veryfront 0.1.516 → 0.1.517

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.516",
+    "version": "0.1.517",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [
@@ -43,7 +43,7 @@ export default {
         "./markdown": "./src/markdown/index.ts",
         "./mdx": "./src/mdx/index.ts",
         "./agent": "./src/agent/index.ts",
-        "./agent/conversation-bootstrap": "./src/agent/conversation-bootstrap.ts",
+        "./agent/conversation-bootstrap": "./src/agent/conversation/bootstrap.ts",
         "./agent/durable": "./src/agent/durable.ts",
         "./agent/invoke-agent-child-runs": "./src/agent/invoke-agent-child-runs.ts",
         "./channels/control-plane": "./src/channels/control-plane.ts",
@@ -341,7 +341,7 @@ export default {
         "lint": "DENO_NO_PACKAGE_JSON=1 deno lint src/ cli/",
         "fmt": "deno fmt src/ cli/",
         "fmt:check": "deno fmt --check src/ cli/",
-        "typecheck": "deno task generate && deno check src/index.ts cli/main.ts src/server/index.ts src/routing/api/index.ts src/rendering/index.ts src/platform/index.ts src/platform/adapters/index.ts src/build/index.ts src/build/production-build/index.ts src/transforms/index.ts src/config/index.ts src/utils/index.ts src/data/index.ts src/security/index.ts src/middleware/index.ts src/server/handlers/dev/index.ts src/server/handlers/request/api/index.ts src/rendering/cache/index.ts src/rendering/cache/stores/index.ts src/rendering/rsc/actions/index.ts src/html/index.ts src/modules/index.ts src/proxy/main.ts src/chat/index.ts src/markdown/index.ts src/mdx/index.ts src/fs/index.ts src/oauth/index.ts src/agent/index.ts src/agent/agent-service-route-export.check.ts src/tool/index.ts src/workflow/index.ts src/prompt/index.ts src/resource/index.ts src/jobs/index.ts src/mcp/index.ts src/provider/index.ts",
+        "typecheck": "deno task generate && deno check src/index.ts cli/main.ts src/server/index.ts src/routing/api/index.ts src/rendering/index.ts src/platform/index.ts src/platform/adapters/index.ts src/build/index.ts src/build/production-build/index.ts src/transforms/index.ts src/config/index.ts src/utils/index.ts src/data/index.ts src/security/index.ts src/middleware/index.ts src/server/handlers/dev/index.ts src/server/handlers/request/api/index.ts src/rendering/cache/index.ts src/rendering/cache/stores/index.ts src/rendering/rsc/actions/index.ts src/html/index.ts src/modules/index.ts src/proxy/main.ts src/chat/index.ts src/markdown/index.ts src/mdx/index.ts src/fs/index.ts src/oauth/index.ts src/agent/index.ts src/agent/service/route-export.check.ts src/tool/index.ts src/workflow/index.ts src/prompt/index.ts src/resource/index.ts src/jobs/index.ts src/mcp/index.ts src/provider/index.ts",
         "verify": "deno task generate && deno fmt --check src/ cli/ && DENO_NO_PACKAGE_JSON=1 deno lint src/ cli/ && deno task lint:style && deno task lint:cli-boundary && deno task lint:wildcard-exports && deno task lint:barrel-jsdoc && deno task lint:ban-zod && deno task docs:validate && deno task typecheck && deno task test && deno task test:e2e:binary",
         "verify:quick": "deno task generate && deno fmt --check src/ cli/ && DENO_NO_PACKAGE_JSON=1 deno lint src/ cli/ && deno task lint:style && deno task lint:cli-boundary && deno task lint:wildcard-exports && deno task lint:barrel-jsdoc && deno task lint:ban-zod && deno task docs:validate && deno task typecheck",
         "docs": "rm -rf docs/reference && deno run --allow-read --allow-write --allow-run scripts/docs/generate-api-reference.ts",

package/esm/src/agent/ag-ui/browser-chunk-encoder.d.ts

@@ -0,0 +1,14 @@
+import type { AgUiBrowserEncodedEvent, AgUiBrowserEncoderState, AgUiBrowserRunFinishedMetadata, AgUiRuntimeStreamEvent } from "./browser-encoder.js";
+import type { AgentResponse } from "../types.js";
+export interface AgUiBrowserChunkEncoder<TChunk> {
+    state: AgUiBrowserEncoderState;
+    encode: (chunk: TChunk) => AgUiBrowserEncodedEvent[];
+    finalize: (response: AgentResponse | null) => AgUiBrowserEncodedEvent[];
+}
+export interface CreateAgUiBrowserChunkEncoderOptions<TChunk> {
+    getRuntimeEvents: (chunk: TChunk) => readonly AgUiRuntimeStreamEvent[];
+    getMetadataFromChunk?: (chunk: TChunk) => Partial<AgUiBrowserRunFinishedMetadata> | null | undefined;
+    initialMetadata?: Partial<AgUiBrowserRunFinishedMetadata>;
+}
+export declare function createAgUiBrowserChunkEncoder<TChunk>(options: CreateAgUiBrowserChunkEncoderOptions<TChunk>): AgUiBrowserChunkEncoder<TChunk>;
+//# sourceMappingURL=browser-chunk-encoder.d.ts.map

package/esm/src/agent/ag-ui/browser-chunk-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-chunk-encoder.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/browser-chunk-encoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,8BAA8B,EAC9B,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,uBAAuB,CAAC,MAAM;IAC7C,KAAK,EAAE,uBAAuB,CAAC;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,uBAAuB,EAAE,CAAC;IACrD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,KAAK,uBAAuB,EAAE,CAAC;CACzE;AAED,MAAM,WAAW,oCAAoC,CAAC,MAAM;IAC1D,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,sBAAsB,EAAE,CAAC;IACvE,oBAAoB,CAAC,EAAE,CACrB,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,8BAA8B,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,CAAC;CAC3D;AAkBD,wBAAgB,6BAA6B,CAAC,MAAM,EAClD,OAAO,EAAE,oCAAoC,CAAC,MAAM,CAAC,GACpD,uBAAuB,CAAC,MAAM,CAAC,CAajC"}

package/esm/src/agent/ag-ui/browser-chunk-encoder.js

@@ -0,0 +1,31 @@
+import { createAgUiRuntimeEventEncoder, } from "./runtime-event-encoder.js";
+function mergeMetadata(target, metadata) {
+    if (!metadata) {
+        return;
+    }
+    if (typeof metadata.provider === "string")
+        target.provider = metadata.provider;
+    if (typeof metadata.model === "string")
+        target.model = metadata.model;
+    if (typeof metadata.inputTokens === "number")
+        target.inputTokens = metadata.inputTokens;
+    if (typeof metadata.outputTokens === "number")
+        target.outputTokens = metadata.outputTokens;
+    if (typeof metadata.totalTokens === "number")
+        target.totalTokens = metadata.totalTokens;
+    if (typeof metadata.finishReason === "string")
+        target.finishReason = metadata.finishReason;
+}
+export function createAgUiBrowserChunkEncoder(options) {
+    const runtimeEventEncoder = createAgUiRuntimeEventEncoder({
+        initialMetadata: options.initialMetadata,
+    });
+    return {
+        state: runtimeEventEncoder.state,
+        encode: (chunk) => {
+            mergeMetadata(runtimeEventEncoder.state.metadata, options.getMetadataFromChunk?.(chunk));
+            return options.getRuntimeEvents(chunk).flatMap((event) => runtimeEventEncoder.encode(event));
+        },
+        finalize: (response) => runtimeEventEncoder.finalize(response),
+    };
+}

package/esm/src/agent/ag-ui/browser-encoder.d.ts

@@ -0,0 +1,32 @@
+import type { AgentResponse } from "../types.js";
+export type AgUiRuntimeStreamEvent = Record<string, unknown> & {
+    type: string;
+};
+export interface AgUiBrowserRunFinishedMetadata {
+    provider?: string;
+    model?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    finishReason?: string;
+}
+export interface AgUiBrowserEncoderState {
+    messageId: string | null;
+    textOpen: boolean;
+    reasoningMessageId: string | null;
+    activeStepName: string | null;
+    stepCount: number;
+    streamedToolInputIds: Set<string>;
+    sawVisibleOutput: boolean;
+    sawTerminalError: boolean;
+    metadata: AgUiBrowserRunFinishedMetadata;
+}
+export interface AgUiBrowserEncodedEvent {
+    event: string;
+    payload: Record<string, unknown>;
+}
+export declare function createAgUiBrowserEncoderState(): AgUiBrowserEncoderState;
+export declare function buildAgUiBrowserFinalizeResponse(metadata: AgUiBrowserRunFinishedMetadata): AgentResponse | null;
+export declare function mapRuntimeStreamEventToAgUiBrowserEvents(state: AgUiBrowserEncoderState, event: AgUiRuntimeStreamEvent): AgUiBrowserEncodedEvent[];
+export declare function finalizeAgUiBrowserEvents(state: AgUiBrowserEncoderState, response: AgentResponse | null): AgUiBrowserEncodedEvent[];
+//# sourceMappingURL=browser-encoder.d.ts.map

package/esm/src/agent/ag-ui/browser-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-encoder.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/browser-encoder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,8BAA8B,CAAC;CAC1C;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,wBAAgB,6BAA6B,IAAI,uBAAuB,CAYvE;AA6FD,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,8BAA8B,GACvC,aAAa,GAAG,IAAI,CA6BtB;AA4HD,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,uBAAuB,EAC9B,KAAK,EAAE,sBAAsB,GAC5B,uBAAuB,EAAE,CAgN3B;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,EAAE,aAAa,GAAG,IAAI,GAC7B,uBAAuB,EAAE,CA8B3B"}

package/esm/src/agent/ag-ui/browser-encoder.js

@@ -0,0 +1,405 @@
+import * as dntShim from "../../../_dnt.shims.js";
+export function createAgUiBrowserEncoderState() {
+    return {
+        messageId: null,
+        textOpen: false,
+        reasoningMessageId: null,
+        activeStepName: null,
+        stepCount: 0,
+        streamedToolInputIds: new Set(),
+        sawVisibleOutput: false,
+        sawTerminalError: false,
+        metadata: {},
+    };
+}
+function serializeToolInput(input) {
+    try {
+        return JSON.stringify(input ?? {});
+    }
+    catch {
+        return "{}";
+    }
+}
+function getMessageId(state, event) {
+    if (typeof event.messageId === "string") {
+        state.messageId = event.messageId;
+        return event.messageId;
+    }
+    if (!state.messageId && typeof event.id === "string") {
+        state.messageId = event.id;
+    }
+    if (!state.messageId) {
+        state.messageId = dntShim.crypto.randomUUID();
+    }
+    return state.messageId;
+}
+function getReasoningMessageId(state, event) {
+    if (typeof event.id === "string" && event.id.length > 0) {
+        state.reasoningMessageId = state.messageId
+            ? `${state.messageId}:reasoning:${event.id}`
+            : event.id;
+        return state.reasoningMessageId;
+    }
+    if (!state.reasoningMessageId) {
+        state.reasoningMessageId = state.messageId
+            ? `${state.messageId}:reasoning:${dntShim.crypto.randomUUID()}`
+            : dntShim.crypto.randomUUID();
+    }
+    return state.reasoningMessageId;
+}
+function nextStepName(state) {
+    state.stepCount += 1;
+    state.activeStepName = `step-${state.stepCount}`;
+    return state.activeStepName;
+}
+function finishStepName(state) {
+    const stepName = state.activeStepName ?? `step-${Math.max(state.stepCount, 1)}`;
+    state.activeStepName = null;
+    return stepName;
+}
+function applyDataMetadata(state, event) {
+    const data = event.data && typeof event.data === "object" && !Array.isArray(event.data)
+        ? event.data
+        : event;
+    if (typeof data.model === "string") {
+        state.metadata.model = data.model;
+        const provider = data.model.split("/")[0];
+        if (provider) {
+            state.metadata.provider = provider;
+        }
+    }
+}
+function applyResponseMetadata(state, response) {
+    if (!response)
+        return;
+    if (response.usage) {
+        state.metadata.inputTokens = response.usage.promptTokens;
+        state.metadata.outputTokens = response.usage.completionTokens;
+        state.metadata.totalTokens = response.usage.totalTokens;
+    }
+    const finishReason = response.metadata && typeof response.metadata === "object"
+        ? response.metadata.finishReason
+        : undefined;
+    if (typeof finishReason === "string") {
+        state.metadata.finishReason = finishReason;
+    }
+}
+export function buildAgUiBrowserFinalizeResponse(metadata) {
+    const responseMetadata = {};
+    if (typeof metadata.finishReason === "string" && metadata.finishReason.length > 0) {
+        responseMetadata.finishReason = metadata.finishReason;
+    }
+    const usage = typeof metadata.inputTokens === "number" ||
+        typeof metadata.outputTokens === "number" ||
+        typeof metadata.totalTokens === "number"
+        ? {
+            promptTokens: metadata.inputTokens ?? 0,
+            completionTokens: metadata.outputTokens ?? 0,
+            totalTokens: metadata.totalTokens ??
+                ((metadata.inputTokens ?? 0) + (metadata.outputTokens ?? 0)),
+        }
+        : undefined;
+    if (!usage && Object.keys(responseMetadata).length === 0) {
+        return null;
+    }
+    return {
+        text: "",
+        messages: [],
+        toolCalls: [],
+        status: "completed",
+        ...(usage ? { usage } : {}),
+        ...(Object.keys(responseMetadata).length > 0 ? { metadata: responseMetadata } : {}),
+    };
+}
+function completeToolInput(state, event) {
+    const toolCallId = typeof event.toolCallId === "string" ? event.toolCallId : "";
+    const events = [];
+    if (toolCallId.length > 0 && !state.streamedToolInputIds.has(toolCallId)) {
+        events.push({
+            event: "ToolCallArgs",
+            payload: {
+                toolCallId,
+                delta: serializeToolInput("input" in event ? event.input : {}),
+            },
+        });
+    }
+    if (toolCallId.length > 0) {
+        state.streamedToolInputIds.delete(toolCallId);
+    }
+    events.push({
+        event: "ToolCallEnd",
+        payload: { toolCallId: event.toolCallId },
+    });
+    return events;
+}
+function createToolResultEvent(toolCallId, result, isError = false) {
+    return {
+        event: "ToolCallResult",
+        payload: {
+            toolCallId,
+            result,
+            ...(isError ? { isError: true } : {}),
+        },
+    };
+}
+function createCustomDataEvent(name, value) {
+    return {
+        event: "Custom",
+        payload: { name, value },
+    };
+}
+function createStepEvent(state, type) {
+    return {
+        event: type,
+        payload: {
+            stepName: type === "StepStarted" ? nextStepName(state) : finishStepName(state),
+        },
+    };
+}
+function createReasoningEvent(state, event, type) {
+    const messageId = getReasoningMessageId(state, event);
+    return {
+        event: type,
+        payload: type === "ReasoningMessageStart"
+            ? { messageId, role: "reasoning" }
+            : type === "ReasoningMessageContent"
+                ? {
+                    messageId,
+                    delta: typeof event.delta === "string" ? event.delta : "",
+                }
+                : { messageId },
+    };
+}
+function createTextEvent(messageId, type, delta = "") {
+    return {
+        event: type,
+        payload: type === "TextMessageStart"
+            ? { messageId, role: "assistant" }
+            : type === "TextMessageContent"
+                ? { messageId, delta }
+                : { messageId },
+    };
+}
+function closeOpenTextEvent(state) {
+    if (!state.textOpen) {
+        return [];
+    }
+    state.textOpen = false;
+    return [createTextEvent(getMessageId(state, { type: "text-end" }), "TextMessageEnd")];
+}
+function closeOpenReasoningEvent(state) {
+    if (state.reasoningMessageId === null) {
+        return [];
+    }
+    const messageId = state.reasoningMessageId;
+    state.reasoningMessageId = null;
+    return [{
+            event: "ReasoningMessageEnd",
+            payload: { messageId },
+        }];
+}
+export function mapRuntimeStreamEventToAgUiBrowserEvents(state, event) {
+    if (event.type.startsWith("data-")) {
+        const name = event.type.slice("data-".length);
+        if (name.length === 0) {
+            return [];
+        }
+        state.sawVisibleOutput = true;
+        return [createCustomDataEvent(name, "data" in event ? event.data : null)];
+    }
+    switch (event.type) {
+        case "message-start":
+            getMessageId(state, event);
+            return [];
+        case "text-start": {
+            const events = closeOpenReasoningEvent(state);
+            if (state.textOpen)
+                return [];
+            const messageId = getMessageId(state, event);
+            state.textOpen = true;
+            state.sawVisibleOutput = true;
+            events.push(createTextEvent(messageId, "TextMessageStart"));
+            return events;
+        }
+        case "text-delta": {
+            const events = closeOpenReasoningEvent(state);
+            const messageId = getMessageId(state, event);
+            state.sawVisibleOutput = true;
+            if (!state.textOpen) {
+                state.textOpen = true;
+                events.push(createTextEvent(messageId, "TextMessageStart"), createTextEvent(messageId, "TextMessageContent", typeof event.delta === "string" ? event.delta : ""));
+                return events;
+            }
+            events.push(createTextEvent(messageId, "TextMessageContent", typeof event.delta === "string" ? event.delta : ""));
+            return events;
+        }
+        case "text-end": {
+            if (!state.textOpen)
+                return [];
+            state.textOpen = false;
+            return [createTextEvent(getMessageId(state, event), "TextMessageEnd")];
+        }
+        case "reasoning-start": {
+            const events = closeOpenTextEvent(state);
+            events.push(...closeOpenReasoningEvent(state));
+            state.sawVisibleOutput = true;
+            events.push(createReasoningEvent(state, event, "ReasoningMessageStart"));
+            return events;
+        }
+        case "reasoning-delta": {
+            const events = closeOpenTextEvent(state);
+            state.sawVisibleOutput = true;
+            if (state.reasoningMessageId === null) {
+                events.push(createReasoningEvent(state, event, "ReasoningMessageStart"));
+            }
+            events.push(createReasoningEvent(state, event, "ReasoningMessageContent"));
+            return events;
+        }
+        case "reasoning-end": {
+            const reasoningEvent = createReasoningEvent(state, event, "ReasoningMessageEnd");
+            state.reasoningMessageId = null;
+            return [reasoningEvent];
+        }
+        case "tool-input-start": {
+            const events = [
+                ...closeOpenTextEvent(state),
+                ...closeOpenReasoningEvent(state),
+            ];
+            state.sawVisibleOutput = true;
+            events.push({
+                event: "ToolCallStart",
+                payload: {
+                    toolCallId: event.toolCallId,
+                    toolCallName: event.toolName,
+                },
+            });
+            return events;
+        }
+        case "tool-input-delta":
+            state.sawVisibleOutput = true;
+            if (typeof event.toolCallId === "string") {
+                state.streamedToolInputIds.add(event.toolCallId);
+            }
+            return [
+                ...closeOpenTextEvent(state),
+                ...closeOpenReasoningEvent(state),
+                {
+                    event: "ToolCallArgs",
+                    payload: {
+                        toolCallId: event.toolCallId,
+                        delta: typeof event.inputTextDelta === "string" ? event.inputTextDelta : "",
+                    },
+                },
+            ];
+        case "tool-input-available": {
+            state.sawVisibleOutput = true;
+            return [
+                ...closeOpenTextEvent(state),
+                ...closeOpenReasoningEvent(state),
+                ...completeToolInput(state, event),
+            ];
+        }
+        case "tool-input-error": {
+            state.sawVisibleOutput = true;
+            const events = [
+                ...closeOpenTextEvent(state),
+                ...closeOpenReasoningEvent(state),
+                ...completeToolInput(state, event),
+            ];
+            events.push({
+                event: "ToolCallResult",
+                payload: {
+                    toolCallId: event.toolCallId,
+                    result: {
+                        error: typeof event.errorText === "string" ? event.errorText : "Tool input failed",
+                    },
+                    isError: true,
+                },
+            });
+            return events;
+        }
+        case "tool-output-available":
+            state.sawVisibleOutput = true;
+            return [
+                ...closeOpenTextEvent(state),
+                ...closeOpenReasoningEvent(state),
+                createToolResultEvent(event.toolCallId, event.output),
+            ];
+        case "tool-output-error":
+            state.sawVisibleOutput = true;
+            return [
+                ...closeOpenTextEvent(state),
+                ...closeOpenReasoningEvent(state),
+                createToolResultEvent(event.toolCallId, { error: event.errorText }, true),
+            ];
+        case "tool-output-denied":
+            state.sawVisibleOutput = true;
+            return [
+                ...closeOpenTextEvent(state),
+                ...closeOpenReasoningEvent(state),
+                createToolResultEvent(event.toolCallId, { error: "Tool output denied" }, true),
+            ];
+        case "step-start":
+        case "start-step":
+            state.sawVisibleOutput = true;
+            return [
+                ...closeOpenTextEvent(state),
+                ...closeOpenReasoningEvent(state),
+                createStepEvent(state, "StepStarted"),
+            ];
+        case "step-end":
+        case "finish-step":
+            state.sawVisibleOutput = true;
+            return [
+                ...closeOpenTextEvent(state),
+                ...closeOpenReasoningEvent(state),
+                createStepEvent(state, "StepFinished"),
+            ];
+        case "data":
+            applyDataMetadata(state, event);
+            return [];
+        case "error":
+            state.sawTerminalError = true;
+            return [
+                ...closeOpenTextEvent(state),
+                ...closeOpenReasoningEvent(state),
+                {
+                    event: "RunError",
+                    payload: {
+                        message: typeof event.error === "string" ? event.error : "Agent run failed",
+                    },
+                },
+            ];
+        default:
+            if (typeof event.type === "string" && event.type.startsWith("data-")) {
+                return [createCustomDataEvent(event.type.slice(5), event.data)];
+            }
+            return [];
+    }
+}
+export function finalizeAgUiBrowserEvents(state, response) {
+    applyResponseMetadata(state, response);
+    if (state.sawTerminalError) {
+        return [];
+    }
+    if (!state.sawVisibleOutput) {
+        state.sawTerminalError = true;
+        return [{
+                event: "RunError",
+                payload: {
+                    code: "EMPTY_ASSISTANT_OUTPUT",
+                    message: "Agent run produced no assistant-visible output",
+                },
+            }];
+    }
+    const events = [];
+    events.push(...closeOpenTextEvent(state));
+    events.push(...closeOpenReasoningEvent(state));
+    events.push({
+        event: "RunFinished",
+        payload: {
+            metadata: state.metadata,
+        },
+    });
+    return events;
+}

package/esm/src/agent/ag-ui/browser-finalize-tracker.d.ts

@@ -0,0 +1,12 @@
+import { type AgUiBrowserEncodedEvent, type AgUiBrowserRunFinishedMetadata } from "./browser-encoder.js";
+import type { AgentResponse } from "../types.js";
+export interface AgUiBrowserFinalizeTracker<TChunk> {
+    observeChunk: (chunk: TChunk) => void;
+    observeEncodedEvents: (events: readonly AgUiBrowserEncodedEvent[]) => void;
+    getFinalResponse: () => AgentResponse | null;
+}
+export interface CreateAgUiBrowserFinalizeTrackerOptions<TChunk> {
+    getMetadataFromChunk: (chunk: TChunk) => Partial<AgUiBrowserRunFinishedMetadata> | null | undefined;
+}
+export declare function createAgUiBrowserFinalizeTracker<TChunk>(options: CreateAgUiBrowserFinalizeTrackerOptions<TChunk>): AgUiBrowserFinalizeTracker<TChunk>;
+//# sourceMappingURL=browser-finalize-tracker.d.ts.map

package/esm/src/agent/ag-ui/browser-finalize-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-finalize-tracker.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/browser-finalize-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EAEpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,0BAA0B,CAAC,MAAM;IAChD,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,oBAAoB,EAAE,CAAC,MAAM,EAAE,SAAS,uBAAuB,EAAE,KAAK,IAAI,CAAC;IAC3E,gBAAgB,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,uCAAuC,CAAC,MAAM;IAC7D,oBAAoB,EAAE,CACpB,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,8BAA8B,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CACjE;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EACrD,OAAO,EAAE,uCAAuC,CAAC,MAAM,CAAC,GACvD,0BAA0B,CAAC,MAAM,CAAC,CA2CpC"}

package/esm/src/agent/ag-ui/browser-finalize-tracker.js

@@ -0,0 +1,42 @@
+import { buildAgUiBrowserFinalizeResponse, } from "./browser-encoder.js";
+export function createAgUiBrowserFinalizeTracker(options) {
+    let sawRunError = false;
+    const metadata = {};
+    return {
+        observeChunk: (chunk) => {
+            const nextMetadata = options.getMetadataFromChunk(chunk);
+            if (!nextMetadata) {
+                return;
+            }
+            if (typeof nextMetadata.provider === "string") {
+                metadata.provider = nextMetadata.provider;
+            }
+            if (typeof nextMetadata.model === "string") {
+                metadata.model = nextMetadata.model;
+            }
+            if (typeof nextMetadata.inputTokens === "number") {
+                metadata.inputTokens = nextMetadata.inputTokens;
+            }
+            if (typeof nextMetadata.outputTokens === "number") {
+                metadata.outputTokens = nextMetadata.outputTokens;
+            }
+            if (typeof nextMetadata.totalTokens === "number") {
+                metadata.totalTokens = nextMetadata.totalTokens;
+            }
+            if (typeof nextMetadata.finishReason === "string") {
+                metadata.finishReason = nextMetadata.finishReason;
+            }
+        },
+        observeEncodedEvents: (events) => {
+            if (events.some((event) => event.event === "RunError")) {
+                sawRunError = true;
+            }
+        },
+        getFinalResponse: () => {
+            if (sawRunError) {
+                return null;
+            }
+            return buildAgUiBrowserFinalizeResponse(metadata);
+        },
+    };
+}

package/esm/src/agent/ag-ui/browser-response-stream.d.ts

@@ -0,0 +1,28 @@
+import type { AgentResponse } from "../types.js";
+import type { AgUiSseEvent } from "./host-support.js";
+export interface AgUiBrowserResponseRequestState {
+    runId?: string;
+    threadId?: string;
+    state?: unknown;
+    messages: unknown[];
+}
+export interface AgUiBrowserResponseExecution<TChunk> {
+    agentUIStream: AsyncIterable<TChunk>;
+    fail: (error: unknown) => Promise<void>;
+    waitForFinish: () => Promise<void>;
+}
+export interface AgUiBrowserResponseEncoder<TChunk> {
+    encode: (chunk: TChunk) => AgUiSseEvent[];
+    finalize: (response: AgentResponse | null) => AgUiSseEvent[];
+}
+export interface CreateAgUiBrowserResponseStreamInput<TChunk, TState> {
+    agUiInput: AgUiBrowserResponseRequestState;
+    agentId: string;
+    execution: AgUiBrowserResponseExecution<TChunk>;
+    encoder: AgUiBrowserResponseEncoder<TChunk>;
+    initialState: TState;
+    onChunk?: (state: TState, chunk: TChunk) => void;
+    getFinalResponse?: (state: TState) => AgentResponse | null;
+}
+export declare function createAgUiBrowserResponseStream<TChunk, TState>(input: CreateAgUiBrowserResponseStreamInput<TChunk, TState>): ReadableStream<Uint8Array>;
+//# sourceMappingURL=browser-response-stream.d.ts.map

package/esm/src/agent/ag-ui/browser-response-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-response-stream.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/browser-response-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkBtD,MAAM,WAAW,+BAA+B;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B,CAAC,MAAM;IAClD,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B,CAAC,MAAM;IAChD,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,YAAY,EAAE,CAAC;IAC1C,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,KAAK,YAAY,EAAE,CAAC;CAC9D;AAED,MAAM,WAAW,oCAAoC,CAAC,MAAM,EAAE,MAAM;IAClE,SAAS,EAAE,+BAA+B,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,CAAC;CAC5D;AAUD,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAC5D,KAAK,EAAE,oCAAoC,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1D,cAAc,CAAC,UAAU,CAAC,CAqH5B"}

package/esm/src/agent/ag-ui/chat-ui-chunk-browser-encoder.d.ts

@@ -0,0 +1,20 @@
+import type { ChatMessageMetadata, ChatUiMessageChunk } from "../../chat/protocol.js";
+import type { AgUiBrowserChunkEncoder } from "./browser-chunk-encoder.js";
+import { type AgUiBrowserRunFinishedMetadata, type AgUiRuntimeStreamEvent } from "./browser-encoder.js";
+import { type CreateAgUiTrackedBrowserResponseInput } from "./tracked-browser-response.js";
+export type AgUiChatUiChunkBrowserEncoder = Pick<AgUiBrowserChunkEncoder<ChatUiMessageChunk<ChatMessageMetadata>>, "encode" | "finalize">;
+export interface CreateAgUiChatUiChunkBrowserEncoderOptions {
+    modelId?: string;
+    resolveProvider?: (modelId: string) => string | undefined;
+}
+export interface CreateAgUiChatUiTrackedBrowserResponseInput extends Omit<CreateAgUiTrackedBrowserResponseInput<ChatUiMessageChunk<ChatMessageMetadata>>, "chunkEncoder" | "finalizeTracker"> {
+    modelId: string;
+    resolveProvider?: CreateAgUiChatUiChunkBrowserEncoderOptions["resolveProvider"];
+}
+export declare function getAgUiChatUiMessageMetadataFromChunk(chunk: ChatUiMessageChunk<ChatMessageMetadata>): ChatMessageMetadata | undefined;
+export declare function getAgUiChatUiMessageUsageMetadata(messageMetadata: ChatMessageMetadata | undefined): Pick<AgUiBrowserRunFinishedMetadata, "inputTokens" | "outputTokens" | "totalTokens">;
+export declare function getAgUiChatUiMessageChunkMetadata(chunk: ChatUiMessageChunk<ChatMessageMetadata>, options?: Pick<CreateAgUiChatUiChunkBrowserEncoderOptions, "resolveProvider">): Partial<AgUiBrowserRunFinishedMetadata> | null;
+export declare function normalizeChatUiMessageChunkToAgUiRuntimeEvent(chunk: ChatUiMessageChunk<ChatMessageMetadata>): AgUiRuntimeStreamEvent;
+export declare function createAgUiChatUiChunkBrowserEncoder(options?: CreateAgUiChatUiChunkBrowserEncoderOptions): AgUiChatUiChunkBrowserEncoder;
+export declare function createAgUiChatUiTrackedBrowserResponse(input: CreateAgUiChatUiTrackedBrowserResponseInput): Response;
+//# sourceMappingURL=chat-ui-chunk-browser-encoder.d.ts.map

package/esm/src/agent/ag-ui/chat-ui-chunk-browser-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-ui-chunk-browser-encoder.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/chat-ui-chunk-browser-encoder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,qCAAqC,EAC3C,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,uBAAuB,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,EAChE,QAAQ,GAAG,UAAU,CACtB,CAAC;AAEF,MAAM,WAAW,0CAA0C;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC3D;AAED,MAAM,WAAW,2CAA4C,SAC3D,IAAI,CACF,qCAAqC,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,EAC9E,cAAc,GAAG,iBAAiB,CACnC;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,0CAA0C,CAAC,iBAAiB,CAAC,CAAC;CACjF;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,GAC7C,mBAAmB,GAAG,SAAS,CAUjC;AAED,wBAAgB,iCAAiC,CAC/C,eAAe,EAAE,mBAAmB,GAAG,SAAS,GAC/C,IAAI,CAAC,8BAA8B,EAAE,aAAa,GAAG,cAAc,GAAG,aAAa,CAAC,CAWtF;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,EAC9C,OAAO,GAAE,IAAI,CAAC,0CAA0C,EAAE,iBAAiB,CAAM,GAChF,OAAO,CAAC,8BAA8B,CAAC,GAAG,IAAI,CAgChD;AAED,wBAAgB,6CAA6C,CAC3D,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,GAC7C,sBAAsB,CA+BxB;AAED,wBAAgB,mCAAmC,CACjD,OAAO,GAAE,0CAA+C,GACvD,6BAA6B,CAa/B;AAED,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,2CAA2C,GACjD,QAAQ,CAkBV"}