@agent-native/dispatch 0.11.5 → 0.11.7

package/src/actions/navigate.ts

@@ -12,6 +12,7 @@
  * Options:
  *   --view   View name to navigate to
  *   --path   URL path to navigate to
+ *   --threadId Chat thread ID to open on the chat route
  */
 
 import { defineAction } from "@agent-native/core";
@@ -20,7 +21,7 @@ import { writeAppState } from "@agent-native/core/application-state";
 
 export default defineAction({
   description:
-    "Navigate the UI to a specific view or path. Writes a navigate command to application state which the UI reads and auto-deletes.",
+    "Navigate the UI to a specific view or path. Use threadId to open a specific chat thread on the chat route. Writes a navigate command to application state which the UI reads and auto-deletes.",
   schema: z.object({
     view: z
       .string()
@@ -29,16 +30,24 @@ export default defineAction({
         "Named dispatch view to navigate to. Built-in views include chat, overview, apps, metrics, new-app, vault, integrations, messaging, workspace, agents, destinations, identities, approvals, audit, thread-debug, dreams, and team. Generated Dispatch extension tabs can also use their nav item id.",
       ),
     path: z.string().optional().describe("URL path to navigate to"),
+    threadId: z
+      .string()
+      .optional()
+      .describe("Chat thread ID to open on the chat route"),
   }),
   http: false,
   run: async (args) => {
-    if (!args.view && !args.path) {
-      return "Error: At least --view or --path is required.";
+    const threadId = args.threadId?.trim();
+    if (!args.view && !args.path && !threadId) {
+      return "Error: At least --view, --path, or --threadId is required.";
     }
     const nav: Record<string, string> = {};
+    // A thread id without an explicit view implies the chat surface.
     if (args.view) nav.view = args.view;
+    else if (threadId) nav.view = "chat";
     if (args.path) nav.path = args.path;
+    if (threadId) nav.threadId = threadId;
     await writeAppState("navigate", nav);
-    return `Navigating to ${args.view || args.path}`;
+    return `Navigating to ${args.view || args.path || `chat thread ${threadId}`}`;
   },
 });

package/src/actions/update-vault-secret.ts

@@ -41,5 +41,8 @@ export default defineAction({
         description !== undefined,
       "At least one secret field must be updated",
     ),
+  // Carries a secret `value`. Record THAT the secret changed, never the value —
+  // keep the audit trail from becoming a second credential store.
+  audit: { recordInputs: false },
   run: async (args) => updateSecret(args.id, args),
 });

package/src/components/layout/Layout.tsx

@@ -286,6 +286,21 @@ function dispatchNavLinkTarget(path: string): string {
   return routerHasBasename ? path : appPath(path);
 }
 
+function chatThreadPath(threadId: string): string {
+  return `/chat/${encodeURIComponent(threadId)}`;
+}
+
+function threadIdFromPath(pathname: string): string | null {
+  const match = pathname.match(/^\/chat\/([^/]+)/);
+  if (!match) return null;
+  try {
+    const value = decodeURIComponent(match[1]).trim();
+    return value || null;
+  } catch {
+    return null;
+  }
+}
+
 function formatThreadAge(updatedAt: number) {
   const diffMs = Math.max(0, Date.now() - updatedAt);
   const minutes = Math.floor(diffMs / 60_000);
@@ -315,6 +330,7 @@ function threadUpdatedAt(thread: ChatThreadSummary) {
 
 function DispatchChatsSection({ onNavigate }: { onNavigate?: () => void }) {
   const navigate = useNavigate();
+  const location = useLocation();
   const {
     threads,
     activeThreadId,
@@ -370,7 +386,9 @@ function DispatchChatsSection({ onNavigate }: { onNavigate?: () => void }) {
     switchThread(threadId);
     navigateWithAgentChatViewTransition(
       navigate,
-      dispatchNavLinkTarget("/chat"),
+      dispatchNavLinkTarget(
+        options?.isNew ? "/chat" : chatThreadPath(threadId),
+      ),
     );
     onNavigate?.();
     window.requestAnimationFrame(() => {
@@ -439,7 +457,11 @@ function DispatchChatsSection({ onNavigate }: { onNavigate?: () => void }) {
       <div className="grid gap-0.5">
         {visibleThreads.length > 0 ? (
           visibleThreads.map((thread) => {
-            const isActive = thread.id === activeThreadId;
+            const localPathname = localDispatchPath(location.pathname);
+            const isActive =
+              thread.id ===
+              (threadIdFromPath(localPathname) ??
+                (localPathname === "/chat" ? null : activeThreadId));
             const isRenaming = thread.id === renamingThreadId;
             return (
               <div
@@ -692,13 +714,18 @@ export function Layout({
   const navigate = useNavigate();
   const [mobileOpen, setMobileOpen] = useState(false);
   const localPathname = localDispatchPath(location.pathname);
-  const isChatRoute = localPathname === "/chat";
+  const isChatRoute =
+    localPathname === "/chat" || localPathname.startsWith("/chat/");
   const chatHomeHandoffActive = useAgentChatHomeHandoff({
     storageKey: "dispatch",
     activePath: localPathname,
     enabled: !isChatRoute,
   });
-  useAgentChatHomeHandoffLinks({ storageKey: "dispatch", chatPath: "/chat" });
+  useAgentChatHomeHandoffLinks({
+    storageKey: "dispatch",
+    isChatPath: (pathname) =>
+      pathname === "/chat" || pathname.startsWith("/chat/"),
+  });
 
   if (CHROMELESS_PATHS.some((path) => localPathname === path)) {
     return <>{children}</>;

package/src/hooks/use-navigation-state.ts

@@ -21,6 +21,7 @@ export interface NavigationState {
   dreamId?: string;
   sourceId?: string;
   query?: string;
+  threadId?: string;
 }
 
 export function useNavigationState(extensions?: DispatchExtensionConfig) {
@@ -82,8 +83,8 @@ export function useNavigationState(extensions?: DispatchExtensionConfig) {
         : resolvedPath;
     const nextPath = routerPath(path);
     if (
-      routerPath(location.pathname) === "/chat" &&
-      pathnameFromPath(nextPath) !== "/chat"
+      isChatPath(routerPath(location.pathname)) &&
+      !isChatPath(pathnameFromPath(nextPath))
     ) {
       markAgentChatHomeHandoff("dispatch");
     }
@@ -96,6 +97,21 @@ function pathnameFromPath(path: string): string {
   return path.split(/[?#]/, 1)[0] || "/";
 }
 
+function isChatPath(pathname: string): boolean {
+  return pathname === "/chat" || pathname.startsWith("/chat/");
+}
+
+function threadIdFromPath(pathname: string): string | null {
+  const match = pathname.match(/^\/chat\/([^/]+)/);
+  if (!match) return null;
+  try {
+    const value = decodeURIComponent(match[1]).trim();
+    return value || null;
+  } catch {
+    return null;
+  }
+}
+
 export function buildDispatchNavigationState(
   pathname: string,
   search = "",
@@ -106,6 +122,9 @@ export function buildDispatchNavigationState(
     path: appPath(pathname),
   };
 
+  const threadId = threadIdFromPath(pathname);
+  if (threadId) state.threadId = threadId;
+
   const extensionId = extensionIdFromPathname(pathname);
   if (extensionId) {
     state.view = "extensions";
@@ -206,12 +225,14 @@ function resolveView(
 function resolvePath(
   view?: string,
   extensions?: DispatchExtensionConfig,
-  command?: Pick<NavigationState, "extensionId">,
+  command?: Pick<NavigationState, "extensionId" | "threadId">,
 ): string | undefined {
   switch (view) {
     case "chat":
     case "ask":
-      return "/chat";
+      return command?.threadId && command.threadId.trim()
+        ? `/chat/${encodeURIComponent(command.threadId.trim())}`
+        : "/chat";
     case "overview":
       return "/overview";
     case "apps":

package/src/routes/index.ts

@@ -32,6 +32,7 @@ import { type RouteConfig, route, index } from "@react-router/dev/routes";
 export const dispatchRoutes: RouteConfig = [
   index("./pages/_index.js"),
   route("chat", "./pages/chat.js"),
+  route("chat/:threadId", "./pages/chat.js"),
   route("overview", "./pages/overview.js"),
   route("metrics", "./pages/metrics.js"),
   route("apps", "./pages/apps.js"),

package/src/routes/pages/chat.tsx

@@ -1,11 +1,53 @@
-import { useEffect, useRef } from "react";
+import { useCallback, useEffect, useMemo, useRef } from "react";
 import { useLocation, useNavigate } from "react-router";
 import {
   AgentChatSurface,
+  appBasePath,
+  appPath,
   markAgentChatHomeHandoff,
 } from "@agent-native/core/client";
 import { submitOverviewPrompt } from "@/lib/overview-chat";
 
+function chatThreadPath(threadId: string | null): string {
+  return threadId ? `/chat/${encodeURIComponent(threadId)}` : "/chat";
+}
+
+function stripBasePath(pathname: string): string {
+  const basePath = appBasePath();
+  if (!basePath) return pathname;
+  if (pathname === basePath) return "/";
+  if (pathname.startsWith(`${basePath}/`)) {
+    return pathname.slice(basePath.length) || "/";
+  }
+  return pathname;
+}
+
+// The chat surface renders for both `/chat` and the `/chat/:threadId` deep
+// link. The thread id is read from the pathname (not `useParams`) because the
+// param is owned by the nested deep-link route, not this leaf component.
+function threadIdFromPath(pathname: string): string | null {
+  const match = stripBasePath(pathname).match(/^\/chat\/([^/]+)/);
+  if (!match) return null;
+  try {
+    const value = decodeURIComponent(match[1]).trim();
+    return value || null;
+  } catch {
+    return null;
+  }
+}
+
+// Mirror the basename handling Dispatch's nav links use: pass a router-local
+// path when the live URL is already under the mount, otherwise prefix it.
+function dispatchNavTarget(path: string): string {
+  if (typeof window === "undefined") return path;
+  const basePath = appBasePath();
+  if (!basePath) return path;
+  const pathname = window.location.pathname;
+  const routerHasBasename =
+    pathname === basePath || pathname.startsWith(`${basePath}/`);
+  return routerHasBasename ? path : appPath(path);
+}
+
 interface DispatchChatLocationState {
   dispatchPrompt?: {
     id?: string | number;
@@ -25,7 +67,22 @@ export function meta() {
 export default function ChatRoute() {
   const location = useLocation();
   const navigate = useNavigate();
+  const routeThreadId = threadIdFromPath(location.pathname);
   const handledStateIds = useRef(new Set<string>());
+
+  const navigateThreadUrl = useCallback(
+    (path: string, options?: { replace?: boolean }) =>
+      navigate(dispatchNavTarget(path), options),
+    [navigate],
+  );
+  const threadUrlSync = useMemo(
+    () => ({
+      routeThreadId: routeThreadId ?? null,
+      getPath: chatThreadPath,
+      navigate: navigateThreadUrl,
+    }),
+    [routeThreadId, navigateThreadUrl],
+  );
   const state = location.state as DispatchChatLocationState | null;
   const prompt = state?.dispatchPrompt;
   const thread = state?.dispatchThread;
@@ -92,6 +149,7 @@ export default function ChatRoute() {
         className="dispatch-chat-panel"
         defaultMode="chat"
         storageKey="dispatch"
+        threadUrlSync={threadUrlSync}
         showHeader={false}
         showTabBar={false}
         dynamicSuggestions={false}