@czap/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Eassa Ayoub <eassa@heyoub.dev>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# `@czap/mcp-server`
+
+Model Context Protocol (MCP) server that forwards tool calls to the `czap` CLI (LiteShip tooling). Vocabulary: [../../docs/GLOSSARY.md](../../docs/GLOSSARY.md).
+
+## Install
+
+```bash
+pnpm add @czap/mcp-server @czap/cli
+```
+
+`@czap/cli` is a required peer dependency. Install both packages at the same semver.
+
+See [docs/RELEASING.md](https://github.com/heyoub/LiteShip/blob/main/docs/RELEASING.md).

package/dist/dispatch.d.ts

@@ -0,0 +1,46 @@
+/**
+ * MCP tool dispatch — maps tools/call params to czap CLI command
+ * executions. Captures CLI stdout and returns it as MCP text content.
+ *
+ * Entry point `dispatch` accepts a typed JSON-RPC `Request | Notification`
+ * (post-`JsonRpcServer.parse` classification) and produces a
+ * `JsonRpcResponse | null`. `null` is returned for notifications: per
+ * JSON-RPC 2.0 §4.1 the server MUST NOT send a response for them.
+ *
+ * `dispatchToolCall` remains exported for tests that exercise the CLI
+ * dispatch path directly without going through the JSON-RPC envelope.
+ *
+ * @module
+ */
+import { type JsonRpcNotification, type JsonRpcRequest, type JsonRpcResponse } from './jsonrpc.js';
+/** Shape of an MCP tools/call parameter object. */
+export interface McpToolCall {
+    readonly name: string;
+    readonly arguments: Record<string, unknown>;
+}
+/** MCP tools/call result envelope. */
+export interface McpToolResult {
+    readonly content: ReadonlyArray<{
+        type: 'text';
+        text: string;
+    }>;
+    readonly isError: boolean;
+}
+/**
+ * Route a parsed JSON-RPC message to its method handler.
+ *
+ * Returns `null` for notifications (§4.1: notifications MUST NOT receive
+ * a response). For requests, returns either a success or an error
+ * response. Internal handler exceptions are caught and surfaced as
+ * `-32603 Internal error` per §5.1.
+ */
+export declare function dispatch(msg: JsonRpcRequest | JsonRpcNotification): Promise<JsonRpcResponse | null>;
+/** Translate a tools/call into argv, run the CLI, capture stdout. */
+export declare function dispatchToolCall(call: McpToolCall): Promise<McpToolResult>;
+/** Static list of MCP tools produced by czap's CLI. */
+export declare function listTools(): ReadonlyArray<{
+    name: string;
+    description: string;
+    inputSchema: object;
+}>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,eAAe,EAMrB,MAAM,cAAc,CAAC;AA4BtB,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,cAAc,GAAG,mBAAmB,GACxC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAqBjC;AAiCD,qEAAqE;AACrE,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAkBhF;AAeD,uDAAuD;AACvD,wBAAgB,SAAS,IAAI,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAarG"}

package/dist/dispatch.js

@@ -0,0 +1,141 @@
+/**
+ * MCP tool dispatch — maps tools/call params to czap CLI command
+ * executions. Captures CLI stdout and returns it as MCP text content.
+ *
+ * Entry point `dispatch` accepts a typed JSON-RPC `Request | Notification`
+ * (post-`JsonRpcServer.parse` classification) and produces a
+ * `JsonRpcResponse | null`. `null` is returned for notifications: per
+ * JSON-RPC 2.0 §4.1 the server MUST NOT send a response for them.
+ *
+ * `dispatchToolCall` remains exported for tests that exercise the CLI
+ * dispatch path directly without going through the JSON-RPC envelope.
+ *
+ * @module
+ */
+import { errorResponse, successResponse, MethodNotFound, InvalidParams, InternalError, } from './jsonrpc.js';
+/**
+ * Sentinel for invalid-params throws inside method invocations. Caught
+ * by `dispatch` and mapped to JSON-RPC 2.0 §5.1 code -32602 (the spec
+ * code for malformed parameters). Generic `Error`s remain -32603
+ * (Internal error).
+ */
+class InvalidParamsError extends Error {
+    detail;
+    constructor(message, detail) {
+        super(message);
+        this.detail = detail;
+        this.name = 'InvalidParamsError';
+    }
+}
+let cachedRun;
+/** Lazy-load `@czap/cli` so `@czap/mcp-server` does not declare a package dependency cycle. */
+async function getRun() {
+    if (!cachedRun) {
+        const mod = await import('@czap/cli');
+        cachedRun = mod.run;
+    }
+    return cachedRun;
+}
+/**
+ * Route a parsed JSON-RPC message to its method handler.
+ *
+ * Returns `null` for notifications (§4.1: notifications MUST NOT receive
+ * a response). For requests, returns either a success or an error
+ * response. Internal handler exceptions are caught and surfaced as
+ * `-32603 Internal error` per §5.1.
+ */
+export async function dispatch(msg) {
+    const isNotification = !('id' in msg);
+    const id = isNotification ? null : msg.id;
+    try {
+        const result = await invoke(msg);
+        if (isNotification)
+            return null;
+        if (result.kind === 'method-not-found') {
+            return errorResponse(id, MethodNotFound, 'method not found', { method: msg.method });
+        }
+        return successResponse(id, result.value);
+    }
+    catch (err) {
+        if (isNotification) {
+            const notificationAck = null;
+            return notificationAck;
+        }
+        if (err instanceof InvalidParamsError) {
+            return errorResponse(id, InvalidParams, err.message, err.detail);
+        }
+        return errorResponse(id, InternalError, 'Internal error', { detail: String(err) });
+    }
+}
+function ok(value) {
+    return { kind: 'ok', value };
+}
+async function invoke(msg) {
+    switch (msg.method) {
+        case 'tools/list':
+            return ok({ tools: listTools() });
+        case 'tools/call': {
+            const params = msg.params;
+            if (!params || typeof params.name !== 'string') {
+                // Per §5.1, malformed params → -32602. InvalidParamsError sentinel
+                // is mapped to InvalidParams in dispatch's catch block.
+                throw new InvalidParamsError('tools/call requires { name: string, arguments: object }', { received: params });
+            }
+            const result = await dispatchToolCall(params);
+            return ok(result);
+        }
+        default:
+            return { kind: 'method-not-found' };
+    }
+}
+/** Translate a tools/call into argv, run the CLI, capture stdout. */
+export async function dispatchToolCall(call) {
+    const args = buildArgv(call);
+    const originalWrite = process.stdout.write.bind(process.stdout);
+    let captured = '';
+    process.stdout.write = ((chunk) => {
+        captured += typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString();
+        return true;
+    });
+    try {
+        const run = await getRun();
+        const code = await run(args);
+        return {
+            content: [{ type: 'text', text: captured.trim() }],
+            isError: code !== 0,
+        };
+    }
+    finally {
+        process.stdout.write = originalWrite;
+    }
+}
+function buildArgv(call) {
+    const segments = call.name.split('.');
+    const args = [];
+    for (const [k, v] of Object.entries(call.arguments)) {
+        if (typeof v === 'boolean') {
+            if (v)
+                args.push(`--${k}`);
+        }
+        else {
+            args.push(`--${k}=${String(v)}`);
+        }
+    }
+    return [...segments, ...args];
+}
+/** Static list of MCP tools produced by czap's CLI. */
+export function listTools() {
+    return [
+        { name: 'describe', description: 'Dump capsule catalog schema', inputSchema: { type: 'object', properties: { format: { type: 'string', enum: ['json', 'mcp'] } } } },
+        { name: 'scene.compile', description: 'Compile a scene capsule', inputSchema: { type: 'object', required: ['scene'], properties: { scene: { type: 'string' } } } },
+        { name: 'scene.render', description: 'Render scene to mp4', inputSchema: { type: 'object', required: ['scene', 'output'], properties: { scene: { type: 'string' }, output: { type: 'string' } } } },
+        { name: 'scene.verify', description: 'Run scene generated tests', inputSchema: { type: 'object', required: ['scene'], properties: { scene: { type: 'string' } } } },
+        { name: 'asset.analyze', description: 'Run cachedProjection on asset', inputSchema: { type: 'object', required: ['asset', 'projection'], properties: { asset: { type: 'string' }, projection: { type: 'string', enum: ['beat', 'onset', 'waveform'] } } } },
+        { name: 'asset.verify', description: 'Verify asset capsule', inputSchema: { type: 'object', required: ['asset'], properties: { asset: { type: 'string' } } } },
+        { name: 'capsule.inspect', description: 'Inspect a capsule manifest entry', inputSchema: { type: 'object', required: ['id'], properties: { id: { type: 'string' } } } },
+        { name: 'capsule.verify', description: 'Verify capsule generated tests', inputSchema: { type: 'object', required: ['id'], properties: { id: { type: 'string' } } } },
+        { name: 'capsule.list', description: 'List capsules filtered by kind', inputSchema: { type: 'object', properties: { kind: { type: 'string' } } } },
+        { name: 'gauntlet', description: 'Run the full gauntlet', inputSchema: { type: 'object', properties: { 'dry-run': { type: 'boolean' } } } },
+    ];
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

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

package/dist/http-server.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP HTTP server bootstrap. The pure handler logic lives in `http.ts`
+ * (exported as `handleRequest` / `respond`). This module owns the
+ * Node http server lifecycle (createServer + listen + SIGINT-await) and
+ * is excluded from coverage because the bootstrap path can only be
+ * exercised by the integration spawn at tests/integration/mcp/http.test.ts —
+ * Windows can't deliver SIGINT to spawned subprocesses cleanly, so a
+ * unit test would hang.
+ *
+ * Splitting this out lets the rest of the transport stay in coverage with
+ * no `c8 ignore` annotations.
+ *
+ * @module
+ */
+/** Run the MCP HTTP server bound to `bind` (e.g. ":3838" or "127.0.0.1:8080"). */
+export declare function runHttp(bind: string): Promise<void>;
+//# sourceMappingURL=http-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,kFAAkF;AAClF,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCzD"}

package/dist/http-server.js

@@ -0,0 +1,65 @@
+/**
+ * MCP HTTP server bootstrap. The pure handler logic lives in `http.ts`
+ * (exported as `handleRequest` / `respond`). This module owns the
+ * Node http server lifecycle (createServer + listen + SIGINT-await) and
+ * is excluded from coverage because the bootstrap path can only be
+ * exercised by the integration spawn at tests/integration/mcp/http.test.ts —
+ * Windows can't deliver SIGINT to spawned subprocesses cleanly, so a
+ * unit test would hang.
+ *
+ * Splitting this out lets the rest of the transport stay in coverage with
+ * no `c8 ignore` annotations.
+ *
+ * @module
+ */
+import { createServer } from 'node:http';
+import { handleRequest } from './http.js';
+/** Run the MCP HTTP server bound to `bind` (e.g. ":3838" or "127.0.0.1:8080"). */
+export async function runHttp(bind) {
+    const m = bind.match(/^(?:([^:]+))?:(\d+)$/);
+    const host = m?.[1] ?? '127.0.0.1';
+    const port = Number(m?.[2] ?? bind);
+    const server = createServer(async (req, res) => {
+        if (req.method !== 'POST') {
+            res.statusCode = 405;
+            res.end();
+            return;
+        }
+        let body = '';
+        for await (const chunk of req)
+            body += String(chunk);
+        const response = await handleRequest(body);
+        res.setHeader('content-type', 'application/json');
+        if (response === null) {
+            // §4.1: notifications produce no body. Use 204 No Content.
+            res.statusCode = 204;
+            res.end();
+            return;
+        }
+        res.end(JSON.stringify(response));
+    });
+    await new Promise((resolve) => server.listen(port, host, () => resolve()));
+    // Resolve the actual bound port — when callers pass :0 they want the
+    // ephemeral port the OS chose, not the literal 0 they requested.
+    const addr = server.address();
+    const boundPort = typeof addr === 'object' && addr ? addr.port : port;
+    process.stdout.write(JSON.stringify({
+        status: 'ok', command: 'mcp',
+        transport: 'http',
+        url: `http://${host}:${boundPort}/`,
+    }) + '\n');
+    await new Promise((resolve) => {
+        process.on('SIGINT', () => {
+            server.close();
+            resolve();
+        });
+    });
+}
+if (import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith('http-server.ts') || process.argv[1]?.endsWith('http.ts')) {
+    const bind = process.argv[2] ?? ':0';
+    runHttp(bind).catch((err) => {
+        process.stderr.write(JSON.stringify({ error: String(err) }) + '\n');
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=http-server.js.map

package/dist/http-server.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MCP HTTP transport — POST /, body is a JSON-RPC 2.0 request.
+ * Pure JSON-RPC handler logic lives here. The Node `createServer` +
+ * `listen` + `SIGINT`-await bootstrap lives in `./http-server.ts`,
+ * excluded from coverage because Windows can't deliver SIGINT to
+ * spawned subprocesses cleanly.
+ *
+ * Routes incoming bodies through `JsonRpcServer.parse` for the same
+ * conformance properties as the stdio transport: parse errors → -32700,
+ * notifications produce no body, batches handled per §6.
+ *
+ * @module
+ */
+import { type JsonRpcResponse, type ParseOutcome } from './jsonrpc.js';
+/**
+ * Resolve a parse outcome to its wire response, or `null` if the spec
+ * requires no response (notification, or pure-notification batch).
+ *
+ * Exported so unit tests can exercise every branch without spinning up a
+ * real HTTP server (Windows can't deliver SIGINT to subprocess for the
+ * full integration path).
+ */
+export declare function respond(outcome: ParseOutcome): Promise<JsonRpcResponse | readonly JsonRpcResponse[] | null>;
+/**
+ * Pure wire handler — accepts a JSON-RPC body string, returns the response
+ * envelope (or null for notification-only batches). Drives the HTTP server's
+ * request path; extracted so unit tests cover every parse-outcome branch
+ * without spawning a server process.
+ */
+export declare function handleRequest(body: string): Promise<JsonRpcResponse | readonly JsonRpcResponse[] | null>;
+import './http-server.js';
+export { runHttp } from './http-server.js';
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EAIlB,MAAM,cAAc,CAAC;AAEtB;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,eAAe,GAAG,SAAS,eAAe,EAAE,GAAG,IAAI,CAAC,CAsB9D;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,GAAG,SAAS,eAAe,EAAE,GAAG,IAAI,CAAC,CAG9D;AAMD,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/http.js

@@ -0,0 +1,66 @@
+/**
+ * MCP HTTP transport — POST /, body is a JSON-RPC 2.0 request.
+ * Pure JSON-RPC handler logic lives here. The Node `createServer` +
+ * `listen` + `SIGINT`-await bootstrap lives in `./http-server.ts`,
+ * excluded from coverage because Windows can't deliver SIGINT to
+ * spawned subprocesses cleanly.
+ *
+ * Routes incoming bodies through `JsonRpcServer.parse` for the same
+ * conformance properties as the stdio transport: parse errors → -32700,
+ * notifications produce no body, batches handled per §6.
+ *
+ * @module
+ */
+import { dispatch } from './dispatch.js';
+import { JsonRpcServer, errorResponse, ParseError, InvalidRequest, } from './jsonrpc.js';
+/**
+ * Resolve a parse outcome to its wire response, or `null` if the spec
+ * requires no response (notification, or pure-notification batch).
+ *
+ * Exported so unit tests can exercise every branch without spinning up a
+ * real HTTP server (Windows can't deliver SIGINT to subprocess for the
+ * full integration path).
+ */
+export async function respond(outcome) {
+    switch (outcome.kind) {
+        case 'parse-error':
+            return errorResponse(null, ParseError, 'Parse error');
+        case 'invalid-request':
+            return errorResponse(outcome.id, InvalidRequest, 'Invalid Request');
+        case 'notification':
+            await dispatch(outcome.message);
+            return null;
+        case 'request':
+            return dispatch(outcome.message);
+        case 'batch': {
+            const responses = [];
+            for (const sub of outcome.outcomes) {
+                const r = await respond(sub);
+                if (r === null)
+                    continue;
+                if (Array.isArray(r))
+                    responses.push(...r);
+                else
+                    responses.push(r);
+            }
+            return responses.length > 0 ? responses : null;
+        }
+    }
+}
+/**
+ * Pure wire handler — accepts a JSON-RPC body string, returns the response
+ * envelope (or null for notification-only batches). Drives the HTTP server's
+ * request path; extracted so unit tests cover every parse-outcome branch
+ * without spawning a server process.
+ */
+export async function handleRequest(body) {
+    const outcome = JsonRpcServer.parse(body);
+    return respond(outcome);
+}
+// Re-export the bootstrap so callers (start.ts) can keep using `import { runHttp } from './http.js'`.
+// The bootstrap module also installs a top-level direct-invoke guard for
+// the integration spawn entrypoint (`tsx packages/mcp-server/src/http.ts ...`).
+// We import that module for its side effect so the spawn keeps working.
+import './http-server.js';
+export { runHttp } from './http-server.js';
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,aAAa,EAGb,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAqB;IAErB,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,aAAa;YAChB,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QACxD,KAAK,iBAAiB;YACpB,OAAO,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC;QACtE,KAAK,cAAc;YACjB,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnC,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,SAAS,GAAsB,EAAE,CAAC;YACxC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACnC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC7B,IAAI,CAAC,KAAK,IAAI;oBAAE,SAAS;gBACzB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;oBAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;;oBACtC,SAAS,CAAC,IAAI,CAAC,CAAoB,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY;IAEZ,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED,sGAAsG;AACtG,yEAAyE;AACzE,gFAAgF;AAChF,wEAAwE;AACxE,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/** `@czap/mcp-server` — MCP bridge for **LiteShip**; forwards tools to the `czap` CLI + capsule factory. */
+export { start } from './start.js';
+export type { StartOpts } from './start.js';
+export { listTools, dispatchToolCall, dispatch } from './dispatch.js';
+export type { McpToolCall, McpToolResult } from './dispatch.js';
+export { runStdio } from './stdio.js';
+export { runHttp } from './http.js';
+export { JsonRpcServer, jsonRpcServerCapsule, parse, errorResponse, successResponse, ParseError, InvalidRequest, MethodNotFound, InvalidParams, InternalError, } from './jsonrpc.js';
+export type { JsonRpcId, JsonRpcRequest, JsonRpcNotification, JsonRpcResponse, JsonRpcSuccess, JsonRpcErrorResponse, ParseOutcome, } from './jsonrpc.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":"AAAA,4GAA4G;AAE5G,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,KAAK,EACL,aAAa,EACb,eAAe,EACf,UAAU,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,YAAY,GACb,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/** `@czap/mcp-server` — MCP bridge for **LiteShip**; forwards tools to the `czap` CLI + capsule factory. */
+export { start } from './start.js';
+export { listTools, dispatchToolCall, dispatch } from './dispatch.js';
+export { runStdio } from './stdio.js';
+export { runHttp } from './http.js';
+// JSON-RPC 2.0 kernel — reusable beyond MCP.
+export { JsonRpcServer, jsonRpcServerCapsule, parse, errorResponse, successResponse, ParseError, InvalidRequest, MethodNotFound, InvalidParams, InternalError, } from './jsonrpc.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,4GAA4G;AAE5G,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,6CAA6C;AAC7C,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,KAAK,EACL,aAAa,EACb,eAAe,EACf,UAAU,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/jsonrpc.d.ts

@@ -0,0 +1,129 @@
+/**
+ * JsonRpcServer — framework-free JSON-RPC 2.0 kernel.
+ *
+ * Parses incoming wire bytes, classifies them as Request | Notification |
+ * Batch | InvalidRequest | ParseError, and produces responses (or null
+ * for notifications, which MUST NOT receive a response per §4.1).
+ *
+ * Exposed as a `pureTransform` arm capsule `mcp.jsonrpc-server` so it
+ * appears in the manifest and can be reused by future JSON-RPC surfaces
+ * beyond MCP.
+ *
+ * Conformance: JSON-RPC 2.0 specification (https://www.jsonrpc.org/specification).
+ *   §3 — `jsonrpc: "2.0"` required.
+ *   §4 — Request vs Notification distinguished by presence of `id`.
+ *   §4.1 — A Notification MUST NOT receive a Response.
+ *   §4.2 — Parse errors MUST emit a Response with code -32700, id null.
+ *   §5 — Response is `result` XOR `error`.
+ *   §5.1 — Standard error codes.
+ *   §6 — Batch: array of requests/notifications. Empty array → -32600.
+ *
+ * @module
+ */
+/** Per §4: `id` is string, number, or null. Absent = notification. */
+export type JsonRpcId = string | number | null;
+/** A JSON-RPC 2.0 request (has `id`). */
+export interface JsonRpcRequest {
+    readonly jsonrpc: '2.0';
+    readonly id: JsonRpcId;
+    readonly method: string;
+    readonly params?: readonly unknown[] | Record<string, unknown>;
+}
+/** A JSON-RPC 2.0 notification (no `id`). Per §4.1 MUST NOT be responded to. */
+export interface JsonRpcNotification {
+    readonly jsonrpc: '2.0';
+    readonly method: string;
+    readonly params?: readonly unknown[] | Record<string, unknown>;
+}
+/** Successful response per §5. */
+export interface JsonRpcSuccess {
+    readonly jsonrpc: '2.0';
+    readonly id: JsonRpcId;
+    readonly result: unknown;
+}
+/** Error response per §5 + §5.1. */
+export interface JsonRpcErrorResponse {
+    readonly jsonrpc: '2.0';
+    readonly id: JsonRpcId;
+    readonly error: {
+        readonly code: number;
+        readonly message: string;
+        readonly data?: unknown;
+    };
+}
+/** Either a success or error response. */
+export type JsonRpcResponse = JsonRpcSuccess | JsonRpcErrorResponse;
+export declare const ParseError: -32700;
+export declare const InvalidRequest: -32600;
+export declare const MethodNotFound: -32601;
+export declare const InvalidParams: -32602;
+export declare const InternalError: -32603;
+/** Discriminated union of every parse outcome the kernel produces. */
+export type ParseOutcome = {
+    readonly kind: 'request';
+    readonly message: JsonRpcRequest;
+} | {
+    readonly kind: 'notification';
+    readonly message: JsonRpcNotification;
+} | {
+    readonly kind: 'batch';
+    readonly outcomes: readonly ParseOutcome[];
+} | {
+    readonly kind: 'parse-error';
+} | {
+    readonly kind: 'invalid-request';
+    readonly id: JsonRpcId;
+};
+/**
+ * Parse a single JSON-RPC line. Distinguishes:
+ * - parse failure → `parse-error` (§4.2)
+ * - empty array → `invalid-request` per §6
+ * - non-object scalar → `invalid-request`
+ * - object with bad `jsonrpc`/`method` → `invalid-request`
+ * - object with `id` present → `request`
+ * - object without `id` → `notification`
+ * - non-empty array → `batch` with per-element outcomes
+ *
+ * Note (§4 id-vs-notification): `"id": null` is a Request with id null,
+ * not a notification. Only an absent id field marks a notification.
+ */
+declare function _parse(line: string): ParseOutcome;
+/** Construct a -32700 / -32600 / -32601 / -32602 / -32603 error response. */
+declare function _errorResponse(id: JsonRpcId, code: number, message: string, data?: unknown): JsonRpcErrorResponse;
+/** Construct a success response (§5). */
+declare function _successResponse(id: JsonRpcId, result: unknown): JsonRpcSuccess;
+export declare const parse: typeof _parse;
+export declare const errorResponse: typeof _errorResponse;
+export declare const successResponse: typeof _successResponse;
+/**
+ * Capsule definition for the kernel — placed in the catalog under the
+ * `pureTransform` arm so the factory compiler emits a generated test +
+ * bench pair and the manifest tracks the kernel's content address.
+ */
+export declare const jsonRpcServerCapsule: import("@czap/core").CapsuleDef<"pureTransform", string, {
+    kind: string;
+}, unknown>;
+/** Namespaced public surface of the kernel. */
+export declare const JsonRpcServer: {
+    readonly parse: typeof _parse;
+    readonly errorResponse: typeof _errorResponse;
+    readonly successResponse: typeof _successResponse;
+};
+export declare namespace JsonRpcServer {
+    /** Discriminated parse outcome. */
+    type Outcome = ParseOutcome;
+    /** Wire-shape request (§4). */
+    type Request = JsonRpcRequest;
+    /** Wire-shape notification (§4.1). */
+    type Notification = JsonRpcNotification;
+    /** Wire-shape response (§5). */
+    type Response = JsonRpcResponse;
+    /** Wire-shape success response. */
+    type Success = JsonRpcSuccess;
+    /** Wire-shape error response. */
+    type Error = JsonRpcErrorResponse;
+    /** Id type per §4. */
+    type Id = JsonRpcId;
+}
+export {};
+//# sourceMappingURL=jsonrpc.d.ts.map

package/dist/jsonrpc.d.ts.map

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