@agent-native/core 0.84.66 → 0.85.0

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

@@ -29,17 +29,27 @@ export interface UseRunStuckDetectionOptions {
     /** The thread to monitor. Pass null/undefined to disable polling. */
     threadId: string | null | undefined;
     /**
-     * Threshold above which an in-flight run is considered stuck. The default
-     * sits comfortably above the adapter's 75s no-progress reconnect — by then
-     * automatic recovery has already had its chance.
+     * Threshold above which an in-flight FOREGROUND run is considered stuck.
+     * The default sits comfortably above the adapter's 75s no-progress
+     * reconnect — by then automatic recovery has already had its chance.
      */
     stuckThresholdMs?: number;
+    /**
+     * Threshold for BACKGROUND-dispatched runs (dispatchMode starts with
+     * "background"). The server owns recovery for these — its run-manager
+     * no-progress backstop (150s) and unclaimed-run sweep act first — so the
+     * user-facing "stuck" affordance is a late fallback, not a race against
+     * them. Selected inside the hook because the dispatch mode is only known
+     * from the same poll response that computes the elapsed time.
+     */
+    backgroundStuckThresholdMs?: number;
     /** Poll interval. Default 5_000ms. */
     pollIntervalMs?: number;
     /** API base path. Default `/_agent-native/agent-chat`. */
     apiUrl?: string;
 }
