billion-context 0.1.43 → 0.1.44

package/dist/mcp.js

@@ -0,0 +1,159 @@
+import { createRequire as __biliCreateRequire } from 'node:module';
+const require = __biliCreateRequire(import.meta.url);
+
+// src/mcp.ts
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+var VERSION = (() => {
+  try {
+    const here = fileURLToPath(import.meta.url);
+    const pkg = path.join(path.dirname(here), "..", "package.json");
+    return JSON.parse(fs.readFileSync(pkg, "utf8")).version ?? "dev";
+  } catch {
+    return "dev";
+  }
+})();
+var PROXY_ORIGIN = process.env.BILI_MCP_PROXY ?? "http://127.0.0.1:8787";
+var CONVERSATION_FROM_ENV = process.env.CLAUDE_CODE_SESSION_ID?.trim() || process.env.BILI_CONVERSATION_ID?.trim() || void 0;
+var IDENTITY_BINDING = Boolean(process.env.CLAUDE_CODE_SESSION_ID?.trim());
+var manifestTools = [];
+var conversationId = CONVERSATION_FROM_ENV;
+var registered = false;
+var initialized = false;
+function send(msg) {
+  process.stdout.write(JSON.stringify(msg) + "\n");
+}
+function sendResult(id, result) {
+  if (id === null) return;
+  send({ jsonrpc: "2.0", id, result });
+}
+function sendError(id, code, message) {
+  if (id === null) return;
+  send({ jsonrpc: "2.0", id, error: { code, message } });
+}
+async function fetchManifest() {
+  const res = await fetch(`${PROXY_ORIGIN}/__bili/plugin/manifest`);
+  if (!res.ok) throw new Error(`manifest fetch failed: ${res.status}`);
+  const data = await res.json();
+  const anthropic = data.tools?.anthropic ?? [];
+  manifestTools = anthropic.map((t) => ({ name: t.name, description: t.description, inputSchema: t.input_schema }));
+  if (manifestTools.length === 0) throw new Error("manifest served no anthropic tools");
+}
+async function forwardTool(tool, args) {
+  const res = await fetch(`${PROXY_ORIGIN}/__bili/plugin/tool`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ conversationId, tool, args })
+  });
+  const data = await res.json();
+  if (!res.ok || !data.ok) throw new Error(data.error ?? `tool forward failed: ${res.status}`);
+  return data.result ?? "";
+}
+var ERR_TOOL = -32602;
+async function handleMessage(msg) {
+  const { id = null, method } = msg;
+  const params = typeof msg.params === "object" && msg.params !== null ? msg.params : {};
+  switch (method) {
+    case "initialize": {
+      const fromMeta = params._meta?.ui?.sessionId?.trim();
+      if (fromMeta) conversationId ??= fromMeta;
+      initialized = true;
+      if (conversationId && !registered) {
+        const registerFetch = fetch(`${PROXY_ORIGIN}/__bili/plugin/register`, {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({ conversationId, agent: "mcp", identity: IDENTITY_BINDING })
+        });
+        registered = true;
+        if (IDENTITY_BINDING) {
+          void registerFetch.catch(() => {
+          });
+        } else {
+          await registerFetch.catch(() => {
+          });
+        }
+      }
+      sendResult(id, {
+        protocolVersion: "2025-06-18",
+        serverInfo: { name: "bili", version: VERSION },
+        capabilities: { tools: {} }
+      });
+      return;
+    }
+    case "notifications/initialized":
+      return;
+    case "tools/list": {
+      if (!initialized) {
+        sendError(id, -32002, "server not initialized");
+        return;
+      }
+      sendResult(id, { tools: manifestTools });
+      return;
+    }
+    case "tools/call": {
+      const tool = typeof params.name === "string" ? params.name : "";
+      const args = params.arguments && typeof params.arguments === "object" ? params.arguments : {};
+      if (!tool) {
+        sendError(id, ERR_TOOL, "params.name is required");
+        return;
+      }
+      if (!conversationId) {
+        sendError(id, ERR_TOOL, "no conversation id (set BILI_CONVERSATION_ID or connect via Claude Code MCP session meta)");
+        return;
+      }
+      try {
+        const text = await forwardTool(tool, args);
+        sendResult(id, { content: [{ type: "text", text }], isError: false });
+      } catch (err) {
+        sendResult(id, { content: [{ type: "text", text: `bili tool error: ${err instanceof Error ? err.message : String(err)}` }], isError: true });
+      }
+      return;
+    }
+    case "ping":
+      sendResult(id, {});
+      return;
+    default:
+      if (method?.startsWith("notifications/")) return;
+      sendError(id, -32601, `method not found: ${method ?? "(none)"}`);
+  }
+}
+async function mcpMain() {
+  try {
+    await fetchManifest();
+  } catch (err) {
+    console.error(`bili-mcp: ${err instanceof Error ? err.message : String(err)} (proxy at ${PROXY_ORIGIN})`);
+    process.exit(1);
+  }
+  let buf = "";
+  process.stdin.setEncoding("utf8");
+  process.stdin.on("data", (chunk) => {
+    buf += chunk;
+    let nl;
+    while ((nl = buf.indexOf("\n")) >= 0) {
+      const line = buf.slice(0, nl).trim();
+      buf = buf.slice(nl + 1);
+      if (!line) continue;
+      let parsed;
+      try {
+        parsed = JSON.parse(line);
+      } catch {
+        continue;
+      }
+      if (parsed && typeof parsed === "object") {
+        void handleMessage(parsed);
+      }
+    }
+  });
+  process.stdin.on("end", () => process.exit(0));
+}
+function runMcpStdio() {
+  void mcpMain();
+}
+if (process.argv[1] && /(?:^|[\\/])mcp\.(?:ts|js)$/.test(process.argv[1])) {
+  void mcpMain();
+}
+export {
+  runMcpStdio
+};
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp.ts"],"sourcesContent":["// MCP stdio thin shell for launcher mode (#162): a single \"bili\" MCP server\n// the hosts load via --mcp-config / -c mcp_servers.bili. It fetches the\n// proxy's plugin manifest (single source of truth — zero schema drift),\n// exposes the 4 ACP tools over stdio JSON-RPC, and forwards executes to\n// POST /__bili/plugin/tool. Claude Code passes its session id via the MCP\n// initialize request's _meta.ui.sessionId (documented SessionStart context);\n// we also accept BILI_CONVERSATION_ID env (codex spawn-time registration).\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst VERSION = (() => {\n    try {\n        const here = fileURLToPath(import.meta.url);\n        const pkg = path.join(path.dirname(here), \"..\", \"package.json\");\n        return (JSON.parse(fs.readFileSync(pkg, \"utf8\")).version as string) ?? \"dev\";\n    } catch {\n        return \"dev\";\n    }\n})();\ntype JsonRpcId = string | number | null;\n\ntype McpToolDef = {\n    name: string;\n    description?: string;\n    inputSchema: unknown;\n};\n// Claude Code passes the session id as an env var to MCP children (verified\n// against claude 2.1.227: CLAUDE_CODE_SESSION_ID) — and puts the SAME id on\n// every model request (x-claude-code-session-id), so binding is by identity.\n// BILI_CONVERSATION_ID (launcher-spawned hosts like codex) has no matching\n// request id — binding is headless (next NEW session).\nconst PROXY_ORIGIN = process.env.BILI_MCP_PROXY ?? \"http://127.0.0.1:8787\";\nconst CONVERSATION_FROM_ENV = process.env.CLAUDE_CODE_SESSION_ID?.trim() || process.env.BILI_CONVERSATION_ID?.trim() || undefined;\nconst IDENTITY_BINDING = Boolean(process.env.CLAUDE_CODE_SESSION_ID?.trim());\nlet manifestTools: McpToolDef[] = [];\nlet conversationId = CONVERSATION_FROM_ENV;\nlet registered = false;\nlet initialized = false;\nfunction send(msg: unknown): void {\n    process.stdout.write(JSON.stringify(msg) + \"\\n\");\n}\n\nfunction sendResult(id: JsonRpcId, result: unknown): void {\n    if (id === null) return; // notification — no response expected\n    send({ jsonrpc: \"2.0\", id, result });\n}\n\nfunction sendError(id: JsonRpcId, code: number, message: string): void {\n    if (id === null) return;\n    send({ jsonrpc: \"2.0\", id, error: { code, message } });\n}\n\nasync function fetchManifest(): Promise<void> {\n    const res = await fetch(`${PROXY_ORIGIN}/__bili/plugin/manifest`);\n    if (!res.ok) throw new Error(`manifest fetch failed: ${res.status}`);\n    const data = (await res.json()) as { tools?: Record<string, { name: string; description?: string; input_schema?: unknown }[]> };\n    // Anthropic wire shape is the canonical MCP-compatible schema source.\n    const anthropic = data.tools?.anthropic ?? [];\n    manifestTools = anthropic.map((t) => ({ name: t.name, description: t.description, inputSchema: t.input_schema }));\n    if (manifestTools.length === 0) throw new Error(\"manifest served no anthropic tools\");\n}\n\nasync function forwardTool(tool: string, args: unknown): Promise<string> {\n    const res = await fetch(`${PROXY_ORIGIN}/__bili/plugin/tool`, {\n        method: \"POST\",\n        headers: { \"content-type\": \"application/json\" },\n        body: JSON.stringify({ conversationId, tool, args }),\n    });\n    const data = (await res.json()) as { ok?: boolean; result?: string; error?: string };\n    if (!res.ok || !data.ok) throw new Error(data.error ?? `tool forward failed: ${res.status}`);\n    return data.result ?? \"\";\n}\n\nconst ERR_TOOL = -32602;\n\nasync function handleMessage(msg: {\n    id?: JsonRpcId;\n    method?: string;\n    params?: {\n        _meta?: { ui?: { sessionId?: string } };\n        [k: string]: unknown;\n    };\n}): Promise<void> {\n    const { id = null, method } = msg;\n    const params = typeof msg.params === \"object\" && msg.params !== null ? msg.params : {};\n    switch (method) {\n        case \"initialize\": {\n            // Session id arrives as an env var on the child process (claude)\n            // or is injected at spawn time (launcher hosts). The MCP spec\n            // guarantees the host waits for this response before calling\n            // tools, and claude -p fires its first model request around the\n            // same time — registering here is still the earliest we can be.\n            // Identity-mode registrations bind on any later request, so the\n            // race only matters for headless mode.\n            const fromMeta = params._meta?.ui?.sessionId?.trim();\n            if (fromMeta) conversationId ??= fromMeta;\n            initialized = true;\n            if (conversationId && !registered) {\n                const registerFetch = fetch(`${PROXY_ORIGIN}/__bili/plugin/register`, {\n                    method: \"POST\",\n                    headers: { \"content-type\": \"application/json\" },\n                    body: JSON.stringify({ conversationId, agent: \"mcp\", identity: IDENTITY_BINDING }),\n                });\n                registered = true; // issue-once: a repeated initialize must not re-register\n                if (IDENTITY_BINDING) {\n                    // Identity-mode binding survives any arrival order —\n                    // respond immediately so pipelined hosts are not stuck\n                    // behind the register round-trip.\n                    void registerFetch.catch(() => {});\n                } else {\n                    // Headless binding is order-sensitive: the register MUST\n                    // land before the host's first model request, and hosts\n                    // that pipeline tools/list would otherwise race past it.\n                    await registerFetch.catch(() => {});\n                }\n            }\n            sendResult(id, {\n                protocolVersion: \"2025-06-18\",\n                serverInfo: { name: \"bili\", version: VERSION },\n                capabilities: { tools: {} },\n            });\n            return;\n        }\n        case \"notifications/initialized\":\n            return;\n        case \"tools/list\": {\n            if (!initialized) {\n                sendError(id, -32002, \"server not initialized\");\n                return;\n            }\n            sendResult(id, { tools: manifestTools });\n            return;\n        }\n        case \"tools/call\": {\n            const tool = typeof params.name === \"string\" ? params.name : \"\";\n            const args = params.arguments && typeof params.arguments === \"object\" ? params.arguments : {};\n            if (!tool) {\n                sendError(id, ERR_TOOL, \"params.name is required\");\n                return;\n            }\n            if (!conversationId) {\n                sendError(id, ERR_TOOL, \"no conversation id (set BILI_CONVERSATION_ID or connect via Claude Code MCP session meta)\");\n                return;\n            }\n            try {\n                const text = await forwardTool(tool, args);\n                sendResult(id, { content: [{ type: \"text\", text }], isError: false });\n            } catch (err) {\n                // Tool-level failures are results (isError), not JSON-RPC\n                // errors, so the host surfaces them to the model.\n                sendResult(id, { content: [{ type: \"text\", text: `bili tool error: ${err instanceof Error ? err.message : String(err)}` }], isError: true });\n            }\n            return;\n        }\n        case \"ping\":\n            sendResult(id, {});\n            return;\n        default:\n            if (method?.startsWith(\"notifications/\")) return;\n            sendError(id, -32601, `method not found: ${method ?? \"(none)\"}`);\n    }\n}\nasync function mcpMain(): Promise<void> {\n    try {\n        await fetchManifest();\n    } catch (err) {\n        console.error(`bili-mcp: ${err instanceof Error ? err.message : String(err)} (proxy at ${PROXY_ORIGIN})`);\n        process.exit(1);\n    }\n    let buf = \"\";\n    process.stdin.setEncoding(\"utf8\");\n    process.stdin.on(\"data\", (chunk: string) => {\n        buf += chunk;\n        let nl: number;\n        while ((nl = buf.indexOf(\"\\n\")) >= 0) {\n            const line = buf.slice(0, nl).trim();\n            buf = buf.slice(nl + 1);\n            if (!line) continue;\n            let parsed: unknown;\n            try {\n                parsed = JSON.parse(line);\n            } catch {\n                continue;\n            }\n            if (parsed && typeof parsed === \"object\") {\n                void handleMessage(parsed as Parameters<typeof handleMessage>[0]);\n            }\n        }\n    });\n    process.stdin.on(\"end\", () => process.exit(0));\n}\n\n/** CLI entry (`bili mcp`): the stdio loop keeps the process alive. */\nexport function runMcpStdio(): void {\n    void mcpMain();\n}\n\n// Direct entry (dist/mcp.js spawned by the injected MCP config, or the ts\n// source under tsx in tests): run only when invoked as the script itself,\n// never when imported by the CLI.\nif (process.argv[1] && /(?:^|[\\\\/])mcp\\.(?:ts|js)$/.test(process.argv[1])) {\n    void mcpMain();\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "billion-context",
-  "version": "0.1.43",
+  "version": "0.1.44",
   "description": "Universal context-compression proxy for AI coding agents. Sits between any agent and its model API, rewriting Anthropic/OpenAI streams with acp-kernel compression. Any agent that can set a base URL (Claude Code, Codex, Cursor, Aider) works out of the box.",
   "type": "module",
   "main": "dist/index.js",