@agent-native/dispatch 0.14.14 → 0.15.1

package/dist/server/lib/curated-workspace-templates.js

@@ -0,0 +1,137 @@
+import { listWorkspaceApps } from "./app-creation-store.js";
+/**
+ * Stable first-party template metadata for the initial remix catalog.
+ * `liveUrl` identifies the product URL; it is not a public-demo claim.
+ */
+export const CURATED_WORKSPACE_TEMPLATES = [
+    {
+        id: "mail",
+        name: "Mail",
+        description: "Agent-native email client with keyboard shortcuts and AI triage.",
+        icon: "Mail",
+        color: "#3B82F6",
+        template: "mail",
+        liveUrl: "https://mail.agent-native.com",
+        category: "communication",
+        setupNote: "Connect the workspace email integration before working with live mail.",
+    },
+    {
+        id: "calendar",
+        name: "Calendar",
+        description: "Manage events, synchronization, and public booking with an agent-native calendar.",
+        icon: "CalendarDays",
+        color: "#00B5FF",
+        template: "calendar",
+        liveUrl: "https://calendar.agent-native.com",
+        category: "productivity",
+        setupNote: "Connect the workspace calendar integration before working with live events.",
+    },
+    {
+        id: "analytics",
+        name: "Analytics",
+        description: "Connect data sources and prompt for charts, reports, and product insights.",
+        icon: "BarChart2",
+        color: "#F59E0B",
+        template: "analytics",
+        liveUrl: "https://analytics.agent-native.com",
+        category: "insights",
+        setupNote: "Connect a data source or import a representative dataset before analysis.",
+    },
+    {
+        id: "slides",
+        name: "Slides",
+        description: "Generate and edit React presentations with agent assistance.",
+        icon: "GalleryHorizontal",
+        color: "#EC4899",
+        template: "slides",
+        liveUrl: "https://slides.agent-native.com",
+        category: "creative",
+        setupNote: "Start with a blank deck or connect the workspace presentation integration.",
+    },
+    {
+        id: "content",
+        name: "Content",
+        description: "Write and organize local MDX content with agent assistance.",
+        icon: "FileText",
+        color: "#10B981",
+        template: "content",
+        liveUrl: "https://content.agent-native.com",
+        category: "content",
+        setupNote: "Choose a content folder or create a first document for the private remix.",
+    },
+    {
+        id: "clips",
+        name: "Clips",
+        description: "Record screens, capture meeting notes, and use voice dictation with AI.",
+        icon: "ScreenShare",
+        color: "#0EA5E9",
+        template: "clips",
+        liveUrl: "https://clips.agent-native.com",
+        category: "media",
+        setupNote: "Grant screen and audio permissions only when the workspace needs recording.",
+    },
+    {
+        id: "brain",
+        name: "Brain",
+        description: "Search cited company knowledge from conversations, meetings, and decisions.",
+        icon: "Brain",
+        color: "#8B5CF6",
+        template: "brain",
+        liveUrl: "https://brain.agent-native.com",
+        category: "knowledge",
+        setupNote: "Connect approved knowledge sources before indexing workspace information.",
+    },
+    {
+        id: "assets",
+        name: "Assets",
+        description: "Upload, organize, search, and generate on-brand images and videos.",
+        icon: "Photo",
+        color: "#0F766E",
+        template: "assets",
+        liveUrl: "https://assets.agent-native.com",
+        category: "content",
+        setupNote: "Upload a representative asset or connect approved asset storage to begin.",
+    },
+    {
+        id: "forms",
+        name: "Forms",
+        description: "Create, edit, and manage forms with agent assistance.",
+        icon: "ClipboardList",
+        color: "#06B6D4",
+        template: "forms",
+        liveUrl: "https://forms.agent-native.com",
+        category: "operations",
+        setupNote: "Create a form and choose its submission destination before inviting respondents.",
+    },
+    {
+        id: "design",
+        name: "Design",
+        description: "Create and edit visual designs with agent-assisted exploration.",
+        icon: "Brush",
+        color: "#F472B6",
+        template: "design",
+        liveUrl: "https://design.agent-native.com",
+        category: "creative",
+        setupNote: "Create a private project and optionally connect approved asset sources.",
+    },
+];
+const curatedTemplateById = new Map(CURATED_WORKSPACE_TEMPLATES.map((template) => [template.id, template]));
+export function getCuratedWorkspaceTemplate(templateId) {
+    const normalized = templateId.trim().toLowerCase();
+    const template = curatedTemplateById.get(normalized);
+    if (!template) {
+        throw new Error(`Unknown curated workspace template "${templateId}".`);
+    }
+    return template;
+}
+export async function listCuratedWorkspaceTemplates() {
+    const installedIds = new Set((await listWorkspaceApps({
+        includeAgentCards: false,
+        includeArchived: true,
+    })).map((app) => app.id.trim().toLowerCase()));
+    return CURATED_WORKSPACE_TEMPLATES.map((template) => ({
+        ...template,
+        installed: installedIds.has(template.id),
+    }));
+}
+//# sourceMappingURL=curated-workspace-templates.js.map

