@skillstate/mcp 2.0.0

package/bin/mcp.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+// skillstate MCP stdio server shim (ESM) — @skillstate/mcp bin entry.
+import { launch } from '../dist/index.js';
+
+await launch();

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './mcp-adapter.js';
+export * from './mcp-server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// @skillstate/mcp — MCP server + adapter.
+export * from './mcp-adapter.js';
+export * from './mcp-server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/mcp-adapter.d.ts

@@ -0,0 +1,49 @@
+import type { StatePathRef } from '@skillstate/core';
+/** Options for {@link McpAdapter.generateMcpConfig}. */
+export interface McpConfigOptions {
+    /** Path to the procedural-spec JSON. Defaults to `./skill-spec.json`. */
+    specPath?: string;
+    /** Command that starts the server. Defaults to `node`. */
+    command?: string;
+    /** Absolute launcher module path. Defaults to the package bin entry. */
+    launcherPath?: string;
+    /** Extra environment variables to merge into the server env. */
+    env?: Record<string, string>;
+}
+/**
+ * MCP platform adapter (@non-paper; see module doc).
+ */
+export declare class McpAdapter {
+    readonly name = "mcp";
+    /**
+     * Generate a `.mcp.json`-compatible config document registering the
+     * `skillstate` server. The config is a plain JSON object:
+     *
+     * ```json
+     * {
+     *   "mcpServers": {
+     *     "skillstate": {
+     *       "command": "node",
+     *       "args": ["/path/to/bin/mcp.js"],
+     *       "env": { "SKILLSTATE_STATE_PATH": "...", "SKILLSTATE_SPEC_PATH": "..." }
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * `statePath` accepts a raw path (legacy) or a `{ root, name }` ref
+     * confined via `resolveStatePath`. Deterministic and secret-free.
+     */
+    generateMcpConfig(statePath: string | StatePathRef, options?: McpConfigOptions): string;
+    /**
+     * @non-paper additive helper: generate the config and persist it via
+     * `atomicWriteFile` (tmp + fsync + rename). Both the destination and the
+     * embedded state path accept raw strings (legacy behavior) or
+     * `{ root, name }` refs confined by `resolveStatePath`. Returns the
+     * absolute destination path.
+     */
+    saveMcpConfig(target: string | StatePathRef, statePath: string | StatePathRef, options?: McpConfigOptions): Promise<string>;
+    /** Resolve a `string | StatePathRef` via `resolveStatePath`. */
+    private resolve;
+}
+//# sourceMappingURL=mcp-adapter.d.ts.map

package/dist/mcp-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-adapter.d.ts","sourceRoot":"","sources":["../src/mcp-adapter.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAarD,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,IAAI,SAAS;IAEtB;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,GAAG,YAAY,EAChC,OAAO,CAAC,EAAE,gBAAgB,GACzB,MAAM,CAuBR;IAED;;;;;;OAMG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,GAAG,YAAY,EAC7B,SAAS,EAAE,MAAM,GAAG,YAAY,EAChC,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,CAMjB;IAMD,gEAAgE;IAChE,OAAO,CAAC,OAAO;CAKhB"}

package/dist/mcp-adapter.js

