@ouispec/agent-worker 0.1.0

package/dist/openapi/loader.js

@@ -0,0 +1,361 @@
+/**
+ * loadOpenApiTools — a product's OpenAPI 3 document becomes its agent tools
+ * (ADR-0181 §2). No second manifest format: the document is read directly.
+ *
+ * - An operation is a tool only when its `x-agent` says `expose: true`.
+ * - Its name is its `operationId`; its description its `summary` and `description`;
+ *   its input its parameters and JSON request body, validated by the worker before
+ *   every call.
+ * - Its effect and `destructive` come from `x-agent`, and are on the tool for
+ *   approvals to key on (ADR-0228).
+ * - Its required permissions are its standard `security` requirement.
+ * - A call runs as the caller the required `actAs` seam names, and the API decides
+ *   what that caller may do.
+ * - The product's own assistant (`audience: 'pa'`) gets only the operations flagged
+ *   `pa: true`, and the flag is refused on anything but a read (ADR-0227 §2.1).
+ * - An operation that starts a job names its declared completion event in
+ *   `x-async-binding` (W9). It is checked against the product's declarations at
+ *   load, and with a waiter the tool waits for the job to settle.
+ *
+ * Anything that cannot become a safe, callable tool is refused at load, naming the
+ * operation.
+ */
+import { effectAccess, effectKind } from '@ouispec/bindings';
+import { asyncToolResult, awaitAsyncTool, bindAsyncTool, parseWaitTimeout } from '../tools/async-binding.js';
+import { HTTP_METHODS, OpenApiToolError, createResolver, toInputSchema, } from './document.js';
+import { executeOperation } from './executor.js';
+import { readAgentExposure } from './x-agent.js';
+/** Model providers accept tool names of this shape. */
+const TOOL_NAME = /^[a-zA-Z0-9_-]{1,64}$/;
+const QUERY_STYLES = new Set(['form', 'spaceDelimited', 'pipeDelimited', 'deepObject']);
+function describeOperation(method, path, operationId) {
+    return `${method.toUpperCase()} ${path}${operationId ? ` (${operationId})` : ''}`;
+}
+function jsonMediaType(content) {
+    return Object.keys(content ?? {}).find((type) => /^application\/(?:[\w.+-]+\+)?json(?:\s*;.*)?$/i.test(type));
+}
+/** The operation's parameters: the path item's, overridden by the operation's own of the same name and place. */
+function mergedParameters(pathParams, opParams, resolver, where) {
+    const byKey = new Map();
+    for (const raw of [...(pathParams ?? []), ...(opParams ?? [])]) {
+        const param = resolver.deref(raw, where);
+        if (!param || typeof param.name !== 'string' || !['path', 'query', 'header', 'cookie'].includes(param.in)) {
+            throw new OpenApiToolError(`${where}: a parameter has no name or no valid "in"`);
+        }
+        byKey.set(`${param.in}:${param.name}`, param);
+    }
+    return [...byKey.values()];
+}
+function effectSentences(effect, destructive, consequence) {
+    const sentences = [];
+    switch (effectKind(effect)) {
+        case 'job':
+            sentences.push('It starts a job: the call returns once the job has started, and the job is done only when its status says complete.');
+            break;
+        case 'transaction':
+            sentences.push('It is irreversible: it runs only on the person’s approval of this exact call.');
+            break;
+        default:
+            break;
+    }
+    if (destructive)
+        sentences.push('It removes or replaces something the person made.');
+    if (consequence)
+        sentences.push(consequence);
+    return sentences;
+}
+function buildInput(path, parameters, requestBody, resolver, where) {
+    const properties = {};
+    const required = [];
+    const placements = new Map();
+    const requiredHeaders = [];
+    const templateNames = [...path.matchAll(/\{([^}]+)\}/g)].map((m) => m[1]);
+    for (const name of templateNames) {
+        if (!parameters.some((p) => p.in === 'path' && p.name === name)) {
+            throw new OpenApiToolError(`${where}: the path names {${name}}, which no path parameter declares`);
+        }
+    }
+    for (const param of parameters) {
+        if (param.in === 'header' || param.in === 'cookie') {
+            // The caller's identity and context headers come only from actAs, never from the model.
+            if (param.required) {
+                if (param.in === 'cookie')
+                    throw new OpenApiToolError(`${where}: it requires the cookie ${param.name}, which a tool cannot send`);
+                requiredHeaders.push(param.name);
+            }
+            continue;
+        }
+        if (param.in === 'path' && !templateNames.includes(param.name)) {
+            throw new OpenApiToolError(`${where}: path parameter ${param.name} is not in the path`);
+        }
+        if (!param.schema) {
+            throw new OpenApiToolError(`${where}: parameter ${param.name} declares no schema (content-typed parameters are not supported)`);
+        }
+        if (properties[param.name]) {
+            throw new OpenApiToolError(`${where}: parameter ${param.name} is both a path and a query parameter`);
+        }
+        const schema = toInputSchema(param.schema, resolver, where);
+        if (param.description && schema.description === undefined)
+            schema.description = param.description;
+        properties[param.name] = schema;
+        if (param.in === 'path' || param.required)
+            required.push(param.name);
+        if (param.in === 'path') {
+            if (param.style !== undefined && param.style !== 'simple') {
+                throw new OpenApiToolError(`${where}: path parameter ${param.name} uses style ${param.style}; only simple is supported`);
+            }
+            placements.set(param.name, { in: 'path', name: param.name });
+        }
+        else {
+            const style = (param.style ?? 'form');
+            if (!QUERY_STYLES.has(style))
+                throw new OpenApiToolError(`${where}: query parameter ${param.name} uses style ${style}, which is not supported`);
+            placements.set(param.name, { in: 'query', name: param.name, style, explode: param.explode ?? style === 'form' });
+        }
+    }
+    if (requestBody) {
+        const mediaType = jsonMediaType(requestBody.content);
+        if (!mediaType) {
+            const types = Object.keys(requestBody.content ?? {});
+            throw new OpenApiToolError(`${where}: its request body is ${types.join(', ') || 'undeclared'}; a tool sends JSON only`);
+        }
+        const bodySchema = toInputSchema(requestBody.content[mediaType].schema ?? {}, resolver, where);
+        const fields = bodySchema.properties;
+        const closedObject = bodySchema.type === 'object' &&
+            fields !== undefined &&
+            (bodySchema.additionalProperties === undefined || bodySchema.additionalProperties === false) &&
+            !['allOf', 'anyOf', 'oneOf', 'not', 'if', 'patternProperties', 'dependentSchemas'].some((k) => k in bodySchema);
+        const collides = closedObject && Object.keys(fields).some((name) => name in properties || name === 'body');
+        if (closedObject && !collides) {
+            // A closed object body's fields sit beside the parameters.
+            for (const [name, schema] of Object.entries(fields)) {
+                properties[name] = schema;
+                placements.set(name, { in: 'bodyField', name });
+            }
+            for (const name of bodySchema.required ?? [])
+                if (!required.includes(name))
+                    required.push(name);
+        }
+        else {
+            if (properties.body)
+                throw new OpenApiToolError(`${where}: a parameter is named "body", which its request body needs`);
+            if (requestBody.description && bodySchema.description === undefined)
+                bodySchema.description = requestBody.description;
+            properties.body = bodySchema;
+            placements.set('body', { in: 'body' });
+            if (requestBody.required)
+                required.push('body');
+        }
+    }
+    return {
+        schema: {
+            type: 'object',
+            properties,
+            ...(required.length > 0 ? { required } : {}),
+            // A tool accepts exactly what its operation declares (ADR-0182 §5).
+            additionalProperties: false,
+        },
+        placements,
+        requiredHeaders,
+    };
+}
+function checkSecurity(security, schemes, where) {
+    if (security === undefined) {
+        throw new OpenApiToolError(`${where}: an exposed operation declares its security requirement (operation or document \`security\`; [] for a public one)`);
+    }
+    if (!Array.isArray(security))
+        throw new OpenApiToolError(`${where}: security is a list of requirement objects`);
+    return security.map((requirement) => {
+        if (!requirement || typeof requirement !== 'object' || Array.isArray(requirement)) {
+            throw new OpenApiToolError(`${where}: security is a list of requirement objects`);
+        }
+        const out = {};
+        for (const [scheme, scopes] of Object.entries(requirement)) {
+            if (!schemes || !Object.prototype.hasOwnProperty.call(schemes, scheme)) {
+                throw new OpenApiToolError(`${where}: security names scheme "${scheme}", which components.securitySchemes does not declare`);
+            }
+            if (!Array.isArray(scopes) || scopes.some((s) => typeof s !== 'string')) {
+                throw new OpenApiToolError(`${where}: security scheme "${scheme}" lists its scopes as strings`);
+            }
+            out[scheme] = [...scopes];
+        }
+        return out;
+    });
+}
+function bindOperation(raw, effect, options, where) {
+    if (raw === undefined)
+        return null;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        throw new OpenApiToolError(`${where}: x-async-binding is an object`);
+    const binding = raw;
+    if (typeof binding.event !== 'string' || binding.event.trim() === '') {
+        throw new OpenApiToolError(`${where}: x-async-binding.event names the declared completion the job ends with`);
+    }
+    const kind = effectKind(effect);
+    if (kind !== 'job' && kind !== 'transaction') {
+        throw new OpenApiToolError(`${where}: x-async-binding waits on a job, but its effect is ${kind}; declare effect job`);
+    }
+    if (!options.events) {
+        throw new OpenApiToolError(`${where} waits on '${binding.event}', but no event declarations were given (OpenApiToolsOptions.events)`);
+    }
+    for (const key of ['failure', 'correlation', 'idField']) {
+        if (binding[key] !== undefined && typeof binding[key] !== 'string') {
+            throw new OpenApiToolError(`${where}: x-async-binding.${key} is ${key === 'failure' ? 'an event' : 'a field'} name`);
+        }
+    }
+    const effectTimeout = typeof effect === 'object' && 'timeoutMs' in effect ? effect.timeoutMs : undefined;
+    let bound;
+    try {
+        bound = bindAsyncTool(options.events, {
+            usedBy: where,
+            completion: binding.event,
+            ...(typeof binding.failure === 'string' ? { failure: binding.failure } : {}),
+            ...(typeof binding.correlation === 'string' ? { correlation: binding.correlation } : {}),
+            timeoutMs: parseWaitTimeout(where, 'x-async-binding.timeout', binding.timeout, effectTimeout ?? 60_000),
+        });
+    }
+    catch (err) {
+        throw new OpenApiToolError(err instanceof Error ? err.message.replace(/^\[agent-sdk\] /, '') : String(err));
+    }
+    return { bound, idField: typeof binding.idField === 'string' ? binding.idField : bound.binding.correlation };
+}
+function checkOptions(options) {
+    if (!options || typeof options.actAs !== 'function') {
+        throw new OpenApiToolError('loadOpenApiTools: actAs is required: it names who each call acts as, and has no default');
+    }
+    if (options.audience !== 'agents' && options.audience !== 'pa') {
+        throw new OpenApiToolError('loadOpenApiTools: audience is "agents" or "pa"');
+    }
+    let url;
+    try {
+        url = new URL(options.baseUrl);
+    }
+    catch {
+        throw new OpenApiToolError(`loadOpenApiTools: baseUrl "${String(options.baseUrl)}" is not an absolute http(s) URL`);
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new OpenApiToolError(`loadOpenApiTools: baseUrl "${options.baseUrl}" is not an absolute http(s) URL`);
+    }
+    return options.baseUrl.replace(/\/+$/, '');
+}
+/**
+ * Turn an OpenAPI 3 document into tools. Throws `OpenApiToolError`, naming the
+ * operation, for anything it refuses.
+ */
+export function loadOpenApiTools(document, options) {
+    const baseUrl = checkOptions(options);
+    if (!document || typeof document.openapi !== 'string' || !/^3\.\d+(\.\d+)?/.test(document.openapi)) {
+        throw new OpenApiToolError('loadOpenApiTools: this is not an OpenAPI 3 document (its `openapi` field is not 3.x)');
+    }
+    const resolver = createResolver(document);
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    const { events, waiter } = options;
+    const schemes = document.components?.securitySchemes;
+    const tools = [];
+    const names = new Map();
+    for (const [path, pathItem] of Object.entries(document.paths ?? {})) {
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem?.[method];
+            if (!operation)
+                continue;
+            const where = describeOperation(method, path, operation.operationId);
+            const exposure = readAgentExposure(operation['x-agent'], { method, operationId: operation.operationId }, where);
+            if (!exposure?.expose)
+                continue;
+            const operationId = operation.operationId;
+            if (!operationId)
+                throw new OpenApiToolError(`${where}: an exposed operation needs an operationId, its tool name`);
+            if (!TOOL_NAME.test(operationId)) {
+                throw new OpenApiToolError(`${where}: operationId "${operationId}" is not a tool name (letters, digits, _ and -, at most 64)`);
+            }
+            const clash = names.get(operationId);
+            if (clash)
+                throw new OpenApiToolError(`${where}: operationId "${operationId}" is also ${clash}`);
+            names.set(operationId, describeOperation(method, path));
+            const security = checkSecurity(operation.security ?? document.security, schemes, where);
+            const parameters = mergedParameters(pathItem.parameters, operation.parameters, resolver, where);
+            const requestBody = operation.requestBody ? resolver.deref(operation.requestBody, where) : undefined;
+            const input = buildInput(path, parameters, requestBody, resolver, where);
+            const effect = exposure.effect;
+            const asyncOperation = bindOperation(operation['x-async-binding'], effect, options, where);
+            const bound = asyncOperation?.bound;
+            if (options.audience === 'pa' && !exposure.pa)
+                continue;
+            const isRead = effectAccess(effect) === 'read';
+            // The worker's quota reads this flag: a read is side-effect free.
+            if (isRead)
+                input.schema.sideEffects = false;
+            const summary = operation.summary?.trim();
+            const detail = operation.description?.trim();
+            const description = [
+                [summary, detail && detail !== summary ? detail : undefined].filter(Boolean).join('\n\n') || operationId,
+                ...effectSentences(effect, exposure.destructive, exposure.consequence),
+                // Promise the event only when the tool will actually wait for it.
+                ...(bound && options.waiter
+                    ? [`It waits for ${bound.binding.completion}, and returns the finished result, or why the job failed.`]
+                    : []),
+            ].join(' ');
+            const plan = {
+                operationId,
+                method,
+                path,
+                baseUrl,
+                placements: input.placements,
+                requiredHeaders: input.requiredHeaders,
+                actAs: options.actAs,
+                fetch: fetchImpl,
+            };
+            const irreversible = effectKind(effect) === 'transaction';
+            tools.push({
+                name: operationId,
+                kind: 'backend',
+                description,
+                inputSchema: input.schema,
+                effect,
+                destructive: exposure.destructive,
+                // The approval card's title and consequence come from the operation (ADR-0228 §2.2.2).
+                title: summary || operationId,
+                ...(exposure.consequence ? { consequence: exposure.consequence } : {}),
+                operation: {
+                    operationId,
+                    method,
+                    path,
+                    title: summary || operationId,
+                    security,
+                    ...(bound
+                        ? {
+                            async: {
+                                completion: bound.binding.completion,
+                                ...(bound.binding.failure ? { failure: bound.binding.failure } : {}),
+                                correlation: bound.binding.correlation,
+                                idField: asyncOperation.idField,
+                                timeoutMs: bound.timeoutMs,
+                            },
+                        }
+                        : {}),
+                },
+                async execute(args, ctx) {
+                    // An irreversible act runs only on the person's approval of this exact call
+                    // (ADR-0228). The worker runs it with that approval once the person gave it;
+                    // any other runner (an MCP server, a host calling the tool itself) has none.
+                    if (irreversible && !ctx.approval) {
+                        return {
+                            success: false,
+                            error: `"${operationId}" is irreversible: it runs only on the person’s approval of this exact call, and this call has none`,
+                            data: { code: 'APPROVAL_REQUIRED' },
+                        };
+                    }
+                    const result = await executeOperation(plan, args, ctx);
+                    if (!bound || !waiter || !result.success)
+                        return result;
+                    // The job started: wait for its declared completion or failure.
+                    const dispatch = result.data && typeof result.data === 'object' && !Array.isArray(result.data) ? result.data : {};
+                    const settled = await awaitAsyncTool(events, waiter, bound, dispatch[asyncOperation.idField], ctx.abortSignal);
+                    return asyncToolResult(dispatch, settled);
+                },
+            });
+        }
+    }
+    return tools;
+}
+//# sourceMappingURL=loader.js.map

