@relkit/runtime-hono 0.4.0 → 0.5.1

package/dist/agent-protocol.js

@@ -0,0 +1,101 @@
+import { EventType, RunAgentInputSchema } from "@ag-ui/core";
+import { AGENT_CAPABILITY_HEADER, AGENT_CAPABILITY_VALUE } from "@relkit/contracts";
+import { acceptAgentRun } from "./agent-rpc-write.js";
+import { loadAgent } from "./agent-rpc-read.js";
+import { requireAgentThreadId } from "./agent-rpc-support.js";
+import { agUiFrames } from "./agent-protocol-encoding.js";
+import { agentProtocolFrames } from "./agent-protocol-stream.js";
+import { encodeAgentCursor, eventStream, isRecord, latestUserText, operationId, parseAgentCursor, protocolEndpoint, serverSentEvent, } from "./agent-protocol-support.js";
+import { assertAgentCapabilities } from "./agent-capability-negotiation.js";
+const AGENT_STREAM_HEADERS = { [AGENT_CAPABILITY_HEADER]: AGENT_CAPABILITY_VALUE };
+export function installAgentProtocolEndpoints(app, options) {
+    if (options.agentRuntime === undefined || options.clientIdentity === undefined)
+        return;
+    app.post("/_relkit/v1/agents/:agentId/ag-ui", (context) => protocolEndpoint(context, () => agUi(context, options)));
+}
+async function agUi(context, options) {
+    assertAgentCapabilities(context.req.raw);
+    const body = await context.req.json().catch(() => undefined);
+    if (context.req.header("x-relkit-agent-observe") === "1") {
+        return observeAgUi(context, options, body);
+    }
+    const parsed = RunAgentInputSchema.safeParse(body);
+    if (!parsed.success)
+        return context.json({ error: "invalid-agent-request" }, 422);
+    const rpc = rpcContext(context, options);
+    const agentId = requiredAgentId(context);
+    const after = parseAgentCursor(context.req.header("last-event-id"));
+    const receipt = await acceptAgentRun({
+        agentId,
+        threadId: parsed.data.threadId,
+        kind: "run",
+        operationId: operationId(context),
+        payload: latestUserText(parsed.data.messages) ?? parsed.data.state,
+    }, rpc, options);
+    return eventStream(async function* (signal) {
+        if (after === undefined) {
+            yield serverSentEvent({
+                type: EventType.RUN_STARTED,
+                threadId: receipt.threadId,
+                runId: receipt.runId,
+            });
+        }
+        for await (const emission of agentProtocolFrames(rpc, options, agentId, receipt, after, signal)) {
+            const frames = [...agUiFrames(emission.frame)];
+            for (let index = 0; index < frames.length; index += 1) {
+                const cursor = index === frames.length - 1 && emission.checkpoint !== undefined
+                    ? encodeAgentCursor(emission.checkpoint)
+                    : undefined;
+                yield serverSentEvent(index === frames.length - 1
+                    ? withObservation(frames[index], emission.observation)
+                    : frames[index], cursor);
+            }
+        }
+    }, AGENT_STREAM_HEADERS);
+}
+async function observeAgUi(context, options, body) {
+    if (!isRecord(body))
+        return context.json({ error: "invalid-agent-request" }, 422);
+    const threadId = requireAgentThreadId(body.threadId);
+    const rpc = rpcContext(context, options);
+    const agentId = requiredAgentId(context);
+    const snapshot = await loadAgent({ agentId, threadId }, rpc, options);
+    const runId = typeof body.runId === "string" ? body.runId.trim() : "";
+    if (runId === "" && snapshot.currentRuns.length === 0) {
+        return eventStream(async function* () { });
+    }
+    if (runId === "")
+        throw new TypeError("runId is required for a thread with runs.");
+    if (!snapshot.currentRuns.some((run) => run.runId === runId)) {
+        throw new TypeError("runId does not belong to the requested thread.");
+    }
+    const after = parseAgentCursor(context.req.header("last-event-id"));
+    return eventStream(async function* (signal) {
+        for await (const emission of agentProtocolFrames(rpc, options, agentId, { threadId, runId }, after, signal, true)) {
+            const frames = [...agUiFrames(emission.frame)];
+            for (let index = 0; index < frames.length; index += 1) {
+                const last = index === frames.length - 1;
+                yield serverSentEvent(last ? withObservation(frames[index], emission.observation) : frames[index], last && emission.checkpoint !== undefined
+                    ? encodeAgentCursor(emission.checkpoint)
+                    : undefined);
+            }
+        }
+    }, AGENT_STREAM_HEADERS);
+}
+function withObservation(frame, observation) {
+    if (!isRecord(frame) || observation === undefined)
+        return frame;
+    const metadata = isRecord(frame.metadata) ? frame.metadata : {};
+    const relkit = isRecord(metadata.relkit) ? metadata.relkit : {};
+    return { ...frame, metadata: { ...metadata, relkit: { ...relkit, observation } } };
+}
+function rpcContext(context, options) {
+    return { hono: context, auth: options.auth?.contextFor(context.req.raw) };
+}
+function requiredAgentId(context) {
+    const value = context.req.param("agentId");
+    if (value === undefined || value === "")
+        throw new TypeError("Agent ID is required.");
+    return value;
+}
+//# sourceMappingURL=agent-protocol.js.map

