veryfront 0.1.292 → 0.1.294

package/esm/deno.d.ts

@@ -48,6 +48,7 @@ declare namespace _default {
         "./chat/message-prep": string;
         "./chat/final-step-fallback": string;
         "./chat/provider-errors": string;
+        "./chat/stream-watchdog": string;
     };
     let imports: {
         "veryfront/head": string;

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.292",
+    "version": "0.1.294",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [
@@ -67,7 +67,8 @@ export default {
         "./chat/conversation": "./src/chat/conversation.ts",
         "./chat/message-prep": "./src/chat/message-prep.ts",
         "./chat/final-step-fallback": "./src/chat/final-step-fallback.ts",
-        "./chat/provider-errors": "./src/chat/provider-errors.ts"
+        "./chat/provider-errors": "./src/chat/provider-errors.ts",
+        "./chat/stream-watchdog": "./src/chat/stream-watchdog.ts"
     },
     "imports": {
         "veryfront/head": "./src/react/runtime/core.ts",

package/esm/src/chat/conversation.d.ts

@@ -226,6 +226,10 @@ export declare function pushToolParts(parts: MessagePart[], toolName: string, to
     output?: unknown;
     errorText?: unknown;
 }): void;
+export declare function toConversationPartsFromUiMessage(message: ChatUiMessage): MessagePart[];
+export declare function hasIncompleteToolParts(message: ChatUiMessage): boolean;
+export declare function markIncompleteToolPartsAsStopped(message: ChatUiMessage): ChatUiMessage;
+export declare function markIncompleteToolPartsAsErrored(message: ChatUiMessage, errorText: string): ChatUiMessage;
 export declare function isToolCallPart(value: unknown): value is ToolCallLike;
 export declare function isToolResultPart(value: unknown): value is ToolResultLike;
 export declare function isTextPart(value: unknown): value is TextPartLike;

package/esm/src/chat/conversation.d.ts.map

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

package/esm/src/chat/conversation.js

@@ -214,6 +214,129 @@ export function pushToolParts(parts, toolName, toolCallId, state, part) {
         state: mapToolState(state),
     });
 }
