@co0ontty/wand 4.63.0 → 4.64.0-beta.g3402a64

package/dist/server-workspace-routes.js

@@ -8,10 +8,10 @@ import { expandHomePath } from "./middleware/path-safety.js";
 import { checkSessionWorktreeMergeabilityAsync, cleanupWorktreeSync, prepareSessionWorktree, resolveWorktreeTargetBranchAsync, } from "./git-worktree.js";
 import { collectSessionTopicBlocklist } from "./session-topic.js";
 import { resolveSessionDisplayTitle } from "./session-transport.js";
-import { GLOBAL_WORKSPACE_ID } from "./types.js";
-import { attachUnboundSessionsToWorkspace, backfillSessionWorkspaces, normalizeProjectCwd, projectCwdForSession, syncDirectoryNameForWorkspace, } from "./workspace-binding.js";
+import { attachUnboundSessionsToWorkspace, backfillSessionWorkspaces, normalizeProjectCwd, projectCwdForSession, isGlobalWorkspace, syncDirectoryNameForWorkspace } from "./workspace-binding.js";
 import { archiveBoardTaskForWorkspaceTask, ensureBoardTaskForWorkspaceTask } from "./wand-task-sync.js";
-const PROVIDERS = new Set(["claude", "codex", "opencode", "grok", "qoder", "pi"]);
+import { isSessionProvider } from "./session-provider.js";
+import { firstLayoutTabId } from "./layout-tree.js";
 function workspaceSessionTitle(session, names = {}) {
     return resolveSessionDisplayTitle(session, collectSessionTopicBlocklist({
         taskName: names.taskName,
@@ -74,7 +74,7 @@ function rememberCreatedAt(target, iso) {
         target.createdAt = value;
 }
 function parseDefaultProvider(value) {
-    return typeof value === "string" && PROVIDERS.has(value) ? value : undefined;
+    return isSessionProvider(value) ? value : undefined;
 }
 /** Resolve + validate a workspace cwd: expand home, require an existing directory. */
 function resolveWorkspaceCwd(raw) {
@@ -96,9 +96,6 @@ function deleteSessions(storage, sessions, sessionIds) {
             storage.deleteSession(sessionId);
     }
 }
-function isGlobalWorkspace(workspace) {
-    return workspace.kind === "global" || workspace.id === GLOBAL_WORKSPACE_ID;
-}
 function taskRuntimeCwd(task, workspace) {
     return task.worktree?.path ?? task.cwd ?? workspace?.cwd ?? "";
 }
@@ -226,11 +223,6 @@ function layoutHasTab(node, tabId) {
         return node.tabs.some((tab) => tab.id === tabId);
     return layoutHasTab(node.children[0], tabId) || layoutHasTab(node.children[1], tabId);
 }
-function firstLayoutTabId(node) {
-    if (node.type === "pane")
-        return node.tabs[node.active]?.id ?? node.tabs[0]?.id;
-    return firstLayoutTabId(node.children[0]) ?? firstLayoutTabId(node.children[1]);
-}
 /** 校验任务级工作窗口集合；旧版单棵布局会兼容升级成一个 window。 */
 export function sanitizeTaskLayout(value) {
     const legacy = sanitizeLayoutNode(value);

package/dist/server.js

@@ -24,6 +24,7 @@ import { registerLocalPreviewRoutes } from "./server-local-preview-routes.js";
 import { registerSettingsRoutes } from "./server-settings-routes.js";
 import { appTokenLoginPayload, buildStructuredChatPersonaPayload, isBrowserExtensionOrigin, resolveAppConnectCode, resolveStructuredChatAvatarPath, verifyAppToken, } from "./server-app-connect.js";
 import { firstHeaderValue, sendRouteError } from "./server-request.js";
+import { inferProviderFromCommand, isSessionProvider } from "./session-provider.js";
 import { registerVaultRoutes } from "./server-vault-routes.js";
 import { registerGithubRoutes } from "./server-github-routes.js";
 import { registerTaskRoutes } from "./server-task-routes.js";
@@ -41,7 +42,7 @@ import { checkPackageUpdateAsync, installPackageGloballyAsync, normalizeUpdateCh
 import { repairServiceUnitAfterUpdate } from "./service-self-repair.js";
 import { computeRelaunch } from "./relaunch.js";
 import { RuntimeConfigState } from "./runtime-config.js";
-import { isServiceInstalled } from "./tui/commands.js";
+import { safeServiceInstalled } from "./tui/runtime-utils.js";
 import { checkManagedServiceUpdatePreflight, } from "./update-helper.js";
 import { toSessionDetailDTO } from "./session-transport.js";
 import { registerUploadRoutes } from "./upload-routes.js";
@@ -64,6 +65,16 @@ const PKG_NAME = PKG_JSON.name;
 const PKG_VERSION = PKG_JSON.version;
 const PKG_NODE_REQ = PKG_JSON.engines?.node ?? ">=22.5.0";
 const PKG_REPO_URL = "https://github.com/co0ontty/wand";
+/** 结构化聊天头像允许的图片类型；未知扩展名回 415。 */
+const AVATAR_CONTENT_TYPES = {
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+    ".avif": "image/avif",
+};
 // ── Update check cache ──
 const CACHE_TTL_MS = 10 * 60 * 1000; // 10 minutes
 const MODEL_CATALOG_AUTO_REFRESH_INTERVAL_MS = 30 * 60 * 1000;
@@ -82,6 +93,7 @@ async function checkLatestPackageVersion(channel, forceRefresh = false) {
     }
     return info;
 }
+// ── Build info (构建时打入的 commit SHA) + Beta 通道 ──
 /** 读取 dist/build-info.json（由 scripts/stamp-build-info.js 在 build 时生成）。 */
 function readBuildInfo() {
     try {
@@ -184,6 +196,15 @@ function authenticateBearerAppToken(req, storage, config) {
         return null;
     }
 }
+/**
+ * 解析 PTY 会话的 provider：显式 `provider` 字段优先，其次按命令前缀识别；
+ * 都识别不出时回落到 Claude，与旧版客户端行为保持一致。
+ */
+function resolveProviderForCommand(provider, command) {
+    if (isSessionProvider(provider))
+        return provider;
+    return inferProviderFromCommand(command) ?? "claude";
+}
 // ── Startup error handling ──
 process.on("uncaughtException", (err) => {
     wandError("服务器异常", err.message, "请检查配置是否正确，或尝试重启服务。");
@@ -261,24 +282,15 @@ export async function startServer(config, configPath, options = {}) {
     const storage = new WandStorage(resolveDatabasePath(configPath));
     const runtimeConfig = new RuntimeConfigState(config);
     const authService = new AuthService(storage);
-    // Helper to get current default models from storage (not from startup-captured config)
-    // This allows model preferences to update in real-time when user changes config via UI
-    const getCurrentDefaultModels = () => {
-        // Try to read from storage first (most up-to-date via UI settings)
-        // Falls back to config values for deployment settings
-        const prefStorage = storage;
-        if (prefStorage) {
-            return {
-                claude: prefStorage.getPreference("pref:defaultModel", config.defaultModel ?? ""),
-                codex: prefStorage.getPreference("pref:defaultCodexModel", config.defaultCodexModel ?? ""),
-                opencode: prefStorage.getPreference("pref:defaultOpenCodeModel", config.defaultOpenCodeModel ?? ""),
-                grok: prefStorage.getPreference("pref:defaultGrokModel", config.defaultGrokModel ?? ""),
-                qoder: prefStorage.getPreference("pref:defaultQoderModel", config.defaultQoderModel ?? ""),
-                pi: prefStorage.getPreference("pref:defaultPiModel", config.defaultPiModel ?? ""),
-            };
-        }
-        return getProviderDefaultModels(config);
-    };
+    // 默认模型优先读存储（UI 改设置后实时生效），未设置时由 getPreference 回落到 config。
+    const getCurrentDefaultModels = () => ({
+        claude: storage.getPreference("pref:defaultModel", config.defaultModel ?? ""),
+        codex: storage.getPreference("pref:defaultCodexModel", config.defaultCodexModel ?? ""),
+        opencode: storage.getPreference("pref:defaultOpenCodeModel", config.defaultOpenCodeModel ?? ""),
+        grok: storage.getPreference("pref:defaultGrokModel", config.defaultGrokModel ?? ""),
+        qoder: storage.getPreference("pref:defaultQoderModel", config.defaultQoderModel ?? ""),
+        pi: storage.getPreference("pref:defaultPiModel", config.defaultPiModel ?? ""),
+    });
     const getModelRefreshOptions = () => {
         const injected = options.modelRefreshOptions?.() ?? {};
         const currentDefaults = getCurrentDefaultModels();
@@ -390,20 +402,7 @@ export async function startServer(config, configPath, options = {}) {
                 res.status(404).end();
                 return;
             }
-            const ext = path.extname(resolvedPath).toLowerCase();
-            const contentType = ext === ".svg"
-                ? "image/svg+xml"
-                : ext === ".png"
-                    ? "image/png"
-                    : ext === ".jpg" || ext === ".jpeg"
-                        ? "image/jpeg"
-                        : ext === ".webp"
-                            ? "image/webp"
-                            : ext === ".gif"
-                                ? "image/gif"
-                                : ext === ".avif"
-                                    ? "image/avif"
-                                    : null;
+            const contentType = AVATAR_CONTENT_TYPES[path.extname(resolvedPath).toLowerCase()];
             if (!contentType) {
                 res.status(415).json({ error: "不支持的头像格式。" });
                 return;
@@ -715,17 +714,7 @@ export async function startServer(config, configPath, options = {}) {
             const rawCommand = body.command?.trim() ?? "";
             const provider = interactiveShell
                 ? undefined
-                : body.provider === "codex" || /^codex\b/.test(rawCommand)
-                    ? "codex"
-                    : body.provider === "opencode" || /^opencode\b/.test(rawCommand)
-                        ? "opencode"
-                        : body.provider === "grok" || /^grok\b/.test(rawCommand)
-                            ? "grok"
-                            : body.provider === "qoder" || /^qodercli\b/.test(rawCommand)
-                                ? "qoder"
-                                : body.provider === "pi" || /^pi\b/.test(rawCommand)
-                                    ? "pi"
-                                    : "claude";
+                : resolveProviderForCommand(body.provider, rawCommand);
             // Older clients used the provider id as the PTY command. Qoder's executable
             // is named qodercli, so keep those clients working while preserving custom commands.
             const command = provider === "qoder" && rawCommand === "qoder"
@@ -845,14 +834,6 @@ export async function startServer(config, configPath, options = {}) {
     // previous web process was down; fire-and-forget, failures are logged inside.
     void structuredSessions.recoverDetachedRuns();
     // ── Restart endpoint (needs server + wss in scope) ──
-    function safeServiceInstalled() {
-        try {
-            return isServiceInstalled();
-        }
-        catch {
-            return false;
-        }
-    }
     /**
      * 统一的关服 + 重启。重启方式由 computeRelaunch 决定：
      *   - systemd 托管且已装服务 → 仅退出，交给 Restart=always 用（更新自修复后可能刚被
@@ -975,53 +956,6 @@ export async function startServer(config, configPath, options = {}) {
         }, MODEL_CATALOG_AUTO_REFRESH_INTERVAL_MS);
         modelCatalogRefreshTimer.unref();
     }
-    // ── Auto-update endpoints ──
-    app.get("/api/auto-update", requireAdmin, (_req, res) => {
-        const web = storage.getConfigValue("autoUpdateWeb") === "true";
-        const apk = storage.getConfigValue("autoUpdateApk") === "true";
-        const dmg = storage.getConfigValue("autoUpdateDmg") === "true";
-        const cli = storage.getConfigValue("autoUpdateProviderClis") === "true";
-        res.json({ web, apk, dmg, cli });
-    });
-    app.post("/api/auto-update", requireAdmin, (req, res) => {
-        const { web, apk, dmg, cli } = req.body;
-        if (typeof web === "boolean") {
-            storage.setConfigValue("autoUpdateWeb", String(web));
-        }
-        if (typeof apk === "boolean") {
-            storage.setConfigValue("autoUpdateApk", String(apk));
-        }
-        if (typeof dmg === "boolean") {
-            storage.setConfigValue("autoUpdateDmg", String(dmg));
-        }
-        if (typeof cli === "boolean") {
-            storage.setConfigValue("autoUpdateProviderClis", String(cli));
-        }
-        res.json({
-            web: storage.getConfigValue("autoUpdateWeb") === "true",
-            apk: storage.getConfigValue("autoUpdateApk") === "true",
-            dmg: storage.getConfigValue("autoUpdateDmg") === "true",
-            cli: storage.getConfigValue("autoUpdateProviderClis") === "true",
-        });
-    });
-    // ── Update channel (stable / beta) ──
-    app.get("/api/update-channel", requireAdmin, (_req, res) => {
-        res.json({
-            channel: getUpdateChannel(),
-            build: {
-                commit: BUILD_INFO.commit,
-                shortCommit: BUILD_INFO.commit ? BUILD_INFO.commit.slice(0, 7) : null,
-                builtAt: BUILD_INFO.builtAt,
-                channel: BUILD_INFO.channel,
-            },
-        });
-    });
-    app.post("/api/update-channel", requireAdmin, (req, res) => {
-        const body = (req.body ?? {});
-        const channel = body.channel === "beta" ? "beta" : "stable";
-        storage.setConfigValue("updateChannel", channel);
-        res.json({ channel });
-    });
     // Express 4 does not forward rejected route promises automatically. Every
     // async route above is wrapped with asyncRoute, and this final middleware
     // keeps parser, synchronous middleware, and async failures JSON-shaped.

package/dist/session-ai-context.js

@@ -1,51 +1,19 @@
 import { getDefaultModelForProvider } from "./config.js";
 import { discoverCliSystemAiConfigs, mergeSystemAiConfigs, systemAiProfiles, } from "./system-ai.js";
+import { inferProviderFromCommand, inferProviderFromRunner, isSessionProvider } from "./session-provider.js";
 /**
  * Resolve the provider from every representation used by current and legacy
  * sessions. Older persisted sessions may not have the top-level provider, but
  * still identify Codex through structuredState, runner, or command.
  */
 export function resolveSessionProvider(snapshot) {
-    if (snapshot.provider === "claude"
-        || snapshot.provider === "codex"
-        || snapshot.provider === "opencode"
-        || snapshot.provider === "grok"
-        || snapshot.provider === "qoder"
-        || snapshot.provider === "pi") {
+    if (isSessionProvider(snapshot.provider))
         return snapshot.provider;
-    }
-    if (snapshot.structuredState?.provider === "claude"
-        || snapshot.structuredState?.provider === "codex"
-        || snapshot.structuredState?.provider === "opencode"
-        || snapshot.structuredState?.provider === "grok"
-        || snapshot.structuredState?.provider === "qoder"
-        || snapshot.structuredState?.provider === "pi") {
-        return snapshot.structuredState.provider;
-    }
+    const structuredProvider = snapshot.structuredState?.provider;
+    if (isSessionProvider(structuredProvider))
+        return structuredProvider;
     const runner = snapshot.runner ?? snapshot.structuredState?.runner;
-    if (runner === "codex-cli-exec")
-        return "codex";
-    if (runner === "opencode-cli-run")
-        return "opencode";
-    if (runner === "grok-cli-headless")
-        return "grok";
-    if (runner === "qoder-cli-print")
-        return "qoder";
-    if (runner === "pi-cli-json")
-        return "pi";
-    if (runner === "claude-cli" || runner === "claude-cli-print" || runner === "claude-sdk")
-        return "claude";
-    if (/^codex\b/i.test(snapshot.command.trim()))
-        return "codex";
-    if (/^opencode\b/i.test(snapshot.command.trim()))
-        return "opencode";
-    if (/^grok\b/i.test(snapshot.command.trim()))
-        return "grok";
-    if (/^qodercli\b/i.test(snapshot.command.trim()))
-        return "qoder";
-    if (/^pi\b/i.test(snapshot.command.trim()))
-        return "pi";
-    return "claude";
+    return inferProviderFromRunner(runner) ?? inferProviderFromCommand(snapshot.command) ?? "claude";
 }
 function normalizeModel(value) {
     const model = value?.trim();

package/dist/session-provider.d.ts

@@ -0,0 +1,16 @@
+import type { SessionProvider } from "./types.js";
+/** 全部受支持的会话 provider；顺序与 UI / 派发选择器一致。 */
+export declare const SESSION_PROVIDERS: readonly ["claude", "codex", "opencode", "grok", "qoder", "pi"];
+/** 运行时守卫：把配置、数据库、请求体里的任意值收敛成 SessionProvider。 */
+export declare function isSessionProvider(value: unknown): value is SessionProvider;
+/** provider 对应的 CLI 可执行文件名（Qoder 的 CLI 叫 qodercli）。 */
+export declare function providerCliCommand(provider: SessionProvider): string;
+/** 从 runner 名推断 provider；`pty` 等与 provider 无关的 runner 返回 undefined。 */
+export declare function inferProviderFromRunner(runner: unknown): SessionProvider | undefined;
+/**
+ * 从启动命令推断 provider；无法识别时返回 undefined，由调用方决定默认值。
+ *
+ * 识别的是命令行的第一个 token：`claude`、`npx claude`、任意路径下的 `claude`
+ * 都算 Claude，其余 provider 要求命令以其 CLI 名开头。
+ */
+export declare function inferProviderFromCommand(command: string): SessionProvider | undefined;

package/dist/session-provider.js

@@ -0,0 +1,49 @@
+/** 全部受支持的会话 provider；顺序与 UI / 派发选择器一致。 */
+export const SESSION_PROVIDERS = ["claude", "codex", "opencode", "grok", "qoder", "pi"];
+const SESSION_PROVIDER_SET = new Set(SESSION_PROVIDERS);
+/** 运行时守卫：把配置、数据库、请求体里的任意值收敛成 SessionProvider。 */
+export function isSessionProvider(value) {
+    return typeof value === "string" && SESSION_PROVIDER_SET.has(value);
+}
+/** provider 对应的 CLI 可执行文件名（Qoder 的 CLI 叫 qodercli）。 */
+export function providerCliCommand(provider) {
+    return provider === "qoder" ? "qodercli" : provider;
+}
+/** 从 runner 名推断 provider；`pty` 等与 provider 无关的 runner 返回 undefined。 */
+export function inferProviderFromRunner(runner) {
+    if (runner === "claude-cli" || runner === "claude-cli-print" || runner === "claude-sdk")
+        return "claude";
+    if (runner === "codex-cli-exec")
+        return "codex";
+    if (runner === "opencode-cli-run")
+        return "opencode";
+    if (runner === "grok-cli-headless")
+        return "grok";
+    if (runner === "qoder-cli-print")
+        return "qoder";
+    if (runner === "pi-cli-json")
+        return "pi";
+    return undefined;
+}
+/**
+ * 从启动命令推断 provider；无法识别时返回 undefined，由调用方决定默认值。
+ *
+ * 识别的是命令行的第一个 token：`claude`、`npx claude`、任意路径下的 `claude`
+ * 都算 Claude，其余 provider 要求命令以其 CLI 名开头。
+ */
+export function inferProviderFromCommand(command) {
+    const value = command.trim();
+    if (/^(?:claude|npx\s+claude|[^\s]+\/claude)(?:\s|$)/i.test(value))
+        return "claude";
+    if (/^codex\b/i.test(value))
+        return "codex";
+    if (/^opencode\b/i.test(value))
+        return "opencode";
+    if (/^grok\b/i.test(value))
+        return "grok";
+    if (/^qodercli\b/i.test(value))
+        return "qoder";
+    if (/^pi\b/i.test(value))
+        return "pi";
+    return undefined;
+}

package/dist/session-registry.d.ts

@@ -3,6 +3,15 @@ import type { StructuredSessionManager } from "./structured-session-manager.js";
 import type { WandStorage } from "./storage.js";
 import type { ExecutionMode, SessionSnapshot } from "./types.js";
 export type SessionOwner = "structured" | "pty" | "storage";
+type HiddenSessionStore = Pick<WandStorage, "getConfigValue" | "setConfigValue">;
+/** 读取 `hidden_claude_session_ids`；坏数据 / 空值按空集合处理，不抛错。 */
+export declare function readHiddenSessionIds(storage: Pick<HiddenSessionStore, "getConfigValue">): Set<string>;
+/** 写回 `hidden_claude_session_ids`（保持既有的 JSON 数组格式）。 */
+export declare function writeHiddenSessionIds(storage: Pick<HiddenSessionStore, "setConfigValue">, ids: Set<string>): void;
+/** 追加若干 provider 原生 session id；无变化时不写盘。 */
+export declare function addHiddenSessionIds(storage: HiddenSessionStore, ids: readonly string[]): void;
+/** 移除若干 provider 原生 session id；无变化时不写盘。 */
+export declare function removeHiddenSessionIds(storage: HiddenSessionStore, ids: readonly string[]): void;
 /**
  * Coordinates session ownership without merging the two runner managers.
  * Live structured state wins over PTY, and both win over a durable fallback.
@@ -25,3 +34,4 @@ export declare class SessionRegistry {
     deleteWithProviderHistory(id: string): SessionSnapshot | null;
     private updateStored;
 }
+export {};

package/dist/session-registry.js

@@ -1,22 +1,52 @@
 import { cleanupWorktreeSync } from "./git-worktree.js";
+import { inferProviderFromCommand } from "./session-provider.js";
 function slimSnapshot(snapshot) {
     const { output: _output, messages: _messages, ...slim } = snapshot;
     return { ...slim, output: "" };
 }
-function addHiddenProviderSessionId(storage, id) {
+/** 读取 `hidden_claude_session_ids`；坏数据 / 空值按空集合处理，不抛错。 */
+export function readHiddenSessionIds(storage) {
     const raw = storage.getConfigValue("hidden_claude_session_ids");
-    let hidden;
+    if (!raw)
+        return new Set();
     try {
-        const parsed = raw ? JSON.parse(raw) : [];
-        hidden = new Set(Array.isArray(parsed) ? parsed.filter((value) => typeof value === "string") : []);
+        const parsed = JSON.parse(raw);
+        return new Set(Array.isArray(parsed) ? parsed.filter((value) => typeof value === "string") : []);
     }
     catch {
-        hidden = new Set();
+        return new Set();
     }
-    if (hidden.has(id))
+}
+/** 写回 `hidden_claude_session_ids`（保持既有的 JSON 数组格式）。 */
+export function writeHiddenSessionIds(storage, ids) {
+    storage.setConfigValue("hidden_claude_session_ids", JSON.stringify(Array.from(ids)));
+}
+/** 追加若干 provider 原生 session id；无变化时不写盘。 */
+export function addHiddenSessionIds(storage, ids) {
+    if (ids.length === 0)
+        return;
+    const hidden = readHiddenSessionIds(storage);
+    let changed = false;
+    for (const id of ids) {
+        if (hidden.has(id))
+            continue;
+        hidden.add(id);
+        changed = true;
+    }
+    if (changed)
+        writeHiddenSessionIds(storage, hidden);
+}
+/** 移除若干 provider 原生 session id；无变化时不写盘。 */
+export function removeHiddenSessionIds(storage, ids) {
+    if (ids.length === 0)
         return;
-    hidden.add(id);
-    storage.setConfigValue("hidden_claude_session_ids", JSON.stringify(Array.from(hidden)));
+    const hidden = readHiddenSessionIds(storage);
+    let changed = false;
+    for (const id of ids) {
+        changed = hidden.delete(id) || changed;
+    }
+    if (changed)
+        writeHiddenSessionIds(storage, hidden);
 }
 /**
  * Coordinates session ownership without merging the two runner managers.
@@ -140,11 +170,8 @@ export class SessionRegistry {
             return snapshot;
         const provider = snapshot.provider
             ?? snapshot.structuredState?.provider
-            ?? (/^codex\b/i.test(snapshot.command.trim())
-                ? "codex"
-                : /^opencode\b/i.test(snapshot.command.trim()) ? "opencode"
-                    : /^grok\b/i.test(snapshot.command.trim()) ? "grok"
-                        : /^qodercli\b/i.test(snapshot.command.trim()) ? "qoder" : "claude");
+            ?? inferProviderFromCommand(snapshot.command)
+            ?? "claude";
         if (provider === "claude") {
             this.processes.deleteClaudeHistoryFiles([{ claudeSessionId: providerSessionId, cwd: snapshot.cwd }]);
         }
@@ -154,7 +181,7 @@ export class SessionRegistry {
         else {
             return snapshot;
         }
-        addHiddenProviderSessionId(this.storage, providerSessionId);
+        addHiddenSessionIds(this.storage, [providerSessionId]);
         return snapshot;
     }
     updateStored(id, update) {

package/dist/session-topic.js

@@ -1,5 +1,6 @@
 import { callConfiguredAiText } from "./git-quick-commit.js";
 import { skipAnsiSequence } from "./pty-text-utils.js";
+import { clipAtWordBoundary } from "./text-utils.js";
 const MAX_PROMPT_LENGTH = 12_000;
 const PTY_TOPIC_DRAFT_MAX = 4_000;
 /**
@@ -140,15 +141,6 @@ export function shouldAcceptGeneratedSessionTitle(title, blockedTitles = []) {
         return false;
     return !blockedTitles.some((blocked) => isSameSessionTitle(cleaned, blocked));
 }
-function clipTitle(value, maxLength = TITLE_MAX_LENGTH) {
-    if (value.length <= maxLength)
-        return value;
-    const sliced = value.slice(0, maxLength);
-    const lastSpace = sliced.lastIndexOf(" ");
-    if (lastSpace >= Math.floor(maxLength * 0.55))
-        return sliced.slice(0, lastSpace);
-    return sliced;
-}
 /** Immediate title from the user's command, without waiting for the model. */
 export function summarizeSessionTitleFromInput(input, options = {}) {
     const blockedTitles = options.blockedTitles ?? [];
@@ -156,9 +148,9 @@ export function summarizeSessionTitleFromInput(input, options = {}) {
         .split(/\r?\n/)
         .map((part) => part.replace(/^#+\s*/, "").replace(/\s+/g, " ").trim())
         .filter(Boolean);
-    const fallback = clipTitle(lines[0] ?? "");
+    const fallback = clipAtWordBoundary(lines[0] ?? "", TITLE_MAX_LENGTH);
     for (const line of lines) {
-        const title = clipTitle(line);
+        const title = clipAtWordBoundary(line, TITLE_MAX_LENGTH);
         if (shouldAcceptGeneratedSessionTitle(title, blockedTitles))
             return title;
     }

package/dist/shell-quote.d.ts

@@ -0,0 +1,9 @@
+/**
+ * POSIX shell 引用工具。
+ *
+ * 单引号是唯一在所有 POSIX shell 里都没有展开语义的引用形式；字符串里已有的
+ * 单引号用 `'\''` 收尾再续上，保证结果仍然是一个字面量。
+ */
+export declare function shellQuote(value: string): string;
+/** 把一组值拼成 `'a' 'b'` 形式的参数列表（用于生成 shell 脚本里的数组字面量）。 */
+export declare function shellQuoteAll(values: readonly string[]): string;

package/dist/shell-quote.js

@@ -0,0 +1,13 @@
+/**
+ * POSIX shell 引用工具。
+ *
+ * 单引号是唯一在所有 POSIX shell 里都没有展开语义的引用形式；字符串里已有的
+ * 单引号用 `'\''` 收尾再续上，保证结果仍然是一个字面量。
+ */
+export function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+/** 把一组值拼成 `'a' 'b'` 形式的参数列表（用于生成 shell 脚本里的数组字面量）。 */
+export function shellQuoteAll(values) {
+    return values.map(shellQuote).join(" ");
+}

package/dist/signal-utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Unix 信号名与编号之间的互转。
+ *
+ * Node 只在这些编号上给出稳定语义（Linux/macOS 一致），其余平台差异较大，
+ * 因此这里固定一张小表，未知编号回落 SIGTERM、未知名字回落 0。
+ */
+/** 名字 → 编号；未知名字返回 0（与 waitpid 的"无信号"一致）。 */
+export declare function signalNumberFromName(signal: string): number;
+/** 编号 → 名字；0 / null 表示没有信号，未知编号回落 SIGTERM。 */
+export declare function signalNameFromNumber(signal: number | null): NodeJS.Signals | null;

package/dist/signal-utils.js

@@ -0,0 +1,38 @@
+/**
+ * Unix 信号名与编号之间的互转。
+ *
+ * Node 只在这些编号上给出稳定语义（Linux/macOS 一致），其余平台差异较大，
+ * 因此这里固定一张小表，未知编号回落 SIGTERM、未知名字回落 0。
+ */
+const SIGNAL_NUMBERS = {
+    SIGHUP: 1,
+    SIGINT: 2,
+    SIGQUIT: 3,
+    SIGILL: 4,
+    SIGTRAP: 5,
+    SIGABRT: 6,
+    SIGBUS: 7,
+    SIGFPE: 8,
+    SIGKILL: 9,
+    SIGUSR1: 10,
+    SIGSEGV: 11,
+    SIGUSR2: 12,
+    SIGPIPE: 13,
+    SIGALRM: 14,
+    SIGTERM: 15,
+    SIGCHLD: 17,
+    SIGCONT: 18,
+    SIGSTOP: 19,
+    SIGTSTP: 20,
+};
+const SIGNAL_NAMES = new Map(Object.entries(SIGNAL_NUMBERS).map(([name, number]) => [number, name]));
+/** 名字 → 编号；未知名字返回 0（与 waitpid 的"无信号"一致）。 */
+export function signalNumberFromName(signal) {
+    return SIGNAL_NUMBERS[signal] ?? 0;
+}
+/** 编号 → 名字；0 / null 表示没有信号，未知编号回落 SIGTERM。 */
+export function signalNameFromNumber(signal) {
+    if (signal === null || signal === 0)
+        return null;
+    return SIGNAL_NAMES.get(signal) ?? "SIGTERM";
+}