pi-naming 0.5.0 → 0.5.1

package/README.md

@@ -37,7 +37,9 @@ File: `<pi-agent-dir>/extensions/pi-naming/config.json`; respects `PI_CODING_AGE
     "preferredLength": 10,
     "language": "auto",
     "instructions": "",
-    "timeoutMs": 10000
+    "timeoutMs": 10000,
+    "maxTokens": 2048,
+    "effort": "low"
   }
 }
 ```
@@ -51,8 +53,12 @@ File: `<pi-agent-dir>/extensions/pi-naming/config.json`; respects `PI_CODING_AGE
 | `language` | `"auto"` | Dominant message language, or a language such as `English` or `日本語` |
 | `instructions` | `""` | Additional naming style instructions, not a template or executable code |
 | `timeoutMs` | `10000` | Title request timeout in milliseconds |
+| `maxTokens` | `2048` | Output budget for the title request, capped by the model output limit |
+| `effort` | `"low"` | Thinking effort: `minimal`, `low`, `medium`, `high`, `xhigh` or `max` |
 
-Lengths and timeout must be positive safe integers; timeout must not exceed `2147483647` milliseconds. Unknown fields and invalid values are reported and disable registration. A missing file uses defaults. Explicit names are not truncated by generation settings; additional instructions cannot bypass generated title normalization or length limits.
+Lengths, timeout and output budget must be positive safe integers; timeout must not exceed `2147483647` milliseconds. Unknown fields and invalid values are reported and disable registration. A missing file uses defaults. Explicit names are not truncated by generation settings; additional instructions cannot bypass generated title normalization or length limits.
+
+`maxLength` and `maxTokens` are independent. `maxLength` only truncates the generated title; `maxTokens` only budgets the model response. Reasoning models spend that same budget on thinking and on the title, so on a reasoning model raise `maxTokens` when titles come back empty and lower it to bound cost; `effort` controls how much of the budget thinking is likely to take. No field is derived from another.
 
 For longer English titles use `maxLength: 60`, `preferredLength: 40`, `language: "English"`. Model and authentication come from Pi's current selection; title language is independent of UI language.
 

package/README.zh-CN.md

@@ -37,7 +37,9 @@ pi install npm:pi-naming
     "preferredLength": 10,
     "language": "auto",
     "instructions": "",
-    "timeoutMs": 10000
+    "timeoutMs": 10000,
+    "maxTokens": 2048,
+    "effort": "low"
   }
 }
 ```
@@ -51,8 +53,12 @@ pi install npm:pi-naming
 | `language` | `"auto"` | 跟随消息主要语言，或指定 `English`、`日本語` 等 |
 | `instructions` | `""` | 追加的命名风格要求，不是模板或可执行代码 |
 | `timeoutMs` | `10000` | 标题请求超时（毫秒） |
+| `maxTokens` | `2048` | 标题请求的输出预算，受模型输出上限封顶 |
+| `effort` | `"low"` | 思考档位：`minimal`、`low`、`medium`、`high`、`xhigh`、`max` |
 
-长度和超时必须是正安全整数，超时不超过 `2147483647` 毫秒。未知字段和非法配置会明确报错，不注册功能。缺少配置文件时使用默认值。显式输入的名称不受生成标题长度限制；补充提示不会绕过生成结果的单行清理和长度限制。
+长度、超时和输出预算必须是正安全整数，超时不超过 `2147483647` 毫秒。未知字段和非法配置会明确报错，不注册功能。缺少配置文件时使用默认值。显式输入的名称不受生成标题长度限制；补充提示不会绕过生成结果的单行清理和长度限制。
+
+`maxLength` 与 `maxTokens` 相互独立：`maxLength` 只负责截断生成的标题，`maxTokens` 只负责模型响应的预算，两者不会互相推导。推理模型的思考和标题共用这份预算，所以在推理模型上命名失败就调大 `maxTokens`，想限制成本就调小；`effort` 决定思考大概会占用多少。
 
 例如较长英文标题：`maxLength: 60`、`preferredLength: 40`、`language: "English"`。模型和鉴权直接复用 Pi 当前选择；UI 语言与标题语言独立。
 

package/SKILL.md

@@ -10,7 +10,7 @@ description: 配置 Pi 统一 /rename、首条消息命名和终端目标归属
 Use `/config:naming` to open the normal TUI settings menu; use `reset` for defaults and reload after saving.
 
 - `automaticNaming` / `manualNaming` 控制自动输入和 `/rename [名称]`，`targets` 直接分别控制 session/workspace/tab。Control automatic input and `/rename [name]`; `targets` directly selects session/workspace/tab.
