ace-swarm 1.1.0

package/dist/prompts.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP Prompts – pre-built prompt templates for each ACE role,
+ * multi-agent workflows, and skill activation.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2VvD"}

package/dist/prompts.js

@@ -0,0 +1,281 @@
+/**
+ * MCP Prompts – pre-built prompt templates for each ACE role,
+ * multi-agent workflows, and skill activation.
+ */
+import { z } from "zod";
+import { listAvailableSkills, readAgentInstructions, readSkillInstructions, readTaskArtifact, } from "./helpers.js";
+export function registerPrompts(server) {
+    // ── 1. Per-agent activation prompts ─────────────────────────────────
+    server.prompt("ace-orchestrator", "Activate ACE Orchestrator – Swarm Hypervisor and TPM", { task: z.string().optional().describe("What should the orchestrator do?") }, ({ task }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "# ACE Orchestrator Activation",
+                        "",
+                        "You are now operating as ACE-Orchestrator.",
+                        "",
+                        "## Orchestrator Instructions",
+                        readAgentInstructions("orchestrator"),
+                        "",
+                        "## Role Task Packs",
+                        readTaskArtifact("role_tasks"),
+                        "",
+                        "## Handoff Template",
+                        readTaskArtifact("handoff_template"),
+                        "",
+                        task
+                            ? `## Current Task\n${task}`
+                            : "## Awaiting Task\nScan state artifacts and propose next routed action.",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    server.prompt("ace-vos", "Activate ACE VOS – Venture Architect", { task: z.string().optional().describe("What venture question should VOS solve?") }, ({ task }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "# ACE VOS Activation",
+                        "",
+                        "You are now operating as ACE-VOS.",
+                        "",
+                        "## VOS Instructions",
+                        readAgentInstructions("vos"),
+                        "",
+                        "## CLI Work Split",
+                        readTaskArtifact("cli_work_split"),
+                        "",
+                        task
+                            ? `## Current Task\n${task}`
+                            : "## Awaiting Input\nBegin Socratic venture interrogation.",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    server.prompt("ace-ui", "Activate ACE UI – Mercer Protocol UX/CX Strategist", { task: z.string().optional().describe("What surface should UI audit or rewrite?") }, ({ task }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "# ACE UI Activation",
+                        "",
+                        "You are now operating as ACE-UI.",
+                        "",
+                        "## UI Instructions",
+                        readAgentInstructions("ui"),
+                        "",
+                        "## CLI Work Split",
+                        readTaskArtifact("cli_work_split"),
+                        "",
+                        task
+                            ? `## Current Task\n${task}`
+                            : "## Awaiting Input\nRun a Mercer audit on the current surface.",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    server.prompt("ace-coders", "Activate ACE Coders – Engineering TDD Swarm", { task: z.string().optional().describe("What should engineering build or fix?") }, ({ task }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "# ACE Coders Activation",
+                        "",
+                        "You are now operating as ACE-Coders.",
+                        "",
+                        "## Coders Instructions",
+                        readAgentInstructions("coders"),
+                        "",
+                        "## CLI Work Split",
+                        readTaskArtifact("cli_work_split"),
+                        "",
+                        task
+                            ? `## Current Task\n${task}`
+                            : "## Awaiting Spec\nLoad SPEC_CONTRACT.json or request a structured handoff.",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    // ── 2. Bootstrap and workflow prompts ───────────────────────────────
+    server.prompt("ace-initiate", "Initialize ACE state and route first task", {
+        goal: z.string().optional().describe("Primary objective for this ACE session"),
+    }, ({ goal }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "# Initiate ACE",
+                        "",
+                        "1. Run `bootstrap_state` to materialize ACE artifacts.",
+                        "2. Load `ace://tasks/role_tasks` and `ace://tasks/todo`.",
+                        "3. Route to the correct primary agent using `route_task`.",
+                        "4. Emit a structured handoff before execution.",
+                        "",
+                        goal ? `## Goal\n${goal}` : "## Goal\nDerive the next highest-value action from current state.",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    server.prompt("ace-genesis", "Run full Genesis pipeline: VOS → UI → Coders", { idea: z.string().describe("Describe the product idea or feature") }, ({ idea }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "# ACE Genesis Pipeline",
+                        "",
+                        `> ${idea}`,
+                        "",
+                        "## Pipeline",
+                        "1. VOS: harden thesis and distribution wedge.",
+                        "2. UI: design UX flow and copy deck.",
+                        "3. Coders: implement via TDD with verification evidence.",
+                        "",
+                        "## Handoff Contract",
+                        readTaskArtifact("handoff_template"),
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    server.prompt("ace-handoff", "Create a structured handoff between ACE agents", {
+        from: z.string().describe("Source agent (orchestrator, vos, ui, coders)"),
+        to: z.string().describe("Target agent (orchestrator, vos, ui, coders)"),
+        task: z.string().describe("What task is being handed off?"),
+    }, ({ from, to, task }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "# ACE Handoff Request",
+                        "",
+                        `Route: ACE-${from.toUpperCase()} -> ACE-${to.toUpperCase()}`,
+                        `Task: ${task}`,
+                        "",
+                        "## Handoff Template",
+                        readTaskArtifact("handoff_template"),
+                        "",
+                        "## Example",
+                        readTaskArtifact("handoff_example"),
+                        "",
+                        "## Rules",
+                        "- Populate every required field",
+                        "- Include artifact pointers, not narrative-only summaries",
+                        "- Use measurable acceptance criteria",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    server.prompt("ace-lessons", "Review and apply lessons/guardrails", () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "# ACE Lessons and Guardrails",
+                        "",
+                        readTaskArtifact("lessons"),
+                        "",
+                        "Apply these guardrails to all subsequent actions.",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    // ── 3. Skill prompts ─────────────────────────────────────────────────
+    server.prompt("ace-skill", "Load an ACE skill into active prompt context", {
+        skill: z.string().describe("Skill name (e.g. codemunch, codesnipe, ace-orchestrator)"),
+        task: z.string().optional().describe("Optional task to apply against the skill"),
+    }, ({ skill, task }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `# ACE Skill Activation: ${skill}`,
+                        "",
+                        readSkillInstructions(skill),
+                        "",
+                        task ? `## Task\n${task}` : "## Task\nApply this skill to the current workspace objective.",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    server.prompt("ace-codemunch", "Activate the codemunch skill for AST-first codebase mapping", { task: z.string().optional().describe("Optional analysis objective") }, ({ task }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "# CodeMunch Activation",
+                        "",
+                        readSkillInstructions("codemunch"),
+                        "",
+                        task
+                            ? `## Objective\n${task}`
+                            : "## Objective\nProduce CODEBASE_MAP.md and dependency insights using AST-first extraction.",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    server.prompt("ace-codesnipe", "Activate the codesnipe skill for dual-codebase comparison", { task: z.string().optional().describe("Optional comparison objective") }, ({ task }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "# CodeSnipe Activation",
+                        "",
+                        readSkillInstructions("codesnipe"),
+                        "",
+                        task
+                            ? `## Objective\n${task}`
+                            : "## Objective\nBuild HOME registry, score TARGET relevance, then extract only high-value symbols.",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    server.prompt("ace-skills-index", "List all discoverable ACE skills", () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "# ACE Skills Index",
+                        "",
+                        ...listAvailableSkills().map((skill) => `- ${skill.name} (${skill.source})`),
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}

package/dist/resources.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP Resources – expose ACE instruction files, task artifacts, skills,
+ * and handoff examples as readable resources.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerResources(server: McpServer): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAWtF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyLzD"}

package/dist/resources.js

@@ -0,0 +1,140 @@
+/**
+ * MCP Resources – expose ACE instruction files, task artifacts, skills,
+ * and handoff examples as readable resources.
+ */
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ALL_AGENTS, listAvailableSkills, readAgentInstructions, readAgentManifest, readSkillInstructions, readTaskArtifact, safeRead, } from "./helpers.js";
+export function registerResources(server) {
+    // ── 1. Agent instruction + manifest resources ────────────────────────
+    for (const role of ALL_AGENTS) {
+        server.resource(`ace-${role}-instructions`, `ace://agents/${role}/instructions`, {
+            description: `Full instruction file for ACE-${role.toUpperCase()} agent`,
+            mimeType: "text/markdown",
+        }, () => ({
+            contents: [
+                {
+                    uri: `ace://agents/${role}/instructions`,
+                    text: readAgentInstructions(role),
+                    mimeType: "text/markdown",
+                },
+            ],
+        }));
+        server.resource(`ace-${role}-manifest`, `ace://agents/${role}/manifest`, {
+            description: `Agent manifest for ACE-${role.toUpperCase()}`,
+            mimeType: "text/markdown",
+        }, () => ({
+            contents: [
+                {
+                    uri: `ace://agents/${role}/manifest`,
+                    text: readAgentManifest(role),
+                    mimeType: "text/markdown",
+                },
+            ],
+        }));
+    }
+    // ── 2. Task artifacts ────────────────────────────────────────────────
+    const taskResourceMap = {
+        todo: { desc: "Live checkable execution board" },
+        role_tasks: {
+            desc: "Explicit task boundaries per agent role",
+        },
+        cli_work_split: {
+            desc: "Codex CLI vs Gemini CLI routing contract",
+        },
+        lessons: {
+            desc: "Persistent guardrails captured after corrections",
+        },
+        readme: {
+            desc: "Control-plane overview for task artifacts",
+        },
+    };
+    for (const [key, meta] of Object.entries(taskResourceMap)) {
+        server.resource(`ace-task-${key}`, `ace://tasks/${key}`, { description: meta.desc, mimeType: "text/markdown" }, () => ({
+            contents: [
+                {
+                    uri: `ace://tasks/${key}`,
+                    text: readTaskArtifact(key),
+                    mimeType: "text/markdown",
+                },
+            ],
+        }));
+    }
+    // ── 3. Handoff templates & examples ─────────────────────────────────
+    const handoffResources = {
+        handoff_template: {
+            desc: "Canonical SWARM_HANDOFF.json shape",
+        },
+        handoff_example: {
+            desc: "Filled handoff payload example",
+        },
+        handoff_example_vos_ui: {
+            desc: "VOS to UI concrete handoff example",
+        },
+        handoff_example_ui_coders: {
+            desc: "UI to Coders concrete handoff example",
+        },
+    };
+    for (const [key, meta] of Object.entries(handoffResources)) {
+        server.resource(`ace-${key}`, `ace://handoffs/${key}`, { description: meta.desc, mimeType: "application/json" }, () => ({
+            contents: [
+                {
+                    uri: `ace://handoffs/${key}`,
+                    text: readTaskArtifact(key),
+                    mimeType: "application/json",
+                },
+            ],
+        }));
+    }
+    // ── 4. Skills index + dynamic skill template ────────────────────────
+    server.resource("ace-skills-index", "ace://skills", {
+        description: "List all discoverable ACE skills",
+        mimeType: "text/markdown",
+    }, () => {
+        const skills = listAvailableSkills();
+        const lines = [
+            "# ACE Skills",
+            "",
+            ...skills.map((skill) => `- ${skill.name} (${skill.source}) -> ace://skills/${skill.name}/instructions`),
+        ];
+        return {
+            contents: [
+                {
+                    uri: "ace://skills",
+                    text: lines.join("\n"),
+                    mimeType: "text/markdown",
+                },
+            ],
+        };
+    });
+    server.resource("ace-skill-instructions", new ResourceTemplate("ace://skills/{name}/instructions", { list: undefined }), {
+        description: "Read a skill's SKILL.md by skill name",
+        mimeType: "text/markdown",
+    }, (uri, params) => {
+        const name = params.name || "";
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    text: readSkillInstructions(name),
+                    mimeType: "text/markdown",
+                },
+            ],
+        };
+    });
+    // ── 5. Dynamic workspace file resource ──────────────────────────────
+    server.resource("ace-workspace-file", new ResourceTemplate("ace://workspace/{path+}", { list: undefined }), { description: "Read any file from the ACE workspace by relative path" }, (uri, params) => {
+        const relPath = params["path+"] ||
+            params.path ||
+            "";
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    text: safeRead(relPath),
+                    mimeType: "text/plain",
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const ACE_MCP_SERVER_NAME = "ace-swarm";
+export declare const ACE_MCP_SERVER_VERSION = "1.1.0";
+export declare function createAceServer(): McpServer;
+export declare function startStdioServer(logStartup?: boolean): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAC/C,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAE9C,wBAAgB,eAAe,IAAI,SAAS,CAW3C;AAED,wBAAsB,gBAAgB,CAAC,UAAU,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvE"}

package/dist/server.js

@@ -0,0 +1,26 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerPrompts } from "./prompts.js";
+import { registerResources } from "./resources.js";
+import { registerTools } from "./tools.js";
+export const ACE_MCP_SERVER_NAME = "ace-swarm";
+export const ACE_MCP_SERVER_VERSION = "1.1.0";
+export function createAceServer() {
+    const server = new McpServer({
+        name: ACE_MCP_SERVER_NAME,
+        version: ACE_MCP_SERVER_VERSION,
+    });
+    registerResources(server);
+    registerPrompts(server);
+    registerTools(server);
+    return server;
+}
+export async function startStdioServer(logStartup = true) {
+    const server = createAceServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    if (logStartup) {
+        console.error(`ACE MCP Server (${ACE_MCP_SERVER_NAME}) running on stdio`);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,sBAAsB;KAChC,CAAC,CAAC;IAEH,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAU,GAAG,IAAI;IACtD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mBAAmB,mBAAmB,oBAAoB,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP Tools – actionable orchestration tools for the ACE framework.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTools(server: McpServer): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8BpE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAowBrD"}