billion-context 0.1.43 → 0.1.45

package/README.md

@@ -61,9 +61,49 @@ Three ways to use it — pick one:
   or when you want to pin an exact value. Routing is the same `/bili/` prefix
   either way — the config only changes which context window the proxy uses.
 
+### Agent plugin mode (内外呼应)
+
+For a native-plugin experience, an agent can run a small cooperative plugin
+alongside the proxy: the plugin registers the four ACP tools
+(`compress` / `decompress` / `search_context` / `acp_status`) natively with
+the agent and drives the agent's own tool loop, while the proxy stays the
+compression authority (state, history folding, philosophy prompt, nudges).
+Tool schemas are served by the proxy itself (`GET /__bili/plugin/manifest`),
+so plugin and proxy can never drift. See [PLUGIN.md](PLUGIN.md) for the
+protocol spec. Plugin-equipped sessions are detected automatically via
+request headers — wire-level tool injection is then suppressed for them
+(no double compression, native tool UX). Works in both proxy modes: the
+`/bili/` prefix baseURL **and MITM transparent mode** — the launcher
+(`bili pi` / `bili codex` / `bili claude`) exports `BILLION_CONTEXT_PROXY`
+for plugins to detect; the plugin can also report the agent's own model
+context window (`x-bili-plugin-context-window`) and read live context
+usage via `GET /__bili/plugin/status`.
+
 Compression is injected automatically — you only configure routing, never
 compression itself.
 
+For pi and omp, the plugin ships **inside billion-context itself** — no
+separate package to install:
+
+```bash
+bili plugin install pi      # adds this billion-context install to pi's settings.json (packages)
+bili plugin install omp     # same for omp (config.yml extensions)
+bili plugin install claude  # registers the bili MCP server (claude mcp add, user scope)
+bili plugin install codex   # appends [mcp_servers.bili] to ~/.codex/config.toml
+bili plugin install opencode  # adds mcp.bili to ~/.config/opencode/opencode.json
+bili plugin list            # install status for every supported host
+bili plugin remove pi       # undo (original files backed up to *.bili-bak once)
+```
+
+The installed plugin is a **thin** one (~5 KB, zero runtime deps): it just
+detects the proxy (from the `/bili/` baseURL or `BILLION_CONTEXT_PROXY`),
+fetches tool schemas from the proxy, registers native tools, and forwards
+executions — the proxy remains the single compression authority, so plugin
+and proxy always match versions. Killing it entirely: `BILLION_CONTEXT_PLUGIN=0`.
+
+Hosts without a plugin API (claude, codex, opencode) install the MCP
+bridge instead (`dist/mcp.js`), same protocol underneath.
+
 ### Option 0 — Launcher (`bili pi` / `bili codex` / `bili claude`)
 
 The launcher wraps a client in one command: it starts a proxy on an
