@zhushanwen/pi-rename-session 0.9.4 → 0.10.0

package/README.md

@@ -115,7 +115,7 @@ rename 是 best-effort 副作用，任何失败静默跳过、绝不阻断 agent
 | 11 | `skip: empty prompt` | message_end handler（`firstPrompt skip: empty prompt`） | user message 载荷无文本（理论不发生） |
 | 12 | `tool renamed to "<title>"` | rename_session 工具 execute | agent-tool 路径落库成功（`setSessionName` 之后打出，无防覆盖前缀） |
 
-另有两条**非 debug 常开**日志（无条件经 `logger.warn` 落 appendEntry entry）：`rename LLM call failed`（`logger.warn(msg, { error })` 形态，error 详情在结构化 data 字段；超时时 llm-shared callLLM 内部的 extractText 将空错误文本归一为 `unknown error`——extension 侧 `result.error ?? "unknown error"` 只兜 null/undefined，空串兜底发生在 llm-shared 层）、`model not available, skipping`（选模失败）。handler 侧日志 message 带 `t=<ISO时间>` 与 `turnIndex`；llm 侧带 `t=<ISO时间>`、无 turnIndex。
+另有三条**非 debug 常开**日志（无条件经 `logger.warn` 落 appendEntry entry，任意环境可 `grep "rename-session:log" <session.jsonl>` 排障）：`rename LLM call failed`（`logger.warn(msg, { error })` 形态，error 详情在结构化 data 字段；超时时 llm-shared callLLM 内部的 extractText 将空错误文本归一为 `unknown error`——extension 侧 `result.error ?? "unknown error"` 只兜 null/undefined，空串兜底发生在 llm-shared 层）、`model not available, skipping`（选模失败）、`title empty after clean, skipping rename`（调用成功但标题清洗后为空，结构化 data 含 `model` / `stopReason` / `raw`(≤100 码点标题候选预览)——`stopReason=length` 表示输出预算被 thinking 吃尽，是上调 `maxTokens` 常量的数据信号）。handler 侧日志 message 带 `t=<ISO时间>` 与 `turnIndex`；llm 侧带 `t=<ISO时间>`、无 turnIndex。文件日志通道（`<agentDir>/logs/`）需 `TAIJI_AGENT_DEBUG=1`，独立 pi 用户排障优先 grep session 文件（无需复跑）。
 
 ## E2E 验收
 
@@ -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.4",
+  "version": "0.10.0",
   "type": "module",
   "main": "index.ts",
   "taiji": {
@@ -33,9 +33,9 @@
     "pi-package"
   ],
   "dependencies": {
-    "@zhushanwen/pi-ext-guards": "0.4.1",
+    "@zhushanwen/pi-ext-guards": "0.4.2",
     "@zhushanwen/pi-extension-logger": "0.6.1",
-    "@zhushanwen/pi-llm-shared": "0.9.0"
+    "@zhushanwen/pi-llm-shared": "0.11.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.9",

package/src/__tests__/index.test.ts

@@ -673,14 +673,18 @@ describe("renameSessionExtension", () => {
 		for (const lit of debugLiterals) {
 			expect(warnText(warnSpy)).not.toContain(lit);
 		}
-		// 「零调用」的精确口径：剔除既有 A1 日志（model not available / call failed，
-		// 非本轮 debug 契约、本用例数据 ok:true 不触发这两类）后，其余 warn 调用必须为 0。
+		// 「零调用」的精确口径：剔除常开 A1 日志（model not available / call failed /
+		// title empty——三者为设计内的无条件 warn，非 debug 契约；本用例组 2 空内容
+		// 触发 title empty 属预期留痕）后，其余 warn 调用必须为 0。
 		// 成功路径的 rename with model 已改为 debug-only，debug 关闭时同样不得出现。
 		const nonA1Calls = warnLines(warnSpy).filter(
 			(l) =>
 				!l.includes("model not available") &&
-				!l.includes("rename LLM call failed"),
+				!l.includes("rename LLM call failed") &&
+				!l.includes("title empty after clean"),
 		);
+		// 组 2 的空内容路径恰好触发一次 title empty warn（常开留痕的存在性锚点）
+		expect(warnLines(warnSpy).filter((l) => l.includes("title empty after clean"))).toHaveLength(1);
 		expect(nonA1Calls).toHaveLength(0);
 	});
 });

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,
@@ -444,14 +446,30 @@ describe("callRenameLLM", () => {
 		expect(result).toBe("修复登录bug");
 	});
 
