@ouispec/agent-worker 0.1.0

package/dist/container/server.js

@@ -0,0 +1,119 @@
+/**
+ * The container host adapter: a long-running HTTP server that takes turns.
+ *
+ * The host's API POSTs a turn to `/turns` with the worker's key; the worker
+ * answers `202` once the turn is accepted and runs it, streaming to the
+ * realtime server as the Lambda adapter does. The same runtime core runs it
+ * (runtime/turn-runner.ts), so a turn behaves the same on either host.
+ *
+ *   POST /turns    AgentTurnPayload → 202 { turnId }
+ *                  400 not a turn · 401 wrong key · 409 turn already running
+ *                  503 at capacity or shutting down (retry later)
+ *   GET  /health   200 { status, running, capacity, model }
+ */
+import http from 'node:http';
+import crypto from 'node:crypto';
+import { createAgentTurnRunner, payloadRefusal } from '../runtime/turn-runner.js';
+export async function startContainerAgentWorker(config) {
+    const missing = [
+        !(Number.isInteger(config?.port) && config.port >= 0) && 'port (the port to listen on, 0 for any free port)',
+        !(typeof config?.workerApiKey === 'string' && config.workerApiKey.length > 0) && 'workerApiKey (the key the host sends as x-api-key)',
+    ].filter(Boolean);
+    if (missing.length > 0)
+        throw new Error(`[agent-sdk] Missing required configuration: ${missing.join('; ')}`);
+    const runner = createAgentTurnRunner(config);
+    const capacity = config.maxConcurrentTurns ?? 8;
+    const maxBodyBytes = config.maxBodyBytes ?? 1024 * 1024;
+    const expectedKey = crypto.createHash('sha256').update(config.workerApiKey).digest();
+    const isKey = (presented) => typeof presented === 'string' &&
+        presented.length > 0 &&
+        crypto.timingSafeEqual(crypto.createHash('sha256').update(presented).digest(), expectedKey);
+    const inFlight = new Map();
+    let closing = false;
+    const send = (res, status, body) => {
+        res.writeHead(status, { 'content-type': 'application/json' });
+        res.end(body === undefined ? undefined : JSON.stringify(body));
+    };
+    const server = http.createServer((req, res) => {
+        if (req.method === 'GET' && req.url === '/health') {
+            send(res, closing ? 503 : 200, { status: closing ? 'closing' : 'ok', running: inFlight.size, capacity, model: runner.model });
+            return;
+        }
+        if (req.method !== 'POST' || req.url !== '/turns') {
+            send(res, 404, { error: 'not found' });
+            return;
+        }
+        if (!isKey(req.headers['x-api-key'])) {
+            send(res, 401, { error: 'Invalid or missing API key' });
+            return;
+        }
+        let size = 0;
+        const chunks = [];
+        req.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > maxBodyBytes) {
+                send(res, 413, { error: `body larger than ${maxBodyBytes} bytes` });
+                req.destroy();
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on('end', () => {
+            if (res.writableEnded)
+                return;
+            let payload;
+            try {
+                payload = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+            }
+            catch {
+                send(res, 400, { error: 'body is not JSON' });
+                return;
+            }
+            const refusal = payloadRefusal(payload);
+            if (refusal) {
+                send(res, 400, { error: refusal });
+                return;
+            }
+            if (inFlight.has(payload.turnId)) {
+                send(res, 409, { error: `turn ${payload.turnId} is already running` });
+                return;
+            }
+            if (closing || inFlight.size >= capacity) {
+                send(res, 503, { error: closing ? 'shutting down' : 'at capacity' });
+                return;
+            }
+            const run = runner
+                .run(payload)
+                .then((outcome) => config.onTurnEnd?.(outcome))
+                .catch((err) => {
+                // A turn's own failure is an outcome, not a throw; this is the
+                // runtime failing around it (getDb, say). Nothing retries a
+                // container turn, so it is logged where the host will see it.
+                runner.logger.error('[agent-sdk] Turn could not run', {
+                    turnId: payload.turnId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            })
+                .finally(() => inFlight.delete(payload.turnId));
+            inFlight.set(payload.turnId, run);
+            send(res, 202, { turnId: payload.turnId });
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(config.port, () => {
+            server.off('error', reject);
+            resolve();
+        });
+    });
+    return {
+        port: server.address().port,
+        running: () => inFlight.size,
+        async close() {
+            closing = true;
+            await Promise.allSettled([...inFlight.values()]);
+            await new Promise((resolve) => server.close(() => resolve()));
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/container/server.js.map

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

package/dist/emit/http-adapter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * HTTP emit adapter — sends events to a realtime server via HTTP POST /api/emit.
+ * This is the default adapter used when the worker runs as a Lambda/container
+ * and the realtime server is a separate process.
+ */
+import type { RealtimeEmitAdapter } from './types.js';
+export interface HttpEmitAdapterConfig {
+    url: string;
+    apiKey: string;
+    timeoutMs?: number;
+}
+export declare function createHttpEmitAdapter(config: HttpEmitAdapterConfig): RealtimeEmitAdapter;
+/** Throws, naming the value, unless the realtime server's URL and key are both given. */
+export declare function requireRealtime(url: string | undefined, apiKey: string | undefined): void;
+//# sourceMappingURL=http-adapter.d.ts.map

package/dist/emit/http-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter.d.ts","sourceRoot":"","sources":["../../src/emit/http-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,mBAAmB,CA2BxF;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAKzF"}

package/dist/emit/http-adapter.js

@@ -0,0 +1,35 @@
+export function createHttpEmitAdapter(config) {
+    const { url, apiKey, timeoutMs = 5000 } = config;
+    // No silent no-op: an adapter without a URL used to drop every event, so a
+    // misconfigured worker streamed its turns to nobody.
+    requireRealtime(url, apiKey);
+    return {
+        async emit(room, event, data) {
+            try {
+                const res = await fetch(`${url}/api/emit`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-Api-Key': apiKey,
+                    },
+                    body: JSON.stringify({ event, data, rooms: [room] }),
+                    signal: AbortSignal.timeout(timeoutMs),
+                });
+                if (!res.ok) {
+                    console.warn(`[agent-worker] Emit failed: ${res.status} for event ${event}`);
+                }
+            }
+            catch (error) {
+                console.warn(`[agent-worker] Emit error for ${event}:`, error instanceof Error ? error.message : error);
+            }
+        },
+    };
+}
+/** Throws, naming the value, unless the realtime server's URL and key are both given. */
+export function requireRealtime(url, apiKey) {
+    const missing = [!url && 'realtime.url', !apiKey && 'realtime.apiKey'].filter(Boolean);
+    if (missing.length > 0) {
+        throw new Error(`[agent-sdk] Missing required configuration: ${missing.join(', ')} (the realtime server that carries turns and UI actions)`);
+    }
+}
+//# sourceMappingURL=http-adapter.js.map

package/dist/emit/http-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter.js","sourceRoot":"","sources":["../../src/emit/http-adapter.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,qBAAqB,CAAC,MAA6B;IACjE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACjD,2EAA2E;IAC3E,qDAAqD;IACrD,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAE7B,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,KAAa,EAAE,IAAa;YACnD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,WAAW,EAAE;oBACzC,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,WAAW,EAAE,MAAM;qBACpB;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;iBACvC,CAAC,CAAC;gBAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,OAAO,CAAC,IAAI,CAAC,+BAA+B,GAAG,CAAC,MAAM,cAAc,KAAK,EAAE,CAAC,CAAC;gBAC/E,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,iCAAiC,KAAK,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC1G,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,eAAe,CAAC,GAAuB,EAAE,MAA0B;IACjF,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,cAAc,EAAE,CAAC,MAAM,IAAI,iBAAiB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,+CAA+C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IAC/I,CAAC;AACH,CAAC"}

package/dist/emit/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Realtime emit adapter — how the worker sends events to connected clients.
+ * Default implementation: HTTP POST to a Socket.IO server's /api/emit endpoint.
+ * Platforms can provide custom adapters (direct Socket.IO, Redis pub/sub, etc.).
+ */
+export interface RealtimeEmitAdapter {
+    emit(room: string, event: string, data: unknown): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/emit/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/emit/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE"}

package/dist/emit/types.js

@@ -0,0 +1,7 @@
+/**
+ * Realtime emit adapter — how the worker sends events to connected clients.
+ * Default implementation: HTTP POST to a Socket.IO server's /api/emit endpoint.
+ * Platforms can provide custom adapters (direct Socket.IO, Redis pub/sub, etc.).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/emit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/emit/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/events/http-waiter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The worker's wait for a job to settle, through the SDK realtime server.
+ *
+ * The server keeps every declared completion or failure it emits as its job's
+ * settlement (`GET /internal/events/settlements/:kind/:id`), so the worker
+ * never joins a socket room: it asks, with the internal key, until the job
+ * settles or its deadline passes.
+ */
+import type { EventWaiter } from '@ouispec/agent-events';
+export interface HttpEventWaiterConfig {
+    /** The realtime server's base URL. */
+    url: string;
+    /** Its internal API key (the same key the emit adapter uses). */
+    apiKey: string;
+    /** Longest single wait the server is asked to hold open. Default 20 s. */
+    maxPollMs?: number;
+}
+export declare function createHttpEventWaiter(config: HttpEventWaiterConfig): EventWaiter;
+//# sourceMappingURL=http-waiter.d.ts.map

package/dist/events/http-waiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-waiter.d.ts","sourceRoot":"","sources":["../../src/events/http-waiter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,uBAAuB,CAAC;AAIrE,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,WAAW,CAkBhF"}

package/dist/events/http-waiter.js

@@ -0,0 +1,20 @@
+import { requireRealtime } from '../emit/http-adapter.js';
+import { longPoll } from '../realtime/long-poll.js';
+export function createHttpEventWaiter(config) {
+    const { url, apiKey } = config;
+    requireRealtime(url, apiKey);
+    const maxPollMs = config.maxPollMs ?? 20_000;
+    return {
+        waitForSettlement({ binding, id, timeoutMs, signal }) {
+            return longPoll({
+                url: (waitMs) => `${url}/internal/events/settlements/${encodeURIComponent(binding.kind)}/${encodeURIComponent(id)}?waitMs=${waitMs}`,
+                apiKey,
+                timeoutMs,
+                maxPollMs,
+                ...(signal ? { signal } : {}),
+                describe: `the settlement of ${binding.kind} ${id} (${binding.usedBy})`,
+            });
+        },
+    };
+}
+//# sourceMappingURL=http-waiter.js.map

package/dist/events/http-waiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-waiter.js","sourceRoot":"","sources":["../../src/events/http-waiter.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAWpD,MAAM,UAAU,qBAAqB,CAAC,MAA6B;IACjE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC/B,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC;IAE7C,OAAO;QACL,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;YAClD,OAAO,QAAQ,CAAa;gBAC1B,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CACd,GAAG,GAAG,gCAAgC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,EAAE,CAAC,WAAW,MAAM,EAAE;gBACrH,MAAM;gBACN,SAAS;gBACT,SAAS;gBACT,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,QAAQ,EAAE,qBAAqB,OAAO,CAAC,IAAI,IAAI,EAAE,KAAK,OAAO,CAAC,MAAM,GAAG;aACxE,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @ouispec/agent-worker — the agent runtime.
+ *
+ * Hosts provide: the model (any `ai` provider), the realtime server, the
+ * persona, tools and persistence callbacks (ADR-0227 §2.2).
+ * The worker handles: the multi-round tool loop, UI actions, streaming,
+ * retries and timeouts, on Lambda + SQS or in a container.
+ */
+export type { AgentWorkerConfig, AgentTurnInput, AgentTurnResult, TurnMessage, TurnHistoryMessage, ToolCallRef, SystemPromptContext } from './types.js';
+export type { RealtimeEmitAdapter } from './emit/types.js';
+export type { ToolRegistry, RegisteredTool, ToolExecutionResult, ToolExecutionContext } from './tools/types.js';
+export { createToolRegistry } from './tools/types.js';
+export { loadToolsFromSchema } from './tools/schema-loader.js';
+export type { LoadToolsOptions } from './tools/schema-loader.js';
+export { bindAsyncTool, awaitAsyncTool } from './tools/async-binding.js';
+export type { AsyncToolSpec, BoundAsyncTool, AsyncToolSettlement } from './tools/async-binding.js';
+export { createHttpEventWaiter } from './events/http-waiter.js';
+export type { HttpEventWaiterConfig } from './events/http-waiter.js';
+export { loadEntityToolsFromSchema } from './tools/entity-tools.js';
+export { loadBuiltinTools } from './tools/builtin-tools.js';
+export { loadAllTools } from './tools/load-all-tools.js';
+export type { LoadAllToolsOptions } from './tools/load-all-tools.js';
+export { createToolInputValidator } from './tools/input-validation.js';
+export type { ToolInputValidation, ToolInputValidator } from './tools/input-validation.js';
+export { loadOpenApiTools, OpenApiToolError, API_OPERATION_EFFECTS } from './openapi/index.js';
+export type { OpenApiTool, OpenApiToolsOptions, OpenApiToolAudience, ActAs, OperationRef, OpenApiDocument, OpenApiOperation, OpenApiParameter, OpenApiPathItem, OpenApiRequestBody, SecurityRequirement, HttpMethod, } from './openapi/index.js';
+export type { ToolPolicy, ToolPolicyContext, ToolPolicyDecision } from './authz/tool-policy.js';
+export { defaultToolPolicy, evaluateToolPolicySafe } from './authz/tool-policy.js';
+export { createHttpApprovalStoreClient } from './approvals/client.js';
+export type { ApprovalStoreClient, HttpApprovalStoreClientConfig } from './approvals/client.js';
+export { approvalRequirement, APPROVAL_TOOL_NOTE } from './approvals/requirement.js';
+export type { ApprovalRequirement } from './approvals/requirement.js';
+export { buildApprovalPreview } from './approvals/preview.js';
+export type { UIActionChannel, HttpUIActionChannelConfig } from './ui/channel.js';
+export { createHttpUIActionChannel } from './ui/channel.js';
+export { readClientSnapshot, withoutClientSnapshot, withoutClientUI, capabilityFingerprint, CLIENT_SNAPSHOT_KEY } from './ui/snapshot.js';
+export { readClientKnowledge, renderClientKnowledge, withClientKnowledge, CLIENT_KNOWLEDGE_KEY, type ClientKnowledge } from './ui/knowledge.js';
+export { buildUITools } from './ui/ui-tools.js';
+export type { UIToolDependencies, UIToolCollision } from './ui/ui-tools.js';
+export { createUISequence } from './ui/ui-sequence.js';
+export type { UISequence } from './ui/ui-sequence.js';
+export type { AgentApiSurface, EntityInstance, EntityFilter, EntityMutation, IntentResult, ViewAnnotationState, NavigationState, SessionApiSurface, LearningApiSurface, } from '@ouispec/agent-core';
+export { runAgentTurn } from './orchestrator.js';
+export { PROMPT_CACHE_BREAKPOINTS, describeModel } from './model.js';
+export type { LanguageModel, ProviderOptions } from './model.js';
+export type { TurnPolicy } from './turn-policy.js';
+export { defaultTurnPolicy } from './turn-policy.js';
+export { createHttpEmitAdapter } from './emit/http-adapter.js';
+export type { HttpEmitAdapterConfig } from './emit/http-adapter.js';
+export { createAgentTurnRunner, categorizeError, payloadRefusal } from './runtime/turn-runner.js';
+export type { AgentTurnRunner, TurnOutcome, CategorizedError } from './runtime/turn-runner.js';
+export { assertAgentRuntimeConfig } from './runtime/config.js';
+export type { AgentRuntimeConfig, LambdaAgentConfig, AgentTurnPayload } from './runtime/types.js';
+export { createLambdaAgentHandler } from './lambda/handler.js';
+export { startContainerAgentWorker } from './container/server.js';
+export type { ContainerAgentConfig, ContainerAgentWorker } from './container/server.js';
+export { buildAgentSystemPrompt } from './prompt/index.js';
+export type { AgentPersonaConfig, AgentKnowledgeEntry, AgentWorkflow, AgentFewShotExample, AgentPersonaOverrides, PromptBuildContext, CommunicationStyle, } from './prompt/index.js';
+export { getBaseRules, getCommunicationRules, getToolStrategyRules, getUIControlRules } from './prompt/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,45 @@
+/**
+ * @ouispec/agent-worker — the agent runtime.
+ *
+ * Hosts provide: the model (any `ai` provider), the realtime server, the
+ * persona, tools and persistence callbacks (ADR-0227 §2.2).
+ * The worker handles: the multi-round tool loop, UI actions, streaming,
+ * retries and timeouts, on Lambda + SQS or in a container.
+ */
+export { createToolRegistry } from './tools/types.js';
+export { loadToolsFromSchema } from './tools/schema-loader.js';
+// Async tools wait on the product's declared events (W9)
+export { bindAsyncTool, awaitAsyncTool } from './tools/async-binding.js';
+export { createHttpEventWaiter } from './events/http-waiter.js';
+export { loadEntityToolsFromSchema } from './tools/entity-tools.js';
+export { loadBuiltinTools } from './tools/builtin-tools.js';
+export { loadAllTools } from './tools/load-all-tools.js';
+export { createToolInputValidator } from './tools/input-validation.js';
+// API tools generated from any OpenAPI 3 document (ADR-0181 §2), each call acting
+// as the caller the host's actAs seam names. Also at `/openapi`.
+export { loadOpenApiTools, OpenApiToolError, API_OPERATION_EFFECTS } from './openapi/index.js';
+export { defaultToolPolicy, evaluateToolPolicySafe } from './authz/tool-policy.js';
+// Approvals (ADR-0228): an irreversible action runs only on an approval the
+// user gave, bound to the call, kept by the realtime server's approval store.
+export { createHttpApprovalStoreClient } from './approvals/client.js';
+export { approvalRequirement, APPROVAL_TOOL_NOTE } from './approvals/requirement.js';
+export { buildApprovalPreview } from './approvals/preview.js';
+export { createHttpUIActionChannel } from './ui/channel.js';
+export { readClientSnapshot, withoutClientSnapshot, withoutClientUI, capabilityFingerprint, CLIENT_SNAPSHOT_KEY } from './ui/snapshot.js';
+export { readClientKnowledge, renderClientKnowledge, withClientKnowledge, CLIENT_KNOWLEDGE_KEY } from './ui/knowledge.js';
+export { buildUITools } from './ui/ui-tools.js';
+export { createUISequence } from './ui/ui-sequence.js';
+export { runAgentTurn } from './orchestrator.js';
+// The model seam: any `ai` library model; the worker imports no provider.
+export { PROMPT_CACHE_BREAKPOINTS, describeModel } from './model.js';
+export { defaultTurnPolicy } from './turn-policy.js';
+export { createHttpEmitAdapter } from './emit/http-adapter.js';
+// The runtime: one core, two host adapters (Lambda + SQS, container)
+export { createAgentTurnRunner, categorizeError, payloadRefusal } from './runtime/turn-runner.js';
+export { assertAgentRuntimeConfig } from './runtime/config.js';
+export { createLambdaAgentHandler } from './lambda/handler.js';
+export { startContainerAgentWorker } from './container/server.js';
+// Prompt Framework
+export { buildAgentSystemPrompt } from './prompt/index.js';
+export { getBaseRules, getCommunicationRules, getToolStrategyRules, getUIControlRules } from './prompt/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,yDAAyD;AACzD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,kFAAkF;AAClF,iEAAiE;AACjE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAkB/F,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEnF,4EAA4E;AAC5E,8EAA8E;AAC9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAK9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC1I,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,oBAAoB,EAAwB,MAAM,mBAAmB,CAAC;AAChJ,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAevD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,0EAA0E;AAC1E,OAAO,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,qEAAqE;AACrE,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAElG,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,mBAAmB;AACnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAU3D,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/lambda/handler.d.ts

@@ -0,0 +1,38 @@
+/**
+ * createLambdaAgentHandler — the Lambda + SQS host adapter.
+ *
+ * The runtime core (runtime/turn-runner.ts) runs the turn; this adapter reads
+ * it from the SQS record and tells SQS what a failure means. The host passes
+ * every seam explicitly, and a missing one fails when the handler is created
+ * — at cold start — naming it.
+ *
+ * @example
+ * ```typescript
+ * import { createLambdaAgentHandler, PROMPT_CACHE_BREAKPOINTS } from '@ouispec/agent-worker';
+ * import { bedrock } from '@ai-sdk/amazon-bedrock';
+ *
+ * export const handler = createLambdaAgentHandler({
+ *   model: bedrock('us.anthropic.claude-sonnet-4-6'),
+ *   promptCacheBreakpoint: PROMPT_CACHE_BREAKPOINTS.bedrock,
+ *   realtime: { url: env.REALTIME_URL, apiKey: env.REALTIME_INTERNAL_KEY },
+ *   persona,
+ *   tools: [],
+ *   getDb,
+ *   getHistory: (conversationId, db) => db.message.findMany({ where: { conversationId }, orderBy: { createdAt: 'asc' } }),
+ *   persistMessages: ({ turnId, conversationId, messages, db }) => db.message.createMany({ data: toRows(turnId, conversationId, messages) }),
+ * });
+ * ```
+ */
+import type { SQSEvent } from 'aws-lambda';
+import type { LambdaAgentConfig } from '../runtime/types.js';
+/**
+ * Creates a Lambda handler for SQS: one record per invocation, its body an
+ * `AgentTurnPayload`.
+ *
+ * A failure the runtime marks unrecoverable is rethrown, so SQS's redrive
+ * policy sees it; a recoverable one (the provider rate-limiting or
+ * unavailable) has already been reported to the client and is not retried.
+ */
+export declare function createLambdaAgentHandler<TDb>(config: LambdaAgentConfig<TDb>): (event: SQSEvent) => Promise<void>;
+export type { LambdaAgentConfig, AgentTurnPayload } from '../runtime/types.js';
+//# sourceMappingURL=handler.d.ts.map

package/dist/lambda/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/lambda/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE/E;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,IAG5D,OAAO,QAAQ,KAAG,OAAO,CAAC,IAAI,CAAC,CAY9C;AAED,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lambda/handler.js

@@ -0,0 +1,26 @@
+import { createAgentTurnRunner, payloadRefusal } from '../runtime/turn-runner.js';
+/**
+ * Creates a Lambda handler for SQS: one record per invocation, its body an
+ * `AgentTurnPayload`.
+ *
+ * A failure the runtime marks unrecoverable is rethrown, so SQS's redrive
+ * policy sees it; a recoverable one (the provider rate-limiting or
+ * unavailable) has already been reported to the client and is not retried.
+ */
+export function createLambdaAgentHandler(config) {
+    const runner = createAgentTurnRunner(config);
+    return async (event) => {
+        if (!event.Records?.length) {
+            runner.logger.warn('[agent-sdk] Empty SQS event');
+            return;
+        }
+        const payload = JSON.parse(event.Records[0].body);
+        const refusal = payloadRefusal(payload);
+        if (refusal)
+            throw new Error(`[agent-sdk] ${refusal}`);
+        const outcome = await runner.run(payload);
+        if (outcome.status === 'failed' && !outcome.error.recoverable)
+            throw outcome.cause;
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/lambda/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/lambda/handler.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGlF;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAM,MAA8B;IAC1E,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE7C,OAAO,KAAK,EAAE,KAAe,EAAiB,EAAE;QAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAqB,CAAC;QACtE,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;QAEvD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW;YAAE,MAAM,OAAO,CAAC,KAAK,CAAC;IACrF,CAAC,CAAC;AACJ,CAAC"}

package/dist/model.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The model seam (ADR-0227 §2.2, D5): the host passes any `ai` library model.
+ * The worker names no provider and imports none.
+ */
+import type { LanguageModel, SystemModelMessage } from 'ai';
+export type { LanguageModel };
+/** Provider options on a message, keyed by provider. */
+export type ProviderOptions = NonNullable<SystemModelMessage['providerOptions']>;
+/**
+ * The provider options that mark a prompt-cache breakpoint, for providers that
+ * cache by breakpoint. Pass one as `promptCacheBreakpoint`; omit it for a
+ * provider that caches on its own or not at all. These are data, not
+ * dependencies: the worker imports no provider.
+ */
+export declare const PROMPT_CACHE_BREAKPOINTS: {
+    readonly bedrock: {
+        readonly amazonBedrock: {
+            readonly cachePoint: {
+                readonly type: "default";
+            };
+        };
+    };
+    readonly anthropic: {
+        readonly anthropic: {
+            readonly cacheControl: {
+                readonly type: "ephemeral";
+            };
+        };
+    };
+};
+/** How a model is named in logs and in `recordTurnStart`. */
+export declare function describeModel(model: LanguageModel): string;
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAE5D,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAEjF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;CAGe,CAAC;AAErD,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAE1D"}

package/dist/model.js

@@ -0,0 +1,15 @@
+/**
+ * The provider options that mark a prompt-cache breakpoint, for providers that
+ * cache by breakpoint. Pass one as `promptCacheBreakpoint`; omit it for a
+ * provider that caches on its own or not at all. These are data, not
+ * dependencies: the worker imports no provider.
+ */
+export const PROMPT_CACHE_BREAKPOINTS = {
+    bedrock: { amazonBedrock: { cachePoint: { type: 'default' } } },
+    anthropic: { anthropic: { cacheControl: { type: 'ephemeral' } } },
+};
+/** How a model is named in logs and in `recordTurnStart`. */
+export function describeModel(model) {
+    return typeof model === 'string' ? model : `${model.provider}:${model.modelId}`;
+}
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO,EAAE,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE;IAC/D,SAAS,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE;CACf,CAAC;AAErD,6DAA6D;AAC7D,MAAM,UAAU,aAAa,CAAC,KAAoB;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;AAClF,CAAC"}

package/dist/openapi/document.d.ts

@@ -0,0 +1,87 @@
+/**
+ * The parts of an OpenAPI 3.0 or 3.1 document the tool loader reads, and the
+ * conversion of its schemas into the JSON Schema a tool declares.
+ */
+export type HttpMethod = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';
+export declare const HTTP_METHODS: readonly HttpMethod[];
+export type JsonSchema = Record<string, unknown>;
+export type Reference = {
+    $ref: string;
+};
+/** A security requirement object: scheme name → the scopes or roles it must carry. */
+export type SecurityRequirement = Record<string, string[]>;
+export interface OpenApiParameter {
+    name: string;
+    in: 'path' | 'query' | 'header' | 'cookie';
+    description?: string;
+    required?: boolean;
+    deprecated?: boolean;
+    style?: string;
+    explode?: boolean;
+    schema?: JsonSchema;
+    content?: Record<string, {
+        schema?: JsonSchema;
+    }>;
+}
+export interface OpenApiRequestBody {
+    description?: string;
+    required?: boolean;
+    content?: Record<string, {
+        schema?: JsonSchema;
+    }>;
+}
+export interface OpenApiOperation {
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    parameters?: Array<OpenApiParameter | Reference>;
+    requestBody?: OpenApiRequestBody | Reference;
+    responses?: Record<string, unknown>;
+    security?: SecurityRequirement[];
+    [extension: `x-${string}`]: unknown;
+}
+export type OpenApiPathItem = {
+    summary?: string;
+    description?: string;
+    parameters?: Array<OpenApiParameter | Reference>;
+} & Partial<Record<HttpMethod, OpenApiOperation>>;
+export interface OpenApiDocument {
+    openapi: string;
+    info?: {
+        title?: string;
+        version?: string;
+        [key: string]: unknown;
+    };
+    paths: Record<string, OpenApiPathItem>;
+    components?: {
+        schemas?: Record<string, JsonSchema>;
+        parameters?: Record<string, OpenApiParameter | Reference>;
+        requestBodies?: Record<string, OpenApiRequestBody | Reference>;
+        securitySchemes?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    security?: SecurityRequirement[];
+    [key: string]: unknown;
+}
+/** Thrown for anything the loader refuses; the message names the operation. */
+export declare class OpenApiToolError extends Error {
+    constructor(message: string);
+}
+/**
+ * Resolves `#/...` references in one document. `where` names the operation in
+ * errors. A reference outside the document, or one that does not resolve, is refused.
+ */
+export declare function createResolver(doc: OpenApiDocument): {
+    deref: <T>(value: T | Reference, where: string) => T;
+    lookup: (ref: string, where: string) => unknown;
+};
+export type Resolver = ReturnType<typeof createResolver>;
+/**
+ * An OpenAPI schema as the JSON Schema of a tool's input: every reference inlined,
+ * 3.0's `nullable` as a `null` type, `example` as `examples`, and properties the
+ * server sets (`readOnly`) left out, since a caller never sends them.
+ *
+ * A schema that refers to itself cannot be inlined and is refused.
+ */
+export declare function toInputSchema(schema: unknown, resolver: Resolver, where: string, stack?: string[]): JsonSchema;
+//# sourceMappingURL=document.d.ts.map

package/dist/openapi/document.d.ts.map

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