veryfront 0.1.293 → 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.293",
+    "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/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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,yBAAyB,CAAC;AAGjC,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAExF,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,SAAS,EACT,KAAK,cAAc,EACnB,MAAM,EACN,KAAK,WAAW,EAChB,eAAe,EACf,KAAK,oBAAoB,EACzB,QAAQ,EACR,KAAK,aAAa,EAClB,WAAW,EACX,KAAK,gBAAgB,EACrB,OAAO,EACP,KAAK,gBAAgB,EACrB,WAAW,EACX,KAAK,gBAAgB,GACtB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,KAAK,cAAc,EACnB,cAAc,EACd,KAAK,mBAAmB,EACxB,YAAY,EACZ,KAAK,iBAAiB,EACtB,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACZ,eAAe,EACf,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,iCAAiC,EACtC,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,cAAc,EACnB,sBAAsB,EACtB,KAAK,2BAA2B,EAChC,wBAAwB,EACxB,KAAK,6BAA6B,EAClC,gBAAgB,EAChB,eAAe,EACf,KAAK,oBAAoB,EACzB,gBAAgB,EAChB,uBAAuB,EACvB,MAAM,EACN,KAAK,aAAa,EAClB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,KAAK,mBAAmB,EACxB,cAAc,EACd,KAAK,mBAAmB,EACxB,eAAe,EACf,eAAe,EACf,UAAU,EACV,MAAM,EACN,cAAc,EACd,KAAK,mBAAmB,EACxB,eAAe,EACf,KAAK,oBAAoB,EACzB,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,YAAY,EACZ,KAAK,iBAAiB,EACtB,aAAa,EACb,aAAa,EACb,OAAO,EACP,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,OAAO,EACP,KAAK,YAAY,EACjB,aAAa,EACb,KAAK,kBAAkB,EACvB,UAAU,EACV,KAAK,eAAe,EACpB,WAAW,EACX,KAAK,gBAAgB,EACrB,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,MAAM,EACX,YAAY,EACZ,eAAe,EACf,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,YAAY,EACZ,KAAK,iBAAiB,EACtB,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,OAAO,IAAI,iBAAiB,EAC5B,KAAK,YAAY,EACjB,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,mBAAmB,GACpB,MAAM,4CAA4C,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAE/E,OAAO,EACL,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,mCAAmC,EACnC,KAAK,wCAAwC,EAC7C,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,iCAAiC,EACtC,KAAK,2BAA2B,EAChC,iCAAiC,GAClC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,0BAA0B,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,wBAAwB,EACxB,6BAA6B,EAC7B,mCAAmC,EACnC,2CAA2C,EAC3C,8BAA8B,EAC9B,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC"}

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.293";
+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.293";
+export const VERSION = "0.1.294";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.293",
+  "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.293",
+  "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/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.293";
+export const VERSION = "0.1.294";