@zhushanwen/pi-rename-session 0.9.5 → 0.11.0

package/README.md

@@ -131,7 +131,7 @@ node e2e/run-all.mjs   # 顺序全跑：单场景失败不阻断后续，汇总
 - harness API 与断言纯函数（单测 `e2e/harness.test.mjs` 随 vitest 跑）：`e2e/harness.mjs`
 - A2 的标题记录与人工抽查表（词组形态/语义相关/语言跟随三列）：`e2e/RESULTS.md`（run-a2 自动追加，人工填写）
 - 保留现场调试：`E2E_KEEP_TMP=1 node e2e/run-all.mjs`
-- 测试模型固定 `xiaomi-token-plan-cn/mimo-v2.5-pro`（项目规范，禁 kimi）
+- 测试模型缺省 `xiaomi-token-plan-cn/mimo-v2.6-flash`（`E2E_MODEL` 环境变量可覆盖，禁 kimi）
 
 ## 子 session 自动排除
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-rename-session",
-  "version": "0.9.5",
+  "version": "0.11.0",
   "type": "module",
   "main": "index.ts",
   "taiji": {
@@ -33,9 +33,9 @@
     "pi-package"
   ],
   "dependencies": {
-    "@zhushanwen/pi-ext-guards": "0.4.1",
-    "@zhushanwen/pi-extension-logger": "0.6.1",
-    "@zhushanwen/pi-llm-shared": "0.10.0"
+    "@zhushanwen/pi-ext-guards": "0.4.3",
+    "@zhushanwen/pi-extension-logger": "0.6.2",
+    "@zhushanwen/pi-llm-shared": "0.11.1"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.9",
@@ -48,9 +48,9 @@
     "vitest.config.ts"
   ],
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.84.4",
-    "@earendil-works/pi-ai": "^0.84.4",
-    "typebox": "*"
+    "@earendil-works/pi-coding-agent": "^1.0.0",
+    "@earendil-works/pi-ai": "^1.0.0",
+    "typebox": "1.3.27"
   },
   "peerDependenciesMeta": {
     "@earendil-works/pi-coding-agent": {

package/src/__tests__/index.test.ts

@@ -826,7 +826,7 @@ describe("rename_session 工具注册与 execute 守卫（D3）", () => {
 		expect(setup.registerToolMock).not.toHaveBeenCalled();
 	});
 
-	it("TC-T4: execute 时 live mode 非 agent-tool（load 是 agent-tool、运行中切走）→ isError（经 throw，pi 0.84.4 实装契约），文案含恢复动作指引", async () => {
+	it("TC-T4: execute 时 live mode 非 agent-tool（load 是 agent-tool、运行中切走）→ isError（经 throw，pi 1.0.0 实装契约），文案含恢复动作指引", async () => {
 		setupWithMode(AGENT_TOOL_CONFIG); // load 时注册
 		const tool = setup.registeredTool as RegisteredRenameTool;
 

package/src/__tests__/llm.test.ts

@@ -380,7 +380,9 @@ const STUB_MODEL: Model<Api> = {
 	api: "anthropic-messages",
 	provider: "stub",
 	baseUrl: "https://stub.invalid",
-	reasoning: false,
+	// reasoning=true：档位按模型 supportedLevels 数据驱动判定（pi-ai getSupportedThinkingLevels），
+	// 不支持思考的模型只支持 "off"——用例要断言档位透传，故此处声明支持。
+	reasoning: true,
 	input: ["text"],
 	cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
 	contextWindow: 128_000,
@@ -467,7 +469,7 @@ describe("callRenameLLM", () => {
 		);
 	});
 
-	it("传给 callLLM 的 opts：model/systemPrompt(<200)/maxTokens=2048/timeoutMs=30000/signal/sessionId/无 tools，messages 三段式", async () => {
+	it("传给 callLLM 的 opts：model/systemPrompt(<200)/maxTokens=2048/不传 timeoutMs/signal/sessionId/无 tools，messages 三段式", async () => {
 		vi.mocked(resolveModel).mockReturnValue(STUB_MODEL);
 		vi.mocked(callLLM).mockResolvedValue({ ok: true, content: "标题" });
 		await callRenameLLM(createCtx(), BASE_CONFIG, FINAL_MESSAGE);
@@ -478,7 +480,7 @@ describe("callRenameLLM", () => {
 			systemPrompt: string;
 			messages: { role: string; content: { type: string; text: string }[] }[];
 			maxTokens: number;
-			timeoutMs: number;
+			timeoutMs?: number;
 			signal: AbortSignal;
 			sessionId: string;
 			tools?: unknown;
@@ -488,8 +490,8 @@ describe("callRenameLLM", () => {
 		expect(callOpts.systemPrompt.length).toBeLessThan(200);
 		// 输出预算覆盖 thinking+标题（reasoning 模型 thinking 600-1500 tokens 计入预算，64 必截断）
 		expect(callOpts.maxTokens).toBe(2048);
-		// 固定 30s 超时（超时归一 ok:false 走静默跳过）
-		expect(callOpts.timeoutMs).toBe(30000);
+		// 不传超时（ADR-0122：无包内超时兜底，失败直报）
+		expect(callOpts.timeoutMs).toBeUndefined();
 		expect(callOpts.signal).toBeInstanceOf(AbortSignal);
 		expect(callOpts.sessionId).toBe("test-session-id");
 		// 三段式：user(prompt) + assistant(finalText) + user(instruction)
@@ -672,6 +674,21 @@ describe("callRenameLLM", () => {
 		const callOpts = vi.mocked(callLLM).mock.calls[0][1] as { reasoning?: unknown };
 		expect(callOpts.reasoning).toBe("high");
 	});
+
+	it("thinkingLevel 为该模型不支持的档位 → warn 留痕 + 不传 reasoning（数据驱动判定，不静默换档）", async () => {
+		loggerMock.warn.mockClear();
+		vi.mocked(resolveModel).mockReturnValue(STUB_MODEL);
+		vi.mocked(callLLM).mockResolvedValue({ ok: true, content: "标题" });
+		// STUB_MODEL（reasoning=true）的 supportedLevels = off/minimal/low/medium/high，
+		// "ultra" 词表外 → reasoningLevel undefined → 不传档位
+		await callRenameLLM(createCtx(), { ...BASE_CONFIG, thinkingLevel: "ultra" }, FINAL_MESSAGE);
+
+		const callOpts = vi.mocked(callLLM).mock.calls[0][1] as { reasoning?: unknown };
+		expect(callOpts.reasoning).toBeUndefined();
+		expect(loggerMock.warn).toHaveBeenCalledWith(
+			expect.stringContaining('thinkingLevel "ultra" is not supported'),
+		);
+	});
 });
 
 // ────────────────────────────────────────────────────

package/src/__tests__/pure.test.ts

@@ -301,8 +301,10 @@ describe("normalizeRenameConfig", () => {
 		expect(normalizeRenameConfig({ thinkingLevel: "off" }).thinkingLevel).toBe("off");
 	});
 
-	it("thinkingLevel 非法（未知值 / 非字符串）→ 回默认 off", () => {
-		expect(normalizeRenameConfig({ thinkingLevel: "ultra" }).thinkingLevel).toBe("off");
+	it("thinkingLevel：非空字符串原样采信（含词表外值），非字符串/缺失 → 默认 off", () => {
+		// 词表不在本层（合法性归写入侧 UI 与 pi）：显式写了未知档位不再被静默换成缺省档
+		expect(normalizeRenameConfig({ thinkingLevel: "ultra" }).thinkingLevel).toBe("ultra");
+		expect(normalizeRenameConfig({ thinkingLevel: "xhigh" }).thinkingLevel).toBe("xhigh");
 		expect(normalizeRenameConfig({ thinkingLevel: 5 }).thinkingLevel).toBe("off");
 		expect(normalizeRenameConfig({ thinkingLevel: null }).thinkingLevel).toBe("off");
 		// 缺失字段 → 默认 off（旧配置文件兼容：无 thinkingLevel 字段的存量配置自动回填）

package/src/index.ts

@@ -64,9 +64,11 @@ const RENAME_TOOL_SUBAGENT_GUARD_MESSAGE =
  *   子进程同样加载本 extension（全局 mode=agent-tool 时 subagent 也注册本工具），
  *   子会话是临时产物不参与 rename 体系，与 message_end / turn_end 两入口同语义。
  * - execute 内 live 读 config 守卫：mode !== "agent-tool"（mode 切走后本工具残留在
- *   已存活 session 的工具清单——pi 无 unregisterTool）→ throw isError（pi 0.84.4 实装：
- *   execute 正常返回的 isError 字段被丢弃，isError 状态只能经 throw 产生，
- *   agent-loop.js executePreparedToolCall catch → createErrorToolResult(message)）。
+ *   已存活 session 的工具清单——pi 无 unregisterTool）→ throw isError（pi 1.0.0 实装：
+ *   execute 抛出经 pi-agent-core agent-loop.js executePreparedToolCall 外层 catch 统一转
+ *   isError:true 的 error tool result〔:581-588 createErrorToolResult(message)〕；统一
+ *   throw 为纪律选择（单一错误路径），非「返回值 isError 失效」——1.0.0 起返回值上的
+ *   isError 标记同样被尊重〔:579〕）。
  * - cleanTitle 空值同样 throw isError（空白/纯标点标题不可落库）。
  * - 非空直接 pi.setSessionName，不走 getSessionName() 防覆盖守卫——agent 显式调用
  *   是「代表用户的意图」，语义等同 GUI 手动 rename，允许覆盖任何既有名（含自动名/语义名）。

package/src/llm.ts

@@ -1,5 +1,6 @@
 import path from "node:path";
 
+import { getSupportedThinkingLevels } from "@earendil-works/pi-ai";
 import type { AssistantMessage, Message, Usage } from "@earendil-works/pi-ai";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { isRecord } from "@zhushanwen/pi-ext-guards";
@@ -153,10 +154,7 @@ export function buildTitleMessages(
 	return messages;
 }
 
-// ──────────────────────── debug 证据链 + 超时 ────────────────────────
-
-/** rename LLM 超时（固定值：实测 2048 预算下独立调用 5-12.5s，30s 约 2.4x+ 余量；超时归一 ok:false 静默跳过）。 */
-const RENAME_TIMEOUT_MS = 30_000;
+// ──────────────────────── debug 证据链 ────────────────────────
 
 /** title empty warn 的 raw 预览上限（Unicode 码点数；预览是 LLM 标题候选，非对话原文）。 */
 const TITLE_EMPTY_RAW_PREVIEW_CODE_POINTS = 100;
@@ -268,6 +266,12 @@ export async function callRenameLLM(
 		logger.warn("model not available, skipping");
 		return null;
 	}
+	const reasoningLevel = getSupportedThinkingLevels(model).find((l) => l === config.thinkingLevel);
+	if (config.thinkingLevel !== undefined && reasoningLevel === undefined) {
+		logger.warn(
+			`configured thinkingLevel "${config.thinkingLevel}" is not supported by ${model.provider}/${model.id}; calling without a thinking level`,
+		);
+	}
 
 	const userPrompt =
 		options?.promptText ??
@@ -301,14 +305,14 @@ export async function callRenameLLM(
 		// 输出预算必须覆盖「thinking + 标题」两部分：thinking 计入 maxTokens 的模型
 		//（StepFun step-5-preview 实测 thinking 600-1500 tokens 且不可禁用/不可压低，
 		// reasoning_effort/thinking 参数均被无视）在 64 预算下正文必然截断为空。
-		// 2048 = 实测最大总输出 843 tokens 的 2.4x 余量；不给 4096+ 是因为最坏满额时长
-		//（4096 ÷ 67 tok/s ≈ 61s）远超 30s 超时线。截断发生时空标题 warn 带 stopReason=length 留痕，
+		// 2048 = 实测最大总输出 843 tokens 的 2.4x 余量。截断发生时空标题 warn 带 stopReason=length 留痕，
 		// 该 warn 累积出现即上调本常量的数据信号。maxTokens 是截断上限非预扣额度，按实际用量计费。
 		maxTokens: 2048,
-		// 固定 30s 超时（网络抖动归一为 ok:false 走静默跳过，不悬挂 fire-and-forget promise）
-		timeoutMs: RENAME_TIMEOUT_MS,
-		// thinkingLevel 直接透传（含 "off"）；llm-shared 内部会把 "off" 映射为不传 reasoning（provider 默认）
-		reasoning: config.thinkingLevel,
+		// 不传 timeoutMs（ADR-0122：不设包内超时兜底，LLM 挂死由上层失败直报；调用方显式超时走 llm-shared C2 通道）
+		// 档位按「该模型自己的 supportedLevels」判定（pi-ai 数据驱动，本层不自持词表）：
+		// 配置写了该模型不支持的档位 → 留痕并按「不传档位」处理（不静默换成别的档）。
+		// llm-shared 内部会把 "off" 映射为不传 reasoning（provider 默认）。
+		reasoning: reasoningLevel,
 		// 保留随 session abort 取消调用的语义（旧版 llm.ts 同样透传 ctx.signal）
 		signal: ctx.signal,
 		sessionId,

package/src/pure.ts

@@ -2,11 +2,10 @@ import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 
 import { getAgentDir } from "@earendil-works/pi-coding-agent";
-import type { ModelThinkingLevel } from "@earendil-works/pi-ai";
 
 import { isEnoentError } from "@zhushanwen/pi-ext-guards";
 import {
-	isThinkingLevel,
+	normalizeThinkingLevel,
 	loadConfig,
 	normalizeModelSelector,
 	saveConfig,
@@ -40,11 +39,11 @@ export interface RenameSessionConfig {
 	/** 标题最大长度（Unicode 码点数）。 */
 	maxTitleLength: number;
 	/**
-	 * 标题生成 LLM 的 thinking 级别（pi 的 ModelThinkingLevel，THINKING_ORDER SSOT）。
+	 * 标题生成 LLM 的 thinking 级别（字符串透传；合法档位按模型 supportedLevels 在调用点判定）。
 	 * 默认 "off"：不传 pi-ai reasoning（provider 默认行为，与旧版本一致）；
 	 * "minimal"~"max" 透传给 SimpleStreamOptions.reasoning（provider 不支持时静默忽略）。
 	 */
-	thinkingLevel: ModelThinkingLevel;
+	thinkingLevel: string;
 }
 
 // ──────────────────────── 枚举校验 ────────────────────────
@@ -144,9 +143,7 @@ export function normalizeRenameConfig(raw: unknown): RenameSessionConfig {
 	// normalizeModelSelector：llm-shared 导出（ext-simplify-17 D6 收口）
 	const model = normalizeModelSelector(obj.model) ?? DEFAULT_RENAME_CONFIG.model;
 
-	const thinkingLevel = isThinkingLevel(obj.thinkingLevel)
-		? obj.thinkingLevel
-		: DEFAULT_RENAME_CONFIG.thinkingLevel;
+	const thinkingLevel = normalizeThinkingLevel(obj.thinkingLevel) ?? DEFAULT_RENAME_CONFIG.thinkingLevel;
 
 	return { enabled, model, mode, maxTitleLength, thinkingLevel };
 }