package/dist/openapi/loader.js.map

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

package/dist/openapi/x-agent.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `x-agent`: how an operation opts in as an agent tool (ADR-0181 §3, ADR-0227 §2.1).
+ *
+ * ```yaml
+ * x-agent:
+ *   expose: true            # without it, the operation is not a tool
+ *   effect: mutate          # ADR-0226 §2.6: view | file | mutate | job | transaction, or its object form
+ *   destructive: true       # optional, on a write: removes or replaces something the person made
+ *   consequence: "..."      # optional: what happens, for the tool's description and an approval's preview
+ *   pa: true                # optional: the product's own assistant may call it; only on a read
+ * ```
+ *
+ * Every field is checked, on every operation that carries `x-agent`, exposed or not.
+ */
+import { type ActionEffect, type ActionEffectKind } from '@ouispec/bindings';
+import { type HttpMethod } from './document.js';
+export interface AgentExposure {
+    expose: boolean;
+    effect?: ActionEffect;
+    destructive: boolean;
+    consequence?: string;
+    pa: boolean;
+}
+/** The effects an API operation can have. The others (selection, navigate, open, edit) only a page has. */
+export declare const API_OPERATION_EFFECTS: readonly ActionEffectKind[];
+/**
+ * Read and check an operation's `x-agent`. Returns null when it has none.
+ * `where` names the operation in every refusal.
+ */
+export declare function readAgentExposure(raw: unknown, op: {
+    method: HttpMethod;
+    operationId?: string;
+}, where: string): AgentExposure | null;
+//# sourceMappingURL=x-agent.d.ts.map

