@sonisoft/now-sdk-ext-mcp 1.0.0 → 2.2.0

package/dist/tools/flow.js

@@ -0,0 +1,436 @@
+import { z } from "zod";
+import { FlowManager } from "@sonisoft/now-sdk-ext-core";
+import { withConnectionRetry } from "../common/connection.js";
+/**
+ * Instance parameter description shared across flow tools.
+ */
+const INSTANCE_DESC = "The ServiceNow instance auth alias to use. " +
+    'This is the alias configured via `now-sdk auth --add` (e.g., "dev224436", "prod", "test"). ' +
+    'The user will typically refer to this by name when saying things like "on my dev224436 instance". ' +
+    "If not provided, falls back to the SN_AUTH_ALIAS environment variable.";
+/**
+ * Shared Zod schema fragments for execution parameters common to all
+ * execute_flow / execute_subflow / execute_action tools.
+ */
+const executionInputSchema = {
+    instance: z.string().optional().describe(INSTANCE_DESC),
+    scoped_name: z
+        .string()
+        .describe('Scoped name of the flow/subflow/action to execute (e.g., "global.my_flow", ' +
+        '"x_myapp_custom.create_incident_subflow").'),
+    inputs: z
+        .record(z.unknown())
+        .optional()
+        .describe("Input name-value pairs to pass to the flow/subflow/action. " +
+        "Keys are the input variable names defined in Flow Designer."),
+    mode: z
+        .enum(["foreground", "background"])
+        .optional()
+        .describe('Execution mode. "foreground" (default) runs synchronously and returns outputs ' +
+        "when complete. " +
+        '"background" returns immediately with a context ID — use get_flow_context_status ' +
+        "to poll, then get_flow_outputs or get_flow_error to retrieve results. " +
+        "Use background for flows with approval/wait steps."),
+    timeout: z
+        .number()
+        .optional()
+        .describe("Timeout in milliseconds for the execution. " +
+        "Only applies to foreground mode. Default is the ServiceNow server default (~30s)."),
+    quick: z
+        .boolean()
+        .optional()
+        .describe("Skip creation of execution detail records for better performance. " +
+        "Default false. Use true in CI/CD or when you don't need step-level detail."),
+    scope: z
+        .string()
+        .optional()
+        .describe("Scope context for script execution. Can be a scope name " +
+        '(e.g., "x_myapp_custom") or sys_id. Use when the flow is in a scoped app.'),
+};
+/**
+ * Format a FlowExecutionResult into human-readable text output.
+ */
+function formatExecutionResult(result) {
+    const lines = [];
+    lines.push(`=== Flow Execution Result ===`);
+    lines.push(`Success: ${result.success}`);
+    lines.push(`Type: ${result.flowObjectType}`);
+    lines.push(`Name: ${result.flowObjectName}`);
+    if (result.contextId) {
+        lines.push(`Context ID: ${result.contextId}`);
+    }
+    if (result.executionDate) {
+        lines.push(`Execution Date: ${result.executionDate}`);
+    }
+    if (result.errorMessage) {
+        lines.push(`Error: ${result.errorMessage}`);
+    }
+    if (result.outputs && Object.keys(result.outputs).length > 0) {
+        lines.push("");
+        lines.push("Outputs:");
+        lines.push(JSON.stringify(result.outputs, null, 2));
+    }
+    if (result.debugOutput) {
+        lines.push("");
+        lines.push("Debug Output:");
+        lines.push(result.debugOutput);
+    }
+    return lines.join("\n");
+}
+// ============================================================
+// 1. execute_flow
+// ============================================================
+export function registerExecuteFlowTool(server) {
+    server.registerTool("execute_flow", {
+        title: "Execute Flow",
+        description: "Execute a ServiceNow Flow Designer flow by scoped name. " +
+            "Runs the flow using sn_fd.FlowAPI via a background script.\n\n" +
+            "In foreground mode (default), the call blocks until the flow completes and " +
+            "returns outputs directly. In background mode, it returns immediately with a " +
+            "context ID that you can poll with get_flow_context_status.\n\n" +
+            "IMPORTANT: Flows with approval or wait steps MUST use background mode — " +
+            "foreground mode will fail if the flow enters a waiting state.",
+        inputSchema: executionInputSchema,
+    }, async ({ instance, scoped_name, inputs, mode, timeout, quick, scope }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const mgr = new FlowManager(snInstance, scope);
+                return await mgr.executeFlow({
+                    scopedName: scoped_name,
+                    inputs,
+                    mode,
+                    timeout,
+                    quick,
+                    scope,
+                });
+            });
+            return {
+                content: [
+                    { type: "text", text: formatExecutionResult(result) },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    { type: "text", text: `Error executing flow: ${message}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+// ============================================================
+// 2. execute_subflow
+// ============================================================
+export function registerExecuteSubflowTool(server) {
+    server.registerTool("execute_subflow", {
+        title: "Execute Subflow",
+        description: "Execute a ServiceNow Flow Designer subflow by scoped name. " +
+            "Subflows are reusable building blocks in Flow Designer — this is the " +
+            "primary tool for testing subflows during development.\n\n" +
+            "In foreground mode (default), the call blocks until the subflow completes " +
+            "and returns outputs directly. In background mode, it returns a context ID " +
+            "for polling with get_flow_context_status.\n\n" +
+            "Pass inputs as key-value pairs matching the subflow's input variables.",
+        inputSchema: executionInputSchema,
+    }, async ({ instance, scoped_name, inputs, mode, timeout, quick, scope }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const mgr = new FlowManager(snInstance, scope);
+                return await mgr.executeSubflow({
+                    scopedName: scoped_name,
+                    inputs,
+                    mode,
+                    timeout,
+                    quick,
+                    scope,
+                });
+            });
+            return {
+                content: [
+                    { type: "text", text: formatExecutionResult(result) },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error executing subflow: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+// ============================================================
+// 3. execute_action
+// ============================================================
+export function registerExecuteActionTool(server) {
+    server.registerTool("execute_action", {
+        title: "Execute Action",
+        description: "Execute a ServiceNow Flow Designer action by scoped name. " +
+            "Actions are the lowest-level building blocks in Flow Designer " +
+            "(e.g., lookup record, create task, send notification).\n\n" +
+            "In foreground mode (default), the call blocks until the action completes " +
+            "and returns outputs directly. Actions typically complete quickly and " +
+            "foreground mode is usually appropriate.",
+        inputSchema: executionInputSchema,
+    }, async ({ instance, scoped_name, inputs, mode, timeout, quick, scope }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const mgr = new FlowManager(snInstance, scope);
+                return await mgr.executeAction({
+                    scopedName: scoped_name,
+                    inputs,
+                    mode,
+                    timeout,
+                    quick,
+                    scope,
+                });
+            });
+            return {
+                content: [
+                    { type: "text", text: formatExecutionResult(result) },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error executing action: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+// ============================================================
+// 4. get_flow_context_status
+// ============================================================
+export function registerGetFlowContextStatusTool(server) {
+    server.registerTool("get_flow_context_status", {
+        title: "Get Flow Context Status",
+        description: "Query the current status of a flow execution by its context ID. " +
+            "Use this to poll background flow executions started with execute_flow, " +
+            "execute_subflow, or execute_action in background mode.\n\n" +
+            "Possible states: QUEUED, IN_PROGRESS, WAITING, COMPLETE, CANCELLED, ERROR.\n\n" +
+            "Typical pattern: execute in background -> poll this tool every few seconds -> " +
+            "once COMPLETE, call get_flow_outputs. If ERROR, call get_flow_error.",
+        inputSchema: {
+            instance: z.string().optional().describe(INSTANCE_DESC),
+            context_id: z
+                .string()
+                .describe("The flow context sys_id returned from an execute_flow, " +
+                "execute_subflow, or execute_action call (the contextId field)."),
+        },
+    }, async ({ instance, context_id }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const mgr = new FlowManager(snInstance);
+                return await mgr.getFlowContextStatus(context_id);
+            });
+            const lines = [];
+            lines.push("=== Flow Context Status ===");
+            lines.push(`Context ID: ${result.contextId}`);
+            lines.push(`Found: ${result.found}`);
+            if (result.found) {
+                lines.push(`State: ${result.state}`);
+                if (result.name)
+                    lines.push(`Name: ${result.name}`);
+                if (result.started)
+                    lines.push(`Started: ${result.started}`);
+                if (result.ended)
+                    lines.push(`Ended: ${result.ended}`);
+            }
+            if (result.errorMessage) {
+                lines.push(`Error: ${result.errorMessage}`);
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting flow context status: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+// ============================================================
+// 5. get_flow_outputs
+// ============================================================
+export function registerGetFlowOutputsTool(server) {
+    server.registerTool("get_flow_outputs", {
+        title: "Get Flow Outputs",
+        description: "Retrieve outputs from a completed flow/subflow/action execution by its " +
+            "context ID. Only call this after get_flow_context_status shows COMPLETE.\n\n" +
+            "Returns the output name-value pairs defined by the flow/subflow/action.",
+        inputSchema: {
+            instance: z.string().optional().describe(INSTANCE_DESC),
+            context_id: z
+                .string()
+                .describe("The flow context sys_id from the execution result's contextId field."),
+        },
+    }, async ({ instance, context_id }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const mgr = new FlowManager(snInstance);
+                return await mgr.getFlowOutputs(context_id);
+            });
+            const lines = [];
+            lines.push("=== Flow Outputs ===");
+            lines.push(`Context ID: ${result.contextId}`);
+            lines.push(`Success: ${result.success}`);
+            if (result.outputs && Object.keys(result.outputs).length > 0) {
+                lines.push("");
+                lines.push("Outputs:");
+                lines.push(JSON.stringify(result.outputs, null, 2));
+            }
+            else {
+                lines.push("\nNo outputs returned.");
+            }
+            if (result.errorMessage) {
+                lines.push(`\nError: ${result.errorMessage}`);
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting flow outputs: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+// ============================================================
+// 6. get_flow_error
+// ============================================================
+export function registerGetFlowErrorTool(server) {
+    server.registerTool("get_flow_error", {
+        title: "Get Flow Error",
+        description: "Retrieve the error message from a failed flow execution by its context ID. " +
+            "Call this after get_flow_context_status shows ERROR to understand why the " +
+            "flow failed.\n\n" +
+            "Returns the flow's error message which can be used to diagnose and fix " +
+            "issues in the flow definition.",
+        inputSchema: {
+            instance: z.string().optional().describe(INSTANCE_DESC),
+            context_id: z
+                .string()
+                .describe("The flow context sys_id from the execution result's contextId field."),
+        },
+    }, async ({ instance, context_id }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const mgr = new FlowManager(snInstance);
+                return await mgr.getFlowError(context_id);
+            });
+            const lines = [];
+            lines.push("=== Flow Error ===");
+            lines.push(`Context ID: ${result.contextId}`);
+            lines.push(`Success: ${result.success}`);
+            if (result.flowErrorMessage) {
+                lines.push(`\nFlow Error Message:\n${result.flowErrorMessage}`);
+            }
+            else {
+                lines.push("\nNo error message found for this context.");
+            }
+            if (result.errorMessage) {
+                lines.push(`\nExecution Error: ${result.errorMessage}`);
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting flow error: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+// ============================================================
+// 7. cancel_flow
+// ============================================================
+export function registerCancelFlowTool(server) {
+    server.registerTool("cancel_flow", {
+        title: "Cancel Flow",
+        description: "Cancel a running or paused flow execution by its context ID. " +
+            "Use this to stop a background flow that is no longer needed, " +
+            "is stuck in a waiting state, or was started by mistake.\n\n" +
+            "IMPORTANT: This is a destructive operation — the flow will be " +
+            "permanently cancelled and cannot be resumed.",
+        inputSchema: {
+            instance: z.string().optional().describe(INSTANCE_DESC),
+            context_id: z
+                .string()
+                .describe("The flow context sys_id from the execution result's contextId field."),
+            reason: z
+                .string()
+                .optional()
+                .describe('Reason for cancellation. Default: "Cancelled via FlowManager".'),
+        },
+    }, async ({ instance, context_id, reason }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const mgr = new FlowManager(snInstance);
+                return await mgr.cancelFlow(context_id, reason);
+            });
+            const lines = [];
+            lines.push("=== Flow Cancellation ===");
+            lines.push(`Context ID: ${result.contextId}`);
+            lines.push(`Success: ${result.success}`);
+            if (result.errorMessage) {
+                lines.push(`Error: ${result.errorMessage}`);
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error cancelling flow: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=flow.js.map

package/dist/tools/flow.js.map

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

package/dist/tools/knowledge.d.ts

@@ -0,0 +1,11 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerListKnowledgeBasesTool(server: McpServer): void;
+export declare function registerGetKnowledgeBaseTool(server: McpServer): void;
+export declare function registerListKbCategoriesTool(server: McpServer): void;
+export declare function registerCreateKbCategoryTool(server: McpServer): void;
+export declare function registerListKbArticlesTool(server: McpServer): void;
+export declare function registerGetKbArticleTool(server: McpServer): void;
+export declare function registerCreateKbArticleTool(server: McpServer): void;
+export declare function registerUpdateKbArticleTool(server: McpServer): void;
+export declare function registerPublishKbArticleTool(server: McpServer): void;
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/tools/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBpE,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsEtE;AAMD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyCpE;AAMD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiEpE;AAMD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsDpE;AAMD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2ElE;AAMD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2ChE;AAMD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6FnE;AAMD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoFnE;AAMD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0CpE"}