@agent-native/core 0.137.3 → 0.137.4

package/dist/client/settings/SettingsRow.js

@@ -6,7 +6,7 @@ import { cn } from "../utils.js";
  * resolve an app's i18n keys.
  */
 export function SettingsGroup({ id, title, description, className, children, }) {
-    return (_jsxs("section", { id: id, className: cn("scroll-mt-16 overflow-hidden rounded-lg border border-border bg-card text-card-foreground shadow-sm", className), children: [(title || description) && (_jsxs("header", { className: "border-b border-border/60 px-5 py-4 sm:px-6", children: [title && (_jsx("h2", { className: "text-base font-semibold leading-none tracking-tight", children: title })), description && (_jsx("p", { className: "mt-1.5 text-sm leading-snug text-muted-foreground", children: description }))] })), _jsx("div", { className: "divide-y divide-border/60", children: children })] }));
+    return (_jsxs("section", { id: id, className: cn("scroll-mt-16", className), children: [(title || description) && (_jsxs("header", { className: "mb-2.5", children: [title && (_jsx("h2", { className: "text-sm font-semibold text-foreground", children: title })), description && (_jsx("p", { className: "mt-1 text-xs leading-5 text-muted-foreground", children: description }))] })), _jsx("div", { className: "overflow-hidden rounded-xl border border-border/70 bg-card text-card-foreground", children: _jsx("div", { className: "divide-y divide-border/60", children: children }) })] }));
 }
 /** One setting: label and description on the start side, control on the end. */
 export function SettingsRow({ id, label, description, icon, status, control, children, className, }) {

package/dist/client/settings/SettingsSection.d.ts

@@ -20,15 +20,17 @@ interface SettingsSectionProps {
     badge?: string;
     required?: boolean;
     connected?: boolean;
+    /** Let a child-owned card surface fill the section without a second wrapper. */
+    flat?: boolean;
+    /** Render the page content as a row inside a parent SettingsGroup. */
+    grouped?: boolean;
     open?: boolean;
     onToggle?: () => void;
     children: ReactNode;
 }
 /**
- * Collapsible settings section. Renders as a compact row in the agent sidebar
- * and as a polished, shadcn-style card on the full settings page (so the
- * framework tabs match app-owned General/Team cards). The visual surface is
- * read from `SettingsSurfaceContext`.
+ * Settings sections stay compact and collapsible in the agent sidebar, while
+ * the full settings page uses Codex-style headings and always-visible rows.
  */
 export declare function SettingsSection(props: SettingsSectionProps): import("react").JSX.Element;
 export {};

package/dist/client/settings/SettingsSection.js

@@ -10,10 +10,8 @@ export function useSettingsSurface() {
     return useContext(SettingsSurfaceContext);
 }
 /**
- * Collapsible settings section. Renders as a compact row in the agent sidebar
- * and as a polished, shadcn-style card on the full settings page (so the
- * framework tabs match app-owned General/Team cards). The visual surface is
- * read from `SettingsSurfaceContext`.
+ * Settings sections stay compact and collapsible in the agent sidebar, while
+ * the full settings page uses Codex-style headings and always-visible rows.
  */
 export function SettingsSection(props) {
     const surface = useSettingsSurface();
@@ -59,8 +57,10 @@ function SettingsSectionBody({ open, children, }) {
         return null;
     return (_jsx("div", { "data-state": open ? "open" : "closed", "aria-hidden": open ? undefined : true, inert: open ? undefined : true, className: "agent-native-settings-section-body", onTransitionEnd: handleTransitionEnd, children: children }));
 }
-function PageSettingsSection({ id, icon, title, subtitle, badge, required, connected, open = false, onToggle, children, }) {
-    return (_jsxs("div", { id: id, className: cn("scroll-mt-16 overflow-hidden rounded-lg border bg-card text-card-foreground shadow-sm transition-colors", open ? "border-border" : "border-border/60"), children: [_jsxs("button", { type: "button", onClick: onToggle, "aria-expanded": open, className: "flex w-full items-start justify-between gap-4 px-5 py-4 text-start transition-colors hover:bg-muted/40 sm:px-6 sm:py-5", children: [_jsxs("div", { className: "flex min-w-0 items-start gap-3", children: [_jsx("span", { className: "mt-0.5 flex size-8 shrink-0 items-center justify-center rounded-md bg-muted text-muted-foreground [&>svg]:size-[18px]", children: icon }), _jsxs("span", { className: "flex min-w-0 flex-col gap-1.5", children: [_jsxs("span", { className: "flex flex-wrap items-center gap-2", children: [_jsx("span", { className: "text-base font-semibold leading-none tracking-tight text-foreground", children: title }), connected && _jsx(ConnectedDot, { size: "md" }), required && !connected && (_jsx(StatusBadge, { label: "Required", tone: "required", size: "md" })), badge && _jsx(StatusBadge, { label: badge, tone: "muted", size: "md" })] }), subtitle && (_jsx("span", { className: "text-sm leading-snug text-muted-foreground", children: subtitle }))] })] }), _jsx(IconChevronDown, { size: 18, className: cn("mt-1 shrink-0 text-muted-foreground transition-transform", open && "rotate-180") })] }), _jsx(SettingsSectionBody, { open: open, children: _jsx("div", { "data-agent-native-settings-page": "", className: "border-t border-border/60 px-5 pb-5 pt-5 sm:px-6 sm:pb-6", children: children }) })] }));
+function PageSettingsSection({ id, title, subtitle, badge, required, connected, flat, grouped, children, }) {
+    return (_jsxs("section", { id: id, className: "scroll-mt-16", children: [!grouped && (_jsx("div", { className: "mb-2.5 flex items-baseline justify-between gap-3", children: _jsxs("div", { className: "min-w-0", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx("h2", { className: "text-sm font-semibold text-foreground", children: title }), connected && _jsx(ConnectedDot, { size: "sm" }), required && !connected && (_jsx(StatusBadge, { label: "Required", tone: "required", size: "sm" })), badge && _jsx(StatusBadge, { label: badge, tone: "muted", size: "sm" })] }), subtitle && (_jsx("p", { className: "mt-1 text-xs leading-5 text-muted-foreground", children: subtitle }))] }) })), _jsx("div", { "data-agent-native-settings-page": "", className: cn(!flat &&
+                    !grouped &&
+                    "overflow-hidden rounded-xl border border-border/70 bg-card text-card-foreground"), children: _jsx("div", { className: cn(!flat && !grouped && "divide-y divide-border/60 px-5 py-1 sm:px-6"), children: children }) })] }));
 }
 function SidebarSettingsSection({ id, icon, title, subtitle, badge, required, connected, open = false, onToggle, children, }) {
     return (_jsxs("div", { id: id, className: "rounded-lg border border-border bg-background/50", children: [_jsxs("button", { type: "button", onClick: onToggle, "aria-expanded": open, className: "flex w-full cursor-pointer items-center justify-between px-3 py-2.5 text-start rounded-lg hover:bg-accent/40 transition-colors", children: [_jsxs("div", { className: "flex items-center gap-2 min-w-0", children: [_jsx("span", { className: "shrink-0 text-muted-foreground", children: icon }), _jsx("span", { className: "text-[12px] font-medium text-foreground truncate", children: title }), connected && _jsx(ConnectedDot, { size: "sm" }), required && !connected && (_jsx(StatusBadge, { label: "Required", tone: "muted", size: "sm" })), badge && _jsx(StatusBadge, { label: badge, tone: "muted", size: "sm" })] }), _jsx(IconChevronDown, { size: 12, className: `shrink-0 text-muted-foreground transition-transform ${open ? "rotate-180" : ""}` })] }), _jsx(SettingsSectionBody, { open: open, children: _jsxs("div", { className: "border-t border-border px-3 pb-3 pt-2.5", children: [subtitle && (_jsx("p", { className: "text-[10px] text-muted-foreground mb-2.5", children: subtitle })), children] }) })] }));

package/dist/client/settings/SettingsTabsPage.js

@@ -1,13 +1,19 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Tabs, useDesignSystem } from "@agent-native/toolkit/design-system";
-import { IconArrowUpRight, IconHistory, IconSearch, IconSettings, IconUserCircle, IconUsers, IconX, } from "@tabler/icons-react";
+import { IconArrowLeft, IconArrowUpRight, IconHistory, IconSearch, IconSettings, IconUserCircle, IconUsers, IconX, } from "@tabler/icons-react";
 import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
 import { Link } from "react-router";
 import { cn } from "../utils.js";
 function normalizeTabId(value) {
-    const normalized = value
-        ?.replace(/^#/, "")
-        .trim()
+    let decoded = value?.replace(/^#/, "").trim() ?? "";
+    try {
+        decoded = decodeURIComponent(decoded);
+    }
+    catch {
+        // coercion-ok: preserve malformed external hashes for routing fallback.
+        // Keep the raw hash when an external link contains malformed encoding.
+    }
+    const normalized = decoded
         .toLowerCase()
         .replace(/['"]/g, "")
         .replace(/[\s_]+/g, "-");
@@ -22,6 +28,9 @@ function normalizeTabId(value) {
     if (normalized === "workspace" || normalized === "workspace-settings") {
         return "workspace";
     }
+    if (normalized === "connections") {
+        return "integrations";
+    }
     return normalized;
 }
 function resolveTabId(tabs, value) {
@@ -30,7 +39,15 @@ function resolveTabId(tabs, value) {
         return null;
     if (tabs.some((tab) => tab.id === normalized))
         return normalized;
+    const nestedTab = tabs
+        .filter((tab) => normalized.startsWith(`${tab.id}:`) ||
+        tab.id.startsWith(`${normalized}:`))
+        .sort((a, b) => b.id.length - a.id.length)[0];
+    if (nestedTab)
+        return nestedTab.id;
     const section = normalized.split(":", 1)[0];
+    if (tabs.some((tab) => tab.id === section))
+        return section;
     const owner = tabs.find((tab) => tab.searchEntries?.some((entry) => normalizeTabId(entry.hash ?? entry.id) === section));
     if (owner)
         return owner.id;
@@ -53,7 +70,7 @@ function updateHashForTab(tabId) {
     if (typeof window === "undefined")
         return;
     const { pathname, search } = window.location;
-    const hash = tabId === "general" ? "" : `#${encodeURIComponent(tabId)}`;
+    const hash = tabId === "general" ? "" : `#${tabId}`;
     window.history.pushState(null, "", `${pathname}${search}${hash}`);
 }
 function isEditableElement(element) {
@@ -65,7 +82,7 @@ function isEditableElement(element) {
         tagName === "select" ||
         element.isContentEditable);
 }
-export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs = [], generalLabel = "General", accountLabel = "Account", teamLabel = "Team", whatsNewLabel = "What's new", ariaLabel = "Settings sections", defaultTab = "general", className, navClassName, contentClassName, enableSearch = true, searchPlaceholder = "Search settings", searchEntries, generalSearchEntries, value, onValueChange, }) {
+export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs = [], generalLabel = "General", accountLabel = "Account", teamLabel = "Team", whatsNewLabel = "What's new", ariaLabel = "Settings sections", defaultTab = "integrations", className, navClassName, contentClassName, enableSearch = true, searchPlaceholder = "Search settings", searchEntries, generalSearchEntries, value, onValueChange, }) {
     const rootRef = useRef(null);
     const searchInputRef = useRef(null);
     const autoFocusedSearchRef = useRef(false);
@@ -142,6 +159,12 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
         }
         return groups;
     }, [tabs]);
+    const tabGroupLabels = {
+        app: "Personal",
+        integrations: "Integrations",
+        workspace: "Workspace",
+        agent: "Agent",
+    };
     const isControlled = value !== undefined;
     const [internalTab, setInternalTab] = useState(() => activeTabFromHash(tabs, fallbackTab));
     const activeTab = isControlled ? value : internalTab;
@@ -300,7 +323,7 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
         }
     };
     const searching = enableSearch && trimmedQuery.length > 0;