package/dist/server/lib/curated-workspace-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curated-workspace-templates.js","sourceRoot":"","sources":["../../../src/server/lib/curated-workspace-templates.ts"],"names":[],"mappings":"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","sourcesContent":["import { listWorkspaceApps } from \"./app-creation-store.js\";\n\nexport interface CuratedWorkspaceTemplate {\n  id: string;\n  name: string;\n  description: string;\n  icon: string;\n  color: string;\n  template: string;\n  liveUrl: string;\n  category: string;\n  setupNote: string;\n}\n\nexport interface CuratedWorkspaceTemplateStatus extends CuratedWorkspaceTemplate {\n  installed: boolean;\n}\n\n/**\n * Stable first-party template metadata for the initial remix catalog.\n * `liveUrl` identifies the product URL; it is not a public-demo claim.\n */\nexport const CURATED_WORKSPACE_TEMPLATES: readonly CuratedWorkspaceTemplate[] =\n  [\n    {\n      id: \"mail\",\n      name: \"Mail\",\n      description:\n        \"Agent-native email client with keyboard shortcuts and AI triage.\",\n      icon: \"Mail\",\n      color: \"#3B82F6\",\n      template: \"mail\",\n      liveUrl: \"https://mail.agent-native.com\",\n      category: \"communication\",\n      setupNote:\n        \"Connect the workspace email integration before working with live mail.\",\n    },\n    {\n      id: \"calendar\",\n      name: \"Calendar\",\n      description:\n        \"Manage events, synchronization, and public booking with an agent-native calendar.\",\n      icon: \"CalendarDays\",\n      color: \"#00B5FF\",\n      template: \"calendar\",\n      liveUrl: \"https://calendar.agent-native.com\",\n      category: \"productivity\",\n      setupNote:\n        \"Connect the workspace calendar integration before working with live events.\",\n    },\n    {\n      id: \"analytics\",\n      name: \"Analytics\",\n      description:\n        \"Connect data sources and prompt for charts, reports, and product insights.\",\n      icon: \"BarChart2\",\n      color: \"#F59E0B\",\n      template: \"analytics\",\n      liveUrl: \"https://analytics.agent-native.com\",\n      category: \"insights\",\n      setupNote:\n        \"Connect a data source or import a representative dataset before analysis.\",\n    },\n    {\n      id: \"slides\",\n      name: \"Slides\",\n      description:\n        \"Generate and edit React presentations with agent assistance.\",\n      icon: \"GalleryHorizontal\",\n      color: \"#EC4899\",\n      template: \"slides\",\n      liveUrl: \"https://slides.agent-native.com\",\n      category: \"creative\",\n      setupNote:\n        \"Start with a blank deck or connect the workspace presentation integration.\",\n    },\n    {\n      id: \"content\",\n      name: \"Content\",\n      description:\n        \"Write and organize local MDX content with agent assistance.\",\n      icon: \"FileText\",\n      color: \"#10B981\",\n      template: \"content\",\n      liveUrl: \"https://content.agent-native.com\",\n      category: \"content\",\n      setupNote:\n        \"Choose a content folder or create a first document for the private remix.\",\n    },\n    {\n      id: \"clips\",\n      name: \"Clips\",\n      description:\n        \"Record screens, capture meeting notes, and use voice dictation with AI.\",\n      icon: \"ScreenShare\",\n      color: \"#0EA5E9\",\n      template: \"clips\",\n      liveUrl: \"https://clips.agent-native.com\",\n      category: \"media\",\n      setupNote:\n        \"Grant screen and audio permissions only when the workspace needs recording.\",\n    },\n    {\n      id: \"brain\",\n      name: \"Brain\",\n      description:\n        \"Search cited company knowledge from conversations, meetings, and decisions.\",\n      icon: \"Brain\",\n      color: \"#8B5CF6\",\n      template: \"brain\",\n      liveUrl: \"https://brain.agent-native.com\",\n      category: \"knowledge\",\n      setupNote:\n        \"Connect approved knowledge sources before indexing workspace information.\",\n    },\n    {\n      id: \"assets\",\n      name: \"Assets\",\n      description:\n        \"Upload, organize, search, and generate on-brand images and videos.\",\n      icon: \"Photo\",\n      color: \"#0F766E\",\n      template: \"assets\",\n      liveUrl: \"https://assets.agent-native.com\",\n      category: \"content\",\n      setupNote:\n        \"Upload a representative asset or connect approved asset storage to begin.\",\n    },\n    {\n      id: \"forms\",\n      name: \"Forms\",\n      description: \"Create, edit, and manage forms with agent assistance.\",\n      icon: \"ClipboardList\",\n      color: \"#06B6D4\",\n      template: \"forms\",\n      liveUrl: \"https://forms.agent-native.com\",\n      category: \"operations\",\n      setupNote:\n        \"Create a form and choose its submission destination before inviting respondents.\",\n    },\n    {\n      id: \"design\",\n      name: \"Design\",\n      description:\n        \"Create and edit visual designs with agent-assisted exploration.\",\n      icon: \"Brush\",\n      color: \"#F472B6\",\n      template: \"design\",\n      liveUrl: \"https://design.agent-native.com\",\n      category: \"creative\",\n      setupNote:\n        \"Create a private project and optionally connect approved asset sources.\",\n    },\n  ] as const;\n\nconst curatedTemplateById = new Map(\n  CURATED_WORKSPACE_TEMPLATES.map((template) => [template.id, template]),\n);\n\nexport function getCuratedWorkspaceTemplate(\n  templateId: string,\n): CuratedWorkspaceTemplate {\n  const normalized = templateId.trim().toLowerCase();\n  const template = curatedTemplateById.get(normalized);\n  if (!template) {\n    throw new Error(`Unknown curated workspace template \"${templateId}\".`);\n  }\n  return template;\n}\n\nexport async function listCuratedWorkspaceTemplates(): Promise<\n  CuratedWorkspaceTemplateStatus[]\n> {\n  const installedIds = new Set(\n    (\n      await listWorkspaceApps({\n        includeAgentCards: false,\n        includeArchived: true,\n      })\n    ).map((app) => app.id.trim().toLowerCase()),\n  );\n\n  return CURATED_WORKSPACE_TEMPLATES.map((template) => ({\n    ...template,\n    installed: installedIds.has(template.id),\n  }));\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/dispatch",
-  "version": "0.14.14",
+  "version": "0.15.1",
   "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": {
@@ -17,6 +17,12 @@
     "src"
   ],
   "type": "module",
