@agent-native/core 0.93.0 → 0.94.0

package/corpus/core/src/client/settings/DemoModeSection.tsx

@@ -17,6 +17,7 @@ import { useQuery } from "@tanstack/react-query";
 import { useEffect, useState } from "react";
 
 import { agentNativePath } from "../api-path.js";
+import { useChangeVersion } from "../use-change-version.js";
 
 interface DemoStatus {
   enabled?: boolean;
@@ -30,9 +31,10 @@ const DEMO_MODE_WRITE_URL = agentNativePath(
 
 export function DemoModeSection() {
   const [enabled, setEnabled] = useState<boolean | null>(null);
+  const demoModeVersion = useChangeVersion("app-state:demo-mode");
 
   const { data } = useQuery({
-    queryKey: ["agent-native", "demo-mode"],
+    queryKey: ["agent-native", "demo-mode", demoModeVersion],
     queryFn: async () => {
       const res = await fetch(DEMO_STATUS_URL, {
         credentials: "same-origin",
@@ -40,8 +42,7 @@ export function DemoModeSection() {
       if (!res.ok) return null;
       return (await res.json()) as DemoStatus | null;
     },
-    refetchInterval: 4_000,
-    staleTime: 2_000,
+    staleTime: Infinity,
   });
 
   const serverEnabled = data?.enabled;

package/corpus/core/src/client/settings/SettingsPanel.tsx

@@ -3177,6 +3177,7 @@ export function useAgentSettingsTabs(): SettingsTabItem[] {
         id: "agent",
         label: "Agent",
         icon: IconBrain,
+        group: "agent",
         keywords: "agent model llm limits voice automations",
         searchEntries: buildSectionSearchEntries(AGENT_SETTINGS_SECTIONS),
         content: (
@@ -3193,6 +3194,7 @@ export function useAgentSettingsTabs(): SettingsTabItem[] {
         id: "connections",
         label: "Connections",
         icon: IconPlugConnected,
+        group: "agent",
         keywords: "connections secrets integrations email browser usage",
         searchEntries: buildSectionSearchEntries(CONNECTION_SETTINGS_SECTIONS),
         content: (
@@ -3209,6 +3211,7 @@ export function useAgentSettingsTabs(): SettingsTabItem[] {
         id: "organization",
         label: "Organization",
         icon: IconUsersGroup,
+        group: "workspace",
         keywords: "organization org team members invites collaborators",
         content: (
           <div className="mx-auto w-full max-w-2xl">
@@ -3220,6 +3223,7 @@ export function useAgentSettingsTabs(): SettingsTabItem[] {
         id: "workspace",
         label: "Workspace",
         icon: IconCloud,
+        group: "workspace",
         keywords: "workspace account hosting database uploads auth",
         searchEntries: buildSectionSearchEntries(WORKSPACE_SETTINGS_SECTIONS),
         content: (

package/corpus/core/src/client/settings/SettingsTabsPage.tsx

@@ -49,6 +49,12 @@ export interface SettingsTabItem {
   label: string;
   icon?: SettingsTabIcon;
   content: ReactNode;
+  /**
+   * Optional visual navigation group. Adjacent tabs with the same group render
+   * together; a quiet divider separates each group on desktop while mobile
+   * keeps the compact horizontal tab scroller unchanged.
+   */
+  group?: string;
   /** Extra space-separated terms so this tab is findable via search. */
   keywords?: string;
   /** Deep-link entries within this tab for the settings search. */
@@ -78,9 +84,10 @@ export interface SettingsTabsPageProps {
   generalSearchEntries?: SettingsSearchEntry[];
   /**
    * Controlled active tab id. When provided, the parent owns tab state (and is
-   * responsible for URL/app-state sync); the component skips its own hash-based
-   * tab tracking. Leave undefined for the default uncontrolled, hash-driven
-   * behavior.
+   * responsible for URL/app-state sync). Recognized top-level tab hashes still
+   * report through `onValueChange`, so shared links such as
+   * `/settings#organization` can select the matching controlled Team tab.
+   * Leave undefined for the default uncontrolled, hash-driven behavior.
    */
   value?: string;
   /**
@@ -186,6 +193,7 @@ export function SettingsTabsPage({
   const rootRef = useRef<HTMLDivElement | null>(null);
   const searchInputRef = useRef<HTMLInputElement | null>(null);
   const autoFocusedSearchRef = useRef(false);
+  const controlledHashRef = useRef<string | null>(null);
   const tabs = useMemo<SettingsTabItem[]>(() => {
     const hasOrganizationTab = extraTabs.some(
       (tab) => tab.id === "organization",
@@ -205,6 +213,7 @@ export function SettingsTabsPage({
         id: "team",
         label: teamLabel,
         icon: IconUsers,
+        group: "workspace",
         content: team,
       });
     }
@@ -213,6 +222,7 @@ export function SettingsTabsPage({
         id: "whats-new",
         label: whatsNewLabel,
         icon: IconHistory,
+        group: "updates",
         content: whatsNew,
       });
     }
@@ -231,6 +241,21 @@ export function SettingsTabsPage({
   const fallbackTab = tabs.some((tab) => tab.id === defaultTab)
     ? defaultTab
     : (tabs[0]?.id ?? "general");
+  const tabGroups = useMemo(() => {
+    const groups: Array<{ id: string; tabs: SettingsTabItem[] }> = [];
+
+    for (const tab of tabs) {
+      const groupId = tab.group ?? "app";
+      const previousGroup = groups.at(-1);
+      if (previousGroup?.id === groupId) {
+        previousGroup.tabs.push(tab);
+      } else {
+        groups.push({ id: groupId, tabs: [tab] });
+      }
+    }
+
+    return groups;
+  }, [tabs]);
   const isControlled = value !== undefined;
   const [internalTab, setInternalTab] = useState(() =>
     activeTabFromHash(tabs, fallbackTab),
@@ -269,6 +294,23 @@ export function SettingsTabsPage({
     return () => window.removeEventListener("hashchange", handleHashChange);
   }, [isControlled, tabs]);
 
+  useEffect(() => {
+    // Controlled pages retain ownership of their active state, but shared
+    // organization navigation uses a hash deep link. Report only recognized
+    // top-level tab hashes; section hashes remain available to inner panels.
+    if (!isControlled) return;
+    const syncControlledHash = () => {
+      const hash = window.location.hash;
+      const fromHash = resolveTabId(tabs, hash);
+      if (!fromHash || controlledHashRef.current === hash) return;
+      controlledHashRef.current = hash;
+      onValueChange?.(fromHash);
+    };
+    syncControlledHash();
+    window.addEventListener("hashchange", syncControlledHash);
+    return () => window.removeEventListener("hashchange", syncControlledHash);
+  }, [isControlled, onValueChange, tabs, value]);
+
   useEffect(() => {
     if (!enableSearch || autoFocusedSearchRef.current) return;
     if (
@@ -472,40 +514,56 @@ export function SettingsTabsPage({
             role="tablist"
             className="flex gap-1 overflow-x-auto sm:flex-col sm:overflow-x-visible"
           >
-            {tabs.map((tab) => {
-              const Icon = tab.icon;
-              const selected = tab.id === selectedTab?.id;
-              return (
-                <button
-                  key={tab.id}
-                  type="button"
-                  role="tab"
-                  aria-selected={selected}
-                  aria-controls={`settings-tabpanel-${tab.id}`}
-                  id={`settings-tab-${tab.id}`}
-                  onClick={() => {
-                    changeTab(tab.id);
-                    if (!isControlled) updateHashForTab(tab.id);
-                  }}
-                  className={cn(
-                    "flex min-h-9 shrink-0 items-center gap-2 rounded-md px-3 py-2 text-start text-sm font-medium transition-colors sm:w-full",
-                    selected
-                      ? "bg-accent text-foreground"
-                      : "text-muted-foreground hover:bg-accent/50 hover:text-foreground",
-                  )}
-                >
-                  {Icon ? (
-                    <Icon
-                      className={cn(
-                        "size-4 shrink-0",
-                        selected ? "text-foreground" : "text-muted-foreground",
-                      )}
-                    />
-                  ) : null}
-                  <span className="truncate">{tab.label}</span>
-                </button>
-              );
-            })}
+            {tabGroups.map((group, groupIndex) => (
+              <div
+                key={group.id}
+                data-settings-tab-group={group.id}
+                className={cn(
+                  "contents sm:block",
+                  groupIndex > 0 &&
+                    "sm:mt-2 sm:border-t sm:border-border/60 sm:pt-2",
+                )}
+              >
+                <div className="contents sm:flex sm:flex-col sm:gap-1">
+                  {group.tabs.map((tab) => {
+                    const Icon = tab.icon;
+                    const selected = tab.id === selectedTab?.id;
+                    return (
+                      <button
+                        key={tab.id}
+                        type="button"
+                        role="tab"
+                        aria-selected={selected}
+                        aria-controls={`settings-tabpanel-${tab.id}`}
+                        id={`settings-tab-${tab.id}`}
+                        onClick={() => {
+                          changeTab(tab.id);
+                          if (!isControlled) updateHashForTab(tab.id);
+                        }}
+                        className={cn(
+                          "flex min-h-9 shrink-0 items-center gap-2 rounded-md px-3 py-2 text-start text-sm font-medium transition-colors sm:w-full",
+                          selected
+                            ? "bg-accent text-foreground"
+                            : "text-muted-foreground hover:bg-accent/50 hover:text-foreground",
+                        )}
+                      >
+                        {Icon ? (
+                          <Icon
+                            className={cn(
+                              "size-4 shrink-0",
+                              selected
+                                ? "text-foreground"
+                                : "text-muted-foreground",
+                            )}
+                          />
+                        ) : null}
+                        <span className="truncate">{tab.label}</span>
+                      </button>
+                    );
+                  })}
+                </div>
+              </div>
+            ))}
           </nav>
         )}
       </div>

package/corpus/core/src/client/use-chat-models.ts

@@ -2,7 +2,9 @@ import { useCallback, useEffect, useRef, useState } from "react";
 
 import { DEFAULT_MODEL } from "../agent/default-model.js";
 import {
+  DEFAULT_REASONING_EFFORT,
   getReasoningEffortOptionsForModel,
+  resolveReasoningEffortSelection,
   type ReasoningEffort,
 } from "../shared/reasoning-effort.js";
 import { agentNativePath } from "./api-path.js";
@@ -87,7 +89,10 @@ export function useChatModels({
     initialPersisted.engine ?? "",
   );
   const [selectedEffort, setSelectedEffort] = useState<ReasoningEffort>(
-    initialPersisted.effort ?? "auto",
+    resolveReasoningEffortSelection(
+      initialPersisted.model ?? DEFAULT_MODEL,
+      initialPersisted.effort,
+    ),
   );
   const selectionRef = useRef({
     selectedModel,
@@ -110,10 +115,9 @@ export function useChatModels({
       setSelectedModel(model);
       setSelectedEngine(engine);
       setSelectedEffort((prevEffort) => {
-        const next =
-          prevEffort === "auto" || effortOptions.includes(prevEffort)
-            ? prevEffort
-            : "auto";
+        const next = effortOptions.includes(prevEffort)
+          ? prevEffort
+          : DEFAULT_REASONING_EFFORT;
         writePersisted(storageKey, { model, engine, effort: next });
         return next;
       });
@@ -180,12 +184,10 @@ export function useChatModels({
             defaultGroup?.models[0] ??
             nextDefaultModel;
           const nextEngine = defaultGroup?.engine ?? "";
-          const effortOptions = getReasoningEffortOptionsForModel(nextModel);
-          const nextEffort =
-            selection.selectedEffort === "auto" ||
-            effortOptions.includes(selection.selectedEffort)
-              ? selection.selectedEffort
-              : "auto";
+          const nextEffort = resolveReasoningEffortSelection(
+            nextModel,
+            selection.selectedEffort,
+          );
           setSelectedModel(nextModel);
           setSelectedEngine(nextEngine);
           setSelectedEffort(nextEffort);
@@ -207,12 +209,10 @@ export function useChatModels({
             defaultGroup?.models[0] ??
             nextDefaultModel;
           const nextEngine = defaultGroup?.engine ?? "";
-          const effortOptions = getReasoningEffortOptionsForModel(nextModel);
-          const nextEffort =
-            selection.selectedEffort === "auto" ||
-            effortOptions.includes(selection.selectedEffort)
-              ? selection.selectedEffort
-              : "auto";
+          const nextEffort = resolveReasoningEffortSelection(
+            nextModel,
+            selection.selectedEffort,
+          );
           setSelectedModel(nextModel);
           setSelectedEngine(nextEngine);
           setSelectedEffort(nextEffort);

package/corpus/core/src/client/use-db-sync.ts

@@ -1,6 +1,9 @@
 import { useEffect, useRef, useState } from "react";
 
-import { ensureDemoModeFetchInterceptor } from "../demo/fetch-interceptor.js";
+import {
+  ensureDemoModeFetchInterceptor,
+  refreshDemoModeFetchInterceptor,
+} from "../demo/fetch-interceptor.js";
 import { agentNativePath } from "./api-path.js";
 import {
   ensureEmbedAuthFetchInterceptor,
@@ -21,6 +24,7 @@ interface QueryClient {
 
 const POLL_ABORT_MIN_MS = 10_000;
 const SSE_FALLBACK_INTERVAL_MS = 15_000;
+const IDLE_POLL_INTERVAL_MS = 15_000;
 const POLL_AUTH_FAILURE_COOLDOWN_MS = 60_000;
 /**
  * Max cadence for SSE/poll-driven query invalidation in `useDbSync`. Events
@@ -192,6 +196,8 @@ interface TransportSubscription {
    * subscribers so the most-frequent caller is satisfied.
    */
   interval: number;
+  /** Requested poll interval while the tab has no active agent work. */
+  idleInterval: number;
   /** Requested fallback interval while SSE is connected. */
   fallbackInterval: number;
   /**
@@ -213,6 +219,7 @@ class SyncTransport {
   private sseConnected = false;
   private authFailureUntil = 0;
   private consecutiveFailures = 0;
+  private activeChatIds = new Set<string>();
 
   constructor(
     private readonly pollUrl: string,
@@ -225,10 +232,17 @@ class SyncTransport {
 
   add(id: symbol, sub: TransportSubscription): void {
     const wasEmpty = this.subscribers.size === 0;
+    const wasActive = this.isActive;
     this.subscribers.set(id, sub);
     if (wasEmpty) {
       this.stopped = false;
       this.start();
+    } else if (!wasActive && this.isActive) {
+      // A collab surface (or other active subscriber) just joined. Catch up
+      // immediately rather than waiting out an idle-cadence timer.
+      this.pollNow();
+    } else {
+      this.reschedule();
     }
     sub.onSseStateChange?.(this.sseConnected);
   }
@@ -264,6 +278,18 @@ class SyncTransport {
     return isFinite(min) ? min : 2000;
   }
 
+  private get effectiveIdleInterval(): number {
+    let min = Infinity;
+    for (const sub of this.subscribers.values()) {
+      if (sub.idleInterval < min) min = sub.idleInterval;
+    }
+    return isFinite(min) ? min : IDLE_POLL_INTERVAL_MS;
+  }
+
+  private get isActive(): boolean {
+    return this.activeChatIds.size > 0;
+  }
+
   private get effectiveFallbackInterval(): number {
     let min = Infinity;
     for (const sub of this.subscribers.values()) {
@@ -277,6 +303,15 @@ class SyncTransport {
   // -------------------------------------------------------------------------
 
   private fan(events: SyncEvent[], version: number | undefined): void {
+    if (
+      events.some(
+        (event) =>
+          event.source === "app-state" &&
+          (event.key === "demo-mode" || event.key === "*"),
+      )
+    ) {
+      void refreshDemoModeFetchInterceptor();
+    }
     for (const sub of this.subscribers.values()) {
       sub.onEvents(events, version);
     }
@@ -310,9 +345,11 @@ class SyncTransport {
       }, authDelay);
       return;
     }
-    const base = this.sseConnected
-      ? this.effectiveFallbackInterval
-      : this.effectiveInterval;
+    const base = this.isActive
+      ? this.effectiveInterval
+      : this.sseConnected
+        ? this.effectiveFallbackInterval
+        : this.effectiveIdleInterval;
     // Exponential backoff while polls keep failing (500s during a deploy,
     // DNS blips, a struggling DB). Auth failures have their own cooldown
     // above; this covers everything else so a down server isn't hammered at
@@ -461,6 +498,40 @@ class SyncTransport {
     this.pollNow();
   };
 
+  private handleChatRunning = (event: Event): void => {
+    const detail = (
+      event as CustomEvent<{
+        isRunning?: unknown;
+        running?: unknown;
+        tabId?: unknown;
+      }>
+    ).detail;
+    const running =
+      typeof detail?.isRunning === "boolean"
+        ? detail.isRunning
+        : typeof detail?.running === "boolean"
+          ? detail.running
+          : null;
+    if (running === null) return;
+
+    const id =
+      typeof detail?.tabId === "string" && detail.tabId
+        ? detail.tabId
+        : "__default__";
+    const wasActive = this.isActive;
+    if (running) this.activeChatIds.add(id);
+    else this.activeChatIds.delete(id);
+    if (wasActive === this.isActive) return;
+
+    if (this.isActive) {
+      // Run start is a high-signal indication that cross-process writes are
+      // imminent. Catch up now, then stay on the active cadence.
+      this.pollNow();
+    } else {
+      this.reschedule();
+    }
+  };
+
   private start(): void {
     // Universal demo-mode redaction for the UI. Idempotent + browser-only +
     // a no-op until demo mode is on. Lives here because every template root
@@ -473,6 +544,7 @@ class SyncTransport {
       void this.poll();
     }
     window.addEventListener("focus", this.handleFocus);
+    window.addEventListener("agentNative.chatRunning", this.handleChatRunning);
     document.addEventListener("visibilitychange", this.handleVisibilityChange);
   }
 
@@ -484,6 +556,10 @@ class SyncTransport {
       this.timer = null;
     }
     window.removeEventListener("focus", this.handleFocus);
+    window.removeEventListener(
+      "agentNative.chatRunning",
+      this.handleChatRunning,
+    );
     document.removeEventListener(
       "visibilitychange",
       this.handleVisibilityChange,
@@ -568,6 +644,7 @@ export function subscribeSyncEvents(
     onSseStateChange: options.onSseStateChange,
     pauseWhenHidden: options.pauseWhenHidden ?? true,
     interval: options.interval ?? 60_000,
+    idleInterval: options.interval ?? 60_000,
     fallbackInterval: options.fallbackInterval ?? 60_000,
   });
   return () => {
@@ -640,6 +717,8 @@ export function useDbSync(
     ),
     pauseWhenHidden = true,
   } = options;
+  const idleInterval =
+    options.interval === undefined ? IDLE_POLL_INTERVAL_MS : interval;
 
   const onEventRef = useRef(options.onEvent);
   onEventRef.current = options.onEvent;
@@ -742,7 +821,12 @@ export function useDbSync(
       for (const evt of relevant) {
         const src = typeof evt.source === "string" ? evt.source : "";
         const ver = typeof evt.version === "number" ? evt.version : 0;
-        if (src && ver > 0) bumpChangeVersion(src, ver);
+        if (src && ver > 0) {
+          bumpChangeVersion(src, ver);
+          if (typeof evt.key === "string" && evt.key) {
+            bumpChangeVersion(`${src}:${evt.key}`, ver);
+          }
+        }
       }
 
       // Awareness (cursor/presence) events never change action/extension/
@@ -796,7 +880,12 @@ export function useDbSync(
           const hasDataChangingEvent = invalidating.some(
             (evt) => evt.source !== "app-state",
           );
-          if (hasDataChangingEvent) {
+          // 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"] });
@@ -856,6 +945,7 @@ export function useDbSync(
       onEvents,
       pauseWhenHidden,
       interval,
+      idleInterval,
       fallbackInterval,
     });
 
@@ -880,6 +970,7 @@ export function useDbSync(
     sseUrl,
     queryClient,
     interval,
+    idleInterval,
     fallbackInterval,
     pauseWhenHidden,
   ]);
@@ -926,6 +1017,8 @@ export function useScreenRefreshKey(
     ),
     pauseWhenHidden = true,
   } = options;
+  const idleInterval =
+    options.interval === undefined ? IDLE_POLL_INTERVAL_MS : interval;
   const [key, setKey] = useState(0);
 
   useEffect(() => {
@@ -958,6 +1051,7 @@ export function useScreenRefreshKey(
       onEvents,
       pauseWhenHidden,
       interval,
+      idleInterval,
       fallbackInterval,
     });
 
@@ -967,7 +1061,14 @@ export function useScreenRefreshKey(
         releaseTransport(pollUrl, sseUrl);
       }
     };
-  }, [pollUrl, sseUrl, interval, fallbackInterval, pauseWhenHidden]);
+  }, [
+    pollUrl,
+    sseUrl,
+    interval,
+    idleInterval,
+    fallbackInterval,
+    pauseWhenHidden,
+  ]);
 
   return key;
 }

package/corpus/core/src/code-agents/background-controller.ts

@@ -1,4 +1,5 @@
 import {
+  executeDenyCodeAgentApproval,
   executeExistingCodeAgentRun,
   executePendingCodeAgentApproval,
 } from "../cli/code-agent-executor.js";
@@ -25,6 +26,7 @@ import type { AgentPromptAttachment } from "./prompt-attachments.js";
 
 export type BackgroundAgentControlCommand =
   | "approve"
+  | "deny"
   | "resume"
   | "retry"
   | "stop";
@@ -246,6 +248,22 @@ async function controlLocalCodeBackgroundAgentRun(
         error: approved ? undefined : `Run not found: ${run.id}`,
       };
     }
+    case "deny": {
+      const denied = await executeDenyCodeAgentApproval(run.id, {
+        stdout: input.stdout,
+      });
+      return {
+        ok: Boolean(denied),
+        runId: run.id,
+        run: denied
+          ? toBackgroundAgentRun(denied)
+          : currentBackgroundRun(run.id),
+        message: denied
+          ? "Pending approval denied for the Agent-Native Code run."
+          : undefined,
+        error: denied ? undefined : `Run not found: ${run.id}`,
+      };
+    }
     case "resume":
     case "retry": {
       // A control action must return immediately — awaiting