@co0ontty/wand 4.83.1-beta.g97d7ae9 → 4.84.0

package/README.md

@@ -135,6 +135,8 @@ npm run check              # TypeScript type check
 npm run build              # Compile and copy static assets to dist/
 ```
 
+On this configured development machine, use `~/start.sh` to build/install the working tree and restart, `~/start.sh --restart` to restart without rebuilding, or `~/start.sh --status` to check status. This user-home helper enters the project and handles sudo locally; do not prefix it with `sudo`. It is not included in a fresh clone, and credentials stay outside the repository. Restart safety rules remain in [AGENTS.md](AGENTS.md).
+
 Use an isolated config for testing:
 
 ```bash
@@ -316,6 +318,8 @@ npm run check              # TypeScript 类型检查
 npm run build              # 编译 + 复制静态资源到 dist/
 ```
 
+本机开发环境统一调用用户主目录入口：`~/start.sh` 构建/安装当前代码并重启，`~/start.sh --restart` 仅重启、不重新构建，`~/start.sh --status` 查状态。入口自动进入项目并在本地处理 sudo，外层不要再加 sudo；它是本机配置，不随新克隆提供，凭据不入仓库。重启安全约束仍以 [AGENTS.md](AGENTS.md) 为准。
+
 隔离测试环境（不影响生产实例）：
 
 ```bash

package/dist/agent-dispatch.js

@@ -1,4 +1,5 @@
 import { getDefaultModelForProvider } from "./config.js";
+import { defaultModelGroupSelector } from "./model-groups.js";
 import { defaultRoleForCli } from "./default-employee.js";
 import { providerCliCommand } from "./session-provider.js";
 import { agentKey } from "./ai-team-types.js";
