@co0ontty/wand 4.76.0 → 4.77.0-beta.g7fb0b70

package/dist/storage.js

@@ -4,9 +4,10 @@ import path from "node:path";
 import { DatabaseSync } from "node:sqlite";
 import { GLOBAL_WORKSPACE_ID } from "./types.js";
 import { normalizeSessionDirectory } from "./session-directory-tree.js";
-import { inferProviderFromCommand, inferProviderFromRunner, isSessionProvider } from "./session-provider.js";
+import { inferProviderFromCommand, inferProviderFromRunner, isSessionProvider, SESSION_PROVIDERS } from "./session-provider.js";
 import { DEFAULT_ITERATION_NAME, DEFAULT_WAND_TASK_AGENT_KIND, DEFAULT_WAND_TASK_PRIORITY, isWandTaskAgentKind, normalizeWandTaskAgentMode } from "./task-types.js";
 import { firstLayoutTabId } from "./layout-tree.js";
+import { AI_TEAM_DEFAULT_MAX_STEPS, isTeamMemberRole, memberAgents } from "./ai-team-types.js";
 import { isThinkingEffort } from "./structured-provider-common.js";
 import { DEFAULT_PASSWORD_VAULT_ID, DEFAULT_PASSWORD_VAULT_NAME, decryptVaultSecret, encryptVaultSecret, itemMatchesFilter, normalizePasswordItemInput, normalizeVaultName, nowIso, } from "./password-manager.js";
 function safeJsonParse(raw) {
@@ -24,7 +25,11 @@ function safeJsonParse(raw) {
  * 前端据此显示「未指定 CLI 工具」，而不是渲染出半个派发配置。
  */
 export function parseWandTaskAgent(raw) {
-    const value = typeof raw === "string" ? safeJsonParse(raw) : undefined;
+    const value = typeof raw === "string"
+        ? safeJsonParse(raw)
+        : raw && typeof raw === "object" && !Array.isArray(raw)
+            ? raw
+            : undefined;
     if (!value || typeof value !== "object")
         return null;
     const provider = value.provider;
@@ -170,6 +175,7 @@ function serializeSessionOptions(snapshot) {
         providerCliExitCode: snapshot.providerCliExitCode,
         currentTaskTitle: snapshot.currentTaskTitle,
         summary: snapshot.summary,
+        systemPrompt: snapshot.systemPrompt,
     };
     return JSON.stringify(options);
 }
@@ -231,6 +237,8 @@ function parseSessionOptions(raw) {
         options.currentTaskTitle = parsed.currentTaskTitle;
     if (typeof parsed.summary === "string")
         options.summary = parsed.summary;
+    if (typeof parsed.systemPrompt === "string")
+        options.systemPrompt = parsed.systemPrompt;
     return options;
 }
 function parseQueuedMessages(raw) {
@@ -772,7 +780,76 @@ const INIT_SQL = `
     FOREIGN KEY (session_id) REFERENCES command_sessions(id) ON DELETE CASCADE
   );
   CREATE INDEX IF NOT EXISTS idx_wand_task_sessions_session ON wand_task_sessions(session_id);
+
+  CREATE TABLE IF NOT EXISTS ai_teams (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    description TEXT NOT NULL DEFAULT '',
+    instructions TEXT NOT NULL DEFAULT '',
+    members_json TEXT NOT NULL,
+    require_plan_approval INTEGER NOT NULL DEFAULT 1,
+    max_steps INTEGER NOT NULL DEFAULT 30,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS ai_team_runs (
+    id TEXT PRIMARY KEY,
+    team_id TEXT NOT NULL,
+    task_id TEXT NOT NULL,
+    team_json TEXT NOT NULL,
+    objective TEXT NOT NULL,
+    cwd TEXT NOT NULL,
+    status TEXT NOT NULL,
+    status_detail TEXT NOT NULL DEFAULT '',
+    steps_used INTEGER NOT NULL DEFAULT 0,
+    step_limit INTEGER NOT NULL,
+    format_retries INTEGER NOT NULL DEFAULT 0,
+    plan_approved INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+  CREATE INDEX IF NOT EXISTS idx_ai_team_runs_task ON ai_team_runs(task_id, created_at);
+  CREATE INDEX IF NOT EXISTS idx_ai_team_runs_status ON ai_team_runs(status);
+
+  CREATE TABLE IF NOT EXISTS ai_team_steps (
+    id TEXT PRIMARY KEY,
+    run_id TEXT NOT NULL,
+    seq INTEGER NOT NULL,
+    kind TEXT NOT NULL,
+    member_id TEXT NOT NULL,
+    title TEXT NOT NULL,
+    instructions TEXT NOT NULL,
+    session_id TEXT,
+    status TEXT NOT NULL,
+    report TEXT NOT NULL DEFAULT '',
+    report_path TEXT NOT NULL,
+    depends_on_json TEXT NOT NULL DEFAULT '[]',
+    started_at TEXT,
+    ended_at TEXT,
+    UNIQUE (run_id, seq)
+  );
+  CREATE INDEX IF NOT EXISTS idx_ai_team_steps_session ON ai_team_steps(session_id, status);
 `;
+/** AI 团队表的后加列；只加不删，历史行取默认值。 */
+function ensureAiTeamSchema(db) {
+    const teamColumns = new Set(db.prepare("PRAGMA table_info(ai_teams)").all().map((column) => column.name));
+    if (!teamColumns.has("instructions"))
+        db.exec("ALTER TABLE ai_teams ADD COLUMN instructions TEXT NOT NULL DEFAULT ''");
+    const stepColumns = new Set(db.prepare("PRAGMA table_info(ai_team_steps)").all().map((column) => column.name));
+    if (!stepColumns.has("depends_on_json"))
+        db.exec("ALTER TABLE ai_team_steps ADD COLUMN depends_on_json TEXT NOT NULL DEFAULT '[]'");
+    const runColumns = new Set(db.prepare("PRAGMA table_info(ai_team_runs)").all().map((column) => column.name));
+    if (!runColumns.has("chat_session_id"))
+        db.exec("ALTER TABLE ai_team_runs ADD COLUMN chat_session_id TEXT");
+    if (!runColumns.has("pending_notes_json"))
+        db.exec("ALTER TABLE ai_team_runs ADD COLUMN pending_notes_json TEXT NOT NULL DEFAULT '[]'");
+    // v2 多候选降级：步骤实际候选与跳过记录（StepDispatchInfo）、run 级状态（黑名单等）。只加列，旧行取默认 '{}'。
+    if (!stepColumns.has("dispatch_info_json"))
+        db.exec("ALTER TABLE ai_team_steps ADD COLUMN dispatch_info_json TEXT NOT NULL DEFAULT '{}'");
+    if (!runColumns.has("run_state_json"))
+        db.exec("ALTER TABLE ai_team_runs ADD COLUMN run_state_json TEXT NOT NULL DEFAULT '{}'");
+}
 function ensureWandTaskSchema(db) {
     const columns = db.prepare("PRAGMA table_info(wand_tasks)").all();
     const names = new Set(columns.map((column) => column.name));
@@ -903,6 +980,7 @@ export function ensureDatabaseFile(dbPath) {
     ensureWandTaskSchema(db);
     ensureWandMilestoneSchema(db);
     ensureIterationPromptSchema(db);
+    ensureAiTeamSchema(db);
     ensureConnectorSchema(db);
     {
         const missionColumns = db.prepare("PRAGMA table_info(missions)").all();
@@ -935,6 +1013,7 @@ export class WandStorage {
         ensureWandTaskSchema(this.db);
         ensureWandMilestoneSchema(this.db);
         ensureIterationPromptSchema(this.db);
+        ensureAiTeamSchema(this.db);
         ensureConnectorSchema(this.db);
         this.ensureDefaultPasswordVault();
     }
@@ -1197,6 +1276,22 @@ export class WandStorage {
             .all();
         return new Map(rows.map((row) => [row.id, Number(row.n) || 0]));
     }
+    /** Count user-initiated CLI launches (one per session), including archived sessions. */
+    countInteractiveSessionsByProvider() {
+        const counts = Object.fromEntries(SESSION_PROVIDERS.map((provider) => [provider, 0]));
+        const rows = this.db.prepare(`SELECT provider, runner, command, COUNT(*) AS n
+       FROM command_sessions
+       WHERE session_source = 'interactive'
+       GROUP BY provider, runner, command`).all();
+        for (const row of rows) {
+            const provider = isSessionProvider(row.provider)
+                ? row.provider
+                : inferProviderFromRunner(row.runner) ?? inferProviderFromCommand(row.command);
+            if (provider)
+                counts[provider] += Number(row.n) || 0;
+        }
+        return counts;
+    }
     /** Sessions not yet attached to a project. Omits messages/output. */
     listUnboundSessionBindings() {
         const rows = this.db
@@ -1870,6 +1965,126 @@ export class WandStorage {
     deleteExpiredAuthSessions(now) {
         this.db.prepare("DELETE FROM auth_sessions WHERE expires_at < ?").run(now);
     }
+    // ============ AI Teams ============
+    listAiTeams() {
+        const rows = this.db.prepare("SELECT * FROM ai_teams ORDER BY created_at ASC").all();
+        return rows.map(mapAiTeamRow);
+    }
+    getAiTeam(id) {
+        const row = this.db.prepare("SELECT * FROM ai_teams WHERE id = ?").get(id);
+        return row ? mapAiTeamRow(row) : null;
+    }
+    saveAiTeam(team) {
+        this.db.prepare(`INSERT INTO ai_teams (
+         id, name, description, instructions, members_json, require_plan_approval, max_steps,
+         created_at, updated_at
+       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT(id) DO UPDATE SET
+         name = excluded.name, description = excluded.description,
+         instructions = excluded.instructions,
+         members_json = excluded.members_json,
+         require_plan_approval = excluded.require_plan_approval,
+         max_steps = excluded.max_steps, updated_at = excluded.updated_at`).run(team.id, team.name, team.description, team.instructions, JSON.stringify(team.members), team.requirePlanApproval ? 1 : 0, team.maxSteps, team.createdAt, team.updatedAt);
+    }
+    /** 只删团队定义；已有运行保存了团队快照，不受影响。 */
+    deleteAiTeam(id) {
+        this.db.prepare("DELETE FROM ai_teams WHERE id = ?").run(id);
+    }
+    saveAiTeamRun(run) {
+        this.db.prepare(`INSERT INTO ai_team_runs (
+         id, team_id, task_id, team_json, objective, cwd, status, status_detail,
+         steps_used, step_limit, format_retries, plan_approved, chat_session_id, pending_notes_json,
+         created_at, updated_at
+       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT(id) DO UPDATE SET
+         team_json = excluded.team_json,
+         status = excluded.status, status_detail = excluded.status_detail,
+         steps_used = excluded.steps_used, step_limit = excluded.step_limit,
+         format_retries = excluded.format_retries, plan_approved = excluded.plan_approved,
+         chat_session_id = excluded.chat_session_id, pending_notes_json = excluded.pending_notes_json,
+         updated_at = excluded.updated_at`).run(run.id, run.teamId, run.taskId, JSON.stringify(run.team), run.objective, run.cwd, run.status, run.statusDetail, run.stepsUsed, run.stepLimit, run.formatRetries, run.planApproved ? 1 : 0, run.chatSessionId, JSON.stringify(run.pendingNotes), run.createdAt, run.updatedAt);
+    }
+    /** 群聊会话对应的最近一次运行（同一个群聊可以接着开新运行）。 */
+    getLatestAiTeamRunByChat(sessionId) {
+        const row = this.db.prepare("SELECT * FROM ai_team_runs WHERE chat_session_id = ? ORDER BY created_at DESC LIMIT 1").get(sessionId);
+        return row ? mapAiTeamRunRow(row) : null;
+    }
+    /**
+     * 会话列表用的群聊标记索引：chat_session_id → 最近一次运行的入口信息。
+     * 一次查询建整张表，供 /api/tasks 每请求一次构建；不逐会话查询。
+     */
+    listAiTeamRunChatMarkers() {
+        const rows = this.db.prepare(`SELECT id, team_json, chat_session_id FROM ai_team_runs
+       WHERE chat_session_id IS NOT NULL AND chat_session_id <> '' ORDER BY created_at DESC`).all();
+        const markers = new Map();
+        for (const row of rows) {
+            const chatSessionId = typeof row.chat_session_id === "string" ? row.chat_session_id : "";
+            if (!chatSessionId || markers.has(chatSessionId))
+                continue;
+            const rawTeam = safeJsonParse(typeof row.team_json === "string" ? row.team_json : null);
+            markers.set(chatSessionId, {
+                runId: String(row.id),
+                teamName: String(rawTeam?.name ?? ""),
+                memberCount: Array.isArray(rawTeam?.members) ? rawTeam.members.length : 0,
+            });
+        }
+        return markers;
+    }
+    getAiTeamRun(id) {
+        const row = this.db.prepare("SELECT * FROM ai_team_runs WHERE id = ?").get(id);
+        return row ? mapAiTeamRunRow(row) : null;
+    }
+    listAiTeamRuns(filter = {}) {
+        const where = [];
+        const params = [];
+        if (filter.taskId) {
+            where.push("task_id = ?");
+            params.push(filter.taskId);
+        }
+        if (filter.teamId) {
+            where.push("team_id = ?");
+            params.push(filter.teamId);
+        }
+        if (filter.statuses) {
+            if (filter.statuses.length === 0)
+                return [];
+            where.push(`status IN (${filter.statuses.map(() => "?").join(", ")})`);
+            params.push(...filter.statuses);
+        }
+        const rows = this.db.prepare(`SELECT * FROM ai_team_runs ${where.length ? `WHERE ${where.join(" AND ")}` : ""} ORDER BY created_at DESC`
+            + (filter.limit ? ` LIMIT ${Math.max(1, Math.floor(filter.limit))}` : "")).all(...params);
+        return rows.map(mapAiTeamRunRow);
+    }
+    saveAiTeamStep(step) {
+        this.db.prepare(`INSERT INTO ai_team_steps (
+         id, run_id, seq, kind, member_id, title, instructions, session_id, status,
+         report, report_path, depends_on_json, started_at, ended_at, dispatch_info_json
+       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT(id) DO UPDATE SET
+         session_id = excluded.session_id, status = excluded.status, report = excluded.report,
+         instructions = excluded.instructions,
+         depends_on_json = excluded.depends_on_json,
+         dispatch_info_json = excluded.dispatch_info_json,
+         started_at = excluded.started_at, ended_at = excluded.ended_at`).run(step.id, step.runId, step.seq, step.kind, step.memberId, step.title, step.instructions, step.sessionId, step.status, step.report, step.reportPath, JSON.stringify(step.dependsOn), step.startedAt, step.endedAt, JSON.stringify(step.dispatchInfo ?? { usedCandidate: 0, skipped: [] }));
+    }
+    listAiTeamSteps(runId) {
+        const rows = this.db.prepare("SELECT * FROM ai_team_steps WHERE run_id = ? ORDER BY seq ASC").all(runId);
+        return rows.map(mapAiTeamStepRow);
+    }
+    getRunningAiTeamStepBySession(sessionId) {
+        const row = this.db.prepare("SELECT * FROM ai_team_steps WHERE session_id = ? AND status = 'running' LIMIT 1").get(sessionId);
+        return row ? mapAiTeamStepRow(row) : null;
+    }
+    /** `ai_team_runs.run_state_json` 的读侧入口（§3.4）；脏值 / 旧行退化成空黑名单。 */
+    getAiTeamRunState(runId) {
+        const row = this.db.prepare("SELECT run_state_json FROM ai_team_runs WHERE id = ?").get(runId);
+        return parseAiTeamRunState(row?.run_state_json);
+    }
+    /** 只写 `run_state_json` 一列，不碰 `saveAiTeamRun` 负责的业务字段。 */
+    setAiTeamRunState(runId, state) {
+        this.db.prepare("UPDATE ai_team_runs SET run_state_json = ? WHERE id = ?")
+            .run(JSON.stringify(state), runId);
+    }
     // ============ Missions ============
     saveMission(mission) {
         this.db.prepare(`INSERT INTO missions (
@@ -2065,6 +2280,202 @@ export class WandStorage {
         this.db.prepare("DELETE FROM command_sessions WHERE id = ?").run(id);
     }
 }
+function mapAiTeamRow(row) {
+    return {
+        id: String(row.id),
+        name: String(row.name),
+        description: String(row.description ?? ""),
+        instructions: String(row.instructions ?? ""),
+        members: normalizeAiTeamMembers(safeJsonParse(typeof row.members_json === "string" ? row.members_json : null)),
+        requirePlanApproval: Number(row.require_plan_approval) !== 0,
+        maxSteps: Number(row.max_steps) || AI_TEAM_DEFAULT_MAX_STEPS,
+        createdAt: String(row.created_at),
+        updatedAt: String(row.updated_at),
+    };
+}
+/**
+ * 旧行读端归一（§3.1 修正 B10）：members 是从 members_json/team_json 解析出的裸 JSON，
+ * 不满足 AiTeamMember 类型，必须逐成员经 memberAgents 补齐 agents 后才能当 AiTeamMember 用。
+ * 没有任何可识别执行配置的成员行直接丢弃（旧数据必然带 agent，走到这里说明行已损坏）。
+ */
+function normalizeAiTeamMember(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const value = raw;
+    const rawAgent = parseWandTaskAgent(value.agent) ?? undefined;
+    const agents = memberAgents({
+        agent: rawAgent,
+        agents: Array.isArray(value.agents)
+            ? value.agents.map((candidate) => parseWandTaskAgent(candidate)).filter((candidate) => candidate !== null)
+            : undefined,
+    });
+    if (agents.length === 0)
+        return null;
+    const member = {
+        id: String(value.id ?? ""),
+        name: String(value.name ?? ""),
+        duty: String(value.duty ?? ""),
+        agents,
+        agent: rawAgent ?? agents[0],
+        isLeader: value.isLeader === true,
+    };
+    if (typeof value.avatar === "string" && value.avatar)
+        member.avatar = value.avatar;
+    if (isTeamMemberRole(value.role))
+        member.role = value.role;
+    return member;
+}
+function normalizeAiTeamMembers(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const members = [];
+    for (const item of raw) {
+        const member = normalizeAiTeamMember(item);
+        if (member)
+            members.push(member);
+    }
+    return members;
+}
+function mapAiTeamRunRow(row) {
+    const rawTeam = safeJsonParse(typeof row.team_json === "string" ? row.team_json : null);
+    const team = rawTeam ? {
+        id: String(rawTeam.id ?? row.team_id),
+        name: String(rawTeam.name ?? ""),
+        description: String(rawTeam.description ?? ""),
+        instructions: String(rawTeam.instructions ?? ""),
+        members: normalizeAiTeamMembers(rawTeam.members),
+        requirePlanApproval: rawTeam.requirePlanApproval === undefined ? true : rawTeam.requirePlanApproval !== false,
+        maxSteps: Number(rawTeam.maxSteps) || AI_TEAM_DEFAULT_MAX_STEPS,
+        createdAt: String(rawTeam.createdAt ?? row.created_at),
+        updatedAt: String(rawTeam.updatedAt ?? row.created_at),
+    } : null;
+    return {
+        id: String(row.id),
+        teamId: String(row.team_id),
+        team: team ?? {
+            id: String(row.team_id), name: "", description: "", instructions: "", members: [], requirePlanApproval: true,
+            maxSteps: AI_TEAM_DEFAULT_MAX_STEPS, createdAt: String(row.created_at), updatedAt: String(row.created_at),
+        },
+        taskId: String(row.task_id),
+        objective: String(row.objective),
+        cwd: String(row.cwd),
+        status: String(row.status),
+        statusDetail: String(row.status_detail ?? ""),
+        stepsUsed: Number(row.steps_used) || 0,
+        stepLimit: Number(row.step_limit) || AI_TEAM_DEFAULT_MAX_STEPS,
+        formatRetries: Number(row.format_retries) || 0,
+        planApproved: Number(row.plan_approved) !== 0,
+        chatSessionId: typeof row.chat_session_id === "string" && row.chat_session_id ? row.chat_session_id : null,
+        pendingNotes: (safeJsonParse(typeof row.pending_notes_json === "string" ? row.pending_notes_json : null) ?? [])
+            .filter((note) => typeof note === "string"),
+        createdAt: String(row.created_at),
+        updatedAt: String(row.updated_at),
+    };
+}
+/** 候选失败类别的读侧白名单；真源是 `ai-team-types.ts` 的 `CandidateFailureKind`。 */
+const CANDIDATE_FAILURE_KINDS = [
+    "spawn-missing", "host-disabled", "model-unknown", "startup-timeout",
+    "runtime-failure", "format-error", "user-stop",
+];
+function isCandidateFailureKind(value) {
+    return CANDIDATE_FAILURE_KINDS.includes(value);
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+/**
+ * `ai_team_steps.dispatch_info_json` 的读侧校验（§3.2）。脏值 / 旧行默认 `{}` 一律退化成
+ * 「首选、没跳过任何候选」，坏条目逐条丢弃，不整字段作废——降级留痕是可观测性数据，
+ * 不能因为一条脏记录把整条链丢掉。
+ */
+export function parseStepDispatchInfo(raw) {
+    const value = typeof raw === "string" ? safeJsonParse(raw) : raw;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return { usedCandidate: 0, skipped: [] };
+    const record = value;
+    const skippedRaw = Array.isArray(record.skipped) ? record.skipped : [];
+    const skipped = [];
+    for (const item of skippedRaw) {
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            continue;
+        const entry = item;
+        const agent = parseWandTaskAgent(entry.agent);
+        const candidate = Number(entry.candidate);
+        const reason = nonEmptyString(entry.reason);
+        if (!agent || !Number.isInteger(candidate) || candidate < 0 || !reason)
+            continue;
+        // 未知类别按 runtime-failure 记：它不可降级，宁可少降一级也不因为脏数据错换候选。
+        skipped.push({
+            candidate,
+            agent,
+            reason,
+            errorKind: isCandidateFailureKind(entry.errorKind) ? entry.errorKind : "runtime-failure",
+        });
+    }
+    const usedRaw = Number(record.usedCandidate);
+    const used = Number.isInteger(usedRaw) && usedRaw > 0 ? usedRaw : 0;
+    // 与留痕自相矛盾的脏值以 skipped 链为准向下纠正，绝不凭空跳级。
+    const trail = skipped.reduce((highest, item) => Math.max(highest, item.candidate), -1) + 1;
+    return { usedCandidate: skipped.length > 0 ? Math.min(used, trail) : used, skipped };
+}
+/** `ai_team_runs.run_state_json` 的读侧校验（§3.4）；脏值退化成空黑名单。 */
+export function parseAiTeamRunState(raw) {
+    const value = typeof raw === "string" ? safeJsonParse(raw) : raw;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return { providers: [], agents: [], strikes: {}, hostDisabled: [] };
+    const record = value;
+    const state = { providers: [], agents: [], strikes: {}, hostDisabled: [] };
+    for (const item of Array.isArray(record.providers) ? record.providers : []) {
+        const provider = nonEmptyString(item);
+        if (isSessionProvider(provider) && !state.providers.includes(provider))
+            state.providers.push(provider);
+    }
+    for (const item of Array.isArray(record.agents) ? record.agents : []) {
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            continue;
+        const entry = item;
+        const key = nonEmptyString(entry.key);
+        if (key && !state.agents.some((agent) => agent.key === key)) {
+            state.agents.push({ key, kind: isCandidateFailureKind(entry.kind) ? entry.kind : "runtime-failure" });
+        }
+    }
+    const strikes = record.strikes;
+    if (strikes && typeof strikes === "object" && !Array.isArray(strikes)) {
+        for (const [key, count] of Object.entries(strikes)) {
+            const value2 = Number(count);
+            if (key && Number.isFinite(value2) && value2 > 0)
+                state.strikes[key] = Math.min(999, Math.floor(value2));
+        }
+    }
+    for (const item of Array.isArray(record.hostDisabled) ? record.hostDisabled : []) {
+        const kind = nonEmptyString(item);
+        if (isWandTaskAgentKind(kind) && !state.hostDisabled.includes(kind))
+            state.hostDisabled.push(kind);
+    }
+    return state;
+}
+function mapAiTeamStepRow(row) {
+    const step = {
+        id: String(row.id),
+        runId: String(row.run_id),
+        seq: Number(row.seq),
+        kind: String(row.kind),
+        memberId: String(row.member_id),
+        title: String(row.title),
+        instructions: String(row.instructions),
+        sessionId: typeof row.session_id === "string" ? row.session_id : null,
+        status: String(row.status),
+        report: String(row.report ?? ""),
+        reportPath: String(row.report_path),
+        dependsOn: safeJsonParse(typeof row.depends_on_json === "string" ? row.depends_on_json : null) ?? [],
+        startedAt: typeof row.started_at === "string" ? row.started_at : null,
+        endedAt: typeof row.ended_at === "string" ? row.ended_at : null,
+    };
+    const dispatchInfo = parseStepDispatchInfo(typeof row.dispatch_info_json === "string" ? row.dispatch_info_json : null);
+    if (dispatchInfo.usedCandidate > 0 || dispatchInfo.skipped.length > 0)
+        step.dispatchInfo = dispatchInfo;
+    return step;
+}
 function mapMissionRow(row) {
     return {
         id: String(row.id),

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

@@ -8,6 +8,11 @@ export interface PermissionPolicy {
 }
 export declare function derivePermissionPolicy(mode: ExecutionMode, autoApprove: boolean, cwd: string): PermissionPolicy;
 export declare function buildAppendSystemPromptParts(language: string | undefined, mode: ExecutionMode): string[];
+/**
+ * 完整 append 列表：模式 / 语言指令 + 会话级系统提示（团队、自动化会话的角色与规则）。
+ * CLI 与 SDK 两条路径共用，避免只改一边。
+ */
+export declare function buildSessionSystemPromptParts(session: Pick<SessionSnapshot, "mode" | "systemPrompt">, language: string | undefined): string[];
 export interface ClaudeCliArgsOptions {
     permissionPolicy: PermissionPolicy;
     systemPromptParts?: string[];

package/dist/structured-claude-adapter.js

@@ -92,6 +92,17 @@ export function buildAppendSystemPromptParts(language, mode) {
     }
     return parts;
 }
+/**
+ * 完整 append 列表：模式 / 语言指令 + 会话级系统提示（团队、自动化会话的角色与规则）。
+ * CLI 与 SDK 两条路径共用，避免只改一边。
+ */
+export function buildSessionSystemPromptParts(session, language) {
+    const parts = buildAppendSystemPromptParts(language, session.mode);
+    const sessionPrompt = session.systemPrompt?.trim();
+    if (sessionPrompt)
+        parts.push(sessionPrompt);
+    return parts;
+}
 export function buildClaudeCliArgs(session, options) {
     const args = ["-p", "--verbose", "--output-format", "stream-json"];
     if (options.permissionPolicy.permissionMode !== "default") {
@@ -129,7 +140,7 @@ export class ClaudeCliRunner {
         const permissionPolicy = derivePermissionPolicy(context.session.mode, context.session.autoApprovePermissions ?? false, context.session.cwd);
         const args = buildClaudeCliArgs(context.session, {
             permissionPolicy,
-            systemPromptParts: buildAppendSystemPromptParts(this.options.language?.(), context.session.mode),
+            systemPromptParts: buildSessionSystemPromptParts(context.session, this.options.language?.()),
         });
         const reducer = new ClaudeCliProtocolReducer(context.session);
         let killedForQuestion = false;
@@ -179,7 +190,7 @@ export class ClaudeCliRunner {
                 signal,
                 stderr: ctx.stderr,
                 stdoutTail,
-                primaryError: null,
+                primaryError: reducer.errorText,
                 stopReason: killedForQuestion ? "ask-user-question" : undefined,
                 spawnError,
             }),

package/dist/structured-claude-protocol.d.ts

@@ -20,6 +20,8 @@ interface ClaudeCliTurnState extends StructuredRunnerTurnState {
 export declare class ClaudeCliProtocolReducer {
     readonly state: ClaudeCliTurnState;
     askUserQuestionDetected: boolean;
+    /** result 事件带 is_error 时的说明（如「API Error: 503 …」），作为这一轮的主错误。 */
+    errorText: string | null;
     private readonly blocksByKey;
     private readonly keyOrder;
     private readonly taskMetaRegistry;

package/dist/structured-claude-protocol.js

@@ -121,6 +121,8 @@ export function extractClaudeAssistantMessage(message) {
 export class ClaudeCliProtocolReducer {
     state;
     askUserQuestionDetected = false;
+    /** result 事件带 is_error 时的说明（如「API Error: 503 …」），作为这一轮的主错误。 */
+    errorText = null;
     blocksByKey = new Map();
     keyOrder = [];
     taskMetaRegistry = new Map();
@@ -186,6 +188,8 @@ export class ClaudeCliProtocolReducer {
         if (event.type === "result") {
             if (typeof event.result === "string")
                 this.state.result = event.result.trim();
+            if (event.is_error === true && this.state.result)
+                this.errorText = this.state.result;
             this.state.model = extractClaudeModelName(event.modelUsage && typeof event.modelUsage === "object"
                 ? event.modelUsage
                 : undefined) ?? this.state.model;

package/dist/structured-codex-adapter.js

@@ -2,7 +2,7 @@ import { spawn } from "node:child_process";
 import { startStructuredCli } from "./structured-exec-pump.js";
 import { CodexProtocolReducer } from "./structured-codex-protocol.js";
 import { whichSync } from "./path-repair.js";
-import { thinkingEffortToCodexReasoningEffort } from "./structured-provider-common.js";
+import { thinkingEffortToCodexReasoningEffort, promptWithSystemFallback } from "./structured-provider-common.js";
 /** Build the stable CLI contract for a structured Codex turn. */
 export function buildCodexArgs(session) {
     const args = ["exec", "--json", "--color", "never"];
@@ -49,7 +49,7 @@ export class CodexRunner {
             args,
             cwd: context.session.cwd,
             env: context.env,
-            stdinData: context.prompt,
+            stdinData: promptWithSystemFallback(context.session, context.prompt),
             observer,
             execHost: this.execHost,
             spawnProcess: this.spawnProcess,

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 { thinkingEffortToGrokEffort } from "./structured-provider-common.js";
+import { systemPromptArgs, thinkingEffortToGrokEffort } from "./structured-provider-common.js";
 function grokText(value) {
     if (typeof value === "string")
         return value;
@@ -147,6 +147,7 @@ export function buildGrokArgs(session, prompt) {
     }
     if (session.claudeSessionId)
         args.push("--resume", session.claudeSessionId);
+    args.push(...systemPromptArgs(session));
     return args;
 }
 /** Apply one official Grok Build `streaming-json` event. */

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 { thinkingEffortToOpenCodeVariant } from "./structured-provider-common.js";
+import { thinkingEffortToOpenCodeVariant, promptWithSystemFallback } from "./structured-provider-common.js";
 function extractStructuredText(value) {
     if (typeof value === "string")
         return value;
@@ -135,7 +135,7 @@ export class OpenCodeRunner {
             args,
             cwd: context.session.cwd,
             env: context.env,
-            stdinData: context.prompt,
+            stdinData: promptWithSystemFallback(context.session, context.prompt),
             observer,
             execHost: this.execHost,
             spawnProcess: this.spawnProcess,

package/dist/structured-pi-adapter.js

@@ -1,7 +1,7 @@
 import { spawn } from "node:child_process";
 import { startStructuredCli } from "./structured-exec-pump.js";
 import { asRecord, normalizeStructuredToolResultContent } from "./structured-content.js";
-import { thinkingEffortToPiLevel } from "./structured-provider-common.js";
+import { systemPromptArgs, thinkingEffortToPiLevel } from "./structured-provider-common.js";
 export function isMissingPiSession(error, sessionId) {
     return !!sessionId && !!error?.includes(`No session found matching '${sessionId}'`);
 }
@@ -41,6 +41,7 @@ export function buildPiArgs(session, prompt) {
     const thinking = thinkingEffortToPiLevel(session.thinkingEffort);
     if (thinking)
         args.push("--thinking", thinking);
+    args.push(...systemPromptArgs(session));
     if (session.claudeSessionId)
         args.push("--session", session.claudeSessionId);
     args.push(prompt);

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

@@ -1,4 +1,21 @@
 import type { SessionProvider, SessionRunner, SessionSnapshot, StructuredSessionState, WandConfig } from "./types.js";
+/**
+ * 把会话级系统提示交给 CLI 的开关。Claude / Qoder / Pi 用 `--append-system-prompt`，
+ * Grok 用 `--rules`；Codex / OpenCode 没有这个入口，只能退回并入本轮消息。
+ * 各 provider 的支持情况由 `--help` 实测得出，新增 provider 前先验。
+ */
+export declare function systemPromptFlag(provider: SessionProvider | null | undefined): string | null;
+/** 结构化 runner 的 args：provider 支持时把系统提示当成独立参数传。 */
+export declare function systemPromptArgs(session: Pick<SessionSnapshot, "provider" | "systemPrompt">): string[];
+/**
+ * provider 没有系统提示通道时的兜底：把它放在本会话第一条消息最前面，并写明它不是用户输入。
+ * 只在首轮拼一次：后续轮次的消息已经接在有它的对话历史后面。有通道的 provider 不会走这里。
+ */
+export declare function promptWithSystemFallback(session: Pick<SessionSnapshot, "provider" | "systemPrompt" | "messages">, prompt: string): string;
+/** provider 没有系统提示通道时的并接格式：明确标出这不是用户输入。 */
+export declare function composeSystemFallback(systemPrompt: string, prompt: string): string;
+/** 把系统提示接到 CLI 命令上（provider 支持时）；不支持时原样返回，由调用方并进首条输入。 */
+export declare function commandWithSystemPrompt(command: string, provider: SessionProvider | null | undefined, systemPrompt: string | null | undefined): string;
 /** 判断任意值是否为合法的 thinking effort（旧四档，或 `provider:level`）。 */
 export declare function isThinkingEffort(value: unknown): value is NonNullable<SessionSnapshot["thinkingEffort"]>;
 /** 只取本 provider 的原生档位。别的 CLI 的前缀不能串过去。 */