@nwire/mcp 0.7.0 → 0.8.0

package/dist/inspect.js

@@ -0,0 +1,278 @@
+/**
+ * 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.
+ */
+import { request as httpRequest } from "node:http";
+import { createConnection } from "node:net";
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+// ─── Port discovery ────────────────────────────────────────────────
+const DEFAULT_PROBE_PORTS = [
+    3000, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010,
+    3030, 3040, 3050, 4000, 8080,
+];
+const PROBE_TIMEOUT_MS = 150;
+const CACHE_TTL_MS = 5_000;
+const NEGATIVE_CACHE_TTL_MS = 1_500;
+let discovered = { url: undefined, expires: 0 };
+/** Reset the URL cache. Tests use this to flush between cases. */
+export function resetInspectDiscoveryCache() {
+    discovered = { url: undefined, expires: 0 };
+}
+/**
+ * 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 async function discoverInspectUrl() {
+    if (process.env.NWIRE_INSPECT_URL) {
+        return process.env.NWIRE_INSPECT_URL.replace(/\/$/, "");
+    }
+    if (Date.now() < discovered.expires)
+        return discovered.url;
+    const ports = parsePorts(process.env.NWIRE_PROBE_PORTS) ?? DEFAULT_PROBE_PORTS;
+    for (const port of ports) {
+        if (await isNwireWire(port, PROBE_TIMEOUT_MS)) {
+            const url = `http://127.0.0.1:${port}`;
+            discovered = { url, expires: Date.now() + CACHE_TTL_MS };
+            return url;
+        }
+    }
+    discovered = { url: undefined, expires: Date.now() + NEGATIVE_CACHE_TTL_MS };
+    return undefined;
+}
+function parsePorts(raw) {
+    if (!raw)
+        return undefined;
+    const ports = raw.split(",").map((s) => Number(s.trim())).filter((n) => n > 0);
+    return ports.length > 0 ? ports : undefined;
+}
+/**
+ * Probe one port: open a socket, then GET `/_nwire/events/recent?limit=1`
+ * and require a JSON-array body. This rejects unrelated services on the
+ * same port (TCP-only probes were too permissive).
+ */
+function isNwireWire(port, timeoutMs) {
+    return new Promise((resolveProbe) => {
+        const sock = createConnection({ host: "127.0.0.1", port });
+        sock.setTimeout(timeoutMs, () => { sock.destroy(); resolveProbe(false); });
+        sock.once("error", () => resolveProbe(false));
+        sock.once("connect", () => {
+            sock.destroy();
+            const req = httpRequest({ host: "127.0.0.1", port, path: "/_nwire/events/recent?limit=1", method: "GET" }, (res) => {
+                if (res.statusCode !== 200) {
+                    res.resume();
+                    return resolveProbe(false);
+                }
+                let buf = "";
+                res.setEncoding("utf8");
+                res.on("data", (c) => { buf += c; if (buf.length > 1024)
+                    res.destroy(); });
+                res.on("end", () => resolveProbe(buf.trimStart().startsWith("[")));
+            });
+            req.setTimeout(timeoutMs, () => { req.destroy(); resolveProbe(false); });
+            req.once("error", () => resolveProbe(false));
+            req.end();
+        });
+    });
+}
+// ─── HTTP helpers ──────────────────────────────────────────────────
+async function httpGetJson(url) {
+    return new Promise((resolveGet, rejectGet) => {
+        const u = new URL(url);
+        const req = httpRequest({ host: u.hostname, port: u.port || 80, path: u.pathname + u.search, method: "GET" }, (res) => {
+            let buf = "";
+            res.setEncoding("utf8");
+            res.on("data", (c) => { buf += c; });
+            res.on("end", () => {
+                if ((res.statusCode ?? 0) >= 400) {
+                    return rejectGet(new Error(`GET ${url} → ${res.statusCode}`));
+                }
+                try {
+                    resolveGet(buf.length === 0 ? undefined : JSON.parse(buf));
+                }
+                catch (err) {
+                    rejectGet(new Error(`GET ${url} returned non-JSON: ${err.message}`));
+                }
+            });
+        });
+        req.setTimeout(5_000, () => { req.destroy(); rejectGet(new Error(`GET ${url} timed out`)); });
+        req.once("error", rejectGet);
+        req.end();
+    });
+}
+// ─── Disk fallback ─────────────────────────────────────────────────
+function readDiskCache(file) {
+    const path = resolve(process.cwd(), ".nwire", file);
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Resolve the full manifest. Live wire wins; otherwise disk cache.
+ * Throws a helpful error if neither is available.
+ */
+async function getManifest() {
+    const url = await discoverInspectUrl();
+    if (url) {
+        try {
+            return (await httpGetJson(`${url}/_nwire/manifest`));
+        }
+        catch {
+            // fall through to disk
+        }
+    }
+    const disk = readDiskCache("manifest.json");
+    if (disk)
+        return disk;
+    throw new Error("no running wire and no .nwire/manifest.json on disk. Start a wire or run `nwire cache`.");
+}
+function filterByModule(items, module) {
+    if (typeof module !== "string" || module.length === 0)
+        return items;
+    return items.filter((it) => it.module === module);
+}
+export const inspectTools = [
+    {
+        name: "manifest",
+        description: "Return the full .nwire manifest of the running wire (live HTTP) or the on-disk cache.",
+        inputSchema: { type: "object", additionalProperties: false, properties: {} },
+        async run() {
+            return getManifest();
+        },
+    },
+    {
+        name: "list_actions",
+        description: "List actions exposed by the wire. Optional `module` filter (e.g. \"submissions\").",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: { module: { type: "string" } },
+        },
+        async run(args) {
+            const manifest = await getManifest();
+            const actions = (manifest.actions ?? readDiskCache("actions.json") ?? []);
+            return filterByModule(actions, args.module);
+        },
+    },
+    {
+        name: "list_events",
+        description: "List events declared by the wire. Optional `module` filter.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: { module: { type: "string" } },
+        },
+        async run(args) {
+            const manifest = await getManifest();
+            const events = (manifest.events ?? readDiskCache("events.json") ?? []);
+            return filterByModule(events, args.module);
+        },
+    },
+    {
+        name: "list_hooks",
+        description: "List runtime hooks (reads .nwire/hooks.json from disk).",
+        inputSchema: { type: "object", additionalProperties: false, properties: {} },
+        async run() {
+            // hooks.json lives on disk; the running wire does not currently
+            // expose it via /_nwire (it's scanner output, not runtime state).
+            const disk = readDiskCache("hooks.json");
+            if (disk)
+                return disk;
+            // Try the manifest as a last resort — some scans embed hooks there.
+            try {
+                const manifest = await getManifest();
+                return manifest.hooks ?? [];
+            }
+            catch {
+                throw new Error(".nwire/hooks.json not found. Run `nwire cache`.");
+            }
+        },
+    },
+    {
+        name: "list_plugins",
+        description: "List discovered plugins (reads .nwire/plugins.json). Optional `kind` filter: \"plugin\" | \"module\".",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: { kind: { type: "string", enum: ["plugin", "module"] } },
+        },
+        async run(args) {
+            let plugins = readDiskCache("plugins.json");
+            if (!plugins) {
+                try {
+                    const manifest = await getManifest();
+                    plugins = (manifest.plugins ?? []);
+                }
+                catch {
+                    throw new Error(".nwire/plugins.json not found. Run `nwire cache`.");
+                }
+            }
+            if (typeof args.kind === "string" && args.kind.length > 0) {
+                return plugins.filter((p) => p.kind === args.kind);
+            }
+            return plugins;
+        },
+    },
+    {
+        name: "recent_events",
+        description: "GET /_nwire/events/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_events requires a live wire.");
+            const limit = typeof args.limit === "number" ? args.limit : 100;
+            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);
+}
+//# sourceMappingURL=inspect.js.map

package/dist/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../src/inspect.ts"],"names":[],"mappings":"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"}

package/dist/write-tools.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Write tools — the mutating counterpart to `inspect.ts`.
+ *
+ * Where the inspect tools proxy `GET /_nwire/*` (or fall back to the
+ * `.nwire/` disk cache), write tools drive the running wire through its
+ * mutating endpoints:
+ *
+ *   POST /_nwire/dispatch  — invoke a registered action  ← `dispatch_action`
+ *   POST /_nwire/command   — invoke a defineCommand      ← NOT YET MOUNTED
+ *   POST /_nwire/replay    — replay a hook recording     ← NOT YET MOUNTED
+ *
+ * The wire ships only `/_nwire/dispatch` today (see
+ * `packages/nwire-http/src/inspect.ts`). For tools whose endpoint does
+ * not yet exist, we ship the tool ANYWAY so the contract is visible in
+ * `tools/list`, but the call returns `isError: true` with an explicit
+ * "endpoint not implemented on wire side" message rather than
+ * synthesizing a fake response. The companion follow-up in
+ * `@nwire/http` will mount the missing routes.
+ *
+ * These tools register alongside `inspectTools` and reuse the same URL
+ * discovery cache (`discoverInspectUrl`). They do NOT modify the
+ * existing read-only surface.
+ */
+import { type InspectToolDef } from "./inspect.js";
+export declare const writeTools: readonly InspectToolDef[];
+export declare function findWriteTool(name: string): InspectToolDef | undefined;
+//# sourceMappingURL=write-tools.d.ts.map

package/dist/write-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-tools.d.ts","sourceRoot":"","sources":["../src/write-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AA4MvE,eAAO,MAAM,UAAU,EAAE,SAAS,cAAc,EAI/C,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEtE"}

package/dist/write-tools.js

@@ -0,0 +1,212 @@
+/**
+ * Write tools — the mutating counterpart to `inspect.ts`.
+ *
+ * Where the inspect tools proxy `GET /_nwire/*` (or fall back to the
+ * `.nwire/` disk cache), write tools drive the running wire through its
+ * mutating endpoints:
+ *
+ *   POST /_nwire/dispatch  — invoke a registered action  ← `dispatch_action`
+ *   POST /_nwire/command   — invoke a defineCommand      ← NOT YET MOUNTED
+ *   POST /_nwire/replay    — replay a hook recording     ← NOT YET MOUNTED
+ *
+ * The wire ships only `/_nwire/dispatch` today (see
+ * `packages/nwire-http/src/inspect.ts`). For tools whose endpoint does
+ * not yet exist, we ship the tool ANYWAY so the contract is visible in
+ * `tools/list`, but the call returns `isError: true` with an explicit
+ * "endpoint not implemented on wire side" message rather than
+ * synthesizing a fake response. The companion follow-up in
+ * `@nwire/http` will mount the missing routes.
+ *
+ * These tools register alongside `inspectTools` and reuse the same URL
+ * discovery cache (`discoverInspectUrl`). They do NOT modify the
+ * existing read-only surface.
+ */
+import { request as httpRequest } from "node:http";
+import { discoverInspectUrl } from "./inspect.js";
+/**
+ * POST JSON to a URL. Resolves with `{ status, body }` even for 4xx/5xx
+ * — the caller decides what to do with non-2xx responses, because the
+ * wire returns useful diagnostics in the body (e.g. action-not-found).
+ */
+async function httpPostJson(url, payload) {
+    return new Promise((resolvePost, rejectPost) => {
+        const u = new URL(url);
+        const data = JSON.stringify(payload ?? {});
+        const req = httpRequest({
+            host: u.hostname,
+            port: u.port || 80,
+            path: u.pathname + u.search,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Content-Length": Buffer.byteLength(data).toString(),
+            },
+        }, (res) => {
+            let buf = "";
+            res.setEncoding("utf8");
+            res.on("data", (c) => { buf += c; });
+            res.on("end", () => {
+                const status = res.statusCode ?? 0;
+                if (buf.length === 0)
+                    return resolvePost({ status, body: undefined });
+                try {
+                    resolvePost({ status, body: JSON.parse(buf) });
+                }
+                catch {
+                    // Non-JSON body — surface it raw so callers see the truth.
+                    resolvePost({ status, body: buf });
+                }
+            });
+        });
+        req.setTimeout(10_000, () => {
+            req.destroy();
+            rejectPost(new Error(`POST ${url} timed out`));
+        });
+        req.once("error", rejectPost);
+        req.write(data);
+        req.end();
+    });
+}
+// ─── Tools ─────────────────────────────────────────────────────────
+const NO_WIRE = "no running wire detected; this tool requires a live wire (set NWIRE_INSPECT_URL or start one).";
+/**
+ * Invoke a registered action via `POST /_nwire/dispatch`. Returns the
+ * wire's envelope + result on success; surfaces the wire's diagnostic
+ * body on 4xx/5xx without rewriting it.
+ */
+const dispatchAction = {
+    name: "dispatch_action",
+    description: "Invoke a registered action on the running wire (POST /_nwire/dispatch). " +
+        "Args: { action: string, input: object, user?: { id, roles? } }. " +
+        "Returns the action result + correlation envelope, or the wire's error body on failure.",
+    inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        required: ["action"],
+        properties: {
+            action: { type: "string" },
+            input: { type: "object", additionalProperties: true },
+            user: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    id: { type: "string" },
+                    roles: { type: "array", items: { type: "string" } },
+                },
+            },
+            tenant: { type: "string" },
+        },
+    },
+    async run(args) {
+        const url = await discoverInspectUrl();
+        if (!url)
+            throw new Error(NO_WIRE);
+        const action = args.action;
+        if (!action)
+            throw new Error("dispatch_action requires `action`");
+        const user = args.user;
+        const tenant = args.tenant;
+        const payload = {
+            action,
+            input: args.input ?? {},
+            ...(user?.id !== undefined && { userId: user.id }),
+            ...(tenant !== undefined && { tenant }),
+        };
+        const { status, body } = await httpPostJson(`${url}/_nwire/dispatch`, payload);
+        if (status >= 400) {
+            throw new Error(`dispatch failed (${status}): ${typeof body === "string" ? body : JSON.stringify(body)}`);
+        }
+        return body;
+    },
+};
+/**
+ * Invoke a `defineCommand` on the wire. The wire does NOT currently
+ * expose a `/_nwire/command` endpoint (see
+ * `packages/nwire-http/src/inspect.ts`); this tool gap-flags until that
+ * endpoint is mounted. The intended shape is documented in the error.
+ */
+const runCommand = {
+    name: "run_command",
+    description: "Invoke a registered defineCommand on the running wire by name. " +
+        "Args: { name: string, args: object }. " +
+        "NOTE: the wire-side endpoint (/_nwire/command) is not yet mounted — see gap-flag in tool output.",
+    inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        required: ["name"],
+        properties: {
+            name: { type: "string" },
+            args: { type: "object", additionalProperties: true },
+        },
+    },
+    async run(args) {
+        const url = await discoverInspectUrl();
+        if (!url)
+            throw new Error(NO_WIRE);
+        const name = args.name;
+        if (!name)
+            throw new Error("run_command requires `name`");
+        // Try the canonical endpoint first; if the wire returns 404 we surface
+        // a clear gap message rather than silently faking something.
+        const { status, body } = await httpPostJson(`${url}/_nwire/command`, {
+            name,
+            args: args.args ?? {},
+        });
+        if (status === 404) {
+            throw new Error("endpoint not implemented yet on wire side: POST /_nwire/command. " +
+                "See packages/nwire-http/src/inspect.ts — only /_nwire/dispatch is mounted today. " +
+                "Workaround: invoke kernel commands via the CLI (`nwire please ...`) until the route lands.");
+        }
+        if (status >= 400) {
+            throw new Error(`run_command failed (${status}): ${typeof body === "string" ? body : JSON.stringify(body)}`);
+        }
+        return body;
+    },
+};
+/**
+ * Replay a `@nwire/hooks` recording on the wire. Same gap as
+ * `run_command` — `/_nwire/replay` is not yet mounted; tool ships so
+ * the contract is visible.
+ */
+const replayTrace = {
+    name: "replay_trace",
+    description: "Replay a @nwire/hooks recording on the running wire (POST /_nwire/replay). " +
+        "Args: { recording: object } where `recording` is the output of `record()`. " +
+        "NOTE: the wire-side endpoint (/_nwire/replay) is not yet mounted — see gap-flag in tool output.",
+    inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        required: ["recording"],
+        properties: {
+            recording: { type: "object", additionalProperties: true },
+        },
+    },
+    async run(args) {
+        const url = await discoverInspectUrl();
+        if (!url)
+            throw new Error(NO_WIRE);
+        const recording = args.recording;
+        if (!recording || typeof recording !== "object") {
+            throw new Error("replay_trace requires `recording` (object from @nwire/hooks record()).");
+        }
+        const { status, body } = await httpPostJson(`${url}/_nwire/replay`, { recording });
+        if (status === 404) {
+            throw new Error("endpoint not implemented yet on wire side: POST /_nwire/replay. " +
+                "See packages/nwire-http/src/inspect.ts — recordings can still be replayed in-process via " +
+                "`replay()` from @nwire/hooks; HTTP replay against a running wire requires the new route.");
+        }
+        if (status >= 400) {
+            throw new Error(`replay_trace failed (${status}): ${typeof body === "string" ? body : JSON.stringify(body)}`);
+        }
+        return body;
+    },
+};
+export const writeTools = [
+    dispatchAction,
+    runCommand,
+    replayTrace,
+];
+export function findWriteTool(name) {
+    return writeTools.find((t) => t.name === name);
+}
+//# sourceMappingURL=write-tools.js.map

package/dist/write-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-tools.js","sourceRoot":"","sources":["../src/write-tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@nwire/mcp",
-  "version": "0.7.0",
+  "version": "0.8.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",
   "files": [
     "dist",
-    "src"
+    "src",
+    "LICENSE"
   ],
   "type": "module",
   "main": "./dist/index.js",
@@ -20,7 +22,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@nwire/kernel": "0.7.0"
+    "@nwire/kernel": "0.8.0"
   },
   "devDependencies": {
     "@types/node": "^22.19.9",