coalesce-transform-mcp 0.2.3 → 0.4.1

package/dist/tasks/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tasks/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAKnD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEzE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,IAAI,CAIN"}

package/dist/tasks/index.js

@@ -0,0 +1,10 @@
+import { registerRunAndWaitTask } from "./run-and-wait-task.js";
+import { registerRetryAndWaitTask } from "./retry-and-wait-task.js";
+import { registerStartRunTask } from "./start-run-task.js";
+export { InMemoryTaskStore, InMemoryTaskMessageQueue } from "./store.js";
+export function registerTaskTools(server, client) {
+    registerRunAndWaitTask(server, client);
+    registerRetryAndWaitTask(server, client);
+    registerStartRunTask(server, client);
+}
+//# sourceMappingURL=index.js.map

package/dist/tasks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tasks/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,MAAsB;IAEtB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/tasks/retry-and-wait-task.d.ts

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

package/dist/tasks/retry-and-wait-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-and-wait-task.d.ts","sourceRoot":"","sources":["../../src/tasks/retry-and-wait-task.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAuBnD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,IAAI,CA2DN"}

package/dist/tasks/retry-and-wait-task.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { RerunParams, buildJsonToolResponse, WRITE_ANNOTATIONS, sanitizeResponse, getToolOutputSchema, } from "../coalesce/types.js";
+import { retryAndWait } from "../workflows/retry-and-wait.js";
+const RetryAndWaitTaskInput = RerunParams.extend({
+    pollInterval: z
+        .number()
+        .optional()
+        .describe("Seconds between status checks (default: 10, min: 5, max: 300)"),
+    timeout: z
+        .number()
+        .optional()
+        .describe("Max seconds to wait (default: 1800, min: 30, max: 3600)"),
+});
+export function registerRetryAndWaitTask(server, client) {
+    server.experimental.tasks.registerToolTask("retry_and_wait", {
+        title: "Retry and Wait",
+        description: "Retry a failed Coalesce run and poll until completion or timeout. Returns a task that can be polled for status.\n\nRequires Snowflake Key Pair auth via environment variables.\n\nArgs:\n  - runDetails.runID (string, required): The run ID to retry\n  - runDetails.forceIgnoreWorkspaceStatus (boolean, optional): Force retry\n  - parameters (object, optional): Runtime parameters\n  - pollInterval (number, optional): Seconds between checks (default: 10)\n  - timeout (number, optional): Max wait seconds (default: 1800)\n\nReturns:\n  { status, results, resultsError?, incomplete?, timedOut? }\n\nInspect timedOut, incomplete, and resultsError fields before continuing.",
+        inputSchema: RetryAndWaitTaskInput,
+        outputSchema: getToolOutputSchema("retry_and_wait"),
+        annotations: WRITE_ANNOTATIONS,
+        execution: { taskSupport: "optional" },
+    }, {
+        async createTask(rawParams, extra) {
+            const params = rawParams;
+            const task = await extra.taskStore.createTask({
+                ttl: extra.taskRequestedTtl,
+                pollInterval: (params.pollInterval ?? 10) * 1000,
+            });
+            (async () => {
+                try {
+                    const result = await retryAndWait(client, params, {
+                        signal: extra.signal,
+                    });
+                    const sanitized = sanitizeResponse(result);
+                    const response = buildJsonToolResponse("retry_and_wait", sanitized);
+                    await extra.taskStore.storeTaskResult(task.taskId, "completed", response);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    await extra.taskStore.storeTaskResult(task.taskId, "failed", {
+                        content: [{ type: "text", text: `retry_and_wait failed: ${message}` }],
+                        isError: true,
+                    });
+                }
+            })();
+            return { task };
+        },
+        async getTask(_params, extra) {
+            const task = await extra.taskStore.getTask(extra.taskId);
+            if (!task) {
+                throw new Error(`Task ${extra.taskId} not found`);
+            }
+            return task;
+        },
+        async getTaskResult(_params, extra) {
+            const result = await extra.taskStore.getTaskResult(extra.taskId);
+            return result;
+        },
+    });
+}
+//# sourceMappingURL=retry-and-wait-task.js.map

