coalesce-transform-mcp 0.3.0 → 0.4.2

package/dist/mcp/subgraphs.js

@@ -1,102 +1,65 @@
 import { z } from "zod";
 import { listWorkspaceSubgraphs, getWorkspaceSubgraph, createWorkspaceSubgraph, updateWorkspaceSubgraph, deleteWorkspaceSubgraph, } from "../coalesce/api/subgraphs.js";
-import { PaginationParams, buildJsonToolResponse, handleToolError, getToolOutputSchema, READ_ONLY_ANNOTATIONS, WRITE_ANNOTATIONS, DESTRUCTIVE_ANNOTATIONS, } from "../coalesce/types.js";
-export function registerSubgraphTools(server, client) {
-    server.registerTool("list_workspace_subgraphs", {
-        title: "List Workspace Subgraphs",
-        description: "List all subgraphs in a Coalesce workspace. Use this to discover subgraph IDs.\n\nArgs:\n  - workspaceID (string, required): The workspace ID\n  - limit, startingFrom, orderBy, orderByDirection: Pagination\n\nReturns:\n  { data: Subgraph[], next?: string, total?: number }",
-        inputSchema: PaginationParams.extend({
-            workspaceID: z.string().describe("The workspace ID"),
-        }),
-        outputSchema: getToolOutputSchema("list_workspace_subgraphs"),
-        annotations: READ_ONLY_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await listWorkspaceSubgraphs(client, params);
-            return buildJsonToolResponse("list_workspace_subgraphs", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("get_workspace_subgraph", {
-        title: "Get Workspace Subgraph",
-        description: "Get details of a specific subgraph.\n\nArgs:\n  - workspaceID (string, required): The workspace ID\n  - subgraphID (string, required): The subgraph ID\n\nReturns:\n  Subgraph object with name and node steps.",
-        inputSchema: z.object({
-            workspaceID: z.string().describe("The workspace ID"),
-            subgraphID: z.string().describe("The subgraph ID"),
-        }),
-        outputSchema: getToolOutputSchema("get_workspace_subgraph"),
-        annotations: READ_ONLY_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await getWorkspaceSubgraph(client, params);
-            return buildJsonToolResponse("get_workspace_subgraph", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("create_workspace_subgraph", {
-        title: "Create Workspace Subgraph",
-        description: "Create a subgraph in a Coalesce workspace. Subgraphs group nodes visually.\n\nArgs:\n  - workspaceID (string, required): The workspace ID\n  - name (string, required): Subgraph name\n  - steps (string[], required): Array of node IDs to include\n\nReturns:\n  Created subgraph with assigned ID.",
-        inputSchema: z.object({
-            workspaceID: z.string().describe("The workspace ID"),
-            name: z.string().describe("Name for the subgraph"),
-            steps: z
-                .array(z.string())
-                .describe("Array of node IDs to include in the subgraph"),
-        }),
-        outputSchema: getToolOutputSchema("create_workspace_subgraph"),
-        annotations: WRITE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await createWorkspaceSubgraph(client, params);
-            return buildJsonToolResponse("create_workspace_subgraph", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("update_workspace_subgraph", {
-        title: "Update Workspace Subgraph",
-        description: "Update a subgraph's name and member nodes. Replaces the entire steps array.\n\nArgs:\n  - workspaceID (string, required): The workspace ID\n  - subgraphID (string, required): The subgraph ID\n  - name (string, required): Updated name\n  - steps (string[], required): Updated node IDs\n\nReturns:\n  Updated subgraph object.",
-        inputSchema: z.object({
-            workspaceID: z.string().describe("The workspace ID"),
-            subgraphID: z.string().describe("The subgraph ID to update"),
-            name: z.string().describe("Updated name for the subgraph"),
-            steps: z
-                .array(z.string())
-                .describe("Updated array of node IDs to include in the subgraph"),
-        }),
-        outputSchema: getToolOutputSchema("update_workspace_subgraph"),
-        annotations: WRITE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await updateWorkspaceSubgraph(client, params);
-            return buildJsonToolResponse("update_workspace_subgraph", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("delete_workspace_subgraph", {
-        title: "Delete Workspace Subgraph",
-        description: "Delete a subgraph from a workspace. Destructive — the subgraph is removed but its member nodes are NOT deleted.\n\nArgs:\n  - workspaceID (string, required): The workspace ID\n  - subgraphID (string, required): The subgraph ID\n\nReturns:\n  Confirmation message.",
-        inputSchema: z.object({
-            workspaceID: z.string().describe("The workspace ID"),
-            subgraphID: z.string().describe("The subgraph ID to delete"),
-        }),
-        outputSchema: getToolOutputSchema("delete_workspace_subgraph"),
-        annotations: DESTRUCTIVE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await deleteWorkspaceSubgraph(client, params);
-            return buildJsonToolResponse("delete_workspace_subgraph", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
+import { PaginationParams, READ_ONLY_ANNOTATIONS, WRITE_ANNOTATIONS, DESTRUCTIVE_ANNOTATIONS, } from "../coalesce/types.js";
+import { defineSimpleTool, defineDestructiveTool } from "./tool-helpers.js";
+export function defineSubgraphTools(server, client) {
+    return [
+        defineSimpleTool(client, "list_workspace_subgraphs", {
+            title: "List Workspace Subgraphs",
+            description: "List all subgraphs in a Coalesce workspace. Use this to discover subgraph IDs.\n\nArgs:\n  - workspaceID (string, required): The workspace ID\n  - limit, startingFrom, orderBy, orderByDirection: Pagination\n\nReturns:\n  { data: Subgraph[], next?: string, total?: number }",
+            inputSchema: PaginationParams.extend({
+                workspaceID: z.string().describe("The workspace ID"),
+            }),
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, listWorkspaceSubgraphs),
+        defineSimpleTool(client, "get_workspace_subgraph", {
+            title: "Get Workspace Subgraph",
+            description: "Get details of a specific subgraph.\n\nArgs:\n  - workspaceID (string, required): The workspace ID\n  - subgraphID (string, required): The subgraph ID\n\nReturns:\n  Subgraph object with name and node steps.",
+            inputSchema: z.object({
+                workspaceID: z.string().describe("The workspace ID"),
+                subgraphID: z.string().describe("The subgraph ID"),
+            }),
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, getWorkspaceSubgraph),
+        defineSimpleTool(client, "create_workspace_subgraph", {
+            title: "Create Workspace Subgraph",
+            description: "Create a subgraph in a Coalesce workspace. Subgraphs group nodes visually.\n\nArgs:\n  - workspaceID (string, required): The workspace ID\n  - name (string, required): Subgraph name\n  - steps (string[], required): Array of node IDs to include\n\nReturns:\n  Created subgraph with assigned ID.",
+            inputSchema: z.object({
+                workspaceID: z.string().describe("The workspace ID"),
+                name: z.string().describe("Name for the subgraph"),
+                steps: z
+                    .array(z.string())
+                    .describe("Array of node IDs to include in the subgraph"),
+            }),
+            annotations: WRITE_ANNOTATIONS,
+        }, createWorkspaceSubgraph),
+        defineSimpleTool(client, "update_workspace_subgraph", {
+            title: "Update Workspace Subgraph",
+            description: "Update a subgraph's name and member nodes. Replaces the entire steps array.\n\nArgs:\n  - workspaceID (string, required): The workspace ID\n  - subgraphID (string, required): The subgraph ID\n  - name (string, required): Updated name\n  - steps (string[], required): Updated node IDs\n\nReturns:\n  Updated subgraph object.",
+            inputSchema: z.object({
+                workspaceID: z.string().describe("The workspace ID"),
+                subgraphID: z.string().describe("The subgraph ID to update"),
+                name: z.string().describe("Updated name for the subgraph"),
+                steps: z
+                    .array(z.string())
+                    .describe("Updated array of node IDs to include in the subgraph"),
+            }),
+            annotations: WRITE_ANNOTATIONS,
+        }, updateWorkspaceSubgraph),
+        defineDestructiveTool(server, client, "delete_workspace_subgraph", {
+            title: "Delete Workspace Subgraph",
+            description: "Delete a subgraph from a workspace. Destructive — the subgraph is removed but its member nodes are NOT deleted.\n\nArgs:\n  - workspaceID (string, required): The workspace ID\n  - subgraphID (string, required): The subgraph ID\n  - confirmed (boolean, optional): Set to true after the user explicitly confirms deletion\n\nReturns:\n  Confirmation message.",
+            inputSchema: z.object({
+                workspaceID: z.string().describe("The workspace ID"),
+                subgraphID: z.string().describe("The subgraph ID to delete"),
+                confirmed: z
+                    .boolean()
+                    .optional()
+                    .describe("Set to true after the user explicitly confirms the deletion."),
+            }),
+            annotations: DESTRUCTIVE_ANNOTATIONS,
+            confirmMessage: (params) => `This will permanently delete subgraph "${params.subgraphID}" from workspace "${params.workspaceID}". Member nodes will NOT be deleted.`,
+        }, deleteWorkspaceSubgraph),
+    ];
 }
 //# sourceMappingURL=subgraphs.js.map

package/dist/mcp/subgraphs.js.map

@@ -1 +1 @@
-{"version":3,"file":"subgraphs.js","sourceRoot":"","sources":["../../src/mcp/subgraphs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,MAAsB;IAEtB,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,kRAAkR;QACpR,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC;YACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;SACrD,CAAC;QACF,YAAY,EAAE,mBAAmB,CAAC,0BAA0B,CAAC;QAC7D,WAAW,EAAE,qBAAqB;KACnC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC5D,OAAO,qBAAqB,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,iNAAiN;QACnN,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;SACnD,CAAC;QACF,YAAY,EAAE,mBAAmB,CAAC,wBAAwB,CAAC;QAC3D,WAAW,EAAE,qBAAqB;KACnC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC1D,OAAO,qBAAqB,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,uSAAuS;QACzS,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAClD,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,CAAC,8CAA8C,CAAC;SAC5D,CAAC;QACF,YAAY,EAAE,mBAAmB,CAAC,2BAA2B,CAAC;QAC9D,WAAW,EAAE,iBAAiB;KAC/B,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7D,OAAO,qBAAqB,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,qUAAqU;QACvU,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YAC5D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YAC1D,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,CAAC,sDAAsD,CAAC;SACpE,CAAC;QACF,YAAY,EAAE,mBAAmB,CAAC,2BAA2B,CAAC;QAC9D,WAAW,EAAE,iBAAiB;KAC/B,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7D,OAAO,qBAAqB,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,yQAAyQ;QAC3Q,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;SAC7D,CAAC;QACF,YAAY,EAAE,mBAAmB,CAAC,2BAA2B,CAAC;QAC9D,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7D,OAAO,qBAAqB,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"subgraphs.js","sourceRoot":"","sources":["../../src/mcp/subgraphs.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tool-helpers.d.ts

@@ -0,0 +1,37 @@
+import type { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CoalesceClient } from "../client.js";
+import { type ToolDefinition } from "../coalesce/types.js";
+type ToolAnnotations = {
+    readOnlyHint?: boolean;
+    idempotentHint?: boolean;
+    destructiveHint?: boolean;
+    openWorldHint?: boolean;
+};
+type ToolDef<S extends z.ZodType> = {
+    title: string;
+    description: string;
+    inputSchema: S;
+    annotations: ToolAnnotations;
+    sanitize?: boolean;
+};
+/**
+ * Define a simple passthrough tool: calls an API function with (client, params)
+ * and wraps the result in buildJsonToolResponse / handleToolError.
+ */
+export declare function defineSimpleTool<S extends z.ZodType>(client: CoalesceClient, name: string, def: ToolDef<S>, apiFunc: (client: CoalesceClient, params: z.infer<S>) => Promise<unknown>): ToolDefinition;
+/**
+ * Define a local-only tool that does not call the Coalesce API.
+ * Provides the same error handling and response formatting as defineSimpleTool
+ * without requiring a CoalesceClient dependency.
+ */
+export declare function defineLocalTool<S extends z.ZodType>(name: string, def: ToolDef<S>, handler: (params: z.infer<S>) => unknown | Promise<unknown>): ToolDefinition;
+/**
+ * Define a destructive tool that requires user confirmation before executing.
+ * The `server` parameter is still needed for elicitation.
+ */
+export declare function defineDestructiveTool<S extends z.ZodType>(server: McpServer, client: CoalesceClient, name: string, def: ToolDef<S> & {
+    confirmMessage: (params: z.infer<S>) => string;
+}, apiFunc: (client: CoalesceClient, params: z.infer<S>) => Promise<unknown>): ToolDefinition;
+export {};
+//# sourceMappingURL=tool-helpers.d.ts.map

package/dist/mcp/tool-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAG9B,KAAK,eAAe,GAAG;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,KAAK,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,IAAI;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC;IACf,WAAW,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAQF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAClD,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EACf,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GACxE,cAAc,CAmBhB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EACjD,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EACf,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC1D,cAAc,CAmBhB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EACvD,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,cAAc,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,CAAA;CAAE,EACpE,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GACxE,cAAc,CA2BhB"}

package/dist/mcp/tool-helpers.js

@@ -0,0 +1,82 @@
+import { buildJsonToolResponse, handleToolError, getToolOutputSchema, sanitizeResponse, } from "../coalesce/types.js";
+import { requireDestructiveConfirmation } from "../services/shared/elicitation.js";
+/**
+ * Define a simple passthrough tool: calls an API function with (client, params)
+ * and wraps the result in buildJsonToolResponse / handleToolError.
+ */
+export function defineSimpleTool(client, name, def, apiFunc) {
+    return [
+        name,
+        {
+            title: def.title,
+            description: def.description,
+            inputSchema: def.inputSchema,
+            outputSchema: getToolOutputSchema(name),
+            annotations: def.annotations,
+        },
+        (async (params) => {
+            try {
+                const result = await apiFunc(client, params);
+                return buildJsonToolResponse(name, def.sanitize ? sanitizeResponse(result) : result);
+            }
+            catch (error) {
+                return handleToolError(error);
+            }
+        }),
+    ];
+}
+/**
+ * Define a local-only tool that does not call the Coalesce API.
+ * Provides the same error handling and response formatting as defineSimpleTool
+ * without requiring a CoalesceClient dependency.
+ */
+export function defineLocalTool(name, def, handler) {
+    return [
+        name,
+        {
+            title: def.title,
+            description: def.description,
+            inputSchema: def.inputSchema,
+            outputSchema: getToolOutputSchema(name),
+            annotations: def.annotations,
+        },
+        (async (params) => {
+            try {
+                const result = await handler(params);
+                return buildJsonToolResponse(name, def.sanitize ? sanitizeResponse(result) : result);
+            }
+            catch (error) {
+                return handleToolError(error);
+            }
+        }),
+    ];
+}
+/**
+ * Define a destructive tool that requires user confirmation before executing.
+ * The `server` parameter is still needed for elicitation.
+ */
+export function defineDestructiveTool(server, client, name, def, apiFunc) {
+    return [
+        name,
+        {
+            title: def.title,
+            description: def.description,
+            inputSchema: def.inputSchema,
+            outputSchema: getToolOutputSchema(name),
+            annotations: def.annotations,
+        },
+        (async (params) => {
+            try {
+                const approvalResponse = await requireDestructiveConfirmation(server, name, def.confirmMessage(params), params.confirmed);
+                if (approvalResponse)
+                    return approvalResponse;
+                const result = await apiFunc(client, params);
+                return buildJsonToolResponse(name, def.sanitize ? sanitizeResponse(result) : result);
+            }
+            catch (error) {
+                return handleToolError(error);
+            }
+        }),
+    ];
+}
+//# sourceMappingURL=tool-helpers.js.map

package/dist/mcp/tool-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers.js","sourceRoot":"","sources":["../../src/mcp/tool-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,GAEjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAuBnF;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAsB,EACtB,IAAY,EACZ,GAAe,EACf,OAAyE;IAEzE,OAAO;QACL,IAAI;QACJ;YACE,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,YAAY,EAAE,mBAAmB,CAAC,IAAI,CAAC;YACvC,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B;QACD,CAAC,KAAK,EAAE,MAAkB,EAAE,EAAE;YAC5B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC7C,OAAO,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACvF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAiB;KACnB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,GAAe,EACf,OAA2D;IAE3D,OAAO;QACL,IAAI;QACJ;YACE,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,YAAY,EAAE,mBAAmB,CAAC,IAAI,CAAC;YACvC,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B;QACD,CAAC,KAAK,EAAE,MAAkB,EAAE,EAAE;YAC5B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;gBACrC,OAAO,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACvF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAiB;KACnB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,MAAsB,EACtB,IAAY,EACZ,GAAoE,EACpE,OAAyE;IAEzE,OAAO;QACL,IAAI;QACJ;YACE,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,YAAY,EAAE,mBAAmB,CAAC,IAAI,CAAC;YACvC,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B;QACD,CAAC,KAAK,EAAE,MAAkB,EAAE,EAAE;YAC5B,IAAI,CAAC;gBACH,MAAM,gBAAgB,GAAG,MAAM,8BAA8B,CAC3D,MAAM,EACN,IAAI,EACJ,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAC1B,MAAM,CAAC,SAAS,CACjB,CAAC;gBACF,IAAI,gBAAgB;oBAAE,OAAO,gBAAgB,CAAC;gBAE9C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC7C,OAAO,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACvF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAiB;KACnB,CAAC;AACJ,CAAC"}

package/dist/mcp/users.d.ts

@@ -1,4 +1,5 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { CoalesceClient } from "../client.js";
-export declare function registerUserTools(server: McpServer, client: CoalesceClient): void;
+import { type ToolDefinition } from "../coalesce/types.js";
+export declare function defineUserTools(server: McpServer, client: CoalesceClient): ToolDefinition[];
 //# sourceMappingURL=users.d.ts.map

package/dist/mcp/users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/mcp/users.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAqBnD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,IAAI,CA2LN"}
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/mcp/users.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAWnD,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAG9B,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,cAAc,EAAE,CA6GlB"}

package/dist/mcp/users.js

@@ -1,153 +1,100 @@
 import { z } from "zod";
 import { listOrgUsers, getUserRoles, listUserRoles, setOrgRole, setProjectRole, deleteProjectRole, setEnvRole, deleteEnvRole, } from "../coalesce/api/users.js";
-import { PaginationParams, buildJsonToolResponse, handleToolError, getToolOutputSchema, READ_ONLY_ANNOTATIONS, IDEMPOTENT_WRITE_ANNOTATIONS, DESTRUCTIVE_ANNOTATIONS, } from "../coalesce/types.js";
-export function registerUserTools(server, client) {
-    server.registerTool("list_org_users", {
-        title: "List Org Users",
-        description: "List all users in the Coalesce organization.\n\nArgs:\n  - limit, startingFrom, orderBy, orderByDirection: Pagination controls\n\nReturns:\n  { data: User[], next?: string, total?: number }",
-        inputSchema: PaginationParams,
-        outputSchema: getToolOutputSchema("list_org_users"),
-        annotations: READ_ONLY_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await listOrgUsers(client, params);
-            return buildJsonToolResponse("list_org_users", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("get_user_roles", {
-        title: "Get User Roles",
-        description: "Get roles assigned to a specific user, optionally scoped to a project or environment.\n\nArgs:\n  - userID (string, required): The user ID\n  - projectID (string, optional): Scope to a specific project\n  - environmentID (string, optional): Scope to a specific environment\n\nReturns:\n  Role assignments for the user.",
-        inputSchema: z.object({
-            userID: z.string().describe("The user ID"),
-            projectID: z.string().optional().describe("Optional project scope filter"),
-            environmentID: z.string().optional().describe("Optional environment scope filter"),
-        }),
-        outputSchema: getToolOutputSchema("get_user_roles"),
-        annotations: READ_ONLY_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await getUserRoles(client, params);
-            return buildJsonToolResponse("get_user_roles", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("list_user_roles", {
-        title: "List User Roles",
-        description: "List roles for all users in the organization, optionally scoped.\n\nArgs:\n  - projectID (string, optional): Scope to a project\n  - environmentID (string, optional): Scope to an environment\n\nReturns:\n  { data: RoleAssignment[], next?: string, total?: number }",
-        inputSchema: z.object({
-            projectID: z.string().optional().describe("Optional project scope filter"),
-            environmentID: z.string().optional().describe("Optional environment scope filter"),
-        }),
-        outputSchema: getToolOutputSchema("list_user_roles"),
-        annotations: READ_ONLY_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await listUserRoles(client, params);
-            return buildJsonToolResponse("list_user_roles", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("set_org_role", {
-        title: "Set Org Role",
-        description: "Set the organization-level role for a user. Idempotent — safe to call multiple times.\n\nArgs:\n  - userID (string, required): The user ID\n  - role (string, required): Role to assign (e.g., 'admin', 'member', 'viewer')\n\nReturns:\n  Updated role assignment.",
-        inputSchema: z.object({
-            userID: z.string().describe("The user ID"),
-            role: z.string().describe("The organization role to assign (e.g., 'admin', 'member', 'viewer')"),
-        }),
-        outputSchema: getToolOutputSchema("set_org_role"),
-        annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
-    }, async (params) => {
-        try {
+import { PaginationParams, READ_ONLY_ANNOTATIONS, IDEMPOTENT_WRITE_ANNOTATIONS, DESTRUCTIVE_ANNOTATIONS, } from "../coalesce/types.js";
+import { defineSimpleTool, defineDestructiveTool } from "./tool-helpers.js";
+export function defineUserTools(server, client) {
+    return [
+        defineSimpleTool(client, "list_org_users", {
+            title: "List Org Users",
+            description: "List all users in the Coalesce organization.\n\nArgs:\n  - limit, startingFrom, orderBy, orderByDirection: Pagination controls\n\nReturns:\n  { data: User[], next?: string, total?: number }",
+            inputSchema: PaginationParams,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, listOrgUsers),
+        defineSimpleTool(client, "get_user_roles", {
+            title: "Get User Roles",
+            description: "Get roles assigned to a specific user, optionally scoped to a project or environment.\n\nArgs:\n  - userID (string, required): The user ID\n  - projectID (string, optional): Scope to a specific project\n  - environmentID (string, optional): Scope to a specific environment\n\nReturns:\n  Role assignments for the user.",
+            inputSchema: z.object({
+                userID: z.string().describe("The user ID"),
+                projectID: z.string().optional().describe("Optional project scope filter"),
+                environmentID: z.string().optional().describe("Optional environment scope filter"),
+            }),
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, getUserRoles),
+        defineSimpleTool(client, "list_user_roles", {
+            title: "List User Roles",
+            description: "List roles for all users in the organization, optionally scoped.\n\nArgs:\n  - projectID (string, optional): Scope to a project\n  - environmentID (string, optional): Scope to an environment\n\nReturns:\n  { data: RoleAssignment[], next?: string, total?: number }",
+            inputSchema: z.object({
+                projectID: z.string().optional().describe("Optional project scope filter"),
+                environmentID: z.string().optional().describe("Optional environment scope filter"),
+            }),
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, listUserRoles),
+        defineSimpleTool(client, "set_org_role", {
+            title: "Set Org Role",
+            description: "Set the organization-level role for a user. Idempotent — safe to call multiple times.\n\nArgs:\n  - userID (string, required): The user ID\n  - role (string, required): Role to assign (e.g., 'admin', 'member', 'viewer')\n\nReturns:\n  Updated role assignment.",
+            inputSchema: z.object({
+                userID: z.string().describe("The user ID"),
+                role: z.string().describe("The organization role to assign (e.g., 'admin', 'member', 'viewer')"),
+            }),
+            annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
+        }, (client, params) => {
             const { userID, ...body } = params;
-            const result = await setOrgRole(client, { userID, body });
-            return buildJsonToolResponse("set_org_role", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("set_project_role", {
-        title: "Set Project Role",
-        description: "Set a user's role for a specific project. Idempotent.\n\nArgs:\n  - userID (string, required): The user ID\n  - projectID (string, required): The project ID\n  - role (string, required): Role to assign (e.g., 'admin', 'developer', 'viewer')\n\nReturns:\n  Updated role assignment.",
-        inputSchema: z.object({
-            userID: z.string().describe("The user ID"),
-            projectID: z.string().describe("The project ID"),
-            role: z.string().describe("The project role to assign (e.g., 'admin', 'developer', 'viewer')"),
-        }),
-        outputSchema: getToolOutputSchema("set_project_role"),
-        annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const { userID, projectID, ...body } = params;
-            const result = await setProjectRole(client, { userID, projectID, body });
-            return buildJsonToolResponse("set_project_role", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("delete_project_role", {
-        title: "Delete Project Role",
-        description: "Remove a user's role from a specific project. Destructive — the user will lose project access.\n\nArgs:\n  - userID (string, required): The user ID\n  - projectID (string, required): The project ID\n\nReturns:\n  Confirmation message.",
-        inputSchema: z.object({
-            userID: z.string().describe("The user ID"),
-            projectID: z.string().describe("The project ID"),
+            return setOrgRole(client, { userID, body });
         }),
-        outputSchema: getToolOutputSchema("delete_project_role"),
-        annotations: DESTRUCTIVE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await deleteProjectRole(client, params);
-            return buildJsonToolResponse("delete_project_role", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("set_env_role", {
-        title: "Set Env Role",
-        description: "Set a user's role for a specific environment. Idempotent.\n\nArgs:\n  - userID (string, required): The user ID\n  - environmentID (string, required): The environment ID\n  - role (string, required): Role to assign\n\nReturns:\n  Updated role assignment.",
-        inputSchema: z.object({
-            userID: z.string().describe("The user ID"),
-            environmentID: z.string().describe("The environment ID"),
-            role: z.string().describe("The environment role to assign (e.g., 'admin', 'developer', 'viewer')"),
+        defineSimpleTool(client, "set_project_role", {
+            title: "Set Project Role",
+            description: "Set a user's role for a specific project. Idempotent.\n\nArgs:\n  - userID (string, required): The user ID\n  - projectID (string, required): The project ID\n  - role (string, required): Role to assign (e.g., 'admin', 'developer', 'viewer')\n\nReturns:\n  Updated role assignment.",
+            inputSchema: z.object({
+                userID: z.string().describe("The user ID"),
+                projectID: z.string().describe("The project ID"),
+                role: z.string().describe("The project role to assign (e.g., 'admin', 'developer', 'viewer')"),
+            }),
+            annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
+        }, (client, params) => {
+            const { userID, projectID, role } = params;
+            return setProjectRole(client, { userID, projectID, body: { projectRole: role } });
         }),
-        outputSchema: getToolOutputSchema("set_env_role"),
-        annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const { userID, environmentID, ...body } = params;
-            const result = await setEnvRole(client, { userID, environmentID, body });
-            return buildJsonToolResponse("set_env_role", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("delete_env_role", {
-        title: "Delete Env Role",
-        description: "Remove a user's role from a specific environment. Destructive.\n\nArgs:\n  - userID (string, required): The user ID\n  - environmentID (string, required): The environment ID\n\nReturns:\n  Confirmation message.",
-        inputSchema: z.object({
-            userID: z.string().describe("The user ID"),
-            environmentID: z.string().describe("The environment ID"),
+        defineDestructiveTool(server, client, "delete_project_role", {
+            title: "Delete Project Role",
+            description: "Remove a user's role from a specific project. Destructive — the user will lose project access immediately.\n\nArgs:\n  - userID (string, required): The user ID\n  - projectID (string, required): The project ID\n  - confirmed (boolean, optional): Set to true after the user explicitly confirms the role removal\n\nReturns:\n  Confirmation message.",
+            inputSchema: z.object({
+                userID: z.string().describe("The user ID"),
+                projectID: z.string().describe("The project ID"),
+                confirmed: z
+                    .boolean()
+                    .optional()
+                    .describe("Set to true after the user explicitly confirms the role removal."),
+            }),
+            annotations: DESTRUCTIVE_ANNOTATIONS,
+            confirmMessage: (params) => `This will remove the project role for user "${params.userID}" on project "${params.projectID}". The user will lose project access immediately.`,
+        }, deleteProjectRole),
+        defineSimpleTool(client, "set_env_role", {
+            title: "Set Env Role",
+            description: "Set a user's role for a specific environment. Idempotent.\n\nArgs:\n  - userID (string, required): The user ID\n  - environmentID (string, required): The environment ID\n  - role (string, required): Role to assign\n\nReturns:\n  Updated role assignment.",
+            inputSchema: z.object({
+                userID: z.string().describe("The user ID"),
+                environmentID: z.string().describe("The environment ID"),
+                role: z.string().describe("The environment role to assign (e.g., 'admin', 'developer', 'viewer')"),
+            }),
+            annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
+        }, (client, params) => {
+            const { userID, environmentID, role } = params;
+            return setEnvRole(client, { userID, environmentID, body: { environmentRole: role } });
         }),
-        outputSchema: getToolOutputSchema("delete_env_role"),
-        annotations: DESTRUCTIVE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await deleteEnvRole(client, params);
-            return buildJsonToolResponse("delete_env_role", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
+        defineDestructiveTool(server, client, "delete_env_role", {
+            title: "Delete Env Role",
+            description: "Remove a user's role from a specific environment. Destructive — the user will lose environment access immediately.\n\nArgs:\n  - userID (string, required): The user ID\n  - environmentID (string, required): The environment ID\n  - confirmed (boolean, optional): Set to true after the user explicitly confirms the role removal\n\nReturns:\n  Confirmation message.",
+            inputSchema: z.object({
+                userID: z.string().describe("The user ID"),
+                environmentID: z.string().describe("The environment ID"),
+                confirmed: z
+                    .boolean()
+                    .optional()
+                    .describe("Set to true after the user explicitly confirms the role removal."),
+            }),
+            annotations: DESTRUCTIVE_ANNOTATIONS,
+            confirmMessage: (params) => `This will remove the environment role for user "${params.userID}" on environment "${params.environmentID}". The user will lose environment access immediately.`,
+        }, deleteEnvRole),
+    ];
 }
 //# sourceMappingURL=users.js.map