billion-context-pi-lean 0.1.57-lean.1 → 0.1.69-lean.1

package/README.md

@@ -10,11 +10,11 @@ A lightweight Pi wrapper for [`billion-context-pi`](https://github.com/ranxiangl
 * Streamlined tool surface: Exposes the high-frequency `compress` tool directly, while consolidating `decompress`, `search_context`, and `acp_status` into an on-demand `acp_context` interface.
 * Focused and clean: Disables built-in delegation and auto-updates by design. For delegation workflows, pair with a dedicated subagent extension.
 
-Upstream dependency is pinned to `billion-context-pi@0.1.57`; delegation remains disabled in this lean wrapper.
+Upstream dependency is pinned to `billion-context-pi@0.1.69`; delegation remains disabled in this lean wrapper.
 
 ## Context Savings
 
-The benchmark below compares the same delegation-disabled configuration against upstream `0.1.57`.
+The benchmark below compares the same delegation-disabled configuration against upstream `0.1.69`.
 
 ## Installation
 
@@ -59,15 +59,16 @@ Use `help` only when you need to inspect the full upstream schema.
 
 With only this extension enabled, its recurring initialization overhead in the model context is:
 
-| Item | Lean | Upstream `billion-context-pi@0.1.57` |
+| Item | Lean | Upstream `billion-context-pi@0.1.69` |
 | --- | ---: | ---: |
 | `compress` | 231 | 549 |
 | Context operations | `acp_context`: 90 | `decompress` + `search_context` + `acp_status`: 1,095 |
-| System prompt additions | 369 | 3,951 |
-| **Total** | **690** | **5,595** |
+| System prompt additions | 369 | 4,158 |
+| **Total** | **690** | **5,802** |
+
+This saves **5,112 tokens (88.1%)** compared to the pinned upstream package.
+The benchmark was measured on Pi 0.85.1 with `measure-plugin-tokens-v3.mjs` in a fresh isolated session, with delegation disabled for both packages, excluding built-in tools, skills, context files, and unrelated extensions. Token estimates use `ceil(characters / 4)`. Pure runtime UI elements and slash commands are excluded as they are not sent to the model.
 
-This saves **4,905 tokens (87.7%)** compared to the pinned upstream package.
-The benchmark was measured on Pi 0.84.4 with `pi-context-view@0.4.3` in a fresh isolated session, with delegation disabled for both packages, excluding built-in tools, skills, context files, and unrelated extensions. Context View estimates tokens as `ceil(characters / 4)`. Pure runtime UI elements and slash commands are excluded as they are not sent to the model.
 ## Development
 
 ```bash

package/README.zh-CN.md

@@ -8,11 +8,11 @@
 
 * 完整上下文引擎：保留上游的对话历史压缩、分层摘要、主动提示（Nudge）、溢出恢复、重试机制与工具保护能力。
 * 优化工具布局：高频使用的 `compress` 工具直接对外暴露，其余 `decompress`、`search_context` 与 `acp_status` 操作整合为按需调用的 `acp_context` 入口。
-* 纯粹专注：主动移除了内置的 Delegation 代理分发与自动更新逻辑；如需多 Agent 协作，建议搭配独立的 Subagent 扩展使用。上游依赖版本锁定为 `billion-context-pi@0.1.57`，确保运行稳定可靠。
+* 纯粹专注：主动移除了内置的 Delegation 代理分发与自动更新逻辑；如需多 Agent 协作，建议搭配独立的 Subagent 扩展使用。上游依赖版本锁定为 `billion-context-pi@0.1.69`，确保运行稳定可靠。
 
 ## 精简优化成效
 
-在双方均关闭 Delegation 的配置下，与上游 `billion-context-pi@0.1.57` 本地对比：Lean 精简版常驻上下文开销为 690 tokens，上游为 5,595 tokens，减少 **4,905 tokens（87.7%）**。
+在双方均关闭 Delegation 的配置下，与上游 `billion-context-pi@0.1.69` 本地对比：Lean 精简版常驻上下文开销为 690 tokens，上游为 5,802 tokens，减少 **5,112 tokens（88.1%）**。
 
 ## 安装
 
@@ -57,15 +57,16 @@ acp_context
 
 单独启用本扩展时，注入到模型初始上下文中的 Token 占用实测如下：
 
-| 项目 | Lean 精简版 | 原版 `billion-context-pi@0.1.57` |
+| 项目 | Lean 精简版 | 原版 `billion-context-pi@0.1.69` |
 | --- | ---: | ---: |
 | `compress` | 231 | 549 |
 | 上下文检索与操作 | `acp_context`: 90 | `decompress` + `search_context` + `acp_status`: 1,095 |
-| 系统提示词增量 | 369 | 3,951 |
-| **合计** | **690** | **5,595** |
+| 系统提示词增量 | 369 | 4,158 |
+| **合计** | **690** | **5,802** |
+
+相比当前上游扩展，初始开销减少了 **5,112 tokens（88.1%）**。
+测试时双方均关闭 Delegation，环境为 Pi 0.85.1 与 `measure-plugin-tokens-v3.mjs` 独立会话，排除了 Pi 内置工具、Skills、上下文文件与无关扩展。Token 按 `ceil(字符数 / 4)` 估算。未计入不会发送给模型的纯运行时 UI 与 Slash 命令。
 
-相比当前上游扩展，初始开销减少了 **4,905 tokens（87.7%）**。
-测试时双方均关闭 Delegation，环境为 Pi 0.84.4 与 `pi-context-view@0.4.3` 独立会话，排除了 Pi 内置工具、Skills、上下文文件与无关扩展。Context View 按 `ceil(字符数 / 4)` 估算。未计入不会发送给模型的纯运行时 UI 与 Slash 命令。
 ## 本地开发
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "billion-context-pi-lean",
-  "version": "0.1.57-lean.1",
+  "version": "0.1.69-lean.1",
   "type": "module",
   "description": "Token-lean Pi facade for billion-context-pi with the full upstream context engine.",
   "license": "MIT",
@@ -12,13 +12,19 @@
   "bugs": {
     "url": "https://github.com/kunkun9527/billion-context-pi-lean/issues"
   },
+  "files": [
+    "index.ts",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE"
+  ],
   "scripts": {
     "test": "node --test tests/*.test.mjs",
     "typecheck": "tsc -p tsconfig.json",
     "check": "npm run typecheck && npm test"
   },
   "dependencies": {
-    "billion-context-pi": "0.1.57",
+    "billion-context-pi": "0.1.69",
     "typebox": "1.3.7"
   },
   "devDependencies": {

package/tests/facade.test.mjs

@@ -1,307 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import { createJiti } from "../node_modules/@earendil-works/pi-coding-agent/node_modules/jiti/lib/jiti.mjs";
-
-const jiti = createJiti(import.meta.url, { moduleCache: false });
-const extensionModule = await jiti.import("../index.ts");
-const extension = extensionModule.default ?? extensionModule;
-const { createLeanAcpExtension } = extensionModule;
-
-function createPi() {
-  const tools = [];
-  const handlers = new Map();
-  const noOp = () => undefined;
-  return new Proxy({
-    tools,
-    handlers,
-    registerTool(tool) {
-      tools.push(tool);
-    },
-    on(event, handler) {
-      const listeners = handlers.get(event) ?? [];
-      listeners.push(handler);
-      handlers.set(event, listeners);
-    },
-    registerCommand: noOp,
-    registerShortcut: noOp,
-    registerMessageRenderer: noOp,
-    registerProvider: noOp,
-    registerFlag: noOp,
-    getFlag: () => undefined,
-    getActiveTools: () => [],
-    getAllTools: () => [],
-    setActiveTools: noOp,
-    appendEntry: noOp,
-    sendMessage: noOp,
-    events: { on: noOp, emit: noOp },
-  }, {
-    get(target, property) {
-      return property in target ? target[property] : noOp;
-    },
-  });
-}
-
-const schemas = {
-  compress: {
-    type: "object",
-    description: "large outer description",
-    properties: {
-      topic: { type: "string", description: "large top-level topic description" },
-      content: {
-        type: "array",
-        description: "large nested description",
-        items: {
-          type: "object",
-          properties: {
-            startId: { type: "string", description: "large start description" },
-            endId: { type: "string", description: "large end description" },
-            summary: { type: "string", description: "large summary description" },
-            topic: { type: "string", description: "large range topic description" },
-          },
-        },
-      },
-      summaryMaxChars: { type: "number", description: "large limit description" },
-    },
-    required: ["content"],
-  },
-  decompress: {
-    type: "object",
-    properties: {
-      blockId: { type: "string" },
-      full: { type: "boolean" },
-      toFile: { type: "string" },
-      inline: { type: "boolean" },
-    },
-    required: ["blockId"],
-  },
-  search_context: {
-    type: "object",
-    properties: {
-      query: { type: "string" },
-      limit: { type: "number" },
-    },
-    required: ["query"],
-  },
-  acp_status: {
-    type: "object",
-    properties: {
-      scope: { type: "string" },
-      view: { type: "string" },
-      tool: { type: "string" },
-      sort: { type: "string" },
-      limit: { type: "number" },
-    },
-  },
-};
-
-function fakeUpstream(calls = [], executions = { count: 0 }) {
-  return (pi) => {
-    for (const name of ["compress", "decompress", "search_context", "acp_status"]) {
-      pi.registerTool({
-        name,
-        label: name,
-        description: `${name} full upstream description`,
-        parameters: structuredClone(schemas[name]),
-        async execute(...args) {
-          executions.count += 1;
-          calls.push([name, ...args]);
-          return {
-            content: [{
-              type: "text",
-              text: name === "search_context"
-                ? 'result → decompress({ blockId: "b12" })'
-                : name === "compress"
-                  ? 'Nothing to do — Run acp_status, then call compress again. Use search_context or decompress to retrieve details. Try search_context({ query: "auth token" }).'
-                  : `${name} result`,
-            }],
-          };
-        },
-      });
-    }
-    pi.registerTool({ name: "acp_delegate", async execute() {} });
-    pi.on("before_agent_start", () => ({ systemPrompt: "upstream prompt must be suppressed" }));
-  };
-}
-
-function getTool(pi, name) {
-  return pi.tools.find((tool) => tool.name === name);
-}
-
-test("registers only compress and acp_context provider tools", () => {
-  const pi = createPi();
-  createLeanAcpExtension(fakeUpstream())(pi);
-  assert.deepEqual(pi.tools.map((tool) => tool.name), ["compress", "acp_context"]);
-});
-
-test("cooperates with an optional collapsed-display service without a local file dependency", () => {
-  const serviceKey = Symbol.for("@local/pi-collapsed-tools.display-service.v1");
-  const previous = globalThis[serviceKey];
-  const decorated = [];
-  globalThis[serviceKey] = {
-    version: 1,
-    decorate(tool) {
-      decorated.push(tool.name);
-      return tool;
-    },
-  };
-
-  try {
-    const pi = createPi();
-    createLeanAcpExtension(fakeUpstream())(pi);
-    assert.deepEqual(decorated, ["compress", "acp_context"]);
-  } finally {
-    if (previous === undefined) delete globalThis[serviceKey];
-    else globalThis[serviceKey] = previous;
-  }
-});
-
-test("keeps compress direct, retains concise critical descriptions, and rewrites stale status advice", async () => {
-  const calls = [];
-  const pi = createPi();
-  createLeanAcpExtension(fakeUpstream(calls))(pi);
-  const tool = getTool(pi, "compress");
-  const result = await tool.execute(
-    "compress-1",
-    { content: [{ startId: "m1", endId: "m2", summary: "done" }] },
-    undefined,
-    undefined,
-    { cwd: "C:/work" },
-  );
-
-  const schema = tool.parameters;
-  const entries = schema.properties.content.items.properties;
-  assert.equal(schema.description, undefined);
-  assert.match(schema.properties.content.description, /direct array/i);
-  assert.match(schema.properties.content.description, /JSON strings|JSON-stringify/i);
-  assert.match(schema.properties.content.description, /mix/i);
-  assert.match(schema.properties.topic.description, /label/i);
-  assert.match(schema.properties.summaryMaxChars.description, /length/i);
-  assert.match(entries.startId.description, /first/i);
-  assert.match(entries.endId.description, /last/i);
-  assert.match(entries.summary.description, /exact technical details/i);
-  assert.match(entries.topic.description, /label/i);
-  assert.doesNotMatch(JSON.stringify(schema), /large .* description/);
-  const rewritten = result.content[0].text;
-  assert.match(rewritten, /acp_context\(\{ op: "acp_status", args: \{\} \}\)/);
-  assert.match(rewritten, /use acp_context with op "search_context" or "decompress"/i);
-  assert.match(rewritten, /acp_context\(\{ op: "search_context", args: \{ query: "auth token" \} \}\)/);
-  assert.doesNotMatch(rewritten, /\b(?:search_context|decompress|acp_status)\s*\(/);
-  assert.doesNotMatch(rewritten, /\brun acp_status\b/i);
-  assert.doesNotMatch(rewritten, /\buse search_context\b/i);
-  assert.equal(calls[0][0], "compress");
-  assert.deepEqual(calls[0][2], { content: [{ startId: "m1", endId: "m2", summary: "done" }] });
-});
-test("routes all three low-frequency operations with original args and execution context", async () => {
-  const cases = [
-    ["search_context", { query: "architecture", limit: 8 }],
-    ["decompress", { blockId: "b11", toFile: "R:/Temp/history.txt", full: true }],
-    ["acp_status", { scope: "uncompressed", view: "messages", sort: "size", limit: 30 }],
-  ];
-
-  for (const [op, args] of cases) {
-    const calls = [];
-    const pi = createPi();
-    createLeanAcpExtension(fakeUpstream(calls))(pi);
-    const signal = new AbortController().signal;
-    const context = { cwd: "C:/work" };
-    await getTool(pi, "acp_context").execute(
-      `call-${op}`,
-      { op, args },
-      signal,
-      undefined,
-      context,
-    );
-    assert.equal(calls[0][0], op);
-    assert.equal(calls[0][1], `call-${op}`);
-    assert.deepEqual(calls[0][2], args);
-    assert.equal(calls[0][3], signal);
-    assert.equal(calls[0][5], context);
-  }
-});
-
-test("rewrites search results to the facade call syntax", async () => {
-  const pi = createPi();
-  createLeanAcpExtension(fakeUpstream())(pi);
-  const result = await getTool(pi, "acp_context").execute(
-    "search-1",
-    { op: "search_context", args: { query: "needle" } },
-  );
-  assert.equal(
-    result.content[0].text,
-    'result → acp_context({ op: "decompress", args: { blockId: "b12" } })',
-  );
-});
-
-test("facade advertises help syntax and discloses an upstream schema without executing it", async () => {
-  const executions = { count: 0 };
-  const pi = createPi();
-  createLeanAcpExtension(fakeUpstream([], executions))(pi);
-  const tool = getTool(pi, "acp_context");
-  assert.match(
-    tool.description,
-    /\{ op: "help", args: \{ tool: "search_context" \} \}/,
-  );
-  const result = await tool.execute(
-    "help-1",
-    { op: "help", args: { tool: "decompress" } },
-  );
-  assert.equal(executions.count, 0);
-  assert.match(result.content[0].text, /blockId/);
-  assert.match(result.content[0].text, /toFile/);
-});
-
-test("invalid facade args fail locally with an on-demand help hint", async () => {
-  const executions = { count: 0 };
-  const pi = createPi();
-  createLeanAcpExtension(fakeUpstream([], executions))(pi);
-  await assert.rejects(
-    getTool(pi, "acp_context").execute(
-      "invalid-1",
-      { op: "decompress", args: { inline: true } },
-    ),
-    /args invalid.*op help.*decompress/,
-  );
-  assert.equal(executions.count, 0);
-});
-
-test("suppresses the upstream prompt and keeps concise summary-fidelity rules", async () => {
-  const pi = createPi();
-  createLeanAcpExtension(fakeUpstream())(pi);
-  const hooks = pi.handlers.get("before_agent_start");
-  assert.equal(hooks.length, 1);
-  const result = await hooks[0]({ systemPrompt: "base prompt" });
-  assert.match(result.systemPrompt, /^base prompt/);
-  assert.match(result.systemPrompt, /Compress consumed history with compress/);
-  assert.match(result.systemPrompt, /exact file paths and line numbers/i);
-  assert.match(result.systemPrompt, /symbols and signatures/i);
-  assert.match(result.systemPrompt, /errors, commands, versions, thresholds/i);
-  assert.match(result.systemPrompt, /decisions with reasons, current state, and unresolved TODOs/i);
-  assert.match(result.systemPrompt, /Refs may be renumbered after compression/i);
-  assert.match(result.systemPrompt, /Block decompression writes to a file by default/i);
-  assert.match(result.systemPrompt, /provider-throttle.*resume exactly where interrupted/i);
-  assert.match(result.systemPrompt, /acp_context/);
-  assert.doesNotMatch(result.systemPrompt, /upstream prompt must be suppressed/);
-});
-
-test("real upstream registration exposes the intended two-tool surface", () => {
-  const pi = createPi();
-  extension(pi);
-  assert.deepEqual(pi.tools.map((tool) => tool.name), ["compress", "acp_context"]);
-});
-
-test("provider-facing metadata stays within the lean budget", () => {
-  const pi = createPi();
-  extension(pi);
-  const metadata = pi.tools.map((tool) => ({
-    name: tool.name,
-    description: tool.description,
-    parameters: tool.parameters,
-    promptSnippet: tool.promptSnippet,
-    promptGuidelines: tool.promptGuidelines,
-  }));
-  const serialized = JSON.stringify(metadata);
-  assert.ok(
-    serialized.length <= 1450,
-    `lean metadata grew to ${serialized.length} characters`,
-  );
-});

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "strict": true,
-    "noEmit": true,
-    "skipLibCheck": true,
-    "allowImportingTsExtensions": true
-  },
-  "include": [
-    "index.ts"
-  ]
-}