@autonoma-ai/sdk 0.1.0 → 0.1.3

package/README.md

@@ -0,0 +1,88 @@
+# @autonoma-ai/sdk
+
+Core protocol layer for the Autonoma Environment Factory. Handles HMAC verification, JWT-signed teardown tokens, template resolution, FK graph ordering, 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.
+
+## Install
+
+```bash
+pnpm add @autonoma-ai/sdk
+```
+
+## What's exported
+
+### `handleRequest(config, request)`
+
+Main entry point. Routes `discover`, `up`, and `down` actions, verifies HMAC, and delegates to the ORM adapter.
+
+```typescript
+import { handleRequest } from '@autonoma-ai/sdk'
+
+const response = await handleRequest(config, { body, headers })
+// { status: 200, body: { ... } }
+```
+
+### `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.
+
+```typescript
+import { checkScenario } from '@autonoma-ai/sdk'
+
+const result = await checkScenario(adapter, {
+  create: {
+    Organization: [{
+      name: 'Test [{{testRunId}}]',
+      slug: 'test-{{testRunId}}',
+      users: [{ email: 'admin-{{testRunId}}@test.com', name: 'Admin' }],
+    }],
+  },
+})
+
+// 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:
+
+```typescript
+import { topoSort, findDeferrableEdge } from '@autonoma-ai/sdk/graph'
+```
+
+- `topoSort(edges)` — Kahn's algorithm + Tarjan's SCC for FK-ordered entity creation
+- `findDeferrableEdge(scc, edges)` — finds a nullable FK in a cycle to break it
+
+### Other exports
+
+| Export | Use |
+|--------|-----|
+| `signBody` / `verifySignature` | HMAC-SHA256 signing for request auth |
+| `signRefs` / `verifyRefs` | JWT-like token for signing teardown refs |
+| `resolveTemplate` | Resolve `{{testRunId}}`, `{{index}}`, `{{cycle(...)}}`, etc. |
+| `resolveTree` | Nested scenario tree → flat entity list with auto-wired FKs |
+| `fingerprint` | Deterministic hash of scenario definitions |
+
+## CLI
+
+The package ships an `autonoma` CLI:
+
+```bash
+# Validate a scenario against a schema
+npx autonoma validate <schema.json> <scenario.json>
+
+# Convert Prisma DMMF to autonoma-schema.json
+npx autonoma schema convert <dmmf.json> --scope-field <field>
+```
+
+## Documentation
+
+Full docs: [docs/](../../docs/) — start with [overview](../../docs/overview.txt) or read [everything in one file](../../docs/llms-full.txt).

package/dist/cli.js

@@ -95,7 +95,7 @@ function convertDMMFToSchema(dmmf, scopeField) {
         });
       }
     }
-    models.push({ name: model.name, fields });
+    models.push({ name: model.name, tableName: model.dbName ?? model.name, fields });
   }
   return { models, edges, relations: [], scopeField };
 }

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { readFile, writeFile } from 'node:fs/promises'\nimport { resolve } from 'node:path'\nimport type { SchemaInfo } from './types'\n\nconst HELP = `\nautonoma — Autonoma SDK CLI\n\nCommands:\n  autonoma schema convert <dmmf.json>   Convert Prisma DMMF to autonoma schema\n\nOptions:\n  --scope-field <name>   Scope field name (default: \"testRunId\")\n  --pretty               Pretty-print output\n  -o, --output <path>    Write output to file instead of stdout\n  -h, --help             Show this help\n`.trim()\n\nasync function main() {\n  const args = process.argv.slice(2)\n\n  if (args.length === 0 || args.includes('-h') || args.includes('--help')) {\n    console.log(HELP)\n    process.exit(0)\n  }\n\n  const command = args[0]\n\n  switch (command) {\n    case 'schema':\n      return await cmdSchema(args.slice(1))\n    default:\n      console.error(`Unknown command: ${command}`)\n      console.log(HELP)\n      process.exit(1)\n  }\n}\n\n// ── schema convert ────────────────────────────────────────────────────────\n\nasync function cmdSchema(args: string[]) {\n  const subcommand = args[0]\n\n  if (subcommand !== 'convert') {\n    console.error('Usage: autonoma schema convert <dmmf.json> --scope-field <name>')\n    process.exit(1)\n  }\n\n  const flags = parseFlags(args.slice(1))\n  const positional = flags._positional\n\n  if (positional.length < 1) {\n    console.error('Usage: autonoma schema convert <dmmf.json> --scope-field <name>')\n    process.exit(1)\n  }\n\n  const dmmfPath = resolve(positional[0]!)\n  const scopeField = (flags['--scope-field'] as string) ?? 'testRunId'\n  const dmmf = await readJSON<DMMFInput>(dmmfPath)\n\n  const schema = convertDMMFToSchema(dmmf, scopeField)\n\n  const json = JSON.stringify(schema, null, 2)\n\n  if (flags['-o'] || flags['--output']) {\n    const outPath = resolve((flags['-o'] ?? flags['--output']) as string)\n    await writeFile(outPath, json + '\\n')\n    console.error(`Schema written to ${outPath}`)\n    console.error(`  ${schema.models.length} models, ${schema.edges.length} FK edges, scopeField: \"${scopeField}\"`)\n  } else {\n    console.log(json)\n  }\n}\n\n// ── DMMF conversion ───────────────────────────────────────────────────────\n\ninterface DMMFInput {\n  models: Record<string, DMMFModel> | DMMFModel[]\n  datamodel?: { models: DMMFModel[] }\n}\n\ninterface DMMFModel {\n  name: string\n  fields: DMMFField[]\n}\n\ninterface DMMFField {\n  name: string\n  type: string\n  kind: string\n  isRequired: boolean\n  isId: boolean\n  hasDefaultValue: boolean\n  relationFromFields?: string[]\n  relationToFields?: string[]\n}\n\nfunction convertDMMFToSchema(dmmf: DMMFInput, scopeField: string): SchemaInfo {\n  let dmmfModels: DMMFModel[]\n\n  if (dmmf.datamodel?.models) {\n    dmmfModels = dmmf.datamodel.models\n  } else if (Array.isArray(dmmf.models)) {\n    dmmfModels = dmmf.models\n  } else {\n    dmmfModels = Object.entries(dmmf.models).map(\n      ([name, model]) => ({ ...model, name }),\n    )\n  }\n\n  const models: SchemaInfo['models'] = []\n  const edges: SchemaInfo['edges'] = []\n\n  for (const model of dmmfModels) {\n    const fields: SchemaInfo['models'][number]['fields'] = []\n\n    for (const field of model.fields) {\n      if (field.kind === 'object') {\n        if (field.relationFromFields?.length) {\n          edges.push({\n            from: model.name,\n            to: field.type,\n            localField: field.relationFromFields[0]!,\n            foreignField: field.relationToFields?.[0] ?? 'id',\n            nullable: !field.isRequired,\n          })\n        }\n        continue\n      }\n\n      if (field.kind === 'scalar' || field.kind === 'enum') {\n        fields.push({\n          name: field.name,\n          type: field.type,\n          isRequired: field.isRequired,\n          isId: field.isId,\n          hasDefault: field.hasDefaultValue,\n        })\n      }\n    }\n\n    models.push({ name: model.name, fields })\n  }\n\n  return { models, edges, relations: [], scopeField }\n}\n\n// ── Utilities ─────────────────────────────────────────────────────────────\n\nasync function readJSON<T>(path: string): Promise<T> {\n  try {\n    const content = await readFile(path, 'utf-8')\n    return JSON.parse(content) as T\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n      console.error(`File not found: ${path}`)\n    } else if (err instanceof SyntaxError) {\n      console.error(`Invalid JSON in ${path}: ${err.message}`)\n    } else {\n      console.error(`Error reading ${path}: ${err}`)\n    }\n    process.exit(1)\n  }\n}\n\ninterface ParsedFlags {\n  [key: string]: string | boolean | string[]\n  _positional: string[]\n}\n\nfunction parseFlags(args: string[]): ParsedFlags {\n  const result: ParsedFlags = { _positional: [] }\n  let i = 0\n  while (i < args.length) {\n    const arg = args[i]!\n    if (arg.startsWith('-')) {\n      const next = args[i + 1]\n      if (next && !next.startsWith('-')) {\n        result[arg] = next\n        i += 2\n      } else {\n        result[arg] = true\n        i++\n      }\n    } else {\n      result._positional.push(arg)\n      i++\n    }\n  }\n  return result\n}\n\nmain().catch((err) => {\n  console.error('Fatal:', err instanceof Error ? err.message : err)\n  process.exit(1)\n})\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { readFile, writeFile } from 'node:fs/promises'\nimport { resolve } from 'node:path'\nimport type { SchemaInfo } from './types'\n\nconst HELP = `\nautonoma — Autonoma SDK CLI\n\nCommands:\n  autonoma schema convert <dmmf.json>   Convert Prisma DMMF to autonoma schema\n\nOptions:\n  --scope-field <name>   Scope field name (default: \"testRunId\")\n  --pretty               Pretty-print output\n  -o, --output <path>    Write output to file instead of stdout\n  -h, --help             Show this help\n`.trim()\n\nasync function main() {\n  const args = process.argv.slice(2)\n\n  if (args.length === 0 || args.includes('-h') || args.includes('--help')) {\n    console.log(HELP)\n    process.exit(0)\n  }\n\n  const command = args[0]\n\n  switch (command) {\n    case 'schema':\n      return await cmdSchema(args.slice(1))\n    default:\n      console.error(`Unknown command: ${command}`)\n      console.log(HELP)\n      process.exit(1)\n  }\n}\n\n// ── schema convert ────────────────────────────────────────────────────────\n\nasync function cmdSchema(args: string[]) {\n  const subcommand = args[0]\n\n  if (subcommand !== 'convert') {\n    console.error('Usage: autonoma schema convert <dmmf.json> --scope-field <name>')\n    process.exit(1)\n  }\n\n  const flags = parseFlags(args.slice(1))\n  const positional = flags._positional\n\n  if (positional.length < 1) {\n    console.error('Usage: autonoma schema convert <dmmf.json> --scope-field <name>')\n    process.exit(1)\n  }\n\n  const dmmfPath = resolve(positional[0]!)\n  const scopeField = (flags['--scope-field'] as string) ?? 'testRunId'\n  const dmmf = await readJSON<DMMFInput>(dmmfPath)\n\n  const schema = convertDMMFToSchema(dmmf, scopeField)\n\n  const json = JSON.stringify(schema, null, 2)\n\n  if (flags['-o'] || flags['--output']) {\n    const outPath = resolve((flags['-o'] ?? flags['--output']) as string)\n    await writeFile(outPath, json + '\\n')\n    console.error(`Schema written to ${outPath}`)\n    console.error(`  ${schema.models.length} models, ${schema.edges.length} FK edges, scopeField: \"${scopeField}\"`)\n  } else {\n    console.log(json)\n  }\n}\n\n// ── DMMF conversion ───────────────────────────────────────────────────────\n\ninterface DMMFInput {\n  models: Record<string, DMMFModel> | DMMFModel[]\n  datamodel?: { models: DMMFModel[] }\n}\n\ninterface DMMFModel {\n  name: string\n  dbName?: string | null\n  fields: DMMFField[]\n}\n\ninterface DMMFField {\n  name: string\n  type: string\n  kind: string\n  isRequired: boolean\n  isId: boolean\n  hasDefaultValue: boolean\n  relationFromFields?: string[]\n  relationToFields?: string[]\n}\n\nfunction convertDMMFToSchema(dmmf: DMMFInput, scopeField: string): SchemaInfo {\n  let dmmfModels: DMMFModel[]\n\n  if (dmmf.datamodel?.models) {\n    dmmfModels = dmmf.datamodel.models\n  } else if (Array.isArray(dmmf.models)) {\n    dmmfModels = dmmf.models\n  } else {\n    dmmfModels = Object.entries(dmmf.models).map(\n      ([name, model]) => ({ ...model, name }),\n    )\n  }\n\n  const models: SchemaInfo['models'] = []\n  const edges: SchemaInfo['edges'] = []\n\n  for (const model of dmmfModels) {\n    const fields: SchemaInfo['models'][number]['fields'] = []\n\n    for (const field of model.fields) {\n      if (field.kind === 'object') {\n        if (field.relationFromFields?.length) {\n          edges.push({\n            from: model.name,\n            to: field.type,\n            localField: field.relationFromFields[0]!,\n            foreignField: field.relationToFields?.[0] ?? 'id',\n            nullable: !field.isRequired,\n          })\n        }\n        continue\n      }\n\n      if (field.kind === 'scalar' || field.kind === 'enum') {\n        fields.push({\n          name: field.name,\n          type: field.type,\n          isRequired: field.isRequired,\n          isId: field.isId,\n          hasDefault: field.hasDefaultValue,\n        })\n      }\n    }\n\n    models.push({ name: model.name, tableName: model.dbName ?? model.name, fields })\n  }\n\n  return { models, edges, relations: [], scopeField }\n}\n\n// ── Utilities ─────────────────────────────────────────────────────────────\n\nasync function readJSON<T>(path: string): Promise<T> {\n  try {\n    const content = await readFile(path, 'utf-8')\n    return JSON.parse(content) as T\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n      console.error(`File not found: ${path}`)\n    } else if (err instanceof SyntaxError) {\n      console.error(`Invalid JSON in ${path}: ${err.message}`)\n    } else {\n      console.error(`Error reading ${path}: ${err}`)\n    }\n    process.exit(1)\n  }\n}\n\ninterface ParsedFlags {\n  [key: string]: string | boolean | string[]\n  _positional: string[]\n}\n\nfunction parseFlags(args: string[]): ParsedFlags {\n  const result: ParsedFlags = { _positional: [] }\n  let i = 0\n  while (i < args.length) {\n    const arg = args[i]!\n    if (arg.startsWith('-')) {\n      const next = args[i + 1]\n      if (next && !next.startsWith('-')) {\n        result[arg] = next\n        i += 2\n      } else {\n        result[arg] = true\n        i++\n      }\n    } else {\n      result._positional.push(arg)\n      i++\n    }\n  }\n  return result\n}\n\nmain().catch((err) => {\n  console.error('Fatal:', err instanceof Error ? err.message : err)\n  process.exit(1)\n})\n"],"mappings":";;;AAEA,SAAS,UAAU,iBAAiB;AACpC,SAAS,eAAe;AAGxB,IAAM,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWX,KAAK;AAEP,eAAe,OAAO;AACpB,QAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AAEjC,MAAI,KAAK,WAAW,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,QAAQ,GAAG;AACvE,YAAQ,IAAI,IAAI;AAChB,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,UAAU,KAAK,CAAC;AAEtB,UAAQ,SAAS;AAAA,IACf,KAAK;AACH,aAAO,MAAM,UAAU,KAAK,MAAM,CAAC,CAAC;AAAA,IACtC;AACE,cAAQ,MAAM,oBAAoB,OAAO,EAAE;AAC3C,cAAQ,IAAI,IAAI;AAChB,cAAQ,KAAK,CAAC;AAAA,EAClB;AACF;AAIA,eAAe,UAAU,MAAgB;AACvC,QAAM,aAAa,KAAK,CAAC;AAEzB,MAAI,eAAe,WAAW;AAC5B,YAAQ,MAAM,iEAAiE;AAC/E,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,QAAQ,WAAW,KAAK,MAAM,CAAC,CAAC;AACtC,QAAM,aAAa,MAAM;AAEzB,MAAI,WAAW,SAAS,GAAG;AACzB,YAAQ,MAAM,iEAAiE;AAC/E,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,WAAW,QAAQ,WAAW,CAAC,CAAE;AACvC,QAAM,aAAc,MAAM,eAAe,KAAgB;AACzD,QAAM,OAAO,MAAM,SAAoB,QAAQ;AAE/C,QAAM,SAAS,oBAAoB,MAAM,UAAU;AAEnD,QAAM,OAAO,KAAK,UAAU,QAAQ,MAAM,CAAC;AAE3C,MAAI,MAAM,IAAI,KAAK,MAAM,UAAU,GAAG;AACpC,UAAM,UAAU,QAAS,MAAM,IAAI,KAAK,MAAM,UAAU,CAAY;AACpE,UAAM,UAAU,SAAS,OAAO,IAAI;AACpC,YAAQ,MAAM,qBAAqB,OAAO,EAAE;AAC5C,YAAQ,MAAM,KAAK,OAAO,OAAO,MAAM,YAAY,OAAO,MAAM,MAAM,2BAA2B,UAAU,GAAG;AAAA,EAChH,OAAO;AACL,YAAQ,IAAI,IAAI;AAAA,EAClB;AACF;AA0BA,SAAS,oBAAoB,MAAiB,YAAgC;AAC5E,MAAI;AAEJ,MAAI,KAAK,WAAW,QAAQ;AAC1B,iBAAa,KAAK,UAAU;AAAA,EAC9B,WAAW,MAAM,QAAQ,KAAK,MAAM,GAAG;AACrC,iBAAa,KAAK;AAAA,EACpB,OAAO;AACL,iBAAa,OAAO,QAAQ,KAAK,MAAM,EAAE;AAAA,MACvC,CAAC,CAAC,MAAM,KAAK,OAAO,EAAE,GAAG,OAAO,KAAK;AAAA,IACvC;AAAA,EACF;AAEA,QAAM,SAA+B,CAAC;AACtC,QAAM,QAA6B,CAAC;AAEpC,aAAW,SAAS,YAAY;AAC9B,UAAM,SAAiD,CAAC;AAExD,eAAW,SAAS,MAAM,QAAQ;AAChC,UAAI,MAAM,SAAS,UAAU;AAC3B,YAAI,MAAM,oBAAoB,QAAQ;AACpC,gBAAM,KAAK;AAAA,YACT,MAAM,MAAM;AAAA,YACZ,IAAI,MAAM;AAAA,YACV,YAAY,MAAM,mBAAmB,CAAC;AAAA,YACtC,cAAc,MAAM,mBAAmB,CAAC,KAAK;AAAA,YAC7C,UAAU,CAAC,MAAM;AAAA,UACnB,CAAC;AAAA,QACH;AACA;AAAA,MACF;AAEA,UAAI,MAAM,SAAS,YAAY,MAAM,SAAS,QAAQ;AACpD,eAAO,KAAK;AAAA,UACV,MAAM,MAAM;AAAA,UACZ,MAAM,MAAM;AAAA,UACZ,YAAY,MAAM;AAAA,UAClB,MAAM,MAAM;AAAA,UACZ,YAAY,MAAM;AAAA,QACpB,CAAC;AAAA,MACH;AAAA,IACF;AAEA,WAAO,KAAK,EAAE,MAAM,MAAM,MAAM,WAAW,MAAM,UAAU,MAAM,MAAM,OAAO,CAAC;AAAA,EACjF;AAEA,SAAO,EAAE,QAAQ,OAAO,WAAW,CAAC,GAAG,WAAW;AACpD;AAIA,eAAe,SAAY,MAA0B;AACnD,MAAI;AACF,UAAM,UAAU,MAAM,SAAS,MAAM,OAAO;AAC5C,WAAO,KAAK,MAAM,OAAO;AAAA,EAC3B,SAAS,KAAK;AACZ,QAAK,IAA8B,SAAS,UAAU;AACpD,cAAQ,MAAM,mBAAmB,IAAI,EAAE;AAAA,IACzC,WAAW,eAAe,aAAa;AACrC,cAAQ,MAAM,mBAAmB,IAAI,KAAK,IAAI,OAAO,EAAE;AAAA,IACzD,OAAO;AACL,cAAQ,MAAM,iBAAiB,IAAI,KAAK,GAAG,EAAE;AAAA,IAC/C;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;AAOA,SAAS,WAAW,MAA6B;AAC/C,QAAM,SAAsB,EAAE,aAAa,CAAC,EAAE;AAC9C,MAAI,IAAI;AACR,SAAO,IAAI,KAAK,QAAQ;AACtB,UAAM,MAAM,KAAK,CAAC;AAClB,QAAI,IAAI,WAAW,GAAG,GAAG;AACvB,YAAM,OAAO,KAAK,IAAI,CAAC;AACvB,UAAI,QAAQ,CAAC,KAAK,WAAW,GAAG,GAAG;AACjC,eAAO,GAAG,IAAI;AACd,aAAK;AAAA,MACP,OAAO;AACL,eAAO,GAAG,IAAI;AACd;AAAA,MACF;AAAA,IACF,OAAO;AACL,aAAO,YAAY,KAAK,GAAG;AAC3B;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACpB,UAAQ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,GAAG;AAChE,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/dist/{graph-DpqVvKaD.d.ts → graph-gkFzydIb.d.ts}

