@relkit/runtime-hono 0.4.0 → 0.5.0

package/dist/agent-protocol-frame-state.js

@@ -0,0 +1,124 @@
+import { progressFrame } from "./agent-protocol-progress.js";
+import { toolEventFrame, toolFrame } from "./agent-protocol-tool.js";
+export function* snapshotFrames(snapshot, runIds, sentText, sentParts, toolInputs, recoverState = false) {
+    const acceptedAt = snapshot.currentRuns
+        .filter((candidate) => runIds.has(candidate.runId))
+        .map((candidate) => candidate.acceptedAt)
+        .sort()[0];
+    if (acceptedAt === undefined)
+        return;
+    if (recoverState) {
+        if (snapshot.values !== undefined)
+            yield { kind: "state", value: snapshot.values };
+        for (const execution of snapshot.executions) {
+            yield { kind: "event", event: "execution-snapshot", value: execution };
+        }
+    }
+    for (const message of snapshot.currentMessages) {
+        if (message.createdAt < acceptedAt)
+            continue;
+        yield* browserMessageFrames(message, sentText, sentParts, toolInputs);
+    }
+    for (const approval of snapshot.approvals) {
+        if (!runIds.has(approval.runId) || sentParts.has(approval.approvalId))
+            continue;
+        sentParts.set(approval.approvalId, approval.status);
+        yield { kind: "approval", approvalId: approval.approvalId, value: approval };
+    }
+}
+export function* eventFrames(event, runIds, sentText, sentParts, toolInputs) {
+    if (!runIds.has(event.runId))
+        return;
+    if (event.kind === "message-updated")
+        yield* browserMessageFrames(event.message, sentText, sentParts, toolInputs);
+    else if (event.kind === "approval")
+        yield { kind: "approval", approvalId: event.eventId, value: event.value };
+    else if (event.kind === "progress")
+        yield progressFrame(event.progressId, event.value, event);
+    else if (event.kind === "control")
+        yield { kind: "event", event: "control", value: event.value };
+    else if (event.kind === "run-interrupted")
+        yield { kind: "event", event: "interruption", value: event.value };
+    else if (event.kind === "execution-event")
+        yield {
+            kind: "event",
+            event: "execution",
+            value: event.value,
+            eventId: event.eventId,
+            recordId: event.recordId,
+            runId: event.runId,
+            createdAt: event.createdAt,
+        };
+    else if ("toolCallId" in event)
+        yield toolEventFrame(event, toolInputs);
+}
+export function* terminalFrames(snapshot, runId, sentText) {
+    const run = snapshot.currentRuns.find((candidate) => candidate.runId === runId);
+    for (const messageId of sentText.keys())
+        yield { kind: "text-end", messageId };
+    const text = latestText(snapshot, run.acceptedAt);
+    yield {
+        kind: "terminal",
+        threadId: snapshot.thread.threadId,
+        runId,
+        status: run.status,
+        ...(text === undefined ? {} : { text }),
+    };
+}
+export function terminalRun(snapshot, runId) {
+    const run = snapshot.currentRuns.find((candidate) => candidate.runId === runId);
+    return (run !== undefined &&
+        ["succeeded", "failed", "cancelled", "worker-interrupted"].includes(run.status));
+}
+export function continuationRun(snapshot, currentRunId, runIds) {
+    const current = snapshot.currentRuns.find((candidate) => candidate.runId === currentRunId);
+    const active = snapshot.activeRun?.runId;
+    if (current?.status === "approval-interrupted" &&
+        active !== undefined &&
+        active !== currentRunId) {
+        runIds.add(active);
+        return active;
+    }
+    return currentRunId;
+}
+function* browserMessageFrames(message, sentText, sentParts, toolInputs) {
+    if (message.role === "assistant")
+        yield* messageFrames(message, sentText);
+    for (const part of message.parts) {
+        if (part.kind === "text")
+            continue;
+        const digest = JSON.stringify(part.kind === "tool" ? [part.state, part.value] : part.value);
+        if (sentParts.get(part.partId) === digest)
+            continue;
+        sentParts.set(part.partId, digest);
+        if (part.kind === "progress") {
+            yield progressFrame(part.partId, part.value, part);
+        }
+        else if (part.kind === "tool") {
+            yield toolFrame(part, toolInputs);
+        }
+    }
+}
+function* messageFrames(message, sent) {
+    const text = message.parts
+        .filter((part) => part.kind === "text")
+        .map((part) => part.text)
+        .join("");
+    const prior = sent.get(message.messageId);
+    if (prior === undefined)
+        yield { kind: "text-start", messageId: message.messageId };
+    const delta = prior !== undefined && text.startsWith(prior) ? text.slice(prior.length) : text;
+    sent.set(message.messageId, text);
+    if (delta !== "")
+        yield { kind: "text-delta", messageId: message.messageId, delta };
+}
+function latestText(snapshot, acceptedAt) {
+    for (let index = snapshot.currentMessages.length - 1; index >= 0; index -= 1) {
+        const message = snapshot.currentMessages[index];
+        if (message.role !== "assistant" || message.createdAt < acceptedAt)
+            continue;
+        return message.parts.find((part) => part.kind === "text")?.text;
+    }
+    return undefined;
+}
+//# sourceMappingURL=agent-protocol-frame-state.js.map