package/dist/tasks/retry-and-wait-task.js.map

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

package/dist/tasks/run-and-wait-task.d.ts

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

package/dist/tasks/run-and-wait-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-and-wait-task.d.ts","sourceRoot":"","sources":["../../src/tasks/run-and-wait-task.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAuBnD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,IAAI,CA2DN"}

package/dist/tasks/run-and-wait-task.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { StartRunParams, buildJsonToolResponse, WRITE_ANNOTATIONS, sanitizeResponse, getToolOutputSchema, } from "../coalesce/types.js";
+import { runAndWait } from "../workflows/run-and-wait.js";
+const RunAndWaitTaskInput = StartRunParams.extend({
+    pollInterval: z
+        .number()
+        .optional()
+        .describe("Seconds between status checks (default: 10, min: 5, max: 300)"),
+    timeout: z
+        .number()
+        .optional()
+        .describe("Max seconds to wait (default: 1800, min: 30, max: 3600)"),
+});
+export function registerRunAndWaitTask(server, client) {
+    server.experimental.tasks.registerToolTask("run_and_wait", {
+        title: "Run and Wait",
+        description: "Start a Coalesce refresh run and poll until completion or timeout. Returns a task that can be polled for status.\n\nRequires Snowflake Key Pair auth via environment variables. If the user provides a job name instead of an ID, look it up with list_environment_jobs first.\n\nArgs:\n  - runDetails.environmentID (string, required): Target environment\n  - runDetails.jobID (string, optional): Specific job to run\n  - runDetails.includeNodesSelector (string, optional): Node filter\n  - runDetails.excludeNodesSelector (string, optional): Node exclusion\n  - runDetails.parallelism (number, optional): Max parallel nodes\n  - runDetails.forceIgnoreWorkspaceStatus (boolean, optional): Force run\n  - confirmRunAllNodes (boolean): Required when no job/node scope\n  - parameters (object, optional): Runtime parameters\n  - pollInterval (number, optional): Seconds between checks (default: 10, range: 5–300)\n  - timeout (number, optional): Max wait seconds (default: 1800, range: 30–3600)\n\nReturns:\n  { status, results, resultsError?, incomplete?, timedOut? }\n\nInspect timedOut, incomplete, and resultsError fields before continuing.",
+        inputSchema: RunAndWaitTaskInput,
+        outputSchema: getToolOutputSchema("run_and_wait"),
+        annotations: WRITE_ANNOTATIONS,
+        execution: { taskSupport: "optional" },
+    }, {
+        async createTask(rawParams, extra) {
+            const params = rawParams;
+            const task = await extra.taskStore.createTask({
+                ttl: extra.taskRequestedTtl,
+                pollInterval: (params.pollInterval ?? 10) * 1000,
+            });
+            (async () => {
+                try {
+                    const result = await runAndWait(client, params, {
+                        signal: extra.signal,
+                    });
+                    const sanitized = sanitizeResponse(result);
+                    const response = buildJsonToolResponse("run_and_wait", sanitized);
+                    await extra.taskStore.storeTaskResult(task.taskId, "completed", response);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    await extra.taskStore.storeTaskResult(task.taskId, "failed", {
+                        content: [{ type: "text", text: `run_and_wait failed: ${message}` }],
+                        isError: true,
+                    });
+                }
+            })();
+            return { task };
+        },
+        async getTask(_params, extra) {
+            const task = await extra.taskStore.getTask(extra.taskId);
+            if (!task) {
+                throw new Error(`Task ${extra.taskId} not found`);
+            }
+            return task;
+        },
+        async getTaskResult(_params, extra) {
+            const result = await extra.taskStore.getTaskResult(extra.taskId);
+            return result;
+        },
+    });
+}
+//# sourceMappingURL=run-and-wait-task.js.map

