coalesce-transform-mcp 0.3.0 → 0.4.2

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

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/mcp/cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAkCnD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,IAAI,CAwKN"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/mcp/cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AA6B9B,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,cAAc,EAAE,CA2IlB"}

package/dist/mcp/cache.js

@@ -2,14 +2,16 @@ import { rmSync, existsSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { z } from "zod";
 import { DESTRUCTIVE_ANNOTATIONS, IDEMPOTENT_WRITE_ANNOTATIONS, buildJsonToolResponse, handleToolError, getToolOutputSchema, } from "../coalesce/types.js";
+import { requireDestructiveConfirmation } from "../services/shared/elicitation.js";
 import { getCacheDir, CACHE_DIR_NAME } from "../cache-dir.js";
 import { cacheEnvironmentNodes, cacheOrgUsers, cacheRuns, cacheWorkspaceNodes, } from "../services/cache/snapshots.js";
+import { defineSimpleTool } from "./tool-helpers.js";
 const SnapshotPaginationShape = {
     pageSize: z
         .number()
         .int()
         .positive()
-        .max(1000)
+        .max(500)
         .optional()
         .describe("Optional API page size used while collecting the full snapshot. Defaults to 250."),
     orderBy: z
@@ -21,149 +23,131 @@ const SnapshotPaginationShape = {
         .optional()
         .describe("Optional sort direction used for paginated collection."),
 };
-export function registerCacheTools(server, client) {
-    server.registerTool("cache_workspace_nodes", {
-        title: "Cache Workspace Nodes",
-        description: "Fetch and cache all workspace nodes to disk for efficient repeated access. Useful when working with large workspaces where inline responses exceed the auto-cache threshold.\n\nArgs:\n  - workspaceID (string, required): The workspace ID\n  - detail (boolean, optional): Fetch expanded node details. Defaults to true\n  - pageSize (number, optional): API page size for collection. Defaults to 250, max 1000\n  - orderBy (string, optional): Sort field for paginated collection. Defaults to id\n  - orderByDirection ('asc'|'desc', optional): Sort direction\n\nReturns:\n  Cache metadata with resourceUri (coalesce://cache/...) for accessing the cached data via MCP resource read.",
-        inputSchema: z.object({
-            workspaceID: z.string().describe("The workspace ID"),
-            detail: z
-                .boolean()
-                .optional()
-                .describe("When true, fetches expanded node details. Defaults to true."),
-            ...SnapshotPaginationShape,
-        }),
-        outputSchema: getToolOutputSchema("cache_workspace_nodes"),
-        annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await cacheWorkspaceNodes(client, params);
-            return buildJsonToolResponse("cache_workspace_nodes", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("cache_environment_nodes", {
-        title: "Cache Environment Nodes",
-        description: "Fetch and cache all environment nodes to disk for efficient repeated access.\n\nArgs:\n  - environmentID (string, required): The environment ID\n  - detail (boolean, optional): Fetch expanded node details. Defaults to true\n  - pageSize (number, optional): API page size for collection. Defaults to 250, max 1000\n  - orderBy (string, optional): Sort field for paginated collection. Defaults to id\n  - orderByDirection ('asc'|'desc', optional): Sort direction\n\nReturns:\n  Cache metadata with resourceUri (coalesce://cache/...) for accessing the cached data via MCP resource read.",
-        inputSchema: z.object({
-            environmentID: z.string().describe("The environment ID"),
-            detail: z
-                .boolean()
-                .optional()
-                .describe("When true, fetches expanded node details. Defaults to true."),
-            ...SnapshotPaginationShape,
-        }),
-        outputSchema: getToolOutputSchema("cache_environment_nodes"),
-        annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await cacheEnvironmentNodes(client, params);
-            return buildJsonToolResponse("cache_environment_nodes", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("cache_runs", {
-        title: "Cache Runs",
-        description: "Fetch and cache runs to disk with optional filters for efficient repeated access.\n\nArgs:\n  - runType (enum, optional): Filter by 'deploy' or 'refresh'\n  - runStatus (enum, optional): Filter by 'completed' | 'failed' | 'canceled' | 'running' | 'waitingToRun'\n  - environmentID (string, optional): Filter by environment ID\n  - detail (boolean, optional): Fetch expanded run details. Defaults to false\n  - pageSize (number, optional): API page size for collection. Defaults to 250, max 1000\n  - orderBy (string, optional): Sort field for paginated collection. Defaults to id\n  - orderByDirection ('asc'|'desc', optional): Sort direction\n\nReturns:\n  Cache metadata with resourceUri (coalesce://cache/...) for accessing the cached data via MCP resource read.",
-        inputSchema: z.object({
-            runType: z.enum(["deploy", "refresh"]).optional().describe("Optional run type filter"),
-            runStatus: z
-                .enum(["completed", "failed", "canceled", "running", "waitingToRun"])
-                .optional()
-                .describe("Optional run status filter"),
-            environmentID: z.string().optional().describe("Optional environment ID filter"),
-            detail: z
-                .boolean()
-                .optional()
-                .describe("When true, fetches expanded run details. Defaults to false."),
-            ...SnapshotPaginationShape,
-        }),
-        outputSchema: getToolOutputSchema("cache_runs"),
-        annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await cacheRuns(client, params);
-            return buildJsonToolResponse("cache_runs", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("cache_org_users", {
-        title: "Cache Org Users",
-        description: "Fetch and cache all organization users to disk for efficient repeated access.\n\nArgs:\n  - pageSize (number, optional): API page size for collection. Defaults to 250, max 1000\n  - orderBy (string, optional): Sort field for paginated collection. Defaults to id\n  - orderByDirection ('asc'|'desc', optional): Sort direction\n\nReturns:\n  Cache metadata with resourceUri (coalesce://cache/...) for accessing the cached data via MCP resource read.",
-        inputSchema: z.object({
-            ...SnapshotPaginationShape,
-        }),
-        outputSchema: getToolOutputSchema("cache_org_users"),
-        annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await cacheOrgUsers(client, params);
-            return buildJsonToolResponse("cache_org_users", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("clear_data_cache", {
-        title: "Clear Data Cache",
-        description: "Clear the MCP server's local data cache. Removes all cached artifacts from disk.\n\nReturns:\n  { deleted: boolean, fileCount: number, totalBytes: number, message: string }",
-        inputSchema: z.object({}),
-        outputSchema: getToolOutputSchema("clear_data_cache"),
-        annotations: DESTRUCTIVE_ANNOTATIONS,
-    }, async () => {
-        try {
-            const cacheDir = getCacheDir();
-            if (!existsSync(cacheDir)) {
-                return buildJsonToolResponse("clear_data_cache", {
-                    deleted: false,
-                    message: `No cache directory found at ${CACHE_DIR_NAME}/`,
-                });
-            }
-            // Count files and measure size before deleting
-            let fileCount = 0;
-            let totalBytes = 0;
-            function countFiles(dir) {
+export function defineCacheTools(server, client) {
+    return [
+        defineSimpleTool(client, "cache_workspace_nodes", {
+            title: "Cache Workspace Nodes",
+            description: "Fetch and cache all workspace nodes to disk for efficient repeated access. Useful when working with large workspaces where inline responses exceed the auto-cache threshold.\n\nArgs:\n  - workspaceID (string, required): The workspace ID\n  - detail (boolean, optional): Fetch expanded node details. Defaults to true\n  - pageSize (number, optional): API page size for collection. Defaults to 250, max 500\n  - orderBy (string, optional): Sort field for paginated collection. Defaults to id\n  - orderByDirection ('asc'|'desc', optional): Sort direction\n\nReturns:\n  Cache metadata with resourceUri (coalesce://cache/...) for accessing the cached data via MCP resource read.",
+            inputSchema: z.object({
+                workspaceID: z.string().describe("The workspace ID"),
+                detail: z
+                    .boolean()
+                    .optional()
+                    .describe("When true, fetches expanded node details. Defaults to true."),
+                ...SnapshotPaginationShape,
+            }),
+            annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
+        }, cacheWorkspaceNodes),
+        defineSimpleTool(client, "cache_environment_nodes", {
+            title: "Cache Environment Nodes",
+            description: "Fetch and cache all environment nodes to disk for efficient repeated access.\n\nArgs:\n  - environmentID (string, required): The environment ID\n  - detail (boolean, optional): Fetch expanded node details. Defaults to true\n  - pageSize (number, optional): API page size for collection. Defaults to 250, max 500\n  - orderBy (string, optional): Sort field for paginated collection. Defaults to id\n  - orderByDirection ('asc'|'desc', optional): Sort direction\n\nReturns:\n  Cache metadata with resourceUri (coalesce://cache/...) for accessing the cached data via MCP resource read.",
+            inputSchema: z.object({
+                environmentID: z.string().describe("The environment ID"),
+                detail: z
+                    .boolean()
+                    .optional()
+                    .describe("When true, fetches expanded node details. Defaults to true."),
+                ...SnapshotPaginationShape,
+            }),
+            annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
+        }, cacheEnvironmentNodes),
+        defineSimpleTool(client, "cache_runs", {
+            title: "Cache Runs",
+            description: "Fetch and cache runs to disk with optional filters for efficient repeated access.\n\nArgs:\n  - runType (enum, optional): Filter by 'deploy' or 'refresh'\n  - runStatus (enum, optional): Filter by 'completed' | 'failed' | 'canceled' | 'running' | 'waitingToRun'\n  - environmentID (string, optional): Filter by environment ID\n  - detail (boolean, optional): Fetch expanded run details. Defaults to false\n  - pageSize (number, optional): API page size for collection. Defaults to 250, max 500\n  - orderBy (string, optional): Sort field for paginated collection. Defaults to id\n  - orderByDirection ('asc'|'desc', optional): Sort direction\n\nReturns:\n  Cache metadata with resourceUri (coalesce://cache/...) for accessing the cached data via MCP resource read.",
+            inputSchema: z.object({
+                runType: z.enum(["deploy", "refresh"]).optional().describe("Optional run type filter"),
+                runStatus: z
+                    .enum(["completed", "failed", "canceled", "running", "waitingToRun"])
+                    .optional()
+                    .describe("Optional run status filter"),
+                environmentID: z.string().optional().describe("Optional environment ID filter"),
+                detail: z
+                    .boolean()
+                    .optional()
+                    .describe("When true, fetches expanded run details. Defaults to false."),
+                ...SnapshotPaginationShape,
+            }),
+            annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
+        }, cacheRuns),
+        defineSimpleTool(client, "cache_org_users", {
+            title: "Cache Org Users",
+            description: "Fetch and cache all organization users to disk for efficient repeated access.\n\nArgs:\n  - pageSize (number, optional): API page size for collection. Defaults to 250, max 500\n  - orderBy (string, optional): Sort field for paginated collection. Defaults to id\n  - orderByDirection ('asc'|'desc', optional): Sort direction\n\nReturns:\n  Cache metadata with resourceUri (coalesce://cache/...) for accessing the cached data via MCP resource read.",
+            inputSchema: z.object({
+                ...SnapshotPaginationShape,
+            }),
+            annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
+        }, cacheOrgUsers),
+        // clear_data_cache has complex inline logic (file counting + rmSync)
+        // that doesn't fit the simple helper pattern.
+        // NOTE: The inline handler requires `server` for elicitation — do NOT rename to `_server`.
+        ["clear_data_cache",
+            {
+                title: "Clear Data Cache",
+                description: "Clear the MCP server's local data cache. Removes all cached artifacts from disk.\n\nArgs:\n  - confirmed (boolean, optional): Set to true after the user explicitly confirms cache clearing\n\nReturns:\n  { deleted: boolean, fileCount: number, totalBytes: number, message: string }",
+                inputSchema: z.object({
+                    confirmed: z
+                        .boolean()
+                        .optional()
+                        .describe("Set to true after the user explicitly confirms the cache clearing."),
+                }),
+                outputSchema: getToolOutputSchema("clear_data_cache"),
+                annotations: DESTRUCTIVE_ANNOTATIONS,
+            },
+            async (params) => {
                 try {
-                    for (const entry of readdirSync(dir, { withFileTypes: true })) {
-                        const entryPath = join(dir, entry.name);
-                        if (entry.isDirectory()) {
-                            countFiles(entryPath);
-                        }
-                        else if (entry.isFile()) {
-                            fileCount++;
-                            try {
-                                totalBytes += statSync(entryPath).size;
-                            }
-                            catch {
-                                // skip unreadable files
+                    const approvalResponse = await requireDestructiveConfirmation(server, "clear_data_cache", "This will delete all cached data from disk. Cached snapshots will need to be re-fetched.", params.confirmed);
+                    if (approvalResponse)
+                        return approvalResponse;
+                    const cacheDir = getCacheDir();
+                    if (!existsSync(cacheDir)) {
+                        return buildJsonToolResponse("clear_data_cache", {
+                            deleted: false,
+                            message: `No cache directory found at ${CACHE_DIR_NAME}/`,
+                        });
+                    }
+                    // Count files and measure size before deleting
+                    let fileCount = 0;
+                    let totalBytes = 0;
+                    let countErrors = 0;
+                    function countFiles(dir) {
+                        try {
+                            for (const entry of readdirSync(dir, { withFileTypes: true })) {
+                                const entryPath = join(dir, entry.name);
+                                if (entry.isDirectory()) {
+                                    countFiles(entryPath);
+                                }
+                                else if (entry.isFile()) {
+                                    fileCount++;
+                                    try {
+                                        totalBytes += statSync(entryPath).size;
+                                    }
+                                    catch {
+                                        countErrors++;
+                                    }
+                                }
                             }
                         }
+                        catch {
+                            countErrors++;
+                        }
                     }
+                    countFiles(cacheDir);
+                    rmSync(cacheDir, { recursive: true, force: true });
+                    const sizeMB = (totalBytes / (1024 * 1024)).toFixed(2);
+                    return buildJsonToolResponse("clear_data_cache", {
+                        deleted: true,
+                        fileCount,
+                        totalBytes,
+                        sizeMB: `${sizeMB} MB`,
+                        message: `Deleted ${fileCount} files (${sizeMB} MB) from ${CACHE_DIR_NAME}/`,
+                        ...(countErrors > 0 ? { countWarning: `${countErrors} file(s)/dir(s) could not be measured — reported totals may be approximate` } : {}),
+                    });
                 }
-                catch {
-                    // skip unreadable dirs
+                catch (error) {
+                    return handleToolError(error);
                 }
             }
-            countFiles(cacheDir);
-            rmSync(cacheDir, { recursive: true, force: true });
-            const sizeMB = (totalBytes / (1024 * 1024)).toFixed(2);
-            return buildJsonToolResponse("clear_data_cache", {
-                deleted: true,
-                fileCount,
-                totalBytes,
-                sizeMB: `${sizeMB} MB`,
-                message: `Deleted ${fileCount} files (${sizeMB} MB) from ${CACHE_DIR_NAME}/`,
-            });
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
+        ],
+    ];
 }
 //# sourceMappingURL=cache.js.map

package/dist/mcp/cache.js.map

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

package/dist/mcp/environments.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"environments.d.ts","sourceRoot":"","sources":["../../src/mcp/environments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAmBnD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,IAAI,CAwIN"}
+{"version":3,"file":"environments.d.ts","sourceRoot":"","sources":["../../src/mcp/environments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAOnD,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAG9B,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,cAAc,EAAE,CA8DlB"}

package/dist/mcp/environments.js

@@ -1,117 +1,61 @@
 import { z } from "zod";
-import { listEnvironments, getEnvironment, createEnvironment, updateEnvironment, deleteEnvironment, } from "../coalesce/api/environments.js";
-import { PaginationParams, buildJsonToolResponse, handleToolError, getToolOutputSchema, READ_ONLY_ANNOTATIONS, WRITE_ANNOTATIONS, IDEMPOTENT_WRITE_ANNOTATIONS, DESTRUCTIVE_ANNOTATIONS, } from "../coalesce/types.js";
-export function registerEnvironmentTools(server, client) {
-    server.registerTool("list_environments", {
-        title: "List Environments",
-        description: "List all available Coalesce environments with optional pagination.\n\nReturns environment IDs, names, and configuration. Use this to discover environment IDs needed by run, node, and job tools.\n\nArgs:\n  - limit (number, optional): Max results per page\n  - startingFrom (string, optional): Pagination cursor from previous response\n  - orderBy (string, optional): Sort field (requires startingFrom)\n  - orderByDirection ('asc'|'desc', optional): Sort direction\n  - detail (boolean, optional): Include expanded environment configuration\n\nReturns:\n  { data: Environment[], next?: string, total?: number }\n\nUse get_environment for a single environment by ID.",
-        inputSchema: PaginationParams.extend({
-            detail: z.boolean().optional().describe("When true, returns expanded environment info"),
-        }),
-        outputSchema: getToolOutputSchema("list_environments"),
-        annotations: READ_ONLY_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await listEnvironments(client, params);
-            return buildJsonToolResponse("list_environments", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("get_environment", {
-        title: "Get Environment",
-        description: "Get details of a specific Coalesce environment by ID.\n\nReturns full environment configuration including connection details, runtime parameters, and tag colors.\n\nArgs:\n  - environmentID (string, required): The environment ID\n\nReturns:\n  Full environment object with ID, name, project, connection settings, and configuration.",
-        inputSchema: z.object({
-            environmentID: z.string().describe("The environment ID"),
-        }),
-        outputSchema: getToolOutputSchema("get_environment"),
-        annotations: READ_ONLY_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await getEnvironment(client, params);
-            return buildJsonToolResponse("get_environment", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("create_environment", {
-        title: "Create Environment",
-        description: "Create a new Coalesce environment within a project.\n\nArgs:\n  - projectID (string, required): The project to create the environment in\n  - name (string, required): Name for the new environment\n  - oauthEnabled (boolean, optional): Enable OAuth (default: false)\n  - devEnv (boolean, optional): Mark as development environment (default: false)\n  - connectionAccount (string, optional): Connection account identifier\n  - runTimeParameters (object, optional): Runtime parameters for the environment\n  - tagColors (object, optional): UI tag colors { backgroundColor, textColor }\n\nReturns:\n  Created environment object with assigned ID.",
-        inputSchema: z.object({
-            projectID: z.string().describe("The project ID to create the environment in"),
-            name: z.string().describe("Name for the new environment"),
-            oauthEnabled: z.boolean().optional().describe("Whether OAuth is enabled. Defaults to false."),
-            devEnv: z.boolean().optional().describe("Defaults to false."),
-            connectionAccount: z.string().optional().describe("Optional connection account identifier"),
-            runTimeParameters: z.record(z.unknown()).optional().describe("Optional runtime parameters"),
-            tagColors: z
-                .object({
-                backgroundColor: z.string().optional(),
-                textColor: z.string().optional(),
-            })
-                .optional()
-                .describe("Optional tag colors for the environment"),
-        }),
-        outputSchema: getToolOutputSchema("create_environment"),
-        annotations: WRITE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            // Coalesce API expects `project` in the body
+import { listEnvironments, getEnvironment, createEnvironment, deleteEnvironment, } from "../coalesce/api/environments.js";
+import { PaginationParams, READ_ONLY_ANNOTATIONS, WRITE_ANNOTATIONS, DESTRUCTIVE_ANNOTATIONS, } from "../coalesce/types.js";
+import { defineSimpleTool, defineDestructiveTool } from "./tool-helpers.js";
+export function defineEnvironmentTools(server, client) {
+    return [
+        defineSimpleTool(client, "list_environments", {
+            title: "List Environments",
+            description: "List all available Coalesce environments with optional pagination.\n\nReturns environment IDs, names, and configuration. Use this to discover environment IDs needed by run, node, and job tools.\n\nArgs:\n  - limit (number, optional): Max results per page\n  - startingFrom (string, optional): Pagination cursor from previous response\n  - orderBy (string, optional): Sort field (requires startingFrom)\n  - orderByDirection ('asc'|'desc', optional): Sort direction\n  - detail (boolean, optional): Include expanded environment configuration\n\nReturns:\n  { data: Environment[], next?: string, total?: number }\n\nUse get_environment for a single environment by ID.",
+            inputSchema: PaginationParams.extend({
+                detail: z.boolean().optional().describe("When true, returns expanded environment info"),
+            }),
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, listEnvironments),
+        defineSimpleTool(client, "get_environment", {
+            title: "Get Environment",
+            description: "Get details of a specific Coalesce environment by ID.\n\nReturns full environment configuration including connection details, runtime parameters, and tag colors.\n\nArgs:\n  - environmentID (string, required): The environment ID\n\nReturns:\n  Full environment object with ID, name, project, connection settings, and configuration.",
+            inputSchema: z.object({
+                environmentID: z.string().describe("The environment ID"),
+            }),
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, getEnvironment),
+        defineSimpleTool(client, "create_environment", {
+            title: "Create Environment",
+            description: "Create a new Coalesce environment within a project.\n\nArgs:\n  - projectID (string, required): The project to create the environment in\n  - name (string, required): Name for the new environment\n  - oauthEnabled (boolean, optional): Enable OAuth (default: false)\n  - devEnv (boolean, optional): Mark as development environment (default: false)\n  - connectionAccount (string, optional): Connection account identifier\n  - runTimeParameters (object, optional): Runtime parameters for the environment\n  - tagColors (object, optional): UI tag colors { backgroundColor, textColor }\n\nReturns:\n  Created environment object with assigned ID.",
+            inputSchema: z.object({
+                projectID: z.string().describe("The project ID to create the environment in"),
+                name: z.string().describe("Name for the new environment"),
+                oauthEnabled: z.boolean().optional().describe("Whether OAuth is enabled. Defaults to false."),
+                devEnv: z.boolean().optional().describe("Defaults to false."),
+                connectionAccount: z.string().optional().describe("Optional connection account identifier"),
+                runTimeParameters: z.record(z.unknown()).optional().describe("Optional runtime parameters"),
+                tagColors: z
+                    .object({
+                    backgroundColor: z.string().optional(),
+                    textColor: z.string().optional(),
+                })
+                    .optional()
+                    .describe("Optional tag colors for the environment"),
+            }),
+            annotations: WRITE_ANNOTATIONS,
+        }, (client, params) => {
             const { projectID, ...rest } = params;
-            const result = await createEnvironment(client, { project: projectID, ...rest });
-            return buildJsonToolResponse("create_environment", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("update_environment", {
-        title: "Update Environment",
-        description: "Update an existing Coalesce environment. Partial update — only provided fields are changed.\n\nArgs:\n  - environmentID (string, required): The environment ID to update\n  - name (string, optional): Updated environment name\n  - oauthEnabled (boolean, optional): Toggle OAuth\n  - connectionAccount (string, optional): Updated connection account\n  - runTimeParameters (object, optional): Updated runtime parameters\n  - tagColors (object, optional): Updated UI tag colors\n\nReturns:\n  Updated environment object.",
-        inputSchema: z.object({
-            environmentID: z.string().describe("The environment ID to update"),
-            name: z.string().optional().describe("Updated name for the environment"),
-            oauthEnabled: z.boolean().optional().describe("Whether OAuth is enabled"),
-            devEnv: z.boolean().optional().describe("Whether this is a dev environment"),
-            connectionAccount: z.string().optional().describe("Connection account identifier"),
-            runTimeParameters: z.record(z.unknown()).optional().describe("Runtime parameters"),
-            tagColors: z
-                .object({
-                backgroundColor: z.string().optional(),
-                textColor: z.string().optional(),
-            })
-                .optional()
-                .describe("Tag colors for the environment"),
-        }),
-        outputSchema: getToolOutputSchema("update_environment"),
-        annotations: IDEMPOTENT_WRITE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await updateEnvironment(client, params);
-            return buildJsonToolResponse("update_environment", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    server.registerTool("delete_environment", {
-        title: "Delete Environment",
-        description: "Permanently delete a Coalesce environment. This is destructive and cannot be undone.\n\nArgs:\n  - environmentID (string, required): The environment ID to delete\n\nReturns:\n  Confirmation message.",
-        inputSchema: z.object({
-            environmentID: z.string().describe("The environment ID to delete"),
+            return createEnvironment(client, { project: projectID, oauthEnabled: false, ...rest });
         }),
-        outputSchema: getToolOutputSchema("delete_environment"),
-        annotations: DESTRUCTIVE_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await deleteEnvironment(client, params);
-            return buildJsonToolResponse("delete_environment", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
+        defineDestructiveTool(server, client, "delete_environment", {
+            title: "Delete Environment",
+            description: "Permanently delete a Coalesce environment. This is destructive and cannot be undone.\n\nArgs:\n  - environmentID (string, required): The environment ID to delete\n  - confirmed (boolean, optional): Set to true after the user explicitly confirms deletion\n\nReturns:\n  Confirmation message.",
+            inputSchema: z.object({
+                environmentID: z.string().describe("The environment 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 environment "${params.environmentID}". This cannot be undone.`,
+        }, deleteEnvironment),
+    ];
 }
 //# sourceMappingURL=environments.js.map

package/dist/mcp/environments.js.map

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

package/dist/mcp/git-accounts.d.ts

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

package/dist/mcp/git-accounts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-accounts.d.ts","sourceRoot":"","sources":["../../src/mcp/git-accounts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAkBnD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,IAAI,CA2HN"}
+{"version":3,"file":"git-accounts.d.ts","sourceRoot":"","sources":["../../src/mcp/git-accounts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQnD,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAG9B,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,cAAc,EAAE,CAqFlB"}