@@ -0,0 +1,80 @@
+import { fileURLToPath } from 'node:url';
+import { atomicWriteFile, resolveStatePath, } from '@skillstate/core';
+/**
+ * Default launcher: the umbrella package's MCP stdio entry (`bin/mcp.js`).
+ * When installed, `@skillstate/mcp` lives at the same depth as the
+ * package's own `dist/` (or `src/`), so `../../../bin/mcp.js` from the
+ * compiled module resolves to the root `bin/mcp.js`. Overridable via
+ * {@link McpConfigOptions.launcherPath}.
+ */
+const LAUNCHER_PATH = fileURLToPath(new URL('../../../bin/mcp.js', import.meta.url));
+/**
+ * MCP platform adapter (@non-paper; see module doc).
+ */
+export class McpAdapter {
+    name = 'mcp';
+    /**
+     * Generate a `.mcp.json`-compatible config document registering the
+     * `skillstate` server. The config is a plain JSON object:
+     *
+     * ```json
+     * {
+     *   "mcpServers": {
+     *     "skillstate": {
+     *       "command": "node",
+     *       "args": ["/path/to/bin/mcp.js"],
+     *       "env": { "SKILLSTATE_STATE_PATH": "...", "SKILLSTATE_SPEC_PATH": "..." }
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * `statePath` accepts a raw path (legacy) or a `{ root, name }` ref
+     * confined via `resolveStatePath`. Deterministic and secret-free.
+     */
+    generateMcpConfig(statePath, options) {
+        const resolved = this.resolve(statePath);
+        const specPath = options?.specPath ?? './skill-spec.json';
+        const command = options?.command ?? 'node';
+        const launcherPath = options?.launcherPath ?? LAUNCHER_PATH;
+        const env = {
+            SKILLSTATE_STATE_PATH: resolved,
+            SKILLSTATE_SPEC_PATH: specPath,
+            ...(options?.env ?? {}),
+        };
+        const doc = {
+            mcpServers: {
+                skillstate: {
+                    command,
+                    args: [launcherPath],
+                    env,
+                },
+            },
+        };
+        return JSON.stringify(doc, null, 2) + '\n';
+    }
+    /**
+     * @non-paper additive helper: generate the config and persist it via
+     * `atomicWriteFile` (tmp + fsync + rename). Both the destination and the
+     * embedded state path accept raw strings (legacy behavior) or
+     * `{ root, name }` refs confined by `resolveStatePath`. Returns the
+     * absolute destination path.
+     */
+    async saveMcpConfig(target, statePath, options) {
+        const dest = this.resolve(target);
+        const resolved = this.resolve(statePath);
+        const config = this.generateMcpConfig(resolved, options);
+        await atomicWriteFile(dest, config);
+        return dest;
+    }
+    /* ------------------------------------------------------------------ */
+    /*  Internal helpers                                                   */
+    /* ------------------------------------------------------------------ */
+    /** Resolve a `string | StatePathRef` via `resolveStatePath`. */
+    resolve(target) {
+        return typeof target === 'string'
+            ? target
+            : resolveStatePath(target.root, target.name);
+    }
+}
+//# sourceMappingURL=mcp-adapter.js.map

