@agent-native/core 0.167.1 → 0.167.4

package/dist/client/AgentPanel.js

@@ -436,7 +436,7 @@ function CodeAccessUnavailablePanel({ title, description, ctaLabel, ctaHref, sec
                             });
                         }, className: "inline-flex items-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-xs font-medium text-foreground hover:bg-accent", children: secondaryCtaLabel })] })] }));
 }
-function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, emptyStateText, emptyStateAddon, suggestions, dynamicSuggestions, showHeader = true, onCollapse, isFullscreen, onToggleFullscreen, onFullViewRequest, onSnapTo75Percent, isWideDrawer, onExitWideDrawer, devAppUrl, storageKey, restoreActiveThread = true, scope, showScopeBadge, browserTabId, threadUrlSync, chatNotice, showTabBar = true, showPageNewChatButton = false, allowSettingsMode = true, chatOnly = false, agentPageHref, codeAccess, ...assistantChatProps }) {
+function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, emptyStateText, emptyStateAddon, suggestions, dynamicSuggestions, showHeader = true, onCollapse, isFullscreen, onToggleFullscreen, onFullViewRequest, onSnapTo75Percent, isWideDrawer, onExitWideDrawer, devAppUrl, storageKey, restoreActiveThread = true, scope, isolateHistoryByScope = false, showScopeBadge, browserTabId, threadUrlSync, chatNotice, showTabBar = true, showPageNewChatButton = false, allowSettingsMode = true, chatOnly = false, agentPageHref, codeAccess, ...assistantChatProps }) {
     const t = useT();
     const navigate = useNavigate();
     const location = useLocation();
@@ -838,7 +838,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                                     const isActive = tab.id === activeTabId ||
                                         (tab.id === focusParentId &&
                                             activeTab?.parentThreadId === tab.id);
-                                    return (_jsxs("div", { role: "button", tabIndex: 0, ref: isActive ? activeTabRefCb : undefined, onClick: () => setActiveTabId(tab.id), onKeyDown: activateOnKeyDown(() => setActiveTabId(tab.id)), className: cn("agent-tab relative flex shrink-0 items-center gap-1 rounded-md px-2.5 py-1.5 text-[11px] font-medium cursor-pointer max-w-[150px]", isActive
+                                    return (_jsxs("div", { role: "button", tabIndex: 0, ref: isActive ? activeTabRefCb : undefined, onClick: () => setActiveTabId(tab.id), onKeyDown: activateOnKeyDown(() => setActiveTabId(tab.id)), className: cn("agent-tab relative flex shrink-0 items-center gap-1 rounded-md px-2.5 py-1.5 text-[11px] font-medium cursor-pointer min-w-[56px] max-w-[150px]", isActive
                                             ? "bg-accent text-foreground"
                                             : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsx("span", { className: "truncate pe-1", children: tab.label }), tab.status === "running" && (_jsx("span", { className: "h-1.5 w-1.5 shrink-0 rounded-full bg-muted-foreground/50 animate-pulse" })), _jsx("button", { type: "button", "aria-label": t("agentPanel.closeTab"), onClick: (e) => {
                                                     e.stopPropagation();
@@ -881,7 +881,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                                                 const isActive = tab.id === activeTabId ||
                                                     (tab.id === focusParentId &&
                                                         activeTab?.parentThreadId === tab.id);
-                                                return (_jsxs("div", { role: "button", tabIndex: 0, ref: isActive ? activeTabRefCb : undefined, onClick: () => setActiveTabId(tab.id), onKeyDown: activateOnKeyDown(() => setActiveTabId(tab.id)), className: cn("agent-tab relative flex shrink-0 items-center gap-1 rounded-md px-2.5 py-1.5 text-[11px] font-medium cursor-pointer max-w-[150px]", isActive
+                                                return (_jsxs("div", { role: "button", tabIndex: 0, ref: isActive ? activeTabRefCb : undefined, onClick: () => setActiveTabId(tab.id), onKeyDown: activateOnKeyDown(() => setActiveTabId(tab.id)), className: cn("agent-tab relative flex shrink-0 items-center gap-1 rounded-md px-2.5 py-1.5 text-[11px] font-medium cursor-pointer min-w-[56px] max-w-[150px]", isActive
                                                         ? "bg-accent text-foreground"
                                                         : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsx("span", { className: "truncate pe-1", children: tab.label }), tab.status === "running" && (_jsx("span", { className: "h-1.5 w-1.5 shrink-0 rounded-full bg-muted-foreground/50 animate-pulse" })), _jsx("button", { type: "button", "aria-label": t("agentPanel.closeTab"), onClick: (e) => {
                                                                 e.stopPropagation();
@@ -899,7 +899,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                                             })
                                             : cliTabs.map((id, i) => (_jsxs("div", { role: "button", tabIndex: 0, ref: id === activeCliTab
                                                     ? activeTabRefCb
-                                                    : undefined, onClick: () => setActiveCliTab(id), onKeyDown: activateOnKeyDown(() => setActiveCliTab(id)), className: cn("agent-tab relative flex shrink-0 items-center gap-1 rounded-md px-2.5 py-1.5 text-[11px] font-medium cursor-pointer", id === activeCliTab
+                                                    : undefined, onClick: () => setActiveCliTab(id), onKeyDown: activateOnKeyDown(() => setActiveCliTab(id)), className: cn("agent-tab relative flex shrink-0 items-center gap-1 rounded-md px-2.5 py-1.5 text-[11px] font-medium cursor-pointer min-w-[56px]", id === activeCliTab
                                                     ? "bg-accent text-foreground"
                                                     : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsxs("span", { children: ["Terminal ", i + 1] }), _jsx("button", { type: "button", "aria-label": t("agentPanel.closeTab"), onClick: (e) => {
                                                             e.stopPropagation();
@@ -917,7 +917,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                                                     ? "bg-accent text-foreground"
                                                     : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: "Main" }), childTabs.map((tab) => (_jsxs("div", { role: "button", tabIndex: 0, ref: tab.id === activeTabId
                                                     ? activeTabRefCb
-                                                    : undefined, onClick: () => setActiveTabId(tab.id), onKeyDown: activateOnKeyDown(() => setActiveTabId(tab.id)), className: cn("agent-tab relative flex shrink-0 items-center gap-1 rounded-md px-2 py-1 text-[10px] font-medium cursor-pointer max-w-[140px]", tab.id === activeTabId
+                                                    : undefined, onClick: () => setActiveTabId(tab.id), onKeyDown: activateOnKeyDown(() => setActiveTabId(tab.id)), className: cn("agent-tab relative flex shrink-0 items-center gap-1 rounded-md px-2 py-1 text-[10px] font-medium cursor-pointer min-w-[48px] max-w-[140px]", tab.id === activeTabId
                                                     ? "bg-accent text-foreground"
                                                     : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsx("span", { className: "truncate pe-1", children: tab.subAgentName || tab.label }), tab.status === "running" && (_jsx("span", { className: "h-1 w-1 shrink-0 rounded-full bg-muted-foreground/50 animate-pulse" })), _jsx("button", { type: "button", "aria-label": t("agentPanel.closeTab"), onClick: (e) => {
                                                             e.stopPropagation();
@@ -981,7 +981,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                         `margin-left:auto;margin-right:auto;width:100%;}`,
                 } }), SHOW_ONBOARDING && mounted && (_jsx(Suspense, { fallback: null, children: _jsx(OnboardingPanel, {}) })), showFirstRunOnboarding && mounted && !insideAgentSidebar && (_jsx(Suspense, { fallback: null, children: _jsx(FirstRunOnboarding, {}) })), _jsx("div", { className: cn("flex flex-col min-h-0", mode === "chat" ? "flex-1" : "shrink-0"), children: mounted && (_jsx(Suspense, { fallback: _jsx(ChatLoadingSkeleton, { renderHeader: showHeader ? renderChatHeader : undefined, centerComposerWhenEmpty: assistantChatProps.centerComposerWhenEmpty, composerSlot: assistantChatProps.composerSlot, composerAreaClassName: assistantChatProps.composerAreaClassName, composerLayoutVariant: assistantChatProps.composerLayoutVariant }), children: _jsx(MultiTabAssistantChatLazy, { ...assistantChatProps, agentChatSurface: effectiveAgentChatSurface, apiUrl: apiUrl, showHeader: false, renderHeader: showHeader ? renderChatHeader : undefined, showTabBar: showTabBar, renderOverlay: showPageNewChatButton && !showHeader
                             ? renderPageChatOverlay
-                            : undefined, contentHidden: mode !== "chat", emptyStateText: emptyStateText, emptyStateAddon: emptyStateAddon, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, onSwitchToCli: () => switchMode("cli"), execMode: execMode, onExecModeChange: switchExecMode, storageKey: storageKey, restoreActiveThread: restoreActiveThread, scope: scope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync }) })) }), canUseCodeTools
+                            : undefined, contentHidden: mode !== "chat", emptyStateText: emptyStateText, emptyStateAddon: emptyStateAddon, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, onSwitchToCli: () => switchMode("cli"), execMode: execMode, onExecModeChange: switchExecMode, storageKey: storageKey, restoreActiveThread: restoreActiveThread, scope: scope, isolateHistoryByScope: isolateHistoryByScope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync }) })) }), canUseCodeTools
                 ? mode === "cli" &&
                     cliTabs.map((id) => (_jsx("div", { className: "min-h-0 relative flex-1", style: {
                             display: id === activeCliTab ? undefined : "none",
@@ -1418,7 +1418,7 @@ export function AgentChatSurface({ mode = "panel", className, defaultMode = "cha
  * Wraps app content with a toggleable agent sidebar.
  * Use AgentToggleButton in your header to open/close it.
  */
-export function AgentSidebar({ children, emptyStateText = "How can I help you?", suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, availableModels, modelListLoading, selectedAgent, onAgentChange, onConnectLocalRuntime, runtime, adapterReloadKey, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position = "right", defaultOpen = false, animateMobile = true, animateDesktop = true, chatViewTransition = false, chatViewTransitionHandoff = false, storageKey, openStorageKey, apiUrl, agentChatSurface, desktopIdentityUnauthenticated, desktopIdentityAuthenticated, showTabBar = true, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning = false, onFullscreenRequest, scope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding = false, }) {
+export function AgentSidebar({ children, emptyStateText = "How can I help you?", suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, availableModels, modelListLoading, selectedAgent, onAgentChange, onConnectLocalRuntime, runtime, adapterReloadKey, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position = "right", defaultOpen = false, animateMobile = true, animateDesktop = true, chatViewTransition = false, chatViewTransitionHandoff = false, storageKey, openStorageKey, apiUrl, agentChatSurface, desktopIdentityUnauthenticated, desktopIdentityAuthenticated, showTabBar = true, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning = false, onFullscreenRequest, scope, isolateHistoryByScope = false, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding = false, }) {
     const staticHostedHarnessEnabled = isHostedHarnessConfigured(injectedAgentNativeConfig().harness);
     const hostedHarnessQuery = useActionQuery("get-hosted-harness-config", undefined, { enabled: staticHostedHarnessEnabled });
     const hostedHarnessStatus = hostedHarnessQuery.data;
@@ -2059,7 +2059,7 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
                             ? "desktop"
                             : undefined, "data-agent-sidebar-layout": panelLayout, "data-agent-sidebar-position": effectivePosition, "data-agent-native-hosted-harness-ui": hostedHarnessUi ? "desktop" : undefined, "data-agent-sidebar-state": panelOpen ? "open" : "closed", "data-agent-sidebar-per-app-chat": isPerAppChatSidebar ? "true" : undefined, "data-agent-sidebar-resizing": isResizing ? "true" : undefined, "data-agent-sidebar-chat-handoff": chatViewTransitionHandoff ? "true" : undefined, style: chatViewTransition
                     ? getAgentChatViewTransitionStyle(panelStyle)
-                    : panelStyle, inert: sidebarAnimationEnabled && !panelOpen ? true : undefined, "aria-hidden": sidebarAnimationEnabled && !panelOpen ? true : undefined, children: _jsx("div", { className: "agent-sidebar-panel-inner flex min-h-0 flex-1 flex-col", children: _jsx(AgentPanel, { emptyStateText: emptyStateText, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, composerToolbarSlot: composerToolbarSlot, composerSlot: composerSlot, onComposerTextChange: onComposerTextChange, imageModelMenu: imageModelMenu, availableAgents: effectiveAvailableAgents, availableModels: availableModels, modelListLoading: modelListLoading, selectedAgent: effectiveSelectedAgent, onAgentChange: effectiveOnAgentChange, hostedHarness: hostedHarnessEnabled, onConnectLocalRuntime: onConnectLocalRuntime, runtime: runtime, adapterReloadKey: adapterReloadKey, threadFooterSlot: threadFooterSlot, apiUrl: apiUrl, agentChatSurface: agentChatSurface, desktopIdentityUnauthenticated: desktopIdentityUnauthenticated, desktopIdentityAuthenticated: desktopIdentityAuthenticated, showTabBar: effectiveShowTabBar, suppressInlineOpenApp: suppressInlineOpenApp, composerPlaceholder: composerPlaceholder, missingApiKeySetupLayout: "sidebar", onCollapse: () => setOpenPersisted(false), onSnapTo75Percent: isMobile ? undefined : snapTo75Percent, isWideDrawer: isMobile ? false : isWideDrawer, onExitWideDrawer: isMobile ? undefined : exitWideDrawer, onFullViewRequest: onFullscreenRequest, storageKey: storageKey, scope: scope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync, agentPageHref: agentPageHref, allowSettingsMode: false, chatOnly: true }) }) }), showResizeHandle && isLeft && (_jsx(ResizeHandle, { position: effectivePosition, onDrag: handleDrag, onResizeStart: handleResizeStart, onResizeEnd: handleResizeEnd }))] })) : null;
+                    : panelStyle, inert: sidebarAnimationEnabled && !panelOpen ? true : undefined, "aria-hidden": sidebarAnimationEnabled && !panelOpen ? true : undefined, children: _jsx("div", { className: "agent-sidebar-panel-inner flex min-h-0 flex-1 flex-col", children: _jsx(AgentPanel, { emptyStateText: emptyStateText, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, composerToolbarSlot: composerToolbarSlot, composerSlot: composerSlot, onComposerTextChange: onComposerTextChange, imageModelMenu: imageModelMenu, availableAgents: effectiveAvailableAgents, availableModels: availableModels, modelListLoading: modelListLoading, selectedAgent: effectiveSelectedAgent, onAgentChange: effectiveOnAgentChange, hostedHarness: hostedHarnessEnabled, onConnectLocalRuntime: onConnectLocalRuntime, runtime: runtime, adapterReloadKey: adapterReloadKey, threadFooterSlot: threadFooterSlot, apiUrl: apiUrl, agentChatSurface: agentChatSurface, desktopIdentityUnauthenticated: desktopIdentityUnauthenticated, desktopIdentityAuthenticated: desktopIdentityAuthenticated, showTabBar: effectiveShowTabBar, suppressInlineOpenApp: suppressInlineOpenApp, composerPlaceholder: composerPlaceholder, missingApiKeySetupLayout: "sidebar", onCollapse: () => setOpenPersisted(false), onSnapTo75Percent: isMobile ? undefined : snapTo75Percent, isWideDrawer: isMobile ? false : isWideDrawer, onExitWideDrawer: isMobile ? undefined : exitWideDrawer, onFullViewRequest: onFullscreenRequest, storageKey: storageKey, scope: scope, isolateHistoryByScope: isolateHistoryByScope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync, agentPageHref: agentPageHref, allowSettingsMode: false, chatOnly: true }) }) }), showResizeHandle && isLeft && (_jsx(ResizeHandle, { position: effectivePosition, onDrag: handleDrag, onResizeStart: handleResizeStart, onResizeEnd: handleResizeEnd }))] })) : null;
     const drawerPlaceholder = wideDrawerEnabled && !presentationMode && panelOpen ? (_jsx("div", { "aria-hidden": "true", className: "agent-sidebar-drawer-placeholder shrink-0", "data-agent-sidebar-placeholder": "true", style: { width: drawerPlaceholderWidth + 1 } })) : null;
     return (_jsx(AgentSidebarOnboardingContext.Provider, { value: true, children: _jsxs(RealtimeVoiceModeProvider, { browserTabId: browserTabId, children: [showFirstRunOnboarding && (_jsx(Suspense, { fallback: null, children: _jsx(FirstRunOnboarding, {}) })), _jsxs("div", { className: "agent-sidebar-shell flex min-w-0 flex-1 h-screen overflow-hidden", "data-agent-sidebar-position": effectivePosition, "data-agent-native-hosted-harness-ui": hostedHarnessUi ? "desktop" : undefined, "data-agent-native-hosted-chat": isPerAppChatHosted ? "true" : undefined, "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: [isMobile &&
                             !isPerAppChatHosted &&

package/dist/client/AssistantChat.d.ts

@@ -11,7 +11,7 @@ import { type AgentChatRuntime } from "./chat/runtime.js";
 import { type AgentComposerLayoutVariant, type ComposerSubmitIntent, type Reference } from "./composer/index.js";
 import { type AgentDynamicSuggestionsOption } from "./dynamic-suggestions.js";
 import { type ContentPart } from "./sse-event-processor.js";
-import type { ChatThreadScope, ChatThreadSnapshot } from "./use-chat-threads.js";
+import { type ChatThreadScope, type ChatThreadSnapshot } from "./use-chat-threads.js";
 export { AssistantMessageListErrorBoundary, AssistantUiStaleIndexErrorBoundary, assistantUiRecoverableRenderErrorKind, isAssistantUiRecoverableRenderError, isAssistantUiStaleIndexError, } from "./assistant-ui-recovery.js";
 export { displayableUserMessageText } from "./chat/message-components.js";
 export declare function shouldSuppressUnauthenticatedDesktopThreadRestore(surface: AgentChatSurfaceKind, status: number, desktopIdentityUnauthenticated?: boolean): boolean;
@@ -269,6 +269,8 @@ export interface AssistantChatProps {
     threadId?: string;
     /** Resource scope to include with chat requests for server-side context. */
     contextScope?: ChatThreadScope | null;
+    /** Restrict server-side thread restores to the supplied app scope. */
+    isolateHistoryByScope?: boolean;
     /** Namespace used to hide ambient composer context from other host surfaces. */
     contextNamespace?: string;
     /** Whether this chat owns the active visible composer context snapshot. */

package/dist/client/AssistantChat.js

@@ -39,6 +39,7 @@ import { McpConnectionSuggestion } from "./resources/McpConnectionSuggestion.js"
 import { claimRunStream, createRunStreamToken, ownsRunStream, releaseRunStream, } from "./run-stream-ownership.js";
 import { AgentAutoContinueSignal, readSSEStreamRaw, settleInterruptedToolCalls, } from "./sse-event-processor.js";
 import { useAgentEngineConfigured } from "./use-agent-engine-configured.js";
+import { appendChatThreadScopeParams, } from "./use-chat-threads.js";
 import { useDevMode } from "./use-dev-mode.js";
 import { useRunStuckDetection } from "./use-run-stuck-detection.js";
 import { cn } from "./utils.js";
@@ -1386,7 +1387,7 @@ function approvalResolutionIdentity(approvalKey, toolCallId,
 askId) {
     return `${toolCallId ?? ""}\u0000${approvalKey}\u0000${askId ?? ""}`;
 }
-const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateText, suggestions, dynamicSuggestions, threadFooterSlot, emptyStateAddon, showHeader = true, onSwitchToCli, className, apiUrl, tabId, browserTabId, threadId, contextScope, contextNamespace, isActiveComposer = true, onMessageCountChange, onSaveThread, onGenerateTitle, composerSlot, onComposerTextChange, composerAreaClassName, composerPlaceholder, missingApiKeySetupLayout = "default", composerLayoutVariant = "default", centerComposerWhenEmpty = false, emptyStateDisplay = "default", composerToolbarSlot, composerExtraActionButton, showModelSelector = true, composerDisabled = false, composerDisabledPlaceholder, isNewThread, isThreadStateLoading, onSlashCommand, execMode, onExecModeChange, approvalActions, planModeDisabled, planModeDisabledReason, selectedModel, defaultModel, selectedEngine, selectedEffort, availableModels, modelListLoading, onModelChange, onEffortChange, availableAgents, selectedAgent, hostedHarness, onAgentChange, imageModelMenu, onForkChat, onConnectProvider, onConnectLocalRuntime, plusMenuMode = "full", providerStatusChecksEnabled = true, loadHistoryRepository, historyReloadKey, externalStreaming = false, agentChatSurface = "app", desktopIdentityUnauthenticated = false, desktopIdentityAuthenticated = false, suppressInlineOpenApp = false, }, ref) {
+const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateText, suggestions, dynamicSuggestions, threadFooterSlot, emptyStateAddon, showHeader = true, onSwitchToCli, className, apiUrl, tabId, browserTabId, threadId, contextScope, isolateHistoryByScope = false, contextNamespace, isActiveComposer = true, onMessageCountChange, onSaveThread, onGenerateTitle, composerSlot, onComposerTextChange, composerAreaClassName, composerPlaceholder, missingApiKeySetupLayout = "default", composerLayoutVariant = "default", centerComposerWhenEmpty = false, emptyStateDisplay = "default", composerToolbarSlot, composerExtraActionButton, showModelSelector = true, composerDisabled = false, composerDisabledPlaceholder, isNewThread, isThreadStateLoading, onSlashCommand, execMode, onExecModeChange, approvalActions, planModeDisabled, planModeDisabledReason, selectedModel, defaultModel, selectedEngine, selectedEffort, availableModels, modelListLoading, onModelChange, onEffortChange, availableAgents, selectedAgent, hostedHarness, onAgentChange, imageModelMenu, onForkChat, onConnectProvider, onConnectLocalRuntime, plusMenuMode = "full", providerStatusChecksEnabled = true, loadHistoryRepository, historyReloadKey, externalStreaming = false, agentChatSurface = "app", desktopIdentityUnauthenticated = false, desktopIdentityAuthenticated = false, suppressInlineOpenApp = false, }, ref) {
     const t = useT();
     const thread = useThread();
     const threadRuntime = useThreadRuntime();
@@ -1418,6 +1419,14 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         enabled: messages.length === 0,
     });
     const messageListResetKey = useMemo(() => assistantUiMessageListStructureKey(messages), [messages]);
+    const threadScopeQuery = useMemo(() => {
+        if (!isolateHistoryByScope || !contextScope)
+            return "";
+        const params = new URLSearchParams();
+        appendChatThreadScopeParams(params, contextScope);
+        const query = params.toString();
+        return query ? `?${query}` : "";
+    }, [contextScope?.id, contextScope?.type, isolateHistoryByScope]);
     // Chat-wide drag-and-drop: users expect to drop a file anywhere on the agent
     // sidebar (thread, header, composer) and have it attach — same as ChatGPT,
     // Claude.ai, Linear, Slack, etc. Tiptap's own `handleDrop` only fires inside
@@ -1989,7 +1998,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
             ? setTimeout(() => ownAbort.abort(), getPollAbortMs(2000))
             : null;
         try {
-            const refreshRes = await fetch(`${apiUrl}/threads/${encodeURIComponent(threadId)}`, { signal: signal ?? ownAbort?.signal });
+            const refreshRes = await fetch(`${apiUrl}/threads/${encodeURIComponent(threadId)}${threadScopeQuery}`, { signal: signal ?? ownAbort?.signal });
             if (!refreshRes.ok)
                 return null;
             const refreshData = await refreshRes.json();
@@ -2006,7 +2015,13 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
             if (ownAbortTimer)
                 clearTimeout(ownAbortTimer);
         }
-    }, [apiUrl, importThreadData, loadHistoryRepository, threadId]);
+    }, [
+        apiUrl,
+        importThreadData,
+        loadHistoryRepository,
+        threadId,
+        threadScopeQuery,
+    ]);
     const exportCleanThreadRepo = useCallback(() => ensureMessageMetadata(normalizeThreadRepository(threadRuntime.export())), [threadRuntime]);
     const exportPersistableThreadRepo = useCallback(() => withLastAssistantRunDuration(exportCleanThreadRepo(), showRunningInUI ? null : lastChatRunDurationMs), [exportCleanThreadRepo, lastChatRunDurationMs, showRunningInUI]);
     useEffect(() => {
@@ -2698,7 +2713,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
             (async () => {
                 let canReconnect = false;
                 try {
-                    const res = await fetch(`${apiUrl}/threads/${encodeURIComponent(threadId)}`);
+                    const res = await fetch(`${apiUrl}/threads/${encodeURIComponent(threadId)}${threadScopeQuery}`);
                     if (!res.ok) {
                         if (!cancelled) {
                             setThreadRestoreError(shouldSuppressUnauthenticatedDesktopThreadRestore(agentChatSurface, res.status, desktopIdentityUnauthenticated)
@@ -2811,6 +2826,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         isThreadStateLoading,
         desktopIdentityUnauthenticated,
         restoreAttempt,
+        threadScopeQuery,
     ]);
     useEffect(() => {
         if (!loadHistoryRepository ||
@@ -2992,7 +3008,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         const timer = setTimeout(() => {
             (async () => {
                 try {
-                    const res = await fetch(`${apiUrl}/threads/${encodeURIComponent(threadId)}/queued`, {
+                    const res = await fetch(`${apiUrl}/threads/${encodeURIComponent(threadId)}/queued${threadScopeQuery}`, {
                         method: "POST",
                         headers: { "Content-Type": "application/json" },
                         body: JSON.stringify({ queuedMessages }),
@@ -3010,7 +3026,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
             })();
         }, 300);
         return () => clearTimeout(timer);
-    }, [queuedMessages, threadId, apiUrl]);
+    }, [queuedMessages, threadId, apiUrl, threadScopeQuery]);
     // Nudge the shared hook to re-check after a Builder connect.
     const handleBuilderConnected = useCallback(() => {
         focusComposerAfterConnectRef.current = true;

package/dist/client/MultiTabAssistantChat.d.ts

@@ -64,9 +64,11 @@ export type MultiTabAssistantChatProps = Omit<AssistantChatProps, "tabId" | "thr
     threadUrlSync?: boolean | ChatThreadUrlSyncOptions;
     /** Ambient resource context to show as a composer chip. */
     scope?: ChatThreadScope | null;
+    /** Keep app-owned chat history isolated to the supplied scope. */
+    isolateHistoryByScope?: boolean;
     /** @deprecated Scope context is now rendered in the composer. */
     showScopeBadge?: boolean;
     /** Cadence for hydrating agent-team sub-agent tab status. Default: 3000. */
     agentTeamPollMs?: number;
 };
-export declare function MultiTabAssistantChat({ showTabBar, renderHeader, renderOverlay, contentHidden, apiUrl, storageKey, restoreActiveThread, browserTabId, threadUrlSync, scope, agentTeamPollMs, ...props }: MultiTabAssistantChatProps): React.JSX.Element;
+export declare function MultiTabAssistantChat({ showTabBar, renderHeader, renderOverlay, contentHidden, apiUrl, storageKey, restoreActiveThread, browserTabId, threadUrlSync, scope, isolateHistoryByScope, agentTeamPollMs, ...props }: MultiTabAssistantChatProps): React.JSX.Element;

package/dist/client/MultiTabAssistantChat.js

@@ -402,7 +402,7 @@ function runToAgentTeamTabInfo(run) {
         status: run.status ?? "unknown",
     };
 }
-export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderOverlay, contentHidden = false, apiUrl = agentNativePath("/_agent-native/agent-chat"), storageKey, restoreActiveThread = true, browserTabId, threadUrlSync = false, scope = null, agentTeamPollMs = DEFAULT_AGENT_TEAM_POLL_MS, ...props }) {
+export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderOverlay, contentHidden = false, apiUrl = agentNativePath("/_agent-native/agent-chat"), storageKey, restoreActiveThread = true, browserTabId, threadUrlSync = false, scope = null, isolateHistoryByScope = false, agentTeamPollMs = DEFAULT_AGENT_TEAM_POLL_MS, ...props }) {
     const translate = useT();
     const contextNamespace = scope
         ? scope.contextKey?.trim() || `scope:${scope.type}:${scope.id}`
@@ -520,6 +520,7 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
         routeThreadId: threadUrlSyncEnabled
             ? urlThreadId
             : (activeDeepLinkedThreadId ?? undefined),
+        isolateHistoryByScope,
     });
     const switchThread = useCallback((threadId, options = {}) => {
         switchThreadState(threadId);
@@ -1911,7 +1912,7 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
                                                 const isActive = tab.id === activeThreadId ||
                                                     (tab.id === focusParentId &&
                                                         activeTab?.parentThreadId === tab.id);
-                                                return (_jsxs("div", { ref: isActive ? activeTabRefCb : undefined, className: cn("agent-tab relative flex items-center rounded-md text-[11px] font-medium shrink-0 max-w-[130px]", isActive
+                                                return (_jsxs("div", { ref: isActive ? activeTabRefCb : undefined, className: cn("agent-tab relative flex items-center rounded-md text-[11px] font-medium shrink-0 min-w-[56px] max-w-[130px]", isActive
                                                         ? "bg-accent text-foreground ring-1 ring-inset ring-border/60 shadow-sm"
                                                         : "text-muted-foreground hover:text-foreground hover:bg-accent/50"), children: [_jsxs("button", { type: "button", onClick: () => switchThread(tab.id), className: "flex items-center gap-1 px-2.5 py-1.5 min-w-0 flex-1 text-start", children: [_jsx("span", { className: "truncate pe-1", children: tab.label }), tab.status === "running" && (_jsx("span", { className: "w-1.5 h-1.5 rounded-full bg-muted-foreground/50 shrink-0 animate-pulse" }))] }), _jsx("button", { type: "button", "aria-label": translate("agentChat.tabs.closeTab"), onClick: (e) => {
                                                                 e.stopPropagation();
@@ -1931,7 +1932,7 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
                                                     ? "bg-accent text-foreground"
                                                     : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: translate("agentChat.tabs.main") }), childTabs.map((tab) => (_jsxs("div", { ref: tab.id === activeThreadId
                                                     ? activeTabRefCb
-                                                    : undefined, className: cn("agent-tab relative flex shrink-0 items-center rounded-md text-[10px] font-medium max-w-[130px]", tab.id === activeThreadId
+                                                    : undefined, className: cn("agent-tab relative flex shrink-0 items-center rounded-md text-[10px] font-medium min-w-[48px] max-w-[130px]", tab.id === activeThreadId
                                                     ? "bg-accent text-foreground"
                                                     : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsxs("button", { type: "button", onClick: () => switchThread(tab.id), className: "flex items-center gap-1 px-2 py-1 min-w-0 flex-1 text-start", children: [_jsx("span", { className: "truncate pe-1", children: tab.subAgentName || tab.label }), tab.status === "running" && (_jsx("span", { className: "w-1 h-1 rounded-full bg-muted-foreground/50 shrink-0 animate-pulse" }))] }), _jsx("button", { type: "button", "aria-label": translate("agentChat.tabs.closeTab"), onClick: (e) => {
                                                             e.stopPropagation();
@@ -1969,7 +1970,7 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
                                         else {
                                             chatRefs.current.delete(tabId);
                                         }
-                                    }, threadId: tabId, tabId: tabId, browserTabId: browserTabId, contextNamespace: contextNamespace, isActiveComposer: tabId === activeThreadId, apiUrl: apiUrl, isNewThread: newThreadIds.current.has(tabId) || isNewThread(tabId), isThreadStateLoading: isLoading, onMessageCountChange: (count) => setMessageCounts((prev) => prev[tabId] === count
+                                    }, threadId: tabId, tabId: tabId, browserTabId: browserTabId, contextScope: scope, contextNamespace: contextNamespace, isolateHistoryByScope: isolateHistoryByScope, isActiveComposer: tabId === activeThreadId, apiUrl: apiUrl, isNewThread: newThreadIds.current.has(tabId) || isNewThread(tabId), isThreadStateLoading: isLoading, onMessageCountChange: (count) => setMessageCounts((prev) => prev[tabId] === count
                                         ? prev
                                         : { ...prev, [tabId]: count }), onSaveThread: handleSaveThread, onGenerateTitle: handleGenerateTitle, onSlashCommand: handleSlashCommand, selectedModel: modelSelection?.model, selectedEngine: modelSelection?.engine, selectedEffort: modelSelection?.effort ?? DEFAULT_REASONING_EFFORT, composerSlot: props.composerSlot, defaultModel: defaultModel, availableModels: availableModels, modelListLoading: modelListLoading, onModelChange: handleModelChange, onEffortChange: handleEffortChange, onForkChat: () => handleForkChat(tabId), 
                                     // Sub-agent tabs are read-only: sending a new message from the

package/dist/client/agent-page/AgentJobsTab.js

@@ -11,7 +11,9 @@ import { AgentEmptyState } from "./AgentEmptyState.js";
 import { AgentTabFrame } from "./AgentTabFrame.js";
 import { AutomationDetailsDialog, } from "./AutomationDetailsDialog.js";
 import { AutomationScheduleDialog } from "./AutomationScheduleDialog.js";
-import { useAutomations, useManageAutomation, useManageRecurringJob, useRunAutomationNow, useRecurringJobs, } from "./use-jobs.js";
+import { scheduleFiringFor, } from "./scheduled-trigger-state.js";
+import { ScheduledTriggerNotice } from "./ScheduledTriggerNotice.js";
+import { useAutomations, useManageAutomation, useManageRecurringJob, useRunAutomationNow, useRecurringJobs, useScheduledTriggerState, } from "./use-jobs.js";
 function listRecurringJobs(jobs) {
     return jobs.map((resource) => ({
         kind: "recurring",
@@ -37,7 +39,33 @@ function describeTrigger(entry, t) {
         entry.resource.schedule ||
         t("jobs.scheduledTrigger", { defaultValue: "Scheduled" }));
 }
-function detailsFields(entry, t, formatDateTime) {
+/**
+ * `nextRun` is computed from the cron expression, not from anything that
+ * promises to run it, so it must never be presented with more confidence than
+ * the scheduler check earned. Three answers, three phrasings: a known-dead
+ * scheduler replaces the date, an unverified one qualifies it, and a confirmed
+ * one shows it plainly.
+ */
+function nextRunValue(entry, t, formatDateTime, scheduleFiring, unset) {
+    const formatted = formatDateTime(entry.resource.nextRun);
+    if (entry.triggerType !== "schedule" || scheduleFiring === "fires") {
+        return formatted ?? unset;
+    }
+    if (scheduleFiring === "never") {
+        return t("jobs.nextRunNeverScheduler", {
+            defaultValue: "Never — no scheduler in this deploy",
+        });
+    }
+    return formatted
+        ? t("jobs.nextRunSchedulerUnknown", {
+            defaultValue: "{{date}} — unconfirmed, the scheduler check failed",
+            date: formatted,
+        })
+        : t("jobs.nextRunSchedulerUnknownNoDate", {
+            defaultValue: "Unknown — the scheduler check failed",
+        });
+}
+function detailsFields(entry, t, formatDateTime, scheduleFiring) {
     const resource = entry.resource;
     const unset = t("jobs.notSet", { defaultValue: "—" });
     const fields = [
@@ -66,7 +94,7 @@ function detailsFields(entry, t, formatDateTime) {
     }
     fields.push({
         label: t("jobs.nextRun", { defaultValue: "Next run" }),
-        value: formatDateTime(resource.nextRun) ?? unset,
+        value: nextRunValue(entry, t, formatDateTime, scheduleFiring, unset),
     }, {
         label: t("jobs.lastRun", { defaultValue: "Last run" }),
         value: formatDateTime(resource.lastRun) ??
@@ -104,6 +132,11 @@ export function AgentJobsTab({ canManageOrg = false, hideHeader = false, }) {
     const personalAutomationsQuery = useAutomations("user");
     const organizationJobsQuery = useRecurringJobs("org");
     const organizationAutomationsQuery = useAutomations("org");
+    const scheduledTriggerState = useScheduledTriggerState();
+    // Three states, not `!== false`: that expression also swallowed a FAILED
+    // status query, which then licensed a confident "Next run" forever. See
+    // `scheduleFiringFor` for which way each state leans and why.
+    const scheduleFiring = scheduleFiringFor(scheduledTriggerState);
     const personalJobsMutation = useManageRecurringJob("user");
     const personalAutomationsMutation = useManageAutomation("user");
     const organizationJobsMutation = useManageRecurringJob("org");
@@ -240,7 +273,7 @@ export function AgentJobsTab({ canManageOrg = false, hideHeader = false, }) {
                 defaultValue: "Create an automation",
             }), label: t("jobs.newAutomation", {
                 defaultValue: "New automation",
-            }) }), children: [_jsxs("div", { className: "space-y-7", children: [hideHeader ? (_jsx("div", { className: "flex justify-end", children: _jsx(AgentAskPopover, { context: automationCreationContext(), prompt: t("jobs.automationPrompt", {
+            }) }), children: [_jsxs("div", { className: "space-y-7", children: [_jsx(ScheduledTriggerNotice, { state: scheduledTriggerState }), hideHeader ? (_jsx("div", { className: "flex justify-end", children: _jsx(AgentAskPopover, { context: automationCreationContext(), prompt: t("jobs.automationPrompt", {
                                 defaultValue: "Create an automation that does this: ",
                             }), title: t("jobs.automationsCreateTitle", {
                                 defaultValue: "Create an automation",
@@ -296,9 +329,9 @@ export function AgentJobsTab({ canManageOrg = false, hideHeader = false, }) {
                                             name: runTarget.resource.name,
                                             scope: runTarget.resource.scope,
                                         }, { onSuccess: () => setRunTarget(null) });
-                                    }, children: [runAutomationMutation.isPending ? (_jsx(IconLoader2, { className: "size-4 animate-spin" })) : (_jsx(IconPlayerPlay, { className: "size-4" })), t("jobs.runNow", { defaultValue: "Run now" })] })] })] }) }), detailsTarget ? (_jsx(AutomationDetailsDialog, { open: true, name: detailsTarget.resource.name, scope: detailsTarget.resource.scope === "organization" ? "org" : "user", triggerSummary: describeTrigger(detailsTarget, t), fields: detailsFields(detailsTarget, t, formatDateTime), condition: detailsTarget.kind === "automation"
+                                    }, children: [runAutomationMutation.isPending ? (_jsx(IconLoader2, { className: "size-4 animate-spin" })) : (_jsx(IconPlayerPlay, { className: "size-4" })), t("jobs.runNow", { defaultValue: "Run now" })] })] })] }) }), detailsTarget ? (_jsx(AutomationDetailsDialog, { open: true, name: detailsTarget.resource.name, scope: detailsTarget.resource.scope === "organization" ? "org" : "user", triggerSummary: describeTrigger(detailsTarget, t), fields: detailsFields(detailsTarget, t, formatDateTime, scheduleFiring), condition: detailsTarget.kind === "automation"
                     ? detailsTarget.resource.condition
                     : null, instructions: detailsTarget.kind === "automation"
                     ? detailsTarget.resource.body
-                    : detailsTarget.resource.instructions, mcpTools: detailsTarget.resource.mcpTools ?? [], lastError: detailsTarget.resource.lastError, formatTimestamp: (value) => formatDateTime(new Date(value).toISOString()) ?? String(value), onClose: () => setDetailsTarget(null) })) : null, scheduleTarget ? (_jsx(AutomationScheduleDialog, { open: true, name: scheduleTarget.resource.name, schedule: scheduleTarget.resource.schedule ?? "", timezone: scheduleTarget.resource.timezone ?? null, saving: mutationPending, error: mutationError ? mutationError.message : null, onCancel: () => setScheduleTarget(null), onSave: (next) => mutateEntry(scheduleTarget, "update", next, () => setScheduleTarget(null)) })) : null] }));
+                    : detailsTarget.resource.instructions, mcpTools: detailsTarget.resource.mcpTools ?? [], lastError: detailsTarget.resource.lastError, formatTimestamp: (value) => formatDateTime(new Date(value).toISOString()) ?? String(value), onClose: () => setDetailsTarget(null) })) : null, scheduleTarget ? (_jsx(AutomationScheduleDialog, { open: true, name: scheduleTarget.resource.name, schedule: scheduleTarget.resource.schedule ?? "", timezone: scheduleTarget.resource.timezone ?? null, saving: mutationPending, error: mutationError ? mutationError.message : null, scheduledTriggerState: scheduledTriggerState, onCancel: () => setScheduleTarget(null), onSave: (next) => mutateEntry(scheduleTarget, "update", next, () => setScheduleTarget(null)) })) : null] }));
 }

package/dist/client/agent-page/AutomationScheduleDialog.d.ts

@@ -1,3 +1,4 @@
+import type { ScheduledTriggerState } from "./scheduled-trigger-state.js";
 export interface AutomationScheduleDialogProps {
     open: boolean;
     name: string;
@@ -5,10 +6,18 @@ export interface AutomationScheduleDialogProps {
     timezone: string | null;
     saving: boolean;
     error?: string | null;
+    /**
+     * Passed in rather than queried here so this dialog stays presentational, the
+     * way the rest of its props already are. Carries the whole query state so a
+     * failed check is distinguishable from a healthy one — this dialog is where
+     * someone is actively picking a cadence, so an unverified scheduler is exactly
+     * what they need told.
+     */
+    scheduledTriggerState: ScheduledTriggerState;
     onCancel: () => void;
     onSave: (next: {
         schedule: string;
         timezone: string;
     }) => void;
 }
-export declare function AutomationScheduleDialog({ open, name, schedule, timezone, saving, error, onCancel, onSave, }: AutomationScheduleDialogProps): import("react").JSX.Element;
+export declare function AutomationScheduleDialog({ open, name, schedule, timezone, saving, error, scheduledTriggerState, onCancel, onSave, }: AutomationScheduleDialogProps): import("react").JSX.Element;

package/dist/client/agent-page/AutomationScheduleDialog.js

@@ -5,6 +5,7 @@ import { IconLoader2 } from "@tabler/icons-react";
 import { useEffect, useState } from "react";
 import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, } from "../components/ui/dialog.js";
 import { useT } from "../i18n.js";
+import { ScheduledTriggerNotice } from "./ScheduledTriggerNotice.js";
 import { TimezoneSelect, browserTimezone } from "./TimezoneSelect.js";
 const PRESETS = [
     { label: "Every hour", cron: "0 * * * *" },
@@ -16,7 +17,7 @@ const CRON_FIELD_COUNT = 5;
 function looksLikeCron(value) {
     return value.trim().split(/\s+/).length === CRON_FIELD_COUNT;
 }
-export function AutomationScheduleDialog({ open, name, schedule, timezone, saving, error, onCancel, onSave, }) {
+export function AutomationScheduleDialog({ open, name, schedule, timezone, saving, error, scheduledTriggerState, onCancel, onSave, }) {
     const t = useT();
     const [value, setValue] = useState(schedule);
     const [zone, setZone] = useState(timezone || browserTimezone());
@@ -37,7 +38,7 @@ export function AutomationScheduleDialog({ open, name, schedule, timezone, savin
                                 name: name.replace(/-/g, " "),
                             }) }), _jsx(DialogDescription, { children: t("jobs.editScheduleDescription", {
                                 defaultValue: "The clock time below is read in the timezone you pick, so 8:00 means 8:00 there.",
-                            }) })] }), _jsxs("div", { className: "space-y-3", children: [_jsxs("div", { children: [_jsx("label", { className: "text-xs font-medium text-foreground", htmlFor: "automation-schedule", children: t("jobs.cronExpression", { defaultValue: "Cron expression" }) }), _jsx(Input, { id: "automation-schedule", className: "mt-1 font-mono text-sm", value: value, spellCheck: false, autoComplete: "off", disabled: saving, onChange: (event) => setValue(event.target.value) }), _jsx("p", { className: "mt-1 text-[11px] text-muted-foreground", children: t("jobs.cronFormatHint", {
+                            }) })] }), _jsxs("div", { className: "space-y-3", children: [_jsx(ScheduledTriggerNotice, { state: scheduledTriggerState, variant: "inline" }), _jsxs("div", { children: [_jsx("label", { className: "text-xs font-medium text-foreground", htmlFor: "automation-schedule", children: t("jobs.cronExpression", { defaultValue: "Cron expression" }) }), _jsx(Input, { id: "automation-schedule", className: "mt-1 font-mono text-sm", value: value, spellCheck: false, autoComplete: "off", disabled: saving, onChange: (event) => setValue(event.target.value) }), _jsx("p", { className: "mt-1 text-[11px] text-muted-foreground", children: t("jobs.cronFormatHint", {
                                         defaultValue: "minute hour day-of-month month day-of-week",
                                     }) })] }), _jsx("div", { className: "flex flex-wrap gap-1.5", children: PRESETS.map((preset) => (_jsx(Button, { type: "button", variant: "outline", size: "sm", className: "h-7 cursor-pointer text-[11px]", disabled: saving, onClick: () => setValue(preset.cron), children: preset.label }, preset.cron))) }), _jsxs("div", { children: [_jsx("label", { className: "text-xs font-medium text-foreground", htmlFor: "automation-timezone", children: t("jobs.timezone", { defaultValue: "Timezone" }) }), _jsx("div", { className: "mt-1", children: _jsx(TimezoneSelect, { id: "automation-timezone", value: zone, disabled: saving, onChange: setZone, suggested: [browserTimezone()] }) })] }), trimmed && !valid ? (_jsx("p", { className: "text-xs text-destructive", children: t("jobs.cronFieldCount", {
                                 defaultValue: "A cron expression needs exactly 5 fields.",

package/dist/client/agent-page/ScheduledTriggerNotice.d.ts

@@ -0,0 +1,22 @@
+import type { ScheduledTriggerState } from "./scheduled-trigger-state.js";
+export interface ScheduledTriggerNoticeProps {
+    state: ScheduledTriggerState;
+    /** `banner` heads the page; `inline` sits inside the schedule dialog. */
+    variant?: "banner" | "inline";
+}
+/**
+ * Warns that schedule-triggered automations will not fire in this deploy.
+ *
+ * Worth a persistent surface rather than a one-time toast: whether a schedule
+ * fires is decided by the BUILD, while automations are created at runtime, so
+ * the mismatch is invisible at the moment it bites. Without this, a scheduled
+ * automation reports "Enabled" with a plausible "Next run" and silently never
+ * runs. Shown on the Automations page and again inside the schedule editor,
+ * which is the one place a user is actively choosing a cadence.
+ *
+ * Takes the whole query state, not just a resolved status, because a status
+ * check that FAILED has to look different from one that came back healthy: the
+ * failure is why the next-run dates alongside it are unverified, and silently
+ * rendering nothing would present them as confirmed.
+ */
+export declare function ScheduledTriggerNotice({ state, variant, }: ScheduledTriggerNoticeProps): import("react").JSX.Element | null;

package/dist/client/agent-page/ScheduledTriggerNotice.js

@@ -0,0 +1,84 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { IconAlertCircle, IconAlertTriangle, IconChevronRight, } from "@tabler/icons-react";
+import { useT } from "../i18n.js";
+/**
+ * Warns that schedule-triggered automations will not fire in this deploy.
+ *
+ * Worth a persistent surface rather than a one-time toast: whether a schedule
+ * fires is decided by the BUILD, while automations are created at runtime, so
+ * the mismatch is invisible at the moment it bites. Without this, a scheduled
+ * automation reports "Enabled" with a plausible "Next run" and silently never
+ * runs. Shown on the Automations page and again inside the schedule editor,
+ * which is the one place a user is actively choosing a cadence.
+ *
+ * Takes the whole query state, not just a resolved status, because a status
+ * check that FAILED has to look different from one that came back healthy: the
+ * failure is why the next-run dates alongside it are unverified, and silently
+ * rendering nothing would present them as confirmed.
+ */
+export function ScheduledTriggerNotice({ state, variant = "banner", }) {
+    const t = useT();
+    // Still in flight: resolves in milliseconds, so say nothing rather than
+    // flash a caveat at every reader on a perfectly healthy deploy.
+    if (state.kind === "loading")
+        return null;
+    const shell = variant === "banner"
+        ? "flex items-start gap-2.5 rounded-xl border px-4 py-3"
+        : "flex items-start gap-2 rounded-lg border px-3 py-2";
+    // Muted rather than amber: "we could not check" is a weaker claim than "this
+    // will not run", and dressing it identically would teach readers to discount
+    // the one that means something.
+    if (state.kind === "unknown") {
+        return (_jsxs("div", { role: "status", "data-testid": "scheduled-trigger-notice", "data-reason": "check-failed", className: `${shell} border-border/70 bg-muted/50`, children: [_jsx(IconAlertCircle, { className: "mt-px size-4 shrink-0 text-muted-foreground" }), _jsxs("div", { className: "min-w-0", children: [_jsx("p", { className: "text-xs font-medium text-foreground", children: t("jobs.scheduleUnknownTitle", {
+                                defaultValue: "Couldn't check whether schedules run here",
+                            }) }), _jsx("p", { className: "mt-0.5 text-[11px] leading-4 text-muted-foreground", children: t("jobs.scheduleUnknownDetail", {
+                                defaultValue: "The scheduler status check failed, so the next run times below " +
+                                    "are unconfirmed. Reload to check again.",
+                            }) })] })] }));
+    }
+    const status = state.status;
+    if (status.available)
+        return null;
+    const headline = status.reason === "local-development"
+        ? t("jobs.scheduleUnavailableLocalTitle", {
+            defaultValue: "Schedules don't run in local development",
+        })
+        : t("jobs.scheduleUnavailableTitle", {
+            defaultValue: "Schedules won't run in this deploy",
+        });
+    const detail = status.reason === "disabled-by-env"
+        ? t("jobs.scheduleUnavailableDisabled", {
+            defaultValue: "This app was built with recurring jobs turned off, so no scheduled " +
+                "automation will fire. Event-triggered automations and Run now still work.",
+        })
+        : status.reason === "no-platform-scheduler"
+            ? t("jobs.scheduleUnavailableNoScheduler", {
+                defaultValue: "This hosting target has no durable scheduler, so no scheduled automation will fire. Event-triggered automations and Run now still work.",
+            })
+            : t("jobs.scheduleUnavailableLocal", {
+                defaultValue: "Schedules stay off on a dev machine unless you opt in. " +
+                    "Event-triggered automations and Run now still work.",
+            });
+    /**
+     * Recovery steps, collapsed by default: the notice has to say what is wrong
+     * before it says how to change it, and the how is longer than the what. Null
+     * where nothing is actually toggleable — `no-platform-scheduler` means the
+     * host has no scheduler to enable, so an empty disclosure would promise a fix
+     * that does not exist.
+     */
+    const fix = status.reason === "disabled-by-env"
+        ? t("jobs.scheduleUnavailableDisabledFix", {
+            defaultValue: "To enable recurring jobs, set AGENT_NATIVE_DISABLE_RECURRING_JOBS=false in the build environment.",
+        })
+        : status.reason === "local-development"
+            ? t("jobs.scheduleUnavailableLocalFix", {
+                defaultValue: "Set AGENT_NATIVE_ENABLE_LOCAL_RECURRING_JOBS=true to run " +
+                    "schedules on this machine.",
+            })
+            : null;
+    return (_jsxs("div", { role: "status", "data-testid": "scheduled-trigger-notice", "data-reason": status.reason, className: `${shell} border-amber-500/40 bg-amber-500/10`, children: [_jsx(IconAlertTriangle, { className: "mt-px size-4 shrink-0 text-amber-600 dark:text-amber-400" }), _jsxs("div", { className: "min-w-0", children: [_jsx("p", { className: "text-xs font-medium text-amber-700 dark:text-amber-300", children: headline }), _jsx("p", { className: "mt-0.5 text-[11px] leading-4 text-amber-700/90 dark:text-amber-300/90", children: detail }), fix ? (_jsxs("details", { className: "group mt-1", children: [_jsxs("summary", { className: "-ml-1.5 inline-flex w-fit cursor-pointer select-none list-none items-center gap-1 rounded-md px-1.5 py-1 text-[11px] font-medium text-amber-700 transition-colors hover:bg-amber-500/15 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-amber-500/40 dark:text-amber-300 dark:hover:bg-amber-400/15 [&::-webkit-details-marker]:hidden", children: [_jsx(IconChevronRight, { className: "size-3 shrink-0 transition-transform duration-150 group-open:rotate-90" }), _jsx("span", { className: "group-open:hidden", children: t("jobs.scheduleUnavailableFixLabel", {
+                                            defaultValue: "Show more",
+                                        }) }), _jsx("span", { className: "hidden group-open:inline", children: t("jobs.scheduleUnavailableFixLabelOpen", {
+                                            defaultValue: "Show less",
+                                        }) })] }), _jsx("p", { className: "mt-1 whitespace-pre-line text-[11px] leading-4 text-amber-700/90 dark:text-amber-300/90", children: fix })] })) : null] })] }));
+}

package/dist/client/agent-page/scheduled-trigger-state.d.ts

@@ -0,0 +1,28 @@
+import type { ScheduledTriggerStatus } from "../../jobs/actions/get-scheduled-trigger-status.js";
+export type { ScheduledTriggerStatus };
+/**
+ * Three-state view of the scheduler status query.
+ *
+ * `unknown` exists so a FAILED check cannot pass for a healthy one. The status
+ * action can 404 on an older deploy, 403 behind an auth boundary, or fail
+ * discovery — none of which say anything about whether schedules fire, and all
+ * of which read as "fine" under a plain `data?.available !== false`. `loading`
+ * stays separate because it resolves on its own in milliseconds; an error does
+ * not.
+ *
+ * Deliberately kept in its own module, free of the query hook: the pure
+ * state→consequence mapping below is what the UI branches on, and it stays real
+ * in tests that mock the data layer.
+ */
+export type ScheduledTriggerState = {
+    kind: "loading";
+} | {
+    kind: "unknown";
+    error: Error | null;
+} | {
+    kind: "resolved";
+    status: ScheduledTriggerStatus;
+};
+/** Whether a schedule-triggered automation will fire, as far as the UI knows. */
+export type ScheduleFiring = "fires" | "never" | "unknown";
+export declare function scheduleFiringFor(state: ScheduledTriggerState): ScheduleFiring;

package/dist/client/agent-page/scheduled-trigger-state.js

@@ -0,0 +1,10 @@
+export function scheduleFiringFor(state) {
+    if (state.kind === "resolved") {
+        return state.status.available ? "fires" : "never";
+    }
+    // Loading leans optimistic on purpose: accusing a working deploy of being
+    // broken mid-flight is worse than showing the warning a beat late. An errored
+    // check gets no such benefit — it never resolves, so the optimism would be
+    // permanent and would license a confident "Next run" forever.
+    return state.kind === "unknown" ? "unknown" : "fires";
+}

package/dist/client/agent-page/use-jobs.d.ts

@@ -1,3 +1,4 @@
+import type { ScheduledTriggerState, ScheduledTriggerStatus } from "./scheduled-trigger-state.js";
 export type JobsScope = "user" | "org";
 export interface RecurringJob {
     id: string;
@@ -75,6 +76,12 @@ export interface AutomationRun {
     finishedAt: number | null;
     error: string | null;
 }
+export type { ScheduledTriggerState, ScheduledTriggerStatus };
+/**
+ * Deploy-scoped and fixed for the life of the process, so it is cached far
+ * longer than the automation lists.
+ */
+export declare function useScheduledTriggerState(): ScheduledTriggerState;
 export declare function useRecurringJobs(scope: JobsScope): import("@tanstack/react-query").UseQueryResult<NoInfer<RecurringJob[]>, Error>;
 export declare function useAutomations(scope: JobsScope): import("@tanstack/react-query").UseQueryResult<NoInfer<Automation[]>, Error>;
 export declare function useManageRecurringJob(scope: JobsScope): import("@tanstack/react-query").UseMutationResult<{

package/dist/client/agent-page/use-jobs.js

@@ -6,6 +6,20 @@ function recurringParams(scope) {
 function automationParams(scope) {
     return { scope: scope === "org" ? "organization" : "personal" };
 }
+/**
+ * Deploy-scoped and fixed for the life of the process, so it is cached far
+ * longer than the automation lists.
+ */
+export function useScheduledTriggerState() {
+    const query = useActionQuery("get-scheduled-trigger-status", {}, { staleTime: 5 * 60_000 });
+    // Data first: a cached answer with a failing background refetch is still an
+    // answer, and downgrading it to `unknown` would flicker the warning off.
+    if (query.data)
+        return { kind: "resolved", status: query.data };
+    if (query.error)
+        return { kind: "unknown", error: query.error };
+    return { kind: "loading" };
+}
 export function useRecurringJobs(scope) {
     return useActionQuery("list-recurring-jobs", recurringParams(scope), { staleTime: 5_000 });
 }