package/dist/agent-protocol.js.map

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

package/dist/agent-rpc-errors.d.ts

@@ -0,0 +1,5 @@
+import { ORPCError } from "@orpc/server";
+export declare function agentRpcCall<Value>(action: () => Promise<Value>): Promise<Value>;
+export declare function agentRpcStream<Value>(action: () => AsyncIterable<Value>): AsyncIterable<Value>;
+export declare function agentRpcError(error: unknown): ORPCError<string, unknown>;
+//# sourceMappingURL=agent-rpc-errors.d.ts.map

package/dist/agent-rpc-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-rpc-errors.d.ts","sourceRoot":"","sources":["../src/agent-rpc-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAqBzC,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAMtF;AAED,wBAAuB,cAAc,CAAC,KAAK,EACzC,MAAM,EAAE,MAAM,aAAa,CAAC,KAAK,CAAC,GACjC,aAAa,CAAC,KAAK,CAAC,CAMtB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAQxE"}

package/dist/agent-rpc-errors.js

@@ -0,0 +1,65 @@
+import { ORPCError } from "@orpc/server";
+const publicCodes = new Set([
+    "AGENT_CAPABILITIES_UNSUPPORTED",
+    "AGENT_APPROVAL_REQUIRED",
+    "AGENT_BUSY",
+    "AGENT_CONTROL_OVERLOADED",
+    "AGENT_OUTPUT_TOO_LARGE",
+    "AGENT_PRINCIPAL_OVERLOADED",
+    "AGENT_PROVIDER_OVERLOADED",
+    "AGENT_STOPPING",
+    "AGENT_WORKER_INTERRUPTED",
+    "AGENT_RUN_READ_ONLY",
+    "GENERATION_UNAVAILABLE",
+    "IDENTITY_PRECONDITION_FAILED",
+    "IDEMPOTENCY_CONFLICT",
+    "IDEMPOTENCY_WINDOW_EXPIRED",
+    "PROVIDER_STATE_LOST",
+    "NOT_FOUND",
+]);
+export async function agentRpcCall(action) {
+    try {
+        return await action();
+    }
+    catch (error) {
+        throw agentRpcError(error);
+    }
+}
+export async function* agentRpcStream(action) {
+    try {
+        yield* action();
+    }
+    catch (error) {
+        throw agentRpcError(error);
+    }
+}
+export function agentRpcError(error) {
+    if (error instanceof ORPCError)
+        return error;
+    if (error instanceof TypeError)
+        return new ORPCError("BAD_REQUEST", { message: error.message });
+    const code = errorCode(error);
+    if (code !== undefined && publicCodes.has(code)) {
+        return new ORPCError(code, { message: publicMessage(code) });
+    }
+    return new ORPCError("INTERNAL_SERVER_ERROR");
+}
+function errorCode(error) {
+    if (error === null || typeof error !== "object")
+        return undefined;
+    return typeof error.code === "string"
+        ? error.code
+        : undefined;
+}
+function publicMessage(code) {
+    if (code === "NOT_FOUND")
+        return "Agent resource was not found.";
+    if (code === "PROVIDER_STATE_LOST")
+        return "Agent provider state changed.";
+    if (code === "IDEMPOTENCY_WINDOW_EXPIRED")
+        return "The idempotency window expired.";
+    if (code === "IDEMPOTENCY_CONFLICT")
+        return "The operation ID was reused with different content.";
+    return code.toLowerCase().replaceAll("_", " ");
+}
+//# sourceMappingURL=agent-rpc-errors.js.map