-- `title` 控制长度、语言、补充提示和超时；模型鉴权复用 Pi。Controls length, language, instructions and timeout; model authentication comes from Pi.
+- `title` 控制长度、语言、补充提示、超时、输出预算和思考档位（`maxTokens` 默认 2048、`effort` 默认 low，二者与 `maxLength` 相互独立）；模型鉴权复用 Pi。Controls length, language, instructions, timeout, output budget and thinking effort (`maxTokens` default 2048, `effort` default low, both independent from `maxLength`); model authentication comes from Pi.
 - 无终端也可命名 session；终端失败与跳过必须报告。普通会话明确目标路径不受旧 `PI_SUBAGENT_RENAME_*` 变量影响；关闭 target 即使变量为 `1` 也不执行。Session naming works without a terminal; report terminal failures and skips. The ordinary-session explicit-target path ignores legacy `PI_SUBAGENT_RENAME_*` variables; a disabled target never runs even when a variable is `1`.
 - 子进程归属由启动方通过 mux 协议提供，不把 pane 扩大为共享 tab，不修改父 workspace。Launchers grant child targets through the mux protocol; never expand a pane to a shared tab or rename the parent workspace.
 - 子代理需要显式配置 `subagentExtensions` 加载 naming。Child extension isolation requires explicitly loading naming in `subagentExtensions`.

package/config.example.json

@@ -11,6 +11,8 @@
     "preferredLength": 10,
     "language": "auto",
     "instructions": "",
-    "timeoutMs": 10000
+    "timeoutMs": 10000,
+    "maxTokens": 2048,
+    "effort": "low"
   }
 }

package/locales/index.json

@@ -159,6 +159,14 @@
     "zh-CN": "最大标题长度：{value}",
     "en-US": "Maximum title length: {value}"
   },
+  "configMaxTokens": {
+    "zh-CN": "输出预算：{value} tokens",
+    "en-US": "Output budget: {value} tokens"
+  },
+  "configEffort": {
+    "zh-CN": "思考档位：{value}",
+    "en-US": "Thinking effort: {value}"
+  },
   "configPreferredLength": {
     "zh-CN": "首选标题长度：{value}",
     "en-US": "Preferred title length: {value}"
@@ -207,6 +215,18 @@
     "zh-CN": "最大标题长度（正整数）",
     "en-US": "Maximum title length (positive integer)"
   },
