@autonoma-ai/sdk 0.2.2 → 0.2.4-canary.2dc39bb

package/README.md

@@ -1,8 +1,8 @@
 # @autonoma-ai/sdk
 
-Core protocol layer for the Autonoma Environment Factory. Handles HMAC verification, JWT-signed teardown tokens, FK graph ordering, and the `discover`/`up`/`down` request lifecycle.
+Core protocol layer for the Autonoma Environment Factory. Handles HMAC verification, JWT-signed teardown tokens, dependency ordering from `_alias`/`_ref` graphs, and the `discover`/`up`/`down` request lifecycle.
 
-This package is the shared dependency of all ORM and server adapters — you don't need to install it directly unless you're building a custom adapter.
+This package is the shared dependency of all server adapters — you don't need to install it directly unless you're building a custom adapter.
 
 ## Install
 
@@ -14,7 +14,7 @@ pnpm add @autonoma-ai/sdk
 
 ### `handleRequest(config, request)`
 
-Main entry point. Routes `discover`, `up`, and `down` actions, verifies HMAC, and delegates to the ORM adapter.
+Main entry point. Routes `discover`, `up`, and `down` actions, verifies HMAC, and delegates to registered factories.
 
 ```typescript
 import { handleRequest } from '@autonoma-ai/sdk'
@@ -23,6 +23,26 @@ const response = await handleRequest(config, { body, headers })
 // { status: 200, body: { ... } }
 ```
 
+### `defineFactory({ inputSchema, create, teardown?, refSchema? })`
+
+Defines a factory for a model. `inputSchema` is a Zod schema that the SDK uses to derive the discover response — no database introspection needed.
+
+```typescript
+import { defineFactory } from '@autonoma-ai/sdk'
+import { z } from 'zod'
+
+const Organization = defineFactory({
+  inputSchema: z.object({ name: z.string(), slug: z.string() }),
+  create: async (data, ctx) => {
+    const org = await db.organization.create({ data })
+    return { id: org.id, ...data }
+  },
+  teardown: async (record, ctx) => {
+    await db.organization.delete({ where: { id: record.id } })
+  },
+})
+```
+
 ### `checkScenario(adapter, scenario)`
 
 Dry-run a scenario against a real database — full create-then-teardown cycle. Use this in integration tests to validate scenario data before deploying.
@@ -35,30 +55,26 @@ const result = await checkScenario(adapter, {
     Organization: [{
       name: 'Test Org',
       slug: 'test-org',
-      users: [{ email: 'admin@test.com', name: 'Admin' }],
+      _alias: 'org1',
     }],
   },
 })
 
-// result.valid   → true/false
-// result.phase   → 'ok' | 'up' | 'down'
-// result.errors  → [{ message, fix }]
-// result.timing  → { upMs, downMs }
+// result.valid   -> true/false
+// result.phase   -> 'ok' | 'up' | 'down'
+// result.errors  -> [{ message, fix }]
+// result.timing  -> { upMs, downMs }
 ```
 
-### `checkAllScenarios(adapter, scenarios)`
-
-Runs `checkScenario` for each scenario definition and returns all results.
-
 ### Graph utilities (`@autonoma-ai/sdk/graph`)
 
-Exported from the `/graph` subpath for use in ORM adapters:
+Exported from the `/graph` subpath:
 
 ```typescript
 import { topoSort, findDeferrableEdge } from '@autonoma-ai/sdk/graph'
 ```
 
-- `topoSort(edges)` — Kahn's algorithm + Tarjan's SCC for FK-ordered entity creation
+- `topoSort(edges)` — Kahn's algorithm + Tarjan's SCC for dependency ordering
 - `findDeferrableEdge(scc, edges)` — finds a nullable FK in a cycle to break it
 
 ### Other exports
@@ -67,7 +83,6 @@ import { topoSort, findDeferrableEdge } from '@autonoma-ai/sdk/graph'
 |--------|-----|
 | `signBody` / `verifySignature` | HMAC-SHA256 signing for request auth |
 | `signRefs` / `verifyRefs` | JWT-like token for signing teardown refs |
-| `resolveTree` | Nested scenario tree → flat entity list with auto-wired FKs |
 | `fingerprint` | Deterministic hash of scenario definitions |
 
 ## Documentation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autonoma-ai/sdk",
-  "version": "0.2.2",
+  "version": "0.2.4-canary.2dc39bb",
   "description": "Autonoma Environment Factory SDK — protocol layer",
   "type": "module",
   "exports": {