package/dist/agent-rpc-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-rpc-errors.js","sourceRoot":"","sources":["../src/agent-rpc-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,gCAAgC;IAChC,yBAAyB;IACzB,YAAY;IACZ,0BAA0B;IAC1B,wBAAwB;IACxB,4BAA4B;IAC5B,2BAA2B;IAC3B,gBAAgB;IAChB,0BAA0B;IAC1B,qBAAqB;IACrB,wBAAwB;IACxB,8BAA8B;IAC9B,sBAAsB;IACtB,4BAA4B;IAC5B,qBAAqB;IACrB,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAQ,MAA4B;IACpE,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CACnC,MAAkC;IAElC,IAAI,CAAC;QACH,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,YAAY,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,KAAK,YAAY,SAAS;QAAE,OAAO,IAAI,SAAS,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,SAAS,CAAC,uBAAuB,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAClE,OAAO,OAAQ,KAAqC,CAAC,IAAI,KAAK,QAAQ;QACpE,CAAC,CAAE,KAAmC,CAAC,IAAI;QAC3C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,IAAI,KAAK,WAAW;QAAE,OAAO,+BAA+B,CAAC;IACjE,IAAI,IAAI,KAAK,qBAAqB;QAAE,OAAO,+BAA+B,CAAC;IAC3E,IAAI,IAAI,KAAK,4BAA4B;QAAE,OAAO,iCAAiC,CAAC;IACpF,IAAI,IAAI,KAAK,sBAAsB;QAAE,OAAO,qDAAqD,CAAC;IAClG,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC"}

package/dist/agent-rpc-read.d.ts

@@ -0,0 +1,42 @@
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+import type { RpcContext } from "./rpc.js";
+import { type AgentInput } from "./agent-rpc-support.js";
+export declare function listAgentThreads(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions): Promise<import("@relkit/agents").ThreadList>;
+export declare function loadAgent(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions): Promise<import("@relkit/contracts").ThreadSnapshot>;
+export declare function observeAgent(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions, signal?: AbortSignal): AsyncGenerator<{
+    kind: "gap";
+    reason: "expired" | "foreign" | "future" | "session" | "provider-reset";
+    snapshot: import("@relkit/contracts").ThreadSnapshot;
+    event?: never;
+} | {
+    kind: "event";
+    event: import("@relkit/contracts").AgentClientEvent;
+    reason?: never;
+    snapshot?: never;
+} | {
+    kind: "snapshot";
+    snapshot: import("@relkit/contracts").ThreadSnapshot;
+    reason?: never;
+    event?: never;
+}, void, unknown>;
+export declare function lookupAgentReceipt(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions): Promise<{
+    readonly status: "not-found";
+    readonly providerEpoch: string;
+} | {
+    readonly status: "expired";
+    readonly expiredAt: string;
+} | {
+    readonly status: "state-lost";
+    readonly previousEpoch?: string;
+} | {
+    readonly status: "found";
+    readonly receipt: import("@relkit/agents").ContinuationReceipt;
+} | {
+    readonly status: "found";
+    readonly receipt: import("@relkit/agents").ControlReceipt;
+} | {
+    readonly status: "found";
+    readonly receipt: import("@relkit/agents").AcceptRunReceipt | import("@relkit/agents").CompletionReceipt;
+}>;
+export declare function readAgentHistory(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions): Promise<import("@relkit/agents").SnapshotHistoryPage>;
+//# sourceMappingURL=agent-rpc-read.d.ts.map

package/dist/agent-rpc-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-rpc-read.d.ts","sourceRoot":"","sources":["../src/agent-rpc-read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAG7F,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,gDAKrC;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,uDAYrC;AAED,wBAAuB,YAAY,CACjC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,EACpC,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;kBAoDrB;AAWD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B;;;;;;;;;;;;;;;;;;GAmCrC;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,yDAcrC"}

package/dist/agent-rpc-read.js