+function pushFileConversationPart(parts, part) {
+    const uploadId = part.uploadId ?? extractUploadId(part.url);
+    if (!uploadId)
+        return;
+    if (part.mediaType.startsWith("image/")) {
+        parts.push({
+            type: "image",
+            upload_id: uploadId,
+            media_type: part.mediaType,
+            ...(part.url ? { url: part.url } : {}),
+        });
+        return;
+    }
+    parts.push({
+        type: "file",
+        upload_id: uploadId,
+        media_type: part.mediaType,
+        ...(part.url ? { url: part.url } : {}),
+    });
+}
+export function toConversationPartsFromUiMessage(message) {
+    const parts = [];
+    for (const part of message.parts) {
+        if (part.type === "text") {
+            parts.push({ type: "text", text: part.text });
+            continue;
+        }
+        if (part.type === "reasoning") {
+            parts.push({ type: "reasoning", text: part.text });
+            continue;
+        }
+        if (part.type === "step-start") {
+            continue;
+        }
+        if (part.type === "source-url") {
+            parts.push({
+                type: "citation",
+                source_id: part.sourceId,
+                title: part.title,
+                url: part.url,
+            });
+            continue;
+        }
+        if (part.type === "source-document") {
+            parts.push({
+                type: "citation",
+                source_id: part.sourceId,
+                title: part.title,
+            });
+            continue;
+        }
+        if (part.type === "file") {
+            pushFileConversationPart(parts, part);
+            continue;
+        }
+        if (isDataUiPart(part)) {
+            const name = part.type.replace(/^data-/, "");
+            if (name.length > 0) {
+                parts.push({
+                    type: "data",
+                    name,
+                    value: part.data,
+                });
+            }
+            continue;
+        }
+        if (isToolUiPart(part)) {
+            const toolName = getUiToolName(part);
+            if (!toolName) {
+                continue;
+            }
+            pushToolParts(parts, toolName, part.toolCallId, part.state, part);
+        }
+    }
+    return parts.filter((part) => messagePartSchema.safeParse(part).success);
+}
+function isToolComplete(part) {
+    return part.state === "output-available" || part.state === "output-error" ||
+        part.state === "output-denied";
+}
+export function hasIncompleteToolParts(message) {
+    return message.parts.some((part) => isToolUiPart(part) && !isToolComplete(part));
+}
+export function markIncompleteToolPartsAsStopped(message) {
+    return markIncompleteToolPartsAsErrored(message, "Stopped by user");
+}
+export function markIncompleteToolPartsAsErrored(message, errorText) {
+    let mutated = false;
+    const parts = message.parts.map((part) => {
+        if (!isToolUiPart(part) || isToolComplete(part)) {
+            return part;
+        }
+        mutated = true;
+        return markToolPartAsErrored(part, errorText);
+    });
+    return mutated ? { ...message, parts } : message;
+}
+function markToolPartAsErrored(part, errorText) {
+    if (part.type === "dynamic-tool") {
+        return {
+            type: "dynamic-tool",
+            toolName: part.toolName,
+            toolCallId: part.toolCallId,
+            ...(part.title ? { title: part.title } : {}),
+            ...(part.providerExecuted !== undefined ? { providerExecuted: part.providerExecuted } : {}),
+            ...(part.callProviderMetadata ? { callProviderMetadata: part.callProviderMetadata } : {}),
+            input: part.input,
+            state: "output-error",
+            errorText,
+        };
+    }
+    return {
+        type: part.type,
+        toolCallId: part.toolCallId,
+        ...(part.toolName ? { toolName: part.toolName } : {}),
+        ...(part.title ? { title: part.title } : {}),
+        ...(part.providerExecuted !== undefined ? { providerExecuted: part.providerExecuted } : {}),
+        ...(part.callProviderMetadata ? { callProviderMetadata: part.callProviderMetadata } : {}),
+        input: part.input,
+        state: "output-error",
+        errorText,
+    };
+}
 export function isToolCallPart(value) {
     return (isRecord(value) &&
         value.type === "tool-call" &&

package/esm/src/chat/index.d.ts

@@ -63,4 +63,5 @@ export { type HostedStreamPartForUiChunkMapping, type HostedUiChunkMappingOption
 export { useCompletion, type UseCompletionOptions, type UseCompletionResult, } from "../agent/react/use-completion.js";
 export { useStreaming, type UseStreamingOptions, type UseStreamingResult, } from "../agent/react/use-streaming.js";
 export { useVoiceInput, type UseVoiceInputOptions, type UseVoiceInputResult, } from "../agent/react/use-voice-input.js";
+export { ChatStreamIdleTimeoutError, type ChatStreamWatchdogOptions, type ChatStreamWatchdogPhase, type ChatStreamWatchdogState, createChatStreamWatchdog, createChatStreamWatchdogState, DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS, DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS, getNextChatStreamWatchdogState, isHeartbeatOnlyMetadataChunk, isLongRunningToolRunning, } from "./stream-watchdog.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/chat/index.d.ts.map

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

package/esm/src/chat/index.js

@@ -61,3 +61,4 @@ export { mapHostedStreamPartToChatUiChunks, } from "./hosted-ui-chunk-mapping.js
 export { useCompletion, } from "../agent/react/use-completion.js";
 export { useStreaming, } from "../agent/react/use-streaming.js";
 export { useVoiceInput, } from "../agent/react/use-voice-input.js";
+export { ChatStreamIdleTimeoutError, createChatStreamWatchdog, createChatStreamWatchdogState, DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS, DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS, getNextChatStreamWatchdogState, isHeartbeatOnlyMetadataChunk, isLongRunningToolRunning, } from "./stream-watchdog.js";

package/esm/src/chat/stream-watchdog.d.ts

@@ -0,0 +1,34 @@
+import "../../_dnt.polyfills.js";
+import type { ChatUiMessageChunk, MessageMetadata } from "./types.js";
+export declare const DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS = 120000;
+export declare const DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS = 300000;
+export type ChatStreamWatchdogPhase = "response_pending" | "tool_input_streaming" | "tool_running" | "post_tool_idle";
+export type ChatStreamWatchdogState = {
+    phase: ChatStreamWatchdogPhase;
+    timeoutMs: number;
+    toolCallId?: string;
+    toolName?: string;
+};
+export type ChatStreamWatchdogOptions = {
+    idleTimeoutMs?: number;
+    toolRunningTimeoutMs?: number;
+    longRunningToolNames?: Iterable<string>;
+};
+export declare class ChatStreamIdleTimeoutError extends Error {
+    readonly state: ChatStreamWatchdogState;
+    constructor(state: ChatStreamWatchdogState);
+}
+export declare function createChatStreamWatchdogState(phase: ChatStreamWatchdogPhase, metadata?: {
+    toolCallId?: string;
+    toolName?: string;
+}, options?: Pick<Required<ChatStreamWatchdogOptions>, "idleTimeoutMs" | "toolRunningTimeoutMs">): ChatStreamWatchdogState;
+export declare function isLongRunningToolRunning(current: ChatStreamWatchdogState, longRunningToolNames: ReadonlySet<string>): boolean;
+export declare function getNextChatStreamWatchdogState(currentState: ChatStreamWatchdogState, chunk: ChatUiMessageChunk<MessageMetadata>, options?: ChatStreamWatchdogOptions): ChatStreamWatchdogState;
+export declare function isHeartbeatOnlyMetadataChunk(chunk: ChatUiMessageChunk<MessageMetadata>): boolean;
+export declare function createChatStreamWatchdog(options?: ChatStreamWatchdogOptions): {
+    signal: AbortSignal;
+    readonly lastTimeoutState: ChatStreamWatchdogState | null;
+    observe(chunk: ChatUiMessageChunk<MessageMetadata>): void;
+    dispose(): void;
+};
+//# sourceMappingURL=stream-watchdog.d.ts.map

package/esm/src/chat/stream-watchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-watchdog.d.ts","sourceRoot":"","sources":["../../../src/src/chat/stream-watchdog.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtE,eAAO,MAAM,mCAAmC,SAAU,CAAC;AAC3D,eAAO,MAAM,2CAA2C,SAAU,CAAC;AAEnE,MAAM,MAAM,uBAAuB,GAC/B,kBAAkB,GAClB,sBAAsB,GACtB,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACzC,CAAC;AAEF,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;gBAE5B,KAAK,EAAE,uBAAuB;CAU3C;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,CAAC,EAAE;IACT,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,OAAO,GAAE,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,eAAe,GAAG,sBAAsB,CAG1F,GACA,uBAAuB,CAOzB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,uBAAuB,EAChC,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,GACxC,OAAO,CAMT;AAED,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,uBAAuB,EACrC,KAAK,EAAE,kBAAkB,CAAC,eAAe,CAAC,EAC1C,OAAO,CAAC,EAAE,yBAAyB,GAClC,uBAAuB,CA+DzB;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,kBAAkB,CAAC,eAAe,CAAC,GAAG,OAAO,CAEhG;AAED,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,yBAAyB;;+BAsChD,uBAAuB,GAAG,IAAI;mBAGvC,kBAAkB,CAAC,eAAe,CAAC;;EAgBrD"}

package/esm/src/chat/stream-watchdog.js

@@ -0,0 +1,142 @@
+import "../../_dnt.polyfills.js";
+import * as dntShim from "../../_dnt.shims.js";
+export const DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS = 120_000;
+export const DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS = 300_000;
+export class ChatStreamIdleTimeoutError extends Error {
+    state;
+    constructor(state) {
+        const toolLabel = typeof state.toolName === "string" && state.toolName.length > 0
+            ? ` for ${state.toolName}${state.toolCallId ? ` (${state.toolCallId})` : ""}`
+            : state.toolCallId
+                ? ` for ${state.toolCallId}`
+                : "";
+        super(`Chat stream idle timeout after ${state.timeoutMs}ms during ${state.phase}${toolLabel}`);
+        this.name = "ChatStreamIdleTimeoutError";
+        this.state = state;
+    }
+}
+export function createChatStreamWatchdogState(phase, metadata, options = {
+    idleTimeoutMs: DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS,
+    toolRunningTimeoutMs: DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS,
+}) {
+    return {
+        phase,
+        timeoutMs: phase === "tool_running" ? options.toolRunningTimeoutMs : options.idleTimeoutMs,
+        ...(metadata?.toolCallId ? { toolCallId: metadata.toolCallId } : {}),
+        ...(metadata?.toolName ? { toolName: metadata.toolName } : {}),
+    };
+}
+export function isLongRunningToolRunning(current, longRunningToolNames) {
+    return (current.phase === "tool_running" &&
+        typeof current.toolName === "string" &&
+        longRunningToolNames.has(current.toolName));
+}
+export function getNextChatStreamWatchdogState(currentState, chunk, options) {
+    const resolvedOptions = resolveChatStreamWatchdogOptions(options);
+    switch (chunk.type) {
+        case "tool-input-start":
+            return createChatStreamWatchdogState("tool_input_streaming", {
+                toolCallId: chunk.toolCallId,
+                toolName: chunk.toolName,
+            }, resolvedOptions);
+        case "tool-input-delta":
+            return createChatStreamWatchdogState("tool_input_streaming", {
+                toolCallId: chunk.toolCallId,
+                toolName: currentState.toolCallId === chunk.toolCallId
+                    ? currentState.toolName
+                    : undefined,
+            }, resolvedOptions);
+        case "tool-input-available":
+            return createChatStreamWatchdogState("tool_running", {
+                toolCallId: chunk.toolCallId,
+                toolName: chunk.toolName,
+            }, resolvedOptions);
+        case "tool-output-available":
+        case "tool-output-error":
+        case "tool-output-denied":
+            return createChatStreamWatchdogState("post_tool_idle", {
+                toolCallId: chunk.toolCallId,
+                toolName: currentState.toolCallId === chunk.toolCallId
+                    ? currentState.toolName
+                    : undefined,
+            }, resolvedOptions);
+        case "message-metadata":
+            return isLongRunningToolRunning(currentState, resolvedOptions.longRunningToolNames)
+                ? currentState
+                : createChatStreamWatchdogState("response_pending", undefined, resolvedOptions);
+        case "finish":
+            return createChatStreamWatchdogState("response_pending", undefined, resolvedOptions);
+        default:
+            return isLongRunningToolRunning(currentState, resolvedOptions.longRunningToolNames)
+                ? currentState
+                : createChatStreamWatchdogState("response_pending", undefined, resolvedOptions);
+    }
+}
+export function isHeartbeatOnlyMetadataChunk(chunk) {
+    return chunk.type === "message-metadata" && Object.keys(chunk.messageMetadata ?? {}).length === 0;
+}
+export function createChatStreamWatchdog(options) {
+    const resolvedOptions = resolveChatStreamWatchdogOptions(options);
+    const controller = new AbortController();
+    let state = createChatStreamWatchdogState("response_pending", undefined, resolvedOptions);
+    let timer = null;
+    let lastTimeoutState = null;
+    const clearTimer = () => {
+        if (timer !== null) {
+            clearTimeout(timer);
+            timer = null;
+        }
+    };
+    const arm = () => {
+        if (controller.signal.aborted) {
+            return;
+        }
+        clearTimer();
+        if (isLongRunningToolRunning(state, resolvedOptions.longRunningToolNames)) {
+            return;
+        }
+        timer = dntShim.setTimeout(() => {
+            lastTimeoutState = state;
+            controller.abort(new DOMException(new ChatStreamIdleTimeoutError(state).message, "AbortError"));
+        }, state.timeoutMs);
+        maybeUnrefTimer(timer);
+    };
+    arm();
+    return {
+        signal: controller.signal,
+        get lastTimeoutState() {
+            return lastTimeoutState;
+        },
+        observe(chunk) {
+            if (isHeartbeatOnlyMetadataChunk(chunk)) {
+                return;
+            }
+            state = getNextChatStreamWatchdogState(state, chunk, resolvedOptions);
+            if (chunk.type === "finish") {
+                clearTimer();
+                return;
+            }
+            arm();
+        },
+        dispose() {
+            clearTimer();
+        },
+    };
+}
+function resolveChatStreamWatchdogOptions(options) {
+    return {
+        idleTimeoutMs: options?.idleTimeoutMs ?? DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS,
+        toolRunningTimeoutMs: options?.toolRunningTimeoutMs ??
+            DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS,
+        longRunningToolNames: new Set(options?.longRunningToolNames ?? ["invoke_agent"]),
+    };
+}
+function maybeUnrefTimer(timer) {
+    if (typeof timer !== "object" || timer === null || !("unref" in timer)) {
+        return;
+    }
+    const timerWithUnref = timer;
+    if (typeof timerWithUnref.unref === "function") {
+        timerWithUnref.unref();
+    }
+}

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.292";
+export declare const VERSION = "0.1.294";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.292";
+export const VERSION = "0.1.294";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.292",
+  "version": "0.1.294",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -193,6 +193,10 @@
       "import": "./esm/src/chat/provider-errors.js",
       "types": "./esm/src/chat/provider-errors.d.ts"
     },
+    "./chat/stream-watchdog": {
+      "import": "./esm/src/chat/stream-watchdog.js",
+      "types": "./esm/src/chat/stream-watchdog.d.ts"
+    },
     "./tsconfig.json": "./tsconfig.json"
   },
   "scripts": {},

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.292",
+  "version": "0.1.294",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [
@@ -67,7 +67,8 @@ export default {
     "./chat/conversation": "./src/chat/conversation.ts",
     "./chat/message-prep": "./src/chat/message-prep.ts",
     "./chat/final-step-fallback": "./src/chat/final-step-fallback.ts",
-    "./chat/provider-errors": "./src/chat/provider-errors.ts"
+    "./chat/provider-errors": "./src/chat/provider-errors.ts",
+    "./chat/stream-watchdog": "./src/chat/stream-watchdog.ts"
   },
   "imports": {
     "veryfront/head": "./src/react/runtime/core.ts",

package/src/src/chat/conversation.ts

@@ -293,6 +293,157 @@ export function pushToolParts(
   });
 }
 
+function pushFileConversationPart(
+  parts: MessagePart[],
+  part: Extract<ChatUiMessagePart, { type: "file" }>,
+): void {
+  const uploadId = part.uploadId ?? extractUploadId(part.url);
+  if (!uploadId) return;
+
+  if (part.mediaType.startsWith("image/")) {
+    parts.push({
+      type: "image",
+      upload_id: uploadId,
+      media_type: part.mediaType,
+      ...(part.url ? { url: part.url } : {}),
+    });
+    return;
+  }
+
+  parts.push({
+    type: "file",
+    upload_id: uploadId,
+    media_type: part.mediaType,
+    ...(part.url ? { url: part.url } : {}),
+  });
+}
+
+export function toConversationPartsFromUiMessage(message: ChatUiMessage): MessagePart[] {
+  const parts: MessagePart[] = [];
+
+  for (const part of message.parts) {
+    if (part.type === "text") {
+      parts.push({ type: "text", text: part.text });
+      continue;
+    }
+
+    if (part.type === "reasoning") {
+      parts.push({ type: "reasoning", text: part.text });
+      continue;
+    }
+
+    if (part.type === "step-start") {
+      continue;
+    }
+
+    if (part.type === "source-url") {
+      parts.push({
+        type: "citation",
+        source_id: part.sourceId,
+        title: part.title,
+        url: part.url,
+      });
+      continue;
+    }
+
+    if (part.type === "source-document") {
+      parts.push({
+        type: "citation",
+        source_id: part.sourceId,
+        title: part.title,
+      });
+      continue;
+    }
+
+    if (part.type === "file") {
+      pushFileConversationPart(parts, part);
+      continue;
+    }
+
+    if (isDataUiPart(part)) {
+      const name = part.type.replace(/^data-/, "");
+      if (name.length > 0) {
+        parts.push({
+          type: "data",
+          name,
+          value: part.data,
+        });
+      }
+      continue;
+    }
+
+    if (isToolUiPart(part)) {
+      const toolName = getUiToolName(part);
+      if (!toolName) {
+        continue;
+      }
+
+      pushToolParts(parts, toolName, part.toolCallId, part.state, part);
+    }
+  }
+
+  return parts.filter((part) => messagePartSchema.safeParse(part).success);
+}
+
+function isToolComplete(part: ToolUiPart): boolean {
+  return part.state === "output-available" || part.state === "output-error" ||
+    part.state === "output-denied";
+}
+
+export function hasIncompleteToolParts(message: ChatUiMessage): boolean {
+  return message.parts.some((part) => isToolUiPart(part) && !isToolComplete(part));
+}
+
+export function markIncompleteToolPartsAsStopped(message: ChatUiMessage): ChatUiMessage {
+  return markIncompleteToolPartsAsErrored(message, "Stopped by user");
+}
+
+export function markIncompleteToolPartsAsErrored(
+  message: ChatUiMessage,
+  errorText: string,
+): ChatUiMessage {
+  let mutated = false;
+
+  const parts = message.parts.map((part) => {
+    if (!isToolUiPart(part) || isToolComplete(part)) {
+      return part;
+    }
+
+    mutated = true;
+    return markToolPartAsErrored(part, errorText);
+  });
+
+  return mutated ? { ...message, parts } : message;
+}
+
+function markToolPartAsErrored(part: ToolUiPart, errorText: string): ChatUiMessagePart {
+  if (part.type === "dynamic-tool") {
+    return {
+      type: "dynamic-tool",
+      toolName: part.toolName,
+      toolCallId: part.toolCallId,
+      ...(part.title ? { title: part.title } : {}),
+      ...(part.providerExecuted !== undefined ? { providerExecuted: part.providerExecuted } : {}),
+      ...(part.callProviderMetadata ? { callProviderMetadata: part.callProviderMetadata } : {}),
+      input: part.input,
+      state: "output-error",
+      errorText,
+    };
+  }
+
+  return {
+    type: part.type,
+    toolCallId: part.toolCallId,
+    ...(part.toolName ? { toolName: part.toolName } : {}),
+    ...(part.title ? { title: part.title } : {}),
+    ...(part.providerExecuted !== undefined ? { providerExecuted: part.providerExecuted } : {}),
+    ...(part.callProviderMetadata ? { callProviderMetadata: part.callProviderMetadata } : {}),
+    input: part.input,
+    state: "output-error",
+    errorText,
+  };
+}
+
 export function isToolCallPart(value: unknown): value is ToolCallLike {
   return (
     isRecord(value) &&

package/src/src/chat/index.ts

@@ -259,3 +259,17 @@ export {
   type UseVoiceInputOptions,
   type UseVoiceInputResult,
 } from "../agent/react/use-voice-input.js";
+
+export {
+  ChatStreamIdleTimeoutError,
+  type ChatStreamWatchdogOptions,
+  type ChatStreamWatchdogPhase,
+  type ChatStreamWatchdogState,
+  createChatStreamWatchdog,
+  createChatStreamWatchdogState,
+  DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS,
+  DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS,
+  getNextChatStreamWatchdogState,
+  isHeartbeatOnlyMetadataChunk,
+  isLongRunningToolRunning,
+} from "./stream-watchdog.js";

package/src/src/chat/stream-watchdog.ts

@@ -0,0 +1,222 @@
+import "../../_dnt.polyfills.js";
+import * as dntShim from "../../_dnt.shims.js";
+import type { ChatUiMessageChunk, MessageMetadata } from "./types.js";
+
+export const DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS = 120_000;
+export const DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS = 300_000;
+
+export type ChatStreamWatchdogPhase =
+  | "response_pending"
+  | "tool_input_streaming"
+  | "tool_running"
+  | "post_tool_idle";
+
+export type ChatStreamWatchdogState = {
+  phase: ChatStreamWatchdogPhase;
+  timeoutMs: number;
+  toolCallId?: string;
+  toolName?: string;
+};
+
+export type ChatStreamWatchdogOptions = {
+  idleTimeoutMs?: number;
+  toolRunningTimeoutMs?: number;
+  longRunningToolNames?: Iterable<string>;
+};
+
+export class ChatStreamIdleTimeoutError extends Error {
+  readonly state: ChatStreamWatchdogState;
+
+  constructor(state: ChatStreamWatchdogState) {
+    const toolLabel = typeof state.toolName === "string" && state.toolName.length > 0
+      ? ` for ${state.toolName}${state.toolCallId ? ` (${state.toolCallId})` : ""}`
+      : state.toolCallId
+      ? ` for ${state.toolCallId}`
+      : "";
+    super(`Chat stream idle timeout after ${state.timeoutMs}ms during ${state.phase}${toolLabel}`);
+    this.name = "ChatStreamIdleTimeoutError";
+    this.state = state;
+  }
+}
+
+export function createChatStreamWatchdogState(
+  phase: ChatStreamWatchdogPhase,
+  metadata?: {
+    toolCallId?: string;
+    toolName?: string;
+  },
+  options: Pick<Required<ChatStreamWatchdogOptions>, "idleTimeoutMs" | "toolRunningTimeoutMs"> = {
+    idleTimeoutMs: DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS,
+    toolRunningTimeoutMs: DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS,
+  },
+): ChatStreamWatchdogState {
+  return {
+    phase,
+    timeoutMs: phase === "tool_running" ? options.toolRunningTimeoutMs : options.idleTimeoutMs,
+    ...(metadata?.toolCallId ? { toolCallId: metadata.toolCallId } : {}),
+    ...(metadata?.toolName ? { toolName: metadata.toolName } : {}),
+  };
+}
+
+export function isLongRunningToolRunning(
+  current: ChatStreamWatchdogState,
+  longRunningToolNames: ReadonlySet<string>,
+): boolean {
+  return (
+    current.phase === "tool_running" &&
+    typeof current.toolName === "string" &&
+    longRunningToolNames.has(current.toolName)
+  );
+}
+
+export function getNextChatStreamWatchdogState(
+  currentState: ChatStreamWatchdogState,
+  chunk: ChatUiMessageChunk<MessageMetadata>,
+  options?: ChatStreamWatchdogOptions,
+): ChatStreamWatchdogState {
+  const resolvedOptions = resolveChatStreamWatchdogOptions(options);
+
+  switch (chunk.type) {
+    case "tool-input-start":
+      return createChatStreamWatchdogState(
+        "tool_input_streaming",
+        {
+          toolCallId: chunk.toolCallId,
+          toolName: chunk.toolName,
+        },
+        resolvedOptions,
+      );
+
+    case "tool-input-delta":
+      return createChatStreamWatchdogState(
+        "tool_input_streaming",
+        {
+          toolCallId: chunk.toolCallId,
+          toolName: currentState.toolCallId === chunk.toolCallId
+            ? currentState.toolName
+            : undefined,
+        },
+        resolvedOptions,
+      );
+
+    case "tool-input-available":
+      return createChatStreamWatchdogState(
+        "tool_running",
+        {
+          toolCallId: chunk.toolCallId,
+          toolName: chunk.toolName,
+        },
+        resolvedOptions,
+      );
+
+    case "tool-output-available":
+    case "tool-output-error":
+    case "tool-output-denied":
+      return createChatStreamWatchdogState(
+        "post_tool_idle",
+        {
+          toolCallId: chunk.toolCallId,
+          toolName: currentState.toolCallId === chunk.toolCallId
+            ? currentState.toolName
+            : undefined,
+        },
+        resolvedOptions,
+      );
+
+    case "message-metadata":
+      return isLongRunningToolRunning(currentState, resolvedOptions.longRunningToolNames)
+        ? currentState
+        : createChatStreamWatchdogState("response_pending", undefined, resolvedOptions);
+
+    case "finish":
+      return createChatStreamWatchdogState("response_pending", undefined, resolvedOptions);
+
+    default:
+      return isLongRunningToolRunning(currentState, resolvedOptions.longRunningToolNames)
+        ? currentState
+        : createChatStreamWatchdogState("response_pending", undefined, resolvedOptions);
+  }
+}
+
+export function isHeartbeatOnlyMetadataChunk(chunk: ChatUiMessageChunk<MessageMetadata>): boolean {
+  return chunk.type === "message-metadata" && Object.keys(chunk.messageMetadata ?? {}).length === 0;
+}
+
+export function createChatStreamWatchdog(options?: ChatStreamWatchdogOptions) {
+  const resolvedOptions = resolveChatStreamWatchdogOptions(options);
+  const controller = new AbortController();
+  let state = createChatStreamWatchdogState("response_pending", undefined, resolvedOptions);
+  let timer: ReturnType<typeof dntShim.setTimeout> | null = null;
+  let lastTimeoutState: ChatStreamWatchdogState | null = null;
+
+  const clearTimer = () => {
+    if (timer !== null) {
+      clearTimeout(timer);
+      timer = null;
+    }
+  };
+
+  const arm = () => {
+    if (controller.signal.aborted) {
+      return;
+    }
+
+    clearTimer();
+
+    if (isLongRunningToolRunning(state, resolvedOptions.longRunningToolNames)) {
+      return;
+    }
+
+    timer = dntShim.setTimeout(() => {
+      lastTimeoutState = state;
+      controller.abort(
+        new DOMException(new ChatStreamIdleTimeoutError(state).message, "AbortError"),
+      );
+    }, state.timeoutMs);
+    maybeUnrefTimer(timer);
+  };
+
+  arm();
+
+  return {
+    signal: controller.signal,
+    get lastTimeoutState(): ChatStreamWatchdogState | null {
+      return lastTimeoutState;
+    },
+    observe(chunk: ChatUiMessageChunk<MessageMetadata>) {
+      if (isHeartbeatOnlyMetadataChunk(chunk)) {
+        return;
+      }
+
+      state = getNextChatStreamWatchdogState(state, chunk, resolvedOptions);
+      if (chunk.type === "finish") {
+        clearTimer();
+        return;
+      }
+      arm();
+    },
+    dispose() {
+      clearTimer();
+    },
+  };
+}
+
+function resolveChatStreamWatchdogOptions(options?: ChatStreamWatchdogOptions) {
+  return {
+    idleTimeoutMs: options?.idleTimeoutMs ?? DEFAULT_CHAT_STREAM_IDLE_TIMEOUT_MS,
+    toolRunningTimeoutMs: options?.toolRunningTimeoutMs ??
+      DEFAULT_CHAT_STREAM_TOOL_RUNNING_TIMEOUT_MS,
+    longRunningToolNames: new Set(options?.longRunningToolNames ?? ["invoke_agent"]),
+  };
+}
+
+function maybeUnrefTimer(timer: ReturnType<typeof dntShim.setTimeout>): void {
+  if (typeof timer !== "object" || timer === null || !("unref" in timer)) {
+    return;
+  }
+
+  const timerWithUnref: { unref?: unknown } = timer;
+  if (typeof timerWithUnref.unref === "function") {
+    timerWithUnref.unref();
+  }
+}

package/src/src/utils/version-constant.ts

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.292";
+export const VERSION = "0.1.294";