@relkit/runtime-hono 0.4.0 → 0.5.0

package/dist/agent-active-execution.d.ts

@@ -0,0 +1,13 @@
+import type { AcceptRunReceipt, ExecutionClaim } from "@relkit/agents";
+export interface ActiveAgentExecution {
+    receipt: AcceptRunReceipt;
+    claim: ExecutionClaim;
+    readonly controlRunIds: string[];
+    readonly steering: AgentSteeringBuffer;
+}
+export interface AgentSteeringBuffer {
+    readonly push: (message: string) => void;
+    readonly drain: () => readonly string[];
+}
+export declare function createAgentSteeringBuffer(): AgentSteeringBuffer;
+//# sourceMappingURL=agent-active-execution.d.ts.map

package/dist/agent-active-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-active-execution.d.ts","sourceRoot":"","sources":["../src/agent-active-execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,wBAAgB,yBAAyB,IAAI,mBAAmB,CAM/D"}

package/dist/agent-active-execution.js

@@ -0,0 +1,8 @@
+export function createAgentSteeringBuffer() {
+    const pending = [];
+    return Object.freeze({
+        push: (message) => pending.push(message),
+        drain: () => pending.splice(0),
+    });
+}
+//# sourceMappingURL=agent-active-execution.js.map

package/dist/agent-active-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-active-execution.js","sourceRoot":"","sources":["../src/agent-active-execution.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,yBAAyB;IACvC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAChD,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;KAC/B,CAAC,CAAC;AACL,CAAC"}

package/dist/agent-approval-coordinator.d.ts

@@ -0,0 +1,20 @@
+import type { AcceptRunReceipt, AgentStateProvider, ExecutionClaim, PendingApproval } from "@relkit/agents";
+import { type OperationId } from "@relkit/contracts";
+import type { agentContext } from "./agent-rpc-support.js";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+import type { ActiveAgentExecution } from "./agent-active-execution.js";
+type ResolvedAgent = Awaited<ReturnType<typeof agentContext>>;
+export declare class AgentApprovalCoordinator {
+    private readonly resolved;
+    private readonly active;
+    private readonly options;
+    private readonly waiting;
+    private flushQueued;
+    constructor(resolved: ResolvedAgent, active: ActiveAgentExecution, options: RouteMaterializationOptions);
+    readonly request: (approval: PendingApproval) => Promise<"approved" | "denied">;
+    continue(operationId: OperationId, payload: unknown, beforeResume?: () => Promise<void>): Promise<void>;
+    private flush;
+}
+export declare function claimRun(provider: AgentStateProvider, resolved: ResolvedAgent, receipt: AcceptRunReceipt, options: RouteMaterializationOptions): Promise<ExecutionClaim>;
+export {};
+//# sourceMappingURL=agent-approval-coordinator.d.ts.map

package/dist/agent-approval-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-approval-coordinator.d.ts","sourceRoot":"","sources":["../src/agent-approval-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,eAAe,EAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,KAAK,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AAS9D,qBAAa,wBAAwB;IAKjC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,WAAW,CAAS;gBAGT,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,2BAA2B;IAGvD,QAAQ,CAAC,OAAO,GAAI,UAAU,eAAe,KAAG,OAAO,CAAC,UAAU,GAAG,QAAQ,CAAC,CAuB5E;IAEI,QAAQ,CACZ,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,EAChB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;YAiDF,KAAK;CAwCpB;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,cAAc,CAAC,CASzB"}

package/dist/agent-approval-coordinator.js

