@agent-native/core 0.97.0 → 0.98.1

package/dist/client/use-agent-engine-configured.js

@@ -3,6 +3,7 @@ import { PROVIDER_ENV_VARS } from "../agent/engine/provider-env-vars.js";
 import { agentNativePath } from "./api-path.js";
 const PROVIDER_ENV_VAR_SET = new Set(PROVIDER_ENV_VARS);
 const DEFAULT_STATUS_CHECK_TIMEOUT_MS = 2500;
+const UNKNOWN_STATUS_RETRY_MS = 2000;
 async function fetchStatusJson(path, timeoutMs) {
     const controller = typeof AbortController !== "undefined" ? new AbortController() : null;
     let timeoutId;
@@ -75,9 +76,14 @@ export async function fetchAgentEngineConfiguredState(enabled = true, options) {
         (engineStatusKnown && engineStatus.configured);
     if (anyConfigured)
         return "configured";
-    return envKeysKnown && builderStatusKnown && engineStatusKnown
-        ? "missing"
-        : "unknown";
+    // The engine status route is the canonical readiness check: it resolves
+    // Builder, scoped BYOK secrets, deployment credentials, and custom engines.
+    // Once it has answered `configured: false`, a slow legacy env/Builder status
+    // request must not leave the composer permissively stuck in `unknown`.
+    if (engineStatusKnown)
+        return "missing";
+    // Compatibility fallback for older hosts without the canonical route.
+    return envKeysKnown && builderStatusKnown ? "missing" : "unknown";
 }
 /**
  * Shared "can the agent run?" gate — the single source of truth for the sidebar
@@ -90,17 +96,23 @@ export function useAgentEngineConfigured(enabled = true, options) {
     const [state, setState] = useState("unknown");
     useEffect(() => {
         let cancelled = false;
+        let retryId;
         // Monotonic call counter: overlapping checks (mount + a
         // `agent-engine:configured-changed` fired right after a key is saved) can
         // resolve out of order; only the latest call may write state, or a slow
         // stale "missing" response would overwrite the fresh "configured" one.
         let requestSeq = 0;
         const check = async (options) => {
+            if (retryId !== undefined) {
+                clearTimeout(retryId);
+                retryId = undefined;
+            }
             const seq = ++requestSeq;
             const nextState = await fetchAgentEngineConfiguredState(enabled, options);
             if (cancelled || seq !== requestSeq)
                 return;
             if (nextState === "unknown") {
+                retryId = setTimeout(() => void check(), UNKNOWN_STATUS_RETRY_MS);
                 return;
             }
             setState(nextState);
@@ -124,6 +136,8 @@ export function useAgentEngineConfigured(enabled = true, options) {
         window.addEventListener("agent-chat:missing-api-key", onMissing);
         return () => {
             cancelled = true;
+            if (retryId !== undefined)
+                clearTimeout(retryId);
             window.removeEventListener("agent-engine:configured-changed", onConfiguredChanged);
             window.removeEventListener("agent-chat:missing-api-key", onMissing);
         };

package/dist/client/use-agent-engine-configured.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-agent-engine-configured.js","sourceRoot":"","sources":["../../src/client/use-agent-engine-configured.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useState } from \"react\";\n\nimport { PROVIDER_ENV_VARS } from \"../agent/engine/provider-env-vars.js\";\nimport { agentNativePath } from \"./api-path.js\";\n\nconst PROVIDER_ENV_VAR_SET = new Set(PROVIDER_ENV_VARS);\n\n/** `unknown` until the first check resolves, so callers don't flash the gate. */\nexport type AgentEngineConfiguredState = \"unknown\" | \"configured\" | \"missing\";\n\nexport interface UseAgentEngineConfiguredResult {\n  /** True once we know nothing can run the agent (no key / Builder / BYOK). */\n  missing: boolean;\n  state: AgentEngineConfiguredState;\n}\n\nexport interface FetchAgentEngineConfiguredStateOptions {\n  /**\n   * Legacy hint from explicit missing-key stream events. Kept for API\n   * compatibility, but missing state still requires authoritative status\n   * responses so transient endpoint failures do not clobber connected state.\n   */\n  missingFallback?: boolean;\n  timeoutMs?: number;\n}\n\nexport interface UseAgentEngineConfiguredOptions {\n  tabId?: string | null;\n  threadId?: string | null;\n}\n\nconst DEFAULT_STATUS_CHECK_TIMEOUT_MS = 2500;\n\nasync function fetchStatusJson(\n  path: string,\n  timeoutMs: number,\n): Promise<unknown | null> {\n  const controller =\n    typeof AbortController !== \"undefined\" ? new AbortController() : null;\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<null>((resolve) => {\n    timeoutId = setTimeout(() => {\n      controller?.abort();\n      resolve(null);\n    }, timeoutMs);\n  });\n\n  // Never serve a stale status from the HTTP cache: this is re-fetched right\n  // after a provider connects, and a cached \"missing\" would keep the composer\n  // gate and error banner pinned even though a provider is now configured.\n  const request = fetch(agentNativePath(path), {\n    cache: \"no-store\",\n    ...(controller ? { signal: controller.signal } : {}),\n  })\n    .then((r) => (r.ok ? r.json() : null))\n    .catch(() => null)\n    .finally(() => {\n      if (timeoutId !== undefined) clearTimeout(timeoutId);\n    });\n\n  return Promise.race([request, timeout]);\n}\n\nfunction hasConfiguredFlag(value: unknown): value is { configured: boolean } {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"configured\" in value &&\n    typeof (value as { configured?: unknown }).configured === \"boolean\"\n  );\n}\n\nfunction missingKeyEventMatchesScope(\n  event: Event,\n  options: UseAgentEngineConfiguredOptions | undefined,\n): boolean {\n  const detail = (event as CustomEvent).detail as\n    | { tabId?: unknown; threadId?: unknown }\n    | undefined;\n  const eventTabId = typeof detail?.tabId === \"string\" ? detail.tabId : null;\n  const eventThreadId =\n    typeof detail?.threadId === \"string\" ? detail.threadId : null;\n  if (!eventTabId && !eventThreadId) return true;\n\n  const tabId = options?.tabId ?? null;\n  const threadId = options?.threadId ?? null;\n  if (!tabId && !threadId) return true;\n  return (\n    (eventTabId != null && eventTabId === tabId) ||\n    (eventThreadId != null && eventThreadId === threadId)\n  );\n}\n\nexport async function fetchAgentEngineConfiguredState(\n  enabled = true,\n  options?: FetchAgentEngineConfiguredStateOptions,\n): Promise<AgentEngineConfiguredState> {\n  if (!enabled) return \"configured\";\n\n  const timeoutMs =\n    typeof options?.timeoutMs === \"number\" && options.timeoutMs > 0\n      ? options.timeoutMs\n      : DEFAULT_STATUS_CHECK_TIMEOUT_MS;\n  const [envKeys, builderStatus, engineStatus] = await Promise.all([\n    fetchStatusJson(\"/_agent-native/env-status\", timeoutMs),\n    fetchStatusJson(\"/_agent-native/builder/status\", timeoutMs),\n    fetchStatusJson(\"/_agent-native/agent-engine/status\", timeoutMs),\n  ]);\n\n  // All three failed — likely a flaky network; keep the caller in unknown.\n  // Even an explicit missing-key stream event should not pin the composer into\n  // setup without a fresh authoritative status response.\n  if (envKeys == null && builderStatus == null && engineStatus == null) {\n    return \"unknown\";\n  }\n\n  const envKeysKnown = Array.isArray(envKeys);\n  const builderStatusKnown = hasConfiguredFlag(builderStatus);\n  const engineStatusKnown = hasConfiguredFlag(engineStatus);\n  const keys = envKeysKnown\n    ? (envKeys as Array<{\n        key: string;\n        configured: boolean;\n      }>)\n    : [];\n  const llmKeys = keys.filter((k) => PROVIDER_ENV_VAR_SET.has(k.key));\n  const anyConfigured =\n    llmKeys.some((k) => k.configured) ||\n    (builderStatusKnown && builderStatus.configured) ||\n    (engineStatusKnown && engineStatus.configured);\n  if (anyConfigured) return \"configured\";\n  return envKeysKnown && builderStatusKnown && engineStatusKnown\n    ? \"missing\"\n    : \"unknown\";\n}\n\n/**\n * Shared \"can the agent run?\" gate — the single source of truth for the sidebar\n * composer and app prompt boxes. Checks the env-key / Builder / BYOK status\n * endpoints on mount, re-checks on `agent-engine:configured-changed`, and folds\n * in the adapter's `agent-chat:missing-api-key` signal. Pass `enabled = false`\n * to short-circuit to configured; flaky requests stay `unknown`.\n */\nexport function useAgentEngineConfigured(\n  enabled = true,\n  options?: UseAgentEngineConfiguredOptions,\n): UseAgentEngineConfiguredResult {\n  const [state, setState] = useState<AgentEngineConfiguredState>(\"unknown\");\n\n  useEffect(() => {\n    let cancelled = false;\n    // Monotonic call counter: overlapping checks (mount + a\n    // `agent-engine:configured-changed` fired right after a key is saved) can\n    // resolve out of order; only the latest call may write state, or a slow\n    // stale \"missing\" response would overwrite the fresh \"configured\" one.\n    let requestSeq = 0;\n    const check = async (options?: { missingFallback?: boolean }) => {\n      const seq = ++requestSeq;\n      const nextState = await fetchAgentEngineConfiguredState(enabled, options);\n      if (cancelled || seq !== requestSeq) return;\n      if (nextState === \"unknown\") {\n        return;\n      }\n      setState(nextState);\n    };\n    const onConfiguredChanged = () => {\n      void check();\n    };\n    const onMissing = (event: Event) => {\n      if (!missingKeyEventMatchesScope(event, options)) return;\n      if (!enabled) {\n        setState(\"configured\");\n        return;\n      }\n      void check({ missingFallback: true });\n    };\n\n    void check();\n    window.addEventListener(\n      \"agent-engine:configured-changed\",\n      onConfiguredChanged,\n    );\n    // A stale failed stream can arrive after a reconnect succeeds. Re-check the\n    // current status before pinning the composer in setup.\n    window.addEventListener(\"agent-chat:missing-api-key\", onMissing);\n    return () => {\n      cancelled = true;\n      window.removeEventListener(\n        \"agent-engine:configured-changed\",\n        onConfiguredChanged,\n      );\n      window.removeEventListener(\"agent-chat:missing-api-key\", onMissing);\n    };\n  }, [enabled, options?.tabId, options?.threadId]);\n\n  return { missing: state === \"missing\", state };\n}\n"]}
+{"version":3,"file":"use-agent-engine-configured.js","sourceRoot":"","sources":["../../src/client/use-agent-engine-configured.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC;AA0BxD,MAAM,+BAA+B,GAAG,IAAI,CAAC;AAC7C,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC,KAAK,UAAU,eAAe,CAC5B,IAAY,EACZ,SAAiB;IAEjB,MAAM,UAAU,GACd,OAAO,eAAe,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACxE,IAAI,SAAoD,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC5C,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,UAAU,EAAE,KAAK,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,2EAA2E;IAC3E,4EAA4E;IAC5E,yEAAyE;IACzE,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE;QAC3C,KAAK,EAAE,UAAU;QACjB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC;SACC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACrC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;SACjB,OAAO,CAAC,GAAG,EAAE;QACZ,IAAI,SAAS,KAAK,SAAS;YAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,YAAY,IAAI,KAAK;QACrB,OAAQ,KAAkC,CAAC,UAAU,KAAK,SAAS,CACpE,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,KAAY,EACZ,OAAoD;IAEpD,MAAM,MAAM,GAAI,KAAqB,CAAC,MAEzB,CAAC;IACd,MAAM,UAAU,GAAG,OAAO,MAAM,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,MAAM,aAAa,GACjB,OAAO,MAAM,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,IAAI,CAAC,UAAU,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IAE/C,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC;IAC3C,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,CACL,CAAC,UAAU,IAAI,IAAI,IAAI,UAAU,KAAK,KAAK,CAAC;QAC5C,CAAC,aAAa,IAAI,IAAI,IAAI,aAAa,KAAK,QAAQ,CAAC,CACtD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,OAAO,GAAG,IAAI,EACd,OAAgD;IAEhD,IAAI,CAAC,OAAO;QAAE,OAAO,YAAY,CAAC;IAElC,MAAM,SAAS,GACb,OAAO,OAAO,EAAE,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC;QAC7D,CAAC,CAAC,OAAO,CAAC,SAAS;QACnB,CAAC,CAAC,+BAA+B,CAAC;IACtC,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/D,eAAe,CAAC,2BAA2B,EAAE,SAAS,CAAC;QACvD,eAAe,CAAC,+BAA+B,EAAE,SAAS,CAAC;QAC3D,eAAe,CAAC,oCAAoC,EAAE,SAAS,CAAC;KACjE,CAAC,CAAC;IAEH,yEAAyE;IACzE,6EAA6E;IAC7E,uDAAuD;IACvD,IAAI,OAAO,IAAI,IAAI,IAAI,aAAa,IAAI,IAAI,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAC5D,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,YAAY;QACvB,CAAC,CAAE,OAGE;QACL,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,MAAM,aAAa,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;QACjC,CAAC,kBAAkB,IAAI,aAAa,CAAC,UAAU,CAAC;QAChD,CAAC,iBAAiB,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,aAAa;QAAE,OAAO,YAAY,CAAC;IAEvC,wEAAwE;IACxE,4EAA4E;IAC5E,6EAA6E;IAC7E,uEAAuE;IACvE,IAAI,iBAAiB;QAAE,OAAO,SAAS,CAAC;IAExC,sEAAsE;IACtE,OAAO,YAAY,IAAI,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAO,GAAG,IAAI,EACd,OAAyC;IAEzC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA6B,SAAS,CAAC,CAAC;IAE1E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,OAAkD,CAAC;QACvD,wDAAwD;QACxD,0EAA0E;QAC1E,wEAAwE;QACxE,uEAAuE;QACvE,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,MAAM,KAAK,GAAG,KAAK,EAAE,OAAuC,EAAE,EAAE;YAC9D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO,GAAG,SAAS,CAAC;YACtB,CAAC;YACD,MAAM,GAAG,GAAG,EAAE,UAAU,CAAC;YACzB,MAAM,SAAS,GAAG,MAAM,+BAA+B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,IAAI,SAAS,IAAI,GAAG,KAAK,UAAU;gBAAE,OAAO;YAC5C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE,EAAE,uBAAuB,CAAC,CAAC;gBAClE,OAAO;YACT,CAAC;YACD,QAAQ,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC,CAAC;QACF,MAAM,mBAAmB,GAAG,GAAG,EAAE;YAC/B,KAAK,KAAK,EAAE,CAAC;QACf,CAAC,CAAC;QACF,MAAM,SAAS,GAAG,CAAC,KAAY,EAAE,EAAE;YACjC,IAAI,CAAC,2BAA2B,CAAC,KAAK,EAAE,OAAO,CAAC;gBAAE,OAAO;YACzD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,QAAQ,CAAC,YAAY,CAAC,CAAC;gBACvB,OAAO;YACT,CAAC;YACD,KAAK,KAAK,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC;QAEF,KAAK,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,gBAAgB,CACrB,iCAAiC,EACjC,mBAAmB,CACpB,CAAC;QACF,4EAA4E;QAC5E,uDAAuD;QACvD,MAAM,CAAC,gBAAgB,CAAC,4BAA4B,EAAE,SAAS,CAAC,CAAC;QACjE,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,OAAO,KAAK,SAAS;gBAAE,YAAY,CAAC,OAAO,CAAC,CAAC;YACjD,MAAM,CAAC,mBAAmB,CACxB,iCAAiC,EACjC,mBAAmB,CACpB,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,4BAA4B,EAAE,SAAS,CAAC,CAAC;QACtE,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEjD,OAAO,EAAE,OAAO,EAAE,KAAK,KAAK,SAAS,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC","sourcesContent":["import { useEffect, useState } from \"react\";\n\nimport { PROVIDER_ENV_VARS } from \"../agent/engine/provider-env-vars.js\";\nimport { agentNativePath } from \"./api-path.js\";\n\nconst PROVIDER_ENV_VAR_SET = new Set(PROVIDER_ENV_VARS);\n\n/** `unknown` until the first check resolves, so callers don't flash the gate. */\nexport type AgentEngineConfiguredState = \"unknown\" | \"configured\" | \"missing\";\n\nexport interface UseAgentEngineConfiguredResult {\n  /** True once we know nothing can run the agent (no key / Builder / BYOK). */\n  missing: boolean;\n  state: AgentEngineConfiguredState;\n}\n\nexport interface FetchAgentEngineConfiguredStateOptions {\n  /**\n   * Legacy hint from explicit missing-key stream events. Kept for API\n   * compatibility, but missing state still requires authoritative status\n   * responses so transient endpoint failures do not clobber connected state.\n   */\n  missingFallback?: boolean;\n  timeoutMs?: number;\n}\n\nexport interface UseAgentEngineConfiguredOptions {\n  tabId?: string | null;\n  threadId?: string | null;\n}\n\nconst DEFAULT_STATUS_CHECK_TIMEOUT_MS = 2500;\nconst UNKNOWN_STATUS_RETRY_MS = 2000;\n\nasync function fetchStatusJson(\n  path: string,\n  timeoutMs: number,\n): Promise<unknown | null> {\n  const controller =\n    typeof AbortController !== \"undefined\" ? new AbortController() : null;\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<null>((resolve) => {\n    timeoutId = setTimeout(() => {\n      controller?.abort();\n      resolve(null);\n    }, timeoutMs);\n  });\n\n  // Never serve a stale status from the HTTP cache: this is re-fetched right\n  // after a provider connects, and a cached \"missing\" would keep the composer\n  // gate and error banner pinned even though a provider is now configured.\n  const request = fetch(agentNativePath(path), {\n    cache: \"no-store\",\n    ...(controller ? { signal: controller.signal } : {}),\n  })\n    .then((r) => (r.ok ? r.json() : null))\n    .catch(() => null)\n    .finally(() => {\n      if (timeoutId !== undefined) clearTimeout(timeoutId);\n    });\n\n  return Promise.race([request, timeout]);\n}\n\nfunction hasConfiguredFlag(value: unknown): value is { configured: boolean } {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"configured\" in value &&\n    typeof (value as { configured?: unknown }).configured === \"boolean\"\n  );\n}\n\nfunction missingKeyEventMatchesScope(\n  event: Event,\n  options: UseAgentEngineConfiguredOptions | undefined,\n): boolean {\n  const detail = (event as CustomEvent).detail as\n    | { tabId?: unknown; threadId?: unknown }\n    | undefined;\n  const eventTabId = typeof detail?.tabId === \"string\" ? detail.tabId : null;\n  const eventThreadId =\n    typeof detail?.threadId === \"string\" ? detail.threadId : null;\n  if (!eventTabId && !eventThreadId) return true;\n\n  const tabId = options?.tabId ?? null;\n  const threadId = options?.threadId ?? null;\n  if (!tabId && !threadId) return true;\n  return (\n    (eventTabId != null && eventTabId === tabId) ||\n    (eventThreadId != null && eventThreadId === threadId)\n  );\n}\n\nexport async function fetchAgentEngineConfiguredState(\n  enabled = true,\n  options?: FetchAgentEngineConfiguredStateOptions,\n): Promise<AgentEngineConfiguredState> {\n  if (!enabled) return \"configured\";\n\n  const timeoutMs =\n    typeof options?.timeoutMs === \"number\" && options.timeoutMs > 0\n      ? options.timeoutMs\n      : DEFAULT_STATUS_CHECK_TIMEOUT_MS;\n  const [envKeys, builderStatus, engineStatus] = await Promise.all([\n    fetchStatusJson(\"/_agent-native/env-status\", timeoutMs),\n    fetchStatusJson(\"/_agent-native/builder/status\", timeoutMs),\n    fetchStatusJson(\"/_agent-native/agent-engine/status\", timeoutMs),\n  ]);\n\n  // All three failed — likely a flaky network; keep the caller in unknown.\n  // Even an explicit missing-key stream event should not pin the composer into\n  // setup without a fresh authoritative status response.\n  if (envKeys == null && builderStatus == null && engineStatus == null) {\n    return \"unknown\";\n  }\n\n  const envKeysKnown = Array.isArray(envKeys);\n  const builderStatusKnown = hasConfiguredFlag(builderStatus);\n  const engineStatusKnown = hasConfiguredFlag(engineStatus);\n  const keys = envKeysKnown\n    ? (envKeys as Array<{\n        key: string;\n        configured: boolean;\n      }>)\n    : [];\n  const llmKeys = keys.filter((k) => PROVIDER_ENV_VAR_SET.has(k.key));\n  const anyConfigured =\n    llmKeys.some((k) => k.configured) ||\n    (builderStatusKnown && builderStatus.configured) ||\n    (engineStatusKnown && engineStatus.configured);\n  if (anyConfigured) return \"configured\";\n\n  // The engine status route is the canonical readiness check: it resolves\n  // Builder, scoped BYOK secrets, deployment credentials, and custom engines.\n  // Once it has answered `configured: false`, a slow legacy env/Builder status\n  // request must not leave the composer permissively stuck in `unknown`.\n  if (engineStatusKnown) return \"missing\";\n\n  // Compatibility fallback for older hosts without the canonical route.\n  return envKeysKnown && builderStatusKnown ? \"missing\" : \"unknown\";\n}\n\n/**\n * Shared \"can the agent run?\" gate — the single source of truth for the sidebar\n * composer and app prompt boxes. Checks the env-key / Builder / BYOK status\n * endpoints on mount, re-checks on `agent-engine:configured-changed`, and folds\n * in the adapter's `agent-chat:missing-api-key` signal. Pass `enabled = false`\n * to short-circuit to configured; flaky requests stay `unknown`.\n */\nexport function useAgentEngineConfigured(\n  enabled = true,\n  options?: UseAgentEngineConfiguredOptions,\n): UseAgentEngineConfiguredResult {\n  const [state, setState] = useState<AgentEngineConfiguredState>(\"unknown\");\n\n  useEffect(() => {\n    let cancelled = false;\n    let retryId: ReturnType<typeof setTimeout> | undefined;\n    // Monotonic call counter: overlapping checks (mount + a\n    // `agent-engine:configured-changed` fired right after a key is saved) can\n    // resolve out of order; only the latest call may write state, or a slow\n    // stale \"missing\" response would overwrite the fresh \"configured\" one.\n    let requestSeq = 0;\n    const check = async (options?: { missingFallback?: boolean }) => {\n      if (retryId !== undefined) {\n        clearTimeout(retryId);\n        retryId = undefined;\n      }\n      const seq = ++requestSeq;\n      const nextState = await fetchAgentEngineConfiguredState(enabled, options);\n      if (cancelled || seq !== requestSeq) return;\n      if (nextState === \"unknown\") {\n        retryId = setTimeout(() => void check(), UNKNOWN_STATUS_RETRY_MS);\n        return;\n      }\n      setState(nextState);\n    };\n    const onConfiguredChanged = () => {\n      void check();\n    };\n    const onMissing = (event: Event) => {\n      if (!missingKeyEventMatchesScope(event, options)) return;\n      if (!enabled) {\n        setState(\"configured\");\n        return;\n      }\n      void check({ missingFallback: true });\n    };\n\n    void check();\n    window.addEventListener(\n      \"agent-engine:configured-changed\",\n      onConfiguredChanged,\n    );\n    // A stale failed stream can arrive after a reconnect succeeds. Re-check the\n    // current status before pinning the composer in setup.\n    window.addEventListener(\"agent-chat:missing-api-key\", onMissing);\n    return () => {\n      cancelled = true;\n      if (retryId !== undefined) clearTimeout(retryId);\n      window.removeEventListener(\n        \"agent-engine:configured-changed\",\n        onConfiguredChanged,\n      );\n      window.removeEventListener(\"agent-chat:missing-api-key\", onMissing);\n    };\n  }, [enabled, options?.tabId, options?.threadId]);\n\n  return { missing: state === \"missing\", state };\n}\n"]}

package/dist/client/use-db-sync.d.ts

@@ -5,7 +5,13 @@ interface QueryClient {
     invalidateQueries(opts?: {
         queryKey?: string[];
         predicate?: (query: Query) => boolean;
-    }): void;
+    }, options?: {
+        cancelRefetch?: boolean;
+    }): unknown;
+    isFetching?(filters?: {
+        queryKey?: string[];
+        predicate?: (query: Query) => boolean;
+    }): number;
 }
 export type SyncEvent = {
     version?: number;
@@ -83,7 +89,7 @@ export declare function subscribeSyncEvents(options: SubscribeSyncEventsOptions)
  * @param options.onEvent - Optional callback for each change event
  * @param options.interval - Poll interval in ms. Default: 2000
  * @param options.fallbackInterval - Poll interval while SSE is connected.
- *   Default: 15000
+ *   Default: 60000
  * @param options.pauseWhenHidden - Pause polling while the tab is hidden.
  *   Default: true
  * @param options.ignoreSource - Skip events whose `requestSource` matches this

package/dist/client/use-db-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-db-sync.d.ts","sourceRoot":"","sources":["../../src/client/use-db-sync.ts"],"names":[],"mappings":"AAaA,UAAU,KAAK;IACb,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;CAC9B;AAED,UAAU,WAAW;IACnB,iBAAiB,CAAC,IAAI,CAAC,EAAE;QACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;KACvC,GAAG,IAAI,CAAC;CACV;AAuBD,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB,CAAC;AAkEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAUxE;AAwcD,gBAAgB;AAChB,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D;AAED,MAAM,WAAW,0BAA0B;IACzC,gEAAgE;IAChE,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACrE,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,MAAM,IAAI,CAmBZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,SAAS,CACvB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IACtD,6BAA6B,CAAC,EAAE,MAAM,EAAE,CAAC;CACrC,GACL,IAAI,CA6QN;AAED,wCAAwC;AACxC,eAAO,MAAM,cAAc,kBAAY,CAAC;AAExC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,MAAM,CAiER"}
+{"version":3,"file":"use-db-sync.d.ts","sourceRoot":"","sources":["../../src/client/use-db-sync.ts"],"names":[],"mappings":"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"}

package/dist/client/use-db-sync.js

@@ -1,11 +1,15 @@
 import { useEffect, useRef, useState } from "react";
 import { ensureDemoModeFetchInterceptor, refreshDemoModeFetchInterceptor, } from "../demo/fetch-interceptor.js";
 import { agentNativePath } from "./api-path.js";
+import { getBrowserTabId } from "./browser-tab-id.js";
 import { ensureEmbedAuthFetchInterceptor, isEmbedAuthActive, } from "./embed-auth.js";
 import { bumpChangeVersion } from "./use-change-version.js";
 const POLL_ABORT_MIN_MS = 10_000;
-const SSE_FALLBACK_INTERVAL_MS = 15_000;
-const IDLE_POLL_INTERVAL_MS = 15_000;
+// SSE delivers changes immediately in the normal path. The poll is a
+// cross-process/serverless safety net, so an idle tab should not bill the host
+// four times per minute forever. Focus and active agent work still poll now.
+const SSE_FALLBACK_INTERVAL_MS = 60_000;
+const IDLE_POLL_INTERVAL_MS = 60_000;
 const POLL_AUTH_FAILURE_COOLDOWN_MS = 60_000;
 /**
  * Max cadence for SSE/poll-driven query invalidation in `useDbSync`. Events
@@ -242,7 +246,7 @@ class SyncTransport {
         // above; this covers everything else so a down server isn't hammered at
         // full cadence. Resets on the first successful poll.
         const delay = this.consecutiveFailures > 0
-            ? Math.min(base * 2 ** Math.min(this.consecutiveFailures, 5), 30_000)
+            ? Math.min(base * 2 ** Math.min(this.consecutiveFailures, 5), 300_000)
             : base;
         this.timer = setTimeout(() => {
             this.timer = null;
@@ -512,7 +516,7 @@ export function subscribeSyncEvents(options) {
  * @param options.onEvent - Optional callback for each change event
  * @param options.interval - Poll interval in ms. Default: 2000
  * @param options.fallbackInterval - Poll interval while SSE is connected.
- *   Default: 15000
+ *   Default: 60000
  * @param options.pauseWhenHidden - Pause polling while the tab is hidden.
  *   Default: true
  * @param options.ignoreSource - Skip events whose `requestSource` matches this
@@ -592,9 +596,10 @@ export function useDbSync(options = {}) {
         }
         function invalidateForEvents(events) {
             const ignore = ignoreSourceRef.current;
-            const relevant = ignore
-                ? events.filter((e) => e.requestSource !== ignore)
-                : events;
+            const ownBrowserSource = getBrowserTabId();
+            const relevant = events.filter((event) => !(event.source === "action" &&
+                event.requestSource === ownBrowserSource) &&
+                (!ignore || event.requestSource !== ignore));
             const suppressedActions = new Set(suppressActionInvalidationForRef.current ?? []);
             const isSuppressedActionEvent = (evt) => evt.source === "action" &&
                 typeof evt.key === "string" &&
@@ -625,16 +630,32 @@ export function useDbSync(options = {}) {
             // still reach onEvent below for callers that render presence.
             const invalidating = relevant.filter((e) => e.source !== "awareness");
             if (invalidating.length > 0 && queryClient) {
+                // Sync events describe completed writes. If a matching read is already
+                // in flight, let it finish instead of aborting and immediately
+                // launching the same request again. Repeated action events otherwise
+                // turn a slow endpoint into a cancel/restart loop that never settles.
+                const invalidateWithoutCancel = (filters) => {
+                    const needsTrailingRefresh = (queryClient.isFetching?.(filters) ?? 0) > 0;
+                    const completion = queryClient.invalidateQueries(filters, {
+                        cancelRefetch: false,
+                    });
+                    // TanStack Query deliberately leaves an in-flight fetch alone when
+                    // cancelRefetch is false. Queue one post-settlement invalidation so
+                    // a write that landed after that read began cannot be cleared as
+                    // fresh by the older response.
+                    if (needsTrailingRefresh && completion instanceof Promise) {
+                        void completion.then(() => queryClient.invalidateQueries(filters), () => { });
+                    }
+                };
                 const hasActionEvent = invalidating.some((evt) => evt.source === "action" && !isSuppressedActionEvent(evt));
                 if (hasActionEvent) {
-                    // Custom apps frequently start with raw `useQuery` calls before
-                    // graduating to `useActionQuery` or source-versioned query keys.
-                    // A successful mutating action is the core "agent changed app data"
-                    // signal, so refresh active queries broadly as a compatibility
-                    // safety net. Other event sources stay targeted to avoid request
-                    // storms from noisy domain-specific writes.
+                    // Action-backed reads share the ["action"] prefix. Keep the default
+                    // refresh targeted to those queries; invalidating every active query
+                    // makes one agent write fan out across unrelated provider reads,
+                    // dashboards, and background status checks. Older apps that still
+                    // need broad compatibility can opt in with a predicate.
                     const predicate = actionInvalidatePredicateRef.current;
-                    queryClient.invalidateQueries(predicate ? { predicate } : undefined);
+                    invalidateWithoutCancel(predicate ? { predicate } : { queryKey: ["action"] });
                 }
                 // Framework-level invalidate: a small, fixed list of query-key
                 // prefixes the framework's own hooks/components use (action results,
@@ -662,32 +683,36 @@ export function useDbSync(options = {}) {
                 // turn starved run heartbeat writes and surfaced as `stale_run`.
                 if (!suppressesWholeBatch) {
                     const hasDataChangingEvent = invalidating.some((evt) => evt.source !== "app-state");
-                    // The broad action invalidate above already covers every fixed
-                    // framework prefix. Re-invalidating ["action"] immediately after it
-                    // cancels/restarts the same active reads and creates a duplicate
-                    // request wave. Keep the fixed-prefix pass for non-action sources;
-                    // action batches get exactly one compatibility invalidation.
-                    if (hasDataChangingEvent && !hasActionEvent) {
-                        queryClient.invalidateQueries({ queryKey: ["action"] });
-                        queryClient.invalidateQueries({ queryKey: ["extension"] });
-                        queryClient.invalidateQueries({ queryKey: ["extensions"] });
-                        queryClient.invalidateQueries({ queryKey: ["extension-slots"] });
-                        queryClient.invalidateQueries({ queryKey: ["slot-installs"] });
-                        queryClient.invalidateQueries({ queryKey: ["slot-available"] });
-                        queryClient.invalidateQueries({ queryKey: ["tool"] });
-                        queryClient.invalidateQueries({ queryKey: ["tools"] });
+                    if (hasDataChangingEvent) {
+                        const hasFrameworkPrefixEvent = invalidating.some((evt) => ["extensions", "extension", "tool", "tools", "slots"].includes(evt.source ?? ""));
+                        // The action-specific invalidation above already refreshed
+                        // ["action"]. A mixed action + extension/tool batch still needs
+                        // the independent framework prefixes, while pure action batches
+                        // retain their narrow storm-resistant invalidation.
+                        if (!hasActionEvent) {
+                            invalidateWithoutCancel({ queryKey: ["action"] });
+                        }
+                        if (!hasActionEvent || hasFrameworkPrefixEvent) {
+                            invalidateWithoutCancel({ queryKey: ["extension"] });
+                            invalidateWithoutCancel({ queryKey: ["extensions"] });
+                            invalidateWithoutCancel({ queryKey: ["extension-slots"] });
+                            invalidateWithoutCancel({ queryKey: ["slot-installs"] });
+                            invalidateWithoutCancel({ queryKey: ["slot-available"] });
+                            invalidateWithoutCancel({ queryKey: ["tool"] });
+                            invalidateWithoutCancel({ queryKey: ["tools"] });
+                        }
                     }
                     if (invalidating.some((evt) => evt.source === "app-state")) {
-                        queryClient.invalidateQueries({ queryKey: ["app-state"] });
+                        invalidateWithoutCancel({ queryKey: ["app-state"] });
                     }
                     if (hasAppStateEvent(invalidating, "navigate")) {
-                        queryClient.invalidateQueries({ queryKey: ["navigate-command"] });
+                        invalidateWithoutCancel({ queryKey: ["navigate-command"] });
                     }
                     if (hasAppStateEvent(invalidating, "show-questions")) {
-                        queryClient.invalidateQueries({ queryKey: ["show-questions"] });
+                        invalidateWithoutCancel({ queryKey: ["show-questions"] });
                     }
                     if (hasAppStateEvent(invalidating, "__set_url__")) {
-                        queryClient.invalidateQueries({ queryKey: ["__set_url__"] });
+                        invalidateWithoutCancel({ queryKey: ["__set_url__"] });
                     }
                 }
             }