coalesce-transform-mcp 0.2.3 → 0.4.1

package/dist/workflows/get-environment-health.js

@@ -0,0 +1,310 @@
+import { z } from "zod";
+import { fetchAllEnvironmentNodes, fetchAllRuns, } from "../services/cache/snapshots.js";
+import { READ_ONLY_ANNOTATIONS, validatePathSegment, } from "../coalesce/types.js";
+import { defineSimpleTool } from "../mcp/tool-helpers.js";
+import { isPlainObject } from "../utils.js";
+import { MS_PER_DAY } from "../constants.js";
+function extractNodes(items) {
+    return items.filter((item) => isPlainObject(item));
+}
+function extractRuns(items) {
+    return items.filter((item) => isPlainObject(item) && typeof item.id === "string");
+}
+function countNodesByType(nodes) {
+    const counts = {};
+    for (const node of nodes) {
+        const nodeType = typeof node.nodeType === "string" ? node.nodeType : "unknown";
+        counts[nodeType] = (counts[nodeType] ?? 0) + 1;
+    }
+    return counts;
+}
+function getNodeID(node) {
+    return typeof node.id === "string" ? node.id : String(node.id ?? "");
+}
+function getNodeName(node) {
+    return typeof node.name === "string" ? node.name : "unnamed";
+}
+function getNodeType(node) {
+    return typeof node.nodeType === "string" ? node.nodeType : "unknown";
+}
+function isTerminalRunStatus(status) {
+    return status === "completed" || status === "failed";
+}
+function isRunScoped(details) {
+    return (typeof details.jobID === "string" ||
+        typeof details.includeNodesSelector === "string" ||
+        typeof details.excludeNodesSelector === "string");
+}
+function getAttributedRunNodeIDs(run, allNodeIDs) {
+    if (!isTerminalRunStatus(run.runStatus)) {
+        return [];
+    }
+    const runTime = run.runEndTime ?? run.runStartTime;
+    if (typeof runTime !== "string") {
+        return [];
+    }
+    const details = isPlainObject(run.runDetails) ? run.runDetails : undefined;
+    if (!details) {
+        return [];
+    }
+    const nodes = Array.isArray(details.nodes) ? details.nodes : [];
+    const explicitNodeIDs = nodes.flatMap((node) => {
+        if (!isPlainObject(node) || typeof node.nodeID !== "string") {
+            return [];
+        }
+        return [node.nodeID];
+    });
+    if (explicitNodeIDs.length > 0) {
+        return explicitNodeIDs;
+    }
+    if (isRunScoped(details)) {
+        return [];
+    }
+    const nodesInRun = typeof details.nodesInRun === "number"
+        ? details.nodesInRun
+        : undefined;
+    if (nodesInRun === allNodeIDs.length) {
+        return allNodeIDs;
+    }
+    return [];
+}
+function buildNodeRunStatuses(nodes, runs) {
+    const nodeLastRun = new Map();
+    const allNodeIDs = nodes.map(getNodeID);
+    const knownNodeIDs = new Set(allNodeIDs);
+    for (const run of runs) {
+        if (!isTerminalRunStatus(run.runStatus)) {
+            continue;
+        }
+        const runTime = run.runEndTime ?? run.runStartTime;
+        if (!runTime || typeof runTime !== "string")
+            continue;
+        for (const nodeID of getAttributedRunNodeIDs(run, allNodeIDs)) {
+            if (!knownNodeIDs.has(nodeID))
+                continue;
+            const existing = nodeLastRun.get(nodeID);
+            if (!existing || runTime > existing.time) {
+                nodeLastRun.set(nodeID, { status: run.runStatus, time: runTime });
+            }
+        }
+    }
+    return nodes.map((node) => {
+        const nodeID = getNodeID(node);
+        const lastRun = nodeLastRun.get(nodeID);
+        if (!lastRun) {
+            return {
+                nodeID,
+                nodeName: getNodeName(node),
+                lastRunStatus: "never_run",
+            };
+        }
+        return {
+            nodeID,
+            nodeName: getNodeName(node),
+            lastRunStatus: lastRun.status === "completed" ? "passed" : "failed",
+            lastRunTime: lastRun.time,
+        };
+    });
+}
+function getFailedRunsLast24h(runs) {
+    const cutoff = new Date(Date.now() - MS_PER_DAY).toISOString();
+    return runs
+        .filter((run) => {
+        if (run.runStatus !== "failed")
+            return false;
+        const startTime = run.runStartTime;
+        return typeof startTime === "string" && startTime >= cutoff;
+    })
+        .map((run) => ({
+        runID: run.id,
+        runStatus: run.runStatus,
+        startTime: run.runStartTime,
+        endTime: typeof run.runEndTime === "string" ? run.runEndTime : undefined,
+    }));
+}
+function getStaleNodes(nodes, nodeRunStatuses, staleDays = 7) {
+    const cutoff = new Date(Date.now() - staleDays * MS_PER_DAY);
+    const stale = [];
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        const status = nodeRunStatuses[i];
+        if (status.lastRunStatus === "never_run") {
+            stale.push({
+                nodeID: getNodeID(node),
+                nodeName: getNodeName(node),
+                nodeType: getNodeType(node),
+            });
+            continue;
+        }
+        if (status.lastRunTime) {
+            const lastRunDate = new Date(status.lastRunTime);
+            if (lastRunDate < cutoff) {
+                const daysSince = Math.floor((Date.now() - lastRunDate.getTime()) / MS_PER_DAY);
+                stale.push({
+                    nodeID: getNodeID(node),
+                    nodeName: getNodeName(node),
+                    nodeType: getNodeType(node),
+                    lastRunTime: status.lastRunTime,
+                    daysSinceLastRun: daysSince,
+                });
+            }
+        }
+    }
+    return stale;
+}
+function analyzeDependencyHealth(nodes) {
+    const nodeIDs = new Set(nodes.map(getNodeID));
+    const referencedNodes = new Set();
+    const edgeKeys = new Set();
+    const nodesWithUpstream = new Set();
+    for (const node of nodes) {
+        const nodeID = getNodeID(node);
+        const predecessors = node.predecessorNodeIDs;
+        if (Array.isArray(predecessors) && predecessors.length > 0) {
+            nodesWithUpstream.add(nodeID);
+        }
+        const metadata = node.metadata;
+        if (isPlainObject(metadata)) {
+            const sourceMapping = metadata.sourceMapping;
+            if (Array.isArray(sourceMapping) && sourceMapping.length > 0) {
+                nodesWithUpstream.add(nodeID);
+            }
+            if (Array.isArray(sourceMapping)) {
+                for (const mapping of sourceMapping) {
+                    if (!isPlainObject(mapping))
+                        continue;
+                    const aliases = isPlainObject(mapping.aliases) ? mapping.aliases : {};
+                    for (const value of Object.values(aliases)) {
+                        if (typeof value === "string" && nodeIDs.has(value)) {
+                            referencedNodes.add(value);
+                            edgeKeys.add(`${value}->${nodeID}`);
+                        }
+                    }
+                    const deps = Array.isArray(mapping.dependencies)
+                        ? mapping.dependencies
+                        : [];
+                    for (const dep of deps) {
+                        if (typeof dep === "string" && nodeIDs.has(dep)) {
+                            referencedNodes.add(dep);
+                            edgeKeys.add(`${dep}->${nodeID}`);
+                        }
+                        else if (isPlainObject(dep) &&
+                            typeof dep.nodeID === "string" &&
+                            nodeIDs.has(dep.nodeID)) {
+                            referencedNodes.add(dep.nodeID);
+                            edgeKeys.add(`${dep.nodeID}->${nodeID}`);
+                        }
+                    }
+                }
+            }
+        }
+        if (Array.isArray(predecessors)) {
+            for (const pred of predecessors) {
+                if (typeof pred === "string" && nodeIDs.has(pred)) {
+                    referencedNodes.add(pred);
+                    edgeKeys.add(`${pred}->${nodeID}`);
+                }
+            }
+        }
+    }
+    const orphanNodes = nodes
+        .filter((node) => {
+        const id = getNodeID(node);
+        return !referencedNodes.has(id) && !nodesWithUpstream.has(id);
+    })
+        .map((node) => ({
+        nodeID: getNodeID(node),
+        nodeName: getNodeName(node),
+        nodeType: getNodeType(node),
+    }));
+    return { orphanNodes, totalDependencyEdges: edgeKeys.size };
+}
+function computeHealthScore(totalNodes, failedRunsLast24h, staleNodes, dependencyHealth, nodeRunStatuses) {
+    const reasons = [];
+    if (totalNodes === 0) {
+        return { score: "warning", reasons: ["Environment has no deployed nodes"] };
+    }
+    const failedCount = failedRunsLast24h.length;
+    const staleCount = staleNodes.length;
+    const orphanCount = dependencyHealth.orphanNodes.length;
+    const neverRunCount = nodeRunStatuses.filter((s) => s.lastRunStatus === "never_run").length;
+    const failedNodeCount = nodeRunStatuses.filter((s) => s.lastRunStatus === "failed").length;
+    if (failedCount > 0) {
+        reasons.push(`${failedCount} failed ${failedCount === 1 ? "run" : "runs"} in the last 24 hours`);
+    }
+    if (failedNodeCount > 0) {
+        reasons.push(`${failedNodeCount}/${totalNodes} nodes have a failed last run`);
+    }
+    if (staleCount > 0) {
+        reasons.push(`${staleCount} stale node(s) not run in 7+ days`);
+    }
+    if (orphanCount > 0) {
+        reasons.push(`${orphanCount} orphan node(s) with no upstream or downstream connections`);
+    }
+    if (neverRunCount > 0) {
+        reasons.push(`${neverRunCount} node(s) have never been run`);
+    }
+    if (reasons.length === 0) {
+        reasons.push("All nodes healthy, no recent failures");
+    }
+    const hasCritical = failedCount >= 3 || failedNodeCount > totalNodes * 0.5;
+    const hasWarning = failedCount > 0 ||
+        staleCount > 0 ||
+        orphanCount > 0 ||
+        neverRunCount > 0;
+    const score = hasCritical
+        ? "critical"
+        : hasWarning
+            ? "warning"
+            : "healthy";
+    return { score, reasons };
+}
+export async function getEnvironmentHealth(client, params) {
+    const environmentID = validatePathSegment(params.environmentID, "environmentID");
+    const [nodesResult, runsResult] = await Promise.all([
+        fetchAllEnvironmentNodes(client, { environmentID, detail: true }),
+        fetchAllRuns(client, {
+            environmentID,
+            detail: true,
+            orderBy: "id",
+            orderByDirection: "desc",
+        }),
+    ]);
+    const nodes = extractNodes(nodesResult.items);
+    const runs = extractRuns(runsResult.items);
+    const assessedAt = new Date().toISOString();
+    const nodesByType = countNodesByType(nodes);
+    const nodeRunStatuses = buildNodeRunStatuses(nodes, runs);
+    const failedRunsLast24h = getFailedRunsLast24h(runs);
+    const staleNodes = getStaleNodes(nodes, nodeRunStatuses);
+    const dependencyHealth = analyzeDependencyHealth(nodes);
+    const { score, reasons } = computeHealthScore(nodes.length, failedRunsLast24h, staleNodes, dependencyHealth, nodeRunStatuses);
+    return {
+        environmentID,
+        assessedAt,
+        totalNodes: nodes.length,
+        nodesByType,
+        nodeRunStatus: nodeRunStatuses,
+        failedRunsLast24h,
+        staleNodes,
+        dependencyHealth,
+        healthScore: score,
+        healthReasons: reasons,
+    };
+}
+export function defineGetEnvironmentHealth(_server, client) {
+    return [
+        defineSimpleTool(client, "get_environment_health", {
+            title: "Get Environment Health",
+            description: "Get a comprehensive health dashboard for a deployed environment. Composes multiple API calls into a single health summary.\n\nThis tool paginates through all environment nodes and all environment runs before scoring health, so it may take longer on large or busy environments.\n\nArgs:\n  - environmentID (string, required): The environment ID\n\nReturns:\n  {\n    environmentID, assessedAt, totalNodes,\n    nodesByType: { Stage: 5, Dimension: 3, ... },\n    nodeRunStatus: [{ nodeID, nodeName, lastRunStatus, lastRunTime }],\n    failedRunsLast24h: [{ runID, runStatus, startTime, endTime }],\n    staleNodes: [{ nodeID, nodeName, nodeType, lastRunTime, daysSinceLastRun }],\n    dependencyHealth: { orphanNodes: [...], totalDependencyEdges },\n    healthScore: \"healthy\" | \"warning\" | \"critical\",\n    healthReasons: [\"...\"]\n  }",
+            inputSchema: z.object({
+                environmentID: z
+                    .string()
+                    .describe("The environment ID to assess health for"),
+            }),
+            annotations: READ_ONLY_ANNOTATIONS,
+            sanitize: true,
+        }, getEnvironmentHealth),
+    ];
+}
+//# sourceMappingURL=get-environment-health.js.map

