@co0ontty/wand 4.79.0 → 4.80.0

package/dist/silicon-employee-draft.js

@@ -0,0 +1,146 @@
+import { callConfiguredAiText } from "./git-quick-commit.js";
+import { employeeCliAvailable } from "./silicon-employee-dispatch.js";
+import { SESSION_PROVIDERS, isSessionProvider } from "./session-provider.js";
+import { DEFAULT_WAND_TASK_AGENT_KIND, DEFAULT_WAND_TASK_AGENT_MODE, normalizeWandTaskAgentMode, } from "./task-types.js";
+import { clipAtWordBoundary } from "./text-utils.js";
+export class SiliconEmployeeDraftError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "SiliconEmployeeDraftError";
+    }
+}
+const NAME_MAX = 40;
+const DUTY_MAX = 200;
+const PROMPT_MAX = 20_000;
+const EXPECTATION_MAX = 4_000;
+/** 只用于提示词的 CLI 人话名；执行候选本身仍用 provider id。 */
+const PROVIDER_LABELS = {
+    claude: "Claude Code",
+    codex: "OpenAI Codex CLI",
+    opencode: "OpenCode CLI",
+    grok: "Grok Build CLI",
+    qoder: "Qoder CLI",
+    pi: "Pi coding agent",
+    gemini: "Gemini CLI",
+};
+/** 硅基员工只能跑结构化会话；候选沿用看板的「跟随服务端默认」。 */
+export function employeeAgentFor(provider) {
+    return {
+        provider,
+        model: "default",
+        thinkingEffort: "off",
+        mode: normalizeWandTaskAgentMode(provider, DEFAULT_WAND_TASK_AGENT_MODE),
+        kind: DEFAULT_WAND_TASK_AGENT_KIND,
+    };
+}
+/**
+ * 已安装的 CLI：默认 provider 优先，其余按全局顺序；
+ * 都没装时返回空数组，由调用方决定退回到哪一个首选。
+ */
+export function availableEmployeeProviders(preferred = "claude", isAvailable = employeeCliAvailable) {
+    const order = [preferred, ...SESSION_PROVIDERS];
+    const seen = new Set();
+    const available = [];
+    for (const provider of order) {
+        if (seen.has(provider))
+            continue;
+        seen.add(provider);
+        if (isAvailable(employeeAgentFor(provider)))
+            available.push(provider);
+    }
+    return available;
+}
+function stripFences(raw) {
+    return raw.trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/i, "").trim();
+}
+/** 从模型输出里取第一个 JSON 对象，容忍前后夹带解释文字。 */
+export function extractDraftJson(raw) {
+    const text = stripFences(raw);
+    const start = text.indexOf("{");
+    const end = text.lastIndexOf("}");
+    if (start < 0 || end <= start) {
+        throw new SiliconEmployeeDraftError("AI 没有返回可用的员工配置，请换个说法再试。", "DRAFT_INVALID_JSON");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text.slice(start, end + 1));
+    }
+    catch {
+        throw new SiliconEmployeeDraftError("AI 返回的员工配置无法解析，请重试。", "DRAFT_INVALID_JSON");
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new SiliconEmployeeDraftError("AI 返回的员工配置无法解析，请重试。", "DRAFT_INVALID_JSON");
+    }
+    return parsed;
+}
+function oneLine(record, key) {
+    const value = record[key];
+    return typeof value === "string" ? value.replace(/\s+/g, " ").trim() : "";
+}
+/**
+ * 校验并收敛模型输出。名字 / 角色设定缺失即视为不可用；
+ * provider 不在已安装清单里时按候选顺序兜底，不让员工带着跑不起来的 CLI 落库。
+ */
+export function parseSiliconEmployeeDraft(raw, options = {}) {
+    const record = extractDraftJson(raw);
+    const name = clipAtWordBoundary(oneLine(record, "name"), NAME_MAX);
+    if (!name)
+        throw new SiliconEmployeeDraftError("AI 没有给出员工名字，请重试。", "DRAFT_MISSING_NAME");
+    const duty = clipAtWordBoundary(oneLine(record, "duty"), DUTY_MAX);
+    const prompt = typeof record.prompt === "string" ? record.prompt.trim().slice(0, PROMPT_MAX) : "";
+    if (!prompt)
+        throw new SiliconEmployeeDraftError("AI 没有给出员工角色设定，请重试。", "DRAFT_MISSING_PROMPT");
+    const allowed = options.allowedProviders?.length ? options.allowedProviders : [...SESSION_PROVIDERS];
+    const requested = oneLine(record, "provider").toLowerCase();
+    const provider = isSessionProvider(requested) && allowed.includes(requested)
+        ? requested
+        : options.fallbackProvider && allowed.includes(options.fallbackProvider)
+            ? options.fallbackProvider
+            : allowed[0];
+    return { name, duty, prompt, agent: employeeAgentFor(provider) };
+}
+/** 规则走系统提示，用户的期望走用户消息；一次性调用沿用系统 AI 通道。 */
+export function buildEmployeeDraftPrompt(expectation, providers, existingNames = []) {
+    const list = providers.length ? providers : [...SESSION_PROVIDERS];
+    const lines = [
+        "你正在帮用户创建一位「硅基员工」：一个长期负责某类工作的 AI 角色，之后会以结构化会话执行任务。",
+        "根据用户对这位员工的期望，设计一份配置，只输出一个 JSON 对象（不要 Markdown 代码块，不要任何解释）：",
+        '{"name":"员工名字","duty":"一句话职责","prompt":"角色设定","provider":"执行工具"}',
+        "",
+        "字段要求：",
+        "- name：2-8 个中文，具体、好记、体现职能（如「前端小匠」「接口守夜人」）；不要「助手」「AI」这类空泛词，不要带标点。",
+        "- duty：一句话职责，15-40 个字，说清它负责什么、交付什么，会显示在侧栏和消息署名里。",
+        "- prompt：角色设定（系统提示），用第二人称「你」写给这位员工，分点写清专业能力、工作要求、交付标准与协作习惯，300-600 字；不要复述用户原话，不要写具体项目或文件名。",
+        `- provider：执行工具，只能取 ${list.map((provider) => `"${provider}"（${PROVIDER_LABELS[provider]}）`).join("、")} 之一，挑最适合这项工作的。`,
+    ];
+    if (existingNames.length) {
+        lines.push(`- 不要与已有员工重名：${existingNames.slice(0, 20).join("、")}。`);
+    }
+    return { system: lines.join("\n"), prompt: `用户对这位员工的期望：\n${expectation}` };
+}
+/** 按自然语言期望生成员工配置；调用方负责随后落库。 */
+export async function generateSiliconEmployeeDraft(expectation, ai = {}, options = {}) {
+    const trimmed = expectation.trim();
+    if (!trimmed) {
+        throw new SiliconEmployeeDraftError("先说说你对这位员工的期望吧。", "EMPTY_EXPECTATION");
+    }
+    if (trimmed.length > EXPECTATION_MAX) {
+        throw new SiliconEmployeeDraftError(`期望描述太长了（${trimmed.length} 字），请精简到 ${EXPECTATION_MAX} 字以内。`, "EXPECTATION_TOO_LONG");
+    }
+    const available = availableEmployeeProviders(options.preferredProvider, options.isProviderAvailable);
+    const providers = available.length ? available : [options.preferredProvider ?? "claude", ...SESSION_PROVIDERS];
+    const request = buildEmployeeDraftPrompt(trimmed, providers, options.existingNames);
+    let raw;
+    try {
+        raw = await callConfiguredAiText(request, options.cwd || process.cwd(), options.language ?? "", ai);
+    }
+    catch (error) {
+        if (error instanceof SiliconEmployeeDraftError)
+            throw error;
+        const message = error instanceof Error ? error.message : String(error);
+        throw new SiliconEmployeeDraftError(message || "AI 生成员工配置失败。", "DRAFT_AI_FAILED");
+    }
+    return parseSiliconEmployeeDraft(raw, { allowedProviders: providers, fallbackProvider: providers[0] });
+}

