@zergai/ztc 0.4.0-beta.1 → 0.5.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (718) hide show
  1. package/README.md +398 -45
  2. package/RUST_THIRD_PARTY_LICENSES.txt +1080 -822
  3. package/THIRD_PARTY_NOTICES.md +273 -12
  4. package/bin/zmux-darwin-arm64 +0 -0
  5. package/bin/ztc-audio-darwin-arm64 +0 -0
  6. package/bin/ztc-capture-darwin-arm64 +0 -0
  7. package/bin/ztc-computer-darwin-arm64 +0 -0
  8. package/bin/ztc-llm-darwin-arm64 +0 -0
  9. package/bin/ztc-tts-darwin-arm64 +0 -0
  10. package/bin/ztc-tui-darwin-arm64 +0 -0
  11. package/bin/ztc-zlicky-overlay-darwin-arm64 +0 -0
  12. package/bin/zterm-darwin-arm64 +0 -0
  13. package/dist/App.js +1206 -209
  14. package/dist/agent/agent.d.ts +74 -8
  15. package/dist/agent/agent.js +1073 -184
  16. package/dist/agent/backends/account_rotation.d.ts +4 -0
  17. package/dist/agent/backends/account_rotation.js +8 -2
  18. package/dist/agent/backends/anthropic.d.ts +13 -0
  19. package/dist/agent/backends/anthropic.js +169 -28
  20. package/dist/agent/backends/claude_cli.js +18 -8
  21. package/dist/agent/backends/codex_app_server.d.ts +1 -0
  22. package/dist/agent/backends/codex_app_server.js +55 -3
  23. package/dist/agent/backends/codex_auth.d.ts +1 -0
  24. package/dist/agent/backends/codex_auth.js +67 -13
  25. package/dist/agent/backends/codex_buffered_recovery.d.ts +27 -0
  26. package/dist/agent/backends/codex_buffered_recovery.js +293 -0
  27. package/dist/agent/backends/gemini.js +3 -1
  28. package/dist/agent/backends/http_error.d.ts +26 -0
  29. package/dist/agent/backends/http_error.js +221 -0
  30. package/dist/agent/backends/index.d.ts +9 -2
  31. package/dist/agent/backends/index.js +22 -2
  32. package/dist/agent/backends/openai.d.ts +0 -6
  33. package/dist/agent/backends/openai.js +5 -2
  34. package/dist/agent/backends/openai_compatible.d.ts +5 -4
  35. package/dist/agent/backends/openai_compatible.js +26 -19
  36. package/dist/agent/backends/openai_responses.d.ts +8 -3
  37. package/dist/agent/backends/openai_responses.js +77 -33
  38. package/dist/agent/backends/provider_ids.d.ts +1 -0
  39. package/dist/agent/backends/provider_ids.js +4 -0
  40. package/dist/agent/backends/request_metrics.js +12 -2
  41. package/dist/agent/backends/types.d.ts +109 -6
  42. package/dist/agent/backends/types.js +5 -1
  43. package/dist/agent/backends/zrouter_stream.d.ts +6 -1
  44. package/dist/agent/backends/zrouter_stream.js +160 -42
  45. package/dist/agent/background_registry.d.ts +2 -0
  46. package/dist/agent/background_registry.js +1 -0
  47. package/dist/agent/claim_observation.d.ts +6 -0
  48. package/dist/agent/claim_observation.js +54 -0
  49. package/dist/agent/commands/accounts.js +46 -177
  50. package/dist/agent/commands/attention.d.ts +2 -0
  51. package/dist/agent/commands/attention.js +67 -0
  52. package/dist/agent/commands/auth.js +18 -2
  53. package/dist/agent/commands/board.d.ts +2 -0
  54. package/dist/agent/commands/board.js +169 -0
  55. package/dist/agent/commands/clipboard.js +50 -1
  56. package/dist/agent/commands/compact.js +21 -13
  57. package/dist/agent/commands/config.js +4 -1
  58. package/dist/agent/commands/context.js +6 -1
  59. package/dist/agent/commands/desktop.d.ts +2 -0
  60. package/dist/agent/commands/desktop.js +29 -0
  61. package/dist/agent/commands/effort.js +14 -6
  62. package/dist/agent/commands/environment.d.ts +3 -0
  63. package/dist/agent/commands/environment.js +109 -0
  64. package/dist/agent/commands/evidence.d.ts +2 -0
  65. package/dist/agent/commands/evidence.js +9 -0
  66. package/dist/agent/commands/fork.js +4 -3
  67. package/dist/agent/commands/goal.d.ts +33 -1
  68. package/dist/agent/commands/goal.js +174 -14
  69. package/dist/agent/commands/goal_exit.d.ts +36 -0
  70. package/dist/agent/commands/goal_exit.js +120 -0
  71. package/dist/agent/commands/help.js +3 -1
  72. package/dist/agent/commands/history.js +3 -1
  73. package/dist/agent/commands/inbox.d.ts +2 -0
  74. package/dist/agent/commands/inbox.js +148 -0
  75. package/dist/agent/commands/index.js +16 -1
  76. package/dist/agent/commands/input_mode.js +8 -6
  77. package/dist/agent/commands/job.d.ts +2 -0
  78. package/dist/agent/commands/job.js +93 -0
  79. package/dist/agent/commands/keybindings.js +4 -1
  80. package/dist/agent/commands/label.d.ts +2 -0
  81. package/dist/agent/commands/label.js +77 -0
  82. package/dist/agent/commands/layout.d.ts +2 -0
  83. package/dist/agent/commands/layout.js +20 -0
  84. package/dist/agent/commands/mirror.js +16 -1
  85. package/dist/agent/commands/model.js +12 -2
  86. package/dist/agent/commands/permissions.d.ts +3 -1
  87. package/dist/agent/commands/permissions.js +79 -89
  88. package/dist/agent/commands/plan.js +5 -15
  89. package/dist/agent/commands/profile.js +21 -2
  90. package/dist/agent/commands/provider_selection.js +20 -1
  91. package/dist/agent/commands/rename.js +1 -1
  92. package/dist/agent/commands/resources.d.ts +2 -0
  93. package/dist/agent/commands/resources.js +67 -0
  94. package/dist/agent/commands/rewind.d.ts +3 -0
  95. package/dist/agent/commands/rewind.js +16 -0
  96. package/dist/agent/commands/runbooks.d.ts +2 -0
  97. package/dist/agent/commands/runbooks.js +73 -0
  98. package/dist/agent/commands/runbooks_lazy.d.ts +2 -0
  99. package/dist/agent/commands/runbooks_lazy.js +8 -0
  100. package/dist/agent/commands/sessions.d.ts +1 -1
  101. package/dist/agent/commands/sessions.js +33 -5
  102. package/dist/agent/commands/settings.js +185 -39
  103. package/dist/agent/commands/setup.d.ts +2 -0
  104. package/dist/agent/commands/setup.js +78 -0
  105. package/dist/agent/commands/share.d.ts +2 -0
  106. package/dist/agent/commands/share.js +64 -0
  107. package/dist/agent/commands/status.js +14 -2
  108. package/dist/agent/commands/types.d.ts +99 -6
  109. package/dist/agent/commands/update.js +8 -0
  110. package/dist/agent/commands/usage.d.ts +2 -0
  111. package/dist/agent/commands/usage.js +8 -0
  112. package/dist/agent/factory.d.ts +11 -0
  113. package/dist/agent/factory.js +113 -88
  114. package/dist/agent/loop_policy.d.ts +6 -3
  115. package/dist/agent/loop_policy.js +12 -3
  116. package/dist/agent/measurement_guidance.d.ts +2 -0
  117. package/dist/agent/measurement_guidance.js +5 -0
  118. package/dist/agent/request_encoder.d.ts +8 -1
  119. package/dist/agent/request_encoder.js +95 -23
  120. package/dist/agent/runtime/benchmark_comparison.d.ts +30 -0
  121. package/dist/agent/runtime/benchmark_comparison.js +94 -0
  122. package/dist/agent/runtime/benchmark_contract.d.ts +48 -0
  123. package/dist/agent/runtime/benchmark_contract.js +90 -0
  124. package/dist/agent/runtime/checked_commands.d.ts +32 -0
  125. package/dist/agent/runtime/checked_commands.js +119 -0
  126. package/dist/agent/runtime/command_execution_policy.d.ts +26 -0
  127. package/dist/agent/runtime/command_execution_policy.js +91 -0
  128. package/dist/agent/runtime/command_jobs.d.ts +36 -18
  129. package/dist/agent/runtime/command_jobs.js +151 -13
  130. package/dist/agent/runtime/command_panes.d.ts +59 -0
  131. package/dist/agent/runtime/command_panes.js +398 -0
  132. package/dist/agent/runtime/command_wait.d.ts +19 -0
  133. package/dist/agent/runtime/command_wait.js +167 -0
  134. package/dist/agent/runtime/cpu_benchmark.d.ts +30 -0
  135. package/dist/agent/runtime/cpu_benchmark.js +126 -0
  136. package/dist/agent/runtime/delegated_evidence.d.ts +26 -0
  137. package/dist/agent/runtime/delegated_evidence.js +80 -0
  138. package/dist/agent/runtime/evidence.d.ts +127 -0
  139. package/dist/agent/runtime/evidence.js +468 -0
  140. package/dist/agent/runtime/execution_context.d.ts +7 -0
  141. package/dist/agent/runtime/execution_context.js +39 -3
  142. package/dist/agent/runtime/json_verifier_recipe.d.ts +8 -0
  143. package/dist/agent/runtime/json_verifier_recipe.js +66 -0
  144. package/dist/agent/runtime/measurements.d.ts +110 -0
  145. package/dist/agent/runtime/measurements.js +317 -0
  146. package/dist/agent/runtime/policy.d.ts +4 -0
  147. package/dist/agent/runtime/policy.js +31 -20
  148. package/dist/agent/runtime/provider_native_evidence.d.ts +20 -0
  149. package/dist/agent/runtime/provider_native_evidence.js +86 -0
  150. package/dist/agent/runtime/recovery.d.ts +2 -0
  151. package/dist/agent/runtime/recovery.js +45 -2
  152. package/dist/agent/runtime/remote_broker_transport.d.ts +10 -0
  153. package/dist/agent/runtime/remote_broker_transport.js +84 -0
  154. package/dist/agent/runtime/remote_deletion_receipts.d.ts +3 -0
  155. package/dist/agent/runtime/remote_deletion_receipts.js +43 -0
  156. package/dist/agent/runtime/remote_journal_replay.d.ts +13 -0
  157. package/dist/agent/runtime/remote_journal_replay.js +233 -0
  158. package/dist/agent/runtime/remote_mutation_journal.d.ts +25 -0
  159. package/dist/agent/runtime/remote_mutation_journal.js +208 -0
  160. package/dist/agent/runtime/remote_resource_endpoint.d.ts +7 -0
  161. package/dist/agent/runtime/remote_resource_endpoint.js +6 -0
  162. package/dist/agent/runtime/remote_resource_errors.d.ts +5 -0
  163. package/dist/agent/runtime/remote_resource_errors.js +9 -0
  164. package/dist/agent/runtime/remote_resource_script.d.ts +2 -0
  165. package/dist/agent/runtime/remote_resource_script.js +1009 -0
  166. package/dist/agent/runtime/remote_resources.d.ts +29 -0
  167. package/dist/agent/runtime/remote_resources.js +160 -0
  168. package/dist/agent/runtime/source_verification.d.ts +12 -0
  169. package/dist/agent/runtime/source_verification.js +210 -0
  170. package/dist/agent/runtime/source_verification_contract.d.ts +75 -0
  171. package/dist/agent/runtime/source_verification_contract.js +203 -0
  172. package/dist/agent/runtime/tool_checkpoints.d.ts +11 -0
  173. package/dist/agent/runtime/tool_checkpoints.js +26 -0
  174. package/dist/agent/runtime/tool_effects.d.ts +5 -0
  175. package/dist/agent/runtime/tool_progress.d.ts +12 -0
  176. package/dist/agent/runtime/tool_progress.js +76 -0
  177. package/dist/agent/runtime/tool_runtime.d.ts +16 -1
  178. package/dist/agent/runtime/tool_runtime.js +204 -10
  179. package/dist/agent/runtime/tracing.d.ts +1 -1
  180. package/dist/agent/runtime/verifier_capture.d.ts +9 -0
  181. package/dist/agent/runtime/verifier_capture.js +100 -0
  182. package/dist/agent/runtime/verifier_contract.d.ts +24 -0
  183. package/dist/agent/runtime/verifier_contract.js +41 -0
  184. package/dist/agent/subagent.d.ts +20 -10
  185. package/dist/agent/subagent.js +266 -29
  186. package/dist/agent/tool_response_directory.d.ts +24 -0
  187. package/dist/agent/tool_response_directory.js +61 -0
  188. package/dist/agent/tool_response_source.d.ts +8 -0
  189. package/dist/agent/tool_response_source.js +49 -0
  190. package/dist/agent/tool_response_store.d.ts +75 -4
  191. package/dist/agent/tool_response_store.js +583 -64
  192. package/dist/agent/tools/ask_user.d.ts +3 -1
  193. package/dist/agent/tools/ask_user.js +30 -11
  194. package/dist/agent/tools/background.js +1 -0
  195. package/dist/agent/tools/benchmark_cpu.d.ts +2 -0
  196. package/dist/agent/tools/benchmark_cpu.js +102 -0
  197. package/dist/agent/tools/compare_benchmarks.d.ts +2 -0
  198. package/dist/agent/tools/compare_benchmarks.js +53 -0
  199. package/dist/agent/tools/deferred.js +1 -0
  200. package/dist/agent/tools/delegate.js +18 -2
  201. package/dist/agent/tools/helper_requirements.d.ts +7 -0
  202. package/dist/agent/tools/helper_requirements.js +19 -0
  203. package/dist/agent/tools/index.d.ts +1 -0
  204. package/dist/agent/tools/index.js +3 -0
  205. package/dist/agent/tools/measurement_report.d.ts +22 -0
  206. package/dist/agent/tools/measurement_report.js +190 -0
  207. package/dist/agent/tools/pane.d.ts +0 -7
  208. package/dist/agent/tools/pane.js +5 -4
  209. package/dist/agent/tools/project_context.d.ts +3 -0
  210. package/dist/agent/tools/project_context.js +45 -0
  211. package/dist/agent/tools/recall_tool_response.d.ts +3 -5
  212. package/dist/agent/tools/recall_tool_response.js +19 -29
  213. package/dist/agent/tools/registry.d.ts +1 -0
  214. package/dist/agent/tools/registry.js +23 -0
  215. package/dist/agent/tools/related_sessions.d.ts +2 -0
  216. package/dist/agent/tools/related_sessions.js +156 -0
  217. package/dist/agent/tools/routine.js +13 -3
  218. package/dist/agent/tools/session_evidence.d.ts +3 -0
  219. package/dist/agent/tools/session_evidence.js +72 -0
  220. package/dist/agent/tools/shell.d.ts +4 -3
  221. package/dist/agent/tools/shell.js +174 -47
  222. package/dist/agent/tools/tool_search.js +3 -2
  223. package/dist/agent/tools/types.d.ts +28 -0
  224. package/dist/agent/tools/verify_artifact.d.ts +2 -0
  225. package/dist/agent/tools/verify_artifact.js +60 -0
  226. package/dist/agent/tools/workflow.js +1 -0
  227. package/dist/app/activity.d.ts +6 -1
  228. package/dist/app/activity.js +81 -12
  229. package/dist/app/agent_runner.d.ts +6 -1
  230. package/dist/app/agent_runner.js +34 -19
  231. package/dist/app/command_context.js +106 -10
  232. package/dist/app/controller.d.ts +15 -4
  233. package/dist/app/controller.js +29 -3
  234. package/dist/app/escape_stop.d.ts +11 -0
  235. package/dist/app/escape_stop.js +15 -0
  236. package/dist/app/liveness.d.ts +6 -4
  237. package/dist/app/liveness.js +13 -3
  238. package/dist/app/model_catalog_cache.d.ts +5 -0
  239. package/dist/app/model_catalog_cache.js +138 -0
  240. package/dist/app/ordered_transcript.js +43 -4
  241. package/dist/app/prompt_turn.d.ts +14 -0
  242. package/dist/app/prompt_turn.js +53 -0
  243. package/dist/app/recap.d.ts +3 -0
  244. package/dist/app/recap.js +9 -3
  245. package/dist/app/restart.d.ts +3 -2
  246. package/dist/app/restart.js +22 -7
  247. package/dist/app/rewind.d.ts +3 -3
  248. package/dist/app/rewind.js +3 -3
  249. package/dist/app/selection_completion.d.ts +17 -2
  250. package/dist/app/selection_completion.js +84 -9
  251. package/dist/app/session_manager.d.ts +38 -6
  252. package/dist/app/session_manager.js +263 -60
  253. package/dist/app/session_messages.d.ts +3 -0
  254. package/dist/app/session_messages.js +60 -0
  255. package/dist/app/task_scope_router.d.ts +20 -0
  256. package/dist/app/task_scope_router.js +173 -0
  257. package/dist/app/transcript_window.d.ts +2 -0
  258. package/dist/app/transcript_window.js +4 -0
  259. package/dist/app/workspace_admission_details.d.ts +3 -0
  260. package/dist/app/workspace_admission_details.js +26 -0
  261. package/dist/app/workspace_layout_controller.d.ts +11 -0
  262. package/dist/app/workspace_layout_controller.js +88 -0
  263. package/dist/app/workspace_monitor.d.ts +1 -0
  264. package/dist/app/workspace_monitor.js +216 -0
  265. package/dist/app/workspace_presets.d.ts +29 -0
  266. package/dist/app/workspace_presets.js +192 -0
  267. package/dist/attention/queue.d.ts +37 -0
  268. package/dist/attention/queue.js +183 -0
  269. package/dist/bench/rf_shared.d.ts +2 -0
  270. package/dist/board/binding.d.ts +42 -0
  271. package/dist/board/binding.js +38 -0
  272. package/dist/board/client.d.ts +42 -0
  273. package/dist/board/client.js +60 -0
  274. package/dist/cli.js +1 -1
  275. package/dist/cli_args.js +19 -17
  276. package/dist/cli_main.js +110 -13
  277. package/dist/cli_ratatui.d.ts +183 -16
  278. package/dist/cli_ratatui.js +3989 -1255
  279. package/dist/components/ActivityLine.d.ts +3 -2
  280. package/dist/components/ActivityLine.js +2 -2
  281. package/dist/components/InputArea.d.ts +19 -1
  282. package/dist/components/InputArea.js +264 -190
  283. package/dist/components/MessageList.d.ts +2 -0
  284. package/dist/components/MessageList.js +3 -1
  285. package/dist/components/SingleMessage.d.ts +2 -0
  286. package/dist/components/SingleMessage.js +4 -2
  287. package/dist/components/StatusBar.d.ts +4 -2
  288. package/dist/components/StatusBar.js +3 -1
  289. package/dist/conductor_branch.js +3 -0
  290. package/dist/config/api_retry.d.ts +6 -1
  291. package/dist/config/api_retry.js +19 -1
  292. package/dist/config/defaults.d.ts +2 -1
  293. package/dist/config/defaults.js +9 -2
  294. package/dist/config/message_display.d.ts +1 -0
  295. package/dist/config/message_display.js +17 -2
  296. package/dist/config/permissions.d.ts +21 -0
  297. package/dist/config/permissions.js +89 -0
  298. package/dist/config/resolved.d.ts +2 -2
  299. package/dist/config/types.d.ts +32 -5
  300. package/dist/config.d.ts +38 -4
  301. package/dist/config.js +290 -42
  302. package/dist/context/project_intelligence.d.ts +44 -0
  303. package/dist/context/project_intelligence.js +246 -0
  304. package/dist/desktop/cli_launch.d.ts +8 -0
  305. package/dist/desktop/cli_launch.js +6 -0
  306. package/dist/desktop/cli_shim.d.ts +8 -0
  307. package/dist/desktop/cli_shim.js +120 -0
  308. package/dist/desktop/runtime.d.ts +16 -0
  309. package/dist/desktop/runtime.js +161 -0
  310. package/dist/desktop/worker_launch.d.ts +7 -0
  311. package/dist/desktop/worker_launch.js +7 -0
  312. package/dist/diagnostics/cargo_mutants_selection.d.ts +27 -0
  313. package/dist/diagnostics/cargo_mutants_selection.js +48 -0
  314. package/dist/diagnostics/native_terminal_benchmark.d.ts +58 -0
  315. package/dist/diagnostics/native_terminal_benchmark.js +1247 -0
  316. package/dist/diagnostics/session_evidence_package.d.ts +40 -0
  317. package/dist/diagnostics/session_evidence_package.js +234 -0
  318. package/dist/diagnostics/session_export.d.ts +93 -0
  319. package/dist/diagnostics/session_export.js +634 -0
  320. package/dist/emulation/tool_adapters.js +48 -18
  321. package/dist/emulation/ztc_addendum.d.ts +1 -0
  322. package/dist/emulation/ztc_addendum.js +13 -12
  323. package/dist/environment/service_runner.d.ts +1 -0
  324. package/dist/environment/service_runner.js +68 -0
  325. package/dist/environment/store.d.ts +120 -0
  326. package/dist/environment/store.js +387 -0
  327. package/dist/events.d.ts +40 -1
  328. package/dist/events.js +10 -17
  329. package/dist/goal_contract.d.ts +25 -0
  330. package/dist/goal_contract.js +44 -0
  331. package/dist/headless.d.ts +31 -0
  332. package/dist/headless.js +578 -70
  333. package/dist/headless_cli.js +8 -0
  334. package/dist/headless_cli_args.d.ts +1 -0
  335. package/dist/headless_cli_args.js +1 -0
  336. package/dist/intake/cli.d.ts +1 -0
  337. package/dist/intake/cli.js +33 -0
  338. package/dist/intake/format.d.ts +2 -0
  339. package/dist/intake/format.js +14 -0
  340. package/dist/intake/notifications.d.ts +16 -0
  341. package/dist/intake/notifications.js +132 -0
  342. package/dist/intake/store.d.ts +56 -0
  343. package/dist/intake/store.js +238 -0
  344. package/dist/library.d.ts +8 -0
  345. package/dist/library.js +19 -10
  346. package/dist/mcp/client.d.ts +1 -0
  347. package/dist/mcp/client.js +20 -0
  348. package/dist/modes/builtin/plan.yaml +2 -2
  349. package/dist/modes/handlers.js +1 -1
  350. package/dist/onboarding/first_run.d.ts +3 -0
  351. package/dist/onboarding/first_run.js +33 -25
  352. package/dist/onboarding/setup.d.ts +32 -0
  353. package/dist/onboarding/setup.js +133 -0
  354. package/dist/onboarding/setup_agent_health.d.ts +17 -0
  355. package/dist/onboarding/setup_agent_health.js +79 -0
  356. package/dist/onboarding/setup_environment.d.ts +66 -0
  357. package/dist/onboarding/setup_environment.js +219 -0
  358. package/dist/onboarding/setup_workspace.d.ts +17 -0
  359. package/dist/onboarding/setup_workspace.js +129 -0
  360. package/dist/optimize/adapters/index.d.ts +4 -1
  361. package/dist/optimize/adapters/index.js +7 -0
  362. package/dist/optimize/adapters/kernelbench.js +14 -5
  363. package/dist/optimize/adapters/popcorn.js +3 -2
  364. package/dist/optimize/adapters/profile_benchmark.js +13 -7
  365. package/dist/optimize/adapters/rfbench.js +25 -14
  366. package/dist/optimize/adapters/types.d.ts +3 -0
  367. package/dist/optimize/adapters/zergpod.js +5 -2
  368. package/dist/optimize/baseline.js +10 -21
  369. package/dist/optimize/branch.js +9 -12
  370. package/dist/optimize/combine.js +2 -3
  371. package/dist/optimize/executor.js +34 -48
  372. package/dist/optimize/measurements.d.ts +55 -0
  373. package/dist/optimize/measurements.js +173 -0
  374. package/dist/optimize/results.d.ts +1 -0
  375. package/dist/optimize/results.js +11 -33
  376. package/dist/optimize/tge.js +2 -1
  377. package/dist/panes/initial_input.d.ts +19 -0
  378. package/dist/panes/initial_input.js +206 -0
  379. package/dist/panes/labels.d.ts +16 -0
  380. package/dist/panes/labels.js +42 -0
  381. package/dist/panes/model_catalog.d.ts +3 -3
  382. package/dist/panes/model_catalog.js +28 -4
  383. package/dist/panes/pane_registry.js +6 -2
  384. package/dist/panes/types.d.ts +3 -0
  385. package/dist/panes/ztc_launch.js +19 -0
  386. package/dist/plugin/optimization.d.ts +2 -0
  387. package/dist/plugin/optimization.js +1 -0
  388. package/dist/plugin/runtime.d.ts +2 -0
  389. package/dist/plugin/simulation.d.ts +6 -1
  390. package/dist/plugin/simulation_contract.d.ts +836 -1
  391. package/dist/plugin/simulation_documents.d.ts +22 -0
  392. package/dist/plugin/simulation_documents.js +1 -0
  393. package/dist/plugin/simulation_interventions.d.ts +103 -0
  394. package/dist/plugin/simulation_interventions.js +1 -0
  395. package/dist/plugin/simulation_living.d.ts +1 -0
  396. package/dist/plugin/simulation_living.js +3 -0
  397. package/dist/plugin/simulation_meetings.d.ts +121 -0
  398. package/dist/plugin/simulation_meetings.js +1 -0
  399. package/dist/plugin/simulation_story_review.d.ts +111 -0
  400. package/dist/plugin/simulation_story_review.js +1 -0
  401. package/dist/plugin/simulation_storyteller.d.ts +91 -0
  402. package/dist/plugin/simulation_storyteller.js +1 -0
  403. package/dist/plugin/simulation_structured.d.ts +2 -0
  404. package/dist/plugin/simulation_structured.js +2 -0
  405. package/dist/plugin/simulation_toolkit.d.ts +21 -0
  406. package/dist/plugin/simulation_toolkit.js +24 -0
  407. package/dist/prompts/tool_delegate_task.j2 +1 -1
  408. package/dist/remote-broker/Dockerfile +10 -0
  409. package/dist/remote-broker/archive.py +1227 -0
  410. package/dist/remote-broker/cutover.py +761 -0
  411. package/dist/remote-broker/requirements.txt +5 -0
  412. package/dist/remote-broker/resources.json +6 -0
  413. package/dist/remote-broker/resources.write-staging.example.json +18 -0
  414. package/dist/remote-broker/retained.py +686 -0
  415. package/dist/remote-broker/retained_cleanup.py +550 -0
  416. package/dist/remote-broker/server.py +648 -0
  417. package/dist/remote-broker/worker.py +1007 -0
  418. package/dist/router_auth.d.ts +31 -0
  419. package/dist/router_auth.js +155 -9
  420. package/dist/runbooks/catalog.d.ts +3 -0
  421. package/dist/runbooks/catalog.js +26 -0
  422. package/dist/runbooks/library.d.ts +11 -0
  423. package/dist/runbooks/library.js +95 -0
  424. package/dist/runbooks/package.d.ts +43 -0
  425. package/dist/runbooks/package.js +102 -0
  426. package/dist/session.d.ts +65 -13
  427. package/dist/session.js +548 -43
  428. package/dist/session_handoff.d.ts +25 -0
  429. package/dist/session_handoff.js +322 -0
  430. package/dist/session_handoff_contract.d.ts +89 -0
  431. package/dist/session_handoff_contract.js +179 -0
  432. package/dist/session_media.d.ts +41 -0
  433. package/dist/session_media.js +357 -0
  434. package/dist/session_ownership.d.ts +16 -0
  435. package/dist/session_ownership.js +221 -0
  436. package/dist/session_public.d.ts +10 -2
  437. package/dist/session_public.js +6 -1
  438. package/dist/simulation/dynamic_history.d.ts +42 -0
  439. package/dist/simulation/dynamic_history.js +173 -0
  440. package/dist/simulation/engines/swarm/pane_manager.js +7 -6
  441. package/dist/simulation/inference.d.ts +3 -1
  442. package/dist/simulation/inference.js +19 -1
  443. package/dist/simulation/intervention_generation.d.ts +27 -0
  444. package/dist/simulation/intervention_generation.js +246 -0
  445. package/dist/simulation/intervention_material.d.ts +4 -0
  446. package/dist/simulation/intervention_material.js +81 -0
  447. package/dist/simulation/living/context.d.ts +3130 -0
  448. package/dist/simulation/living/context.js +944 -0
  449. package/dist/simulation/living/definer.d.ts +12 -0
  450. package/dist/simulation/living/definer.js +223 -0
  451. package/dist/simulation/living/definition.d.ts +257 -0
  452. package/dist/simulation/living/definition.js +341 -0
  453. package/dist/simulation/living/frame.d.ts +259 -0
  454. package/dist/simulation/living/frame.js +223 -0
  455. package/dist/simulation/living/identifiers.d.ts +2 -0
  456. package/dist/simulation/living/identifiers.js +12 -0
  457. package/dist/simulation/living/index.d.ts +15 -0
  458. package/dist/simulation/living/index.js +15 -0
  459. package/dist/simulation/living/inference.d.ts +219 -0
  460. package/dist/simulation/living/inference.js +576 -0
  461. package/dist/simulation/living/mechanics.d.ts +54 -0
  462. package/dist/simulation/living/mechanics.js +588 -0
  463. package/dist/simulation/living/model-input.d.ts +25 -0
  464. package/dist/simulation/living/model-input.js +215 -0
  465. package/dist/simulation/living/open-world.d.ts +257 -0
  466. package/dist/simulation/living/open-world.js +102 -0
  467. package/dist/simulation/living/projection.d.ts +7 -0
  468. package/dist/simulation/living/projection.js +31 -0
  469. package/dist/simulation/living/recall.d.ts +17 -0
  470. package/dist/simulation/living/recall.js +25 -0
  471. package/dist/simulation/living/reduce.d.ts +15 -0
  472. package/dist/simulation/living/reduce.js +1853 -0
  473. package/dist/simulation/living/replay.d.ts +6 -0
  474. package/dist/simulation/living/replay.js +22 -0
  475. package/dist/simulation/living/runtime.d.ts +140 -0
  476. package/dist/simulation/living/runtime.js +3020 -0
  477. package/dist/simulation/living/shared-kinds.d.ts +24 -0
  478. package/dist/simulation/living/shared-kinds.js +96 -0
  479. package/dist/simulation/living/types.d.ts +2785 -0
  480. package/dist/simulation/living/types.js +669 -0
  481. package/dist/simulation/llm.d.ts +3 -1
  482. package/dist/simulation/llm.js +90 -30
  483. package/dist/simulation/memory/embedding.d.ts +1 -1
  484. package/dist/simulation/memory/embedding.js +9 -3
  485. package/dist/simulation/memory/filesystem.d.ts +2 -0
  486. package/dist/simulation/memory/filesystem.js +5 -1
  487. package/dist/simulation/memory/filesystem_file_tree.d.ts +4 -1
  488. package/dist/simulation/memory/filesystem_file_tree.js +41 -10
  489. package/dist/simulation/memory/filesystem_invariants.js +1 -2
  490. package/dist/simulation/memory/filesystem_types.d.ts +1 -0
  491. package/dist/simulation/memory/memory.d.ts +2 -0
  492. package/dist/simulation/memory/memory.js +5 -1
  493. package/dist/simulation/orchestration/intent.js +0 -2
  494. package/dist/simulation/orchestration/lifecycle.js +0 -2
  495. package/dist/simulation/plugin_host.d.ts +25 -1
  496. package/dist/simulation/plugin_host.js +334 -17
  497. package/dist/simulation/session_documents.d.ts +20 -0
  498. package/dist/simulation/session_documents.js +62 -0
  499. package/dist/simulation/session_input_validation.d.ts +43 -0
  500. package/dist/simulation/session_input_validation.js +364 -0
  501. package/dist/simulation/session_inputs.d.ts +32 -0
  502. package/dist/simulation/session_inputs.js +154 -0
  503. package/dist/simulation/telemetry.d.ts +11 -14
  504. package/dist/simulation/telemetry.js +177 -54
  505. package/dist/simulation/toolkit/bounded_turns.d.ts +13 -0
  506. package/dist/simulation/toolkit/bounded_turns.js +80 -0
  507. package/dist/simulation/toolkit/dynamic_agents.d.ts +25 -0
  508. package/dist/simulation/toolkit/dynamic_agents.js +218 -0
  509. package/dist/simulation/toolkit/dynamic_digest.d.ts +1 -0
  510. package/dist/simulation/toolkit/dynamic_digest.js +8 -0
  511. package/dist/simulation/toolkit/dynamic_documents.d.ts +7 -0
  512. package/dist/simulation/toolkit/dynamic_documents.js +71 -0
  513. package/dist/simulation/toolkit/dynamic_driver.d.ts +8 -0
  514. package/dist/simulation/toolkit/dynamic_driver.js +269 -0
  515. package/dist/simulation/toolkit/dynamic_game.d.ts +53 -0
  516. package/dist/simulation/toolkit/dynamic_game.js +805 -0
  517. package/dist/simulation/toolkit/dynamic_knowledge.d.ts +15 -0
  518. package/dist/simulation/toolkit/dynamic_knowledge.js +91 -0
  519. package/dist/simulation/toolkit/dynamic_mechanics.d.ts +22 -0
  520. package/dist/simulation/toolkit/dynamic_mechanics.js +910 -0
  521. package/dist/simulation/toolkit/dynamic_meetings.d.ts +239 -0
  522. package/dist/simulation/toolkit/dynamic_meetings.js +350 -0
  523. package/dist/simulation/toolkit/dynamic_progress.d.ts +131 -0
  524. package/dist/simulation/toolkit/dynamic_progress.js +214 -0
  525. package/dist/simulation/toolkit/dynamic_projection.d.ts +9 -0
  526. package/dist/simulation/toolkit/dynamic_projection.js +219 -0
  527. package/dist/simulation/toolkit/dynamic_runtime.d.ts +412 -0
  528. package/dist/simulation/toolkit/dynamic_runtime.js +6536 -0
  529. package/dist/simulation/toolkit/dynamic_state.d.ts +111 -0
  530. package/dist/simulation/toolkit/dynamic_state.js +1967 -0
  531. package/dist/simulation/toolkit/dynamic_story_review.d.ts +508 -0
  532. package/dist/simulation/toolkit/dynamic_story_review.js +333 -0
  533. package/dist/simulation/toolkit/dynamic_storyteller.d.ts +77 -0
  534. package/dist/simulation/toolkit/dynamic_storyteller.js +114 -0
  535. package/dist/simulation/toolkit/dynamic_storyteller_runtime.d.ts +26 -0
  536. package/dist/simulation/toolkit/dynamic_storyteller_runtime.js +126 -0
  537. package/dist/simulation/toolkit/dynamic_world.d.ts +22 -0
  538. package/dist/simulation/toolkit/dynamic_world.js +377 -0
  539. package/dist/simulation/toolkit/structured_output.d.ts +5 -0
  540. package/dist/simulation/toolkit/structured_output.js +321 -0
  541. package/dist/simulation/types/world.d.ts +2 -0
  542. package/dist/simulation/world/artifact_store.js +1 -1
  543. package/dist/simulation/world/memory_manager.d.ts +5 -0
  544. package/dist/simulation/world/memory_manager.js +17 -2
  545. package/dist/simulation/world/state.d.ts +3 -2
  546. package/dist/simulation/world/state.js +15 -5
  547. package/dist/skills/bundled/measurement-validation/SKILL.md +144 -0
  548. package/dist/terminal_attach.d.ts +1 -0
  549. package/dist/terminal_attach.js +113 -0
  550. package/dist/tool_progress.d.ts +3 -0
  551. package/dist/tool_progress.js +27 -0
  552. package/dist/types.d.ts +145 -10
  553. package/dist/types.js +3 -0
  554. package/dist/ui/core/input.d.ts +3 -0
  555. package/dist/ui/core/input_segments.d.ts +18 -1
  556. package/dist/ui/core/input_segments.js +131 -47
  557. package/dist/ui/core/input_state.d.ts +12 -0
  558. package/dist/ui/core/layout_yoga.d.ts +1 -1
  559. package/dist/ui/core/turn_metadata.d.ts +5 -0
  560. package/dist/ui/core/turn_metadata.js +22 -0
  561. package/dist/ui/ink/render.d.ts +2 -1
  562. package/dist/ui/ink/render.js +6 -5
  563. package/dist/ui/ratatui/headless_pane_manager.d.ts +14 -1
  564. package/dist/ui/ratatui/headless_pane_manager.js +293 -104
  565. package/dist/ui/ratatui/index.d.ts +1 -0
  566. package/dist/ui/ratatui/input.d.ts +4 -0
  567. package/dist/ui/ratatui/input.js +15 -0
  568. package/dist/ui/ratatui/ipc_path.d.ts +2 -0
  569. package/dist/ui/ratatui/ipc_path.js +29 -1
  570. package/dist/ui/ratatui/mux_persistence.d.ts +3 -1
  571. package/dist/ui/ratatui/mux_persistence.js +139 -1
  572. package/dist/ui/ratatui/pane_relay.d.ts +1 -1
  573. package/dist/ui/ratatui/pane_relay.js +55 -27
  574. package/dist/ui/ratatui/process.d.ts +17 -1
  575. package/dist/ui/ratatui/process.js +80 -7
  576. package/dist/ui/ratatui/protocol.d.ts +236 -1
  577. package/dist/ui/ratatui/protocol.js +90 -0
  578. package/dist/ui/scrollback.d.ts +2 -1
  579. package/dist/ui/scrollback.js +9 -4
  580. package/dist/ui/stream_typewriter.d.ts +8 -3
  581. package/dist/ui/stream_typewriter.js +30 -1
  582. package/dist/ui/streaming_scrollback.d.ts +1 -0
  583. package/dist/ui/streaming_scrollback.js +1 -1
  584. package/dist/ui/transcript_render_cache.js +10 -0
  585. package/dist/ui/views/activity_line.d.ts +5 -3
  586. package/dist/ui/views/activity_line.js +65 -7
  587. package/dist/ui/views/app.d.ts +6 -3
  588. package/dist/ui/views/app.js +17 -6
  589. package/dist/ui/views/completion_menu.js +10 -5
  590. package/dist/ui/views/input_area.d.ts +7 -3
  591. package/dist/ui/views/input_area.js +15 -9
  592. package/dist/ui/views/message_list.d.ts +4 -1
  593. package/dist/ui/views/message_list.js +89 -19
  594. package/dist/ui/views/queue_panel.d.ts +3 -1
  595. package/dist/ui/views/queue_panel.js +9 -2
  596. package/dist/ui/views/status_bar.d.ts +4 -2
  597. package/dist/ui/views/status_bar.js +28 -13
  598. package/dist/ui/views/theme.d.ts +2 -0
  599. package/dist/ui/views/theme.js +2 -0
  600. package/dist/ui/widgets/color_panel.js +18 -0
  601. package/dist/ui/widgets/form.js +8 -0
  602. package/dist/ui/widgets/log_view.js +7 -0
  603. package/dist/ui/widgets/navigator_panel.js +8 -0
  604. package/dist/ui/widgets/prompt_viewer.js +2 -0
  605. package/dist/ui/widgets/questionnaire.d.ts +2 -0
  606. package/dist/ui/widgets/questionnaire.js +79 -16
  607. package/dist/ui/widgets/resume_panel.d.ts +2 -0
  608. package/dist/ui/widgets/resume_panel.js +26 -15
  609. package/dist/ui/widgets/rewind_panel.d.ts +2 -2
  610. package/dist/ui/widgets/rewind_panel.js +4 -2
  611. package/dist/ui/widgets/select.js +16 -27
  612. package/dist/ui/widgets/settings_panel.js +16 -0
  613. package/dist/ui/widgets/status_line_panel.d.ts +1 -0
  614. package/dist/ui/widgets/status_line_panel.js +30 -4
  615. package/dist/ui/widgets/text_input.d.ts +2 -0
  616. package/dist/ui/widgets/text_input.js +15 -1
  617. package/dist/ui/widgets/types.d.ts +2 -0
  618. package/dist/usage_projection.d.ts +24 -0
  619. package/dist/usage_projection.js +130 -0
  620. package/dist/usage_snapshot.d.ts +36 -0
  621. package/dist/usage_snapshot.js +131 -0
  622. package/dist/utils/assistant_message.d.ts +2 -0
  623. package/dist/utils/assistant_message.js +5 -0
  624. package/dist/utils/atomic_write.d.ts +6 -2
  625. package/dist/utils/atomic_write.js +29 -4
  626. package/dist/utils/checked_shell.d.ts +25 -0
  627. package/dist/utils/checked_shell.js +107 -0
  628. package/dist/utils/compaction.d.ts +4 -1
  629. package/dist/utils/compaction.js +31 -7
  630. package/dist/utils/context.d.ts +4 -4
  631. package/dist/utils/context.js +14 -12
  632. package/dist/utils/deepseek.d.ts +2 -2
  633. package/dist/utils/deepseek.js +13 -5
  634. package/dist/utils/ephemeral.js +4 -0
  635. package/dist/utils/ephemeral_tools.d.ts +18 -0
  636. package/dist/utils/ephemeral_tools.js +97 -0
  637. package/dist/utils/jev_client.d.ts +4 -0
  638. package/dist/utils/jev_client.js +15 -0
  639. package/dist/utils/model_cache.d.ts +15 -0
  640. package/dist/utils/model_cache.js +143 -0
  641. package/dist/utils/models.d.ts +4 -2
  642. package/dist/utils/models.js +12 -16
  643. package/dist/utils/reasoning.d.ts +8 -1
  644. package/dist/utils/reasoning.js +31 -11
  645. package/dist/utils/router_catalog.d.ts +49 -0
  646. package/dist/utils/router_catalog.js +271 -0
  647. package/dist/utils/sandbox.d.ts +9 -0
  648. package/dist/utils/sandbox.js +118 -15
  649. package/dist/utils/shell.d.ts +7 -0
  650. package/dist/utils/shell.js +98 -34
  651. package/dist/utils/subprocess_env.d.ts +3 -0
  652. package/dist/utils/subprocess_env.js +27 -1
  653. package/dist/web/accounts_mirror.d.ts +3 -1
  654. package/dist/web/accounts_mirror.js +13 -9
  655. package/dist/web/child_publication.d.ts +17 -0
  656. package/dist/web/child_publication.js +45 -0
  657. package/dist/web/mirror_authenticator.d.ts +31 -11
  658. package/dist/web/mirror_authenticator.js +67 -17
  659. package/dist/web/mirror_client.d.ts +31 -4
  660. package/dist/web/mirror_client.js +189 -23
  661. package/dist/web/mirror_stream.d.ts +84 -22
  662. package/dist/web/mirror_stream.js +676 -95
  663. package/dist/web/observer_query_redaction.d.ts +6 -0
  664. package/dist/web/observer_query_redaction.js +58 -0
  665. package/dist/web/pane_registry.d.ts +2 -0
  666. package/dist/web/pane_registry.js +86 -22
  667. package/dist/web/tool_image.d.ts +6 -0
  668. package/dist/web/tool_image.js +17 -0
  669. package/dist/web/view_plugin.d.ts +14 -0
  670. package/dist/web/view_plugin.js +23 -1
  671. package/dist/worker/executor.js +31 -12
  672. package/dist/worker/index.d.ts +1 -0
  673. package/dist/worker/toolsets.js +3 -1
  674. package/dist/worker/types.d.ts +12 -1
  675. package/dist/workflows/registry.js +1 -0
  676. package/dist/workflows/registry_handle.d.ts +2 -0
  677. package/dist/workflows/runtime.d.ts +2 -0
  678. package/dist/workflows/runtime.js +1 -0
  679. package/dist/workspace_agent.d.ts +7 -0
  680. package/dist/workspace_agent.js +36 -0
  681. package/dist/workspace_collision.d.ts +76 -0
  682. package/dist/workspace_collision.js +688 -0
  683. package/dist/workspace_layout.d.ts +18 -0
  684. package/dist/workspace_layout.js +121 -0
  685. package/dist/workspace_runtime.d.ts +44 -0
  686. package/dist/workspace_runtime.js +82 -0
  687. package/dist/workspace_session_context.d.ts +62 -0
  688. package/dist/workspace_session_context.js +160 -0
  689. package/dist/zlm-embed.mjs +32518 -9615
  690. package/dist/zlm.js +1 -0
  691. package/node_modules/@zerg/model-contracts/LICENSE.md +375 -0
  692. package/node_modules/@zerg/model-contracts/README.md +90 -0
  693. package/node_modules/@zerg/model-contracts/index.d.ts +20 -0
  694. package/node_modules/@zerg/model-contracts/index.js +223 -0
  695. package/node_modules/@zerg/model-contracts/package.json +8 -0
  696. package/node_modules/glob/node_modules/brace-expansion/index.js +78 -22
  697. package/node_modules/glob/node_modules/brace-expansion/package.json +1 -1
  698. package/node_modules/readdir-glob/node_modules/brace-expansion/index.js +78 -22
  699. package/node_modules/readdir-glob/node_modules/brace-expansion/package.json +1 -1
  700. package/package.json +45 -24
  701. package/packages/model-contracts/LICENSE.md +375 -0
  702. package/packages/model-contracts/README.md +90 -0
  703. package/packages/model-contracts/index.d.ts +20 -0
  704. package/packages/model-contracts/index.js +223 -0
  705. package/packages/model-contracts/package.json +8 -0
  706. package/remote-broker/Dockerfile +10 -0
  707. package/remote-broker/README.md +308 -0
  708. package/remote-broker/archive.py +1227 -0
  709. package/remote-broker/cutover.py +761 -0
  710. package/remote-broker/requirements.txt +5 -0
  711. package/remote-broker/resources.example.json +6 -0
  712. package/remote-broker/resources.write-staging.example.json +18 -0
  713. package/remote-broker/retained.py +686 -0
  714. package/remote-broker/retained_cleanup.py +550 -0
  715. package/remote-broker/server.py +648 -0
  716. package/scripts/build-remote-broker.mjs +13 -0
  717. package/scripts/ensure-local-packages.mjs +6 -0
  718. package/scripts/node-pty-helpers.mjs +103 -0
