@nwire/mcp 0.7.0 → 0.8.0

package/README.md

@@ -1,18 +1,22 @@
 # @nwire/mcp
 
-> Model Context Protocol server — exposes the kernel's CommandRouter as MCP tools over stdio.
+> Model Context Protocol server — exposes the kernel's CommandRouter + read-only inspect tools + mutating write tools as MCP tools over stdio.
 
-## What it does
+Wraps the Nwire kernel as a Model Context Protocol server. AI clients
+(Claude Desktop, Cursor, IDE plugins) speak JSON-RPC 2.0 over stdio per
+the MCP spec; this server routes `tools/list` and `tools/call` to:
 
-Wraps the Nwire kernel's `CommandRouter` as a Model Context Protocol server. AI clients (Claude Desktop, Cursor, IDE plugins) speak JSON-RPC 2.0 over stdio per the MCP spec; this server routes their `tools/list` and `tools/call` to the same command table the CLI and Studio use. One transport, three surfaces.
+1. **Kernel CommandRouter** — same commands the CLI and Studio drive.
+2. **Inspect tools** — read-only introspection over `/__nwire/*` (falls back to `.nwire/` cache).
+3. **Write tools** — mutating actions that POST to `/__nwire/*` on a live wire.
 
-## Install
+One transport, three surfaces (CLI, Studio, MCP).
 
 ```bash
 pnpm add @nwire/mcp
 ```
 
-## Quick start
+## Quick example
 
 ```ts
 import { serveMcp } from "@nwire/mcp";
@@ -20,7 +24,7 @@ import { createKernel } from "@nwire/kernel";
 
 const kernel = createKernel();
 kernel.router.register("dev", devHandler);
-kernel.router.register("ls", listHandler);
+kernel.router.register("ls",  listHandler);
 
 await serveMcp({ kernel, serverName: "my-app" });
 // Process now speaks MCP over stdin/stdout; stderr is for logs.
@@ -32,40 +36,54 @@ Then point Claude Desktop at the binary in `claude_desktop_config.json`:
 { "mcpServers": { "my-app": { "command": "node", "args": ["./mcp.js"] } } }
 ```
 
-## API surface
+## Surface
 
-- `serveMcp({ kernel?, serverName?, serverVersion? })` — boot the server on stdio; resolves when stdin closes.
-- `JsonRpcRequest` / `JsonRpcResponse` / `JsonRpcNotification` — exported for callers writing alternative transports (WebSocket, etc.) that reuse dispatch.
+| Export                                                  | Role                                                          |
+| ------------------------------------------------------- | ------------------------------------------------------------- |
+| `serveMcp({ kernel?, serverName?, serverVersion?, stdin?, stdout? })` | Boot the server on stdio; resolves when stdin closes. |
+| `JsonRpcRequest` / `JsonRpcResponse` / `JsonRpcNotification` | JSON-RPC types for callers writing alternative transports (WebSocket, etc.). |
 
-## When to use
+### Built-in tools
 
-When you want AI assistants to invoke your Nwire commands directly. Pairs naturally with `@nwire/cli` (same commands) and Studio (same router, browser surface). Fits L4 and up.
+Beyond the kernel's CommandRouter, the server exposes these tools:
 
-## Standalone use
+**Inspect (read-only)** — proxy `/__nwire/*` on a running wire, fall back to `.nwire/*.json` on disk:
 
-For developers using `@nwire/mcp` **without the rest of Nwire** — pair it with any TypeScript project, any container, any HTTP framework.
+| Tool                | Reads                                                |
+| ------------------- | ---------------------------------------------------- |
+| `manifest`          | `.nwire/manifest.json`                               |
+| `list_actions`      | `.nwire/actions.json`                                |
+| `list_events`       | `.nwire/events.json`                                 |
+| `list_hooks`        | `.nwire/hooks.json`                                  |
+| `list_plugins`      | `.nwire/plugins.json`                                |
+| `recent_events`     | Live `/__nwire/events/recent`                        |
+| `recent_telemetry`  | Live `/__nwire/telemetry/recent`                     |
 
-```ts
-// See the package's main entry (src/) for the standalone surface.
-// The exports below work without @nwire/app or @nwire/forge.
-import {} from /* ...standalone exports... */ "@nwire/mcp";
-```
+**Write (mutating)** — POST to a live wire:
 
