@agent-native/dispatch 0.40.30-nightly-20261021064625 → 0.40.30

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

@@ -11,12 +11,18 @@ const queryState = vi.hoisted(() => ({
   connectedApps: [] as Array<Record<string, unknown>>,
   connectedAppsError: null as Error | null,
   connectedAppsLoading: false,
+  communityAppsEnabled: false,
+  communityApps: [] as Array<Record<string, unknown>>,
+  installCommunityApp: vi.fn(),
+  installCommunityAppResult: null as Record<string, unknown> | null,
+  sendToAgentChat: vi.fn(),
 }));
 
 vi.mock("@agent-native/core/client/hooks", () => ({
   useActionQuery: (action: string) => {
     const workspaceApps = action === "list-workspace-apps";
     const connectedApps = action === "list-connected-agents";
+    const communityApps = action === "list-curated-community-apps";
     const error = workspaceApps
       ? queryState.workspaceAppsError
       : connectedApps
@@ -27,7 +33,9 @@ vi.mock("@agent-native/core/client/hooks", () => ({
         ? queryState.workspaceApps
         : connectedApps
           ? queryState.connectedApps
-          : { name: null, displayName: null, appCount: 0 },
+          : communityApps
+            ? queryState.communityApps
+            : { name: null, displayName: null, appCount: 0 },
       error,
       isError: Boolean(error),
       isLoading: workspaceApps
@@ -38,6 +46,30 @@ vi.mock("@agent-native/core/client/hooks", () => ({
       refetch: vi.fn(),
     };
   },
+  useActionMutation: (
+    _action: string,
+    options?: { onSuccess?: (result: Record<string, unknown>) => void },
+  ) => ({
+    mutate: (input: unknown) => {
+      queryState.installCommunityApp(input);
+      if (queryState.installCommunityAppResult) {
+        options?.onSuccess?.(queryState.installCommunityAppResult);
+      }
+    },
+    isPending: false,
+  }),
+}));
+
+vi.mock("@agent-native/core/client/agent-chat", () => ({
+  sendToAgentChat: queryState.sendToAgentChat,
+}));
+
+vi.mock("@agent-native/core/client/labs", () => ({
+  useLab: () => queryState.communityAppsEnabled,
+}));
+
+vi.mock("../../shared/labs.js", () => ({
+  COMMUNITY_APPS_LAB: { key: "dispatch.community-apps", defaultEnabled: false },
 }));
 
 vi.mock("@agent-native/core/client/i18n", () => ({
@@ -92,6 +124,11 @@ describe("Dispatch apps route", () => {
     queryState.connectedApps = [];
     queryState.connectedAppsError = null;
     queryState.connectedAppsLoading = false;
+    queryState.communityAppsEnabled = false;
+    queryState.communityApps = [];
+    queryState.installCommunityApp.mockReset();
+    queryState.installCommunityAppResult = null;
+    queryState.sendToAgentChat.mockReset();
     container = document.createElement("div");
     document.body.appendChild(container);
     root = createRoot(container);
@@ -129,4 +166,167 @@ describe("Dispatch apps route", () => {
 
     expect(container.textContent).toContain("No workspace apps");
   });
+
+  it("hides community apps while the Lab is off", async () => {
+    await renderAppsRoute();
+
+    expect(container.textContent).not.toContain("dispatch.pages.communityApps");
+  });
+
+  it("lists the reviewed catalog and starts the selected install", async () => {
+    queryState.communityAppsEnabled = true;
+    queryState.communityApps = [
+      {
+        id: "community-qr",
+        name: "QR",
+        description: "Generate QR images.",
+        appId: "community-qr",
+        repo: "BuilderIO/agent-native",
+        ref: "main",
+        license: "MIT",
+        provenance: "Reviewed source",
+        templatePath: "templates/community/qr",
+        installed: false,
+        pending: false,
+        installable: true,
+      },
+    ];
+
+    await renderAppsRoute();
+
+    expect(container.textContent).toContain("QR");
+    expect(
+      container.querySelector<HTMLAnchorElement>("a[href*='github.com']")?.href,
+    ).toContain("/tree/main/templates/community/qr");
+    const installButton = Array.from(
+      container.querySelectorAll<HTMLButtonElement>("button"),
+    ).find((button) =>
+      button.textContent?.includes("dispatch.pages.communityAppsInstall"),
+    );
+    expect(installButton).toBeDefined();
+    await act(async () => installButton?.click());
+    expect(queryState.installCommunityApp).toHaveBeenCalledWith({
+      sourceId: "community-qr",
+    });
+  });
+
+  it("sends verified source files to the local code agent", async () => {
+    queryState.communityAppsEnabled = true;
+    queryState.communityApps = [
+      {
+        id: "community-qr",
+        name: "QR",
+        description: "Generate QR images.",
+        appId: "community-qr",
+        repo: "BuilderIO/agent-native",
+        ref: "main",
+        license: "MIT",
+        provenance: "Reviewed source",
+        templatePath: "templates/community/qr",
+        installed: false,
+        pending: false,
+        installable: true,
+      },
+    ];
+    queryState.installCommunityAppResult = {
+      mode: "local-agent",
+      prompt: "Create this app from the pinned files.",
+      attachments: [
+        {
+          type: "file",
+          name: "community-qr/README.md",
+          contentType: "text/plain",
+          text: "Verified source",
+        },
+      ],
+    };
+
+    await renderAppsRoute();
+    const installButton = Array.from(
+      container.querySelectorAll<HTMLButtonElement>("button"),
+    ).find((button) =>
+      button.textContent?.includes("dispatch.pages.communityAppsInstall"),
+    );
+    await act(async () => installButton?.click());
+
+    expect(queryState.sendToAgentChat).toHaveBeenCalledWith({
+      message: "Create this app from the pinned files.",
+      attachments: [
+        {
+          type: "file",
+          name: "community-qr/README.md",
+          contentType: "text/plain",
+          text: "Verified source",
+        },
+      ],
+      submit: true,
+      type: "code",
+      newTab: true,
+      reuseEmptyTab: true,
+    });
+  });
+
+  it("explains when a community app ID is already in use", async () => {
+    queryState.communityAppsEnabled = true;
+    queryState.communityApps = [
+      {
+        id: "community-qr",
+        name: "QR",
+        description: "Generate QR images.",
+        appId: "qr",
+        repo: "BuilderIO/agent-native",
+        ref: "main",
+        license: "MIT",
+        provenance: "Reviewed source",
+        templatePath: "templates/community/qr",
+        installed: false,
+        pending: false,
+        installable: false,
+        installUnavailableReason: "app-id-conflict",
+      },
+    ];
+
+    await renderAppsRoute();
+
+    expect(container.textContent).toContain(
+      "dispatch.pages.communityAppsIdConflict",
+    );
+    expect(
+      Array.from(container.querySelectorAll("button")).some((button) =>
+        button.textContent?.includes("dispatch.pages.communityAppsInstall"),
+      ),
+    ).toBe(false);
+  });
+
+  it("explains when Builder-mode community installs cannot be verified", async () => {
+    queryState.communityAppsEnabled = true;
+    queryState.communityApps = [
+      {
+        id: "community-qr",
+        name: "QR",
+        description: "Generate QR images.",
+        appId: "community-qr",
+        repo: "BuilderIO/agent-native",
+        ref: "main",
+        license: "MIT",
+        provenance: "Reviewed source",
+        templatePath: "templates/community/qr",
+        installed: false,
+        pending: false,
+        installable: false,
+        installUnavailableReason: "builder-install-unverified",
+      },
+    ];
+
+    await renderAppsRoute();
+
+    expect(container.textContent).toContain(
+      "dispatch.pages.communityAppsBuilderInstallUnavailable",
+    );
+    expect(
+      Array.from(container.querySelectorAll("button")).some((button) =>
+        button.textContent?.includes("dispatch.pages.communityAppsInstall"),
+      ),
+    ).toBe(false);
+  });
 });

package/src/routes/pages/apps.tsx

@@ -16,6 +16,7 @@ import {
   APP_LIST_GRID_ROW_CLASS,
   AppList,
 } from "../../components/app-list-row";
+import { CommunityAppsSection } from "../../components/community-apps-section";
 import { ConnectedAppCard } from "../../components/connected-app-card";
 import { CreateAppPopover } from "../../components/create-app-popover";
 import { DispatchShell } from "../../components/dispatch-shell";
@@ -346,6 +347,8 @@ function AppsRoute() {
             </section>
           </Collapsible>
         ) : null}
+
+        <CommunityAppsSection />
       </div>
     </DispatchShell>
   );

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

@@ -8,7 +8,8 @@ import ConnectRoute from "./connect";
 const connectState = vi.hoisted(() => ({
   enabled: false,
   status: "ready" as "loading" | "ready",
-  useQuery: vi.fn(() => ({ data: [], isLoading: false, isError: false })),
+  useActionQuery: vi.fn(() => ({ data: [], isLoading: false, isError: false })),
+  useActionMutation: vi.fn(() => ({ mutateAsync: vi.fn() })),
 }));
 
 vi.mock("@agent-native/core/client/feature-flags", () => ({
@@ -23,8 +24,9 @@ vi.mock("../../components/dispatch-shell", () => ({
 vi.mock("@agent-native/core/client/i18n", () => ({
   useT: () => (key: string) => key,
 }));
-vi.mock("@tanstack/react-query", () => ({
-  useQuery: connectState.useQuery,
+vi.mock("@agent-native/core/client/hooks", () => ({
+  useActionQuery: connectState.useActionQuery,
+  useActionMutation: connectState.useActionMutation,
 }));
 
 describe("ConnectRoute", () => {
@@ -34,7 +36,8 @@ describe("ConnectRoute", () => {
   beforeEach(() => {
     connectState.enabled = false;
     connectState.status = "ready";
-    connectState.useQuery.mockClear();
+    connectState.useActionQuery.mockClear();
+    connectState.useActionMutation.mockClear();
     container = document.createElement("div");
     document.body.appendChild(container);
     root = createRoot(container);
@@ -48,13 +51,57 @@ describe("ConnectRoute", () => {
   it("renders nothing and does not fetch when the labs flag is off", async () => {
     await act(async () => root.render(<ConnectRoute />));
     expect(container.innerHTML).toBe("");
-    expect(connectState.useQuery).not.toHaveBeenCalled();
+    expect(connectState.useActionQuery).not.toHaveBeenCalled();
+    expect(connectState.useActionMutation).not.toHaveBeenCalled();
   });
 
   it("shows the page skeleton while the labs flag is loading", async () => {
     connectState.status = "loading";
     await act(async () => root.render(<ConnectRoute />));
     expect(container.querySelector('[aria-busy="true"]')).not.toBeNull();
-    expect(connectState.useQuery).not.toHaveBeenCalled();
+    expect(connectState.useActionQuery).not.toHaveBeenCalled();
+    expect(connectState.useActionMutation).not.toHaveBeenCalled();
+  });
+
+  it("inspects a URL through the server action and renders its card", async () => {
+    connectState.enabled = true;
+    const mutateAsync = vi.fn().mockResolvedValue({
+      name: "Slides",
+      description: "A slide workspace",
+      url: "https://slides.example.com/_agent-native/a2a",
+      connect: true,
+    });
+    connectState.useActionMutation.mockReturnValue({ mutateAsync } as never);
+
+    await act(async () => root.render(<ConnectRoute />));
+    expect(connectState.useActionQuery).toHaveBeenCalledWith(
+      "list-connect-marketplace-apps",
+      {},
+      { staleTime: 5 * 60 * 1000, retry: 1 },
+    );
+
+    const input = container.querySelector("input");
+    expect(input).not.toBeNull();
+    await act(async () => {
+      const setter = Object.getOwnPropertyDescriptor(
+        HTMLInputElement.prototype,
+        "value",
+      )?.set;
+      setter?.call(input, "https://slides.example.com");
+      input?.dispatchEvent(new Event("input", { bubbles: true }));
+    });
+
+    const inspectButton = [...container.querySelectorAll("button")].find(
+      (button) => button.textContent?.includes("dispatch.pages.inspectApp"),
+    );
+    expect(inspectButton).toBeDefined();
+    await act(async () => inspectButton?.click());
+
+    expect(mutateAsync).toHaveBeenCalledWith({
+      url: "https://slides.example.com/",
+    });
+    expect(container.querySelector("[data-connect-card] h3")?.textContent).toBe(
+      "Slides",
+    );
   });
 });

package/src/routes/pages/connect.tsx

@@ -1,7 +1,10 @@
 import { useFeatureFlagState } from "@agent-native/core/client/feature-flags";
+import {
+  useActionMutation,
+  useActionQuery,
+} from "@agent-native/core/client/hooks";
 import { useT } from "@agent-native/core/client/i18n";
 import { IconExternalLink, IconPlugConnected } from "@tabler/icons-react";
-import { useQuery } from "@tanstack/react-query";
 import { useState } from "react";
 
 import { AppIcon } from "../../components/app-icon";
@@ -11,8 +14,6 @@ import { Input } from "../../components/ui/input";
 import { Skeleton } from "../../components/ui/skeleton";
 import {
   buildIdentityConnectUrl,
-  fetchConnectAgentCard,
-  fetchMarketplaceApps,
   normalizeConnectUrl,
   type ConnectAgentCard,
   type MarketplaceApp,
@@ -143,13 +144,15 @@ function ConnectAppsContent() {
   const [card, setCard] = useState<ConnectAgentCard | null>(null);
   const [cardError, setCardError] = useState(false);
   const [cardLoading, setCardLoading] = useState(false);
-  const feedQuery = useQuery({
-    queryKey: ["connect-apps-marketplace"],
-    queryFn: () => fetchMarketplaceApps(),
-    enabled: true,
-    staleTime: 5 * 60 * 1000,
-    retry: 1,
-  });
+  const feedQuery = useActionQuery(
+    "list-connect-marketplace-apps",
+    {},
+    {
+      staleTime: 5 * 60 * 1000,
+      retry: 1,
+    },
+  );
+  const inspectCard = useActionMutation("inspect-connect-agent-card");
 
   const target = normalizeConnectUrl(url);
 
@@ -159,7 +162,7 @@ function ConnectAppsContent() {
     setCardError(false);
     setCard(null);
     try {
-      setCard(await fetchConnectAgentCard(target.toString()));
+      setCard(await inspectCard.mutateAsync({ url: target.toString() }));
     } catch {
       setCardError(true);
     } finally {

package/src/server/index.ts

@@ -7,6 +7,15 @@ import {
 import { dispatchActions } from "../actions/index.js";
 import type { DispatchConfig } from "../config.js";
 import { dispatchAccessDescriptor } from "../shared/app-roles.js";
+export {
+  listOrganizationVisibleWorkspaceApps,
+  listWorkspaceApps,
+} from "./lib/app-creation-store.js";
+export {
+  invalidateOrgAppsDirectoryCache,
+  orgAppsDirectoryAccessCache,
+  orgAppsDirectoryCache,
+} from "./lib/org-apps-directory-cache.js";
 
 defineAppRoles(dispatchAccessDescriptor, { allowOrgAdmins: true });