pi-naming 0.6.0 → 0.7.1

package/README.md

@@ -15,7 +15,7 @@ Available through npm after publication. Run `/reload` after installation.
 - **Automatic naming**: the first real user input in a new, unnamed session generates a title in the background and applies it to the allowed session, workspace and tab targets.
 - **`/rename [name]`**: supply an explicit name, or omit it to generate one from user messages on the current branch. Uses the same targets and execution path as automatic naming.
 - **`/config:naming`**: open the TUI settings panel (Pi's `SettingsList`); toggles switch in place, enums and numbers open a submenu, free text opens a prefilled input. Every change is saved and applied immediately, no `/reload`. Use `reset` to restore defaults.
-- Manual generation considers all user input on the current branch and names the main task. Explicit later corrections or goal changes take precedence; procedural follow-ups such as “continue”, “verify”, or “commit” should not overshadow the topic. Other branches, assistant replies and tool output are excluded. Automatic naming still attempts only once on the first input, not after every turn.
+- By default, model-based manual generation considers all user input on the current branch and names the main task. Explicit later corrections or goal changes take precedence; procedural follow-ups such as “continue”, “verify”, or “commit” should not overshadow the topic. Other branches, assistant replies and tool output are excluded. Automatic naming still attempts only once on the first input, not after every turn.
 - Automatic results do not overwrite an existing name. Manual commands supersede pending requests; session switches and reloads discard old results and errors.
 - Each target is independent. Unsupported, disabled, unidentified or failed terminal targets are reported without preventing session naming or other target updates. Non-UI modes receive Pi messages instead of silent failures.
 
@@ -33,6 +33,7 @@ File: `<pi-agent-dir>/extensions/pi-naming/config.json`; respects `PI_CODING_AGE
     "tab": true
   },
   "title": {
+    "usePromptAsTitle": false,
     "maxLength": 15,
     "preferredLength": 10,
     "language": "auto",
@@ -48,6 +49,7 @@ File: `<pi-agent-dir>/extensions/pi-naming/config.json`; respects `PI_CODING_AGE
 
 | Title field | Default | Meaning |
 | --- | --- | --- |
+| `usePromptAsTitle` | `false` | Use a shortened literal first prompt and current directory name, without calling a model |
 | `maxLength` | `15` | Maximum generated Unicode code points; longer output is truncated |
 | `preferredLength` | `10` | Preferred length requested from the model; must not exceed the maximum |
 | `language` | `"auto"` | Dominant message language, or a language such as `English` or `日本語` |
@@ -62,6 +64,10 @@ Lengths, timeout and output budget must be positive safe integers; timeout must
 
 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.
 
+Set `title.usePromptAsTitle: true` (or toggle **Use prompt as title** in `/config:naming`) for deterministic naming. Automatic naming uses the triggering prompt; `/rename` without a name uses the first nonempty user message on the current branch. The format is `directory: prompt`, for example `project: Fix the login timeout`. Whitespace is collapsed without stripping literal quotes, Markdown, or `title:` prefixes. The full title respects `maxLength` in Unicode code points: the directory uses at most half the available space, leaving room for the prompt; limits below 5 show only the prompt. Increase `maxLength` to preserve longer directory names and prompts.
+
+This mode needs no model or credentials. Model-specific preferences (`preferredLength`, `language`, `instructions`, `timeoutMs`, `maxTokens`, `effort`) apply only to model-based naming. Explicit `/rename My title` still uses the supplied name verbatim. Changes in the panel take effect on the next naming operation.
+
 ## Standalone and composed use
 
 - `pi-terminal-mux` is an automatically installed library dependency, not a separate extension to enable. It resolves terminal targets and executes renames, without generating titles.

package/README.zh-CN.md

@@ -15,7 +15,7 @@ pi install npm:pi-naming
 - **首条消息自动命名**：新建且未命名的 session 收到首条真实用户输入后，后台生成标题，同步允许修改的 session、workspace 和 tab。
 - **`/rename [名称]`**：显式指定名称，或省略名称、根据当前分支用户消息生成标题。与自动命名使用相同的目标配置和执行逻辑。
 - **`/config:naming`**：打开 TUI 配置面板（Pi 自带 `SettingsList`）；开关原地切换，枚举与数值回车开二级列表，自由文本回车开预填输入框。改一项立即保存并生效，不需要 `/reload`。输入 `reset` 恢复默认值。
-- 手动生成时综合当前分支的全部用户输入，围绕主要任务命名；后续明确纠正或目标变更优先，“继续”“验证一下”“提交”等流程性跟进不应盖过主题。不会读取其他分支、assistant 回复或工具输出。自动命名仍仅在首条输入时尝试一次，不随每轮对话更新。
+- 默认的模型命名模式在手动生成时综合当前分支的全部用户输入，围绕主要任务命名；后续明确纠正或目标变更优先，“继续”“验证一下”“提交”等流程性跟进不应盖过主题。不会读取其他分支、assistant 回复或工具输出。自动命名仍仅在首条输入时尝试一次，不随每轮对话更新。
 - 不覆盖已有名称的自动命名结果。手动命令优先于尚未完成的旧请求；会话切换或 reload 后丢弃旧结果和错误。
 - 各目标独立执行。终端不支持、被禁用、缺少归属信息或改名失败均明确报告，不阻止 session 和其他可用目标改名。无交互 UI 时通过 Pi 消息报告。
 
@@ -33,6 +33,7 @@ pi install npm:pi-naming
     "tab": true
   },
   "title": {
+    "usePromptAsTitle": false,
     "maxLength": 15,
     "preferredLength": 10,
     "language": "auto",
@@ -48,6 +49,7 @@ pi install npm:pi-naming
 
 | 标题字段 | 默认值 | 含义 |
 | --- | --- | --- |
+| `usePromptAsTitle` | `false` | 用首条提示词的字面文本和当前目录名生成标题，不调用模型 |
 | `maxLength` | `15` | 生成标题最大 Unicode 码点数，超出时截断 |
 | `preferredLength` | `10` | 提示模型优先采用的长度，不得超过最大长度 |
 | `language` | `"auto"` | 跟随消息主要语言，或指定 `English`、`日本語` 等 |
@@ -62,6 +64,10 @@ pi install npm:pi-naming
 
 例如较长英文标题：`maxLength: 60`、`preferredLength: 40`、`language: "English"`。模型和鉴权直接复用 Pi 当前选择；UI 语言与标题语言独立。
 
+设置 `title.usePromptAsTitle: true`，或在 `/config:naming` 中打开「使用提示词命名」，即可使用确定性命名。自动命名使用触发它的提示词；不带名称的 `/rename` 使用当前分支首条非空用户消息。格式为 `目录名: 提示词`，例如 `project: 修复登录超时`。空白会合并为单个空格，保留字面引号、Markdown 和 `title:` 前缀。整个标题仍受 `maxLength` 的 Unicode 码点数限制：目录名最多占可用空间的一半，为提示词保留空间；上限小于 5 时只显示提示词。需要保留更长的目录名和提示词时可调大 `maxLength`。
+
+此模式不需要模型或鉴权。模型相关偏好（`preferredLength`、`language`、`instructions`、`timeoutMs`、`maxTokens`、`effort`）仅作用于模型命名。显式 `/rename 自定义标题` 仍直接使用输入名称。面板改动在下一次命名时立即生效。
+
 ## 独立使用与组合
 
 - `pi-terminal-mux` 是自动安装的库依赖，无需额外启用扩展；负责目标探测与终端执行，不负责生成标题。

package/SKILL.md

@@ -11,6 +11,7 @@ Use `/config:naming` to open the TUI settings panel (Pi's SettingsList); use `re
 
 - `automaticNaming` / `manualNaming` 控制自动输入和 `/rename [名称]`，`targets` 直接分别控制 session/workspace/tab。Control automatic input and `/rename [name]`; `targets` directly selects session/workspace/tab.
 - `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.
+- `title.usePromptAsTitle` 默认 false；打开后用首条非空提示词与当前目录名生成 `目录名: 提示词`，自动和不带名称的 `/rename` 都不调用模型，也无需鉴权。整个标题受 `maxLength` 限制，目录最多占可用空间一半，上限小于 5 时仅保留提示词；其他模型偏好不适用。Defaults to false; enable it to use `directory: first prompt` without a model or credentials. The full title respects `maxLength`, reserving at least half the space for the prompt; limits below 5 omit the directory. Model-only preferences do not apply.
 - 无终端也可命名 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

@@ -7,6 +7,7 @@
     "tab": true
   },
   "title": {
+    "usePromptAsTitle": false,
     "maxLength": 15,
     "preferredLength": 10,
     "language": "auto",

package/locales/index.json

@@ -72,8 +72,8 @@
     "en-US": "Invalid configuration field: {field}. Check the field name, type and allowed range."
   },
   "renameDescription": {
-    "zh-CN": "统一命名 session 与允许修改的终端目标；省略名称时综合当前分支全部用户消息生成",
-    "en-US": "Name the session and allowed terminal targets; omit the name to summarize all user messages on the current branch"
+    "zh-CN": "统一命名 session 与允许修改的终端目标；省略名称时按标题配置生成",
+    "en-US": "Name the session and allowed terminal targets; omit the name to generate a title using naming settings"
   },
   "namingManualDisabled": {
     "zh-CN": "手动命名已关闭：用 /config:naming 打开「手动命名」后再试",
@@ -168,8 +168,8 @@
     "en-US": "Manual /rename"
   },
   "panelDescManualNaming": {
-    "zh-CN": "允许用 /rename 手动命名；省略名称时综合当前分支全部用户消息生成",
-    "en-US": "Allow manual naming through /rename; omitting the name summarizes all user messages on the current branch"
+    "zh-CN": "允许用 /rename 手动命名；省略名称时按标题配置生成",
+    "en-US": "Allow manual naming through /rename; omitting the name generates a title using naming settings"
   },
   "panelLabelSessionTarget": {
     "zh-CN": "命名 session",
@@ -258,5 +258,13 @@
   "panelValueUnset": {
     "zh-CN": "未设置",
     "en-US": "not set"
+  },
+  "panelLabelUsePromptAsTitle": {
+    "zh-CN": "使用提示词命名",
+    "en-US": "Use prompt as title"
+  },
+  "panelDescUsePromptAsTitle": {
+    "zh-CN": "用首条提示词和当前目录名生成标题，不调用模型",
+    "en-US": "Use the first prompt and current directory name without a model request"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-naming",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "Configurable Pi session naming and manual terminal workspace/tab renaming",
   "type": "module",
   "main": "./index.ts",
@@ -59,7 +59,7 @@
   "dependencies": {
     "pi-extensions-i18n": "^0.9.0",
     "pi-model-request": "^0.1.1",
-    "pi-terminal-mux": "^0.6.7"
+    "pi-terminal-mux": "^0.6.8"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": ">=0.80.0",
@@ -72,7 +72,7 @@
     "@earendil-works/pi-tui": "0.85.1",
     "@types/node": "24.12.4",
     "pi-model-request": "^0.1.1",
-    "pi-terminal-mux": "^0.6.7",
+    "pi-terminal-mux": "^0.6.8",
     "tsx": "4.23.1",
     "typescript": "5.9.3"
   }

package/src/config-panel.ts

@@ -33,6 +33,7 @@ export const PANEL_FIELD = {
   sessionTarget: "targets.session",
   workspaceTarget: "targets.workspace",
   tabTarget: "targets.tab",
+  usePromptAsTitle: "title.usePromptAsTitle",
   maxLength: "title.maxLength",
   preferredLength: "title.preferredLength",
   language: "title.language",
@@ -81,6 +82,7 @@ const PANEL_FIELDS: readonly PanelField[] = [
   { id: PANEL_FIELD.sessionTarget, kind: "toggle", labelKey: "panelLabelSessionTarget", descriptionKey: "panelDescSessionTarget" },
   { id: PANEL_FIELD.workspaceTarget, kind: "toggle", labelKey: "panelLabelWorkspaceTarget", descriptionKey: "panelDescWorkspaceTarget" },
   { id: PANEL_FIELD.tabTarget, kind: "toggle", labelKey: "panelLabelTabTarget", descriptionKey: "panelDescTabTarget" },
+  { id: PANEL_FIELD.usePromptAsTitle, kind: "toggle", labelKey: "panelLabelUsePromptAsTitle", descriptionKey: "panelDescUsePromptAsTitle" },
   { id: PANEL_FIELD.maxLength, kind: "choice", labelKey: "panelLabelMaxLength", descriptionKey: "panelDescMaxLength" },
   { id: PANEL_FIELD.preferredLength, kind: "choice", labelKey: "panelLabelPreferredLength", descriptionKey: "panelDescPreferredLength" },
   { id: PANEL_FIELD.language, kind: "choice", labelKey: "panelLabelLanguage", descriptionKey: "panelDescLanguage" },
@@ -137,6 +139,7 @@ function fieldOptions(id: PanelFieldId, config: NamingConfig): PanelOption[] {
     case PANEL_FIELD.sessionTarget:
     case PANEL_FIELD.workspaceTarget:
     case PANEL_FIELD.tabTarget:
+    case PANEL_FIELD.usePromptAsTitle:
       return toggleOptions();
     case PANEL_FIELD.maxLength:
       return numberOptions(MAX_LENGTH_PRESETS);
@@ -181,6 +184,8 @@ function readField(config: NamingConfig, id: PanelFieldId): string {
       return config.targets.workspace ? TOGGLE_ON : TOGGLE_OFF;
     case PANEL_FIELD.tabTarget:
       return config.targets.tab ? TOGGLE_ON : TOGGLE_OFF;
+    case PANEL_FIELD.usePromptAsTitle:
+      return config.title.usePromptAsTitle ? TOGGLE_ON : TOGGLE_OFF;
     case PANEL_FIELD.maxLength:
       return String(config.title.maxLength);
     case PANEL_FIELD.preferredLength:
@@ -212,6 +217,8 @@ function writeField(config: NamingConfig, id: PanelFieldId, value: string): Nami
       return { ...config, targets: { ...config.targets, workspace: value === TOGGLE_ON } };
     case PANEL_FIELD.tabTarget:
       return { ...config, targets: { ...config.targets, tab: value === TOGGLE_ON } };
+    case PANEL_FIELD.usePromptAsTitle:
+      return { ...config, title: { ...title, usePromptAsTitle: value === TOGGLE_ON } };
     case PANEL_FIELD.maxLength:
       return { ...config, title: { ...title, maxLength: Number(value) } };
     case PANEL_FIELD.preferredLength:

package/src/config.ts

@@ -29,6 +29,7 @@ const NAMING_SWITCHES = ["automaticNaming", "manualNaming"] as const;
 const TARGET_KEYS = ["session", "workspace", "tab"] as const;
 
 export interface TitleConfig {
+  usePromptAsTitle: boolean;
   maxLength: number;
   preferredLength: number;
   language: string;
@@ -39,6 +40,7 @@ export interface TitleConfig {
 }
 
 export const DEFAULT_TITLE_CONFIG: Readonly<TitleConfig> = Object.freeze({
+  usePromptAsTitle: false,
   maxLength: 15,
   preferredLength: 10,
   language: "auto",
@@ -94,6 +96,10 @@ export function parseConfig(value: unknown): NamingConfig {
     if (!Object.hasOwn(DEFAULT_TITLE_CONFIG, key)) invalid(`title.${key}`);
   }
   const title: TitleConfig = { ...DEFAULT_TITLE_CONFIG };
+  if (titleRaw.usePromptAsTitle !== undefined) {
+    if (typeof titleRaw.usePromptAsTitle !== "boolean") invalid("title.usePromptAsTitle");
+    title.usePromptAsTitle = titleRaw.usePromptAsTitle;
+  }
   for (const key of ["maxLength", "preferredLength", "timeoutMs", "maxTokens"] as const) {
     if (titleRaw[key] !== undefined) title[key] = positiveInteger(titleRaw[key], `title.${key}`);
   }

package/src/index.ts

@@ -11,7 +11,7 @@ const NOTICE_TAG = "naming";
 const NOTICE_COLOR: NoticeColor = NOTICE_TAG_COLOR;
 /** 本扩展的提示来源。 */
 const NOTICE_SOURCE: NoticeSource = { tag: NOTICE_TAG, color: NOTICE_COLOR };
-import { getCurrentSessionUserMessages, requestSessionNameWithTimeout, type SessionNameRequester } from "./session-name.ts";
+import { buildPromptSessionName, getCurrentSessionUserMessages, requestSessionNameWithTimeout, type SessionNameRequester } from "./session-name.ts";
 
 const RENAME_COMMAND = "rename";
 const CONFIG_COMMAND_ALIASES = ["config:naming", "naming-config", "pi-naming-config"] as const;
@@ -168,10 +168,14 @@ export async function registerNaming(
     let label = automatic ? "" : args.trim();
     if (!label) {
       try {
-        label = await requestSessionNameWithTimeout({
-          userMessages: automatic ? [args] : getCurrentSessionUserMessages(ctx),
-          ctx, requestName, title: current().title,
-        });
+        const userMessages = automatic ? [args] : getCurrentSessionUserMessages(ctx);
+        const title = current().title;
+        label = title.usePromptAsTitle
+          ? buildPromptSessionName(userMessages, ctx.cwd, title.maxLength)
+          : await requestSessionNameWithTimeout({
+            userMessages,
+            ctx, requestName, title,
+          });
       } catch (error) {
         if (isCurrent()) report(pi, ctx, { message: i18n.t("namingFailed", { error: errorMessage(error) }), level: "error" });
         return;

package/src/session-name.ts

@@ -4,6 +4,7 @@ import type {
   SessionEntry,
 } from "@earendil-works/pi-coding-agent";
 import { createModelRequester } from "pi-model-request";
+import { basename } from "node:path";
 import { i18n } from "./i18n.ts";
 import { DEFAULT_TITLE_CONFIG, type TitleConfig } from "./config.ts";
 
@@ -131,6 +132,23 @@ export function normalizeSessionName(raw: string, maxLength = DEFAULT_TITLE_CONF
   return Array.from(name).slice(0, maxLength).join("").trim();
 }
 
+/** 用首条非空提示词和目录名生成标题，保留字面文本，不做模型响应格式清理。 */
+export function buildPromptSessionName(
+  userMessages: readonly string[],
+  cwd: string,
+  maxLength = DEFAULT_TITLE_CONFIG.maxLength,
+): string {
+  const singleLine = (value: string): string => value.replace(/[\u0000-\u001f\u007f-\u009f]/g, " ").replace(/\s+/g, " ").trim();
+  const prompt = userMessages.map(singleLine).find(Boolean);
+  if (!prompt) throw new Error(i18n.t("sessionNameNoMessages"));
+  const promptPoints = Array.from(prompt);
+  const directory = Array.from(singleLine(basename(cwd) || cwd));
+  // 至少给提示词留一半空间；极短上限只显示提示词，避免目录前缀挤掉整个主题。
+  if (directory.length === 0 || maxLength < 5) return promptPoints.slice(0, maxLength).join("").trim();
+  const directoryLength = Math.min(directory.length, Math.floor((maxLength - 2) / 2));
+  return `${directory.slice(0, directoryLength).join("")}: ${promptPoints.slice(0, maxLength - directoryLength - 2).join("")}`.trim();
+}
+
 /** 调用当前 session 模型生成名称，并把鉴权、空响应和模型错误显式抛出。 */
 export async function requestSessionName({
   userMessages,