@co0ontty/wand 4.76.0 → 4.77.0-beta.g7fb0b70

package/dist/ai-team-types.d.ts

@@ -0,0 +1,147 @@
+import type { AgentActivityState } from "./mission-types.js";
+import type { WandTaskAgent } from "./task-types.js";
+import type { ConversationTurn } from "./types.js";
+export declare const AI_TEAM_MIN_MEMBERS = 2;
+export declare const AI_TEAM_MAX_MEMBERS = 8;
+export declare const AI_TEAM_DEFAULT_MAX_STEPS = 30;
+export declare const AI_TEAM_MIN_STEPS = 5;
+export declare const AI_TEAM_MAX_STEPS = 200;
+/** 每个成员的执行候选上限（1 首选 + 3 备用，§11-Q5）。 */
+export declare const AI_TEAM_MAX_CANDIDATES = 4;
+/** 成员职责标注；缺省视同 "any"。 */
+export type TeamMemberRole = "plan" | "work" | "verify" | "any";
+export declare const TEAM_MEMBER_ROLES: readonly TeamMemberRole[];
+export declare function isTeamMemberRole(value: unknown): value is TeamMemberRole;
+export interface AiTeamMember {
+    /** 团队内唯一，形如 "m_xxxxxxxx"；Leader 派工时原样引用。 */
+    id: string;
+    name: string;
+    /** 职责说明，原样写进提示词。 */
+    duty: string;
+    /** v2：有序候选执行配置，第一个优先；至少 1 个。 */
+    agents: WandTaskAgent[];
+    /** 兼容字段：始终等于 agents[0]，供未升级读端使用（§3.6 读点清单）。 */
+    agent: WandTaskAgent;
+    /** 职责标注；缺省视同 "any"。 */
+    role?: TeamMemberRole;
+    isLeader: boolean;
+    /** 头像：空串按 id 哈希选毛色；"cat:<n>" 指定毛色；"data:image/…" 为用户上传的小图。 */
+    avatar?: string;
+}
+/**
+ * 取成员候选列表：agents 缺失/空 → [agent]，否则原样返回。
+ * 参数刻意放宽为部分字段，让未归一的裸 JSON（旧 members_json / team_json）也能直接调用。
+ */
+export declare function memberAgents(member: {
+    agent?: WandTaskAgent | undefined;
+    agents?: WandTaskAgent[] | undefined;
+}): WandTaskAgent[];
+/**
+ * 候选身份 = 五元组精确匹配（§3.5）；黑名单与保存期去重共用。
+ * 按字面量比较：model:"default" 不与具体默认模型名做等价归一。
+ */
+export declare function agentKey(agent: WandTaskAgent): string;
+/** 启动失败分类（§3.4）；ai-team-availability（T2）复用此联合类型。 */
+export type CandidateFailureKind = "spawn-missing" | "host-disabled" | "model-unknown" | "startup-timeout" | "runtime-failure" | "format-error" | "user-stop";
+/** 步骤实际派发用的候选与本步之前跳过的候选（§3.2，存 ai_team_steps.dispatch_info_json）。 */
+export interface StepDispatchInfo {
+    usedCandidate: number;
+    skipped: Array<{
+        candidate: number;
+        agent: WandTaskAgent;
+        /** summarizeError 式清洗后的人类文案。 */
+        reason: string;
+        errorKind: CandidateFailureKind;
+    }>;
+}
+/** 上传头像在前端缩成小图后的上限（data URL 字符数）。 */
+export declare const AI_TEAM_AVATAR_MAX_CHARS = 60000;
+export interface AiTeam {
+    id: string;
+    name: string;
+    description: string;
+    /** 协作指令：分工、工作要求与注意事项，写进负责人和成员的提示词。 */
+    instructions: string;
+    members: AiTeamMember[];
+    requirePlanApproval: boolean;
+    /** Leader 轮次 + 成员步骤合计的上限。 */
+    maxSteps: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export type AiTeamRunStatus = "running" | "awaiting_approval" | "waiting_user" | "done" | "failed" | "stopped";
+export declare const AI_TEAM_ACTIVE_RUN_STATUSES: readonly AiTeamRunStatus[];
+export interface AiTeamRun {
+    id: string;
+    teamId: string;
+    /** 启动时的团队快照；之后改团队不影响已开始的运行。 */
+    team: AiTeam;
+    taskId: string;
+    objective: string;
+    cwd: string;
+    status: AiTeamRunStatus;
+    statusDetail: string;
+    stepsUsed: number;
+    stepLimit: number;
+    /** 当前这轮 Leader 回复格式错误的重试次数。 */
+    formatRetries: number;
+    /** 首个计划是否已被批准（或无需批准）。 */
+    planApproved: boolean;
+    /** 这次运行的群聊会话；旧运行没有。 */
+    chatSessionId: string | null;
+    /** 成员干活时用户在群里说的话，等负责人下一轮一起转告。 */
+    pendingNotes: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * 会话列表用的群聊标记：chat_session_id → 最近一次运行（`AiTeamRunChatMarker` 索引的 value）。
+ * 只带列表徽标和点开 IM 视图所需的入口信息，不暴露运行细节。
+ */
+export interface AiTeamRunChatMarker {
+    runId: string;
+    teamName: string;
+    memberCount: number;
+}
+export type AiTeamStepKind = "leader" | "work";
+export type AiTeamStepStatus = "queued" | "running" | "done" | "failed" | "skipped";
+export interface AiTeamStep {
+    id: string;
+    runId: string;
+    seq: number;
+    kind: AiTeamStepKind;
+    memberId: string;
+    title: string;
+    /** 发给成员（或 Leader）的输入。 */
+    instructions: string;
+    sessionId: string | null;
+    status: AiTeamStepStatus;
+    /** 这些步骤都完成后才能开始；空数组表示可立即开始（同一成员仍一次只做一步）。 */
+    dependsOn: string[];
+    /** work：成员报告；leader：Leader 给用户看的说明。 */
+    report: string;
+    /** 约定的报告文件，相对 run.cwd。 */
+    reportPath: string;
+    startedAt: string | null;
+    endedAt: string | null;
+    /**
+     * 本步实际派发用的候选与之前的跳过链（§3.2，存 ai_team_steps.dispatch_info_json）。
+     * 缺省 = 首选、没跳过过任何候选；旧运行不凭空造出留痕。
+     */
+    dispatchInfo?: StepDispatchInfo;
+}
+/** 团队页的运行记录：带上任务卡标题，免去前端再查。 */
+export interface AiTeamRunSummary extends AiTeamRun {
+    taskTitle: string;
+    taskIdentifier: string;
+}
+/** detail() 里群聊回合的截尾条数（§4.4）：面板只给最近这一段，完整会话走「打开群聊」。 */
+export declare const AI_TEAM_DETAIL_CHAT_TURNS = 200;
+export interface AiTeamRunDetail {
+    run: AiTeamRun;
+    steps: AiTeamStep[];
+    /** 运行中步骤所在会话的实时状态（等待授权 / 等待回答等）。 */
+    memberStates: Record<string, AgentActivityState>;
+    /** 群聊 relay 会话的消息，截尾 AI_TEAM_DETAIL_CHAT_TURNS 条；没有群聊会话的旧运行为空数组。 */
+    chatTurns: ConversationTurn[];
+}

package/dist/ai-team-types.js

@@ -0,0 +1,32 @@
+export const AI_TEAM_MIN_MEMBERS = 2;
+export const AI_TEAM_MAX_MEMBERS = 8;
+export const AI_TEAM_DEFAULT_MAX_STEPS = 30;
+export const AI_TEAM_MIN_STEPS = 5;
+export const AI_TEAM_MAX_STEPS = 200;
+/** 每个成员的执行候选上限（1 首选 + 3 备用，§11-Q5）。 */
+export const AI_TEAM_MAX_CANDIDATES = 4;
+export const TEAM_MEMBER_ROLES = ["plan", "work", "verify", "any"];
+export function isTeamMemberRole(value) {
+    return TEAM_MEMBER_ROLES.includes(value);
+}
+/**
+ * 取成员候选列表：agents 缺失/空 → [agent]，否则原样返回。
+ * 参数刻意放宽为部分字段，让未归一的裸 JSON（旧 members_json / team_json）也能直接调用。
+ */
+export function memberAgents(member) {
+    if (Array.isArray(member.agents) && member.agents.length > 0)
+        return member.agents;
+    return member.agent ? [member.agent] : [];
+}
+/**
+ * 候选身份 = 五元组精确匹配（§3.5）；黑名单与保存期去重共用。
+ * 按字面量比较：model:"default" 不与具体默认模型名做等价归一。
+ */
+export function agentKey(agent) {
+    return `${agent.provider}|${agent.model}|${agent.thinkingEffort}|${agent.mode}|${agent.kind}`;
+}
+/** 上传头像在前端缩成小图后的上限（data URL 字符数）。 */
+export const AI_TEAM_AVATAR_MAX_CHARS = 60_000;
+export const AI_TEAM_ACTIVE_RUN_STATUSES = ["running", "awaiting_approval", "waiting_user"];
+/** detail() 里群聊回合的截尾条数（§4.4）：面板只给最近这一段，完整会话走「打开群聊」。 */
+export const AI_TEAM_DETAIL_CHAT_TURNS = 200;

package/dist/attention.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 首页要一眼看到、点进去能处理的报错。
+ * 只收还没消化的失败：团队运行出错、会话 lastError / 失败、合并失败。
+ * 等批准、步数用完、普通提问不算报错。
+ */
+export interface AttentionItem {
+    id: string;
+    title: string;
+    detail: string;
+    /** 点进去处理时打开的会话。没有会话时前端改去团队页。 */
+    sessionId: string | null;
+    updatedAt: string;
+}
+export interface AttentionSessionInput {
+    id: string;
+    title: string;
+    archived?: boolean;
+    status: string;
+    lastError?: string | null;
+    worktreeMergeStatus?: string | null;
+    automationId?: string | null;
+    updatedAt: string;
+}
+export interface AttentionTeamRunInput {
+    id: string;
+    status: string;
+    statusDetail: string;
+    taskTitle: string;
+    teamName: string;
+    chatSessionId: string | null;
+    updatedAt: string;
+}
+export declare function teamRunIdFromAutomation(automationId: string | null | undefined): string;
+/** 团队运行里值得在首页提示的报错。普通提问和步数上限不算。 */
+export declare function teamRunErrorDetail(status: string, detail: string): string | null;
+export declare function sessionErrorDetail(session: AttentionSessionInput): string | null;
+export declare function collectAttentionItems(input: {
+    runs: readonly AttentionTeamRunInput[];
+    sessions: readonly AttentionSessionInput[];
+}): AttentionItem[];

package/dist/attention.js

@@ -0,0 +1,86 @@
+/**
+ * 首页要一眼看到、点进去能处理的报错。
+ * 只收还没消化的失败：团队运行出错、会话 lastError / 失败、合并失败。
+ * 等批准、步数用完、普通提问不算报错。
+ */
+const TEAM_ERROR = /出错|失败|耗尽|无法|不正确/;
+const NOT_AN_ERROR = /步数上限/;
+const ATTENTION_LIMIT = 20;
+export function teamRunIdFromAutomation(automationId) {
+    if (!automationId)
+        return "";
+    if (automationId.startsWith("ai-team-chat:"))
+        return automationId.slice("ai-team-chat:".length);
+    if (automationId.startsWith("ai-team:"))
+        return automationId.slice("ai-team:".length);
+    return "";
+}
+/** 团队运行里值得在首页提示的报错。普通提问和步数上限不算。 */
+export function teamRunErrorDetail(status, detail) {
+    const text = detail.trim();
+    if (status === "failed")
+        return text || "团队运行失败";
+    if (status !== "waiting_user")
+        return null;
+    if (!text || NOT_AN_ERROR.test(text) || !TEAM_ERROR.test(text))
+        return null;
+    return text;
+}
+export function sessionErrorDetail(session) {
+    if (session.archived || !session.id)
+        return null;
+    const lastError = session.lastError?.trim();
+    if (lastError)
+        return lastError;
+    if (session.status === "failed")
+        return "会话失败";
+    if (session.worktreeMergeStatus === "failed")
+        return "工作区合并失败";
+    return null;
+}
+export function collectAttentionItems(input) {
+    const runsById = new Map(input.runs.map((run) => [run.id, run]));
+    const items = [];
+    const seen = new Set();
+    const coveredRunIds = new Set();
+    const push = (item) => {
+        const key = `${item.sessionId ?? item.id}\0${item.detail}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        items.push(item);
+    };
+    for (const run of input.runs) {
+        const detail = teamRunErrorDetail(run.status, run.statusDetail);
+        if (!detail)
+            continue;
+        coveredRunIds.add(run.id);
+        const title = [run.teamName, run.taskTitle].filter(Boolean).join(" · ") || "团队运行";
+        push({
+            id: `team:${run.id}`,
+            title,
+            detail,
+            sessionId: run.chatSessionId,
+            updatedAt: run.updatedAt,
+        });
+    }
+    for (const session of input.sessions) {
+        const detail = sessionErrorDetail(session);
+        if (!detail)
+            continue;
+        const runId = teamRunIdFromAutomation(session.automationId);
+        if (runId && coveredRunIds.has(runId))
+            continue;
+        const linked = runId ? runsById.get(runId) : undefined;
+        push({
+            id: `session:${session.id}`,
+            title: session.title.trim() || "未命名会话",
+            detail,
+            sessionId: linked?.chatSessionId || session.id,
+            updatedAt: session.updatedAt,
+        });
+    }
+    return items
+        .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt) || a.id.localeCompare(b.id))
+        .slice(0, ATTENTION_LIMIT);
+}

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "e98b32fc784c024dd38d1996355044224f2bf398",
-  "builtAt": "2026-09-25T01:15:44.613Z",
-  "version": "4.76.0",
-  "channel": "stable"
+  "commit": "7fb0b7084791e2b2308bffdf7b71893a45f6f2ad",
+  "builtAt": "2026-09-27T10:05:19.219Z",
+  "version": "4.77.0-beta.g7fb0b70",
+  "channel": "beta"
 }

package/dist/claude-sdk-runner.d.ts

@@ -17,6 +17,11 @@ export interface RunClaudePrintOptions {
      * 莫名其妙变中英混搭，根因就在这。
      */
     language?: string;
+    /**
+     * 本次调用的规则 / 角色 / 输出格式。走 appendSystemPrompt，不拼进用户串，
+     * 避免规则被当成待处理内容，也避免它进 provider 历史时冒充用户输入。
+     */
+    systemInstructions?: string;
 }
 /**
  * 解析 SDK 应使用的 claude binary：**优先系统安装的 claude，回退 SDK 内置 native binary**。

package/dist/claude-sdk-runner.js

@@ -118,6 +118,7 @@ export async function runClaudePrint(prompt, options) {
     const timeoutHandle = setTimeout(() => abortController.abort(), options.timeoutMs);
     const sdkClaudeBinary = resolveSdkClaudeBinary();
     const languageDirective = options.language ? buildLanguageDirective(options.language) : "";
+    const appendSystemPrompt = [languageDirective, options.systemInstructions?.trim() ?? ""].filter(Boolean).join("\n\n");
     const model = options.model?.trim();
     const sdkOptions = {
         abortController,
@@ -127,7 +128,7 @@ export async function runClaudePrint(prompt, options) {
         persistSession: false,
         ...(cwd ? { cwd } : {}),
         ...(sdkClaudeBinary ? { pathToClaudeCodeExecutable: sdkClaudeBinary } : {}),
-        ...(languageDirective ? { appendSystemPrompt: languageDirective } : {}),
+        ...(appendSystemPrompt ? { appendSystemPrompt } : {}),
         ...(model && model !== "default" ? { model } : {}),
         ...(options.effort ? { effort: options.effort } : {}),
     };

package/dist/commit-task-archive.d.ts

@@ -0,0 +1,3 @@
+import type { WandStorage } from "./storage.js";
+import type { SessionSnapshot } from "./types.js";
+export declare function archiveCommitTasks(storage: WandStorage, session: SessionSnapshot, entryIds: readonly string[]): string[];

package/dist/commit-task-archive.js

@@ -0,0 +1,43 @@
+import { projectCwdForSession, normalizeProjectCwd } from "./workspace-binding.js";
+/**
+ * Only close completed cards linked to this commit's selected iteration entries (or its
+ * session). A shared default iteration can contain several projects and old completed work;
+ * neither is a reason to archive an unrelated card.
+ */
+function cardIdForSession(storage, sessionId) {
+    const binding = storage.getSessionWorkspace(sessionId);
+    const card = binding?.workspaceTaskId
+        ? storage.getWandTaskByWorkspaceTaskId(binding.workspaceTaskId)
+        : null;
+    return card?.id ?? storage.getWandTaskIdForSession(sessionId);
+}
+export function archiveCommitTasks(storage, session, entryIds) {
+    const directory = projectCwdForSession(session);
+    const related = new Set();
+    const currentTaskId = cardIdForSession(storage, session.id);
+    if (currentTaskId)
+        related.add(currentTaskId);
+    for (const entry of storage.listIterationPromptsByIds(entryIds)) {
+        const taskId = entry.taskId || (entry.sessionId ? cardIdForSession(storage, entry.sessionId) : null);
+        if (taskId)
+            related.add(taskId);
+    }
+    return storage.transaction(() => {
+        const archived = [];
+        for (const id of related) {
+            const task = storage.getWandTask(id);
+            if (task?.status !== "done")
+                continue;
+            // The workspace is the authoritative directory for a card. Worktree sessions use the
+            // parent project directory; a global/unassigned card only qualifies via this very session.
+            const workspace = task.workspaceId ? storage.getWorkspace(task.workspaceId) : null;
+            const sameDirectory = !!workspace && workspace.kind !== "global"
+                && !!directory && normalizeProjectCwd(workspace.cwd) === directory;
+            if (!sameDirectory && !(id === currentTaskId && (!workspace || workspace.kind === "global")))
+                continue;
+            storage.updateWandTask(id, { status: "archived" });
+            archived.push(id);
+        }
+        return archived;
+    });
+}

package/dist/config.js

@@ -596,7 +596,6 @@ function defaultCardExpandDefaults() {
         inlineTools: false,
         terminal: false,
         thinking: false,
-        toolGroup: false,
     };
 }
 function normalizeCardDefaults(input) {
@@ -608,7 +607,6 @@ function normalizeCardDefaults(input) {
         inlineTools: typeof raw.inlineTools === "boolean" ? raw.inlineTools : false,
         terminal: typeof raw.terminal === "boolean" ? raw.terminal : false,
         thinking: typeof raw.thinking === "boolean" ? raw.thinking : false,
-        toolGroup: typeof raw.toolGroup === "boolean" ? raw.toolGroup : false,
     };
 }
 function defaultAndroidApkConfig() {

package/dist/git-quick-commit.d.ts

@@ -1,3 +1,4 @@
+import { type AiTextRequest } from "./system-ai.js";
 import { GitStatusResult, PushResult, QuickCommitResult, SessionProvider, SessionSnapshot, TagHeadResult } from "./types.js";
 export type QuickCommitErrorCode = "CWD_MISSING" | "NO_CWD" | "NOT_A_GIT_REPO" | "NO_COMMIT" | "NOTHING_TO_COMMIT" | "NOTHING_TO_PUSH" | "EMPTY_MESSAGE" | "EMPTY_TAG" | "EMPTY_AI_MESSAGE" | "AI_FALLBACK_FAILED" | "INVALID_AI_TAG" | "TAG_EXISTS" | "GIT_ADD_FAILED" | "GIT_DIFF_FAILED" | "GIT_COMMIT_FAILED" | "GIT_TAG_FAILED" | "CLAUDE_CLI_MISSING" | "CLAUDE_CLI_FAILED" | "CLAUDE_TIMEOUT";
 /** Non-blocking status implementation used by HTTP routes. */
@@ -48,7 +49,7 @@ export interface CommitInputOptions {
  * exhausts its profile chain and then falls back once to the current-session
  * CLI. CLI mode uses only that CLI.
  */
-export declare function callConfiguredAiText(prompt: string, cwd: string, language: string, opts: QuickCommitAiOptions): Promise<string>;
+export declare function callConfiguredAiText(request: AiTextRequest, cwd: string, language: string, opts: QuickCommitAiOptions): Promise<string>;
 export interface GenerateCommitMessageResult {
     message: string;
     /** AI-suggested next tag derived from the staged diff and the latest existing tag. */