package/dist/storage.d.ts

@@ -1,6 +1,7 @@
 import { SessionSnapshot, ConversationTurn, SessionProvider, StructuredSessionState, Workspace, LayoutNode, TaskWindowLayout, WorkspaceDefaultProvider, WorkspaceKind, WorkspaceTask, WorkspaceTaskWorktree, WorkspaceTaskStatus } from "./types.js";
-import type { AiTeam, AiTeamRun, AiTeamRunChatMarker, AiTeamRunStatus, AiTeamStep, AiTeamStepSessionMarker, CandidateFailureKind, StepDispatchInfo } from "./ai-team-types.js";
+import type { AiTeam, AiTeamRun, AiTeamRunChatMarker, AiTeamRunStatus, AiTeamStep, AiTeamStepSessionMarker, CandidateFailureKind, SiliconEmployee, StepDispatchInfo } from "./ai-team-types.js";
 import type { WandTask, WandTaskAgent, WandTaskAgentKind, WandTaskTitleSource } from "./task-types.js";
+import { type SystemEmployeeSeed } from "./system-employee.js";
 import type { AgentActivityItem, Mission, MissionAttempt, MissionReviewComment, MissionReviewStatus, MissionStatus } from "./mission-types.js";
 import { type PasswordVault, type PasswordVaultItem, type PasswordVaultItemFilter, type PasswordVaultItemInput } from "./password-manager.js";
 /** `ai_team_runs.run_state_json`：本次运行的候选黑名单（§3.4 修正 B12 两层键值 + host-disabled）。 */