@@ -0,0 +1,148 @@
+import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
+import { createOperationId } from "@relkit/realtime";
+import { agentLimits, digest, encodedBytes } from "./agent-rpc-support.js";
+export class AgentApprovalCoordinator {
+    resolved;
+    active;
+    options;
+    waiting = new Map();
+    flushQueued = false;
+    constructor(resolved, active, options) {
+        this.resolved = resolved;
+        this.active = active;
+        this.options = options;
+    }
+    request = (approval) => {
+        const approvalId = digest({
+            runId: this.active.receipt.runId,
+            invocationId: approval.invocationId,
+            toolCallId: approval.toolCallId,
+        });
+        const existing = this.waiting.get(approvalId);
+        if (existing !== undefined)
+            return new Promise((resolve) => {
+                const original = existing.resolve;
+                existing.resolve = (decision) => {
+                    original(decision);
+                    resolve(decision);
+                };
+            });
+        const result = new Promise((resolve) => {
+            this.waiting.set(approvalId, { approval, approvalId, resolve });
+        });
+        if (!this.flushQueued) {
+            this.flushQueued = true;
+            queueMicrotask(() => void this.flush());
+        }
+        return result;
+    };
+    async continue(operationId, payload, beforeResume) {
+        const entries = [...this.waiting.values()];
+        if (entries.length === 0)
+            throw new Error("No approval interruption is pending.");
+        const decisions = approvalDecisions(payload);
+        if (entries.some(({ approvalId }) => decisions[approvalId] === undefined)) {
+            throw new Error("Every open approval requires a decision.");
+        }
+        const interruptSetDigest = entries[0]?.interruptSetDigest;
+        if (interruptSetDigest === undefined ||
+            entries.some((entry) => entry.interruptSetDigest !== interruptSetDigest)) {
+            throw new Error("Approval interrupt set is not ready.");
+        }
+        const interruptedRunId = this.active.receipt.runId;
+        const semanticDigest = digest({ interruptedRunId, interruptSetDigest, decisions });
+        const continuation = await this.resolved.provider.admitContinuation({
+            ...this.resolved.scope,
+            operationId,
+            semanticDigest,
+            kind: "approval",
+            threadId: this.active.receipt.threadId,
+            interruptedRunId,
+            interruptSetDigest,
+            decisions,
+            admittedAt: new Date().toISOString(),
+            receiptExpiresAt: receiptExpiry(),
+        });
+        this.active.receipt = {
+            operationId: continuation.operationId,
+            threadId: continuation.threadId,
+            runId: continuation.runId,
+            status: "accepted",
+            duplicate: continuation.duplicate,
+        };
+        this.active.controlRunIds.push(continuation.runId);
+        this.active.claim = await claimRun(this.resolved.provider, this.resolved, this.active.receipt, this.options);
+        await beforeResume?.();
+        for (const entry of entries) {
+            this.waiting.delete(entry.approvalId);
+            entry.resolve(decisions[entry.approvalId] === "approve" ? "approved" : "denied");
+        }
+    }
+    async flush() {
+        this.flushQueued = false;
+        const entries = [...this.waiting.values()].filter((entry) => entry.interruptSetDigest === undefined);
+        if (entries.length === 0)
+            return;
+        const interruptSetDigest = digest(entries.map(({ approvalId }) => approvalId).sort());
+        for (const entry of entries) {
+            entry.interruptSetDigest = interruptSetDigest;
+            const value = {
+                approvalId: entry.approvalId,
+                runId: this.active.receipt.runId,
+                interruptSetDigest,
+                interruptSetSize: entries.length,
+                status: "open",
+                publicRequest: {
+                    toolCallId: entry.approval.toolCallId,
+                    toolId: entry.approval.toolId,
+                    sideEffect: entry.approval.sideEffect,
+                },
+            };
+            await this.resolved.provider.appendJournal({
+                ...this.resolved.scope,
+                threadId: this.active.receipt.threadId,
+                runId: this.active.receipt.runId,
+                claim: this.active.claim,
+                operationId: createOperationId(),
+                semanticDigest: digest(value),
+                record: {
+                    recordId: crypto.randomUUID(),
+                    runId: this.active.receipt.runId,
+                    kind: "approval",
+                    publicValue: value,
+                    encodedBytes: encodedBytes(value),
+                    createdAt: new Date().toISOString(),
+                },
+                limits: agentLimits,
+            });
+        }
+    }
+}
+export function claimRun(provider, resolved, receipt, options) {
+    return provider.claimRun({
+        ...resolved.scope,
+        threadId: receipt.threadId,
+        runId: receipt.runId,
+        workerId: crypto.randomUUID(),
+        generationId: options.agentRuntime.generationId,
+        expiresAt: new Date(Date.now() + REALTIME_RUNTIME_LIMITS.leaseExpiryMs).toISOString(),
+    });
+}
+function approvalDecisions(value) {
+    if (value === null || typeof value !== "object")
+        return {};
+    const payload = value;
+    if (typeof payload.approvalId === "string" && isDecision(payload.decision)) {
+        return { [payload.approvalId]: payload.decision };
+    }
+    if (payload.decisions === null || typeof payload.decisions !== "object")
+        return {};
+    return Object.fromEntries(Object.entries(payload.decisions).filter((entry) => isDecision(entry[1])));
+}
+function isDecision(value) {
+    return value === "approve" || value === "deny";
+}
+function receiptExpiry() {
+    return new Date(Date.now() + REALTIME_RUNTIME_LIMITS.agentReceiptMs).toISOString();
+}
+//# sourceMappingURL=agent-approval-coordinator.js.map