@@ -0,0 +1,127 @@
+import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
+import { agentClientEvents } from "@relkit/agents";
+import { assertExpectedIdentity } from "./rpc-identity.js";
+import { agentContext, requireAgentThreadId } from "./agent-rpc-support.js";
+import { clientAgentSnapshot } from "./agent-compatibility.js";
+export async function listAgentThreads(input, context, options) {
+    await assertExpectedIdentity(context, options.clientIdentity, input.expectedIdentity);
+    const resolved = await agentContext(input, context, options, "list");
+    return resolved.provider.listThreads({ ...resolved.scope, limit: 100 });
+}
+export async function loadAgent(input, context, options) {
+    await assertExpectedIdentity(context, options.clientIdentity);
+    const threadId = requireAgentThreadId(input.threadId);
+    const resolved = await agentContext({ ...input, threadId }, context, options, "load");
+    return clientAgentSnapshot(await resolved.provider.loadThread({
+        ...resolved.scope,
+        threadId,
+        maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
+    }));
+}
+export async function* observeAgent(input, context, options, signal) {
+    await assertExpectedIdentity(context, options.clientIdentity, input.expectedIdentity);
+    const threadId = requireAgentThreadId(input.threadId);
+    if (input.after === undefined)
+        throw new TypeError("checkpoint is required.");
+    let resolved = await agentContext({ ...input, threadId }, context, options, "observe");
+    let after = input.after;
+    const controller = signal ?? new AbortController().signal;
+    while (!controller.aborted) {
+        await assertExpectedIdentity(context, options.clientIdentity, input.expectedIdentity);
+        resolved = await agentContext({ ...input, threadId }, context, options, "observe");
+        const page = await resolved.provider.readJournal({
+            ...resolved.scope,
+            threadId,
+            after,
+            limit: 100,
+            maxEncodedBytes: 1024 * 1024,
+        });
+        if (page.gap !== undefined) {
+            const snapshot = clientAgentSnapshot(await resolved.provider.loadThread({
+                ...resolved.scope,
+                threadId,
+                maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
+            }));
+            after = snapshot.checkpoint;
+            yield { kind: "gap", reason: page.gap, snapshot };
+            continue;
+        }
+        after = page.checkpoint;
+        for (const record of page.records)
+            for (const event of agentClientEvents(record))
+                yield { kind: "event", event };
+        if (page.records.some(requiresSnapshot)) {
+            const snapshot = clientAgentSnapshot(await resolved.provider.loadThread({
+                ...resolved.scope,
+                threadId,
+                maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
+            }));
+            yield { kind: "snapshot", snapshot };
+        }
+        if (!page.hasMore)
+            await resolved.provider.waitForJournal({
+                ...resolved.scope,
+                threadId,
+                after,
+                deadlineMs: Date.now() + 15_000,
+                signal: controller,
+            });
+    }
+}
+function requiresSnapshot(record) {
+    return (record.kind === "approval" ||
+        record.kind === "control" ||
+        record.kind === "terminal" ||
+        record.kind === "interruption");
+}
+export async function lookupAgentReceipt(input, context, options) {
+    await assertExpectedIdentity(context, options.clientIdentity);
+    if (input.operationId === undefined || input.requestDigest === undefined)
+        throw new TypeError("Receipt request is invalid.");
+    const resolved = await agentContext(input, context, options, "receipt");
+    if (input.kind === "continuation") {
+        const threadId = requireAgentThreadId(input.threadId);
+        return resolved.provider.lookupContinuationReceipt({
+            ...resolved.scope,
+            operationId: input.operationId,
+            threadId,
+            semanticDigest: input.requestDigest,
+            now: new Date().toISOString(),
+        });
+    }
+    if (input.kind === "agent-control") {
+        const threadId = requireAgentThreadId(input.threadId);
+        if (input.runId === undefined)
+            throw new TypeError("Control receipt request is invalid.");
+        return resolved.provider.lookupControlReceipt({
+            ...resolved.scope,
+            operationId: input.operationId,
+            threadId,
+            runId: input.runId,
+            semanticDigest: input.requestDigest,
+            now: new Date().toISOString(),
+        });
+    }
+    return resolved.provider.lookupRunReceipt({
+        ...resolved.scope,
+        operationId: input.operationId,
+        ...(input.threadId === undefined ? {} : { threadId: input.threadId }),
+        semanticDigest: input.requestDigest,
+        now: new Date().toISOString(),
+    });
+}
+export async function readAgentHistory(input, context, options) {
+    await assertExpectedIdentity(context, options.clientIdentity);
+    const threadId = requireAgentThreadId(input.threadId);
+    if (input.snapshotId === undefined || input.cursor === undefined)
+        throw new TypeError("Snapshot and cursor are required.");
+    const resolved = await agentContext({ ...input, threadId }, context, options, "history");
+    return resolved.provider.readSnapshotHistory({
+        ...resolved.scope,
+        threadId,
+        snapshotId: input.snapshotId,
+        cursor: input.cursor,
+        maxEncodedBytes: REALTIME_RUNTIME_LIMITS.snapshotHistoryPageBytes,
+    });
+}
+//# sourceMappingURL=agent-rpc-read.js.map

