@nwire/mcp 0.12.1 → 0.13.0

package/dist/inspect.d.ts

@@ -2,15 +2,17 @@
  * Inspect tools — proxy a running wire's `/_nwire/*` introspection
  * endpoints (or fall back to the on-disk `.nwire/` cache) as MCP tools.
  *
- * Today's `@nwire/mcp` only exposed the kernel's CLI commands. The
- * running wire mounts a rich read-only surface (manifest, recent events,
- * recent telemetry, dispatch…) at `/_nwire/*`. We adapt that surface
- * into MCP tools so an AI client can ask "what actions does this app
- * expose?" or "show me the last 100 events" without booting anything.
+ * The running wire mounts a rich read-only surface (manifest, recent
+ * events, dispatch…) at `/_nwire/*`. We adapt that surface into MCP
+ * tools so an AI client can ask "what actions does this app expose?" or
+ * "show me the last 100 events" without booting anything.
  *
- * Discovery follows the same pattern Studio uses (see
- * `packages/nwire-studio/vite.config.ts`):
+ * Telemetry records are now written by TelemetryReporter sinks (file,
+ * OTLP, …) rather than streamed over HTTP. The former `recent_telemetry`
+ * tool has been removed; read the `.nwire/telemetry/` JSONL files
+ * directly or connect an OTLP-compatible viewer.
  *
+ * Discovery:
  *   1. If `NWIRE_INSPECT_URL` is set, trust it.
  *   2. Otherwise, probe a small fixed list of ports for a wire that
  *      answers `GET /_nwire/events/recent?limit=1` with a JSON array.

package/dist/inspect.js

@@ -2,15 +2,17 @@
  * Inspect tools — proxy a running wire's `/_nwire/*` introspection
  * endpoints (or fall back to the on-disk `.nwire/` cache) as MCP tools.
  *
- * Today's `@nwire/mcp` only exposed the kernel's CLI commands. The
- * running wire mounts a rich read-only surface (manifest, recent events,
- * recent telemetry, dispatch…) at `/_nwire/*`. We adapt that surface
- * into MCP tools so an AI client can ask "what actions does this app
- * expose?" or "show me the last 100 events" without booting anything.
+ * The running wire mounts a rich read-only surface (manifest, recent
+ * events, dispatch…) at `/_nwire/*`. We adapt that surface into MCP
+ * tools so an AI client can ask "what actions does this app expose?" or
+ * "show me the last 100 events" without booting anything.
  *
- * Discovery follows the same pattern Studio uses (see
- * `packages/nwire-studio/vite.config.ts`):
+ * Telemetry records are now written by TelemetryReporter sinks (file,
+ * OTLP, …) rather than streamed over HTTP. The former `recent_telemetry`
+ * tool has been removed; read the `.nwire/telemetry/` JSONL files
+ * directly or connect an OTLP-compatible viewer.
  *
+ * Discovery:
  *   1. If `NWIRE_INSPECT_URL` is set, trust it.
  *   2. Otherwise, probe a small fixed list of ports for a wire that
  *      answers `GET /_nwire/events/recent?limit=1` with a JSON array.
@@ -190,8 +192,10 @@ export const inspectTools = [
             properties: { module: { type: "string" } },
         },
         async run(args) {
-            const manifest = await getManifest();
-            const actions = (manifest.actions ?? readDiskCache("actions.json") ?? []);
+            // Structure comes from the deep `.nwire/manifest.json` (the live
+            // `/_nwire/manifest` is a thin wire summary with no actions array).
+            const disk = readDiskCache("manifest.json");
+            const actions = (disk?.actions ?? (await getManifest()).actions ?? []);
             return filterByModule(actions, args.module);
         },
     },
@@ -204,8 +208,8 @@ export const inspectTools = [
             properties: { module: { type: "string" } },
         },
         async run(args) {
-            const manifest = await getManifest();
-            const events = (manifest.events ?? readDiskCache("events.json") ?? []);
+            const disk = readDiskCache("manifest.json");
+            const events = (disk?.events ?? (await getManifest()).events ?? []);
             return filterByModule(events, args.module);
         },
     },
