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

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

@@ -3,37 +3,20 @@
 // anything can read credentials. An MCP server is always launched as a
 // non-interactive child process, where the keyring cannot be unlocked.
 import "./common/credstore-boot.js";
+// Second, and before anything constructs a core manager: core's loggers are field
+// initializers, and until NEX-3 merely constructing one created ./logs/ in whatever
+// directory the client happened to launch this server from.
+import { flushLogs } from "@sonisoft/now-sdk-ext-core";
+import { initLogging, getLogger } from "./common/logging.js";
+initLogging();
 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 log = getLogger("mcp");
 const server = new McpServer({
     name: "now-sdk-ext-mcp",
     version: readServerVersion(),
@@ -49,109 +32,89 @@ 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).
+// Through the logger, not console.error: an uncaught error here can be an auth or
+// HTTP failure carrying a live session, and only the logger redacts.
 process.on("uncaughtException", (error) => {
-    console.error("[now-sdk-ext-mcp] Uncaught exception:", error);
+    log.error("Uncaught exception", { error });
 });
 process.on("unhandledRejection", (reason) => {
-    console.error("[now-sdk-ext-mcp] Unhandled rejection:", reason);
+    log.error("Unhandled rejection", { reason });
 });
+/** Longest a shutdown will wait on the logger before giving up on it. */
+const FLUSH_TIMEOUT_MS = 2000;
+/**
+ * Flushes buffered log records, then exits — but never lets the flush prevent the exit.
+ *
+ * Awaiting `flushLogs()` unguarded would make termination depend on that promise
+ * settling. Stuck I/O would then turn a graceful SIGTERM into a process that has to be
+ * SIGKILLed, which is strictly worse than the lost log lines this exists to save.
+ * `unref` so a pending timer cannot itself hold the process open.
+ *
+ * The rejection is swallowed on purpose: `void p.finally(cb)` re-throws after running
+ * the callback, so a failing flush would surface as an unhandled rejection during
+ * shutdown. Exiting regardless is the intent, so say so rather than rely on
+ * `process.exit` winning the race against the rejection being reported.
+ */
+async function flushAndExit(code) {
+    let timer;
+    try {
+        await Promise.race([
+            flushLogs(),
+            new Promise((resolve) => {
+                timer = setTimeout(resolve, FLUSH_TIMEOUT_MS);
+                timer.unref?.();
+            }),
+        ]);
+    }
+    catch {
+        // Nothing useful to do while shutting down; the exit below still happens.
+    }
+    finally {
+        // Tidy even though process.exit follows: leaving it dangling would be one more
+        // thing to reason about if this ever grows a path that does not exit.
+        if (timer)
+            clearTimeout(timer);
+    }
+    process.exit(code);
+}
+// A client stops this server by signalling it, which is the ORDINARY way it exits —
+// not an error path. Winston's file transport buffers, so without a flush here the
+// last records before shutdown are lost whenever NEX_LOG_FILE is on, which is exactly
+// when someone is reading the file to find out what happened.
+//
+// `once`, so a second signal from an impatient client still terminates immediately
+// rather than queueing another flush.
+for (const signal of ["SIGINT", "SIGTERM"]) {
+    process.once(signal, () => {
+        void flushAndExit(0);
+    });
+}
 // Start the server on stdio transport
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("now-sdk-ext-mcp server running on stdio");
+    log.info("now-sdk-ext-mcp server running on stdio");
 }
 main().catch((error) => {
-    console.error("Fatal error:", error);
-    process.exit(1);
+    log.error("Fatal error starting server", { error });
+    // Flush before exiting: winston buffers, and this is the line that explains why
+    // the server is not there. Same timeout guard — a stuck flush must not leave a
+    // failed startup hanging instead of exiting non-zero.
+    void flushAndExit(1);
 });
 //# sourceMappingURL=index.js.map

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,kFAAkF;AAClF,oFAAoF;AACpF,4DAA4D;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC7D,WAAW,EAAE,CAAC;AAEd,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;AAEjF,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;AAC7B,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,kFAAkF;AAClF,qEAAqE;AACrE,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,GAAG,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,GAAG,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEH,yEAAyE;AACzE,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B;;;;;;;;;;;;GAYG;AACH,KAAK,UAAU,YAAY,CAAC,IAAY;IACtC,IAAI,KAAiC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,SAAS,EAAE;YACX,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAC5B,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;gBAC9C,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAClB,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;IAC5E,CAAC;YAAS,CAAC;QACT,+EAA+E;QAC/E,sEAAsE;QACtE,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,oFAAoF;AACpF,mFAAmF;AACnF,sFAAsF;AACtF,8DAA8D;AAC9D,EAAE;AACF,mFAAmF;AACnF,sCAAsC;AACtC,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;QACxB,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,sCAAsC;AACtC,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;AACtD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,GAAG,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,gFAAgF;IAChF,+EAA+E;IAC/E,sDAAsD;IACtD,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC;AACvB,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"}