package/dist/agent-rpc-read.js.map

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

package/dist/agent-rpc-resume.d.ts

@@ -0,0 +1,13 @@
+import { type OperationId } from "@relkit/contracts";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+import { agentContext, type AgentInput } from "./agent-rpc-support.js";
+type ResolvedAgent = Awaited<ReturnType<typeof agentContext>>;
+export declare function acceptAgentResume(input: AgentInput, threadId: string, operationId: OperationId, resolved: ResolvedAgent, options: RouteMaterializationOptions): Promise<{
+    operationId: OperationId;
+    threadId: string;
+    runId: string;
+    status: "accepted";
+    duplicate: boolean;
+}>;
+export {};
+//# sourceMappingURL=agent-rpc-resume.d.ts.map

package/dist/agent-rpc-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-rpc-resume.d.ts","sourceRoot":"","sources":["../src/agent-rpc-resume.ts"],"names":[],"mappings":"AAKA,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EACL,YAAY,EAEZ,KAAK,UAAU,EAEhB,MAAM,wBAAwB,CAAC;AAKhC,KAAK,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AAE9D,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,2BAA2B;;;;;;GAuDrC"}

package/dist/agent-rpc-resume.js

@@ -0,0 +1,72 @@
+import { isGraphDescriptor, validateGraphResumeInput, validateNativeAgentResumeInput, } from "@relkit/agents";
+import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
+import { agentContext, digest, verifiedAgentRequestDigest, } from "./agent-rpc-support.js";
+import { startAgentRun } from "./agent-rpc-worker.js";
+import { waitForAgentRun } from "./agent-run-tasks.js";
+import { assertAgentRunWritable } from "./agent-compatibility.js";
+export async function acceptAgentResume(input, threadId, operationId, resolved, options) {
+    if (typeof input.waitingRevision !== "string" || input.waitingRevision.length === 0) {
+        throw new TypeError("Agent resume requires the observed waiting revision.");
+    }
+    const requestDigest = verifiedAgentRequestDigest(input);
+    const snapshot = await resolved.provider.loadThread({
+        ...resolved.scope,
+        threadId,
+        maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
+    });
+    const waiting = snapshot.waiting;
+    assertAgentRunWritable(snapshot, waiting?.runId);
+    if (waiting === undefined) {
+        const prior = await resolved.provider.lookupContinuationReceipt({
+            ...resolved.scope,
+            operationId,
+            threadId,
+            semanticDigest: requestDigest,
+            now: new Date().toISOString(),
+        });
+        if (prior.status === "found") {
+            const accepted = asAcceptedRun({ ...prior.receipt, duplicate: true });
+            startAgentRun(resolved, accepted, input.payload, options, true);
+            return accepted;
+        }
+        throw new TypeError("Agent has no waiting continuation.");
+    }
+    if (input.waitingRevision !== waiting.revision) {
+        throw new TypeError("Agent waiting revision is stale.");
+    }
+    let reply;
+    try {
+        reply = isGraphDescriptor(resolved.descriptor)
+            ? await validateGraphResumeInput(resolved.descriptor, waiting.requests, input.payload)
+            : validateNativeAgentResumeInput(waiting.requests, input.payload);
+    }
+    catch {
+        throw new TypeError("Agent resume input validation failed.");
+    }
+    await waitForAgentRun(waiting.runId);
+    const continuation = await resolved.provider.admitContinuation({
+        ...resolved.scope,
+        kind: "resume",
+        operationId,
+        semanticDigest: requestDigest,
+        threadId,
+        interruptedRunId: waiting.runId,
+        interruptSetDigest: digest(waiting),
+        waitingRevision: waiting.revision,
+        admittedAt: new Date().toISOString(),
+        receiptExpiresAt: new Date(Date.now() + REALTIME_RUNTIME_LIMITS.agentReceiptMs).toISOString(),
+    });
+    const accepted = asAcceptedRun(continuation);
+    startAgentRun(resolved, accepted, reply, options, true);
+    return accepted;
+}
+function asAcceptedRun(continuation) {
+    return {
+        operationId: continuation.operationId,
+        threadId: continuation.threadId,
+        runId: continuation.runId,
+        status: "accepted",
+        duplicate: continuation.duplicate,
+    };
+}
+//# sourceMappingURL=agent-rpc-resume.js.map

