@zenalexa/unicli 0.213.1 → 0.215.0

package/dist/mcp/dispatch.d.ts

@@ -0,0 +1,46 @@
+/**
+ * MCP tool-call dispatcher — the bridge between JSON-RPC tool invocations
+ * and the invocation kernel.
+ *
+ * v0.213.3 R2: every MCP tool call funnels through `execute()` so the CLI
+ * and MCP surfaces produce byte-identical envelopes (modulo trace_id and
+ * duration_ms). Flat `params` shape preserved for D2 backward compat.
+ *
+ * Shape contract (backward compat with v0.213.2 and earlier):
+ *   - success → `{ content: [{type:"text", text: JSON.stringify({count, results}, null, 2)}],
+ *                  structuredContent: { type: "json", data: {count, results} } }`
+ *   - error   → `{ isError: true, content, structuredContent.data.suggestion, _meta }`
+ *   - warnings flow to `_meta.warnings` so agents can inspect them
+ */
+import type { AdapterManifest, AdapterCommand } from "../types.js";
+export interface McpStructuredContent {
+    type: "json";
+    data: unknown;
+}
+export interface McpToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent?: McpStructuredContent;
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+}
+/**
+ * 10 KB threshold above which MCP clients (Claude Code, Zed) may truncate
+ * tool output. When exceeded, we attach `_meta.anthropic/maxResultSizeChars`
+ * to raise the cap to 100 KB for this call.
+ */
+export declare const MAX_RESULT_SIZE_CHARS = 10000;
+/**
+ * Annotate a tool result with `_meta.anthropic/maxResultSizeChars` when the
+ * serialized payload exceeds MAX_RESULT_SIZE_CHARS.
+ */
+export declare function annotateIfLarge(result: McpToolResult): McpToolResult;
+/**
+ * Execute a resolved (adapter, command) pair via the invocation kernel and
+ * shape the result into the MCP `McpToolResult` envelope. Used by both the
+ * default `unicli_run` tool and every expanded `unicli_<site>_<command>`.
+ */
+export declare function runResolvedCommand(adapter: AdapterManifest, cmd: AdapterCommand, cmdName: string, args: Record<string, unknown>): Promise<McpToolResult>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/mcp/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/mcp/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAYpE;AAaD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,aAAa,CAAC,CA0DxB"}

package/dist/mcp/dispatch.js