+  "sideEffects": [
+    "*.css",
+    "dist/server/index.js",
+    "dist/server/lib/usage-metrics-store.js",
+    "dist/server/plugins/core-routes.js"
+  ],
   "exports": {
     ".": "./dist/index.js",
     "./routes": "./dist/routes/index.js",
@@ -93,7 +99,7 @@
     "typescript-7": "npm:typescript@^7.0.2",
     "vite": "8.1.0",
     "vitest": "^4.1.5",
-    "@agent-native/core": "0.107.1"
+    "@agent-native/core": "0.109.4"
   },
   "peerDependencies": {
     "@agent-native/core": ">=0.8.0",

package/src/actions/index.ts

@@ -33,6 +33,7 @@ import grantWorkspaceResourcesToApp from "./grant-workspace-resources-to-app.js"
 import listAgentThreadSources from "./list-agent-thread-sources.js";
 import listAvailableWorkspaceTemplates from "./list-available-workspace-templates.js";
 import listConnectedAgents from "./list-connected-agents.js";
+import listCuratedWorkspaceTemplates from "./list-curated-workspace-templates.js";
 import listDestinations from "./list-destinations.js";
 import listDispatchApprovals from "./list-dispatch-approvals.js";
 import listDispatchAudit from "./list-dispatch-audit.js";
@@ -66,6 +67,7 @@ import providerApiRequest from "./provider-api-request.js";
 import queryStagedDataset from "./query-staged-dataset.js";
 import rejectDispatchChange from "./reject-dispatch-change.js";
 import rejectDreamProposal from "./reject-dream-proposal.js";
+import remixWorkspaceTemplate from "./remix-workspace-template.js";
 import removePendingWorkspaceApp from "./remove-pending-workspace-app.js";
 import requestVaultSecret from "./request-vault-secret.js";
 import restoreStarterWorkspaceResources from "./restore-starter-workspace-resources.js";
@@ -128,6 +130,7 @@ export const dispatchActions: Record<string, ActionEntry> = {
   "grant-vault-secrets-to-app": grantVaultSecretsToApp,
   "list-agent-thread-sources": listAgentThreadSources,
   "list-available-workspace-templates": listAvailableWorkspaceTemplates,
+  "list-curated-workspace-templates": listCuratedWorkspaceTemplates,
   "list-connected-agents": listConnectedAgents,
   "list-destinations": listDestinations,
   "list-dispatch-approvals": listDispatchApprovals,
@@ -164,6 +167,7 @@ export const dispatchActions: Record<string, ActionEntry> = {
   "reject-dispatch-change": rejectDispatchChange,
   "reject-dream-proposal": rejectDreamProposal,
   "remove-pending-workspace-app": removePendingWorkspaceApp,
+  "remix-workspace-template": remixWorkspaceTemplate,
   "request-vault-secret": requestVaultSecret,
   "revoke-vault-grant": revokeVaultGrant,
   "revoke-workspace-resource-grant": revokeWorkspaceResourceGrant,

package/src/actions/list-curated-workspace-templates.spec.ts

@@ -0,0 +1,36 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const mocks = vi.hoisted(() => ({
+  listCuratedWorkspaceTemplates: vi.fn(),
+}));
+
+vi.mock("../server/lib/curated-workspace-templates.js", () => ({
+  listCuratedWorkspaceTemplates: mocks.listCuratedWorkspaceTemplates,
+}));
+
+import action from "./list-curated-workspace-templates.js";
+
+describe("list-curated-workspace-templates action", () => {
+  beforeEach(() => vi.clearAllMocks());
+
+  it("delegates to the catalog store", async () => {
+    const templates = [
+      {
+        id: "mail",
+        name: "Mail",
+        description: "Email",
+        icon: "Mail",
+        color: "#3B82F6",
+        template: "mail",
+        liveUrl: "https://mail.agent-native.com",
+        category: "communication",
+        setupNote: "Connect email.",
+        installed: false,
+      },
+    ];
+    mocks.listCuratedWorkspaceTemplates.mockResolvedValue(templates);
+
+    await expect(action.run({})).resolves.toEqual(templates);
+    expect(mocks.listCuratedWorkspaceTemplates).toHaveBeenCalledOnce();
+  });
+});

package/src/actions/list-curated-workspace-templates.ts

@@ -0,0 +1,12 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { listCuratedWorkspaceTemplates } from "../server/lib/curated-workspace-templates.js";
+
+export default defineAction({
+  description:
+    "List the curated first-party workspace templates available for private remixing. Returns stable template metadata, the product/live URL (not a public-demo claim), setup guidance, and whether each source template is already installed in the current workspace.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  run: async () => listCuratedWorkspaceTemplates(),
+});

package/src/actions/remix-workspace-template.spec.ts

@@ -0,0 +1,116 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+const mocks = vi.hoisted(() => ({
+  isLocalAppCreationRuntime: vi.fn(() => process.env.NODE_ENV !== "production"),
+  scaffoldWorkspaceAppFromTemplate: vi.fn(),
+  startWorkspaceAppCreation: vi.fn(),
+  recordAudit: vi.fn(),
+}));
+
+vi.mock("../server/lib/app-creation-store.js", () => ({
+  isLocalAppCreationRuntime: mocks.isLocalAppCreationRuntime,
+  scaffoldWorkspaceAppFromTemplate: mocks.scaffoldWorkspaceAppFromTemplate,
+  startWorkspaceAppCreation: mocks.startWorkspaceAppCreation,
+}));
+
+vi.mock("../server/lib/dispatch-store.js", () => ({
+  recordAudit: mocks.recordAudit,
+}));
+
+import action from "./remix-workspace-template.js";
+
+describe("remix-workspace-template action", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.recordAudit.mockResolvedValue(undefined);
+  });
+
+  afterEach(() => {
+    vi.unstubAllEnvs();
+  });
+
+  it("scaffolds the curated source template in local app-creation runtime", async () => {
+    vi.stubEnv("NODE_ENV", "test");
+    vi.stubEnv("NETLIFY", "");
+    mocks.scaffoldWorkspaceAppFromTemplate.mockResolvedValue({
+      appId: "mail-remix",
+      template: "mail",
+      output: "scaffolded",
+    });
+
+    const result = await action.run({
+      templateId: "mail",
+      appId: "mail-remix",
+      description: "A private support inbox.",
+    });
+
+    expect(mocks.scaffoldWorkspaceAppFromTemplate).toHaveBeenCalledWith({
+      template: "mail",
+      appId: "mail-remix",
+    });
+    expect(mocks.startWorkspaceAppCreation).not.toHaveBeenCalled();
+    expect(result).toEqual(
+      expect.objectContaining({
+        appId: "mail-remix",
+        sourceTemplate: expect.objectContaining({
+          id: "mail",
+          template: "mail",
+          setupNote: expect.any(String),
+        }),
+      }),
+    );
+    expect(mocks.recordAudit).toHaveBeenCalledWith(
+      expect.objectContaining({
+        action: "workspace-app.remix-requested",
+        targetId: "mail-remix",
+        metadata: expect.objectContaining({ sourceTemplate: "mail" }),
+      }),
+    );
+  });
+
+  it("starts a hosted private remix without copying data or secrets", async () => {
+    vi.stubEnv("NODE_ENV", "production");
+    mocks.startWorkspaceAppCreation.mockResolvedValue({
+      mode: "builder",
+      appId: "calendar-remix",
+      status: "processing",
+    });
+
+    const result = await action.run({
+      templateId: "calendar",
+      description: "A private scheduling workflow.",
+    });
+
+    expect(mocks.scaffoldWorkspaceAppFromTemplate).not.toHaveBeenCalled();
+    expect(mocks.startWorkspaceAppCreation).toHaveBeenCalledWith(
+      expect.objectContaining({
+        appId: "calendar-remix",
+        template: "calendar",
+        description: "A private scheduling workflow.",
+        prompt: expect.stringContaining(
+          "private workspace remix of a curated first-party template",
+        ),
+      }),
+    );
+    const prompt = mocks.startWorkspaceAppCreation.mock.calls[0][0].prompt;
+    expect(prompt).toContain("Source template: Calendar (calendar)");
+    expect(prompt).toContain("Never copy source-app data");
+    expect(prompt).toContain("secrets");
+    expect(result).toEqual(
+      expect.objectContaining({
+        mode: "builder",
+        sourceTemplate: expect.objectContaining({ id: "calendar" }),
+      }),
+    );
+  });
+
+  it("rejects templates outside the curated catalog before creating an app", async () => {
+    await expect(
+      action.run({ templateId: "not-a-curated-template", appId: null }),
+    ).rejects.toThrow(
+      'Unknown curated workspace template "not-a-curated-template".',
+    );
+    expect(mocks.scaffoldWorkspaceAppFromTemplate).not.toHaveBeenCalled();
+    expect(mocks.startWorkspaceAppCreation).not.toHaveBeenCalled();
+  });
+});

