@soldy_ai/mcp 0.1.6

package/dist/subscriptions.js

@@ -0,0 +1,275 @@
+/** Events that indicate project status changed. */
+const STATUS_EVENTS = new Set([
+    "RunStarted",
+    "RunCompleted",
+    "RunError",
+    "RunPaused",
+    "RunCancelled",
+    "RunContinued",
+    "TeamRunStarted",
+    "TeamRunCompleted",
+    "TeamRunError",
+    "TeamRunCancelled",
+    "AgentSystemError",
+]);
+/** Events that carry new message content. */
+const MESSAGE_EVENTS = new Set([
+    "RunContent",
+    "RunContentCompleted",
+    "RunIntermediateContent",
+    "ToolCallStarted",
+    "ToolCallCompleted",
+    "TeamRunContent",
+    "TeamRunContentCompleted",
+    "TeamRunIntermediateContent",
+    "TeamToolCallStarted",
+    "TeamToolCallCompleted",
+    "ReasoningStarted",
+    "ReasoningStep",
+    "ReasoningCompleted",
+    "TeamReasoningStarted",
+    "TeamReasoningStep",
+    "TeamReasoningCompleted",
+    // Status events also produce messages
+    ...STATUS_EVENTS,
+]);
+/**
+ * Bridges WebSocket project subscriptions to MCP resource update notifications.
+ *
+ * When an MCP client subscribes to a resource URI (e.g. `soldy://project/{id}/status`),
+ * this bridge connects to the API WebSocket, subscribes to the project, and forwards
+ * relevant events as `sendResourceUpdated` notifications.
+ */
+export class SubscriptionBridge {
+    client;
+    apiKey;
+    ws = null;
+    subscribedProjects = new Set();
+    connecting = false;
+    reconnectTimer = null;
+    reconnectDelay = 1000;
+    maxReconnectDelay = 30000;
+    server = null;
+    /** Brand task polling: taskId → { interval, lastStatus } */
+    brandTaskPolls = new Map();
+    static BRAND_TASK_POLL_MS = 3000;
+    constructor(client, _apiUrl, apiKey) {
+        this.client = client;
+        this.apiKey = apiKey;
+    }
+    /** Attach the low-level MCP Server instance for sending notifications. */
+    setServer(server) {
+        this.server = server;
+    }
+    /** Subscribe to a project's WebSocket events. Call when MCP client subscribes to a resource. */
+    async subscribeProject(projectId) {
+        if (this.subscribedProjects.has(projectId))
+            return;
+        this.subscribedProjects.add(projectId);
+        await this.ensureConnected();
+        this.sendProjectSubscribe(projectId);
+    }
+    /** Unsubscribe from a project. Call when no more MCP subscriptions reference it. */
+    unsubscribeProject(projectId) {
+        this.subscribedProjects.delete(projectId);
+        // WebSocket protocol doesn't support unsubscribe, but we stop sending notifications
+    }
+    /** Subscribe to brand task status changes via polling. */
+    subscribeBrandTask(taskId) {
+        if (this.brandTaskPolls.has(taskId))
+            return;
+        const poll = {
+            lastStatus: "",
+            interval: setInterval(async () => {
+                if (!this.server)
+                    return;
+                try {
+                    const task = await this.client.getBrandTaskResult(taskId);
+                    if (!task)
+                        return;
+                    const entry = this.brandTaskPolls.get(taskId);
+                    if (!entry)
+                        return;
+                    if (task.status !== entry.lastStatus) {
+                        entry.lastStatus = task.status;
+                        this.server.sendResourceUpdated({
+                            uri: `soldy://brand/task/${taskId}`,
+                        });
+                        // Also notify brand list when a new brand is extracted
+                        if (task.status === "finished") {
+                            this.server.sendResourceUpdated({ uri: "soldy://brands" });
+                            if (task.brand_id) {
+                                this.server.sendResourceUpdated({
+                                    uri: `soldy://brand/${task.brand_id}`,
+                                });
+                            }
+                            // Task completed — stop polling
+                            this.unsubscribeBrandTask(taskId);
+                        }
+                        else if (task.status === "failed") {
+                            // Task failed — stop polling
+                            this.unsubscribeBrandTask(taskId);
+                        }
+                    }
+                }
+                catch (err) {
+                    console.error(`[SubscriptionBridge] Brand task poll error (${taskId}):`, err);
+                }
+            }, SubscriptionBridge.BRAND_TASK_POLL_MS),
+        };
+        this.brandTaskPolls.set(taskId, poll);
+    }
+    /** Stop polling a brand task. */
+    unsubscribeBrandTask(taskId) {
+        const entry = this.brandTaskPolls.get(taskId);
+        if (entry) {
+            clearInterval(entry.interval);
+            this.brandTaskPolls.delete(taskId);
+        }
+    }
+    /** Disconnect the WebSocket and stop all polling. */
+    disconnect() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.connecting = false;
+        // Stop all brand task polls
+        for (const [taskId, entry] of this.brandTaskPolls) {
+            clearInterval(entry.interval);
+            this.brandTaskPolls.delete(taskId);
+        }
+    }
+    async ensureConnected() {
+        if (this.ws?.readyState === WebSocket.OPEN)
+            return;
+        if (this.connecting) {
+            // Wait for ongoing connection
+            await new Promise((resolve) => {
+                const check = () => {
+                    if (this.ws?.readyState === WebSocket.OPEN)
+                        resolve();
+                    else
+                        setTimeout(check, 100);
+                };
+                check();
+            });
+            return;
+        }
+        await this.connect();
+    }
+    async connect() {
+        this.connecting = true;
+        const wsUrl = this.client.getWebSocketUrl(this.apiKey);
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(wsUrl);
+            ws.onopen = () => {
+                this.ws = ws;
+                this.connecting = false;
+                this.reconnectDelay = 1000;
+                console.error("[SubscriptionBridge] WebSocket connected");
+                // Re-subscribe all projects
+                for (const projectId of this.subscribedProjects) {
+                    this.sendProjectSubscribe(projectId);
+                }
+                resolve();
+            };
+            ws.onmessage = (event) => {
+                this.handleMessage(String(event.data));
+            };
+            ws.onclose = () => {
+                console.error("[SubscriptionBridge] WebSocket closed");
+                this.ws = null;
+                this.connecting = false;
+                this.scheduleReconnect();
+            };
+            ws.onerror = (err) => {
+                console.error("[SubscriptionBridge] WebSocket error:", err);
+                this.connecting = false;
+                if (!this.ws)
+                    reject(new Error("WebSocket connection failed"));
+            };
+        });
+    }
+    scheduleReconnect() {
+        if (this.subscribedProjects.size === 0)
+            return;
+        if (this.reconnectTimer)
+            return;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect().catch((err) => {
+                console.error("[SubscriptionBridge] Reconnect failed:", err);
+                this.reconnectDelay = Math.min(this.reconnectDelay * 2, this.maxReconnectDelay);
+                this.scheduleReconnect();
+            });
+        }, this.reconnectDelay);
+    }
+    sendProjectSubscribe(projectId) {
+        if (this.ws?.readyState !== WebSocket.OPEN)
+            return;
+        this.ws.send(JSON.stringify({
+            event: "ClientProjectSubscribe",
+            project_id: projectId,
+        }));
+    }
+    handleMessage(data) {
+        if (!this.server)
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        const projectId = msg.context?.project_id;
+        if (!projectId || !this.subscribedProjects.has(projectId))
+            return;
+        const event = msg.event;
+        const runId = msg.context?.run_id;
+        // Status change notifications
+        if (STATUS_EVENTS.has(event)) {
+            this.server.sendResourceUpdated({
+                uri: `soldy://project/${projectId}/status`,
+            });
+        }
+        // Message notifications
+        if (MESSAGE_EVENTS.has(event)) {
+            this.server.sendResourceUpdated({
+                uri: `soldy://project/${projectId}/messages`,
+            });
+            if (runId) {
+                this.server.sendResourceUpdated({
+                    uri: `soldy://project/${projectId}/runs/${runId}/messages`,
+                });
+            }
+        }
+        // Material notifications
+        if (msg.message?.materials?.length) {
+            this.server.sendResourceUpdated({
+                uri: `soldy://project/${projectId}/materials`,
+            });
+            if (runId) {
+                this.server.sendResourceUpdated({
+                    uri: `soldy://project/${projectId}/runs/${runId}/materials`,
+                });
+            }
+        }
+    }
+}
+/** Extract project_id from a soldy://project/... resource URI. */
+export function extractProjectId(uri) {
+    const match = uri.match(/^soldy:\/\/project\/([^/]+)/);
+    return match?.[1] ?? null;
+}
+/** Extract task_id from a soldy://brand/task/... resource URI. */
+export function extractBrandTaskId(uri) {
+    const match = uri.match(/^soldy:\/\/brand\/task\/([^/]+)/);
+    return match?.[1] ?? null;
+}
+//# sourceMappingURL=subscriptions.js.map