package/dist/agent-approval-coordinator.js.map

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

package/dist/agent-capability-negotiation.d.ts

@@ -0,0 +1,2 @@
+export declare function assertAgentCapabilities(request: Request): void;
+//# sourceMappingURL=agent-capability-negotiation.d.ts.map

package/dist/agent-capability-negotiation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-capability-negotiation.d.ts","sourceRoot":"","sources":["../src/agent-capability-negotiation.ts"],"names":[],"mappings":"AAOA,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAY9D"}

package/dist/agent-capability-negotiation.js

@@ -0,0 +1,16 @@
+import { ORPCError } from "@orpc/server";
+import { AGENT_CAPABILITY_HEADER, AGENT_CAPABILITY_QUERY, AGENT_STREAM_CAPABILITIES, } from "@relkit/contracts";
+export function assertAgentCapabilities(request) {
+    const value = request.headers.get(AGENT_CAPABILITY_HEADER) ??
+        new URL(request.url).searchParams.get(AGENT_CAPABILITY_QUERY) ??
+        "";
+    const offered = new Set(value.split(",").map((entry) => entry.trim()));
+    const missing = AGENT_STREAM_CAPABILITIES.filter((capability) => !offered.has(capability));
+    if (missing.length === 0)
+        return;
+    throw new ORPCError("AGENT_CAPABILITIES_UNSUPPORTED", {
+        message: "The client does not support the required native agent stream capabilities.",
+        data: { required: AGENT_STREAM_CAPABILITIES, missing },
+    });
+}
+//# sourceMappingURL=agent-capability-negotiation.js.map

package/dist/agent-capability-negotiation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-capability-negotiation.js","sourceRoot":"","sources":["../src/agent-capability-negotiation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,KAAK,GACT,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QAC5C,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,sBAAsB,CAAC;QAC7D,EAAE,CAAC;IACL,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACjC,MAAM,IAAI,SAAS,CAAC,gCAAgC,EAAE;QACpD,OAAO,EAAE,4EAA4E;QACrF,IAAI,EAAE,EAAE,QAAQ,EAAE,yBAAyB,EAAE,OAAO,EAAE;KACvD,CAAC,CAAC;AACL,CAAC"}

package/dist/agent-compatibility.d.ts

@@ -0,0 +1,5 @@
+import { type AgentRunCompatibility, type StoredRun, type ThreadSnapshot } from "@relkit/contracts";
+export declare function agentRunCompatibility(run: StoredRun | undefined, waitingRunId?: string): AgentRunCompatibility;
+export declare function clientAgentSnapshot(snapshot: ThreadSnapshot): ThreadSnapshot;
+export declare function assertAgentRunWritable(snapshot: ThreadSnapshot, runId?: string): void;
+//# sourceMappingURL=agent-compatibility.d.ts.map

package/dist/agent-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-compatibility.d.ts","sourceRoot":"","sources":["../src/agent-compatibility.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,SAAS,GAAG,SAAS,EAC1B,YAAY,CAAC,EAAE,MAAM,GACpB,qBAAqB,CAiBvB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CAM5E;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CASrF"}

package/dist/agent-compatibility.js