package/dist/tasks/run-and-wait-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-and-wait-task.js","sourceRoot":"","sources":["../../src/tasks/run-and-wait-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,MAAM,mBAAmB,GAAG,cAAc,CAAC,MAAM,CAAC;IAChD,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC,CAAC;AAIH,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,MAAsB;IAEtB,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,gBAAgB,CACxC,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,inCAAinC;QACnnC,WAAW,EAAE,mBAAmB;QAChC,YAAY,EAAE,mBAAmB,CAAC,cAAc,CAAC;QACjD,WAAW,EAAE,iBAAiB;QAC9B,SAAS,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE;KACvC,EACD;QACE,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK;YAC/B,MAAM,MAAM,GAAG,SAA6B,CAAC;YAC7C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC;gBAC5C,GAAG,EAAE,KAAK,CAAC,gBAAgB;gBAC3B,YAAY,EAAE,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,GAAG,IAAI;aACjD,CAAC,CAAC;YAEH,CAAC,KAAK,IAAI,EAAE;gBACV,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE;wBAC9C,MAAM,EAAE,KAAK,CAAC,MAAM;qBACrB,CAAC,CAAC;oBACH,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;oBAC3C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;oBAClE,MAAM,KAAK,CAAC,SAAS,CAAC,eAAe,CACnC,IAAI,CAAC,MAAM,EACX,WAAW,EACX,QAAQ,CACT,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACzD,MAAM,KAAK,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE;wBAC3D,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,OAAO,EAAE,EAAE,CAAC;wBACpE,OAAO,EAAE,IAAI;qBACd,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;YAEL,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK;YAC1B,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,MAAM,YAAY,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK;YAChC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACjE,OAAO,MAAkD,CAAC;QAC5D,CAAC;KACF,CACF,CAAC;AACJ,CAAC"}

package/dist/tasks/start-run-task.d.ts

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

package/dist/tasks/start-run-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-run-task.d.ts","sourceRoot":"","sources":["../../src/tasks/start-run-task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAWnD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,IAAI,CAwDN"}

package/dist/tasks/start-run-task.js

@@ -0,0 +1,47 @@
+import { StartRunParams, buildJsonToolResponse, WRITE_ANNOTATIONS, sanitizeResponse, getToolOutputSchema, } from "../coalesce/types.js";
+import { startRun } from "../coalesce/api/runs.js";
+export function registerStartRunTask(server, client) {
+    server.experimental.tasks.registerToolTask("start_run", {
+        title: "Start Run",
+        description: "Start a new Coalesce refresh run. Returns a task that resolves once the run has been submitted.\n\nRequires Snowflake Key Pair auth — credentials are read from SNOWFLAKE_USERNAME, SNOWFLAKE_KEY_PAIR_KEY, SNOWFLAKE_WAREHOUSE, SNOWFLAKE_ROLE environment variables.\n\nRequires a numeric environmentID and optionally a jobID. If the user provides a job name, look up the ID with list_environment_jobs first.\n\nArgs:\n  - runDetails.environmentID (string, required): Target environment\n  - runDetails.jobID (string, optional): Specific job to run\n  - runDetails.includeNodesSelector (string, optional): Node filter for ad-hoc runs\n  - runDetails.excludeNodesSelector (string, optional): Node exclusion filter\n  - runDetails.parallelism (number, optional): Max parallel nodes (default: 16)\n  - runDetails.forceIgnoreWorkspaceStatus (boolean, optional): Allow run even if last deploy failed\n  - confirmRunAllNodes (boolean): Required when no job/node scope is provided\n  - parameters (object, optional): Key-value runtime parameters\n\nReturns:\n  { runCounter: number, runStatus: string, message: string }\n\nPrefer run_and_wait when you need the final outcome in a single call.",
+        inputSchema: StartRunParams,
+        outputSchema: getToolOutputSchema("start_run"),
+        annotations: WRITE_ANNOTATIONS,
+        execution: { taskSupport: "optional" },
+    }, {
+        async createTask(rawParams, extra) {
+            const params = rawParams;
+            const task = await extra.taskStore.createTask({
+                ttl: extra.taskRequestedTtl,
+            });
+            (async () => {
+                try {
+                    const result = await startRun(client, params);
+                    const sanitized = sanitizeResponse(result);
+                    const response = buildJsonToolResponse("start_run", sanitized);
+                    await extra.taskStore.storeTaskResult(task.taskId, "completed", response);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    await extra.taskStore.storeTaskResult(task.taskId, "failed", {
+                        content: [{ type: "text", text: `start_run failed: ${message}` }],
+                        isError: true,
+                    });
+                }
+            })();
+            return { task };
+        },
+        async getTask(_params, extra) {
+            const task = await extra.taskStore.getTask(extra.taskId);
+            if (!task) {
+                throw new Error(`Task ${extra.taskId} not found`);
+            }
+            return task;
+        },
+        async getTaskResult(_params, extra) {
+            const result = await extra.taskStore.getTaskResult(extra.taskId);
+            return result;
+        },
+    });
+}
+//# sourceMappingURL=start-run-task.js.map

