@co0ontty/wand 4.77.0 → 4.78.0-beta.ga1e4f59

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

@@ -1,6 +1,6 @@
 import { type AgentDispatchDeps } from "./agent-dispatch.js";
 import { type ModelCatalogView } from "./ai-team-availability.js";
-import { type AiTeamRun, type AiTeamRunDetail, type AiTeamRunSummary } from "./ai-team-types.js";
+import { type AiTeam, 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 { WandStorage } from "./storage.js";
 import type { WandTask, WandTaskAgent } from "./task-types.js";
@@ -41,12 +41,19 @@ export interface AiTeamRunnerOptions {
     resolveCwd: (task: WandTask) => string;
     ops: AiTeamSessionOps;
     notify?: (run: AiTeamRun) => void;
+    /** 运行中步骤的 live 文本推送（§4.9）：去抖后每 500ms 至多一次，stepId+text+omittedChars+state 全同不重复推。 */
+    notifyLive?: (update: AiTeamLiveUpdate) => void;
     now?: () => number;
     /**
      * 某 provider 已发现的模型清单（§3.4 model-unknown 事前比对）。目录未就绪 / 清单为空时
      * 返回空值即可，判定方向是「拿不准就放行」。
      */
     models?: (provider: WandTaskAgent["provider"]) => ModelCatalogView;
+    /**
+     * 该 provider 服务端配置的默认模型（拿不到返回空串）。只用于提示词里的成员名单：
+     * `default` 哨兵不是模型名，写真正会用的那个。
+     */
+    defaultModelOf?: (provider: WandTaskAgent["provider"]) => string;
 }
 export declare function createAiTeamSessionOps(deps: AgentDispatchDeps & {
     sessions: SessionRegistry;
@@ -55,8 +62,16 @@ export declare function createAiTeamChatOps(deps: AgentDispatchDeps): AiTeamChat
 export declare function createAiTeamRunner(deps: AgentDispatchDeps & {
     sessions: SessionRegistry;
     notify?: (run: AiTeamRun) => void;
+    notifyLive?: (update: AiTeamLiveUpdate) => void;
     models?: (provider: WandTaskAgent["provider"]) => ModelCatalogView;
+    defaultModelOf?: (provider: WandTaskAgent["provider"]) => string;
 }): AiTeamRunner;
+/**
+ * 群聊里的发言人。上传的头像是 data URL，每条消息都带一份太重，改用按 id 取的像素猫。
+ * `agent` 传该步**实际使用候选**（§3.6/B15，降级换候选后跟着变），model / thinkingEffort 与
+ * provider 同源；Leader 或没有步骤的场景回退首选候选。只填真值，展示文案归客户端。
+ */
+export declare function displayAiTeam(snapshot: AiTeam, current: AiTeam | null): AiTeam;
 /** 遮蔽参照目录：家目录与激活配置目录（含 `/tmp/wand-dev` 这类隔离路径，按传入处理）。 */
 export interface RedactionDirs {
     homeDir?: string;
@@ -69,6 +84,35 @@ export interface RedactionDirs {
  * 方向是宁多勿漏：认不准的超长串一律隐藏，代价只是文案少一段可调试信息。
  */
 export declare function redactAiTeamErrorText(text: string, dirs?: RedactionDirs): string;
+/** 每行邀请名单上限（S2/S3）：`邀请 @a、@b、@c、@d 加入群聊`。 */
+export declare const CHAT_INVITE_PER_LINE = 4;
+/**
+ * 首次建群的入群序列（S1–S3）：负责人先入群，再按 `team.members` 原顺序邀请其余成员。
+ * 每行最多 [CHAT_INVITE_PER_LINE] 人，第二行起用 `继续邀请 …`；除负责人外没人时给
+ * `还没有邀请其他成员入群`（仍两条，不伪造成员）。
+ */
+export declare function chatIntroLines(team: Pick<AiTeam, "name" | "members">): string[];
+/** 开工发言里的一条依据（来自 `step.dependsOn` 解析出的上游步骤）。 */
+export interface AiTeamStepBasis {
+    seq: number;
+    title: string;
+    memberName: string;
+    reportPath: string;
+}
+/**
+ * 开工发言正文（S4）：
+ * - 第 1 行 `我正在开始工作：第 N 步「标题」`；
+ * - 有依赖时第 2 行 `依据 @上游成员 第 M 步「上游标题」的产物 <reportPath>`，超过两条
+ *   只列前两条并在尾上 `等 N 步`（N = 依赖总数）；
+ * - 依赖解析不到（旧数据/步骤被删）→ `依据上游步骤的产物继续`。
+ */
+export declare function stepStartText(step: Pick<AiTeamStep, "seq" | "title">, upstream?: ReadonlyArray<AiTeamStepBasis>, dependencyCount?: number): string;
+/**
+ * 派工行的依据括注（S5）：`（依据：第 1 步「设计规格」的产物）`，多个依赖用 `、` 连接。
+ * 位置 `at` 是**本批 steps 内**的 0-based 下标（展示成第 at+1 步）；没有依赖就是空串（首步无依据）。
+ * 它**取代**旧的 `（等第 N 项完成后）`：同一个依赖关系不写两遍。
+ */
+export declare function assignmentBasisNote(after: readonly number[], titles: readonly string[]): string;
 /**
  * AI 团队调度器。状态全部在数据库里，会话事件驱动推进；同一运行的所有操作串行执行。
  * 成员会话是普通 Wand 会话，服务端只负责传话：Leader 决定派谁做什么，成员交报告。
@@ -79,10 +123,16 @@ export declare class AiTeamRunner {
     private readonly chat?;
     private readonly resolveCwd;
     private readonly notifyListener?;
+    private readonly notifyLiveListener?;
     private readonly modelsOf?;
+    private readonly defaultModelOf?;
     private readonly now;
     private readonly chains;
     private readonly outputTimers;
+    /** live 推送的去抖计时器，按 runId 计（§4.9）。 */
+    private readonly liveTimers;
+    /** 上次推出去的 live 列表指纹（§4.9）：stepId + text + omittedChars + state 全同就不重复推。 */
+    private readonly lastLiveKey;
     private readonly recheckTimers;
     /** 已经确定「不降级、按既有路径记 failed」的步骤，防止 finishStep 再判一次形成回环。 */
     private readonly noDegrade;
@@ -90,6 +140,8 @@ export declare class AiTeamRunner {
     /** 脱敏参照目录只算一次：os.homedir() 读 env，configDir 随 storage 定，运行期不变。 */
     private redactionDirsValue;
     constructor(options: AiTeamRunnerOptions);
+    /** 提示词里的模型名解析器：`default` 哨兵交给服务端配置的默认模型。 */
+    private readonly defaultModelName;
     /** 本 runner 的遮蔽参照目录（§4.5）。 */
     private get redactionDirs();
     /** 只脱敏、不改长度语义（用于本来就不截断的文案）。 */
@@ -112,6 +164,8 @@ export declare class AiTeamRunner {
         echo?: boolean;
     }): Promise<AiTeamRunDetail>;
     continueRun(runId: string, extraSteps: number): Promise<AiTeamRunDetail>;
+    /** 已有运行的上限独立持久化；修改团队定义后，下次续跑至少采用新的团队上限。 */
+    private extendStepLimit;
     completeStep(runId: string, stepId: string, report: string): Promise<AiTeamRunDetail>;
     stop(runId: string): Promise<AiTeamRunDetail>;
     /**
@@ -121,6 +175,17 @@ export declare class AiTeamRunner {
     chatInput(sessionId: string, text: string): Promise<void>;
     detail(runId: string): AiTeamRunDetail;
     listForTask(taskId: string): AiTeamRun[];
+    /**
+     * 此刻正在干活的步骤的实时文本（§4.9）。只覆盖 running 且有会话的步骤，按 seq 升序；
+     * 快照拿不到的步骤跳过而不抛。run 不存在时与 detail() 同口径抛错。
+     */
+    live(runId: string): AiTeamLiveStep[];
+    private liveSteps;
+    private liveStep;
+    /** 挂一次 run 级 live 去抖：同一 run 每 500ms 至多算一遍、推一次，与 evaluate 的计时器互不干扰。 */
+    private scheduleLivePush;
+    /** 推一次 live 列表（§4.9）；指纹（stepId + text + omittedChars + state）没变就不重复推，推送失败只忽略。 */
+    private pushLive;
     /** 团队页的运行记录；teamId 为空时列出所有团队（侧边栏计数用）。 */
     listRuns(filter: {
         teamId?: string;
@@ -131,7 +196,12 @@ export declare class AiTeamRunner {
     ingest(event: ProcessEvent): void;
     /** 服务启动时调用：把重启前未结束的运行接回来，并开始兜底巡检。 */
     reconcile(): void;
-    /** 兜底巡检：PTY 成员写完报告后可能不再产生事件。 */
+    /**
+     * 兜底巡检：PTY 成员写完报告后可能不再产生事件。
+     * 顺带对每个 run 强制对账一次 live（§4.9）：registry 内部状态静默翻转时一条事件都不会进来，
+     * 状态芯片只能等客户端下一次重拉；这里在同一串里重算列表走 pushLive，指纹变了才推，
+     * 没变就什么都不发。巡检间隔与 evaluate 行为都不动。
+     */
     startSweep(): void;
     dispose(): void;
     /** 等当前排队的所有操作跑完（测试用）。 */
@@ -142,8 +212,10 @@ export declare class AiTeamRunner {
     private evaluate;
     private scheduleRecheck;
     private stepOutcome;
-    /** proceed=false 时只记结果不推进，由调用方在记完一批之后统一 advance。 */
+    /** 步骤落地后补推一次 live（§4.9）：让卡片收尾，列表可能已空。内部抛错时不推。 */
     private finishStep;
+    /** proceed=false 时只记结果不推进，由调用方在记完一批之后统一 advance。 */
+    private finishStepCore;
     /**
      * 派出所有已就绪的成员步骤：依赖都已完成、且该成员手上没有活。不同成员并行，同一成员串行。
      * 有成员失败、队列清空或依赖再也满足不了时，等在跑的都结束后交回 Leader。
@@ -157,6 +229,16 @@ export declare class AiTeamRunner {
      * 成员步骤的上游交接：把依赖步骤的报告写成一个交接文件，提示词只给路径。
      * 没有依赖、或写文件失败时返回 null（提示词仍逐行列出上游报告文件）。
      */
+    /**
+     * 开工发言（S4）：成员**自己发的真实发言**（头像 + 名字 + 气泡），不是居中 notice；
+     * 文案由 [stepStartText] 拼（依据只来自 `step.dependsOn`，不引 `decision.message` / 报告正文 / 提示词文本）。
+     */
+    private postStepStart;
+    /**
+     * 开工发言的依据：只看 `step.dependsOn`，按依赖顺序解析出上游步骤（没有依赖返回空数组）。
+     * 不调 `memberUpstream`：那个会顺手写交接文件，而这里只要读数据（设计 v2.1 强调不引 LLM 文本）。
+     */
+    private upstreamBasis;
     private memberUpstream;
     /**
      * 同一个群聊里接着开新运行时的续跑交接（§4.4 同一套文件交接）：把之前几轮的步骤摘要