package/dist/agent-protocol-frame-state.js.map

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

package/dist/agent-protocol-progress.d.ts

@@ -0,0 +1,8 @@
+import type { AgentProgressScope } from "@relkit/agents";
+import type { AgentProtocolFrame } from "./agent-protocol-stream.js";
+type ProgressFrame = Extract<AgentProtocolFrame, {
+    kind: "progress";
+}>;
+export declare function progressFrame(partId: string, value: unknown, scope: AgentProgressScope): ProgressFrame;
+export {};
+//# sourceMappingURL=agent-protocol-progress.d.ts.map

package/dist/agent-protocol-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-protocol-progress.d.ts","sourceRoot":"","sources":["../src/agent-protocol-progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,KAAK,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAEvE,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,kBAAkB,GACxB,aAAa,CAGf"}

package/dist/agent-protocol-progress.js

@@ -0,0 +1,5 @@
+export function progressFrame(partId, value, scope) {
+    const frame = { kind: "progress", partId, value };
+    return scope.scope === "tool" ? { ...frame, ...scope } : { ...frame, scope: "run" };
+}
+//# sourceMappingURL=agent-protocol-progress.js.map

package/dist/agent-protocol-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-protocol-progress.js","sourceRoot":"","sources":["../src/agent-protocol-progress.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,KAAc,EACd,KAAyB;IAEzB,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,UAAmB,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3D,OAAO,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACtF,CAAC"}

package/dist/agent-protocol-stream.d.ts

@@ -0,0 +1,57 @@
+import type { AgentObservation, JournalCheckpoint, JournalRecord } from "@relkit/agents";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+import type { RpcContext } from "./rpc.js";
+export type AgentProtocolFrame = {
+    readonly kind: "state";
+    readonly value: unknown;
+} | {
+    readonly kind: "text-start";
+    readonly messageId: string;
+} | {
+    readonly kind: "text-delta";
+    readonly messageId: string;
+    readonly delta: string;
+} | {
+    readonly kind: "text-end";
+    readonly messageId: string;
+} | ({
+    readonly kind: "progress";
+    readonly partId: string;
+    readonly value: unknown;
+} & import("@relkit/agents").AgentProgressScope) | {
+    readonly kind: "approval";
+    readonly approvalId: string;
+    readonly value: unknown;
+} | {
+    readonly kind: "event";
+    readonly event: JournalRecord["kind"] | "execution" | "execution-snapshot" | "observation";
+    readonly value: unknown;
+    readonly eventId?: string;
+    readonly recordId?: string;
+    readonly runId?: string;
+    readonly createdAt?: string;
+} | {
+    readonly kind: "tool";
+    readonly toolCallId: string;
+    readonly toolId: string;
+    readonly state: import("@relkit/agents").ToolPartState;
+    readonly value?: unknown;
+    readonly inputStarted?: boolean;
+    readonly inputDelta?: string;
+} | {
+    readonly kind: "terminal";
+    readonly threadId: string;
+    readonly runId: string;
+    readonly status: string;
+    readonly text?: string;
+};
+export interface AgentProtocolEmission {
+    readonly frame: AgentProtocolFrame;
+    readonly checkpoint?: JournalCheckpoint;
+    readonly observation?: AgentObservation;
+}
+export declare function agentProtocolFrames(context: RpcContext, options: RouteMaterializationOptions, agentId: string, receipt: {
+    readonly threadId: string;
+    readonly runId: string;
+}, after?: JournalCheckpoint, signal?: AbortSignal, includeEmptyObservations?: boolean): AsyncIterable<AgentProtocolEmission>;
+//# sourceMappingURL=agent-protocol-stream.d.ts.map

package/dist/agent-protocol-stream.d.ts.map

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