package/dist/tasks/start-run-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-run-task.js","sourceRoot":"","sources":["../../src/tasks/start-run-task.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,EAEd,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,MAAsB;IAEtB,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,gBAAgB,CACxC,WAAW,EACX;QACE,KAAK,EAAE,WAAW;QAClB,WAAW,EACT,+pCAA+pC;QACjqC,WAAW,EAAE,cAAc;QAC3B,YAAY,EAAE,mBAAmB,CAAC,WAAW,CAAC;QAC9C,WAAW,EAAE,iBAAiB;QAC9B,SAAS,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE;KACvC,EACD;QACE,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK;YAC/B,MAAM,MAAM,GAAG,SAA0B,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC;gBAC5C,GAAG,EAAE,KAAK,CAAC,gBAAgB;aAC5B,CAAC,CAAC;YAEH,CAAC,KAAK,IAAI,EAAE;gBACV,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAC9C,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;oBAC3C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;oBAC/D,MAAM,KAAK,CAAC,SAAS,CAAC,eAAe,CACnC,IAAI,CAAC,MAAM,EACX,WAAW,EACX,QAAQ,CACT,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACzD,MAAM,KAAK,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE;wBAC3D,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,OAAO,EAAE,EAAE,CAAC;wBACjE,OAAO,EAAE,IAAI;qBACd,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;YAEL,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK;YAC1B,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,MAAM,YAAY,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK;YAChC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACjE,OAAO,MAAkD,CAAC;QAC5D,CAAC;KACF,CACF,CAAC;AACJ,CAAC"}

package/dist/tasks/store.d.ts

@@ -0,0 +1,2 @@
+export { InMemoryTaskStore, InMemoryTaskMessageQueue, } from "@modelcontextprotocol/sdk/experimental/tasks";
+//# sourceMappingURL=store.d.ts.map

package/dist/tasks/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/tasks/store.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,8CAA8C,CAAC"}

package/dist/tasks/store.js

@@ -0,0 +1,2 @@
+export { InMemoryTaskStore, InMemoryTaskMessageQueue, } from "@modelcontextprotocol/sdk/experimental/tasks";
+//# sourceMappingURL=store.js.map

package/dist/tasks/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/tasks/store.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,8CAA8C,CAAC"}

package/dist/utils.d.ts

@@ -9,8 +9,19 @@ export declare function isPlainObject(value: unknown): value is Record<string, u
  * propagate rather than being caught and silenced.
  */
 export declare function rethrowNonRecoverableApiError(error: unknown): void;
+/**
+ * Like {@link rethrowNonRecoverableApiError} but also rethrows on HTTP 500.
+ * Use in contexts where a server error indicates a broken session rather than
+ * a transient failure worth swallowing (e.g. node-type inventory fetches).
+ */
+export declare function rethrowNonRecoverableOrServerError(error: unknown): void;
 /**
  * Returns the first occurrence of each distinct item while preserving input order.
  */
 export declare function uniqueInOrder<T>(values: T[]): T[];
+/**
+ * Replaces characters unsafe for filenames with underscores.
+ * Used to sanitize workspace IDs and similar values for use in file paths.
+ */
+export declare function sanitizeForFilename(value: string): string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElC;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAIlE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAajD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElC;AAKD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAIlE;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAIvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAajD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/utils.js

@@ -6,13 +6,25 @@ import { CoalesceApiError } from "./client.js";
 export function isPlainObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+const NON_RECOVERABLE_STATUSES = [401, 403, 503];
