@agent-native/dispatch 0.40.30 → 0.40.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/dispatch",
-  "version": "0.40.30",
+  "version": "0.40.31",
   "description": "Dispatch — workspace control plane for agent-native apps. Vault, integrations, destinations, scheduled jobs, and cross-app delegation, shipped as a single drop-in package.",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -90,7 +90,7 @@
     "tailwind-merge": "^3.5.0",
     "vaul": "^1.1.2",
     "zod": "^4.3.6",
-    "@agent-native/toolkit": "0.212.0"
+    "@agent-native/toolkit": "0.212.1"
   },
   "devDependencies": {
     "@react-router/dev": "^8.1.0",
@@ -104,7 +104,7 @@
     "typescript-7": "npm:typescript@^7.0.2",
     "vite": "8.1.0",
     "vitest": "^4.1.5",
-    "@agent-native/core": "0.212.0"
+    "@agent-native/core": "0.212.1"
   },
   "peerDependencies": {
     "@agent-native/core": ">=0.209.1",

package/src/actions/list-connected-agents.spec.ts

@@ -3,7 +3,9 @@ import { describe, expect, it, vi } from "vitest";
 const mocks = vi.hoisted(() => ({
   discoverAgents: vi.fn(),
   getBuiltinAgents: vi.fn(),
-  getRequestUserEmail: vi.fn(() => "owner@example.test"),
+  getRequestUserEmail: vi.fn<() => string | undefined>(
+    () => "owner@example.test",
+  ),
   resourceGet: vi.fn(),
   resourceListAccessible: vi.fn(async (): Promise<unknown[]> => []),
   parseRemoteAgentManifest: vi.fn(),
@@ -141,4 +143,18 @@ describe("list-connected-agents", () => {
     expect(entry).toMatchObject({ id: "mail", source: "workspace" });
     expect(entry).not.toHaveProperty("homeUrl");
   });
+
+  it("returns a typed authentication error when the session has no user email", async () => {
+    mocks.discoverAgents.mockResolvedValue([]);
+    mocks.getBuiltinAgents.mockReturnValue([]);
+    mocks.loadWorkspaceAppsManifest.mockResolvedValue(null);
+    mocks.getRequestUserEmail.mockReturnValueOnce(undefined);
+
+    const { default: action } = await import("./list-connected-agents.js");
+
+    await expect(action.run({})).rejects.toMatchObject({
+      statusCode: 401,
+      errorCode: "dispatch_user_identity_missing",
+    });
+  });
 });

package/src/actions/list-connected-agents.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core/action";
+import { defineAction, fail } from "@agent-native/core/action";
 import {
   REMOTE_AGENT_RESOURCE_PREFIXES,
   parseRemoteAgentManifest,
@@ -45,7 +45,12 @@ export default defineAction({
       builtins.map((agent) => [agent.id, agent.url]),
     );
     const ownerEmail = getRequestUserEmail();
-    if (!ownerEmail) throw new Error("no authenticated user");
+    if (!ownerEmail) {
+      fail("Sign in to list connected agents.", {
+        errorCode: "dispatch_user_identity_missing",
+        statusCode: 401,
+      });
+    }
     const resources: Array<{ id: string; path: string; owner: string }> = [];
     for (const prefix of [...REMOTE_AGENT_RESOURCE_PREFIXES].reverse()) {
       resources.push(...(await resourceListAccessible(ownerEmail, prefix)));

package/src/actions/list-workspace-connections.spec.ts

@@ -10,6 +10,9 @@ const mocks = vi.hoisted(() => ({
   hasWorkspaceProviderOAuthCredentials: vi.fn(),
   isProviderApiId: vi.fn(() => false),
   listProviderApiCatalog: vi.fn(() => []),
+  listWorkspaceApps: vi.fn(async () => [
+    { id: "dispatch", name: "Dispatch", status: "ready" },
+  ]),
   listWorkspaceConnectionGrants: vi.fn(),
   listWorkspaceConnectionProviders: vi.fn(),
   listWorkspaceConnectionsForUser: vi.fn(),
@@ -54,9 +57,7 @@ vi.mock("@agent-native/core/workspace-connections", () => ({
 vi.mock("@agent-native/dispatch/actions", () => ({
   dispatchActions: {
     "list-workspace-apps": {
-      run: vi.fn(async () => [
-        { id: "dispatch", name: "Dispatch", status: "ready" },
-      ]),
+      run: mocks.listWorkspaceApps,
     },
   },
 }));
@@ -123,4 +124,14 @@ describe("list-workspace-connections", () => {
     expect(result.providers.map((provider) => provider.id)).toEqual(["github"]);
     expect(result.counts.providers).toBe(1);
   });
+
+  it("preserves workspace app lookup failures instead of returning partial grants", async () => {
+    const error = Object.assign(new Error("Workspace registry unavailable"), {
+      statusCode: 503,
+      errorCode: "workspace_gateway_org_a2a_secret_unavailable",
+    });
+    mocks.listWorkspaceApps.mockRejectedValueOnce(error);
+
+    await expect(action.run({})).rejects.toBe(error);
+  });
 });

package/src/actions/list-workspace-connections.ts

@@ -79,23 +79,19 @@ async function listGrantApps(): Promise<GrantApp[]> {
   const listWorkspaceApps = dispatchActions["list-workspace-apps"];
   if (!listWorkspaceApps) return [{ id: "dispatch", label: "Dispatch" }];
 
-  try {
-    const apps = (await listWorkspaceApps.run({
-      includeAgentCards: false,
-      audience: "all",
-    } as any)) as WorkspaceApp[];
-    const grantApps = apps
-      .filter((app) => !app.archived && app.status !== "pending")
-      .map((app) => ({
-        id: app.id,
-        label: app.name || humanizeAppId(app.id),
-      }));
-    return grantApps.length > 0
-      ? grantApps
-      : [{ id: "dispatch", label: "Dispatch" }];
-  } catch {
-    return [{ id: "dispatch", label: "Dispatch" }];
-  }
+  const apps = (await listWorkspaceApps.run({
+    includeAgentCards: false,
+    audience: "all",
+  } as any)) as WorkspaceApp[];
+  const grantApps = apps
+    .filter((app) => !app.archived && app.status !== "pending")
+    .map((app) => ({
+      id: app.id,
+      label: app.name || humanizeAppId(app.id),
+    }));
+  return grantApps.length > 0
+    ? grantApps
+    : [{ id: "dispatch", label: "Dispatch" }];
 }
 
 export default defineAction({

package/src/components/action-query-error.spec.tsx

@@ -53,4 +53,24 @@ describe("ActionQueryError", () => {
     });
     expect(onRetry).toHaveBeenCalledOnce();
   });
+
+  it("shows the query and safe HTTP diagnostic without exposing the message", () => {
+    act(() => {
+      root.render(
+        <ActionQueryError
+          error={Object.assign(new Error("secret database detail"), {
+            status: 401,
+            errorCode: "workspace_gateway_rejected",
+          })}
+          queryName="list-workspace-apps"
+          onRetry={() => {}}
+        />,
+      );
+    });
+
+    expect(container.textContent).toContain(
+      "list-workspace-apps · HTTP 401 · workspace_gateway_rejected",
+    );
+    expect(container.textContent).not.toContain("secret database detail");
+  });
 });

package/src/components/action-query-error.tsx

@@ -8,13 +8,48 @@ interface ActionQueryErrorProps {
   error?: unknown;
   onRetry: () => unknown;
   className?: string;
+  queryName?: string;
+}
+
+function actionQueryDiagnostic(
+  error: unknown,
+  queryName: string | undefined,
+): string | null {
+  const parts: string[] = [];
+  if (queryName) parts.push(queryName);
+
+  if (error && typeof error === "object") {
+    const details = error as Record<string, unknown>;
+    const status =
+      typeof details.statusCode === "number"
+        ? details.statusCode
+        : details.status;
+    if (
+      typeof status === "number" &&
+      Number.isInteger(status) &&
+      status >= 100 &&
+      status <= 599
+    ) {
+      parts.push(`HTTP ${status}`);
+    }
+
+    const code = details.errorCode ?? details.code;
+    if (typeof code === "string" && /^[a-zA-Z0-9_.-]{1,80}$/.test(code)) {
+      parts.push(code);
+    }
+  }
+
+  return parts.length > 0 ? parts.join(" · ") : null;
 }
 
 export function ActionQueryError({
+  error,
   onRetry,
   className,
+  queryName,
 }: ActionQueryErrorProps) {
   const t = useT();
+  const diagnostic = actionQueryDiagnostic(error, queryName);
 
   return (
     <Alert variant="destructive" className={className}>
@@ -22,6 +57,11 @@ export function ActionQueryError({
       <AlertTitle>{t("dispatch.pages.dataLoadFailed")}</AlertTitle>
       <AlertDescription className="flex flex-wrap items-center justify-between gap-3">
         <span>{t("dispatch.pages.dataLoadFailedDescription")}</span>
+        {diagnostic ? (
+          <code className="w-full break-all text-xs text-muted-foreground">
+            {diagnostic}
+          </code>
+        ) : null}
         <Button type="button" variant="outline" size="sm" onClick={onRetry}>
           <IconRefresh className="size-4" />
           {t("dispatch.pages.tryAgain")}

package/src/components/chat-home-apps.spec.tsx

@@ -25,7 +25,11 @@ const launcherState = vi.hoisted(() => ({
       },
     ],
     isLoading: false,
-    error: undefined,
+    error: undefined as unknown,
+    errorQueryName: undefined as
+      | "list-workspace-apps"
+      | "list-connected-agents"
+      | undefined,
     openApp: vi.fn(),
     retry: vi.fn(),
   },
@@ -89,6 +93,8 @@ describe("DispatchChatHomeApps", () => {
     ];
     launcherState.value.openApp.mockReset();
     launcherState.value.retry.mockReset();
+    launcherState.value.error = undefined;
+    launcherState.value.errorQueryName = undefined;
     container = document.createElement("div");
     document.body.appendChild(container);
     root = createRoot(container);
@@ -194,4 +200,29 @@ describe("DispatchChatHomeApps", () => {
     expect(container.textContent).toContain("Localized Calendar description");
     expect(container.textContent).not.toContain("Default English text");
   });
+
+  it.each([
+    ["list-workspace-apps", "Workspace apps failed"],
+    ["list-connected-agents", "Connected agents failed"],
+  ] as const)("identifies the failed %s query", async (queryName, message) => {
+    launcherState.value.workspaceApps = [];
+    launcherState.value.error = Object.assign(new Error(message), {
+      statusCode: 503,
+      errorCode: "workspace_gateway_unavailable",
+    });
+    launcherState.value.errorQueryName = queryName;
+
+    await act(async () => {
+      root.render(
+        <MemoryRouter initialEntries={["/chat"]}>
+          <DispatchChatHomeApps />
+        </MemoryRouter>,
+      );
+    });
+
+    expect(container.textContent).toContain(
+      `${queryName} · HTTP 503 · workspace_gateway_unavailable`,
+    );
+    expect(container.textContent).not.toContain(message);
+  });
 });

package/src/components/chat-home-apps.tsx

@@ -48,7 +48,11 @@ export function DispatchChatHomeApps() {
   if (launcher.error && launcher.workspaceApps.length === 0) {
     return (
       <div className="mx-auto w-full max-w-[1000px]">
-        <ActionQueryError error={launcher.error} onRetry={launcher.retry} />
+        <ActionQueryError
+          error={launcher.error}
+          onRetry={launcher.retry}
+          queryName={launcher.errorQueryName}
+        />
       </div>
     );
   }
@@ -61,6 +65,7 @@ export function DispatchChatHomeApps() {
           error={launcher.error}
           onRetry={launcher.retry}
           className="mb-3"
+          queryName={launcher.errorQueryName}
         />
       ) : null}
       <section aria-label={t("dispatch.nav.apps")}>

package/src/components/dispatch-control-plane.tsx

@@ -360,6 +360,7 @@ export function DispatchControlPlane() {
         <ActionQueryError
           error={appsQuery.error}
           onRetry={() => void appsQuery.refetch()}
+          queryName="list-workspace-apps"
         />
       ) : (
         <AppsPanel apps={workspaceApps ?? []} isLoading={appsLoading} />

package/src/components/layout/Layout.tsx

@@ -299,6 +299,7 @@ interface DispatchWorkspaceAppLauncher {
   workspaceApps: readonly WorkspaceAppSummary[];
   isLoading: boolean;
   error?: unknown;
+  errorQueryName?: "list-workspace-apps" | "list-connected-agents";
   openApp: (app: ChatFirstAppItem) => void;
   retry: () => void;
 }
@@ -1487,6 +1488,12 @@ function DispatchLayout({
   const chatFirstAppsFailed = chatFirstAppsQuery.isError;
   const chatFirstAppsError =
     chatFirstAppsQuery.error ?? chatFirstConnectedAppsQuery.error;
+  const chatFirstAppsErrorQueryName =
+    chatFirstAppsQuery.error != null
+      ? "list-workspace-apps"
+      : chatFirstConnectedAppsQuery.error != null
+        ? "list-connected-agents"
+        : undefined;
   const chatFirstResolvableApps = useMemo(
     () =>
       mergeChatFirstWorkspaceApps(
@@ -1574,6 +1581,7 @@ function DispatchLayout({
       workspaceApps: chatFirstWorkspaceApps,
       isLoading: chatFirstAppsLoading,
       error: chatFirstAppsError,
+      errorQueryName: chatFirstAppsErrorQueryName,
       openApp: openChatFirstApp,
       retry: () => {
         void chatFirstAppsQuery.refetch();
@@ -1582,6 +1590,7 @@ function DispatchLayout({
     }),
     [
       chatFirstAppsError,
+      chatFirstAppsErrorQueryName,
       chatFirstAppsLoading,
       chatFirstAppsQuery.refetch,
       chatFirstConnectedAppsQuery.refetch,

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

@@ -98,6 +98,7 @@ export default function WorkspaceAppCatchAllRoute() {
         <ActionQueryError
           error={appsQuery.error}
           onRetry={() => void appsQuery.refetch()}
+          queryName="list-workspace-apps"
         />
       </DispatchShell>
     );

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

@@ -80,8 +80,16 @@ vi.mock("@agent-native/core/client/i18n", () => ({
 }));
 
 vi.mock("../../components/action-query-error", () => ({
-  ActionQueryError: ({ error }: { error: Error }) => (
-    <div role="alert">{error.message}</div>
+  ActionQueryError: ({
+    error,
+    queryName,
+  }: {
+    error: Error;
+    queryName?: string;
+  }) => (
+    <div role="alert">
+      {queryName}: {error.message}
+    </div>
   ),
 }));
 
@@ -167,6 +175,22 @@ describe("Dispatch apps route", () => {
     expect(container.textContent).toContain("No workspace apps");
   });
 
+  it("identifies each app discovery query when both fail", async () => {
+    queryState.workspaceAppsError = new Error("Workspace app list failed");
+    queryState.connectedAppsError = new Error("Connected agent list failed");
+
+    await renderAppsRoute();
+
+    const errors = Array.from(
+      container.querySelectorAll('[role="alert"]'),
+      (alert) => alert.textContent,
+    );
+    expect(errors).toContain("list-workspace-apps: Workspace app list failed");
+    expect(errors).toContain(
+      "list-connected-agents: Connected agent list failed",
+    );
+  });
+
   it("hides community apps while the Lab is off", async () => {
     await renderAppsRoute();
 

package/src/routes/pages/apps.tsx

@@ -185,12 +185,14 @@ function AppsRoute() {
             <ActionQueryError
               error={appsQuery.error}
               onRetry={() => void appsQuery.refetch()}
+              queryName="list-workspace-apps"
             />
           ) : null}
           {connectedAppsQuery.isError ? (
             <ActionQueryError
               error={connectedAppsQuery.error}
               onRetry={() => void connectedAppsQuery.refetch()}
+              queryName="list-connected-agents"
             />
           ) : null}
           {showAppSkeletons ? (