@ouispec/agent-worker 0.1.0

package/dist/tools/async-binding.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Async tools bound to declared events (W9, ADR-0227 §2.4).
+ *
+ * A tool whose work outlives its call (a GPU job, an export) names the
+ * declared completion it waits on, and optionally its failure and the field
+ * its dispatch returns the job's id in. `bindAsyncTool` checks all of it
+ * against the product's declarations when the tools load; `awaitAsyncTool`
+ * waits for the job to settle when the tool runs. Intent tools use both
+ * (schema-loader.ts), and so do tools generated from any other source, such
+ * as an OpenAPI operation's async binding.
+ */
+import type { ToolExecutionResult } from './types.js';
+import { type AsyncBinding, type EventCatalog, type EventWaiter } from '@ouispec/agent-events';
+export interface AsyncToolSpec {
+    /** Who is binding, for errors: `intent 'generate-image'`, `operation POST /reports/export`. */
+    usedBy: string;
+    /** The declared completion the tool waits on. */
+    completion: string;
+    /** Its declared failure. Default: the one the declarations pair with the completion. */
+    failure?: string;
+    /** The field the dispatch returns the job's id in. Default: the completion's correlation field. */
+    correlation?: string;
+    timeoutMs: number;
+    /**
+     * Fields for the model, each read from the completion's payload with a
+     * `${ event.path }` expression. Default: the completion's declared result.
+     */
+    resultMapping?: Readonly<Record<string, string>>;
+    /** What the mapping is called where it is written, for errors. Default `resultMapping`. */
+    mappingLabel?: string;
+}
+export interface BoundAsyncTool {
+    binding: AsyncBinding;
+    timeoutMs: number;
+    /** Target field → path in the completion's payload; null for the declared result. */
+    fields: Readonly<Record<string, string>> | null;
+}
+/** How the job the tool started ended, as the model is told. */
+export type AsyncToolSettlement = {
+    status: 'complete';
+    fields: Record<string, unknown>;
+} | {
+    status: 'failed';
+    reason: string;
+} | {
+    status: 'dispatched';
+    warning: string;
+};
+/** Check an async tool against the declarations, or throw naming the tool and what is wrong. */
+export declare function bindAsyncTool(events: EventCatalog, spec: AsyncToolSpec): BoundAsyncTool;
+/**
+ * Wait for the job `id` names to settle, and say how it ended. Never throws:
+ * a wait that could not happen, or did not end in time, is `dispatched` with
+ * the reason, so the model keeps the job id and knows the job may still run.
+ */
+export declare function awaitAsyncTool(events: EventCatalog, waiter: EventWaiter, bound: BoundAsyncTool, id: unknown, signal?: AbortSignal): Promise<AsyncToolSettlement>;
+/**
+ * A wait's timeout as written in a declaration: `60s`, `2m`. Absent: `fallbackMs`
+ * (60 s). Anything else fails the load, naming who wrote it and where.
+ */
+export declare function parseWaitTimeout(usedBy: string, where: string, timeout: unknown, fallbackMs?: number): number;
+/**
+ * What an async tool returns once its wait ends, for every kind of async tool:
+ * - complete: the dispatch with the completion's fields, `status: 'complete'`;
+ * - failed: a failed call with the declared reason, and the dispatch with `status: 'failed'`;
+ * - dispatched: the job may still be running, so the model keeps the dispatch
+ *   (`onDispatched`, default the dispatch) and is told why the wait ended. The
+ *   call itself did not fail, so it is not retried.
+ */
+export declare function asyncToolResult(dispatch: Readonly<Record<string, unknown>>, settled: AsyncToolSettlement, onDispatched?: Readonly<Record<string, unknown>>): ToolExecutionResult;
+//# sourceMappingURL=async-binding.d.ts.map

package/dist/tools/async-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-binding.d.ts","sourceRoot":"","sources":["../../src/tools/async-binding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,aAAa;IAC5B,+FAA+F;IAC/F,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,2FAA2F;IAC3F,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;CACjD;AAED,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAI9C,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,GAAG,cAAc,CAmCvF;AAMD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,cAAc,EACrB,EAAE,EAAE,OAAO,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAwB9B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,SAAS,GAAG,MAAM,CAM7G;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,OAAO,EAAE,mBAAmB,EAC5B,YAAY,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAY,GACzD,mBAAmB,CASrB"}

package/dist/tools/async-binding.js