@@ -31,13 +31,29 @@ export interface TranscriptAnchor {
31
31
  export declare const CAPABILITY_PANE_DELIVERY_ACK = "pane_delivery_ack_v1";
32
32
  export declare const CAPABILITY_SCROLLBACK_ANCHOR = "scrollback_anchor";
33
33
  export declare const CAPABILITY_DESKTOP_UPDATE_RESTART = "desktop_update_restart_v1";
34
+ export declare const CAPABILITY_DESKTOP_TASK_CONTROLS = "desktop_task_controls_v1";
35
+ export declare const CAPABILITY_DESKTOP_RUNTIME_CONTROLS = "desktop_runtime_controls_v1";
36
+ export declare const CAPABILITY_DESKTOP_SESSION_SHARE = "desktop_session_share_v1";
37
+ export declare const CAPABILITY_TERMINAL_FRAME_METRICS = "terminal_frame_metrics_v1";
38
+ export declare const CAPABILITY_TERMINAL_INTERACTION = "terminal_interaction_v1";
34
39
  export declare const CAPABILITY_CLIPBOARD_IMAGE = "clipboard_image";
40
+ export declare const CAPABILITY_CLIPBOARD_TEXT = "clipboard_text";
35
41
  export type SplitDirection = 'horizontal' | 'vertical';
36
42
  export type LayoutPreset = 'grid' | 'columns' | 'rows' | 'main_and_stack';
37
43
  export type PaneScrollMode = 'line_up' | 'line_down' | 'page_up' | 'page_down' | 'top' | 'bottom' | 'ratio';
44
+ export interface PaneLabels {
45
+ updated_at_ms?: number;
46
+ manual_title?: string;
47
+ project?: string;
48
+ task?: string;
49
+ group?: string;
50
+ pinned?: boolean;
51
+ }
38
52
  export interface PaneInfo {
39
53
  id: number;
40
54
  title: string;
55
+ inferred_title?: string;
56
+ labels?: PaneLabels;
41
57
  pane_type: string;
42
58
  is_focused: boolean;
43
59
  is_alive: boolean;
@@ -67,13 +83,39 @@ export type MuxLayoutNode = {
67
83
  export interface MuxPaneState {
68
84
  id: number;
69
85
  title: string;
86
+ inferred_title?: string;
87
+ labels?: PaneLabels;
70
88
  pane_type: string;
71
89
  command?: string;
72
90
  args?: string[];
73
91
  cwd?: string;
74
92
  content?: string;
93
+ agent_session?: {
94
+ session_id: string;
95
+ project_path: string;
96
+ };
97
+ restoration_status?: 'not_started' | 'missing_command' | 'missing_directory' | 'session_missing' | 'session_active_elsewhere' | 'session_unreadable';
98
+ window_id?: number;
99
+ }
100
+ export interface MuxWindowState {
101
+ id: number;
102
+ title: string;
103
+ focused_pane_id: number;
104
+ zoomed_pane_id?: number;
105
+ layout: MuxLayoutNode;
106
+ color?: string;
107
+ pattern?: string;
75
108
  }
76
109
  export interface MuxSessionState {
110
+ schema_version?: 1;
111
+ active_window_id?: number;
112
+ windows?: MuxWindowState[];
113
+ geometry?: {
114
+ cols?: number;
115
+ rows?: number;
116
+ pixel_width?: number;
117
+ pixel_height?: number;
118
+ };
77
119
  focused_pane_id: number;
78
120
  zoomed_pane_id?: number;
79
121
  layout: MuxLayoutNode;
@@ -88,6 +130,132 @@ export interface ZlickyCursorOverlay {
88
130
  pane_id?: number;
89
131
  ttl_ms?: number;
90
132
  }
133
+ /** Bounded display projection of the canonical accepted queue. */
134
+ export interface DesktopTaskControlAttachment {
135
+ id: string;
136
+ name: string;
137
+ kind: 'image' | 'file';
138
+ media_type?: string;
139
+ size?: number;
140
+ }
141
+ export interface DesktopTaskControlEntry {
142
+ id: string;
143
+ source_message_id: string | null;
144
+ text: string;
145
+ text_complete: boolean;
146
+ queued_at: string;
147
+ delivery: 'subturn' | 'end-of-turn';
148
+ attachments: DesktopTaskControlAttachment[];
149
+ }
150
+ export interface DesktopTaskControlState {
151
+ version: 1;
152
+ session_id: string;
153
+ owner_id: string;
154
+ revision: number;
155
+ run_id: string | null;
156
+ blocked_reason: string | null;
157
+ can_stop: boolean;
158
+ entries: DesktopTaskControlEntry[];
159
+ runtime?: DesktopRuntimeState;
160
+ /** A preview request with a zero package ID captures the current checkpoint. */
161
+ share_available?: boolean;
162
+ share?: DesktopSessionShareState;
163
+ }
164
+ /** Derived from a detached canonical checkpoint; never a completion certificate. */
165
+ export interface DesktopSessionShareState {
166
+ package_id: string;
167
+ source: {
168
+ session_id: string | null;
169
+ as_of: string | null;
170
+ evidence_revision: number | null;
171
+ handoff_revision: number | null;
172
+ task_id: string | null;
173
+ };
174
+ index_markdown: string;
175
+ notice: string;
176
+ }
177
+ export type DesktopSessionShareAction = {
178
+ type: 'desktop_session_share_action';
179
+ request_id: string;
180
+ pane_id: number;
181
+ session_id: string;
182
+ owner_id: string;
183
+ revision: number;
184
+ package_id: string;
185
+ } & ({
186
+ action: 'preview' | 'copy';
187
+ } | {
188
+ action: 'save';
189
+ path: string;
190
+ });
191
+ /** Retained local observations are minima; provider account quota is a separate scope. */
192
+ export interface DesktopUsageView {
193
+ label: string;
194
+ reported_requests: number;
195
+ estimated_requests: number;
196
+ unavailable_requests: number;
197
+ input_tokens: number | null;
198
+ output_tokens: number | null;
199
+ total_tokens: number | null;
200
+ estimated_tokens: number | null;
201
+ cost_usd: string | null;
202
+ coverage: 'observed_minimum' | 'unknown';
203
+ }
204
+ export interface DesktopRuntimeAccount {
205
+ id: string;
206
+ label: string;
207
+ provider: string;
208
+ selected: boolean;
209
+ usable: boolean;
210
+ status: string;
211
+ cooldown_until: number | null;
212
+ quota_summary: string | null;
213
+ }
214
+ export interface DesktopRuntimeState {
215
+ provider: string;
216
+ model: string;
217
+ selected_account_id: string | null;
218
+ observed_at: string;
219
+ accounts: DesktopRuntimeAccount[];
220
+ usage: {
221
+ session: DesktopUsageView;
222
+ project: DesktopUsageView;
223
+ today: DesktopUsageView;
224
+ };
225
+ switching_blocked_reason: string | null;
226
+ context_notice: string;
227
+ }
228
+ export type DesktopRuntimeAction = {
229
+ type: 'desktop_runtime_action';
230
+ request_id: string;
231
+ pane_id: number;
232
+ session_id: string;
233
+ owner_id: string;
234
+ revision: number;
235
+ } & ({
236
+ action: 'account_use';
237
+ account_id: string;
238
+ } | {
239
+ action: 'open_models';
240
+ });
241
+ export interface DesktopTaskActionResult {
242
+ request_id: string;
243
+ status: 'applied' | 'stale' | 'not_queued' | 'blocked' | 'persistence_failed' | 'invalid';
244
+ message: string;
245
+ }
246
+ export interface DesktopTaskAction {
247
+ type: 'desktop_task_action';
248
+ request_id: string;
249
+ pane_id: number;
250
+ session_id: string;
251
+ owner_id: string;
252
+ revision: number;
253
+ run_id: string | null;
254
+ action: 'edit' | 'remove' | 'reorder' | 'send_now' | 'stop';
255
+ entry_id?: string | null;
256
+ text?: string | null;
257
+ before_id?: string | null;
258
+ }
91
259
  export type RustCommand = {
92
260
  type: 'render';
93
261
  frame: LayoutFrame;
@@ -116,11 +284,16 @@ export type RustCommand = {
116
284
  } | {
117
285
  type: 'read_clipboard_image';
118
286
  request_id: string;
287
+ } | {
288
+ type: 'read_clipboard_text';
289
+ request_id: string;
119
290
  } | {
120
291
  type: 'config';
121
292
  scrollback?: boolean;
122
293
  debug?: boolean;
123
294
  viewport_height?: number;
295
+ mouse_capture?: boolean;
296
+ wheel_scroll_lines?: number;
124
297
  } | {
125
298
  type: 'shutdown';
126
299
  } | {
@@ -227,9 +400,18 @@ export type RustCommand = {
227
400
  cursors: ZlickyCursorOverlay[];
228
401
  } | {
229
402
  type: 'get_session_state';
403
+ } | {
404
+ type: 'get_terminal_metrics';
405
+ request_id: string;
230
406
  } | {
231
407
  type: 'restore_session_state';
232
408
  state: MuxSessionState;
409
+ } | {
410
+ type: 'workspace_layout';
411
+ action: 'save' | 'list' | 'restore' | 'delete';
412
+ request_id: string;
413
+ name?: string;
414
+ state?: MuxSessionState;
233
415
  } | {
234
416
  type: 'switch_window';
235
417
  window_id: number;
@@ -256,12 +438,23 @@ export type RustCommand = {
256
438
  type: 'set_pane_title';
257
439
  pane_id: number;
258
440
  title: string;
441
+ source?: 'manual' | 'inferred';
442
+ } | {
443
+ type: 'set_pane_labels';
444
+ pane_id: number;
445
+ labels: PaneLabels;
446
+ if_newer?: boolean;
259
447
  } | {
260
448
  type: 'set_pane_activity';
261
449
  pane_id: number;
262
450
  status?: string;
263
451
  spinner?: string;
264
452
  label?: string;
453
+ } | {
454
+ type: 'set_pane_task_controls';
455
+ pane_id: number;
456
+ state: DesktopTaskControlState;
457
+ result?: DesktopTaskActionResult;
265
458
  } | {
266
459
  type: 'set_keybindings';
267
460
  keymap: {
@@ -275,7 +468,7 @@ export type RustCommand = {
275
468
  type: 'set_wheel_capture';
276
469
  active: boolean;
277
470
  };
278
- export type RustEvent = {
471
+ export type RustEvent = DesktopTaskAction | DesktopRuntimeAction | DesktopSessionShareAction | {
279
472
  type: 'ready';
280
473
  version: string;
281
474
  cols: number;
@@ -285,6 +478,7 @@ export type RustEvent = {
285
478
  type: 'input';
286
479
  input: string;
287
480
  key: InputKey;
481
+ paste?: true;
288
482
  } | {
289
483
  type: 'resize';
290
484
  cols: number;
@@ -298,6 +492,11 @@ export type RustEvent = {
298
492
  request_id: string;
299
493
  png_base64: string | null;
300
494
  error?: string | null;
495
+ } | {
496
+ type: 'clipboard_text';
497
+ request_id: string;
498
+ text: string | null;
499
+ error?: string | null;
301
500
  } | {
302
501
  type: 'error';
303
502
  message: string;
@@ -355,6 +554,36 @@ export type RustEvent = {
355
554
  } | {
356
555
  type: 'session_state';
357
556
  state: MuxSessionState;
557
+ }
558
+ /** Native previous-frame CPU update/render ms, excluding vsync/presentation.
559
+ * History is oldest→newest, finite/nonnegative, last≤120; sample count is cumulative.
560
+ * Grid is protocol owner pane 0; pane count includes that owner.
561
+ */
562
+ | {
563
+ type: 'terminal_metrics';
564
+ request_id: string;
565
+ frame_count: number;
566
+ frame_cpu_sample_count: number;
567
+ frame_cpu_samples_ms: number[];
568
+ pane_count: number;
569
+ viewport_cols: number;
570
+ viewport_rows: number;
571
+ window_width_points: number;
572
+ window_height_points: number;
573
+ pixels_per_point: number;
574
+ focused: boolean;
575
+ } | {
576
+ type: 'workspace_pane_action';
577
+ pane_id: number;
578
+ action: 'run' | 'resume';
579
+ } | {
580
+ type: 'workspace_layout_result';
581
+ request_id: string;
582
+ action: 'save' | 'list' | 'restore' | 'delete';
583
+ ok: boolean;
584
+ names: string[];
585
+ state?: MuxSessionState;
586
+ message?: string;
358
587
  } | {
359
588
  type: 'session_restored';
360
589
  restored_panes: number;
@@ -409,3 +638,9 @@ export declare function serializeCommand(cmd: RustCommand): string;
409
638
  * Parse an event from Rust
410
639
  */
411
640
  export declare function parseEvent(json: string): RustEvent | null;
641
+ /** Sharing intents carry only bounded identities and an explicit save destination. */
642
+ export declare function isDesktopSessionShareAction(value: unknown): value is DesktopSessionShareAction;
643
+ /** Runtime intents have no optional payload fields or unrecognized operations. */
644
+ export declare function isDesktopRuntimeAction(value: unknown): value is DesktopRuntimeAction;
645
+ /** Reject malformed native actions before any host queue operation sees them. */
646
+ export declare function isDesktopTaskAction(value: unknown): value is DesktopTaskAction;
@@ -8,7 +8,13 @@
8
8
  export const CAPABILITY_PANE_DELIVERY_ACK = 'pane_delivery_ack_v1';
9
9
  export const CAPABILITY_SCROLLBACK_ANCHOR = 'scrollback_anchor';
10
10
  export const CAPABILITY_DESKTOP_UPDATE_RESTART = 'desktop_update_restart_v1';
11
+ export const CAPABILITY_DESKTOP_TASK_CONTROLS = 'desktop_task_controls_v1';
12
+ export const CAPABILITY_DESKTOP_RUNTIME_CONTROLS = 'desktop_runtime_controls_v1';
13
+ export const CAPABILITY_DESKTOP_SESSION_SHARE = 'desktop_session_share_v1';
14
+ export const CAPABILITY_TERMINAL_FRAME_METRICS = 'terminal_frame_metrics_v1';
15
+ export const CAPABILITY_TERMINAL_INTERACTION = 'terminal_interaction_v1';
11
16
  export const CAPABILITY_CLIPBOARD_IMAGE = 'clipboard_image';
17
+ export const CAPABILITY_CLIPBOARD_TEXT = 'clipboard_text';
12
18
  // ============================================================================
13
19
  // Serialization helpers
14
20
  // ============================================================================
@@ -27,9 +33,93 @@ export function parseEvent(json) {
27
33
  if (!parsed || typeof parsed !== 'object' || !('type' in parsed)) {
28
34
  return null;
29
35
  }
36
+ if (parsed.type === 'desktop_task_action' && !isDesktopTaskAction(parsed))
37
+ return null;
38
+ if (parsed.type === 'desktop_runtime_action' && !isDesktopRuntimeAction(parsed))
39
+ return null;
40
+ if (parsed.type === 'desktop_session_share_action' && !isDesktopSessionShareAction(parsed))
41
+ return null;
30
42
  return parsed;
31
43
  }
32
44
  catch {
33
45
  return null;
34
46
  }
35
47
  }
48
+ /** Sharing intents carry only bounded identities and an explicit save destination. */
49
+ export function isDesktopSessionShareAction(value) {
50
+ if (value === null || typeof value !== 'object' || Array.isArray(value))
51
+ return false;
52
+ const event = value;
53
+ const identity = (id) => typeof id === 'string' && id.length > 0
54
+ && Buffer.byteLength(id, 'utf8') <= 256 && !/[\u0000-\u001f\u007f-\u009f]/.test(id);
55
+ if (event.type !== 'desktop_session_share_action' || !identity(event.request_id)
56
+ || !identity(event.session_id) || !identity(event.owner_id)
57
+ || !Number.isInteger(event.pane_id) || event.pane_id < 0 || event.pane_id > 0xffff_ffff
58
+ || !Number.isSafeInteger(event.revision) || event.revision < 0
59
+ || typeof event.package_id !== 'string' || !/^[a-f0-9]{64}$/.test(event.package_id))
60
+ return false;
61
+ const keys = ['type', 'request_id', 'pane_id', 'session_id', 'owner_id', 'revision', 'package_id', 'action'];
62
+ if (event.action === 'save') {
63
+ if (typeof event.path !== 'string' || event.path.trim().length === 0
64
+ || Buffer.byteLength(event.path, 'utf8') > 4096 || /[\u0000-\u001f\u007f-\u009f]/.test(event.path))
65
+ return false;
66
+ keys.push('path');
67
+ }
68
+ else if (event.action !== 'preview' && event.action !== 'copy')
69
+ return false;
70
+ return Object.keys(event).every(key => keys.includes(key));
71
+ }
72
+ /** Runtime intents have no optional payload fields or unrecognized operations. */
73
+ export function isDesktopRuntimeAction(value) {
74
+ if (value === null || typeof value !== 'object' || Array.isArray(value))
75
+ return false;
76
+ const event = value;
77
+ const identity = (id) => typeof id === 'string' && id.length > 0
78
+ && Buffer.byteLength(id, 'utf8') <= 256 && !/[\u0000-\u001f\u007f-\u009f]/.test(id);
79
+ if (event.type !== 'desktop_runtime_action' || !identity(event.request_id)
80
+ || !identity(event.session_id) || !identity(event.owner_id)
81
+ || !Number.isInteger(event.pane_id) || event.pane_id < 0 || event.pane_id > 0xffff_ffff
82
+ || !Number.isSafeInteger(event.revision) || event.revision < 0)
83
+ return false;
84
+ const keys = ['type', 'request_id', 'pane_id', 'session_id', 'owner_id', 'revision', 'action'];
85
+ if (event.action === 'account_use') {
86
+ if (!identity(event.account_id))
87
+ return false;
88
+ keys.push('account_id');
89
+ }
90
+ else if (event.action !== 'open_models')
91
+ return false;
92
+ return Object.keys(event).every(key => keys.includes(key));
93
+ }
94
+ /** Reject malformed native actions before any host queue operation sees them. */
95
+ export function isDesktopTaskAction(value) {
96
+ if (value === null || typeof value !== 'object' || Array.isArray(value))
97
+ return false;
98
+ const event = value;
99
+ const identity = (id) => typeof id === 'string' && id.length > 0
100
+ && Buffer.byteLength(id, 'utf8') <= 256 && !/[\u0000-\u001f\u007f-\u009f]/.test(id);
101
+ if (event.type !== 'desktop_task_action' || !identity(event.request_id)
102
+ || !identity(event.session_id) || !identity(event.owner_id)
103
+ || !Number.isInteger(event.pane_id) || event.pane_id < 0 || event.pane_id > 0xffff_ffff
104
+ || !Number.isSafeInteger(event.revision) || event.revision < 0
105
+ || (event.run_id !== null && !identity(event.run_id)))
106
+ return false;
107
+ if (!['edit', 'remove', 'reorder', 'send_now', 'stop'].includes(event.action))
108
+ return false;
109
+ for (const id of [event.entry_id, event.before_id]) {
110
+ if (id !== undefined && id !== null && !identity(id))
111
+ return false;
112
+ }
113
+ if (event.text !== undefined && event.text !== null
114
+ && (typeof event.text !== 'string' || Buffer.byteLength(event.text, 'utf8') > 65_536))
115
+ return false;
116
+ if (event.action === 'stop')
117
+ return event.run_id !== null;
118
+ if (!identity(event.entry_id))
119
+ return false;
120
+ if (event.action === 'edit' && (typeof event.text !== 'string' || Buffer.byteLength(event.text, 'utf8') > 65_536))
121
+ return false;
122
+ if (event.action === 'reorder' && event.before_id !== undefined && event.before_id !== null && !identity(event.before_id))
123
+ return false;
124
+ return true;
125
+ }
@@ -47,7 +47,7 @@ export interface ScrollbackLine {
47
47
  */
48
48
  message_id?: string;
49
49
  }
50
- export declare function messageHeaderToScrollbackLine(message: Message, formatTime: (date: Date) => string): ScrollbackLine;
50
+ export declare function messageHeaderToScrollbackLine(message: Message, formatTime: (date: Date) => string, cols?: number, showTurnMetadata?: boolean): ScrollbackLine;
51
51
  /**
52
52
  * Highlight plan for a tool-trace message body, or undefined for any other
53
53
  * message.
@@ -64,6 +64,7 @@ export declare function toolBodyHighlightPlanForMessage(message: Message): ToolB
64
64
  */
65
65
  export declare function messageToScrollbackLines(message: Message, formatTime: (date: Date) => string, cols: number, options?: {
66
66
  showThinking?: boolean;
67
+ showTurnMetadata?: boolean;
67
68
  }): ScrollbackLine[];
68
69
  /**
69
70
  * Render message body to scrollback lines, matching the live
@@ -4,7 +4,9 @@
4
4
  *
5
5
  * Extracted from cli_ratatui.ts to reduce file size.
6
6
  */
7
+ import { messageHeaderSuffix } from './core/turn_metadata.js';
7
8
  import { isToolResultMessage } from '../utils/tool_result_message.js';
9
+ import { isToolUsePlaceholderMessage } from '../utils/assistant_message.js';
8
10
  import { highlightLine, segmentsToAnsi, sgrForeground, stripAnsi, toolBodyHighlightPlan, toolBodyLineOptions, } from './syntax_highlight.js';
9
11
  import { TERMINAL_THEME } from './views/theme.js';
10
12
  import { CODE_FRAME_DEFAULT_WIDTH, ListNesting, MESSAGE_BODY_INDENT, RECAP_CONTINUATION_INDENT, RECAP_PREFIX, THINKING_BODY_INDENT, TRANSCRIPT_INDENT_STEP, frameIndentFor, indentUnits, leadingIndentSpaces, parseListMarker, parseQuotePrefix, quoteGutter, } from './indent.js';
@@ -276,12 +278,13 @@ function roleConfig(message) {
276
278
  return { label: 'System', icon: '●', color: 'gray' };
277
279
  }
278
280
  }
279
- export function messageHeaderToScrollbackLine(message, formatTime) {
281
+ export function messageHeaderToScrollbackLine(message, formatTime, cols = 80, showTurnMetadata = true) {
280
282
  const config = roleConfig(message);
281
283
  const timestamp = message.timestamp instanceof Date ? message.timestamp : new Date(message.timestamp);
282
284
  // `${icon} ${label} • ${time}` matches the live `SingleMessage.tsx` row.
283
285
  const head = sgr(`${config.icon} ${config.label}`, config.color, { bold: true });
284
- const tail = sgr(` • ${formatTime(timestamp)}`, 'gray', { dim: true });
286
+ const plain = `${config.icon} ${config.label} • ${formatTime(timestamp)}`;
287
+ const tail = sgr(` • ${formatTime(timestamp)}${messageHeaderSuffix(message, cols, displayWidth(plain), showTurnMetadata)}`, 'gray', { dim: true });
285
288
  return { text: `${head}${tail}` };
286
289
  }
287
290
  /**
@@ -307,7 +310,9 @@ export function toolBodyHighlightPlanForMessage(message) {
307
310
  */
308
311
  export function messageToScrollbackLines(message, formatTime, cols, options = {}) {
309
312
  // Tool-result user messages are API-only; never display them.
310
- if (isToolResultMessage(message))
313
+ if (isToolResultMessage(message) || message.metadata?.toolUseOnly === true)
314
+ return [];
315
+ if (isToolUsePlaceholderMessage(message))
311
316
  return [];
312
317
  if (options.showThinking === false && message.metadata?.reasoning === true)
313
318
  return [];
@@ -377,7 +382,7 @@ export function messageToScrollbackLines(message, formatTime, cols, options = {}
377
382
  if (bodyLines.length === 0 && message.role === 'assistant' && !message.widget) {
378
383
  return [];
379
384
  }
380
- return stamp([messageHeaderToScrollbackLine(message, formatTime), ...bodyLines]);
385
+ return stamp([messageHeaderToScrollbackLine(message, formatTime, cols, options.showTurnMetadata), ...bodyLines]);
381
386
  }
382
387
  /** A `Label: value` row of the launch readout. */
383
388
  const READOUT_LABEL = /^([A-Z][A-Za-z0-9 ]*):( +)(.*)$/;
@@ -13,9 +13,9 @@ import type { Message } from '../types.js';
13
13
  * display settles at roughly `lagMs` behind arrival and drains any burst in
14
14
  * a bounded number of ticks, so the effect can never feel like a slow
15
15
  * typewriter.
16
- * - A finished message (`isStreaming` false) is shown whole immediately. The
17
- * reveal never delays the completed answer, and the transcript, session file
18
- * and mirror keep the exact received text.
16
+ * - With the optional prose cap off, a finished message is shown immediately.
17
+ * A selected cap keeps draining an already tracked display after completion;
18
+ * callers keep the complete canonical answer for storage and provider input.
19
19
  *
20
20
  * Callers own scheduling: they re-sample after one tick while `pending` is
21
21
  * true and stop ticking when nothing is owed.
@@ -28,6 +28,9 @@ export interface StreamTypewriterState {
28
28
  shown: number;
29
29
  /** Time of the last advance; lets several render sites share one tick. */
30
30
  lastTickAt: number;
31
+ /** Unspent word credit, used only when a prose reading cap is selected. */
32
+ readingWordCredit?: number;
33
+ readingUpdatedAt?: number;
31
34
  }
32
35
  export interface StreamTypewriterOptions {
33
36
  /** When false the content is passed through untouched. */
@@ -40,6 +43,8 @@ export interface StreamTypewriterOptions {
40
43
  lagMs?: number;
41
44
  /** Backlogs at or below this size are shown whole at once. */
42
45
  immediateChars?: number;
46
+ /** Positive prose words/second; null or omission keeps the bounded-lag behavior. */
47
+ proseReadingRateWordsPerSecond?: number | null;
43
48
  }
44
49
  export interface StreamTypewriterPlan {
45
50
  /** Content to render for this sample. */
@@ -80,7 +80,13 @@ export function planStreamTypewriterSample(state, message, options) {
80
80
  shown: content.length,
81
81
  lastTickAt: options.now,
82
82
  };
83
- if (!options.enabled || !message.isStreaming) {
83
+ const requestedRate = options.proseReadingRateWordsPerSecond;
84
+ // Existing renderers recognize backtick fences. Mixed prose/code deliberately
85
+ // keeps the existing reveal instead of slowing a code block as human prose.
86
+ const readingRate = typeof requestedRate === 'number' && Number.isFinite(requestedRate)
87
+ && requestedRate > 0 && !/^\s*```/m.test(content) ? requestedRate : null;
88
+ const trackedCompletion = state.messageId === message.id && state.shown < content.length;
89
+ if (!options.enabled || (!message.isStreaming && (readingRate === null || !trackedCompletion))) {
84
90
  return { content, nextState: settled, pending: false };
85
91
  }
86
92
  const continues = state.messageId === message.id
@@ -95,6 +101,29 @@ export function planStreamTypewriterSample(state, message, options) {
95
101
  ? state
96
102
  : { messageId: message.id, full: '', shown: 0, lastTickAt: options.now - tickMs };
97
103
  const backlog = content.length - tracked.shown;
104
+ if (readingRate !== null) {
105
+ const elapsed = Math.max(0, options.now - (tracked.readingUpdatedAt ?? options.now));
106
+ const earned = (tracked.readingWordCredit ?? 1) + readingRate * elapsed / 1_000;
107
+ // A provider that was caught up cannot bank a long silent wait and then
108
+ // bypass the cap with its next burst. Available backlogs earn normal credit.
109
+ const credit = tracked.shown === tracked.full.length ? Math.min(1, earned) : earned;
110
+ const receivedWords = [...content.matchAll(/\S+/g)];
111
+ const visibleWords = (content.slice(0, tracked.shown).match(/\S+/g) ?? []).length;
112
+ const allowedWords = visibleWords + Math.floor(credit);
113
+ const cut = allowedWords < receivedWords.length ? receivedWords[allowedWords].index : content.length;
114
+ const shown = Math.max(tracked.shown, clampRevealBoundary(content, cut));
115
+ const spent = Math.max(0, (content.slice(0, shown).match(/\S+/g) ?? []).length - visibleWords);
116
+ const remaining = content.length - shown;
117
+ const owedTime = credit < 1;
118
+ return {
119
+ content: content.slice(0, shown),
120
+ nextState: { messageId: message.id, full: content, shown,
121
+ lastTickAt: shown > tracked.shown ? options.now : tracked.lastTickAt,
122
+ readingWordCredit: remaining > 0 ? credit - spent : Math.min(1, credit - spent),
123
+ readingUpdatedAt: options.now },
124
+ pending: remaining > 0 && (shown > tracked.shown || owedTime),
125
+ };
126
+ }
98
127
  if (backlog <= 0) {
99
128
  return { content, nextState: { ...tracked, full: content, shown: content.length }, pending: false };
100
129
  }
@@ -16,6 +16,7 @@ export interface StreamingScrollbackOptions {
16
16
  liveTailLines: number;
17
17
  final: boolean;
18
18
  cols: number;
19
+ showTurnMetadata?: boolean;
19
20
  }
20
21
  export interface StreamingScrollbackPlan {
21
22
  lines: ScrollbackLine[];
@@ -65,7 +65,7 @@ export function planStreamingScrollbackAppend(state, message, formatTime, option
65
65
  // and stamped with the message id like every other line of this message.
66
66
  if (lines.length > 0 && !activeState.headerPrinted) {
67
67
  lines.unshift({
68
- ...messageHeaderToScrollbackLine(message, formatTime),
68
+ ...messageHeaderToScrollbackLine(message, formatTime, options.cols, options.showTurnMetadata),
69
69
  message_id: message.id,
70
70
  });
71
71
  }
@@ -73,8 +73,10 @@ export class TranscriptRenderCache {
73
73
  lines,
74
74
  reasoning: metadataFlag(message, 'reasoning'),
75
75
  recap: metadataFlag(message, 'recap'),
76
+ planMode: metadataFlag(message, 'planMode'),
76
77
  role: message.role,
77
78
  streaming: message.isStreaming === true,
79
+ turnKey: turnRenderKey(message),
78
80
  timestampMs: message.timestamp instanceof Date ? message.timestamp.getTime() : -1,
79
81
  timestampRef: message.timestamp,
80
82
  toolOutput: toolOutputIdentity(message),
@@ -100,8 +102,12 @@ export class TranscriptRenderCache {
100
102
  return false;
101
103
  if (entry.recap !== metadataFlag(message, 'recap'))
102
104
  return false;
105
+ if (entry.planMode !== metadataFlag(message, 'planMode'))
106
+ return false;
103
107
  if (entry.toolOutput !== toolOutputIdentity(message))
104
108
  return false;
109
+ if (entry.turnKey !== turnRenderKey(message))
110
+ return false;
105
111
  if (entry.timestampRef !== message.timestamp) {
106
112
  // A rebuilt Date instance with the same instant still renders the same
107
113
  // header; only a different instant invalidates the entry.
@@ -131,3 +137,7 @@ export class TranscriptRenderCache {
131
137
  function toolOutputIdentity(message) {
132
138
  return message.metadata?.toolOutput;
133
139
  }
140
+ function turnRenderKey(message) {
141
+ const turn = message.turn;
142
+ return turn ? `${turn.id}|${turn.startedAt}|${turn.finishedAt ?? 'live'}|${turn.tokens}|${turn.estimated}|${turn.usageIncomplete}|${Math.floor((turn.finishedAt ?? Date.now()) / 1000)}` : '';
143
+ }
@@ -1,11 +1,11 @@
1
- import { AgentState } from '../../types.js';
1
+ import type { AgentState, InputMode } from '../../types.js';
2
2
  import { LayoutNode } from '../core/index.js';
3
3
  import type { TodoItem } from '../../app/controller.js';
4
4
  interface ActivityLineProps {
5
5
  state: AgentState;
6
6
  spinnerLabel?: string | null;
7
7
  spinnerFrame?: string | null;
8
- inputMode?: 'queue' | 'interrupt';
8
+ inputMode?: InputMode;
9
9
  isRecording?: boolean;
10
10
  recordingDevice?: string | null;
11
11
  audioLevel?: number;
@@ -19,8 +19,10 @@ interface ActivityLineProps {
19
19
  stallHintMs?: number;
20
20
  /** Render-time clock; injectable so tests can pin elapsed/quiet values. */
21
21
  now?: number;
22
+ /** Available terminal cells; tool output remains one untrusted display row. */
23
+ cols?: number;
22
24
  }
23
- export declare function buildActivityLineView({ state, spinnerLabel, spinnerFrame, inputMode, scrollback, isRecording, recordingDevice, audioLevel, partialTranscript, activeTask, taskStartedAt, tokensUsed, showTodos, hasTodos, lastEventAt, stallHintMs, now, }: ActivityLineProps & {
25
+ export declare function buildActivityLineView({ state, spinnerLabel, spinnerFrame, inputMode, scrollback, isRecording, recordingDevice, audioLevel, partialTranscript, activeTask, taskStartedAt, tokensUsed, showTodos, hasTodos, lastEventAt, stallHintMs, now, cols, }: ActivityLineProps & {
24
26
  scrollback?: boolean;
25
27
  }): LayoutNode;
26
28
  export {};