@co0ontty/wand 4.79.0 → 4.80.0

package/dist/server-task-routes.js

@@ -1,4 +1,4 @@
-import { dispatchAgentForTask } from "./agent-dispatch.js";
+import { dispatchAgentForTask, resolveTaskDispatchTarget } from "./agent-dispatch.js";
 import { asyncRoute } from "./express-async.js";
 import { getErrorMessage } from "./error-utils.js";
 import { bodyObject, sendRouteError, text } from "./server-request.js";
@@ -7,6 +7,8 @@ import { defaultMilestoneIdForWrite, resolvedMilestoneFields, scopedMilestoneId
 import { generateWandTaskTitle, provisionalTaskTitleFromDescription, TASK_TITLE_MAX_LENGTH } from "./task-title.js";
 import { recordIterationPromptForTask } from "./iteration-log.js";
 import { resolveSystemAiContext } from "./session-ai-context.js";
+import { memberAgents } from "./ai-team-types.js";
+import { selectEmployeeCandidate } from "./silicon-employee-dispatch.js";
 import { DEFAULT_WAND_TASK_AGENT_KIND, DEFAULT_WAND_TASK_AGENT_MODE, DEFAULT_WAND_TASK_PRIORITY, isWandTaskAgentKind, isWandTaskAgentMode, normalizeWandTaskAgentMode, WAND_MILESTONE_NAME_MAX_LENGTH } from "./task-types.js";
 import { isAutoNameableBoardTask, taskAutoNameSignature, taskAutoNameSourceText } from "./wand-task-sync.js";
 import { isSessionProvider } from "./session-provider.js";
@@ -38,6 +40,48 @@ export function writeTaskBoardLastAgent(storage, agent) {
         kind: agent.kind,
     });
 }
+function parseExecutionSubject(storage, value) {
+    if (value === null)
+        return null;
+    const body = bodyObject(value);
+    const type = text(body.type);
+    const id = text(body.id);
+    if (!id)
+        throw new Error("请选择执行对象。");
+    if (type === "employee") {
+        const employee = storage.getSiliconEmployee(id);
+        if (!employee || employee.archivedAt)
+            throw new Error("硅基员工不存在或已归档。");
+        return { type, id };
+    }
+    if (type === "team") {
+        if (!storage.getAiTeam(id))
+            throw new Error("AI 团队不存在。");
+        return { type, id };
+    }
+    if (type === "cli") {
+        if (!isSessionProvider(id))
+            throw new Error("请选择有效的 CLI 工具。");
+        return { type, id };
+    }
+    throw new Error("执行对象类型无效。");
+}
+function preferredAgentForSubject(storage, subject) {
+    if (subject.type === "employee")
+        return storage.getSiliconEmployee(subject.id)?.agents[0] ?? null;
+    if (subject.type === "team") {
+        const team = storage.getAiTeam(subject.id);
+        const member = team?.members.find((entry) => entry.isLeader) ?? team?.members[0];
+        return member ? memberAgents(member)[0] ?? null : null;
+    }
+    return null;
+}
+function cliAgentForSubject(subject, current) {
+    return parseTaskAgent({
+        ...(current?.provider === subject.id ? current : defaultTaskBoardAgent()),
+        provider: subject.id,
+    });
+}
 function dateValue(value) {
     if (value === undefined)
         return undefined;
@@ -178,6 +222,9 @@ function taskSessionSummary(session) {
         thinkingEffort: session.thinkingEffort || "off",
         // 会话实际跑的执行模式；旧会话没有该字段时留空，前端回落到任务上的配置。
         mode: session.mode || "",
+        employeeId: session.employeeId,
+        employeeName: session.employeeName,
+        employeeAvatar: session.employeeAvatar,
     };
 }
 /**
@@ -191,7 +238,7 @@ function scheduleWandTaskTitleGeneration(storage, taskId, source, signature, opt
     const cwd = options.cwd || options.config?.defaultCwd || process.cwd();
     const run = async () => {
         try {
-            const title = await generateTitle(source, cwd, options.config?.language ?? "", taskTitleAiOptions(options.config));
+            const title = await generateTitle(source, cwd, options.config?.language ?? "", taskTitleAiOptions(options.config, storage));
             const current = storage.getWandTask(taskId);
             // 用户已经自己写了标题（原生端 / 面板编辑）就不要覆盖。
             if (!current || current.titleSource !== "auto")
@@ -249,7 +296,7 @@ export function refreshAutoBoardTaskTitles(storage, options = {}) {
     }
 }
 /** 自动生成标题没有会话上下文，按「默认 provider + 默认模型」解析，与提示词优化一致。 */