@@ -21,6 +22,9 @@ export function resolveTaskDispatchTarget(deps, task) {
 export async function dispatchAgentForTask(deps, input) {
     const { storage, config, structured, processes } = deps;
     const { agent } = input;
+    if (agent.engine === "sdk" && !input.employee) {
+        throw new Error("SDK 执行引擎只能通过员工候选启用。");
+    }
     if (input.employee) {
         if (agent.kind !== "structured")
             throw new Error("绑定员工只支持结构化会话。");
@@ -40,7 +44,7 @@ export async function dispatchAgentForTask(deps, input) {
     const cwd = group.cwd;
     const provider = agent.provider;
     const model = agent.model === "default" ? "" : agent.model;
-    const resolvedModel = model || getDefaultModelForProvider(config, provider) || undefined;
+    const resolvedModel = model || defaultModelGroupSelector(config.modelGroups, provider, getDefaultModelForProvider(config, provider)) || getDefaultModelForProvider(config, provider) || undefined;
     const session = agent.kind === "pty"
         ? await processes.start(providerCliCommand(provider), cwd, agent.mode, input.prompt, {
             provider,

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

@@ -35,7 +35,7 @@ export interface StartupFailureProbe {
  */
 export declare function classifyStartupFailure(probe: StartupFailureProbe): CandidateFailureKind;
 export interface WorkFailureInput {
-    /** 只有 work 步骤参与降级；leader 步骤走既有格式重试/waiting_user 路径。 */
+    /** 成员执行步骤的启动失败降级；负责人完整候选重试由 runner 管理。 */
     stepKind: "leader" | "work";
     /** PTY 候选一律不异步分类、不降级（§3.4 修正 B4）。 */
     agentKind: WandTaskAgentKind;

package/dist/ai-team-prompts.js

@@ -43,7 +43,8 @@ export function leaderOf(team) {
     return team.members.find((member) => member.isLeader) ?? team.members[0];
 }
 export function workersOf(team) {
-    return team.members.filter((member) => !member.isLeader);
+    // A single employee or explicitly @-selected coordinator retains their own professional duty.
+    return team.members.length === 1 || team.allowLeaderWork ? team.members : team.members.filter((member) => !member.isLeader);
 }
 /** 每步的约定报告文件（相对 cwd）。所有 CLI 都能写文件，因此是通用的交接方式。 */
 export function aiTeamReportPath(runId, seq, kind, memberId) {
@@ -240,7 +241,8 @@ function leaderSystemPrompt(run, resolveModel) {
     return [
         ...(employeePrompt ? [employeePrompt] : []),
         `你是 AI 团队「${run.team.name}」的负责人（${leader.name}）。`,
-        `你的职责：${leader.duty.trim() || "拆分任务、派工、根据报告决定下一步。"}`,
+        `你的专业职责：${leader.duty.trim() || "拆分任务、派工、根据报告决定下一步。"}`,
+        ...(run.team.allowLeaderWork ? ["用户通过 @ 指定你为本轮负责人：协调职责是拆分任务、按群成员的专业职责派工、收集报告并汇总；不代表所有工作都由你执行。"] : []),
         "",
         "## 成员（只能把工作派给下列成员；id 必须原样使用）",
         "成员的名单行只列首选执行配置；执行配置由系统按候选顺序自动降级，你只按成员能力分派，不操心模型可用性。",
@@ -248,11 +250,18 @@ function leaderSystemPrompt(run, resolveModel) {
         ...teamInstructions(run.team),
         "",
         "## 工作方式",
-        "- 你不直接改代码：你负责拆分任务、派工，并根据成员报告决定下一步。",
+        run.team.members.length === 1
+            ? "- 本群只有你一位员工：规划阶段只制定计划，work 步骤使用你的同一 member id。执行阶段会在独立的阶段会话里工作并交付。"
+            : run.team.allowLeaderWork
+                ? "- 规划阶段只负责拆分、派工和汇总。属于你专业职责的工作可派给自己的 member id，系统会用独立 work 会话执行；其余工作交给职责匹配的成员，不能包办，也不为了全员发言重复派工。"
+                : "- 你不直接改代码：你负责拆分任务、派工，并根据成员报告决定下一步。",
         `- 每次只安排接下来要做的几步（1–${AI_TEAM_MAX_ASSIGN_STEPS} 步）。互不依赖的工作派给不同成员可以并行；所有在跑的步骤结束后，我会把报告交回给你。`,
         "- 并行成员共用同一个工作目录，不要让两个人同时改同一批文件。",
-        "- 实现与验收交给不同成员，不要让同一个成员验收自己的工作。",
+        run.team.members.length === 1
+            ? "- 可以自测，但不能声称独立交叉验收。任务需要另一人验收时，等待用户明确邀请/确认，不虚构成员。"
+            : "- 实现与验收交给不同成员，不要让同一个成员验收自己的工作。",
         "- 派工优先按角色：制定计划给 plan 成员，实现给 work 成员，验收给 verify 成员；没标角色的成员视为 any。",
+        "- 同时按成员的专业职责选人并遵守边界（例如设计成员只出设计，不改产品代码），不能因为某人是负责人就把所有工作交给他。",
         "- 同一成员同一时间只有一个步骤；互不相干的步骤并行派出，有先后关系的用 after 声明。",
         "- 需要用户拍板时就提问，不要猜。",
         `- ${OBJECTIVE_INTENT_NOTE}`,

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

@@ -1,11 +1,12 @@
 import type { SiliconEmployee } from "./ai-team-types.js";
 import { type AgentDispatchDeps } from "./agent-dispatch.js";
 import { type ModelCatalogView } from "./ai-team-availability.js";
-import { type AiTeam, type AiTeamLiveStep, type AiTeamLiveUpdate, type AiTeamRun, type AiTeamRunDetail, type AiTeamRunSummary, type AiTeamStep } from "./ai-team-types.js";
+import { type AiTeam, type AiTeamLiveSnapshot, type AiTeamLiveStep, type AiTeamLiveUpdate, type AiTeamRun, type AiTeamRunDetail, type AiTeamRunSummary, type AiTeamStep } from "./ai-team-types.js";
 import type { SessionRegistry } from "./session-registry.js";
+import type { StructuredFailure } from "./structured-failure.js";
 import type { WandStorage } from "./storage.js";
 import type { WandTask, WandTaskAgent } from "./task-types.js";
-import type { ConversationTurn, ProcessEvent, SessionSnapshot } from "./types.js";
+import type { ConversationAuthor, ConversationTurn, ProcessEvent, SessionSnapshot } from "./types.js";
 /** 群聊会话的 automationId 前缀；后面接运行 id。 */
 export declare const AI_TEAM_CHAT_PREFIX = "ai-team-chat:";
 /** 用户可见的冲突错误（路由转 409）。 */
@@ -30,6 +31,7 @@ export interface AiTeamSessionOps {
     ownerOf(sessionId: string): "structured" | "pty" | "storage" | null;
     /** Server-private generation and one-shot, explicitly unaccepted startup fact. */
     consumeUnacceptedStartup?(sessionId: string, requestId: string): boolean;
+    consumeUnacceptedFailure?(sessionId: string, requestId: string): StructuredFailure | null;
 }
 /** 群聊：一次运行一个转发会话，团队的决定、派工和报告都以成员身份发在里面。 */
 export interface AiTeamChatOps {
@@ -43,6 +45,8 @@ export interface AiTeamChatOps {
 export interface AiTeamRunnerOptions {
     storage: WandStorage;
     chat?: AiTeamChatOps;
+    /** Instance projection includes ordinary group replies without copying private DMs. */
+    chatHistoryTurns?: (conversationId: string) => ConversationTurn[];
     /** 解析任务卡的执行目录；默认走 agent-dispatch 的规则。 */
     resolveCwd: (task: WandTask) => string;
     ops: AiTeamSessionOps;
@@ -50,6 +54,11 @@ export interface AiTeamRunnerOptions {
     /** 运行中步骤的 live 文本推送（§4.9）：去抖后每 500ms 至多一次，stepId+text+omittedChars+state 全同不重复推。 */
     notifyLive?: (update: AiTeamLiveUpdate) => void;
     now?: () => number;
+    /**
+     * 静默心跳阈值（毫秒），默认 AI_TEAM_SILENCE_HEARTBEAT_MS。测试注入小值来验证静默期确实重推，
+     * 生产不设这一项；调用方不要拿它做无界轮询——每个 run 至多一个计时器，离开 running 即 cancel。
+     */
+    heartbeatMs?: number;
     /**
      * 某 provider 已发现的模型清单（§3.4 model-unknown 事前比对）。目录未就绪 / 清单为空时
      * 返回空值即可，判定方向是「拿不准就放行」。
@@ -60,6 +69,11 @@ export interface AiTeamRunnerOptions {
      * `default` 哨兵不是模型名，写真正会用的那个。
      */
     defaultModelOf?: (provider: WandTaskAgent["provider"]) => string;
+    /**
+     * 当前用户资料的署名投影。只在没有对话归属、只能回放 relay 快照的旧群聊里用；
+     * 有对话归属时由 ConversationService 统一投影，避免两处口径。
+     */
+    selfAuthor?: () => ConversationAuthor;
 }
 export declare function createAiTeamSessionOps(deps: AgentDispatchDeps & {
     sessions: SessionRegistry;
@@ -68,9 +82,11 @@ export declare function createAiTeamChatOps(deps: AgentDispatchDeps): AiTeamChat
 export declare function createAiTeamRunner(deps: AgentDispatchDeps & {
     sessions: SessionRegistry;
     notify?: (run: AiTeamRun) => void;
+    chatHistoryTurns?: (conversationId: string) => ConversationTurn[];
     notifyLive?: (update: AiTeamLiveUpdate) => void;
     models?: (provider: WandTaskAgent["provider"]) => ModelCatalogView;
     defaultModelOf?: (provider: WandTaskAgent["provider"]) => string;
+    selfAuthor?: () => ConversationAuthor;
 }): AiTeamRunner;
 /**
  * 群聊里的发言人。上传的头像是 data URL，每条消息都带一份太重，改用按 id 取的像素猫。
@@ -127,11 +143,13 @@ export declare class AiTeamRunner {
     private readonly storage;
     private readonly ops;
     private readonly chat?;
+    private readonly chatHistoryTurns?;
     private readonly resolveCwd;
     private readonly notifyListener?;
     private readonly notifyLiveListener?;
     private readonly modelsOf?;
     private readonly defaultModelOf?;
+    private readonly selfAuthorOf?;
     private readonly now;
     private readonly chains;
     private readonly outputTimers;
@@ -139,6 +157,22 @@ export declare class AiTeamRunner {
     private readonly liveTimers;
     /** 上次推出去的 live 列表指纹（§4.9）：stepId + text + omittedChars + state 全同就不重复推。 */
     private readonly lastLiveKey;
+    /** 上次真正推出 live 列表的时刻（毫秒），静默心跳的起算点。 */
+    private readonly lastLivePushAt;
+    /** 上次 `ai-team-run` 通知发出的时刻（毫秒）；心跳据此判断 run 通道是否也该重推。 */
+    private readonly lastRunNotifyAt;
+    /**
+     * 静默心跳计时器，按 runId 计：**每个 run 至多一个**，run 离开 running（终态 / 等批准 / 等回复）
+     * 或 dispose 时立即 cancel，不留悬挂计时器。
+     */
+    private readonly heartbeatTimers;
+    /**
+     * 每个运行中步骤最近一次「可观测活动」的签名与时刻（毫秒）。纯内存观测记录，不入库：
+     * 服务重启后退回步骤自己的 `startedAt` 重新起算，第一次观察不算活动。
+     * 步骤落地（done / failed / skipped）时在 `saveStep` 里删掉，容量随并发步数有界。
+     */
+    private readonly stepActivity;
+    private readonly heartbeatMs;
     private readonly recheckTimers;
     /** 已经确定「不降级、按既有路径记 failed」的步骤，防止 finishStep 再判一次形成回环。 */
     private readonly noDegrade;
@@ -156,10 +190,15 @@ export declare class AiTeamRunner {
     /** 先脱敏再头尾截断：截断会把中间的敏感串切出来，顺序不能反。 */
     private cleanError;
     start(input: {
-        teamId: string;
+        teamId?: string;
+        team?: AiTeam;
         taskId: string;
         note?: string;
         chatSessionId?: string;
+        conversationId?: string;
+        memberVersion?: number;
+        runId?: string;
+        onAccepted?: (run: AiTeamRun) => void;
     }): Promise<AiTeamRunDetail>;
     approve(runId: string, options?: {
         echo?: boolean;
@@ -180,6 +219,8 @@ export declare class AiTeamRunner {
      * 成员干活时先记下，负责人下一轮一起看到；运行已结束则接着开一轮新的。
      */
     chatInput(sessionId: string, text: string): Promise<void>;
+    /** Explicit task target; ordinary group talk never implicitly approves/stops/starts a run. */
+    inputForRun(runId: string, text: string): Promise<AiTeamRunDetail>;
     detail(runId: string): AiTeamRunDetail;
     listForTask(taskId: string): AiTeamRun[];
     /**
@@ -187,12 +228,45 @@ export declare class AiTeamRunner {
      * 快照拿不到的步骤跳过而不抛。run 不存在时与 detail() 同口径抛错。
      */
     live(runId: string): AiTeamLiveStep[];
+    /**
+     * 轮询端（`GET /api/ai-team-runs/:id/live`）的完整投影：live 步骤 + run 级活动时间。
+     * 一次读数算出两者，移动端不必为了「还在跑吗」再拉一次 detail。run 不存在时与 detail() 同口径抛错。
+     */
+    liveSnapshot(runId: string): AiTeamLiveSnapshot;
+    /**
+     * run 级活动时间投影（派生、不入库）。`steps` 为该 run 的全部步骤，缺省时只在 run 还在跑
+     * 才去查表：终态 / 等批准 / 等用户时 `run.updatedAt` 就是最后一次状态写入，而逐步骤的内存观察
+     * 也已随步骤落地清掉，再查几十条历史记录没有意义。
+     */
+    private activityOf;
     private liveSteps;
     private liveStep;
+    /**
+     * 记一步「最近一次可观测活动」的时刻并返回。签名 = 活动状态 + live 文本长度 + 原始输出与回合
+     * 规模 + 是否在本轮里 + 待授权请求 id；任一项变了就算活动发生在此刻。
+     * 与 live 推送指纹刻意不同：指纹只管「要不要推」，这里的信号要能把「文本没变但输出仍在涨」
+     * （一条长命令、一段被 ANSI 包住的进度）也认成活动。首次观察不记成活动，以 `startedAt` 为基线，
+     * 免得服务重启后第一次读快照就谎报「刚刚有活动」。
+     */
+    private noteStepActivity;
     /** 挂一次 run 级 live 去抖：同一 run 每 500ms 至多算一遍、推一次，与 evaluate 的计时器互不干扰。 */
     private scheduleLivePush;
-    /** 推一次 live 列表（§4.9）；指纹（stepId + text + omittedChars + state）没变就不重复推，推送失败只忽略。 */
+    /**
+     * 推一次 live 列表（§4.9）；指纹（stepId + text + omittedChars + state）没变就不重复推，
+     * 推送失败只忽略。例外是静默心跳：`heartbeat` 为 true 时按心跳计时器的裁决放行，内容可以逐字相同，
+     * 但新的 `activity.observedAt` 与 heartbeat 标记让前端知道「这个 run 还在被跟踪」。
+     * 放行不松开去抖：推完照样记指纹并重排心跳，所以静默期最多每 heartbeatMs 一次，不是无界重推。
+     */
     private pushLive;
+    /**
+     * 排一次静默心跳：距上次 live 推送或 run 通知还差多久到阈值，就多久后再看一次。
+     * 同一 run 至多一个计时器；run 不在 running、被删除或 dispose 时 cancel，不泄漏。
+     */
+    private scheduleHeartbeat;
+    /** 心跳到点：仍在跑且仍在静默就把 live 快照和 run 状态各重推一次，然后按新基线续排。 */
+    private beat;
+    /** run 离开 running（终态、等批准、等用户）、被删除或 dispose：取消心跳并清掉基线。 */
+    private cancelHeartbeat;
     /** 团队页的运行记录；teamId 为空时列出所有团队（侧边栏计数用）。 */
     listRuns(filter: {
         teamId?: string;
@@ -273,7 +347,7 @@ export declare class AiTeamRunner {
      * 只直接派出 A′，**不整轮 advance**（N1：advance 的 queued/byId/busyMembers 是进循环时的快照，
      * 整轮调整会在同一栈里对同一步二次派发）。`proceed` 原样透传给 A′ 的 dispatchStep。
      */
-    private degradeWorkStep;
+    private degradeStep;
     /**
      * 会话「起来又倒下」的启动期归因（§3.4 触发点 2）。判定核在 ai-team-availability，
      * 这里只负责喂时钟、快照与报告产出；不满足降级条件返回 null，按既有路径记 failed。
@@ -330,4 +404,5 @@ export declare class AiTeamRunner {
     private saveStep;
     private notify;
     private iso;
+    private isoOf;
 }