@co0ontty/wand 4.93.0 → 4.94.0

package/dist/storage.d.ts

@@ -12,6 +12,7 @@ import { UserMemoryRepository } from "./storage/user-memory-repository.js";
 import { AiTeamRepository } from "./storage/ai-teams-repository.js";
 import { MissionRepository } from "./storage/missions-repository.js";
 import { SessionRepository } from "./storage/sessions-repository.js";
+import { UploadRepository } from "./storage/uploads-repository.js";
 export { parseWandTaskAgent };
 export type { ConnectorMeta };
 export { ensureDatabaseFile } from "./storage-schema.js";
@@ -19,7 +20,7 @@ export { ensureDatabaseFile } from "./storage-schema.js";
 type RepositoryMethods<T> = Pick<T, {
     [K in keyof T]: T[K] extends (...args: never[]) => unknown ? K : never;
 }[keyof T]>;
-export interface WandStorage extends RepositoryMethods<ConversationRepository>, RepositoryMethods<PreferencesRepository>, RepositoryMethods<WorkspaceRepository>, RepositoryMethods<TaskRepository>, RepositoryMethods<SecretsRepository>, RepositoryMethods<EmployeeRepository>, RepositoryMethods<UserMemoryRepository>, RepositoryMethods<AiTeamRepository>, RepositoryMethods<MissionRepository>, RepositoryMethods<SessionRepository> {
+export interface WandStorage extends RepositoryMethods<ConversationRepository>, RepositoryMethods<PreferencesRepository>, RepositoryMethods<WorkspaceRepository>, RepositoryMethods<TaskRepository>, RepositoryMethods<SecretsRepository>, RepositoryMethods<EmployeeRepository>, RepositoryMethods<UserMemoryRepository>, RepositoryMethods<AiTeamRepository>, RepositoryMethods<MissionRepository>, RepositoryMethods<SessionRepository>, RepositoryMethods<UploadRepository> {
 }
 export declare class WandStorage {
     readonly conversations: ConversationRepository;
@@ -32,6 +33,7 @@ export declare class WandStorage {
     readonly aiTeams: AiTeamRepository;
     readonly missions: MissionRepository;
     readonly sessions: SessionRepository;
+    readonly uploads: UploadRepository;
     private readonly closeListeners;
     private readonly taskTitleListeners;
     private titleNoticePending;

package/dist/storage.js

@@ -15,6 +15,7 @@ import { UserMemoryRepository } from "./storage/user-memory-repository.js";
 import { AiTeamRepository } from "./storage/ai-teams-repository.js";
 import { MissionRepository } from "./storage/missions-repository.js";
 import { SessionRepository } from "./storage/sessions-repository.js";
+import { UploadRepository } from "./storage/uploads-repository.js";
 export { parseWandTaskAgent };
 export { ensureDatabaseFile } from "./storage-schema.js";
 export class WandStorage {
@@ -28,6 +29,7 @@ export class WandStorage {
     aiTeams;
     missions;
     sessions;
+    uploads;
     closeListeners = new Set();
     taskTitleListeners = new Set();
     titleNoticePending = false;
@@ -88,6 +90,7 @@ export class WandStorage {
         this.aiTeams = new AiTeamRepository(this.db, this);
         this.missions = new MissionRepository(this.db, this);
         this.sessions = new SessionRepository(this.db, this);
+        this.uploads = new UploadRepository(this.db, this);
         this.schedules = new ScheduledTaskRepository(this.db, action => this.transaction(action));
         this.secrets.openVault();
         const brokenLinks = this.integrityReport().filter((item) => item.count > 0);
@@ -230,6 +233,7 @@ const REPOSITORY_FORWARDS = [
     ["aiTeams", AiTeamRepository],
     ["missions", MissionRepository],
     ["sessions", SessionRepository],
+    ["uploads", UploadRepository],
 ];
 for (const [field, repository] of REPOSITORY_FORWARDS) {
     for (const name of Object.getOwnPropertyNames(repository.prototype)) {

package/dist/structured-failure.d.ts

@@ -26,6 +26,8 @@ export declare function cliUnacceptedFacts(input: {
     /** Adapters whose protocol echoes the failure text into `result` state what really ran. */
     progressed?: boolean;
 }): StructuredCliUnacceptedFacts;
+/** Assemble common CLI exit fields while the adapter retains protocol/error observations. */
+export declare function buildStructuredCliResult(input: Parameters<typeof cliUnacceptedFacts>[0] & Pick<StructuredRunnerResult, "exitCode" | "stderr">): StructuredRunnerResult;
 /** Only call for a provider protocol error, never assistant text, stderr or a caught transport error. */
 export declare function classifyProviderRejection(message: string | null | undefined): ProviderRejectionKind | null;
 /** Monotonic observations matter: a final error can replace earlier usage or content. */

package/dist/structured-failure.js

@@ -12,6 +12,15 @@ export function cliUnacceptedFacts(input) {
         return {};
     return { inputAccepted: false, rejection: classifyProviderRejection(input.primaryError) ?? "model-unavailable" };
 }
+/** Assemble common CLI exit fields while the adapter retains protocol/error observations. */
+export function buildStructuredCliResult(input) {
+    const { state, exitCode, signal, stderr, primaryError, spawnError } = input;
+    return {
+        state, exitCode, signal, stderr, primaryError,
+        ...(spawnError ? { spawnError } : {}),
+        ...cliUnacceptedFacts(input),
+    };
+}
 /** Only call for a provider protocol error, never assistant text, stderr or a caught transport error. */
 export function classifyProviderRejection(message) {
     const text = message?.trim() ?? "";

package/dist/structured-grok-adapter.js

@@ -1,7 +1,7 @@
 import { spawn } from "node:child_process";
 import { startStructuredCli } from "./structured-exec-pump.js";
 import { asRecord } from "./structured-content.js";
-import { cliUnacceptedFacts } from "./structured-failure.js";
+import { buildStructuredCliResult } from "./structured-failure.js";
 import { systemPromptArgs, thinkingEffortToGrokEffort } from "./structured-provider-common.js";
 function grokText(value) {
     if (typeof value === "string")
@@ -253,9 +253,9 @@ export class GrokRunner {
                     unparsedStdout = true; /* Non-protocol stdout is not evidence of a safe refusal. */
                 }
             },
-            finalize: (ctx, exitCode, signal, spawnError) => ({
-                state, exitCode, signal, stderr: ctx.stderr, primaryError, ...(spawnError ? { spawnError } : {}),
-                ...cliUnacceptedFacts({ state, primaryError, protocolError, unparsedStdout, signal, ...(spawnError ? { spawnError } : {}) }),
+            finalize: (ctx, exitCode, signal, spawnError) => buildStructuredCliResult({
+                state, exitCode, signal, stderr: ctx.stderr, primaryError,
+                protocolError, unparsedStdout, spawnError,
             }),
         });
     }

package/dist/structured-opencode-adapter.js

@@ -2,7 +2,7 @@ import { randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
 import { startStructuredCli } from "./structured-exec-pump.js";
 import { asRecord } from "./structured-content.js";
-import { cliUnacceptedFacts } from "./structured-failure.js";
+import { buildStructuredCliResult } from "./structured-failure.js";
 import { thinkingEffortToOpenCodeVariant, promptWithSystemFallback } from "./structured-provider-common.js";
 function extractStructuredText(value) {
     if (typeof value === "string")
@@ -165,14 +165,9 @@ export class OpenCodeRunner {
                 }
                 observer.onUpdate(state);
             },
-            finalize: (ctx, exitCode, signal, spawnError) => ({
-                state,
-                exitCode,
-                signal,
-                stderr: ctx.stderr,
-                primaryError,
-                ...(spawnError ? { spawnError } : {}),
-                ...cliUnacceptedFacts({ state, primaryError, protocolError, unparsedStdout, signal, ...(spawnError ? { spawnError } : {}) }),
+            finalize: (ctx, exitCode, signal, spawnError) => buildStructuredCliResult({
+                state, exitCode, signal, stderr: ctx.stderr, primaryError,
+                protocolError, unparsedStdout, spawnError,
             }),
         });
     }

package/dist/structured-provider-common.d.ts

@@ -1,8 +1,7 @@
 import type { SessionProvider, SessionRunner, SessionSnapshot, StructuredSessionState } from "./types.js";
 /**
  * 把会话级系统提示交给 CLI 的开关。Claude / Qoder / Pi 用 `--append-system-prompt`，
- * Grok 用 `--rules`；Codex / OpenCode / Gemini 没有这个入口，只能退回并入本轮消息
- * （Gemini 只有 `GEMINI_SYSTEM_MD`，那是整体替换而非追加）。
+ * Grok 用 `--rules`；Codex / OpenCode 没有这个入口，只能退回并入本轮消息。
  * 各 provider 的支持情况由 `--help` 实测得出，新增 provider 前先验。
  */
 export declare function systemPromptFlag(provider: SessionProvider | null | undefined): string | null;

package/dist/structured-provider-common.js

@@ -2,8 +2,7 @@ import { isNativeThinkingEffort } from "./provider-catalog.js";
 import { shellQuote } from "./shell-quote.js";
 /**
  * 把会话级系统提示交给 CLI 的开关。Claude / Qoder / Pi 用 `--append-system-prompt`，
- * Grok 用 `--rules`；Codex / OpenCode / Gemini 没有这个入口，只能退回并入本轮消息
- * （Gemini 只有 `GEMINI_SYSTEM_MD`，那是整体替换而非追加）。
+ * Grok 用 `--rules`；Codex / OpenCode 没有这个入口，只能退回并入本轮消息。
  * 各 provider 的支持情况由 `--help` 实测得出，新增 provider 前先验。
  */
 export function systemPromptFlag(provider) {
@@ -34,7 +33,7 @@ export function promptWithSystemFallback(session, prompt) {
     if (systemPromptFlag(session.provider))
         return prompt;
     const base = (session.messages?.length ?? 0) <= 1 ? session.systemPrompt?.trim() : "";
-    // Knowledge is live per turn, including resumed Codex/OpenCode/Gemini conversations.
+    // Knowledge is live per turn, including resumed Codex/OpenCode conversations.
     const text = [base, session.runtimeSystemPrompt?.trim()].filter(Boolean).join("\n\n");
     return text ? composeSystemFallback(text, prompt) : prompt;
 }
@@ -86,7 +85,7 @@ export function isStructuredRunnerForProvider(provider, runner) {
         return runner === "qoder-cli-print";
     if (provider === "pi")
         return runner === "pi-cli-json";
-    return runner === "gemini-cli-json";
+    return false;
 }
 export function defaultStructuredRunner(provider) {
     if (provider === "codex")
@@ -99,8 +98,6 @@ export function defaultStructuredRunner(provider) {
         return "qoder-cli-print";
     if (provider === "pi")
         return "pi-cli-json";
-    if (provider === "gemini")
-        return "gemini-cli-json";
     return "claude-cli-print";
 }
 /**

package/dist/structured-session-manager-replay.js

@@ -7,7 +7,6 @@ import { applyOpenCodeEvent } from "./structured-opencode-adapter.js";
 import { applyGrokEvent } from "./structured-grok-adapter.js";
 import { applyPiEvent } from "./structured-pi-adapter.js";
 import { lastPiAssistantMessage } from "./pi-event-projection.js";
-import { applyGeminiEvent } from "./structured-gemini-adapter.js";
 import { normalizeTurnAnchors } from "./structured-provider-common.js";
 import { enrichStructuredMessages, WAND_PROTOCOL_VERSION } from "./structured-client-protocol.js";
 export function buildReplayProcessor(session) {
@@ -70,7 +69,7 @@ export function buildReplayProcessor(session) {
         };
         return processor;
     }
-    // grok-cli-headless / opencode-cli-run / pi-cli-json / gemini-cli-json share the same shape.
+    // grok-cli-headless / opencode-cli-run / pi-cli-json share the same shape.
     const state = {
         blocks: [],
         result: "",
@@ -97,9 +96,7 @@ export function buildReplayProcessor(session) {
                 ? applyGrokEvent(state, event)
                 : runner === "opencode-cli-run"
                     ? applyOpenCodeEvent(state, event)
-                    : runner === "gemini-cli-json"
-                        ? applyGeminiEvent(state, event)
-                        : applyPiEvent(state, event, observedAt);
+                    : applyPiEvent(state, event, observedAt);
             if (error)
                 processor.primaryError = error;
             else if (runner === "pi-cli-json") {
@@ -121,7 +118,6 @@ export function recoveredCommandLabel(runner) {
         case "grok-cli-headless": return "grok -p --output-format streaming-json";
         case "qoder-cli-print": return "qodercli -p --output-format stream-json";
         case "pi-cli-json": return "pi --mode json";
-        case "gemini-cli-json": return "gemini -p --output-format stream-json";
         default: return "claude -p";
     }
 }

package/dist/structured-session-manager.d.ts

@@ -24,7 +24,6 @@ export interface StructuredSessionManagerRunners {
     grok?: StructuredRunnerAdapter;
     qoder?: StructuredRunnerAdapter;
     pi?: StructuredRunnerAdapter;
-    gemini?: StructuredRunnerAdapter;
 }
 interface CreateStructuredSessionOptions {
     title?: string;
@@ -126,7 +125,7 @@ export declare class StructuredSessionManager {
     private readonly coreRunner;
     private readonly coreRunnerSupplied;
     private coreRestartDrains;
-    private readonly geminiRunner;
+    private readonly unsupportedStructuredProviders;
     /** Structured CLI runs that were mid-flight when the previous web process died. */
     private pendingRecoveryIds;
     private detachedRecoveryPromise;

package/dist/structured-session-manager.js

@@ -24,7 +24,7 @@ import { SessionMetadataService } from "./session-metadata-service.js";
 import { resolveSessionCwd } from "./session-cwd.js";
 import { isScheduledConversationSession } from "./conversation-session-preview.js";
 import { isSessionProvider, providerCliCommand } from "./session-provider.js";
-import { resolveSystemAiContext } from "./session-ai-context.js";
+import { resolveSessionProvider, resolveSystemAiContext } from "./session-ai-context.js";
 import { CodexRunner } from "./structured-codex-adapter.js";
 import { ClaudeCliRunner } from "./structured-claude-adapter.js";
 import { OpenCodeRunner } from "./structured-opencode-adapter.js";
@@ -34,7 +34,6 @@ import { PiRunner, isMissingPiSession } from "./structured-pi-adapter.js";
 import { PiOutputFile } from "./pi-output-file.js";
 import { PiProtocolReader } from "./pi-protocol-reader.js";
 import { PiTmuxHost } from "./pi-tmux-host.js";
-import { GeminiRunner, isMissingGeminiSession } from "./structured-gemini-adapter.js";
 import { structuredRunId } from "./structured-exec-host.js";
 import { defaultStructuredRunner, defaultStructuredState, isStructuredRunnerForProvider, normalizeThinkingEffort, resolveStructuredRunner } from "./structured-provider-common.js";
 import { TurnQuietHeartbeat } from "./turn-heartbeat.js";
@@ -148,7 +147,7 @@ export class StructuredSessionManager {
     coreRunner;
     coreRunnerSupplied;
     coreRestartDrains = 0;
-    geminiRunner;
+    unsupportedStructuredProviders = new Set();
     /** Structured CLI runs that were mid-flight when the previous web process died. */
     pendingRecoveryIds = [];
     detachedRecoveryPromise = null;
@@ -179,7 +178,6 @@ export class StructuredSessionManager {
         this.coreRunner = withModelGroups(runners.core ?? new CoreRunner({ config: this.config,
             decisionAccess: decisionRuntime, openRouter }), config);
         this.coreRunnerSupplied = runners.core !== undefined;
-        this.geminiRunner = wrap(runners.gemini ?? new GeminiRunner(undefined, this.execHost));
         this.metadata = new SessionMetadataService({
             isDisposed: () => this.disposed,
             current: (id) => this.sessions.get(id),
@@ -199,8 +197,29 @@ export class StructuredSessionManager {
             if ((snapshot.sessionKind ?? "pty") !== "structured")
                 continue;
             const restoredStatus = snapshot.status === "running" ? "idle" : snapshot.status;
-            const storedProvider = snapshot.provider ?? snapshot.structuredState?.provider;
-            const provider = isSessionProvider(storedProvider) ? storedProvider : "claude";
+            let provider;
+            try {
+                provider = resolveSessionProvider(snapshot);
+            }
+            catch (error) {
+                // Keep removed/unknown tools as read-only history. Never rewrite their
+                // durable identity to another provider or try to adopt their process.
+                this.unsupportedStructuredProviders.add(snapshot.id);
+                this.sessions.set(snapshot.id, {
+                    ...snapshot,
+                    status: "failed",
+                    titleGenerating: false,
+                    ...(snapshot.structuredState ? { structuredState: {
+                            ...snapshot.structuredState,
+                            inFlight: false,
+                            activeRequestId: null,
+                            turnStartedAt: null,
+                            lastActivityAt: null,
+                            lastError: error instanceof Error ? error.message : String(error),
+                        } } : {}),
+                });
+                continue;
+            }
             const storedRunner = snapshot.runner ?? snapshot.structuredState?.runner;
             // Legacy/corrupt snapshots are normalized on restore so send dispatch can
             // rely on the provider/runner invariant without making startup fail.
@@ -1152,11 +1171,9 @@ export class StructuredSessionManager {
                             ? "qodercli -p --output-format stream-json"
                             : provider === "pi"
                                 ? "pi --mode json --print"
-                                : provider === "gemini"
-                                    ? "gemini -p --output-format stream-json"
-                                    : runner === "claude-cli-print"
-                                        ? "claude -p (stream-json)"
-                                        : "claude -p --output-format stream-json",
+                                : runner === "claude-cli-print"
+                                    ? "claude -p (stream-json)"
+                                    : "claude -p --output-format stream-json",
             cwd: worktreeSetup?.cwd ?? baseCwd,
             mode: options.mode,
             worktreeEnabled: Boolean(worktreeSetup),
@@ -1384,8 +1401,10 @@ export class StructuredSessionManager {
         const userTurn = buildUserTurn(prompt, pendingAsk, userTurnAt);
         const requestId = randomUUID();
         this.unacceptedTeamStarts.delete(id);
-        if ((session.provider === "pi" && isMissingPiSession(session.structuredState?.lastError, session.claudeSessionId))
-            || (session.provider === "gemini" && isMissingGeminiSession(session.structuredState?.lastError))) {
+        if (this.unsupportedStructuredProviders.has(id)) {
+            throw new Error(`会话使用的 provider 已不受支持，不能继续发送。`);
+        }
+        if (session.provider === "pi" && isMissingPiSession(session.structuredState?.lastError, session.claudeSessionId)) {
             session = { ...session, claudeSessionId: null };
         }
         const updated = {
@@ -1599,15 +1618,6 @@ export class StructuredSessionManager {
         else if (provider === "pi") {
             await this.runPiTurn(id, updated, prompt, requestId);
         }
-        else if (provider === "gemini") {
-            await this.runStructuredStreaming(id, updated, prompt, requestId, {
-                runner: this.geminiRunner,
-                provider: "gemini",
-                commandLabel: "gemini -p --output-format stream-json",
-                logKind: "gemini-json",
-                installHint: "请安装 @google/gemini-cli ≥ 0.11（`npm i -g @google/gemini-cli@latest`），或重跑 `wand service:install` 刷新服务的 PATH",
-            });
-        }
         else {
             await this.runStructuredStreaming(id, updated, cliClaudePrompt, requestId);
         }
@@ -2582,9 +2592,6 @@ export class StructuredSessionManager {
             if (provider === "pi" && isMissingPiSession(result.stderr, current.claudeSessionId)) {
                 failed.claudeSessionId = null;
             }
-            if (provider === "gemini" && isMissingGeminiSession(`${result.stderr}\n${errorText}`)) {
-                failed.claudeSessionId = null;
-            }
             this.sessions.set(sessionId, failed);
             this.saveAuthoritativeSession(failed);
             this.emitStructuredSnapshot(failed);

package/dist/task-organize-contract.d.ts

@@ -0,0 +1,41 @@
+export type TaskOrganizeMode = "auto" | "all";
+export interface OrganizeByTitleResult {
+    ok: true;
+    foundTasks: number;
+    eligibleTasks: number;
+    skippedTasks: number;
+    movedSessions: Array<{
+        sessionId: string;
+        taskId: string;
+        taskName: string;
+    }>;
+    categorizedTasks: Array<{
+        taskId: string;
+        parentTaskId: string;
+        parentTitle: string;
+    }>;
+    refused: Array<{
+        id: string;
+        kind: "session" | "task";
+        reason: string;
+    }>;
+}
+/** Server resolves full membership, independent of sidebar pagination or search. */
+export type TaskOrganizeTarget = {
+    kind: "all";
+} | {
+    kind: "workspace";
+    workspaceId: string;
+} | {
+    kind: "directory";
+    cwd: string;
+};
+export declare const TASK_ORGANIZE_OPTIONS: ({
+    value: "auto";
+    label: string;
+    hint: string;
+} | {
+    value: "all";
+    label: string;
+    hint: string;
+})[];

package/dist/task-organize-contract.js

@@ -0,0 +1,4 @@
+export const TASK_ORGANIZE_OPTIONS = [
+    { value: "auto", label: "自动任务归类", hint: "仅系统自动标题，跳过用户自定标题" },
+    { value: "all", label: "所有任务归类", hint: "包含用户自定标题的任务" },
+];

package/dist/task-title-organize-service.d.ts

@@ -0,0 +1,21 @@
+import { type QuickCommitAiOptions } from "./ai-text-runner.js";
+import type { AutoTaskTitleOptions } from "./task-title-service.js";
+import { type TitleJudge } from "./task-title-organize.js";
+import type { WandStorage } from "./storage.js";
+import type { OrganizeByTitleResult } from "./task-organize-contract.js";
+export type { OrganizeByTitleResult } from "./task-organize-contract.js";
+export declare function titleJudgeForStorage(storage: WandStorage, options: AutoTaskTitleOptions): TitleJudge | undefined;
+export declare function systemTitleJudge(ai: QuickCommitAiOptions, cwd: string): TitleJudge;
+/**
+ * Classify the selected tasks by title and move in-scope sessions to the task
+ * whose title is the same work. Sessions of selected tasks are in scope even
+ * when the sidebar selection did not tick them individually.
+ */
+export declare function organizeSelectedByTitle(storage: WandStorage, input: {
+    taskIds: readonly string[];
+    sessionIds?: readonly string[];
+    mode?: "auto" | "all";
+}, options?: {
+    judge?: TitleJudge;
+    refreshSession?(sessionId: string): void;
+}): Promise<OrganizeByTitleResult>;

package/dist/task-title-organize-service.js

@@ -0,0 +1,168 @@
+import { callConfiguredAiText } from "./ai-text-runner.js";
+import { getErrorMessage } from "./error-utils.js";
+import { resolveSystemAiContext } from "./session-ai-context.js";
+import { parentTaskIdFrom } from "./task-agent-parsing.js";
+import { planTitleOrganization, parseTitleJudgment, titleJudgmentPrompt, } from "./task-title-organize.js";
+import { isGlobalWorkspace, normalizeProjectCwd, projectCwdForSession } from "./workspace-binding.js";
+export function titleJudgeForStorage(storage, options) {
+    const config = options.config;
+    if (!config)
+        return undefined;
+    const provider = config.defaultProvider;
+    const ai = resolveSystemAiContext({
+        provider,
+        structuredState: undefined,
+        runner: undefined,
+        command: provider === "qoder" ? "qodercli" : (provider || "pi"),
+        selectedModel: null,
+        thinkingEffort: "off",
+    }, config, storage.getSystemSiliconEmployee(), options.free);
+    if (ai.employeeChannelOnly && !ai.cliCandidates?.length)
+        return undefined;
+    return systemTitleJudge(ai, options.cwd || config.defaultCwd || process.cwd());
+}
+export function systemTitleJudge(ai, cwd) {
+    return async (input) => {
+        const request = titleJudgmentPrompt(input);
+        return callConfiguredAiText(request, cwd || process.cwd(), "", {
+            ...ai,
+            thinkingEffort: "off",
+        }, parseTitleJudgment);
+    };
+}
+function directoryKeyForTask(storage, task) {
+    const workspace = storage.getWorkspace(task.workspaceId);
+    if (workspace && !isGlobalWorkspace(workspace))
+        return normalizeProjectCwd(workspace.cwd);
+    return normalizeProjectCwd(task.cwd || workspace?.cwd || "");
+}
+function sessionRecord(session, teamOwned) {
+    return {
+        id: session.id,
+        title: session.title?.trim() || "",
+        directoryKey: projectCwdForSession(session),
+        workspaceTaskId: session.workspaceTaskId ?? null,
+        teamOwned,
+        archived: session.archived === true,
+    };
+}
+/**
+ * Classify the selected tasks by title and move in-scope sessions to the task
+ * whose title is the same work. Sessions of selected tasks are in scope even
+ * when the sidebar selection did not tick them individually.
+ */
+export async function organizeSelectedByTitle(storage, input, options = {}) {
+    const taskIds = [...new Set(input.taskIds.map((id) => id.trim()).filter(Boolean))];
+    const sessionIds = [...new Set((input.sessionIds ?? []).map((id) => id.trim()).filter(Boolean))];
+    const tasks = [];
+    const snapshots = new Map();
+    let foundTasks = 0;
+    let skippedTasks = 0;
+    const refused = [];
+    for (const id of taskIds) {
+        const task = storage.getWorkspaceTask(id);
+        const card = task ? storage.getWandTaskByWorkspaceTaskId(task.id) : null;
+        if (!task || !card) {
+            refused.push({ id, kind: "task", reason: "未找到该任务" });
+            continue;
+        }
+        foundTasks++;
+        if ((input.mode ?? "auto") === "auto" && card.titleSource !== "auto") {
+            skippedTasks++;
+            continue;
+        }
+        snapshots.set(task.id, { name: task.name, title: card.title, titleSource: card.titleSource });
+        tasks.push({
+            id: task.id,
+            cardId: card.id,
+            titles: [task.name, card.title],
+            workspaceId: card.workspaceId,
+            directoryKey: directoryKeyForTask(storage, task),
+            status: card.status,
+            parentTaskId: card.parentTaskId,
+            createdAt: task.createdAt,
+            archived: card.status === "archived" || task.archived === true,
+        });
+    }
+    if (!tasks.length) {
+        return { ok: true, foundTasks, eligibleTasks: 0, skippedTasks, movedSessions: [], categorizedTasks: [], refused };
+    }
+    const teamIds = new Set([
+        ...storage.listAiTeamRunChatMarkers().keys(),
+        ...storage.listAiTeamStepSessionMarkers().keys(),
+    ]);
+    const sessions = new Map();
+    for (const task of tasks) {
+        for (const session of storage.listSessionsByWorkspaceTaskSlim(task.id)) {
+            sessions.set(session.id, sessionRecord(session, teamIds.has(session.id)));
+        }
+    }
+    for (const id of sessionIds) {
+        if (sessions.has(id))
+            continue;
+        const session = storage.getSessionSlim(id);
+        if (!session) {
+            refused.push({ id, kind: "session", reason: "未找到该会话" });
+            continue;
+        }
+        // Explicit session selection must not pull user-named tasks into auto mode.
+        if ((input.mode ?? "auto") === "auto" && session.workspaceTaskId
+            && storage.getWandTaskByWorkspaceTaskId(session.workspaceTaskId)?.titleSource !== "auto")
+            continue;
+        sessions.set(session.id, sessionRecord(session, teamIds.has(session.id)));
+    }
+    const plan = await planTitleOrganization(tasks, [...sessions.values()], options.judge);
+    refused.push(...plan.refused);
+    // A semantic judgment is asynchronous: manual renames during it invalidate the pass.
+    if (tasks.some((task) => {
+        const current = storage.getWorkspaceTask(task.id);
+        const card = storage.getWandTask(task.cardId);
+        const before = snapshots.get(task.id);
+        return !current || !card || current.name !== before.name || card.title !== before.title
+            || card.titleSource !== before.titleSource || card.status !== task.status
+            || card.parentTaskId !== task.parentTaskId || card.workspaceId !== task.workspaceId;
+    })) {
+        refused.push({ id: "changed", kind: "task", reason: "任务在归类期间已改变，请重新归类" });
+        return { ok: true, foundTasks, eligibleTasks: tasks.length, skippedTasks, movedSessions: [], categorizedTasks: [], refused };
+    }
+    const movedSessions = [];
+    for (const move of plan.sessionMoves) {
+        const before = sessions.get(move.sessionId);
+        const current = storage.getSessionSlim(move.sessionId);
+        if (!before || !current || current.archived || (current.workspaceTaskId ?? null) !== before.workspaceTaskId
+            || (current.title?.trim() || "") !== before.title || projectCwdForSession(current) !== before.directoryKey
+            || ((input.mode ?? "auto") === "auto" && current.workspaceTaskId
+                && storage.getWandTaskByWorkspaceTaskId(current.workspaceTaskId)?.titleSource !== "auto")) {
+            refused.push({ id: move.sessionId, kind: "session", reason: "会话在归类期间已改变，未改归属" });
+            continue;
+        }
+        const task = storage.getWorkspaceTask(move.taskId);
+        try {
+            storage.moveSessionToWorkspaceTask(move.sessionId, move.taskId);
+            options.refreshSession?.(move.sessionId);
+            movedSessions.push({ sessionId: move.sessionId, taskId: move.taskId, taskName: task?.name ?? "" });
+        }
+        catch (error) {
+            refused.push({ id: move.sessionId, kind: "session", reason: getErrorMessage(error, "无法移动会话") });
+        }
+    }
+    const categorizedTasks = [];
+    for (const link of plan.taskParents) {
+        const task = tasks.find((item) => item.id === link.workspaceTaskId);
+        const card = task ? storage.getWandTask(task.cardId) : null;
+        const parent = storage.getWandTask(link.parentCardId);
+        if (!task || !card || !parent) {
+            refused.push({ id: link.workspaceTaskId, kind: "task", reason: "未找到要归入的任务" });
+            continue;
+        }
+        try {
+            const parentTaskId = parentTaskIdFrom(storage, link.parentCardId, card.workspaceId, card.id, card.parentTaskId);
+            storage.updateWandTask(card.id, { parentTaskId });
+            categorizedTasks.push({ taskId: task.id, parentTaskId: parent.id, parentTitle: parent.title });
+        }
+        catch (error) {
+            refused.push({ id: task.id, kind: "task", reason: getErrorMessage(error, "无法归类任务") });
+        }
+    }
+    return { ok: true, foundTasks, eligibleTasks: tasks.length, skippedTasks, movedSessions, categorizedTasks, refused };
+}