@@ -0,0 +1,47 @@
+import { ORPCError } from "@orpc/server";
+import { AGENT_STATE_SCHEMA_VERSION, AGENT_STREAM_VERSION, } from "@relkit/contracts";
+export function agentRunCompatibility(run, waitingRunId) {
+    if (run === undefined) {
+        return { runtime: "native", access: "read-write", resumableCheckpoint: false };
+    }
+    const owner = run.owner;
+    const native = owner?.protocolVersion === AGENT_STREAM_VERSION &&
+        owner.schemaVersion === AGENT_STATE_SCHEMA_VERSION;
+    return {
+        runtime: native ? "native" : "ai-sdk",
+        access: native ? "read-write" : "read-only",
+        resumableCheckpoint: native && waitingRunId === run.runId,
+        ...(typeof owner?.protocolVersion === "number"
+            ? { protocolVersion: owner.protocolVersion }
+            : {}),
+        ...(typeof owner?.schemaVersion === "number" ? { schemaVersion: owner.schemaVersion } : {}),
+    };
+}
+export function clientAgentSnapshot(snapshot) {
+    const run = currentRun(snapshot);
+    const compatibility = agentRunCompatibility(run, snapshot.waiting?.runId);
+    if (compatibility.access === "read-write")
+        return { ...snapshot, compatibility };
+    const { waiting: _waiting, ...readOnly } = snapshot;
+    return { ...readOnly, compatibility };
+}
+export function assertAgentRunWritable(snapshot, runId) {
+    const run = runId === undefined
+        ? currentRun(snapshot)
+        : snapshot.currentRuns.find((candidate) => candidate.runId === runId);
+    if (agentRunCompatibility(run, snapshot.waiting?.runId).access === "read-write")
+        return;
+    throw new ORPCError("AGENT_RUN_READ_ONLY", {
+        message: "Historical AI SDK runs are read-only and have no native resumable checkpoint.",
+    });
+}
+function currentRun(snapshot) {
+    const active = snapshot.activeRun?.runId;
+    if (active !== undefined) {
+        const run = snapshot.currentRuns.find((candidate) => candidate.runId === active);
+        if (run !== undefined)
+            return run;
+    }
+    return [...snapshot.currentRuns].sort((left, right) => right.acceptedAt.localeCompare(left.acceptedAt))[0];
+}
+//# sourceMappingURL=agent-compatibility.js.map

package/dist/agent-compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-compatibility.js","sourceRoot":"","sources":["../src/agent-compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,GAIrB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,UAAU,qBAAqB,CACnC,GAA0B,EAC1B,YAAqB;IAErB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC;IACjF,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAgD,CAAC;IACnE,MAAM,MAAM,GACV,KAAK,EAAE,eAAe,KAAK,oBAAoB;QAC/C,KAAK,CAAC,aAAa,KAAK,0BAA0B,CAAC;IACrD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QACrC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW;QAC3C,mBAAmB,EAAE,MAAM,IAAI,YAAY,KAAK,GAAG,CAAC,KAAK;QACzD,GAAG,CAAC,OAAO,KAAK,EAAE,eAAe,KAAK,QAAQ;YAC5C,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE;YAC5C,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,KAAK,EAAE,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAwB;IAC1D,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,aAAa,GAAG,qBAAqB,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1E,IAAI,aAAa,CAAC,MAAM,KAAK,YAAY;QAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,aAAa,EAAE,CAAC;IACjF,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC;IACpD,OAAO,EAAE,GAAG,QAAQ,EAAE,aAAa,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAwB,EAAE,KAAc;IAC7E,MAAM,GAAG,GACP,KAAK,KAAK,SAAS;QACjB,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAC1E,IAAI,qBAAqB,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,KAAK,YAAY;QAAE,OAAO;IACxF,MAAM,IAAI,SAAS,CAAC,qBAAqB,EAAE;QACzC,OAAO,EAAE,+EAA+E;KACzF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,QAAwB;IAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;QACjF,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC;IACpC,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACpD,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAChD,CAAC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/agent-content-sink.d.ts