@@ -231,11 +235,11 @@ export const inspectTools = [
     },
     {
         name: "list_plugins",
-        description: 'List discovered plugins (reads .nwire/plugins.json). Optional `kind` filter: "plugin" | "module".',
+        description: "List discovered plugins (reads .nwire/plugins.json).",
         inputSchema: {
             type: "object",
             additionalProperties: false,
-            properties: { kind: { type: "string", enum: ["plugin", "module"] } },
+            properties: { kind: { type: "string", enum: ["plugin"] } },
         },
         async run(args) {
             let plugins = readDiskCache("plugins.json");
@@ -270,23 +274,6 @@ export const inspectTools = [
             return httpGetJson(`${url}/_nwire/events/recent?limit=${limit}`);
         },
     },
-    {
-        name: "recent_telemetry",
-        description: "GET /_nwire/telemetry/recent?limit=N from the running wire. Requires a live wire.",
-        inputSchema: {
-            type: "object",
-            additionalProperties: false,
-            properties: { limit: { type: "number", minimum: 1, maximum: 10_000 } },
-        },
-        async run(args) {
-            const url = await discoverInspectUrl();
-            if (!url) {
-                throw new Error("no running wire detected; recent_telemetry requires a live wire.");
-            }
-            const limit = typeof args.limit === "number" ? args.limit : 100;
-            return httpGetJson(`${url}/_nwire/telemetry/recent?limit=${limit}`);
-        },
-    },
 ];
 export function findInspectTool(name) {
     return inspectTools.find((t) => t.name === name);

package/dist/mcp-adapter.js

@@ -56,12 +56,17 @@ export function mcpAdapter(config = {}) {
             const reqContainer = parentContainer.createScope();
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const wireApp = wire.app;
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const runtimeExecute = wireApp?.runtime?.execute;
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const hasRunMethod = typeof wire.handler?.run === "function";
-            if (runtimeExecute && hasRunMethod) {
-                return await runtimeExecute.call(wireApp.runtime, wire.handler, parsedInput, {});
+            const runtime = wireApp?.runtime;
+            if (runtime?.receive) {
+                // Unified inbound — the MCP tool call becomes a command on the
+                // runtime's source chain (the same path http-koa uses). The terminal
+                // router lands it on runtime.execute and threads the logger extra.
+                return await runtime.receive({
+                    kind: "command",
+                    name: wire.handler?.name ?? binding.tool,
+                    input: parsedInput,
+                    target: wire.handler,
+                }, { extras: { logger } });
             }
             const handlerCtx = {
                 resolve: (name) => reqContainer.resolve(name),

package/dist/write-tools.js

@@ -109,7 +109,10 @@ const dispatchAction = {
         const user = args.user;
         const tenant = args.tenant;
         const payload = {
-            action,
+            // The inspect `/dispatch` endpoint dispatches any handler by name and
+            // reads `body.handler` (Studio's Dispatch panel sends the same). Keep the
+            // tool arg `action` for UX, but POST it as `handler`.
+            handler: action,
             input: args.input ?? {},
             ...(user?.id !== undefined && { userId: user.id }),
             ...(tenant !== undefined && { tenant }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nwire/mcp",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "private": false,
   "description": "Nwire MCP (Model Context Protocol) server — exposes the kernel's CommandRouter as MCP tools over stdio. AI clients (Claude, Cursor, …) drive nwire commands the same way the CLI and Studio do.",
   "license": "MIT",
@@ -22,11 +22,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@nwire/container": "0.12.1",
-    "@nwire/logger": "0.12.1",
-    "@nwire/wires": "0.12.1",
-    "@nwire/supervisor": "0.12.1",
-    "@nwire/endpoint": "0.12.1"
+    "@nwire/endpoint": "0.13.0",
+    "@nwire/logger": "0.13.0",
+    "@nwire/container": "0.13.0",
+    "@nwire/supervisor": "0.13.0",
+    "@nwire/wires": "0.13.0"
   },
   "devDependencies": {
     "@types/node": "^22.19.9",