package/dist/agent-protocol-stream.js

@@ -0,0 +1,77 @@
+import { expectedClientIdentity } from "./client-identity.js";
+import { loadAgent, observeAgent } from "./agent-rpc-read.js";
+import { waitForAgentRun } from "./agent-run-tasks.js";
+import { continuationRun, eventFrames, snapshotFrames, terminalFrames, terminalRun, } from "./agent-protocol-frame-state.js";
+export async function* agentProtocolFrames(context, options, agentId, receipt, after, signal, includeEmptyObservations = false) {
+    const sentText = new Map();
+    const sentParts = new Map();
+    const toolInputs = new Map();
+    const runIds = new Set([receipt.runId]);
+    const expectedIdentity = expectedClientIdentity(context.hono.req.raw);
+    let snapshot = await loadAgent({ agentId, threadId: receipt.threadId }, context, options);
+    let currentRunId = continuationRun(snapshot, receipt.runId, runIds);
+    if (after !== undefined &&
+        terminalRun(snapshot, currentRunId) &&
+        samePoint(after, snapshot.checkpoint)) {
+        return;
+    }
+    const cursor = after ?? { ...snapshot.checkpoint, sequence: "0" };
+    const observer = new AbortController();
+    const observerSignal = signal === undefined
+        ? AbortSignal.any([context.hono.req.raw.signal, observer.signal])
+        : AbortSignal.any([context.hono.req.raw.signal, observer.signal, signal]);
+    const iterator = observeAgent({
+        agentId,
+        threadId: receipt.threadId,
+        after: cursor,
+        ...(expectedIdentity === undefined ? {} : { expectedIdentity }),
+    }, context, options, observerSignal)[Symbol.asyncIterator]();
+    try {
+        while (true) {
+            const next = await iterator.next();
+            if (next.done)
+                return;
+            const observation = next.value;
+            if (observation.kind === "event") {
+                yield* emissions(eventFrames(observation.event, runIds, sentText, sentParts, toolInputs), observation.event.checkpoint, observation, includeEmptyObservations);
+                continue;
+            }
+            snapshot = observation.snapshot;
+            currentRunId = continuationRun(snapshot, currentRunId, runIds);
+            yield* emissions(snapshotFrames(snapshot, runIds, sentText, sentParts, toolInputs, observation.kind === "gap"), snapshot.checkpoint, observation, includeEmptyObservations);
+            if (!terminalRun(snapshot, currentRunId))
+                continue;
+            observer.abort();
+            await iterator.return?.(undefined);
+            await waitForAgentRun(receipt.runId);
+            yield* emissions(terminalFrames(snapshot, currentRunId, sentText), snapshot.checkpoint);
+            return;
+        }
+    }
+    finally {
+        observer.abort();
+        await iterator.return?.(undefined);
+    }
+}
+function* emissions(frames, checkpoint, observation, includeEmptyObservation = false) {
+    const values = [...frames];
+    if (values.length === 0 && observation !== undefined && includeEmptyObservation) {
+        values.push({ kind: "event", event: "observation", value: observation });
+    }
+    for (let index = 0; index < values.length; index += 1) {
+        yield {
+            frame: values[index],
+            ...(index === values.length - 1 ? { checkpoint } : {}),
+            ...(index === values.length - 1 && observation !== undefined ? { observation } : {}),
+        };
+    }
+}
+function samePoint(left, right) {
+    return (left.applicationId === right.applicationId &&
+        left.environment === right.environment &&
+        left.profile === right.profile &&
+        left.providerEpoch === right.providerEpoch &&
+        left.threadId === right.threadId &&
+        left.sequence === right.sequence);
+}
+//# sourceMappingURL=agent-protocol-stream.js.map

package/dist/agent-protocol-stream.js.map

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

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