@@ -0,0 +1,11 @@
+import type { AgentContentSink } from "@relkit/agents";
+import type { ActiveAgentExecution } from "./agent-active-execution.js";
+import type { agentContext } from "./agent-rpc-support.js";
+type ResolvedAgent = Awaited<ReturnType<typeof agentContext>>;
+export interface AgentJournalSink extends AgentContentSink {
+    readonly ensureOutput: (value: unknown, signal: AbortSignal) => Promise<void>;
+    readonly isWaiting: () => boolean;
+}
+export declare function createAgentContentSink(resolved: ResolvedAgent, active: ActiveAgentExecution, messageId: string, assistantCreatedAt: string): AgentJournalSink;
+export {};
+//# sourceMappingURL=agent-content-sink.d.ts.map

package/dist/agent-content-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-content-sink.d.ts","sourceRoot":"","sources":["../src/agent-content-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAsC,MAAM,gBAAgB,CAAC;AAE3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAM3D,KAAK,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AAE9D,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC;CACnC;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,GACzB,gBAAgB,CAkKlB"}

package/dist/agent-content-sink.js

@@ -0,0 +1,132 @@
+import { appendAgentMessage, appendBrowserMessage } from "./agent-run-journal.js";
+import { agentLimits, digest, encodedBytes } from "./agent-rpc-support.js";
+import { createOperationId } from "@relkit/realtime";
+import { createAgentProgressSink } from "./agent-progress-sink.js";
+export function createAgentContentSink(resolved, active, messageId, assistantCreatedAt) {
+    const toolParts = new Map();
+    const toolCreatedAt = new Map();
+    let latestOutput;
+    let hasOutput = false;
+    let outputFinished = false;
+    let waiting = false;
+    return Object.freeze({
+        isWaiting: () => waiting,
+        emitWaiting: async (value, signal) => {
+            if (waiting)
+                return;
+            if (signal.aborted)
+                throw signal.reason;
+            await resolved.provider.suspendRun({
+                ...resolved.scope,
+                operationId: createOperationId(),
+                threadId: active.receipt.threadId,
+                runId: active.receipt.runId,
+                claim: active.claim,
+                waiting: { ...value, runId: active.receipt.runId },
+                suspendedAt: new Date().toISOString(),
+            });
+            waiting = true;
+        },
+        ensureOutput: async (value, signal) => {
+            if (outputFinished)
+                return;
+            if (signal.aborted)
+                throw signal.reason;
+            await appendAgentMessage(resolved, active.receipt, active.claim, "assistant", hasOutput ? latestOutput : value, messageId, assistantCreatedAt, "complete");
+            outputFinished = true;
+        },
+        emitEvent: async (value, signal) => {
+            if (signal.aborted)
+                throw signal.reason;
+            await resolved.provider.appendJournal({
+                ...resolved.scope,
+                threadId: active.receipt.threadId,
+                runId: active.receipt.runId,
+                claim: active.claim,
+                operationId: createOperationId(),
+                semanticDigest: digest(value),
+                record: {
+                    recordId: crypto.randomUUID(),
+                    runId: active.receipt.runId,
+                    kind: "event",
+                    publicValue: value,
+                    encodedBytes: encodedBytes(value),
+                    createdAt: value.occurredAt,
+                },
+                limits: agentLimits,
+            });
+        },
+        emitMessage: async (value, signal) => {
+            if (signal.aborted)
+                throw signal.reason;
+            await appendBrowserMessage(resolved, active.receipt, active.claim, {
+                ...value,
+                runId: active.receipt.runId,
+            });
+        },
+        progressSinkForTool: (tool) => createAgentProgressSink(resolved, active, tool),
+        emitOutput: (value, signal) => {
+            if (signal.aborted)
+                throw signal.reason;
+            latestOutput = value;
+            hasOutput = true;
+            return appendAgentMessage(resolved, active.receipt, active.claim, "assistant", value, messageId, assistantCreatedAt, "streaming");
+        },
+        finishOutput: async (signal) => {
+            if (signal.aborted)
+                throw signal.reason;
+            if (!hasOutput || outputFinished)
+                return;
+            await appendAgentMessage(resolved, active.receipt, active.claim, "assistant", latestOutput, messageId, assistantCreatedAt, "complete");
+            outputFinished = true;
+        },
+        emitTool: async (value, signal) => {
+            if (signal.aborted)
+                throw signal.reason;
+            const toolMessageId = `${active.receipt.runId}:tool:${value.toolCallId}`;
+            const prior = toolParts.get(value.toolCallId);
+            const part = {
+                ...(prior ?? {
+                    partId: `${toolMessageId}:state`,
+                    kind: "tool",
+                    toolCallId: value.toolCallId,
+                    toolId: value.toolId,
+                }),
+                state: value.state,
+                ...(value.state === "input-streaming" && typeof value.value === "string"
+                    ? { inputText: value.value }
+                    : {}),
+                ...(value.state === "input-ready" ? { input: value.value } : {}),
+                ...(value.state === "succeeded" ? { output: value.value } : {}),
+            };
+            toolParts.set(value.toolCallId, part);
+            const createdAt = toolCreatedAt.get(value.toolCallId) ?? new Date().toISOString();
+            toolCreatedAt.set(value.toolCallId, createdAt);
+            const message = {
+                messageId: toolMessageId,
+                runId: active.receipt.runId,
+                role: "tool",
+                parts: [part],
+                createdAt,
+            };
+            await resolved.provider.appendJournal({
+                ...resolved.scope,
+                threadId: active.receipt.threadId,
+                runId: active.receipt.runId,
+                claim: active.claim,
+                operationId: createOperationId(),
+                semanticDigest: digest(message),
+                record: {
+                    recordId: crypto.randomUUID(),
+                    runId: active.receipt.runId,
+                    kind: "message",
+                    publicValue: message,
+                    encodedBytes: encodedBytes(message),
+                    createdAt: message.createdAt,
+                },
+                limits: agentLimits,
+            });
+        },
+    });
+}
+//# sourceMappingURL=agent-content-sink.js.map