package/dist/openapi/x-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x-agent.d.ts","sourceRoot":"","sources":["../../src/openapi/x-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAA2C,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtH,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,EAAE,OAAO,CAAC;CACb;AAID,2GAA2G;AAC3G,eAAO,MAAM,qBAAqB,EAAE,SAAS,gBAAgB,EAAqD,CAAC;AAiCnH;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,EAAE,EAAE;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAChD,KAAK,EAAE,MAAM,GACZ,aAAa,GAAG,IAAI,CA8CtB"}

package/dist/openapi/x-agent.js

@@ -0,0 +1,102 @@
+/**
+ * `x-agent`: how an operation opts in as an agent tool (ADR-0181 §3, ADR-0227 §2.1).
+ *
+ * ```yaml
+ * x-agent:
+ *   expose: true            # without it, the operation is not a tool
+ *   effect: mutate          # ADR-0226 §2.6: view | file | mutate | job | transaction, or its object form
+ *   destructive: true       # optional, on a write: removes or replaces something the person made
+ *   consequence: "..."      # optional: what happens, for the tool's description and an approval's preview
+ *   pa: true                # optional: the product's own assistant may call it; only on a read
+ * ```
+ *
+ * Every field is checked, on every operation that carries `x-agent`, exposed or not.
+ */
+import { effectAccess, effectKind, effectProblem } from '@ouispec/bindings';
+import { OpenApiToolError } from './document.js';
+const KEYS = new Set(['expose', 'effect', 'destructive', 'consequence', 'pa']);
+/** The effects an API operation can have. The others (selection, navigate, open, edit) only a page has. */
+export const API_OPERATION_EFFECTS = ['view', 'file', 'mutate', 'job', 'transaction'];
+/** Methods that change data by definition (RFC 9110): a read-only effect on one is a mistake. */
+const WRITE_METHODS = new Set(['put', 'patch', 'delete']);
+/**
+ * The effect as the tool carries it. A `mutate` or `transaction` is through this
+ * operation, so its `operation` is filled in; one naming another operation is refused.
+ */
+function readEffect(value, operationId, where) {
+    let effect = value;
+    if (effect === 'mutate' || effect === 'transaction' || effect === 'job')
+        effect = { kind: effect };
+    if (effect && typeof effect === 'object' && !Array.isArray(effect)) {
+        const e = { ...effect };
+        if (e.kind === 'mutate' || e.kind === 'transaction') {
+            if (e.operation !== undefined && e.operation !== operationId) {
+                throw new OpenApiToolError(`${where}: x-agent.effect names operation "${String(e.operation)}"; an operation's effect is its own`);
+            }
+            if (operationId)
+                e.operation = operationId;
+        }
+        effect = e;
+    }
+    const problem = effectProblem(effect);
+    if (problem)
+        throw new OpenApiToolError(`${where}: x-agent.effect: ${problem}`);
+    const kind = effectKind(effect);
+    if (!API_OPERATION_EFFECTS.includes(kind)) {
+        throw new OpenApiToolError(`${where}: x-agent.effect ${kind} is a page's effect; an API operation's effect is one of ${API_OPERATION_EFFECTS.join(', ')}`);
+    }
+    return effect;
+}
+/**
+ * Read and check an operation's `x-agent`. Returns null when it has none.
+ * `where` names the operation in every refusal.
+ */
+export function readAgentExposure(raw, op, where) {
+    if (raw === undefined)
+        return null;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        throw new OpenApiToolError(`${where}: x-agent is an object`);
+    const x = raw;
+    for (const key of Object.keys(x)) {
+        if (!KEYS.has(key))
+            throw new OpenApiToolError(`${where}: x-agent has an unknown key "${key}" (${[...KEYS].join(', ')})`);
+    }
+    const flag = (key) => {
+        if (x[key] === undefined)
+            return false;
+        if (typeof x[key] !== 'boolean')
+            throw new OpenApiToolError(`${where}: x-agent.${key} is true or false`);
+        return x[key];
+    };
+    const expose = flag('expose');
+    const destructive = flag('destructive');
+    const pa = flag('pa');
+    if (x.consequence !== undefined && (typeof x.consequence !== 'string' || x.consequence.trim() === '')) {
+        throw new OpenApiToolError(`${where}: x-agent.consequence is a non-empty sentence`);
+    }
+    if (expose && x.effect === undefined)
+        throw new OpenApiToolError(`${where}: x-agent.effect is required on an exposed operation`);
+    const effect = x.effect === undefined ? undefined : readEffect(x.effect, op.operationId, where);
+    const access = effectAccess(effect);
+    if (destructive && access !== 'write') {
+        throw new OpenApiToolError(`${where}: x-agent.destructive applies only to a write; this operation's effect is read-only`);
+    }
+    if (effect && access === 'read' && WRITE_METHODS.has(op.method)) {
+        throw new OpenApiToolError(`${where}: effect ${effectKind(effect)} is read-only, but ${op.method.toUpperCase()} changes data; declare what it changes`);
+    }
+    if (pa) {
+        if (!expose)
+            throw new OpenApiToolError(`${where}: x-agent.pa needs expose: true`);
+        if (access !== 'read') {
+            throw new OpenApiToolError(`${where}: x-agent.pa is allowed only on a read-only operation (effect view); this one is ${effectKind(effect)}, a write`);
+        }
+    }
+    return {
+        expose,
+        ...(effect !== undefined ? { effect } : {}),
+        destructive,
+        ...(typeof x.consequence === 'string' ? { consequence: x.consequence } : {}),
+        pa,
+    };
+}
+//# sourceMappingURL=x-agent.js.map

package/dist/openapi/x-agent.js.map

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

package/dist/orchestrator.d.ts

@@ -0,0 +1,12 @@
+import type { AgentWorkerConfig, AgentTurnInput, AgentTurnResult } from './types.js';
+/**
+ * Run a complete agent turn using the Vercel AI SDK.
+ *
+ * A turn runs in one or more segments. Each segment is one `streamText` call
+ * with a fixed tool set. When a UI action changes what the client's page
+ * offers (navigating is the common case), the segment ends and the turn
+ * continues in a new one whose tools are the new page's (ADR-0209 D3). The
+ * round cap counts across segments.
+ */
+export declare function runAgentTurn(config: AgentWorkerConfig, input: AgentTurnInput): Promise<AgentTurnResult>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAmC,MAAM,YAAY,CAAC;AAiDtH;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,eAAe,CAAC,CAkyB1B"}