package/dist/workflows/get-environment-health.js.map

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

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

@@ -1,10 +1,11 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { CoalesceClient } from "../client.js";
+import { type ToolDefinition } from "../coalesce/types.js";
 export declare function getEnvironmentOverview(client: CoalesceClient, params: {
     environmentID: string;
 }): Promise<{
     environment: unknown;
     nodes: unknown[];
 }>;
-export declare function registerGetEnvironmentOverview(server: McpServer, client: CoalesceClient): void;
+export declare function defineGetEnvironmentOverview(_server: McpServer, client: CoalesceClient): ToolDefinition[];
 //# sourceMappingURL=get-environment-overview.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-environment-overview.d.ts","sourceRoot":"","sources":["../../src/workflows/get-environment-overview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAUnD,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CAUrD;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAsB9F"}
+{"version":3,"file":"get-environment-overview.d.ts","sourceRoot":"","sources":["../../src/workflows/get-environment-overview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAG9B,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CAUrD;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,cAAc,EAAE,CAYzG"}

package/dist/workflows/get-environment-overview.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { fetchAllEnvironmentNodes } from "../services/cache/snapshots.js";
-import { READ_ONLY_ANNOTATIONS, buildJsonToolResponse, validatePathSegment, handleToolError, getToolOutputSchema, } from "../coalesce/types.js";
+import { READ_ONLY_ANNOTATIONS, validatePathSegment, } from "../coalesce/types.js";
+import { defineSimpleTool } from "../mcp/tool-helpers.js";
 export async function getEnvironmentOverview(client, params) {
     const environmentID = validatePathSegment(params.environmentID, "environmentID");
     const basePath = `/api/v1/environments/${environmentID}`;
@@ -10,23 +11,16 @@ export async function getEnvironmentOverview(client, params) {
     ]);
     return { environment, nodes: nodes.items };
 }
