@ouispec/agent-worker 0.1.0

package/dist/ui/ui-tools.js

@@ -0,0 +1,244 @@
+import { boundObservations } from './observations.js';
+import { createUISequence } from './ui-sequence.js';
+const DEFAULT_MAX_OBSERVATION_CHARS = 6_000;
+/**
+ * When to send a request again while no tab has received it (dispatchUntilAnswered):
+ * after 1 s, then 2, 4, and every 8 s.
+ */
+export const FIRST_RESEND_AFTER_MS = 1_000;
+export const MAX_RESEND_AFTER_MS = 8_000;
+/**
+ * When to send a request a tab received again, if its answer has not come: by
+ * then longer than the tab waits before answering a repeat (oui-spec's
+ * `reanswerAfterMs`, 8 s), so the repeat recovers an answer that was lost.
+ */
+export const RECEIVED_RESEND_AFTER_MS = 10_000;
+/** How long to wait for an async action's outcome when it declares no limit of its own. */
+export const DEFAULT_JOB_WAIT_MS = 5 * 60_000;
+/** Build the UI tools for a set of surfaces. The first surface to declare an action id keeps it. */
+export function buildUITools(surfaces, deps) {
+    const tools = [];
+    const owner = new Map();
+    const collisions = [];
+    const sequence = deps.sequence ?? createUISequence();
+    for (const surface of surfaces) {
+        for (const action of surface.actions) {
+            const kept = owner.get(action.id);
+            if (kept !== undefined) {
+                collisions.push({ actionId: action.id, keptSurface: kept, droppedSurface: surface.id });
+                continue;
+            }
+            owner.set(action.id, surface.id);
+            tools.push(uiTool(surface, action, deps, sequence));
+        }
+    }
+    return { tools, collisions };
+}
+function uiTool(surface, action, deps, sequence) {
+    return {
+        name: action.id,
+        kind: 'ui',
+        description: describe(surface, action),
+        inputSchema: (action.input ?? { type: 'object', properties: {} }),
+        // The approval card's words and whether a call needs approval come from
+        // the declaration (ADR-0228 §2.1–2.2). `confirm` marks a destructive
+        // action, or one that changes what the person works in: either asks.
+        ...(action.title ? { title: action.title } : { title: action.description }),
+        consequence: action.description,
+        ...(action.effect !== undefined ? { effect: action.effect } : {}),
+        ...(action.confirm ? { destructive: true } : {}),
+        execute(input, ctx) {
+            // In the place the orchestrator took when the model's call arrived, or,
+            // called directly, in a place taken now (ui-sequence.ts).
+            const slot = ctx.uiSlot ?? sequence.reserve();
+            return slot.run(() => runAction(surface, action, deps, sequence, input, ctx));
+        },
+    };
+}
+async function runAction(surface, action, deps, sequence, input, ctx) {
+    const requestId = ctx.toolCallId;
+    const room = ctx.socketRoom;
+    if (!requestId || !room) {
+        throw new Error(`[agent-sdk] UI tool ${action.id} needs the tool call id and the turn's room`);
+    }
+    // The page as the actions before this one left it.
+    const before = sequence.latestSurfaces() ?? deps.currentSurfaces();
+    // The surfaces the worker holds, so the answer repeats them only if they changed (oui-spec §7.3.4).
+    const knownSurfaces = sequence.knownHash();
+    const request = {
+        requestId,
+        surfaceId: surface.id,
+        actionId: action.id,
+        params: input,
+        timestamp: Date.now(),
+        ...(ctx.approval ? { approval: ctx.approval } : {}),
+        ...(knownSurfaces ? { knownSurfaces } : {}),
+    };
+    const answered = await dispatchUntilAnswered(deps, room, request, ctx);
+    if (!answered.result) {
+        const within = `within ${Math.round(deps.resultTimeoutMs / 1000)}s`;
+        const sent = `${answered.sends} time${answered.sends === 1 ? '' : 's'}`;
+        return {
+            success: false,
+            error: (answered.received
+                ? `The page received "${action.id}" but its answer did not arrive ${within} (the request was sent ${sent}). ` +
+                    'It may have run: check what the page shows before trying again.'
+                : answered.receipts
+                    ? `No open page received "${action.id}" ${within} (sent ${sent}): the person's page may be closed or offline. ` +
+                        'It did not run there. Tell the user the page is not responding.'
+                    : `The page did not answer "${action.id}" ${within}, though the request was sent to it ${sent}. ` +
+                        'It may or may not have run: check what the page shows before trying again, and tell the user if it is not responding.'),
+        };
+    }
+    const result = withSurfaces(answered.result, sequence);
+    deps.onResult(result);
+    // Work that outlives the call (a GPU job, an export) was only started: wait
+    // for its outcome, so the model tells the person it is done only once it is.
+    const final = result.success && result.interim ? await awaitOutcome(action, deps, requestId, ctx) : null;
+    const outcome = final && final !== 'running' ? withSurfaces(final, sequence) : final;
+    if (outcome && outcome !== 'running')
+        deps.onResult(outcome);
+    const answer = outcome && outcome !== 'running' ? outcome : result;
+    const data = {
+        ...forModel(answer, before, deps.maxObservationChars ?? DEFAULT_MAX_OBSERVATION_CHARS, surface.id),
+        ...(outcome === 'running' ? { status: 'running', note: stillRunningNote(action) } : {}),
+    };
+    return answer.success
+        ? { success: true, data }
+        : { success: false, data, error: answer.error?.message ?? `"${action.id}" failed` };
+}
+/**
+ * Send the request to the turn's room, and send it again only while it may not
+ * have reached the page (oui-spec §7.3.7).
+ *
+ * A room delivers only to the sockets in it when the event is sent. The tab
+ * joins the turn's room once it learns the room from the send-message answer,
+ * while the worker may already be running the turn: the turn after an
+ * approval runs its approved call at once, before any model round, and the
+ * first send can reach nobody. So while no tab has received the request it is
+ * sent again, backing off (1, 2, 4, then every 8 s).
+ *
+ * Once a tab has received it (the realtime service's receipts), its answer is
+ * waited for, not asked for again: on dev (2026-10-02 09:11Z) a fixed 2 s
+ * re-send made the tab answer every copy, the copies of a large answer queued
+ * on its one socket, and the next request's answer missed its window though
+ * its action had run. It is sent again only after RECEIVED_RESEND_AFTER_MS of
+ * silence, in case the answer was lost; the tab then answers the repeat once.
+ */
+async function dispatchUntilAnswered(deps, room, request, ctx) {
+    const deadline = Date.now() + deps.resultTimeoutMs;
+    let sends = 0;
+    let received = false;
+    let receipts = false;
+    let backoff = FIRST_RESEND_AFTER_MS;
+    for (;;) {
+        const receipt = await deps.channel.dispatch(room, request);
+        sends++;
+        if (receipt) {
+            receipts = true;
+            if (receipt.accepted > 0)
+                received = true;
+        }
+        const left = deadline - Date.now();
+        const wait = received ? RECEIVED_RESEND_AFTER_MS : backoff;
+        const result = await deps.channel.awaitResult(request.requestId, {
+            userId: ctx.userId,
+            timeoutMs: Math.max(0, Math.min(wait, left)),
+            signal: ctx.abortSignal,
+        });
+        if (result || Date.now() >= deadline || ctx.abortSignal?.aborted)
+            return { result, sends, received, receipts };
+        if (!received)
+            backoff = Math.min(backoff * 2, MAX_RESEND_AFTER_MS);
+    }
+}
+/**
+ * An answer with the surfaces it stands for: those it carries, or those the
+ * worker holds under the hash it reports (an answer repeats surfaces only when
+ * they changed). Recorded as the page's surfaces from now on.
+ */
+function withSurfaces(result, sequence) {
+    const surfaces = sequence.resolve(result);
+    sequence.record(surfaces, result.surfacesHash);
+    return surfaces && !result.surfaces ? { ...result, surfaces } : result;
+}
+/**
+ * The final answer to a started action: its outcome once the work is done or
+ * has failed, or `'running'` when it has not finished by its own limit (its
+ * polling's `maxDurationMs`) or by when the turn must stop waiting.
+ */
+async function awaitOutcome(action, deps, requestId, ctx) {
+    const until = Math.min(Date.now() + (action.polling?.maxDurationMs ?? DEFAULT_JOB_WAIT_MS), deps.waitDeadline?.() ?? Infinity);
+    const timeoutMs = until - Date.now();
+    if (timeoutMs <= 0)
+        return 'running';
+    const final = await deps.channel.awaitResult(requestId, {
+        userId: ctx.userId,
+        timeoutMs,
+        signal: ctx.abortSignal,
+        final: true,
+    });
+    // No answer in time, or a relay that only keeps first answers handing back the acknowledgment.
+    if (!final || final.interim)
+        return 'running';
+    return final;
+}
+function stillRunningNote(action) {
+    return (`"${action.id}" started and has not finished yet, so it is not done: tell the person it is still running, ` +
+        'never that it is done. Its status and result appear in the page state when it finishes.');
+}
+function describe(surface, action) {
+    let desc = `[UI · ${surface.name}] ${action.description}`;
+    if (action.usage)
+        desc += `\n\nWhen to use: ${action.usage}`;
+    if (action.preconditions)
+        desc += `\n\nPreconditions: ${action.preconditions}`;
+    if (action.async) {
+        desc +=
+            '\n\nAsync: waits for the work to finish and returns its outcome; if it is still running when the wait ends, ' +
+                'it says so (status "running"), and the outcome appears in the page state when it finishes.';
+        if (action.estimatedDuration)
+            desc += ` Estimated duration: ${action.estimatedDuration}.`;
+    }
+    return desc;
+}
+/**
+ * What the model sees: the outcome, and what the page offers now. Tool changes
+ * are named so the model knows the page it is on, not just that something
+ * happened.
+ */
+function forModel(result, before, maxObservationChars, actingSurfaceId) {
+    const after = result.surfaces ?? before;
+    const beforeActions = new Set(before.flatMap((s) => s.actions.map((a) => a.id)));
+    const afterActions = new Set(after.flatMap((s) => s.actions.map((a) => a.id)));
+    const added = [...afterActions].filter((id) => !beforeActions.has(id));
+    const removed = [...beforeActions].filter((id) => !afterActions.has(id));
+    return {
+        ...(result.data !== undefined ? { result: result.data } : {}),
+        ...(result.error ? { error: result.error } : {}),
+        ...(result.interim ? { status: 'started' } : {}),
+        ...(result.settled === false
+            ? { note: 'The page was still loading when this was reported; what it offers may still change.' }
+            : {}),
+        ...(result.delivery?.trimmed ? { delivery: deliveryNote(result.delivery) } : {}),
+        page: {
+            surfaces: after.map((s) => s.name),
+            ...(added.length ? { toolsAdded: added } : {}),
+            ...(removed.length ? { toolsRemoved: removed } : {}),
+        },
+        ...(result.observations && Object.keys(result.observations).length
+            ? { state: boundObservations(result.observations, maxObservationChars, actingSurfaceId) }
+            : {}),
+    };
+}
+/**
+ * What the model is told about an answer the tab had to trim to deliver
+ * (oui-spec §7.3.6): the outcome is what happened, and what it lacks.
+ */
+function deliveryNote(delivery) {
+    const lacks = delivery.omitted.map((field) => (field === 'data' ? 'what the action returned' : `the page's ${field}`));
+    return (`The page ran this, and its outcome here is what happened, but its full answer was refused on the way ` +
+        `(${delivery.reason}), so it came without ${lacks.join(', ')}. ` +
+        "Don't assume what the page shows: read its state from the next action's answer before relying on it.");
+}
+//# sourceMappingURL=ui-tools.js.map

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

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

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@ouispec/agent-worker",
+  "version": "0.1.0",
+  "description": "The agent runtime — any `ai` model, UI actions answered by the client, streaming and tool loops; one core on Lambda + SQS or in a container",
+  "homepage": "https://github.com/wesreid/oui/tree/main/packages/agent-worker#readme",
+  "bugs": {
+    "url": "https://github.com/wesreid/oui/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wesreid/oui.git",
+    "directory": "packages/agent-worker"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./lambda": {
+      "types": "./dist/lambda/handler.d.ts",
+      "import": "./dist/lambda/handler.js"
+    },
+    "./container": {
+      "types": "./dist/container/server.d.ts",
+      "import": "./dist/container/server.js"
+    },
+    "./openapi": {
+      "types": "./dist/openapi/index.d.ts",
+      "import": "./dist/openapi/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "ai": "^7.0.58",
+    "ajv": "^8.17.0",
+    "ajv-formats": "^3.0.1",
+    "yaml": "^2.7.0",
+    "@ouispec/agent-core": "^0.1.0",
+    "@ouispec/agent-events": "^0.1.0",
+    "@ouispec/bindings": "^0.1.0",
+    "oui-spec": "^0.6.1"
+  },
+  "devDependencies": {
+    "@ai-sdk/amazon-bedrock": "^5.0.50",
+    "@ai-sdk/openai": "4.0.36",
+    "@types/aws-lambda": "^8.10.145",
+    "@types/node": "^22.0.0",
+    "aws-lambda": "^1.0.7",
+    "socket.io-client": "^4.7.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.0",
+    "zod": "^4.4.3",
+    "@ouispec/agent-realtime": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist",
+    "eval:live": "vitest run --config vitest.live.config.ts",
+    "record:fixture-turn": "vitest run --config vitest.record.config.ts"
+  }
+}