@@ -0,0 +1,109 @@
+/**
+ * MCP tool-call dispatcher — the bridge between JSON-RPC tool invocations
+ * and the invocation kernel.
+ *
+ * v0.213.3 R2: every MCP tool call funnels through `execute()` so the CLI
+ * and MCP surfaces produce byte-identical envelopes (modulo trace_id and
+ * duration_ms). Flat `params` shape preserved for D2 backward compat.
+ *
+ * Shape contract (backward compat with v0.213.2 and earlier):
+ *   - success → `{ content: [{type:"text", text: JSON.stringify({count, results}, null, 2)}],
+ *                  structuredContent: { type: "json", data: {count, results} } }`
+ *   - error   → `{ isError: true, content, structuredContent.data.suggestion, _meta }`
+ *   - warnings flow to `_meta.warnings` so agents can inspect them
+ */
+import { buildInvocation, execute } from "../engine/kernel/execute.js";
+import { coerceLimit } from "../engine/args.js";
+/**
+ * 10 KB threshold above which MCP clients (Claude Code, Zed) may truncate
+ * tool output. When exceeded, we attach `_meta.anthropic/maxResultSizeChars`
+ * to raise the cap to 100 KB for this call.
+ */
+export const MAX_RESULT_SIZE_CHARS = 10_000;
+/**
+ * Annotate a tool result with `_meta.anthropic/maxResultSizeChars` when the
+ * serialized payload exceeds MAX_RESULT_SIZE_CHARS.
+ */
+export function annotateIfLarge(result) {
+    const totalChars = result.content.reduce((sum, c) => sum + c.text.length, 0);
+    if (totalChars > MAX_RESULT_SIZE_CHARS) {
+        return {
+            ...result,
+            _meta: {
+                ...result._meta,
+                "anthropic/maxResultSizeChars": 100_000,
+            },
+        };
+    }
+    return result;
+}
+function withWarnings(result, warnings) {
+    if (warnings.length === 0)
+        return result;
+    return {
+        ...result,
+        _meta: { ...result._meta, warnings: [...warnings] },
+    };
+}
+/**
+ * Execute a resolved (adapter, command) pair via the invocation kernel and
+ * shape the result into the MCP `McpToolResult` envelope. Used by both the
+ * default `unicli_run` tool and every expanded `unicli_<site>_<command>`.
+ */
+export async function runResolvedCommand(adapter, cmd, cmdName, args) {
+    // MCP preserves the flat-params contract. Apply the default `limit: 20`
+    // only when the adapter declares a `limit` arg — the kernel's ajv
+    // validator runs in strict mode (`additionalProperties: false`), so
+    // passing an undeclared `limit` would trip usage errors for adapters
+    // that don't paginate.
+    const declaresLimit = (cmd.adapterArgs ?? []).some((a) => a.name === "limit");
+    const mergedArgs = declaresLimit
+        ? { limit: 20, ...args }
+        : { ...args };
+    if (declaresLimit && args.limit !== undefined) {
+        const coerced = coerceLimit(args.limit);
+        if (coerced !== undefined)
+            mergedArgs.limit = coerced;
+    }
+    const inv = buildInvocation("mcp", adapter.name, cmdName, {
+        args: mergedArgs,
+        source: "mcp",
+    });
+    if (!inv) {
+        // Already filtered by handleRunCommand / handleExpandedTool before this
+        // point; still, guard so a misrouted call doesn't crash the server.
+        const errorData = {
+            error: `Unknown command: ${adapter.name} ${cmdName}`,
+            suggestion: "Use unicli_list to see available commands.",
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(errorData, null, 2) }],
+            structuredContent: { type: "json", data: errorData },
+            isError: true,
+        };
+    }
+    const result = await execute(inv);
+    if (result.error) {
+        const errorData = {
+            error: result.error.message,
+            code: result.error.code,
+            adapter_path: result.error.adapter_path,
+            step: result.error.step,
+            suggestion: result.error.suggestion,
+            trace_id: inv.trace_id,
+        };
+        const base = {
+            content: [{ type: "text", text: JSON.stringify(errorData, null, 2) }],
+            structuredContent: { type: "json", data: errorData },
+            isError: true,
+        };
+        return withWarnings(base, result.warnings);
+    }
+    const data = { count: result.results.length, results: result.results };
+    const base = {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        structuredContent: { type: "json", data },
+    };
+    return withWarnings(base, result.warnings);
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/mcp/dispatch.js.map

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

package/dist/mcp/handler.d.ts

@@ -0,0 +1,30 @@
+/**
+ * MCP JSON-RPC dispatch — `buildHandler(tools)` returns the per-request
+ * handler used by every transport (stdio, HTTP, Streamable HTTP).
+ *
+ * Extracted from `server.ts` so the top-level file only owns bootstrap,
+ * arg parsing, and transport wiring. This module owns:
+ *   - `initialize` / `ping` / `tools/list` / `tools/call` method dispatch
+ *   - The four built-in meta-tools (`unicli_list` / `unicli_run` /
+ *     `unicli_search` / `unicli_explore` + deprecated aliases)
+ *   - Fallthrough to expanded-tool dispatch via `./dispatch.ts`
+ */
+import { type McpTool } from "./tools.js";
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id?: number | string | null;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: number | string | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export declare function buildHandler(tools: McpTool[]): (req: JsonRpcRequest) => JsonRpcResponse | undefined | Promise<JsonRpcResponse | undefined>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/mcp/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/mcp/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAoSD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EAAE,GACf,CACD,GAAG,EAAE,cAAc,KAChB,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAkCtE"}

package/dist/mcp/handler.js

