Autonoma SDK

Multi-language SDK for the Autonoma Environment Factory endpoint. Define typed factories per model, and the SDK handles HMAC authentication, dependency-ordered entity creation via _alias/_ref graphs, and scoped teardown.

All SDKs implement the same protocol with identical core modules:

• handler -- request routing (discover/up/down), HMAC verification, environment gating, error wrapping
• hmac -- HMAC-SHA256 signing/verification for request authentication
• refs -- JWT-like token (header.payload.signature) for signing/verifying created entity refs
• graph -- topological sort + cycle detection for dependency ordering
• schema -- builds the discover response from registered factory input definitions (Zod, Pydantic, struct tags, etc.)
• fingerprint -- deterministic SHA-256 hash of scenario definitions

Every response includes protocol version and SDK metadata:

{
  "version": "1.0",
  "sdk": { "language": "typescript", "server": "express" }
}

• conformance/ -- Language-agnostic JSON fixtures that verify core algorithm behavior (graph sorting, HMAC, refs, fingerprinting) across all implementations
• protocol/ -- HTTP-level test suites that validate the full request/response cycle against any running SDK server
• examples/ -- Runnable example projects for every supported language (see examples README)

See the README in each language SDK for installation and usage instructions.

# Run conformance tests across all languages
cd conformance && npx tsx run.ts

# Run protocol tests against a running server
npx tsx protocol/test-runner.ts --url http://localhost:3000/api/autonoma --secret <secret>

Private -- Autonoma AI