-export function registerGetEnvironmentOverview(server, client) {
-    server.registerTool("get_environment_overview", {
-        title: "Get Environment Overview",
-        description: "Get environment details and all its deployed nodes in a single call.\n\nArgs:\n  - environmentID (string, required): The environment ID\n\nReturns:\n  { environment: EnvironmentObject, nodes: NodeObject[] }",
-        inputSchema: z.object({
-            environmentID: z.string().describe("The environment ID"),
-        }),
-        outputSchema: getToolOutputSchema("get_environment_overview"),
-        annotations: READ_ONLY_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await getEnvironmentOverview(client, params);
-            return buildJsonToolResponse("get_environment_overview", result);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
+export function defineGetEnvironmentOverview(_server, client) {
+    return [
+        defineSimpleTool(client, "get_environment_overview", {
+            title: "Get Environment Overview",
+            description: "Get environment details and all its deployed nodes in a single call.\n\nArgs:\n  - environmentID (string, required): The environment ID\n\nReturns:\n  { environment: EnvironmentObject, nodes: NodeObject[] }",
+            inputSchema: z.object({
+                environmentID: z.string().describe("The environment ID"),
+            }),
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, getEnvironmentOverview),
+    ];
 }
 //# sourceMappingURL=get-environment-overview.js.map

package/dist/workflows/get-environment-overview.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-environment-overview.js","sourceRoot":"","sources":["../../src/workflows/get-environment-overview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAsB,EACtB,MAAiC;IAEjC,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,wBAAwB,aAAa,EAAE,CAAC;IAEzD,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACpB,wBAAwB,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC;KACpD,CAAC,CAAC;IAEH,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAAiB,EAAE,MAAsB;IACtF,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,gNAAgN;QAClN,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;SACzD,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;AACJ,CAAC"}
+{"version":3,"file":"get-environment-overview.js","sourceRoot":"","sources":["../../src/workflows/get-environment-overview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GAEpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAsB,EACtB,MAAiC;IAEjC,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,wBAAwB,aAAa,EAAE,CAAC;IAEzD,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACpB,wBAAwB,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC;KACpD,CAAC,CAAC;IAEH,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAkB,EAAE,MAAsB;IACrF,OAAO;QACL,gBAAgB,CAAC,MAAM,EAAE,0BAA0B,EAAE;YACnD,KAAK,EAAE,0BAA0B;YACjC,WAAW,EACT,gNAAgN;YAClN,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;aACzD,CAAC;YACF,WAAW,EAAE,qBAAqB;SACnC,EAAE,sBAAsB,CAAC;KAC3B,CAAC;AACJ,CAAC"}

package/dist/workflows/get-run-details.d.ts

@@ -1,6 +1,6 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { CoalesceClient } from "../client.js";
-import { type JsonToolError } from "../coalesce/types.js";
+import { type JsonToolError, type ToolDefinition } from "../coalesce/types.js";
 export declare function getRunDetails(client: CoalesceClient, params: {
     runID: string;
 }): Promise<{
@@ -8,5 +8,5 @@ export declare function getRunDetails(client: CoalesceClient, params: {
     results: unknown;
     resultsError?: JsonToolError;
 }>;
-export declare function registerGetRunDetails(server: McpServer, client: CoalesceClient): void;
+export declare function defineGetRunDetails(_server: McpServer, client: CoalesceClient): ToolDefinition[];
 //# sourceMappingURL=get-run-details.d.ts.map

package/dist/workflows/get-run-details.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-run-details.d.ts","sourceRoot":"","sources":["../../src/workflows/get-run-details.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAG9B,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,CAqB3E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAsBrF"}
+{"version":3,"file":"get-run-details.d.ts","sourceRoot":"","sources":["../../src/workflows/get-run-details.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAI9B,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,CAqB3E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,cAAc,EAAE,CAahG"}

package/dist/workflows/get-run-details.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
-import { READ_ONLY_ANNOTATIONS, buildJsonToolResponse, sanitizeResponse, validatePathSegment, handleToolError, getToolOutputSchema, } from "../coalesce/types.js";
+import { READ_ONLY_ANNOTATIONS, validatePathSegment, } from "../coalesce/types.js";
 import { serializeResultsError } from "./progress.js";
+import { defineSimpleTool } from "../mcp/tool-helpers.js";
 export async function getRunDetails(client, params) {
     const validRunID = validatePathSegment(params.runID, "runID");
     let run;
@@ -16,23 +17,17 @@ export async function getRunDetails(client, params) {
         ? { run, results: null, resultsError }
         : { run, results };
 }
-export function registerGetRunDetails(server, client) {
-    server.registerTool("get_run_details", {
-        title: "Get Run Details",
-        description: "Get run metadata and execution results in a single call. Combines get_run and get_run_results.\n\nArgs:\n  - runID (string, required): Numeric run ID (integer). Use runCounter, not the UUID.\n\nReturns:\n  { run: RunObject, results: ResultsObject, resultsError?: ErrorObject }",
-        inputSchema: z.object({
-            runID: z.string().describe("The numeric run ID (integer, e.g. '401'). Use the runCounter value from start_run or run_status responses — not the UUID from run URLs."),
-        }),
-        outputSchema: getToolOutputSchema("get_run_details"),
-        annotations: READ_ONLY_ANNOTATIONS,
-    }, async (params) => {
-        try {
-            const result = await getRunDetails(client, params);
-            return buildJsonToolResponse("get_run_details", sanitizeResponse(result));
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
+export function defineGetRunDetails(_server, client) {
+    return [
+        defineSimpleTool(client, "get_run_details", {
+            title: "Get Run Details",
+            description: "Get run metadata and execution results in a single call. Combines get_run and get_run_results.\n\nArgs:\n  - runID (string, required): Numeric run ID (integer). Use runCounter, not the UUID.\n\nReturns:\n  { run: RunObject, results: ResultsObject, resultsError?: ErrorObject }",
+            inputSchema: z.object({
+                runID: z.string().describe("The numeric run ID (integer, e.g. '401'). Use the runCounter value from start_run or run_status responses — not the UUID from run URLs."),
+            }),
+            annotations: READ_ONLY_ANNOTATIONS,
+            sanitize: true,
+        }, getRunDetails),
+    ];
 }
 //# sourceMappingURL=get-run-details.js.map

package/dist/workflows/get-run-details.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-run-details.js","sourceRoot":"","sources":["../../src/workflows/get-run-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,GAEpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAsB,EACtB,MAAyB;IAEzB,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAE9D,IAAI,GAAY,CAAC;IACjB,IAAI,OAAO,GAAY,IAAI,CAAC;IAC5B,IAAI,YAAuC,CAAC;IAE5C,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,UAAU,EAAE,CAAC,CAAC;IAC5D,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,UAAU,UAAU,CAAC,CAAC;IAExE,CAAC,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxB,UAAU;QACV,cAAc,CAAC,IAAI,CACjB,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,EAC7B,CAAC,KAAK,EAAE,EAAE,GAAG,YAAY,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAC5D;KACF,CAAC,CAAC;IAEH,OAAO,YAAY,KAAK,SAAS;QAC/B,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE;QACtC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAsB;IAC7E,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,sRAAsR;QACxR,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yIAAyI,CAAC;SACtK,CAAC;QACF,YAAY,EAAE,mBAAmB,CAAC,iBAAiB,CAAC;QACpD,WAAW,EAAE,qBAAqB;KACnC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACnD,OAAO,qBAAqB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-run-details.js","sourceRoot":"","sources":["../../src/workflows/get-run-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GAGpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAsB,EACtB,MAAyB;IAEzB,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAE9D,IAAI,GAAY,CAAC;IACjB,IAAI,OAAO,GAAY,IAAI,CAAC;IAC5B,IAAI,YAAuC,CAAC;IAE5C,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,UAAU,EAAE,CAAC,CAAC;IAC5D,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,UAAU,UAAU,CAAC,CAAC;IAExE,CAAC,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxB,UAAU;QACV,cAAc,CAAC,IAAI,CACjB,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,EAC7B,CAAC,KAAK,EAAE,EAAE,GAAG,YAAY,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAC5D;KACF,CAAC,CAAC;IAEH,OAAO,YAAY,KAAK,SAAS;QAC/B,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE;QACtC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAkB,EAAE,MAAsB;IAC5E,OAAO;QACL,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE;YAC1C,KAAK,EAAE,iBAAiB;YACxB,WAAW,EACT,sRAAsR;YACxR,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yIAAyI,CAAC;aACtK,CAAC;YACF,WAAW,EAAE,qBAAqB;YAClC,QAAQ,EAAE,IAAI;SACf,EAAE,aAAa,CAAC;KAClB,CAAC;AACJ,CAAC"}

package/dist/workflows/poll-run.d.ts

@@ -0,0 +1,14 @@
+import { type CoalesceClient } from "../client.js";
+import { type WorkflowProgressReporter } from "./progress.js";
+export interface PollRunOptions {
+    client: CoalesceClient;
+    runCounter: number;
+    label: string;
+    pollIntervalMs: number;
+    timeoutMs: number;
+    startedAt: number;
+    signal?: AbortSignal;
+    reportProgress?: WorkflowProgressReporter;
+}
+export declare function pollRunToCompletion(opts: PollRunOptions): Promise<unknown>;
+//# sourceMappingURL=poll-run.d.ts.map

package/dist/workflows/poll-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll-run.d.ts","sourceRoot":"","sources":["../../src/workflows/poll-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,eAAe,CAAC;AAOvB,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,cAAc,CAAC,EAAE,wBAAwB,CAAC;CAC3C;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CA0GhF"}

package/dist/workflows/poll-run.js

@@ -0,0 +1,86 @@
+import { CoalesceApiError } from "../client.js";
+import { remainingTimeMs, serializeResultsError, sleepWithAbort, } from "./progress.js";
+import { formatRunStatusForMessage, isTerminalRunStatus, validateRunStatus, } from "./run-status.js";
+export async function pollRunToCompletion(opts) {
+    const { client, runCounter, label, pollIntervalMs, timeoutMs, startedAt, signal, reportProgress } = opts;
+    let lastStatus = null;
+    let pollCount = 0;
+    while (remainingTimeMs(startedAt, timeoutMs) > 0) {
+        const nextPollDelay = Math.min(pollIntervalMs, remainingTimeMs(startedAt, timeoutMs));
+        await sleepWithAbort(nextPollDelay, signal);
+        const statusTimeoutMs = remainingTimeMs(startedAt, timeoutMs);
+        if (statusTimeoutMs <= 0) {
+            break;
+        }
+        let status;
+        try {
+            status = (await client.get("/scheduler/runStatus", { runCounter }, { timeoutMs: statusTimeoutMs, signal }));
+        }
+        catch (error) {
+            if (error instanceof CoalesceApiError && error.status === 408) {
+                pollCount += 1;
+                await reportProgress?.(`Status check ${pollCount} for ${label} ${runCounter} timed out. Retrying while time remains.`);
+                continue;
+            }
+            throw error;
+        }
+        lastStatus = status;
+        pollCount += 1;
+        const runStatus = status.runStatus;
+        await reportProgress?.(`Status check ${pollCount} for ${label} ${runCounter}: ${formatRunStatusForMessage(runStatus)}.`);
+        const validatedRunStatus = validateRunStatus(runCounter, runStatus);
+        if (isTerminalRunStatus(validatedRunStatus)) {
+            await reportProgress?.(`${capitalize(label)} ${runCounter} reached terminal status ${validatedRunStatus}. Fetching results.`);
+            const resultsTimeoutMs = remainingTimeMs(startedAt, timeoutMs);
+            if (resultsTimeoutMs <= 0) {
+                await reportProgress?.(`Workflow deadline reached before results could be fetched for ${label} ${runCounter}.`);
+                return {
+                    status,
+                    results: null,
+                    resultsError: {
+                        message: "Workflow timeout reached before run results could be fetched",
+                        status: 408,
+                    },
+                    incomplete: true,
+                };
+            }
+            try {
+                const results = await client.get(`/api/v1/runs/${runCounter}/results`, undefined, { timeoutMs: resultsTimeoutMs, signal });
+                await reportProgress?.(`Fetched results for ${label} ${runCounter}.`);
+                return { status, results };
+            }
+            catch (error) {
+                const serializedError = serializeResultsError(error);
+                await reportProgress?.(`${capitalize(label)} ${runCounter} finished, but fetching results failed: ${serializedError.message}.`);
+                return {
+                    status,
+                    results: null,
+                    resultsError: serializedError,
+                    incomplete: true,
+                };
+            }
+        }
+    }
+    // Timeout — return last known status
+    let finalStatus = lastStatus;
+    const finalStatusTimeoutMs = remainingTimeMs(startedAt, timeoutMs);
+    if (finalStatusTimeoutMs > 0) {
+        try {
+            finalStatus = await client.get("/scheduler/runStatus", { runCounter }, { timeoutMs: finalStatusTimeoutMs, signal });
+        }
+        catch (error) {
+            if (!(error instanceof CoalesceApiError && error.status === 408)) {
+                throw error;
+            }
+        }
+    }
+    if (finalStatus && typeof finalStatus === "object") {
+        validateRunStatus(runCounter, finalStatus.runStatus);
+    }
+    await reportProgress?.(`Timed out waiting for ${label} ${runCounter}. Returning the last known status.`);
+    return { status: finalStatus, results: null, timedOut: true };
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=poll-run.js.map

package/dist/workflows/poll-run.js.map

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

package/dist/workflows/progress.d.ts

@@ -21,6 +21,7 @@ export type WorkflowProgressExtra = {
     sendNotification?: (notification: WorkflowProgressNotification) => Promise<void>;
 };
 export type WorkflowProgressReporter = (message: string, total?: number) => Promise<void>;
+export declare function isAbortError(error: unknown): boolean;
 export declare function throwIfAborted(signal?: AbortSignal): void;
 export declare function sleepWithAbort(ms: number, signal?: AbortSignal): Promise<void>;
 export declare function createWorkflowProgressReporter(extra?: WorkflowProgressExtra): WorkflowProgressReporter | undefined;

package/dist/workflows/progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/workflows/progress.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAY5G;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;QAC/B,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KACjC,CAAC;IACF,gBAAgB,CAAC,EAAE,CACjB,YAAY,EAAE,4BAA4B,KACvC,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,KACX,OAAO,CAAC,IAAI,CAAC,CAAC;AAQnB,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAIzD;AAED,wBAAsB,cAAc,CAClC,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,CAAC,EAAE,qBAAqB,GAC5B,wBAAwB,GAAG,SAAS,CA6BtC"}
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/workflows/progress.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAY5G;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;QAC/B,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KACjC,CAAC;IACF,gBAAgB,CAAC,EAAE,CACjB,YAAY,EAAE,4BAA4B,KACvC,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,KACX,OAAO,CAAC,IAAI,CAAC,CAAC;AAQnB,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD;AAED,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAIzD;AAED,wBAAsB,cAAc,CAClC,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,CAAC,EAAE,qBAAqB,GAC5B,wBAAwB,GAAG,SAAS,CA6BtC"}

package/dist/workflows/progress.js

@@ -20,6 +20,9 @@ function createAbortError() {
     error.name = "AbortError";
     return error;
 }
+export function isAbortError(error) {
+    return error instanceof Error && error.name === "AbortError";
+}
 export function throwIfAborted(signal) {
     if (signal?.aborted) {
         throw createAbortError();