package/src/actions/remix-workspace-template.ts

@@ -0,0 +1,99 @@
+import { defineAction } from "@agent-native/core";
+import { getWorkspaceAppIdValidationError } from "@agent-native/core/shared";
+import { z } from "zod";
+
+import {
+  isLocalAppCreationRuntime,
+  scaffoldWorkspaceAppFromTemplate,
+  startWorkspaceAppCreation,
+} from "../server/lib/app-creation-store.js";
+import { getCuratedWorkspaceTemplate } from "../server/lib/curated-workspace-templates.js";
+import { recordAudit } from "../server/lib/dispatch-store.js";
+
+function buildRemixPrompt(input: {
+  templateName: string;
+  templateId: string;
+  setupNote: string;
+  description?: string | null;
+}): string {
+  return [
+    "Create a private workspace remix of a curated first-party template.",
+    `Source template: ${input.templateName} (${input.templateId}).`,
+    "Recreate the source template's product shape and capabilities as an independent workspace app.",
+    "Never copy source-app data, records, user content, secrets, credentials, tokens, API keys, or private configuration.",
+    "Use empty or synthetic seed data only, keep the remix private to the current workspace, and do not create a public demo.",
+    `Setup note: ${input.setupNote}`,
+    input.description?.trim()
+      ? `Requested customization: ${input.description.trim()}`
+      : "Keep the first version close to the curated source template while preserving independent ownership.",
+  ].join(" ");
+}
+
+export default defineAction({
+  description:
+    "Create a private, independent remix of one of Dispatch's curated first-party workspace templates. Valid templates are mail, calendar, analytics, slides, content, clips, brain, assets, forms, and design. The remix must not copy source-app data, secrets, credentials, or private configuration; local workspaces scaffold the template, while hosted workspaces start a Builder app-creation branch.",
+  schema: z.object({
+    templateId: z
+      .string()
+      .min(1)
+      .describe(
+        "Curated source template id: mail, calendar, analytics, slides, content, clips, brain, assets, forms, or design.",
+      ),
+    appId: z
+      .string()
+      .max(64)
+      .optional()
+      .nullable()
+      .refine((appId) => !appId || !getWorkspaceAppIdValidationError(appId), {
+        message:
+          "Use a non-reserved app id with lowercase letters, numbers, and hyphens.",
+      })
+      .describe(
+        "Optional target workspace app id. Defaults to <template>-remix so the source app remains independent.",
+      ),
+    description: z
+      .string()
+      .max(500)
+      .optional()
+      .nullable()
+      .describe("Optional customization or purpose for the private remix."),
+  }),
+  run: async (input) => {
+    const sourceTemplate = getCuratedWorkspaceTemplate(input.templateId);
+    const appId = input.appId?.trim() || `${sourceTemplate.template}-remix`;
+
+    const result = isLocalAppCreationRuntime()
+      ? await scaffoldWorkspaceAppFromTemplate({
+          template: sourceTemplate.template,
+          appId,
+        })
+      : await startWorkspaceAppCreation({
+          prompt: buildRemixPrompt({
+            templateName: sourceTemplate.name,
+            templateId: sourceTemplate.template,
+            setupNote: sourceTemplate.setupNote,
+            description: input.description,
+          }),
+          appId,
+          description: input.description,
+          template: sourceTemplate.template,
+        });
+
+    await recordAudit({
+      action: "workspace-app.remix-requested",
+      targetType: "workspace-app",
+      targetId: appId,
+      summary: `Requested private remix of ${sourceTemplate.name}`,
+      metadata: {
+        sourceTemplate: sourceTemplate.template,
+        mode:
+          result && typeof result === "object" && "mode" in result
+            ? result.mode
+            : "local",
+        descriptionConfigured: !!input.description?.trim(),
+      },
+    });
+
+    return { ...result, sourceTemplate };
+  },
+});