-    return (_jsxs("div", { ref: rootRef, className: cn("flex h-full min-h-0 w-full flex-col overflow-hidden bg-background sm:flex-row", className), children: [_jsxs("div", { className: cn("flex shrink-0 flex-col gap-2 bg-background p-2 sm:min-h-0 sm:w-56 sm:overflow-y-auto sm:p-3", navClassName), children: [enableSearch ? (_jsxs("div", { className: "relative sm:mb-1", children: [_jsx(IconSearch, { className: "pointer-events-none absolute start-2.5 top-1/2 size-3.5 -translate-y-1/2 text-muted-foreground" }), _jsx("input", { ref: searchInputRef, type: "search", value: query, onChange: (event) => setQuery(event.target.value), onKeyDown: (event) => {
+    return (_jsxs("div", { ref: rootRef, className: cn("flex h-full min-h-0 w-full flex-col overflow-hidden bg-background sm:flex-row", className), children: [_jsxs("div", { className: cn("flex shrink-0 flex-col gap-2 bg-background p-2 sm:min-h-0 sm:w-60 sm:overflow-y-auto sm:p-4", navClassName), children: [_jsxs("a", { href: "/", className: "flex min-h-8 items-center gap-2 rounded-md px-2 text-sm text-muted-foreground transition-colors hover:bg-accent/50 hover:text-foreground", children: [_jsx(IconArrowLeft, { className: "size-4 shrink-0 rtl:-scale-x-100" }), _jsx("span", { children: "Back to app" })] }), enableSearch ? (_jsxs("div", { className: "relative sm:mb-2", children: [_jsx(IconSearch, { className: "pointer-events-none absolute start-2.5 top-1/2 size-3.5 -translate-y-1/2 text-muted-foreground" }), _jsx("input", { ref: searchInputRef, type: "search", value: query, onChange: (event) => setQuery(event.target.value), onKeyDown: (event) => {
                                     if (event.key === "Escape")
                                         setQuery("");
                                     if (event.key === "Enter" && results[0]) {
@@ -329,25 +352,24 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
                             changeTab(nextTab);
                             if (!isControlled)
                                 updateHashForTab(nextTab);
-                        }, orientation: "vertical", "aria-label": ariaLabel, className: "flex gap-1 overflow-x-auto sm:flex-col sm:overflow-x-visible" })) : (_jsx("nav", { "aria-label": ariaLabel, role: "tablist", className: "flex gap-1 overflow-x-auto sm:flex-col sm:overflow-x-visible", children: tabGroups.map((group, groupIndex) => (_jsx("div", { "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"), children: _jsx("div", { className: "contents sm:flex sm:flex-col sm:gap-1", children: group.tabs.map((tab) => {
-                                    const Icon = tab.icon;
-                                    const selected = tab.id === selectedTab?.id;
-                                    const tabContent = (_jsxs(_Fragment, { children: [Icon ? (_jsx(Icon, { className: cn("size-4 shrink-0", selected
-                                                    ? "text-foreground"
-                                                    : "text-muted-foreground") })) : null, _jsx("span", { className: "truncate", children: tab.label }), tab.href ? (_jsx(IconArrowUpRight, { "aria-hidden": "true", className: "size-3.5 shrink-0 text-muted-foreground/80" })) : null] }));
-                                    if (tab.href) {
-                                        return (_jsx(Link, { role: "tab", "aria-selected": selected, to: tab.href, 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
+                        }, orientation: "vertical", "aria-label": ariaLabel, className: "flex gap-1 overflow-x-auto sm:flex-col sm:overflow-x-visible" })) : (_jsx("nav", { "aria-label": ariaLabel, role: "tablist", className: "flex gap-1 overflow-x-auto sm:flex-col sm:overflow-x-visible", children: tabGroups.map((group, groupIndex) => (_jsx("div", { "data-settings-tab-group": group.id, className: cn("contents sm:block", groupIndex > 0 && "sm:mt-3 sm:pt-1"), children: _jsxs("div", { className: "contents sm:flex sm:flex-col sm:gap-1", children: [_jsx("div", { className: "hidden px-3 pb-1 pt-1 text-[11px] font-medium text-muted-foreground sm:block", children: tabGroupLabels[group.id] ?? group.id }), group.tabs.map((tab) => {
+                                        const Icon = tab.icon;
+                                        const selected = tab.id === selectedTab?.id;
+                                        const tabContent = (_jsxs(_Fragment, { children: [Icon ? (_jsx(Icon, { className: cn("size-4 shrink-0", selected
+                                                        ? "text-foreground"
+                                                        : "text-muted-foreground") })) : null, _jsx("span", { className: "truncate", children: tab.label }), tab.href ? (_jsx(IconArrowUpRight, { "aria-hidden": "true", className: "size-3.5 shrink-0 text-muted-foreground/80" })) : null] }));
+                                        if (tab.href) {
+                                            return (_jsx(Link, { role: "tab", "aria-selected": selected, to: tab.href, 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"), children: tabContent }, tab.id));
+                                        }
+                                        return (_jsx("button", { 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"), children: tabContent }, tab.id));
-                                    }
-                                    return (_jsx("button", { 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"), children: tabContent }, tab.id));
-                                }) }) }, group.id))) }))] }), _jsx("div", { id: `settings-tabpanel-${selectedTab?.id ?? "general"}`, role: "tabpanel", "aria-labelledby": `settings-tab-${selectedTab?.id ?? "general"}`, className: cn("min-h-0 min-w-0 flex-1 overflow-y-auto p-4 sm:p-6", contentClassName), children: selectedTab?.content })] }));
+                                    })] }) }, group.id))) }))] }), _jsx("div", { id: `settings-tabpanel-${selectedTab?.id ?? "general"}`, role: "tabpanel", "aria-labelledby": `settings-tab-${selectedTab?.id ?? "general"}`, className: cn("min-h-0 min-w-0 flex-1 overflow-y-auto p-4 sm:p-8 lg:p-10", contentClassName), children: selectedTab?.content })] }));
 }
 //# sourceMappingURL=SettingsTabsPage.js.map

package/dist/client/settings/VoiceTranscriptionSection.d.ts

@@ -10,5 +10,7 @@
  * mirrors the server transcription route's key/env resolution.
  */
 import React from "react";
-export declare function VoiceTranscriptionSection(): React.JSX.Element;
+export declare function VoiceTranscriptionSection({ compact, }?: {
+    compact?: boolean;
+}): React.JSX.Element;
 //# sourceMappingURL=VoiceTranscriptionSection.d.ts.map

package/dist/client/settings/VoiceTranscriptionSection.js

@@ -10,10 +10,11 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * Provider status comes from `/_agent-native/voice-providers/status`, which
  * mirrors the server transcription route's key/env resolution.
  */
-import { Switch } from "@agent-native/toolkit/design-system";
+import { Picker, Switch } from "@agent-native/toolkit/design-system";
 import { IconAlertCircle, IconCheck, IconChevronDown, IconChevronRight, IconExternalLink, IconLoader2, IconLockOpen, } from "@tabler/icons-react";
 import { useCallback, useEffect, useState } from "react";
 import { agentNativePath } from "../api-path.js";
+import { SettingsRow } from "./SettingsRow.js";
 import { openBuilderConnectPopup, useBuilderStatus, } from "./useBuilderStatus.js";
 const PREFS_URL = agentNativePath("/_agent-native/application-state/voice-transcription-prefs");
 const CLEANUP_PREFS_URL = agentNativePath("/_agent-native/application-state/voice-cleanup-prefs");
@@ -58,7 +59,7 @@ function batchProvider(provider) {
         return DEFAULT_BATCH_PROVIDER;
     return provider;
 }
-export function VoiceTranscriptionSection() {
+export function VoiceTranscriptionSection({ compact = false, } = {}) {
     const [transcriptionMode, setTranscriptionMode] = useState(null);
     const [provider, setProvider] = useState(DEFAULT_BATCH_PROVIDER);
     const [instructions, setInstructions] = useState("");
@@ -267,14 +268,25 @@ export function VoiceTranscriptionSection() {
     if (transcriptionMode === null) {
         return (_jsxs("div", { className: "flex items-center gap-1.5 text-[10px] text-muted-foreground", children: [_jsx(IconLoader2, { size: 10, className: "animate-spin" }), "Loading\u2026"] }));
     }
+    if (compact) {
+        return (_jsx(SettingsRow, { label: "Voice transcription", description: "Choose how voice input is transcribed.", control: _jsx(Picker, { mode: "select", options: [
+                    { value: "mac-native", label: "Mac Native" },
+                    { value: "google-realtime", label: "Google Realtime" },
+                    { value: "batch", label: "Batch" },
+                ], value: transcriptionMode, onChange: (next) => {
+                    const value = String(next ?? "");
+                    if (isTranscriptionMode(value))
+                        chooseSource(value);
+                }, "aria-label": "Voice transcription", className: "w-44 text-start" }) }));
+    }
     return (_jsxs("div", { className: "space-y-2", children: [_jsxs("div", { className: "rounded-md border border-border bg-background p-2", children: [_jsx("div", { className: "mb-2 flex items-start justify-between gap-3 px-0.5", children: _jsxs("div", { children: [_jsx("div", { className: "text-[11px] font-medium text-foreground", children: "Live transcription" }), _jsx("p", { className: "mt-0.5 text-[10px] text-muted-foreground", children: "Choose where real-time words come from. Batch still runs after recording stops." })] }) }), _jsxs("div", { className: "space-y-2", children: [_jsx(ProviderOption, { id: "mac-native", selected: transcriptionMode === "mac-native", onSelect: () => chooseSource("mac-native"), title: "Mac Native", subtitle: "Free and fast in the macOS Tauri app. Web clients use the existing browser-native path when available.", rightSlot: _jsx("span", { className: "text-[10px] text-muted-foreground", children: "Tauri default" }) }), _jsx(ProviderOption, { id: "google-realtime", selected: transcriptionMode === "google-realtime", onSelect: () => chooseSource("google-realtime"), disabled: !googleRealtimeReady, title: "Google Realtime", subtitle: googleRealtimeReady
                                     ? "BYOK only for v1. Streams live partials and finals through Google Speech-to-Text."
                                     : googleRealtimeConfigured
                                         ? "Google credentials are set. Connect Builder completely to mint the managed realtime session."
-                                        : "BYOK only for v1. Configure Google service account before selecting this source.", rightSlot: googleRealtimeReady ? (_jsxs("span", { className: "flex items-center gap-1 text-[10px] text-green-500", children: [_jsx(IconCheck, { size: 10 }), "Ready"] })) : googleRealtimeConfigured ? (_jsxs("button", { type: "button", onClick: (e) => {
+                                        : "BYOK only for v1. Configure Google service account before selecting this source.", rightSlot: googleRealtimeReady ? (_jsxs("span", { className: "flex items-center gap-1 text-[10px] text-green-500", children: [_jsx(IconCheck, { size: 10 }), "Ready"] })) : googleRealtimeConfigured ? (_jsx("button", { type: "button", onClick: (e) => {
                                         e.stopPropagation();
                                         openBuilderConnect();
-                                    }, className: "inline-flex items-center gap-1 rounded border border-border px-2 py-0.5 text-[10px] text-muted-foreground hover:bg-accent/40 hover:text-foreground", children: ["Connect Builder.io", _jsx(IconExternalLink, { size: 10 })] })) : (_jsxs("button", { type: "button", onClick: (e) => {
+                                    }, className: "inline-flex items-center gap-1 rounded border border-border px-2 py-0.5 text-[10px] text-muted-foreground hover:bg-accent/40 hover:text-foreground", children: "Connect Builder.io" })) : (_jsxs("button", { type: "button", onClick: (e) => {
                                         e.stopPropagation();
                                         setShowAdvanced(true);
                                         focusKey("GOOGLE_APPLICATION_CREDENTIALS");
@@ -285,18 +297,18 @@ export function VoiceTranscriptionSection() {
                                         : "Needs key" }))] })] }), _jsxs("div", { className: "rounded-md border border-border bg-background", children: [_jsxs("button", { type: "button", onClick: () => setShowAdvanced((v) => !v), className: "w-full flex items-center justify-between gap-2 px-2.5 py-2 cursor-pointer", children: [_jsxs("span", { className: "text-[11px] font-medium text-foreground inline-flex items-center gap-1", children: [showAdvanced ? (_jsx(IconChevronDown, { size: 12 })) : (_jsx(IconChevronRight, { size: 12, className: "rtl:-scale-x-100" })), "Add API keys"] }), _jsx("span", { className: "text-[10px] text-muted-foreground", children: "Google STT \u00B7 Gemini \u00B7 Groq \u00B7 OpenAI" })] }), showAdvanced && (_jsxs("div", { className: "px-2 pb-2 space-y-2", children: [_jsx(ProviderOption, { id: "google-service-account", selected: transcriptionMode === "google-realtime", onSelect: () => chooseSource("google-realtime"), disabled: !googleRealtimeReady, title: "Google Speech-to-Text service account", subtitle: googleRealtimeConfigured
                                     ? "Service-account JSON is set. Connect Builder to mint the managed realtime WebSocket session."
                                     : "Service-account JSON for the dedicated realtime WebSocket to Google StreamingRecognize.", rightSlot: googleRealtimeConfigured ===
-                                    null ? null : googleRealtimeReady ? (_jsxs("span", { className: "flex items-center gap-1 text-[10px] text-green-500", children: [_jsx(IconCheck, { size: 10 }), "Ready"] })) : googleRealtimeConfigured ? (_jsxs("button", { type: "button", onClick: (e) => {
+                                    null ? null : googleRealtimeReady ? (_jsxs("span", { className: "flex items-center gap-1 text-[10px] text-green-500", children: [_jsx(IconCheck, { size: 10 }), "Ready"] })) : googleRealtimeConfigured ? (_jsx("button", { type: "button", onClick: (e) => {
                                         e.stopPropagation();
                                         openBuilderConnect();
-                                    }, className: "inline-flex items-center gap-1 rounded border border-border px-2 py-0.5 text-[10px] text-muted-foreground hover:text-foreground hover:bg-accent/40", children: ["Connect Builder.io", _jsx(IconExternalLink, { size: 10 })] })) : (_jsxs("button", { type: "button", onClick: (e) => {
+                                    }, className: "inline-flex items-center gap-1 rounded border border-border px-2 py-0.5 text-[10px] text-muted-foreground hover:text-foreground hover:bg-accent/40", children: "Connect Builder.io" })) : (_jsxs("button", { type: "button", onClick: (e) => {
                                         e.stopPropagation();
                                         focusKey("GOOGLE_APPLICATION_CREDENTIALS");
                                     }, className: "inline-flex items-center gap-1 rounded border border-border px-2 py-0.5 text-[10px] text-muted-foreground hover:text-foreground hover:bg-accent/40", children: ["Configure", _jsx(IconExternalLink, { size: 10 })] })) }), _jsx(ProviderOption, { id: "auto", selected: transcriptionMode === "batch" && provider === "auto", onSelect: () => chooseBatchProvider("auto"), title: "Automatic batch fallback", subtitle: "Keep the current Clips fallback chain: Builder Gemini, Gemini, Groq, then OpenAI." }), _jsx(ProviderOption, { id: "builder-gemini", selected: transcriptionMode === "batch" && provider === "builder-gemini", onSelect: () => chooseBatchProvider("builder-gemini"), disabled: !builderStatus?.configured, title: "Builder.io Connect", subtitle: builderStatus?.configured
                                     ? "Use Builder-hosted Gemini Flash-Lite for batch transcription and Luna for text cleanup."
-                                    : "One-click connect for Gemini Flash-Lite transcription and Luna text cleanup. No Google key needed.", rightSlot: builderStatus?.configured ? (_jsxs("span", { className: "flex items-center gap-1 text-[10px] text-green-500", children: [_jsx(IconCheck, { size: 10 }), "Connected"] })) : (_jsxs("button", { type: "button", onClick: (e) => {
+                                    : "One-click connect for Gemini Flash-Lite transcription and Luna text cleanup. No Google key needed.", rightSlot: builderStatus?.configured ? (_jsxs("span", { className: "flex items-center gap-1 text-[10px] text-green-500", children: [_jsx(IconCheck, { size: 10 }), "Connected"] })) : (_jsx("button", { type: "button", onClick: (e) => {
                                         e.stopPropagation();
                                         openBuilderConnect();
-                                    }, className: "inline-flex items-center gap-1 rounded border border-border px-2 py-0.5 text-[10px] text-muted-foreground hover:text-foreground hover:bg-accent/40", children: ["Connect Builder.io", _jsx(IconExternalLink, { size: 10 })] })) }), _jsx(ProviderOption, { id: "gemini", selected: transcriptionMode === "batch" && provider === "gemini", onSelect: () => chooseBatchProvider("gemini"), title: "Google Gemini", subtitle: "BYOK Gemini for AI cleanup and optional strict batch transcription.", rightSlot: geminiConfigured === null ? null : geminiConfigured ? (_jsxs("span", { className: "flex items-center gap-1 text-[10px] text-green-500", children: [_jsx(IconCheck, { size: 10 }), "Key set"] })) : (_jsxs("button", { type: "button", onClick: (e) => {
+                                    }, className: "inline-flex items-center gap-1 rounded border border-border px-2 py-0.5 text-[10px] text-muted-foreground hover:text-foreground hover:bg-accent/40", children: "Connect Builder.io" })) }), _jsx(ProviderOption, { id: "gemini", selected: transcriptionMode === "batch" && provider === "gemini", onSelect: () => chooseBatchProvider("gemini"), title: "Google Gemini", subtitle: "BYOK Gemini for AI cleanup and optional strict batch transcription.", rightSlot: geminiConfigured === null ? null : geminiConfigured ? (_jsxs("span", { className: "flex items-center gap-1 text-[10px] text-green-500", children: [_jsx(IconCheck, { size: 10 }), "Key set"] })) : (_jsxs("button", { type: "button", onClick: (e) => {
                                         e.stopPropagation();
                                         focusKey("GEMINI_API_KEY");
                                     }, className: "inline-flex items-center gap-1 rounded border border-border px-2 py-0.5 text-[10px] text-muted-foreground hover:text-foreground hover:bg-accent/40", children: ["Add key", _jsx(IconExternalLink, { size: 10 })] })) }), _jsx(ProviderOption, { id: "openai", selected: transcriptionMode === "batch" && provider === "openai", onSelect: () => chooseBatchProvider("openai"), title: "OpenAI Transcribe", subtitle: "Batch transcription provider. Requires an OpenAI API key.", rightSlot: openAiConfigured === null ? null : openAiConfigured ? (_jsxs("span", { className: "flex items-center gap-1 text-[10px] text-green-500", children: [_jsx(IconCheck, { size: 10 }), "Key set"] })) : (_jsxs("button", { type: "button", onClick: (e) => {

package/dist/client/settings/agent-settings-search.d.ts

@@ -3,7 +3,7 @@ export type SettingsSectionId = "account" | "llm" | "app-models" | "limits" | "v
 export declare const SETTINGS_SECTION_IDS: Set<SettingsSectionId>;
 export declare const ALL_SETTINGS_SECTIONS: readonly SettingsSectionId[];
 export declare const AGENT_SETTINGS_SECTIONS: readonly SettingsSectionId[];
-export declare const CONNECTION_SETTINGS_SECTIONS: readonly SettingsSectionId[];
+export declare const INTEGRATION_SETTINGS_SECTIONS: readonly SettingsSectionId[];
 export declare const WORKSPACE_SETTINGS_SECTIONS: readonly SettingsSectionId[];
 export declare function buildSectionSearchEntries(sections: readonly SettingsSectionId[]): SettingsSearchEntry[];
 export interface AgentSettingsSearchTab {

package/dist/client/settings/agent-settings-search.js

@@ -46,9 +46,9 @@ export const AGENT_SETTINGS_SECTIONS = [
     "background",
     "a2a",
 ];
-export const CONNECTION_SETTINGS_SECTIONS = [
-    "secrets",
+export const INTEGRATION_SETTINGS_SECTIONS = [
     "integrations",
+    "secrets",
     "email",
     "browser",
     "usage",
@@ -90,7 +90,7 @@ const SETTINGS_SECTION_SEARCH_META = {
         keywords: "triggers scheduled events cron jobs",
     },
     secrets: {
-        label: "API Keys & Connections",
+        label: "API keys",
         keywords: "secrets credentials tokens api keys environment variables",
     },
     hosting: {
@@ -150,15 +150,15 @@ export function getAgentSettingsSearchTabs() {
     return [
         {
             id: "agent",
-            label: "Manage agent",
+            label: "Agent",
             keywords: "agent workspace manage agent model llm limits voice automations",
             searchEntries: buildSectionSearchEntries(AGENT_SETTINGS_SECTIONS),
         },
         {
-            id: "connections",
-            label: "Connections",
-            keywords: "connections secrets integrations email browser usage",
-            searchEntries: buildSectionSearchEntries(CONNECTION_SETTINGS_SECTIONS),
+            id: "integrations",
+            label: "Integrations",
+            keywords: "integrations agent integrations connections secrets email browser usage tools",
+            searchEntries: buildSectionSearchEntries(INTEGRATION_SETTINGS_SECTIONS),
         },
         {
             id: "organization",

package/dist/client/transcription/BuilderTranscriptionCta.js

@@ -6,7 +6,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *
  * Drop this next to transcript displays in any template.
  */
-import { IconBolt, IconExternalLink, IconLoader2 } from "@tabler/icons-react";
+import { IconBolt, IconLoader2 } from "@tabler/icons-react";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { agentNativePath } from "../api-path.js";
 import { openBuilderConnectPopup } from "../settings/useBuilderStatus.js";
@@ -82,6 +82,6 @@ export function BuilderTranscriptionCta() {
         return null;
     return (_jsxs("div", { className: "flex items-center gap-2 rounded-md border border-border/50 bg-muted/30 px-3 py-2 text-xs text-muted-foreground", children: [_jsx(IconBolt, { size: 14, className: "shrink-0 text-muted-foreground/70", "aria-hidden": "true" }), _jsx("span", { className: "flex-1", children: connecting
                     ? "Waiting for Builder.io…"
-                    : "Connect Builder.io for higher-quality transcription — free credits, no API key needed." }), error ? (_jsx("span", { className: "text-destructive text-[10px]", children: error })) : connecting ? (_jsx(IconLoader2, { size: 12, className: "shrink-0 animate-spin" })) : (_jsxs("button", { type: "button", onClick: handleConnect, className: "ml-auto shrink-0 inline-flex items-center gap-1 rounded bg-foreground px-2 py-1 text-[10px] font-semibold text-background hover:opacity-90 transition-opacity", children: ["Connect", _jsx(IconExternalLink, { size: 10 })] }))] }));
+                    : "Connect Builder.io for higher-quality transcription — free credits, no API key needed." }), error ? (_jsx("span", { className: "text-destructive text-[10px]", children: error })) : connecting ? (_jsx(IconLoader2, { size: 12, className: "shrink-0 animate-spin" })) : (_jsx("button", { type: "button", onClick: handleConnect, className: "ml-auto shrink-0 inline-flex items-center gap-1 rounded bg-foreground px-2 py-1 text-[10px] font-semibold text-background hover:opacity-90 transition-opacity", children: "Connect" }))] }));
 }
 //# sourceMappingURL=BuilderTranscriptionCta.js.map

package/dist/client/use-chat-threads.d.ts

@@ -13,9 +13,15 @@ export interface ChatThreadSummary {
     createdAt: number;
     updatedAt: number;
     scope: ChatThreadScope | null;
+    source?: ChatThreadSource | null;
     pinnedAt?: number | null;
     archivedAt?: number | null;
 }
+export interface ChatThreadSource {
+    platform?: string;
+    appId?: string;
+    url?: string;
+}
 export interface ChatThreadData {
     id: string;
     ownerEmail: string;
@@ -26,6 +32,7 @@ export interface ChatThreadData {
     createdAt: number;
     updatedAt: number;
     scope: ChatThreadScope | null;
+    source?: ChatThreadSource | null;
     pinnedAt?: number | null;
     archivedAt?: number | null;
 }
@@ -57,6 +64,8 @@ export interface UseChatThreadsOptions {
      * create/new-chat mode.
      */
     routeThreadId?: string | null;
+    /** Include connected and other-app chats in list/search results. */
+    includeExternal?: boolean;
 }
 export declare function useChatThreads(apiUrl?: string, storageKey?: string, scope?: ChatThreadScope | null, options?: UseChatThreadsOptions): {
     threads: ChatThreadSummary[];

package/dist/client/use-chat-threads.js

@@ -3,8 +3,14 @@ import { agentNativePath } from "./api-path.js";
 const ACTIVE_THREAD_KEY = "agent-chat-active-thread";
 const THREADS_UPDATED_EVENT = "agent-chat:threads-updated";
 const THREADS_PAGE_SIZE = 50;
-async function fetchThreadListPage(apiUrl, offset) {
-    return fetch(offset > 0 ? `${apiUrl}/threads?offset=${offset}` : `${apiUrl}/threads`).then(async (res) => {
+async function fetchThreadListPage(apiUrl, offset, includeExternal) {
+    const params = new URLSearchParams();
+    if (offset > 0)
+        params.set("offset", String(offset));
+    if (includeExternal)
+        params.set("includeExternal", "1");
+    const query = params.toString();
+    return fetch(`${apiUrl}/threads${query ? `?${query}` : ""}`).then(async (res) => {
         if (!res.ok)
             return undefined;
         const data = await res.json();
@@ -102,6 +108,7 @@ function nextThreadTitle(currentTitle, incomingTitle, incomingPreview, source =
 export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-chat"), storageKey, scope, options) {
     const autoCreate = options?.autoCreate !== false;
     const restoreActiveThread = options?.restoreActiveThread !== false;
+    const includeExternal = options?.includeExternal === true;
     const routeControlsActiveThread = options?.routeThreadId !== undefined;
     const routeThreadId = normalizeThreadId(options?.routeThreadId);
     // Each (storageKey, scope) pair gets its own active-thread localStorage key
@@ -148,6 +155,7 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
     const [isLoadingMoreThreads, setIsLoadingMoreThreads] = useState(false);
     const [threadsLoadError, setThreadsLoadError] = useState(null);
     const nextThreadsOffsetRef = useRef(0);
+    const latestFetchRequestRef = useRef(0);
     const threadsRef = useRef(threads);
     threadsRef.current = threads;
     // IDs we generated client-side this session — consumers use this to know
@@ -341,9 +349,12 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
         threads,
     ]);
     const fetchThreads = useCallback(async (options) => {
+        const requestId = ++latestFetchRequestRef.current;
         try {
             const offset = options?.append ? nextThreadsOffsetRef.current : 0;
-            const loaded = await fetchThreadListPage(apiUrl, offset);
+            const loaded = await fetchThreadListPage(apiUrl, offset, includeExternal);
+            if (requestId !== latestFetchRequestRef.current)
+                return undefined;
             if (!loaded) {
                 if (!options?.append) {
                     setThreadsLoadError("Could not load chat history.");
@@ -426,12 +437,14 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             return loaded;
         }
         catch {
+            if (requestId !== latestFetchRequestRef.current)
+                return undefined;
             if (!options?.append) {
                 setThreadsLoadError("Could not load chat history.");
             }
             return undefined;
         }
-    }, [apiUrl]);
+    }, [apiUrl, includeExternal]);
     const loadMoreThreads = useCallback(async () => {
         if (isLoadingMoreThreads || !hasMoreThreads)
             return;
@@ -980,7 +993,10 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
     }, [apiUrl]);
     const searchThreads = useCallback(async (query) => {
         try {
-            const res = await fetch(`${apiUrl}/threads?q=${encodeURIComponent(query)}`);
+            const params = new URLSearchParams({ q: query });
+            if (includeExternal)
+                params.set("includeExternal", "1");
+            const res = await fetch(`${apiUrl}/threads?${params.toString()}`);
             if (!res.ok)
                 return [];
             const data = await res.json();
@@ -989,7 +1005,7 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
         catch {
             return [];
         }
-    }, [apiUrl]);
+    }, [apiUrl, includeExternal]);
     const getThreadShareState = useCallback(async (threadId) => {
         try {
             const res = await fetch(`${apiUrl}/threads/${encodeURIComponent(threadId)}/share`);

package/dist/collab/awareness.d.ts

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

package/dist/collab/routes.d.ts

@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
  * Body: { update: string (base64), requestSource?: string }
  */
 export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/file-upload/actions/upload-image.d.ts

@@ -17,12 +17,12 @@ declare const _default: import("../../action.js").ActionDefinition<{
     id?: undefined;
     provider?: undefined;
 } | {
+    error?: undefined;
     configured?: undefined;
     connectPath?: undefined;
     url: string;
     id: string;
     provider: string;
-    error?: undefined;
 }>;
 export default _default;
 //# sourceMappingURL=upload-image.d.ts.map

package/dist/integrations/google-docs-poller.js

@@ -5,7 +5,7 @@ import { runAgentLoopDirectWithSoftTimeout } from "../agent/run-loop-with-resume
 import { startRun } from "../agent/run-manager.js";
 import { buildAssistantMessage, extractThreadMeta, } from "../agent/thread-data-builder.js";
 import { attachToolSearch } from "../agent/tool-search.js";
-import { createThread, getThread, updateThreadData, } from "../chat-threads/store.js";
+import { createThread, getThread, setThreadSourceIfMissing, updateThreadData, } from "../chat-threads/store.js";
 import { resolveOrgIdForEmail } from "../org/context.js";
 import { runWithRequestContext } from "../server/request-context.js";
 import { getServiceAccountAccessToken, getServiceAccountEmail, getStartPageToken, googleDocsAdapter, listChanges, listDocComments, } from "./adapters/google-docs.js";
@@ -274,14 +274,22 @@ async function processComment(fileId, commentId, text, senderName, options, exis
         platformContext: { fileId, commentId },
         timestamp: Date.now(),
     };
+    const source = {
+        platform: PLATFORM,
+        url: `https://docs.google.com/document/d/${fileId}/edit`,
+    };
     let threadId = existingThreadId;
     if (!threadId) {
         const thread = await createThread(options.ownerEmail, {
             title: `Google Doc: ${senderName}`,
+            source,
         });
         await saveThreadMapping(PLATFORM, key, thread.id, { fileId, commentId });
         threadId = thread.id;
     }
+    // Older mapped conversations predate thread provenance. Backfill them as
+    // they are touched so Dispatch's default local-history view excludes them.
+    await setThreadSourceIfMissing(threadId, source);
     const thread = await getThread(threadId);
     const existingMessages = [];
     if (thread?.threadData) {

package/dist/integrations/webhook-handler.js

@@ -11,7 +11,7 @@ import { startRun, } from "../agent/run-manager.js";
 import { buildCurrentTimeUserContext, buildRuntimeContextPrompt, } from "../agent/runtime-context.js";
 import { buildAssistantMessage, extractThreadMeta, threadDataToEngineMessages, } from "../agent/thread-data-builder.js";
 import { attachToolSearch } from "../agent/tool-search.js";
-import { createThread, getThread, grantThreadUserShare, } from "../chat-threads/store.js";
+import { createThread, getThread, grantThreadUserShare, setThreadSourceIfMissing, } from "../chat-threads/store.js";
 import { updateThreadData } from "../chat-threads/store.js";
 import { isLocalDatabase } from "../db/client.js";
 import { getOrgA2ASecret, resolveOrgIdForEmail } from "../org/context.js";
@@ -575,6 +575,11 @@ async function processIncomingMessage(incoming, options, opts = {}) {
             const threadOrgId = opts.orgId ?? (await resolveOrgIdForEmail(ownerEmail));
             const createdThread = await runWithRequestContext({ userEmail: ownerEmail, orgId: threadOrgId ?? undefined }, () => createThread(ownerEmail, {
                 title: `${adapter.label}: ${incoming.senderName || incoming.senderId || "User"}`,
+                source: {
+                    platform: incoming.platform,
+                    appId: options.appId ?? null,
+                    url: incoming.sourceUrl ?? null,
+                },
             }));
             await saveThreadMapping(incoming.platform, incoming.externalThreadId, createdThread.id, incoming.platformContext);
             mapping = {
@@ -587,6 +592,11 @@ async function processIncomingMessage(incoming, options, opts = {}) {
             };
         }
         threadId = mapping.internalThreadId;
+        await setThreadSourceIfMissing(threadId, {
+            platform: incoming.platform,
+            appId: options.appId ?? null,
+            url: incoming.sourceUrl ?? null,
+        });
         // Load existing thread history for context.
         thread = await getThread(threadId);
     }