package/dist/agent-content-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-content-sink.js","sourceRoot":"","sources":["../src/agent-content-sink.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AASnE,MAAM,UAAU,sBAAsB,CACpC,QAAuB,EACvB,MAA4B,EAC5B,SAAiB,EACjB,kBAA0B;IAE1B,MAAM,SAAS,GAAG,IAAI,GAAG,EAYtB,CAAC;IACJ,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,IAAI,YAAqB,CAAC;IAC1B,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO;QACxB,WAAW,EAAE,KAAK,EAChB,KAAkE,EAClE,MAAmB,EACnB,EAAE;YACF,IAAI,OAAO;gBAAE,OAAO;YACpB,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAC;YACxC,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACjC,GAAG,QAAQ,CAAC,KAAK;gBACjB,WAAW,EAAE,iBAAiB,EAAE;gBAChC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ;gBACjC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO,EAAE,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE;gBAClD,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC,CAAC;YACH,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,YAAY,EAAE,KAAK,EAAE,KAAc,EAAE,MAAmB,EAAE,EAAE;YAC1D,IAAI,cAAc;gBAAE,OAAO;YAC3B,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAC;YACxC,MAAM,kBAAkB,CACtB,QAAQ,EACR,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,KAAK,EACZ,WAAW,EACX,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,EAChC,SAAS,EACT,kBAAkB,EAClB,UAAU,CACX,CAAC;YACF,cAAc,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,SAAS,EAAE,KAAK,EAAE,KAA0B,EAAE,MAAmB,EAAE,EAAE;YACnE,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAC;YACxC,MAAM,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC;gBACpC,GAAG,QAAQ,CAAC,KAAK;gBACjB,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ;gBACjC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,iBAAiB,EAAE;gBAChC,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC;gBAC7B,MAAM,EAAE;oBACN,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE;oBAC7B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;oBAC3B,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,KAAK;oBAClB,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC;oBACjC,SAAS,EAAE,KAAK,CAAC,UAAU;iBAC5B;gBACD,MAAM,EAAE,WAAW;aACpB,CAAC,CAAC;QACL,CAAC;QACD,WAAW,EAAE,KAAK,EAAE,KAAqB,EAAE,MAAmB,EAAE,EAAE;YAChE,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAC;YACxC,MAAM,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE;gBACjE,GAAG,KAAK;gBACR,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;aAC5B,CAAC,CAAC;QACL,CAAC;QACD,mBAAmB,EAAE,CAAC,IAA8D,EAAE,EAAE,CACtF,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;QACjD,UAAU,EAAE,CAAC,KAAc,EAAE,MAAmB,EAAE,EAAE;YAClD,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAC;YACxC,YAAY,GAAG,KAAK,CAAC;YACrB,SAAS,GAAG,IAAI,CAAC;YACjB,OAAO,kBAAkB,CACvB,QAAQ,EACR,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,KAAK,EACZ,WAAW,EACX,KAAK,EACL,SAAS,EACT,kBAAkB,EAClB,WAAW,CACZ,CAAC;QACJ,CAAC;QACD,YAAY,EAAE,KAAK,EAAE,MAAmB,EAAE,EAAE;YAC1C,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAC;YACxC,IAAI,CAAC,SAAS,IAAI,cAAc;gBAAE,OAAO;YACzC,MAAM,kBAAkB,CACtB,QAAQ,EACR,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,KAAK,EACZ,WAAW,EACX,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,UAAU,CACX,CAAC;YACF,cAAc,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,QAAQ,EAAE,KAAK,EACb,KAAoF,EACpF,MAAmB,EACnB,EAAE;YACF,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAC;YACxC,MAAM,aAAa,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS,KAAK,CAAC,UAAU,EAAE,CAAC;YACzE,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG;gBACX,GAAG,CAAC,KAAK,IAAI;oBACX,MAAM,EAAE,GAAG,aAAa,QAAQ;oBAChC,IAAI,EAAE,MAAe;oBACrB,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;iBACrB,CAAC;gBACF,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,iBAAiB,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;oBACtE,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE;oBAC5B,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChE,CAAC;YACF,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAClF,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG;gBACd,SAAS,EAAE,aAAa;gBACxB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;gBAC3B,IAAI,EAAE,MAAe;gBACrB,KAAK,EAAE,CAAC,IAAI,CAAC;gBACb,SAAS;aACV,CAAC;YACF,MAAM,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC;gBACpC,GAAG,QAAQ,CAAC,KAAK;gBACjB,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ;gBACjC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,iBAAiB,EAAE;gBAChC,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC;gBAC/B,MAAM,EAAE;oBACN,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE;oBAC7B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;oBAC3B,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,OAAO;oBACpB,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC;oBACnC,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B;gBACD,MAAM,EAAE,WAAW;aACpB,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/agent-control-worker.d.ts