-export declare function useRunStuckDetection({ threadId, stuckThresholdMs, pollIntervalMs, apiUrl, }: UseRunStuckDetectionOptions): RunStuckState;
+export declare const DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS = 180000;
+export declare function useRunStuckDetection({ threadId, stuckThresholdMs, backgroundStuckThresholdMs, 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,4EAA4E;IAC5E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4BD,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,gBAA6C,EAC7C,cAAyC,EACzC,MAAM,GACP,EAAE,2BAA2B,GAAG,aAAa,CAgF7C;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,4EAA4E;IAC5E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC;;;;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,gBAA6C,EAC7C,0BAAkE,EAClE,cAAyC,EACzC,MAAM,GACP,EAAE,2BAA2B,GAAG,aAAa,CA6F7C;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

@@ -1,6 +1,7 @@
 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;
 const DEFAULT_POLL_INTERVAL_MS = 5_000;
 const IDLE_BACKOFF_INTERVAL_MS = 15_000;
 const EMPTY_STATE = {
@@ -13,7 +14,7 @@ const EMPTY_STATE = {
     heartbeatSinceMs: null,
     dispatchMode: null,
 };
-export function useRunStuckDetection({ threadId, stuckThresholdMs = DEFAULT_STUCK_THRESHOLD_MS, pollIntervalMs = DEFAULT_POLL_INTERVAL_MS, apiUrl, }) {
+export function useRunStuckDetection({ threadId, stuckThresholdMs = DEFAULT_STUCK_THRESHOLD_MS, backgroundStuckThresholdMs = DEFAULT_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
@@ -44,10 +45,17 @@ export function useRunStuckDetection({ threadId, stuckThresholdMs = DEFAULT_STUC
                     const stuckSinceMs = lastProgressAt != null ? nowMs - lastProgressAt : null;
                     const heartbeatAt = data.heartbeatAt ?? null;
                     const heartbeatSinceMs = heartbeatAt != null ? nowMs - heartbeatAt : null;
+                    const dispatchMode = typeof data.dispatchMode === "string" ? data.dispatchMode : null;
+                    // Background-dispatched runs get the wider threshold: the server's
+                    // own recovery (150s no-progress backstop + chained continuations)
+                    // must get its chance before the user sees a "stuck" affordance.
+                    const effectiveThresholdMs = dispatchMode?.startsWith("background")
+                        ? backgroundStuckThresholdMs
+                        : stuckThresholdMs;
                     const isStuck = Boolean(data.active &&
                         data.status === "running" &&
                         stuckSinceMs != null &&
-                        stuckSinceMs > stuckThresholdMs);
+                        stuckSinceMs > effectiveThresholdMs);
                     setState({
                         isStuck,
                         runId: data.runId ?? null,
@@ -56,7 +64,7 @@ export function useRunStuckDetection({ threadId, stuckThresholdMs = DEFAULT_STUC
                         stuckSinceMs,
                         heartbeatAt,
                         heartbeatSinceMs,
-                        dispatchMode: typeof data.dispatchMode === "string" ? data.dispatchMode : null,
+                        dispatchMode,
                     });
                     // Back off polling when nothing is in flight — there's no point
                     // hammering the endpoint while the chat is idle. We still poll
@@ -82,7 +90,13 @@ export function useRunStuckDetection({ threadId, stuckThresholdMs = DEFAULT_STUC
             if (timer)
                 clearTimeout(timer);
         };
-    }, [threadId, stuckThresholdMs, pollIntervalMs, apiUrl]);
+    }, [
+        threadId,
+        stuckThresholdMs,
+        backgroundStuckThresholdMs,
+        pollIntervalMs,
+        apiUrl,
+    ]);
     return state;
 }
 /**

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, e.g. foreground 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   * Threshold above which an in-flight run is considered stuck. The default\n   * sits comfortably above the adapter's 75s no-progress reconnect — by then\n   * automatic recovery has already had its chance.\n   */\n  stuckThresholdMs?: 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;\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  stuckThresholdMs = DEFAULT_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) 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 isStuck = Boolean(\n            data.active &&\n            data.status === \"running\" &&\n            stuckSinceMs != null &&\n            stuckSinceMs > stuckThresholdMs,\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              typeof data.dispatchMode === \"string\" ? data.dispatchMode : 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  }, [threadId, stuckThresholdMs, pollIntervalMs, apiUrl]);\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, e.g. foreground 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   * 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  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) 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          // Background-dispatched runs get the wider threshold: the server's\n          // own recovery (150s no-progress backstop + chained continuations)\n          // must get its chance before the user sees a \"stuck\" affordance.\n          const effectiveThresholdMs = dispatchMode?.startsWith(\"background\")\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    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"]}

package/dist/collab/awareness.d.ts

@@ -49,11 +49,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
@@ -64,10 +64,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;AAS3C,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;CAChB;AAKD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;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,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAUN;AAKD,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;AAUD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;kBAuCa,MAAM;eAAS,MAAM;;;GAa1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;kBAWM,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;AAS3C,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;CAChB;AAKD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;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,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAUN;AAKD,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;AAUD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;;kBAuCa,MAAM;eAAS,MAAM;;GAa1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;kBAWM,MAAM;kBAAY,MAAM;;GAMvD,CAAC"}

package/dist/collab/routes.d.ts

@@ -41,9 +41,9 @@ export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import
  * Body: { text: string, fieldName?: string, requestSource?: string }
  */
 export declare const postCollabText: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    text?: undefined;
     ok?: undefined;
     error: string;
-    text?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/db/runtime-diagnostics.d.ts

@@ -0,0 +1,52 @@
+import { type DbExec, type Dialect } from "./client.js";
+export interface DatabaseRuntimeFingerprint {
+    configured: boolean;
+    source: string;
+    dialect: Dialect;
+    urlHash?: string;
+    protocol?: string;
+    host?: string;
+    database?: string;
+    appName?: string;
+    authTokenConfigured: boolean;
+    netlifyDatabaseUrlConfigured: boolean;
+    neon?: {
+        endpointId?: string;
+        pooled: boolean;
+        projectHost?: string;
+    };
+}
+export interface RuntimeDebugFingerprint {
+    app: string;
+    environment: string;
+    deployContext?: string;
+    deployId?: string;
+    commitRef?: string;
+    branch?: string;
+    siteName?: string;
+    database: DatabaseRuntimeFingerprint;
+}
+export interface RequiredSchemaTable {
+    table: string;
+    columns: string[];
+}
+export interface DatabaseSchemaHealthResult {
+    ok: boolean;
+    checked: boolean;
+    dialect: Dialect;
+    missingTables: string[];
+    missingColumns: Array<{
+        table: string;
+        column: string;
+    }>;
+    error?: string;
+}
+export declare function getDatabaseRuntimeFingerprint(): DatabaseRuntimeFingerprint;
+export declare function getRuntimeDebugFingerprint(): RuntimeDebugFingerprint;
+export declare function runDatabaseSchemaHealthCheck(options?: {
+    exec?: DbExec;
+    dialect?: Dialect;
+    required?: RequiredSchemaTable[];
+}): Promise<DatabaseSchemaHealthResult>;
+export declare function formatRuntimeDebugFingerprint(fingerprint?: RuntimeDebugFingerprint): string;
+//# sourceMappingURL=runtime-diagnostics.d.ts.map

package/dist/db/runtime-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-diagnostics.d.ts","sourceRoot":"","sources":["../../src/db/runtime-diagnostics.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,4BAA4B,EAAE,OAAO,CAAC;IACtC,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,OAAO,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,0BAA0B,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+HD,wBAAgB,6BAA6B,IAAI,0BAA0B,CAa1E;AAED,wBAAgB,0BAA0B,IAAI,uBAAuB,CAkBpE;AA4CD,wBAAsB,4BAA4B,CAChD,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAC7B,GACL,OAAO,CAAC,0BAA0B,CAAC,CAsCrC;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,GAAE,uBAAsD,GAClE,MAAM,CA2BR"}

package/dist/db/runtime-diagnostics.js

@@ -0,0 +1,250 @@
+import { createHash } from "node:crypto";
+import { getDatabaseUrl, getDialect, getDbExec, } from "./client.js";
+const DEFAULT_REQUIRED_SCHEMA = [
+    {
+        table: "agent_runs",
+        columns: [
+            "id",
+            "thread_id",
+            "status",
+            "started_at",
+            "completed_at",
+            "heartbeat_at",
+            "last_progress_at",
+            "turn_id",
+            "error_code",
+            "error_detail",
+            "terminal_reason",
+            "dispatch_mode",
+            "diag_stage",
+            "worker_stage",
+        ],
+    },
+    {
+        table: "agent_run_events",
+        columns: ["run_id", "seq", "event_at", "event_data"],
+    },
+    {
+        table: "agent_tool_ledger",
+        columns: ["thread_id", "tool_key", "result_summary", "completed_at"],
+    },
+    {
+        table: "chat_threads",
+        columns: [
+            "id",
+            "owner_email",
+            "title",
+            "preview",
+            "thread_data",
+            "message_count",
+            "created_at",
+            "updated_at",
+            "scope_type",
+            "scope_id",
+            "scope_label",
+            "pinned_at",
+            "archived_at",
+        ],
+    },
+    {
+        table: "settings",
+        columns: ["key", "value", "updated_at"],
+    },
+    {
+        table: "application_state",
+        columns: ["session_id", "key", "value", "updated_at"],
+    },
+];
+function envValue(key) {
+    const value = process.env[key]?.trim();
+    return value || undefined;
+}
+function appEnvPrefix() {
+    return envValue("APP_NAME")?.toUpperCase().replace(/-/g, "_");
+}
+function databaseUrlSource() {
+    const appName = appEnvPrefix();
+    if (appName && envValue(`${appName}_DATABASE_URL`)) {
+        return `${appName}_DATABASE_URL`;
+    }
+    if (envValue("DATABASE_URL"))
+        return "DATABASE_URL";
+    if (envValue("NETLIFY_DATABASE_URL"))
+        return "NETLIFY_DATABASE_URL";
+    return "default";
+}
+function databaseAuthTokenConfigured() {
+    const appName = appEnvPrefix();
+    return Boolean((appName && envValue(`${appName}_DATABASE_AUTH_TOKEN`)) ||
+        envValue("DATABASE_AUTH_TOKEN") ||
+        envValue("NETLIFY_DATABASE_AUTH_TOKEN"));
+}
+function shortHash(value) {
+    if (!value)
+        return undefined;
+    return createHash("sha256").update(value).digest("hex").slice(0, 12);
+}
+function parseDatabaseUrl(url) {
+    if (!url)
+        return {};
+    if (url.startsWith("pglite:")) {
+        return { protocol: "pglite", database: url.slice("pglite:".length) };
+    }
+    if (url.startsWith("file:")) {
+        return { protocol: "file", database: url.slice("file:".length) };
+    }
+    if (!/^[a-z][a-z0-9+.-]*:\/\//i.test(url)) {
+        return { protocol: "sqlite", database: url };
+    }
+    try {
+        const parsed = new URL(url);
+        const host = parsed.hostname || undefined;
+        const neonMatch = host?.match(/^(ep-[a-z0-9-]+?)(-pooler)?\.(.+)$/i);
+        const isNeon = Boolean(host?.endsWith(".neon.tech") && neonMatch);
+        return {
+            protocol: parsed.protocol.replace(/:$/, ""),
+            host,
+            database: parsed.pathname.replace(/^\//, "") || undefined,
+            ...(isNeon
+                ? {
+                    neon: {
+                        endpointId: neonMatch?.[1],
+                        pooled: Boolean(neonMatch?.[2]),
+                        projectHost: neonMatch?.[3],
+                    },
+                }
+                : {}),
+        };
+    }
+    catch {
+        return {};
+    }
+}
+export function getDatabaseRuntimeFingerprint() {
+    const url = getDatabaseUrl();
+    const parsed = parseDatabaseUrl(url);
+    return {
+        configured: Boolean(url),
+        source: databaseUrlSource(),
+        dialect: getDialect(),
+        urlHash: shortHash(url),
+        appName: envValue("APP_NAME"),
+        authTokenConfigured: databaseAuthTokenConfigured(),
+        netlifyDatabaseUrlConfigured: Boolean(envValue("NETLIFY_DATABASE_URL")),
+        ...parsed,
+    };
+}
+export function getRuntimeDebugFingerprint() {
+    return {
+        app: envValue("APP_NAME") ?? "unknown",
+        environment: envValue("NODE_ENV") ?? "unknown",
+        deployContext: envValue("CONTEXT") ?? envValue("VERCEL_ENV"),
+        deployId: envValue("DEPLOY_ID") ?? envValue("VERCEL_DEPLOYMENT_ID"),
+        commitRef: envValue("COMMIT_REF") ??
+            envValue("NETLIFY_COMMIT_REF") ??
+            envValue("VERCEL_GIT_COMMIT_SHA") ??
+            envValue("GIT_COMMIT_SHA"),
+        branch: envValue("BRANCH") ??
+            envValue("HEAD") ??
+            envValue("VERCEL_GIT_COMMIT_REF"),
+        siteName: envValue("SITE_NAME") ?? envValue("NETLIFY_SITE_NAME"),
+        database: getDatabaseRuntimeFingerprint(),
+    };
+}
+function assertSafeIdentifier(value) {
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(value)) {
+        throw new Error(`Unsafe schema identifier: ${value}`);
+    }
+}
+async function postgresTableColumns(exec, table) {
+    const result = await exec.execute({
+        sql: `SELECT column_name FROM information_schema.columns WHERE table_schema = 'public' AND table_name = ?`,
+        args: [table],
+    });
+    if (!result.rows.length)
+        return null;
+    return new Set(result.rows.map((row) => String(row.column_name)));
+}
+async function sqliteTableColumns(exec, table) {
+    assertSafeIdentifier(table);
+    const exists = await exec.execute({
+        sql: `SELECT name FROM sqlite_master WHERE type = 'table' AND name = ? LIMIT 1`,
+        args: [table],
+    });
+    if (!exists.rows.length)
+        return null;
+    const result = await exec.execute(`PRAGMA table_info(${table})`);
+    return new Set(result.rows.map((row) => String(row.name)));
+}
+async function tableColumns(exec, dialect, table) {
+    return dialect === "postgres"
+        ? postgresTableColumns(exec, table)
+        : sqliteTableColumns(exec, table);
+}
+export async function runDatabaseSchemaHealthCheck(options = {}) {
+    const dialect = options.dialect ?? getDialect();
+    const exec = options.exec ?? getDbExec();
+    const required = options.required ?? DEFAULT_REQUIRED_SCHEMA;
+    const missingTables = [];
+    const missingColumns = [];
+    try {
+        for (const requirement of required) {
+            const columns = await tableColumns(exec, dialect, requirement.table);
+            if (!columns) {
+                missingTables.push(requirement.table);
+                continue;
+            }
+            for (const column of requirement.columns) {
+                if (!columns.has(column)) {
+                    missingColumns.push({ table: requirement.table, column });
+                }
+            }
+        }
+    }
+    catch (err) {
+        return {
+            ok: false,
+            checked: false,
+            dialect,
+            missingTables,
+            missingColumns,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    return {
+        ok: missingTables.length === 0 && missingColumns.length === 0,
+        checked: true,
+        dialect,
+        missingTables,
+        missingColumns,
+    };
+}
+export function formatRuntimeDebugFingerprint(fingerprint = getRuntimeDebugFingerprint()) {
+    const db = fingerprint.database;
+    return [
+        `app: ${fingerprint.app}`,
+        `environment: ${fingerprint.environment}`,
+        fingerprint.deployContext
+            ? `deploy_context: ${fingerprint.deployContext}`
+            : "",
+        fingerprint.deployId ? `deploy_id: ${fingerprint.deployId}` : "",
+        fingerprint.commitRef ? `commit_ref: ${fingerprint.commitRef}` : "",
+        fingerprint.branch ? `branch: ${fingerprint.branch}` : "",
+        fingerprint.siteName ? `site_name: ${fingerprint.siteName}` : "",
+        `db_configured: ${db.configured}`,
+        `db_source: ${db.source}`,
+        `db_dialect: ${db.dialect}`,
+        db.protocol ? `db_protocol: ${db.protocol}` : "",
+        db.host ? `db_host: ${db.host}` : "",
+        db.database ? `db_database: ${db.database}` : "",
+        db.urlHash ? `db_url_hash: ${db.urlHash}` : "",
+        db.neon?.endpointId ? `db_neon_endpoint: ${db.neon.endpointId}` : "",
+        db.neon ? `db_neon_pooled: ${db.neon.pooled}` : "",
+        db.neon?.projectHost ? `db_neon_project_host: ${db.neon.projectHost}` : "",
+        `db_auth_token_configured: ${db.authTokenConfigured}`,
+        `netlify_database_url_configured: ${db.netlifyDatabaseUrlConfigured}`,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+//# sourceMappingURL=runtime-diagnostics.js.map

package/dist/db/runtime-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-diagnostics.js","sourceRoot":"","sources":["../../src/db/runtime-diagnostics.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport {\n  getDatabaseUrl,\n  getDialect,\n  getDbExec,\n  type DbExec,\n  type Dialect,\n} from \"./client.js\";\n\nexport interface DatabaseRuntimeFingerprint {\n  configured: boolean;\n  source: string;\n  dialect: Dialect;\n  urlHash?: string;\n  protocol?: string;\n  host?: string;\n  database?: string;\n  appName?: string;\n  authTokenConfigured: boolean;\n  netlifyDatabaseUrlConfigured: boolean;\n  neon?: {\n    endpointId?: string;\n    pooled: boolean;\n    projectHost?: string;\n  };\n}\n\nexport interface RuntimeDebugFingerprint {\n  app: string;\n  environment: string;\n  deployContext?: string;\n  deployId?: string;\n  commitRef?: string;\n  branch?: string;\n  siteName?: string;\n  database: DatabaseRuntimeFingerprint;\n}\n\nexport interface RequiredSchemaTable {\n  table: string;\n  columns: string[];\n}\n\nexport interface DatabaseSchemaHealthResult {\n  ok: boolean;\n  checked: boolean;\n  dialect: Dialect;\n  missingTables: string[];\n  missingColumns: Array<{ table: string; column: string }>;\n  error?: string;\n}\n\nconst DEFAULT_REQUIRED_SCHEMA: RequiredSchemaTable[] = [\n  {\n    table: \"agent_runs\",\n    columns: [\n      \"id\",\n      \"thread_id\",\n      \"status\",\n      \"started_at\",\n      \"completed_at\",\n      \"heartbeat_at\",\n      \"last_progress_at\",\n      \"turn_id\",\n      \"error_code\",\n      \"error_detail\",\n      \"terminal_reason\",\n      \"dispatch_mode\",\n      \"diag_stage\",\n      \"worker_stage\",\n    ],\n  },\n  {\n    table: \"agent_run_events\",\n    columns: [\"run_id\", \"seq\", \"event_at\", \"event_data\"],\n  },\n  {\n    table: \"agent_tool_ledger\",\n    columns: [\"thread_id\", \"tool_key\", \"result_summary\", \"completed_at\"],\n  },\n  {\n    table: \"chat_threads\",\n    columns: [\n      \"id\",\n      \"owner_email\",\n      \"title\",\n      \"preview\",\n      \"thread_data\",\n      \"message_count\",\n      \"created_at\",\n      \"updated_at\",\n      \"scope_type\",\n      \"scope_id\",\n      \"scope_label\",\n      \"pinned_at\",\n      \"archived_at\",\n    ],\n  },\n  {\n    table: \"settings\",\n    columns: [\"key\", \"value\", \"updated_at\"],\n  },\n  {\n    table: \"application_state\",\n    columns: [\"session_id\", \"key\", \"value\", \"updated_at\"],\n  },\n];\n\nfunction envValue(key: string): string | undefined {\n  const value = process.env[key]?.trim();\n  return value || undefined;\n}\n\nfunction appEnvPrefix(): string | undefined {\n  return envValue(\"APP_NAME\")?.toUpperCase().replace(/-/g, \"_\");\n}\n\nfunction databaseUrlSource(): string {\n  const appName = appEnvPrefix();\n  if (appName && envValue(`${appName}_DATABASE_URL`)) {\n    return `${appName}_DATABASE_URL`;\n  }\n  if (envValue(\"DATABASE_URL\")) return \"DATABASE_URL\";\n  if (envValue(\"NETLIFY_DATABASE_URL\")) return \"NETLIFY_DATABASE_URL\";\n  return \"default\";\n}\n\nfunction databaseAuthTokenConfigured(): boolean {\n  const appName = appEnvPrefix();\n  return Boolean(\n    (appName && envValue(`${appName}_DATABASE_AUTH_TOKEN`)) ||\n    envValue(\"DATABASE_AUTH_TOKEN\") ||\n    envValue(\"NETLIFY_DATABASE_AUTH_TOKEN\"),\n  );\n}\n\nfunction shortHash(value: string): string | undefined {\n  if (!value) return undefined;\n  return createHash(\"sha256\").update(value).digest(\"hex\").slice(0, 12);\n}\n\nfunction parseDatabaseUrl(url: string): Partial<DatabaseRuntimeFingerprint> {\n  if (!url) return {};\n  if (url.startsWith(\"pglite:\")) {\n    return { protocol: \"pglite\", database: url.slice(\"pglite:\".length) };\n  }\n  if (url.startsWith(\"file:\")) {\n    return { protocol: \"file\", database: url.slice(\"file:\".length) };\n  }\n  if (!/^[a-z][a-z0-9+.-]*:\\/\\//i.test(url)) {\n    return { protocol: \"sqlite\", database: url };\n  }\n\n  try {\n    const parsed = new URL(url);\n    const host = parsed.hostname || undefined;\n    const neonMatch = host?.match(/^(ep-[a-z0-9-]+?)(-pooler)?\\.(.+)$/i);\n    const isNeon = Boolean(host?.endsWith(\".neon.tech\") && neonMatch);\n    return {\n      protocol: parsed.protocol.replace(/:$/, \"\"),\n      host,\n      database: parsed.pathname.replace(/^\\//, \"\") || undefined,\n      ...(isNeon\n        ? {\n            neon: {\n              endpointId: neonMatch?.[1],\n              pooled: Boolean(neonMatch?.[2]),\n              projectHost: neonMatch?.[3],\n            },\n          }\n        : {}),\n    };\n  } catch {\n    return {};\n  }\n}\n\nexport function getDatabaseRuntimeFingerprint(): DatabaseRuntimeFingerprint {\n  const url = getDatabaseUrl();\n  const parsed = parseDatabaseUrl(url);\n  return {\n    configured: Boolean(url),\n    source: databaseUrlSource(),\n    dialect: getDialect(),\n    urlHash: shortHash(url),\n    appName: envValue(\"APP_NAME\"),\n    authTokenConfigured: databaseAuthTokenConfigured(),\n    netlifyDatabaseUrlConfigured: Boolean(envValue(\"NETLIFY_DATABASE_URL\")),\n    ...parsed,\n  };\n}\n\nexport function getRuntimeDebugFingerprint(): RuntimeDebugFingerprint {\n  return {\n    app: envValue(\"APP_NAME\") ?? \"unknown\",\n    environment: envValue(\"NODE_ENV\") ?? \"unknown\",\n    deployContext: envValue(\"CONTEXT\") ?? envValue(\"VERCEL_ENV\"),\n    deployId: envValue(\"DEPLOY_ID\") ?? envValue(\"VERCEL_DEPLOYMENT_ID\"),\n    commitRef:\n      envValue(\"COMMIT_REF\") ??\n      envValue(\"NETLIFY_COMMIT_REF\") ??\n      envValue(\"VERCEL_GIT_COMMIT_SHA\") ??\n      envValue(\"GIT_COMMIT_SHA\"),\n    branch:\n      envValue(\"BRANCH\") ??\n      envValue(\"HEAD\") ??\n      envValue(\"VERCEL_GIT_COMMIT_REF\"),\n    siteName: envValue(\"SITE_NAME\") ?? envValue(\"NETLIFY_SITE_NAME\"),\n    database: getDatabaseRuntimeFingerprint(),\n  };\n}\n\nfunction assertSafeIdentifier(value: string): void {\n  if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(value)) {\n    throw new Error(`Unsafe schema identifier: ${value}`);\n  }\n}\n\nasync function postgresTableColumns(\n  exec: DbExec,\n  table: string,\n): Promise<Set<string> | null> {\n  const result = await exec.execute({\n    sql: `SELECT column_name FROM information_schema.columns WHERE table_schema = 'public' AND table_name = ?`,\n    args: [table],\n  });\n  if (!result.rows.length) return null;\n  return new Set(result.rows.map((row) => String(row.column_name)));\n}\n\nasync function sqliteTableColumns(\n  exec: DbExec,\n  table: string,\n): Promise<Set<string> | null> {\n  assertSafeIdentifier(table);\n  const exists = await exec.execute({\n    sql: `SELECT name FROM sqlite_master WHERE type = 'table' AND name = ? LIMIT 1`,\n    args: [table],\n  });\n  if (!exists.rows.length) return null;\n  const result = await exec.execute(`PRAGMA table_info(${table})`);\n  return new Set(result.rows.map((row) => String(row.name)));\n}\n\nasync function tableColumns(\n  exec: DbExec,\n  dialect: Dialect,\n  table: string,\n): Promise<Set<string> | null> {\n  return dialect === \"postgres\"\n    ? postgresTableColumns(exec, table)\n    : sqliteTableColumns(exec, table);\n}\n\nexport async function runDatabaseSchemaHealthCheck(\n  options: {\n    exec?: DbExec;\n    dialect?: Dialect;\n    required?: RequiredSchemaTable[];\n  } = {},\n): Promise<DatabaseSchemaHealthResult> {\n  const dialect = options.dialect ?? getDialect();\n  const exec = options.exec ?? getDbExec();\n  const required = options.required ?? DEFAULT_REQUIRED_SCHEMA;\n  const missingTables: string[] = [];\n  const missingColumns: Array<{ table: string; column: string }> = [];\n\n  try {\n    for (const requirement of required) {\n      const columns = await tableColumns(exec, dialect, requirement.table);\n      if (!columns) {\n        missingTables.push(requirement.table);\n        continue;\n      }\n      for (const column of requirement.columns) {\n        if (!columns.has(column)) {\n          missingColumns.push({ table: requirement.table, column });\n        }\n      }\n    }\n  } catch (err) {\n    return {\n      ok: false,\n      checked: false,\n      dialect,\n      missingTables,\n      missingColumns,\n      error: err instanceof Error ? err.message : String(err),\n    };\n  }\n\n  return {\n    ok: missingTables.length === 0 && missingColumns.length === 0,\n    checked: true,\n    dialect,\n    missingTables,\n    missingColumns,\n  };\n}\n\nexport function formatRuntimeDebugFingerprint(\n  fingerprint: RuntimeDebugFingerprint = getRuntimeDebugFingerprint(),\n): string {\n  const db = fingerprint.database;\n  return [\n    `app: ${fingerprint.app}`,\n    `environment: ${fingerprint.environment}`,\n    fingerprint.deployContext\n      ? `deploy_context: ${fingerprint.deployContext}`\n      : \"\",\n    fingerprint.deployId ? `deploy_id: ${fingerprint.deployId}` : \"\",\n    fingerprint.commitRef ? `commit_ref: ${fingerprint.commitRef}` : \"\",\n    fingerprint.branch ? `branch: ${fingerprint.branch}` : \"\",\n    fingerprint.siteName ? `site_name: ${fingerprint.siteName}` : \"\",\n    `db_configured: ${db.configured}`,\n    `db_source: ${db.source}`,\n    `db_dialect: ${db.dialect}`,\n    db.protocol ? `db_protocol: ${db.protocol}` : \"\",\n    db.host ? `db_host: ${db.host}` : \"\",\n    db.database ? `db_database: ${db.database}` : \"\",\n    db.urlHash ? `db_url_hash: ${db.urlHash}` : \"\",\n    db.neon?.endpointId ? `db_neon_endpoint: ${db.neon.endpointId}` : \"\",\n    db.neon ? `db_neon_pooled: ${db.neon.pooled}` : \"\",\n    db.neon?.projectHost ? `db_neon_project_host: ${db.neon.projectHost}` : \"\",\n    `db_auth_token_configured: ${db.authTokenConfigured}`,\n    `netlify_database_url_configured: ${db.netlifyDatabaseUrlConfigured}`,\n  ]\n    .filter(Boolean)\n    .join(\"\\n\");\n}\n"]}

package/dist/observability/routes.d.ts

@@ -41,28 +41,28 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
-    error?: undefined;
-    ok?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
     id?: undefined;
-} | {
     error?: undefined;
     ok?: undefined;
+} | {
     summary?: undefined;
     spans?: undefined;
     id: string;
-} | {
+    error?: undefined;
     ok?: undefined;
+} | {
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
     error: any;
+    ok?: undefined;
 } | {
-    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
+    error?: undefined;
     ok: boolean;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/provider-api/corpus-jobs.d.ts

@@ -73,7 +73,6 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
     offset?: unknown;
     limit?: unknown;
 }, {
-    deleted?: undefined;
     jobs: {
         id: string;
         name: string;
@@ -84,6 +83,7 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
         updatedAt: string;
     }[];
     total: number;
+    deleted?: undefined;
     jobId?: undefined;
 } | {
     jobs?: undefined;
@@ -91,9 +91,9 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
     deleted: boolean;
     jobId: string;
 } | {
-    deleted?: undefined;
     jobs?: undefined;
     total?: undefined;
+    deleted?: undefined;
     jobId?: undefined;
     hits: Record<string, unknown>[];
     offset: number;

package/dist/resources/handlers.d.ts

@@ -52,8 +52,8 @@ export declare function handleDeleteResource(event: any): Promise<{
     error: string;
     ok?: undefined;
 } | {
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>;
 /** POST /_agent-native/resources/upload — upload a file as a resource */
 export declare function handleUploadResource(event: any): Promise<import("./store.js").Resource | {
@@ -73,9 +73,9 @@ export declare function handleUploadResource(event: any): Promise<import("./stor
     runId: string | null;
     expiresAt: number | null;
     metadata: string | null;
+    error?: undefined;
     url: string;
     provider: string;
-    error?: undefined;
 }>;
 export {};
 //# sourceMappingURL=handlers.d.ts.map