+const NON_RECOVERABLE_WITH_SERVER_ERROR_STATUSES = [401, 403, 500, 503];
 /**
  * Re-throws CoalesceApiError for non-recoverable HTTP statuses (401, 403, 503).
  * These indicate auth failures or service unavailability that should
  * propagate rather than being caught and silenced.
  */
 export function rethrowNonRecoverableApiError(error) {
-    if (error instanceof CoalesceApiError && [401, 403, 503].includes(error.status)) {
+    if (error instanceof CoalesceApiError && NON_RECOVERABLE_STATUSES.includes(error.status)) {
+        throw error;
+    }
+}
+/**
+ * Like {@link rethrowNonRecoverableApiError} but also rethrows on HTTP 500.
+ * Use in contexts where a server error indicates a broken session rather than
+ * a transient failure worth swallowing (e.g. node-type inventory fetches).
+ */
+export function rethrowNonRecoverableOrServerError(error) {
+    if (error instanceof CoalesceApiError && NON_RECOVERABLE_WITH_SERVER_ERROR_STATUSES.includes(error.status)) {
         throw error;
     }
 }
@@ -31,4 +43,11 @@ export function uniqueInOrder(values) {
     }
     return unique;
 }
+/**
+ * Replaces characters unsafe for filenames with underscores.
+ * Used to sanitize workspace IDs and similar values for use in file paths.
+ */
+export function sanitizeForFilename(value) {
+    return value.replace(/[^a-zA-Z0-9_\-]/g, "_");
+}
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAc;IAC1D,IAAI,KAAK,YAAY,gBAAgB,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAChF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,MAAW;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAK,CAAC;IAC1B,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AACjD,MAAM,0CAA0C,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAExE;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAc;IAC1D,IAAI,KAAK,YAAY,gBAAgB,IAAI,wBAAwB,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAAC,KAAc;IAC/D,IAAI,KAAK,YAAY,gBAAgB,IAAI,0CAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3G,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,MAAW;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAK,CAAC;IAC1B,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC"}

package/dist/workflows/get-environment-health.d.ts

@@ -0,0 +1,49 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CoalesceClient } from "../client.js";
+import { type ToolDefinition } from "../coalesce/types.js";
+type HealthStatus = "healthy" | "warning" | "critical";
+type NodeRunStatus = {
+    nodeID: string;
+    nodeName: string;
+    lastRunStatus: "passed" | "failed" | "never_run";
+    lastRunTime?: string;
+};
+type FailedRunSummary = {
+    runID: string;
+    runStatus: string;
+    startTime: string;
+    endTime?: string;
+};
+type StaleNode = {
+    nodeID: string;
+    nodeName: string;
+    nodeType: string;
+    lastRunTime?: string;
+    daysSinceLastRun?: number;
+};
+type DependencyHealth = {
+    orphanNodes: Array<{
+        nodeID: string;
+        nodeName: string;
+        nodeType: string;
+    }>;
+    totalDependencyEdges: number;
+};
+export type EnvironmentHealthResult = {
+    environmentID: string;
+    assessedAt: string;
+    totalNodes: number;
+    nodesByType: Record<string, number>;
+    nodeRunStatus: NodeRunStatus[];
+    failedRunsLast24h: FailedRunSummary[];
+    staleNodes: StaleNode[];
+    dependencyHealth: DependencyHealth;
+    healthScore: HealthStatus;
+    healthReasons: string[];
+};
+export declare function getEnvironmentHealth(client: CoalesceClient, params: {
+    environmentID: string;
+}): Promise<EnvironmentHealthResult>;
+export declare function defineGetEnvironmentHealth(_server: McpServer, client: CoalesceClient): ToolDefinition[];
+export {};
+//# sourceMappingURL=get-environment-health.d.ts.map

package/dist/workflows/get-environment-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-environment-health.d.ts","sourceRoot":"","sources":["../../src/workflows/get-environment-health.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAKnD,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAO9B,KAAK,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAWvD,KAAK,aAAa,GAAG;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,WAAW,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,YAAY,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAwUF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA8ClC;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,GACrB,cAAc,EAAE,CAelB"}