-function taskTitleAiOptions(config) {
+function taskTitleAiOptions(config, storage) {
     if (!config)
         return {};
     const provider = config.defaultProvider ?? "claude";
@@ -261,11 +308,11 @@ function taskTitleAiOptions(config) {
         selectedModel: null,
         thinkingEffort: config.defaultThinkingEffort,
     };
-    // resolveSystemAiContext 会在直连 API 可用且已启用时优先走 API，否则回落到 CLI。
-    return resolveSystemAiContext(defaultSession, config);
+    // resolveSystemAiContext 会在直连 API 可用且已启用时优先走 API，否则走系统运维员工的 CLI 候选链。
+    return resolveSystemAiContext(defaultSession, config, storage?.getSystemSiliconEmployee() ?? null);
 }
 export function registerTaskRoutes(app, deps) {
-    const { storage, sessions, structured, processes, config } = deps;
+    const { storage, sessions, structured, processes, config, aiTeams } = deps;
     const dto = (task) => taskDto(deps, task);
     app.get("/api/wand-tasks", (req, res) => {
         try {
@@ -392,8 +439,18 @@ export function registerTaskRoutes(app, deps) {
             const status = STATUSES.has(body.status) ? body.status : "todo";
             const priority = PRIORITIES.has(body.priority) ? body.priority : DEFAULT_WAND_TASK_PRIORITY;
             const agent = body.agent === undefined ? null : parseTaskAgent(body.agent);
-            if (agent)
-                writeTaskBoardLastAgent(storage, agent);
+            const executionSubject = body.executionSubject === undefined
+                ? agent ? { type: "cli", id: agent.provider } : null
+                : parseExecutionSubject(storage, body.executionSubject);
+            if (executionSubject?.type === "cli" && agent && agent.provider !== executionSubject.id) {
+                throw new Error("CLI 执行对象与工具配置不一致。");
+            }
+            if (executionSubject?.type !== "cli" && executionSubject && agent?.kind === "pty") {
+                throw new Error("PTY 只能选择 CLI 工具。");
+            }
+            const assignedAgent = executionSubject && executionSubject.type !== "cli"
+                ? preferredAgentForSubject(storage, executionSubject)
+                : executionSubject?.type === "cli" ? agent ?? cliAgentForSubject(executionSubject) : agent;
             const labels = labelsFrom(body.labels);
             const dueDate = dateValue(body.dueDate) ?? null;
             // 没选迭代就落到默认迭代：每个任务都属于一个迭代。
@@ -411,8 +468,11 @@ export function registerTaskRoutes(app, deps) {
                 labels,
                 dueDate,
                 milestoneId,
-                agent,
+                agent: assignedAgent,
+                executionSubject,
             });
+            if (agent)
+                writeTaskBoardLastAgent(storage, agent);
             if (titleSource === "auto") {
                 refreshAutoBoardTaskTitles(storage, {
                     cwd: workspaceId ? storage.getWorkspace(workspaceId)?.cwd : undefined,
@@ -484,8 +544,24 @@ export function registerTaskRoutes(app, deps) {
             if (body.agent !== undefined) {
                 // 老客户端不传 mode / kind：沿用任务当前值，而不是复位成标准 / 结构化。
                 patch.agent = parseTaskAgent(body.agent, currentTask.agent?.mode, currentTask.agent?.kind);
-                if (patch.agent)
-                    writeTaskBoardLastAgent(storage, patch.agent);
+                if (body.executionSubject === undefined && patch.agent) {
+                    patch.executionSubject = { type: "cli", id: patch.agent.provider };
+                }
+            }
+            if (body.executionSubject !== undefined) {
+                patch.executionSubject = parseExecutionSubject(storage, body.executionSubject);
+                if (patch.executionSubject?.type === "cli" && patch.agent
+                    && patch.agent.provider !== patch.executionSubject.id) {
+                    throw new Error("CLI 执行对象与工具配置不一致。");
+                }
+                if (patch.executionSubject?.type === "cli" && !patch.agent) {
+                    patch.agent = cliAgentForSubject(patch.executionSubject, currentTask.agent);
+                }
+                if (patch.executionSubject && patch.executionSubject.type !== "cli") {
+                    if (patch.agent?.kind === "pty")
+                        throw new Error("PTY 只能选择 CLI 工具。");
+                    patch.agent = preferredAgentForSubject(storage, patch.executionSubject);
+                }
             }
             if (body.sortOrder !== undefined && Number.isFinite(Number(body.sortOrder))) {
                 patch.sortOrder = Math.floor(Number(body.sortOrder));
@@ -495,6 +571,8 @@ export function registerTaskRoutes(app, deps) {
                 res.status(404).json({ error: "未找到该任务。" });
                 return;
             }
+            if (body.agent !== undefined && patch.agent)
+                writeTaskBoardLastAgent(storage, patch.agent);
             res.json(dto(storage.getWandTask(task.id) ?? task));
         }
         catch (error) {
@@ -556,16 +634,81 @@ export function registerTaskRoutes(app, deps) {
             if (!config)
                 throw new Error("当前服务未启用派发，无法派发 Agent。");
             const body = bodyObject(req.body);
-            const agent = body.agent === undefined
-                ? task.agent ?? parseWandTaskAgent(JSON.stringify(body))
-                : parseTaskAgent(body.agent, task.agent?.mode, task.agent?.kind);
+            const subject = body.subject === undefined
+                ? body.agent !== undefined ? null : task.executionSubject ?? null
+                : parseExecutionSubject(storage, body.subject);
+            if ((subject?.type === "employee" || subject?.type === "team")
+                && (body.kind === "pty" || (body.agent && bodyObject(body.agent).kind === "pty"))) {
+                throw new Error("PTY 只能选择 CLI 工具。");
+            }
+            const requestedPrompt = text(body.prompt);
+            const existingSessions = storage.listWandTaskSessionIds(task.id).length;
+            if (existingSessions > 0 && !requestedPrompt)
+                throw new Error("请输入提示词。");
+            const prompt = requestedPrompt || task.description.trim() || task.title || "执行此任务";
+            if (subject?.type === "team") {
+                if (!aiTeams)
+                    throw new Error("当前服务未启用 AI 团队。");
+                const team = storage.getAiTeam(subject.id);
+                if (!team)
+                    throw new Error("AI 团队不存在。");
+                if (body.workspaceId !== undefined) {
+                    const workspaceId = body.workspaceId === null ? null : text(body.workspaceId) || null;
+                    if (workspaceId && !storage.getWorkspace(workspaceId))
+                        throw new Error("项目不存在。");
+                    parentTaskIdFrom(storage, task.parentTaskId, workspaceId, task.id, task.parentTaskId);
+                    if (workspaceId !== task.workspaceId)
+                        assertTaskWorkspaceMove(storage, task.id, workspaceId);
+                    task = storage.updateWandTask(task.id, { workspaceId }) ?? task;
+                }
+                const target = resolveTaskDispatchTarget({ storage, config }, task);
+                const detail = await aiTeams.start({ teamId: team.id, taskId: task.id, note: prompt });
+                const preferredMember = team.members.find((member) => member.isLeader) ?? team.members[0];
+                const preferredAgent = preferredMember ? memberAgents(preferredMember)[0] ?? null : null;
+                storage.updateWandTask(task.id, {
+                    executionSubject: subject,
+                    agent: preferredAgent,
+                    status: task.status === "todo" ? "doing" : task.status,
+                });
+                recordIterationPromptForTask(storage, {
+                    sessionId: detail.run.chatSessionId ?? undefined,
+                    cwd: target.cwd,
+                    workspaceId: target.workspaceId,
+                    milestoneId: task.milestoneId,
+                    taskId: task.id,
+                    title: task.title,
+                    detail: task.description || prompt,
+                    source: "dispatch",
+                });
+                res.status(202).json({
+                    ok: true,
+                    taskId: task.id,
+                    subject,
+                    teamRun: detail,
+                    session: detail.run.chatSessionId ? { id: detail.run.chatSessionId, sessionKind: "structured" } : null,
+                });
+                return;
+            }
+            const employee = subject?.type === "employee" ? storage.getSiliconEmployee(subject.id) : null;
+            if (subject?.type === "employee" && (!employee || employee.archivedAt)) {
+                throw new Error("硅基员工不存在或已归档。");
+            }
+            const selected = employee ? selectEmployeeCandidate(employee) : null;
+            const cliDefault = subject?.type === "cli"
+                ? parseTaskAgent({ ...cliAgentForSubject(subject, task.agent), ...(body.kind === "pty" ? { kind: "pty" } : {}) })
+                : null;
+            const agent = selected?.agent ?? (body.agent === undefined
+                ? cliDefault ?? task.agent ?? parseWandTaskAgent(JSON.stringify(body))
+                : parseTaskAgent(body.agent, task.agent?.mode, task.agent?.kind));
             if (!agent)
                 throw new Error("请先为该任务选择 CLI 工具。");
+            if (subject?.type === "cli" && agent.provider !== subject.id) {
+                throw new Error("CLI 执行对象与工具配置不一致。");
+            }
             if (agent.kind === "structured" && !structured)
                 throw new Error("当前服务未启用结构化会话，无法派发 Agent。");
             if (agent.kind === "pty" && !processes)
                 throw new Error("当前服务未启用终端会话，无法派发 Agent。");
-            writeTaskBoardLastAgent(storage, agent);
             if (body.workspaceId !== undefined) {
                 const workspaceId = body.workspaceId === null ? null : text(body.workspaceId) || null;
                 if (workspaceId && !storage.getWorkspace(workspaceId))
@@ -575,14 +718,18 @@ export function registerTaskRoutes(app, deps) {
                     assertTaskWorkspaceMove(storage, task.id, workspaceId);
                 task = storage.updateWandTask(task.id, { workspaceId }) ?? task;
             }
-            const requestedPrompt = text(body.prompt);
-            const existingSessions = storage.listWandTaskSessionIds(task.id).length;
-            if (existingSessions > 0 && !requestedPrompt)
-                throw new Error("请输入提示词。");
-            const prompt = requestedPrompt || task.description.trim() || task.title || "执行此任务";
-            const { session, cwd, workspaceId } = await dispatchAgentForTask({ storage, config, structured: structured ?? null, processes: processes ?? null }, { task, agent, prompt, automationId: `wand-task:${task.id}` });
+            const { session, cwd, workspaceId } = await dispatchAgentForTask({ storage, config, structured: structured ?? null, processes: processes ?? null }, { task, agent, prompt, automationId: `wand-task:${task.id}`,
+                systemPrompt: employee?.prompt, employee: employee ?? undefined,
+                employeeCandidateIndex: selected?.index });
             task = storage.getWandTask(task.id);
-            storage.updateWandTask(task.id, { agent, status: task.status === "todo" ? "doing" : task.status });
+            const usedSubject = subject ?? { type: "cli", id: agent.provider };
+            storage.updateWandTask(task.id, {
+                agent,
+                executionSubject: usedSubject,
+                status: task.status === "todo" ? "doing" : task.status,
+            });
+            if (!employee)
+                writeTaskBoardLastAgent(storage, agent);
             // 派发也算一轮迭代里的改动意图：直接把任务的标题 / 描述记进迭代记录。
             recordIterationPromptForTask(storage, {
                 sessionId: session.id,
@@ -597,6 +744,7 @@ export function registerTaskRoutes(app, deps) {
             res.status(202).json({
                 ok: true,
                 taskId: task.id,
+                subject: usedSubject,
                 session: {
                     id: session.id,
                     provider: session.provider,
@@ -605,6 +753,10 @@ export function registerTaskRoutes(app, deps) {
                     thinkingEffort: session.thinkingEffort,
                     mode: session.mode,
                     cwd: session.cwd,
+                    employeeId: session.employeeId,
+                    employeeName: session.employeeName,
+                    employeeAvatar: session.employeeAvatar,
+                    employeeCandidateIndex: session.employeeCandidateIndex,
                 },
             });
         }

package/dist/server-update-routes.js

@@ -405,7 +405,7 @@ export function registerAdminUpdateRoutes(app, deps) {
             return;
         }
         const rawIds = Array.isArray(req.body?.ids) ? req.body.ids : [];
-        const ids = rawIds.filter((value) => value === "claude" || value === "codex" || value === "opencode" || value === "grok" || value === "qoder" || value === "pi");
+        const ids = rawIds.filter((value) => value === "claude" || value === "codex" || value === "opencode" || value === "grok" || value === "qoder" || value === "pi" || value === "gemini");
         state.providerCliUpdateInFlight = true;
         try {
             const before = await refreshProviderCliUpdateState(state, config);

package/dist/server-workspace-routes.js

@@ -40,6 +40,9 @@ function workspaceSessionSummary(session, names = {}, registry, team = {}) {
         inFlight: live.structuredState?.inFlight === true,
         cwd: live.cwd,
         startedAt: live.startedAt,
+        employeeId: live.employeeId,
+        employeeName: live.employeeName,
+        employeeAvatar: live.employeeAvatar,
         ...(team.chat ? { teamChat: team.chat } : {}),
         ...(team.step ? { teamStep: team.step } : {}),
     };

package/dist/server.js

@@ -33,6 +33,7 @@ import { registerMissionRoutes } from "./server-mission-routes.js";
 import { Missions } from "./missions.js";
 import { createAiTeamRunner } from "./ai-team-runner.js";
 import { registerAiTeamRoutes } from "./server-ai-team-routes.js";
+import { registerSiliconEmployeeRoutes } from "./server-employee-routes.js";
 import { registerAttentionRoutes } from "./server-attention-routes.js";
 import { refreshProviderCliUpdateState, registerAdminUpdateRoutes, registerPublicUpdateRoutes, ServerUpdateState, } from "./server-update-routes.js";
 import { parseSessionCreationOrigin, registerClaudeHistoryRoutes, registerSessionRoutes } from "./server-session-routes.js";
@@ -298,6 +299,7 @@ export async function startServer(config, configPath, options = {}) {
         grok: storage.getPreference("pref:defaultGrokModel", config.defaultGrokModel ?? ""),
         qoder: storage.getPreference("pref:defaultQoderModel", config.defaultQoderModel ?? ""),
         pi: storage.getPreference("pref:defaultPiModel", config.defaultPiModel ?? ""),
+        gemini: storage.getPreference("pref:defaultGeminiModel", config.defaultGeminiModel ?? ""),
     });
     const getModelRefreshOptions = () => {
         const injected = options.modelRefreshOptions?.() ?? {};
@@ -361,6 +363,7 @@ export async function startServer(config, configPath, options = {}) {
             grok: "grokModels",
             qoder: "qoderModels",
             pi: "piModels",
+            gemini: "geminiModels",
         }[provider];
         return cache[key].map((entry) => entry.id);
     };
@@ -707,12 +710,17 @@ export async function startServer(config, configPath, options = {}) {
     });
     registerGithubRoutes(app, { storage, requireAdmin, sessions: sessionRegistry });
     // 任务管理与 Missions 一样只需登录：原生 connected-app 也要能列/建/派发。
-    registerTaskRoutes(app, { storage, sessions: sessionRegistry, structured: structuredSessions, processes, config });
+    registerTaskRoutes(app, { storage, sessions: sessionRegistry, structured: structuredSessions, processes, config, aiTeams });
     registerAiTeamRoutes(app, {
         storage,
         runner: aiTeams,
         notifyTeamChanged: (teamId) => notifyAiTeamRun({ kind: "ai-team-definition", teamId }),
     });
+    registerSiliconEmployeeRoutes(app, {
+        storage,
+        config,
+        notifyEmployeeChanged: (employeeId) => notifyAiTeamRun({ kind: "silicon-employee-definition", employeeId }),
+    });
     registerAttentionRoutes(app, { sessions: sessionRegistry, runner: aiTeams });
     registerAdminUpdateRoutes(app, {
         storage,
@@ -755,7 +763,7 @@ export async function startServer(config, configPath, options = {}) {
             if (snapshot?.cwd)
                 cwd = snapshot.cwd;
             if (snapshot)
-                ai = resolveSystemAiContext(snapshot, config);
+                ai = resolveSystemAiContext(snapshot, config, storage.getSystemSiliconEmployee());
         }
         if (!ai) {
             const defaultSession = {
@@ -766,7 +774,7 @@ export async function startServer(config, configPath, options = {}) {
                 selectedModel: null,
                 thinkingEffort: config.defaultThinkingEffort,
             };
-            ai = resolveSystemAiContext(defaultSession, config);
+            ai = resolveSystemAiContext(defaultSession, config, storage.getSystemSiliconEmployee());
         }
         try {
             const optimized = await optimizePrompt(text, config.language ?? "", cwd, ai);
@@ -785,6 +793,11 @@ export async function startServer(config, configPath, options = {}) {
     // ── Session control ──
     app.post("/api/commands", asyncRoute(async (req, res) => {
         const body = req.body;
+        if (body.employeeId !== undefined || body.teamId !== undefined
+            || (body.subject !== undefined && body.subject?.type !== "cli")) {
+            res.status(400).json({ error: "PTY 只能选择 CLI 工具。" });
+            return;
+        }
         const interactiveShell = body.shell === true;
         if (!interactiveShell && !body.command?.trim()) {
             res.status(400).json({ error: "请输入要执行的命令。" });

package/dist/session-ai-context.d.ts

@@ -1,4 +1,5 @@
 import { discoverCliSystemAiConfigs } from "./system-ai.js";
+import type { SiliconEmployee } from "./ai-team-types.js";
 import type { SessionProvider, SessionSnapshot, SystemAiConfig, WandConfig } from "./types.js";
 export interface SessionAiContext {
     provider: SessionProvider;
@@ -6,6 +7,10 @@ export interface SessionAiContext {
     thinkingEffort: SessionSnapshot["thinkingEffort"];
     inheritEnv?: boolean;
     systemAi?: SystemAiConfig;
+    /** 内置「系统运维」员工的人设；作为系统提示前缀注入 Wand 自有 AI 调用。 */
+    opsPersona?: string;
+    /** CLI 降级链（按顺序）。为空时只用 provider/model 这一次调用。 */
+    cliCandidates?: import("./types.js").AiCliCandidate[];
 }
 /**
  * Resolve the provider from every representation used by current and legacy
@@ -16,6 +21,6 @@ export declare function resolveSessionProvider(snapshot: Pick<SessionSnapshot, "
 /** Build the provider-specific settings used by session-adjacent AI actions. */
 export declare function resolveSessionAiContext(snapshot: Pick<SessionSnapshot, "provider" | "structuredState" | "runner" | "command" | "selectedModel" | "thinkingEffort">, config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultPiModel" | "defaultThinkingEffort" | "inheritEnv">): SessionAiContext;
 /** Build the source order for Wand-owned AI features such as titles. */
-export declare function resolveSystemAiContext(snapshot: Parameters<typeof resolveSessionAiContext>[0], config: Parameters<typeof resolveSessionAiContext>[1] & Pick<WandConfig, "systemAi" | "systemAiCli" | "systemAiModel">): SessionAiContext;
+export declare function resolveSystemAiContext(snapshot: Parameters<typeof resolveSessionAiContext>[0], config: Parameters<typeof resolveSessionAiContext>[1] & Pick<WandConfig, "systemAi" | "systemAiCli" | "systemAiModel">, systemEmployee?: SiliconEmployee | null): SessionAiContext;
 /** Build the AI context for quick-commit actions from their global preferences. */
-export declare function resolveCommitAiContext(snapshot: Pick<SessionSnapshot, "provider" | "structuredState" | "runner" | "command" | "selectedModel" | "thinkingEffort">, config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultPiModel" | "defaultThinkingEffort" | "inheritEnv" | "commitAiSource" | "systemAi">, discoverApis?: typeof discoverCliSystemAiConfigs): SessionAiContext;
+export declare function resolveCommitAiContext(snapshot: Pick<SessionSnapshot, "provider" | "structuredState" | "runner" | "command" | "selectedModel" | "thinkingEffort">, config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultPiModel" | "defaultThinkingEffort" | "inheritEnv" | "commitAiSource" | "systemAi" | "systemAiCli" | "systemAiModel">, discoverApis?: typeof discoverCliSystemAiConfigs, systemEmployee?: SiliconEmployee | null): SessionAiContext;

package/dist/session-ai-context.js

@@ -1,6 +1,8 @@
 import { getDefaultModelForProvider } from "./config.js";
 import { discoverCliSystemAiConfigs, mergeSystemAiConfigs, systemAiProfiles, } from "./system-ai.js";
-import { inferProviderFromCommand, inferProviderFromRunner, isSessionProvider } from "./session-provider.js";
+import { providerCliInstalled, isSessionProvider } from "./session-provider.js";
+import { isSystemSiliconEmployee, systemEmployeeCliCandidates } from "./system-employee.js";
+import { inferProviderFromCommand, inferProviderFromRunner } from "./session-provider.js";
 /**
  * Resolve the provider from every representation used by current and legacy
  * sessions. Older persisted sessions may not have the top-level provider, but
@@ -37,18 +39,39 @@ export function resolveSessionAiContext(snapshot, config) {
     };
 }
 /** Build the source order for Wand-owned AI features such as titles. */
-export function resolveSystemAiContext(snapshot, config) {
+export function resolveSystemAiContext(snapshot, config, systemEmployee) {
     const sessionContext = resolveSessionAiContext(snapshot, config);
+    // 候选里的「跟随默认模型」在这里就换成具体的 Wand 默认模型：降级到下一个 provider
+    // 时不能拿上一个 provider 的模型，也不能把决定权交给 CLI 自己的默认值。
+    const chain = systemEmployeeCliCandidates(systemEmployee).map((candidate) => ({
+        ...candidate,
+        model: candidate.model ?? normalizeModel(getDefaultModelForProvider(config, candidate.provider)),
+    }));
+    const owned = {
+        ...sessionContext,
+        ...(chain.length ? { cliCandidates: chain } : {}),
+        ...(isSystemSiliconEmployee(systemEmployee) ? { opsPersona: systemEmployee.prompt } : {}),
+    };
+    // 内置员工可用时，Wand 自有调用一律按它的候选链：provider/model 取首个已安装的
+    // 候选（两条路都一致），整条链留给运行期降级。
+    if (chain.length) {
+        const preferred = chain.find((candidate) => providerCliInstalled(candidate.provider)) ?? chain[0];
+        owned.provider = preferred.provider;
+        owned.model = preferred.model ?? normalizeModel(getDefaultModelForProvider(config, preferred.provider));
+        owned.thinkingEffort = preferred.thinkingEffort ?? config.defaultThinkingEffort;
+    }
     if (config.systemAi?.enabled) {
         const directApi = usableSystemAi(config.systemAi);
-        return directApi ? { ...sessionContext, systemAi: directApi } : sessionContext;
+        return directApi ? { ...owned, systemAi: directApi } : owned;
     }
+    if (chain.length)
+        return owned;
     // Older installations without a system AI CLI preference still follow the
     // current session. A chosen CLI must never inherit another provider's model.
     if (!isSessionProvider(config.systemAiCli))
-        return sessionContext;
+        return owned;
     return {
-        ...sessionContext,
+        ...owned,
         provider: config.systemAiCli,
         model: normalizeModel(config.systemAiModel)
             ?? normalizeModel(getDefaultModelForProvider(config, config.systemAiCli)),
@@ -56,10 +79,14 @@ export function resolveSystemAiContext(snapshot, config) {
     };
 }
 /** Build the AI context for quick-commit actions from their global preferences. */
-export function resolveCommitAiContext(snapshot, config, discoverApis = discoverCliSystemAiConfigs) {
-    const sessionContext = resolveSessionAiContext(snapshot, config);
-    if (config.commitAiSource !== "api")
-        return sessionContext;
+export function resolveCommitAiContext(snapshot, config, discoverApis = discoverCliSystemAiConfigs, systemEmployee) {
+    const sessionContext = resolveSystemAiContext(snapshot, config, systemEmployee);
+    if (config.commitAiSource !== "api") {
+        // 快捷提交的直连来源只看 commitAiSource；系统 AI 的 enabled 不能顺手把它打开。
+        const cliContext = { ...sessionContext };
+        delete cliContext.systemAi;
+        return cliContext;
+    }
     const directApi = mergeSystemAiConfigs(config.systemAi, discoverApis(sessionContext.provider));
     return {
         ...sessionContext,

package/dist/session-provider.d.ts

@@ -1,10 +1,15 @@
 import type { SessionProvider } from "./types.js";
 /** 全部受支持的会话 provider；顺序与 UI / 派发选择器一致。 */
-export declare const SESSION_PROVIDERS: readonly ["claude", "codex", "opencode", "grok", "qoder", "pi"];
+export declare const SESSION_PROVIDERS: readonly ["claude", "codex", "opencode", "grok", "qoder", "pi", "gemini"];
 /** 运行时守卫：把配置、数据库、请求体里的任意值收敛成 SessionProvider。 */
 export declare function isSessionProvider(value: unknown): value is SessionProvider;
 /** provider 对应的 CLI 可执行文件名（Qoder 的 CLI 叫 qodercli）。 */
 export declare function providerCliCommand(provider: SessionProvider): string;
+/**
+ * 不启动 shell 也能判断某个 provider 的 CLI 是否在 PATH 上（与子进程 PATH 一致）。
+ * 用于多候选降级时跳过没安装的工具，避免白等一次 spawn 失败。
+ */
+export declare function providerCliInstalled(provider: SessionProvider, pathValue?: string): boolean;
 /** 从 runner 名推断 provider；`pty` 等与 provider 无关的 runner 返回 undefined。 */
 export declare function inferProviderFromRunner(runner: unknown): SessionProvider | undefined;
 /**

package/dist/session-provider.js

@@ -1,5 +1,7 @@
+import { constants, accessSync, statSync } from "node:fs";
+import path from "node:path";
 /** 全部受支持的会话 provider；顺序与 UI / 派发选择器一致。 */
-export const SESSION_PROVIDERS = ["claude", "codex", "opencode", "grok", "qoder", "pi"];
+export const SESSION_PROVIDERS = ["claude", "codex", "opencode", "grok", "qoder", "pi", "gemini"];
 const SESSION_PROVIDER_SET = new Set(SESSION_PROVIDERS);
 /** 运行时守卫：把配置、数据库、请求体里的任意值收敛成 SessionProvider。 */
 export function isSessionProvider(value) {
@@ -9,6 +11,25 @@ export function isSessionProvider(value) {
 export function providerCliCommand(provider) {
     return provider === "qoder" ? "qodercli" : provider;
 }
+/**
+ * 不启动 shell 也能判断某个 provider 的 CLI 是否在 PATH 上（与子进程 PATH 一致）。
+ * 用于多候选降级时跳过没安装的工具，避免白等一次 spawn 失败。
+ */
+export function providerCliInstalled(provider, pathValue = process.env.PATH ?? "") {
+    const command = providerCliCommand(provider);
+    for (const directory of pathValue.split(path.delimiter)) {
+        if (!directory)
+            continue;
+        try {
+            const executable = path.join(directory, command);
+            accessSync(executable, constants.X_OK);
+            if (statSync(executable).isFile())
+                return true;
+        }
+        catch { /* 检查下一个 PATH 目录 */ }
+    }
+    return false;
+}
 /** 从 runner 名推断 provider；`pty` 等与 provider 无关的 runner 返回 undefined。 */
 export function inferProviderFromRunner(runner) {
     if (runner === "claude-cli" || runner === "claude-cli-print" || runner === "claude-sdk")
@@ -23,6 +44,8 @@ export function inferProviderFromRunner(runner) {
         return "qoder";
     if (runner === "pi-cli-json")
         return "pi";
+    if (runner === "gemini-cli-json")
+        return "gemini";
     return undefined;
 }
 /**
@@ -45,5 +68,8 @@ export function inferProviderFromCommand(command) {
         return "qoder";
     if (/^pi\b/i.test(value))
         return "pi";
+    // Gemini CLI 的可执行文件就叫 gemini；-p / --prompt 等参数不影响首 token 识别。
+    if (/^gemini\b/i.test(value))
+        return "gemini";
     return undefined;
 }

package/dist/session-transport.js

@@ -26,6 +26,10 @@ function sessionBase(snapshot) {
         id: snapshot.id,
         sessionSource: snapshot.sessionSource,
         automationId: snapshot.automationId,
+        employeeId: snapshot.employeeId,
+        employeeName: snapshot.employeeName,
+        employeeAvatar: snapshot.employeeAvatar,
+        employeeCandidateIndex: snapshot.employeeCandidateIndex,
         sessionKind: snapshot.sessionKind,
         provider: snapshot.provider,
         providerCliActive: snapshot.providerCliActive,

package/dist/silicon-employee-dispatch.d.ts

@@ -0,0 +1,9 @@
+import type { SiliconEmployee } from "./ai-team-types.js";
+import type { WandTaskAgent } from "./task-types.js";
+/** Match child-process PATH without starting a shell or trusting a client availability claim. */
+export declare function employeeCliAvailable(agent: WandTaskAgent, pathValue?: string): boolean;
+/** First installed candidate wins; when none is installed retain the preferred candidate for a recoverable failure. */
+export declare function selectEmployeeCandidate(employee: Pick<SiliconEmployee, "agents">, available?: (agent: WandTaskAgent) => boolean): {
+    agent: WandTaskAgent;
+    index: number;
+};

package/dist/silicon-employee-dispatch.js

@@ -0,0 +1,13 @@
+import { providerCliInstalled } from "./session-provider.js";
+/** Match child-process PATH without starting a shell or trusting a client availability claim. */
+export function employeeCliAvailable(agent, pathValue = process.env.PATH ?? "") {
+    return providerCliInstalled(agent.provider, pathValue);
+}
+/** First installed candidate wins; when none is installed retain the preferred candidate for a recoverable failure. */
+export function selectEmployeeCandidate(employee, available = employeeCliAvailable) {
+    if (!employee.agents.length || employee.agents.some((agent) => agent.kind !== "structured")) {
+        throw new Error("硅基员工没有可用的结构化执行候选。");
+    }
+    const index = employee.agents.findIndex((agent) => available(agent));
+    return { agent: employee.agents[index < 0 ? 0 : index], index: index < 0 ? 0 : index };
+}

package/dist/silicon-employee-draft.d.ts

@@ -0,0 +1,36 @@
+import { type QuickCommitAiOptions } from "./git-quick-commit.js";
+import type { SiliconEmployeeDraft } from "./ai-team-types.js";
+import type { AiTextRequest } from "./system-ai.js";
+import type { WandTaskAgent } from "./task-types.js";
+import type { SessionProvider } from "./types.js";
+export declare class SiliconEmployeeDraftError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/** 硅基员工只能跑结构化会话；候选沿用看板的「跟随服务端默认」。 */
+export declare function employeeAgentFor(provider: SessionProvider): WandTaskAgent;
+/**
+ * 已安装的 CLI：默认 provider 优先，其余按全局顺序；
+ * 都没装时返回空数组，由调用方决定退回到哪一个首选。
+ */
+export declare function availableEmployeeProviders(preferred?: SessionProvider, isAvailable?: (agent: WandTaskAgent) => boolean): SessionProvider[];
+/** 从模型输出里取第一个 JSON 对象，容忍前后夹带解释文字。 */
+export declare function extractDraftJson(raw: string): Record<string, unknown>;
+/**
+ * 校验并收敛模型输出。名字 / 角色设定缺失即视为不可用；
+ * provider 不在已安装清单里时按候选顺序兜底，不让员工带着跑不起来的 CLI 落库。
+ */
+export declare function parseSiliconEmployeeDraft(raw: string, options?: {
+    allowedProviders?: SessionProvider[];
+    fallbackProvider?: SessionProvider;
+}): SiliconEmployeeDraft;
+/** 规则走系统提示，用户的期望走用户消息；一次性调用沿用系统 AI 通道。 */
+export declare function buildEmployeeDraftPrompt(expectation: string, providers: SessionProvider[], existingNames?: string[]): AiTextRequest;
+/** 按自然语言期望生成员工配置；调用方负责随后落库。 */
+export declare function generateSiliconEmployeeDraft(expectation: string, ai?: QuickCommitAiOptions, options?: {
+    cwd?: string;
+    language?: string;
+    existingNames?: string[];
+    preferredProvider?: SessionProvider;
+    isProviderAvailable?: (agent: WandTaskAgent) => boolean;
+}): Promise<SiliconEmployeeDraft>;