@zhushanwen/pi-session-manager 0.6.0 → 0.6.2

package/README.md

@@ -31,9 +31,9 @@ agent-managed session pi extension：把 session 的创建/发送/读取/列表/
 pi install npm:@zhushanwen/pi-session-manager
 ```
 
-## 工具激活（deferred）
+## 工具激活
 
-上表 8 个工具均为 `exposure: "deferred"`——不占常驻工具声明，由 pi 内置 `tool_search` 工具检索命中后按需激活。taiji 宿主内开箱即用（宿主启动时已激活 `tool_search`）；独立 pi 使用需在 `<agentDir>/settings.json`（默认 `~/.pi/agent/settings.json`）加 `"defaultTools": ["+tool_search"]`（`+` 前缀是增量修饰，保留 read/bash/edit/write 默认集）。注意独立 pi 下即便激活，工具功能仍依赖 taiji runtime handler（见上节「运行要求」）。
+`create_managed_session` 为 direct 常驻——创建入口默认对模型可见（注册不声明 `exposure` 字段，pi SDK 缺省 `direct`）。其余 7 个工具为 `exposure: "deferred"`——不占常驻工具声明，由 pi 内置 `tool_search` 工具检索命中后按需激活。taiji 宿主内开箱即用（宿主启动时已激活 `tool_search`）；独立 pi 使用需在 `<agentDir>/settings.json`（默认 `~/.pi/agent/settings.json`）加 `"defaultTools": ["+tool_search"]`（`+` 前缀是增量修饰，保留 read/bash/edit/write 默认集）。注意独立 pi 下即便激活，工具功能仍依赖 taiji runtime handler（见上节「运行要求」）。
 
 ## 测试
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-session-manager",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Pi extension for agent-managed sessions — create, message, monitor, abort, archive, and delete child sessions via ctx.ui.select channel.",
   "type": "module",
   "main": "index.ts",
@@ -30,8 +30,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@zhushanwen/extension-protocol": "0.23.0",
-    "@zhushanwen/pi-delivery-port": "0.2.1",
+    "@zhushanwen/extension-protocol": "0.24.0",
+    "@zhushanwen/pi-delivery-port": "0.3.0",
     "@zhushanwen/pi-ext-guards": "0.5.0",
     "@zhushanwen/pi-extension-logger": "0.6.2"
   },

package/src/__tests__/tool-schema.test.ts

@@ -25,6 +25,16 @@ describe("U5-A3 tool-schema", () => {
 	const schemas = getRegisteredSchemas();
 
 	describe("create_managed_session", () => {
+		// exposure 重划终态锚（C-ext-05，2026-10-23 裁决）：direct 常驻 = 注册时不写
+		// exposure 字段（registerSessionTool 条件展开，与 SDK 缺省 direct 等价，
+		// pi-semantics PS-91）——对照下方 delete/archive 的 toBe("deferred") 反向锚；
+		// 误写 "deferred" 会把创建入口从模型默认可见集收走，此处红。
+		it("is registered as direct (exposure 字段缺省 — SDK 缺省 direct)", () => {
+			const tool = getRegisteredTools().find((t) => t.name === "create_managed_session");
+			expect(tool).toBeDefined();
+			expect(tool?.exposure).toBeUndefined();
+		});
+
 		it("requires cwd (string)", () => {
 			const s = schemas.create_managed_session;
 			expect(s.type).toBe("object");

package/src/index.ts

@@ -187,6 +187,13 @@ interface SessionToolConfig<S extends TObject> {
 	name: string
 	label: string
 	description: string
+	/**
+	 * 可见性档位（ADR-0136 名单句）：缺省 = deferred（七件套）；显式 "direct" =
+	 * 常驻声明（create_managed_session 例外，2026-10-23 裁决）。direct 形态不写
+	 * exposure 字段（与 SDK 缺省及全仓常驻工具惯例一致，pi-semantics PS-91），
+	 * helper 条件展开实现。
+	 */
+	exposure?: "deferred" | "direct"
 	/**
 	 * 识别层（session-manager-archive-delete 四层信息协议）：系统提示词 Available tools
 	 * 清单的一行片段。deferred 工具激活前不在活跃集、带不带都不进清单；激活后带
@@ -223,10 +230,12 @@ function registerSessionTool<S extends TObject>(pi: ExtensionAPI, cfg: SessionTo
 	pi.registerTool({
 		name: cfg.name,
 		label: cfg.label,
-		// deferred（tool-declaration-slimming D4）：session-manager 工具族（八件套，与
-		// ADR-0136 现行登记一致）整体不常驻声明，tool_search
-		// 命中即激活；迁移写入的 +tool_search 条目（runtime pi-codemode-settings）承载检索入口
-		exposure: "deferred",
+		// deferred（tool-declaration-slimming D4）：session-manager 工具族与 ADR-0136
+		// 现行登记一致——除 create_managed_session（direct 常驻，2026-10-23 裁决）外
+		// 不常驻声明，tool_search 命中即激活；检索入口 = 启动迁移写入的 +tool_search
+		// 条目（runtime pi-codemode-settings）。direct 档不写 exposure 字段（与 SDK
+		// 缺省等价，pi-semantics PS-91），条件展开避免传显式 undefined
+		...(cfg.exposure !== "direct" ? { exposure: "deferred" as const } : {}),
 		promptSnippet: cfg.promptSnippet,
 		description: cfg.description,
 		parameters: cfg.parameters,
@@ -267,6 +276,9 @@ export default function sessionManagerExtension(pi: ExtensionAPI): void {
 	registerSessionTool(pi, {
 		name: "create_managed_session",
 		label: "Create Managed Session",
+		// direct 常驻（2026-10-23 裁决，ADR-0136 补记）：创建入口模型默认可见，
+		// 其余七件保持 deferred
+		exposure: "direct",
 		promptSnippet:
 			"Create a new managed child session in a working directory, optionally with an initial prompt.",
 		description: `Create a new managed child session in a working directory, optionally with an initial prompt.

package/src/render.ts

@@ -4,19 +4,12 @@
 
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
-import { firstContentText } from "@zhushanwen/extension-protocol";
-
-/** pi toolResult 通用形状（AgentToolResult 的结构最小面，renderResult 入参收窄用）。 */
-interface ToolResultShape { // oe-exempt:20261017:framework:details 数据形状窄 view（单实现消费，非抽象接口）
-	content: Array<{ type: string; text?: string }>;
-	details?: { summary?: unknown };
-}
+import { readDetailsSummary, resultContentText } from "@zhushanwen/extension-protocol";
 
 export function renderSessionManagerResult(result: unknown, options: { expanded: boolean }, theme: Theme): Text {
-	const r = result as ToolResultShape;
-	const summary = r.details?.summary;
-	if (options.expanded === false && typeof summary === "string" && summary !== "") {
+	const summary = readDetailsSummary(result);
+	if (options.expanded === false && summary !== undefined) {
 		return new Text(theme.fg("dim", summary), 0, 0);
 	}
-	return new Text(firstContentText(r), 0, 0);
+	return new Text(resultContentText(result), 0, 0);
 }