-	it("callLLM 返回空 content（cleanTitle 空串）→ 返回 null", async () => {
+	it("callLLM 返回空 content（cleanTitle 空串）→ 返回 null + logger.warn 留痕（stopReason/raw 结构化）", async () => {
 		vi.mocked(resolveModel).mockReturnValue(STUB_MODEL);
-		vi.mocked(callLLM).mockResolvedValue({ ok: true, content: "   " });
+		vi.mocked(callLLM).mockResolvedValue({ ok: true, content: "   ", stopReason: "length" });
+		const result = await callRenameLLM(createCtx(), BASE_CONFIG, FINAL_MESSAGE);
+		expect(result).toBeNull();
+		// A1 契约：空标题不再无痕——warn 带 model/stopReason/raw（截断=length 是上调 maxTokens 的数据信号）
+		expect(loggerMock.warn).toHaveBeenCalledWith(
+			"title empty after clean, skipping rename",
+			{ model: "stub/stub-model", stopReason: "length", raw: "   " },
+		);
+	});
+
+	it("callLLM 返回非空但清洗后为空（纯标点）→ warn 的 raw 携带 ≤100 码点原始预览", async () => {
+		vi.mocked(resolveModel).mockReturnValue(STUB_MODEL);
+		vi.mocked(callLLM).mockResolvedValue({ ok: true, content: "。。。。。", stopReason: "stop" });
 		const result = await callRenameLLM(createCtx(), BASE_CONFIG, FINAL_MESSAGE);
 		expect(result).toBeNull();
+		expect(loggerMock.warn).toHaveBeenCalledWith(
+			"title empty after clean, skipping rename",
+			{ model: "stub/stub-model", stopReason: "stop", raw: "。。。。。" },
+		);
 	});
 
-	it("传给 callLLM 的 opts：model/systemPrompt(<200)/maxTokens=64/timeoutMs=30000/signal/sessionId/无 tools，messages 三段式", async () => {
+	it("传给 callLLM 的 opts：model/systemPrompt(<200)/maxTokens=2048/timeoutMs=30000/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);
@@ -470,7 +488,8 @@ describe("callRenameLLM", () => {
 		expect(callOpts.model).toBe(STUB_MODEL);
 		expect(callOpts.systemPrompt).toBe(RENAME_SYSTEM_PROMPT);
 		expect(callOpts.systemPrompt.length).toBeLessThan(200);
-		expect(callOpts.maxTokens).toBe(64);
+		// 输出预算覆盖 thinking+标题（reasoning 模型 thinking 600-1500 tokens 计入预算，64 必截断）
+		expect(callOpts.maxTokens).toBe(2048);
 		// 固定 30s 超时（超时归一 ok:false 走静默跳过）
 		expect(callOpts.timeoutMs).toBe(30000);
 		expect(callOpts.signal).toBeInstanceOf(AbortSignal);
@@ -655,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/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";
@@ -155,9 +156,12 @@ export function buildTitleMessages(
 
 // ──────────────────────── debug 证据链 + 超时 ────────────────────────
 
-/** rename LLM 超时（固定值：输入 ≤8k token + 输出 64 token，30s 宽裕；超时归一 ok:false 静默跳过）。 */
+/** rename LLM 超时（固定值：实测 2048 预算下独立调用 5-12.5s，30s 约 2.4x+ 余量；超时归一 ok:false 静默跳过）。 */
 const RENAME_TIMEOUT_MS = 30_000;
 
+/** title empty warn 的 raw 预览上限（Unicode 码点数；预览是 LLM 标题候选，非对话原文）。 */
+const TITLE_EMPTY_RAW_PREVIEW_CODE_POINTS = 100;
+
 /** debug 开关 live 读（每次调用查 process.env，非模块加载时读——vi.stubEnv 可测 + 运行时可切换）。 */
 export function isRenameDebugEnabled(): boolean {
 	return process.env.TAIJI_AGENT_DEBUG === "1";
@@ -265,6 +269,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 ??
@@ -295,12 +305,19 @@ export async function callRenameLLM(
 		model,
 		systemPrompt: RENAME_SYSTEM_PROMPT,
 		messages,
-		// 标题只需几个词，64 token 足够且省 quota
-		maxTokens: 64,
+		// 输出预算必须覆盖「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 留痕，
+		// 该 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,
+		// 档位按「该模型自己的 supportedLevels」判定（pi-ai 数据驱动，本层不自持词表）：
+		// 配置写了该模型不支持的档位 → 留痕并按「不传档位」处理（不静默换成别的档）。
+		// llm-shared 内部会把 "off" 映射为不传 reasoning（provider 默认）。
+		reasoning: reasoningLevel,
 		// 保留随 session abort 取消调用的语义（旧版 llm.ts 同样透传 ctx.signal）
 		signal: ctx.signal,
 		sessionId,
@@ -327,6 +344,15 @@ export async function callRenameLLM(
 
 	const title = cleanTitle(result.content, config.maxTitleLength);
 	if (!title) {
+		// A1 契约（不可用不静默）：调用成功但标题为空是可排查的失败形态，不走 debugLog——
+		// warn 经 appendEntry 无条件写 session 文件（rename-session:log entry），任何环境可 grep。
+		// stopReason=length = 输出预算被 thinking 吃光（上调 maxTokens 的数据信号）；
+		// stopReason=stop = 模型正常返回空/纯标点文本（换标题模型）。raw 是 LLM 生成的标题候选非对话原文。
+		logger.warn("title empty after clean, skipping rename", {
+			model: `${model.provider}/${model.id}`,
+			stopReason: result.stopReason,
+			raw: truncateCodePoints(result.content, TITLE_EMPTY_RAW_PREVIEW_CODE_POINTS, "…"),
+		});
 		debugLog("skip: title empty");
 		return null;
 	}

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 };
 }