@aid-framework/generator-sdk 0.0.0 → 0.1.39

package/dist/targets.js

@@ -0,0 +1,88 @@
+/**
+ * The Phase 0 target declarations, in the shape `@aid-framework/ir`'s capability gate consumes.
+ *
+ * `@aid-framework/ir` ships a placeholder (`PHASE_0_TARGET_CAPABILITIES`) precisely so the gate
+ * can exist before a real generator does; this module is the replacement. It matters
+ * that these are *declarations*, not aspirations: a target that claims `streaming`
+ * makes every spec requiring streaming pass the capability gate, so the list is the
+ * honest answer to "what does the code this generator emits actually do".
+ *
+ * Two facts are recorded here rather than hidden in prose:
+ *
+ * - `streaming` is declared since layer P7a. It was absent while both gateways raised
+ *   `FeatureDeferredError`; the Python runtime now streams and the generator emits a
+ *   route that negotiates `Accept: text/event-stream`, so the declaration is backed by
+ *   an emitter, a runtime and a committed example. The TypeScript runtime still defers
+ *   streaming (ratified to L6), which is why `@aid-framework/ir`'s derivation and this list are
+ *   kept separate concerns.
+ * - `agents` and `cursor-memory` are declared since layer P7b, and they are two
+ *   declarations rather than one because the IR derives two: `agents` from an `agents`
+ *   collection, `cursor-memory` from a `memory` collection (there is no `memory`
+ *   capability to declare). Both are backed by emitted code -- `generated/agents.py`
+ *   builds the runtime over this app's own gateway and tools and serves the routes --
+ *   and by the example's `tests/test_agents.py`, which pauses a run and resumes it. The
+ *   TypeScript target declares neither, so `@aid-framework/ir` will route a spec that needs them
+ *   to the Python target or refuse it.
+ * - the absence of `emitsAgainst.orchestration` — Phase 0 control flow is plain async,
+ *   and orchestration frameworks are deferred to Phase 2. An agent loop is not an
+ *   orchestration framework: the emitted `build_runtime` calls `AgentRuntime.from_ir`
+ *   from the repo's own runtime and depends on nothing outside it.
+ */
+import { IR_VERSION } from '@aid-framework/ir';
+import { formatDiagnostics } from '@aid-framework/spec';
+import { parseManifest, targetCapabilityDeclarations, } from './manifest.js';
+export const PY_FASTAPI_TARGET = 'py-fastapi';
+/**
+ * The FastAPI + Pydantic target. `emitsAgainst` says the emitted code binds to
+ * Pydantic for structured output and OpenTelemetry GenAI for tracing, and to no
+ * orchestration framework at all.
+ */
+export const PY_FASTAPI_MANIFEST_INPUT = {
+    manifestVersion: 1,
+    name: '@aid-framework/generator-py-fastapi',
+    target: PY_FASTAPI_TARGET,
+    version: '0.1.0',
+    irRange: `^${IR_VERSION}`,
+    capabilities: [
+        'http-trigger',
+        'json-schema',
+        'streaming',
+        'tool-calling',
+        'otel',
+        'embeddings',
+        'rerank',
+        'guardrails',
+        'agents',
+        'cursor-memory',
+    ],
+    emitsAgainst: {
+        structuredOutput: 'pydantic',
+        tracing: 'otel-genai',
+    },
+    output: {
+        root: 'app',
+        generatedDir: 'generated',
+        businessDir: 'business',
+    },
+};
+/**
+ * The generator set is validated at module load. A manifest that does not parse is a
+ * programming error in this package, not user input, so it throws rather than returning
+ * diagnostics no caller is in a position to act on.
+ */
+function requireValidManifest(label, input) {
+    const { manifest, diagnostics } = parseManifest(input);
+    if (manifest === undefined) {
+        throw new Error(`${label} is not a valid generator manifest:\n${formatDiagnostics(diagnostics)}`);
+    }
+    return manifest;
+}
+export const PY_FASTAPI_MANIFEST = requireValidManifest(PY_FASTAPI_MANIFEST_INPUT.name, PY_FASTAPI_MANIFEST_INPUT);
+export function phase0Generators() {
+    return [PY_FASTAPI_MANIFEST];
+}
+/** Drop-in replacement for `@aid-framework/ir`'s `phase0TargetCapabilities()`. */
+export function phase0TargetCapabilities() {
+    return targetCapabilityDeclarations(phase0Generators());
+}
+//# sourceMappingURL=targets.js.map

package/dist/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,UAAU,EAAqC,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAGL,aAAa,EACb,4BAA4B,GAC7B,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAA2B;IAC/D,eAAe,EAAE,CAAC;IAClB,IAAI,EAAE,qCAAqC;IAC3C,MAAM,EAAE,iBAAiB;IACzB,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,IAAI,UAAU,EAAE;IACzB,YAAY,EAAE;QACZ,cAAc;QACd,aAAa;QACb,WAAW;QACX,cAAc;QACd,MAAM;QACN,YAAY;QACZ,QAAQ;QACR,YAAY;QACZ,QAAQ;QACR,eAAe;KAChB;IACD,YAAY,EAAE;QACZ,gBAAgB,EAAE,UAAU;QAC5B,OAAO,EAAE,YAAY;KACtB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,KAAK;QACX,YAAY,EAAE,WAAW;QACzB,WAAW,EAAE,UAAU;KACxB;CACF,CAAC;AAEF;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,KAAa,EAAE,KAA6B;IACxE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,wCAAwC,iBAAiB,CAAC,WAAW,CAAC,EAAE,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAsB,oBAAoB,CACxE,yBAAyB,CAAC,IAAI,EAC9B,yBAAyB,CAC1B,CAAC;AAEF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAC/B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,wBAAwB;IACtC,OAAO,4BAA4B,CAAC,gBAAgB,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/package.json

@@ -1,14 +1,43 @@
-{
-    "name":  "@aid-framework/generator-sdk",
-    "version":  "0.0.0",
-    "description":  "Placeholder package created to register this name for OIDC trusted publishing. Contains no code; real releases are published by GitHub Actions.",
-    "license":  "Apache-2.0",
-    "repository":  {
-                       "type":  "git",
-                       "url":  "git+https://github.com/aid-framework/aid-framework.git",
-                       "directory":  "packages/generator-sdk"
-                   },
-    "publishConfig":  {
-                          "access":  "public"
-                      }
-}
+{
+  "name": "@aid-framework/generator-sdk",
+  "version": "0.1.39",
+  "description": "The AID Framework generator plugin interface: the manifest contract, the drift/ownership algorithm, and the determinism helpers every target generator emits through.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aid-framework/aid-framework.git",
+    "directory": "packages/generator-sdk"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@aid-framework/ir": "0.1.39",
+    "@aid-framework/spec": "0.1.39"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean"
+  }
+}