@oneie/sdk 0.9.0 → 0.10.0

package/dist/meta.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { RECEIVERS, RECIPES } from "./receivers.js";
+/**
+ * Project the catalog to agent-facing rows, scoped to what the caller may call.
+ * `canCall(auth)` decides per receiver — the service passes a predicate built
+ * from the caller's role; omitted ⇒ everything is visible.
+ */
+export function metaCatalog(opts = {}) {
+    const canCall = opts.canCall ?? (() => true);
+    return Object.values(RECEIVERS)
+        .filter((r) => canCall(r.auth))
+        .map((r) => ({
+        receiver: r.receiver,
+        summary: r.summary,
+        effect: r.effect,
+        auth: r.auth,
+        cost: r.cost,
+        reversible: r.reversible,
+        settles: r.settles,
+        simulatable: r.simulatable,
+        idempotent: r.idempotent,
+        version: r.version,
+        deprecated: r.deprecated,
+    }));
+}
+/** The ordered receiver sequence for a goal — what `meta:catalog?goal=` returns. */
+export function metaRecipe(goal) {
+    return { goal, recipe: RECIPES[goal] };
+}
+/** One receiver's request + response as JSON Schema — read before calling. */
+export function metaSchema(receiver) {
+    const r = RECEIVERS[receiver];
+    return {
+        receiver: r.receiver,
+        summary: r.summary,
+        request: z.toJSONSchema(r.request),
+        response: z.toJSONSchema(r.response),
+    };
+}
+/** A role-scoping predicate: low-privilege callers can't see owner-only receivers. */
+export function ownerOnly(auth) {
+    return auth !== undefined && /^(manage_|mint_)/.test(auth);
+}
+//# sourceMappingURL=meta.js.map

package/dist/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,OAAO,EAAsC,MAAM,gBAAgB,CAAC;AAyBxF;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAA4D,EAAE;IACxF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;SAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC,CAAC,CAAC;AACR,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;AACzC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,QAAsB;IAM/C,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO;QACL,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC;QAClC,QAAQ,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,SAAS,CAAC,IAAwB;IAChD,OAAO,IAAI,KAAK,SAAS,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/dist/openapi.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 `plans/agent-first-spec.md`.
+ */
+export declare const RECEIVER_REGION_BEGIN = "    # BEGIN generated:receivers \u2014 bun run generate:openapi (do not edit by hand)";
+export declare 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 declare function buildReceiverPayload(): {
+    oneOf: Array<Record<string, unknown>>;
+};
+/**
+ * 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 declare function generatedRegion(): string;
+/** Replace the marked region in an openapi.yaml string. Throws if markers are absent. */
+export declare function injectRegion(yaml: string): string;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,eAAO,MAAM,qBAAqB,0FACkD,CAAC;AACrF,eAAO,MAAM,mBAAmB,kCAAkC,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,CAmBhF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD"}

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 `plans/agent-first-spec.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"}