@agent-native/core 0.92.11 → 0.93.0

package/dist/client/integrations/index.js

@@ -1,3 +1,4 @@
 export { IntegrationsPanel } from "./IntegrationsPanel.js";
 export { useIntegrationStatus } from "./useIntegrationStatus.js";
+export { listIntegrationEnvStatuses, listIntegrationStatuses, saveIntegrationEnvVars, setIntegrationEnabled, setupIntegration, disconnectManagedIntegrationInstallation, listManagedIntegrationInstallations, managedIntegrationOAuthUrl, managedSlackAgentManifestUrl, listManagedIntegrationScopes, saveManagedIntegrationScope, listManagedIntegrationBudgets, listManagedIntegrationMemory, forgetManagedIntegrationMemory, saveManagedIntegrationBudget, testManagedIntegrationInstallation, IntegrationClientError, } from "./api.js";
 //# sourceMappingURL=index.js.map

package/dist/client/integrations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/integrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC","sourcesContent":["export { IntegrationsPanel } from \"./IntegrationsPanel.js\";\nexport { useIntegrationStatus } from \"./useIntegrationStatus.js\";\nexport type { IntegrationStatus } from \"./useIntegrationStatus.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/integrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,wCAAwC,EACxC,mCAAmC,EACnC,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAC5B,kCAAkC,EAClC,sBAAsB,GAQvB,MAAM,UAAU,CAAC","sourcesContent":["export { IntegrationsPanel } from \"./IntegrationsPanel.js\";\nexport { useIntegrationStatus } from \"./useIntegrationStatus.js\";\nexport type { IntegrationStatus } from \"./useIntegrationStatus.js\";\nexport {\n  listIntegrationEnvStatuses,\n  listIntegrationStatuses,\n  saveIntegrationEnvVars,\n  setIntegrationEnabled,\n  setupIntegration,\n  disconnectManagedIntegrationInstallation,\n  listManagedIntegrationInstallations,\n  managedIntegrationOAuthUrl,\n  managedSlackAgentManifestUrl,\n  listManagedIntegrationScopes,\n  saveManagedIntegrationScope,\n  listManagedIntegrationBudgets,\n  listManagedIntegrationMemory,\n  forgetManagedIntegrationMemory,\n  saveManagedIntegrationBudget,\n  testManagedIntegrationInstallation,\n  IntegrationClientError,\n  type ClientIntegrationInstallation,\n  type ClientIntegrationScope,\n  type ClientIntegrationUsageBudget,\n  type ClientIntegrationMemory,\n  type ClientIntegrationStatus,\n  type IntegrationEnvStatus,\n  type SavedEnvVarsResult,\n} from \"./api.js\";\n"]}

