@zhushanwen/pi-smart-context 0.4.1 → 0.4.2

package/README.md

@@ -32,15 +32,9 @@
 pi install npm:@zhushanwen/pi-smart-context
 ```
 
-## 工具激活（deferred）
+## 工具激活
 
-`compact_context` 工具为 `exposure: "deferred"`——不占常驻工具声明，由 pi 内置 `tool_search` 工具检索命中后按需激活。taiji 宿主内开箱即用（宿主启动时已激活 `tool_search`）；独立 pi 使用需在 `<agentDir>/settings.json`（默认 `~/.pi/agent/settings.json`）开启：
-
-```json
-{ "defaultTools": ["+tool_search"] }
-```
-
-`+` 前缀是增量修饰（保留 read/bash/edit/write 默认集）。未开启 `tool_search` 时该工具对模型不可见。
+`compact_context` 工具为 direct 常驻——注册不声明 `exposure` 字段（pi SDK 缺省 `direct`），工具声明随会话常驻、对模型默认可见，无需经 `tool_search` 检索激活，独立 pi 开箱即用。
 
 ## 配置
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-smart-context",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "main": "index.ts",
   "taiji": {

package/src/__tests__/tool.test.ts

@@ -12,11 +12,14 @@ vi.mock("../pure.js", async (importOriginal) => {
 import { DEFAULT_SMART_CONTEXT_CONFIG, loadSmartContextConfig } from "../pure.js";
 import { registerCompactContextTool } from "../tool.js";
 import { countCompactions } from "../pure.js";
-import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { ExtensionAPI, ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
 
 interface RegisteredTool {
 	name: string;
+	/** pi SDK 的 exposure 缺省值 "direct"（常驻）——不写字段时 SDK 侧默认（pi-semantics PS-91），本视图可缺省。 */
+	exposure?: string;
 	parameters: { type?: string };
+	renderResult?: (result: unknown, options: { expanded: boolean }, theme: Theme) => { render: (width: number) => string[] };
 	execute: (id: string, params: Record<string, unknown>, signal: undefined, onUpdate: undefined, ctx: ExtensionContext) => Promise<{ content: Array<{ type: string; text: string }>; details: Record<string, unknown> }>;
 }
 
@@ -67,6 +70,17 @@ describe("compact_context 工具（R2 降级态：fire-and-forget + 结果注入
 		expect(tools[0].name).toBe("compact_context");
 	});
 
+	// exposure 重划终态锚（C-ext-05，2026-10-23 ADR-0136）：direct 常驻 = 注册时不写
+	// exposure 字段（SDK 缺省 direct，pi-semantics PS-91）——误写 "deferred" 会把压缩入口
+	// 从模型默认可见集收走（tool_search 才可激活），此处红。
+	it("exposure 注册终态：direct 常驻——不写 exposure 字段（SDK 缺省 direct）", () => {
+		const { pi, tools } = makePi();
+		registerCompactContextTool(pi);
+		expect(tools).toHaveLength(1);
+		expect(tools[0]!.name).toBe("compact_context");
+		expect(tools[0]!.exposure).toBeUndefined();
+	});
+
 	it("门控拒绝（排除命中）→ throw 带原因与恢复指引（D5）", async () => {
 		mockedLoad.mockReturnValue({ ...DEFAULT_SMART_CONTEXT_CONFIG, excludedModels: ["zai/glm"] });
 		const { pi, tools } = makePi();
@@ -95,6 +109,19 @@ describe("compact_context 工具（R2 降级态：fire-and-forget + 结果注入
 		expect(result.details).toMatchObject({ mode: "same-model", launched: true, fellBack: false, compactionCount: 1 });
 	});
 
+	it("renderResult 接线（C-ext-05）：注册定义携带函数成员 + 折叠态输出 details.summary 一行", async () => {
+		const { pi, tools } = makePi();
+		registerCompactContextTool(pi, { getEntries: () => [{ type: "message" }] });
+		const tool = tools[0];
+		expect(typeof tool.renderResult).toBe("function");
+		const result = await tool.execute("t1", {}, undefined, undefined, makeCtx());
+		const renderTheme = { fg: (_token: string, text: string) => text } as unknown as Theme;
+		const lines = tool.renderResult!(result, { expanded: false }, renderTheme).render(400);
+		// Text.render 按宽度 pad，trim 后断言（折叠态 = details.summary 一行）
+		expect(lines.length).toBe(1);
+		expect(lines[0].trim()).toBe("Context compacted");
+	});
+
 	it("onComplete 兑现后 nextTurn 注入结果（含模式/前后 tokens/成本；降智提示按次数）", async () => {
 		const { pi, tools } = makePi();
 		registerCompactContextTool(pi, { getEntries: () => [{ type: "compaction" }, { type: "compaction" }] });

package/src/render-result.ts

@@ -4,32 +4,7 @@
 
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
-import { firstContentText } from "@zhushanwen/extension-protocol";
-
-/** content[0] 的 text 纯文本（content 缺失或非 text 类型时兜底空串）。 */
-function contentText(result: unknown): string {
-	const content = fieldValue(result, "content");
-	if (!Array.isArray(content)) return "";
-	return firstContentText({ content });
-}
-
-/** unknown 值按字段名安全取值（index-signature 收窄，替代全可选结构断言）。 */
-function fieldValue(v: unknown, key: string): unknown {
-	if (typeof v !== "object" || v === null) return undefined;
-	return (v as Record<string, unknown>)[key];
-}
-
-/** 从 details 安全读取 summary（容错非对象形态与旧版本 entry）。 */
-function readDetailsSummary(result: unknown): string | undefined {
-	const summary = fieldValue(fieldValue(result, "details"), "summary");
-	return typeof summary === "string" && summary !== "" ? summary : undefined;
-}
-
-/** 折叠态回退：content 文本首行（保持一行摘要形态）。 */
-function firstLine(text: string): string {
-	const idx = text.indexOf("\n");
-	return idx === -1 ? text : text.slice(0, idx);
-}
+import { firstLine, readDetailsSummary, resultContentText } from "@zhushanwen/extension-protocol";
 
 /** 折叠态（expanded=false）= details.summary 一行（dim）；展开态 = content 纯文本。 */
 export function renderCompactContextResult(
@@ -37,7 +12,7 @@ export function renderCompactContextResult(
 	options: { expanded: boolean },
 	theme: Theme,
 ): Text {
-	if (options.expanded) return new Text(contentText(result), 0, 0);
-	const summary = readDetailsSummary(result) ?? firstLine(contentText(result));
+	if (options.expanded) return new Text(resultContentText(result), 0, 0);
+	const summary = readDetailsSummary(result) ?? firstLine(resultContentText(result));
 	return new Text(theme.fg("dim", summary), 0, 0);
 }

package/src/tool.ts

@@ -153,9 +153,6 @@ export function registerCompactContextTool(
 	pi.registerTool({
 		name: "compact_context",
 		label: "compact_context",
-		// deferred（tool-declaration-slimming D4）：不常驻声明，tool_search 命中即激活；
-		// 迁移写入的 +tool_search 条目（runtime pi-codemode-settings）承载检索入口
-		exposure: "deferred",
 		description: TOOL_DESCRIPTION,
 		parameters: CompactContextParams,
 		execute: async (_toolCallId, params, _signal, _onUpdate, ctx) => {