@co0ontty/wand 4.82.0 → 4.83.1

package/dist/server-employee-routes.js

@@ -1,5 +1,5 @@
 import { randomUUID } from "node:crypto";
-import { AI_TEAM_MAX_CANDIDATES, SILICON_EMPLOYEE_AVATAR_MAX_CHARS, agentKey, isBuiltinSiliconEmployee, } from "./ai-team-types.js";
+import { AI_TEAM_MAX_CANDIDATES, SILICON_EMPLOYEE_AVATAR_MAX_CHARS, agentKey, isBuiltinSiliconEmployee, parseSiliconEmployeeTags, siliconEmployeeTags, } from "./ai-team-types.js";
 import { getErrorMessage } from "./error-utils.js";
 import { asyncRoute } from "./express-async.js";
 import { bodyObject, sendRouteError, text } from "./server-request.js";
@@ -75,6 +75,12 @@ export function parseSystemEmployeeAgents(value, existing) {
             throw new Error(`该员工是内置的，${field.label}不可修改。`);
         }
     }
+    if (body.tags !== undefined && JSON.stringify(body.tags) !== JSON.stringify(siliconEmployeeTags(existing))) {
+        throw new Error("该员工是内置的，标签不可修改。");
+    }
+    if (body.systemKey !== undefined && body.systemKey !== existing.systemKey) {
+        throw new Error("该员工是内置的，身份不可修改。");
+    }
     if (!Array.isArray(body.agents))
         throw new Error("请提供执行候选数组。");
     if (body.agents.length === 0)
@@ -139,6 +145,7 @@ export function parseSiliconEmployeeInput(value, existing, now) {
         throw new Error("执行候选存在重复。");
     }
     const avatar = parseAvatar(body.avatar, name);
+    const tags = parseSiliconEmployeeTags(body.tags === undefined ? existing?.tags ?? [] : body.tags);
     const id = existing?.id ?? `e_${randomUUID().replace(/-/g, "")}`;
     return {
         id,
@@ -147,6 +154,7 @@ export function parseSiliconEmployeeInput(value, existing, now) {
         prompt,
         avatar,
         agents,
+        tags,
         archivedAt: existing?.archivedAt,
         createdAt: existing ? existing.createdAt : now,
         updatedAt: now,

package/dist/server-session-routes.d.ts

@@ -2,7 +2,7 @@ import type { Express } from "express";
 import { ProcessManager } from "./process-manager.js";
 import { StructuredSessionManager } from "./structured-session-manager.js";
 import { WandStorage } from "./storage.js";
-import { ExecutionMode, SessionSnapshot, SessionSource, WandConfig } from "./types.js";
+import { ExecutionMode, ProcessEvent, SessionSnapshot, SessionSource, WandConfig } from "./types.js";
 import { toSessionListItemDTO } from "./session-transport.js";
 import { SessionRegistry } from "./session-registry.js";
 import { type SessionDirectoryNode } from "./session-directory-tree.js";
@@ -45,6 +45,6 @@ export interface SessionDirectoryTreeResponse {
 }
 export declare function buildSessionListPage(sessions: SessionSnapshot[], offset: number, limit: number): SessionListPage;
 export declare function buildSessionDirectoryTree(sessions: SessionSnapshot[], customNames?: ReadonlyMap<string, string>): SessionDirectoryTreeResponse;
-export declare function registerSessionRoutes(app: Express, processes: ProcessManager, structured: StructuredSessionManager, storage: WandStorage, defaultMode: ExecutionMode, config: WandConfig, sessions: SessionRegistry, onSessionCreated?: (cwd: string | undefined | null) => void): void;
+export declare function registerSessionRoutes(app: Express, processes: ProcessManager, structured: StructuredSessionManager, storage: WandStorage, defaultMode: ExecutionMode, config: WandConfig, sessions: SessionRegistry, onSessionCreated?: (cwd: string | undefined | null) => void, onCompletionViewed?: (event: ProcessEvent) => void): void;
 export declare function registerClaudeHistoryRoutes(app: Express, processes: ProcessManager, storage: WandStorage): void;
 export {};

package/dist/server-session-routes.js

@@ -181,6 +181,8 @@ function sessionListRevision(entries, directoryNames = []) {
         entry.sortTimestamp,
         entry.session.title,
         entry.session.status,
+        entry.session.completionRevision ?? 0,
+        entry.session.viewedCompletionRevision ?? 0,
         entry.session.ptyBusy === true,
         entry.session.structuredState?.inFlight === true,
     ]);
@@ -347,7 +349,7 @@ function canMergeSession(snapshot) {
 function isMergeActionAllowed(snapshot) {
     return snapshot.status !== "running";
 }
-export function registerSessionRoutes(app, processes, structured, storage, defaultMode, config, sessions, onSessionCreated) {
+export function registerSessionRoutes(app, processes, structured, storage, defaultMode, config, sessions, onSessionCreated, onCompletionViewed) {
     const wantsCompactTools = (req) => req.get("X-Wand-Tool-Projection") === "compact" || req.query.compactTools === "1";
     const sessionResponseDTO = (snapshot, req) => {
         const enriched = enrichStructuredMessages(snapshot.messages ?? [], snapshot.id);
@@ -528,6 +530,29 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             sendRouteError(res, error, "无法启动结构化会话。");
         }
     }));
+    app.post("/api/sessions/:id/provider", (req, res) => {
+        const provider = req.body?.provider;
+        if (!isSessionProvider(provider)) {
+            res.status(400).json({ error: "请选择有效的 CLI 工具。" });
+            return;
+        }
+        const id = req.params.id;
+        const owner = sessions.ownerOf(id);
+        if (!owner) {
+            res.status(404).json({ error: "未找到该会话。" });
+            return;
+        }
+        if (owner !== "structured") {
+            res.status(400).json({ error: "只有新建空白结构化对话可以更换工具。" });
+            return;
+        }
+        try {
+            res.json(sessionResponseDTO(structured.setSessionProvider(id, provider), req));
+        }
+        catch (error) {
+            sendRouteError(res, error, "切换工具失败。");
+        }
+    });
     app.post("/api/sessions/:id/model", (req, res) => {
         const body = req.body;
         const rawModel = typeof body?.model === "string" ? body.model.trim() : null;
@@ -1129,6 +1154,24 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
         }
         res.json(page);
     }));
