@agent-native/core 0.154.5 → 0.155.0

package/dist/client/agent-chat-adapter.js

@@ -6,6 +6,7 @@ import { getOrCreateAnalyticsSessionId } from "./analytics-session.js";
 import { captureError } from "./analytics.js";
 import { agentNativePath } from "./api-path.js";
 import { formatChatErrorText, normalizeChatError } from "./error-format.js";
+import { createRunStreamToken, preemptRunStream, releaseRunStream, } from "./run-stream-ownership.js";
 import { AgentAutoContinueSignal, INTERRUPTED_TOOL_RESULT, appendMissingFinalResponseWarning, readSSEStream, settleInterruptedToolCalls, } from "./sse-event-processor.js";
 import { isDelegatedAgentToolCall, isToolCallInFlight, } from "./tool-display.js";
 const TEXT_ATTACHMENT_CONTENT_TYPES = new Set([
@@ -1006,6 +1007,26 @@ function snapshotContent(content) {
         ? { ...part }
         : { ...part, args: { ...part.args } });
 }
+function hasMissingFinalResponseAfterTool(content) {
+    const warning = appendMissingFinalResponseWarning(snapshotContent(content));
+    return warning?.errorCode === "final_response_missing_after_tool";
+}
+function missingFinalResponseWarningFromResult(result) {
+    const metadata = result.metadata;
+    const custom = metadata?.custom;
+    if (!custom || typeof custom !== "object")
+        return null;
+    const warning = custom.runWarning;
+    if (!warning || typeof warning !== "object")
+        return null;
+    const warningRecord = warning;
+    if (warningRecord.errorCode !== "final_response_missing_after_tool") {
+        return null;
+    }
+    return {
+        message: typeof warningRecord.message === "string" ? warningRecord.message : "",
+    };
+}
 function stableJson(value) {
     try {
         return JSON.stringify(value);
@@ -1618,7 +1639,19 @@ export function createAgentChatAdapter(options) {
                         activeRun.threadId === threadId &&
                         activeRun.runId === runId));
             };
+            // The adapter's own stream outranks AssistantChat's reconnect fallback:
+            // when it attaches to a run, any reconnect reader folding the same run
+            // must stop writing UI state or both folds render at once.
+            const streamOwnershipToken = createRunStreamToken(`adapter:${turnId}`);
+            const takeRunStreamOwnership = () => {
+                if (threadId && runId) {
+                    preemptRunStream(threadId, runId, streamOwnershipToken);
+                }
+            };
             const settleTerminalChatRun = () => {
+                if (threadId && runId) {
+                    releaseRunStream(threadId, runId, streamOwnershipToken);
+                }
                 if (!ownsActiveRunState())
                     return;
                 if (threadId && runId) {
@@ -1972,10 +2005,12 @@ export function createAgentChatAdapter(options) {
                                 break;
                             }
                             updateCurrentRunDispatchMode(reconnectRes.headers.get("X-Dispatch-Mode"));
+                            takeRunStreamOwnership();
                             for await (const result of readSSEStream(reconnectRes.body, content, toolCallCounter, tabId, (seq, isProgress) => {
                                 rememberRunSeq(seq);
-                                if (threadId)
-                                    updateActiveRunSeq(seq, isProgress);
+                                if (threadId && runId) {
+                                    updateActiveRunSeq(threadId, runId, seq, isProgress);
+                                }
                             }, runId, currentSSEOptions())) {
                                 const nextResult = withRequestModeMetadata(result);
                                 if (isTerminalChatModelRunResult(nextResult)) {
@@ -2311,20 +2346,45 @@ export function createAgentChatAdapter(options) {
                         }
                         attached = true;
                         updateCurrentRunDispatchMode(eventsRes.headers.get("X-Dispatch-Mode"));
+                        takeRunStreamOwnership();
+                        let missingFinalResponseResult = null;
                         for await (const result of readSSEStream(eventsRes.body, content, toolCallCounter, tabId, (seq, isProgress) => {
                             rememberRunSeq(seq);
-                            if (threadId)
-                                updateActiveRunSeq(seq, isProgress);
+                            if (threadId && runId) {
+                                updateActiveRunSeq(threadId, runId, seq, isProgress);
+                            }
                         }, runId, currentSSEOptions({
                             noProgressTimeoutMs: BACKGROUND_FOLLOW_ATTACH_WATCHDOG_MS,
                             actionPreparationStallTimeoutMs: BACKGROUND_FOLLOW_ATTACH_WATCHDOG_MS,
                         }))) {
                             const nextResult = withRequestModeMetadata(result);
+                            if (isDurableBackgroundDispatch() &&
+                                missingFinalResponseWarningFromResult(nextResult)) {
+                                missingFinalResponseResult = nextResult;
+                                continue;
+                            }
                             if (isTerminalChatModelRunResult(nextResult)) {
                                 settleTerminalChatRun();
                             }
                             yield nextResult;
                         }
+                        if (missingFinalResponseResult) {
+                            const warning = missingFinalResponseWarningFromResult(missingFinalResponseResult);
+                            const lastContentPart = content.at(-1);
+                            if (warning?.message &&
+                                lastContentPart?.type === "text" &&
+                                lastContentPart.text === warning.message) {
+                                content.pop();
+                            }
+                            if (continueAfterMissingFinalResponse()) {
+                                await delay(250, abortSignal);
+                                return "client_continue";
+                            }
+                            settleTerminalChatRun();
+                            yield missingFinalResponseResult;
+                            clearActiveRun();
+                            return "completed";
+                        }
                         // readSSEStream returned normally: a terminal done/error was
                         // consumed and rendered — the turn is over.
                         clearActiveRun();
@@ -2614,6 +2674,11 @@ export function createAgentChatAdapter(options) {
                                         continue;
                                     }
                                 }
+                                if (hasMissingFinalResponseAfterTool(content) &&
+                                    continueAfterMissingFinalResponse()) {
+                                    await delay(250, abortSignal);
+                                    return "client_continue";
+                                }
                                 yield* emitBackgroundTerminalOutcome(active);
                                 return "completed";
                             }
@@ -2642,6 +2707,9 @@ export function createAgentChatAdapter(options) {
                             }
                             const seqBeforeAttach = lastSeq;
                             const attach = yield* followAttachOnce();
+                            if (attach === "client_continue") {
+                                return "client_continue";
+                            }
                             if (attach === "completed" || attach === "aborted") {
                                 return "completed";
                             }
@@ -2964,6 +3032,17 @@ export function createAgentChatAdapter(options) {
                         nonAdvancing: !advanced,
                     };
                 };
+                const continueAfterMissingFinalResponse = () => {
+                    const continuation = prepareAutoContinuation(new AgentAutoContinueSignal({ reason: "stream_ended" }));
+                    if (!continuation.ok)
+                        return false;
+                    if (typeof window !== "undefined") {
+                        window.dispatchEvent(new CustomEvent("agent-chat:auto-continue", {
+                            detail: { tabId },
+                        }));
+                    }
+                    return true;
+                };
                 while (true) {
                     try {
                         runId = null;
@@ -3221,18 +3300,41 @@ export function createAgentChatAdapter(options) {
                             clearPendingTurnIfMatches(threadId, turnId);
                             setActiveRun({ threadId, runId, turnId, lastSeq: -1 });
                         }
+                        takeRunStreamOwnership();
+                        let missingFinalResponseResult = null;
                         for await (const result of readSSEStream(res.body, content, toolCallCounter, tabId, (seq, isProgress) => {
                             rememberRunSeq(seq);
                             if (runId && threadId) {
-                                updateActiveRunSeq(seq, isProgress);
+                                updateActiveRunSeq(threadId, runId, seq, isProgress);
                             }
                         }, runId, currentSSEOptions())) {
                             const nextResult = withRequestModeMetadata(result);
+                            if (isDurableBackgroundDispatch() &&
+                                missingFinalResponseWarningFromResult(nextResult)) {
+                                missingFinalResponseResult = nextResult;
+                                continue;
+                            }
                             if (isTerminalChatModelRunResult(nextResult)) {
                                 settleTerminalChatRun();
                             }
                             yield nextResult;
                         }
+                        if (isDurableBackgroundDispatch() && missingFinalResponseResult) {
+                            const warning = missingFinalResponseWarningFromResult(missingFinalResponseResult);
+                            const lastContentPart = content.at(-1);
+                            if (warning?.message &&
+                                lastContentPart?.type === "text" &&
+                                lastContentPart.text === warning.message) {
+                                content.pop();
+                            }
+                            if (continueAfterMissingFinalResponse()) {
+                                continue;
+                            }
+                            settleTerminalChatRun();
+                            yield missingFinalResponseResult;
+                            clearActiveRun();
+                            return;
+                        }
                         // Run completed normally — clear active run state
                         clearActiveRun();
                         return;

package/dist/client/analytics.js

@@ -1030,6 +1030,12 @@ function exceptionEventProperties(event) {
         ...(event.extra ? { exceptionExtra: event.extra } : {}),
     };
 }
+function amplitudeEventProperties(name, properties) {
+    if (name !== AGENT_NATIVE_EXCEPTION_EVENT_NAME)
+        return properties;
+    const { exceptionTags: _exceptionTags, exceptionExtra: _exceptionExtra, ...stableProperties } = properties;
+    return stableProperties;
+}
 /**
  * Resolve browser PostHog config, or `undefined` when error capture should not
  * reach PostHog. Reads the SSR-injected shell config first, then Vite env for
@@ -1557,13 +1563,14 @@ export function trackEvent(name, params) {
         return;
     ensureSentry();
     const props = resolveProps(name, params);
+    const amplitudeProps = amplitudeEventProperties(name, props);
     window.gtag?.("event", name.replace(/\s+/g, "_"), props);
     if (ensureAmplitude()) {
-        _amplitudeModule?.track(name, props);
+        _amplitudeModule?.track(name, amplitudeProps);
     }
     else if (_amplitudeApiKey) {
         if (_pendingAmplitudeEvents.length < 100) {
-            _pendingAmplitudeEvents.push([name, props]);
+            _pendingAmplitudeEvents.push([name, amplitudeProps]);
         }
     }
     sendAgentNativeAnalytics(name, props);

package/dist/client/chat/tool-call-display.js

@@ -258,19 +258,19 @@ function ApprovalAffordance({ toolName, toolCallId, approval, }) {
     if (resolution === "denied") {
         return (_jsxs("div", { className: "mt-1.5 text-xs text-muted-foreground", children: ["Denied. ", toolName, " did not run."] }));
     }
-    return (_jsxs("div", { className: "mt-1.5 flex items-center gap-2 rounded-md border border-border bg-muted/40 px-2.5 py-1.5", children: [_jsx(IconShieldCheck, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" }), _jsxs("span", { className: "mr-auto text-xs text-muted-foreground", children: ["Approve to run ", toolName, "?"] }), ctx && (_jsxs("button", { type: "button", onClick: () => {
+    return (_jsxs("div", { className: "mt-1.5 flex min-w-0 flex-wrap items-center gap-2 rounded-md border border-border bg-muted/40 px-2.5 py-1.5", children: [_jsx(IconShieldCheck, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" }), _jsxs("span", { className: "min-w-0 flex-1 text-xs text-muted-foreground", children: ["Approve to run ", toolName, "?"] }), ctx && (_jsxs("button", { type: "button", onClick: () => {
                     setLocalResolution("approved");
                     ctx.onApprovalResolved?.(approval.approvalKey, "approved", toolCallId);
                     ctx.onApprove(approval.approvalKey);
-                }, className: cn("inline-flex items-center gap-1 rounded-md px-2.5 py-1 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90"), children: [_jsx(IconCheck, { className: "h-3.5 w-3.5" }), "Approve"] })), ctx?.onAlwaysAllow && (_jsxs("button", { type: "button", onClick: () => {
+                }, className: cn("inline-flex shrink-0 items-center gap-1 rounded-md px-2.5 py-1 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90"), children: [_jsx(IconCheck, { className: "h-3.5 w-3.5" }), "Approve"] })), ctx?.onAlwaysAllow && (_jsxs("button", { type: "button", onClick: () => {
                     setLocalResolution("approved");
                     ctx.onApprovalResolved?.(approval.approvalKey, "approved", toolCallId);
                     ctx.onAlwaysAllow?.(approval.approvalKey);
-                }, title: "Approve and always allow this exact command", className: cn("inline-flex items-center gap-1 rounded-md border border-border px-2.5 py-1 text-xs font-medium transition-colors", "text-foreground hover:bg-muted"), children: [_jsx(IconShieldCheck, { className: "h-3.5 w-3.5" }), "Always allow"] })), _jsxs("button", { type: "button", onClick: () => {
+                }, title: "Approve and always allow this exact command", className: cn("inline-flex shrink-0 items-center gap-1 rounded-md border border-border px-2.5 py-1 text-xs font-medium transition-colors", "text-foreground hover:bg-muted"), children: [_jsx(IconShieldCheck, { className: "h-3.5 w-3.5" }), "Always allow"] })), _jsxs("button", { type: "button", onClick: () => {
                     setLocalResolution("denied");
                     ctx?.onApprovalResolved?.(approval.approvalKey, "denied", toolCallId);
                     ctx?.onDeny?.(approval.approvalKey);
-                }, className: cn("inline-flex items-center gap-1 rounded-md border border-border px-2.5 py-1 text-xs font-medium transition-colors", "text-foreground hover:bg-muted"), children: [_jsx(IconX, { className: "h-3.5 w-3.5" }), "Deny"] })] }));
+                }, className: cn("inline-flex shrink-0 items-center gap-1 rounded-md border border-border px-2.5 py-1 text-xs font-medium transition-colors", "text-foreground hover:bg-muted"), children: [_jsx(IconX, { className: "h-3.5 w-3.5" }), "Deny"] })] }));
 }
 // ─── ToolCallDisplay ──────────────────────────────────────────────────────────
 export function ToolCallDisplay({ toolName, toolCallId, argsText, args, result, mcpApp, chatUI, isRunning, outcome, structuredMeta, activity, approval, repeatCount, isLatestRunning = isRunning, isActiveTail, }) {

package/dist/client/chat-first/apps-rail.js

@@ -5,6 +5,11 @@ import { memo, useMemo, useState } from "react";
 import { orderChatFirstAppIds, readChatFirstAppLayout, writeChatFirstAppLayout, } from "../chat-first.js";
 import { cn } from "../utils.js";
 import { defaultChatFirstCopy } from "./copy.js";
+function ChatFirstRailAppIcon({ app, activeAppId, renderIcon, }) {
+    const isActive = activeAppId !== undefined && activeAppId === app.id;
+    const isInactive = activeAppId !== undefined && !isActive;
+    return (_jsx("span", { "data-chat-first-app-icon": true, className: cn("transition-[filter]", isInactive && "grayscale"), children: renderIcon(app, { isActive, isInactive }) }));
+}
 function AppRows({ apps, activeAppId, layout, onDragStart, onDrop, onDragEnd, onOpenApp, onRemoveApp, onTogglePinned, onMove, renderIcon, copy, }) {
     const orderedIds = orderChatFirstAppIds(apps.map((app) => app.id), layout);
     const appsById = new Map(apps.map((app) => [app.id, app]));
@@ -16,7 +21,7 @@ function AppRows({ apps, activeAppId, layout, onDragStart, onDrop, onDragEnd, on
             const pinned = layout.pinnedIds.includes(app.id);
             const index = orderedApps.indexOf(app);
             return (_jsxs(ContextMenu, { children: [_jsx(ContextMenuTrigger, { asChild: true, children: _jsxs("li", { draggable: true, "data-chat-first-app": true, "data-app-id": app.id, className: cn("group flex h-8 w-full min-w-0 items-center gap-1 rounded-md px-0 text-sm", active
-                                ? "bg-sidebar-accent font-medium text-sidebar-accent-foreground"
+                                ? "font-medium text-sidebar-foreground"
                                 : "text-sidebar-foreground/75 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"), onDragStart: (event) => {
                                 event.dataTransfer.effectAllowed = "move";
                                 onDragStart(app.id);
@@ -31,7 +36,7 @@ function AppRows({ apps, activeAppId, layout, onDragStart, onDrop, onDragEnd, on
                                             event.preventDefault();
                                             onMove(app.id, 1);
                                         }
-                                    }, "aria-keyshortcuts": "Alt+ArrowUp Alt+ArrowDown", "aria-label": copy("openApp", { name: app.name }), children: [renderIcon(app), _jsx("span", { className: "truncate", children: app.name })] }), _jsx("button", { type: "button", className: cn("flex size-6 shrink-0 items-center justify-center rounded text-sidebar-foreground/45 opacity-0 hover:bg-sidebar-accent hover:text-sidebar-foreground group-hover:opacity-100 focus-visible:opacity-100", pinned && "text-sidebar-foreground/70 opacity-100"), "aria-label": copy(pinned ? "unpinApp" : "pinApp", {
+                                    }, "aria-keyshortcuts": "Alt+ArrowUp Alt+ArrowDown", "aria-label": copy("openApp", { name: app.name }), children: [_jsx(ChatFirstRailAppIcon, { app: app, activeAppId: activeAppId, renderIcon: renderIcon }), _jsx("span", { className: "truncate", children: app.name })] }), _jsx("button", { type: "button", className: cn("flex size-6 shrink-0 items-center justify-center rounded text-sidebar-foreground/45 opacity-0 hover:bg-sidebar-accent hover:text-sidebar-foreground group-hover:opacity-100 focus-visible:opacity-100", pinned && "text-sidebar-foreground/70 opacity-100"), "aria-label": copy(pinned ? "unpinApp" : "pinApp", {
                                         name: app.name,
                                     }), "aria-pressed": pinned, onClick: () => onTogglePinned(app.id), children: _jsx(IconPin, { size: 13, strokeWidth: pinned ? 2.2 : 1.6, "aria-hidden": "true" }) }), _jsx("span", { className: "sr-only", children: `${index + 1} of ${orderedApps.length}` })] }) }), _jsxs(ContextMenuContent, { children: [_jsxs(ContextMenuItem, { onSelect: () => onTogglePinned(app.id), children: [_jsx(IconPin, { size: 14, "aria-hidden": "true" }), pinned ? copy("removePinned") : copy("pinTop")] }), _jsx(ContextMenuSeparator, {}), _jsxs(ContextMenuItem, { disabled: index === 0, onSelect: () => onMove(app.id, -1), children: [_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" }), copy("moveUp")] }), _jsxs(ContextMenuItem, { disabled: index === orderedApps.length - 1, onSelect: () => onMove(app.id, 1), children: [_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" }), copy("moveDown")] }), onRemoveApp ? (_jsxs(_Fragment, { children: [_jsx(ContextMenuSeparator, {}), _jsxs(ContextMenuItem, { onSelect: () => onRemoveApp(app), className: "text-destructive focus:text-destructive", children: [_jsx(IconTrash, { size: 14, "aria-hidden": "true" }), copy("removeApp")] })] })) : null] })] }, app.id));
         }) }));
@@ -96,8 +101,8 @@ export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, activeA
         return (_jsxs("section", { "data-chat-first-apps-rail": true, className: "flex flex-col items-center gap-1 px-1.5 pt-2", "aria-label": copy("workspaceApps"), children: [createTrigger, loading && apps.length === 0
                     ? [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "size-9 rounded-md" }, index)))
                     : visibleApps.map((app) => (_jsx("button", { type: "button", "data-chat-first-app": true, "data-app-id": app.id, className: cn("flex size-9 items-center justify-center rounded-md", activeAppId === app.id
-                            ? "bg-sidebar-accent text-sidebar-accent-foreground"
-                            : "text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"), onClick: () => onOpenApp(app), "aria-label": copy("openApp", { name: app.name }), title: app.name, children: renderIcon(app) }, app.id))), onOpenAllApps ? (_jsx("button", { type: "button", "data-chat-first-all-apps": true, className: "flex size-9 items-center justify-center rounded-md text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground", onClick: onOpenAllApps, "aria-label": copy("allApps"), title: copy("allApps"), children: _jsx(IconApps, { size: 16, "aria-hidden": "true" }) })) : null, error ? (_jsx("span", { className: "size-1.5 rounded-full bg-destructive", title: error, "aria-label": error })) : null] }));
+                            ? "text-sidebar-foreground"
+                            : "text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"), onClick: () => onOpenApp(app), "aria-label": copy("openApp", { name: app.name }), title: app.name, children: _jsx(ChatFirstRailAppIcon, { app: app, activeAppId: activeAppId, renderIcon: renderIcon }) }, app.id))), onOpenAllApps ? (_jsx("button", { type: "button", "data-chat-first-all-apps": true, className: "flex size-9 items-center justify-center rounded-md text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground", onClick: onOpenAllApps, "aria-label": copy("allApps"), title: copy("allApps"), children: _jsx(IconApps, { size: 16, "aria-hidden": "true" }) })) : null, error ? (_jsx("span", { className: "size-1.5 rounded-full bg-destructive", title: error, "aria-label": error })) : null] }));
     }
     return (_jsxs("section", { "data-chat-first-apps-rail": true, className: "mt-3 px-2 pb-2 pt-2", "aria-label": copy("workspaceApps"), children: [_jsxs("div", { className: "mb-1 flex items-center gap-1.5 px-2 text-[11px] font-medium text-sidebar-foreground/50", children: [_jsx("span", { children: copy("workspaceApps") }), _jsx("span", { className: "ml-auto", children: createTrigger })] }), loading && apps.length === 0 ? (_jsx("div", { className: "space-y-0.5 px-2", children: [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "h-8 w-full rounded-md" }, index))) })) : apps.length === 0 ? (_jsxs("div", { className: "px-2", children: [_jsx("p", { className: "text-xs text-sidebar-foreground/55", children: copy("noWorkspaceApps") }), createAppTrigger ? (createTrigger) : onCreateApp ? (_jsxs("button", { type: "button", className: "mt-1 inline-flex h-6 items-center gap-1.5 rounded-md border border-sidebar-border px-2 text-xs text-sidebar-foreground/75 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onCreateApp, children: [_jsx(IconPlus, { size: 13, "aria-hidden": "true" }), copy("createApp")] })) : (createTrigger)] })) : (_jsx(AppRows, { apps: visibleApps, activeAppId: activeAppId, layout: layout, onDragStart: setDraggedAppId, onDrop: reorderApps, onDragEnd: () => setDraggedAppId(null), onOpenApp: onOpenApp, onRemoveApp: onRemoveApp, onTogglePinned: togglePinned, onMove: moveApp, renderIcon: renderIcon, copy: copy })), hasMoreApps || showAllApps ? (_jsxs("button", { type: "button", className: "mt-0.5 flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/50 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: () => setShowAllApps((value) => !value), children: [showAllApps ? (_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" })) : (_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" })), showAllApps ? copy("showLess") : copy("showMore")] })) : null, onOpenAllApps ? (_jsx("div", { className: "mt-1 border-t border-sidebar-border/60 pt-1", children: _jsxs("button", { type: "button", "data-chat-first-all-apps": true, className: "flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/55 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onOpenAllApps, children: [_jsx(IconApps, { size: 14, "aria-hidden": "true" }), _jsx("span", { children: copy("allApps") })] }) })) : null, error ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsxs("button", { type: "button", className: "mt-1 flex items-center gap-1 px-2 text-[10px] text-destructive/80", onClick: onRetry, "aria-label": error, children: [_jsx("span", { className: "size-1.5 rounded-full bg-destructive" }), onRetry ? copy("retry") : copy("appsLoadError")] }) }), _jsx(TooltipContent, { side: "right", children: error })] })) : null] }));
 });

package/dist/client/chat-first/primary-nav.d.ts

@@ -1,11 +1,12 @@
 import type { ChatFirstCopy } from "./types.js";
 export type ChatFirstPrimaryTab = "new-chat" | "integrations" | "scheduled";
-export declare function ChatFirstPrimaryNavigation({ onNewChat, onOpenIntegrations, onOpenScheduled, onSearch, activeTab, stickyNewChat, copy, }: {
+export declare function ChatFirstPrimaryNavigation({ onNewChat, onOpenIntegrations, onOpenScheduled, onSearch, activeTab, collapsed, stickyNewChat, copy, }: {
     onNewChat?: () => void;
     onOpenIntegrations: () => void;
     onOpenScheduled: () => void;
     onSearch?: () => void;
     activeTab?: ChatFirstPrimaryTab;
+    collapsed?: boolean;
     stickyNewChat?: boolean;
     copy?: ChatFirstCopy;
 }): import("react").JSX.Element;

package/dist/client/chat-first/primary-nav.js

@@ -1,13 +1,13 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { IconClock, IconPlus, IconPlugConnected, IconSearch, } from "@tabler/icons-react";
 import { defaultChatFirstCopy } from "./copy.js";
-export function ChatFirstPrimaryNavigation({ onNewChat, onOpenIntegrations, onOpenScheduled, onSearch, activeTab, stickyNewChat = false, copy = defaultChatFirstCopy, }) {
+export function ChatFirstPrimaryNavigation({ onNewChat, onOpenIntegrations, onOpenScheduled, onSearch, activeTab, collapsed = false, stickyNewChat = false, copy = defaultChatFirstCopy, }) {
     const tabClassName = (tab) => `flex h-8 w-full items-center gap-2 rounded-md px-2 text-[13px] font-medium transition-[background-color,color] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring ${activeTab === tab
         ? "bg-sidebar-accent text-sidebar-accent-foreground"
         : "text-sidebar-foreground/80 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"}`;
-    const renderTab = (tab, content, onSelect, className) => (_jsx("button", { type: "button", role: "tab", "aria-selected": activeTab === tab, className: [tabClassName(tab), className].filter(Boolean).join(" "), onClick: onSelect, children: content }));
+    const renderTab = (tab, content, onSelect, className) => (_jsx("button", { type: "button", role: "tab", "aria-selected": activeTab === tab, "aria-label": tab === "new-chat" ? copy("newChat") : undefined, title: tab === "new-chat" && collapsed ? copy("newChat") : undefined, className: [tabClassName(tab), className].filter(Boolean).join(" "), onClick: onSelect, children: content }));
     const newChatTab = onNewChat
-        ? renderTab("new-chat", _jsxs(_Fragment, { children: [_jsx(IconPlus, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("newChat") })] }), onNewChat, "code-agents-primary-new-chat")
+        ? renderTab("new-chat", _jsxs(_Fragment, { children: [_jsx(IconPlus, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { className: collapsed ? "sr-only" : undefined, children: copy("newChat") })] }), onNewChat, "code-agents-primary-new-chat")
         : null;
     const integrationsTab = renderTab("integrations", _jsxs(_Fragment, { children: [_jsx(IconPlugConnected, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("integrations") })] }), onOpenIntegrations);
     const scheduledTab = renderTab("scheduled", _jsxs(_Fragment, { children: [_jsx(IconClock, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("scheduled") })] }), onOpenScheduled);

package/dist/client/chat-first/types.d.ts

@@ -8,6 +8,10 @@ export interface ChatFirstAppItem {
     color?: string;
 }
 export type ChatFirstCopy = (key: string, values?: Record<string, string>) => string;
+export interface ChatFirstAppIconRenderOptions {
+    isActive: boolean;
+    isInactive: boolean;
+}
 export interface ChatFirstEmbedTarget {
     url: string;
     title?: string;
@@ -51,7 +55,7 @@ export interface ChatFirstAppRailProps {
     onOpenAllApps?: () => void;
     onCreateApp?: () => void;
     createAppTrigger?: ReactNode;
-    renderIcon: (app: ChatFirstAppItem) => ReactNode;
+    renderIcon: (app: ChatFirstAppItem, options?: ChatFirstAppIconRenderOptions) => ReactNode;
     copy?: ChatFirstCopy;
 }
 export interface ChatFirstBrowserPaneProps {

package/dist/client/markdown/InlineMarkdown.d.ts

@@ -0,0 +1,23 @@
+import type { ReactNode } from "react";
+export interface InlineMarkdownProps {
+    content: string;
+    className?: string;
+    linkClassName?: string;
+    codeClassName?: string;
+    inline?: boolean;
+    protectedSpans?: readonly InlineMarkdownProtectedSpan[];
+    renderProtectedSpan?: (span: InlineMarkdownProtectedSpan, children: ReactNode) => ReactNode;
+}
+export interface InlineMarkdownProtectedSpan {
+    source: string;
+    label: string;
+    className?: string;
+    title?: string;
+}
+/**
+ * Render user-authored Markdown for compact text surfaces.
+ *
+ * This intentionally has no block-level Markdown elements: headings, lists,
+ * quotes, and raw HTML are either flattened to their text or omitted.
+ */
+export declare function InlineMarkdown({ content, className, linkClassName, codeClassName, inline, protectedSpans, renderProtectedSpan, }: InlineMarkdownProps): import("react").JSX.Element;

package/dist/client/markdown/InlineMarkdown.js

@@ -0,0 +1,65 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import ReactMarkdown, { defaultUrlTransform, } from "react-markdown";
+import remarkGfm from "remark-gfm";
+import { cn } from "../utils.js";
+const INLINE_MARKDOWN_ELEMENTS = [
+    "a",
+    "br",
+    "code",
+    "del",
+    "em",
+    "p",
+    "s",
+    "strong",
+];
+/**
+ * Render user-authored Markdown for compact text surfaces.
+ *
+ * This intentionally has no block-level Markdown elements: headings, lists,
+ * quotes, and raw HTML are either flattened to their text or omitted.
+ */
+export function InlineMarkdown({ content, className, linkClassName, codeClassName, inline = false, protectedSpans = [], renderProtectedSpan, }) {
+    const protectedSpanByHref = new Map(protectedSpans
+        .map((span, index) => [`${PROTECTED_SPAN_PREFIX}${index}`, span])
+        .filter(([, span]) => span.source.length > 0));
+    const renderedContent = protectInlineMarkdownSpans(content, protectedSpans);
+    const components = {
+        a: ({ children, href }) => {
+            const protectedSpan = href ? protectedSpanByHref.get(href) : undefined;
+            if (protectedSpan) {
+                return renderProtectedSpan ? (renderProtectedSpan(protectedSpan, children)) : (_jsx("span", { className: protectedSpan.className, title: protectedSpan.title, children: children }));
+            }
+            const safeHref = href
+                ? defaultUrlTransform(normalizeInlineMarkdownHref(href))
+                : "";
+            if (!safeHref)
+                return _jsx(_Fragment, { children: children });
+            return (_jsx("a", { href: safeHref, target: "_blank", rel: "noopener noreferrer", className: cn("text-primary underline-offset-2 hover:underline", linkClassName), children: children }));
+        },
+        code: ({ children, className: syntaxClassName }) => (_jsx("code", { className: cn("rounded bg-muted px-1 py-0.5 font-mono text-[0.9em]", syntaxClassName, codeClassName), children: children })),
+        p: ({ children }) => inline ? _jsx("span", { children: children }) : _jsx("p", { className: "m-0", children: children }),
+    };
+    const Root = inline ? "span" : "div";
+    return (_jsx(Root, { className: cn("whitespace-pre-wrap break-words", className), children: _jsx(ReactMarkdown, { allowedElements: INLINE_MARKDOWN_ELEMENTS, components: components, remarkPlugins: [remarkGfm], skipHtml: true, unwrapDisallowed: true, children: renderedContent }) }));
+}
+const PROTECTED_SPAN_PREFIX = "https://inline-markdown-protected.invalid/span/";
+function protectInlineMarkdownSpans(content, spans) {
+    return [...spans]
+        .map((span, index) => ({ span, index }))
+        .filter(({ span }) => span.source.length > 0)
+        .sort((a, b) => b.span.source.length - a.span.source.length)
+        .reduce((markdown, { span, index }) => markdown
+        .split(span.source)
+        .join(`[${escapeProtectedSpanLabel(span.label)}](${PROTECTED_SPAN_PREFIX}${index})`), content);
+}
+function escapeProtectedSpanLabel(label) {
+    return label.replace(/[\\[\]]/g, "\\$&");
+}
+function normalizeInlineMarkdownHref(href) {
+    if (/^www\./i.test(href))
+        return `https://${href}`;
+    if (/^http:\/\/www\./i.test(href)) {
+        return `https://${href.slice("http://".length)}`;
+    }
+    return href;
+}

package/dist/client/markdown/index.d.ts

@@ -0,0 +1 @@
+export { InlineMarkdown, type InlineMarkdownProtectedSpan, type InlineMarkdownProps, } from "./InlineMarkdown.js";

package/dist/client/markdown/index.js

@@ -0,0 +1 @@
+export { InlineMarkdown, } from "./InlineMarkdown.js";

package/dist/client/review/ReviewThreadPanel.js

@@ -8,6 +8,7 @@ import { Spinner } from "@agent-native/toolkit/ui/spinner";
 import { IconCircleCheck, IconDots, IconMessageCircle, IconSend, IconTrash, IconX, } from "@tabler/icons-react";
 import { useMemo, useState } from "react";
 import { useFormatters } from "../i18n.js";
+import { InlineMarkdown } from "../markdown/index.js";
 import { cn } from "../utils.js";
 import { ReviewCommentComposer } from "./ReviewCommentComposer.js";
 import { ReviewStatusBadge } from "./ReviewStatusBadge.js";
@@ -126,7 +127,7 @@ function CommentBubble({ comment, compact = false, resolvedLabel, reviewerLabel,
     const bodyIsResolutionNote = resolutionNote !== null &&
         resolutionNote === comment.body.trim() &&
         isResolutionNoteMetadata(comment.metadata);
-    return (_jsxs("div", { className: "flex min-w-0 items-start gap-2.5", children: [_jsx(Avatar, { className: compact ? "size-5" : "size-7", children: _jsx(AvatarFallback, { className: "text-[10px] font-semibold text-muted-foreground", children: authorInitials(author) }) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [_jsx("span", { className: "truncate text-sm font-medium", children: author }), _jsx("time", { className: "shrink-0 text-[11px] text-muted-foreground", dateTime: comment.createdAt, children: formatCommentDate(comment.createdAt, formatDate) }), comment.status === "resolved" ? (_jsx("span", { className: "hidden shrink-0 rounded-full bg-muted px-1.5 py-0.5 text-[10px] font-medium text-muted-foreground @xs/review:inline-flex", children: resolvedLabel })) : null] }), !bodyIsResolutionNote ? (_jsx("p", { className: cn("mt-1 whitespace-pre-wrap break-words text-foreground", compact ? "text-xs leading-5" : "text-sm leading-5"), children: comment.body })) : null, resolutionNote ? (_jsxs("div", { className: "mt-1.5 flex min-w-0 items-start gap-1.5 rounded-md bg-muted/60 px-2 py-1.5 text-muted-foreground", "aria-label": resolvedLabel, children: [_jsx(IconCircleCheck, { className: "mt-0.5 size-3.5 shrink-0" }), _jsx("p", { className: "min-w-0 whitespace-pre-wrap break-words text-xs leading-4", children: resolutionNote })] })) : null] })] }));
+    return (_jsxs("div", { className: "flex min-w-0 items-start gap-2.5", children: [_jsx(Avatar, { className: compact ? "size-5" : "size-7", children: _jsx(AvatarFallback, { className: "text-[10px] font-semibold text-muted-foreground", children: authorInitials(author) }) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [_jsx("span", { className: "truncate text-sm font-medium", children: author }), _jsx("time", { className: "shrink-0 text-[11px] text-muted-foreground", dateTime: comment.createdAt, children: formatCommentDate(comment.createdAt, formatDate) }), comment.status === "resolved" ? (_jsx("span", { className: "hidden shrink-0 rounded-full bg-muted px-1.5 py-0.5 text-[10px] font-medium text-muted-foreground @xs/review:inline-flex", children: resolvedLabel })) : null] }), !bodyIsResolutionNote ? (_jsx(InlineMarkdown, { content: comment.body, className: cn("mt-1 text-foreground", compact ? "text-xs leading-5" : "text-sm leading-5") })) : null, resolutionNote ? (_jsxs("div", { className: "mt-1.5 flex min-w-0 items-start gap-1.5 rounded-md bg-muted/60 px-2 py-1.5 text-muted-foreground", "aria-label": resolvedLabel, children: [_jsx(IconCircleCheck, { className: "mt-0.5 size-3.5 shrink-0" }), _jsx(InlineMarkdown, { content: resolutionNote, className: "min-w-0 text-xs leading-4" })] })) : null] })] }));
 }
 function capabilityAllowsThread(capability, thread) {
     return typeof capability === "function" ? capability(thread) : capability;

package/dist/client/run-stream-ownership.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Exactly one SSE reader may fold a given run into UI state.
+ *
+ * Two readers attach to the same run routinely: the chat adapter's own stream,
+ * and AssistantChat's reconnect reader for runs with no live adapter stream
+ * (page reload, tab restore). When both are attached they build two independent
+ * accumulators from the same events, and the UI renders both — duplicate tool
+ * cards (one spinning, one static) and the same assistant text streaming twice.
+ *
+ * The previous guard read a React ref (`isRuntimeRunningRef`) at attach time and
+ * re-checked it from a 1s poll. That is a race, not a lock: the ref lags a
+ * render behind, the poll is skipped while the tab is hidden, and the refs were
+ * per-component-instance while MultiTabAssistantChat mounts several instances
+ * against one run. Ownership therefore lives here — module scope, one registry
+ * per browser tab, claimed and checked synchronously.
+ *
+ * Claims are advisory in one direction only: a reader that does not hold the
+ * claim must not mutate UI state. It may still drain its socket to completion.
+ */
+/** Mint a token identifying one reader. Not shared between readers. */
+export declare function createRunStreamToken(label?: string): symbol;
+/**
+ * Take ownership of a run's UI fold. Returns false when another live reader
+ * already holds it — the caller must not attach, or must attach read-only.
+ * Re-claiming with the same token is a no-op success so retry loops are safe.
+ */
+export declare function claimRunStream(threadId: string, runId: string, token: symbol): boolean;
+/**
+ * Take ownership even if another reader holds it, and return whether the claim
+ * changed hands. The adapter's own stream outranks the reconnect fallback: when
+ * the user sends a message the adapter legitimately becomes the owner, and the
+ * displaced reader learns it lost via `ownsRunStream`.
+ */
+export declare function preemptRunStream(threadId: string, runId: string, token: symbol): boolean;
+export declare function ownsRunStream(threadId: string, runId: string, token: symbol): boolean;
+/** Release only if still held by this token, so a late unmount cannot free a successor's claim. */
+export declare function releaseRunStream(threadId: string, runId: string, token: symbol): void;
+/** Test seam. */
+export declare function __resetRunStreamOwnership(): void;

package/dist/client/run-stream-ownership.js

@@ -0,0 +1,65 @@
+/**
+ * Exactly one SSE reader may fold a given run into UI state.
+ *
+ * Two readers attach to the same run routinely: the chat adapter's own stream,
+ * and AssistantChat's reconnect reader for runs with no live adapter stream
+ * (page reload, tab restore). When both are attached they build two independent
+ * accumulators from the same events, and the UI renders both — duplicate tool
+ * cards (one spinning, one static) and the same assistant text streaming twice.
+ *
+ * The previous guard read a React ref (`isRuntimeRunningRef`) at attach time and
+ * re-checked it from a 1s poll. That is a race, not a lock: the ref lags a
+ * render behind, the poll is skipped while the tab is hidden, and the refs were
+ * per-component-instance while MultiTabAssistantChat mounts several instances
+ * against one run. Ownership therefore lives here — module scope, one registry
+ * per browser tab, claimed and checked synchronously.
+ *
+ * Claims are advisory in one direction only: a reader that does not hold the
+ * claim must not mutate UI state. It may still drain its socket to completion.
+ */
+const owners = new Map();
+function runKey(threadId, runId) {
+    return `${threadId} ${runId}`;
+}
+/** Mint a token identifying one reader. Not shared between readers. */
+export function createRunStreamToken(label) {
+    return Symbol(label ?? "run-stream-reader");
+}
+/**
+ * Take ownership of a run's UI fold. Returns false when another live reader
+ * already holds it — the caller must not attach, or must attach read-only.
+ * Re-claiming with the same token is a no-op success so retry loops are safe.
+ */
+export function claimRunStream(threadId, runId, token) {
+    const key = runKey(threadId, runId);
+    const current = owners.get(key);
+    if (current && current !== token)
+        return false;
+    owners.set(key, token);
+    return true;
+}
+/**
+ * Take ownership even if another reader holds it, and return whether the claim
+ * changed hands. The adapter's own stream outranks the reconnect fallback: when
+ * the user sends a message the adapter legitimately becomes the owner, and the
+ * displaced reader learns it lost via `ownsRunStream`.
+ */
+export function preemptRunStream(threadId, runId, token) {
+    const key = runKey(threadId, runId);
+    const current = owners.get(key);
+    owners.set(key, token);
+    return current !== token;
+}
+export function ownsRunStream(threadId, runId, token) {
+    return owners.get(runKey(threadId, runId)) === token;
+}
+/** Release only if still held by this token, so a late unmount cannot free a successor's claim. */
+export function releaseRunStream(threadId, runId, token) {
+    const key = runKey(threadId, runId);
+    if (owners.get(key) === token)
+        owners.delete(key);
+}
+/** Test seam. */
+export function __resetRunStreamOwnership() {
+    owners.clear();
+}

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,9 +77,9 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
-    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
+    error?: undefined;
 }>>;

package/dist/collab/struct-routes.d.ts

@@ -13,8 +13,8 @@
  * Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
  */
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;