-## Within nwire-app
+| Tool             | Posts to                                                  |
+| ---------------- | --------------------------------------------------------- |
+| `dispatch_action`| `/__nwire/dispatch` — fire any registered action.         |
+| `run_command`    | `/__nwire/commands/run` — invoke a `defineCommand`.        |
+| `replay_trace`   | `/__nwire/replay` — replay a recording against the wire.  |
 
-For developers using this package as part of the Nwire stack — register it via `app.use(...)` or it auto-wires when you compose `createApp({ modules })`.
+Write tools gracefully gap-flag when the target endpoint isn't mounted
+(e.g., MCP running standalone with no wire up).
 
-```ts
-import { createApp } from "@nwire/forge";
+### Progress notifications
 
-const app = createApp({
-  /* ...config... */
-});
-// Adapter/plugin wiring happens here when applicable.
-```
+For kernel router commands, the server forwards `command.log` and
+`command.progress` events as MCP `notifications/progress` so the AI
+client streams output as the command runs. Inspect + write tools are
+synchronous and don't notify.
+
+## Related
+
+- `@nwire/kernel` — supplies the `CommandRouter` + `CommandHandle` lifecycle.
+- `@nwire/cli` — same kernel router exposed as a terminal CLI.
+- `@nwire/studio` — same `/__nwire/*` middleware that write/inspect tools target.
+- `@nwire/scan` — produces the `.nwire/*.json` files inspect tools fall back to.
 
-## See also
+## Status
 