@@ -55,8 +56,9 @@ interface CreateWandTaskInput {
     dueDate?: string | null;
     milestoneId?: string | null;
     agent?: WandTaskAgent | null;
+    executionSubject?: WandTask["executionSubject"];
 }
-type WandTaskPatch = Partial<Pick<WandTask, "workspaceId" | "workspaceTaskId" | "parentTaskId" | "title" | "titleSource" | "autoTitleSignature" | "description" | "status" | "priority" | "labels" | "dueDate" | "milestoneId" | "sortOrder" | "agent">>;
+type WandTaskPatch = Partial<Pick<WandTask, "workspaceId" | "workspaceTaskId" | "parentTaskId" | "title" | "titleSource" | "autoTitleSignature" | "description" | "status" | "priority" | "labels" | "dueDate" | "milestoneId" | "sortOrder" | "agent" | "executionSubject">>;
 export declare class WandStorage {
     private readonly db;
     private readonly dbPath;
@@ -310,6 +312,21 @@ export declare class WandStorage {
     deleteAuthSession(token: string): void;
     deleteAllAuthSessions(): void;
     deleteExpiredAuthSessions(now: number): void;
+    listSiliconEmployees(options?: {
+        includeArchived?: boolean;
+    }): SiliconEmployee[];
+    getSiliconEmployee(id: string): SiliconEmployee | null;
+    /** 内置「系统运维」员工；未创建（或被删除过）时返回 null。 */
+    getSystemSiliconEmployee(key?: string): SiliconEmployee | null;
+    /**
+     * 幂等地保证内置员工存在。已存在时只补齐锁定字段（防止旧的同名定义漂移），
+     * 候选保留用户当下的设置；不存在时按 seed 建首条候选。
+     */
+    ensureSystemSiliconEmployee(seed?: SystemEmployeeSeed): SiliconEmployee;
+    saveSiliconEmployee(employee: SiliconEmployee): void;
+    archiveSiliconEmployee(id: string, archivedAt?: string): void;
+    unarchiveSiliconEmployee(id: string): void;
+    deleteSiliconEmployee(id: string): void;
     listAiTeams(): AiTeam[];
     getAiTeam(id: string): AiTeam | null;
     saveAiTeam(team: AiTeam): void;

package/dist/storage.js

@@ -9,6 +9,8 @@ import { DEFAULT_ITERATION_NAME, DEFAULT_WAND_TASK_AGENT_KIND, DEFAULT_WAND_TASK
 import { firstLayoutTabId } from "./layout-tree.js";
 import { isUnnamedWorkspaceTaskName } from "./wand-task-sync.js";
 import { AI_TEAM_DEFAULT_MAX_STEPS, AI_TEAM_TERMINAL_RUN_STATUSES, isTeamMemberRole, memberAgents } from "./ai-team-types.js";
+import { isTaskExecutionSubject } from "./task-types.js";
+import { SYSTEM_EMPLOYEE_KEY, systemEmployeeDefinition, systemEmployeeSeedAgents, } from "./system-employee.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) {
@@ -40,7 +42,7 @@ export function parseWandTaskAgent(raw) {
         return null;
     if (typeof model !== "string" || !model.trim() || model.trim().length > 128)
         return null;
-    if (thinkingEffort !== "off" && thinkingEffort !== "standard" && thinkingEffort !== "deep" && thinkingEffort !== "max")
+    if (!isThinkingEffort(thinkingEffort))
         return null;
     // mode 是后加列：历史行没有该字段时按标准模式读取，不因此整条配置退化成 null。
     const mode = normalizeWandTaskAgentMode(provider, value.mode);
@@ -177,6 +179,11 @@ function serializeSessionOptions(snapshot) {
         currentTaskTitle: snapshot.currentTaskTitle,
         summary: snapshot.summary,
         systemPrompt: snapshot.systemPrompt,
+        employeeId: snapshot.employeeId,
+        employeeName: snapshot.employeeName,
+        employeeAvatar: snapshot.employeeAvatar,
+        employeeCandidates: snapshot.employeeCandidates,
+        employeeCandidateIndex: snapshot.employeeCandidateIndex,
     };
     return JSON.stringify(options);
 }
@@ -240,6 +247,20 @@ function parseSessionOptions(raw) {
         options.summary = parsed.summary;
     if (typeof parsed.systemPrompt === "string")
         options.systemPrompt = parsed.systemPrompt;
+    if (typeof parsed.employeeId === "string")
+        options.employeeId = parsed.employeeId;
+    if (typeof parsed.employeeName === "string")
+        options.employeeName = parsed.employeeName;
+    if (typeof parsed.employeeAvatar === "string")
+        options.employeeAvatar = parsed.employeeAvatar;
+    if (Array.isArray(parsed.employeeCandidates)) {
+        options.employeeCandidates = parsed.employeeCandidates
+            .map(parseWandTaskAgent)
+            .filter((agent) => agent?.kind === "structured");
+    }
+    if (Number.isSafeInteger(parsed.employeeCandidateIndex) && parsed.employeeCandidateIndex >= 0) {
+        options.employeeCandidateIndex = parsed.employeeCandidateIndex;
+    }
     return options;
 }
 function parseQueuedMessages(raw) {
@@ -763,6 +784,7 @@ const INIT_SQL = `
     milestone_id TEXT,
     sort_order INTEGER NOT NULL DEFAULT 0,
     agent_json TEXT,
+    execution_subject_json TEXT,
     workspace_task_id TEXT,
     parent_task_id TEXT,
     title_source TEXT,
@@ -794,6 +816,21 @@ const INIT_SQL = `
     updated_at TEXT NOT NULL
   );
 
+  CREATE TABLE IF NOT EXISTS silicon_employees (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    duty TEXT NOT NULL DEFAULT '',
+    prompt TEXT NOT NULL DEFAULT '',
+    avatar TEXT NOT NULL DEFAULT '',
+    agents_json TEXT NOT NULL,
+    system_key TEXT,
+    archived_at TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+  CREATE INDEX IF NOT EXISTS idx_silicon_employees_archived ON silicon_employees(archived_at);
+
+
   CREATE TABLE IF NOT EXISTS ai_team_runs (
     id TEXT PRIMARY KEY,
     team_id TEXT NOT NULL,
@@ -850,6 +887,27 @@ function ensureAiTeamSchema(db) {
         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 '{}'");
+    // 硅基员工表结构保护（遵循只加不删）
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS silicon_employees (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      duty TEXT NOT NULL DEFAULT '',
+      prompt TEXT NOT NULL DEFAULT '',
+      avatar TEXT NOT NULL DEFAULT '',
+      agents_json TEXT NOT NULL,
+      system_key TEXT,
+      archived_at TEXT,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_silicon_employees_archived ON silicon_employees(archived_at);
+  `);
+    // 内置员工标记（如 "wand-ops"）：只加列，用户员工保持 NULL。
+    const employeeColumns = new Set(db.prepare("PRAGMA table_info(silicon_employees)").all().map((column) => column.name));
+    if (employeeColumns.size > 0 && !employeeColumns.has("system_key")) {
+        db.exec("ALTER TABLE silicon_employees ADD COLUMN system_key TEXT");
+    }
 }
 function ensureWandTaskSchema(db) {
     const columns = db.prepare("PRAGMA table_info(wand_tasks)").all();
@@ -861,6 +919,8 @@ function ensureWandTaskSchema(db) {
     // 任务的默认派发配置（CLI 工具 / 模型 / 思考深度）。只加列，历史行保持 NULL。
     if (columns.length > 0 && !names.has("agent_json"))
         db.exec("ALTER TABLE wand_tasks ADD COLUMN agent_json TEXT");
+    if (columns.length > 0 && !names.has("execution_subject_json"))
+        db.exec("ALTER TABLE wand_tasks ADD COLUMN execution_subject_json TEXT");
     if (columns.length > 0 && !names.has("workspace_task_id"))
         db.exec("ALTER TABLE wand_tasks ADD COLUMN workspace_task_id TEXT");
     // 父任务归属只加列；历史任务仍然是顶层任务。
@@ -999,7 +1059,7 @@ export function ensureDatabaseFile(dbPath) {
 }
 const WAND_TASK_FIELDS = `id, identifier, workspace_id, workspace_task_id, parent_task_id,
   title, title_source, auto_title_signature, description, status, priority, labels_json,
-  due_date, milestone_id, sort_order, agent_json, created_at, updated_at`;
+  due_date, milestone_id, sort_order, agent_json, execution_subject_json, created_at, updated_at`;
 // Shared metadata comes from the latest explicitly linked card, including meaningful NULLs.
 // The old container columns remain readable for legacy rows until the startup migration.
 const WORKSPACE_TASK_PROJECTION = `SELECT wt.id,
@@ -1530,6 +1590,10 @@ export class WandStorage {
             milestoneId: typeof row.milestone_id === "string" && row.milestone_id ? row.milestone_id : null,
             sortOrder: Number(row.sort_order) || 0,
             agent: parseWandTaskAgent(row.agent_json),
+            executionSubject: (() => {
+                const parsed = safeJsonParse(typeof row.execution_subject_json === "string" ? row.execution_subject_json : null);
+                return isTaskExecutionSubject(parsed) ? parsed : null;
+            })(),
             createdAt: String(row.created_at),
             updatedAt: String(row.updated_at),
         };
@@ -1553,8 +1617,8 @@ export class WandStorage {
         const number = this.db.prepare(`SELECT COALESCE(MAX(CAST(substr(identifier, 6) AS INTEGER)), 0) AS value
       FROM wand_tasks WHERE identifier GLOB 'TASK-[0-9]*'`).get();
         this.db.prepare(`INSERT INTO wand_tasks (${WAND_TASK_FIELDS})
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
-            .run(id, `TASK-${number.value + 1}`, input.workspaceId ?? null, input.workspaceTaskId ?? null, input.parentTaskId ?? null, input.title, input.titleSource ?? "user", null, input.description ?? "", status, input.priority ?? DEFAULT_WAND_TASK_PRIORITY, JSON.stringify(input.labels ?? []), input.dueDate ?? null, input.milestoneId ?? null, max.value + 1, input.agent ? JSON.stringify(input.agent) : null, createdAt, createdAt);
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(id, `TASK-${number.value + 1}`, input.workspaceId ?? null, input.workspaceTaskId ?? null, input.parentTaskId ?? null, input.title, input.titleSource ?? "user", null, input.description ?? "", status, input.priority ?? DEFAULT_WAND_TASK_PRIORITY, JSON.stringify(input.labels ?? []), input.dueDate ?? null, input.milestoneId ?? null, max.value + 1, input.agent ? JSON.stringify(input.agent) : null, input.executionSubject ? JSON.stringify(input.executionSubject) : null, createdAt, createdAt);
         return this.getWandTask(id);
     }
     createWandTask(input) {
@@ -1601,9 +1665,9 @@ export class WandStorage {
         }
         this.db.prepare(`UPDATE wand_tasks SET workspace_id = ?, workspace_task_id = ?, parent_task_id = ?,
       title = ?, title_source = ?, auto_title_signature = ?, description = ?, status = ?, priority = ?,
-      labels_json = ?, due_date = ?, milestone_id = ?, sort_order = ?, agent_json = ?, updated_at = ?
+      labels_json = ?, due_date = ?, milestone_id = ?, sort_order = ?, agent_json = ?, execution_subject_json = ?, updated_at = ?
       WHERE id = ?`)
-            .run(next.workspaceId, next.workspaceTaskId, next.parentTaskId, next.title, next.titleSource, next.autoTitleSignature ?? null, next.description, next.status, next.priority, JSON.stringify(next.labels), next.dueDate, next.milestoneId ?? null, next.sortOrder, next.agent ? JSON.stringify(next.agent) : null, next.updatedAt, next.id);
+            .run(next.workspaceId, next.workspaceTaskId, next.parentTaskId, next.title, next.titleSource, next.autoTitleSignature ?? null, next.description, next.status, next.priority, JSON.stringify(next.labels), next.dueDate, next.milestoneId ?? null, next.sortOrder, next.agent ? JSON.stringify(next.agent) : null, next.executionSubject ? JSON.stringify(next.executionSubject) : null, next.updatedAt, next.id);
         if (patch.workspaceId !== undefined && next.workspaceTaskId) {
             const workspaceId = next.workspaceId ?? this.ensureGlobalWorkspace().id;
             // The container FK/index and standalone session workspace bucket follow the canonical project.
@@ -2252,6 +2316,71 @@ export class WandStorage {
     deleteExpiredAuthSessions(now) {
         this.db.prepare("DELETE FROM auth_sessions WHERE expires_at < ?").run(now);
     }
+    // ============ Silicon Employees ============
+    listSiliconEmployees(options) {
+        const includeArchived = options?.includeArchived ?? false;
+        // 内置员工（system_key 非空）始终排在最前，其余按创建时间。
+        const sql = includeArchived
+            ? "SELECT * FROM silicon_employees ORDER BY (system_key IS NULL), created_at ASC"
+            : "SELECT * FROM silicon_employees WHERE archived_at IS NULL ORDER BY (system_key IS NULL), created_at ASC";
+        const rows = this.db.prepare(sql).all();
+        return rows.map(mapSiliconEmployeeRow);
+    }
+    getSiliconEmployee(id) {
+        const row = this.db.prepare("SELECT * FROM silicon_employees WHERE id = ?").get(id);
+        return row ? mapSiliconEmployeeRow(row) : null;
+    }
+    /** 内置「系统运维」员工；未创建（或被删除过）时返回 null。 */
+    getSystemSiliconEmployee(key = SYSTEM_EMPLOYEE_KEY) {
+        const row = this.db.prepare("SELECT * FROM silicon_employees WHERE system_key = ?").get(key);
+        return row ? mapSiliconEmployeeRow(row) : null;
+    }
+    /**
+     * 幂等地保证内置员工存在。已存在时只补齐锁定字段（防止旧的同名定义漂移），
+     * 候选保留用户当下的设置；不存在时按 seed 建首条候选。
+     */
+    ensureSystemSiliconEmployee(seed = {}) {
+        const existing = this.getSystemSiliconEmployee();
+        if (!existing) {
+            const employee = systemEmployeeDefinition(systemEmployeeSeedAgents(seed), new Date().toISOString());
+            this.saveSiliconEmployee(employee);
+            return employee;
+        }
+        const locked = systemEmployeeDefinition(existing.agents, new Date().toISOString(), existing);
+        if (existing.name !== locked.name
+            || existing.duty !== locked.duty
+            || existing.prompt !== locked.prompt
+            || existing.avatar !== locked.avatar
+            || existing.archivedAt !== undefined
+            || existing.agents.length === 0) {
+            this.saveSiliconEmployee(locked);
+            return locked;
+        }
+        return existing;
+    }
+    saveSiliconEmployee(employee) {
+        this.db.prepare(`INSERT INTO silicon_employees (
+         id, name, duty, prompt, avatar, agents_json, system_key, archived_at, created_at, updated_at
+       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT(id) DO UPDATE SET
+         name = excluded.name,
+         duty = excluded.duty,
+         prompt = excluded.prompt,
+         avatar = excluded.avatar,
+         agents_json = excluded.agents_json,
+         system_key = excluded.system_key,
+         archived_at = excluded.archived_at,
+         updated_at = excluded.updated_at`).run(employee.id, employee.name, employee.duty, employee.prompt, employee.avatar, JSON.stringify(employee.agents), employee.systemKey ?? null, employee.archivedAt ?? null, employee.createdAt, employee.updatedAt);
+    }
+    archiveSiliconEmployee(id, archivedAt = new Date().toISOString()) {
+        this.db.prepare("UPDATE silicon_employees SET archived_at = ?, updated_at = ? WHERE id = ?").run(archivedAt, new Date().toISOString(), id);
+    }
+    unarchiveSiliconEmployee(id) {
+        this.db.prepare("UPDATE silicon_employees SET archived_at = NULL, updated_at = ? WHERE id = ?").run(new Date().toISOString(), id);
+    }
+    deleteSiliconEmployee(id) {
+        this.db.prepare("DELETE FROM silicon_employees WHERE id = ?").run(id);
+    }
     // ============ AI Teams ============
     listAiTeams() {
         const rows = this.db.prepare("SELECT * FROM ai_teams ORDER BY created_at ASC").all();
@@ -2301,7 +2430,7 @@ export class WandStorage {
      * 一次查询建整张表，供 /api/tasks 每请求一次构建；不逐会话查询。
      */
     listAiTeamRunChatMarkers() {
-        const rows = this.db.prepare(`SELECT r.id, r.team_json, r.chat_session_id, t.name AS current_team_name
+        const rows = this.db.prepare(`SELECT r.id, r.team_id, r.team_json, r.chat_session_id, t.name AS current_team_name
        FROM ai_team_runs r LEFT JOIN ai_teams t ON t.id = r.team_id
        WHERE r.chat_session_id IS NOT NULL AND r.chat_session_id <> '' ORDER BY r.created_at DESC`).all();
         const markers = new Map();
@@ -2312,6 +2441,7 @@ export class WandStorage {
             const rawTeam = safeJsonParse(typeof row.team_json === "string" ? row.team_json : null);
             markers.set(chatSessionId, {
                 runId: String(row.id),
+                teamId: String(row.team_id),
                 teamName: typeof row.current_team_name === "string" ? row.current_team_name : String(rawTeam?.name ?? ""),
                 memberCount: Array.isArray(rawTeam?.members) ? rawTeam.members.length : 0,
             });
@@ -2624,6 +2754,27 @@ export class WandStorage {
         this.db.prepare("DELETE FROM command_sessions WHERE id = ?").run(id);
     }
 }
+function mapSiliconEmployeeRow(row) {
+    const rawAgents = safeJsonParse(typeof row.agents_json === "string" ? row.agents_json : null);
+    const agents = Array.isArray(rawAgents)
+        ? rawAgents
+            .map((candidate) => parseWandTaskAgent(candidate))
+            .filter((candidate) => candidate !== null)
+        : [];
+    const systemKey = typeof row.system_key === "string" && row.system_key ? row.system_key : undefined;
+    return {
+        id: String(row.id),
+        name: String(row.name),
+        duty: String(row.duty ?? ""),
+        prompt: String(row.prompt ?? ""),
+        avatar: String(row.avatar ?? ""),
+        agents,
+        systemKey,
+        archivedAt: typeof row.archived_at === "string" && row.archived_at ? row.archived_at : undefined,
+        createdAt: String(row.created_at),
+        updatedAt: String(row.updated_at),
+    };
+}
 function mapAiTeamRow(row) {
     return {
         id: String(row.id),

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

@@ -0,0 +1,40 @@
+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;
+}