@zerobuild/mcp 2.6.1

package/README.md

@@ -0,0 +1,114 @@
+# @zerobuild/mcp
+
+MCP (Model Context Protocol) server for Zerobuild. Connect Claude, Cursor, Windsurf, or any MCP-compatible AI agent to your Zerobuild workspace.
+
+## Quick Start
+
+### 1. Create an API Key
+
+In your Zerobuild workspace, go to **Settings > API Keys** and create a key with `read,write` scopes.
+
+### 2. Configure your MCP client
+
+**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "zerobuild": {
+      "command": "npx",
+      "args": ["-y", "@zerobuild/mcp"],
+      "env": {
+        "ZEROBUILD_API_KEY": "zb_live_...",
+        "ZEROBUILD_URL": "https://app.zerobuild.ai"
+      }
+    }
+  }
+}
+```
+
+**Claude Code:**
+
+```bash
+claude mcp add zerobuild -- npx -y @zerobuild/mcp
+# Then set env vars: ZEROBUILD_API_KEY, ZEROBUILD_URL
+```
+
+**Cursor / Windsurf:** Same config format as Claude Desktop in their respective MCP settings.
+
+### 3. HTTP mode (self-hosted)
+
+Run as a hosted HTTP endpoint instead of stdio:
+
+```bash
+ZEROBUILD_API_KEY=zb_live_... \
+ZEROBUILD_URL=https://app.zerobuild.ai \
+npx -y @zerobuild/mcp --http
+```
+
+Server starts at `http://localhost:3002/mcp` (configurable via `MCP_PORT`). Any MCP client that supports the Streamable HTTP transport can connect to this URL.
+
+## What's Available
+
+### Resources (read context)
+
+| Resource | Description |
+|---|---|
+| `zerobuild://conversations` | Open live chat conversations |
+| `zerobuild://conversations/{id}` | Conversation detail with messages |
+| `zerobuild://contacts` | All contacts |
+| `zerobuild://contacts/{id}` | Contact detail |
+| `zerobuild://channels` | Team chat channels |
+| `zerobuild://channels/{id}/messages` | Recent channel messages |
+| `zerobuild://documents` | Document tree |
+| `zerobuild://documents/{id}` | Document content |
+| `zerobuild://search/{query}` | Unified search |
+
+### Tools (actions)
+
+| Tool | Description |
+|---|---|
+| `list_channels` | List channels with IDs |
+| `list_conversations` | List conversations with IDs |
+| `send_message` | Send message to a channel |
+| `reply_to_conversation` | Reply to a customer |
+| `add_internal_note` | Add internal note (team only) |
+| `close_conversation` | Close a conversation |
+| `assign_conversation` | Assign to an agent |
+| `transfer_conversation` | Transfer with handoff note |
+| `tag_conversation` | Add/remove tags |
+| `create_document` | Create doc or folder |
+| `update_document` | Update doc content |
+| `search` | Full-text search |
+
+### Prompts (workflows)
+
+| Prompt | Description |
+|---|---|
+| `summarize-conversation` | Summarize with customer context |
+| `draft-reply` | Draft reply using conversation history |
+| `find-related` | Find related conversations/docs |
+| `conversation-handoff` | Generate transfer summary |
+| `daily-digest` | Daily conversation activity digest |
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `ZEROBUILD_API_KEY` | Yes | — | API key (`zb_live_*`) |
+| `ZEROBUILD_URL` | No | `http://localhost:3001` | Zerobuild API base URL |
+| `MCP_PORT` | No | `3002` | HTTP server port (--http mode only) |
+
+## Examples
+
+**Ask Claude to summarize today's conversations:**
+> "Summarize all open live chat conversations in my Zerobuild workspace"
+
+**Create a doc from a conversation:**
+> "Take the key points from conversation #42 and create a document called 'Meeting Follow-up'"
+
+**Reply to a customer:**
+> "Draft a reply to the latest message in conversation #15, suggesting they check our docs"
+
+**Search across everything:**
+> "Search my workspace for anything related to 'shipping delay'"

package/dist/client.d.ts