@@ -0,0 +1,8 @@
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+import type { agentContext } from "./agent-rpc-support.js";
+import { AgentApprovalCoordinator } from "./agent-approval-coordinator.js";
+import type { ActiveAgentExecution } from "./agent-active-execution.js";
+type ResolvedAgent = Awaited<ReturnType<typeof agentContext>>;
+export declare function consumeAgentControls(resolved: ResolvedAgent, active: ActiveAgentExecution, options: RouteMaterializationOptions, runController: AbortController, approvals: AgentApprovalCoordinator, signal: AbortSignal): Promise<void>;
+export {};
+//# sourceMappingURL=agent-control-worker.d.ts.map

package/dist/agent-control-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-control-worker.d.ts","sourceRoot":"","sources":["../src/agent-control-worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,KAAK,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AAE9D,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,2BAA2B,EACpC,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,wBAAwB,EACnC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/dist/agent-control-worker.js

@@ -0,0 +1,131 @@
+import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
+import { AgentApprovalCoordinator } from "./agent-approval-coordinator.js";
+export async function consumeAgentControls(resolved, active, options, runController, approvals, signal) {
+    let afterSequence;
+    let runId = active.receipt.runId;
+    while (!signal.aborted) {
+        if (runId !== active.receipt.runId) {
+            runId = active.receipt.runId;
+            afterSequence = undefined;
+        }
+        const page = await resolved.provider.readControls({
+            ...resolved.scope,
+            threadId: active.receipt.threadId,
+            runId,
+            ...(afterSequence === undefined ? {} : { afterSequence }),
+            limit: 32,
+        });
+        for (const operationId of page.operationIds) {
+            await applyControl(resolved, active.receipt.threadId, runId, options, operationId, runController, approvals, active).catch(() => undefined);
+        }
+        afterSequence = page.nextSequence;
+        if (!page.hasMore)
+            await resolved.provider.waitForControls({
+                ...resolved.scope,
+                threadId: active.receipt.threadId,
+                runId,
+                afterSequence: page.nextSequence,
+                deadlineMs: Date.now() + 15_000,
+                signal,
+            });
+    }
+}
+async function applyControl(resolved, threadId, runId, options, operationId, runController, approvals, active) {
+    const snapshot = await resolved.provider.loadThread({
+        ...resolved.scope,
+        threadId,
+        maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
+    });
+    const record = snapshot.controls.find((candidate) => candidate.controlId === operationId);
+    if (record === undefined)
+        return;
+    if (record.kind === "follow-up")
+        return;
+    const claim = await resolved.provider.claimControl({
+        ...resolved.scope,
+        threadId,
+        runId,
+        operationId,
+        workerId: crypto.randomUUID(),
+        generationId: options.agentRuntime.generationId,
+        expiresAt: new Date(Date.now() + 45_000).toISOString(),
+    });
+    const now = new Date().toISOString();
+    if (record.kind === "stop") {
+        await resolved.provider.markControlEffectStarted({
+            ...resolved.scope,
+            threadId,
+            runId,
+            operationId,
+            claim,
+        });
+        runController.abort(new Error("Agent stopped."));
+        await resolved.provider.settleControl({
+            ...resolved.scope,
+            threadId,
+            runId,
+            operationId,
+            claim,
+            status: "applied",
+            effect: "confirmed",
+            settledAt: now,
+        });
+        return;
+    }
+    if (record.kind === "approve") {
+        await approvals.continue(operationId, record.publicPayload, async () => {
+            await resolved.provider.markControlEffectStarted({
+                ...resolved.scope,
+                threadId,
+                runId,
+                operationId,
+                claim,
+                downstreamOperationId: operationId,
+            });
+            await resolved.provider.settleControl({
+                ...resolved.scope,
+                threadId,
+                runId,
+                operationId,
+                claim,
+                status: "applied",
+                effect: "confirmed",
+                downstreamOperationId: operationId,
+                settledAt: now,
+            });
+        });
+        return;
+    }
+    if (record.kind === "steer" && typeof record.publicPayload === "string") {
+        await resolved.provider.markControlEffectStarted({
+            ...resolved.scope,
+            threadId,
+            runId,
+            operationId,
+            claim,
+        });
+        active.steering.push(record.publicPayload);
+        await resolved.provider.settleControl({
+            ...resolved.scope,
+            threadId,
+            runId,
+            operationId,
+            claim,
+            status: "applied",
+            effect: "confirmed",
+            settledAt: now,
+        });
+        return;
+    }
+    await resolved.provider.settleControl({
+        ...resolved.scope,
+        threadId,
+        runId,
+        operationId,
+        claim,
+        status: "rejected",
+        effect: "not-started",
+        settledAt: now,
+    });
+}
+//# sourceMappingURL=agent-control-worker.js.map

package/dist/agent-control-worker.js.map

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

package/dist/agent-follow-up.d.ts

@@ -0,0 +1,12 @@
+import type { ActiveAgentExecution } from "./agent-active-execution.js";
+import type { agentContext } from "./agent-rpc-support.js";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+type ResolvedAgent = Awaited<ReturnType<typeof agentContext>>;
+export interface NextAgentRun {
+    readonly receipt: Awaited<ReturnType<ResolvedAgent["provider"]["acceptRun"]>>;
+    readonly input: unknown;
+    readonly controlRunIds: readonly string[];
+}
+export declare function processAgentFollowUps(resolved: ResolvedAgent, active: ActiveAgentExecution, options: RouteMaterializationOptions, startNext: boolean): Promise<NextAgentRun | undefined>;
+export {};
+//# sourceMappingURL=agent-follow-up.d.ts.map