@sonisoft/now-sdk-ext-mcp 4.4.0 → 4.5.0

package/dist/common/annotations.d.ts

@@ -27,8 +27,14 @@
  * - `idempotentHint` — repeating the call with identical arguments leaves the
  *   same end state. True for "set this field to X"; false for "append a comment"
  *   or "create a record", which accumulate.
- * - `openWorldHint` — reserved here for arbitrary code execution, where the
- *   effect is genuinely unbounded and cannot be inferred from the arguments.
+ * - `openWorldHint` — TRUE FOR EVERY TOOL HERE, and set explicitly rather than
+ *   left to the spec's default. All of them talk to a live ServiceNow instance,
+ *   which is exactly what the spec means by an open world. It was tempting to use
+ *   it to single out arbitrary code execution, but that would have been wrong in
+ *   both directions: the spec default is already `true`, so the marking would
+ *   have been a no-op, and leaving it off the other 80-odd would have implied
+ *   they were closed-world when they are not. MCP has no hint for "runs
+ *   caller-supplied logic" — the tool description carries that.
  */
 export interface ToolAnnotations {
     readOnlyHint?: boolean;

package/dist/common/annotations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/common/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,MAAM,WAAW,eAAe;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAyBD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAmJ5D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAShE"}
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/common/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,MAAM,WAAW,eAAe;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AA2BD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAwJ5D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAchE"}

package/dist/common/annotations.js

@@ -27,27 +27,39 @@
  * - `idempotentHint` — repeating the call with identical arguments leaves the
  *   same end state. True for "set this field to X"; false for "append a comment"
  *   or "create a record", which accumulate.
- * - `openWorldHint` — reserved here for arbitrary code execution, where the
- *   effect is genuinely unbounded and cannot be inferred from the arguments.
+ * - `openWorldHint` — TRUE FOR EVERY TOOL HERE, and set explicitly rather than
+ *   left to the spec's default. All of them talk to a live ServiceNow instance,
+ *   which is exactly what the spec means by an open world. It was tempting to use
+ *   it to single out arbitrary code execution, but that would have been wrong in
+ *   both directions: the spec default is already `true`, so the marking would
+ *   have been a no-op, and leaving it off the other 80-odd would have implied
+ *   they were closed-world when they are not. MCP has no hint for "runs
+ *   caller-supplied logic" — the tool description carries that.
  */
 /** Cannot modify anything. */
-const READ = { readOnlyHint: true };
+const READ = { readOnlyHint: true, openWorldHint: true };
 /** Adds something new; nothing pre-existing is lost. Repeating accumulates. */
-const CREATE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false };
+const CREATE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true };
 /** Sets state to a given value. Nothing is destroyed; repeating is a no-op. */
-const SET = { readOnlyHint: false, destructiveHint: false, idempotentHint: true };
+const SET = { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true };
 /** Overwrites or removes data that already existed. Repeating settles. */
-const OVERWRITE = { readOnlyHint: false, destructiveHint: true, idempotentHint: true };
+const OVERWRITE = { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true };
 /** Overwrites or removes, and repeating does NOT settle. */