@@ -0,0 +1,19 @@
+import type { JournalCheckpoint } from "@relkit/agents";
+import type { Context } from "hono";
+export interface ServerSentEvent {
+    readonly data: unknown;
+    readonly id?: string;
+}
+export declare function eventStream(events: (signal: AbortSignal) => AsyncIterable<ServerSentEvent>, extraHeaders?: Readonly<Record<string, string>>): Response;
+export declare function serverSentEvent(data: unknown, id?: string): ServerSentEvent;
+export declare function encodeAgentCursor(checkpoint: JournalCheckpoint): string;
+export declare function parseAgentCursor(value: string | undefined): JournalCheckpoint | undefined;
+export declare function protocolEndpoint(context: Context, action: () => Promise<Response>): Promise<Response>;
+export declare function operationId(context: Context): import("@relkit/contracts").OperationId;
+export declare function latestUserText(messages: readonly unknown[]): string | undefined;
+export declare function messageText(message: {
+    readonly parts: readonly unknown[];
+} | undefined): string | undefined;
+export declare function last<Value>(values: readonly Value[], matches: (value: Value) => boolean): NonNullable<Value> | undefined;
+export declare function isRecord(value: unknown): value is Readonly<Record<string, unknown>>;
+//# sourceMappingURL=agent-protocol-support.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-protocol-support.d.ts","sourceRoot":"","sources":["../src/agent-protocol-support.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,aAAa,CAAC,eAAe,CAAC,EAC/D,YAAY,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAClD,QAAQ,CA6BV;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,eAAe,CAE3E;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAEvE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAYzF;AAkBD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,qBAiBvF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,2CAI3C;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,GAAG,SAAS,CAM/E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAAG,SAAS,sBAGtF;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,kCAMvF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEnF"}

package/dist/agent-protocol-support.js

@@ -0,0 +1,108 @@
+import { ORPCError } from "@orpc/server";
+import { parseOperationId } from "@relkit/realtime";
+export function eventStream(events, extraHeaders = {}) {
+    const encoder = new TextEncoder();
+    const aborter = new AbortController();
+    let iterator;
+    return new Response(new ReadableStream({
+        async pull(streamController) {
+            iterator ??= events(aborter.signal)[Symbol.asyncIterator]();
+            try {
+                const next = await iterator.next();
+                if (next.done)
+                    streamController.close();
+                else
+                    streamController.enqueue(encoder.encode(encodeEvent(next.value)));
+            }
+            catch (cause) {
+                streamController.error(new Error("Agent protocol stream failed.", { cause }));
+            }
+        },
+        async cancel(reason) {
+            aborter.abort(reason);
+            await iterator?.return?.(reason);
+        },
+    }), {
+        headers: {
+            "cache-control": "no-cache, no-transform",
+            "content-type": "text/event-stream; charset=utf-8",
+            ...extraHeaders,
+        },
+    });
+}
+export function serverSentEvent(data, id) {
+    return { data, ...(id === undefined ? {} : { id }) };
+}
+export function encodeAgentCursor(checkpoint) {
+    return encodeURIComponent(JSON.stringify(checkpoint));
+}
+export function parseAgentCursor(value) {
+    if (value === undefined || value === "")
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(decodeURIComponent(value));
+    }
+    catch {
+        throw new TypeError("Last-Event-ID is not a valid agent cursor.");
+    }
+    if (!isJournalCheckpoint(parsed)) {
+        throw new TypeError("Last-Event-ID is not a valid agent cursor.");
+    }
+    return parsed;
+}
+function encodeEvent(event) {
+    const id = event.id === undefined ? "" : `id: ${event.id}\n`;
+    return `${id}data: ${JSON.stringify(event.data)}\n\n`;
+}
+function isJournalCheckpoint(value) {
+    if (!isRecord(value))
+        return false;
+    return (["applicationId", "environment", "profile", "providerEpoch", "threadId"].every((name) => typeof value[name] === "string" && value[name] !== "") &&
+        typeof value.sequence === "string" &&
+        /^(0|[1-9]\d*)$/.test(value.sequence));
+}
+export async function protocolEndpoint(context, action) {
+    try {
+        return await action();
+    }
+    catch (error) {
+        if (error instanceof ORPCError) {
+            const status = error.code === "AGENT_CAPABILITIES_UNSUPPORTED"
+                ? 426
+                : error.code === "IDENTITY_PRECONDITION_FAILED"
+                    ? 409
+                    : 403;
+            return context.json({ error: { id: error.code, message: error.message } }, status);
+        }
+        if (error instanceof TypeError)
+            return context.json({ error: { id: "INVALID_REQUEST", message: error.message } }, 422);
+        return context.json({ error: { id: "AGENT_REQUEST_FAILED" } }, 500);
+    }
+}
+export function operationId(context) {
+    const value = context.req.header("x-relkit-operation-id");
+    if (value === undefined)
+        throw new TypeError("x-relkit-operation-id is required.");
+    return parseOperationId(value, { receiptWindowMs: 30 * 86_400_000 });
+}
+export function latestUserText(messages) {
+    const message = last(messages, (item) => isRecord(item) && item.role === "user" && typeof item.content === "string");
+    return isRecord(message) && typeof message.content === "string" ? message.content : undefined;
+}
+export function messageText(message) {
+    const part = message?.parts.find((item) => isRecord(item) && item.kind === "text");
+    return isRecord(part) && typeof part.text === "string" ? part.text : undefined;
+}
+export function last(values, matches) {
+    for (let index = values.length - 1; index >= 0; index -= 1) {
+        const value = values[index];
+        if (matches(value))
+            return value;
+    }
+    return undefined;
+}
+export function isRecord(value) {
+    return value !== null && typeof value === "object";
+}
+//# sourceMappingURL=agent-protocol-support.js.map

