@tea-agent/loop-agent 0.36.4-beta.0 → 0.37.1-beta.0

package/docs/templates/frontend-task-requirement.md

@@ -1,104 +1,70 @@
 # 前端任务需求模板
 
-本模板只承载**通用编写协议 + 三要素 + fail-closed 规则**，不包含任何具体业务组件名、项目专属路径或项目专属命令。填写时每一节都要给出「**要写什么** / **DAG 如何消费** / **缺失/冲突时 fail-closed**」三要素；缺节、空占位或与验收标准冲突时必须阻塞，不得由模型猜测补写。
-
 ## 用户目标
 
-- **要写什么**：以用户视角写清本次要交付的前端行为与用户价值——用户能完成什么、为什么需要它、成功后的可观察结果。必须可验证（可被界面状态或交互断言覆盖），不得只写技术动作或孤立关键词。
-- **DAG 如何消费**：`frontend-contract-pi` 把它映射为 Scope 与 `requirements[].expectedOutcome`，`frontend-plan-pi` 据它安排实现步骤并映射验收标准。
-- **缺失/冲突时 fail-closed**：缺失用户目标，或用户目标与验收标准互相矛盾时阻塞（`request-revision`/blocked），不得猜测补写或改写为技术实现描述。
+TODO
 
 ## 目标页面/组件/路由
 
-- **要写什么**：明确本次交付涉及的目标路由、页面入口与组件范围，逐条列出路径/名称与职责边界；相关但超出范围的页面写清「不做」。
-- **DAG 如何消费**：对齐 `docs/runtime/frontend-implementation-workflow.md` §「需求.md 应包含」的「目标路由/页面/组件」，`frontend-contract-pi` 据它确定 `targets.files` / `targets.routes`，`frontend-plan-pi` 据它划定 writeSet 与实现步骤。
-- **缺失/冲突时 fail-closed**：无法确定目标路由/页面/组件，或范围与验收标准不一致时阻塞；只写泛化名词（如「页面」「组件」）而不给具体范围视为缺失。
+TODO
 
 ## 用户流程
 
-- **要写什么**：写清端到端用户路径，从入口到结果，逐步列出触发动作、顺序与关键分支；涉及多页面/多状态时把每条路径分开写。
-- **DAG 如何消费**：`frontend-contract-pi` 据它抽取 `interactions[]`（每条带 `trigger` 与 `expectedBehavior`），`frontend-plan-pi` 据它安排组件/状态/交互实现步骤。
-- **缺失/冲突时 fail-closed**：缺少可执行的端到端路径、流程与验收标准冲突或关键分支未写时阻塞，不得只写「用户进入页面即可」。
+TODO
 
 ## 必须状态
 
-每个适用状态必须写清该状态的触发条件与预期界面表现；不适用状态必须写 `N/A` 并给出非空理由（对齐 runtime 的 `uiStates` / N/A state 规则）。
-
 ### loading
 
-- **要写什么**：loading 状态出现与结束的触发条件、展示内容（骨架/文案/禁用交互）与超时/失败转移。
-- **DAG 如何消费**：进入 implementation contract 的 `uiStates[]`（`name: "loading"`），`frontend-implement-pi` 按它实现，verify 用它的 `verificationTargetIds` 断言。
-- **缺失/冲突时 fail-closed**：适用但缺失预期行为时阻塞；不适用必须写 `N/A` 并给非空理由，只写 `N/A` 不带理由同样阻塞。
+TODO
 
 ### empty
 
-- **要写什么**：无数据/无结果状态的触发条件与展示（空态文案/引导动作/是否可刷新）。
-- **DAG 如何消费**：进入 `uiStates[]`（`name: "empty"`），verify 断言空态展示与引导。
-- **缺失/冲突时 fail-closed**：适用但缺失预期行为、或与 success/error 展示冲突时阻塞；不适用写 `N/A` + 非空理由。
+TODO
 
 ### error
 
-- **要写什么**：失败状态（请求失败/校验失败/权限失败）的触发条件、错误展示与可恢复动作。
-- **DAG 如何消费**：进入 `uiStates[]`（`name: "error"`），verify 断言错误展示与重试/回退行为。
-- **缺失/冲突时 fail-closed**：适用但缺失错误预期、或错误态会覆盖用户数据时阻塞；不适用写 `N/A` + 非空理由。
+TODO
 
 ### success
 
-- **要写什么**：成功状态的触发条件与展示（数据呈现/确认反馈/后续入口）。
-- **DAG 如何消费**：进入 `uiStates[]`（`name: "success"`），verify 断言成功展示与验收标准对应。
-- **缺失/冲突时 fail-closed**：成功态与验收标准不一致、或缺失成功结果时阻塞；不适用写 `N/A` + 非空理由。
+TODO
 
 ### disabled
 
-- **要写什么**：禁用/不可交互状态的触发条件（权限/前置未满足/进行中）与视觉/交互表现。
-- **DAG 如何消费**：进入 `uiStates[]`（`name: "disabled"`），verify 断言禁用态不会被误触。
-- **缺失/冲突时 fail-closed**：适用但缺失禁用条件、或禁用态与交互要求冲突时阻塞；不适用写 `N/A` + 非空理由。
+TODO
 
 ## 目标运行环境
 
-每个环境必须声明适用性；不适用环境写 `N/A` 并给非空理由。
-
 ### desktop
 
-- **要写什么**：desktop 视口下的适用性声明与关键布局/交互差异（断点、栅格、悬停等）。
-- **DAG 如何消费**：进入 contract 的 target runtime environment，`frontend-plan-pi` 据它决定响应式范围与样式策略。
-- **缺失/冲突时 fail-closed**：适用但缺失断点/布局说明，或与响应式要求冲突时阻塞；不适用写 `N/A` + 非空理由。
+TODO
 
 ### mobile
 
-- **要写什么**：mobile 视口下的适用性声明与触控/布局/安全区差异。
-- **DAG 如何消费**：进入 target runtime environment，`frontend-plan-pi` 据它决定响应式范围与组件策略。
-- **缺失/冲突时 fail-closed**：适用但缺失移动端表现，或与交互要求冲突时阻塞；不适用写 `N/A` + 非空理由。
+TODO
 
 ### tablet
 
-- **要写什么**：tablet 视口下的适用性声明与中间断点表现。
-- **DAG 如何消费**：进入 target runtime environment，`frontend-plan-pi` 据它决定响应式策略。
-- **缺失/冲突时 fail-closed**：适用但缺失 tablet 表现时阻塞；不适用写 `N/A` + 非空理由。
+TODO
 
 ## 交互要求
 
-- **要写什么**：逐条写清每个可交互元素的触发动作与预期行为（点击/输入/提交/滚动/键盘等），可被自动化断言覆盖。
-- **DAG 如何消费**：对齐 §「需求.md 应包含」的「交互要求」，`frontend-contract-pi` 抽取 `interactions[]`（`trigger` + `expectedBehavior`），verify 用行为命令断言。
-- **缺失/冲突时 fail-closed**：交互触发或预期行为缺失、与 UI 状态冲突、或不可自动化断言时阻塞，不得用「用户可正常操作」这类空话。
+TODO
 
 ## 接口与 Mock 输入
 