+    // Explicit display acknowledgement: reads/prefetch/resync never consume completion state.
+    app.post("/api/sessions/:id/completion/view", (req, res) => {
+        const snapshot = sessions.get(req.params.id);
+        if (!snapshot) {
+            res.status(404).json({ error: "未找到该会话。" });
+            return;
+        }
+        const revision = req.body?.completionRevision;
+        if (!Number.isSafeInteger(revision) || revision <= 0) {
+            res.status(400).json({ error: "完成代次无效。" });
+            return;
+        }
+        const changed = storage.markSessionCompletionViewed(snapshot.id, revision);
+        const completion = storage.getSessionCompletion(snapshot.id);
+        if (changed)
+            onCompletionViewed?.({ type: "status", sessionId: snapshot.id, data: completion });
+        res.json({ ok: true, ...completion });
+    });
     app.get("/api/sessions/:id", (req, res) => {
         const snapshot = sessions.get(req.params.id);
         if (!snapshot) {
@@ -1494,6 +1537,59 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             sendRouteError(res, error, "无法停止会话。");
         }
     });
+    // 归档 / 取消归档会话：只写标记，不杀终端、不删历史；保留期扫描再按 archivedAt 清理。
+    app.post("/api/sessions/:id/archive", (req, res) => {
+        try {
+            const updated = sessions.setArchived(req.params.id, true);
+            if (!updated) {
+                res.status(404).json({ error: "未找到该会话。" });
+                return;
+            }
+            res.json(sessionResponseDTO(updated, req));
+        }
+        catch (error) {
+            sendRouteError(res, error, "无法归档会话。");
+        }
+    });
+    app.post("/api/sessions/:id/unarchive", (req, res) => {
+        try {
+            const updated = sessions.setArchived(req.params.id, false);
+            if (!updated) {
+                res.status(404).json({ error: "未找到该会话。" });
+                return;
+            }
+            res.json(sessionResponseDTO(updated, req));
+        }
+        catch (error) {
+            sendRouteError(res, error, "无法恢复会话。");
+        }
+    });
+    // 批量归档 / 恢复：与 /api/sessions/batch-delete 对称，返回失败项让客户端保留选择。
+    app.post("/api/sessions/batch-archive", (req, res) => {
+        const body = req.body;
+        const ids = Array.isArray(body?.sessionIds)
+            ? body.sessionIds.filter((value) => typeof value === "string" && value.trim().length > 0)
+            : [];
+        if (ids.length === 0) {
+            res.status(400).json({ error: "至少提供一个会话 ID。" });
+            return;
+        }
+        const archived = body?.archived !== false;
+        const failed = [];
+        let changed = 0;
+        for (const id of ids) {
+            try {
+                if (sessions.setArchived(id, archived))
+                    changed += 1;
+                else
+                    failed.push(id);
+            }
+            catch {
+                failed.push(id);
+            }
+        }
+        res.json({ ok: true, archived: changed, ...(failed.length > 0 ? { failed } : {}) });
+    });
     app.delete("/api/sessions/:id", (req, res) => {
         try {
             sessions.deleteWithProviderHistory(req.params.id);

package/dist/server-settings-routes.js

@@ -4,7 +4,8 @@ import { buildInfoPayload } from "./build-info.js";
 import { buildChildEnv } from "./env-utils.js";
 import { asyncRoute } from "./express-async.js";
 import { sendRouteError } from "./server-request.js";
-import { getProviderDefaultModels, PREFERENCE_KEYS, saveConfig, writePreferenceToStorage, } from "./config.js";
+import { getProviderDefaultModels, PREFERENCE_KEYS, PROVIDER_MODEL_PREFERENCE_FIELDS, providerModelFields, saveConfig, writePreferenceToStorage, } from "./config.js";
+import { SESSION_PROVIDERS } from "./session-provider.js";
 import { withConfiguredDefaultModelLabels } from "./models.js";
 import { DEPLOYMENT_CONFIG_KEYS } from "./runtime-config.js";
 function publicConfig(config) {
@@ -12,13 +13,7 @@ function publicConfig(config) {
     const defaultModels = getProviderDefaultModels(config);
     return {
         ...safe,
-        defaultModel: defaultModels.claude,
-        defaultCodexModel: defaultModels.codex,
-        defaultOpenCodeModel: defaultModels.opencode,
-        defaultGrokModel: defaultModels.grok,
-        defaultQoderModel: defaultModels.qoder,
-        defaultPiModel: defaultModels.pi,
-        defaultGeminiModel: defaultModels.gemini,
+        ...providerModelFields(defaultModels),
         defaultModels,
     };
 }
@@ -160,20 +155,11 @@ export function registerSettingsRoutes(app, deps) {
                 if (!body.defaultModels || typeof body.defaultModels !== "object" || Array.isArray(body.defaultModels)) {
                     throw new Error("defaultModels 必须是对象。");
                 }
-                if (Object.hasOwn(body.defaultModels, "claude"))
-                    stagePreference("defaultModel", body.defaultModels.claude);
-                if (Object.hasOwn(body.defaultModels, "codex"))
-                    stagePreference("defaultCodexModel", body.defaultModels.codex);
-                if (Object.hasOwn(body.defaultModels, "opencode"))
-                    stagePreference("defaultOpenCodeModel", body.defaultModels.opencode);
-                if (Object.hasOwn(body.defaultModels, "grok"))
-                    stagePreference("defaultGrokModel", body.defaultModels.grok);
-                if (Object.hasOwn(body.defaultModels, "qoder"))
-                    stagePreference("defaultQoderModel", body.defaultModels.qoder);
-                if (Object.hasOwn(body.defaultModels, "pi"))
-                    stagePreference("defaultPiModel", body.defaultModels.pi);
-                if (Object.hasOwn(body.defaultModels, "gemini"))
-                    stagePreference("defaultGeminiModel", body.defaultModels.gemini);
+                for (const provider of SESSION_PROVIDERS) {
+                    if (Object.hasOwn(body.defaultModels, provider)) {
+                        stagePreference(PROVIDER_MODEL_PREFERENCE_FIELDS[provider], body.defaultModels[provider]);
+                    }
+                }
             }
             for (const field of PREFERENCE_KEYS) {
                 const value = body[field];
@@ -229,13 +215,7 @@ export function registerSettingsRoutes(app, deps) {
         const defaults = getProviderDefaultModels(config);
         res.json({
             ...withConfiguredDefaultModelLabels(cached, defaults),
-            defaultModel: defaults.claude,
-            defaultCodexModel: defaults.codex,
-            defaultOpenCodeModel: defaults.opencode,
-            defaultGrokModel: defaults.grok,
-            defaultQoderModel: defaults.qoder,
-            defaultPiModel: defaults.pi,
-            defaultGeminiModel: defaults.gemini,
+            ...providerModelFields(defaults),
             defaultModels: defaults,
         });
     });
@@ -245,13 +225,7 @@ export function registerSettingsRoutes(app, deps) {
             const defaults = getProviderDefaultModels(config);
             res.json({
                 ...withConfiguredDefaultModelLabels(refreshed, defaults),
-                defaultModel: defaults.claude,
-                defaultCodexModel: defaults.codex,
-                defaultOpenCodeModel: defaults.opencode,
-                defaultGrokModel: defaults.grok,
-                defaultQoderModel: defaults.qoder,
-                defaultPiModel: defaults.pi,
-                defaultGeminiModel: defaults.gemini,
+                ...providerModelFields(defaults),
                 defaultModels: defaults,
             });
         }

package/dist/server-update-routes.js

@@ -4,6 +4,7 @@ import { buildInfoPayload } from "./build-info.js";
 import { getErrorMessage } from "./error-utils.js";
 import { asyncRoute } from "./express-async.js";
 import { sendRouteError, text } from "./server-request.js";
+import { isSessionProvider } from "./session-provider.js";
 import { checkProviderCliUpdates, updateProviderClis, verifyProviderCliUpdateResults, } from "./provider-cli-updater.js";
 import { absoluteUrl, buildIosInstallPage, buildIosOtaManifest, buildItmsServicesUrl, collectIosOtaBlockers, formatIosAssetSize, inspectIpa, normalizePublicOrigin, publicOriginFromRequest, } from "./ios-ota.js";
 import { streamFileWithRange } from "./server-file-routes.js";
@@ -405,7 +406,7 @@ export function registerAdminUpdateRoutes(app, deps) {
             return;
         }
         const rawIds = Array.isArray(req.body?.ids) ? req.body.ids : [];
-        const ids = rawIds.filter((value) => value === "claude" || value === "codex" || value === "opencode" || value === "grok" || value === "qoder" || value === "pi" || value === "gemini");
+        const ids = rawIds.filter((value) => isSessionProvider(value));
         state.providerCliUpdateInFlight = true;
         try {
             const before = await refreshProviderCliUpdateState(state, config);

package/dist/server-workspace-routes.js

@@ -35,8 +35,13 @@ function workspaceSessionSummary(session, names = {}, registry, team = {}) {
         command: live.command,
         title: team.chat?.chatTitle ?? workspaceSessionTitle(live, names),
         status: live.status,
+        completionRevision: live.completionRevision ?? 0,
+        viewedCompletionRevision: live.viewedCompletionRevision ?? 0,
         ptyBusy: live.ptyBusy === true,
+        archived: live.archived === true,
+        archivedAt: live.archivedAt ?? null,
         providerCliActive: live.providerCliActive,
+        providerCliExitCode: live.providerCliExitCode,
         inFlight: live.structuredState?.inFlight === true,
         cwd: live.cwd,
         startedAt: live.startedAt,
@@ -72,6 +77,9 @@ function cheapTasksRevision(storage, registry) {
         ...(registry?.listSlim() ?? []).map((session) => [
             session.id,
             session.status,
+            session.completionRevision ?? 0,
+            session.viewedCompletionRevision ?? 0,
+            session.archived === true ? 1 : 0,
             session.ptyBusy === true ? 1 : 0,
             session.providerCliActive ? 1 : 0,
             session.structuredState?.inFlight === true ? 1 : 0,

package/dist/server.js

@@ -16,8 +16,11 @@ import { ModelCatalogService } from "./models.js";
 import { ProcessManager } from "./process-manager.js";
 import { SessionLogger } from "./session-logger.js";
 import { SessionRegistry } from "./session-registry.js";
+import { SessionCompletionTracker } from "./session-completion.js";
 import { resolveSystemAiContext } from "./session-ai-context.js";
 import { StructuredSessionManager } from "./structured-session-manager.js";
+import { DecisionService } from "./decision-service.js";
+import { registerDecisionRoutes } from "./server-decision-routes.js";
 import { recordRecentPath, registerFileRoutes } from "./server-file-routes.js";
 import { registerLocalPreviewRoutes } from "./server-local-preview-routes.js";
 import { registerSettingsRoutes } from "./server-settings-routes.js";
@@ -47,6 +50,7 @@ import { asyncRoute, jsonErrorHandler } from "./express-async.js";
 import { checkPackageUpdateAsync, installPackageGloballyAsync, normalizeUpdateChannel, resolveGlobalWandCli, } from "./npm-update-utils.js";
 import { repairServiceUnitAfterUpdate } from "./service-self-repair.js";
 import { computeRelaunch } from "./relaunch.js";
+import { startRetentionTimer } from "./retention.js";
 import { RuntimeConfigState } from "./runtime-config.js";
 import { safeServiceInstalled } from "./tui/runtime-utils.js";
 import { checkManagedServiceUpdatePreflight, } from "./update-helper.js";
@@ -296,6 +300,7 @@ export async function startServer(config, configPath, options = {}) {
     const storage = new WandStorage(resolveDatabasePath(configPath));
     const runtimeConfig = new RuntimeConfigState(config);
     const authService = new AuthService(storage);
+    const decisions = new DecisionService(config.localDecision);
     // 默认模型优先读存储（UI 改设置后实时生效），未设置时由 getPreference 回落到 config。
     const getCurrentDefaultModels = () => ({
         claude: storage.getPreference("pref:defaultModel", config.defaultModel ?? ""),
@@ -313,6 +318,7 @@ export async function startServer(config, configPath, options = {}) {
             storage,
             inheritEnv: config.inheritEnv !== false,
             apiKey: process.env.ANTHROPIC_API_KEY,
+            baseUrl: process.env.ANTHROPIC_BASE_URL,
             ...injected,
             piEndpointDiscovery: injected.piEndpointDiscovery ?? { enabled: !testMode },
             configuredClaudeModels: [
@@ -352,8 +358,10 @@ export async function startServer(config, configPath, options = {}) {
     const legacyStructuredHost = ptyHosts.legacyHost
         ?? (terminalHost instanceof TerminalDaemonClient ? terminalHost : null);
     const structuredHosts = await createUpgradeAwareStructuredHost(configPath, legacyStructuredHost, config.structured?.processHost);
-    const structuredSessions = new StructuredSessionManager(storage, config, structuredLogger, {}, structuredHosts.host);
+    let decisionRuntime = null;
+    const structuredSessions = new StructuredSessionManager(storage, config, structuredLogger, {}, structuredHosts.host, () => decisionRuntime);
     const sessionRegistry = new SessionRegistry(processes, structuredSessions, storage);
+    const sessionCompletions = new SessionCompletionTracker(storage, (id) => sessionRegistry.get(id));
     const missions = new Missions(storage, structuredSessions, sessionRegistry);
     // wsManager 在后面才建：团队运行的变更通知经由这个转发口，接好之前静默丢弃。
     let notifyAiTeamRun = (_data) => { };
@@ -399,6 +407,7 @@ export async function startServer(config, configPath, options = {}) {
     registerLocalPreviewRoutes(app, { requireAuth, requireFiles });
     // Route-specific parsers must run before the global parser. Once body-parser
     // has consumed a request, a later express.json() cannot tighten or widen it.
+    app.use("/api/decisions", express.json({ limit: "32kb" }));
     app.use("/api/optimize-prompt", express.json({ limit: "256kb" }));
     app.use("/api/file-write", express.json({ limit: "2mb" }));
     app.use(express.json({ limit: "1mb" }));
@@ -593,6 +602,7 @@ export async function startServer(config, configPath, options = {}) {
     app.get("/api/session-check", (req, res) => {
         res.json({ authed: authService.validateSession(readSessionCookie(req, useHttps)) });
     });
+    registerDecisionRoutes(app, { storage, decisions, requireAuth, requireSessions });
     app.use("/api", requireAuth);
     // Connected apps receive only the route families used by native clients and
     // the browser extension. Browser-admin sessions implicitly satisfy all scopes.
@@ -754,7 +764,7 @@ export async function startServer(config, configPath, options = {}) {
     }
     registerSessionRoutes(app, processes, structuredSessions, storage, config.defaultMode, config, sessionRegistry, (cwd) => {
         recordRecentPath(storage, cwd);
-    });
+    }, (event) => wsManager.emitEvent(event));
     registerClaudeHistoryRoutes(app, processes, storage);
     registerWorkspaceRoutes(app, storage, sessionRegistry, { config });
     registerMissionRoutes(app, missions);
@@ -833,6 +843,9 @@ export async function startServer(config, configPath, options = {}) {
             const reqRows = typeof body.rows === "number" && Number.isFinite(body.rows) ? body.rows : undefined;
             const sessionCwd = resolveSessionCwd(body.cwd, config.defaultCwd);
             const workspaceId = resolveWorkspaceIdForNewSession(storage, sessionCwd, body.workspaceId);
+            const role = !interactiveShell && !body.systemPrompt?.trim() && origin.sessionSource === "interactive"
+                && (isSessionProvider(body.provider) || inferProviderFromCommand(command))
+                ? defaultRoleForCli(storage, provider) : null;
             const snapshot = await (interactiveShell
                 ? processes.startShell(sessionCwd, body.mode ?? "default", {
                     worktreeEnabled: body.worktreeEnabled === true,
@@ -849,9 +862,10 @@ export async function startServer(config, configPath, options = {}) {
                     cols: reqCols,
                     rows: reqRows,
                     thinkingEffort: body.thinkingEffort ?? config.defaultThinkingEffort,
-                    systemPrompt: body.systemPrompt?.trim() || (origin.sessionSource === "interactive"
-                        && (isSessionProvider(body.provider) || inferProviderFromCommand(command))
-                        ? defaultRoleForCli(storage, provider).prompt : undefined),
+                    systemPrompt: body.systemPrompt?.trim() || role?.prompt,
+                    employeeId: role?.id,
+                    employeeName: role?.name,
+                    employeeAvatar: role?.avatar,
                     workspaceId,
                     workspaceTaskId: body.workspaceTaskId,
                     ...origin,
@@ -937,11 +951,13 @@ export async function startServer(config, configPath, options = {}) {
     });
     // Wire process events to WebSocket broadcast
     processes.on("process", (event) => {
+        sessionCompletions.ingest(event);
         missions.ingest(event);
         aiTeams.ingest(event);
         wsManager.emitEvent(event);
     });
     structuredSessions.setEventEmitter((event) => {
+        sessionCompletions.ingest(event);
         missions.ingest(event);
         aiTeams.ingest(event);
         wsManager.emitEvent(event);
@@ -1002,6 +1018,7 @@ export async function startServer(config, configPath, options = {}) {
     await new Promise((resolve, reject) => {
         const cleanupFailedListen = () => {
             shuttingDown = true;
+            decisions.dispose();
             try {
                 processes.dispose();
             }
@@ -1052,6 +1069,11 @@ export async function startServer(config, configPath, options = {}) {
             const address = server.address();
             const actualPort = typeof address === "object" && address ? address.port : config.port;
             bindAddr = `${config.host}:${actualPort}`;
+            if (config.localDecision?.enabled) {
+                const localHost = config.host === "::1" ? "[::1]" : config.host === "0.0.0.0" || config.host === "::" ? "127.0.0.1" : config.host;
+                decisionRuntime = { url: `${protocol}://${localHost}:${actualPort}`,
+                    ...(activeSslCertPath ? { caPath: activeSslCertPath } : {}) };
+            }
             const scheme = useHttps ? "HTTPS" : "HTTP";
             // 主 URL：本机回环；若绑定 0.0.0.0 再补一个对外提示。
             collectedUrls.push({ url: `${protocol}://127.0.0.1:${actualPort}`, scheme });
@@ -1095,6 +1117,11 @@ export async function startServer(config, configPath, options = {}) {
         }, MODEL_CATALOG_AUTO_REFRESH_INTERVAL_MS);
         modelCatalogRefreshTimer.unref();
     }
+    // 保留期扫描：7 天没活动的会话/任务自动归档，归档 7 天后自动清理。
+    let retentionTimer = null;
+    if (!testMode) {
+        retentionTimer = startRetentionTimer({ storage, sessions: sessionRegistry });
+    }
     // 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.
@@ -1241,6 +1268,7 @@ export async function startServer(config, configPath, options = {}) {
             return closePromise;
         closePromise = (async () => {
             shuttingDown = true;
+            decisions.dispose();
             await userMemory.dispose();
             if (updateCheckTimer) {
                 clearInterval(updateCheckTimer);
@@ -1254,6 +1282,10 @@ export async function startServer(config, configPath, options = {}) {
                 clearInterval(modelCatalogRefreshTimer);
                 modelCatalogRefreshTimer = null;
             }
+            if (retentionTimer) {
+                clearInterval(retentionTimer);
+                retentionTimer = null;
+            }
             // Stop accepting requests first. Existing requests get a short grace
             // period while managers flush and active runners are cancelled.
             const serverClosed = new Promise((resolve) => {

package/dist/session-completion-state.d.ts

@@ -0,0 +1,26 @@
+export interface SessionCompletionState {
+    /** Monotonic successful-completion generation, owned by storage rather than runner checkpoints. */
+    completionRevision?: number;
+    viewedCompletionRevision?: number;
+}
+/** Explicit navigation, not a list refresh choosing its preferred/default session. */
+export declare function createSessionCompletionViewIntent(): {
+    open(id: string): void;
+    clear(): void;
+    isOpen(id: string): boolean;
+};
+/** Delayed HTTP/WS projections may advance generations, but must never move them backwards. */
+export declare function mergeSessionCompletionState(current: SessionCompletionState | null | undefined, incoming: SessionCompletionState): SessionCompletionState;
+/** A presentation state only: never change the runner's lifecycle or input eligibility. */
+export declare function isSessionJustCompleted(session: SessionCompletionState & {
+    status?: string;
+    archived?: boolean;
+    ptyBusy?: boolean;
+    inFlight?: boolean;
+    structuredState?: {
+        inFlight?: boolean;
+    } | null;
+    permissionBlocked?: boolean;
+    pendingEscalation?: unknown;
+    providerCliExitCode?: number | null;
+}): boolean;

package/dist/session-completion-state.js

@@ -0,0 +1,30 @@
+/** Explicit navigation, not a list refresh choosing its preferred/default session. */
+export function createSessionCompletionViewIntent() {
+    let openedId = null;
+    return {
+        open(id) { openedId = id; },
+        clear() { openedId = null; },
+        isOpen(id) { return openedId === id; },
+    };
+}
+/** Delayed HTTP/WS projections may advance generations, but must never move them backwards. */
+export function mergeSessionCompletionState(current, incoming) {
+    if (incoming.completionRevision === undefined && incoming.viewedCompletionRevision === undefined)
+        return {};
+    return {
+        completionRevision: Math.max(current?.completionRevision ?? 0, incoming.completionRevision ?? 0),
+        viewedCompletionRevision: Math.max(current?.viewedCompletionRevision ?? 0, incoming.viewedCompletionRevision ?? 0),
+    };
+}
+/** A presentation state only: never change the runner's lifecycle or input eligibility. */
+export function isSessionJustCompleted(session) {
+    return (session.completionRevision ?? 0) > (session.viewedCompletionRevision ?? 0)
+        && !session.archived
+        && !session.ptyBusy
+        && !session.inFlight
+        && !session.structuredState?.inFlight
+        && !session.permissionBlocked
+        && !session.pendingEscalation
+        && !(typeof session.providerCliExitCode === "number" && session.providerCliExitCode !== 0)
+        && ["idle", "running", "exited"].includes(session.status ?? "");
+}

package/dist/session-completion.d.ts

@@ -0,0 +1,12 @@
+import type { WandStorage } from "./storage.js";
+import type { ProcessEvent, SessionSnapshot } from "./types.js";
+/** Observe completion facts without combining PTY and structured execution implementations. */
+export declare class SessionCompletionTracker {
+    private readonly storage;
+    private readonly getSession;
+    private readonly busyPty;
+    private readonly completedPty;
+    private readonly ended;
+    constructor(storage: WandStorage, getSession: (id: string) => SessionSnapshot | null);
+    ingest(event: ProcessEvent): void;
+}

package/dist/session-completion.js

@@ -0,0 +1,62 @@
+/** Observe completion facts without combining PTY and structured execution implementations. */
+export class SessionCompletionTracker {
+    storage;
+    getSession;
+    busyPty = new Set();
+    completedPty = new Set();
+    ended = new Map();
+    constructor(storage, getSession) {
+        this.storage = storage;
+        this.getSession = getSession;
+    }
+    ingest(event) {
+        if (event.type === "started") {
+            this.busyPty.delete(event.sessionId);
+            this.completedPty.delete(event.sessionId);
+            this.ended.delete(event.sessionId);
+            return;
+        }
+        if (event.type !== "status" && event.type !== "ended")
+            return;
+        const data = event.data;
+        if (!data)
+            return;
+        const snapshot = this.getSession(event.sessionId);
+        if (!snapshot)
+            return;
+        let completed = false;
+        if ((snapshot.sessionKind ?? "pty") === "structured") {
+            if (event.type === "ended" && snapshot.status === "idle" && snapshot.exitCode === 0
+                && !snapshot.structuredState?.inFlight && !snapshot.structuredState?.lastError) {
+                const key = snapshot.endedAt ?? "";
+                completed = !!key && this.ended.get(snapshot.id) !== key;
+                if (completed)
+                    this.ended.set(snapshot.id, key);
+            }
+        }
+        else {
+            if (data.ptyBusy === true) {
+                this.busyPty.add(snapshot.id);
+                this.completedPty.delete(snapshot.id);
+            }
+            else if (data.ptyBusy === false && this.busyPty.delete(snapshot.id)) {
+                completed = !snapshot.permissionBlocked && !snapshot.pendingEscalation
+                    && snapshot.status === "running"
+                    && !(typeof snapshot.providerCliExitCode === "number" && snapshot.providerCliExitCode !== 0);
+            }
+            if ((data.providerCliActive === false && data.providerCliExitCode === 0)
+                || (event.type === "ended" && snapshot.status === "exited" && snapshot.exitCode === 0)) {
+                completed ||= !this.completedPty.has(snapshot.id);
+            }
+            if (completed)
+                this.completedPty.add(snapshot.id);
+            if (event.type === "ended")
+                this.busyPty.delete(snapshot.id);
+        }
+        if (completed) {
+            const completion = this.storage.recordSessionCompletion(snapshot.id);
+            if (completion)
+                Object.assign(data, completion);
+        }
+    }
+}

package/dist/session-provider.d.ts

@@ -1,21 +1,7 @@
 import type { SessionProvider } from "./types.js";
-/** 全部受支持的会话 provider；顺序与 UI / 派发选择器一致。 */
-export declare const SESSION_PROVIDERS: readonly ["claude", "codex", "opencode", "grok", "qoder", "pi", "gemini"];
-/** 运行时守卫：把配置、数据库、请求体里的任意值收敛成 SessionProvider。 */
-export declare function isSessionProvider(value: unknown): value is SessionProvider;
-/** provider 对应的 CLI 可执行文件名（Qoder 的 CLI 叫 qodercli）。 */
-export declare function providerCliCommand(provider: SessionProvider): string;
+export { SESSION_PROVIDERS, isSessionProvider, providerCliCommand, providerDisplayName, inferProviderFromRunner, inferProviderFromCommand, normalizeProviderId, } from "./provider-catalog.js";
 /**
  * 不启动 shell 也能判断某个 provider 的 CLI 是否在 PATH 上（与子进程 PATH 一致）。
  * 用于多候选降级时跳过没安装的工具，避免白等一次 spawn 失败。
  */
 export declare function providerCliInstalled(provider: SessionProvider, pathValue?: string): boolean;
-/** 从 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;