@@ -83,6 +123,35 @@ bili test pi                          # quick end-to-end smoke test of the pi pa
 bili pi --mitm-domain api.foo.com     # add a domain to the MITM whitelist
 ```
 
+**Plugin-in-launcher mode (#162)** — for `claude` and `codex` the launcher
+additionally injects a single `bili` MCP server (`--mcp-config` for claude,
+`-c mcp_servers.bili.*` for codex — both ephemeral, nothing written to host
+config). The traffic route is **unchanged by default** — the transparent-
+MITM proxy as before — so existing setups keep working exactly as they did
+(OAuth-subscription traffic, custom relay endpoints). Opt in to **direct URL
+routing** (`BILI_LAUNCHER_DIRECT=1`) to drop MITM/CA trust entirely (claude's
+`ANTHROPIC_BASE_URL` / codex's provider `base_url` pointing at the `/bili/`
+prefix); the launcher prints a warning when direct mode changes your traffic
+route. The result is the native-plugin experience of [PLUGIN.md](PLUGIN.md)
+with zero setup: the four ACP tools appear as native MCP tools, executed on
+the proxy under the session lock, while the proxy keeps state, folding,
+philosophy prompt and nudges. Session binding is automatic — claude passes
+its session id to MCP children and on every request; codex spawns bind on
+first sight. Plugin mode is opt-in while host-flag compatibility soaks: set
+`BILI_LAUNCHER_PLUGIN=1` to enable the native MCP tools (verified with
+claude 2.1.227 / codex 0.147.0; `BILI_LAUNCHER_PLUGIN=0` forces the plain
+wire-injected launcher once the default flips on).
+`BILI_LAUNCHER_DIRECT=1` is an opt-in, not an opt-out.
+
+Mode matrix:
+
+| Mode | Tools surface | Setup | When |
+|------|--------------|-------|------|
+| Launcher + MCP (`BILI_LAUNCHER_PLUGIN=1`) | native MCP tools | one env var | best UX; opt-in while soaking |
+| Launcher wire mode (default for claude/codex) | proxy-injected wire tools | none — just `bili claude` / `bili codex` | default until plugin mode soaks |
+| Manual plugin (pi etc.) | agent-side plugin | install plugin | hosts with plugin APIs |
+| Manual baseURL | proxy-injected wire tools | edit client config | exotic hosts |
+
 How the client is pointed at the proxy (set automatically in the child env):
 
 | Client      | Proxy redirect      | CA trust env var        |

package/README.zh-CN.md

@@ -47,6 +47,21 @@ npm install -g billion-context
 - **零配置(最简单):** 在客户端 baseURL 前面加上代理地址 + `/bili/`。无需配置文件 —— context 窗口自动从 [models.dev](https://models.dev) registry 查询。`/bili/` 前缀还是个自检测信号:billion-context 的客户端扩展(billion-context-pi / opencode-acp)能在自己的 baseUrl 里认出它并自禁用,避免双层压缩。
 - **显式 context 窗口覆盖:** 在配置文件(或网页)里按 URL 声明 context 窗口,用于 registry 不认识的端点,或想钉死一个精确值的场景。两种方式路由都是同一个 `/bili/` 前缀 —— 配置只改变代理用哪个 context 窗口。
 
+### Agent 插件模式(内外呼应)
+
+想要原生插件体验,可以在 agent 内部装一个配合代理的插件:插件把四个
+ACP 工具(`compress` / `decompress` / `search_context` / `acp_status`)
+原生注册进 agent、由 agent 自己的工具循环驱动,而代理仍然是压缩引擎
+(状态、历史折叠、压缩哲学 prompt、nudge 全归代理)。工具 schema 由
+代理统一下发(`GET /__bili/plugin/manifest`),插件与代理永远不会版本
+漂移。协议规范见 [PLUGIN.md](PLUGIN.md)。带插件的会话通过请求头自动
+识别 —— 该会话的 wire 层工具注入自动关闭(不会双重压缩,工具体验原生)。
+两种代理模式都支持:`/bili/` 前缀 baseURL **和 MITM 透明模式** ——
+launcher(`bili pi` / `bili codex` / `bili claude`)会导出
+`BILLION_CONTEXT_PROXY` 供插件检测;插件还可以上报 agent 自己的模型
+上下文窗口(`x-bili-plugin-context-window`),并通过
+`GET /__bili/plugin/status` 读取实时上下文水位。
+
 压缩是自动注入的 —— 你只需配置路由,无需配置压缩本身。
 
 ### 方式 A —— 零配置(`/bili/` 前缀)

package/dist/agent/omp.js

@@ -0,0 +1,182 @@
+import { createRequire as __biliCreateRequire } from 'node:module';
+const require = __biliCreateRequire(import.meta.url);
+
+// src/agent/shared.ts
+var MANIFEST_TIMEOUT_MS = 5e3;
+var TOOL_TIMEOUT_MS = 6e4;
+function proxyBaseFromUrl(baseUrl) {
+  if (!baseUrl) return void 0;
+  try {
+    const url = new URL(baseUrl);
+    if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
+    const segments = url.pathname.split("/").filter((s) => s.length > 0);
+    if (segments[0] !== "bili") return void 0;
+    const rest = url.pathname.slice(url.pathname.indexOf("bili") + "bili".length);
+    if (!/^\/https?:\/\//.test(rest)) return void 0;
+    return `${url.protocol}//${url.host}`;
+  } catch {
+    return void 0;
+  }
+}
+function proxyBaseFromEnv() {
+  const raw = process.env.BILLION_CONTEXT_PROXY?.trim();
+  if (!raw) return void 0;
+  try {
+    const url = new URL(raw);
+    return url.protocol === "http:" || url.protocol === "https:" ? `${url.protocol}//${url.host}` : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function detectProxyBase(baseUrl) {
+  if (process.env.BILLION_CONTEXT_PLUGIN === "0") return void 0;
+  return proxyBaseFromUrl(baseUrl) ?? proxyBaseFromEnv();
+}
+async function fetchJson(url, init, timeoutMs, externalSignal) {
+  const ac = new AbortController();
+  if (externalSignal?.aborted) ac.abort();
+  const timer = setTimeout(() => ac.abort(), timeoutMs);
+  const onExternalAbort = () => ac.abort();
+  externalSignal?.addEventListener("abort", onExternalAbort, { once: true });
+  try {
+    let res;
+    try {
+      res = await fetch(url, { ...init, signal: ac.signal });
+    } catch (err) {
+      if (ac.signal.aborted && !externalSignal?.aborted) throw new Error(`timeout after ${timeoutMs}ms: ${url}`);
+      throw err;
+    }
+    const text = await res.text();
+    let json = void 0;
+    try {
+      json = JSON.parse(text);
+    } catch {
+      json = void 0;
+    }
+    return { ok: res.ok, status: res.status, json };
+  } finally {
+    clearTimeout(timer);
+    externalSignal?.removeEventListener("abort", onExternalAbort);
+  }
+}
+async function fetchManifest(proxyBase) {
+  const { ok, status, json } = await fetchJson(`${proxyBase}/__bili/plugin/manifest`, void 0, MANIFEST_TIMEOUT_MS);
+  if (!ok || !json || typeof json !== "object") throw new Error(`manifest fetch failed: ${status}`);
+  const data = json;
+  const tools = (data.tools?.anthropic ?? []).filter((t) => typeof t.name === "string");
+  if (tools.length === 0) throw new Error("manifest served no anthropic tools");
+  return tools.map((t) => ({ name: t.name, description: t.description, inputSchema: t.input_schema ?? { type: "object", properties: {} } }));
+}
+async function forwardTool(proxyBase, conversationId, tool, args, signal) {
+  const { ok, status, json } = await fetchJson(`${proxyBase}/__bili/plugin/tool`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ conversationId, tool, args: args ?? {} })
+  }, TOOL_TIMEOUT_MS, signal);
+  const data = json;
+  if (!ok || !data?.ok) {
+    throw new Error(`bili proxy tool ${tool} failed (${status}): ${data?.error ?? "unknown error"}`);
+  }
+  return data.result ?? "";
+}
+
+// src/agent/pi.ts
+function agentName(override) {
+  if (override) return override;
+  return process.env.BILLION_CONTEXT_PLUGIN_AGENT === "omp" ? "omp" : "pi";
+}
+function proxyBaseForCtx(ctx) {
+  return detectProxyBase(ctx.model?.baseUrl);
+}
+function sessionIdOf(ctx) {
+  try {
+    const sid = ctx.sessionManager?.getSessionId?.();
+    return typeof sid === "string" ? sid : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function manifestToTool(proxyBase, tool, agent) {
+  return {
+    name: tool.name,
+    description: tool.description,
+    parameters: tool.inputSchema,
+    execute: async (_toolCallId, params, signal, _onUpdate, ctx) => {
+      const conversationId = sessionIdOf(ctx) ?? "unknown";
+      try {
+        const output = await forwardTool(proxyBase, conversationId, tool.name, params, signal);
+        return { content: [{ type: "text", text: output }] };
+      } catch (err) {
+        return { content: [{ type: "text", text: `bili tool error: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
+      }
+    }
+  };
+}
+var RETRY_INTERVAL_MS = 1e4;
+async function registerTools(pi, ctx, state, agent) {
+  const proxyBase = proxyBaseForCtx(ctx);
+  if (proxyBase === void 0) return;
+  const sid = sessionIdOf(ctx) ?? "";
+  if (sid === state.sid) return;
+  if (state.pending !== void 0) return state.pending;
+  if (state.retryAt !== void 0 && Date.now() < state.retryAt) return;
+  state.pending = (async () => {
+    let tools;
+    try {
+      tools = await fetchManifest(proxyBase);
+    } catch (err) {
+      state.retryAt = Date.now() + RETRY_INTERVAL_MS;
+      console.error(`bili-plugin(${agent}): manifest fetch failed: ${err instanceof Error ? err.message : String(err)} \u2014 retrying in ${RETRY_INTERVAL_MS / 1e3}s`);
+      return;
+    }
+    try {
+      for (const t of tools) pi.registerTool(manifestToTool(proxyBase, t, agent));
+      state.sid = sid;
+      state.retryAt = void 0;
+    } catch (err) {
+      state.sid = void 0;
+      state.retryAt = Date.now() + RETRY_INTERVAL_MS;
+      console.error(`bili-plugin(${agent}): tool registration deferred (${err instanceof Error ? err.message : String(err)}) \u2014 retrying in ${RETRY_INTERVAL_MS / 1e3}s`);
+    }
+  })();
+  try {
+    await state.pending;
+  } finally {
+    state.pending = void 0;
+  }
+}
+function createBiliPlugin(agentOverride) {
+  return function biliPlugin(pi) {
+    const agent = agentName(agentOverride);
+    const state = {};
+    pi.on("before_provider_headers", (event, ctx) => {
+      try {
+        if (proxyBaseForCtx(ctx) === void 0) return;
+        const headers = event.headers;
+        if (headers === void 0 || typeof headers !== "object" || Array.isArray(headers)) return;
+        const sid = sessionIdOf(ctx);
+        if (sid !== void 0) headers["x-bili-plugin-conversation"] = sid;
+        headers["x-bili-plugin"] = agent;
+        const window = ctx.model?.contextWindow;
+        if (typeof window === "number" && Number.isFinite(window) && window > 0) {
+          headers["x-bili-plugin-context-window"] = String(Math.floor(window));
+        }
+      } catch (err) {
+        console.error(`bili-plugin(${agent}): header stamp skipped (${err instanceof Error ? err.message : String(err)})`);
+      }
+      void registerTools(pi, ctx, state, agent).catch((err) => console.error(`bili-plugin(${agent}): ${err instanceof Error ? err.message : String(err)}`));
+    });
+    pi.on("session_start", (_event, ctx) => {
+      state.sid = void 0;
+      void registerTools(pi, ctx, state, agent).catch((err) => console.error(`bili-plugin(${agent}): ${err instanceof Error ? err.message : String(err)}`));
+    });
+  };
+}
+var pi_default = createBiliPlugin();
+
+// src/agent/omp.ts
+var omp_default = createBiliPlugin("omp");
+export {
+  omp_default as default
+};
+//# sourceMappingURL=omp.js.map

package/dist/agent/omp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/agent/shared.ts","../../src/agent/pi.ts","../../src/agent/omp.ts"],"sourcesContent":["// Shared thin-plugin core for agent-side extensions (\"内外呼应\", issue #1).\n// The agent plugin is a PURE PROTOCOL CLIENT: no acp-kernel import, no\n// compression logic. The proxy stays the single compression authority; the\n// plugin only (1) detects the proxy, (2) fetches the tool manifest (single\n// source of truth), (3) forwards tool executes, (4) reads status. Same\n// package as the proxy ⇒ same version ⇒ no kernel-skew bug class.\n\nexport type ManifestTool = {\n    name: string;\n    description?: string;\n    inputSchema: unknown;\n};\n\nconst MANIFEST_TIMEOUT_MS = 5000;\nconst TOOL_TIMEOUT_MS = 60000;\nconst STATUS_TIMEOUT_MS = 5000;\n\n/** Detect the proxy from a provider baseUrl's `/bili/` zero-config prefix.\n *  The real prefix embeds the full upstream URL (`/bili/https://…`), so the\n *  check requires `bili` as the first path segment followed by an http(s)\n *  URL — a plain `/foo/bili/` path segment is NOT a bili proxy.\n *  Returns the proxy origin (scheme//host) the request will actually hit. */\nexport function proxyBaseFromUrl(baseUrl: string | undefined): string | undefined {\n    if (!baseUrl) return undefined;\n    try {\n        const url = new URL(baseUrl);\n        if (url.protocol !== \"http:\" && url.protocol !== \"https:\") return undefined;\n        const segments = url.pathname.split(\"/\").filter((s) => s.length > 0);\n        if (segments[0] !== \"bili\") return undefined;\n        const rest = url.pathname.slice(url.pathname.indexOf(\"bili\") + \"bili\".length);\n        if (!/^\\/https?:\\/\\//.test(rest)) return undefined;\n        return `${url.protocol}//${url.host}`;\n    } catch {\n        return undefined;\n    }\n}\n\n/** MITM transparent mode has no `/bili/` prefix; the proxy's launcher exports\n *  BILLION_CONTEXT_PROXY. A stale value surfaces as a tool-forward error. */\nexport function proxyBaseFromEnv(): string | undefined {\n    const raw = process.env.BILLION_CONTEXT_PROXY?.trim();\n    if (!raw) return undefined;\n    try {\n        const url = new URL(raw);\n        return url.protocol === \"http:\" || url.protocol === \"https:\" ? `${url.protocol}//${url.host}` : undefined;\n    } catch {\n        return undefined;\n    }\n}\n\nexport function detectProxyBase(baseUrl: string | undefined): string | undefined {\n    if (process.env.BILLION_CONTEXT_PLUGIN === \"0\") return undefined;\n    return proxyBaseFromUrl(baseUrl) ?? proxyBaseFromEnv();\n}\n\nasync function fetchJson(url: string, init: RequestInit | undefined, timeoutMs: number, externalSignal?: AbortSignal): Promise<{ ok: boolean; status: number; json: unknown }> {\n    const ac = new AbortController();\n    // An already-aborted external signal never fires its \"abort\" event, so\n    // forward the state directly — otherwise only the timeout could stop\n    // the request, turning an instant cancel into a timeout wait.\n    if (externalSignal?.aborted) ac.abort();\n    const timer = setTimeout(() => ac.abort(), timeoutMs);\n    const onExternalAbort = () => ac.abort();\n    externalSignal?.addEventListener(\"abort\", onExternalAbort, { once: true });\n    try {\n        let res: Response;\n        try {\n            res = await fetch(url, { ...init, signal: ac.signal });\n        } catch (err) {\n            if (ac.signal.aborted && !externalSignal?.aborted) throw new Error(`timeout after ${timeoutMs}ms: ${url}`);\n            throw err;\n        }\n        const text = await res.text();\n        let json: unknown = undefined;\n        try {\n            json = JSON.parse(text);\n        } catch {\n            json = undefined;\n        }\n        return { ok: res.ok, status: res.status, json };\n    } finally {\n        clearTimeout(timer);\n        externalSignal?.removeEventListener(\"abort\", onExternalAbort);\n    }\n}\n\nexport async function fetchManifest(proxyBase: string): Promise<ManifestTool[]> {\n    const { ok, status, json } = await fetchJson(`${proxyBase}/__bili/plugin/manifest`, undefined, MANIFEST_TIMEOUT_MS);\n    if (!ok || !json || typeof json !== \"object\") throw new Error(`manifest fetch failed: ${status}`);\n    const data = json as { tools?: { anthropic?: { name?: string; description?: string; input_schema?: unknown }[] } };\n    const tools = (data.tools?.anthropic ?? []).filter((t): t is { name: string; description?: string; input_schema?: unknown } => typeof t.name === \"string\");\n    if (tools.length === 0) throw new Error(\"manifest served no anthropic tools\");\n    return tools.map((t) => ({ name: t.name, description: t.description, inputSchema: t.input_schema ?? { type: \"object\", properties: {} } }));\n}\n\nexport async function forwardTool(proxyBase: string, conversationId: string, tool: string, args: unknown, signal?: AbortSignal): Promise<string> {\n    const { ok, status, json } = await fetchJson(`${proxyBase}/__bili/plugin/tool`, {\n        method: \"POST\",\n        headers: { \"content-type\": \"application/json\" },\n        body: JSON.stringify({ conversationId, tool, args: args ?? {} }),\n    }, TOOL_TIMEOUT_MS, signal);\n    const data = json as { ok?: boolean; result?: string; error?: string } | undefined;\n    if (!ok || !data?.ok) {\n        throw new Error(`bili proxy tool ${tool} failed (${status}): ${data?.error ?? \"unknown error\"}`);\n    }\n    return data.result ?? \"\";\n}\n\n/** Soft-fail by design: the status read is best-effort UI data; undefined\n *  means \"no data\" whether the proxy is down or the session is unknown. */\nexport async function fetchStatus(proxyBase: string, conversationId: string): Promise<Record<string, unknown> | undefined> {\n    const { ok, json } = await fetchJson(`${proxyBase}/__bili/plugin/status?conversationId=${encodeURIComponent(conversationId)}`, undefined, STATUS_TIMEOUT_MS);\n    if (!ok || !json || typeof json !== \"object\") return undefined;\n    return json as Record<string, unknown>;\n}\n","// Thin agent extension for pi and omp (\"内外呼应\", issue #1). Loaded by pi\n// via the package.json `pi` manifest (dist/agent/pi.js) or by omp via the\n// config.yml `extensions:` list (dist/agent/omp.js). pi and omp share the\n// ExtensionFactory API shape, so one factory serves both; types below are\n// minimal structural declarations — the bundled artifact imports NOTHING\n// from the host at runtime (the host duck-types us in).\n\nimport { detectProxyBase, fetchManifest, forwardTool, fetchStatus, type ManifestTool } from \"./shared.js\";\n\ntype Ctx = {\n    sessionManager?: { getSessionId?: () => string } | undefined;\n    model?: { contextWindow?: number; baseUrl?: string } | undefined;\n    cwd?: string;\n};\n\ntype TextBlock = { type: \"text\"; text: string };\ntype ToolResult = { content: TextBlock[]; isError?: boolean };\n\ntype ToolDefinition = {\n    name: string;\n    description?: string;\n    parameters: unknown;\n    execute: (toolCallId: string, params: Record<string, unknown>, signal: AbortSignal | undefined, onUpdate: ((u: unknown) => void) | undefined, ctx: Ctx) => Promise<ToolResult>;\n};\n\ntype ExtensionAPI = {\n    on: (event: string, handler: (event: never, ctx: Ctx) => unknown) => void;\n    registerTool: (tool: ToolDefinition) => void;\n};\n\nfunction agentName(override: string | undefined): string {\n    if (override) return override;\n    return process.env.BILLION_CONTEXT_PLUGIN_AGENT === \"omp\" ? \"omp\" : \"pi\";\n}\n\nfunction proxyBaseForCtx(ctx: Ctx): string | undefined {\n    return detectProxyBase(ctx.model?.baseUrl);\n}\n\nfunction sessionIdOf(ctx: Ctx): string | undefined {\n    try {\n        const sid = ctx.sessionManager?.getSessionId?.();\n        return typeof sid === \"string\" ? sid : undefined;\n    } catch {\n        return undefined;\n    }\n}\n\nfunction manifestToTool(proxyBase: string, tool: ManifestTool, agent: string): ToolDefinition {\n    return {\n        name: tool.name,\n        description: tool.description,\n        parameters: tool.inputSchema,\n        execute: async (_toolCallId, params, signal, _onUpdate, ctx) => {\n            const conversationId = sessionIdOf(ctx) ?? \"unknown\";\n            try {\n                const output = await forwardTool(proxyBase, conversationId, tool.name, params, signal);\n                return { content: [{ type: \"text\", text: output }] };\n            } catch (err) {\n                return { content: [{ type: \"text\", text: `bili tool error: ${err instanceof Error ? err.message : String(err)}` }], isError: true };\n            }\n        },\n    };\n}\n\nconst RETRY_INTERVAL_MS = 10000;\n\ntype RegisterState = { sid?: string; pending?: Promise<void>; retryAt?: number };\n\nasync function registerTools(pi: ExtensionAPI, ctx: Ctx, state: RegisterState, agent: string): Promise<void> {\n    const proxyBase = proxyBaseForCtx(ctx);\n    if (proxyBase === undefined) return;\n    // Cache on the session id; \"\" (host has no sessionManager) still caches,\n    // so a successful registration is not re-fetched on every provider\n    // request — the manifest is session-independent anyway.\n    const sid = sessionIdOf(ctx) ?? \"\";\n    if (sid === state.sid) return;\n    if (state.pending !== undefined) return state.pending;\n    if (state.retryAt !== undefined && Date.now() < state.retryAt) return;\n    state.pending = (async () => {\n        let tools: ManifestTool[];\n        try {\n            tools = await fetchManifest(proxyBase);\n        } catch (err) {\n            state.retryAt = Date.now() + RETRY_INTERVAL_MS;\n            console.error(`bili-plugin(${agent}): manifest fetch failed: ${err instanceof Error ? err.message : String(err)} — retrying in ${RETRY_INTERVAL_MS / 1000}s`);\n            return;\n        }\n        try {\n            for (const t of tools) pi.registerTool(manifestToTool(proxyBase, t, agent));\n            state.sid = sid;\n            state.retryAt = undefined;\n        } catch (err) {\n            state.sid = undefined;\n            state.retryAt = Date.now() + RETRY_INTERVAL_MS;\n            console.error(`bili-plugin(${agent}): tool registration deferred (${err instanceof Error ? err.message : String(err)}) — retrying in ${RETRY_INTERVAL_MS / 1000}s`);\n        }\n    })();\n    try {\n        await state.pending;\n    } finally {\n        state.pending = undefined;\n    }\n}\n\nexport function createBiliPlugin(agentOverride?: string): (pi: ExtensionAPI) => void {\n    return function biliPlugin(pi: ExtensionAPI): void {\n        const agent = agentName(agentOverride);\n        const state: RegisterState = {};\n        pi.on(\"before_provider_headers\", (event, ctx) => {\n            try {\n                if (proxyBaseForCtx(ctx) === undefined) return;\n                const headers = (event as unknown as { headers?: Record<string, string> }).headers;\n                if (headers === undefined || typeof headers !== \"object\" || Array.isArray(headers)) return;\n                const sid = sessionIdOf(ctx);\n                if (sid !== undefined) headers[\"x-bili-plugin-conversation\"] = sid;\n                headers[\"x-bili-plugin\"] = agent;\n                const window = ctx.model?.contextWindow;\n                if (typeof window === \"number\" && Number.isFinite(window) && window > 0) {\n                    headers[\"x-bili-plugin-context-window\"] = String(Math.floor(window));\n                }\n            } catch (err) {\n                console.error(`bili-plugin(${agent}): header stamp skipped (${err instanceof Error ? err.message : String(err)})`);\n            }\n            void registerTools(pi, ctx, state, agent).catch((err: unknown) => console.error(`bili-plugin(${agent}): ${err instanceof Error ? err.message : String(err)}`));\n        });\n        pi.on(\"session_start\", (_event, ctx) => {\n            state.sid = undefined;\n            void registerTools(pi, ctx, state, agent).catch((err: unknown) => console.error(`bili-plugin(${agent}): ${err instanceof Error ? err.message : String(err)}`));\n        });\n    };\n}\n\nexport default createBiliPlugin();\n\nexport { fetchStatus };\n","import { createBiliPlugin } from \"./pi.js\";\n\nexport default createBiliPlugin(\"omp\");\n"],"mappings":"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","names":[]}

package/dist/agent/pi.js

@@ -0,0 +1,187 @@
+import { createRequire as __biliCreateRequire } from 'node:module';
+const require = __biliCreateRequire(import.meta.url);
+
+// src/agent/shared.ts
+var MANIFEST_TIMEOUT_MS = 5e3;
+var TOOL_TIMEOUT_MS = 6e4;
+var STATUS_TIMEOUT_MS = 5e3;
+function proxyBaseFromUrl(baseUrl) {
+  if (!baseUrl) return void 0;
+  try {
+    const url = new URL(baseUrl);
+    if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
+    const segments = url.pathname.split("/").filter((s) => s.length > 0);
+    if (segments[0] !== "bili") return void 0;
+    const rest = url.pathname.slice(url.pathname.indexOf("bili") + "bili".length);
+    if (!/^\/https?:\/\//.test(rest)) return void 0;
+    return `${url.protocol}//${url.host}`;
+  } catch {
+    return void 0;
+  }
+}
+function proxyBaseFromEnv() {
+  const raw = process.env.BILLION_CONTEXT_PROXY?.trim();
+  if (!raw) return void 0;
+  try {
+    const url = new URL(raw);
+    return url.protocol === "http:" || url.protocol === "https:" ? `${url.protocol}//${url.host}` : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function detectProxyBase(baseUrl) {
+  if (process.env.BILLION_CONTEXT_PLUGIN === "0") return void 0;
+  return proxyBaseFromUrl(baseUrl) ?? proxyBaseFromEnv();
+}
+async function fetchJson(url, init, timeoutMs, externalSignal) {
+  const ac = new AbortController();
+  if (externalSignal?.aborted) ac.abort();
+  const timer = setTimeout(() => ac.abort(), timeoutMs);
+  const onExternalAbort = () => ac.abort();
+  externalSignal?.addEventListener("abort", onExternalAbort, { once: true });
+  try {
+    let res;
+    try {
+      res = await fetch(url, { ...init, signal: ac.signal });
+    } catch (err) {
+      if (ac.signal.aborted && !externalSignal?.aborted) throw new Error(`timeout after ${timeoutMs}ms: ${url}`);
+      throw err;
+    }
+    const text = await res.text();
+    let json = void 0;
+    try {
+      json = JSON.parse(text);
+    } catch {
+      json = void 0;
+    }
+    return { ok: res.ok, status: res.status, json };
+  } finally {
+    clearTimeout(timer);
+    externalSignal?.removeEventListener("abort", onExternalAbort);
+  }
+}
+async function fetchManifest(proxyBase) {
+  const { ok, status, json } = await fetchJson(`${proxyBase}/__bili/plugin/manifest`, void 0, MANIFEST_TIMEOUT_MS);
+  if (!ok || !json || typeof json !== "object") throw new Error(`manifest fetch failed: ${status}`);
+  const data = json;
+  const tools = (data.tools?.anthropic ?? []).filter((t) => typeof t.name === "string");
+  if (tools.length === 0) throw new Error("manifest served no anthropic tools");
+  return tools.map((t) => ({ name: t.name, description: t.description, inputSchema: t.input_schema ?? { type: "object", properties: {} } }));
+}
+async function forwardTool(proxyBase, conversationId, tool, args, signal) {
+  const { ok, status, json } = await fetchJson(`${proxyBase}/__bili/plugin/tool`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ conversationId, tool, args: args ?? {} })
+  }, TOOL_TIMEOUT_MS, signal);
+  const data = json;
+  if (!ok || !data?.ok) {
+    throw new Error(`bili proxy tool ${tool} failed (${status}): ${data?.error ?? "unknown error"}`);
+  }
+  return data.result ?? "";
+}
+async function fetchStatus(proxyBase, conversationId) {
+  const { ok, json } = await fetchJson(`${proxyBase}/__bili/plugin/status?conversationId=${encodeURIComponent(conversationId)}`, void 0, STATUS_TIMEOUT_MS);
+  if (!ok || !json || typeof json !== "object") return void 0;
+  return json;
+}
+
+// src/agent/pi.ts
+function agentName(override) {
+  if (override) return override;
+  return process.env.BILLION_CONTEXT_PLUGIN_AGENT === "omp" ? "omp" : "pi";
+}
+function proxyBaseForCtx(ctx) {
+  return detectProxyBase(ctx.model?.baseUrl);
+}
+function sessionIdOf(ctx) {
+  try {
+    const sid = ctx.sessionManager?.getSessionId?.();
+    return typeof sid === "string" ? sid : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function manifestToTool(proxyBase, tool, agent) {
+  return {
+    name: tool.name,
+    description: tool.description,
+    parameters: tool.inputSchema,
+    execute: async (_toolCallId, params, signal, _onUpdate, ctx) => {
+      const conversationId = sessionIdOf(ctx) ?? "unknown";
+      try {
+        const output = await forwardTool(proxyBase, conversationId, tool.name, params, signal);
+        return { content: [{ type: "text", text: output }] };
+      } catch (err) {
+        return { content: [{ type: "text", text: `bili tool error: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
+      }
+    }
+  };
+}
+var RETRY_INTERVAL_MS = 1e4;
+async function registerTools(pi, ctx, state, agent) {
+  const proxyBase = proxyBaseForCtx(ctx);
+  if (proxyBase === void 0) return;
+  const sid = sessionIdOf(ctx) ?? "";
+  if (sid === state.sid) return;
+  if (state.pending !== void 0) return state.pending;
+  if (state.retryAt !== void 0 && Date.now() < state.retryAt) return;
+  state.pending = (async () => {
+    let tools;
+    try {
+      tools = await fetchManifest(proxyBase);
+    } catch (err) {
+      state.retryAt = Date.now() + RETRY_INTERVAL_MS;
+      console.error(`bili-plugin(${agent}): manifest fetch failed: ${err instanceof Error ? err.message : String(err)} \u2014 retrying in ${RETRY_INTERVAL_MS / 1e3}s`);
+      return;
+    }
+    try {
+      for (const t of tools) pi.registerTool(manifestToTool(proxyBase, t, agent));
+      state.sid = sid;
+      state.retryAt = void 0;
+    } catch (err) {
+      state.sid = void 0;
+      state.retryAt = Date.now() + RETRY_INTERVAL_MS;
+      console.error(`bili-plugin(${agent}): tool registration deferred (${err instanceof Error ? err.message : String(err)}) \u2014 retrying in ${RETRY_INTERVAL_MS / 1e3}s`);
+    }
+  })();
+  try {
+    await state.pending;
+  } finally {
+    state.pending = void 0;
+  }
+}
+function createBiliPlugin(agentOverride) {
+  return function biliPlugin(pi) {
+    const agent = agentName(agentOverride);
+    const state = {};
+    pi.on("before_provider_headers", (event, ctx) => {
+      try {
+        if (proxyBaseForCtx(ctx) === void 0) return;
+        const headers = event.headers;
+        if (headers === void 0 || typeof headers !== "object" || Array.isArray(headers)) return;
+        const sid = sessionIdOf(ctx);
+        if (sid !== void 0) headers["x-bili-plugin-conversation"] = sid;
+        headers["x-bili-plugin"] = agent;
+        const window = ctx.model?.contextWindow;
+        if (typeof window === "number" && Number.isFinite(window) && window > 0) {
+          headers["x-bili-plugin-context-window"] = String(Math.floor(window));
+        }
+      } catch (err) {
+        console.error(`bili-plugin(${agent}): header stamp skipped (${err instanceof Error ? err.message : String(err)})`);
+      }
+      void registerTools(pi, ctx, state, agent).catch((err) => console.error(`bili-plugin(${agent}): ${err instanceof Error ? err.message : String(err)}`));
+    });
+    pi.on("session_start", (_event, ctx) => {
+      state.sid = void 0;
+      void registerTools(pi, ctx, state, agent).catch((err) => console.error(`bili-plugin(${agent}): ${err instanceof Error ? err.message : String(err)}`));
+    });
+  };
+}
+var pi_default = createBiliPlugin();
+export {
+  createBiliPlugin,
+  pi_default as default,
+  fetchStatus
+};
+//# sourceMappingURL=pi.js.map

package/dist/agent/pi.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/agent/shared.ts","../../src/agent/pi.ts"],"sourcesContent":["// Shared thin-plugin core for agent-side extensions (\"内外呼应\", issue #1).\n// The agent plugin is a PURE PROTOCOL CLIENT: no acp-kernel import, no\n// compression logic. The proxy stays the single compression authority; the\n// plugin only (1) detects the proxy, (2) fetches the tool manifest (single\n// source of truth), (3) forwards tool executes, (4) reads status. Same\n// package as the proxy ⇒ same version ⇒ no kernel-skew bug class.\n\nexport type ManifestTool = {\n    name: string;\n    description?: string;\n    inputSchema: unknown;\n};\n\nconst MANIFEST_TIMEOUT_MS = 5000;\nconst TOOL_TIMEOUT_MS = 60000;\nconst STATUS_TIMEOUT_MS = 5000;\n\n/** Detect the proxy from a provider baseUrl's `/bili/` zero-config prefix.\n *  The real prefix embeds the full upstream URL (`/bili/https://…`), so the\n *  check requires `bili` as the first path segment followed by an http(s)\n *  URL — a plain `/foo/bili/` path segment is NOT a bili proxy.\n *  Returns the proxy origin (scheme//host) the request will actually hit. */\nexport function proxyBaseFromUrl(baseUrl: string | undefined): string | undefined {\n    if (!baseUrl) return undefined;\n    try {\n        const url = new URL(baseUrl);\n        if (url.protocol !== \"http:\" && url.protocol !== \"https:\") return undefined;\n        const segments = url.pathname.split(\"/\").filter((s) => s.length > 0);\n        if (segments[0] !== \"bili\") return undefined;\n        const rest = url.pathname.slice(url.pathname.indexOf(\"bili\") + \"bili\".length);\n        if (!/^\\/https?:\\/\\//.test(rest)) return undefined;\n        return `${url.protocol}//${url.host}`;\n    } catch {\n        return undefined;\n    }\n}\n\n/** MITM transparent mode has no `/bili/` prefix; the proxy's launcher exports\n *  BILLION_CONTEXT_PROXY. A stale value surfaces as a tool-forward error. */\nexport function proxyBaseFromEnv(): string | undefined {\n    const raw = process.env.BILLION_CONTEXT_PROXY?.trim();\n    if (!raw) return undefined;\n    try {\n        const url = new URL(raw);\n        return url.protocol === \"http:\" || url.protocol === \"https:\" ? `${url.protocol}//${url.host}` : undefined;\n    } catch {\n        return undefined;\n    }\n}\n\nexport function detectProxyBase(baseUrl: string | undefined): string | undefined {\n    if (process.env.BILLION_CONTEXT_PLUGIN === \"0\") return undefined;\n    return proxyBaseFromUrl(baseUrl) ?? proxyBaseFromEnv();\n}\n\nasync function fetchJson(url: string, init: RequestInit | undefined, timeoutMs: number, externalSignal?: AbortSignal): Promise<{ ok: boolean; status: number; json: unknown }> {\n    const ac = new AbortController();\n    // An already-aborted external signal never fires its \"abort\" event, so\n    // forward the state directly — otherwise only the timeout could stop\n    // the request, turning an instant cancel into a timeout wait.\n    if (externalSignal?.aborted) ac.abort();\n    const timer = setTimeout(() => ac.abort(), timeoutMs);\n    const onExternalAbort = () => ac.abort();\n    externalSignal?.addEventListener(\"abort\", onExternalAbort, { once: true });\n    try {\n        let res: Response;\n        try {\n            res = await fetch(url, { ...init, signal: ac.signal });\n        } catch (err) {\n            if (ac.signal.aborted && !externalSignal?.aborted) throw new Error(`timeout after ${timeoutMs}ms: ${url}`);\n            throw err;\n        }\n        const text = await res.text();\n        let json: unknown = undefined;\n        try {\n            json = JSON.parse(text);\n        } catch {\n            json = undefined;\n        }\n        return { ok: res.ok, status: res.status, json };\n    } finally {\n        clearTimeout(timer);\n        externalSignal?.removeEventListener(\"abort\", onExternalAbort);\n    }\n}\n\nexport async function fetchManifest(proxyBase: string): Promise<ManifestTool[]> {\n    const { ok, status, json } = await fetchJson(`${proxyBase}/__bili/plugin/manifest`, undefined, MANIFEST_TIMEOUT_MS);\n    if (!ok || !json || typeof json !== \"object\") throw new Error(`manifest fetch failed: ${status}`);\n    const data = json as { tools?: { anthropic?: { name?: string; description?: string; input_schema?: unknown }[] } };\n    const tools = (data.tools?.anthropic ?? []).filter((t): t is { name: string; description?: string; input_schema?: unknown } => typeof t.name === \"string\");\n    if (tools.length === 0) throw new Error(\"manifest served no anthropic tools\");\n    return tools.map((t) => ({ name: t.name, description: t.description, inputSchema: t.input_schema ?? { type: \"object\", properties: {} } }));\n}\n\nexport async function forwardTool(proxyBase: string, conversationId: string, tool: string, args: unknown, signal?: AbortSignal): Promise<string> {\n    const { ok, status, json } = await fetchJson(`${proxyBase}/__bili/plugin/tool`, {\n        method: \"POST\",\n        headers: { \"content-type\": \"application/json\" },\n        body: JSON.stringify({ conversationId, tool, args: args ?? {} }),\n    }, TOOL_TIMEOUT_MS, signal);\n    const data = json as { ok?: boolean; result?: string; error?: string } | undefined;\n    if (!ok || !data?.ok) {\n        throw new Error(`bili proxy tool ${tool} failed (${status}): ${data?.error ?? \"unknown error\"}`);\n    }\n    return data.result ?? \"\";\n}\n\n/** Soft-fail by design: the status read is best-effort UI data; undefined\n *  means \"no data\" whether the proxy is down or the session is unknown. */\nexport async function fetchStatus(proxyBase: string, conversationId: string): Promise<Record<string, unknown> | undefined> {\n    const { ok, json } = await fetchJson(`${proxyBase}/__bili/plugin/status?conversationId=${encodeURIComponent(conversationId)}`, undefined, STATUS_TIMEOUT_MS);\n    if (!ok || !json || typeof json !== \"object\") return undefined;\n    return json as Record<string, unknown>;\n}\n","// Thin agent extension for pi and omp (\"内外呼应\", issue #1). Loaded by pi\n// via the package.json `pi` manifest (dist/agent/pi.js) or by omp via the\n// config.yml `extensions:` list (dist/agent/omp.js). pi and omp share the\n// ExtensionFactory API shape, so one factory serves both; types below are\n// minimal structural declarations — the bundled artifact imports NOTHING\n// from the host at runtime (the host duck-types us in).\n\nimport { detectProxyBase, fetchManifest, forwardTool, fetchStatus, type ManifestTool } from \"./shared.js\";\n\ntype Ctx = {\n    sessionManager?: { getSessionId?: () => string } | undefined;\n    model?: { contextWindow?: number; baseUrl?: string } | undefined;\n    cwd?: string;\n};\n\ntype TextBlock = { type: \"text\"; text: string };\ntype ToolResult = { content: TextBlock[]; isError?: boolean };\n\ntype ToolDefinition = {\n    name: string;\n    description?: string;\n    parameters: unknown;\n    execute: (toolCallId: string, params: Record<string, unknown>, signal: AbortSignal | undefined, onUpdate: ((u: unknown) => void) | undefined, ctx: Ctx) => Promise<ToolResult>;\n};\n\ntype ExtensionAPI = {\n    on: (event: string, handler: (event: never, ctx: Ctx) => unknown) => void;\n    registerTool: (tool: ToolDefinition) => void;\n};\n\nfunction agentName(override: string | undefined): string {\n    if (override) return override;\n    return process.env.BILLION_CONTEXT_PLUGIN_AGENT === \"omp\" ? \"omp\" : \"pi\";\n}\n\nfunction proxyBaseForCtx(ctx: Ctx): string | undefined {\n    return detectProxyBase(ctx.model?.baseUrl);\n}\n\nfunction sessionIdOf(ctx: Ctx): string | undefined {\n    try {\n        const sid = ctx.sessionManager?.getSessionId?.();\n        return typeof sid === \"string\" ? sid : undefined;\n    } catch {\n        return undefined;\n    }\n}\n\nfunction manifestToTool(proxyBase: string, tool: ManifestTool, agent: string): ToolDefinition {\n    return {\n        name: tool.name,\n        description: tool.description,\n        parameters: tool.inputSchema,\n        execute: async (_toolCallId, params, signal, _onUpdate, ctx) => {\n            const conversationId = sessionIdOf(ctx) ?? \"unknown\";\n            try {\n                const output = await forwardTool(proxyBase, conversationId, tool.name, params, signal);\n                return { content: [{ type: \"text\", text: output }] };\n            } catch (err) {\n                return { content: [{ type: \"text\", text: `bili tool error: ${err instanceof Error ? err.message : String(err)}` }], isError: true };\n            }\n        },\n    };\n}\n\nconst RETRY_INTERVAL_MS = 10000;\n\ntype RegisterState = { sid?: string; pending?: Promise<void>; retryAt?: number };\n\nasync function registerTools(pi: ExtensionAPI, ctx: Ctx, state: RegisterState, agent: string): Promise<void> {\n    const proxyBase = proxyBaseForCtx(ctx);\n    if (proxyBase === undefined) return;\n    // Cache on the session id; \"\" (host has no sessionManager) still caches,\n    // so a successful registration is not re-fetched on every provider\n    // request — the manifest is session-independent anyway.\n    const sid = sessionIdOf(ctx) ?? \"\";\n    if (sid === state.sid) return;\n    if (state.pending !== undefined) return state.pending;\n    if (state.retryAt !== undefined && Date.now() < state.retryAt) return;\n    state.pending = (async () => {\n        let tools: ManifestTool[];\n        try {\n            tools = await fetchManifest(proxyBase);\n        } catch (err) {\n            state.retryAt = Date.now() + RETRY_INTERVAL_MS;\n            console.error(`bili-plugin(${agent}): manifest fetch failed: ${err instanceof Error ? err.message : String(err)} — retrying in ${RETRY_INTERVAL_MS / 1000}s`);\n            return;\n        }\n        try {\n            for (const t of tools) pi.registerTool(manifestToTool(proxyBase, t, agent));\n            state.sid = sid;\n            state.retryAt = undefined;\n        } catch (err) {\n            state.sid = undefined;\n            state.retryAt = Date.now() + RETRY_INTERVAL_MS;\n            console.error(`bili-plugin(${agent}): tool registration deferred (${err instanceof Error ? err.message : String(err)}) — retrying in ${RETRY_INTERVAL_MS / 1000}s`);\n        }\n    })();\n    try {\n        await state.pending;\n    } finally {\n        state.pending = undefined;\n    }\n}\n\nexport function createBiliPlugin(agentOverride?: string): (pi: ExtensionAPI) => void {\n    return function biliPlugin(pi: ExtensionAPI): void {\n        const agent = agentName(agentOverride);\n        const state: RegisterState = {};\n        pi.on(\"before_provider_headers\", (event, ctx) => {\n            try {\n                if (proxyBaseForCtx(ctx) === undefined) return;\n                const headers = (event as unknown as { headers?: Record<string, string> }).headers;\n                if (headers === undefined || typeof headers !== \"object\" || Array.isArray(headers)) return;\n                const sid = sessionIdOf(ctx);\n                if (sid !== undefined) headers[\"x-bili-plugin-conversation\"] = sid;\n                headers[\"x-bili-plugin\"] = agent;\n                const window = ctx.model?.contextWindow;\n                if (typeof window === \"number\" && Number.isFinite(window) && window > 0) {\n                    headers[\"x-bili-plugin-context-window\"] = String(Math.floor(window));\n                }\n            } catch (err) {\n                console.error(`bili-plugin(${agent}): header stamp skipped (${err instanceof Error ? err.message : String(err)})`);\n            }\n            void registerTools(pi, ctx, state, agent).catch((err: unknown) => console.error(`bili-plugin(${agent}): ${err instanceof Error ? err.message : String(err)}`));\n        });\n        pi.on(\"session_start\", (_event, ctx) => {\n            state.sid = undefined;\n            void registerTools(pi, ctx, state, agent).catch((err: unknown) => console.error(`bili-plugin(${agent}): ${err instanceof Error ? err.message : String(err)}`));\n        });\n    };\n}\n\nexport default createBiliPlugin();\n\nexport { fetchStatus };\n"],"mappings":"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","names":[]}