package/dist/agent-protocol-support.js.map

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

package/dist/agent-protocol-tool.d.ts

@@ -0,0 +1,12 @@
+import type { AgentToolEvent, BrowserMessage } from "@relkit/agents";
+import type { AgentProtocolFrame } from "./agent-protocol-stream.js";
+type ToolFrame = Extract<AgentProtocolFrame, {
+    kind: "tool";
+}>;
+type ToolPart = Extract<BrowserMessage["parts"][number], {
+    kind: "tool";
+}>;
+export declare function toolEventFrame(event: AgentToolEvent, inputs: Map<string, string>): ToolFrame;
+export declare function toolFrame(part: ToolPart, inputs: Map<string, string>): ToolFrame;
+export {};
+//# sourceMappingURL=agent-protocol-tool.d.ts.map

package/dist/agent-protocol-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-protocol-tool.d.ts","sourceRoot":"","sources":["../src/agent-protocol-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAiB,MAAM,gBAAgB,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,KAAK,SAAS,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAC/D,KAAK,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CA0B5F;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAwChF"}

package/dist/agent-protocol-tool.js

@@ -0,0 +1,65 @@
+export function toolEventFrame(event, inputs) {
+    const states = {
+        "tool-started": "started",
+        "tool-input": "input-streaming",
+        "tool-input-ready": "input-ready",
+        "tool-approval-required": "approval-required",
+        "tool-executing": "running",
+        "tool-succeeded": "succeeded",
+        "tool-failed": "failed",
+        "tool-denied": "denied",
+    };
+    return toolFrame({
+        partId: event.eventId,
+        kind: "tool",
+        toolCallId: event.toolCallId,
+        toolId: event.toolId,
+        state: states[event.kind],
+        ...("input" in event
+            ? { value: event.input }
+            : "output" in event
+                ? { value: event.output }
+                : {}),
+    }, inputs);
+}
+export function toolFrame(part, inputs) {
+    const prior = inputs.get(part.toolCallId);
+    if (part.state === "started")
+        inputs.set(part.toolCallId, "");
+    const input = part.state === "input-streaming"
+        ? (part.inputText ?? (typeof part.value === "string" ? part.value : undefined))
+        : undefined;
+    if (input !== undefined)
+        inputs.set(part.toolCallId, input);
+    const encoded = part.state === "input-ready" ? JSON.stringify(part.input ?? part.value) : undefined;
+    const delta = input !== undefined
+        ? input.startsWith(prior ?? "")
+            ? input.slice(prior?.length ?? 0)
+            : input
+        : prior === undefined || prior === ""
+            ? encoded
+            : encoded?.startsWith(prior)
+                ? encoded.slice(prior.length)
+                : undefined;
+    return {
+        kind: "tool",
+        toolCallId: part.toolCallId,
+        toolId: part.toolId,
+        state: part.state,
+        ...(part.state === "input-ready"
+            ? { value: part.input ?? part.value }
+            : part.state === "succeeded"
+                ? { value: part.output ?? part.value }
+                : part.value === undefined
+                    ? {}
+                    : { value: part.value }),
+        ...((part.state === "started" ||
+            part.state === "input-streaming" ||
+            part.state === "input-ready") &&
+            prior === undefined
+            ? { inputStarted: true }
+            : {}),
+        ...(delta === undefined || delta === "" ? {} : { inputDelta: delta }),
+    };
+}
+//# sourceMappingURL=agent-protocol-tool.js.map

package/dist/agent-protocol-tool.js.map

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

package/dist/agent-protocol.d.ts

@@ -0,0 +1,4 @@
+import type { Hono } from "hono";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+export declare function installAgentProtocolEndpoints(app: Hono, options: RouteMaterializationOptions): void;
+//# sourceMappingURL=agent-protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-protocol.d.ts","sourceRoot":"","sources":["../src/agent-protocol.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAmB3E,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,2BAA2B,GACnC,IAAI,CAKN"}