package/dist/subscriptions.js.map

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

package/dist/tools/brand.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SoldyAPIClient } from "../client.js";
+export declare function registerBrandTools(server: McpServer, client: SoldyAPIClient): void;

package/dist/tools/brand.js

@@ -0,0 +1,141 @@
+import { z } from "zod";
+import { formatApiError } from "../errors.js";
+export function registerBrandTools(server, client) {
+    server.tool("create_brand", "Create a brand. Use before create_project if user has brand identity to associate.", {
+        name: z.string(),
+        description: z.string().optional(),
+        stage: z.string().optional(),
+    }, async ({ name, description, stage }) => {
+        const wsId = await client.getDefaultWorkspaceId();
+        const resp = await client.post("/public/brand", {
+            name,
+            slug: name
+                .toLowerCase()
+                .replace(/\s+/g, "-")
+                .replace(/[^a-z0-9-]/g, ""),
+            description: description ?? "",
+            stage: stage ?? "",
+            workspace_id: wsId,
+        });
+        if (resp.code !== 0 || !resp.data)
+            return {
+                content: [{ type: "text", text: formatApiError(resp) }],
+                isError: true,
+            };
+        const b = resp.data;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Brand created: **${b.name}** (ID: \`${b.id}\`)\nView: https://soldy.ai/app/brands/${b.id}`,
+                },
+            ],
+        };
+    });
+    server.tool("list_brands", "List all brands. Check here first if user mentions a brand or company.", {}, async () => {
+        const wsId = await client.getDefaultWorkspaceId();
+        const resp = await client.get("/public/brand/list", {
+            workspace_id: wsId,
+        });
+        if (resp.code !== 0)
+            return {
+                content: [{ type: "text", text: formatApiError(resp) }],
+                isError: true,
+            };
+        const brands = resp.data ?? [];
+        if (brands.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No brands yet. Use create_brand or extract_brand to add one.",
+                    },
+                ],
+            };
+        }
+        const lines = ["| Name | ID | Stage |", "|---|---|---|"];
+        for (const b of brands) {
+            lines.push(`| ${b.name} | \`${b.id}\` | ${b.stage} |`);
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    });
+    server.tool("extract_brand", `Extract brand identity from a product URL or website URL. This is IMPORTANT — when the user provides a product page URL, call this BEFORE create_project to give the agent brand context (colors, tone, positioning).
+
+Returns a task_id. Use watch_brand_task(task_id) to subscribe for completion notifications (preferred), or poll get_brand_task_result. Usually takes 30-60s. Once finished, use the returned brand_id in send_message options.`, {
+        content: z
+            .string()
+            .describe("Product page URL, brand website URL, or text describing the brand"),
+        brand_id: z.string().optional(),
+    }, async ({ content, brand_id }) => {
+        const wsId = await client.getDefaultWorkspaceId();
+        const resp = await client.post("/public/brand/task", {
+            content,
+            brand_id: brand_id ?? "",
+            workspace_id: wsId,
+        });
+        if (resp.code !== 0 || !resp.data)
+            return {
+                content: [{ type: "text", text: formatApiError(resp) }],
+                isError: true,
+            };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Brand extraction started (task: \`${resp.data.id}\`). Use watch_brand_task to subscribe for completion, or poll with get_brand_task_result. Usually takes 30-60s.`,
+                },
+            ],
+        };
+    });
+    server.tool("get_brand_task_result", "Check brand extraction progress and result. For real-time updates, prefer watch_brand_task(task_id) instead of polling this tool. You can also read the resource URI soldy://brand/task/{task_id}.", { task_id: z.string() }, async ({ task_id }) => {
+        const wsId = await client.getDefaultWorkspaceId();
+        const resp = await client.post("/public/brand/task/result", {
+            task_ids: [task_id],
+            workspace_id: wsId,
+        });
+        if (resp.code !== 0 || !resp.data || resp.data.length === 0) {
+            return {
+                content: [{ type: "text", text: "Task not found." }],
+                isError: true,
+            };
+        }
+        const task = resp.data[0];
+        switch (task.status) {
+            case "running":
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Running (${Math.round(task.progress)}%). Check again shortly.`,
+                        },
+                    ],
+                };
+            case "finished":
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Brand extracted: ID \`${task.brand_id}\`\nView: https://soldy.ai/app/brands/${task.brand_id}`,
+                        },
+                    ],
+                };
+            case "failed":
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Extraction failed: ${task.reason || "unknown"}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            default:
+                return {
+                    content: [
+                        { type: "text", text: `Status: ${task.status}` },
+                    ],
+                };
+        }
+    });
+}
+//# sourceMappingURL=brand.js.map

package/dist/tools/brand.js.map

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

package/dist/tools/material.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMaterialTools(server: McpServer, apiUrl: string): void;

package/dist/tools/material.js

@@ -0,0 +1,23 @@
+export function registerMaterialTools(server, apiUrl) {
+    server.tool("upload_material", "Returns HTTP upload endpoint for local file upload. Note: send_message handles local files automatically — you usually don't need this.", {}, async () => {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `## File Upload
+
+send_message automatically handles local file paths — just pass them as material_urls.
+
+For manual upload, POST multipart/form-data to:
+${apiUrl}/api/v1/public/material
+
+Header: X-API-Key: <your-key>
+Field: file (required)
+
+The response contains a URL to use in send_message's material_urls.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=material.js.map

package/dist/tools/material.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material.js","sourceRoot":"","sources":["../../src/tools/material.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAc;IACrE,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,yIAAyI,EACzI,EAAE,EACF,KAAK,IAAI,EAAE;QACT,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;;;;;EAKhB,MAAM;;;;;oEAK4D;iBACzD;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/message.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SoldyAPIClient } from "../client.js";
+export declare function registerMessageTools(server: McpServer, client: SoldyAPIClient): void;