package/dist/agent-rpc-resume.js.map

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

package/dist/agent-rpc-support.d.ts

@@ -0,0 +1,44 @@
+import { type OperationId } from "@relkit/contracts";
+import type { AgentRequestScope, AgentStateLimits, RunOwner } from "@relkit/agents";
+import { type StandardSchemaV1 } from "@relkit/schema";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+import type { RpcContext } from "./rpc.js";
+export interface AgentInput {
+    readonly agentId: string;
+    readonly expectedIdentity?: import("@relkit/contracts").ExpectedClientIdentity;
+    readonly threadId?: string;
+    readonly resume?: boolean;
+    readonly waitingRevision?: string;
+    readonly runId?: string;
+    readonly operationId?: OperationId;
+    readonly kind?: string;
+    readonly payload?: unknown;
+    readonly after?: unknown;
+    readonly requestDigest?: string;
+    readonly snapshotId?: string;
+    readonly cursor?: string;
+}
+export declare function requireAgentThreadId(value: unknown): string;
+export declare function agentContext(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions, operation: string): Promise<{
+    descriptor: {
+        readonly input: StandardSchemaV1;
+        readonly output: StandardSchemaV1;
+        readonly client?: unknown;
+        readonly chat?: {
+            readonly input?: unknown;
+            readonly output?: unknown;
+        };
+    };
+    node: import("@relkit/graph").AgentRegistration;
+    provider: import("@relkit/agents").AgentStateProvider;
+    scope: AgentRequestScope;
+    trusted: unknown;
+}>;
+export declare function validateAgentValue(schema: StandardSchemaV1, value: unknown): Promise<unknown>;
+export declare function validateAgentInput(resolved: Awaited<ReturnType<typeof agentContext>>, payload: unknown): Promise<unknown>;
+export declare const agentLimits: AgentStateLimits;
+export declare function digest(value: unknown): string;
+export declare function verifiedAgentRequestDigest(input: AgentInput): string;
+export declare function encodedBytes(value: unknown): number;
+export declare function agentOwner(options: RouteMaterializationOptions, profile: string): RunOwner;
+//# sourceMappingURL=agent-rpc-support.d.ts.map

package/dist/agent-rpc-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-rpc-support.d.ts","sourceRoot":"","sources":["../src/agent-rpc-support.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAY,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,mBAAmB,EAAE,sBAAsB,CAAC;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK3D;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,EACpC,SAAS,EAAE,MAAM;;wBAkHD,gBAAgB;yBACf,gBAAgB;0BACf,OAAO;wBACT;YAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;SAAE;;;;;;GArExE;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,oBAIhF;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,EAClD,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,eAAO,MAAM,WAAW,EAAE,gBAWzB,CAAC;AAEF,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI7C;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAUpE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,2BAA2B,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAQ1F"}

package/dist/agent-rpc-support.js

