@agent-native/toolkit 0.204.0 → 0.204.1-nightly-20261008065100

package/src/app/chat/AgentKitAssistantChat.spec.tsx

@@ -849,6 +849,63 @@ describe("AgentKitAssistantChat host behavior", () => {
     );
   });
 
+  it("uses a sanitized first-message fallback when the thread title is blank", async () => {
+    const savedSnapshots = vi.fn();
+    const message = {
+      id: "message-user-title-fallback",
+      role: "user",
+      status: "complete",
+      createdAt: "2026-10-07T12:00:00.000Z",
+      parts: [
+        {
+          type: "text",
+          text: 'Summarize @[the sprint|resource:123]\n<context data-agentkit-context-encoding="entities-v1">Private context</context>',
+        },
+      ],
+    };
+    chatMocks.thread = {
+      ...chatMocks.thread,
+      thread: {
+        id: chatMocks.threadId,
+        title: "",
+        createdAt: message.createdAt,
+        updatedAt: message.createdAt,
+      },
+      messages: [message],
+      events: [],
+      activeRunIds: [],
+      runs: {},
+      approvals: {},
+      approvalRunIds: {},
+      connectionRequests: {},
+      connectionRequestRunIds: {},
+      tools: {},
+      activities: {},
+      queuedMessages: [],
+      tasks: {},
+      taskGroups: {},
+      widgets: {},
+      widgetMessageIds: {},
+      annotations: {},
+      annotationMessageIds: {},
+      agents: {},
+      agentInteractions: [],
+      artifacts: [],
+    };
+
+    const props = baseProps({
+      onSaveThread: savedSnapshots,
+      runtime: {} as never,
+    });
+    await mount(props);
+    await act(async () => root.render(null));
+
+    expect(savedSnapshots).toHaveBeenCalledWith(
+      chatMocks.threadId,
+      expect.objectContaining({ title: "Summarize @the sprint" }),
+    );
+  });
+
   it("shows a retry when chat history fails to load", async () => {
     const retryHistory = vi.fn();
     chatMocks.history = {
@@ -897,6 +954,38 @@ describe("AgentKitAssistantChat host behavior", () => {
     expect(container.querySelector('[role="status"]')?.textContent).toBe(
       "agentChat.status.thinking",
     );
+    expect(
+      container.querySelector("[data-agentkit-active-run-id-copy]"),
+    ).toBeNull();
+  });
+
+  it("shows and copies the active run ID as soon as it becomes available", async () => {
+    const props = baseProps();
+    await mount(props);
+
+    expect(
+      container.querySelector("[data-agentkit-active-run-id-copy]"),
+    ).toBeNull();
+
+    chatMocks.thread = { ...chatMocks.thread, activeRunIds: ["run-active"] };
+    await act(async () => root.render(<AgentKitAssistantChat {...props} />));
+
+    const copyRequestIdButton = container.querySelector(
+      '[data-agentkit-active-run-id-copy] button[aria-label="agentChat.message.copyRequestId"]',
+    );
+    expect(copyRequestIdButton).toBeTruthy();
+
+    await act(async () => {
+      copyRequestIdButton?.click();
+      await Promise.resolve();
+    });
+
+    expect(chatMocks.writeClipboardText).toHaveBeenCalledWith("run-active");
+    expect(
+      container.querySelector(
+        '[data-agentkit-active-run-id-copy] button[aria-label="agentChat.common.copied"]',
+      ),
+    ).toBeTruthy();
   });
 
   it("does not duplicate Thinking after the run becomes active", async () => {
@@ -4015,11 +4104,18 @@ describe("AgentKitAssistantChat host behavior", () => {
       createdAt: "2026-09-26T12:00:01.000Z",
       parts: [{ type: "text", text: "Assistant answer survives handoff" }],
     };
+    const followupUserMessage = {
+      id: "handoff-followup-user-message",
+      role: "user",
+      status: "complete",
+      createdAt: "2026-09-26T12:00:02.000Z",
+      parts: [{ type: "text", text: "Save after handoff" }],
+    };
     chatMocks.threadId = threadId;
     chatMocks.thread = {
       thread: {
         id: threadId,
-        title: "Handoff thread",
+        title: "",
         createdAt: message.createdAt,
         updatedAt: message.createdAt,
       },
@@ -4056,7 +4152,13 @@ describe("AgentKitAssistantChat host behavior", () => {
 
     await act(async () => root.render(null));
     expect(savedSnapshots).toHaveBeenCalledOnce();
-
+    expect(savedSnapshots).toHaveBeenCalledWith(
+      threadId,
+      expect.objectContaining({
+        title: "Keep this transcript visible",
+        titleSource: "fallback",
+      }),
+    );
     const fetch = vi.fn(async () => new Response(null, { status: 404 }));
     const runtime = {
       id: "handoff-test",
@@ -4092,23 +4194,23 @@ describe("AgentKitAssistantChat host behavior", () => {
     chatMocks.createTransport.mockImplementation((options: any) =>
       createAgentNativeAgentKitTransport({ ...options, runtime, fetch }),
     );
-    await act(async () => {
-      root.render(
-        <AgentKitAssistantChat
-          {...baseProps({
-            threadId,
-            browserTabId,
-            isNewThread: false,
-            onSaveThread: savedSnapshots,
-            centerComposerWhenEmpty: true,
-            suggestionPlacement: "context-chips",
-            homeIntroSlot: <h1>What should we do?</h1>,
-            afterComposerSlot: <div data-testid="home-app-grid" />,
-            suggestions: ["Explore my apps"],
-          })}
-        />,
-      );
+    const restoredProps = baseProps({
+      threadId,
+      browserTabId,
+      isNewThread: false,
+      onSaveThread: savedSnapshots,
+      centerComposerWhenEmpty: true,
+      suggestionPlacement: "context-chips",
+      homeIntroSlot: <h1>What should we do?</h1>,
+      afterComposerSlot: <div data-testid="home-app-grid" />,
+      suggestions: ["Explore my apps"],
     });
+    const restoredRef = createRef<any>();
+    await act(async () =>
+      root.render(
+        <AgentKitAssistantChat {...restoredProps} ref={restoredRef} />,
+      ),
+    );
 
     expect(container.textContent).toContain("Keep this transcript visible");
     expect(container.textContent).toContain(
@@ -4122,6 +4224,10 @@ describe("AgentKitAssistantChat host behavior", () => {
     const handoff = await chatMocks.rootProps.transport.getThreadSnapshot({
       threadId,
     });
+    expect(handoff).toMatchObject({
+      title: "Keep this transcript visible",
+      titleSource: "fallback",
+    });
     expect(handoff.messages[0].parts).toContainEqual({
       type: "text",
       text: "Keep this transcript visible",
@@ -4131,6 +4237,22 @@ describe("AgentKitAssistantChat host behavior", () => {
       text: "Assistant answer survives handoff",
     });
     expect(fetch).not.toHaveBeenCalled();
+
+    chatMocks.thread = {
+      ...chatMocks.thread,
+      thread: handoff,
+      messages: [...handoff.messages, followupUserMessage],
+    };
+    await act(async () =>
+      root.render(
+        <AgentKitAssistantChat {...restoredProps} ref={restoredRef} />,
+      ),
+    );
+    const restoredSurfaceSnapshot = restoredRef.current?.exportThreadSnapshot();
+    expect(restoredSurfaceSnapshot).toMatchObject({
+      title: "Keep this transcript visible",
+      titleSource: "fallback",
+    });
   });
 
   it("keeps transient thread-restore errors retryable without clearing the tab", async () => {

package/src/app/chat/AgentKitAssistantChat.tsx

@@ -83,9 +83,12 @@ import {
   realtimeVoiceTranscriptRegistry,
   type RealtimeVoiceTranscriptMessage,
 } from "@agent-native/toolkit/composer/realtime-voice-transcript";
+import { IconButton } from "@agent-native/toolkit/design-system";
 import { cn } from "@agent-native/toolkit/utils";
 import {
   IconAlertTriangle,
+  IconCircleCheck,
+  IconCopy,
   IconLoader2,
   IconMessage,
   IconPlayerStopFilled,
@@ -169,7 +172,10 @@ import {
 } from "./chat/tool-call-display.js";
 import { resolveAgentKitToolSource } from "./chat/tool-integration.js";
 import { ExternalAgentNudge } from "./external-agent-host.js";
+import { fallbackChatTitle } from "./fallback-chat-title.js";
+import { formatFeedbackReport } from "./feedback-report.js";
 import { FileStorageSetupPopover } from "./FileStorageSetupPopover.js";
+import { reconcileSettledRun } from "./reconcile-settled-run.js";
 import { RunStuckBanner } from "./RunStuckBanner.js";
 import { ThinkingDisplayProvider } from "./thinking-display.js";
 
@@ -200,9 +206,12 @@ const DEFERRED_PROVIDER_SUBMISSION_CLAIM_TTL_MS = 15 * 60 * 1000;
 const DEFERRED_PROVIDER_SUBMISSION_MAX_RETRIES = 3;
 const DEFERRED_PROVIDER_SUBMISSIONS_KEY_PREFIX =
   "agentkit-deferred-provider-submissions:";
+type AgentKitHandoffThreadSnapshot = AgentThreadSnapshot & {
+  titleSource?: "fallback";
+};
 const threadHandoffSnapshots = new Map<
   string,
-  { snapshot: AgentThreadSnapshot; expiresAt: number }
+  { snapshot: AgentKitHandoffThreadSnapshot; expiresAt: number }
 >();
 const deferredProviderSubmissionOperations = new Map<
   string,
@@ -856,6 +865,11 @@ export const AgentKitAssistantChat = forwardRef<
         shortcut: "{{shortcut}}",
       }),
       feedbackSubmit: t("agentChat.feedback.submit"),
+      feedbackReasonMisread: t("agentChat.feedback.reasonMisread"),
+      feedbackReasonNotDone: t("agentChat.feedback.reasonNotDone"),
+      feedbackReasonWrongNumbers: t("agentChat.feedback.reasonWrongNumbers"),
+      feedbackReasonTooSlow: t("agentChat.feedback.tooSlow"),
+      feedbackCopyDetails: t("agentChat.feedback.copyDetails"),
       fork: t("agentChat.message.forkChat"),
       previousBranch: t("agentChat.message.previousBranch"),
       nextBranch: t("agentChat.message.nextBranch"),
@@ -863,6 +877,8 @@ export const AgentKitAssistantChat = forwardRef<
       error: t("agentChat.error.failed"),
       renderError: t("agentChat.error.render"),
       runFailed: t("agentChat.error.failed"),
+      continueRun: t("agentChat.common.continue"),
+      continueRunUnavailable: t("agentChat.recovery.continueUnavailable"),
       reconnect: t("agentChat.agentPanel.chatgptSubscriptionReconnect"),
       reasoning: t("agentChat.status.thinking"),
       expandActivity: t("agentChat.common.expand"),
@@ -1202,6 +1218,7 @@ export const AgentKitAssistantChat = forwardRef<
           labels={labels}
           branchNavigation={props.branchNavigation}
           loadRunUsage={loadRunUsage}
+          buildFeedbackReport={formatFeedbackReport}
           onThreadForked={(thread) => props.onForkedThread?.(thread.id)}
           onCopyMessage={({ text }) => {
             const html = renderMarkdownToClipboardHtml(text);
@@ -1522,6 +1539,15 @@ const AgentKitAssistantChatBody = forwardRef<
     () => hasActiveAgentRuns(controller.getThread(threadId)),
     [controller, threadId],
   );
+  const reconcileServerSettled = useCallback(
+    () =>
+      reconcileSettledRun({
+        load: control.load,
+        getThread: () => controller.getThread(threadId),
+        tabId: props.tabId ?? threadId,
+      }),
+    [control.load, controller, props.tabId, threadId],
+  );
 
   useEffect(() => {
     if (previousPrefillRevisionRef.current === prefillRevision) return;
@@ -3141,6 +3167,7 @@ const AgentKitAssistantChatBody = forwardRef<
           )
         }
         isAwaitingResponse={() => isRunning}
+        onServerSettled={reconcileServerSettled}
         onRetry={() =>
           void sendRecoveryMessage(RECOVERY_CONTINUE_PROMPT, "continue")
         }
@@ -3369,6 +3396,32 @@ function AgentKitTranscript({ children, threadId }: AgentKitRegionRenderProps) {
   const threadMessageIds = new Set(
     thread.messages.map((message) => message.id),
   );
+  const activeRunId = thread.activeRunIds.at(-1);
+  const [requestIdCopyFeedback, setRequestIdCopyFeedback] = useState<{
+    runId: string;
+    status: "copied" | "failed";
+  } | null>(null);
+  const activeRunRequestIdCopyStatus =
+    requestIdCopyFeedback && requestIdCopyFeedback.runId === activeRunId
+      ? requestIdCopyFeedback.status
+      : null;
+  useEffect(() => {
+    if (!requestIdCopyFeedback) return;
+    const timeout = setTimeout(() => setRequestIdCopyFeedback(null), 1_400);
+    return () => clearTimeout(timeout);
+  }, [requestIdCopyFeedback]);
+  const copyActiveRunRequestId = async () => {
+    if (!activeRunId) return;
+    try {
+      const copied = await writeClipboardText(activeRunId);
+      setRequestIdCopyFeedback({
+        runId: activeRunId,
+        status: copied ? "copied" : "failed",
+      });
+    } catch {
+      setRequestIdCopyFeedback({ runId: activeRunId, status: "failed" });
+    }
+  };
   const lastMessage = thread.messages.at(-1);
   const showThinking =
     surface.isSubmissionInFlight &&
@@ -3538,6 +3591,46 @@ function AgentKitTranscript({ children, threadId }: AgentKitRegionRenderProps) {
         surface.props.tabId,
       )}
       {children}
+      {activeRunId ? (
+        <div
+          className="agentkit-activities-static"
+          data-agentkit-active-run-id-copy="true"
+        >
+          <IconButton
+            label={
+              activeRunRequestIdCopyStatus === "copied"
+                ? t("agentChat.common.copied")
+                : activeRunRequestIdCopyStatus === "failed"
+                  ? t("agentChat.recovery.copyFailed")
+                  : t("agentChat.message.copyRequestId")
+            }
+            title={t("agentChat.message.copyRequestId")}
+            icon={
+              activeRunRequestIdCopyStatus === "copied" ? (
+                <IconCircleCheck aria-hidden="true" />
+              ) : activeRunRequestIdCopyStatus === "failed" ? (
+                <IconAlertTriangle aria-hidden="true" />
+              ) : (
+                <IconCopy aria-hidden="true" />
+              )
+            }
+            size="compact"
+            onPress={() => void copyActiveRunRequestId()}
+          />
+          {activeRunRequestIdCopyStatus ? (
+            <span
+              className="sr-only"
+              role={
+                activeRunRequestIdCopyStatus === "failed" ? "alert" : "status"
+              }
+            >
+              {activeRunRequestIdCopyStatus === "copied"
+                ? t("agentChat.common.copied")
+                : t("agentChat.recovery.copyFailed")}
+            </span>
+          ) : null}
+        </div>
+      ) : null}
       {handoffMessages.map((message) => (
         <AgentMessageView
           key={message.id}
@@ -4607,6 +4700,7 @@ function AgentKitRunFailure({
   const surface = useAgentKitSurface();
   const t = useT();
   const [dismissed, setDismissed] = useState<string | null>(null);
+  const [continueFailed, setContinueFailed] = useState(false);
   const authErrorReason =
     error.code === "unauthorized" || error.code === "http_401"
       ? "session-expired"
@@ -4690,6 +4784,17 @@ function AgentKitRunFailure({
     );
   }
   if (wasRetried(thread.messages, runId)) return null;
+  // Continuing resumes the stopped run's own turn, so finished steps are not
+  // run again; that needs it to still be the turn's newest run.
+  const continueStoppedRun = control.canContinueRun
+    ? superseded
+      ? undefined
+      : () => {
+          setContinueFailed(false);
+          control.continueRun(runId).catch(() => setContinueFailed(true));
+        }
+    : () =>
+        void surface.sendRecoveryMessage(RECOVERY_CONTINUE_PROMPT, "continue");
   const info: RunErrorInfo = {
     message: formatAgentKitErrorText(error, t),
     errorCode: error.code,
@@ -4700,8 +4805,9 @@ function AgentKitRunFailure({
   return (
     <RunErrorRecoveryCard
       info={info}
-      onContinue={() =>
-        void surface.sendRecoveryMessage(RECOVERY_CONTINUE_PROMPT, "continue")
+      onContinue={continueStoppedRun}
+      continueError={
+        continueFailed ? t("agentChat.recovery.continueUnavailable") : null
       }
       onRetry={() => void retryFailedTurn()}
       retryHasUnavailableAttachment={retryRequest.hasUnavailableAttachment}
@@ -5334,7 +5440,13 @@ function createAgentKitThreadSnapshot(thread: AgentThreadState) {
     agentMessageText(
       [...messages].reverse().find((message) => message.role === "user")!,
     );
-  const title = thread.thread?.title ?? firstUserText?.slice(0, 80) ?? "";
+  const handoffThread = thread.thread as AgentKitHandoffThreadSnapshot | null;
+  const savedTitle = handoffThread?.title?.trim();
+  const titleSource: "fallback" | undefined =
+    !savedTitle || handoffThread?.titleSource === "fallback"
+      ? "fallback"
+      : undefined;
+  const title = savedTitle || fallbackChatTitle(firstUserText ?? "");
   const runs = Object.entries(thread.runs).map(([id, run]) => ({
     ...run,
     id,
@@ -5356,6 +5468,7 @@ function createAgentKitThreadSnapshot(thread: AgentThreadState) {
       agentKit,
     }),
     title,
+    ...(titleSource ? { titleSource } : {}),
     preview: (latestUserText ?? "").slice(0, 280),
     messageCount: messages.length,
   };
@@ -5389,7 +5502,7 @@ function createAgentKitThreadHandoffKey(
 function readAgentKitThreadHandoffSnapshot(
   key: string,
   consume = false,
-): AgentThreadSnapshot | null {
+): AgentKitHandoffThreadSnapshot | null {
   const entry = threadHandoffSnapshots.get(key);
   if (!entry) return null;
   if (entry.expiresAt <= Date.now()) {
@@ -5413,10 +5526,13 @@ function storeAgentKitThreadHandoffSnapshot(
   if (!messages.length) return;
 
   const now = new Date().toISOString();
-  const handoff: AgentThreadSnapshot = {
+  const handoff: AgentKitHandoffThreadSnapshot = {
     ...(thread.thread ?? {}),
     id: thread.id,
     title: snapshot.title || thread.thread?.title,
+    ...(snapshot.titleSource === "fallback"
+      ? { titleSource: "fallback" as const }
+      : {}),
     createdAt: thread.thread?.createdAt ?? messages[0]?.createdAt ?? now,
     updatedAt: thread.thread?.updatedAt ?? messages.at(-1)?.createdAt ?? now,
     messages,
@@ -5617,7 +5733,7 @@ function appendVoiceTranscriptsToThreadSnapshot(
     }),
     title:
       snapshot.title ||
-      (firstUser ? agentMessageText(firstUser).slice(0, 80) : ""),
+      (firstUser ? fallbackChatTitle(agentMessageText(firstUser)) : ""),
     preview: latestUser ? agentMessageText(latestUser).slice(0, 280) : "",
     messageCount: messages.length,
   };

package/src/app/chat/AgentPanel.header.spec.ts

@@ -9,7 +9,7 @@ import {
 } from "@agent-native/toolkit/ui/dropdown-menu";
 import React, { act } from "react";
 import { createRoot, type Root } from "react-dom/client";
-import { MemoryRouter, useLocation } from "react-router";
+import { MemoryRouter, useHref, useLocation } from "react-router";
 import { describe, expect, it, vi } from "vitest";
 
 import {
@@ -445,6 +445,45 @@ describe("AgentPanel settings navigation", () => {
     }
   });
 
+  it("keeps a settings request inside the mounted app path", () => {
+    const container = document.createElement("div");
+    document.body.appendChild(container);
+    const root: Root = createRoot(container);
+    let href = "";
+
+    function LocationProbe() {
+      const location = useLocation();
+      href = useHref(`${location.pathname}${location.hash}`);
+      return null;
+    }
+
+    try {
+      vi.stubEnv("VITE_APP_BASE_PATH", "/dispatch");
+      act(() => {
+        window.history.replaceState(null, "", "/dispatch/chat#llm");
+        root.render(
+          React.createElement(
+            MemoryRouter,
+            { basename: "/dispatch", initialEntries: ["/dispatch/chat#llm"] },
+            React.createElement(AgentPanelSettingsNavigation),
+            React.createElement(LocationProbe),
+          ),
+        );
+      });
+
+      act(() => {
+        window.dispatchEvent(new CustomEvent("agent-panel:open-settings"));
+      });
+
+      expect(href).toBe("/dispatch/settings#llm");
+    } finally {
+      act(() => root.unmount());
+      container.remove();
+      window.history.replaceState(null, "", "/");
+      vi.unstubAllEnvs();
+    }
+  });
+
   it("routes a mounted settings request to an existing secret-specific hash", () => {
     const container = document.createElement("div");
     document.body.appendChild(container);
@@ -532,7 +571,7 @@ describe("AgentPanel settings navigation", () => {
     }
   });
 
-  it("preserves the app base path when opening settings", () => {
+  it("navigates with a router-local settings path", () => {
     const container = document.createElement("div");
     document.body.appendChild(container);
     const root: Root = createRoot(container);
@@ -545,11 +584,10 @@ describe("AgentPanel settings navigation", () => {
 
     try {
       act(() => {
-        window.history.replaceState(null, "", "/dispatch/_agent-native/poll");
         root.render(
           React.createElement(
             MemoryRouter,
-            { initialEntries: ["/"] },
+            { initialEntries: ["/chat"] },
             React.createElement(AgentPanelSettingsNavigation),
             React.createElement(LocationProbe),
           ),
@@ -564,11 +602,10 @@ describe("AgentPanel settings navigation", () => {
         );
       });
 
-      expect(pathname).toBe("/dispatch/settings");
+      expect(pathname).toBe("/settings");
     } finally {
       act(() => root.unmount());
       container.remove();
-      window.history.replaceState(null, "", "/");
     }
   });
 
@@ -1134,7 +1171,6 @@ describe("AgentChatSurface chrome defaults", () => {
     expect(source).not.toContain("SettingsPanel");
     expect(source).not.toContain("allowSettingsMode");
     expect(source).not.toContain('mode === "settings"');
-    expect(source).toContain('pathname: appPath("/settings")');
   });
 
   it("mounts URL command sync for a full-page chat surface", () => {

package/src/app/chat/AgentPanel.tsx

@@ -199,7 +199,7 @@ export function AgentPanelSettingsNavigation({
       const requested = requestedSettingsSection(section, window.location.hash);
       const navigation = navigate(
         {
-          pathname: appPath("/settings"),
+          pathname: "/settings",
           hash: settingsRouteHashForSection(section, window.location.hash),
         },
         // The hash can't tell API keys from Integrations; the redesigned

package/src/app/chat/MultiTabAssistantChat.spec.tsx

@@ -85,6 +85,13 @@ const assistantChatMockState = vi.hoisted(() => ({
   onRetryModelList: undefined as (() => void) | undefined,
   onSlashCommand: undefined as ((command: string) => void) | undefined,
   onForkedThread: undefined as ((threadId: string) => void) | undefined,
+  onGenerateTitle: undefined as
+    | ((
+        threadId: string,
+        message: string,
+        selection: { engine?: string; model?: string },
+      ) => void)
+    | undefined,
   onSaveThread: undefined as
     | ((
         threadId: string,
@@ -93,6 +100,7 @@ const assistantChatMockState = vi.hoisted(() => ({
           title: string;
           preview: string;
           messageCount: number;
+          titleSource?: "fallback";
         },
       ) => void)
     | undefined,
@@ -351,6 +359,7 @@ vi.mock("./AgentKitAssistantChat.js", async () => {
         onRetryModelList?: () => void;
         onSlashCommand?: (command: string) => void;
         onForkedThread?: (threadId: string) => void;
+        onGenerateTitle?: typeof assistantChatMockState.onGenerateTitle;
         onSaveThread?: typeof assistantChatMockState.onSaveThread;
         branchNavigation?: typeof assistantChatMockState.branchNavigation;
       };
@@ -359,6 +368,7 @@ vi.mock("./AgentKitAssistantChat.js", async () => {
       assistantChatMockState.onRetryModelList = props.onRetryModelList;
       assistantChatMockState.onSlashCommand = props.onSlashCommand;
       assistantChatMockState.onForkedThread = props.onForkedThread;
+      assistantChatMockState.onGenerateTitle = props.onGenerateTitle;
       assistantChatMockState.onSaveThread = props.onSaveThread;
       assistantChatMockState.branchNavigation = props.branchNavigation;
       React.useImperativeHandle(ref, () => ({
@@ -413,6 +423,7 @@ function resetThreadMocks() {
   assistantChatMockState.onRetryModelList = undefined;
   assistantChatMockState.onSlashCommand = undefined;
   assistantChatMockState.onForkedThread = undefined;
+  assistantChatMockState.onGenerateTitle = undefined;
   assistantChatMockState.onSaveThread = undefined;
   assistantChatMockState.branchNavigation = undefined;
   threadMocks.activeThreadId = "thread-1";
@@ -522,6 +533,7 @@ describe("MultiTabAssistantChat postMessage bridge", () => {
       title: "Saved chat",
       preview: "Latest request",
       messageCount: 1,
+      titleSource: "fallback" as const,
     };
     window.history.replaceState(null, "", "/");
 
@@ -583,6 +595,28 @@ describe("MultiTabAssistantChat postMessage bridge", () => {
     expect(window.location.search).toBe("?thread=thread-1");
   });
 
+  it("persists a sanitized prompt title when title generation is unavailable", async () => {
+    threadMocks.generateTitle.mockResolvedValueOnce(null);
+    await act(async () => {
+      root.render(<MultiTabAssistantChat storageKey="title-fallback" />);
+      await Promise.resolve();
+    });
+
+    const message =
+      'Summarize @[the sprint|resource:123]\n<context data-agentkit-context-encoding="entities-v1">Private context</context>';
+    await act(async () => {
+      assistantChatMockState.onGenerateTitle?.("thread-1", message, {});
+      await Promise.resolve();
+    });
+
+    expect(threadMocks.saveThreadData).toHaveBeenCalledWith("thread-1", {
+      threadData: "",
+      title: "Summarize @the sprint",
+      preview: message.slice(0, 120),
+      titleSource: "fallback",
+    });
+  });
+
   it("prefills the active composer without submitting when submit is false", () => {
     act(() => {
       dispatchSubmitChat({