-const OVERWRITE_ONCE = { readOnlyHint: false, destructiveHint: true, idempotentHint: false };
-/** Runs caller-supplied logic. Effect is unbounded and not inferable from args. */
-const ARBITRARY = {
-    readOnlyHint: false,
-    destructiveHint: true,
-    idempotentHint: false,
-    openWorldHint: true,
-};
+const OVERWRITE_ONCE = { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true };
+/**
+ * Runs caller-supplied logic — a script or a flow someone else authored.
+ *
+ * Structurally identical to OVERWRITE_ONCE, because MCP has no hint that means
+ * "unbounded effect". Kept as a separate name purely so this table records which
+ * tools are in that category; the warning that actually reaches the model is in
+ * the tool description.
+ */
+const ARBITRARY = OVERWRITE_ONCE;
 export const TOOL_ANNOTATIONS = {
+    // ---- meta: reports this server's own configuration, touches no instance.
+    // Registered outside TOOL_REGISTRY because it is always available regardless
+    // of the active package.
+    list_tool_packages: READ,
     // ---- aggregate: server-side counts, no writes
     count_records: READ,
     aggregate_query: READ,
@@ -183,7 +195,12 @@ export const TOOL_ANNOTATIONS = {
  * Failing at registration makes that impossible.
  */
 export function annotationsFor(toolName) {
-    const annotations = TOOL_ANNOTATIONS[toolName];
+    // hasOwnProperty, not bracket access: TOOL_ANNOTATIONS["constructor"] would
+    // otherwise return the Object constructor — truthy — and this would hand back
+    // a function instead of throwing.
+    const annotations = Object.prototype.hasOwnProperty.call(TOOL_ANNOTATIONS, toolName)
+        ? TOOL_ANNOTATIONS[toolName]
+        : undefined;
     if (!annotations) {
         throw new Error(`No annotations defined for tool "${toolName}". Add it to TOOL_ANNOTATIONS ` +
             `in src/common/annotations.ts — every tool must declare whether it is read-only.`);

package/dist/common/annotations.js.map

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

package/dist/common/tool-packages.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Resolves MCP_TOOL_PACKAGE into the set of tools to register.
+ *
+ * Every failure mode here degrades toward MORE tools, never fewer. A typo in the
+ * env var that silently exposed a smaller surface would look like the server was
+ * broken — tools simply missing, with no error to search for. Falling back to
+ * `full` and saying so on stderr is the recoverable direction.
+ */
+export interface ResolvedPackage {
+    /** Package names that were actually applied. */
+    names: string[];
+    /** Tool names to register, already filtered to ones that exist. */
+    tools: string[];
+    /** Requested names that matched no package. */
+    unknownPackages: string[];
+    /** Tools named by a package that this server does not have. */
+    unknownTools: string[];
+    /** True when the requested selection could not be used and `full` was substituted. */
+    fellBack: boolean;
+}
+/**
+ * Resolves a selection into a concrete tool set.
+ *
+ * `selection` is the raw env value: one package name, or several comma-separated,
+ * in which case the result is their UNION. Union rather than intersection because
+ * combining packages is how someone expresses "I do service desk work AND change
+ * approvals" — an intersection of two role packages is almost always empty.
+ */
+export declare function resolveToolPackage(selection: string | undefined): ResolvedPackage;
+/**
+ * Reports the resolution on stderr.
+ *
+ * stderr, never stdout — stdout is the JSON-RPC transport, and a stray byte
+ * there breaks the client's parser.
+ */
+export declare function reportResolution(resolved: ResolvedPackage): void;
+//# sourceMappingURL=tool-packages.d.ts.map

package/dist/common/tool-packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-packages.d.ts","sourceRoot":"","sources":["../../src/common/tool-packages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,MAAM,WAAW,eAAe;IAC5B,gDAAgD;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mEAAmE;IACnE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,+DAA+D;IAC/D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,sFAAsF;IACtF,QAAQ,EAAE,OAAO,CAAC;CACrB;AAgBD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAuEjF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAuBhE"}

package/dist/common/tool-packages.js

@@ -0,0 +1,128 @@
+/**
+ * Resolves MCP_TOOL_PACKAGE into the set of tools to register.
+ *
+ * Every failure mode here degrades toward MORE tools, never fewer. A typo in the
+ * env var that silently exposed a smaller surface would look like the server was
+ * broken — tools simply missing, with no error to search for. Falling back to
+ * `full` and saying so on stderr is the recoverable direction.
+ */
+import { TOOL_PACKAGES, DEFAULT_PACKAGE } from "../config/tool-packages.js";
+import { TOOL_ANNOTATIONS } from "./annotations.js";
+import { allToolNames } from "../tools/registry.js";
+/** Sentinel in a package's `tools` meaning "everything". */
+const ALL = "*";
+/** Sentinel meaning "every tool annotated readOnlyHint: true". */
+const READONLY = "@readonly";
+/**
+ * Tools annotated as read-only. Derived, so it cannot drift from the annotations.
+ *
+ * Filtered to the registry deliberately. TOOL_ANNOTATIONS covers one tool the
+ * registry does not — `list_tool_packages`, which is registered unconditionally —
+ * and returning it here would put a name in the resolved set that has no
+ * registrar, crashing startup on `TOOL_REGISTRY[name](server)`.
+ */
+function readonlyTools(known) {
+    return Object.entries(TOOL_ANNOTATIONS)
+        .filter(([name, a]) => a.readOnlyHint === true && known.has(name))
+        .map(([name]) => name);
+}
+/**
+ * Resolves a selection into a concrete tool set.
+ *
+ * `selection` is the raw env value: one package name, or several comma-separated,
+ * in which case the result is their UNION. Union rather than intersection because
+ * combining packages is how someone expresses "I do service desk work AND change
+ * approvals" — an intersection of two role packages is almost always empty.
+ */
+export function resolveToolPackage(selection) {
+    const known = new Set(allToolNames());
+    const requested = (selection ?? "")
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    if (requested.length === 0) {
+        return {
+            names: [DEFAULT_PACKAGE],
+            tools: allToolNames(),
+            unknownPackages: [],
+            unknownTools: [],
+            fellBack: false,
+        };
+    }
+    const names = [];
+    const unknownPackages = [];
+    const selected = new Set();
+    const namedButMissing = new Set();
+    for (const name of requested) {
+        // hasOwnProperty, not bracket access. TOOL_PACKAGES is an object literal,
+        // so TOOL_PACKAGES["constructor"] returns the Object constructor — truthy,
+        // with no `.tools` — and `for (const t of pkg.tools)` then throws at module
+        // load, before the uncaughtException handler exists. MCP_TOOL_PACKAGE=
+        // constructor would crash the server rather than falling back, which is the
+        // exact opposite of this file's stated invariant.
+        const pkg = Object.prototype.hasOwnProperty.call(TOOL_PACKAGES, name)
+            ? TOOL_PACKAGES[name]
+            : undefined;
+        if (!pkg) {
+            unknownPackages.push(name);
+            continue;
+        }
+        names.push(name);
+        for (const tool of pkg.tools) {
+            if (tool === ALL) {
+                allToolNames().forEach((t) => selected.add(t));
+            }
+            else if (tool === READONLY) {
+                readonlyTools(known).forEach((t) => selected.add(t));
+            }
+            else if (known.has(tool)) {
+                selected.add(tool);
+            }
+            else {
+                // Expected for packages naming tools from open tickets; still
+                // reported, because the same path catches a genuine typo.
+                namedButMissing.add(tool);
+            }
+        }
+    }
+    // Nothing usable was requested. Fall back rather than register an empty
+    // server: a server with no tools is indistinguishable from a broken one.
+    if (names.length === 0) {
+        return {
+            names: [DEFAULT_PACKAGE],
+            tools: allToolNames(),
+            unknownPackages,
+            unknownTools: [],
+            fellBack: true,
+        };
+    }
+    return {
+        names,
+        tools: [...selected].sort(),
+        unknownPackages,
+        unknownTools: [...namedButMissing].sort(),
+        fellBack: false,
+    };
+}
+/**
+ * Reports the resolution on stderr.
+ *
+ * stderr, never stdout — stdout is the JSON-RPC transport, and a stray byte
+ * there breaks the client's parser.
+ */
+export function reportResolution(resolved) {
+    const { names, tools, unknownPackages, unknownTools, fellBack } = resolved;
+    if (unknownPackages.length > 0) {
+        const available = Object.keys(TOOL_PACKAGES).sort().join(", ");
+        console.error(`[tool-packages] unknown package(s): ${unknownPackages.join(", ")}. ` +
+            `Available: ${available}.` +
+            (fellBack ? ` Falling back to "${DEFAULT_PACKAGE}".` : ""));
+    }
+    if (unknownTools.length > 0) {
+        console.error(`[tool-packages] ${unknownTools.length} tool(s) named by a package do not exist ` +
+            `on this server and were skipped: ${unknownTools.join(", ")}. ` +
+            `This is expected for tools from work that has not landed yet.`);
+    }
+    console.error(`[tool-packages] active: ${names.join(", ")} — ${tools.length} of ${allToolNames().length} tools registered`);
+}
+//# sourceMappingURL=tool-packages.js.map

package/dist/common/tool-packages.js.map

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

package/dist/config/tool-packages.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Tool packages — named subsets of the tool surface.
+ *
+ * All 86 tools are registered by default, and their descriptions are long by
+ * design (`execute_script`'s runs to about thirteen lines, because it has to
+ * teach scoped-vs-global name qualification). That is a fixed cost paid on every
+ * session, and model tool-selection accuracy degrades as the option count grows.
+ * A user doing service-desk work does not need Flow Designer, ATF, or app
+ * publishing in front of them.
+ *
+ * Selected with MCP_TOOL_PACKAGE. Unset means "full", so the default behaviour
+ * is unchanged.
+ *
+ * ---
+ *
+ * ON NAMING TOOLS THAT DO NOT EXIST YET
+ *
+ * Packages may reference tools this server does not have. That is deliberate,
+ * not sloppiness: NEX-38 (user and group tools), NEX-39 (incident and change
+ * tools) and NEX-46 (workflow execution) are all open, and their tools belong in
+ * these packages the day they land. Naming them now means the package is already
+ * right rather than something someone has to remember to revisit.
+ *
+ * Unknown names are reported once at startup and skipped. They are a warning
+ * rather than an error precisely because forward references are expected — but
+ * they are still surfaced, because the same warning catches a genuine typo.
+ */
+export interface ToolPackage {
+    /** Shown by list_tool_packages, so write it for whoever picks a package. */
+    description: string;
+    /** Tool names, or ["*"] for everything. May name tools that do not exist yet. */
+    tools: string[];
+}
+export declare const TOOL_PACKAGES: Record<string, ToolPackage>;
+/** The package used when MCP_TOOL_PACKAGE is unset or unusable. */
+export declare const DEFAULT_PACKAGE = "full";
+//# sourceMappingURL=tool-packages.d.ts.map

package/dist/config/tool-packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-packages.d.ts","sourceRoot":"","sources":["../../src/config/tool-packages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,WAAW,WAAW;IACxB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAkLrD,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,eAAe,SAAS,CAAC"}

package/dist/config/tool-packages.js

@@ -0,0 +1,197 @@
+/**
+ * Tool packages — named subsets of the tool surface.
+ *
+ * All 86 tools are registered by default, and their descriptions are long by
+ * design (`execute_script`'s runs to about thirteen lines, because it has to
+ * teach scoped-vs-global name qualification). That is a fixed cost paid on every
+ * session, and model tool-selection accuracy degrades as the option count grows.
+ * A user doing service-desk work does not need Flow Designer, ATF, or app
+ * publishing in front of them.
+ *
+ * Selected with MCP_TOOL_PACKAGE. Unset means "full", so the default behaviour
+ * is unchanged.
+ *
+ * ---
+ *
+ * ON NAMING TOOLS THAT DO NOT EXIST YET
+ *
+ * Packages may reference tools this server does not have. That is deliberate,
+ * not sloppiness: NEX-38 (user and group tools), NEX-39 (incident and change
+ * tools) and NEX-46 (workflow execution) are all open, and their tools belong in
+ * these packages the day they land. Naming them now means the package is already
+ * right rather than something someone has to remember to revisit.
+ *
+ * Unknown names are reported once at startup and skipped. They are a warning
+ * rather than an error precisely because forward references are expected — but
+ * they are still surfaced, because the same warning catches a genuine typo.
+ */
+export const TOOL_PACKAGES = {
+    full: {
+        description: "Every tool. The default when MCP_TOOL_PACKAGE is unset.",
+        tools: ["*"],
+    },
+    readonly: {
+        description: "Only tools that cannot modify anything — safe to expose when the session " +
+            "should be able to investigate but never change the instance. Derived from " +
+            "the readOnlyHint annotations rather than hand-listed, so it cannot drift.",
+        // Resolved dynamically; see resolveReadonlyPackage in common/tool-packages.ts.
+        tools: ["@readonly"],
+    },
+    developer: {
+        description: "Building and debugging on an instance: scripts, schema, source sync, " +
+            "update sets, scope, logs and code search.",
+        tools: [
+            "execute_script",
+            "query_table",
+            "query_syslog",
+            "count_records",
+            "aggregate_query",
+            "aggregate_grouped",
+            "discover_table_schema",
+            "explain_field",
+            "lookup_table",
+            "lookup_columns",
+            "lookup_app",
+            "list_instance_tables",
+            "pull_script",
+            "push_script",
+            "code_search",
+            "list_code_search_groups",
+            "list_code_search_tables",
+            "add_code_search_table",
+            "get_current_update_set",
+            "list_update_sets",
+            "create_update_set",
+            "set_current_update_set",
+            "inspect_update_set",
+            "clone_update_set",
+            "move_update_set_records",
+            "get_current_scope",
+            "set_current_scope",
+            "list_scoped_apps",
+            "check_instance_health",
+            "find_task",
+            "export_record_xml",
+            "import_records_xml",
+        ],
+    },
+    service_desk: {
+        description: "Working tickets: find and update tasks, read knowledge, raise catalog " +
+            "requests. No scripting, no schema, no app lifecycle.",
+        tools: [
+            "find_task",
+            "query_table",
+            "add_task_comment",
+            "assign_task",
+            "resolve_incident",
+            "close_incident",
+            "approve_change",
+            "list_knowledge_bases",
+            "list_kb_articles",
+            "get_kb_article",
+            "list_catalog_items",
+            "get_catalog_item",
+            "list_catalog_item_variables",
+            "submit_catalog_request",
+            "list_attachments",
+            "get_attachment_info",
+            // Pending NEX-39.
+            "create_incident",
+            "update_incident",
+            "add_work_note",
+        ],
+    },
+    admin: {
+        description: "Instance administration: users and groups, plugins, health, logs, and " +
+            "scripting. Deliberately includes execute_script — an admin package " +
+            "without it is not an admin package.",
+        tools: [
+            "query_table",
+            "query_syslog",
+            "count_records",
+            "find_task",
+            "execute_script",
+            "list_plugins",
+            "list_instance_tables",
+            "check_instance_health",
+            "list_scoped_apps",
+            "get_app_details",
+            "list_company_apps",
+            "search_store_apps",
+            "validate_app_install",
+            "install_store_app",
+            "update_store_app",
+            // Pending NEX-38.
+            "find_user",
+            "list_users",
+            "create_user",
+            "update_user",
+            "list_groups",
+            "get_group_members",
+            "add_group_members",
+            "remove_group_members",
+            "assign_user_role",
+            "remove_user_role",
+        ],
+    },
+    change_manager: {
+        description: "Change and release work: change approvals, update sets, flows and " +
+            "workflows, and the app repo.",
+        tools: [
+            "find_task",
+            "query_table",
+            "approve_change",
+            "add_task_comment",
+            "get_current_update_set",
+            "list_update_sets",
+            "create_update_set",
+            "set_current_update_set",
+            "inspect_update_set",
+            "clone_update_set",
+            "move_update_set_records",
+            "execute_flow",
+            "get_flow_context_status",
+            "get_flow_outputs",
+            "get_flow_error",
+            "get_flow_logs",
+            "cancel_flow",
+            "create_workflow",
+            "install_from_app_repo",
+            "publish_to_app_repo",
+            // Pending NEX-39 and NEX-46.
+            "create_change_request",
+            "update_change_request",
+            "get_change_details",
+            "add_change_task",
+            "get_workflow_versions",
+            "execute_workflow",
+        ],
+    },
+    flow_developer: {
+        description: "Flow Designer work end to end: run, test, copy, inspect and diagnose " +
+            "flows, plus the schema and logs needed to debug them.",
+        tools: [
+            "execute_flow",
+            "execute_subflow",
+            "execute_action",
+            "test_flow",
+            "copy_flow",
+            "cancel_flow",
+            "get_flow_context_status",
+            "get_flow_outputs",
+            "get_flow_error",
+            "get_flow_execution_details",
+            "get_flow_logs",
+            "query_table",
+            "query_syslog",
+            "discover_table_schema",
+            "lookup_table",
+            "get_current_scope",
+            "set_current_scope",
+            "list_scoped_apps",
+        ],
+    },
+};
+/** The package used when MCP_TOOL_PACKAGE is unset or unusable. */
+export const DEFAULT_PACKAGE = "full";
+//# sourceMappingURL=tool-packages.js.map

package/dist/config/tool-packages.js.map

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

package/dist/index.js

@@ -5,35 +5,11 @@
 import "./common/credstore-boot.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerServiceNowResources } from "./resources/servicenow.js";
+import { TOOL_REGISTRY } from "./tools/registry.js";
+import { registerListToolPackagesTool } from "./tools/tool-packages.js";
+import { resolveToolPackage, reportResolution } from "./common/tool-packages.js";
 import { readServerVersion } from "./common/version.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { registerExecuteScriptTool } from "./tools/execute-script.js";
-import { registerRunAtfTestTool, registerRunAtfTestSuiteTool, } from "./tools/atf.js";
-import { registerQueryTableTool } from "./tools/query-table.js";
-import { registerFindAtfTestsTool } from "./tools/find-atf-tests.js";
-import { registerQuerySyslogTool } from "./tools/query-syslog.js";
-import { registerLookupAppTool } from "./tools/lookup-app.js";
-import { registerLookupTableTool } from "./tools/lookup-table.js";
-import { registerLookupColumnsTool } from "./tools/lookup-columns.js";
-import { registerCodeSearchTool, registerListCodeSearchGroupsTool, registerListCodeSearchTablesTool, registerAddCodeSearchTableTool, } from "./tools/codesearch.js";
-import { registerDiscoverTableSchemaTool, registerExplainFieldTool, registerValidateCatalogTool, } from "./tools/schema.js";
-import { registerGetCurrentScopeTool, registerSetCurrentScopeTool, registerListScopedAppsTool, } from "./tools/scope.js";
-import { registerGetCurrentUpdateSetTool, registerListUpdateSetsTool, registerCreateUpdateSetTool, registerSetCurrentUpdateSetTool, registerInspectUpdateSetTool, registerCloneUpdateSetTool, registerMoveUpdateSetRecordsTool, } from "./tools/updateset.js";
-import { registerAddTaskCommentTool, registerAssignTaskTool, registerResolveIncidentTool, registerCloseIncidentTool, registerApproveChangeTool, registerFindTaskTool, } from "./tools/task.js";
-import { registerBatchCreateRecordsTool, registerBatchUpdateRecordsTool, } from "./tools/batch.js";
-import { registerListAttachmentsTool, registerGetAttachmentInfoTool, registerUploadAttachmentTool, } from "./tools/attachment.js";
-import { registerGetAppDetailsTool, registerValidateAppInstallTool, registerSearchStoreAppsTool, registerListCompanyAppsTool, registerInstallStoreAppTool, registerUpdateStoreAppTool, registerInstallFromAppRepoTool, registerPublishToAppRepoTool, } from "./tools/app-manager.js";
-import { registerCreateWorkflowTool } from "./tools/workflow.js";
-import { registerPullScriptTool, registerPushScriptTool, } from "./tools/scriptsync.js";
-import { registerCountRecordsTool, registerAggregateQueryTool, registerAggregateGroupedTool, } from "./tools/aggregate.js";
-import { registerCheckInstanceHealthTool } from "./tools/health.js";
-import { registerGetCmdbRelationshipsTool, registerTraverseCmdbGraphTool, } from "./tools/cmdb.js";
-import { registerListInstanceTablesTool, registerListPluginsTool, } from "./tools/discovery.js";
-import { registerQueryUpdateRecordsTool, registerQueryDeleteRecordsTool, } from "./tools/query-batch.js";
-import { registerExportRecordXmlTool, registerImportRecordsXmlTool, } from "./tools/xml-record.js";
-import { registerListKnowledgeBasesTool, registerGetKnowledgeBaseTool, registerListKbCategoriesTool, registerCreateKbCategoryTool, registerListKbArticlesTool, registerGetKbArticleTool, registerCreateKbArticleTool, registerUpdateKbArticleTool, registerPublishKbArticleTool, } from "./tools/knowledge.js";
-import { registerListCatalogItemsTool, registerGetCatalogItemTool, registerListCatalogCategoriesTool, registerGetCatalogCategoryTool, registerListCatalogItemVariablesTool, registerSubmitCatalogRequestTool, } from "./tools/catalog.js";
-import { registerExecuteFlowTool, registerExecuteSubflowTool, registerExecuteActionTool, registerGetFlowContextStatusTool, registerGetFlowOutputsTool, registerGetFlowErrorTool, registerCancelFlowTool, registerTestFlowTool, registerCopyFlowTool, registerGetFlowExecutionDetailsTool, registerGetFlowLogsTool, } from "./tools/flow.js";
 const server = new McpServer({
     name: "now-sdk-ext-mcp",
     version: readServerVersion(),
@@ -49,93 +25,19 @@ const server = new McpServer({
     },
 });
 registerServiceNowResources(server);
-// Register tools
-registerExecuteScriptTool(server);
-registerRunAtfTestTool(server);
-registerRunAtfTestSuiteTool(server);
-registerQueryTableTool(server);
-registerFindAtfTestsTool(server);
-registerQuerySyslogTool(server);
-registerLookupAppTool(server);
-registerLookupTableTool(server);
-registerLookupColumnsTool(server);
-registerCodeSearchTool(server);
-registerListCodeSearchGroupsTool(server);
-registerListCodeSearchTablesTool(server);
-registerAddCodeSearchTableTool(server);
-registerDiscoverTableSchemaTool(server);
-registerExplainFieldTool(server);
-registerValidateCatalogTool(server);
-registerGetCurrentScopeTool(server);
-registerSetCurrentScopeTool(server);
-registerListScopedAppsTool(server);
-registerGetCurrentUpdateSetTool(server);
-registerListUpdateSetsTool(server);
-registerCreateUpdateSetTool(server);
-registerSetCurrentUpdateSetTool(server);
-registerInspectUpdateSetTool(server);
-registerAddTaskCommentTool(server);
-registerAssignTaskTool(server);
-registerResolveIncidentTool(server);
-registerCloseIncidentTool(server);
-registerApproveChangeTool(server);
-registerFindTaskTool(server);
-registerBatchCreateRecordsTool(server);
-registerBatchUpdateRecordsTool(server);
-registerListAttachmentsTool(server);
-registerGetAttachmentInfoTool(server);
-registerGetAppDetailsTool(server);
-registerValidateAppInstallTool(server);
-registerSearchStoreAppsTool(server);
-registerListCompanyAppsTool(server);
-registerInstallStoreAppTool(server);
-registerUpdateStoreAppTool(server);
-registerInstallFromAppRepoTool(server);
-registerPublishToAppRepoTool(server);
-registerCreateWorkflowTool(server);
-registerPullScriptTool(server);
-registerPushScriptTool(server);
-registerCountRecordsTool(server);
-registerAggregateQueryTool(server);
-registerAggregateGroupedTool(server);
-registerCheckInstanceHealthTool(server);
-registerGetCmdbRelationshipsTool(server);
-registerTraverseCmdbGraphTool(server);
-registerListInstanceTablesTool(server);
-registerListPluginsTool(server);
-registerQueryUpdateRecordsTool(server);
-registerQueryDeleteRecordsTool(server);
-registerCloneUpdateSetTool(server);
-registerMoveUpdateSetRecordsTool(server);
-registerUploadAttachmentTool(server);
-registerExportRecordXmlTool(server);
-registerImportRecordsXmlTool(server);
-registerListKnowledgeBasesTool(server);
-registerGetKnowledgeBaseTool(server);
-registerListKbCategoriesTool(server);
-registerCreateKbCategoryTool(server);
-registerListKbArticlesTool(server);
-registerGetKbArticleTool(server);
-registerCreateKbArticleTool(server);
-registerUpdateKbArticleTool(server);
-registerPublishKbArticleTool(server);
-registerListCatalogItemsTool(server);
-registerGetCatalogItemTool(server);
-registerListCatalogCategoriesTool(server);
-registerGetCatalogCategoryTool(server);
-registerListCatalogItemVariablesTool(server);
-registerSubmitCatalogRequestTool(server);
-registerExecuteFlowTool(server);
-registerExecuteSubflowTool(server);
-registerExecuteActionTool(server);
-registerGetFlowContextStatusTool(server);
-registerGetFlowOutputsTool(server);
-registerGetFlowErrorTool(server);
-registerCancelFlowTool(server);
-registerTestFlowTool(server);
-registerCopyFlowTool(server);
-registerGetFlowExecutionDetailsTool(server);
-registerGetFlowLogsTool(server);
+// Tools are registered through the registry rather than 86 direct calls, so a
+// package can select a subset. Resolution happens once, before registration —
+// filtering after the fact would still pay the import cost and still advertise
+// the tools in tools/list.
+const activePackage = resolveToolPackage(process.env.MCP_TOOL_PACKAGE);
+reportResolution(activePackage);
+for (const name of activePackage.tools) {
+    TOOL_REGISTRY[name](server);
+}
+// Always registered, whatever the package. A filtered session otherwise has no
+// way to tell "this server cannot do that" from "that tool is filtered out of
+// this session".
+registerListToolPackagesTool(server, activePackage);
 // Prevent the process from crashing silently on unexpected errors.
 // Log to stderr (stdout is reserved for JSON-RPC).
 process.on("uncaughtException", (error) => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,iFAAiF;AACjF,uEAAuE;AACvE,uEAAuE;AACvE,OAAO,4BAA4B,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,iBAAiB,EAAE;CAC7B,EACD;IACE,gFAAgF;IAChF,EAAE;IACF,8EAA8E;IAC9E,+EAA+E;IAC/E,gFAAgF;IAChF,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;KACd;CACF,CACF,CAAC;AAEF,2BAA2B,CAAC,MAAM,CAAC,CAAC;AAEpC,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAC/E,2BAA2B;AAC3B,MAAM,aAAa,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACvE,gBAAgB,CAAC,aAAa,CAAC,CAAC;AAEhC,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;IACvC,aAAa,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED,+EAA+E;AAC/E,8EAA8E;AAC9E,iBAAiB;AACjB,4BAA4B,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAGpD,mEAAmE;AACnE,mDAAmD;AACnD,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;AAChE,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,MAAM,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC;AAEH,sCAAsC;AACtC,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;AAC3D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Tool name -> registration function.
+ *
+ * index.ts used to call all 86 registration functions directly, which meant the
+ * only way to know which tools exist was to read 86 lines of imports. Nothing
+ * could ask "which tools are there?" without registering them.
+ *
+ * This table makes the set addressable, so a package can name a subset and
+ * something can register exactly that. It is the same shape as TOOL_ANNOTATIONS
+ * in common/annotations.ts — deliberately, since they are keyed identically and
+ * a test asserts they cover the same set. Two tables that must agree are worth
+ * having only if something checks that they do.
+ *
+ * GENERATED-ISH: derived from src/tools/*.ts, but checked in and maintained by
+ * hand. A new tool has to be added here or it cannot be registered at all —
+ * which is the point, and is asserted by a test rather than left to memory.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Registers exactly one tool on the server. */
+export type ToolRegistrar = (server: McpServer) => void;
+export declare const TOOL_REGISTRY: Record<string, ToolRegistrar>;
+/** Every tool name this server knows how to register. */
+export declare function allToolNames(): string[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+IpE,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;AAExD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAkHvD,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC"}

package/dist/tools/registry.js

@@ -0,0 +1,164 @@
+/**
+ * Tool name -> registration function.
+ *
+ * index.ts used to call all 86 registration functions directly, which meant the
+ * only way to know which tools exist was to read 86 lines of imports. Nothing
+ * could ask "which tools are there?" without registering them.
+ *
+ * This table makes the set addressable, so a package can name a subset and
+ * something can register exactly that. It is the same shape as TOOL_ANNOTATIONS
+ * in common/annotations.ts — deliberately, since they are keyed identically and
+ * a test asserts they cover the same set. Two tables that must agree are worth
+ * having only if something checks that they do.
+ *
+ * GENERATED-ISH: derived from src/tools/*.ts, but checked in and maintained by
+ * hand. A new tool has to be added here or it cannot be registered at all —
+ * which is the point, and is asserted by a test rather than left to memory.
+ */
+import { registerAggregateGroupedTool, registerAggregateQueryTool, registerCountRecordsTool, } from "../tools/aggregate.js";
+import { registerGetAppDetailsTool, registerInstallFromAppRepoTool, registerInstallStoreAppTool, registerListCompanyAppsTool, registerPublishToAppRepoTool, registerSearchStoreAppsTool, registerUpdateStoreAppTool, registerValidateAppInstallTool, } from "../tools/app-manager.js";
+import { registerRunAtfTestSuiteTool, registerRunAtfTestTool, } from "../tools/atf.js";
+import { registerGetAttachmentInfoTool, registerListAttachmentsTool, registerUploadAttachmentTool, } from "../tools/attachment.js";
+import { registerBatchCreateRecordsTool, registerBatchUpdateRecordsTool, } from "../tools/batch.js";
+import { registerGetCatalogCategoryTool, registerGetCatalogItemTool, registerListCatalogCategoriesTool, registerListCatalogItemVariablesTool, registerListCatalogItemsTool, registerSubmitCatalogRequestTool, } from "../tools/catalog.js";
+import { registerGetCmdbRelationshipsTool, registerTraverseCmdbGraphTool, } from "../tools/cmdb.js";
+import { registerAddCodeSearchTableTool, registerCodeSearchTool, registerListCodeSearchGroupsTool, registerListCodeSearchTablesTool, } from "../tools/codesearch.js";
+import { registerListInstanceTablesTool, registerListPluginsTool, } from "../tools/discovery.js";
+import { registerExecuteScriptTool, } from "../tools/execute-script.js";
+import { registerFindAtfTestsTool, } from "../tools/find-atf-tests.js";
+import { registerCancelFlowTool, registerCopyFlowTool, registerExecuteActionTool, registerExecuteFlowTool, registerExecuteSubflowTool, registerGetFlowContextStatusTool, registerGetFlowErrorTool, registerGetFlowExecutionDetailsTool, registerGetFlowLogsTool, registerGetFlowOutputsTool, registerTestFlowTool, } from "../tools/flow.js";
+import { registerCheckInstanceHealthTool, } from "../tools/health.js";
+import { registerCreateKbArticleTool, registerCreateKbCategoryTool, registerGetKbArticleTool, registerGetKnowledgeBaseTool, registerListKbArticlesTool, registerListKbCategoriesTool, registerListKnowledgeBasesTool, registerPublishKbArticleTool, registerUpdateKbArticleTool, } from "../tools/knowledge.js";
+import { registerLookupAppTool, } from "../tools/lookup-app.js";
+import { registerLookupColumnsTool, } from "../tools/lookup-columns.js";
+import { registerLookupTableTool, } from "../tools/lookup-table.js";
+import { registerQueryDeleteRecordsTool, registerQueryUpdateRecordsTool, } from "../tools/query-batch.js";
+import { registerQuerySyslogTool, } from "../tools/query-syslog.js";
+import { registerQueryTableTool, } from "../tools/query-table.js";
+import { registerDiscoverTableSchemaTool, registerExplainFieldTool, registerValidateCatalogTool, } from "../tools/schema.js";
+import { registerGetCurrentScopeTool, registerListScopedAppsTool, registerSetCurrentScopeTool, } from "../tools/scope.js";
+import { registerPullScriptTool, registerPushScriptTool, } from "../tools/scriptsync.js";
+import { registerAddTaskCommentTool, registerApproveChangeTool, registerAssignTaskTool, registerCloseIncidentTool, registerFindTaskTool, registerResolveIncidentTool, } from "../tools/task.js";
+import { registerCloneUpdateSetTool, registerCreateUpdateSetTool, registerGetCurrentUpdateSetTool, registerInspectUpdateSetTool, registerListUpdateSetsTool, registerMoveUpdateSetRecordsTool, registerSetCurrentUpdateSetTool, } from "../tools/updateset.js";
+import { registerCreateWorkflowTool, } from "../tools/workflow.js";
+import { registerExportRecordXmlTool, registerImportRecordsXmlTool, } from "../tools/xml-record.js";
+export const TOOL_REGISTRY = {
+    // ---- aggregate
+    aggregate_grouped: registerAggregateGroupedTool,
+    aggregate_query: registerAggregateQueryTool,
+    count_records: registerCountRecordsTool,
+    // ---- app-manager
+    get_app_details: registerGetAppDetailsTool,
+    install_from_app_repo: registerInstallFromAppRepoTool,
+    install_store_app: registerInstallStoreAppTool,
+    list_company_apps: registerListCompanyAppsTool,
+    publish_to_app_repo: registerPublishToAppRepoTool,
+    search_store_apps: registerSearchStoreAppsTool,
+    update_store_app: registerUpdateStoreAppTool,
+    validate_app_install: registerValidateAppInstallTool,
+    // ---- atf
+    run_atf_test: registerRunAtfTestTool,
+    run_atf_test_suite: registerRunAtfTestSuiteTool,
+    // ---- attachment
+    get_attachment_info: registerGetAttachmentInfoTool,
+    list_attachments: registerListAttachmentsTool,
+    upload_attachment: registerUploadAttachmentTool,
+    // ---- batch
+    batch_create_records: registerBatchCreateRecordsTool,
+    batch_update_records: registerBatchUpdateRecordsTool,
+    // ---- catalog
+    get_catalog_category: registerGetCatalogCategoryTool,
+    get_catalog_item: registerGetCatalogItemTool,
+    list_catalog_categories: registerListCatalogCategoriesTool,
+    list_catalog_item_variables: registerListCatalogItemVariablesTool,
+    list_catalog_items: registerListCatalogItemsTool,
+    submit_catalog_request: registerSubmitCatalogRequestTool,
+    // ---- cmdb
+    get_cmdb_relationships: registerGetCmdbRelationshipsTool,
+    traverse_cmdb_graph: registerTraverseCmdbGraphTool,
+    // ---- codesearch
+    add_code_search_table: registerAddCodeSearchTableTool,
+    code_search: registerCodeSearchTool,
+    list_code_search_groups: registerListCodeSearchGroupsTool,
+    list_code_search_tables: registerListCodeSearchTablesTool,
+    // ---- discovery
+    list_instance_tables: registerListInstanceTablesTool,
+    list_plugins: registerListPluginsTool,
+    // ---- execute-script
+    execute_script: registerExecuteScriptTool,
+    // ---- find-atf-tests
+    find_atf_tests: registerFindAtfTestsTool,
+    // ---- flow
+    cancel_flow: registerCancelFlowTool,
+    copy_flow: registerCopyFlowTool,
+    execute_action: registerExecuteActionTool,
+    execute_flow: registerExecuteFlowTool,
+    execute_subflow: registerExecuteSubflowTool,
+    get_flow_context_status: registerGetFlowContextStatusTool,
+    get_flow_error: registerGetFlowErrorTool,
+    get_flow_execution_details: registerGetFlowExecutionDetailsTool,
+    get_flow_logs: registerGetFlowLogsTool,
+    get_flow_outputs: registerGetFlowOutputsTool,
+    test_flow: registerTestFlowTool,
+    // ---- health
+    check_instance_health: registerCheckInstanceHealthTool,
+    // ---- knowledge
+    create_kb_article: registerCreateKbArticleTool,
+    create_kb_category: registerCreateKbCategoryTool,
+    get_kb_article: registerGetKbArticleTool,
+    get_knowledge_base: registerGetKnowledgeBaseTool,
+    list_kb_articles: registerListKbArticlesTool,
+    list_kb_categories: registerListKbCategoriesTool,
+    list_knowledge_bases: registerListKnowledgeBasesTool,
+    publish_kb_article: registerPublishKbArticleTool,
+    update_kb_article: registerUpdateKbArticleTool,
+    // ---- lookup-app
+    lookup_app: registerLookupAppTool,
+    // ---- lookup-columns
+    lookup_columns: registerLookupColumnsTool,
+    // ---- lookup-table
+    lookup_table: registerLookupTableTool,
+    // ---- query-batch
+    query_delete_records: registerQueryDeleteRecordsTool,
+    query_update_records: registerQueryUpdateRecordsTool,
+    // ---- query-syslog
+    query_syslog: registerQuerySyslogTool,
+    // ---- query-table
+    query_table: registerQueryTableTool,
+    // ---- schema
+    discover_table_schema: registerDiscoverTableSchemaTool,
+    explain_field: registerExplainFieldTool,
+    validate_catalog: registerValidateCatalogTool,
+    // ---- scope
+    get_current_scope: registerGetCurrentScopeTool,
+    list_scoped_apps: registerListScopedAppsTool,
+    set_current_scope: registerSetCurrentScopeTool,
+    // ---- scriptsync
+    pull_script: registerPullScriptTool,
+    push_script: registerPushScriptTool,
+    // ---- task
+    add_task_comment: registerAddTaskCommentTool,
+    approve_change: registerApproveChangeTool,
+    assign_task: registerAssignTaskTool,
+    close_incident: registerCloseIncidentTool,
+    find_task: registerFindTaskTool,
+    resolve_incident: registerResolveIncidentTool,
+    // ---- updateset
+    clone_update_set: registerCloneUpdateSetTool,
+    create_update_set: registerCreateUpdateSetTool,
+    get_current_update_set: registerGetCurrentUpdateSetTool,
+    inspect_update_set: registerInspectUpdateSetTool,
+    list_update_sets: registerListUpdateSetsTool,
+    move_update_set_records: registerMoveUpdateSetRecordsTool,
+    set_current_update_set: registerSetCurrentUpdateSetTool,
+    // ---- workflow
+    create_workflow: registerCreateWorkflowTool,
+    // ---- xml-record
+    export_record_xml: registerExportRecordXmlTool,
+    import_records_xml: registerImportRecordsXmlTool,
+};
+/** Every tool name this server knows how to register. */
+export function allToolNames() {
+    return Object.keys(TOOL_REGISTRY);
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

package/dist/tools/tool-packages.d.ts

@@ -0,0 +1,13 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ResolvedPackage } from "../common/tool-packages.js";
+/**
+ * `list_tool_packages` — what is loaded, and what else could be.
+ *
+ * Registered regardless of the active package, deliberately. If a filtered
+ * session could not see this, a model working with a reduced surface would have
+ * no way to tell whether a tool is genuinely absent from the server or merely
+ * filtered out of this session — and would report "that capability does not
+ * exist" when the truth is "ask your administrator for a different package".
+ */
+export declare function registerListToolPackagesTool(server: McpServer, active: ResolvedPackage): void;
+//# sourceMappingURL=tool-packages.d.ts.map

package/dist/tools/tool-packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-packages.d.ts","sourceRoot":"","sources":["../../src/tools/tool-packages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAsB,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAIjF;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA8C7F"}

package/dist/tools/tool-packages.js

@@ -0,0 +1,50 @@
+import { TOOL_PACKAGES } from "../config/tool-packages.js";
+import { resolveToolPackage } from "../common/tool-packages.js";
+import { allToolNames } from "./registry.js";
+import { annotationsFor } from "../common/annotations.js";
+/**
+ * `list_tool_packages` — what is loaded, and what else could be.
+ *
+ * Registered regardless of the active package, deliberately. If a filtered
+ * session could not see this, a model working with a reduced surface would have
+ * no way to tell whether a tool is genuinely absent from the server or merely
+ * filtered out of this session — and would report "that capability does not
+ * exist" when the truth is "ask your administrator for a different package".
+ */
+export function registerListToolPackagesTool(server, active) {
+    server.registerTool("list_tool_packages", {
+        annotations: annotationsFor("list_tool_packages"),
+        title: "List Tool Packages",
+        description: "Show which tool package this session is running and what other packages exist. " +
+            "Use this when a capability you expected is missing: the tool may exist on the " +
+            "server but be filtered out of this session, in which case the answer is a " +
+            "different MCP_TOOL_PACKAGE rather than a missing feature.",
+        inputSchema: {},
+    }, () => {
+        const total = allToolNames().length;
+        const lines = [];
+        lines.push("=== Active ===");
+        lines.push(`Package(s): ${active.names.join(", ")}`);
+        lines.push(`Tools:      ${active.tools.length} of ${total}`);
+        if (active.fellBack) {
+            lines.push(`NOTE: the requested package was not recognised, so "full" was substituted.`);
+        }
+        if (active.unknownPackages.length > 0) {
+            lines.push(`Unrecognised request(s): ${active.unknownPackages.join(", ")}`);
+        }
+        lines.push("");
+        lines.push("=== Available ===");
+        for (const [name, pkg] of Object.entries(TOOL_PACKAGES).sort(([a], [b]) => a.localeCompare(b))) {
+            // Resolve each so the count reflects what would actually register,
+            // not how many names the config happens to list.
+            const resolved = resolveToolPackage(name);
+            const marker = active.names.includes(name) ? " (active)" : "";
+            lines.push(`${name}${marker} — ${resolved.tools.length} tools`);
+            lines.push(`   ${pkg.description}`);
+        }
+        lines.push("");
+        lines.push("Set MCP_TOOL_PACKAGE to change this. Comma-separated names are unioned.");
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    });
+}
+//# sourceMappingURL=tool-packages.js.map

package/dist/tools/tool-packages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-packages.js","sourceRoot":"","sources":["../../src/tools/tool-packages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAmB,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAiB,EAAE,MAAuB;IACnF,MAAM,CAAC,YAAY,CACf,oBAAoB,EACpB;QACI,WAAW,EAAE,cAAc,CAAC,oBAAoB,CAAC;QACjD,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACP,iFAAiF;YACjF,gFAAgF;YAChF,4EAA4E;YAC5E,2DAA2D;QAC/D,WAAW,EAAE,EAAE;KAClB,EACD,GAAG,EAAE;QACD,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC,MAAM,CAAC;QACpC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,KAAK,CAAC,MAAM,OAAO,KAAK,EAAE,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CACN,4EAA4E,CAC/E,CAAC;QACN,CAAC;QACD,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7F,mEAAmE;YACnE,iDAAiD;YACjD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,MAAM,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;QAEtF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC,CACJ,CAAC;AACN,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonisoft/now-sdk-ext-mcp",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "description": "MCP server for interacting with ServiceNow instances via @sonisoft/now-sdk-ext-core",
   "keywords": [
     "servicenow",