@agent-native/dispatch 0.23.5 → 0.24.0

package/src/lib/other-apps.ts

@@ -5,6 +5,8 @@ export interface ConnectedAppSummary {
   name: string;
   description?: string;
   url: string;
+  /** Canonical app-home URL used for launchers; `url` remains the A2A endpoint. */
+  homeUrl?: string;
   color?: string;
   source?: "builtin" | "custom" | "workspace";
 }

package/src/lib/workspace-apps.test.ts

@@ -0,0 +1,20 @@
+import { describe, expect, it } from "vitest";
+
+import { workspaceAppEmbedTarget } from "./workspace-apps";
+
+describe("workspaceAppEmbedTarget", () => {
+  it("uses the app URL as the embed root when a mount path is also present", () => {
+    expect(
+      workspaceAppEmbedTarget({
+        path: "/content",
+        url: "https://workspace.example.test/content",
+      }),
+    ).toEqual({ url: "https://workspace.example.test/content" });
+  });
+
+  it("falls back to the mounted path when no app URL is available", () => {
+    expect(workspaceAppEmbedTarget({ path: "/content", url: null })).toEqual({
+      path: "/content",
+    });
+  });
+});

package/src/lib/workspace-apps.ts

@@ -70,6 +70,16 @@ export function workspaceAppHref(app: WorkspaceAppSummary): string | null {
   return app.path || app.url || null;
 }
 
+export function workspaceAppEmbedTarget(
+  app: Pick<WorkspaceAppSummary, "path" | "url">,
+): { path?: string; url?: string } {
+  const url = app.url?.trim();
+  if (url) return { url };
+
+  const path = app.path.trim();
+  return path.startsWith("/") ? { path } : path ? { url: path } : {};
+}
+
 export function isPendingBuilderHref(app: WorkspaceAppSummary): boolean {
   return app.status === "pending" && !!app.builderUrl;
 }

package/src/routes/pages/apps.$appId.tsx

@@ -13,7 +13,9 @@ import { Badge } from "../../components/ui/badge";
 import { Button } from "../../components/ui/button";
 import { Skeleton } from "../../components/ui/skeleton";
 import { Spinner } from "../../components/ui/spinner";
+import { isEmbedSessionExpiredMessage } from "../../lib/embed-session-recovery";
 import {
+  workspaceAppEmbedTarget,
   workspaceAppHref,
   type WorkspaceAppSummary,
 } from "../../lib/workspace-apps";
@@ -61,12 +63,12 @@ export default function WorkspaceAppRoute() {
   });
   const embedInput = useMemo<EmbedSessionInput | null>(() => {
     if (!app || !href) return null;
-    const path = app.path.trim();
-    if (path.startsWith("/")) {
-      return { app: app.id, path, chrome: "minimal" };
-    }
-    return { app: app.id, url: href, chrome: "minimal" };
-  }, [app?.id, app?.path, href]);
+    return {
+      app: app.id,
+      ...workspaceAppEmbedTarget(app),
+      chrome: "minimal",
+    };
+  }, [app?.id, app?.path, app?.url, href]);
 
   useEffect(() => {
     if (!app || app.status === "pending" || !embedInput) return;
@@ -99,12 +101,8 @@ export default function WorkspaceAppRoute() {
 
   useEffect(() => {
     const handleEmbedSessionExpired = (event: MessageEvent) => {
-      if (
-        event.data?.type !== "agentNative.embedSessionExpired" ||
-        event.source !== embedFrameRef.current?.contentWindow
-      ) {
+      if (!isEmbedSessionExpiredMessage(event, embedFrameRef.current, null))
         return;
-      }
       setEmbedAttempt((attempt) => attempt + 1);
     };
 
@@ -222,6 +220,7 @@ export default function WorkspaceAppRoute() {
       <div className="min-h-0 flex-1 bg-muted/20">
         {embedUrl ? (
           <iframe
+            key={`${embedUrl}:${embedAttempt}`}
             data-dispatch-workspace-app-frame
             src={embedUrl}
             title={app.name}

package/src/routes/pages/chat.spec.tsx

@@ -16,6 +16,7 @@ vi.mock("@agent-native/core/client/agent-chat", () => ({
     return <>{props.composerSlot as ReactNode}</>;
   },
   markAgentChatHomeHandoff: vi.fn(),
+  readChatFirstMode: () => true,
   navigateWithAgentChatViewTransition: (
     navigate: (path: string) => void,
     path: string,
@@ -23,6 +24,10 @@ vi.mock("@agent-native/core/client/agent-chat", () => ({
   sendToAgentChat: vi.fn(),
 }));
 
+vi.mock("../../components/layout/Layout", () => ({
+  useDispatchExtensions: () => undefined,
+}));
+
 vi.mock("@agent-native/core/client/api-path", () => ({
   agentNativePath: (path: string) => path,
   appApiPath: (path: string) => path,
@@ -74,6 +79,7 @@ describe("Dispatch ChatRoute", () => {
       centerComposerWhenEmpty: true,
       composerLayoutVariant: "hero",
       composerPlaceholder: "Ask Dispatch...",
+      suppressInlineOpenApp: true,
     });
     expect(container.textContent).toContain("Chat across your apps");
   });
@@ -106,6 +112,10 @@ describe("Dispatch ChatRoute", () => {
     expect(clientState.surfaceProps).not.toHaveProperty(
       "composerLayoutVariant",
     );
+    expect(clientState.surfaceProps).toHaveProperty(
+      "suppressInlineOpenApp",
+      true,
+    );
     expect(container.textContent).not.toContain("Chat across your apps");
   });
 });

package/src/routes/pages/chat.tsx

@@ -1,6 +1,7 @@
 import {
   AgentChatSurface,
   markAgentChatHomeHandoff,
+  readChatFirstMode,
 } from "@agent-native/core/client/agent-chat";
 import { appBasePath, appPath } from "@agent-native/core/client/api-path";
 import { useT } from "@agent-native/core/client/i18n";
@@ -13,6 +14,7 @@ import {
 } from "react";
 import { useLocation, useNavigate } from "react-router";
 
+import { useDispatchExtensions } from "../../components/layout/Layout";
 import { submitOverviewPrompt } from "../../lib/overview-chat";
 
 function chatThreadPath(threadId: string | null): string {
@@ -93,6 +95,11 @@ export default function ChatRoute() {
   const navigate = useNavigate();
   const routeThreadId = threadIdFromPath(location.pathname);
   const handledStateIds = useRef(new Set<string>());
+  const extensions = useDispatchExtensions();
+  const suppressInlineOpenApp =
+    extensions?.chatFirst === true ||
+    readChatFirstMode() ||
+    new URLSearchParams(location.search).get("chatFirst") === "1";
 
   const navigateThreadUrl = useCallback(
     (path: string, options?: { replace?: boolean }) =>
@@ -181,6 +188,7 @@ export default function ChatRoute() {
         showHeader={false}
         showTabBar={false}
         dynamicSuggestions={false}
+        suppressInlineOpenApp={suppressInlineOpenApp}
         suggestions={[]}
         emptyStateText={t("dispatch.pages.chatAcrossAppsDescription", {
           defaultValue: