dominds 0.6.7 → 0.7.0

package/dist/agent-priming.js

@@ -46,7 +46,7 @@ const fs = __importStar(require("node:fs/promises"));
 const path = __importStar(require("node:path"));
 const dialog_1 = require("./dialog");
 const dialog_run_state_1 = require("./dialog-run-state");
-const driver_1 = require("./llm/driver");
+const driver_entry_1 = require("./llm/driver-entry");
 const log_1 = require("./log");
 const runtime_language_1 = require("./shared/runtime-language");
 const id_1 = require("./shared/utils/id");
@@ -58,7 +58,7 @@ const PRIMING_VCS_SESSION_SLUG = 'rtws-vcs-inventory';
 const cacheByAgentId = new Map();
 const inflightByAgentId = new Map();
 async function emitSayingEventsAndPersist(dlg, content) {
-    const calls = await (0, driver_1.emitSayingEvents)(dlg, content);
+    const calls = await (0, driver_entry_1.emitSayingEvents)(dlg, content);
     const genseq = dlg.activeGenSeqOrUndefined;
     if (dlg.generationStarted &&
         typeof genseq === 'number' &&
@@ -949,7 +949,7 @@ async function generatePrimingNoteViaMainlineAgent(options) {
             ].join('\n');
         // IMPORTANT: this is an internal (non-persisted) prompt. driver.ts will inject it into
         // the LLM context for this drive only, without polluting dialog history.
-        await (0, driver_1.driveDialogStream)(dlg, {
+        await (0, driver_entry_1.driveDialogStream)(dlg, {
             content: internalPrompt,
             msgId: (0, id_1.generateShortId)(),
             grammar: 'markdown',
@@ -1451,7 +1451,7 @@ async function runAgentPrimingLive(dlg) {
                 language,
                 collectiveTargets: [ensuredSpecialistId],
             });
-            await (0, driver_1.driveDialogStream)(sub, { content: initPrompt, msgId: (0, id_1.generateShortId)(), grammar: 'markdown', skipTaskdoc: true }, true);
+            await (0, driver_entry_1.driveDialogStream)(sub, { content: initPrompt, msgId: (0, id_1.generateShortId)(), grammar: 'markdown', skipTaskdoc: true }, true);
             shellResponseText = extractLastAssistantSaying(sub.msgs);
             const toolResult = extractLastShellCmdResultText(sub.msgs);
             snapshotText = toolResult ? toolResult : shellResponseText;
@@ -1525,7 +1525,7 @@ async function runAgentPrimingLive(dlg) {
                     language,
                     collectiveTargets: [ensuredSpecialistId],
                 });
-                await (0, driver_1.driveDialogStream)(round1Sub, {
+                await (0, driver_entry_1.driveDialogStream)(round1Sub, {
                     content: round1Prompt,
                     msgId: (0, id_1.generateShortId)(),
                     grammar: 'markdown',
@@ -1581,7 +1581,7 @@ async function runAgentPrimingLive(dlg) {
                     language,
                     collectiveTargets: [ensuredSpecialistId],
                 });
-                await (0, driver_1.driveDialogStream)(round1Sub, {
+                await (0, driver_entry_1.driveDialogStream)(round1Sub, {
                     content: round2Prompt,
                     msgId: (0, id_1.generateShortId)(),
                     grammar: 'markdown',
@@ -1743,7 +1743,7 @@ async function runAgentPrimingLive(dlg) {
                     language,
                     collectiveTargets: [dlg.agentId],
                 });
-                await (0, driver_1.driveDialogStream)(sub, {
+                await (0, driver_entry_1.driveDialogStream)(sub, {
                     content: initPrompt,
                     msgId: (0, id_1.generateShortId)(),
                     grammar: 'markdown',

package/dist/docs/drive-logic-context-refactor-plan.zh.md

@@ -2,6 +2,7 @@
 
 状态：Draft  
 语义基线：以 `dominds/main/llm/driver.ts` 与 `dominds/main/persistence.ts` 当前实现为准。
+测试基线（2026-02-09 更新）：drive 相关脚本统一通过 `main/llm/driver-entry.ts` 调用，可用 `DOMINDS_DRIVER_ENGINE=v1|v2` 进行引擎切换验证。
 
 ## 1. 背景与目标
 
@@ -103,140 +104,235 @@
 2. 当前无 `next_gen` 真实业务需求，先不保留该分支，避免语义包袱。
 3. 如未来出现单轮内部提示需求，新增能力应基于明确场景和回归测试，不提前抽象。
 
-## 6. 大重构计划（可执行蓝图）
+## 6. Priming 重点支持目标
 
-### 阶段 A：上下文装配纯函数化（不改行为）
+本次重构把 Agent Priming 作为第一优先级目标，不再作为“顺带兼容”。
 
-目标：把“怎么拼装 ctxMsgs”从 `_driveDialogStream()` 中剥离为可测试单元。
+### 6.1 Priming 对 drive 的硬需求
 
-交付物：
-
-1. 新建 `buildDriveContextSnapshot(...)`，输出不可变快照：
-   - `stableMessages`（来自 `dlg.msgs` + memories + taskdoc + coursePrefix）
-   - `transientMessages`（subdialog 注入、internal drive priming、reminder/language guide）
-   - `diagnostics`（各来源计数、关键 id、去重统计）
-2. 新建 `renderDriveContextMessages(snapshot)`，仅负责有序拼接，不负责业务决策。
-3. `_driveDialogStream()` 改为“准备输入 -> 调纯函数 -> 用输出”。
-
-验收：
-
-1. 对同一输入快照，render 结果稳定（可 snapshot test）。
-2. 现有行为不变（含 remind/language guide 插入顺序）。
-
-### 阶段 B：take/commit/rollback 事务边界显式化（核心）
+1. Priming 使用的临时引导 prompt 只作用于当前 drive。
+2. 在同一 drive 的多轮迭代中（工具调用、context remediation、continue）必须持续可见。
+3. 该 prompt 不进入 `dlg.msgs`，不写事件，不落盘，不渲染 UI。
+4. drive 中断/失败后不得残留到下一次 drive。
 
-目标：把“队友回贴消费”从散落标志位改为单一事务状态机。
+### 6.2 Priming 支持实现（简化方案）
 
-交付物：
+核心原则：**不做通用“多生命周期临时 prompt 框架”，只保留 drive 级 priming 通道**。
 
-1. 引入 `TakenResponsesTxn`（建议放在 `main/llm/driver-context-txn.ts`）：
-   - `begin(dlgId)`：take queue
-   - `asInjectedMessages()`：生成注入消息
-   - `markGenerationAttempted()`：至少发起过有效 LLM 请求
-   - `finalize(outcome)`：`commit|rollback`
-2. 用显式 outcome 替代隐式 `generationHadError` 推断。
-3. 把 interrupted 与 error 的 finalize 语义统一。
+1. 在新 driver 中把 priming 输入建模为单一字段：`internalDrivePrimingMsg?: ChatMessage`。
+2. 上下文装配时固定规则：每轮迭代都在末尾注入 `internalDrivePrimingMsg`。
+3. 通过 driver 生命周期自然回收：drive 结束即销毁，不做额外状态机。
+4. 仅保留 `persistMode='internal'` 这一种 priming 入口，不再引入 `next_gen`/scope 分叉。
 
-验收：
+这样可以把 priming 需求落实为“一个字段 + 一条注入规则”，实现面最小化。
 
-1. interrupted/error 必 rollback。
-2. 成功且已尝试生成时 commit。
-3. finalize 幂等（重复调用不会破坏状态）。
+## 7. 两阶段重构计划（按新模块重写）
 
-### 阶段 C：teammate response 单路径入上下文（减少双轨）
+### 阶段 1：新建并上线 `driver-v2`，旧模块原样保留
 
-目标：统一 live 路径与 restore 路径的同构转换，避免“看过但丢失”或重复。
+目标：在新模块里重写 drive 逻辑，旧 `driver.ts` 保持原样，便于并排对比与问题定位。
 
 交付物：
 
-1. 新建 `toTellaskResultMsg(record)` 转换器，统一以下两处：
-   - live commit 后镜像到 `dlg.msgs`
-   - `rebuildFromEvents()` 的重建映射
-2. 显式去重键策略：
-   - 优先 `callId`
-   - 回退 `responseId`
-   - 再回退 `responderId + tellaskHead + completedAt`
-3. diagnostics 中输出“去重前后数量”和命中键类型。
-
-验收：
-
-1. restore 后不重复。
-2. live drive 与 restore drive 的输入上下文等价。
-
-### 阶段 D：\_driveDialogStream 职责分层（可维护性）
-
-目标：把巨函数拆成“稳定编排 + 可替换子模块”。
+1. 新模块（建议）：
+   - `main/llm/driver-v2/index.ts`（对外入口）
+   - `main/llm/driver-v2/orchestrator.ts`（drive 级编排入口）
+   - `main/llm/driver-v2/types.ts`（v2 内部类型与运行态）
+   - `main/llm/driver-v2/context.ts`（上下文装配，含 priming 注入）
+   - `main/llm/driver-v2/policy.ts`（策略模型骨架）
+   - `main/llm/driver-v2/context-health.ts`（context-health 决策骨架）
+   - `main/llm/driver-v2/subdialog-txn.ts`（take/commit/rollback 事务）
+   - `main/llm/driver-v2/supdialog-response.ts`（subdialog 回贴与 auto-revive 编排）
+   - `main/llm/driver-v2/round.ts`（单轮生成与 side effects）
+   - 当前状态（2026-02-09 最新）：`orchestrator` 已去除 `emitSayingEvents / supplyResponseToSupdialog / runBackendDriver` 的 v1 passthrough；`round` 已接管 lock/dead-check/upNext/subdialog-reply 收尾流程；核心循环已切换到 `driver-v2/core.ts:driveDialogStreamCoreV2`，不再调用 `_driveDialogStream/driveDialogStreamCoreV1`。
+   - 仍保留的过渡 bridge（2026-02-09）：`coreV2` 已把重试、diligence、参数校验、saying-event 处理迁入 `driver-v2/`（`runtime-utils.ts`、`saying-events.ts`）；当前仅 `tellask` 执行链仍通过 `driver-v2/tellask-bridge.ts -> driver.ts` 过渡调用，属于阶段 1 末尾需继续收敛的技术债。
+2. 保持旧模块文件不动：
+   - `main/llm/driver.ts` 继续存在，作为对照基线。
+3. 切换方式：
+   - 通过单点入口切换到 v2（建议配置开关或固定切换点），避免多处散改 import。
+   - 当前状态（2026-02-09）：`main/llm/driver-entry.ts` 已支持 `DOMINDS_DRIVER_ENGINE=v1|v2`（默认 `v2`）。
+4. Priming 专项支持：
+   - v2 内置 `internalDrivePrimingMsg` 注入规则（每轮注入、drive 内有效、绝不持久化）。
+5. 关键回归与复放：
+   - `multi-iter subdialog response`
+   - `interrupt rollback`
+   - `commit mirror to dlg.msgs`
+   - `no duplicate after restore`
+   - `internal drive priming persists across iterations`
+   - 复放 `39/12/417f4a49` 风格样本
+
+阶段 1 验收门槛：
+
+1. `pnpm -C dominds run lint:types` 通过。
+2. tellask 相关回归通过。
+3. priming 专项回归通过。
+4. 对比旧 driver，关键语义一致且已知 bug 被修复。
+
+### 阶段 2：v2 稳定后删除旧模块并清理
+
+目标：确认 v2 可稳定替代后，删除旧逻辑，收敛维护面。
 
-建议拆分模块：
-
-1. `prepareDriveInputs(...)`
-2. `buildGenerationContext(...)`
-3. `runGenerationRound(...)`（流式/非流式统一返回形态）
-4. `applyRoundSideEffects(...)`（tool outputs / tellask outputs / upNext）
-5. `finalizeDrive(...)`
-
-验收：
-
-1. `_driveDialogStream` 主体降到“编排层”。
-2. 单模块改动不需触碰整个 while-loop。
-
-### 阶段 E：回归矩阵与复放样本
-
-新增最小回归：
+交付物：
 
-1. `drive-context:multi-iter-subdialog-response.ts`
-2. `drive-context:interrupt-rollback.ts`
-3. `drive-context:commit-mirror-msgs.ts`
-4. `drive-context:no-duplicate-after-restore.ts`
-5. `drive-context:internal-drive-priming-persists-across-iterations.ts`
+1. 删除旧 `driver.ts` 中被 v2 覆盖的实现（或将其瘦身为转发壳并最终移除）。
+2. 清理迁移期开关、对照代码、过渡注释和 dead code。
+3. 固化最终文档：
+   - 新 driver 模块边界
+   - priming 通道语义
+   - 事务边界与错误处理约束
 
-新增复放样本：
+阶段 2 验收门槛：
 
-1. 以 `39/12/417f4a49` 风格构造一条“多轮 + tellask + tool + continue”样本，断言模型能持续看到 teammate 原始回贴语义。
+1. 全量类型检查与回归通过。
+2. 无旧模块引用残留（import/调用链清零）。
+3. 行为与阶段 1 上线结果一致。
 
-## 7. 目标接口草案（供后续实现）
+## 8. 目标接口草案（v2，简化版）
 
 ```ts
-type DriveTransientContext = {
-  subdialogResponseMsgs: ChatMessage[];
-  internalDrivePrimingMsg?: ChatMessage;
-  reminderMsgs: ChatMessage[];
-  languageGuideMsg: ChatMessage;
+type DriveV2Input = {
+  persistedPrompt?: HumanPrompt; // 常规用户输入（会持久化）
+  internalDrivePrimingMsg?: ChatMessage; // 仅 drive 内可见
+  skipTaskdoc?: boolean;
 };
 
-type DriveContextSnapshot = {
-  stableMessages: ChatMessage[];
-  transient: DriveTransientContext;
-  diagnostics: {
-    counts: Record<string, number>;
-    dedupe: { before: number; after: number; by: string[] };
-    genseq?: number;
-    callIds: string[];
-  };
+type DriveV2Runtime = {
+  takenSubdialogResponses: TakenSubdialogResponse[];
+  generationAttempted: boolean;
 };
 ```
 
 说明：
 
-1. `internalDrivePrimingMsg` 仅允许 drive 级语义，不包含单轮模式。
-2. snapshot 不做副作用，不访问持久层。
-3. 所有副作用留在 driver 编排层执行。
+1. priming 只保留 `internalDrivePrimingMsg` 一条路径。
+2. 不提供“下一轮临时注入”接口，避免再次引入语义分叉。
+3. 所有持久化副作用统一在编排层执行，不放进上下文纯函数。
 
-## 8. 重构约束（必须保持）
+## 9. 重构约束（必须保持）
 
 1. 不改变现有 wire 协议事件名与基础语义（除非显式版本升级）。
 2. 不引入 silent fallback；上下文事务异常需 loud 日志与可见错误信号。
 3. 保持 TypeScript strict 与可静态验证属性；禁止 `any`。
-4. 重构每阶段都要求：
-   - `pnpm -C dominds run lint:types` 通过
-   - tellask 相关回归通过
-   - 至少 1 条真实对话复放样本通过（含 auto-revive 场景）
-
-## 9. 执行顺序建议
-
-1. 先做阶段 A，先把“可观察性”补齐。
-2. 再做阶段 B，这是一致性根基。
-3. 再做阶段 C，统一消息路径。
-4. 最后做阶段 D/E，收敛维护复杂度并补齐回归。
-
-该顺序允许在每阶段都可独立回滚，降低一次性大改风险。
+4. 旧模块在阶段 1 必须原样保留，便于对照和回滚。
+
+## 10. 现有测试合理性评估（针对 dlg drive）
+
+结论（2026-02-09 更新）：**覆盖面已明显提升，足以支撑阶段 1 的持续迁移；但仍有未完成的对照/复放用例，尚未达到“可删除旧模块”的阶段 2 门槛**。
+
+### 10.1 现有测试的合理性（优点）
+
+1. 以脚本方式在临时 rtws 跑通关键链路，具备真实文件系统与持久化路径，能抓到不少“运行态”问题。
+2. 已覆盖部分核心行为：
+   - tellask 解析/流式解析稳定性
+   - root auto-revive 基础路径
+   - type B 注册去重基础路径
+   - diligence push/Q4H 的部分事件行为
+3. 执行成本低，适合快速 smoke。
+
+### 10.2 仍存关键缺口（阶段 2 前需补齐）
+
+1. `v1-v2-parity-diligence-q4h.ts` 仍未实现（当前只有 switch-smoke 级别验证，不是逐断言 parity）。
+2. `replay-39-12-417f4a49-style.ts` 仍未实现（尚未形成稳定复放门禁）。
+3. 旧模块仍保留；v2 已激活入口与外围编排，且核心生成循环已独立到 `coreV2`，但仍存在 bridge 依赖（tellask/重试/diligence 等辅助函数），尚未进入“删除旧模块”收敛阶段。
+
+## 11. v2 测试设计与上线门禁
+
+### 11.1 分层策略
+
+1. L0 单元层（纯逻辑，零 I/O）
+   - 目标：验证 v2 新模块内部规则和数据变换。
+   - 关注：context 装配顺序、priming 注入规则、txn 状态机。
+2. L1 集成层（临时 rtws + mock provider）
+   - 目标：验证 drive 主链路和持久化副作用。
+   - 关注：take/commit/rollback、auto-revive、runState、event 语义。
+3. L2 对照/复放层（v1 vs v2）
+   - 目标：验证重写后与既有正确语义一致，且已知 bug 被修复。
+   - 关注：同输入下关键输出等价、上下文可见性不回退。
+
+### 11.2 v2 必做用例（最小集）
+
+1. `driver-v2/context-assembly-order.ts`
+   - 断言：`base -> ephemeral -> tail` 装配顺序稳定，且 reminders/language guide 插入点与现有语义一致。
+   - v1 状态：可跑；已实现并通过（2026-02-09）。
+2. `driver-v2/internal-drive-priming-multi-iter.ts`
+   - 断言：priming 提示在同一 drive 第 1/2/3 轮均可见。
+   - v1 状态：可跑；已实现并通过（2026-02-09）。
+3. `driver-v2/internal-drive-priming-not-persisted.ts`
+   - 断言：priming 不进入 `dlg.msgs`、不写 events、不落盘。
+   - v1 状态：可跑；已实现并通过（2026-02-09）。
+4. `driver-v2/internal-drive-priming-no-leak-next-drive.ts`
+   - 断言：drive 结束后 priming 不泄漏到下一次 drive。
+   - v1 状态：可跑；已实现并通过（2026-02-09）。
+5. `driver-v2/subdialog-queue-interrupt-rollback.ts`
+   - 断言：take 后 interrupted/error 必 rollback，下一次 drive 可重见。
+   - v1 状态：可跑；已实现并通过（2026-02-09）。
+6. `driver-v2/subdialog-queue-commit-mirror.ts`
+   - 断言：成功 commit 后镜像到 `dlg.msgs`，后续不依赖队列注入。
+   - v1 状态：可跑；已实现并通过（2026-02-09）。
+7. `driver-v2/subdialog-restore-live-equivalence.ts`
+   - 断言：restore 路径与 live 路径对 teammate response 的上下文等价。
+   - v1 状态：可跑；已实现并通过（2026-02-09）。`restoreDialogHierarchy(rootId, status)` 需由调用方显式传入状态。
+8. `driver-v2/multi-iter-tool-round-context-continuity.ts`
+   - 断言：工具回合 continue 后，前序关键上下文不丢失。
+   - v1 状态：可跑；已实现并通过（2026-02-09）。
+9. `driver-v2/v1-v2-parity-basic-tellask.ts`
+   - 断言：同 mock 输入下，v1/v2 在可观察语义上等价（除已知 bug 修复差异）。
+   - v1 状态：可跑；已实现并通过（2026-02-09）。
+10. `driver-v2/v1-v2-parity-diligence-q4h.ts`
+    - 断言：diligence/Q4H 关键事件与 runState 语义一致。
+    - v1 状态：尚未实现专门 parity 用例；但已通过 `driver-v2:switch-smoke:engine-v1|v2` 覆盖该链路的切换可用性验证（2026-02-09）。
+
+11. `driver-v2/replay-39-12-417f4a49-style.ts`
+    - 断言：复放样本不再出现“已收到回贴却声称没看到”的语义回归。
+    - v1 状态：可先做“现状复放”脚本；v2 需要转为门禁回归。当前未实现。
+
+### 11.3 阶段 1/2 的测试门禁
+
+阶段 1（v2 上线前）必须通过：
+
+1. `lint:types`
+2. 全部 L0 用例
+3. 全部 L1 最小集（上面 1~7）
+4. 至少 2 个 L2 对照用例（上面 8~9）
+5. priming 专项 3 条（上面 1~3）全部通过
+
+阶段 2（删除旧模块前）必须通过：
+
+1. 阶段 1 全部门禁
+2. 全部 L2 用例（含复放样本）
+3. old-driver 引用清零后再跑一次全套，确保无隐性依赖
+
+### 11.4 执行组织建议
+
+在 `tests/package.json` 里新增独立脚本分组（阶段 1 即可开始）：
+
+1. `driver-v2:unit`
+2. `driver-v2:integration`
+3. `driver-v2:parity`
+4. `driver-v2:replay`
+5. `driver-v2:gate`（汇总门禁脚本）
+
+目的：把“能跑”与“可上线”分开，避免只凭单条 smoke 测试判断重写完成。
+
+当前已落地脚本（2026-02-09）：
+
+1. `driver-v2:integration:engine-v1`
+2. `driver-v2:integration:engine-v2`
+3. `driver-v2:switch-smoke:engine-v1`
+4. `driver-v2:switch-smoke:engine-v2`
+5. `driver-v2:parity`
+
+### 11.5 测试基座约定（script-rtws + mock provider）
+
+1. 阶段 1 的集成测试默认基于 `tests/script-rtws` 运行，避免污染真实 rtws。
+   - 执行约束：统一通过 `tests/cli.ts` 入口传 `-C script-rtws`；不允许其它 rtws。
+   - 并发约束：同一时刻只允许一个 `tests/cli.ts` 进程使用 `script-rtws`，禁止并发执行多个脚本（会互相污染快照与恢复过程）。
+   - 运行收尾：`tests/cli.ts` 默认会在脚本结束后将 `tests/script-rtws` 恢复到“测试前快照”（可通过 `DOMINDS_TEST_RTWS_RESTORE_MODE=head` 改为恢复到 git HEAD；`DOMINDS_TEST_RTWS_RESTORE=0` 可禁用自动恢复用于调试）。
+2. 默认使用 `apiType: mock`，通过 `mock-db/<model>.yaml` 驱动可重复测试。
+   - driver 入口切换统一走 `main/llm/driver-entry.ts`，通过环境变量 `DOMINDS_DRIVER_ENGINE=v1|v2` 选择引擎；测试代码避免直接调用 `driveDialogStream` 的 v1 直连入口。
+3. mock 响应可使用：
+   - `delayMs`：整次响应前延迟（用于中断/rollback窗口）
+   - `chunkDelayMs`：流式分块延迟（用于流顺序与 stop 时序）
+   - `funcCalls`：响应后追加函数调用序列（用于工具回合/continue 测试）
+   - `contextContains`：要求上下文中必须包含指定片段（用于上下文连续性断言）
+4. 需要“慢速请求”场景时，优先在 mock 数据层配置，不依赖真实外部 provider。

package/dist/llm/driver-entry.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getActiveDriverEngine = getActiveDriverEngine;
+exports.driveDialogStream = driveDialogStream;
+exports.emitSayingEvents = emitSayingEvents;
+exports.supplyResponseToSupdialog = supplyResponseToSupdialog;
+exports.runBackendDriver = runBackendDriver;
+const driver_1 = require("./driver");
+const driver_v2_1 = require("./driver-v2");
+function resolveActiveDriverEngine() {
+    const raw = process.env.DOMINDS_DRIVER_ENGINE;
+    if (raw === undefined) {
+        return 'v2';
+    }
+    const normalized = raw.trim().toLowerCase();
+    if (normalized === '' || normalized === 'v2') {
+        return 'v2';
+    }
+    if (normalized === 'v1') {
+        return 'v1';
+    }
+    throw new Error(`Invalid DOMINDS_DRIVER_ENGINE=${JSON.stringify(raw)} (expected "v1" or "v2")`);
+}
+// Single switch point for rollout/tests.
+const ACTIVE_DRIVER_ENGINE = resolveActiveDriverEngine();
+function getActiveDriverEngine() {
+    return ACTIVE_DRIVER_ENGINE;
+}
+async function driveDialogStream(...args) {
+    if (ACTIVE_DRIVER_ENGINE === 'v2') {
+        return await (0, driver_v2_1.driveDialogStream)(...args);
+    }
+    return await (0, driver_1.driveDialogStream)(...args);
+}
+async function emitSayingEvents(...args) {
+    if (ACTIVE_DRIVER_ENGINE === 'v2') {
+        return await (0, driver_v2_1.emitSayingEvents)(...args);
+    }
+    return await (0, driver_1.emitSayingEvents)(...args);
+}
+async function supplyResponseToSupdialog(...args) {
+    if (ACTIVE_DRIVER_ENGINE === 'v2') {
+        return await (0, driver_v2_1.supplyResponseToSupdialog)(...args);
+    }
+    return await (0, driver_1.supplyResponseToSupdialog)(...args);
+}
+function runBackendDriver() {
+    if (ACTIVE_DRIVER_ENGINE === 'v2') {
+        return (0, driver_v2_1.runBackendDriver)();
+    }
+    return (0, driver_1.runBackendDriver)();
+}

package/dist/llm/driver-v2/context-health.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decideDriverV2ContextHealth = decideDriverV2ContextHealth;
+function decideDriverV2ContextHealth(args) {
+    const { snapshot } = args;
+    if (!snapshot || snapshot.kind !== 'available') {
+        return { kind: 'proceed' };
+    }
+    if (snapshot.level === 'healthy') {
+        return { kind: 'proceed' };
+    }
+    if (snapshot.level === 'caution') {
+        return args.hadUserPromptThisGen
+            ? { kind: 'proceed' }
+            : { kind: 'continue', reason: 'caution_soft_remediation' };
+    }
+    if (snapshot.level === 'critical') {
+        if (args.criticalCountdownRemaining <= 0) {
+            return { kind: 'continue', reason: 'critical_force_new_course' };
+        }
+        return args.hadUserPromptThisGen
+            ? { kind: 'suspend', reason: 'critical_wait_human' }
+            : { kind: 'continue', reason: 'critical_countdown_remediation' };
+    }
+    const _exhaustive = snapshot.level;
+    return _exhaustive;
+}

package/dist/llm/driver-v2/context.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDriveBaseContextMessages = buildDriveBaseContextMessages;
+exports.appendDriveEphemeralContext = appendDriveEphemeralContext;
+exports.appendDriveTailContext = appendDriveTailContext;
+exports.assembleDriveContextMessages = assembleDriveContextMessages;
+function findLastUserPromptLikeIndex(msgs) {
+    for (let i = msgs.length - 1; i >= 0; i--) {
+        const msg = msgs[i];
+        if (msg &&
+            (msg.type === 'prompting_msg' || msg.type === 'environment_msg') &&
+            msg.role === 'user') {
+            return i;
+        }
+    }
+    return -1;
+}
+function insertBeforeLastUserPromptLike(msgs, toInsert) {
+    if (toInsert.length === 0)
+        return [...msgs];
+    const next = [...msgs];
+    const insertIndex = findLastUserPromptLikeIndex(next);
+    if (insertIndex >= 0) {
+        next.splice(insertIndex, 0, ...toInsert);
+    }
+    else {
+        next.push(...toInsert);
+    }
+    return next;
+}
+function buildDriveBaseContextMessages(parts) {
+    return [
+        ...parts.prependedContextMessages,
+        ...parts.memories,
+        ...(parts.taskDocMsg ? [parts.taskDocMsg] : []),
+        ...parts.coursePrefixMsgs,
+        ...parts.dialogMsgsForContext,
+    ];
+}
+function appendDriveEphemeralContext(base, parts) {
+    const next = [...base];
+    if (parts.subdialogResponseContextMsgs.length > 0) {
+        next.push(...parts.subdialogResponseContextMsgs);
+    }
+    if (parts.internalDrivePromptMsg) {
+        next.push(parts.internalDrivePromptMsg);
+    }
+    return next;
+}
+function appendDriveTailContext(source, parts) {
+    const withReminders = insertBeforeLastUserPromptLike(source, parts.renderedReminders);
+    return insertBeforeLastUserPromptLike(withReminders, [parts.languageGuideMsg]);
+}
+function assembleDriveContextMessages(args) {
+    const baseMsgs = buildDriveBaseContextMessages(args.base);
+    const withEphemeral = appendDriveEphemeralContext(baseMsgs, args.ephemeral);
+    return appendDriveTailContext(withEphemeral, args.tail);
+}