@@ -0,0 +1,104 @@
+import { payloadShape, } from '@ouispec/agent-events';
+const TEMPLATE = /^\$\{\s*(\w+)\.([^}]+?)\s*\}$/;
+/** Check an async tool against the declarations, or throw naming the tool and what is wrong. */
+export function bindAsyncTool(events, spec) {
+    const binding = events.asyncBinding({
+        usedBy: spec.usedBy,
+        completion: spec.completion,
+        ...(spec.failure !== undefined ? { failure: spec.failure } : {}),
+        ...(spec.correlation !== undefined ? { correlation: spec.correlation } : {}),
+    });
+    const label = spec.mappingLabel ?? 'resultMapping';
+    if (!Number.isFinite(spec.timeoutMs) || spec.timeoutMs <= 0) {
+        throw new Error(`[agent-sdk] ${spec.usedBy}: its wait needs a positive timeout, got ${spec.timeoutMs}`);
+    }
+    if (!spec.resultMapping)
+        return { binding, timeoutMs: spec.timeoutMs, fields: null };
+    const completion = events.require(spec.completion, spec.usedBy);
+    const carried = [...payloadShape(completion.payload, completion.defs).properties.keys()];
+    const fields = {};
+    for (const [target, expression] of Object.entries(spec.resultMapping)) {
+        if (target === 'status') {
+            throw new Error(`[agent-sdk] ${spec.usedBy}: ${label} maps 'status', which the SDK sets to how the job ended`);
+        }
+        const template = TEMPLATE.exec(String(expression));
+        if (!template || template[1] !== 'event') {
+            throw new Error(`[agent-sdk] ${spec.usedBy}: ${label}.${target} reads '${expression}'; a subscribe mapping reads the completion, so it must be \${ event.… }`);
+        }
+        const path = template[2];
+        if (!carried.includes(path.split('.')[0])) {
+            throw new Error(`[agent-sdk] ${spec.usedBy}: ${label}.${target} reads '${expression}', and ${completion.name} carries no '${path.split('.')[0]}' (it carries: ${carried.join(', ')})`);
+        }
+        fields[target] = path;
+    }
+    return { binding, timeoutMs: spec.timeoutMs, fields };
+}
+function getByPath(obj, path) {
+    return path.split('.').reduce((acc, key) => (acc && typeof acc === 'object' ? acc[key] : undefined), obj);
+}
+/**
+ * Wait for the job `id` names to settle, and say how it ended. Never throws:
+ * a wait that could not happen, or did not end in time, is `dispatched` with
+ * the reason, so the model keeps the job id and knows the job may still run.
+ */
+export async function awaitAsyncTool(events, waiter, bound, id, signal) {
+    const { binding, timeoutMs } = bound;
+    if (typeof id !== 'string' || id.length === 0) {
+        return { status: 'dispatched', warning: `The dispatch returned no '${binding.correlation}', so its ${binding.completion} cannot be waited on.` };
+    }
+    let settlement;
+    try {
+        settlement = await waiter.waitForSettlement({ binding, id, timeoutMs, ...(signal ? { signal } : {}) });
+    }
+    catch (err) {
+        return { status: 'dispatched', warning: `Waiting for ${binding.completion} failed: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (!settlement || settlement.kind !== binding.kind || settlement.id !== id) {
+        const missing = binding.failure ? `Neither ${binding.completion} nor ${binding.failure} arrived` : `${binding.completion} did not arrive`;
+        return {
+            status: 'dispatched',
+            warning: `${missing} for ${binding.correlation} ${id} within ${Math.round(timeoutMs / 1000)}s: the job is still running.`,
+        };
+    }
+    const outcome = events.outcome(settlement);
+    if (outcome.status === 'failed')
+        return { status: 'failed', reason: outcome.reason };
+    if (!bound.fields)
+        return { status: 'complete', fields: { ...outcome.result } };
+    const fields = {};
+    for (const [target, path] of Object.entries(bound.fields))
+        fields[target] = getByPath(settlement.payload, path);
+    return { status: 'complete', fields };
+}
+/**
+ * A wait's timeout as written in a declaration: `60s`, `2m`. Absent: `fallbackMs`
+ * (60 s). Anything else fails the load, naming who wrote it and where.
+ */
+export function parseWaitTimeout(usedBy, where, timeout, fallbackMs = 60_000) {
+    if (timeout === undefined)
+        return fallbackMs;
+    const match = typeof timeout === 'string' ? /^(\d+)(s|m)$/.exec(timeout) : null;
+    if (!match)
+        throw new Error(`[agent-sdk] ${usedBy}: ${where} '${String(timeout)}' is not a duration like 60s or 2m`);
+    const [, num, unit] = match;
+    return unit === 'm' ? parseInt(num, 10) * 60_000 : parseInt(num, 10) * 1_000;
+}
+/**
+ * What an async tool returns once its wait ends, for every kind of async tool:
+ * - complete: the dispatch with the completion's fields, `status: 'complete'`;
+ * - failed: a failed call with the declared reason, and the dispatch with `status: 'failed'`;
+ * - dispatched: the job may still be running, so the model keeps the dispatch
+ *   (`onDispatched`, default the dispatch) and is told why the wait ended. The
+ *   call itself did not fail, so it is not retried.
+ */
+export function asyncToolResult(dispatch, settled, onDispatched = dispatch) {
+    switch (settled.status) {
+        case 'complete':
+            return { success: true, data: { ...dispatch, ...settled.fields, status: 'complete' } };
+        case 'failed':
+            return { success: false, error: settled.reason, data: { ...dispatch, status: 'failed' } };
+        case 'dispatched':
+            return { success: true, data: { ...onDispatched, status: 'dispatched', warning: settled.warning } };
+    }
+}
+//# sourceMappingURL=async-binding.js.map

package/dist/tools/async-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-binding.js","sourceRoot":"","sources":["../../src/tools/async-binding.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,YAAY,GAIb,MAAM,uBAAuB,CAAC;AAkC/B,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AAEjD,gGAAgG;AAChG,MAAM,UAAU,aAAa,CAAC,MAAoB,EAAE,IAAmB;IACrE,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC;QAClC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,IAAI,eAAe,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,MAAM,4CAA4C,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,aAAa;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAErF,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IACzF,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QACtE,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,MAAM,KAAK,KAAK,yDAAyD,CAAC,CAAC;QACjH,CAAC;QACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,MAAM,WAAW,UAAU,0EAA0E,CAC9I,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,MAAM,WAAW,UAAU,UAAU,UAAU,CAAC,IAAI,gBAAgB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACtK,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;AACxD,CAAC;AAED,SAAS,SAAS,CAAC,GAAsC,EAAE,IAAY;IACrE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAU,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,GAA+B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;AAClJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAoB,EACpB,MAAmB,EACnB,KAAqB,EACrB,EAAW,EACX,MAAoB;IAEpB,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IACrC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,6BAA6B,OAAO,CAAC,WAAW,aAAa,OAAO,CAAC,UAAU,uBAAuB,EAAE,CAAC;IACnJ,CAAC;IACD,IAAI,UAAU,CAAC;IACf,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACzG,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,OAAO,CAAC,UAAU,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IAC5I,CAAC;IACD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,UAAU,QAAQ,OAAO,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,iBAAiB,CAAC;QAC1I,OAAO;YACL,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,GAAG,OAAO,QAAQ,OAAO,CAAC,WAAW,IAAI,EAAE,WAAW,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,8BAA8B;SAC1H,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IACrF,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAChF,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAChH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAAa,EAAE,OAAgB,EAAE,UAAU,GAAG,MAAM;IACnG,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChF,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,MAAM,KAAK,KAAK,KAAK,MAAM,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;IACrH,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAC5B,OAAO,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC;AAC/E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,QAA2C,EAC3C,OAA4B,EAC5B,eAAkD,QAAQ;IAE1D,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,UAAU;YACb,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;QACzF,KAAK,QAAQ;YACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC;QAC5F,KAAK,YAAY;YACf,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;IACxG,CAAC;AACH,CAAC"}

package/dist/tools/builtin-tools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Built-in SDK tools — interaction tools that every platform gets for free.
+ * These are SDK-owned (contract §2) and generated, not hand-authored by the host.
+ *
+ * Interaction tools return `{ __present_options: true, ... }` which the client
+ * SDK handles natively to present choices to the user.
+ *
+ * UI control tools (navigate_to, fill_form, submit_form, trigger_action,
+ * show_toast, control_player, open_entity, highlight_entity) were removed per
+ * ADR-0137 — they used the deprecated CustomEvent dispatch pattern that nothing
+ * handles. Navigation and UI control is now exclusively handled by OUI surfaces
+ * registered by the client app at runtime.
+ */
+import type { RegisteredTool } from './types.js';
+/**
+ * Generate the built-in interaction tools.
+ * These are the same tools every platform needs — present options, confirm, request decision.
+ */
+export declare function loadBuiltinTools(): RegisteredTool[];
+//# sourceMappingURL=builtin-tools.d.ts.map

package/dist/tools/builtin-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-tools.d.ts","sourceRoot":"","sources":["../../src/tools/builtin-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,EAAE,CAEnD"}

package/dist/tools/builtin-tools.js

@@ -0,0 +1,108 @@
+/**
+ * Generate the built-in interaction tools.
+ * These are the same tools every platform needs — present options, confirm, request decision.
+ */
+export function loadBuiltinTools() {
+    return loadInteractionTools();
+}
+function loadInteractionTools() {
+    return [
+        {
+            name: 'present_options',
+            description: 'Present a set of options to the user as clickable choices. Use when the user needs to pick from a discrete set (e.g. which item to use, a style, a name). Returns the selected value.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    prompt: { type: 'string', description: 'Question or prompt for the user' },
+                    options: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                label: { type: 'string', description: 'Option label' },
+                                value: { type: 'string', description: 'Option value (returned on selection)' },
+                                description: { type: 'string', description: 'Optional description' },
+                            },
+                            required: ['label', 'value'],
+                        },
+                    },
+                    style: { type: 'string', enum: ['buttons', 'list', 'cards'], description: 'Presentation style', default: 'buttons' },
+                    allowCustom: { type: 'boolean', description: 'Allow custom user input', default: false },
+                },
+                required: ['prompt', 'options'],
+            },
+            async execute(input) {
+                return {
+                    __present_options: true,
+                    prompt: input.prompt,
+                    options: input.options,
+                    style: input.style ?? 'buttons',
+                    ...(input.allowCustom ? { allowCustom: input.allowCustom } : {}),
+                };
+            },
+        },
+        {
+            name: 'confirm_action',
+            description: 'Ask the user a quick yes-or-no before something significant that needs no approval ("Ready to generate?"). ' +
+                'Never use it for a tool marked "Needs the user\'s approval": call that tool directly, and its approval card asks. ' +
+                'An answer here never approves anything. Returns true (confirmed) or false (cancelled).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    message: { type: 'string', description: 'What you are about to do' },
+                    details: { type: 'string', description: 'Additional context about the consequences' },
+                    confirmLabel: { type: 'string', description: 'Label for the confirm button', default: 'Confirm' },
+                    cancelLabel: { type: 'string', description: 'Label for the cancel button', default: 'Cancel' },
+                },
+                required: ['message'],
+            },
+            async execute(input) {
+                return {
+                    __present_options: true,
+                    prompt: input.message,
+                    options: [
+                        { label: input.confirmLabel ?? 'Confirm', value: 'true' },
+                        { label: input.cancelLabel ?? 'Cancel', value: 'false' },
+                    ],
+                    style: 'buttons',
+                };
+            },
+        },
+        {
+            name: 'request_user_decision',
+            description: 'Request a decision from the user when the agent needs direction (e.g. which approach to take, whether to proceed). More open-ended than present_options.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    question: { type: 'string', description: 'The question to ask' },
+                    context: { type: 'string', description: 'Background context for the decision' },
+                    options: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                label: { type: 'string' },
+                                value: { type: 'string' },
+                                description: { type: 'string' },
+                            },
+                            required: ['label', 'value'],
+                        },
+                        description: 'Optional choices; if omitted, the user gives free-form input',
+                    },
+                },
+                required: ['question'],
+            },
+            async execute(input) {
+                return {
+                    __present_options: true,
+                    prompt: input.question,
+                    ...(input.context ? { context: input.context } : {}),
+                    ...(input.options ? { options: input.options } : { options: [{ label: 'Proceed', value: 'proceed' }] }),
+                    style: 'list',
+                    allowCustom: true,
+                };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=builtin-tools.js.map

package/dist/tools/builtin-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-tools.js","sourceRoot":"","sources":["../../src/tools/builtin-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/entity-tools.d.ts

@@ -0,0 +1,6 @@
+import type { RegisteredTool } from './types.js';
+/**
+ * Load entity schemas and generate CRUD tools for each entity type.
+ */
+export declare function loadEntityToolsFromSchema(schemasDir: string): Promise<RegisteredTool[]>;
+//# sourceMappingURL=entity-tools.d.ts.map

package/dist/tools/entity-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-tools.d.ts","sourceRoot":"","sources":["../../src/tools/entity-tools.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,YAAY,CAAC;AAGvE;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAS7F"}

package/dist/tools/entity-tools.js

@@ -0,0 +1,227 @@
+/**
+ * Entity CRUD tool generation — auto-generates list/get/create/update/delete
+ * tools for each entity type defined in the schema.
+ *
+ * Instead of hand-authoring `list_characters`, `get_character`, `create_character`,
+ * etc., the SDK generates them from `entities/*.yaml`. Each tool's `execute`
+ * calls the corresponding `AgentApiSurface` method:
+ *   - list_<entity>   → apiSurface.queryEntities(type, filter)
+ *   - get_<entity>     → apiSurface.getEntity(type, id)
+ *   - create_<entity>  → apiSurface.mutateEntity(type, id, { create: true, set })
+ *   - update_<entity>  → apiSurface.mutateEntity(type, id, { set })
+ *   - delete_<entity>  → apiSurface.mutateEntity(type, id, {}) with delete semantics
+ *
+ * @see docs/reference/integration-contract.md §1b
+ */
+import { loadSchemas } from '@ouispec/agent-core';
+/**
+ * Load entity schemas and generate CRUD tools for each entity type.
+ */
+export async function loadEntityToolsFromSchema(schemasDir) {
+    const documents = await loadSchemas(schemasDir);
+    const entities = extractEntities(documents);
+    const tools = [];
+    for (const entity of entities) {
+        tools.push(...generateEntityCrudTools(entity));
+    }
+    return tools;
+}
+function extractEntities(documents) {
+    const entities = [];
+    const seen = new Set();
+    for (const doc of documents) {
+        if (doc.entity && !seen.has(doc.entity.id)) {
+            entities.push(doc.entity);
+            seen.add(doc.entity.id);
+        }
+        if (doc.domain?.entities) {
+            for (const e of doc.domain.entities) {
+                if (typeof e === 'object' && e !== null && 'id' in e) {
+                    const ent = e;
+                    if (!seen.has(ent.id)) {
+                        entities.push(ent);
+                        seen.add(ent.id);
+                    }
+                }
+            }
+        }
+    }
+    return entities;
+}
+function generateEntityCrudTools(entity) {
+    const type = entity.id;
+    const lower = type.toLowerCase();
+    const plural = pluralize(lower);
+    const props = entity.properties ?? {};
+    return [
+        generateListTool(type, plural, entity),
+        generateGetTool(type, lower, entity),
+        generateCreateTool(type, lower, entity, props),
+        generateUpdateTool(type, lower, entity, props),
+        generateDeleteTool(type, lower, entity),
+    ];
+}
+function generateListTool(type, lower, entity) {
+    return {
+        name: `list-${lower}`,
+        description: `List ${entity.description ?? type + 's'} with optional filtering and search.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                search: { type: 'string', description: 'Search by name/title' },
+                limit: { type: 'integer', description: 'Max results', default: 20 },
+                offset: { type: 'integer', description: 'Pagination offset', default: 0 },
+            },
+            additionalProperties: false,
+        },
+        async execute(input, ctx) {
+            const apiSurface = ctx.apiSurface;
+            if (!apiSurface)
+                return noSurfaceError(`list-${lower}`);
+            const filter = {};
+            if (input.search)
+                filter.search = input.search;
+            if (input.limit)
+                filter.limit = input.limit;
+            if (input.offset)
+                filter.offset = input.offset;
+            const results = await apiSurface.queryEntities(type, filter);
+            return { success: true, data: results };
+        },
+    };
+}
+function generateGetTool(type, lower, _entity) {
+    return {
+        name: `get-${lower}`,
+        description: `Get a single ${type} by ID.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: `The ${type} ID` },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        async execute(input, ctx) {
+            const apiSurface = ctx.apiSurface;
+            if (!apiSurface)
+                return noSurfaceError(`get-${lower}`);
+            const result = await apiSurface.getEntity(type, input.id);
+            return { success: true, data: result };
+        },
+    };
+}
+function generateCreateTool(type, lower, entity, props) {
+    const { properties, required } = convertEntityProperties(props);
+    return {
+        name: `create-${lower}`,
+        description: `Create a new ${type}.`,
+        inputSchema: {
+            type: 'object',
+            properties,
+            ...(required.length ? { required } : {}),
+            additionalProperties: false,
+        },
+        async execute(input, ctx) {
+            const apiSurface = ctx.apiSurface;
+            if (!apiSurface)
+                return noSurfaceError(`create-${lower}`);
+            const result = await apiSurface.mutateEntity(type, '', { create: true, set: input });
+            return { success: true, data: result };
+        },
+    };
+}
+function generateUpdateTool(type, lower, entity, props) {
+    const { properties } = convertEntityProperties(props, true);
+    return {
+        name: `update-${lower}`,
+        description: `Update properties of an existing ${type}.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: `The ${type} ID to update` },
+                ...properties,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        async execute(input, ctx) {
+            const apiSurface = ctx.apiSurface;
+            if (!apiSurface)
+                return noSurfaceError(`update-${lower}`);
+            const { id, ...set } = input;
+            const result = await apiSurface.mutateEntity(type, id, { set });
+            return { success: true, data: result };
+        },
+    };
+}
+function generateDeleteTool(type, lower, _entity) {
+    return {
+        name: `delete-${lower}`,
+        description: `Delete a ${type} by ID.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: `The ${type} ID to delete` },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        async execute(input, ctx) {
+            const apiSurface = ctx.apiSurface;
+            if (!apiSurface)
+                return noSurfaceError(`delete-${lower}`);
+            // mutateEntity with disconnect signals deletion; hosts interpret accordingly
+            await apiSurface.mutateEntity(type, input.id, { disconnect: ['*'] });
+            return { success: true, data: { deleted: true, id: input.id } };
+        },
+    };
+}
+// ─── helpers ────────────────────────────────────────────────────────────────
+function convertEntityProperties(props, allOptional = false) {
+    const properties = {};
+    const required = [];
+    for (const [name, prop] of Object.entries(props)) {
+        // Skip relation properties at the CRUD layer (they're managed via link/unlink)
+        if (prop.type === 'relation')
+            continue;
+        properties[name] = convertEntityProperty(prop);
+        if (prop.required && !allOptional) {
+            required.push(name);
+        }
+    }
+    return { properties, required };
+}
+function convertEntityProperty(prop) {
+    const schema = {};
+    if (prop.type === 'enum') {
+        schema.type = 'string';
+        if (prop.values)
+            schema.enum = prop.values;
+    }
+    else if (prop.type === 'array') {
+        schema.type = 'array';
+        if (prop.items)
+            schema.items = { type: prop.items.type };
+    }
+    else {
+        schema.type = prop.type;
+    }
+    if (prop.description)
+        schema.description = prop.description;
+    return schema;
+}
+function pluralize(word) {
+    if (word.endsWith('s') || word.endsWith('x') || word.endsWith('z'))
+        return word + 'es';
+    if (word.endsWith('y') && !'aeiou'.includes(word[word.length - 2]))
+        return word.slice(0, -1) + 'ies';
+    return word + 's';
+}
+function noSurfaceError(toolName) {
+    return {
+        success: false,
+        error: `Tool '${toolName}' requires an AgentApiSurface binding. Provide apiSurface in the worker config.`,
+    };
+}
+//# sourceMappingURL=entity-tools.js.map

package/dist/tools/entity-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-tools.js","sourceRoot":"","sources":["../../src/tools/entity-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/input-validation.d.ts

@@ -0,0 +1,16 @@
+export type ToolInputValidation = {
+    ok: true;
+    value: Record<string, unknown>;
+} | {
+    ok: false;
+    errors: string[];
+};
+export type ToolInputValidator = (input: unknown) => ToolInputValidation;
+/**
+ * Compile a validator for a tool's input schema.
+ *
+ * A schema that cannot be compiled yields a validator that rejects every call: a tool
+ * whose input cannot be checked does not run.
+ */
+export declare function createToolInputValidator(inputSchema: Record<string, unknown> | undefined): ToolInputValidator;
+//# sourceMappingURL=input-validation.d.ts.map

package/dist/tools/input-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-validation.d.ts","sourceRoot":"","sources":["../../src/tools/input-validation.ts"],"names":[],"mappings":"AA+BA,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,mBAAmB,CAAC;AAiBzE;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC/C,kBAAkB,CA6BpB"}