@@ -0,0 +1,111 @@
+import { createHash } from "node:crypto";
+import { AGENT_STATE_SCHEMA_VERSION, AGENT_STREAM_VERSION, canonicalJson, REALTIME_RUNTIME_LIMITS, } from "@relkit/contracts";
+import { validate } from "@relkit/schema";
+import { resolveClientIdentity } from "./client-identity.js";
+import { getEntry, isRecord } from "./materialize-routes-utils.js";
+import { ORPCError } from "@orpc/server";
+import { requireClientAuthorization } from "./client-authorization.js";
+export function requireAgentThreadId(value) {
+    if (typeof value !== "string" || value.length === 0 || value !== value.trim()) {
+        throw new TypeError("threadId must be a non-empty string without surrounding whitespace.");
+    }
+    return value;
+}
+export async function agentContext(input, context, options, operation) {
+    if (options.agentRuntime === undefined || options.clientIdentity === undefined)
+        throw new Error("Agent client runtime is unavailable.");
+    const node = options.plan.agents.find((candidate) => candidate.id === input.agentId);
+    const descriptor = getEntry(options.manifest.agents ?? {}, input.agentId);
+    if (node === undefined || node.client === undefined || !isAgent(descriptor))
+        throw new ORPCError("NOT_FOUND", { message: "Agent resource was not found." });
+    const identity = await resolveClientIdentity(options.clientIdentity, context.hono.req.raw, context.auth, true);
+    const trusted = await options.agentRuntime.trustedContext?.({
+        request: context.hono.req.raw,
+        ...(context.auth === undefined ? {} : { auth: context.auth }),
+    });
+    const authorize = isRecord(descriptor.client) ? descriptor.client.authorize : undefined;
+    if (typeof authorize === "function") {
+        await requireClientAuthorization(() => authorize({
+            agentId: input.agentId,
+            threadId: input.threadId,
+            runId: input.runId,
+            operation,
+            input: input.payload,
+        }, trusted), "agent");
+    }
+    const profile = node.stateProfile ?? "default";
+    const provider = await options.agentRuntime.provider(profile);
+    const scope = {
+        ...identity,
+        applicationId: options.agentRuntime.applicationId,
+        environment: options.agentRuntime.environment,
+        profile,
+        providerEpoch: await provider.getEpoch(),
+        agentId: input.agentId,
+        ownerScope: identity.identityScope,
+        authorizationGrantId: digest({ identity, agentId: input.agentId }),
+    };
+    return { descriptor, node, provider, scope, trusted };
+}
+export async function validateAgentValue(schema, value) {
+    const result = await validate(schema, value);
+    if (!("value" in result))
+        throw new TypeError("Agent value validation failed.");
+    return result.value;
+}
+export async function validateAgentInput(resolved, payload) {
+    try {
+        return await validateAgentValue(resolved.descriptor.input, payload);
+    }
+    catch (error) {
+        if (resolved.descriptor.chat?.input !== "message" || typeof payload !== "string")
+            throw error;
+        return validateAgentValue(resolved.descriptor.input, { message: payload });
+    }
+}
+export const agentLimits = {
+    maxSnapshotBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
+    maxHistoryPageBytes: REALTIME_RUNTIME_LIMITS.snapshotHistoryPageBytes,
+    maxJournalRecordBytes: REALTIME_RUNTIME_LIMITS.progressRecordBytes,
+    maxJournalBytesPerThread: REALTIME_RUNTIME_LIMITS.journalBytesPerThread,
+    maxStateBytesPerApplication: REALTIME_RUNTIME_LIMITS.agentStateBytes,
+    maxThreadsPerPrincipal: REALTIME_RUNTIME_LIMITS.threadsPerPrincipal,
+    maxActiveRunsPerPrincipal: REALTIME_RUNTIME_LIMITS.activeRunsPerPrincipal,
+    maxActiveRunsPerApplication: REALTIME_RUNTIME_LIMITS.activeRunsPerApplication,
+    terminalReserveBytes: REALTIME_RUNTIME_LIMITS.terminalReserveBytes,
+    terminalReserveRecords: REALTIME_RUNTIME_LIMITS.terminalReserveRecords,
+};
+export function digest(value) {
+    return `sha256:${createHash("sha256")
+        .update(canonicalJson(value))
+        .digest("hex")}`;
+}
+export function verifiedAgentRequestDigest(input) {
+    const value = input.resume === true
+        ? { payload: input.payload, waitingRevision: input.waitingRevision }
+        : input.payload;
+    const actual = digest(value);
+    if (input.requestDigest !== undefined && input.requestDigest !== actual) {
+        throw new TypeError("Agent request digest does not match its payload.");
+    }
+    return actual;
+}
+export function encodedBytes(value) {
+    return new TextEncoder().encode(JSON.stringify(value)).byteLength;
+}
+export function agentOwner(options, profile) {
+    return {
+        generationId: options.agentRuntime.generationId,
+        publicFingerprint: options.agentRuntime.publicFingerprint,
+        protocolVersion: AGENT_STREAM_VERSION,
+        schemaVersion: AGENT_STATE_SCHEMA_VERSION,
+        providerScope: profile,
+    };
+}
+function isAgent(value) {
+    return isRecord(value) && isSchema(value.input) && isSchema(value.output);
+}
+function isSchema(value) {
+    return isRecord(value) && isRecord(value["~standard"]) && value["~standard"].version === 1;
+}
+//# sourceMappingURL=agent-rpc-support.js.map