conduyt-mcp 4.3.2 → 4.3.3

package/dist/index.js

@@ -45,7 +45,7 @@ if (!apiKey.startsWith("cdy_")) {
 const client = new ConduytClient({ apiUrl, apiKey });
 const server = new McpServer({
     name: "conduyt",
-    version: "4.3.2",
+    version: "4.3.3",
 });
 registerDiscoveryTools(server, client);
 registerContactTools(server, client);

package/dist/tools/deals.js

@@ -1,20 +1,57 @@
 import { z } from "zod";
 import { formatResult } from "../client.js";
 export function registerDealTools(server, client) {
-    server.tool("conduyt_list_deals", "List deals with filtering by pipeline, stage, assignee, or status. Returns deal title, value, stage, contact, and dates.", {
-        pipelineId: z.string().optional().describe("Filter by pipeline UUID"),
-        stageId: z.string().optional().describe("Filter by stage UUID"),
+    server.tool("conduyt_list_deals", "List deals with filtering by pipeline, stage, assignee, or status. Returns deal title, value, stage, contact, and dates. Filter by pipeline/stage NAME (the same names you import with) or by UUID — both camelCase (pipelineName) and snake_case (pipeline_name) argument names are accepted. An unknown name returns a clear error, never the whole account.", {
+        pipeline: z.string().optional().describe("Filter by pipeline UUID (canonical). Aliases: pipelineId, pipeline_id."),
+        pipelineId: z.string().optional().describe("Filter by pipeline UUID (alias of pipeline)."),
+        pipeline_id: z.string().optional().describe("snake_case alias of pipelineId."),
+        pipelineName: z.string().optional().describe("Filter by pipeline NAME (the same name used in conduyt_import_deals/create) — resolved to its UUID; errors if not found. Alias: pipeline_name."),
+        pipeline_name: z.string().optional().describe("snake_case alias of pipelineName."),
+        stage: z.string().optional().describe("Filter by stage UUID (canonical). Aliases: stageId, stage_id."),
+        stageId: z.string().optional().describe("Filter by stage UUID (alias of stage)."),
+        stage_id: z.string().optional().describe("snake_case alias of stageId."),
+        stageName: z.string().optional().describe("Filter by stage NAME within the pipeline — resolved to its UUID; errors if not found. Alias: stage_name."),
+        stage_name: z.string().optional().describe("snake_case alias of stageName."),
         assignedTo: z.string().optional().describe("Filter by assigned user UUID"),
         status: z.enum(["open", "won", "lost"]).optional().describe("Filter by deal status"),
         search: z.string().optional().describe("Search deal titles"),
         page: z.number().optional().describe("Page number (default 1)"),
         per_page: z.number().optional().describe("Results per page (default 25, max 100)"),
-    }, async ({ pipelineId, stageId, assignedTo, status, search, page, per_page }) => {
+    }, async (a) => {
         const params = new URLSearchParams();
-        if (pipelineId)
-            params.set("pipeline", pipelineId);
-        if (stageId)
-            params.set("stage", stageId);
+        // Accept every reasonable casing of each filter (canonical bare name +
+        // camelCase + snake_case) so an agent's provided filter is NEVER silently
+        // stripped by the schema. Coalesce each alias GROUP to a single value
+        // locally — conflicting non-blank values in a group are a contradictory
+        // request and raise a clear tool error (don't emit ambiguous duplicate
+        // query params and hope the parser picks the right one) — then send ONE
+        // canonical wire param (pipeline / stage / pipeline_name / stage_name, the
+        // params the live contract advertises). A blank value is forwarded so the
+        // server rejects it; an id/name cross-conflict is caught by the server.
+        const coalesce = (label, ...vals) => {
+            const present = vals.filter((v) => v !== undefined);
+            if (present.length === 0)
+                return undefined;
+            const distinct = [...new Set(present.map((v) => v.trim().toLowerCase()).filter((v) => v !== ""))];
+            if (distinct.length > 1) {
+                throw new Error(`Conflicting ${label} values — pass only one.`);
+            }
+            // prefer a non-blank original; else keep a blank so the server can reject it
+            return present.find((v) => v.trim() !== "") ?? present[0];
+        };
+        const { assignedTo, status, search, page, per_page } = a;
+        const pipelineV = coalesce("pipeline id", a.pipeline, a.pipelineId, a.pipeline_id);
+        const pipelineNameV = coalesce("pipeline name", a.pipelineName, a.pipeline_name);
+        const stageV = coalesce("stage id", a.stage, a.stageId, a.stage_id);
+        const stageNameV = coalesce("stage name", a.stageName, a.stage_name);
+        if (pipelineV !== undefined)
+            params.set("pipeline", pipelineV);
+        if (pipelineNameV !== undefined)
+            params.set("pipeline_name", pipelineNameV);
+        if (stageV !== undefined)
+            params.set("stage", stageV);
+        if (stageNameV !== undefined)
+            params.set("stage_name", stageNameV);
         if (assignedTo)
             params.set("assigned_to", assignedTo);
         if (status)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "conduyt-mcp",
-  "version": "4.3.2",
-  "description": "MCP server for Conduyt CRM \u2014 expose CRM operations as AI-accessible tools",
+  "version": "4.3.3",
+  "description": "MCP server for Conduyt CRM — expose CRM operations as AI-accessible tools",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/tools/knowledge.d.ts

@@ -1,14 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { ConduytClient } from "../client.js";
-/**
- * Document knowledge base (RAG) — tier 2 of Conduyt's AI model: "use our AI with
- * YOUR model." Uploaded documents are retrieved and fed to the chat model on
- * every call, so the feature is gated to accounts running their OWN AI engine
- * (BYO key). Caps: BYO = 20 docs, + $50/mo AI Knowledge add-on = 100, >100 is
- * handled manually ("reach out to us").
- *
- * All JSON surfaces (API / MCP / CLI) expose the same subset: list / add-URL /
- * delete / reindex. Binary file upload (TXT/MD/CSV) is multipart and is web-UI
- * only — neither MCP tool calls nor the generated CLI carry a file body.
- */
-export declare function registerKnowledgeTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/knowledge.js

@@ -1,38 +0,0 @@
-import { z } from "zod";
-import { formatResult } from "../client.js";
-/**
- * Document knowledge base (RAG) — tier 2 of Conduyt's AI model: "use our AI with
- * YOUR model." Uploaded documents are retrieved and fed to the chat model on
- * every call, so the feature is gated to accounts running their OWN AI engine
- * (BYO key). Caps: BYO = 20 docs, + $50/mo AI Knowledge add-on = 100, >100 is
- * handled manually ("reach out to us").
- *
- * All JSON surfaces (API / MCP / CLI) expose the same subset: list / add-URL /
- * delete / reindex. Binary file upload (TXT/MD/CSV) is multipart and is web-UI
- * only — neither MCP tool calls nor the generated CLI carry a file body.
- */
-export function registerKnowledgeTools(server, client) {
-    server.tool("conduyt_list_knowledge_sources", "List the account's AI knowledge-base documents and the current entitlement. Returns each source (name, type, status: queued|indexing|indexed|stale|failed) plus byoActive (whether the document KB is unlocked by an own-AI-key), addon (whether the $50/mo add-on is active), docLimit, and used count.", {}, async () => {
-        const result = await client.get("/api/v1/knowledge/sources");
-        return formatResult(result);
-    });
-    server.tool("conduyt_add_knowledge_url", "Add a web page to the AI knowledge base by URL. The page is scraped, chunked, embedded, and becomes retrievable for AI answers. Requires the account to have its own AI key connected (byoActive) and to be under its document cap. To add a file (TXT/MD/CSV), use the web UI — file upload is multipart and not available over MCP or CLI.", {
-        url: z.string().describe("Public http(s) URL of the page to learn from"),
-        name: z.string().optional().describe("Optional friendly name (defaults to the URL)"),
-    }, async (params) => {
-        const result = await client.post("/api/v1/knowledge/sources", params);
-        return formatResult(result);
-    });
-    server.tool("conduyt_delete_knowledge_source", "Remove a document from the AI knowledge base. Deletes the stored file (if any) and all of its embeddings. Account-scoped.", {
-        id: z.string().describe("Knowledge source UUID"),
-    }, async ({ id }) => {
-        const result = await client.del(`/api/v1/knowledge/sources/${id}`);
-        return formatResult(result);
-    });
-    server.tool("conduyt_reindex_knowledge_source", "Re-learn a document — re-fetches/re-extracts and rebuilds its embeddings. Use to refresh a URL whose content changed, or to retry a source that failed indexing.", {
-        id: z.string().describe("Knowledge source UUID"),
-    }, async ({ id }) => {
-        const result = await client.post(`/api/v1/knowledge/sources/${id}/reindex`, {});
-        return formatResult(result);
-    });
-}