package/src/components/workspace-template-card.spec.tsx

@@ -0,0 +1,174 @@
+// @vitest-environment happy-dom
+import React, { act } from "react";
+import { createRoot, type Root } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+import {
+  WorkspaceTemplateCard,
+  WorkspaceTemplatesSection,
+  type CuratedWorkspaceTemplate,
+} from "./workspace-template-card";
+
+const clientState = vi.hoisted(() => ({
+  mutation: vi.fn(),
+  options: null as Record<string, unknown> | null,
+  isPending: false,
+}));
+
+const toast = vi.hoisted(() => ({
+  error: vi.fn(),
+  success: vi.fn(),
+}));
+
+vi.mock("@agent-native/core/client", () => ({
+  useActionMutation: (_name: string, options: Record<string, unknown>) => {
+    clientState.options = options;
+    return {
+      mutate: clientState.mutation,
+      isPending: clientState.isPending,
+    };
+  },
+}));
+
+vi.mock("sonner", () => ({ toast }));
+
+const template: CuratedWorkspaceTemplate = {
+  id: "weekly-report",
+  name: "Weekly report",
+  description: "Turn workspace activity into a concise weekly report.",
+  source: "RevOps",
+  integrationSetup: "Connect your CRM after installing the app.",
+  liveUrl: "https://reports.example.test",
+};
+
+describe("WorkspaceTemplateCard", () => {
+  let container: HTMLDivElement;
+  let root: Root;
+
+  beforeEach(() => {
+    vi.stubGlobal("IS_REACT_ACT_ENVIRONMENT", true);
+    clientState.mutation.mockReset();
+    clientState.options = null;
+    clientState.isPending = false;
+    toast.error.mockReset();
+    toast.success.mockReset();
+    container = document.createElement("div");
+    document.body.appendChild(container);
+    root = createRoot(container);
+  });
+
+  afterEach(() => {
+    act(() => root.unmount());
+    container.remove();
+    document.body
+      .querySelectorAll("[data-radix-portal]")
+      .forEach((portal) => portal.remove());
+    vi.unstubAllGlobals();
+  });
+
+  it("shows template context and only links to a live app when supplied", async () => {
+    await act(async () => {
+      root.render(<WorkspaceTemplateCard template={template} />);
+    });
+
+    expect(container.textContent).toContain("Weekly report");
+    expect(container.textContent).toContain("RevOps");
+    expect(container.textContent).toContain(
+      "Connect your CRM after installing the app.",
+    );
+
+    const liveLink = container.querySelector<HTMLAnchorElement>(
+      'a[href="https://reports.example.test"]',
+    );
+    expect(liveLink?.textContent).toContain("View the live app");
+    expect(liveLink?.target).toBe("_blank");
+
+    await act(async () => {
+      root.render(
+        <WorkspaceTemplateCard
+          template={{ ...template, liveUrl: null, productUrl: null }}
+        />,
+      );
+    });
+    expect(
+      container.querySelector('a[href="https://reports.example.test"]'),
+    ).toBe(null);
+  });
+
+  it("remixes with the default app id and allows an override", async () => {
+    await act(async () => {
+      root.render(
+        <WorkspaceTemplateCard template={template} defaultAppId="pipeline" />,
+      );
+    });
+
+    const trigger = Array.from(container.querySelectorAll("button")).find(
+      (button) => button.textContent?.includes("Remix into workspace"),
+    );
+    expect(trigger).not.toBeUndefined();
+
+    await act(async () => {
+      trigger?.click();
+    });
+
+    const input = document.body.querySelector<HTMLInputElement>(
+      "#workspace-template-app-id-weekly-report",
+    );
+    expect(input?.value).toBe("pipeline");
+
+    await act(async () => {
+      if (!input) throw new Error("Expected app id input");
+      Object.getOwnPropertyDescriptor(
+        HTMLInputElement.prototype,
+        "value",
+      )?.set?.call(input, "sales-ops");
+      input.dispatchEvent(new Event("input", { bubbles: true }));
+    });
+
+    await act(async () => {
+      document.body.querySelector<HTMLFormElement>("form")?.requestSubmit();
+    });
+
+    expect(clientState.mutation).toHaveBeenCalledWith({
+      templateId: "weekly-report",
+      appId: "sales-ops",
+    });
+
+    await act(async () => {
+      await (clientState.options?.onSuccess as (result: unknown) => unknown)({
+        appId: "sales-ops",
+      });
+    });
+    expect(toast.success).toHaveBeenCalledWith(
+      "Template remixed into your workspace.",
+    );
+  });
+
+  it("accepts the list action envelope and renders installed state", async () => {
+    await act(async () => {
+      root.render(
+        <WorkspaceTemplatesSection
+          templates={{
+            templates: [
+              {
+                ...template,
+                installed: true,
+                liveUrl: null,
+                productUrl: null,
+              },
+            ],
+          }}
+          title="Curated templates"
+        />,
+      );
+    });
+
+    expect(container.textContent).toContain("Curated templates");
+    expect(container.textContent).toContain("Installed");
+    expect(container.querySelector('a[href^="https://"]')).toBeNull();
+    const remixButton = Array.from(container.querySelectorAll("button")).find(
+      (button) => button.textContent?.includes("Remix into workspace"),
+    );
+    expect(remixButton).not.toHaveProperty("disabled", true);
+  });
+});