+  "configMaxTokensInput": {
+    "zh-CN": "输出预算（正整数，思考与标题共享）",
+    "en-US": "Output budget (positive integer, shared by thinking and title)"
+  },
+  "configEffortInput": {
+    "zh-CN": "思考档位",
+    "en-US": "Thinking effort"
+  },
+  "configEffortInvalid": {
+    "zh-CN": "思考档位无效：{value}；可选值：{options}",
+    "en-US": "Invalid thinking effort: {value}; allowed: {options}"
+  },
   "configPreferredLengthInput": {
     "zh-CN": "首选标题长度（正整数）",
     "en-US": "Preferred title length (positive integer)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-naming",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Configurable Pi session naming and manual terminal workspace/tab renaming",
   "type": "module",
   "main": "./index.ts",
@@ -57,8 +57,8 @@
     "workspace"
   ],
   "dependencies": {
-    "pi-extensions-i18n": "^0.6.0",
-    "pi-terminal-mux": "^0.6.3"
+    "pi-extensions-i18n": "^0.7.0",
+    "pi-terminal-mux": "^0.6.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": ">=0.80.0",
@@ -67,7 +67,7 @@
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "0.85.1",
     "@types/node": "24.12.4",
-    "pi-terminal-mux": "^0.6.3",
+    "pi-terminal-mux": "^0.6.4",
     "tsx": "4.23.1",
     "typescript": "5.9.3",
     "@earendil-works/pi-ai": "0.85.1"

package/src/config.ts

@@ -8,6 +8,16 @@ const PACKAGE_NAME = "pi-naming";
 const CONFIG_FILENAME = "config.json";
 const FILE_NOT_FOUND_CODE = "ENOENT";
 const MAX_TIMER_MS = 2_147_483_647;
+
+/** 思考档位：与 pi-ai 的 ThinkingLevel 一致，优先级由低到高。 */
+export const TITLE_EFFORT_LEVELS = ["minimal", "low", "medium", "high", "xhigh", "max"] as const;
+
+export type TitleEffort = typeof TITLE_EFFORT_LEVELS[number];
+
+/** 标题请求的默认输出预算；推理模型的思考与标题共享该额度。 */
+const DEFAULT_TITLE_MAX_TOKENS = 2048;
+/** 标题请求的默认思考档位；命名不需要高强度推理。 */
+const DEFAULT_TITLE_EFFORT: TitleEffort = "low";
 const NAMING_SWITCHES = ["automaticNaming", "manualNaming"] as const;
 const TARGET_KEYS = ["session", "workspace", "tab"] as const;
 
@@ -17,6 +27,8 @@ export interface TitleConfig {
   language: string;
   instructions: string;
   timeoutMs: number;
+  maxTokens: number;
+  effort: TitleEffort;
 }
 
 export const DEFAULT_TITLE_CONFIG: Readonly<TitleConfig> = Object.freeze({
@@ -25,6 +37,8 @@ export const DEFAULT_TITLE_CONFIG: Readonly<TitleConfig> = Object.freeze({
   language: "auto",
   instructions: "",
   timeoutMs: 10_000,
+  maxTokens: DEFAULT_TITLE_MAX_TOKENS,
+  effort: DEFAULT_TITLE_EFFORT,
 });
 
 export interface NamingConfig {
@@ -51,6 +65,11 @@ function positiveInteger(value: unknown, field: string): number {
   return value;
 }
 
+/** 判断配置值是否为受支持的思考档位。 */
+export function isTitleEffort(value: unknown): value is TitleEffort {
+  return TITLE_EFFORT_LEVELS.some((level) => level === value);
+}
+
 /** 校验配置字段与取值，为省略的字段补齐默认值。 */
 export function parseConfig(value: unknown): NamingConfig {
   const raw = object(value, "config");
@@ -68,7 +87,7 @@ export function parseConfig(value: unknown): NamingConfig {
     if (!Object.hasOwn(DEFAULT_TITLE_CONFIG, key)) invalid(`title.${key}`);
   }
   const title: TitleConfig = { ...DEFAULT_TITLE_CONFIG };
-  for (const key of ["maxLength", "preferredLength", "timeoutMs"] as const) {
+  for (const key of ["maxLength", "preferredLength", "timeoutMs", "maxTokens"] as const) {
     if (titleRaw[key] !== undefined) title[key] = positiveInteger(titleRaw[key], `title.${key}`);
   }
   if (title.preferredLength > title.maxLength) invalid("title.preferredLength");
@@ -79,6 +98,10 @@ export function parseConfig(value: unknown): NamingConfig {
     title[key] = titleRaw[key].trim();
   }
   if (!title.language) invalid("title.language");
+  if (titleRaw.effort !== undefined) {
+    if (!isTitleEffort(titleRaw.effort)) invalid("title.effort");
+    title.effort = titleRaw.effort;
+  }
   return {
     automaticNaming: (raw.automaticNaming as boolean | undefined) ?? true,
     manualNaming: (raw.manualNaming as boolean | undefined) ?? true,

package/src/index.ts

@@ -1,6 +1,6 @@
 import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { TerminalRenameOutcome, TerminalRenameTarget, ResolveRenameOptions } from "pi-terminal-mux";
-import { configPath, loadConfig, parseConfig, saveConfig, type NamingConfig } from "./config.ts";
+import { configPath, isTitleEffort, loadConfig, parseConfig, saveConfig, TITLE_EFFORT_LEVELS, type NamingConfig } from "./config.ts";
 import { i18n } from "./i18n.ts";
 import { installNoticeRenderer, notifyWithSource, type NoticeColor, type NoticeSource } from "pi-extensions-i18n";
 
@@ -26,11 +26,14 @@ const CONFIG_OPTION = {
   language: 7,
   instructions: 8,
   timeout: 9,
+  maxTokens: 10,
+  effort: 11,
 } as const;
 const MAX_LENGTH_PRESETS = ["15", "30", "60"] as const;
 const PREFERRED_LENGTH_PRESETS = ["10", "20", "40"] as const;
 const LANGUAGE_PRESETS = ["auto", "中文", "English", "日本語"] as const;
 const TIMEOUT_PRESETS = ["5000", "10000", "30000"] as const;
+const MAX_TOKENS_PRESETS = ["1024", "2048", "4096"] as const;
 const MESSAGE_TYPE = "pi-naming";
 
 export interface TerminalNamingAdapter {
@@ -152,6 +155,8 @@ export function registerNamingConfigCommand(
           i18n.t("configLanguage", { value: config.title.language }),
           i18n.t("configInstructions", { value: config.title.instructions || i18n.t("configEmpty") }),
           i18n.t("configTimeout", { value: config.title.timeoutMs }),
+          i18n.t("configMaxTokens", { value: config.title.maxTokens }),
+          i18n.t("configEffort", { value: config.title.effort }),
           doneChoice,
         ];
         const selected = await ctx.ui.select(i18n.t("configMenuTitle"), choices);
@@ -188,6 +193,14 @@ export function registerNamingConfigCommand(
             inputTitle = i18n.t("configInstructionsInput");
             inputValue = config.title.instructions;
             options = [];
+          } else if (selectedIndex === CONFIG_OPTION.maxTokens) {
+            inputTitle = i18n.t("configMaxTokensInput");
+            inputValue = String(config.title.maxTokens);
+            options = MAX_TOKENS_PRESETS;
+          } else if (selectedIndex === CONFIG_OPTION.effort) {
+            inputTitle = i18n.t("configEffortInput");
+            inputValue = config.title.effort;
+            options = TITLE_EFFORT_LEVELS;
           }
           const input = selectedIndex === CONFIG_OPTION.instructions
             ? await ctx.ui.input(inputTitle, inputValue)
@@ -198,7 +211,18 @@ export function registerNamingConfigCommand(
           else if (selectedIndex === CONFIG_OPTION.preferredLength) title.preferredLength = Number(input.trim());
           else if (selectedIndex === CONFIG_OPTION.language) title.language = input;
           else if (selectedIndex === CONFIG_OPTION.instructions) title.instructions = input;
-          else title.timeoutMs = Number(input.trim());
+          else if (selectedIndex === CONFIG_OPTION.maxTokens) title.maxTokens = Number(input.trim());
+          else if (selectedIndex === CONFIG_OPTION.effort) {
+            // 自定义输入可能不是受支持的档位；明确报错并重开菜单，不静默丢弃也不落到其它字段。
+            if (!isTitleEffort(input)) {
+              report(pi, ctx, {
+                message: i18n.t("configEffortInvalid", { value: input, options: TITLE_EFFORT_LEVELS.join(", ") }),
+                level: "error",
+              });
+              continue;
+            }
+            title.effort = input;
+          } else title.timeoutMs = Number(input.trim());
           try { next = parseConfig({ ...config, title }); }
           catch (error) {
             report(pi, ctx, { message: i18n.t("configCommandInvalid", { error: errorMessage(error) }), level: "error" });

package/src/session-name.ts

@@ -1,4 +1,4 @@
-import { complete } from "@earendil-works/pi-ai/compat";
+import { completeSimple } from "@earendil-works/pi-ai/compat";
 import type {
   ExtensionContext,
   SessionEntry,
@@ -6,17 +6,25 @@ import type {
 import { i18n } from "./i18n.ts";
 import { DEFAULT_TITLE_CONFIG, type TitleConfig } from "./config.ts";
 
-const MIN_TITLE_OUTPUT_TOKENS = 64;
-const TOKENS_PER_TITLE_CODE_POINT = 4;
-
 /** 生成标题所需的最小 session 上下文；终端消费者可复用该契约。 */
 export type SessionNameContext = Pick<ExtensionContext, "model" | "modelRegistry">;
 
 /** 可注入的标题 completion，便于终端消费者和测试复用同一套请求逻辑。 */
-export type SessionNameCompletion = (...args: Parameters<typeof complete>) => ReturnType<typeof complete>;
+export type SessionNameCompletion = (...args: Parameters<typeof completeSimple>) => ReturnType<typeof completeSimple>;
 
 type SessionNameModel = Parameters<SessionNameCompletion>[0];
 
+/** 计算标题请求的输出预算：取配置的预算与模型输出上限的较小值。 */
+export function resolveTitleMaxTokens(
+  model: Pick<SessionNameModel, "maxTokens">,
+  configuredMaxTokens: number,
+): number {
+  // 推理模型的思考与标题共用同一份输出预算。预算过小时思考会把额度整个吃掉，
+  // 响应因 max_output_tokens 截断且不含标题文本，最终报“没有返回有效标题”。
+  // 因此预算由 title.maxTokens 统一控制，默认 2048 留出思考余量。
+  return Math.min(model.maxTokens, configuredMaxTokens);
+}
+
 /** 标题请求参数；userMessages 只应包含待分析的用户输入。 */
 export type SessionNameRequest = {
   userMessages: readonly string[];
@@ -127,7 +135,7 @@ export async function requestSessionName({
   userMessages,
   ctx,
   signal,
-  completion = complete,
+  completion = completeSimple,
   title = DEFAULT_TITLE_CONFIG,
 }: SessionNameRequest): Promise<string> {
   if (userMessages.length === 0) {
@@ -166,11 +174,9 @@ export async function requestSessionName({
       apiKey: auth.apiKey,
       headers: auth.headers,
       env: auth.env,
-      // 较长标题需要更多输出预算，但不能超过模型的输出上限。
-      maxTokens: Math.min(
-        model.maxTokens,
-        Math.max(MIN_TITLE_OUTPUT_TOKENS, title.maxLength * TOKENS_PER_TITLE_CODE_POINT),
-      ),
+      maxTokens: resolveTitleMaxTokens(model, title.maxTokens),
+      // 命名不需要高强度推理；档位可配置，降低思考占用预算的波动。
+      reasoning: title.effort,
       signal,
     },
   );