threenative-engine-mcp 0.2.2 → 0.2.3

package/README.md

@@ -30,3 +30,16 @@ The first that exists wins, so the manifest can never drift from the engine the
 
 A project copy committed at scaffold time is therefore inert whenever the package is installed:
 the two never need re-syncing by hand.
+
+## The call log
+
+Every tool call appends one JSON line to `.threenative/engine-mcp.log` in the launch directory, so
+a finished session's searches can be read back:
+
+```json
+{"time":"2026-09-14T20:20:00.000Z","results":["MultiMesh3D"],"scope":"mechanic","situation":"spawn many identical props","tool":"engine_search_capabilities","verdict":"matched"}
+```
+
+A rejected call is logged with its `error`, which is where an agent asked for something the engine
+could not answer. `THREENATIVE_ENGINE_MCP_LOG` names another file, or `off` to disable the log. A
+log that cannot be written reports once on stderr and never fails a tool call.

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { realpathSync, readFileSync, existsSync } from 'fs';
+import { realpathSync, readFileSync, existsSync, mkdirSync, appendFileSync } from 'fs';
 import path from 'path';
 import { createInterface } from 'readline';
 import { fileURLToPath } from 'url';
@@ -417,6 +417,22 @@ var TOOL_DEFINITIONS = [
 function toolDefinitions() {
   return TOOL_DEFINITIONS;
 }
+var DEFAULT_LOG_FILE = path.join(".threenative", "engine-mcp.log");
+var logBroken = false;
+function logToolCall(entry) {
+  if (logBroken) return;
+  const target = process.env.THREENATIVE_ENGINE_MCP_LOG ?? DEFAULT_LOG_FILE;
+  if (target === "off") return;
+  try {
+    mkdirSync(path.dirname(path.resolve(target)), { recursive: true });
+    appendFileSync(target, `${JSON.stringify({ time: (/* @__PURE__ */ new Date()).toISOString(), ...entry })}
+`);
+  } catch (error) {
+    logBroken = true;
+    process.stderr.write(`engine-mcp log disabled (${target}): ${String(error)}
+`);
+  }
+}
 function jsonRpcError(id, code, message) {
   return JSON.stringify({ id, jsonrpc: "2.0", error: { code, message } });
 }
@@ -439,12 +455,22 @@ function handleToolCall(params, manifestFile) {
     const scope = argumentsValue.scope ?? "mechanic";
     if (scope !== "request" && scope !== "mechanic")
       throw new Error("engine_search_capabilities scope must be 'request' or 'mechanic'.");
-    return toolText(searchCapabilities(argumentsValue.situation, manifestFile, scope));
+    const response = searchCapabilities(argumentsValue.situation, manifestFile, scope);
+    logToolCall({
+      results: response.results.map((result) => result.symbol),
+      scope,
+      situation: argumentsValue.situation,
+      tool: name,
+      verdict: response.verdict
+    });
+    return toolText(response);
   }
   if (name === "engine_capability_detail") {
     if (typeof argumentsValue.symbol !== "string")
       throw new Error("engine_capability_detail requires a string 'symbol' argument.");
-    return toolText(capabilityDetail(argumentsValue.symbol, manifestFile));
+    const detail = capabilityDetail(argumentsValue.symbol, manifestFile);
+    logToolCall({ symbol: argumentsValue.symbol, tool: name });
+    return toolText(detail);
   }
   throw new Error(`Unknown engine MCP tool '${String(name)}'.`);
 }
@@ -464,7 +490,7 @@ function handleLine(line, manifestFile) {
         capabilities: { tools: { listChanged: false } },
         instructions: AUTHORING_INSTRUCTIONS,
         protocolVersion: "2025-06-18",
-        serverInfo: { name: "threenative-engine-mcp", version: "0.2.2" }
+        serverInfo: { name: "threenative-engine-mcp", version: "0.2.3" }
       });
     }
     if (request.method === "tools/list") {
@@ -476,7 +502,9 @@ function handleLine(line, manifestFile) {
     }
     return jsonRpcError(request.id, -32601, `Method not found: ${request.method}`);
   } catch (error) {
-    return jsonRpcError(request.id, -32e3, error instanceof Error ? error.message : String(error));
+    const message = error instanceof Error ? error.message : String(error);
+    if (request.method === "tools/call") logToolCall({ error: message, request: request.params });
+    return jsonRpcError(request.id, -32e3, message);
   }
 }
 function runServer(manifestFile = defaultManifestPath()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "threenative-engine-mcp",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "license": "MIT",
   "description": "Offline MCP capability discovery for ThreeNative authoring agents.",
   "keywords": [