@co0ontty/wand 4.93.0 → 4.94.0

package/dist/web-ui/react/workspaces/types.d.ts

@@ -0,0 +1,408 @@
+import type { ProviderId } from "../../provider-identity.js";
+import { WAND_AGENT_TOOL_ID } from "../../provider-identity.js";
+export type WorkspaceProvider = ProviderId;
+/**
+ * 能在任务窗口里跑起来的一项：CLI 工具、Wand Agent（进程内 SDK）或裸 Shell。
+ * Wand Agent 与 Pi 共用 pi provider，但在 UI 上是两个可选项，所以用选项 id 当 target。
+ */
+export type WorkspaceSessionTarget = WorkspaceProvider | "shell" | typeof WAND_AGENT_TOOL_ID;
+/**
+ * target → provider。Wand Agent 也用 pi provider 开会话，只是引擎是进程内 SDK。
+ * Shell 没有 provider，返回空串。
+ */
+export declare function workspaceTargetProvider(target: WorkspaceSessionTarget): WorkspaceProvider | "";
+/** target → 执行引擎；只有 Wand Agent 走 SDK，其余都是 CLI。 */
+export declare function workspaceTargetEngine(target: WorkspaceSessionTarget): "cli" | "sdk" | undefined;
+/** Agent 窗口的运行形态；空白终端固定为 PTY。 */
+export type WorkspaceSessionKind = "structured" | "pty";
+/**
+ * picker「AI 团队」分组的一项（§5.1 修正 B8）。
+ * 团队不进 WorkspaceSessionTarget 联合：它是并列的独立选择态，`teamId` 空串表示
+ * 这一次起的是会话，非空表示直接开工；提交链路按「会话 or 团队」分叉。
+ */
+export interface WorkspaceTeamOption {
+    id: string;
+    name: string;
+    /** 分组项第二行的说明：成员数与擅长什么。 */
+    detail: string;
+}
+export type PaneTab = {
+    id: string;
+    kind: "session";
+    sessionId: string;
+} | {
+    id: string;
+    kind: "editor";
+    path: string;
+} | {
+    id: string;
+    kind: "preview";
+    path: string;
+};
+export type LayoutNode = {
+    type: "pane";
+    tabs: PaneTab[];
+    active: number;
+} | {
+    type: "split";
+    dir: "h" | "v";
+    ratio: number;
+    children: [LayoutNode, LayoutNode];
+};
+/** 顶部的一个工作窗口 Tab；其内部可以是单终端，也可以是一棵分屏树。 */
+export interface WorkWindowLayout {
+    id: string;
+    layout: LayoutNode;
+    /** 当前接受窗口级操作（移动、标题）的终端/内容标签。 */
+    activeTabId?: string;
+}
+/**
+ * 任务级窗口集合。顶部 Tab 只映射这里的 windows；终端进入另一个窗口后，
+ * 来源 window 会被移除，终端本身成为目标 window 分屏树里的一个 pane。
+ */
+export interface TaskWindowLayout {
+    type: "windows";
+    windows: WorkWindowLayout[];
+    activeWindowId: string | null;
+}
+export interface Workspace {
+    id: string;
+    name: string;
+    cwd: string;
+    kind?: "project" | "global";
+    defaultProvider?: WorkspaceProvider;
+    layout: LayoutNode | null;
+    createdAt: string;
+    lastOpenedAt: string | null;
+    /** Number of task-owned worktrees currently registered under this project. */
+    worktreeCount?: number;
+    /** Number of sessions bound to this project (including task-owned ones). */
+    sessionCount?: number;
+}
+/** GET /api/workspaces/:id 额外带回该项目下的会话列表。 */
+export interface WorkspaceSessionSummary {
+    id: string;
+    /** 实际运行引擎的只读投影，不把 Wand Agent 冒充 Pi CLI。 */
+    engine?: "core" | "cli";
+    provider?: WorkspaceProvider;
+    sessionKind?: string;
+    runner?: string;
+    command?: string;
+    title?: string;
+    titleGenerating?: boolean;
+    status?: string;
+    completionRevision?: number;
+    viewedCompletionRevision?: number;
+    cwd?: string;
+    startedAt?: string;
+    workspaceTaskId?: string;
+    ptyBusy?: boolean;
+    /** 空白终端中仍有前台命令；不是 provider 的生成回合。 */
+    ptyCommandRunning?: boolean;
+    /** 已归档：从正常列表收起，进「已归档」区，可恢复；归档 7 天后由保留期清理。 */
+    archived?: boolean;
+    archivedAt?: string | null;
+    providerCliActive?: boolean;
+    providerCliExitCode?: number | null;
+    inFlight?: boolean;
+    canArchive?: boolean;
+    employeeId?: string;
+    employeeName?: string;
+    employeeAvatar?: string;
+    /** 这条会话是 AI 团队的群聊 relay 会话；服务端 join ai_team_runs 后带上入口信息。 */
+    teamChat?: WorkspaceSessionTeamChat;
+    /** 这条会话是 AI 团队派发出来的成员工作会话；服务端 join ai_team_steps 后带上这一步的身份。 */
+    teamStep?: WorkspaceSessionTeamStep;
+}
+/** 群聊标记的数据来源：ai_team_runs 中该 chat_session_id 最近一次运行（服务端 AiTeamRunChatMarker）。 */
+export interface WorkspaceSessionTeamChat {
+    teamId: string;
+    runId: string;
+    teamName: string;
+    chatTitle?: string;
+    memberCount: number;
+}
+/** 成员步骤标记的数据来源：ai_team_steps.session_id（服务端 AiTeamStepSessionMarker）。 */
+export interface WorkspaceSessionTeamStep {
+    runId: string;
+    stepId: string;
+    /** leader = 负责人自己的回合，work = 派给成员干活的会话。 */
+    kind: string;
+    /** 这一步的任务标题，列表拿它当短标题，不等 CLI 生成会话名。 */
+    title: string;
+    memberId: string;
+    memberName: string;
+    teamName: string;
+    stepStatus: string;
+    runStatus: string;
+    /** 运行已进入终态：这一步的会话算历史，默认折起来、可以清空。 */
+    runFinished: boolean;
+}
+export interface WorkspaceDetail extends Workspace {
+    sessions: WorkspaceSessionSummary[];
+}
+type WorkspaceTaskStatus = "active" | "done";
+/** 任务所属 worktree 信息；非 git 目录时为 null（退化为直接在项目目录运行）。 */
+interface WorkspaceTaskWorktree {
+    branch: string;
+    path: string;
+    baseRef?: string;
+    repoRoot?: string;
+}
+export interface WorkspaceTask {
+    canArchive?: boolean;
+    id: string;
+    workspaceId: string;
+    name: string;
+    worktree: WorkspaceTaskWorktree | null;
+    cwd?: string;
+    /** 归属里程碑（全局列表）；null = 未归入。建任务时同步到看板卡片。 */
+    milestoneId?: string | null;
+    layout: TaskWindowLayout | null;
+    status: WorkspaceTaskStatus;
+    archived?: boolean;
+    createdAt: string;
+    lastOpenedAt: string | null;
+    layoutRevision?: number;
+}
+/** POST/GET 任务路由的返回：在 WorkspaceTask 基础上带回运行期派生字段。 */
+export interface WorkspaceTaskDetail extends WorkspaceTask {
+    /** 任务实际运行目录（worktree 路径，或非 git 时回退到项目目录）。 */
+    cwd: string;
+    /** 是否隔离（有独立 worktree）。 */
+    isolated: boolean;
+    /** 非 git / 基线缺失时的降级提示。 */
+    worktreeError?: string;
+    /** 该任务下已绑定的会话。 */
+    sessions: WorkspaceSessionSummary[];
+}
+/** GET /api/tasks 聚合行：任务 + 运行期派生字段；目录信息在 TaskDirectoryGroup 上。 */
+export type TaskSummary = WorkspaceTaskDetail & {
+    /** 使用 maxSessions 截断时的真实会话总数（未截断时等于 sessions.length）。 */
+    totalSessions?: number;
+    /** 已归档的会话：不进正常列表，在任务下单独收起，可恢复。 */
+    archivedSessions?: WorkspaceSessionSummary[];
+};
+/**
+ * GET /api/tasks 返回的目录组：任务一级容器的分组维度。
+ * 未绑定任务的会话以 standaloneSessions 归入所在目录（synthetic 组表示该
+ * 目录没有项目实体，仅用于展示，不能在其中建任务）。
+ */
+export interface TaskDirectoryGroup {
+    workspaceId: string;
+    workspaceName: string;
+    workspaceCwd: string;
+    /** Folder birth time. New folders sort first; opening never changes this. */
+    createdAt?: string;
+    synthetic?: boolean;
+    /** Hidden global workspace that holds standalone tasks. */
+    global?: boolean;
+    tasks: TaskSummary[];
+    standaloneSessions: WorkspaceSessionSummary[];
+    /** 该目录下未绑定任务的已归档会话。 */
+    archivedSessions?: WorkspaceSessionSummary[];
+}
+export type WorkspaceWorktreeState = "ready" | "dirty" | "conflict" | "empty" | "unavailable";
+interface WorkspaceWorktreeCommit {
+    hash: string;
+    shortHash: string;
+    subject: string;
+}
+export interface WorkspaceWorktreeReview {
+    taskId: string;
+    taskName: string;
+    taskStatus: WorkspaceTaskStatus;
+    branch: string;
+    path: string;
+    baseRef: string;
+    state: WorkspaceWorktreeState;
+    actionable: boolean;
+    reason: string;
+    aheadCount: number;
+    hasUncommittedChanges: boolean;
+    hasConflicts: boolean;
+    commits: readonly WorkspaceWorktreeCommit[];
+}
+export interface WorkspaceWorktreeOverview {
+    workspaceId: string;
+    repoRoot: string;
+    targetBranch: string;
+    worktrees: readonly WorkspaceWorktreeReview[];
+}
+export interface CreateWorkspaceTaskRequest {
+    name?: string;
+    /** 首个会话的提示词：任务留空名时用它总结标题，并同步到看板卡片描述。 */
+    description?: string;
+    baseRef?: string;
+    /** Optional directory override, used by standalone tasks that mount a folder. */
+    cwd?: string;
+    /** 显式 false 时跳过独立 worktree，会话直接跑在项目目录；缺省为 true。 */
+    worktree?: boolean;
+    /** 里程碑 id；null / 缺省表示不归入里程碑。 */
+    milestoneId?: string | null;
+}
+export interface CreateStandaloneTaskRequest {
+    name?: string;
+    /** 首个会话的提示词：任务留空名时用它总结标题，并同步到看板卡片描述。 */
+    description?: string;
+    cwd?: string;
+    worktree?: boolean;
+    /** 里程碑 id；null / 缺省表示不归入里程碑。 */
+    milestoneId?: string | null;
+}
+export interface UpdateWorkspaceTaskRequest {
+    name?: string;
+    status?: WorkspaceTaskStatus;
+    milestoneId?: string | null;
+}
+export interface CreateWorkspaceRequest {
+    name: string;
+    cwd: string;
+    defaultProvider?: WorkspaceProvider;
+}
+export interface UpdateWorkspaceRequest {
+    name?: string;
+    cwd?: string;
+    defaultProvider?: WorkspaceProvider | null;
+}
+export interface RecentPath {
+    path: string;
+    name: string;
+}
+export interface NewProjectDefaults {
+    defaultProvider: WorkspaceProvider;
+    /** 默认执行引擎；只对 pi 有意义（`sdk` = Wand Agent）。 */
+    defaultEngine?: "cli" | "sdk";
+    defaultCwd: string;
+    defaultSessionKind: WorkspaceSessionKind;
+    defaultTaskWorktree: boolean;
+    recentPaths: RecentPath[];
+}
+export interface WorkspacesRepository {
+    list(): Promise<Workspace[]>;
+    /** 目录分组的任务聚合列表（GET /api/tasks），供侧栏「任务」视图一次拉全。 */
+    listTaskGroups(revision?: string): Promise<{
+        groups: TaskDirectoryGroup[];
+        revision?: string;
+        unchanged: boolean;
+    }>;
+    get(id: string): Promise<WorkspaceDetail>;
+    create(request: CreateWorkspaceRequest): Promise<Workspace>;
+    update(id: string, patch: UpdateWorkspaceRequest): Promise<Workspace>;
+    remove(id: string, cascade?: boolean): Promise<void>;
+    saveLayout(id: string, layout: LayoutNode | null): Promise<LayoutNode | null>;
+    /**
+     * 重命名目录（工作区显示名）。服务端会同时同步项目名，
+     * 保证任务列表 / 项目列表 / 原生客户端显示同一个名字。
+     */
+    renameDirectory(cwd: string, name: string | null): Promise<void>;
+    listTasks(workspaceId: string): Promise<WorkspaceTask[]>;
+    createTask(workspaceId: string, request: CreateWorkspaceTaskRequest): Promise<WorkspaceTaskDetail>;
+    createStandaloneTask(request: CreateStandaloneTaskRequest): Promise<WorkspaceTaskDetail>;
+    getTask(taskId: string): Promise<WorkspaceTaskDetail>;
+    updateTask(taskId: string, patch: UpdateWorkspaceTaskRequest): Promise<WorkspaceTask>;
+    deleteTask(taskId: string, cascade?: boolean): Promise<void>;
+    /** 归档任务：保留终端与 worktree，仅从侧栏隐藏并移入看板归档。 */
+    archiveTask(taskId: string): Promise<WorkspaceTask>;
+    /** 归档会停止会话、保留 session id；恢复时用这个 ID 续上。 */
+    archiveSession(sessionId: string, archived: boolean): Promise<void>;
+    /** 批量归档 / 恢复会话。 */
+    batchArchiveSessions(sessionIds: readonly string[], archived: boolean): Promise<void>;
+    saveTaskLayout(taskId: string, layout: TaskWindowLayout | null, layoutRevision?: number): Promise<{
+        layout: TaskWindowLayout | null;
+        layoutRevision?: number;
+    }>;
+    /** Project-level review data used by the multi-worktree merge Agent launcher. */
+    listWorktrees(workspaceId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<WorkspaceWorktreeOverview>;
+    /** 关闭工作窗口 / 终端时批量结束并删除其底层会话。 */
+    deleteSessions(sessionIds: readonly string[]): Promise<void>;
+}
+/** 打开任务时传给宿主的载荷：足够启动一个绑定到该任务的会话。 */
+export interface OpenWorkspaceTaskPayload {
+    workspaceId: string;
+    workspaceName: string;
+    taskId: string;
+    taskName: string;
+    cwd: string;
+    provider?: WorkspaceProvider;
+    /**
+     * 恢复这个任务的标签布局时优先选中的会话（侧栏 / 通知点了哪一个就恢复哪一个）。
+     * 不传时沿用旧行为：当前选中 → 布局里存的活跃标签 → 第一个会话。
+     */
+    preferredSessionId?: string;
+}
+/** 标签栏「+ 新建会话」时传给宿主：在同一任务 worktree 内再起一个绑定会话。 */
+export interface NewTaskSessionPayload {
+    workspaceId: string;
+    /** 缺省表示这次不绑定任务：会话落在所在目录的「未分组任务」里。 */
+    taskId?: string;
+    cwd: string;
+    target: WorkspaceSessionTarget;
+    kind?: WorkspaceSessionKind;
+    prompt?: string;
+    /** 启动会话时使用的模型 id；空串表示跟随服务端默认。 */
+    model?: string;
+    /** Structured-only employee identity; the server resolves its ordered CLI candidates. */
+    employeeId?: string;
+}
+interface StartWorkspaceMergeAgentPayload {
+    workspaceId: string;
+    cwd: string;
+    provider?: WorkspaceProvider;
+    /** 角色与规则：走会话的系统提示，不拼进 prompt。 */
+    systemPrompt: string;
+    prompt: string;
+}
+export interface TaskLayoutSaveOptions {
+    /** Reconciliation/restoration is not a new user edit after a failed save. */
+    automatic?: boolean;
+}
+export interface WorkspacesRuntimeAdapter {
+    /** 对话框打开/关闭的副作用钩子（关其它覆盖层等）。 */
+    onOpen(): void;
+    onClose(): void;
+    /** 当前有效工作目录，作为新建项目目录的默认值。 */
+    effectiveCwd(): string;
+    /** 项目创建成功后：设为活动工作空间（打开工作空间窗口）。 */
+    openWorkspace(workspace: Workspace): void;
+    /** 关闭当前工作空间 / 任务上下文。 */
+    closeWorkspace(): void;
+    /** 删除任务 / 项目后立即刷新会话列表，清掉已删除会话的选中态。 */
+    refreshSessions(): void | Promise<unknown>;
+    /** 选中并打开一个已有会话（项目里的独立会话与会话列表共用同一条记录）。 */
+    selectSession(sessionId: string): void;
+    /**
+     * 点击任务：只恢复任务上下文与已有会话；空任务保持欢迎页。
+     * 返回 Promise 时表示详情恢复完成；调用方若紧接着要在该任务里建会话，
+     * 必须先 await，避免恢复流程用旧快照覆盖新会话的选中态。
+     */
+    openTask(payload: OpenWorkspaceTaskPayload): void | Promise<void>;
+    /** 标签栏「+」：在该任务 worktree 再起一个绑定会话；taskId 缺省时起未分组会话。 */
+    newTaskSession(payload: NewTaskSessionPayload): void | Promise<unknown>;
+    /**
+     * 某个 CLI 工具「上次用过的模型」；新建任务 / 工作窗口用它预选模型。
+     * 与输入框 composer 的按 provider 记忆同源，空串表示还没选过。
+     */
+    modelPreference(provider: WorkspaceProvider): string;
+    /** 用户在创建时选了模型：写回按 provider 的记忆，下一次默认沿用。 */
+    rememberModelPreference(provider: WorkspaceProvider, model: string): void;
+    /** Start one managed Agent at the project checkout to merge selected task worktrees. */
+    startWorktreeMergeAgent(payload: StartWorkspaceMergeAgentPayload): void | Promise<unknown>;
+    /** 工作窗口 / 分屏布局变更后回写持久化 + 更新活动上下文。 */
+    saveTaskLayout(layout: TaskWindowLayout | null, options?: TaskLayoutSaveOptions): void | Promise<unknown>;
+    /** 确认并关闭底层会话；取消或失败时返回 false，调用方不得移除布局。 */
+    closeTaskSessions(sessionIds: readonly string[], scope: "window" | "terminal"): Promise<boolean>;
+    /** 在指定容器内为某会话挂一个池终端实例（分屏窗格内容）。幂等。 */
+    mountSessionTerminal(sessionId: string, container: HTMLElement): boolean;
+    /** 释放某会话的池终端实例（窗格卸载 / 标签关闭）。 */
+    unmountSessionTerminal(sessionId: string): void;
+    /** 读取 / 更新单个池终端的独立缩放比例。 */
+    getSessionTerminalScale(sessionId: string): number;
+    setSessionTerminalScale(sessionId: string, scale: number): number;
+    /** 释放全部池终端（退出工作空间窗口）。 */
+    disposeAllSessionTerminals(): void;
+    toast(message: string, tone?: "info" | "success" | "warning" | "danger"): void;
+}
+export {};

package/dist/web-ui/react/workspaces/types.js

@@ -0,0 +1,16 @@
+// 工作空间（项目）前端类型。镜像 src/types.ts 的 Workspace/LayoutNode/PaneTab，
+// provider 联合沿用浏览器层共享的 provider-identity（不把服务端 types 拉进浏览器 bundle）。
+import { WAND_AGENT_TOOL_ID } from "../../provider-identity.js";
+/**
+ * target → provider。Wand Agent 也用 pi provider 开会话，只是引擎是进程内 SDK。
+ * Shell 没有 provider，返回空串。
+ */
+export function workspaceTargetProvider(target) {
+    if (target === "shell")
+        return "";
+    return target === WAND_AGENT_TOOL_ID ? "pi" : target;
+}
+/** target → 执行引擎；只有 Wand Agent 走 SDK，其余都是 CLI。 */
+export function workspaceTargetEngine(target) {
+    return target === WAND_AGENT_TOOL_ID ? "sdk" : undefined;
+}

package/dist/web-ui/session-activity.js

@@ -1,4 +1,4 @@
-const PROVIDER_CLI_IDS = new Set(["claude", "codex", "opencode", "grok", "qoder", "pi", "gemini"]);
+const PROVIDER_CLI_IDS = new Set(["claude", "codex", "opencode", "grok", "qoder", "pi"]);
 function isStructured(session) {
     return session.sessionKind === "structured" || session.runner === "claude-cli-print";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@co0ontty/wand",
-  "version": "4.93.0",
+  "version": "4.94.0",
   "description": "A web console for Claude Code, Codex, OpenCode, and other local CLI tools.",
   "type": "module",
   "bin": {
@@ -38,7 +38,7 @@
     "dev": "node scripts/check-node-version.js && node scripts/bundle-tailwind.js && node scripts/bundle-xterm.js && node scripts/bundle-qrcode.js && node scripts/bundle-browser.js --development && npm run generate:web-assets && tsx src/cli.ts web",
     "check": "node src/deployment-lock.ts --run-project -- npm run check:body",
     "check:body": "node scripts/check-node-version.js && node scripts/bundle-tailwind.js && node scripts/bundle-xterm.js && node scripts/bundle-qrcode.js && node scripts/bundle-browser.js && npm run generate:web-assets && tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.browser.json && tsc --noEmit -p tsconfig.react.json",
-    "test": "node scripts/check-node-version.js && node --test --import tsx tests/*.test.ts",
+    "test": "node scripts/check-node-version.js && node scripts/run-tests.js",
     "check:bundle-budget": "node scripts/check-node-version.js && node scripts/check-bundle-budget.js",
     "sync:brand-assets": "node scripts/sync-brand-assets.js",
     "check:brand-assets": "node scripts/sync-brand-assets.js --check",

package/dist/structured-gemini-adapter.d.ts

@@ -1,40 +0,0 @@
-import { spawn } from "node:child_process";
-import type { StructuredExecHost } from "./structured-exec-host.js";
-import type { StructuredRunnerAdapter, StructuredRunnerContext, StructuredRunnerExecution, StructuredRunnerObserver, StructuredRunnerTurnState } from "./structured-runner.js";
-import type { SessionSnapshot } from "./types.js";
-export type GeminiTurnState = StructuredRunnerTurnState;
-/**
- * Gemini CLI 的会话写在 `~/.gemini/tmp/<project_hash>/chats/`。ID 找不回来时 headless
- * 会以 42 退出并打印下面这句，识别出来才能丢掉失效的 resume ID 重开一轮
- * （与 Claude / Pi 的同类兜底一致）。
- */
-export declare function isMissingGeminiSession(error: string | null | undefined): boolean;
-/**
- * approval mode 映射。结构化 runner 没有权限桥，`default` 下需要确认的工具调用会被
- * 直接拒绝；`yolo` 才是能连续干活的那一档。
- */
-export declare function geminiApprovalMode(session: SessionSnapshot): "default" | "auto_edit" | "yolo";
-/**
- * `-p ""` 只把 CLI 钉在 headless 模式，真正的 prompt 走 stdin（Gemini CLI 把 stdin
- * 内容与 `-p` 内容用空行拼接，`-p` 为空时只剩 stdin）。这样长消息不撞 argv 上限，
- * 也不会出现在 `ps` 里。
- *
- * `--skip-trust` 必须带：headless 模式下 Gemini CLI 会检查工作区信任状态，未信任的
- * 目录会直接以 55 退出，并把 `--approval-mode` 降级成 `default`。Wand 是在用户自己
- * 选定的工作目录里代表用户启动这个 CLI，与其它 provider 的 auto-approve 语义一致。
- */
-export declare function buildGeminiArgs(session: SessionSnapshot): string[];
-export declare function geminiToolName(name: string): string;
-/**
- * Apply one Gemini CLI `--output-format stream-json` event.
- *
- * assistant `message` 事件带 `delta: true`，每个 chunk 是增量而不是快照，所以文本是
- * 追加而不是替换。tool_use / tool_result 由 CLI 直接按 tool_id 配对，不需要 upsert。
- */
-export declare function applyGeminiEvent(state: GeminiTurnState, event: Record<string, unknown>): string | null;
-export declare class GeminiRunner implements StructuredRunnerAdapter {
-    private readonly spawnProcess;
-    private readonly execHost?;
-    constructor(spawnProcess?: typeof spawn, execHost?: StructuredExecHost | undefined);
-    start(context: StructuredRunnerContext, observer: StructuredRunnerObserver): StructuredRunnerExecution;
-}