@agent-native/dispatch 0.3.0 → 0.5.0

package/dist/server/lib/app-creation-store.d.ts

@@ -15,9 +15,25 @@ export interface WorkspaceAppSummary {
     a2aEndpointUrl?: string | null;
     agentName?: string | null;
     agentSkillsCount?: number | null;
+    archived?: boolean;
 }
 export interface ListWorkspaceAppsOptions {
     includeAgentCards?: boolean;
+    /**
+     * Include apps the current viewer has hidden (archived). Defaults to false
+     * so polling/UI callers see only the visible set; the apps page passes true
+     * when rendering the "Hidden apps" expander.
+     */
+    includeArchived?: boolean;
+}
+export interface AvailableWorkspaceTemplate {
+    name: string;
+    label: string;
+    hint: string;
+    icon: string;
+    color: string;
+    colorRgb: string;
+    core: boolean;
 }
 export interface AppCreationSettings {
     builderProjectId: string | null;
@@ -36,6 +52,21 @@ export interface WorkspaceInfo {
     /** Number of apps currently scaffolded under apps/. */
     appCount: number;
 }
+export declare function archiveWorkspaceApp(input: {
+    appId: string;
+}): Promise<{
+    archivedAppIds: string[];
+}>;
+export declare function unarchiveWorkspaceApp(input: {
+    appId: string;
+}): Promise<{
+    archivedAppIds: string[];
+}>;
+export declare function removePendingWorkspaceApp(input: {
+    appId: string;
+}): Promise<{
+    removed: boolean;
+}>;
 export declare function getEnvBuilderProjectId(): string | null;
 /**
  * Read the workspace's identity from the workspace root's package.json. Used to
@@ -45,6 +76,15 @@ export declare function getEnvBuilderProjectId(): string | null;
  */
 export declare function getWorkspaceInfo(): WorkspaceInfo;
 export declare function listWorkspaceApps(options?: ListWorkspaceAppsOptions): Promise<WorkspaceAppSummary[]>;
+export declare function listAvailableWorkspaceTemplates(): Promise<AvailableWorkspaceTemplate[]>;
+export declare function scaffoldWorkspaceAppFromTemplate(input: {
+    template: string;
+    appId?: string | null;
+}): Promise<{
+    appId: string;
+    template: string;
+    output: string;
+}>;
 export declare function getAppCreationSettings(): Promise<AppCreationSettings>;
 export declare function setAppCreationSettings(input: {
     builderProjectId?: string | null;

package/dist/server/lib/app-creation-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-creation-store.d.ts","sourceRoot":"","sources":["../../../src/server/lib/app-creation-store.ts"],"names":[],"mappings":"AAqCA,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sBAAsB,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IACjE,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,qEAAqE;IACrE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAwdD,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAOtD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAiChD;AAED,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAoDhC;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CA6B3E;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAe/B;AA6QD,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgIA"}
+{"version":3,"file":"app-creation-store.d.ts","sourceRoot":"","sources":["../../../src/server/lib/app-creation-store.ts"],"names":[],"mappings":"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"}

package/dist/server/lib/app-creation-store.js

@@ -1,3 +1,4 @@
+import { spawn } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -178,6 +179,69 @@ async function listPendingWorkspaceApps() {
     const raw = await readSettingsRecord();
     return parsePendingWorkspaceApps(raw.pendingApps);
 }
+function parseArchivedAppIds(value) {
+    if (!Array.isArray(value))
+        return [];
+    const ids = value
+        .map((entry) => (typeof entry === "string" ? entry.trim() : ""))
+        .filter(Boolean);
+    return Array.from(new Set(ids));
+}
+async function listArchivedAppIds() {
+    const raw = await readSettingsRecord();
+    return parseArchivedAppIds(raw.archivedAppIds);
+}
+export async function archiveWorkspaceApp(input) {
+    const appId = input.appId.trim();
+    if (!appId)
+        throw new Error("appId is required");
+    const raw = await readSettingsRecord();
+    const current = parseArchivedAppIds(raw.archivedAppIds);
+    if (!current.includes(appId))
+        current.push(appId);
+    await putSetting(scopedSettingsKey(), { ...raw, archivedAppIds: current });
+    await recordAudit({
+        action: "workspace-app.archived",
+        targetType: "workspace-app",
+        targetId: appId,
+        summary: "Hid workspace app from the Apps list",
+    });
+    return { archivedAppIds: current };
+}
+export async function unarchiveWorkspaceApp(input) {
+    const appId = input.appId.trim();
+    if (!appId)
+        throw new Error("appId is required");
+    const raw = await readSettingsRecord();
+    const current = parseArchivedAppIds(raw.archivedAppIds).filter((id) => id !== appId);
+    await putSetting(scopedSettingsKey(), { ...raw, archivedAppIds: current });
+    await recordAudit({
+        action: "workspace-app.unarchived",
+        targetType: "workspace-app",
+        targetId: appId,
+        summary: "Restored workspace app to the Apps list",
+    });
+    return { archivedAppIds: current };
+}
+export async function removePendingWorkspaceApp(input) {
+    const appId = input.appId.trim();
+    if (!appId)
+        throw new Error("appId is required");
+    const raw = await readSettingsRecord();
+    const pending = parsePendingWorkspaceApps(raw.pendingApps);
+    const next = pending.filter((app) => app.id !== appId);
+    const removed = next.length !== pending.length;
+    if (!removed)
+        return { removed: false };
+    await putSetting(scopedSettingsKey(), { ...raw, pendingApps: next });
+    await recordAudit({
+        action: "workspace-app.pending-removed",
+        targetType: "workspace-app",
+        targetId: appId,
+        summary: "Removed pending Builder app from the Apps list",
+    });
+    return { removed: true };
+}
 function pendingAppToSummary(app) {
     return {
         id: app.id,
@@ -459,24 +523,35 @@ export function getWorkspaceInfo() {
         appCount,
     };
 }
+async function applyArchivedAndPending(apps, options) {
+    const [withPending, archivedIds] = await Promise.all([
+        appendPendingWorkspaceApps(apps),
+        listArchivedAppIds(),
+    ]);
+    const archivedSet = new Set(archivedIds);
+    const annotated = withPending.map((app) => archivedSet.has(app.id) ? { ...app, archived: true } : app);
+    return options.includeArchived
+        ? annotated
+        : annotated.filter((app) => !app.archived);
+}
 export async function listWorkspaceApps(options = {}) {
     const gatewayApps = await readWorkspaceAppsFromGateway();
     if (gatewayApps) {
-        return maybeIncludeAgentCards(await appendPendingWorkspaceApps(gatewayApps), options);
+        return maybeIncludeAgentCards(await applyArchivedAndPending(gatewayApps, options), options);
     }
     const workspaceRoot = findWorkspaceRoot();
     const localFilesystemApps = workspaceRoot && isLocalAppCreationRuntime()
         ? readWorkspaceAppsFromFilesystem(workspaceRoot)
         : null;
     if (localFilesystemApps) {
-        return maybeIncludeAgentCards(await appendPendingWorkspaceApps(localFilesystemApps), options);
+        return maybeIncludeAgentCards(await applyArchivedAndPending(localFilesystemApps, options), options);
     }
     const manifestApps = readWorkspaceAppsFromEnv() ?? readWorkspaceAppsFromManifestFile();
     if (manifestApps) {
-        return maybeIncludeAgentCards(await appendPendingWorkspaceApps(manifestApps), options);
+        return maybeIncludeAgentCards(await applyArchivedAndPending(manifestApps, options), options);
     }
     if (!workspaceRoot) {
-        return maybeIncludeAgentCards(await appendPendingWorkspaceApps([
+        return maybeIncludeAgentCards(await applyArchivedAndPending([
             {
                 id: "dispatch",
                 name: "Dispatch",
@@ -486,10 +561,174 @@ export async function listWorkspaceApps(options = {}) {
                 isDispatch: true,
                 status: "ready",
             },
-        ]), options);
+        ], options), options);
     }
     const apps = readWorkspaceAppsFromFilesystem(workspaceRoot) ?? [];
-    return maybeIncludeAgentCards(await appendPendingWorkspaceApps(apps), options);
+    return maybeIncludeAgentCards(await applyArchivedAndPending(apps, options), options);
+}
+/**
+ * First-party templates the user can scaffold into this workspace via the
+ * Apps page tiles. Inlined here (rather than importing from
+ * `@agent-native/shared-app-config`) because the published `@agent-native/dispatch`
+ * package has no `workspace:*` runtime dependencies. Keep in sync with
+ * `packages/core/src/cli/templates-meta.ts`.
+ */
+const ADDABLE_TEMPLATES = [
+    {
+        name: "mail",
+        label: "Mail",
+        hint: "Email client with keyboard shortcuts and AI triage",
+        icon: "Mail",
+        color: "#3B82F6",
+        colorRgb: "59 130 246",
+        core: true,
+    },
+    {
+        name: "calendar",
+        label: "Calendar",
+        hint: "Manage events, sync, and public booking",
+        icon: "CalendarMonth",
+        color: "#8B5CF6",
+        colorRgb: "139 92 246",
+        core: true,
+    },
+    {
+        name: "content",
+        label: "Content",
+        hint: "Write and organize with agent assistance",
+        icon: "FileText",
+        color: "#10B981",
+        colorRgb: "16 185 129",
+        core: true,
+    },
+    {
+        name: "slides",
+        label: "Slides",
+        hint: "Generate and edit React presentations",
+        icon: "Presentation",
+        color: "#EC4899",
+        colorRgb: "236 72 153",
+        core: true,
+    },
+    {
+        name: "clips",
+        label: "Clips",
+        hint: "Screen recording, meeting notes, and voice dictation",
+        icon: "ScreenShare",
+        color: "#625DF5",
+        colorRgb: "98 93 245",
+        core: true,
+    },
+    {
+        name: "analytics",
+        label: "Analytics",
+        hint: "Connect data sources, prompt for charts",
+        icon: "ChartBar",
+        color: "#F59E0B",
+        colorRgb: "245 158 11",
+        core: true,
+    },
+    {
+        name: "forms",
+        label: "Forms",
+        hint: "Create, edit, and manage forms",
+        icon: "ClipboardList",
+        color: "#06B6D4",
+        colorRgb: "6 182 212",
+        core: true,
+    },
+    {
+        name: "design",
+        label: "Design",
+        hint: "Create and edit visual designs with agent assistance",
+        icon: "Brush",
+        color: "#F472B6",
+        colorRgb: "244 114 182",
+        core: true,
+    },
+    {
+        name: "videos",
+        label: "Video",
+        hint: "Video editing with Remotion",
+        icon: "Video",
+        color: "#EF4444",
+        colorRgb: "239 68 68",
+        core: false,
+    },
+];
+export async function listAvailableWorkspaceTemplates() {
+    const installed = new Set((await listWorkspaceApps({ includeArchived: true })).map((app) => app.id));
+    return ADDABLE_TEMPLATES.filter((tpl) => !installed.has(tpl.name));
+}
+const SCAFFOLD_TIMEOUT_MS = 90_000;
+export async function scaffoldWorkspaceAppFromTemplate(input) {
+    if (!isLocalAppCreationRuntime()) {
+        throw new Error("Scaffolding from Dispatch is only available in local development. " +
+            "Use the Builder branch flow on a deployed workspace.");
+    }
+    const template = input.template.trim();
+    if (!template)
+        throw new Error("template is required");
+    if (!ADDABLE_TEMPLATES.some((tpl) => tpl.name === template)) {
+        throw new Error(`Unknown template "${template}".`);
+    }
+    const appId = (input.appId?.trim() || template).toLowerCase();
+    assertValidWorkspaceAppId(appId);
+    const workspaceRoot = findWorkspaceRoot();
+    if (!workspaceRoot) {
+        throw new Error("No agent-native workspace detected for scaffolding.");
+    }
+    const appDir = path.join(workspaceRoot, "apps", appId);
+    if (fs.existsSync(appDir)) {
+        throw new Error(`apps/${appId} already exists.`);
+    }
+    const output = await runScaffoldCli({
+        cwd: workspaceRoot,
+        args: ["add-app", appId, "--template", template],
+    });
+    await recordAudit({
+        action: "workspace-app.scaffolded",
+        targetType: "workspace-app",
+        targetId: appId,
+        summary: `Scaffolded apps/${appId} from ${template}`,
+        metadata: { template },
+    });
+    return { appId, template, output };
+}
+function runScaffoldCli(input) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("pnpm", ["exec", "agent-native", ...input.args], {
+            cwd: input.cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env, CI: "1", FORCE_COLOR: "0" },
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (chunk) => {
+            stdout += String(chunk);
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += String(chunk);
+        });
+        const timer = setTimeout(() => {
+            child.kill("SIGTERM");
+            reject(new Error(`Scaffold timed out after ${Math.round(SCAFFOLD_TIMEOUT_MS / 1000)}s`));
+        }, SCAFFOLD_TIMEOUT_MS);
+        timer.unref();
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.on("exit", (code) => {
+            clearTimeout(timer);
+            if (code === 0) {
+                resolve([stdout, stderr].filter(Boolean).join("\n").trim());
+                return;
+            }
+            const detail = (stderr || stdout || "").trim() || `exit code ${code}`;
+            reject(new Error(`Scaffold failed: ${detail}`));
+        });
+    });
 }
 export async function getAppCreationSettings() {
     const envBuilderProjectId = getEnvBuilderProjectId();