-- [Architecture sketch §05 — Interfaces tier](../../architecture-sketch.html#packages)
-- [Model Context Protocol spec](https://spec.modelcontextprotocol.io/)
-- Sibling packages: [@nwire/kernel](../nwire-kernel), [@nwire/cli](../nwire-cli), [@nwire/studio](../nwire-studio)
+v0.x — `initialize`, `tools/list`, `tools/call` work end-to-end. Resources, prompts, and sampling are sketched but not implemented yet.

package/dist/index.d.ts

@@ -52,6 +52,18 @@ export interface ServeMcpOptions {
     readonly serverName?: string;
     /** Server version reported on `initialize`. Default `"0.1.0"`. */
     readonly serverVersion?: string;
+    /**
+     * Input stream the server reads newline-delimited JSON-RPC from.
+     * Defaults to `process.stdin`. Tests supply a PassThrough; foreign
+     * transports (websocket, http) can adapt to this same shape.
+     */
+    readonly stdin?: NodeJS.ReadableStream;
+    /**
+     * Output stream the server writes responses + notifications to.
+     * Defaults to `process.stdout`. Stderr is always used for server
+     * logs and is never overridden.
+     */
+    readonly stdout?: NodeJS.WritableStream;
 }
 /**
  * Start the MCP server on stdio. Blocks the process until stdin closes

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAI9E,UAAU,cAAc;IACtB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,UAAU,eAAe;IACvB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACpE;AAED,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAkBD,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB3E;AA8JD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAM9E,UAAU,cAAc;IACtB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,UAAU,eAAe;IACvB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACpE;AAED,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AASD,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAG,MAAM,CAAC,cAAc,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC3E;AAoND,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/index.js

@@ -24,17 +24,12 @@
  * (AI client invokes an nwire command) works end-to-end.
  */
 import { createKernel } from "@nwire/kernel";
+import { inspectTools, findInspectTool } from "./inspect.js";
+import { writeTools, findWriteTool } from "./write-tools.js";
 const ERR_PARSE = -32700;
-const ERR_INVALID_REQ = -32600;
 const ERR_NOT_FOUND = -32601;
 const ERR_INVALID_PARAMS = -32602;
 const ERR_INTERNAL = -32603;
-function send(msg) {
-    process.stdout.write(JSON.stringify(msg) + "\n");
-}
-function log(text) {
-    process.stderr.write(`[nwire-mcp] ${text}\n`);
-}
 /**
  * Start the MCP server on stdio. Blocks the process until stdin closes
  * (the client disconnected). Returns the kernel for callers who want
@@ -48,8 +43,16 @@ export async function serveMcp(options = {}) {
     const kernel = options.kernel ?? createKernel();
     const serverName = options.serverName ?? "nwire";
     const serverVersion = options.serverVersion ?? "0.1.0";
+    const stdin = options.stdin ?? process.stdin;
+    const stdout = options.stdout ?? process.stdout;
+    const send = (msg) => {
+        stdout.write(JSON.stringify(msg) + "\n");
+    };
+    const log = (text) => {
+        process.stderr.write(`[nwire-mcp] ${text}\n`);
+    };
     log(`server starting (${kernel.router.list().length} commands registered)`);
-    await readLines(async (line) => {
+    await readLines(stdin, async (line) => {
         if (!line.trim())
             return;
         let request;
@@ -64,7 +67,7 @@ export async function serveMcp(options = {}) {
             });
             return;
         }
-        await handle(request, { kernel, serverName, serverVersion });
+        await handle(request, { kernel, serverName, serverVersion, send });
     });
     log("stdin closed — server exiting");
 }
@@ -73,7 +76,7 @@ async function handle(req, ctx) {
     try {
         switch (req.method) {
             case "initialize":
-                send({
+                ctx.send({
                     jsonrpc: "2.0",
                     id,
                     result: {
@@ -84,15 +87,32 @@ async function handle(req, ctx) {
                 });
                 return;
             case "tools/list":
-                send({
+                ctx.send({
                     jsonrpc: "2.0",
                     id,
                     result: {
-                        tools: ctx.kernel.router.list().map((name) => ({
-                            name,
-                            description: `Nwire command "${name}"`,
-                            inputSchema: { type: "object", additionalProperties: true },
-                        })),
+                        tools: [
+                            ...ctx.kernel.router.list().map((name) => ({
+                                name,
+                                description: `Nwire command "${name}"`,
+                                inputSchema: { type: "object", additionalProperties: true },
+                            })),
+                            // Read-only introspection tools that proxy /_nwire/* (or
+                            // fall back to the .nwire/ disk cache).
+                            ...inspectTools.map((t) => ({
+                                name: t.name,
+                                description: t.description,
+                                inputSchema: t.inputSchema,
+                            })),
+                            // Mutating tools that drive the wire via POST /_nwire/*.
+                            // Some target endpoints aren't mounted yet — those tools
+                            // gracefully gap-flag (see write-tools.ts).
+                            ...writeTools.map((t) => ({
+                                name: t.name,
+                                description: t.description,
+                                inputSchema: t.inputSchema,
+                            })),
+                        ],
                     },
                 });
                 return;
@@ -100,7 +120,7 @@ async function handle(req, ctx) {
                 await callTool(req, id, ctx);
                 return;
             default:
-                send({
+                ctx.send({
                     jsonrpc: "2.0",
                     id,
                     error: { code: ERR_NOT_FOUND, message: `unknown method "${req.method}"` },
@@ -108,7 +128,7 @@ async function handle(req, ctx) {
         }
     }
     catch (err) {
-        send({
+        ctx.send({
             jsonrpc: "2.0",
             id,
             error: { code: ERR_INTERNAL, message: err.message },
@@ -119,15 +139,44 @@ async function callTool(req, id, ctx) {
     const name = req.params?.name;
     const args = (req.params?.arguments ?? {});
     if (!name) {
-        send({
+        ctx.send({
             jsonrpc: "2.0",
             id,
             error: { code: ERR_INVALID_PARAMS, message: "tools/call requires `name`" },
         });
         return;
     }
+    // Inspect + write tools live alongside the kernel CommandRouter but
+    // don't emit progress notifications — they're synchronous HTTP/file
+    // reads (inspect) or single POSTs (write). Match these BEFORE the
+    // router-has check so they don't collide.
+    const httpTool = findInspectTool(name) ?? findWriteTool(name);
+    if (httpTool) {
+        try {
+            const out = await httpTool.run(args);
+            ctx.send({
+                jsonrpc: "2.0",
+                id,
+                result: {
+                    content: [{ type: "text", text: JSON.stringify(out) }],
+                    isError: false,
+                },
+            });
+        }
+        catch (err) {
+            ctx.send({
+                jsonrpc: "2.0",
+                id,
+                result: {
+                    content: [{ type: "text", text: err.message }],
+                    isError: true,
+                },
+            });
+        }
+        return;
+    }
     if (!ctx.kernel.router.has(name)) {
-        send({
+        ctx.send({
             jsonrpc: "2.0",
             id,
             error: { code: ERR_INVALID_PARAMS, message: `unknown tool "${name}"` },
@@ -138,7 +187,7 @@ async function callTool(req, id, ctx) {
     const handle = ctx.kernel.run(name, args);
     const unsubscribe = handle.on((event) => {
         if (event.kind === "command.log") {
-            send({
+            ctx.send({
                 jsonrpc: "2.0",
                 method: "notifications/progress",
                 params: {
@@ -149,7 +198,7 @@ async function callTool(req, id, ctx) {
             });
         }
         else if (event.kind === "command.progress") {
-            send({
+            ctx.send({
                 jsonrpc: "2.0",
                 method: "notifications/progress",
                 params: {
@@ -162,7 +211,7 @@ async function callTool(req, id, ctx) {
     });
     try {
         const result = await handle.promise;
-        send({
+        ctx.send({
             jsonrpc: "2.0",
             id,
             result: {
@@ -172,7 +221,7 @@ async function callTool(req, id, ctx) {
         });
     }
     catch (err) {
-        send({
+        ctx.send({
             jsonrpc: "2.0",
             id,
             result: {
@@ -186,27 +235,30 @@ async function callTool(req, id, ctx) {
     }
 }
 /**
- * Read newline-delimited messages from stdin. Resolves when stdin
- * closes. Tolerates partial chunks (buffers + splits on \n).
+ * Read newline-delimited messages from a stream. Resolves when the
+ * stream ends. Tolerates partial chunks (buffers + splits on \n).
  */
-function readLines(onLine) {
+function readLines(stream, onLine) {
     return new Promise((resolve) => {
         let buffer = "";
-        process.stdin.on("data", async (chunk) => {
-            buffer += chunk.toString("utf8");
-            const lines = buffer.split("\n");
+        stream.on("data", async (chunk) => {
+            buffer += typeof chunk === "string" ? chunk : chunk.toString("utf8");
+            // CRLF-safe: Windows MCP clients write `\r\n` terminated frames.
+            // Splitting on `\n` alone leaves a trailing `\r` on every line which
+            // breaks downstream JSON parsing of the next message.
+            const lines = buffer.split(/\r?\n/);
             buffer = lines.pop() ?? "";
             for (const line of lines) {
                 try {
                     await onLine(line);
                 }
                 catch (err) {
-                    log(`onLine threw: ${err.message}`);
+                    process.stderr.write(`[nwire-mcp] onLine threw: ${err.message}\n`);
                 }
             }
         });
-        process.stdin.on("end", () => resolve());
-        process.stdin.on("close", () => resolve());
+        stream.on("end", () => resolve());
+        stream.on("close", () => resolve());
     });
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,YAAY,EAAmC,MAAM,eAAe,CAAC;AAwB9E,MAAM,SAAS,GAAS,CAAC,KAAK,CAAC;AAC/B,MAAM,eAAe,GAAG,CAAC,KAAK,CAAC;AAC/B,MAAM,aAAa,GAAK,CAAC,KAAK,CAAC;AAC/B,MAAM,kBAAkB,GAAG,CAAC,KAAK,CAAC;AAClC,MAAM,YAAY,GAAM,CAAC,KAAK,CAAC;AAE/B,SAAS,IAAI,CAAC,GAA0C;IACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,GAAG,CAAC,IAAY;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,IAAI,IAAI,CAAC,CAAC;AAChD,CAAC;AAaD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAA2B,EAAE;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC;IACjD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC;IAEvD,GAAG,CAAC,oBAAoB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,uBAAuB,CAAC,CAAC;IAE5E,MAAM,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,OAAO;QACzB,IAAI,OAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,IAAI;gBACR,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAG,GAAa,CAAC,OAAO,EAAE;aAC5D,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,MAAM,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,+BAA+B,CAAC,CAAC;AACvC,CAAC;AAQD,KAAK,UAAU,MAAM,CAAC,GAAmB,EAAE,GAAkB;IAC3D,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC;IAC1B,IAAI,CAAC;QACH,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,YAAY;gBACf,IAAI,CAAC;oBACH,OAAO,EAAE,KAAK;oBACd,EAAE;oBACF,MAAM,EAAE;wBACN,eAAe,EAAE,YAAY;wBAC7B,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,aAAa,EAAE;wBAChE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE;qBAChD;iBACF,CAAC,CAAC;gBACH,OAAO;YAET,KAAK,YAAY;gBACf,IAAI,CAAC;oBACH,OAAO,EAAE,KAAK;oBACd,EAAE;oBACF,MAAM,EAAE;wBACN,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;4BAC7C,IAAI;4BACJ,WAAW,EAAE,kBAAkB,IAAI,GAAG;4BACtC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE;yBAC5D,CAAC,CAAC;qBACJ;iBACF,CAAC,CAAC;gBACH,OAAO;YAET,KAAK,YAAY;gBACf,MAAM,QAAQ,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;gBAC7B,OAAO;YAET;gBACE,IAAI,CAAC;oBACH,OAAO,EAAE,KAAK;oBACd,EAAE;oBACF,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,mBAAmB,GAAG,CAAC,MAAM,GAAG,EAAE;iBAC1E,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,OAAO,EAAE,KAAK;YACd,EAAE;YACF,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAG,GAAa,CAAC,OAAO,EAAE;SAC/D,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,GAAmB,EACnB,EAA0B,EAC1B,GAAkB;IAElB,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,IAA0B,CAAC;IACpD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAA4B,CAAC;IACtE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,CAAC;YACH,OAAO,EAAE,KAAK;YACd,EAAE;YACF,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,4BAA4B,EAAE;SAC3E,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,OAAO,EAAE,KAAK;YACd,EAAE;YACF,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,iBAAiB,IAAI,GAAG,EAAE;SACvE,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,kEAAkE;IAClE,MAAM,MAAM,GAAkB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE;QACtC,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,wBAAwB;gBAChC,MAAM,EAAE;oBACN,aAAa,EAAE,MAAM,CAAC,SAAS;oBAC/B,OAAO,EAAE,KAAK,CAAC,IAAI;oBACnB,MAAM,EAAE,KAAK,CAAC,MAAM;iBACrB;aACF,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,wBAAwB;gBAChC,MAAM,EAAE;oBACN,aAAa,EAAE,MAAM,CAAC,SAAS;oBAC/B,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,GAAG,EAAE,KAAK,CAAC,GAAG;iBACf;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,EAAE,KAAK;YACd,EAAE;YACF,MAAM,EAAE;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,OAAO,EAAE,KAAK;aACf;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,OAAO,EAAE,KAAK;YACd,EAAE;YACF,MAAM,EAAE;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC;gBACzD,OAAO,EAAE,IAAI;aACd;SACF,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,WAAW,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAC,MAAuC;IACxD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAa,EAAE,EAAE;YAC/C,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,GAAG,CAAC,iBAAkB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/inspect.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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.
+ *
+ * Discovery follows the same pattern Studio uses (see
+ * `packages/nwire-studio/vite.config.ts`):
+ *
+ *   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.
+ *   3. Cache the result for 5s so a burst of tool calls is cheap.
+ *
+ * For tools that have a disk equivalent (`manifest`, `hooks`,
+ * `plugins`), we fall through to `${cwd}/.nwire/<file>.json` when no
+ * live wire answers. That makes the inspect tools usable in a cold
+ * project too — just run `nwire cache` once.
+ */
+/** Reset the URL cache. Tests use this to flush between cases. */
+export declare function resetInspectDiscoveryCache(): void;
+/**
+ * Discover the base URL of a running wire. Honours `NWIRE_INSPECT_URL`
+ * first (and does NOT validate it — callers asked for it explicitly),
+ * then probes a fixed list of ports.
+ */
+export declare function discoverInspectUrl(): Promise<string | undefined>;
+export interface InspectToolDef {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly run: (args: Record<string, unknown>) => Promise<unknown>;
+}
+export declare const inspectTools: readonly InspectToolDef[];
+export declare function findInspectTool(name: string): InspectToolDef | undefined;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../src/inspect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAyBH,kEAAkE;AAClE,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAetE;AAgFD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAS,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3E;AA8BD,eAAO,MAAM,YAAY,EAAE,SAAS,cAAc,EA2HjD,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAExE"}