@@ -0,0 +1,293 @@
+/**
+ * MCP JSON-RPC dispatch — `buildHandler(tools)` returns the per-request
+ * handler used by every transport (stdio, HTTP, Streamable HTTP).
+ *
+ * Extracted from `server.ts` so the top-level file only owns bootstrap,
+ * arg parsing, and transport wiring. This module owns:
+ *   - `initialize` / `ping` / `tools/list` / `tools/call` method dispatch
+ *   - The four built-in meta-tools (`unicli_list` / `unicli_run` /
+ *     `unicli_search` / `unicli_explore` + deprecated aliases)
+ *   - Fallthrough to expanded-tool dispatch via `./dispatch.ts`
+ */
+import { getAllAdapters, listCommands, resolveCommand } from "../registry.js";
+import { annotateIfLarge, runResolvedCommand, } from "./dispatch.js";
+import { expandedRegistry } from "./tools.js";
+import { MCP_PROTOCOL_VERSION, VERSION } from "../constants.js";
+import { resolveElicitation } from "./elicitation.js";
+function handleListAdapters(params) {
+    let commands = listCommands();
+    const site = params.site;
+    const type = params.type;
+    if (site)
+        commands = commands.filter((c) => c.site.includes(site));
+    if (type)
+        commands = commands.filter((c) => c.type === type);
+    const adapters = getAllAdapters();
+    const siteMap = new Map();
+    for (const cmd of commands) {
+        let entry = siteMap.get(cmd.site);
+        if (!entry) {
+            const adapter = adapters.find((a) => a.name === cmd.site);
+            entry = { type: adapter?.type ?? cmd.type, commands: [] };
+            siteMap.set(cmd.site, entry);
+        }
+        entry.commands.push({ name: cmd.command, description: cmd.description });
+    }
+    const result = Array.from(siteMap.entries()).map(([name, info]) => ({
+        site: name,
+        type: info.type,
+        commands: info.commands,
+    }));
+    const data = {
+        total_sites: result.length,
+        total_commands: commands.length,
+        adapters: result,
+    };
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        structuredContent: { type: "json", data },
+    };
+}
+async function handleRunCommand(params) {
+    const site = params.site;
+    const command = params.command;
+    const args = params.args ?? {};
+    if (!site || !command) {
+        const errorData = { error: "site and command are required" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(errorData) }],
+            structuredContent: { type: "json", data: errorData },
+            isError: true,
+        };
+    }
+    const resolved = resolveCommand(site, command);
+    if (!resolved) {
+        const adapters = getAllAdapters();
+        const matchingSites = adapters
+            .filter((a) => a.name.includes(site))
+            .map((a) => ({
+            site: a.name,
+            commands: Object.keys(a.commands),
+        }));
+        const errorData = {
+            error: `Unknown command: ${site} ${command}`,
+            suggestion: matchingSites.length > 0
+                ? `Did you mean one of these? ${JSON.stringify(matchingSites)}`
+                : "Use list_adapters to see all available commands.",
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(errorData, null, 2) }],
+            structuredContent: { type: "json", data: errorData },
+            isError: true,
+        };
+    }
+    return runResolvedCommand(resolved.adapter, resolved.command, command, args);
+}
+/**
+ * Expanded-tool dispatcher — look up `unicli_<site>_<command>` in the
+ * registry populated by buildExpandedTools / buildDeferredTools.
+ */
+async function handleExpandedTool(toolName, args) {
+    if (!toolName.startsWith("unicli_"))
+        return undefined;
+    const entry = expandedRegistry.get(toolName);
+    if (!entry)
+        return undefined;
+    return runResolvedCommand(entry.adapter, entry.cmd, entry.cmdName, args);
+}
+function initializeResponse(id) {
+    return {
+        jsonrpc: "2.0",
+        id,
+        result: {
+            protocolVersion: MCP_PROTOCOL_VERSION,
+            capabilities: {
+                tools: { listChanged: false },
+                elicitation: { supported: true },
+            },
+            serverInfo: { name: "unicli", version: VERSION },
+        },
+    };
+}
+async function dispatchBuiltin(id, name, toolArgs) {
+    switch (name) {
+        case "unicli_list":
+        case "list_adapters": {
+            const result = handleListAdapters(toolArgs);
+            return { jsonrpc: "2.0", id, result: annotateIfLarge(result) };
+        }
+        case "unicli_run":
+        case "run_command": {
+            const result = await handleRunCommand(toolArgs);
+            return { jsonrpc: "2.0", id, result: annotateIfLarge(result) };
+        }
+        case "unicli_search":
+            return dispatchSearch(id, toolArgs);
+        case "unicli_explore":
+        case "unicli_discover":
+            return dispatchExplore(id, toolArgs);
+    }
+    return undefined;
+}
+async function dispatchSearch(id, toolArgs) {
+    const searchQuery = toolArgs.query;
+    const searchLimit = toolArgs.limit || 5;
+    if (!searchQuery) {
+        return {
+            jsonrpc: "2.0",
+            id,
+            error: { code: -32602, message: "Missing required parameter: query" },
+        };
+    }
+    const { search: searchFn } = await import("../discovery/search.js");
+    const results = searchFn(searchQuery, searchLimit);
+    const data = {
+        query: searchQuery,
+        count: results.length,
+        results: results.map((r) => ({
+            command: `unicli ${r.site} ${r.command}`,
+            site: r.site,
+            name: r.command,
+            description: r.description,
+            score: r.score,
+            category: r.category,
+            usage: r.usage,
+        })),
+    };
+    return {
+        jsonrpc: "2.0",
+        id,
+        result: annotateIfLarge({
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            structuredContent: { type: "json", data },
+        }),
+    };
+}
+async function dispatchExplore(id, toolArgs) {
+    const discoverUrl = toolArgs.url;
+    const discoverGoal = toolArgs.goal;
+    if (!discoverUrl) {
+        return {
+            jsonrpc: "2.0",
+            id,
+            error: { code: -32602, message: "Missing required parameter: url" },
+        };
+    }
+    if (!discoverUrl.startsWith("http://") &&
+        !discoverUrl.startsWith("https://")) {
+        return {
+            jsonrpc: "2.0",
+            id,
+            error: {
+                code: -32602,
+                message: "URL must start with http:// or https://",
+            },
+        };
+    }
+    const [{ execFile: ef }, { promisify: prom }] = await Promise.all([
+        import("node:child_process"),
+        import("node:util"),
+    ]);
+    const execFileP = prom(ef);
+    const discoverArgs = ["generate", discoverUrl, "--json"];
+    if (discoverGoal)
+        discoverArgs.push("--goal", discoverGoal);
+    try {
+        const { stdout } = await execFileP("unicli", discoverArgs, {
+            timeout: 120_000,
+            encoding: "utf-8",
+        });
+        return {
+            jsonrpc: "2.0",
+            id,
+            result: annotateIfLarge({
+                content: [{ type: "text", text: stdout }],
+            }),
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            jsonrpc: "2.0",
+            id,
+            result: annotateIfLarge({
+                content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+                isError: true,
+            }),
+        };
+    }
+}
+async function handleToolsCall(id, req) {
+    const params = req.params;
+    if (!params?.name) {
+        return {
+            jsonrpc: "2.0",
+            id,
+            error: { code: -32602, message: "Missing tool name" },
+        };
+    }
+    const toolArgs = params.arguments ?? {};
+    const builtin = await dispatchBuiltin(id, params.name, toolArgs);
+    if (builtin)
+        return builtin;
+    const result = await handleExpandedTool(params.name, toolArgs);
+    if (result) {
+        return { jsonrpc: "2.0", id, result: annotateIfLarge(result) };
+    }
+    return {
+        jsonrpc: "2.0",
+        id,
+        error: {
+            code: -32602,
+            message: `Unknown tool: ${params.name}. Use unicli_list to see available commands.`,
+        },
+    };
+}
+function handleElicitationResponse(id, req) {
+    const elicitParams = req.params;
+    if (elicitParams?.id == null || !elicitParams?.response) {
+        return {
+            jsonrpc: "2.0",
+            id,
+            error: {
+                code: -32602,
+                message: "Missing id or response in elicitation/response",
+            },
+        };
+    }
+    const resolved = resolveElicitation(elicitParams.id, elicitParams.response);
+    return { jsonrpc: "2.0", id, result: { resolved } };
+}
+export function buildHandler(tools) {
+    return function handleRequest(req) {
+        const id = req.id ?? null;
+        switch (req.method) {
+            case "initialize":
+                return initializeResponse(id);
+            case "notifications/initialized":
+                // Notifications have no response — transports already guard `if (response)`.
+                return undefined;
+            case "tools/list":
+                return { jsonrpc: "2.0", id, result: { tools } };
+            case "tools/call":
+                return handleToolsCall(id, req);
+            case "elicitation/response":
+                return handleElicitationResponse(id, req);
+            case "ping":
+                return { jsonrpc: "2.0", id, result: {} };
+            default:
+                if (id !== null && id !== undefined) {
+                    return {
+                        jsonrpc: "2.0",
+                        id,
+                        error: {
+                            code: -32601,
+                            message: `Method not found: ${req.method}`,
+                        },
+                    };
+                }
+                return undefined;
+        }
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/mcp/handler.js.map

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

package/dist/mcp/http-transport.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Simple JSON-RPC over HTTP transport for MCP.
+ *
+ * POST /mcp accepts a single JSON-RPC envelope and returns a single JSON
+ * response. GET /mcp returns server info — handy for health checks from a
+ * browser.
+ *
+ * Note: this is intentionally NOT a full MCP Streamable HTTP transport —
+ * no SSE event stream, no session resume. See `./streamable-http.ts` for
+ * that. Most clients that "speak HTTP" to MCP only need request/response,
+ * and starting with the simpler shape means zero new dependencies and a
+ * tiny attack surface.
+ */
+import type { buildHandler } from "./handler.js";
+export declare function startHttp(handler: ReturnType<typeof buildHandler>, port: number, authEnabled?: boolean): Promise<void>;
+//# sourceMappingURL=http-transport.d.ts.map

package/dist/mcp/http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../src/mcp/http-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,cAAc,CAAC;AAsFjE,wBAAsB,SAAS,CAC7B,OAAO,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,WAAW,UAAQ,GAClB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/mcp/http-transport.js

@@ -0,0 +1,121 @@
+/**
+ * Simple JSON-RPC over HTTP transport for MCP.
+ *
+ * POST /mcp accepts a single JSON-RPC envelope and returns a single JSON
+ * response. GET /mcp returns server info — handy for health checks from a
+ * browser.
+ *
+ * Note: this is intentionally NOT a full MCP Streamable HTTP transport —
+ * no SSE event stream, no session resume. See `./streamable-http.ts` for
+ * that. Most clients that "speak HTTP" to MCP only need request/response,
+ * and starting with the simpler shape means zero new dependencies and a
+ * tiny attack surface.
+ */
+import { createServer, } from "node:http";
+import { getAllAdapters, listCommands } from "../registry.js";
+import { handleOAuthRoute, createOAuthMiddleware } from "./oauth.js";
+import { VERSION } from "../constants.js";
+import { buildDefaultTools } from "./tools.js";
+const MAX_BODY = 1_048_576; // 1 MB
+function writeJson(res, code, payload) {
+    res.writeHead(code, { "Content-Type": "application/json" });
+    res.end(JSON.stringify(payload));
+}
+function serveHealth(res) {
+    const adapterCount = getAllAdapters().length;
+    const commandCount = listCommands().length;
+    const defaultToolCount = buildDefaultTools().length;
+    const expandedCount = commandCount + defaultToolCount;
+    writeJson(res, 200, {
+        status: "ok",
+        adapters: adapterCount,
+        commands: commandCount,
+        tools: { default: defaultToolCount, expanded: expandedCount },
+        version: VERSION,
+    });
+}
+async function consumeBody(req, res) {
+    const chunks = [];
+    let bodySize = 0;
+    return await new Promise((resolve) => {
+        req.on("data", (chunk) => {
+            bodySize += chunk.length;
+            if (bodySize > MAX_BODY) {
+                writeJson(res, 413, {
+                    jsonrpc: "2.0",
+                    id: null,
+                    error: { code: -32600, message: "Request too large" },
+                });
+                req.destroy();
+                resolve(null);
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on("end", () => resolve(Buffer.concat(chunks)));
+        req.on("error", () => resolve(null));
+    });
+}
+async function dispatchPost(req, res, handler) {
+    const bodyBuf = await consumeBody(req, res);
+    if (!bodyBuf)
+        return;
+    const body = bodyBuf.toString("utf-8");
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        writeJson(res, 400, {
+            jsonrpc: "2.0",
+            id: null,
+            error: { code: -32700, message: "Parse error" },
+        });
+        return;
+    }
+    try {
+        const response = await handler(parsed);
+        if (!response) {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        writeJson(res, 200, response);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        writeJson(res, 500, {
+            jsonrpc: "2.0",
+            id: parsed.id ?? null,
+            error: { code: -32603, message: `Internal error: ${message}` },
+        });
+    }
+}
+export async function startHttp(handler, port, authEnabled = false) {
+    const oauthMiddleware = authEnabled ? createOAuthMiddleware() : null;
+    const server = createServer((req, res) => {
+        if (authEnabled && handleOAuthRoute(req, res))
+            return;
+        if (req.method === "GET" &&
+            (req.url === "/" || req.url === "/mcp" || req.url === "/health")) {
+            serveHealth(res);
+            return;
+        }
+        if (req.method !== "POST" || req.url !== "/mcp") {
+            writeJson(res, 404, { error: "POST /mcp" });
+            return;
+        }
+        if (oauthMiddleware?.(req, res))
+            return;
+        void dispatchPost(req, res, handler);
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(port, "127.0.0.1", () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    process.stderr.write(`unicli MCP server v${VERSION} — HTTP transport on http://127.0.0.1:${port}/mcp\n`);
+}
+//# sourceMappingURL=http-transport.js.map

package/dist/mcp/http-transport.js.map

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