@oneie/sdk 0.9.0 → 0.11.0

package/dist/openapi.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { RECEIVERS } from "./receivers.js";
+/**
+ * OpenAPI generation (C7) — the spec stops lying. The `/signal/{receiver}` and
+ * `/ask/{receiver}` request bodies used to carry an opaque "receiver-defined"
+ * payload; here we derive a real `oneOf` over every receiver's request schema
+ * (via `z.toJSONSchema`), each member tagged with the agent-ergonomic metadata
+ * as `x-` extensions. Pure functions — the CLI (`scripts/generate-openapi.ts`)
+ * does the file I/O. See `text/agent-first-spec-plan.md`.
+ */
+export const RECEIVER_REGION_BEGIN = "    # BEGIN generated:receivers — bun run generate:openapi (do not edit by hand)";
+export const RECEIVER_REGION_END = "    # END generated:receivers";
+/**
+ * The `ReceiverPayload` schema — a `oneOf` over every receiver's request, each
+ * member titled by receiver name + summary, with cost/reversibility/settlement
+ * as `x-` extensions an agent reads to budget before calling.
+ */
+export function buildReceiverPayload() {
+    const oneOf = Object.values(RECEIVERS).map((r) => {
+        const schema = z.toJSONSchema(r.request);
+        delete schema["$schema"];
+        const member = {
+            title: r.receiver,
+            description: r.summary,
+            ...schema,
+            "x-effect": r.effect,
+        };
+        if (r.cost !== undefined)
+            member["x-cost"] = r.cost;
+        if (r.reversible !== undefined)
+            member["x-reversible"] = r.reversible;
+        if (r.settles !== undefined)
+            member["x-settles"] = r.settles;
+        if (r.simulatable !== undefined)
+            member["x-simulatable"] = r.simulatable;
+        if (r.idempotent !== undefined)
+            member["x-idempotent"] = r.idempotent;
+        if (r.auth !== undefined)
+            member["x-auth"] = r.auth;
+        return member;
+    });
+    return { oneOf };
+}
+/**
+ * The exact YAML region injected between the markers. JSON is valid YAML
+ * (flow style), so one deterministic line keeps regeneration byte-stable —
+ * the CI drift gate (`generate && git diff --exit-code`) stays clean.
+ */
+export function generatedRegion() {
+    const payload = JSON.stringify(buildReceiverPayload());
+    return `${RECEIVER_REGION_BEGIN}\n    ReceiverPayload: ${payload}\n${RECEIVER_REGION_END}`;
+}
+/** Replace the marked region in an openapi.yaml string. Throws if markers are absent. */
+export function injectRegion(yaml) {
+    const begin = yaml.indexOf(RECEIVER_REGION_BEGIN);
+    const end = yaml.indexOf(RECEIVER_REGION_END);
+    if (begin === -1 || end === -1) {
+        throw new Error("openapi.yaml is missing the generated:receivers markers");
+    }
+    return yaml.slice(0, begin) + generatedRegion() + yaml.slice(end + RECEIVER_REGION_END.length);
+}
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAChC,kFAAkF,CAAC;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,+BAA+B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC/C,MAAM,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAA4B,CAAC;QACpE,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;QACzB,MAAM,MAAM,GAA4B;YACtC,KAAK,EAAE,CAAC,CAAC,QAAQ;YACjB,WAAW,EAAE,CAAC,CAAC,OAAO;YACtB,GAAG,MAAM;YACT,UAAU,EAAE,CAAC,CAAC,MAAM;SACrB,CAAC;QACF,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QACpD,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;YAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;QACtE,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;QAC7D,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS;YAAE,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;QACzE,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;YAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;QACtE,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QACpD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACvD,OAAO,GAAG,qBAAqB,0BAA0B,OAAO,KAAK,mBAAmB,EAAE,CAAC;AAC7F,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9C,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,eAAe,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACjG,CAAC"}