@@ -0,0 +1,79 @@
+/**
+ * HTTP client for the Zerobuild REST API.
+ * Handles auth, envelope unwrapping, and pagination.
+ */
+export declare class ZerobuildApiError extends Error {
+    status: number;
+    code: string;
+    constructor(status: number, code: string, message: string);
+}
+export declare class ZerobuildClient {
+    private apiKey;
+    readonly baseUrl: string;
+    constructor(baseUrl: string, apiKey: string);
+    private request;
+    private buildQuery;
+    listConversations(params?: {
+        status?: string;
+        view?: string;
+        tagId?: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<{
+        conversations: any[];
+        hasMore: boolean;
+    }>;
+    getConversation(id: string): Promise<any>;
+    getConversationMessages(id: string, params?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<any[]>;
+    replyToConversation(id: string, body: {
+        content: string;
+        isInternalNote?: boolean;
+    }): Promise<any>;
+    closeConversation(id: string): Promise<void>;
+    assignConversation(id: string, userId: string | null): Promise<void>;
+    transferConversation(id: string, body: {
+        targetUserId: string;
+        note?: string;
+    }): Promise<void>;
+    listContacts(params?: {
+        search?: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<any[]>;
+    getContact(id: string): Promise<any>;
+    listChannels(): Promise<any[]>;
+    getChannelMessages(channelId: string, params?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<any[]>;
+    sendChannelMessage(channelId: string, body: {
+        content: string;
+    }): Promise<any>;
+    listDocuments(params?: {
+        parentId?: string;
+    }): Promise<any[]>;
+    getDocument(id: string): Promise<any>;
+    createDocument(body: {
+        title: string;
+        content?: unknown;
+        parentId?: string | null;
+        isFolder?: boolean;
+    }): Promise<any>;
+    updateDocument(id: string, body: {
+        title?: string;
+        content?: unknown;
+    }): Promise<any>;
+    listTags(): Promise<any[]>;
+    addTagToConversation(conversationId: string, tagId: string): Promise<void>;
+    removeTagFromConversation(conversationId: string, tagId: string): Promise<void>;
+    listCannedResponses(): Promise<any[]>;
+    search(params: {
+        q: string;
+        type?: string;
+        limit?: number;
+    }): Promise<any>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,137 @@
+/**
+ * HTTP client for the Zerobuild REST API.
+ * Handles auth, envelope unwrapping, and pagination.
+ */
+export class ZerobuildApiError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "ZerobuildApiError";
+    }
+}
+export class ZerobuildClient {
+    apiKey;
+    baseUrl;
+    constructor(baseUrl, apiKey) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}/api${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+        };
+        const res = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            let code = "UNKNOWN";
+            let message = `API error: ${res.status} ${res.statusText}`;
+            try {
+                const err = (await res.json());
+                if (err.error) {
+                    code = err.error.code;
+                    message = err.error.message;
+                }
+            }
+            catch {
+                // use default message
+            }
+            throw new ZerobuildApiError(res.status, code, message);
+        }
+        const json = (await res.json());
+        if (json.error) {
+            throw new ZerobuildApiError(400, json.error.code, json.error.message);
+        }
+        return json.data;
+    }
+    buildQuery(params) {
+        const entries = Object.entries(params).filter(([, v]) => v !== undefined && v !== null);
+        if (entries.length === 0)
+            return "";
+        return "?" + entries.map(([k, v]) => `${k}=${encodeURIComponent(String(v))}`).join("&");
+    }
+    // --- Conversations ---
+    async listConversations(params) {
+        const query = this.buildQuery(params ?? {});
+        return this.request("GET", `/conversations${query}`);
+    }
+    async getConversation(id) {
+        return this.request("GET", `/conversations/${id}`);
+    }
+    async getConversationMessages(id, params) {
+        const query = this.buildQuery(params ?? {});
+        return this.request("GET", `/conversations/${id}/messages${query}`);
+    }
+    async replyToConversation(id, body) {
+        return this.request("POST", `/conversations/${id}/messages`, body);
+    }
+    async closeConversation(id) {
+        await this.request("PATCH", `/conversations/${id}/close`);
+    }
+    async assignConversation(id, userId) {
+        await this.request("PATCH", `/conversations/${id}/assign`, { userId });
+    }
+    async transferConversation(id, body) {
+        await this.request("POST", `/conversations/${id}/transfer`, body);
+    }
+    // --- Contacts ---
+    async listContacts(params) {
+        const query = this.buildQuery(params ?? {});
+        return this.request("GET", `/contacts${query}`);
+    }
+    async getContact(id) {
+        return this.request("GET", `/contacts/${id}`);
+    }
+    // --- Channels ---
+    async listChannels() {
+        return this.request("GET", "/channels");
+    }
+    async getChannelMessages(channelId, params) {
+        const query = this.buildQuery(params ?? {});
+        return this.request("GET", `/channels/${channelId}/messages${query}`);
+    }
+    async sendChannelMessage(channelId, body) {
+        return this.request("POST", `/channels/${channelId}/messages`, body);
+    }
+    // --- Documents ---
+    async listDocuments(params) {
+        const query = this.buildQuery(params ?? {});
+        return this.request("GET", `/documents${query}`);
+    }
+    async getDocument(id) {
+        return this.request("GET", `/documents/${id}`);
+    }
+    async createDocument(body) {
+        return this.request("POST", "/documents", body);
+    }
+    async updateDocument(id, body) {
+        return this.request("PATCH", `/documents/${id}`, body);
+    }
+    // --- Tags ---
+    async listTags() {
+        return this.request("GET", "/conversation-tags");
+    }
+    async addTagToConversation(conversationId, tagId) {
+        await this.request("POST", `/conversations/${conversationId}/tags/${tagId}`);
+    }
+    async removeTagFromConversation(conversationId, tagId) {
+        await this.request("DELETE", `/conversations/${conversationId}/tags/${tagId}`);
+    }
+    // --- Canned Responses ---
+    async listCannedResponses() {
+        return this.request("GET", "/canned");
+    }
+    // --- Search ---
+    async search(params) {
+        const query = this.buildQuery(params);
+        return this.request("GET", `/search${query}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createServer } from "node:http";
+import { randomUUID } from "node:crypto";
+import { ZerobuildClient } from "./client.js";
+import { registerConversationResources } from "./resources/conversations.js";
+import { registerContactResources } from "./resources/contacts.js";
+import { registerChannelResources } from "./resources/channels.js";
+import { registerDocumentResources } from "./resources/documents.js";
+import { registerSearchResource } from "./resources/search.js";
+import { registerConversationTools } from "./tools/conversations.js";
+import { registerMessageTools } from "./tools/messages.js";
+import { registerDocumentTools } from "./tools/documents.js";
+import { registerSearchTool } from "./tools/search.js";
+import { registerPrompts } from "./prompts/index.js";
+const HELP = `
+Zerobuild MCP Server
+
+Exposes your Zerobuild workspace to AI agents via the Model Context Protocol.
+
+Modes:
+  stdio (default)  — for Claude Desktop, Cursor, etc.
+  --http           — hosted HTTP endpoint for remote clients
+
+Environment variables:
+  ZEROBUILD_API_KEY  (required)  API key for authentication (zb_live_*)
+  ZEROBUILD_URL      (optional)  API base URL (default: http://localhost:3001)
+  MCP_PORT           (optional)  HTTP server port when using --http (default: 3002)
+
+Usage with Claude Desktop (stdio):
+  {
+    "mcpServers": {
+      "zerobuild": {
+        "command": "npx",
+        "args": ["@zerobuild/mcp"],
+        "env": {
+          "ZEROBUILD_API_KEY": "zb_live_...",
+          "ZEROBUILD_URL": "https://your-instance.zerobuild.ai"
+        }
+      }
+    }
+  }
+
+Usage as hosted endpoint (HTTP):
+  ZEROBUILD_API_KEY=zb_live_... zerobuild-mcp --http
+
+  Then configure clients to connect to: http://localhost:3002/mcp
+`.trim();
+function createMcpServer(client) {
+    const server = new McpServer({
+        name: "zerobuild",
+        version: "2.6.1",
+    });
+    // Register resources
+    registerConversationResources(server, client);
+    registerContactResources(server, client);
+    registerChannelResources(server, client);
+    registerDocumentResources(server, client);
+    registerSearchResource(server, client);
+    // Register tools
+    registerConversationTools(server, client);
+    registerMessageTools(server, client);
+    registerDocumentTools(server, client);
+    registerSearchTool(server, client);
+    // Register prompts
+    registerPrompts(server, client);
+    return server;
+}
+async function startStdio(client) {
+    const server = createMcpServer(client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`Zerobuild MCP server running via stdio (API: ${client.baseUrl})`);
+}
+async function startHttp(client) {
+    const port = parseInt(process.env.MCP_PORT || "3002", 10);
+    // Map of session ID -> transport for stateful sessions
+    const sessions = new Map();
+    const httpServer = createServer(async (req, res) => {
+        const url = new URL(req.url || "/", `http://localhost:${port}`);
+        // CORS headers
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, mcp-session-id");
+        res.setHeader("Access-Control-Expose-Headers", "mcp-session-id");
+        if (req.method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        if (url.pathname !== "/mcp") {
+            res.writeHead(404, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Not found. MCP endpoint is at /mcp" }));
+            return;
+        }
+        // Get or create session
+        const sessionId = req.headers["mcp-session-id"];
+        if (req.method === "POST" && !sessionId) {
+            // New session — initialize
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+            });
+            const server = createMcpServer(client);
+            await server.connect(transport);
+            // Store session after initialization sets the ID
+            transport.onclose = () => {
+                if (transport.sessionId) {
+                    sessions.delete(transport.sessionId);
+                }
+            };
+            await transport.handleRequest(req, res);
+            // Session ID is set after handling the initialize request
+            if (transport.sessionId) {
+                sessions.set(transport.sessionId, transport);
+            }
+            return;
+        }
+        if (sessionId) {
+            const transport = sessions.get(sessionId);
+            if (!transport) {
+                res.writeHead(404, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Session not found" }));
+                return;
+            }
+            await transport.handleRequest(req, res);
+            return;
+        }
+        // GET without session (for SSE stream) or other methods
+        if (req.method === "GET") {
+            res.writeHead(400, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Missing mcp-session-id header" }));
+            return;
+        }
+        res.writeHead(400, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "Missing mcp-session-id header for existing session" }));
+    });
+    httpServer.listen(port, () => {
+        console.log(`Zerobuild MCP server running at http://localhost:${port}/mcp`);
+        console.log(`API: ${client.baseUrl}`);
+    });
+}
+async function main() {
+    // Handle --help
+    if (process.argv.includes("--help") || process.argv.includes("-h")) {
+        console.log(HELP);
+        process.exit(0);
+    }
+    // Read config from env
+    const apiKey = process.env.ZEROBUILD_API_KEY;
+    const baseUrl = process.env.ZEROBUILD_URL || "http://localhost:3001";
+    if (!apiKey) {
+        console.error("Error: ZEROBUILD_API_KEY environment variable is required.\n");
+        console.error(HELP);
+        process.exit(1);
+    }
+    const client = new ZerobuildClient(baseUrl, apiKey);
+    const httpMode = process.argv.includes("--http");
+    if (httpMode) {
+        await startHttp(client);
+    }
+    else {
+        await startStdio(client);
+    }
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCZ,CAAC,IAAI,EAAE,CAAC;AAET,SAAS,eAAe,CAAC,MAAuB;IAC9C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,qBAAqB;IACrB,6BAA6B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC,iBAAiB;IACjB,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC,mBAAmB;IACnB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,MAAuB;IAC/C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,gDAAgD,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;AACnF,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,MAAuB;IAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAE1D,uDAAuD;IACvD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyC,CAAC;IAElE,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACjD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,oBAAoB,IAAI,EAAE,CAAC,CAAC;QAEhE,eAAe;QACf,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;QAClD,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,4BAA4B,CAAC,CAAC;QAC5E,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,8BAA8B,CAAC,CAAC;QAC9E,GAAG,CAAC,SAAS,CAAC,+BAA+B,EAAE,gBAAgB,CAAC,CAAC;QAEjE,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7B,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACnB,GAAG,CAAC,GAAG,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC5B,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QAED,wBAAwB;QACxB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAuB,CAAC;QAEtE,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACxC,2BAA2B;YAC3B,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;gBAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;aACvC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YACvC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAEhC,iDAAiD;YACjD,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;gBACvB,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;oBACxB,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAExC,0DAA0D;YAC1D,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;gBACxB,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC;gBACxD,OAAO;YACT,CAAC;YACD,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QAED,wDAAwD;QACxD,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACzB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,oDAAoD,EAAE,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QAC3B,OAAO,CAAC,GAAG,CAAC,oDAAoD,IAAI,MAAM,CAAC,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,gBAAgB;IAChB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,uBAAuB;IACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,uBAAuB,CAAC;IAErE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,8DAA8D,CAC/D,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEjD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ZerobuildClient } from "../client.js";
+export declare function registerPrompts(server: McpServer, client: ZerobuildClient): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,QA8MxB"}