package/dist/mcp-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-adapter.js","sourceRoot":"","sources":["../src/mcp-adapter.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,aAAa,CACjC,IAAI,GAAG,CAAC,qBAAqB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAChD,CAAC;AAcF;;GAEG;AACH,MAAM,OAAO,UAAU;IACZ,IAAI,GAAG,KAAK,CAAC;IAEtB;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,CACf,SAAgC,EAChC,OAA0B;QAE1B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,mBAAmB,CAAC;QAC1D,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC;QAC3C,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,aAAa,CAAC;QAE5D,MAAM,GAAG,GAA2B;YAClC,qBAAqB,EAAE,QAAQ;YAC/B,oBAAoB,EAAE,QAAQ;YAC9B,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;SACxB,CAAC;QAEF,MAAM,GAAG,GAAG;YACV,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,OAAO;oBACP,IAAI,EAAE,CAAC,YAAY,CAAC;oBACpB,GAAG;iBACJ;aACF;SACF,CAAC;QAEF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CACjB,MAA6B,EAC7B,SAAgC,EAChC,OAA0B;QAE1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wEAAwE;IACxE,yEAAyE;IACzE,wEAAwE;IAExE,gEAAgE;IACxD,OAAO,CAAC,MAA6B;QAC3C,OAAO,OAAO,MAAM,KAAK,QAAQ;YAC/B,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,132 @@
+import type { Readable, Writable } from 'node:stream';
+import type { ProceduralSpec } from '@skillstate/core';
+import type { TokenTracker } from '@skillstate/core';
+/** MCP stdio framing modes the server can speak. */
+export type FrameMode = 'jsonl' | 'content-length';
+/** A JSON-RPC request object (id may be a number, string, or null). */
+export interface JsonRpcRequest {
+    jsonrpc?: string;
+    id?: number | string | null;
+    method?: unknown;
+    params?: unknown;
+}
+/** The MCP tool-result payload returned on `tools/call`. */
+export interface McpToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/** Options for {@link McpServer}. */
+export interface McpServerOptions {
+    /** Procedural spec: drives `spec.get`, schema validation, and reset defaults. */
+    spec: ProceduralSpec;
+    /** State file root directory (confined by `resolveStatePath`). */
+    root: string;
+    /** State file name (confined by `resolveStatePath`). */
+    name: string;
+    /** Optional token tracker for the `state.metrics` tool. */
+    tracker?: TokenTracker;
+}
+/** Options for {@link launch} (mirrors `McpServerOptions` + env fallbacks). */
+export interface LaunchArgs {
+    spec?: ProceduralSpec;
+    specPath?: string;
+    statePath?: string;
+    root?: string;
+    name?: string;
+    tracker?: TokenTracker;
+    input?: Readable;
+    output?: Writable;
+}
+/**
+ * The `skillstate` MCP server: a JSON-RPC 2.0 over stdio server exposing
+ * the skillstate runtime as MCP tools.
+ */
+export declare class McpServer {
+    private readonly options;
+    /** Protocol version advertised by the server on `initialize`. */
+    readonly protocolVersion = "2024-11-05";
+    /** Advertised server capabilities (a minimal subset). */
+    readonly capabilities: {
+        tools: {
+            listChanged: boolean;
+        };
+    };
+    /** Advertised server identity. */
+    readonly serverInfo: {
+        name: string;
+        version: string;
+    };
+    private buffer;
+    private running;
+    private frameMode;
+    constructor(options: McpServerOptions);
+    /**
+     * Process a single (already-framed) JSON-RPC message line and return the
+     * response string, or `null` when the message needs no reply (a
+     * notification). This is the stateless unit entry point used by the
+     * stdio transport; `feed` drives it for framed/streamed input.
+     */
+    handleLine(line: string): string | null;
+    /**
+     * Feed a raw chunk of stdin and return every response produced by the
+     * complete messages it contains. Handles BOTH newline-delimited JSON-RPC
+     * and `Content-Length`-framed messages; partial frames are buffered until
+     * the rest arrives. Responses are framed like the message that triggered
+     * them.
+     */
+    feed(chunk: string): string[];
+    /**
+     * Attach the server to a stdin/stdout pair (defaults to `process`).
+     * Resolves once the server is reading; `stop()` detaches it. The server
+     * conserves its own buffered state, so real transports may hand over
+     * chunks that split mid-frame.
+     */
+    start(input?: Readable, output?: Writable): Promise<McpServer>;
+    /** Mark the server stopped (idempotent). */
+    stop(): void;
+    /** Whether the server is currently reading from its input stream. */
+    get isRunning(): boolean;
+    /** Parse raw text into a message and dispatch; `-32700` on parse error. */
+    private processRaw;
+    private processMessage;
+    private handleRequest;
+    private handleToolCall;
+    private callTool;
+    private stateGet;
+    private statePatch;
+    private stateMerge;
+    private stateReset;
+    private specGet;
+    private stateMetrics;
+    /** Resolve the target state file path (args override the defaults). */
+    private resolveStore;
+    /** Read + normalize the state, falling back to schema defaults. */
+    private loadState;
+    /** Crash-safe synchronous write: temp sibling + fsync + rename. */
+    private writeState;
+    private toolsList;
+    private resourcesList;
+    /**
+     * Parse a `Content-Length`-framed message from the front of the buffer
+     * (the caller has already asserted the buffer begins with a valid
+     * `Content-Length:` header). Returns the body + consumed length, or
+     * `'incomplete'` if the payload has not all arrived.
+     */
+    private takeContentLengthFrame;
+    /** Encode a response in the given framing mode. */
+    private encodeResponse;
+    private successResponse;
+    private errorResponse;
+    private textResult;
+}
+/**
+ * Launch an MCP server from an argument/env config (reads
+ * `SKILLSTATE_SPEC_PATH` and `SKILLSTATE_STATE_PATH` when not passed
+ * explicitly). Defaults to the canonical InterCode CTF spec and
+ * `.skillstate.json`.
+ */
+export declare function launch(args?: LaunchArgs): Promise<McpServer>;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

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

package/dist/mcp-server.js

@@ -0,0 +1,485 @@
+/**
+ * @non-paper MCP server — no MCP exists in arXiv 2608.26263v3.
+ *
+ * A zero-dependency Model Context Protocol server over stdio (JSON-RPC
+ * 2.0) that exposes the skillstate runtime as MCP tools. It reuses the
+ * paper-exact core directly:
+ *
+ * - `mergeState` (⊕ null-deletion merge, §3.2) and `createInitialState`;
+ * - `validatePatchDeep` (stricter defense-in-depth validation, @non-paper);
+ * - `resolveStatePath` (confines `{ root, name }` — traversal throws);
+ * - `migrate` (normalizes bare/v0/v1 persisted state);
+ * - `redactSecrets` (fail-closed scrubber so secrets never leave the
+ *   process via a tool result).
+ *
+ * TRANSPORT: accepts both official MCP stdio newline-delimited JSON-RPC
+ * AND `Content-Length`-framed messages (LSP-style). Responses echo the
+ * framing of the message that triggered them. State persistence uses a
+ * synchronous temp-sibling + fsync + rename so a mid-write crash can never
+ * produce a truncated state file.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { resolveStatePath } from '@skillstate/core';
+import { mergeState, createInitialState } from '@skillstate/core';
+import { validatePatchDeep } from '@skillstate/core';
+import { migrate } from '@skillstate/core';
+import { redactSecrets } from '@skillstate/core';
+import { INTERCODE_CTF_SPEC } from '@skillstate/core/schemas';
+/**
+ * The `skillstate` MCP server: a JSON-RPC 2.0 over stdio server exposing
+ * the skillstate runtime as MCP tools.
+ */
+export class McpServer {
+    options;
+    /** Protocol version advertised by the server on `initialize`. */
+    protocolVersion = '2024-11-05';
+    /** Advertised server capabilities (a minimal subset). */
+    capabilities = { tools: { listChanged: false } };
+    /** Advertised server identity. */
+    serverInfo = { name: 'skillstate', version: '1.0.0' };
+    buffer = '';
+    running = false;
+    frameMode = 'jsonl';
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Process a single (already-framed) JSON-RPC message line and return the
+     * response string, or `null` when the message needs no reply (a
+     * notification). This is the stateless unit entry point used by the
+     * stdio transport; `feed` drives it for framed/streamed input.
+     */
+    handleLine(line) {
+        const text = line.trim();
+        if (text.length === 0) {
+            return null;
+        }
+        return this.processRaw(text);
+    }
+    /**
+     * Feed a raw chunk of stdin and return every response produced by the
+     * complete messages it contains. Handles BOTH newline-delimited JSON-RPC
+     * and `Content-Length`-framed messages; partial frames are buffered until
+     * the rest arrives. Responses are framed like the message that triggered
+     * them.
+     */
+    feed(chunk) {
+        this.buffer += chunk;
+        const responses = [];
+        while (this.buffer.length > 0) {
+            this.buffer = this.buffer.replace(/^(\r?\n)+/, '');
+            if (this.buffer.length === 0) {
+                break;
+            }
+            if (/^Content-Length:\s*\d+/i.test(this.buffer)) {
+                const framed = this.takeContentLengthFrame();
+                if (framed === 'incomplete') {
+                    break;
+                }
+                this.frameMode = 'content-length';
+                const response = this.processRaw(framed.body);
+                if (response !== null) {
+                    responses.push(this.encodeResponse(response, this.frameMode));
+                }
+                this.buffer = this.buffer.slice(framed.consumed);
+                continue;
+            }
+            const newline = this.buffer.indexOf('\n');
+            if (newline === -1) {
+                break;
+            }
+            const line = this.buffer.slice(0, newline).trim();
+            this.buffer = this.buffer.slice(newline + 1);
+            if (line.length === 0) {
+                continue;
+            }
+            this.frameMode = 'jsonl';
+            const response = this.processRaw(line);
+            if (response !== null) {
+                responses.push(this.encodeResponse(response, this.frameMode));
+            }
+        }
+        return responses;
+    }
+    /**
+     * Attach the server to a stdin/stdout pair (defaults to `process`).
+     * Resolves once the server is reading; `stop()` detaches it. The server
+     * conserves its own buffered state, so real transports may hand over
+     * chunks that split mid-frame.
+     */
+    async start(input, output) {
+        const source = input ?? process.stdin;
+        const sink = output ?? process.stdout;
+        this.running = true;
+        source.on('data', (chunk) => {
+            const text = typeof chunk === 'string' ? chunk : chunk.toString();
+            for (const response of this.feed(text)) {
+                sink.write(response);
+            }
+        });
+        return this;
+    }
+    /** Mark the server stopped (idempotent). */
+    stop() {
+        this.running = false;
+    }
+    /** Whether the server is currently reading from its input stream. */
+    get isRunning() {
+        return this.running;
+    }
+    /* ------------------------------------------------------------------ */
+    /*  JSON-RPC dispatch                                                  */
+    /* ------------------------------------------------------------------ */
+    /** Parse raw text into a message and dispatch; `-32700` on parse error. */
+    processRaw(text) {
+        let message;
+        try {
+            message = JSON.parse(text);
+        }
+        catch {
+            return this.errorResponse(null, -32700, 'Parse error');
+        }
+        return this.processMessage(message);
+    }
+    processMessage(message) {
+        if (typeof message !== 'object' || message === null || Array.isArray(message)) {
+            return this.errorResponse(null, -32600, 'Invalid Request');
+        }
+        const msg = message;
+        const id = 'id' in msg ? msg.id ?? null : null;
+        const method = msg.method;
+        const hasId = 'id' in msg;
+        if (typeof method === 'string' && method.startsWith('notifications/')) {
+            if (hasId) {
+                return this.errorResponse(id, -32600, 'Invalid Request: notifications must not include an id');
+            }
+            return null;
+        }
+        if (typeof method !== 'string' || method.length === 0) {
+            return this.errorResponse(id, -32600, 'Invalid Request');
+        }
+        if (!hasId) {
+            return null;
+        }
+        return this.handleRequest(id, method, msg.params);
+    }
+    handleRequest(id, method, params) {
+        switch (method) {
+            case 'initialize':
+                return this.successResponse(id, {
+                    protocolVersion: this.protocolVersion,
+                    capabilities: this.capabilities,
+                    serverInfo: this.serverInfo,
+                });
+            case 'ping':
+                return this.successResponse(id, {});
+            case 'tools/list':
+                return this.successResponse(id, { tools: this.toolsList() });
+            case 'tools/call':
+                return this.handleToolCall(id, params);
+            case 'resources/list':
+                return this.successResponse(id, { resources: this.resourcesList() });
+            default:
+                return this.errorResponse(id, -32601, `Method not found: ${method}`);
+        }
+    }
+    handleToolCall(id, params) {
+        if (!isPlainObject(params)) {
+            return this.errorResponse(id, -32602, 'Invalid params: expected an object');
+        }
+        const name = params.name;
+        if (typeof name !== 'string' || name.length === 0) {
+            return this.errorResponse(id, -32602, 'Invalid params: name required');
+        }
+        const args = params.arguments;
+        const argsObj = isPlainObject(args) ? args : {};
+        try {
+            const result = this.callTool(name, argsObj);
+            return this.successResponse(id, result);
+        }
+        catch (err) {
+            const message = String(err);
+            return this.successResponse(id, {
+                content: [{ type: 'text', text: message }],
+                isError: true,
+            });
+        }
+    }
+    /* ------------------------------------------------------------------ */
+    /*  Tool implementations                                               */
+    /* ------------------------------------------------------------------ */
+    callTool(name, args) {
+        switch (name) {
+            case 'state.get':
+                return this.stateGet(args);
+            case 'state.patch':
+                return this.statePatch(args);
+            case 'state.merge':
+                return this.stateMerge(args);
+            case 'state.reset':
+                return this.stateReset(args);
+            case 'spec.get':
+                return this.specGet();
+            case 'state.metrics':
+                return this.stateMetrics();
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    stateGet(args) {
+        const filePath = this.resolveStore(args);
+        const state = this.loadState(filePath);
+        return this.textResult(redactSecrets(JSON.stringify(state)));
+    }
+    statePatch(args) {
+        const patch = args.patch;
+        if (!isPlainObject(patch)) {
+            throw new Error('patch must be an object');
+        }
+        const filePath = this.resolveStore(args);
+        const merged = mergeState(this.loadState(filePath), patch);
+        this.writeState(filePath, merged);
+        return this.textResult(redactSecrets(JSON.stringify(merged)));
+    }
+    stateMerge(args) {
+        const patch = args.patch;
+        if (!isPlainObject(patch)) {
+            throw new Error('patch must be an object');
+        }
+        const validation = validatePatchDeep(this.options.spec.schema, patch);
+        if (!validation.valid) {
+            throw new Error(validation.error);
+        }
+        const filePath = this.resolveStore(args);
+        const merged = mergeState(this.loadState(filePath), patch);
+        this.writeState(filePath, merged);
+        return this.textResult(redactSecrets(JSON.stringify(merged)));
+    }
+    stateReset(args) {
+        const filePath = this.resolveStore(args);
+        const initial = createInitialState(this.options.spec.schema);
+        this.writeState(filePath, initial);
+        return this.textResult(redactSecrets(JSON.stringify(initial)));
+    }
+    specGet() {
+        const spec = this.options.spec;
+        return this.textResult(redactSecrets(JSON.stringify({
+            id: spec.id,
+            name: spec.name,
+            version: spec.version,
+            instructions: spec.instructions,
+            schema: spec.schema,
+        })));
+    }
+    stateMetrics() {
+        const tracker = this.options.tracker;
+        if (!tracker) {
+            throw new Error('No token tracker configured');
+        }
+        const metrics = {
+            ...tracker.getMetrics(),
+            ...tracker.getBookkeeping(),
+        };
+        return this.textResult(redactSecrets(JSON.stringify(metrics)));
+    }
+    /* ------------------------------------------------------------------ */
+    /*  State helpers                                                      */
+    /* ------------------------------------------------------------------ */
+    /** Resolve the target state file path (args override the defaults). */
+    resolveStore(args) {
+        const root = typeof args.root === 'string' ? args.root : this.options.root;
+        const name = typeof args.name === 'string' ? args.name : this.options.name;
+        return resolveStatePath(root, name);
+    }
+    /** Read + normalize the state, falling back to schema defaults. */
+    loadState(filePath) {
+        try {
+            const raw = fs.readFileSync(filePath, 'utf-8');
+            return migrate(JSON.parse(raw)).state;
+        }
+        catch {
+            return createInitialState(this.options.spec.schema);
+        }
+    }
+    /** Crash-safe synchronous write: temp sibling + fsync + rename. */
+    writeState(filePath, state) {
+        const dir = path.dirname(filePath);
+        fs.mkdirSync(dir, { recursive: true });
+        const tmp = `${filePath}.tmp.${process.pid}.${Math.random().toString(36).slice(2)}`;
+        const fd = fs.openSync(tmp, 'w');
+        try {
+            fs.writeSync(fd, JSON.stringify(state, null, 2));
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        fs.renameSync(tmp, filePath);
+    }
+    /* ------------------------------------------------------------------ */
+    /*  Tool / resource schemas                                            */
+    /* ------------------------------------------------------------------ */
+    toolsList() {
+        const stringProp = (desc) => ({
+            type: 'string',
+            description: desc,
+        });
+        return [
+            {
+                name: 'state.get',
+                description: 'Read the current skill state (secrets redacted).',
+                inputSchema: {
+                    type: 'object',
+                    properties: { name: stringProp('Optional alternate state file name.') },
+                },
+            },
+            {
+                name: 'state.patch',
+                description: 'Apply a sparse patch (null deletes a key) to the state and persist it.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        patch: { type: 'object' },
+                        root: stringProp('Optional state root directory.'),
+                        name: stringProp('Optional state file name.'),
+                    },
+                    required: ['patch'],
+                },
+            },
+            {
+                name: 'state.merge',
+                description: 'Schema-validated patch: validate then apply the ⊕ merge and persist.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        patch: { type: 'object' },
+                        root: stringProp('Optional state root directory.'),
+                        name: stringProp('Optional state file name.'),
+                    },
+                    required: ['patch'],
+                },
+            },
+            {
+                name: 'state.reset',
+                description: 'Reset the state to the schema defaults.',
+                inputSchema: {
+                    type: 'object',
+                    properties: { name: stringProp('Optional alternate state file name.') },
+                },
+            },
+            {
+                name: 'spec.get',
+                description: 'Return the procedural spec (id, name, version, schema).',
+                inputSchema: { type: 'object' },
+            },
+            {
+                name: 'state.metrics',
+                description: 'Return the paper §4.3 metrics readout from the token tracker.',
+                inputSchema: { type: 'object' },
+            },
+        ];
+    }
+    resourcesList() {
+        return [
+            {
+                uri: 'skillstate://state',
+                name: 'Skill State',
+                mimeType: 'application/json',
+            },
+        ];
+    }
+    /* ------------------------------------------------------------------ */
+    /*  Frame codec                                                        */
+    /* ------------------------------------------------------------------ */
+    /**
+     * Parse a `Content-Length`-framed message from the front of the buffer
+     * (the caller has already asserted the buffer begins with a valid
+     * `Content-Length:` header). Returns the body + consumed length, or
+     * `'incomplete'` if the payload has not all arrived.
+     */
+    takeContentLengthFrame() {
+        const match = this.buffer.match(/^Content-Length:\s*(\d+)/i);
+        const crlf = this.buffer.indexOf('\r\n\r\n');
+        let headerEnd;
+        if (crlf !== -1) {
+            headerEnd = crlf + 4;
+        }
+        else {
+            const lf = this.buffer.indexOf('\n\n');
+            if (lf === -1) {
+                return 'incomplete';
+            }
+            headerEnd = lf + 2;
+        }
+        const length = Number(match[1]);
+        if (this.buffer.length - headerEnd < length) {
+            return 'incomplete';
+        }
+        return {
+            body: this.buffer.slice(headerEnd, headerEnd + length),
+            consumed: headerEnd + length,
+        };
+    }
+    /** Encode a response in the given framing mode. */
+    encodeResponse(text, mode) {
+        if (mode === 'content-length') {
+            return `Content-Length: ${Buffer.byteLength(text, 'utf-8')}\r\n\r\n${text}`;
+        }
+        return `${text}\n`;
+    }
+    /* ------------------------------------------------------------------ */
+    /*  JSON-RPC response builders                                         */
+    /* ------------------------------------------------------------------ */
+    successResponse(id, result) {
+        return JSON.stringify({ jsonrpc: '2.0', id, result });
+    }
+    errorResponse(id, code, message) {
+        return JSON.stringify({
+            jsonrpc: '2.0',
+            id,
+            error: { code, message },
+        });
+    }
+    textResult(text) {
+        return { content: [{ type: 'text', text }] };
+    }
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Resolve the procedural spec for a launch: explicit `args.spec` wins, then
+ * a `SKILLSTATE_SPEC_PATH`/`args.specPath` JSON file, else the canonical
+ * InterCode CTF spec. Pure w.r.t. the returned value.
+ */
+function resolveSpec(args, env) {
+    if (args?.spec) {
+        return args.spec;
+    }
+    const specPath = args?.specPath ?? env['SKILLSTATE_SPEC_PATH'];
+    if (typeof specPath === 'string' && specPath.length > 0) {
+        return JSON.parse(fs.readFileSync(specPath, 'utf-8'));
+    }
+    return INTERCODE_CTF_SPEC;
+}
+/**
+ * Launch an MCP server from an argument/env config (reads
+ * `SKILLSTATE_SPEC_PATH` and `SKILLSTATE_STATE_PATH` when not passed
+ * explicitly). Defaults to the canonical InterCode CTF spec and
+ * `.skillstate.json`.
+ */
+export async function launch(args) {
+    const spec = resolveSpec(args, process.env);
+    const statePath = args?.statePath ?? process.env['SKILLSTATE_STATE_PATH'];
+    const root = args?.root ?? (statePath ? path.dirname(statePath) : '.');
+    const name = args?.name ?? (statePath ? path.basename(statePath) : '.skillstate.json');
+    const server = new McpServer({
+        spec,
+        root,
+        name,
+        tracker: args?.tracker,
+    });
+    return server.start(args?.input, args?.output);
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@skillstate/mcp",
+  "version": "2.0.0",
+  "description": "Zero-dependency MCP server + adapter for the skillstate runtime.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "skillstate-mcp": "bin/mcp.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": ["dist", "bin"],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@skillstate/core": "^2.0.0"
+  }
+}