@@ -1,11 +1,13 @@
-/** ORM adapter interface — implemented by @autonoma-ai/sdk-prisma, @autonoma-ai/sdk-drizzle, etc. */
-interface OrmAdapter {
-    /** Return schema metadata for discover (models, fields, relationships) */
-    getSchema(): SchemaInfo;
-    /** Create entities from a resolved spec, return created records keyed by model */
-    createEntities(spec: Record<string, ResolvedEntitySpec>, context: CreateContext): Promise<Record<string, Record<string, unknown>[]>>;
-    /** Delete all data scoped to a value. Refs are provided for targeted cleanup of un-scoped models. */
-    teardown(scopeValue: string, refs?: Record<string, Record<string, unknown>[]>): Promise<void>;
+/** Minimal SQL executor — wrap your DB connection (pg Pool, Prisma, Drizzle, etc.) into this. */
+interface SQLExecutor {
+    /** Execute a SQL query with parameterized values. Returns rows as plain objects. */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
+    /**
+     * Execute a block within a transaction.
+     * The callback receives an executor scoped to the transaction.
+     * If the callback throws, the transaction is rolled back.
+     */
+    transaction<T>(fn: (tx: SQLExecutor) => Promise<T>): Promise<T>;
 }
 interface SchemaInfo {
     models: ModelInfo[];
@@ -22,6 +24,7 @@ interface SchemaRelation {
 }
 interface ModelInfo {
     name: string;
+    tableName: string;
     fields: FieldInfo[];
 }
 interface FieldInfo {
@@ -52,14 +55,36 @@ interface ScenarioDefinition {
     /** Nested tree: model name → array of node objects with nested children */
     create: Record<string, Record<string, unknown>[]>;
 }
+interface SdkInfo {
+    language: string;
+    orm: string;
+    server: string;
+}
 interface HandlerConfig {
-    adapter: OrmAdapter;
+    /** SQL executor wrapping your database connection */
+    executor: SQLExecutor;
+    /** Scope field name (camelCase), e.g., 'organizationId' */
+    scopeField: string;
+    /** Database dialect. Defaults to 'postgres'. */
+    dialect?: 'postgres' | 'mysql' | 'sqlite';
+    /** DB schema name. Defaults to 'public' for Postgres. */
+    dbSchema?: string;
+    /**
+     * Map scenario model names to DB table names.
+     * Keys are model names (PascalCase), values are DB table names.
+     * If omitted, auto-detected from information_schema with PascalCase inference.
+     */
+    tableNameMap?: Record<string, string>;
+    /** Tables to exclude from introspection. Defaults to ['_prisma_migrations']. */
+    excludeTables?: string[];
     /** Shared secret — known by both you and Autonoma. Used to verify HMAC signatures on incoming requests. */
     sharedSecret: string;
     /** Internal secret — only you know this. Used to sign the refs JWT token. Autonoma never sees it. */
     signingSecret: string;
     allowProduction?: boolean;
     auth?: (user: Record<string, unknown>) => Promise<AuthResult> | AuthResult;
+    /** SDK identity metadata. Server and ORM adapters populate this. */
+    sdk?: Partial<SdkInfo>;
 }
 interface AuthResult {
     token: string;
@@ -104,4 +129,4 @@ declare function topoSort(nodes: string[], edges: FKEdge[]): TopoSortResult;
  */
 declare function findDeferrableEdge(cycle: string[], edges: FKEdge[]): FKEdge | null;
 
-export { type AuthResult as A, type CreateContext as C, type DiscoverResponse as D, type FKEdge as F, type HandlerConfig as H, type ModelInfo as M, type OrmAdapter as O, type ResolvedEntitySpec as R, type SchemaInfo as S, type TopoSortResult as T, type UpResponse as U, type HandlerRequest as a, type HandlerResponse as b, type ScenarioDefinition as c, type DownResponse as d, type FieldInfo as e, type SchemaRelation as f, findDeferrableEdge as g, topoSort as t };
+export { type AuthResult as A, type CreateContext as C, type DiscoverResponse as D, type FKEdge as F, type HandlerConfig as H, type ModelInfo as M, type ResolvedEntitySpec as R, type SchemaInfo as S, type TopoSortResult as T, type UpResponse as U, type HandlerRequest as a, type HandlerResponse as b, type SQLExecutor as c, type ScenarioDefinition as d, type DownResponse as e, type FieldInfo as f, type SchemaRelation as g, type SdkInfo as h, findDeferrableEdge as i, topoSort as t };

package/dist/graph.d.ts

@@ -1 +1 @@
-export { F as FKEdge, T as TopoSortResult, g as findDeferrableEdge, t as topoSort } from './graph-DpqVvKaD.js';
+export { F as FKEdge, T as TopoSortResult, i as findDeferrableEdge, t as topoSort } from './graph-gkFzydIb.js';

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { H as HandlerConfig, a as HandlerRequest, b as HandlerResponse, S as SchemaInfo, O as OrmAdapter, c as ScenarioDefinition } from './graph-DpqVvKaD.js';
-export { A as AuthResult, C as CreateContext, D as DiscoverResponse, d as DownResponse, F as FKEdge, e as FieldInfo, M as ModelInfo, R as ResolvedEntitySpec, f as SchemaRelation, U as UpResponse, g as findDeferrableEdge, t as topoSort } from './graph-DpqVvKaD.js';
+import { H as HandlerConfig, a as HandlerRequest, b as HandlerResponse, S as SchemaInfo, c as SQLExecutor, d as ScenarioDefinition, R as ResolvedEntitySpec, C as CreateContext } from './graph-gkFzydIb.js';
+export { A as AuthResult, D as DiscoverResponse, e as DownResponse, F as FKEdge, f as FieldInfo, M as ModelInfo, g as SchemaRelation, h as SdkInfo, U as UpResponse, i as findDeferrableEdge, t as topoSort } from './graph-gkFzydIb.js';
 
+declare const PROTOCOL_VERSION = "1.0";
 declare function handleRequest(config: HandlerConfig, req: HandlerRequest): Promise<HandlerResponse>;
 
 declare function signBody(body: string, secret: string): string;
@@ -43,9 +44,24 @@ interface CreateOp {
     tempId: string;
     batch: boolean;
 }
+/**
+ * A deferred FK update — emitted when a _ref points to a node that hasn't
+ * been created yet (circular dependency). Resolved after all creates.
+ */
+interface DeferredUpdate {
+    /** Temp ID of the record that needs to be updated */
+    targetTempId: string;
+    /** Model name of the record to update */
+    model: string;
+    /** Field on the record that holds the deferred FK */
+    field: string;
+    /** Alias that will resolve to the FK value once created */
+    refAlias: string;
+}
 /** Result of resolving a tree scenario */
 interface ResolvedTree {
     ops: CreateOp[];
+    deferredUpdates: DeferredUpdate[];
     aliases: Map<string, string>;
 }
 /** A resolved reference to another node's id */
@@ -59,6 +75,10 @@ interface RefNode {
  * Handles both directions:
  *   - FK on child (Application.organizationId → Organization): set child FK to parent ID
  *   - FK on parent (Member.userId → User): create child first, set parent FK to child ID
+ *
+ * Circular FK cycles (e.g. Application.mainBranchId ↔ Branch.applicationId) are handled
+ * transparently: the nullable FK is omitted on the first create and emitted as a
+ * DeferredUpdate to be applied via UPDATE after all records exist.
  */
 declare function resolveTree(create: Record<string, Record<string, unknown>[]>, schema: SchemaInfo, testRunId: string): ResolvedTree;
 
@@ -80,7 +100,11 @@ interface CheckError {
  * Dry-run a scenario against a real database.
  * Runs the full up → down cycle and returns structured errors.
  */
-declare function checkScenario(adapter: OrmAdapter, scenario: ScenarioDefinition, options?: {
+declare function checkScenario(executor: SQLExecutor, scenario: ScenarioDefinition, options?: {
+    scopeField: string;
+    dialect?: HandlerConfig['dialect'];
+    dbSchema?: string;
+    tableNameMap?: Record<string, string>;
     sharedSecret?: string;
     signingSecret?: string;
     auth?: HandlerConfig['auth'];
@@ -88,10 +112,83 @@ declare function checkScenario(adapter: OrmAdapter, scenario: ScenarioDefinition
 /**
  * Check multiple scenarios sequentially.
  */
-declare function checkAllScenarios(adapter: OrmAdapter, scenarios: ScenarioDefinition[], options?: {
+declare function checkAllScenarios(executor: SQLExecutor, scenarios: ScenarioDefinition[], options?: {
+    scopeField: string;
+    dialect?: HandlerConfig['dialect'];
+    dbSchema?: string;
+    tableNameMap?: Record<string, string>;
     sharedSecret?: string;
     signingSecret?: string;
     auth?: HandlerConfig['auth'];
 }): Promise<CheckResult[]>;
 
-export { type CheckError, type CheckResult, type CreateOp, HandlerConfig, HandlerRequest, HandlerResponse, OrmAdapter, type RefNode, type ResolvedTree, ScenarioDefinition, SchemaInfo, type TemplateContext, checkAllScenarios, checkScenario, fingerprint, handleRequest, resolveTemplate, resolveTree, signBody, signRefs, verifyRefs, verifySignature };
+/** Database dialect abstraction — generates dialect-specific SQL strings. */
+interface Dialect {
+    readonly name: 'postgres' | 'mysql' | 'sqlite';
+    /** Parameter placeholder for index (1-based). Postgres: $1, MySQL/SQLite: ? */
+    param(index: number): string;
+    /** Quote an identifier. Postgres: "name", MySQL: `name` */
+    quoteId(name: string): string;
+    /** Whether INSERT ... RETURNING is supported */
+    readonly supportsReturning: boolean;
+    /** SQL to list all base tables in a schema/database */
+    tablesSQL(schema: string): string;
+    /** SQL to list all columns for all tables in a schema/database */
+    columnsSQL(schema: string): string;
+    /** SQL to list primary key columns */
+    primaryKeysSQL(schema: string): string;
+    /** SQL to list foreign key relationships */
+    foreignKeysSQL(schema: string): string;
+    /** SQL to list enum types and their values */
+    enumsSQL(schema: string): string;
+}
+declare function getDialect(name?: 'postgres' | 'mysql' | 'sqlite'): Dialect;
+
+/** Internal result including name mapping tables */
+interface IntrospectionResult {
+    schema: SchemaInfo;
+    /** model name → DB table name */
+    tableMap: Map<string, string>;
+    /** model name → (field name → DB column name) */
+    columnMaps: Map<string, Map<string, string>>;
+    /** model name → (field name → Postgres enum type name). Only populated for Postgres. */
+    enumTypeMaps: Map<string, Map<string, string>>;
+}
+/**
+ * Introspect a database via information_schema to build SchemaInfo.
+ *
+ * Auto-maps DB names (snake_case) to model names (PascalCase) and
+ * field names (camelCase). Override with `tableNameMap`.
+ */
+declare function introspectDatabase(executor: SQLExecutor, dialect: Dialect, config: {
+    scopeField: string;
+    schema?: string;
+    tableNameMap?: Record<string, string>;
+    excludeTables?: string[];
+}): Promise<IntrospectionResult>;
+
+/**
+ * Create entities via raw SQL INSERT.
+ *
+ * Entities arrive pre-sorted by FK order (handler does topo-sort via tree.ts).
+ * Each model in `spec` is inserted sequentially; within a model, batch mode
+ * uses a single multi-row INSERT while normal mode inserts one row at a time.
+ *
+ * For dialects with RETURNING (Postgres): INSERT ... RETURNING *
+ * For dialects without (MySQL): INSERT then SELECT via LAST_INSERT_ID()
+ */
+declare function createEntities(executor: SQLExecutor, dialect: Dialect, tableMap: Map<string, string>, columnMaps: Map<string, Map<string, string>>, spec: Record<string, ResolvedEntitySpec>, _context: CreateContext, enumTypeMaps?: Map<string, Map<string, string>>): Promise<Record<string, Record<string, unknown>[]>>;
+
+/**
+ * Tear down all data scoped to a value, in reverse topological order.
+ *
+ * Strategy:
+ *   1. Find the scope root model (e.g. Organization) from FK edges
+ *   2. Any model with a FK pointing to the scope root is "scoped"
+ *   3. Delete scoped models by their FK = scopeValue
+ *   4. Delete non-scoped models by their record IDs from refs
+ *   5. Delete the scope root entity last by id = scopeValue
+ */
+declare function teardown(executor: SQLExecutor, dialect: Dialect, tableMap: Map<string, string>, columnMaps: Map<string, Map<string, string>>, schema: SchemaInfo, scopeValue: string, refs?: Record<string, Record<string, unknown>[]>): Promise<void>;
+
+export { type CheckError, type CheckResult, CreateContext, type CreateOp, type Dialect, HandlerConfig, HandlerRequest, HandlerResponse, type IntrospectionResult, PROTOCOL_VERSION, type RefNode, ResolvedEntitySpec, type ResolvedTree, SQLExecutor, ScenarioDefinition, SchemaInfo, type TemplateContext, checkAllScenarios, checkScenario, createEntities, fingerprint, getDialect, handleRequest, introspectDatabase, resolveTemplate, resolveTree, signBody, signRefs, teardown, verifyRefs, verifySignature };