package/dist/client/transcription/use-live-transcription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-live-transcription.d.ts","sourceRoot":"","sources":["../../../src/client/transcription/use-live-transcription.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,WAAW,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE,2BAA2B,GACpC,oBAAoB,CAuLtB"}
+{"version":3,"file":"use-live-transcription.d.ts","sourceRoot":"","sources":["../../../src/client/transcription/use-live-transcription.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiBH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,WAAW,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE,2BAA2B,GACpC,oBAAoB,CAmPtB"}

package/dist/client/transcription/use-live-transcription.js

@@ -11,6 +11,8 @@
  * from second zero even without an API key.
  */
 import { useCallback, useEffect, useRef, useState } from "react";
+const NETWORK_RESTART_BASE_MS = 1_000;
+const NETWORK_RESTART_MAX_MS = 30_000;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function getSpeechRecognitionCtor() {
     if (typeof window === "undefined")
@@ -30,12 +32,19 @@ export function useLiveTranscription(options) {
     const transcriptRef = useRef("");
     const stoppedManuallyRef = useRef(false);
     const stopWaiterRef = useRef(null);
+    const restartTimerRef = useRef(null);
+    const networkErrorCountRef = useRef(0);
+    const restartDelayRef = useRef(0);
     const supported = !!getSpeechRecognitionCtor();
     const start = useCallback(() => {
         const Ctor = getSpeechRecognitionCtor();
         if (!Ctor)
             return;
         // Clean up any prior session.
+        if (restartTimerRef.current !== null) {
+            window.clearTimeout(restartTimerRef.current);
+            restartTimerRef.current = null;
+        }
         if (recognitionRef.current) {
             try {
                 recognitionRef.current.abort();
@@ -51,6 +60,8 @@ export function useLiveTranscription(options) {
         recognitionRef.current = recognition;
         transcriptRef.current = "";
         stoppedManuallyRef.current = false;
+        networkErrorCountRef.current = 0;
+        restartDelayRef.current = 0;
         setTranscript("");
         setInterimText("");
         recognition.onresult = (event) => {
@@ -67,21 +78,52 @@ export function useLiveTranscription(options) {
                 }
             }
             setInterimText(interim);
+            if (event.results.length > 0) {
+                networkErrorCountRef.current = 0;
+                restartDelayRef.current = 0;
+            }
         };
         recognition.onerror = (event) => {
             if (event.error === "no-speech" || event.error === "aborted")
                 return;
+            if (event.error === "not-allowed" ||
+                event.error === "service-not-allowed" ||
+                event.error === "audio-capture") {
+                stoppedManuallyRef.current = true;
+                setIsActive(false);
+                return;
+            }
+            if (event.error === "network") {
+                const retryIndex = networkErrorCountRef.current++;
+                restartDelayRef.current = Math.min(NETWORK_RESTART_BASE_MS * 2 ** retryIndex, NETWORK_RESTART_MAX_MS);
+            }
             console.warn("[live-transcription] error:", event.error);
         };
         recognition.onend = () => {
             // Web Speech sometimes stops on its own (silence timeout, network
             // hiccup). Restart automatically unless we stopped intentionally.
-            if (!stoppedManuallyRef.current && recognitionRef.current) {
-                try {
-                    recognition.start();
+            if (!stoppedManuallyRef.current &&
+                recognitionRef.current === recognition) {
+                const restart = () => {
+                    restartTimerRef.current = null;
+                    if (stoppedManuallyRef.current ||
+                        recognitionRef.current !== recognition) {
+                        return;
+                    }
+                    try {
+                        recognition.start();
+                    }
+                    catch {
+                        setIsActive(false);
+                    }
+                };
+                const delayMs = restartDelayRef.current;
+                restartDelayRef.current = 0;
+                if (delayMs > 0) {
+                    restartTimerRef.current = window.setTimeout(restart, delayMs);
                 }
-                catch {
-                    setIsActive(false);
+                else {
+                    restart();
                 }
                 return;
             }
@@ -100,6 +142,10 @@ export function useLiveTranscription(options) {
     }, [lang]);
     const stop = useCallback(() => {
         stoppedManuallyRef.current = true;
+        if (restartTimerRef.current !== null) {
+            window.clearTimeout(restartTimerRef.current);
+            restartTimerRef.current = null;
+        }
         setInterimText("");
         if (recognitionRef.current) {
             try {
@@ -115,6 +161,10 @@ export function useLiveTranscription(options) {
     }, []);
     const stopAndWait = useCallback((timeoutMs = 1200) => {
         stoppedManuallyRef.current = true;
+        if (restartTimerRef.current !== null) {
+            window.clearTimeout(restartTimerRef.current);
+            restartTimerRef.current = null;
+        }
         setInterimText("");
         const recognition = recognitionRef.current;
         if (!recognition) {
@@ -153,6 +203,10 @@ export function useLiveTranscription(options) {
         if (!recognitionRef.current)
             return;
         stoppedManuallyRef.current = true;
+        if (restartTimerRef.current !== null) {
+            window.clearTimeout(restartTimerRef.current);
+            restartTimerRef.current = null;
+        }
         try {
             recognitionRef.current.stop();
         }

package/dist/client/transcription/use-live-transcription.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-live-transcription.js","sourceRoot":"","sources":["../../../src/client/transcription/use-live-transcription.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Live transcription hook — runs the browser's Web Speech API alongside\n * any recording to produce an instant transcript with no API key required.\n *\n * Designed to pair with a MediaRecorder: start when recording begins,\n * stop when the user hits stop. The accumulated transcript is available\n * immediately — no round-trip to Whisper needed.\n *\n * Higher-quality backends (Groq Whisper, OpenAI Whisper, Deepgram) can\n * refine the result afterward, but this gives users something useful\n * from second zero even without an API key.\n */\n\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction getSpeechRecognitionCtor(): any {\n  if (typeof window === \"undefined\") return null;\n  return (\n    (window as any).SpeechRecognition ||\n    (window as any).webkitSpeechRecognition ||\n    null\n  );\n}\n\nexport interface UseLiveTranscriptionOptions {\n  lang?: string;\n}\n\nexport interface LiveTranscriptionApi {\n  supported: boolean;\n  isActive: boolean;\n  /** Accumulated final transcript text so far. */\n  transcript: string;\n  /** Current interim (unconfirmed) text being spoken. */\n  interimText: string;\n  start: () => void;\n  stop: () => string;\n  stopAndWait: (timeoutMs?: number) => Promise<string>;\n  pause: () => void;\n  resume: () => void;\n}\n\nexport function useLiveTranscription(\n  options?: UseLiveTranscriptionOptions,\n): LiveTranscriptionApi {\n  const lang =\n    options?.lang ??\n    (typeof navigator !== \"undefined\" ? navigator.language : \"en-US\");\n\n  const [isActive, setIsActive] = useState(false);\n  const [transcript, setTranscript] = useState(\"\");\n  const [interimText, setInterimText] = useState(\"\");\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const recognitionRef = useRef<any>(null);\n  const transcriptRef = useRef(\"\");\n  const stoppedManuallyRef = useRef(false);\n  const stopWaiterRef = useRef<((text: string) => void) | null>(null);\n\n  const supported = !!getSpeechRecognitionCtor();\n\n  const start = useCallback(() => {\n    const Ctor = getSpeechRecognitionCtor();\n    if (!Ctor) return;\n\n    // Clean up any prior session.\n    if (recognitionRef.current) {\n      try {\n        recognitionRef.current.abort();\n      } catch {\n        /* ignore */\n      }\n    }\n\n    const recognition = new Ctor();\n    recognition.continuous = true;\n    recognition.interimResults = true;\n    recognition.lang = lang;\n    recognitionRef.current = recognition;\n    transcriptRef.current = \"\";\n    stoppedManuallyRef.current = false;\n    setTranscript(\"\");\n    setInterimText(\"\");\n\n    recognition.onresult = (event: any) => {\n      let interim = \"\";\n      for (let i = event.resultIndex; i < event.results.length; i++) {\n        const result = event.results[i];\n        const text = result[0]?.transcript ?? \"\";\n        if (result.isFinal) {\n          transcriptRef.current += text;\n          setTranscript(transcriptRef.current);\n        } else {\n          interim += text;\n        }\n      }\n      setInterimText(interim);\n    };\n\n    recognition.onerror = (event: any) => {\n      if (event.error === \"no-speech\" || event.error === \"aborted\") return;\n      console.warn(\"[live-transcription] error:\", event.error);\n    };\n\n    recognition.onend = () => {\n      // Web Speech sometimes stops on its own (silence timeout, network\n      // hiccup). Restart automatically unless we stopped intentionally.\n      if (!stoppedManuallyRef.current && recognitionRef.current) {\n        try {\n          recognition.start();\n        } catch {\n          setIsActive(false);\n        }\n        return;\n      }\n      setIsActive(false);\n      if (stopWaiterRef.current) {\n        stopWaiterRef.current(transcriptRef.current);\n      }\n    };\n\n    try {\n      recognition.start();\n      setIsActive(true);\n    } catch {\n      /* browser may block without user gesture */\n    }\n  }, [lang]);\n\n  const stop = useCallback((): string => {\n    stoppedManuallyRef.current = true;\n    setInterimText(\"\");\n    if (recognitionRef.current) {\n      try {\n        recognitionRef.current.stop();\n      } catch {\n        /* ignore */\n      }\n      recognitionRef.current = null;\n    }\n    setIsActive(false);\n    return transcriptRef.current;\n  }, []);\n\n  const stopAndWait = useCallback((timeoutMs = 1200): Promise<string> => {\n    stoppedManuallyRef.current = true;\n    setInterimText(\"\");\n\n    const recognition = recognitionRef.current;\n    if (!recognition) {\n      setIsActive(false);\n      return Promise.resolve(transcriptRef.current);\n    }\n\n    return new Promise((resolve) => {\n      let settled = false;\n      const finish = (text: string) => {\n        if (settled) return;\n        settled = true;\n        window.clearTimeout(timeout);\n        if (stopWaiterRef.current === finish) {\n          stopWaiterRef.current = null;\n        }\n        if (recognitionRef.current === recognition) {\n          recognitionRef.current = null;\n        }\n        setIsActive(false);\n        resolve(text);\n      };\n\n      const timeout = window.setTimeout(() => {\n        finish(transcriptRef.current);\n      }, timeoutMs);\n\n      stopWaiterRef.current = finish;\n      try {\n        recognition.stop();\n      } catch {\n        finish(transcriptRef.current);\n      }\n    });\n  }, []);\n\n  const pause = useCallback(() => {\n    if (!recognitionRef.current) return;\n    stoppedManuallyRef.current = true;\n    try {\n      recognitionRef.current.stop();\n    } catch {\n      /* ignore */\n    }\n  }, []);\n\n  const resume = useCallback(() => {\n    if (!recognitionRef.current) return;\n    stoppedManuallyRef.current = false;\n    try {\n      recognitionRef.current.start();\n      setIsActive(true);\n    } catch {\n      /* ignore */\n    }\n  }, []);\n\n  // Clean up on unmount\n  const startRef = useRef(start);\n  const stopRef = useRef(stop);\n  startRef.current = start;\n  stopRef.current = stop;\n\n  useEffect(() => {\n    return () => {\n      stopRef.current();\n    };\n  }, []);\n\n  return {\n    supported,\n    isActive,\n    transcript,\n    interimText,\n    start,\n    stop,\n    stopAndWait,\n    pause,\n    resume,\n  };\n}\n"]}
+{"version":3,"file":"use-live-transcription.js","sourceRoot":"","sources":["../../../src/client/transcription/use-live-transcription.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjE,MAAM,uBAAuB,GAAG,KAAK,CAAC;AACtC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAEtC,8DAA8D;AAC9D,SAAS,wBAAwB;IAC/B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO,CACJ,MAAc,CAAC,iBAAiB;QAChC,MAAc,CAAC,uBAAuB;QACvC,IAAI,CACL,CAAC;AACJ,CAAC;AAoBD,MAAM,UAAU,oBAAoB,CAClC,OAAqC;IAErC,MAAM,IAAI,GACR,OAAO,EAAE,IAAI;QACb,CAAC,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAEpE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAEnD,8DAA8D;IAC9D,MAAM,cAAc,GAAG,MAAM,CAAM,IAAI,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,kBAAkB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,MAAM,CAAkC,IAAI,CAAC,CAAC;IACpE,MAAM,eAAe,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IACpD,MAAM,oBAAoB,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAElC,MAAM,SAAS,GAAG,CAAC,CAAC,wBAAwB,EAAE,CAAC;IAE/C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,MAAM,IAAI,GAAG,wBAAwB,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,8BAA8B;QAC9B,IAAI,eAAe,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC7C,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;QACjC,CAAC;QACD,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;QAC/B,WAAW,CAAC,UAAU,GAAG,IAAI,CAAC;QAC9B,WAAW,CAAC,cAAc,GAAG,IAAI,CAAC;QAClC,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC;QACxB,cAAc,CAAC,OAAO,GAAG,WAAW,CAAC;QACrC,aAAa,CAAC,OAAO,GAAG,EAAE,CAAC;QAC3B,kBAAkB,CAAC,OAAO,GAAG,KAAK,CAAC;QACnC,oBAAoB,CAAC,OAAO,GAAG,CAAC,CAAC;QACjC,eAAe,CAAC,OAAO,GAAG,CAAC,CAAC;QAC5B,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,cAAc,CAAC,EAAE,CAAC,CAAC;QAEnB,WAAW,CAAC,QAAQ,GAAG,CAAC,KAAU,EAAE,EAAE;YACpC,IAAI,OAAO,GAAG,EAAE,CAAC;YACjB,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAChC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,IAAI,EAAE,CAAC;gBACzC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,aAAa,CAAC,OAAO,IAAI,IAAI,CAAC;oBAC9B,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACN,OAAO,IAAI,IAAI,CAAC;gBAClB,CAAC;YACH,CAAC;YACD,cAAc,CAAC,OAAO,CAAC,CAAC;YACxB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,oBAAoB,CAAC,OAAO,GAAG,CAAC,CAAC;gBACjC,eAAe,CAAC,OAAO,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC;QAEF,WAAW,CAAC,OAAO,GAAG,CAAC,KAAU,EAAE,EAAE;YACnC,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;gBAAE,OAAO;YACrE,IACE,KAAK,CAAC,KAAK,KAAK,aAAa;gBAC7B,KAAK,CAAC,KAAK,KAAK,qBAAqB;gBACrC,KAAK,CAAC,KAAK,KAAK,eAAe,EAC/B,CAAC;gBACD,kBAAkB,CAAC,OAAO,GAAG,IAAI,CAAC;gBAClC,WAAW,CAAC,KAAK,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,EAAE,CAAC;gBAClD,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAChC,uBAAuB,GAAG,CAAC,IAAI,UAAU,EACzC,sBAAsB,CACvB,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3D,CAAC,CAAC;QAEF,WAAW,CAAC,KAAK,GAAG,GAAG,EAAE;YACvB,kEAAkE;YAClE,kEAAkE;YAClE,IACE,CAAC,kBAAkB,CAAC,OAAO;gBAC3B,cAAc,CAAC,OAAO,KAAK,WAAW,EACtC,CAAC;gBACD,MAAM,OAAO,GAAG,GAAG,EAAE;oBACnB,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;oBAC/B,IACE,kBAAkB,CAAC,OAAO;wBAC1B,cAAc,CAAC,OAAO,KAAK,WAAW,EACtC,CAAC;wBACD,OAAO;oBACT,CAAC;oBACD,IAAI,CAAC;wBACH,WAAW,CAAC,KAAK,EAAE,CAAC;oBACtB,CAAC;oBAAC,MAAM,CAAC;wBACP,WAAW,CAAC,KAAK,CAAC,CAAC;oBACrB,CAAC;gBACH,CAAC,CAAC;gBACF,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC;gBACxC,eAAe,CAAC,OAAO,GAAG,CAAC,CAAC;gBAC5B,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,eAAe,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAChE,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,CAAC;gBACZ,CAAC;gBACD,OAAO;YACT,CAAC;YACD,WAAW,CAAC,KAAK,CAAC,CAAC;YACnB,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;gBAC1B,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC;YACH,WAAW,CAAC,KAAK,EAAE,CAAC;YACpB,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,MAAM,IAAI,GAAG,WAAW,CAAC,GAAW,EAAE;QACpC,kBAAkB,CAAC,OAAO,GAAG,IAAI,CAAC;QAClC,IAAI,eAAe,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC7C,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;QACjC,CAAC;QACD,cAAc,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC;QAChC,CAAC;QACD,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,aAAa,CAAC,OAAO,CAAC;IAC/B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,SAAS,GAAG,IAAI,EAAmB,EAAE;QACpE,kBAAkB,CAAC,OAAO,GAAG,IAAI,CAAC;QAClC,IAAI,eAAe,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC7C,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;QACjC,CAAC;QACD,cAAc,CAAC,EAAE,CAAC,CAAC;QAEnB,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC;QAC3C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE;gBAC9B,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAC7B,IAAI,aAAa,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;oBACrC,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC/B,CAAC;gBACD,IAAI,cAAc,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;oBAC3C,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC;gBAChC,CAAC;gBACD,WAAW,CAAC,KAAK,CAAC,CAAC;gBACnB,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;gBACrC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,aAAa,CAAC,OAAO,GAAG,MAAM,CAAC;YAC/B,IAAI,CAAC;gBACH,WAAW,CAAC,IAAI,EAAE,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,CAAC,cAAc,CAAC,OAAO;YAAE,OAAO;QACpC,kBAAkB,CAAC,OAAO,GAAG,IAAI,CAAC;QAClC,IAAI,eAAe,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC7C,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;QACjC,CAAC;QACD,IAAI,CAAC;YACH,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,IAAI,CAAC,cAAc,CAAC,OAAO;YAAE,OAAO;QACpC,kBAAkB,CAAC,OAAO,GAAG,KAAK,CAAC;QACnC,IAAI,CAAC;YACH,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC/B,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,sBAAsB;IACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAEvB,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,SAAS;QACT,QAAQ;QACR,UAAU;QACV,WAAW;QACX,KAAK;QACL,IAAI;QACJ,WAAW;QACX,KAAK;QACL,MAAM;KACP,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Live transcription hook — runs the browser's Web Speech API alongside\n * any recording to produce an instant transcript with no API key required.\n *\n * Designed to pair with a MediaRecorder: start when recording begins,\n * stop when the user hits stop. The accumulated transcript is available\n * immediately — no round-trip to Whisper needed.\n *\n * Higher-quality backends (Groq Whisper, OpenAI Whisper, Deepgram) can\n * refine the result afterward, but this gives users something useful\n * from second zero even without an API key.\n */\n\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nconst NETWORK_RESTART_BASE_MS = 1_000;\nconst NETWORK_RESTART_MAX_MS = 30_000;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction getSpeechRecognitionCtor(): any {\n  if (typeof window === \"undefined\") return null;\n  return (\n    (window as any).SpeechRecognition ||\n    (window as any).webkitSpeechRecognition ||\n    null\n  );\n}\n\nexport interface UseLiveTranscriptionOptions {\n  lang?: string;\n}\n\nexport interface LiveTranscriptionApi {\n  supported: boolean;\n  isActive: boolean;\n  /** Accumulated final transcript text so far. */\n  transcript: string;\n  /** Current interim (unconfirmed) text being spoken. */\n  interimText: string;\n  start: () => void;\n  stop: () => string;\n  stopAndWait: (timeoutMs?: number) => Promise<string>;\n  pause: () => void;\n  resume: () => void;\n}\n\nexport function useLiveTranscription(\n  options?: UseLiveTranscriptionOptions,\n): LiveTranscriptionApi {\n  const lang =\n    options?.lang ??\n    (typeof navigator !== \"undefined\" ? navigator.language : \"en-US\");\n\n  const [isActive, setIsActive] = useState(false);\n  const [transcript, setTranscript] = useState(\"\");\n  const [interimText, setInterimText] = useState(\"\");\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const recognitionRef = useRef<any>(null);\n  const transcriptRef = useRef(\"\");\n  const stoppedManuallyRef = useRef(false);\n  const stopWaiterRef = useRef<((text: string) => void) | null>(null);\n  const restartTimerRef = useRef<number | null>(null);\n  const networkErrorCountRef = useRef(0);\n  const restartDelayRef = useRef(0);\n\n  const supported = !!getSpeechRecognitionCtor();\n\n  const start = useCallback(() => {\n    const Ctor = getSpeechRecognitionCtor();\n    if (!Ctor) return;\n\n    // Clean up any prior session.\n    if (restartTimerRef.current !== null) {\n      window.clearTimeout(restartTimerRef.current);\n      restartTimerRef.current = null;\n    }\n    if (recognitionRef.current) {\n      try {\n        recognitionRef.current.abort();\n      } catch {\n        /* ignore */\n      }\n    }\n\n    const recognition = new Ctor();\n    recognition.continuous = true;\n    recognition.interimResults = true;\n    recognition.lang = lang;\n    recognitionRef.current = recognition;\n    transcriptRef.current = \"\";\n    stoppedManuallyRef.current = false;\n    networkErrorCountRef.current = 0;\n    restartDelayRef.current = 0;\n    setTranscript(\"\");\n    setInterimText(\"\");\n\n    recognition.onresult = (event: any) => {\n      let interim = \"\";\n      for (let i = event.resultIndex; i < event.results.length; i++) {\n        const result = event.results[i];\n        const text = result[0]?.transcript ?? \"\";\n        if (result.isFinal) {\n          transcriptRef.current += text;\n          setTranscript(transcriptRef.current);\n        } else {\n          interim += text;\n        }\n      }\n      setInterimText(interim);\n      if (event.results.length > 0) {\n        networkErrorCountRef.current = 0;\n        restartDelayRef.current = 0;\n      }\n    };\n\n    recognition.onerror = (event: any) => {\n      if (event.error === \"no-speech\" || event.error === \"aborted\") return;\n      if (\n        event.error === \"not-allowed\" ||\n        event.error === \"service-not-allowed\" ||\n        event.error === \"audio-capture\"\n      ) {\n        stoppedManuallyRef.current = true;\n        setIsActive(false);\n        return;\n      }\n      if (event.error === \"network\") {\n        const retryIndex = networkErrorCountRef.current++;\n        restartDelayRef.current = Math.min(\n          NETWORK_RESTART_BASE_MS * 2 ** retryIndex,\n          NETWORK_RESTART_MAX_MS,\n        );\n      }\n      console.warn(\"[live-transcription] error:\", event.error);\n    };\n\n    recognition.onend = () => {\n      // Web Speech sometimes stops on its own (silence timeout, network\n      // hiccup). Restart automatically unless we stopped intentionally.\n      if (\n        !stoppedManuallyRef.current &&\n        recognitionRef.current === recognition\n      ) {\n        const restart = () => {\n          restartTimerRef.current = null;\n          if (\n            stoppedManuallyRef.current ||\n            recognitionRef.current !== recognition\n          ) {\n            return;\n          }\n          try {\n            recognition.start();\n          } catch {\n            setIsActive(false);\n          }\n        };\n        const delayMs = restartDelayRef.current;\n        restartDelayRef.current = 0;\n        if (delayMs > 0) {\n          restartTimerRef.current = window.setTimeout(restart, delayMs);\n        } else {\n          restart();\n        }\n        return;\n      }\n      setIsActive(false);\n      if (stopWaiterRef.current) {\n        stopWaiterRef.current(transcriptRef.current);\n      }\n    };\n\n    try {\n      recognition.start();\n      setIsActive(true);\n    } catch {\n      /* browser may block without user gesture */\n    }\n  }, [lang]);\n\n  const stop = useCallback((): string => {\n    stoppedManuallyRef.current = true;\n    if (restartTimerRef.current !== null) {\n      window.clearTimeout(restartTimerRef.current);\n      restartTimerRef.current = null;\n    }\n    setInterimText(\"\");\n    if (recognitionRef.current) {\n      try {\n        recognitionRef.current.stop();\n      } catch {\n        /* ignore */\n      }\n      recognitionRef.current = null;\n    }\n    setIsActive(false);\n    return transcriptRef.current;\n  }, []);\n\n  const stopAndWait = useCallback((timeoutMs = 1200): Promise<string> => {\n    stoppedManuallyRef.current = true;\n    if (restartTimerRef.current !== null) {\n      window.clearTimeout(restartTimerRef.current);\n      restartTimerRef.current = null;\n    }\n    setInterimText(\"\");\n\n    const recognition = recognitionRef.current;\n    if (!recognition) {\n      setIsActive(false);\n      return Promise.resolve(transcriptRef.current);\n    }\n\n    return new Promise((resolve) => {\n      let settled = false;\n      const finish = (text: string) => {\n        if (settled) return;\n        settled = true;\n        window.clearTimeout(timeout);\n        if (stopWaiterRef.current === finish) {\n          stopWaiterRef.current = null;\n        }\n        if (recognitionRef.current === recognition) {\n          recognitionRef.current = null;\n        }\n        setIsActive(false);\n        resolve(text);\n      };\n\n      const timeout = window.setTimeout(() => {\n        finish(transcriptRef.current);\n      }, timeoutMs);\n\n      stopWaiterRef.current = finish;\n      try {\n        recognition.stop();\n      } catch {\n        finish(transcriptRef.current);\n      }\n    });\n  }, []);\n\n  const pause = useCallback(() => {\n    if (!recognitionRef.current) return;\n    stoppedManuallyRef.current = true;\n    if (restartTimerRef.current !== null) {\n      window.clearTimeout(restartTimerRef.current);\n      restartTimerRef.current = null;\n    }\n    try {\n      recognitionRef.current.stop();\n    } catch {\n      /* ignore */\n    }\n  }, []);\n\n  const resume = useCallback(() => {\n    if (!recognitionRef.current) return;\n    stoppedManuallyRef.current = false;\n    try {\n      recognitionRef.current.start();\n      setIsActive(true);\n    } catch {\n      /* ignore */\n    }\n  }, []);\n\n  // Clean up on unmount\n  const startRef = useRef(start);\n  const stopRef = useRef(stop);\n  startRef.current = start;\n  stopRef.current = stop;\n\n  useEffect(() => {\n    return () => {\n      stopRef.current();\n    };\n  }, []);\n\n  return {\n    supported,\n    isActive,\n    transcript,\n    interimText,\n    start,\n    stop,\n    stopAndWait,\n    pause,\n    resume,\n  };\n}\n"]}

package/dist/client/use-run-stuck-detection.d.ts

@@ -24,6 +24,13 @@ export interface RunStuckState {
     heartbeatSinceMs: number | null;
     /** How the run was dispatched/continued, e.g. foreground-self-chain or background-processing. */
     dispatchMode: string | null;
+    /**
+     * Server-authoritative: true when the run holds an open tool call or A2A
+     * `agent_call` delegation (`in_flight_since` marker set). Preferred over the
+     * client-side proxy for deciding whether Retry (which aborts the run) is
+     * safe to offer. Null when the server bundle predates this field.
+     */
+    hasInFlightWork: boolean | null;
 }
 export interface UseRunStuckDetectionOptions {
     /** The thread to monitor. Pass null/undefined to disable polling. */
@@ -50,13 +57,21 @@ export interface UseRunStuckDetectionOptions {
      * from the same poll response that computes the elapsed time.
      */
     backgroundStuckThresholdMs?: number;
+    /**
+     * Threshold for a claimed durable background worker that is still sending
+     * fresh process heartbeats. These workers can legitimately spend up to the
+     * 12-minute tool/no-progress window on large Design, Plan, or Assets work.
+     * Default 13 minutes, matching the durable chunk handoff boundary.
+     */
+    liveBackgroundStuckThresholdMs?: number;
     /** Poll interval. Default 5_000ms. */
     pollIntervalMs?: number;
     /** API base path. Default `/_agent-native/agent-chat`. */
     apiUrl?: string;
 }
 export declare const DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS = 180000;
-export declare function useRunStuckDetection({ threadId, enabled, stuckThresholdMs, backgroundStuckThresholdMs, pollIntervalMs, apiUrl, }: UseRunStuckDetectionOptions): RunStuckState;
+export declare const DEFAULT_LIVE_BACKGROUND_STUCK_THRESHOLD_MS: number;
+export declare function useRunStuckDetection({ threadId, enabled, stuckThresholdMs, backgroundStuckThresholdMs, liveBackgroundStuckThresholdMs, pollIntervalMs, apiUrl, }: UseRunStuckDetectionOptions): RunStuckState;
 /**
  * POST `/runs/:id/abort` so the server flips the run to "aborted" and the
  * adapter's reconnect loop exits cleanly. Returns the run id that was

package/dist/client/use-run-stuck-detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-run-stuck-detection.d.ts","sourceRoot":"","sources":["../../src/client/use-run-stuck-detection.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oDAAoD;IACpD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iGAAiG;IACjG,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,eAAO,MAAM,qCAAqC,SAAU,CAAC;AA0B7D,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,OAAc,EACd,gBAA6C,EAC7C,0BAAkE,EAClE,cAAyC,EACzC,MAAM,GACP,EAAE,2BAA2B,GAAG,aAAa,CAiG7C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,WAEzB,MAAM,WAAU,MAAM,KAAY,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBzE"}
+{"version":3,"file":"use-run-stuck-detection.d.ts","sourceRoot":"","sources":["../../src/client/use-run-stuck-detection.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oDAAoD;IACpD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iGAAiG;IACjG,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;;OAKG;IACH,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC;;;;;OAKG;IACH,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,eAAO,MAAM,qCAAqC,SAAU,CAAC;AAC7D,eAAO,MAAM,0CAA0C,QAAc,CAAC;AA8BtE,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,OAAc,EACd,gBAA6C,EAC7C,0BAAkE,EAClE,8BAA2E,EAC3E,cAAyC,EACzC,MAAM,GACP,EAAE,2BAA2B,GAAG,aAAa,CAmH7C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,WAEzB,MAAM,WAAU,MAAM,KAAY,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBzE"}

package/dist/client/use-run-stuck-detection.js

@@ -2,8 +2,10 @@ import { useEffect, useState, useCallback } from "react";
 import { agentNativePath } from "./api-path.js";
 const DEFAULT_STUCK_THRESHOLD_MS = 90_000;
 export const DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS = 180_000;
+export const DEFAULT_LIVE_BACKGROUND_STUCK_THRESHOLD_MS = 13 * 60_000;
 const DEFAULT_POLL_INTERVAL_MS = 5_000;
 const IDLE_BACKOFF_INTERVAL_MS = 15_000;
+const FRESH_BACKGROUND_HEARTBEAT_MS = 30_000;
 const EMPTY_STATE = {
     isStuck: false,
     runId: null,
@@ -13,8 +15,9 @@ const EMPTY_STATE = {
     heartbeatAt: null,
     heartbeatSinceMs: null,
     dispatchMode: null,
+    hasInFlightWork: null,
 };
-export function useRunStuckDetection({ threadId, enabled = true, stuckThresholdMs = DEFAULT_STUCK_THRESHOLD_MS, backgroundStuckThresholdMs = DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS, pollIntervalMs = DEFAULT_POLL_INTERVAL_MS, apiUrl, }) {
+export function useRunStuckDetection({ threadId, enabled = true, stuckThresholdMs = DEFAULT_STUCK_THRESHOLD_MS, backgroundStuckThresholdMs = DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS, liveBackgroundStuckThresholdMs = DEFAULT_LIVE_BACKGROUND_STUCK_THRESHOLD_MS, pollIntervalMs = DEFAULT_POLL_INTERVAL_MS, apiUrl, }) {
     const [state, setState] = useState(EMPTY_STATE);
     useEffect(() => {
         // Reset on every thread change so the previous thread's stuck banner
@@ -51,9 +54,21 @@ export function useRunStuckDetection({ threadId, enabled = true, stuckThresholdM
                     // get its chance before the user sees a "stuck" affordance.
                     const serverContinued = dispatchMode === "foreground-self-chain" ||
                         dispatchMode?.startsWith("background") === true;
-                    const effectiveThresholdMs = serverContinued
-                        ? backgroundStuckThresholdMs
-                        : stuckThresholdMs;
+                    // A claimed durable worker with a fresh heartbeat can legitimately
+                    // be waiting on a bounded long-running tool/sub-agent call. Showing
+                    // Retry at the generic 3-minute continuation threshold aborts healthy
+                    // work and starts the same call again. Let the worker's own 12-minute
+                    // watchdog act first; a dead/stale heartbeat still gets the earlier
+                    // background fallback below.
+                    const liveBackgroundWorker = dispatchMode === "background-processing" &&
+                        heartbeatSinceMs != null &&
+                        heartbeatSinceMs >= 0 &&
+                        heartbeatSinceMs < FRESH_BACKGROUND_HEARTBEAT_MS;
+                    const effectiveThresholdMs = liveBackgroundWorker
+                        ? liveBackgroundStuckThresholdMs
+                        : serverContinued
+                            ? backgroundStuckThresholdMs
+                            : stuckThresholdMs;
                     const isStuck = Boolean(data.active &&
                         data.status === "running" &&
                         stuckSinceMs != null &&
@@ -67,6 +82,9 @@ export function useRunStuckDetection({ threadId, enabled = true, stuckThresholdM
                         heartbeatAt,
                         heartbeatSinceMs,
                         dispatchMode,
+                        hasInFlightWork: typeof data.hasInFlightWork === "boolean"
+                            ? data.hasInFlightWork
+                            : null,
                     });
                     // Back off polling when nothing is in flight — there's no point
                     // hammering the endpoint while the chat is idle. We still poll
@@ -97,6 +115,7 @@ export function useRunStuckDetection({ threadId, enabled = true, stuckThresholdM
         enabled,
         stuckThresholdMs,
         backgroundStuckThresholdMs,
+        liveBackgroundStuckThresholdMs,
         pollIntervalMs,
         apiUrl,
     ]);

package/dist/client/use-run-stuck-detection.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-run-stuck-detection.js","sourceRoot":"","sources":["../../src/client/use-run-stuck-detection.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useState, useCallback } from \"react\";\n\nimport { agentNativePath } from \"./api-path.js\";\n\n/**\n * Per-thread chat run health, derived from the durable `last_progress_at`\n * timestamp on the server. Drives the user-visible \"this chat looks stuck\"\n * affordance — distinct from the silent reconnect logic in\n * `agent-chat-adapter.ts`, which keeps trying in the background. When\n * automatic recovery isn't making progress (for whatever reason), this\n * hook surfaces a Retry / Cancel button to the user instead of leaving\n * them staring at a frozen spinner.\n */\nexport interface RunStuckState {\n  /** True when an active run hasn't emitted an event for `stuckThresholdMs`. */\n  isStuck: boolean;\n  /** ID of the active run, or null when nothing is in flight. */\n  runId: string | null;\n  /** Server-side run status (\"running\" / \"completed\" / \"errored\" / etc.). */\n  status: string | null;\n  /** Server timestamp (ms) of the last emitted event, or null if none yet. */\n  lastProgressAt: number | null;\n  /** Milliseconds since `lastProgressAt`, or null. */\n  stuckSinceMs: number | null;\n  /** Server timestamp (ms) of the last process-alive heartbeat. */\n  heartbeatAt: number | null;\n  /** Milliseconds since `heartbeatAt`, computed against the server clock. */\n  heartbeatSinceMs: number | null;\n  /** How the run was dispatched/continued, e.g. foreground-self-chain or background-processing. */\n  dispatchMode: string | null;\n}\n\nexport interface UseRunStuckDetectionOptions {\n  /** The thread to monitor. Pass null/undefined to disable polling. */\n  threadId: string | null | undefined;\n  /**\n   * Set false to skip scheduling the poll loop entirely — used to gate\n   * polling to only the active chat tab when multiple tabs are mounted\n   * (inactive tabs are kept alive via display:none, not unmounted).\n   * Defaults to true.\n   */\n  enabled?: boolean;\n  /**\n   * Threshold above which an in-flight FOREGROUND run is considered stuck.\n   * The default sits comfortably above the adapter's 75s no-progress\n   * reconnect — by then automatic recovery has already had its chance.\n   */\n  stuckThresholdMs?: number;\n  /**\n   * Threshold for BACKGROUND-dispatched runs (dispatchMode starts with\n   * \"background\"). The server owns recovery for these — its run-manager\n   * no-progress backstop (150s) and unclaimed-run sweep act first — so the\n   * user-facing \"stuck\" affordance is a late fallback, not a race against\n   * them. Selected inside the hook because the dispatch mode is only known\n   * from the same poll response that computes the elapsed time.\n   */\n  backgroundStuckThresholdMs?: number;\n  /** Poll interval. Default 5_000ms. */\n  pollIntervalMs?: number;\n  /** API base path. Default `/_agent-native/agent-chat`. */\n  apiUrl?: string;\n}\n\nconst DEFAULT_STUCK_THRESHOLD_MS = 90_000;\nexport const DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS = 180_000;\nconst DEFAULT_POLL_INTERVAL_MS = 5_000;\nconst IDLE_BACKOFF_INTERVAL_MS = 15_000;\n\ninterface ActiveRunResponse {\n  active: boolean;\n  runId?: string;\n  status?: string;\n  heartbeatAt: number | null;\n  lastProgressAt?: number | null;\n  dispatchMode?: string | null;\n  /** Server clock at response time, used to compute elapsed server-relative. */\n  serverNow?: number;\n}\n\nconst EMPTY_STATE: RunStuckState = {\n  isStuck: false,\n  runId: null,\n  status: null,\n  lastProgressAt: null,\n  stuckSinceMs: null,\n  heartbeatAt: null,\n  heartbeatSinceMs: null,\n  dispatchMode: null,\n};\n\nexport function useRunStuckDetection({\n  threadId,\n  enabled = true,\n  stuckThresholdMs = DEFAULT_STUCK_THRESHOLD_MS,\n  backgroundStuckThresholdMs = DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS,\n  pollIntervalMs = DEFAULT_POLL_INTERVAL_MS,\n  apiUrl,\n}: UseRunStuckDetectionOptions): RunStuckState {\n  const [state, setState] = useState<RunStuckState>(EMPTY_STATE);\n\n  useEffect(() => {\n    // Reset on every thread change so the previous thread's stuck banner\n    // doesn't bleed onto the new one before the first poll completes.\n    setState(EMPTY_STATE);\n    if (!threadId || !enabled) return;\n\n    const base = apiUrl ?? agentNativePath(\"/_agent-native/agent-chat\");\n    let cancelled = false;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n\n    const poll = async () => {\n      if (cancelled) return;\n      let nextDelay = pollIntervalMs;\n      try {\n        const res = await fetch(\n          `${base}/runs/active?threadId=${encodeURIComponent(threadId)}`,\n          { credentials: \"same-origin\" },\n        );\n        if (cancelled) return;\n        if (res.ok) {\n          const data = (await res.json()) as ActiveRunResponse;\n          const lastProgressAt = data.lastProgressAt ?? null;\n          // Measure elapsed against the SERVER clock (serverNow) rather than the\n          // client's Date.now(). lastProgressAt is a server timestamp, so client\n          // clock skew of more than stuckThresholdMs would otherwise mark every\n          // run stuck (clock ahead) or never stuck (clock behind). Fall back to\n          // the client clock for older bundles that don't send serverNow.\n          const nowMs = data.serverNow ?? Date.now();\n          const stuckSinceMs =\n            lastProgressAt != null ? nowMs - lastProgressAt : null;\n          const heartbeatAt = data.heartbeatAt ?? null;\n          const heartbeatSinceMs =\n            heartbeatAt != null ? nowMs - heartbeatAt : null;\n          const dispatchMode =\n            typeof data.dispatchMode === \"string\" ? data.dispatchMode : null;\n          // Server-continued runs get the wider threshold: the server's own\n          // recovery (150s no-progress backstop + chained continuations) must\n          // get its chance before the user sees a \"stuck\" affordance.\n          const serverContinued =\n            dispatchMode === \"foreground-self-chain\" ||\n            dispatchMode?.startsWith(\"background\") === true;\n          const effectiveThresholdMs = serverContinued\n            ? backgroundStuckThresholdMs\n            : stuckThresholdMs;\n          const isStuck = Boolean(\n            data.active &&\n            data.status === \"running\" &&\n            stuckSinceMs != null &&\n            stuckSinceMs > effectiveThresholdMs,\n          );\n          setState({\n            isStuck,\n            runId: data.runId ?? null,\n            status: data.status ?? null,\n            lastProgressAt,\n            stuckSinceMs,\n            heartbeatAt,\n            heartbeatSinceMs,\n            dispatchMode,\n          });\n          // Back off polling when nothing is in flight — there's no point\n          // hammering the endpoint while the chat is idle. We still poll\n          // occasionally so a fresh run started in another tab is picked up.\n          if (!data.active || data.status !== \"running\") {\n            nextDelay = IDLE_BACKOFF_INTERVAL_MS;\n          }\n        }\n      } catch {\n        // Network blip — leave previous state. Next tick will retry.\n      }\n      if (!cancelled) {\n        timer = setTimeout(poll, nextDelay);\n      }\n    };\n\n    // Stagger the first poll so a freshly-started run isn't immediately\n    // classified as stuck before the server has had a chance to record\n    // any progress events.\n    timer = setTimeout(poll, 2_000);\n\n    return () => {\n      cancelled = true;\n      if (timer) clearTimeout(timer);\n    };\n  }, [\n    threadId,\n    enabled,\n    stuckThresholdMs,\n    backgroundStuckThresholdMs,\n    pollIntervalMs,\n    apiUrl,\n  ]);\n\n  return state;\n}\n\n/**\n * POST `/runs/:id/abort` so the server flips the run to \"aborted\" and the\n * adapter's reconnect loop exits cleanly. Returns the run id that was\n * aborted (or null on failure) so callers can correlate observability\n * events. Best-effort — failures are swallowed, since the user's intent\n * is already captured locally.\n */\nexport function useAbortRun(apiUrl?: string) {\n  return useCallback(\n    async (runId: string, reason: string = \"user\"): Promise<string | null> => {\n      const base = apiUrl ?? agentNativePath(\"/_agent-native/agent-chat\");\n      try {\n        const res = await fetch(\n          `${base}/runs/${encodeURIComponent(runId)}/abort`,\n          {\n            method: \"POST\",\n            headers: { \"Content-Type\": \"application/json\" },\n            credentials: \"same-origin\",\n            body: JSON.stringify({ reason }),\n          },\n        );\n        if (!res.ok) return null;\n        return runId;\n      } catch {\n        return null;\n      }\n    },\n    [apiUrl],\n  );\n}\n"]}
+{"version":3,"file":"use-run-stuck-detection.js","sourceRoot":"","sources":["../../src/client/use-run-stuck-detection.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useState, useCallback } from \"react\";\n\nimport { agentNativePath } from \"./api-path.js\";\n\n/**\n * Per-thread chat run health, derived from the durable `last_progress_at`\n * timestamp on the server. Drives the user-visible \"this chat looks stuck\"\n * affordance — distinct from the silent reconnect logic in\n * `agent-chat-adapter.ts`, which keeps trying in the background. When\n * automatic recovery isn't making progress (for whatever reason), this\n * hook surfaces a Retry / Cancel button to the user instead of leaving\n * them staring at a frozen spinner.\n */\nexport interface RunStuckState {\n  /** True when an active run hasn't emitted an event for `stuckThresholdMs`. */\n  isStuck: boolean;\n  /** ID of the active run, or null when nothing is in flight. */\n  runId: string | null;\n  /** Server-side run status (\"running\" / \"completed\" / \"errored\" / etc.). */\n  status: string | null;\n  /** Server timestamp (ms) of the last emitted event, or null if none yet. */\n  lastProgressAt: number | null;\n  /** Milliseconds since `lastProgressAt`, or null. */\n  stuckSinceMs: number | null;\n  /** Server timestamp (ms) of the last process-alive heartbeat. */\n  heartbeatAt: number | null;\n  /** Milliseconds since `heartbeatAt`, computed against the server clock. */\n  heartbeatSinceMs: number | null;\n  /** How the run was dispatched/continued, e.g. foreground-self-chain or background-processing. */\n  dispatchMode: string | null;\n  /**\n   * Server-authoritative: true when the run holds an open tool call or A2A\n   * `agent_call` delegation (`in_flight_since` marker set). Preferred over the\n   * client-side proxy for deciding whether Retry (which aborts the run) is\n   * safe to offer. Null when the server bundle predates this field.\n   */\n  hasInFlightWork: boolean | null;\n}\n\nexport interface UseRunStuckDetectionOptions {\n  /** The thread to monitor. Pass null/undefined to disable polling. */\n  threadId: string | null | undefined;\n  /**\n   * Set false to skip scheduling the poll loop entirely — used to gate\n   * polling to only the active chat tab when multiple tabs are mounted\n   * (inactive tabs are kept alive via display:none, not unmounted).\n   * Defaults to true.\n   */\n  enabled?: boolean;\n  /**\n   * Threshold above which an in-flight FOREGROUND run is considered stuck.\n   * The default sits comfortably above the adapter's 75s no-progress\n   * reconnect — by then automatic recovery has already had its chance.\n   */\n  stuckThresholdMs?: number;\n  /**\n   * Threshold for BACKGROUND-dispatched runs (dispatchMode starts with\n   * \"background\"). The server owns recovery for these — its run-manager\n   * no-progress backstop (150s) and unclaimed-run sweep act first — so the\n   * user-facing \"stuck\" affordance is a late fallback, not a race against\n   * them. Selected inside the hook because the dispatch mode is only known\n   * from the same poll response that computes the elapsed time.\n   */\n  backgroundStuckThresholdMs?: number;\n  /**\n   * Threshold for a claimed durable background worker that is still sending\n   * fresh process heartbeats. These workers can legitimately spend up to the\n   * 12-minute tool/no-progress window on large Design, Plan, or Assets work.\n   * Default 13 minutes, matching the durable chunk handoff boundary.\n   */\n  liveBackgroundStuckThresholdMs?: number;\n  /** Poll interval. Default 5_000ms. */\n  pollIntervalMs?: number;\n  /** API base path. Default `/_agent-native/agent-chat`. */\n  apiUrl?: string;\n}\n\nconst DEFAULT_STUCK_THRESHOLD_MS = 90_000;\nexport const DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS = 180_000;\nexport const DEFAULT_LIVE_BACKGROUND_STUCK_THRESHOLD_MS = 13 * 60_000;\nconst DEFAULT_POLL_INTERVAL_MS = 5_000;\nconst IDLE_BACKOFF_INTERVAL_MS = 15_000;\nconst FRESH_BACKGROUND_HEARTBEAT_MS = 30_000;\n\ninterface ActiveRunResponse {\n  active: boolean;\n  runId?: string;\n  status?: string;\n  heartbeatAt: number | null;\n  lastProgressAt?: number | null;\n  dispatchMode?: string | null;\n  /** Server clock at response time, used to compute elapsed server-relative. */\n  serverNow?: number;\n  /** True when the run holds an open tool/A2A call (in_flight_since marker). */\n  hasInFlightWork?: boolean;\n}\n\nconst EMPTY_STATE: RunStuckState = {\n  isStuck: false,\n  runId: null,\n  status: null,\n  lastProgressAt: null,\n  stuckSinceMs: null,\n  heartbeatAt: null,\n  heartbeatSinceMs: null,\n  dispatchMode: null,\n  hasInFlightWork: null,\n};\n\nexport function useRunStuckDetection({\n  threadId,\n  enabled = true,\n  stuckThresholdMs = DEFAULT_STUCK_THRESHOLD_MS,\n  backgroundStuckThresholdMs = DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS,\n  liveBackgroundStuckThresholdMs = DEFAULT_LIVE_BACKGROUND_STUCK_THRESHOLD_MS,\n  pollIntervalMs = DEFAULT_POLL_INTERVAL_MS,\n  apiUrl,\n}: UseRunStuckDetectionOptions): RunStuckState {\n  const [state, setState] = useState<RunStuckState>(EMPTY_STATE);\n\n  useEffect(() => {\n    // Reset on every thread change so the previous thread's stuck banner\n    // doesn't bleed onto the new one before the first poll completes.\n    setState(EMPTY_STATE);\n    if (!threadId || !enabled) return;\n\n    const base = apiUrl ?? agentNativePath(\"/_agent-native/agent-chat\");\n    let cancelled = false;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n\n    const poll = async () => {\n      if (cancelled) return;\n      let nextDelay = pollIntervalMs;\n      try {\n        const res = await fetch(\n          `${base}/runs/active?threadId=${encodeURIComponent(threadId)}`,\n          { credentials: \"same-origin\" },\n        );\n        if (cancelled) return;\n        if (res.ok) {\n          const data = (await res.json()) as ActiveRunResponse;\n          const lastProgressAt = data.lastProgressAt ?? null;\n          // Measure elapsed against the SERVER clock (serverNow) rather than the\n          // client's Date.now(). lastProgressAt is a server timestamp, so client\n          // clock skew of more than stuckThresholdMs would otherwise mark every\n          // run stuck (clock ahead) or never stuck (clock behind). Fall back to\n          // the client clock for older bundles that don't send serverNow.\n          const nowMs = data.serverNow ?? Date.now();\n          const stuckSinceMs =\n            lastProgressAt != null ? nowMs - lastProgressAt : null;\n          const heartbeatAt = data.heartbeatAt ?? null;\n          const heartbeatSinceMs =\n            heartbeatAt != null ? nowMs - heartbeatAt : null;\n          const dispatchMode =\n            typeof data.dispatchMode === \"string\" ? data.dispatchMode : null;\n          // Server-continued runs get the wider threshold: the server's own\n          // recovery (150s no-progress backstop + chained continuations) must\n          // get its chance before the user sees a \"stuck\" affordance.\n          const serverContinued =\n            dispatchMode === \"foreground-self-chain\" ||\n            dispatchMode?.startsWith(\"background\") === true;\n          // A claimed durable worker with a fresh heartbeat can legitimately\n          // be waiting on a bounded long-running tool/sub-agent call. Showing\n          // Retry at the generic 3-minute continuation threshold aborts healthy\n          // work and starts the same call again. Let the worker's own 12-minute\n          // watchdog act first; a dead/stale heartbeat still gets the earlier\n          // background fallback below.\n          const liveBackgroundWorker =\n            dispatchMode === \"background-processing\" &&\n            heartbeatSinceMs != null &&\n            heartbeatSinceMs >= 0 &&\n            heartbeatSinceMs < FRESH_BACKGROUND_HEARTBEAT_MS;\n          const effectiveThresholdMs = liveBackgroundWorker\n            ? liveBackgroundStuckThresholdMs\n            : serverContinued\n              ? backgroundStuckThresholdMs\n              : stuckThresholdMs;\n          const isStuck = Boolean(\n            data.active &&\n            data.status === \"running\" &&\n            stuckSinceMs != null &&\n            stuckSinceMs > effectiveThresholdMs,\n          );\n          setState({\n            isStuck,\n            runId: data.runId ?? null,\n            status: data.status ?? null,\n            lastProgressAt,\n            stuckSinceMs,\n            heartbeatAt,\n            heartbeatSinceMs,\n            dispatchMode,\n            hasInFlightWork:\n              typeof data.hasInFlightWork === \"boolean\"\n                ? data.hasInFlightWork\n                : null,\n          });\n          // Back off polling when nothing is in flight — there's no point\n          // hammering the endpoint while the chat is idle. We still poll\n          // occasionally so a fresh run started in another tab is picked up.\n          if (!data.active || data.status !== \"running\") {\n            nextDelay = IDLE_BACKOFF_INTERVAL_MS;\n          }\n        }\n      } catch {\n        // Network blip — leave previous state. Next tick will retry.\n      }\n      if (!cancelled) {\n        timer = setTimeout(poll, nextDelay);\n      }\n    };\n\n    // Stagger the first poll so a freshly-started run isn't immediately\n    // classified as stuck before the server has had a chance to record\n    // any progress events.\n    timer = setTimeout(poll, 2_000);\n\n    return () => {\n      cancelled = true;\n      if (timer) clearTimeout(timer);\n    };\n  }, [\n    threadId,\n    enabled,\n    stuckThresholdMs,\n    backgroundStuckThresholdMs,\n    liveBackgroundStuckThresholdMs,\n    pollIntervalMs,\n    apiUrl,\n  ]);\n\n  return state;\n}\n\n/**\n * POST `/runs/:id/abort` so the server flips the run to \"aborted\" and the\n * adapter's reconnect loop exits cleanly. Returns the run id that was\n * aborted (or null on failure) so callers can correlate observability\n * events. Best-effort — failures are swallowed, since the user's intent\n * is already captured locally.\n */\nexport function useAbortRun(apiUrl?: string) {\n  return useCallback(\n    async (runId: string, reason: string = \"user\"): Promise<string | null> => {\n      const base = apiUrl ?? agentNativePath(\"/_agent-native/agent-chat\");\n      try {\n        const res = await fetch(\n          `${base}/runs/${encodeURIComponent(runId)}/abort`,\n          {\n            method: \"POST\",\n            headers: { \"Content-Type\": \"application/json\" },\n            credentials: \"same-origin\",\n            body: JSON.stringify({ reason }),\n          },\n        );\n        if (!res.ok) return null;\n        return runId;\n      } catch {\n        return null;\n      }\n    },\n    [apiUrl],\n  );\n}\n"]}

package/dist/collab/awareness.d.ts

@@ -62,11 +62,11 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
-    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
+    error?: undefined;
 }>>;
 /**
  * GET /_agent-native/collab/:docId/users
@@ -77,10 +77,10 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
-    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
+    error?: undefined;
 }>>;
 //# sourceMappingURL=awareness.d.ts.map

package/dist/collab/awareness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"awareness.d.ts","sourceRoot":"","sources":["../../src/collab/awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgB3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,GAAG,SAAS,GAChC,IAAI,CAON;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,KAAK,CAAC,EAAE,cAAc,GACrB,IAAI,CAgBN;AAoBD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAmB,GAC7B,IAAI,CAON;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE1E;AAiBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAO1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAOnE;AAkCD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;;kBAwDa,MAAM;eAAS,MAAM;;GAoB1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;kBAYM,MAAM;kBAAY,MAAM;;GAMvD,CAAC"}
+{"version":3,"file":"awareness.d.ts","sourceRoot":"","sources":["../../src/collab/awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgB3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,GAAG,SAAS,GAChC,IAAI,CAON;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,KAAK,CAAC,EAAE,cAAc,GACrB,IAAI,CAgBN;AAoBD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAmB,GAC7B,IAAI,CAON;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE1E;AAiBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAO1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAOnE;AAkCD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;kBAwDa,MAAM;eAAS,MAAM;;;GAoB1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;kBAYM,MAAM;kBAAY,MAAM;;;GAMvD,CAAC"}

package/dist/deploy/build.d.ts.map

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

package/dist/deploy/build.js

@@ -17,7 +17,7 @@ import fs from "fs";
 import { createRequire } from "module";
 import path from "path";
 import { fileURLToPath } from "url";
-import { AGENT_BACKGROUND_FUNCTION_NAME, AGENT_CHAT_PROCESS_RUN_PATH, } from "../agent/durable-background.js";
+import { AGENT_BACKGROUND_FUNCTION_NAME, AGENT_BACKGROUND_PROCESSOR_A2A, AGENT_BACKGROUND_PROCESSOR_FIELD, AGENT_BACKGROUND_PROCESSOR_ROUTE, AGENT_BACKGROUND_PROCESSOR_ROUTE_FIELD, AGENT_CHAT_PROCESS_RUN_PATH, } from "../agent/durable-background.js";
 import { normalizeAppBasePath } from "../server/app-base-path.js";
 import { DEFAULT_SSR_CDN_CACHE_CONTROL, DEFAULT_SSR_NETLIFY_CDN_CACHE_CONTROL, DEFAULT_SPECULATION_RULES_PATH, DEFAULT_SSR_CACHE_CONTROL, } from "../shared/cache-control.js";
 import { mcpEmbedStaticAssetRouteRules } from "../shared/mcp-embed-headers.js";
@@ -1933,6 +1933,11 @@ export function emitSingleTemplateNetlifyBackgroundFunction(projectCwd) {
     // copied bundle does NOT re-register the catch-all `config.path`.
     fs.rmSync(path.join(dest, "server.mjs"), { force: true });
     const processRunPath = JSON.stringify(AGENT_CHAT_PROCESS_RUN_PATH);
+    const a2aProcessTaskPath = JSON.stringify("/_agent-native/a2a/_process-task");
+    const backgroundProcessorField = JSON.stringify(AGENT_BACKGROUND_PROCESSOR_FIELD);
+    const backgroundProcessorA2A = JSON.stringify(AGENT_BACKGROUND_PROCESSOR_A2A);
+    const backgroundProcessorRoute = JSON.stringify(AGENT_BACKGROUND_PROCESSOR_ROUTE);
+    const backgroundProcessorRouteField = JSON.stringify(AGENT_BACKGROUND_PROCESSOR_ROUTE_FIELD);
     const entry = `// Mark this isolate as the durable background runtime BEFORE the handler
 // bundle is imported, so isInBackgroundFunctionRuntime() reliably returns true
 // in this function. The deployed Lambda name is NOT guaranteed to end in
@@ -1944,6 +1949,35 @@ globalThis.__AGENT_NATIVE_BACKGROUND_RUNTIME__ = true;
 
 // The framework route the Nitro router dispatches to (the _process-run plugin).
 const PROCESS_RUN_PATH = ${processRunPath};
+const A2A_PROCESS_TASK_PATH = ${a2aProcessTaskPath};
+const BACKGROUND_PROCESSOR_FIELD = ${backgroundProcessorField};
+const BACKGROUND_PROCESSOR_A2A = ${backgroundProcessorA2A};
+const BACKGROUND_PROCESSOR_ROUTE = ${backgroundProcessorRoute};
+const BACKGROUND_PROCESSOR_ROUTE_FIELD = ${backgroundProcessorRouteField};
+
+function processorPathFromBody(body) {
+  if (!body) return null;
+  try {
+    const parsed = JSON.parse(body);
+    if (parsed?.[BACKGROUND_PROCESSOR_FIELD] === BACKGROUND_PROCESSOR_A2A) {
+      return A2A_PROCESS_TASK_PATH;
+    }
+    const route = parsed?.[BACKGROUND_PROCESSOR_ROUTE_FIELD];
+    if (
+      parsed?.[BACKGROUND_PROCESSOR_FIELD] === BACKGROUND_PROCESSOR_ROUTE &&
+      typeof route === "string" &&
+      route.startsWith("/") &&
+      route.includes("/api/_agent-native-background/") &&
+      !route.includes("?") &&
+      !route.includes("#")
+    ) {
+      return route;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
 
 let cachedHandler;
 
@@ -1959,11 +1993,11 @@ export default async function handler(request, context) {
   try {
     cachedHandler ??= (await import("./main.mjs")).default;
     const url = new URL(request.url);
-    url.pathname = PROCESS_RUN_PATH;
     // Read the body once and pass it through. GET/HEAD have no body.
     const method = request.method || "POST";
     const hasBody = method !== "GET" && method !== "HEAD";
     const body = hasBody ? await request.text() : undefined;
+    url.pathname = processorPathFromBody(body) || PROCESS_RUN_PATH;
     const rewritten = new Request(url.toString(), {
       method,
       headers: request.headers,
@@ -2084,6 +2118,17 @@ export function rewriteBareYjsImportsForServerlessOutput(serverDir) {
 export function assertSingleTemplateNetlifyBuildOutput(projectCwd) {
     const failures = [];
     const publishDir = path.join(projectCwd, "dist");
+    const workspaceAppBasePath = process.env.AGENT_NATIVE_WORKSPACE === "1" ||
+        process.env.VITE_AGENT_NATIVE_WORKSPACE === "1"
+        ? normalizeConfiguredAppBasePath()
+        : "";
+    const assetsRelativeDir = workspaceAppBasePath
+        ? path.join(workspaceAppBasePath.slice(1), "assets")
+        : "assets";
+    const assetsDisplayPath = path
+        .join("dist", assetsRelativeDir)
+        .split(path.sep)
+        .join("/");
     const redirectsPath = path.join(publishDir, "_redirects");
     const internalDir = path.join(projectCwd, ".netlify", "functions-internal");
     const serverDir = path.join(internalDir, "server");
@@ -2093,10 +2138,10 @@ export function assertSingleTemplateNetlifyBuildOutput(projectCwd) {
         failures.push("missing publish directory: dist");
     }
     else {
-        const assetsDir = path.join(publishDir, "assets");
+        const assetsDir = path.join(publishDir, assetsRelativeDir);
         if (!fs.existsSync(assetsDir) ||
             fs.readdirSync(assetsDir).every((name) => name.startsWith("."))) {
-            failures.push("dist/assets is missing hashed client assets — the publish dir would load an infinite spinner");
+            failures.push(`${assetsDisplayPath} is missing hashed client assets — the publish dir would load an infinite spinner`);
         }
     }
     if (fs.existsSync(publishDir) && fs.existsSync(redirectsPath)) {