kibi-mcp 2.3.0 → 3.0.0

package/dist/tools-config.js

@@ -17,30 +17,51 @@
  */
 import { getSpec } from "kibi-runtime";
 import { DIAGNOSTIC_MODE_ENABLED, DIAGNOSTIC_TELEMETRY_SCHEMA, } from "./diagnostics.js";
+import { withWorkspaceRootSchema } from "./server/workspace-router.js";
+// implements REQ-kibi-mcp-tool-consolidation
+/**
+ * The agent-facing tool list. Narrower operations (kb_skills_list,
+ * kb_semantic_advisor, kb_model_requirement, kb_suggest_predicates,
+ * kb_validate_upsert) stay in the operation catalog and on the CLI; MCP
+ * reaches them through kb_skills, kb_model and kb_upsert dryRun so hosts
+ * load fewer tool definitions.
+ */
 const MCP_TOOL_ORDER = [
     "kb_query",
     "kb_search",
     "kb_status",
-    "kb_skills_list",
-    "kb_skills_load",
-    "kb_skills_read",
+    "kb_skills",
     "kb_find_gaps",
     "kb_coverage",
     "kb_graph",
-    "kb_sparql_remote",
-    "kb_semantic_advisor",
+    "kb_model",
     "kb_upsert",
-    "kb_validate_upsert",
     "kb_delete",
     "kb_check",
     "kb_prepare_impact_review",
-    "kb_model_requirement",
-    "kb_suggest_predicates",
     "kb_plan_bootstrap",
     "kb_compile_intent",
     "kb_apply_plan",
     "kb_ingest_proof",
 ];
+/** Tools registered only when named in KIBI_MCP_OPTIONAL_TOOLS. */
+// implements REQ-kibi-mcp-tool-consolidation
+export const OPTIONAL_TOOL_NAMES = [
+    "kb_sparql_remote",
+    "kb_job_status",
+];
+/**
+ * Parse KIBI_MCP_OPTIONAL_TOOLS: a comma-separated list of optional tool
+ * names, or "all".
+ */
+// implements REQ-kibi-mcp-tool-consolidation
+export function enabledOptionalTools(value = process.env.KIBI_MCP_OPTIONAL_TOOLS) {
+    const requested = new Set((value ?? "")
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter(Boolean));
+    return new Set(OPTIONAL_TOOL_NAMES.filter((name) => requested.has("all") || requested.has(name)));
+}
 // implements REQ-002
 const TOOL_ANNOTATIONS = {
     kb_query: {
@@ -56,6 +77,20 @@ const TOOL_ANNOTATIONS = {
         idempotentHint: true,
         openWorldHint: false,
     },
+    kb_skills: {
+        title: "Read bundled Kibi skills",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    kb_model: {
+        title: "Model Kibi requirement prose",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
     kb_skills_list: {
         title: "List bundled Kibi skills",
         readOnlyHint: true,
@@ -150,7 +185,15 @@ const TOOL_ANNOTATIONS = {
         openWorldHint: false,
     },
 };
-const BASE_TOOLS = MCP_TOOL_ORDER.map((name) => {
+function exposedToolNames(optional) {
+    return [
+        ...MCP_TOOL_ORDER,
+        ...(optional.has("kb_sparql_remote")
+            ? ["kb_sparql_remote"]
+            : []),
+    ];
+}
+function toolConfig(name) {
     const spec = getSpec(name);
     const effects = spec.declaredEffects;
     const derived = {
@@ -172,7 +215,13 @@ const BASE_TOOLS = MCP_TOOL_ORDER.map((name) => {
             ...derived,
         },
     };
-});
+}
+/** Catalog tool configs for the base list plus the given optional tools. */
+// implements REQ-kibi-mcp-tool-consolidation
+export function buildBaseTools(optional = enabledOptionalTools()) {
+    return exposedToolNames(optional).map(toolConfig);
+}
+const BASE_TOOLS = buildBaseTools();
 /**
  * Inject _diagnostic_telemetry schema into tool inputs when diagnostic mode is enabled.
  * Exported for unit coverage; TOOLS still applies it only when the server starts
@@ -200,6 +249,6 @@ export function withDiagnosticTelemetrySchema(tools) {
  * Active tools list.
  * In diagnostic mode, all tools include the _diagnostic_telemetry parameter.
  */
-export const TOOLS = DIAGNOSTIC_MODE_ENABLED
+export const TOOLS = withWorkspaceRootSchema(DIAGNOSTIC_MODE_ENABLED
     ? withDiagnosticTelemetrySchema(BASE_TOOLS)
-    : [...BASE_TOOLS];
+    : [...BASE_TOOLS]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kibi-mcp",
-  "version": "2.3.0",
+  "version": "3.0.0",
   "mcpName": "io.github.Looted/kibi-mcp",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
@@ -10,8 +10,8 @@
     "fast-glob": "^3.2.12",
     "gray-matter": "^4.0.3",
     "js-yaml": "^4.1.0",
-    "kibi-runtime": "^2.1.0",
-    "kibi-core": "^0.14.1",
+    "kibi-runtime": "^2.3.0",
+    "kibi-core": "^0.15.0",
     "mcpcat": "^0.1.12",
     "zod": "^4.3.6"
   },
@@ -29,7 +29,10 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "prepack": "npm run build && node ../../scripts/verify-package-contract.mjs kibi-mcp"
   },
-  "files": ["dist", "bin"],
+  "files": [
+    "dist",
+    "bin"
+  ],
   "engines": {
     "node": ">=22"
   },