-- **接口文档/schema — 要写什么**：引用接口文档或任务附件路径与版本，声明请求/响应 schema 来源。**DAG 如何消费**：`frontend-plan-pi` 据此选择 Mock 策略并冻结 endpoint/fixture 映射。**缺失/冲突时 fail-closed**：涉及接口但未引用文档或 schema 时阻塞，不得自行发明字段。
-- **endpoint、method、关键请求/响应字段 — 要写什么**：逐条列出 method、path 与关键字段及含义。**DAG 如何消费**：写入 `mockApi.endpoints[]`（method/path/fixture/consumer）。**缺失/冲突时 fail-closed**：字段缺失、与接口文档冲突或路径不合法时阻塞。
-- **是否允许依赖真实后端 — 要写什么**：明确声明真实后端当前是否可调用、是否允许生产/预览依赖真实请求。**DAG 如何消费**：决定 `mockApi.strategy` 是否可选 `not-needed`（需要真实/无远程证据）。**缺失/冲突时 fail-closed**：未声明后端就绪度却要求真实数据时阻塞，选 `not-needed` 却没有真实/无远程证据会被拦截。
-- **是否要求离线或独立行为验证 — 要写什么**：声明是否需要离线、本地预览或自动化行为验证（或两者都要）。**DAG 如何消费**：决定生成期 `frontendMock.verifyCommands` 与冻结命令集。**缺失/冲突时 fail-closed**：要求离线/自动化却未声明确定性验证命令时，生成期收敛为 `not-needed` 或直接 blocked，plan-revision 无法修复。
-- **success/empty/error/permission 状态 — 要写什么**：逐条声明接口各响应状态对应的 UI 表现。**DAG 如何消费**：与「必须状态」交叉校验，写入 `uiStates[]` 与 fixture 映射。**缺失/冲突时 fail-closed**：接口状态与 UI 状态不匹配或缺失 permission 分支时阻塞。
-- **后端当前就绪状态与 Real Integration Gap — 要写什么**：写清后端是否就绪、未就绪时保留的 Real Integration Gap 与后端就绪后的复验路径。**DAG 如何消费**：进入 `evidenceGaps[]` 与 closeout 的 `Real integration: pending`。**缺失/冲突时 fail-closed**：声称已联通真实接口却无真实证据时阻塞；未就绪却把 Mock 结果写成真实联调会被 review 拒绝。
+- 接口文档/schema：TODO
+- endpoint、method、关键请求/响应字段：TODO
+- 是否允许依赖真实后端：TODO
+- 是否要求离线或独立行为验证：TODO
+- success/empty/error/permission 状态：TODO
+- 后端当前就绪状态与 Real Integration Gap：TODO
 
 ## 验收标准
 
-- **要写什么**：逐条编号（如 `AC-001`）写出可独立断言的前端验收标准，每条都能映射到需求与一个 verification target（可逐条追踪）。
-- **DAG 如何消费**：`frontend-contract-pi` 生成 `requirements[].verificationTargetIds` 映射，`frontend-plan-pi` 把每条 AC 落到有序步骤与验证命令，verify 逐条断言。
-- **缺失/冲突时 fail-closed**：无验收标准、AC 无法映射到需求/验证目标、或 AC 与其它节冲突时阻塞，不得把「看起来能用」当验收。
+TODO
 
 ## 非目标
 
-- **要写什么**：明确列出本次不做的前端范围/排除项（页面、组件、交互、浏览器/视觉/无障碍检查等）。
-- **DAG 如何消费**：`frontend-contract-pi` 记录为 Non-goals，`frontend-review-pi` 据它拒绝范围扩散。
-- **缺失/冲突时 fail-closed**：非目标与目标/验收标准冲突、或范围被悄悄扩大时阻塞；明确不做前端时也必须写入非目标。
+TODO

package/docs/templates/init-managed-agents.md

@@ -33,8 +33,7 @@
 | **允许** | 已发布 `loop-agent` / `agent-worker` CLI；只读 status/doctor/report/inspect/observe；准备 `source/*` 与 `task.json` 边界；human gate；shell 验证与 handoff。 |
 | **禁止** | 绕过 CLI 用宿主 Edit/Write/ApplyPatch 直接改业务实现；CLI/DAG 失败后「救火改文件」；用聊天自述代替 shell 验证。 |
 | **失败时** | 先 `dag report` / `dag doctor`；优先 `dag rerun --from-node` 安全子图续跑；仅契约/源真变或 plan 不合格时同 task 重 advance / `dag rerun-task`；paused 用 approve→`dag resume`。 |
-| **实现写入** | 业务代码 **只** 经受治理 DAG writer（`implement-pi` / `repair-pi`）经 `task advance`（批准 writeSet gate 后长跑）由 Console operation 后台持有；主会话**不得**在前台 Bash 直接执行 `task advance --approve-gate`，不得把长跑命令管道到 `tail`/`head`，不得自行拼接 `nohup` / `Start-Process` / `start`。 |
-| **契约漂移** | 直接编辑 `source/需求.md` / `执行约束.md` 后契约会进入 `externally-modified`，此时 advance/dagRunTask 拒用新内容（DIRTY_SOURCE / hash 不一致）。合法收编路径：`task contract adopt --task <id> --expected-revision <n> --expected-observed-hash <hash> --request-id <id> --request-payload-sha256 <sha>`（hash 从 `task status --json` 的 `contract.observedCanonicalHash` 取）；或改 PRD 后重新 importPrd 走完整重投影。禁止手工改 `lifecycle.json` / `.transactions/` 绕过。 |
+| **实现写入** | 业务代码 **只** 经受治理 DAG writer（`implement-pi` / `repair-pi`）经 `task advance`（批准 writeSet gate 后长跑）。 |
 
 **永远不要**：`loop-agent` / `agent-worker` 失败 ⇒ 主会话直接改仓库实现；也勿因 provider 抖动或只读节点失败**新建无关 task-id**。
 
@@ -110,8 +109,6 @@ loop-agent task status <task-id> --json
 # 有 plan 时收尾：loop-agent plan complete <plan-id> --summary "..."
 ```
 
-长跑 DAG 采用 `prepareDagExecution → runDag → operationId` 异步 operation 路径（`--approve-gate` 不在前台 Bash 中同步等待）；监督退避 60 → 90 → 120 → 180 秒，状态变化后重置为 60 秒，疑似 stall 用 30–60 秒复查。
-
 `--verify` 命令应取项目 `AGENTS.md` / `__LOOP_AGENT_GOVERNANCE_ROOT__/verification-matrix.md` 登记的验证命令（不要假定 `npm run typecheck` 存在）；`--verify` 可选，省略时自动从 package.json scripts 或既有 managed `task.json.verifyCommands` 推导建议。
 
 `source/需求.md` 与 `source/执行约束.md` 仍必需（M8/M9），但默认由 `task advance --prd` 投影生成，而不是主会话手写。`plan create` 不是 `task advance` 的硬依赖。写入前同步 `task.json.allowedPaths` / `task.json.forbiddenPaths` 并审查 writer `writeSet`。高级任意 DagSpec 才用 `dag validate|execute|report`，不进入标准 happy path。
@@ -142,7 +139,7 @@ live run 先用 `loop-agent dag status --run-id <run-id>` 看 lifecycle 与 live
 
 **失败默认恢复序**：`dag report`/`dag doctor` → 优先 `dag rerun --from-node <node> --plan` 再带 `--plan-hash`（provider 抖动、plan/review/verify 安全下游；writer/decision/fingerprint 不合格勿硬跑）→ paused：approve→`dag resume` → 契约/源真变或 R1 不合格：同 task `task advance` / `dag rerun-task`（禁无理由新建 task-id）→ Worker-owned：`agent-worker task retry`。
 
-Operator 须监控 live run 至终态（FINISHED / FAILED / partial_failed）或 Decision Gate 需要 approve；监督退避 60 → 90 → 120 → 180 秒（状态变化后重置 60 秒，疑似 stall 用 30–60 秒复查），长跑 DAG 由 Console operation 后台持有（`prepareDagExecution → runDag → operationId`），禁止前台 Bash 直接 `task advance --approve-gate`、禁止管道 `tail`/`head`、禁止自行拼接 `nohup` / `Start-Process` / `start`；可在节点/rank 变化、verify/closeout、stall 或需 approve 时简短汇报（告知非请求确认）。判活须组合 runner heartbeat、session events 与 `dag doctor` liveness/provider meaningful progress（heartbeat alone ≠ progress）。bounded writer 运行期间不得并发修改工作区（write guard / write-guard 会把越界 diff 错误归因到 writer）；只读 status/doctor/report 与 approve/reject/resume 仍允许。恢复：report/doctor → **优先** `dag rerun --from-node` → 必要时 rerun-task/同 task advance → shell verify。**禁止**把主会话直接 Edit 业务代码当作恢复手段。
+Operator 须监控 live run 至终态（FINISHED / FAILED / partial_failed）或 Decision Gate 需要 approve；可在节点/rank 变化、verify/closeout、stall 或需 approve 时简短汇报（告知非请求确认）。判活须组合 runner heartbeat、session events 与 `dag doctor` liveness/provider meaningful progress（heartbeat alone ≠ progress）。bounded writer 运行期间不得并发修改工作区（write guard / write-guard 会把越界 diff 错误归因到 writer）；只读 status/doctor/report 与 approve/reject/resume 仍允许。恢复：report/doctor → **优先** `dag rerun --from-node` → 必要时 rerun-task/同 task advance → shell verify。**禁止**把主会话直接 Edit 业务代码当作恢复手段。
 
 ### 运行态与验证
 

package/harness.json

@@ -79,9 +79,9 @@
   },
   "executors": {
     "pi": {
-      "description": "Pi 负责规划、评审、诊断；当 DAG toolProfile=write 时也可做有界写入。模型按复杂度三档配置，支持 provider/model 字符串或带 thinking 的对象；斜杠前为 Pi provider，后为 modelId，勿只写裸 modelId。",
+      "description": "Pi 负责规划、评审、诊断；当 DAG toolProfile=write 时也可做有界写入。模型按复杂度三档配置，格式为 provider/model 字符串（例：wizard-local/grok-4.5）；斜杠前为 Pi provider，后为 modelId，勿只写裸 modelId。",
       "LOW": "wizard-local/minimax-m3",
-      "MED": "wizard-local/grok-4.6",
+      "MED": "wizard-local/grok-4.5",
       "HIGH": "wizard-local/gpt-5.6-sol"
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tea-agent/loop-agent",
-  "version": "0.36.4-beta.0",
+  "version": "0.37.1-beta.0",
   "type": "module",
   "bin": {
     "loop-agent": "bin/loop-agent.js",
@@ -45,7 +45,7 @@
     "pi-prompt": "node --import tsx/esm src/cli.ts pi-prompt",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
     "brand:sync": "node scripts/sync-brand-assets.mjs",
-    "build": "npm run brand:sync && npm run clean && tsc -p tsconfig.build.json && node -e \"const fs=require('node:fs');const p='dist/worker/observe/static';fs.mkdirSync(p,{recursive:true});fs.cpSync('src/worker/observe/static',p,{recursive:true});\" && npm run console:build && node scripts/write-build-stamp.mjs",
+    "build": "npm run brand:sync && npm run clean && tsc -p tsconfig.build.json && node -e \"const fs=require('node:fs');const p='dist/worker/observe/static';fs.mkdirSync(p,{recursive:true});fs.cpSync('src/worker/observe/static',p,{recursive:true});\" && npm run console:build",
     "console:typecheck": "tsc -p src/worker/console/tsconfig.json",
     "console:build": "npm run console:typecheck && vite build --config src/worker/console/vite.config.ts",
     "prepack": "npm run build",
@@ -88,6 +88,5 @@
     "typescript": "^5.9.3",
     "vite": "^7.0.0",
     "vitest": "^3.2.4"
-  },
-  "packageManager": "pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319"
+  }
 }

package/skills/loop-agent/SKILL.md

@@ -24,7 +24,6 @@ references:
 ## 初始化升级路由
 
 - 写入型「**loop-agent初始化更新**」「loop-agent 初始化更新」「更新 loop-agent 初始化内容」「升级后对齐」统一运行 `loop-agent init upgrade --repo-root . --json`；处理 controller 返回的单文件 `allowedPaths`，以同一 run `--continue` 推进至终态，不停在中间状态。
-- 升级可能因 gitignore 迁移评估暂停：若 `.agents/` 存在已跟踪内容，需先审查是否有应团队共享的自定义内容；存在 staged 变更或 git 查询失败时需先解决 blocker，再重跑评估。建议的 `git rm -r --cached --ignore-unmatch` 只修改 index、保留工作区文件，且由用户执行而非 controller。
 - 「检查初始化更新」「初始化更新校验」「只检查，不要修改」仅运行 `loop-agent init check-update --repo-root . --markdown`，不得创建 run 或写入。
 - facts 位于 `.harness/init-upgrades/<run-id>/`；禁止业务源码和宽泛 glob。默认管理项目 `.opencode/plugins/`、`.pi/extensions/`、`.pi/settings.json`；Pi trust 后加载，默认不读写 `~/.pi/agent/settings.json`。
 

package/skills/loop-agent/references/command-reference.md

@@ -152,8 +152,6 @@ fresh init 将精确引用写到 `executors.pi.LOW/MED/HIGH`。fresh `loop-agent
 
 `init upgrade` 是写入型升级入口：首次运行冻结 controller identity、检查 npm latest、扫描 surface、自动执行安全动作，并把 run facts 持久化到 `.harness/init-upgrades/<run-id>/`。`--status` 与 `--report` 严格只读；`--continue` 会重新核验 identity、当前 hash 与不变量。版本选择、无法判定冲突、凭据、破坏性删除或 active writer 才进入 human decision。普通语义冲突返回具体单文件 `allowedPaths` merge task，主会话必须合并后继续，不能把 `needs-model-merge` 作为完成。默认管理项目级 OpenCode/Pi recovery 与 `.pi/settings.json` nested merge，保留显式 disabled，Pi trust 后才加载；默认不读写 `~/.pi/agent/settings.json`。旧 `init reconcile` 保留为兼容低层诊断。
 
-升级在 managed block 收敛后生成只读 gitignore 迁移评估（`.harness/init-upgrades/<run-id>/gitignore-migration.json`）：inventory 已跟踪的 `.harness/**` 与 `.agents/**`，建议 index-only 命令 `git rm -r --cached --ignore-unmatch .harness` / `.agents`（只改 index、保留工作区文件；`scripts/**` 与 `ai_workspace/loop-agent/**` 永不出现）。`.agents` 已跟踪内容会触发 human-decision 暂停等待审查；非 Git 仓库、git 查询失败或存在 staged 条目时 `status: blocked` 且无命令建议。controller 不自动修改 Git index。
-
 ### 查看或复制内置示例
 
 ```bash
@@ -321,7 +319,6 @@ loop-agent dag report [--run-id <run-id>] [--lifecycle active|paused|completed|a
 loop-agent dag reconcile-run --run-id <run-id>            # 只读检查 effectiveStatus 与恢复/收口资格
 loop-agent dag reconcile-run --run-id <run-id> --action supersede --reason "..." # 显式保留证据并标记为任务已另行完成
 loop-agent dag reconcile-run --run-id <run-id> --action abandon --reason "..."   # 显式保留证据并收口为已放弃
-loop-agent dag request-interrupt --run-id <run-id> --request-id <id> --target-operation-id <id> --reason-code <code> --reason <detail> [--json]  # 协作中止：写入 interrupt.json（identity CAS）；需配 --expected-runner-pid/--expected-runner-hostname 校验 runner 身份
 loop-agent dag rerun --run-id <run-id> --from-node <node-id> --plan [--json]  # 从节点重跑资格预检（不执行）
 loop-agent dag rerun --run-id <run-id> --from-node <node-id> --plan-hash <sha256> --request-id <key> --reason "..." [--json]  # 安全子图 continuation
 loop-agent dag rerun-task --run-id <run-id> --reason "..." --request-id <key> [--profile auto] [--task-id <id>] [--json]  # standalone 完整任务重跑

package/dist/build-stamp.json

@@ -1,6 +0,0 @@
-{
-  "schemaVersion": 1,
-  "version": "0.36.4-beta.0",
-  "gitSha": "b4d154e6c1e109f754c059c22588cfd0298d4764",
-  "builtAt": "2026-08-16T17:25:17.099Z"
-}

package/dist/commands/dag-request-interrupt.js

@@ -1,20 +0,0 @@
-import { DagInterruptError, executeDagRequestInterrupt, parseDagRequestInterruptArgs, } from "../workflows/dag/interrupt-request.js";
-export { parseDagRequestInterruptArgs, executeDagRequestInterrupt };
-export async function runDagRequestInterrupt(repoRoot, rawArgs) {
-    try {
-        const result = await executeDagRequestInterrupt(repoRoot, rawArgs);
-        console.log(JSON.stringify(result, null, 2));
-    }
-    catch (error) {
-        if (error instanceof DagInterruptError) {
-            console.log(JSON.stringify({
-                ok: false,
-                code: error.code,
-                message: error.message,
-            }, null, 2));
-            process.exitCode = 1;
-            return;
-        }
-        throw error;
-    }
-}

package/dist/worker/console/chat/assistant-content.js

@@ -1,121 +0,0 @@
-/**
- * Assistant content-block helpers shared by Pi event mapping and Operator Chat UI.
- * Mirrors pi-web `lib/message-display.ts` (process vs answer split) without deferred fetch.
- */
-function asRecord(value) {
-    if (!value || typeof value !== "object")
-        return undefined;
-    return value;
-}
-function readString(value) {
-    return typeof value === "string" ? value : undefined;
-}
-/** Parse a persisted/SSE content array; unknown shapes are dropped. */
-export function parseAssistantContent(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const blocks = [];
-    for (const item of value) {
-        const rec = asRecord(item);
-        if (!rec)
-            continue;
-        const type = readString(rec.type) ?? "";
-        if (type === "thinking" || type === "reasoning") {
-            const thinking = readString(rec.thinking) ?? readString(rec.text) ?? "";
-            blocks.push({ type: "thinking", thinking });
-            continue;
-        }
-        if (type === "toolCall" ||
-            type === "tool_call" ||
-            type === "toolUse" ||
-            type === "tool_use") {
-            const toolCallId = readString(rec.toolCallId) ?? readString(rec.id) ?? "";
-            if (!toolCallId)
-                continue;
-            const toolName = readString(rec.toolName) ?? readString(rec.name);
-            blocks.push({
-                type: "toolCall",
-                toolCallId,
-                ...(toolName ? { toolName } : {}),
-            });
-            continue;
-        }
-        if (type === "text" || type === "output_text" || type === "") {
-            const text = readString(rec.text);
-            if (text !== undefined)
-                blocks.push({ type: "text", text });
-        }
-    }
-    return blocks;
-}
-/**
- * Extract ordered assistant content blocks from a Pi SDK message object.
- * Thinking/reasoning blocks keep their own type so they never leak into answer text.
- */
-export function extractAssistantContentBlocks(message) {
-    const rec = asRecord(message);
-    if (!rec)
-        return [];
-    const contents = Array.isArray(rec.content) ? rec.content : [];
-    const parts = Array.isArray(rec.parts) ? rec.parts : [];
-    const fromArrays = parseAssistantContent([...contents, ...parts]) ?? [];
-    if (fromArrays.length > 0)
-        return fromArrays;
-    const top = readString(rec.text);
-    return top ? [{ type: "text", text: top }] : [];
-}
-/**
- * Pi emits message_end for user / toolResult / custom too. Only assistant
- * payloads belong in the Operator Chat assistant bubble (pi-web same split).
- */
-export function isAssistantSdkMessage(message) {
-    const rec = asRecord(message);
-    if (!rec)
-        return false;
-    const role = readString(rec.role);
-    return role === undefined || role === "assistant";
-}
-/**
- * Latest assistant answer text (text blocks only). Thinking is excluded.
- * Preserves the historical `{ text }` / `{ parts: [{ text }] }` fallbacks.
- */
-export function extractAssistantText(message) {
-    return extractAssistantContentBlocks(message)
-        .filter((block) => block.type === "text")
-        .map((block) => block.text)
-        .join("");
-}
-export function isEmptyThinkingBlock(block, options = {}) {
-    return (block.type === "thinking" &&
-        !options.isStreaming &&
-        block.thinking.trim() === "");
-}
-export function getDisplayableAssistantBlocks(blocks, options = {}) {
-    return blocks.filter((block) => !isEmptyThinkingBlock(block, options));
-}
-function isFinalAnswerBlock(block) {
-    return block.type === "text";
-}
-export function splitFinalAssistantBlocks(blocks, options = {}) {
-    const displayable = getDisplayableAssistantBlocks(blocks, options);
-    let lastProcessIndex = -1;
-    for (let i = displayable.length - 1; i >= 0; i--) {
-        if (!isFinalAnswerBlock(displayable[i])) {
-            lastProcessIndex = i;
-            break;
-        }
-    }
-    if (lastProcessIndex === -1) {
-        return { answerBlocks: displayable, processBlocks: [] };
-    }
-    return {
-        answerBlocks: displayable.slice(lastProcessIndex + 1),
-        processBlocks: displayable.slice(0, lastProcessIndex + 1),
-    };
-}
-export function joinAssistantText(blocks) {
-    return blocks
-        .filter((block) => block.type === "text")
-        .map((block) => block.text)
-        .join("");
-}