iCode-TUI 0.29.1__py3-none-any.whl

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 (1138) hide show
  1. chrys/__init__.py +16 -0
  2. chrys/app/__init__.py +3 -0
  3. chrys/app/acp/__init__.py +3 -0
  4. chrys/app/acp/bridge.py +664 -0
  5. chrys/app/acp/content.py +132 -0
  6. chrys/app/acp/doc/frontend-api.md +425 -0
  7. chrys/app/acp/history.py +585 -0
  8. chrys/app/acp/server.py +1796 -0
  9. chrys/app/acp/session_manager.py +1815 -0
  10. chrys/app/acp/tool_status.py +45 -0
  11. chrys/app/cli/__init__.py +3 -0
  12. chrys/app/cli/acp.py +178 -0
  13. chrys/app/cli/app.py +165 -0
  14. chrys/app/cli/approvals.py +101 -0
  15. chrys/app/cli/headless.py +223 -0
  16. chrys/app/cli/launch_cwd.py +42 -0
  17. chrys/app/cli/profiles.py +298 -0
  18. chrys/app/cli/progress.py +857 -0
  19. chrys/app/cli/run.py +425 -0
  20. chrys/app/cli/serve.py +1593 -0
  21. chrys/app/cli/tool_summary.py +225 -0
  22. chrys/app/cli/trajectory.py +201 -0
  23. chrys/app/cli/workflow.py +601 -0
  24. chrys/app/features/__init__.py +3 -0
  25. chrys/app/features/buddy/__init__.py +3 -0
  26. chrys/app/features/buddy/actions.py +68 -0
  27. chrys/app/features/buddy/animation.py +76 -0
  28. chrys/app/features/buddy/commands.py +196 -0
  29. chrys/app/features/buddy/docs/design.md +187 -0
  30. chrys/app/features/buddy/hatchery.py +80 -0
  31. chrys/app/features/buddy/lifecycle.py +41 -0
  32. chrys/app/features/buddy/model.py +265 -0
  33. chrys/app/features/buddy/pixel_renderer.py +113 -0
  34. chrys/app/features/buddy/pixel_sprites.py +279 -0
  35. chrys/app/features/buddy/portrait.py +76 -0
  36. chrys/app/features/buddy/progression.py +58 -0
  37. chrys/app/features/buddy/replies.py +191 -0
  38. chrys/app/features/buddy/sprites/alien.toml +70 -0
  39. chrys/app/features/buddy/sprites/axolotl.toml +71 -0
  40. chrys/app/features/buddy/sprites/bat.toml +69 -0
  41. chrys/app/features/buddy/sprites/bee.toml +69 -0
  42. chrys/app/features/buddy/sprites/cactus.toml +73 -0
  43. chrys/app/features/buddy/sprites/capybara.toml +70 -0
  44. chrys/app/features/buddy/sprites/cat.toml +69 -0
  45. chrys/app/features/buddy/sprites/crab.toml +70 -0
  46. chrys/app/features/buddy/sprites/dragon.toml +71 -0
  47. chrys/app/features/buddy/sprites/duck.toml +69 -0
  48. chrys/app/features/buddy/sprites/fox.toml +69 -0
  49. chrys/app/features/buddy/sprites/frog.toml +70 -0
  50. chrys/app/features/buddy/sprites/ghost.toml +70 -0
  51. chrys/app/features/buddy/sprites/goose.toml +69 -0
  52. chrys/app/features/buddy/sprites/jelly.toml +70 -0
  53. chrys/app/features/buddy/sprites/llama.toml +70 -0
  54. chrys/app/features/buddy/sprites/mushroom.toml +69 -0
  55. chrys/app/features/buddy/sprites/octopus.toml +70 -0
  56. chrys/app/features/buddy/sprites/owl.toml +70 -0
  57. chrys/app/features/buddy/sprites/panda.toml +71 -0
  58. chrys/app/features/buddy/sprites/penguin.toml +69 -0
  59. chrys/app/features/buddy/sprites/rabbit.toml +70 -0
  60. chrys/app/features/buddy/sprites/robot.toml +72 -0
  61. chrys/app/features/buddy/sprites/shark.toml +70 -0
  62. chrys/app/features/buddy/sprites/snail.toml +69 -0
  63. chrys/app/features/buddy/sprites/snake.toml +69 -0
  64. chrys/app/features/buddy/sprites/tabby.toml +69 -0
  65. chrys/app/features/buddy/sprites/turtle.toml +69 -0
  66. chrys/app/features/buddy/store.py +143 -0
  67. chrys/app/features/session_title/__init__.py +7 -0
  68. chrys/app/features/session_title/updater.py +582 -0
  69. chrys/app/installer.py +651 -0
  70. chrys/app/parsing.py +17 -0
  71. chrys/app/tui/__init__.py +3 -0
  72. chrys/app/tui/app.py +1287 -0
  73. chrys/app/tui/behaviors/__init__.py +3 -0
  74. chrys/app/tui/behaviors/click_outside_dismiss.py +90 -0
  75. chrys/app/tui/behaviors/insert_clipboard.py +73 -0
  76. chrys/app/tui/behaviors/right_click_copy.py +146 -0
  77. chrys/app/tui/binding_display.py +139 -0
  78. chrys/app/tui/buddy_messages.py +17 -0
  79. chrys/app/tui/buddy_reply.py +86 -0
  80. chrys/app/tui/chrys.tcss +549 -0
  81. chrys/app/tui/clipboard.py +109 -0
  82. chrys/app/tui/copy_messages.py +10 -0
  83. chrys/app/tui/i18n.py +230 -0
  84. chrys/app/tui/language.py +58 -0
  85. chrys/app/tui/notifications/__init__.py +12 -0
  86. chrys/app/tui/notifications/drivers.py +180 -0
  87. chrys/app/tui/notifications/service.py +126 -0
  88. chrys/app/tui/notifications/settings.py +141 -0
  89. chrys/app/tui/screens/__init__.py +3 -0
  90. chrys/app/tui/screens/agents/__init__.py +8 -0
  91. chrys/app/tui/screens/agents/agent_draft_store.py +937 -0
  92. chrys/app/tui/screens/agents/config.py +2142 -0
  93. chrys/app/tui/screens/agents/config.tcss +169 -0
  94. chrys/app/tui/screens/agents/panels/__init__.py +3 -0
  95. chrys/app/tui/screens/agents/panels/acp.py +1176 -0
  96. chrys/app/tui/screens/agents/panels/basic.py +497 -0
  97. chrys/app/tui/screens/agents/panels/compaction.py +231 -0
  98. chrys/app/tui/screens/agents/panels/config_card.py +218 -0
  99. chrys/app/tui/screens/agents/panels/instructions.py +91 -0
  100. chrys/app/tui/screens/agents/panels/markdown_report.py +76 -0
  101. chrys/app/tui/screens/agents/panels/mcp.py +2262 -0
  102. chrys/app/tui/screens/agents/panels/memory.py +684 -0
  103. chrys/app/tui/screens/agents/panels/path_entry.py +227 -0
  104. chrys/app/tui/screens/agents/panels/skills.py +806 -0
  105. chrys/app/tui/screens/agents/panels/subagents.py +652 -0
  106. chrys/app/tui/screens/agents/panels/tools.py +205 -0
  107. chrys/app/tui/screens/agents/picker.py +103 -0
  108. chrys/app/tui/screens/agents/skill_paths.py +38 -0
  109. chrys/app/tui/screens/agents/validation_messages.py +452 -0
  110. chrys/app/tui/screens/dialogs/__init__.py +35 -0
  111. chrys/app/tui/screens/dialogs/agent_load.py +834 -0
  112. chrys/app/tui/screens/dialogs/agent_load.tcss +78 -0
  113. chrys/app/tui/screens/dialogs/app_mode.py +55 -0
  114. chrys/app/tui/screens/dialogs/approval/__init__.py +15 -0
  115. chrys/app/tui/screens/dialogs/approval/approval.tcss +311 -0
  116. chrys/app/tui/screens/dialogs/approval/bodies/__init__.py +3 -0
  117. chrys/app/tui/screens/dialogs/approval/bodies/file_edit.py +210 -0
  118. chrys/app/tui/screens/dialogs/approval/bodies/sub_agent.py +82 -0
  119. chrys/app/tui/screens/dialogs/approval/body.py +110 -0
  120. chrys/app/tui/screens/dialogs/approval/dialog.py +565 -0
  121. chrys/app/tui/screens/dialogs/approval/mode.py +105 -0
  122. chrys/app/tui/screens/dialogs/ask_user.py +148 -0
  123. chrys/app/tui/screens/dialogs/ask_user.tcss +62 -0
  124. chrys/app/tui/screens/dialogs/base.py +84 -0
  125. chrys/app/tui/screens/dialogs/confirm.py +184 -0
  126. chrys/app/tui/screens/dialogs/confirm.tcss +46 -0
  127. chrys/app/tui/screens/dialogs/connection_test.py +183 -0
  128. chrys/app/tui/screens/dialogs/connection_test.tcss +92 -0
  129. chrys/app/tui/screens/dialogs/diagram.py +102 -0
  130. chrys/app/tui/screens/dialogs/diagram.tcss +24 -0
  131. chrys/app/tui/screens/dialogs/editor.py +378 -0
  132. chrys/app/tui/screens/dialogs/editor.tcss +132 -0
  133. chrys/app/tui/screens/dialogs/file_picker.py +582 -0
  134. chrys/app/tui/screens/dialogs/file_picker.tcss +78 -0
  135. chrys/app/tui/screens/dialogs/fork_session.py +219 -0
  136. chrys/app/tui/screens/dialogs/fork_session.tcss +75 -0
  137. chrys/app/tui/screens/dialogs/image_compression.py +102 -0
  138. chrys/app/tui/screens/dialogs/image_compression.tcss +28 -0
  139. chrys/app/tui/screens/dialogs/man_page.py +172 -0
  140. chrys/app/tui/screens/dialogs/man_page.tcss +39 -0
  141. chrys/app/tui/screens/dialogs/new_folder.py +277 -0
  142. chrys/app/tui/screens/dialogs/new_folder.tcss +51 -0
  143. chrys/app/tui/screens/dialogs/notice.tcss +14 -0
  144. chrys/app/tui/screens/dialogs/prompt_cache.py +144 -0
  145. chrys/app/tui/screens/dialogs/prompt_cache.tcss +38 -0
  146. chrys/app/tui/screens/dialogs/runtime_details.py +371 -0
  147. chrys/app/tui/screens/dialogs/runtime_details.tcss +49 -0
  148. chrys/app/tui/screens/dialogs/session_title.py +110 -0
  149. chrys/app/tui/screens/dialogs/session_title.tcss +43 -0
  150. chrys/app/tui/screens/dialogs/tool_view.py +207 -0
  151. chrys/app/tui/screens/dialogs/tool_view.tcss +43 -0
  152. chrys/app/tui/screens/dialogs/vision_unsupported.py +122 -0
  153. chrys/app/tui/screens/dialogs/vision_unsupported.tcss +35 -0
  154. chrys/app/tui/screens/dialogs/workflow_confirm.py +91 -0
  155. chrys/app/tui/screens/dialogs/workflow_confirm.tcss +17 -0
  156. chrys/app/tui/screens/dialogs/workflow_input.py +258 -0
  157. chrys/app/tui/screens/dialogs/workflow_input.tcss +73 -0
  158. chrys/app/tui/screens/dialogs/workflow_node.py +462 -0
  159. chrys/app/tui/screens/dialogs/workflow_node.tcss +41 -0
  160. chrys/app/tui/screens/dialogs/workflow_picker.py +46 -0
  161. chrys/app/tui/screens/dialogs/workflow_result.py +136 -0
  162. chrys/app/tui/screens/dialogs/workflow_result.tcss +14 -0
  163. chrys/app/tui/screens/diff/__init__.py +22 -0
  164. chrys/app/tui/screens/diff/rollback_modal.py +1381 -0
  165. chrys/app/tui/screens/diff/rollback_modal.tcss +248 -0
  166. chrys/app/tui/screens/diff/screen.py +1532 -0
  167. chrys/app/tui/screens/diff/screen.tcss +104 -0
  168. chrys/app/tui/screens/guides/__init__.py +7 -0
  169. chrys/app/tui/screens/guides/_docs/en/guides/configuration/agents.md +178 -0
  170. chrys/app/tui/screens/guides/_docs/en/guides/configuration/approval.md +117 -0
  171. chrys/app/tui/screens/guides/_docs/en/guides/configuration/chat-options.md +276 -0
  172. chrys/app/tui/screens/guides/_docs/en/guides/configuration/compaction.md +42 -0
  173. chrys/app/tui/screens/guides/_docs/en/guides/configuration/memory.md +48 -0
  174. chrys/app/tui/screens/guides/_docs/en/guides/configuration/models.md +158 -0
  175. chrys/app/tui/screens/guides/_docs/en/guides/configuration/settings.md +210 -0
  176. chrys/app/tui/screens/guides/_docs/en/guides/configuration/themes.md +61 -0
  177. chrys/app/tui/screens/guides/_docs/en/guides/configuration/tools.md +60 -0
  178. chrys/app/tui/screens/guides/_docs/en/guides/configuration/web-tools.md +286 -0
  179. chrys/app/tui/screens/guides/_docs/en/guides/daily-use/sessions.md +77 -0
  180. chrys/app/tui/screens/guides/_docs/en/guides/daily-use/workspaces.md +51 -0
  181. chrys/app/tui/screens/guides/_docs/en/guides/extensions/external-acp-agents.md +126 -0
  182. chrys/app/tui/screens/guides/_docs/en/guides/extensions/hooks.md +167 -0
  183. chrys/app/tui/screens/guides/_docs/en/guides/extensions/mcp.md +95 -0
  184. chrys/app/tui/screens/guides/_docs/en/guides/extensions/skills.md +175 -0
  185. chrys/app/tui/screens/guides/_docs/en/guides/running/icode-acp.md +61 -0
  186. chrys/app/tui/screens/guides/_docs/en/guides/running/icode-run.md +190 -0
  187. chrys/app/tui/screens/guides/_docs/en/guides/running/icode-serve.md +239 -0
  188. chrys/app/tui/screens/guides/_docs/en/guides/running/workflows.md +664 -0
  189. chrys/app/tui/screens/guides/_docs/en/reference/agent-profile.md +548 -0
  190. chrys/app/tui/screens/guides/_docs/en/reference/hooks.md +602 -0
  191. chrys/app/tui/screens/guides/_docs/en/reference/opentelemetry.md +177 -0
  192. chrys/app/tui/screens/guides/_docs/en/reference/settings.md +245 -0
  193. chrys/app/tui/screens/guides/_docs/en/reference/themes.md +149 -0
  194. chrys/app/tui/screens/guides/_docs/en/reference/tool-kinds-and-names.md +58 -0
  195. chrys/app/tui/screens/guides/_docs/en/reference/tui-slash-commands.md +76 -0
  196. chrys/app/tui/screens/guides/_docs/en/reference/workflows.md +1006 -0
  197. chrys/app/tui/screens/guides/_docs/en/start/getting-started.md +170 -0
  198. chrys/app/tui/screens/guides/_docs/en/start/what-is-icode.md +34 -0
  199. chrys/app/tui/screens/guides/_docs/index.yaml +100 -0
  200. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/configuration/agents.md +178 -0
  201. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/configuration/approval.md +117 -0
  202. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/configuration/chat-options.md +276 -0
  203. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/configuration/compaction.md +42 -0
  204. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/configuration/memory.md +48 -0
  205. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/configuration/models.md +158 -0
  206. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/configuration/settings.md +210 -0
  207. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/configuration/themes.md +61 -0
  208. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/configuration/tools.md +60 -0
  209. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/configuration/web-tools.md +286 -0
  210. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/daily-use/sessions.md +77 -0
  211. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/daily-use/workspaces.md +51 -0
  212. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/extensions/external-acp-agents.md +126 -0
  213. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/extensions/hooks.md +167 -0
  214. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/extensions/mcp.md +95 -0
  215. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/extensions/skills.md +175 -0
  216. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/running/icode-acp.md +61 -0
  217. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/running/icode-run.md +190 -0
  218. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/running/icode-serve.md +239 -0
  219. chrys/app/tui/screens/guides/_docs/zh-Hans/guides/running/workflows.md +664 -0
  220. chrys/app/tui/screens/guides/_docs/zh-Hans/reference/agent-profile.md +548 -0
  221. chrys/app/tui/screens/guides/_docs/zh-Hans/reference/hooks.md +602 -0
  222. chrys/app/tui/screens/guides/_docs/zh-Hans/reference/opentelemetry.md +177 -0
  223. chrys/app/tui/screens/guides/_docs/zh-Hans/reference/settings.md +245 -0
  224. chrys/app/tui/screens/guides/_docs/zh-Hans/reference/themes.md +149 -0
  225. chrys/app/tui/screens/guides/_docs/zh-Hans/reference/tool-kinds-and-names.md +58 -0
  226. chrys/app/tui/screens/guides/_docs/zh-Hans/reference/tui-slash-commands.md +76 -0
  227. chrys/app/tui/screens/guides/_docs/zh-Hans/reference/workflows.md +1005 -0
  228. chrys/app/tui/screens/guides/_docs/zh-Hans/start/getting-started.md +170 -0
  229. chrys/app/tui/screens/guides/_docs/zh-Hans/start/what-is-icode.md +34 -0
  230. chrys/app/tui/screens/guides/index.py +215 -0
  231. chrys/app/tui/screens/guides/reader.py +173 -0
  232. chrys/app/tui/screens/guides/screen.py +442 -0
  233. chrys/app/tui/screens/guides/screen.tcss +52 -0
  234. chrys/app/tui/screens/logs/__init__.py +7 -0
  235. chrys/app/tui/screens/logs/screen.py +504 -0
  236. chrys/app/tui/screens/logs/screen.tcss +45 -0
  237. chrys/app/tui/screens/main/__init__.py +7 -0
  238. chrys/app/tui/screens/main/action_availability.py +30 -0
  239. chrys/app/tui/screens/main/buddy_command.py +143 -0
  240. chrys/app/tui/screens/main/commands.py +1073 -0
  241. chrys/app/tui/screens/main/config_actions.py +464 -0
  242. chrys/app/tui/screens/main/copy_actions.py +117 -0
  243. chrys/app/tui/screens/main/dialog_controllers.py +826 -0
  244. chrys/app/tui/screens/main/dialog_gateway.py +166 -0
  245. chrys/app/tui/screens/main/diff_controller.py +478 -0
  246. chrys/app/tui/screens/main/engine_read_model.py +184 -0
  247. chrys/app/tui/screens/main/event_handlers.py +2014 -0
  248. chrys/app/tui/screens/main/input_flow.py +241 -0
  249. chrys/app/tui/screens/main/live_diff.py +244 -0
  250. chrys/app/tui/screens/main/main_screen_presenter.py +295 -0
  251. chrys/app/tui/screens/main/model_indicator.py +217 -0
  252. chrys/app/tui/screens/main/navigation.py +343 -0
  253. chrys/app/tui/screens/main/ports.py +571 -0
  254. chrys/app/tui/screens/main/recent_dirs.py +123 -0
  255. chrys/app/tui/screens/main/rollback_controller.py +586 -0
  256. chrys/app/tui/screens/main/runtime_info.py +71 -0
  257. chrys/app/tui/screens/main/screen.py +2265 -0
  258. chrys/app/tui/screens/main/screen.tcss +21 -0
  259. chrys/app/tui/screens/main/session_handlers.py +1127 -0
  260. chrys/app/tui/screens/main/session_title.py +239 -0
  261. chrys/app/tui/screens/main/settings_coordinator.py +365 -0
  262. chrys/app/tui/screens/main/settings_persistence.py +184 -0
  263. chrys/app/tui/screens/main/shell_mode.py +112 -0
  264. chrys/app/tui/screens/main/state.py +289 -0
  265. chrys/app/tui/screens/main/submit_state.py +11 -0
  266. chrys/app/tui/screens/main/subscriptions.py +177 -0
  267. chrys/app/tui/screens/main/suggestions.py +982 -0
  268. chrys/app/tui/screens/main/tool_action_bridge.py +75 -0
  269. chrys/app/tui/screens/main/view_adapter.py +1567 -0
  270. chrys/app/tui/screens/main/workflow_browser.py +747 -0
  271. chrys/app/tui/screens/main/workflow_content.py +248 -0
  272. chrys/app/tui/screens/main/workflow_controller.py +240 -0
  273. chrys/app/tui/screens/main/workflow_feedback.py +137 -0
  274. chrys/app/tui/screens/main/workflow_flow.py +49 -0
  275. chrys/app/tui/screens/main/workflow_run_control.py +456 -0
  276. chrys/app/tui/screens/main/workflow_session_view.py +316 -0
  277. chrys/app/tui/screens/main/workspace_actions.py +272 -0
  278. chrys/app/tui/screens/main/workspace_branch.py +194 -0
  279. chrys/app/tui/screens/menus/__init__.py +8 -0
  280. chrys/app/tui/screens/menus/languages.py +114 -0
  281. chrys/app/tui/screens/models/__init__.py +7 -0
  282. chrys/app/tui/screens/models/picker.py +147 -0
  283. chrys/app/tui/screens/models/screen.py +2043 -0
  284. chrys/app/tui/screens/models/screen.tcss +255 -0
  285. chrys/app/tui/screens/sessions/__init__.py +8 -0
  286. chrys/app/tui/screens/sessions/presenter.py +586 -0
  287. chrys/app/tui/screens/sessions/screen.py +779 -0
  288. chrys/app/tui/screens/sessions/screen.tcss +127 -0
  289. chrys/app/tui/screens/settings/__init__.py +29 -0
  290. chrys/app/tui/screens/settings/danger.py +26 -0
  291. chrys/app/tui/screens/settings/dialog.py +281 -0
  292. chrys/app/tui/screens/settings/layout.py +519 -0
  293. chrys/app/tui/screens/settings/migrate_dialog.py +253 -0
  294. chrys/app/tui/screens/settings/panes/__init__.py +3 -0
  295. chrys/app/tui/screens/settings/panes/notifications.py +248 -0
  296. chrys/app/tui/screens/settings/panes/sessions.py +148 -0
  297. chrys/app/tui/screens/settings/ports.py +55 -0
  298. chrys/app/tui/screens/settings/provenance.py +102 -0
  299. chrys/app/tui/screens/settings/rows.py +546 -0
  300. chrys/app/tui/screens/settings/settings.tcss +406 -0
  301. chrys/app/tui/screens/themes/__init__.py +8 -0
  302. chrys/app/tui/screens/themes/dialogs.py +330 -0
  303. chrys/app/tui/screens/themes/editor.py +632 -0
  304. chrys/app/tui/screens/themes/editor.tcss +268 -0
  305. chrys/app/tui/screens/themes/messages.py +95 -0
  306. chrys/app/tui/screens/themes/palette.py +694 -0
  307. chrys/app/tui/screens/themes/panel.py +113 -0
  308. chrys/app/tui/screens/themes/picker.py +203 -0
  309. chrys/app/tui/screens/themes/save.py +191 -0
  310. chrys/app/tui/support/__init__.py +3 -0
  311. chrys/app/tui/support/file_manager.py +64 -0
  312. chrys/app/tui/support/gc_freeze.py +1114 -0
  313. chrys/app/tui/support/path_shortcuts.py +50 -0
  314. chrys/app/tui/support/prompt_history.py +298 -0
  315. chrys/app/tui/support/workspace_mru.py +476 -0
  316. chrys/app/tui/terminal/__init__.py +6 -0
  317. chrys/app/tui/terminal/_pty_backend.py +114 -0
  318. chrys/app/tui/terminal/emulator/__init__.py +24 -0
  319. chrys/app/tui/terminal/emulator/buffer.py +456 -0
  320. chrys/app/tui/terminal/emulator/charsets.py +113 -0
  321. chrys/app/tui/terminal/emulator/core.py +963 -0
  322. chrys/app/tui/terminal/emulator/input.py +342 -0
  323. chrys/app/tui/terminal/emulator/parser.py +227 -0
  324. chrys/app/tui/terminal/emulator/pen.py +158 -0
  325. chrys/app/tui/terminal/launcher.py +455 -0
  326. chrys/app/tui/terminal/leaked_reports.py +44 -0
  327. chrys/app/tui/terminal/panel.py +323 -0
  328. chrys/app/tui/terminal/pty_process.py +405 -0
  329. chrys/app/tui/terminal/rendering.py +151 -0
  330. chrys/app/tui/terminal/shell.py +273 -0
  331. chrys/app/tui/terminal/shell_integration.py +199 -0
  332. chrys/app/tui/terminal/title.py +224 -0
  333. chrys/app/tui/terminal/widget.py +654 -0
  334. chrys/app/tui/theme.py +422 -0
  335. chrys/app/tui/theme_loader.py +201 -0
  336. chrys/app/tui/theme_stylesheet.py +49 -0
  337. chrys/app/tui/themes/__init__.py +3 -0
  338. chrys/app/tui/themes/document.py +120 -0
  339. chrys/app/tui/themes/preview.py +170 -0
  340. chrys/app/tui/themes/store.py +176 -0
  341. chrys/app/tui/toasts.py +69 -0
  342. chrys/app/tui/util/__init__.py +3 -0
  343. chrys/app/tui/util/context_pressure.py +146 -0
  344. chrys/app/tui/util/debug_log.py +292 -0
  345. chrys/app/tui/util/diff_entries.py +64 -0
  346. chrys/app/tui/util/formatting.py +53 -0
  347. chrys/app/tui/util/git_branch.py +326 -0
  348. chrys/app/tui/util/invocation_progress.py +57 -0
  349. chrys/app/tui/util/logo.py +32 -0
  350. chrys/app/tui/util/message_gate.py +35 -0
  351. chrys/app/tui/util/mutation_sources.py +14 -0
  352. chrys/app/tui/util/picker_text.py +27 -0
  353. chrys/app/tui/util/removal.py +47 -0
  354. chrys/app/tui/util/rich_style.py +36 -0
  355. chrys/app/tui/util/source_text.py +12 -0
  356. chrys/app/tui/util/static_update.py +88 -0
  357. chrys/app/tui/util/todo_format.py +51 -0
  358. chrys/app/tui/util/visibility.py +214 -0
  359. chrys/app/tui/widgets/__init__.py +60 -0
  360. chrys/app/tui/widgets/ask_user_controls.py +652 -0
  361. chrys/app/tui/widgets/ask_user_markdown.py +17 -0
  362. chrys/app/tui/widgets/ask_user_prompt.py +606 -0
  363. chrys/app/tui/widgets/buttons.py +52 -0
  364. chrys/app/tui/widgets/chat/__init__.py +3 -0
  365. chrys/app/tui/widgets/chat/agent_transcript_surface.py +818 -0
  366. chrys/app/tui/widgets/chat/chrome.py +296 -0
  367. chrys/app/tui/widgets/chat/compaction_card.py +353 -0
  368. chrys/app/tui/widgets/chat/context_fold.py +77 -0
  369. chrys/app/tui/widgets/chat/file_snapshot.py +91 -0
  370. chrys/app/tui/widgets/chat/image_preview.py +214 -0
  371. chrys/app/tui/widgets/chat/live_renderer.py +383 -0
  372. chrys/app/tui/widgets/chat/messages.py +1039 -0
  373. chrys/app/tui/widgets/chat/panel.py +1769 -0
  374. chrys/app/tui/widgets/chat/ports.py +245 -0
  375. chrys/app/tui/widgets/chat/renderers/__init__.py +7 -0
  376. chrys/app/tui/widgets/chat/renderers/ask_user.py +747 -0
  377. chrys/app/tui/widgets/chat/renderers/execute.py +431 -0
  378. chrys/app/tui/widgets/chat/renderers/file_edit.py +925 -0
  379. chrys/app/tui/widgets/chat/renderers/hosted_code.py +83 -0
  380. chrys/app/tui/widgets/chat/renderers/hosted_generic.py +330 -0
  381. chrys/app/tui/widgets/chat/renderers/hosted_image.py +107 -0
  382. chrys/app/tui/widgets/chat/renderers/hosted_mcp.py +43 -0
  383. chrys/app/tui/widgets/chat/renderers/hosted_search.py +167 -0
  384. chrys/app/tui/widgets/chat/renderers/hosted_shell.py +132 -0
  385. chrys/app/tui/widgets/chat/renderers/read_file.py +399 -0
  386. chrys/app/tui/widgets/chat/renderers/search.py +348 -0
  387. chrys/app/tui/widgets/chat/renderers/skill.py +564 -0
  388. chrys/app/tui/widgets/chat/renderers/sleep.py +287 -0
  389. chrys/app/tui/widgets/chat/renderers/sub_agent.py +1385 -0
  390. chrys/app/tui/widgets/chat/renderers/todo.py +114 -0
  391. chrys/app/tui/widgets/chat/renderers/web.py +69 -0
  392. chrys/app/tui/widgets/chat/replay.py +1605 -0
  393. chrys/app/tui/widgets/chat/replay_mount.py +322 -0
  394. chrys/app/tui/widgets/chat/scroll_controller.py +579 -0
  395. chrys/app/tui/widgets/chat/selection_controller.py +435 -0
  396. chrys/app/tui/widgets/chat/session_json.py +508 -0
  397. chrys/app/tui/widgets/chat/toc_model.py +156 -0
  398. chrys/app/tui/widgets/chat/tool_call.py +2478 -0
  399. chrys/app/tui/widgets/chat/tool_registry.py +753 -0
  400. chrys/app/tui/widgets/chat/tool_renderers.py +247 -0
  401. chrys/app/tui/widgets/chat/tool_view_builders.py +260 -0
  402. chrys/app/tui/widgets/chat/transcript_reader.py +57 -0
  403. chrys/app/tui/widgets/checkbox.py +24 -0
  404. chrys/app/tui/widgets/chrome/__init__.py +3 -0
  405. chrys/app/tui/widgets/chrome/app_header.py +283 -0
  406. chrys/app/tui/widgets/chrome/commands.py +95 -0
  407. chrys/app/tui/widgets/chrome/file_index.py +68 -0
  408. chrys/app/tui/widgets/chrome/file_scanner.py +670 -0
  409. chrys/app/tui/widgets/chrome/footer.py +284 -0
  410. chrys/app/tui/widgets/chrome/image_paste.py +351 -0
  411. chrys/app/tui/widgets/chrome/input_bar.py +1299 -0
  412. chrys/app/tui/widgets/chrome/status_bar.py +911 -0
  413. chrys/app/tui/widgets/chrome/suggestion_list.py +652 -0
  414. chrys/app/tui/widgets/click_affordance.py +24 -0
  415. chrys/app/tui/widgets/color_picker/__init__.py +254 -0
  416. chrys/app/tui/widgets/color_picker/controls.py +171 -0
  417. chrys/app/tui/widgets/color_picker/model.py +89 -0
  418. chrys/app/tui/widgets/dialog_buttons.py +58 -0
  419. chrys/app/tui/widgets/dialog_scroll.py +24 -0
  420. chrys/app/tui/widgets/diff_view/__init__.py +20 -0
  421. chrys/app/tui/widgets/diff_view/cells.py +59 -0
  422. chrys/app/tui/widgets/diff_view/code.py +280 -0
  423. chrys/app/tui/widgets/diff_view/compute.py +286 -0
  424. chrys/app/tui/widgets/diff_view/gutter.py +161 -0
  425. chrys/app/tui/widgets/diff_view/inline.py +77 -0
  426. chrys/app/tui/widgets/diff_view/palette.py +87 -0
  427. chrys/app/tui/widgets/diff_view/protocols.py +24 -0
  428. chrys/app/tui/widgets/diff_view/rows.py +138 -0
  429. chrys/app/tui/widgets/diff_view/unified.py +267 -0
  430. chrys/app/tui/widgets/diff_view/widget.py +209 -0
  431. chrys/app/tui/widgets/editor/__init__.py +79 -0
  432. chrys/app/tui/widgets/editor/coordinates.py +30 -0
  433. chrys/app/tui/widgets/editor/highlighter.py +139 -0
  434. chrys/app/tui/widgets/editor/keymaps.py +357 -0
  435. chrys/app/tui/widgets/editor/types.py +216 -0
  436. chrys/app/tui/widgets/editor/vim.py +1195 -0
  437. chrys/app/tui/widgets/editor/widget.py +401 -0
  438. chrys/app/tui/widgets/file_preview.py +58 -0
  439. chrys/app/tui/widgets/hatch.py +138 -0
  440. chrys/app/tui/widgets/input.py +66 -0
  441. chrys/app/tui/widgets/loading.py +125 -0
  442. chrys/app/tui/widgets/markdown/__init__.py +25 -0
  443. chrys/app/tui/widgets/markdown/_utils.py +21 -0
  444. chrys/app/tui/widgets/markdown/anchors.py +71 -0
  445. chrys/app/tui/widgets/markdown/blocks.py +115 -0
  446. chrys/app/tui/widgets/markdown/copyable.py +163 -0
  447. chrys/app/tui/widgets/markdown/diagram/__init__.py +35 -0
  448. chrys/app/tui/widgets/markdown/diagram/canvas.py +409 -0
  449. chrys/app/tui/widgets/markdown/diagram/charts.py +52 -0
  450. chrys/app/tui/widgets/markdown/diagram/diagnostics.py +101 -0
  451. chrys/app/tui/widgets/markdown/diagram/geometry.py +46 -0
  452. chrys/app/tui/widgets/markdown/diagram/layout.py +494 -0
  453. chrys/app/tui/widgets/markdown/diagram/messages.py +18 -0
  454. chrys/app/tui/widgets/markdown/diagram/model.py +275 -0
  455. chrys/app/tui/widgets/markdown/diagram/parser.py +173 -0
  456. chrys/app/tui/widgets/markdown/diagram/parsers/__init__.py +3 -0
  457. chrys/app/tui/widgets/markdown/diagram/parsers/charts.py +349 -0
  458. chrys/app/tui/widgets/markdown/diagram/parsers/common.py +403 -0
  459. chrys/app/tui/widgets/markdown/diagram/parsers/graphs.py +1072 -0
  460. chrys/app/tui/widgets/markdown/diagram/parsers/planning.py +317 -0
  461. chrys/app/tui/widgets/markdown/diagram/parsers/schedule.py +298 -0
  462. chrys/app/tui/widgets/markdown/diagram/parsers/schemas.py +241 -0
  463. chrys/app/tui/widgets/markdown/diagram/parsers/structure.py +221 -0
  464. chrys/app/tui/widgets/markdown/diagram/presentation.py +32 -0
  465. chrys/app/tui/widgets/markdown/diagram/renderers/__init__.py +3 -0
  466. chrys/app/tui/widgets/markdown/diagram/renderers/charts.py +275 -0
  467. chrys/app/tui/widgets/markdown/diagram/renderers/common.py +73 -0
  468. chrys/app/tui/widgets/markdown/diagram/renderers/planning.py +157 -0
  469. chrys/app/tui/widgets/markdown/diagram/renderers/schedule.py +202 -0
  470. chrys/app/tui/widgets/markdown/diagram/renderers/structure.py +77 -0
  471. chrys/app/tui/widgets/markdown/diagram/renderers/xy.py +385 -0
  472. chrys/app/tui/widgets/markdown/diagram/router.py +651 -0
  473. chrys/app/tui/widgets/markdown/diagram/specs/__init__.py +3 -0
  474. chrys/app/tui/widgets/markdown/diagram/specs/charts.py +94 -0
  475. chrys/app/tui/widgets/markdown/diagram/specs/planning.py +68 -0
  476. chrys/app/tui/widgets/markdown/diagram/specs/schedule.py +65 -0
  477. chrys/app/tui/widgets/markdown/diagram/specs/structure.py +23 -0
  478. chrys/app/tui/widgets/markdown/diagram/viewer.py +92 -0
  479. chrys/app/tui/widgets/markdown/links.py +47 -0
  480. chrys/app/tui/widgets/markdown/math/__init__.py +36 -0
  481. chrys/app/tui/widgets/markdown/math/layout.py +739 -0
  482. chrys/app/tui/widgets/markdown/math/markdown.py +291 -0
  483. chrys/app/tui/widgets/markdown/math/parser.py +325 -0
  484. chrys/app/tui/widgets/markdown/math/symbols.py +325 -0
  485. chrys/app/tui/widgets/markdown/navigator.py +80 -0
  486. chrys/app/tui/widgets/markdown/parser.py +1057 -0
  487. chrys/app/tui/widgets/markdown/stream.py +73 -0
  488. chrys/app/tui/widgets/markdown/toc.py +98 -0
  489. chrys/app/tui/widgets/markdown/viewer.py +146 -0
  490. chrys/app/tui/widgets/markdown/widget.py +2046 -0
  491. chrys/app/tui/widgets/marquee.py +101 -0
  492. chrys/app/tui/widgets/option_menu.py +82 -0
  493. chrys/app/tui/widgets/page_navigator.py +118 -0
  494. chrys/app/tui/widgets/select.py +196 -0
  495. chrys/app/tui/widgets/selection.py +59 -0
  496. chrys/app/tui/widgets/sidebar/__init__.py +3 -0
  497. chrys/app/tui/widgets/sidebar/buddy.py +367 -0
  498. chrys/app/tui/widgets/sidebar/context.py +482 -0
  499. chrys/app/tui/widgets/sidebar/debug.py +195 -0
  500. chrys/app/tui/widgets/sidebar/empty_state.py +11 -0
  501. chrys/app/tui/widgets/sidebar/panel.py +198 -0
  502. chrys/app/tui/widgets/sidebar/tasks.py +198 -0
  503. chrys/app/tui/widgets/sidebar/toc.py +166 -0
  504. chrys/app/tui/widgets/sidebar/toc_types.py +30 -0
  505. chrys/app/tui/widgets/syntax_theme.py +85 -0
  506. chrys/app/tui/widgets/text_area.py +258 -0
  507. chrys/app/tui/widgets/trajectory/__init__.py +8 -0
  508. chrys/app/tui/widgets/trajectory/chartkit.py +264 -0
  509. chrys/app/tui/widgets/trajectory/insights.py +1266 -0
  510. chrys/app/tui/widgets/trajectory/overview.py +1101 -0
  511. chrys/app/tui/widgets/trajectory/panel.py +983 -0
  512. chrys/app/tui/widgets/trajectory/presentation.py +311 -0
  513. chrys/app/tui/widgets/trajectory/session_info.py +124 -0
  514. chrys/app/tui/widgets/trajectory/text_view.py +124 -0
  515. chrys/app/tui/widgets/trajectory/timeline.py +380 -0
  516. chrys/app/tui/widgets/welcome.py +126 -0
  517. chrys/app/tui/widgets/workflow/__init__.py +5 -0
  518. chrys/app/tui/widgets/workflow/edges.py +89 -0
  519. chrys/app/tui/widgets/workflow/graph.py +869 -0
  520. chrys/app/tui/widgets/workflow/info.py +310 -0
  521. chrys/app/tui/widgets/workflow/node_view.py +27 -0
  522. chrys/app/tui/widgets/workflow/output.py +225 -0
  523. chrys/app/tui/widgets/workflow/panel.py +658 -0
  524. chrys/app/tui/widgets/workflow/projector.py +324 -0
  525. chrys/app/tui/widgets/workflow/records.py +69 -0
  526. chrys/app/tui/widgets/workflow/scrollbar.py +82 -0
  527. chrys/app/tui/widgets/workflow/selection.py +151 -0
  528. chrys/app/tui/widgets/workflow/source.py +65 -0
  529. chrys/app/tui/widgets/workflow/text.py +257 -0
  530. chrys/app/tui/widgets/workflow/values.py +317 -0
  531. chrys/foundation/__init__.py +0 -0
  532. chrys/foundation/branding.py +15 -0
  533. chrys/foundation/config/__init__.py +7 -0
  534. chrys/foundation/config/coercion.py +374 -0
  535. chrys/foundation/config/context.py +34 -0
  536. chrys/foundation/config/env_file.py +141 -0
  537. chrys/foundation/config/env_layers.py +370 -0
  538. chrys/foundation/config/migrations.py +521 -0
  539. chrys/foundation/config/notification_events.py +22 -0
  540. chrys/foundation/config/process_settings.py +332 -0
  541. chrys/foundation/config/runtime_pointer.py +133 -0
  542. chrys/foundation/config/settings.py +1952 -0
  543. chrys/foundation/config/settings_store.py +996 -0
  544. chrys/foundation/config/spec.py +396 -0
  545. chrys/foundation/config/user_settings.py +140 -0
  546. chrys/foundation/config/warnings.py +262 -0
  547. chrys/foundation/config/web_values.py +135 -0
  548. chrys/foundation/config/yaml_store.py +487 -0
  549. chrys/foundation/errors/__init__.py +68 -0
  550. chrys/foundation/errors/_legacy.py +117 -0
  551. chrys/foundation/errors/_text.py +13 -0
  552. chrys/foundation/errors/_walk.py +85 -0
  553. chrys/foundation/errors/classify.py +278 -0
  554. chrys/foundation/errors/display.py +274 -0
  555. chrys/foundation/errors/formatting.py +283 -0
  556. chrys/foundation/errors/kinds.py +67 -0
  557. chrys/foundation/errors/network.py +497 -0
  558. chrys/foundation/errors/provider.py +445 -0
  559. chrys/foundation/errors/route.py +85 -0
  560. chrys/foundation/events/__init__.py +8 -0
  561. chrys/foundation/events/bus.py +143 -0
  562. chrys/foundation/events/types.py +1629 -0
  563. chrys/foundation/events/workflow.py +38 -0
  564. chrys/foundation/hosted_tools.py +142 -0
  565. chrys/foundation/i18n/__init__.py +32 -0
  566. chrys/foundation/i18n/_catalogs/zh-Hans/LC_MESSAGES/chrys.mo +0 -0
  567. chrys/foundation/i18n/catalogs.py +42 -0
  568. chrys/foundation/i18n/formatting.py +202 -0
  569. chrys/foundation/i18n/locale.py +92 -0
  570. chrys/foundation/i18n/localizer.py +187 -0
  571. chrys/foundation/i18n/messages.py +268 -0
  572. chrys/foundation/io/__init__.py +3 -0
  573. chrys/foundation/io/result_content.py +237 -0
  574. chrys/foundation/models/__init__.py +3 -0
  575. chrys/foundation/models/approval_reuse.py +23 -0
  576. chrys/foundation/models/ask_user.py +468 -0
  577. chrys/foundation/models/execution.py +18 -0
  578. chrys/foundation/models/history_markers.py +115 -0
  579. chrys/foundation/models/invocations.py +63 -0
  580. chrys/foundation/models/mutation_scope.py +28 -0
  581. chrys/foundation/models/session_env.py +87 -0
  582. chrys/foundation/models/session_surface.py +29 -0
  583. chrys/foundation/models/todos.py +74 -0
  584. chrys/foundation/models/turns.py +125 -0
  585. chrys/foundation/models/workflow_session.py +89 -0
  586. chrys/foundation/models/workspace.py +59 -0
  587. chrys/foundation/net/__init__.py +3 -0
  588. chrys/foundation/net/address_class.py +57 -0
  589. chrys/foundation/net/route_probe.py +94 -0
  590. chrys/foundation/net/url.py +107 -0
  591. chrys/foundation/observability/__init__.py +3 -0
  592. chrys/foundation/observability/exporters.py +174 -0
  593. chrys/foundation/observability/gate.py +31 -0
  594. chrys/foundation/observability/setup.py +497 -0
  595. chrys/foundation/observability/sink.py +228 -0
  596. chrys/foundation/patches/__init__.py +19 -0
  597. chrys/foundation/patches/mdurl_cache.py +59 -0
  598. chrys/foundation/patches/patcher.py +287 -0
  599. chrys/foundation/patches/staged_members.py +205 -0
  600. chrys/foundation/patches/textual_block_border.py +105 -0
  601. chrys/foundation/patches/textual_button_ansi.py +65 -0
  602. chrys/foundation/patches/textual_button_ansi_old.txt +68 -0
  603. chrys/foundation/patches/textual_callback_cache.py +248 -0
  604. chrys/foundation/patches/textual_callback_dispatch.py +109 -0
  605. chrys/foundation/patches/textual_compositor_cjk.py +566 -0
  606. chrys/foundation/patches/textual_dispatch_cache.py +150 -0
  607. chrys/foundation/patches/textual_ime_cursor_anchor.py +92 -0
  608. chrys/foundation/patches/textual_kitty_keyboard.py +268 -0
  609. chrys/foundation/patches/textual_lru_acyclic.py +241 -0
  610. chrys/foundation/patches/textual_message_pump.py +136 -0
  611. chrys/foundation/patches/textual_node_diet.py +875 -0
  612. chrys/foundation/patches/textual_one_shot_timer.py +48 -0
  613. chrys/foundation/patches/textual_option_list.py +90 -0
  614. chrys/foundation/patches/textual_precompose.py +89 -0
  615. chrys/foundation/patches/textual_pruned_tabs.py +69 -0
  616. chrys/foundation/patches/textual_reflow_reuse.py +1753 -0
  617. chrys/foundation/patches/textual_removed_node_caches.py +86 -0
  618. chrys/foundation/patches/textual_removed_screen_callbacks.py +55 -0
  619. chrys/foundation/patches/textual_selection_extract.py +48 -0
  620. chrys/foundation/patches/textual_strip_cycles.py +119 -0
  621. chrys/foundation/patches/textual_tab_selection.py +1611 -0
  622. chrys/foundation/patches/textual_timer_skip.py +70 -0
  623. chrys/foundation/patches/textual_utf8_decoder.py +106 -0
  624. chrys/foundation/patches/textual_win_sleep.py +167 -0
  625. chrys/foundation/patches/watchdog_fsevents.py +70 -0
  626. chrys/foundation/patches/watchdog_windows.py +52 -0
  627. chrys/foundation/platform/__init__.py +556 -0
  628. chrys/foundation/platform/c_api.py +32 -0
  629. chrys/foundation/platform/child_reap.py +107 -0
  630. chrys/foundation/platform/command_line.py +95 -0
  631. chrys/foundation/platform/files.py +1470 -0
  632. chrys/foundation/platform/output_capture.py +113 -0
  633. chrys/foundation/platform/paths.py +193 -0
  634. chrys/foundation/platform/process.py +1468 -0
  635. chrys/foundation/platform/pty_output.py +19 -0
  636. chrys/foundation/platform/runtime_paths.py +281 -0
  637. chrys/foundation/platform/win_console.py +129 -0
  638. chrys/foundation/reasoning_origin.py +67 -0
  639. chrys/foundation/recovery.py +16 -0
  640. chrys/foundation/retry.py +278 -0
  641. chrys/foundation/text/__init__.py +3 -0
  642. chrys/foundation/text/encoding.py +603 -0
  643. chrys/foundation/text/images.py +304 -0
  644. chrys/foundation/text/lines.py +24 -0
  645. chrys/foundation/text/mentions.py +90 -0
  646. chrys/foundation/text/model_json.py +25 -0
  647. chrys/foundation/text/reading_order.py +20 -0
  648. chrys/foundation/text/tokenizer.py +25 -0
  649. chrys/foundation/text/tool_output.py +287 -0
  650. chrys/foundation/text/yaml_io.py +62 -0
  651. chrys/foundation/tool_call_context.py +202 -0
  652. chrys/foundation/tool_execution_stamp.py +184 -0
  653. chrys/foundation/tool_invocation_order.py +48 -0
  654. chrys/foundation/tool_kinds.py +102 -0
  655. chrys/foundation/tool_result_metadata.py +287 -0
  656. chrys/foundation/trajectory/__init__.py +10 -0
  657. chrys/foundation/trajectory/context.py +481 -0
  658. chrys/foundation/trajectory/envelope.py +571 -0
  659. chrys/foundation/trajectory/event_types.py +294 -0
  660. chrys/foundation/trajectory/finalizers.py +46 -0
  661. chrys/foundation/trajectory/fingerprint.py +62 -0
  662. chrys/foundation/trajectory/ids.py +155 -0
  663. chrys/foundation/trajectory/keys.py +99 -0
  664. chrys/foundation/trajectory/lease.py +173 -0
  665. chrys/foundation/trajectory/metadata.py +72 -0
  666. chrys/foundation/trajectory/reader.py +271 -0
  667. chrys/foundation/trajectory/recovery.py +225 -0
  668. chrys/foundation/trajectory/revisions.py +152 -0
  669. chrys/foundation/trajectory/segments.py +225 -0
  670. chrys/foundation/trajectory/tools.py +117 -0
  671. chrys/foundation/trajectory/usage.py +151 -0
  672. chrys/foundation/trajectory/writer.py +972 -0
  673. chrys/foundation/trajectory_timing.py +97 -0
  674. chrys/foundation/util/__init__.py +3 -0
  675. chrys/foundation/util/async_tasks.py +29 -0
  676. chrys/foundation/util/chrys_headers.py +23 -0
  677. chrys/foundation/util/env_templates.py +104 -0
  678. chrys/foundation/util/filenames.py +96 -0
  679. chrys/foundation/util/header_charset.py +138 -0
  680. chrys/foundation/util/httpx_helpers.py +12 -0
  681. chrys/foundation/util/lock.py +236 -0
  682. chrys/foundation/util/once_close.py +46 -0
  683. chrys/foundation/util/session_ids.py +29 -0
  684. chrys/foundation/util/shell_tokens.py +88 -0
  685. chrys/foundation/util/sub_agent_context.py +38 -0
  686. chrys/foundation/util/time.py +35 -0
  687. chrys/foundation/util/unicode_scalars.py +36 -0
  688. chrys/foundation/vendor/__init__.py +43 -0
  689. chrys/foundation/vendor/ripgrep/rg-aarch64-apple-darwin +0 -0
  690. chrys/foundation/vendor/ripgrep/rg-aarch64-pc-windows-msvc.exe +0 -0
  691. chrys/foundation/vendor/ripgrep/rg-aarch64-unknown-linux-gnu +0 -0
  692. chrys/foundation/vendor/ripgrep/rg-x86_64-apple-darwin +0 -0
  693. chrys/foundation/vendor/ripgrep/rg-x86_64-pc-windows-msvc.exe +0 -0
  694. chrys/foundation/vendor/ripgrep/rg-x86_64-unknown-linux-musl +0 -0
  695. chrys/kernel/__init__.py +256 -0
  696. chrys/kernel/_content.py +1866 -0
  697. chrys/kernel/_loop_recorder.py +631 -0
  698. chrys/kernel/_null_overlay.py +1026 -0
  699. chrys/kernel/_result_ceiling.py +216 -0
  700. chrys/kernel/_serialization.py +431 -0
  701. chrys/kernel/_tool_arg_errors.py +1629 -0
  702. chrys/kernel/_tool_execution.py +1172 -0
  703. chrys/kernel/_tool_expansion.py +26 -0
  704. chrys/kernel/_types.py +2598 -0
  705. chrys/kernel/agent.py +994 -0
  706. chrys/kernel/client.py +1084 -0
  707. chrys/kernel/compaction.py +1315 -0
  708. chrys/kernel/exceptions.py +211 -0
  709. chrys/kernel/exchanges.py +683 -0
  710. chrys/kernel/identity.py +95 -0
  711. chrys/kernel/images.py +36 -0
  712. chrys/kernel/instrumentation.py +1618 -0
  713. chrys/kernel/loop.py +2308 -0
  714. chrys/kernel/middleware.py +616 -0
  715. chrys/kernel/sessions.py +604 -0
  716. chrys/kernel/tools.py +1061 -0
  717. chrys/kernel/types.py +126 -0
  718. chrys/orchestration/__init__.py +3 -0
  719. chrys/orchestration/engine/__init__.py +3 -0
  720. chrys/orchestration/engine/assembly.py +236 -0
  721. chrys/orchestration/engine/build/__init__.py +3 -0
  722. chrys/orchestration/engine/build/builder.py +1061 -0
  723. chrys/orchestration/engine/build/construction.py +408 -0
  724. chrys/orchestration/engine/build/loaded.py +139 -0
  725. chrys/orchestration/engine/engine.py +789 -0
  726. chrys/orchestration/engine/execution.py +771 -0
  727. chrys/orchestration/engine/loader.py +865 -0
  728. chrys/orchestration/engine/rollback.py +918 -0
  729. chrys/orchestration/engine/run/__init__.py +3 -0
  730. chrys/orchestration/engine/run/active_injection.py +419 -0
  731. chrys/orchestration/engine/run/attachments.py +519 -0
  732. chrys/orchestration/engine/run/bindings.py +1095 -0
  733. chrys/orchestration/engine/run/coordinator.py +1062 -0
  734. chrys/orchestration/engine/run/finalizer.py +417 -0
  735. chrys/orchestration/engine/run/input_refs.py +60 -0
  736. chrys/orchestration/engine/run/prompt_content.py +457 -0
  737. chrys/orchestration/engine/run/resume.py +299 -0
  738. chrys/orchestration/engine/run/retry.py +948 -0
  739. chrys/orchestration/engine/run/runner.py +625 -0
  740. chrys/orchestration/engine/run/runtime_skills.py +146 -0
  741. chrys/orchestration/engine/run/sub_agent_coordination.py +126 -0
  742. chrys/orchestration/engine/run/turn_hooks.py +258 -0
  743. chrys/orchestration/engine/run/turn_state.py +149 -0
  744. chrys/orchestration/engine/run/working_dir.py +50 -0
  745. chrys/orchestration/engine/session_lifecycle.py +2013 -0
  746. chrys/orchestration/engine/state/__init__.py +3 -0
  747. chrys/orchestration/engine/state/active_session.py +183 -0
  748. chrys/orchestration/engine/state/controls.py +639 -0
  749. chrys/orchestration/engine/state/current_agent.py +26 -0
  750. chrys/orchestration/engine/state/lifecycle_permits.py +395 -0
  751. chrys/orchestration/engine/state/machine.py +193 -0
  752. chrys/orchestration/engine/state/session_writer.py +434 -0
  753. chrys/orchestration/engine/trajectory.py +714 -0
  754. chrys/orchestration/engine/usage.py +118 -0
  755. chrys/orchestration/invoker/__init__.py +3 -0
  756. chrys/orchestration/invoker/acp.py +727 -0
  757. chrys/orchestration/invoker/acp_protocol.py +1115 -0
  758. chrys/orchestration/invoker/acp_spec.py +79 -0
  759. chrys/orchestration/invoker/attempts.py +994 -0
  760. chrys/orchestration/invoker/child_compaction.py +131 -0
  761. chrys/orchestration/invoker/child_history.py +99 -0
  762. chrys/orchestration/invoker/contracts.py +253 -0
  763. chrys/orchestration/invoker/evidence.py +94 -0
  764. chrys/orchestration/invoker/kernel.py +343 -0
  765. chrys/orchestration/invoker/origin.py +79 -0
  766. chrys/orchestration/invoker/resources.py +343 -0
  767. chrys/orchestration/invoker/runtime.py +299 -0
  768. chrys/orchestration/invoker/usage.py +80 -0
  769. chrys/orchestration/session_hooks.py +117 -0
  770. chrys/orchestration/session_host.py +1023 -0
  771. chrys/orchestration/session_resources.py +95 -0
  772. chrys/orchestration/session_usage.py +219 -0
  773. chrys/orchestration/startup.py +255 -0
  774. chrys/orchestration/sub_agents/__init__.py +3 -0
  775. chrys/orchestration/sub_agents/acp_policy.py +269 -0
  776. chrys/orchestration/sub_agents/kernel_policy.py +848 -0
  777. chrys/orchestration/sub_agents/registration.py +44 -0
  778. chrys/orchestration/sub_agents/shell.py +337 -0
  779. chrys/orchestration/sub_agents/tools.py +2228 -0
  780. chrys/orchestration/workflows/__init__.py +3 -0
  781. chrys/orchestration/workflows/agent_archive.py +156 -0
  782. chrys/orchestration/workflows/agent_node.py +894 -0
  783. chrys/orchestration/workflows/agent_node_build.py +687 -0
  784. chrys/orchestration/workflows/catalog.py +332 -0
  785. chrys/orchestration/workflows/coordinator.py +771 -0
  786. chrys/orchestration/workflows/hooks.py +176 -0
  787. chrys/orchestration/workflows/preview.py +322 -0
  788. chrys/orchestration/workflows/rollback.py +151 -0
  789. chrys/orchestration/workflows/runner.py +986 -0
  790. chrys/orchestration/workflows/session.py +390 -0
  791. chrys/orchestration/workflows/settings.py +97 -0
  792. chrys/orchestration/workflows/validation.py +674 -0
  793. chrys/orchestration/workflows/worker_client.py +1002 -0
  794. chrys/service/__init__.py +3 -0
  795. chrys/service/acp_client/__init__.py +65 -0
  796. chrys/service/acp_client/_transport.py +922 -0
  797. chrys/service/acp_client/client.py +1311 -0
  798. chrys/service/acp_client/errors.py +224 -0
  799. chrys/service/acp_client/protocol.py +220 -0
  800. chrys/service/acp_client/spawn.py +239 -0
  801. chrys/service/acp_client/spec.py +100 -0
  802. chrys/service/agent_middleware/__init__.py +60 -0
  803. chrys/service/agent_middleware/_metadata_keys.py +52 -0
  804. chrys/service/agent_middleware/control/__init__.py +3 -0
  805. chrys/service/agent_middleware/control/approval.py +769 -0
  806. chrys/service/agent_middleware/control/approval_hooks.py +62 -0
  807. chrys/service/agent_middleware/control/ask_user.py +207 -0
  808. chrys/service/agent_middleware/control/interrupt.py +50 -0
  809. chrys/service/agent_middleware/control/sleep.py +118 -0
  810. chrys/service/agent_middleware/control/todo.py +117 -0
  811. chrys/service/agent_middleware/events/__init__.py +3 -0
  812. chrys/service/agent_middleware/events/hook_dispatch.py +250 -0
  813. chrys/service/agent_middleware/events/hosted_tools.py +1762 -0
  814. chrys/service/agent_middleware/events/intermediate_text.py +128 -0
  815. chrys/service/agent_middleware/events/rejection_metadata.py +50 -0
  816. chrys/service/agent_middleware/events/result_persistence.py +98 -0
  817. chrys/service/agent_middleware/events/sub_agent_events.py +951 -0
  818. chrys/service/agent_middleware/events/tool_error_text.py +22 -0
  819. chrys/service/agent_middleware/events/tool_events.py +779 -0
  820. chrys/service/agent_middleware/injection.py +510 -0
  821. chrys/service/agent_middleware/reminders/__init__.py +91 -0
  822. chrys/service/agent_middleware/reminders/archive_pointer.py +154 -0
  823. chrys/service/agent_middleware/reminders/base.py +25 -0
  824. chrys/service/agent_middleware/reminders/context_usage.py +74 -0
  825. chrys/service/agent_middleware/reminders/file_change.py +63 -0
  826. chrys/service/agent_middleware/reminders/mcp.py +39 -0
  827. chrys/service/agent_middleware/reminders/profile_switch.py +106 -0
  828. chrys/service/agent_middleware/reminders/runtime_env.py +190 -0
  829. chrys/service/agent_middleware/reminders/skills.py +44 -0
  830. chrys/service/agent_middleware/reminders/sub_agents.py +35 -0
  831. chrys/service/agent_middleware/reminders/todo.py +35 -0
  832. chrys/service/agent_middleware/reminders/turn_line.py +48 -0
  833. chrys/service/agent_middleware/response_validation.py +1380 -0
  834. chrys/service/agent_middleware/system_reminder.py +1107 -0
  835. chrys/service/agent_middleware/validators.py +396 -0
  836. chrys/service/analytics/__init__.py +124 -0
  837. chrys/service/analytics/_actions.py +896 -0
  838. chrys/service/analytics/_context_evidence.py +357 -0
  839. chrys/service/analytics/_critical_path.py +179 -0
  840. chrys/service/analytics/_facts.py +919 -0
  841. chrys/service/analytics/_insights.py +769 -0
  842. chrys/service/analytics/_metric_ops.py +83 -0
  843. chrys/service/analytics/_session_projection.py +460 -0
  844. chrys/service/analytics/_timeline.py +434 -0
  845. chrys/service/analytics/_turn_graph.py +1237 -0
  846. chrys/service/analytics/_turns.py +1377 -0
  847. chrys/service/analytics/_workflows.py +171 -0
  848. chrys/service/analytics/aggregation.py +1474 -0
  849. chrys/service/analytics/classification.py +128 -0
  850. chrys/service/analytics/export.py +803 -0
  851. chrys/service/analytics/findings.py +282 -0
  852. chrys/service/analytics/math.py +79 -0
  853. chrys/service/analytics/model.py +886 -0
  854. chrys/service/analytics/reader.py +321 -0
  855. chrys/service/approval/__init__.py +3 -0
  856. chrys/service/approval/arbitration.py +102 -0
  857. chrys/service/approval/command_identity.py +109 -0
  858. chrys/service/approval/correlation.py +57 -0
  859. chrys/service/approval/grant_store.py +108 -0
  860. chrys/service/approval/judge.py +589 -0
  861. chrys/service/approval/level.py +15 -0
  862. chrys/service/approval/policy.py +209 -0
  863. chrys/service/approval/reuse.py +223 -0
  864. chrys/service/approval/reuse_binding.py +133 -0
  865. chrys/service/approval/safety_classifier.py +536 -0
  866. chrys/service/approval/turn_context.py +49 -0
  867. chrys/service/context/__init__.py +3 -0
  868. chrys/service/context/compaction/__init__.py +38 -0
  869. chrys/service/context/compaction/breaker.py +156 -0
  870. chrys/service/context/compaction/budgets.py +93 -0
  871. chrys/service/context/compaction/calibration.py +77 -0
  872. chrys/service/context/compaction/compression.py +690 -0
  873. chrys/service/context/compaction/current_turn_drop.py +458 -0
  874. chrys/service/context/compaction/events.py +201 -0
  875. chrys/service/context/compaction/exclusions.py +261 -0
  876. chrys/service/context/compaction/groups.py +361 -0
  877. chrys/service/context/compaction/last_words.py +1996 -0
  878. chrys/service/context/compaction/last_words_state.py +752 -0
  879. chrys/service/context/compaction/scoped.py +472 -0
  880. chrys/service/context/compaction/spill.py +1947 -0
  881. chrys/service/context/compaction/strategy.py +1116 -0
  882. chrys/service/context/compaction/summaries.py +319 -0
  883. chrys/service/context/compaction/turns.py +375 -0
  884. chrys/service/context/manager.py +174 -0
  885. chrys/service/context/memory_loader.py +792 -0
  886. chrys/service/context/middleware/__init__.py +3 -0
  887. chrys/service/context/middleware/usage.py +332 -0
  888. chrys/service/context/providers/__init__.py +3 -0
  889. chrys/service/context/providers/context_management.py +432 -0
  890. chrys/service/context/providers/history.py +647 -0
  891. chrys/service/context/providers/memory.py +50 -0
  892. chrys/service/context/tool_content.py +22 -0
  893. chrys/service/hooks/__init__.py +37 -0
  894. chrys/service/hooks/detached_worker.py +118 -0
  895. chrys/service/hooks/docs/README.md +14 -0
  896. chrys/service/hooks/docs/authoring.md +684 -0
  897. chrys/service/hooks/docs/configuration.md +499 -0
  898. chrys/service/hooks/docs/design.md +359 -0
  899. chrys/service/hooks/docs/project-hooks.md +348 -0
  900. chrys/service/hooks/events.py +157 -0
  901. chrys/service/hooks/loader.py +665 -0
  902. chrys/service/hooks/manager.py +807 -0
  903. chrys/service/hooks/matcher.py +111 -0
  904. chrys/service/hooks/outbox.py +294 -0
  905. chrys/service/hooks/runner.py +572 -0
  906. chrys/service/hooks/schema.py +407 -0
  907. chrys/service/llm/__init__.py +7 -0
  908. chrys/service/llm/_structured_outputs.py +192 -0
  909. chrys/service/llm/anthropic_messages/__init__.py +9 -0
  910. chrys/service/llm/anthropic_messages/client.py +254 -0
  911. chrys/service/llm/anthropic_messages/decode.py +331 -0
  912. chrys/service/llm/anthropic_messages/history.py +279 -0
  913. chrys/service/llm/anthropic_messages/request.py +323 -0
  914. chrys/service/llm/anthropic_messages/server_tools.py +319 -0
  915. chrys/service/llm/anthropic_messages/stream.py +297 -0
  916. chrys/service/llm/anthropic_messages/thinking_binding.py +156 -0
  917. chrys/service/llm/chat_completions/__init__.py +9 -0
  918. chrys/service/llm/chat_completions/client.py +369 -0
  919. chrys/service/llm/chat_completions/decode.py +338 -0
  920. chrys/service/llm/chat_completions/history.py +657 -0
  921. chrys/service/llm/chat_completions/reasoning.py +244 -0
  922. chrys/service/llm/chat_completions/request.py +192 -0
  923. chrys/service/llm/chat_completions/stream.py +546 -0
  924. chrys/service/llm/chat_completions/validation.py +308 -0
  925. chrys/service/llm/clients.py +613 -0
  926. chrys/service/llm/images.py +65 -0
  927. chrys/service/llm/mock.py +413 -0
  928. chrys/service/llm/observer.py +446 -0
  929. chrys/service/llm/one_shot.py +106 -0
  930. chrys/service/llm/openai_exceptions.py +93 -0
  931. chrys/service/llm/openai_responses/__init__.py +10 -0
  932. chrys/service/llm/openai_responses/client.py +323 -0
  933. chrys/service/llm/openai_responses/decode.py +432 -0
  934. chrys/service/llm/openai_responses/history.py +519 -0
  935. chrys/service/llm/openai_responses/hosted.py +625 -0
  936. chrys/service/llm/openai_responses/replay.py +629 -0
  937. chrys/service/llm/openai_responses/request.py +342 -0
  938. chrys/service/llm/openai_responses/stream.py +847 -0
  939. chrys/service/llm/openai_timestamps.py +57 -0
  940. chrys/service/llm/providers.py +107 -0
  941. chrys/service/llm/proxy_route.py +54 -0
  942. chrys/service/llm/raw_http_log.py +309 -0
  943. chrys/service/llm/route_facts.py +63 -0
  944. chrys/service/llm/route_sessions.py +49 -0
  945. chrys/service/llm/sdk_anthropic.py +18 -0
  946. chrys/service/llm/sdk_headers.py +47 -0
  947. chrys/service/llm/sdk_openai.py +18 -0
  948. chrys/service/llm/sdk_retry.py +59 -0
  949. chrys/service/llm/wire_client.py +246 -0
  950. chrys/service/mcp/__init__.py +3 -0
  951. chrys/service/mcp/_connection.py +235 -0
  952. chrys/service/mcp/_http_transport.py +350 -0
  953. chrys/service/mcp/_progressive.py +459 -0
  954. chrys/service/mcp/_stdio_transport.py +614 -0
  955. chrys/service/mcp/_tool_mixins.py +96 -0
  956. chrys/service/mcp/adapter.py +1031 -0
  957. chrys/service/mcp/cache.py +476 -0
  958. chrys/service/mcp/content.py +32 -0
  959. chrys/service/mcp/errors.py +169 -0
  960. chrys/service/mcp/owned.py +1330 -0
  961. chrys/service/mcp/result_limits.py +168 -0
  962. chrys/service/mcp/thinking_warning.py +95 -0
  963. chrys/service/mcp/validation.py +74 -0
  964. chrys/service/mutations/__init__.py +84 -0
  965. chrys/service/mutations/coordination.py +894 -0
  966. chrys/service/mutations/detector.py +458 -0
  967. chrys/service/mutations/git_calibrator.py +397 -0
  968. chrys/service/mutations/git_state.py +647 -0
  969. chrys/service/mutations/pipeline.py +779 -0
  970. chrys/service/mutations/scanner.py +466 -0
  971. chrys/service/mutations/snapshot_files.py +233 -0
  972. chrys/service/mutations/store.py +625 -0
  973. chrys/service/mutations/tool_names.py +15 -0
  974. chrys/service/mutations/trace.py +246 -0
  975. chrys/service/mutations/tracker.py +1289 -0
  976. chrys/service/mutations/types.py +559 -0
  977. chrys/service/mutations/workspace_changes.py +1583 -0
  978. chrys/service/profiles/__init__.py +2 -0
  979. chrys/service/profiles/agents/__init__.py +3 -0
  980. chrys/service/profiles/agents/builtins/Code.yaml +199 -0
  981. chrys/service/profiles/agents/builtins/Explore.yaml +62 -0
  982. chrys/service/profiles/agents/builtins/General.yaml +114 -0
  983. chrys/service/profiles/agents/builtins/QA.yaml +128 -0
  984. chrys/service/profiles/agents/loader.py +808 -0
  985. chrys/service/profiles/agents/registry.py +727 -0
  986. chrys/service/profiles/agents/schema.py +371 -0
  987. chrys/service/profiles/agents/serializer.py +196 -0
  988. chrys/service/profiles/coercion.py +22 -0
  989. chrys/service/profiles/models/__init__.py +3 -0
  990. chrys/service/profiles/models/env_bridge.py +157 -0
  991. chrys/service/profiles/models/loader.py +282 -0
  992. chrys/service/profiles/models/options.py +438 -0
  993. chrys/service/profiles/models/registry.py +104 -0
  994. chrys/service/profiles/models/resolver.py +286 -0
  995. chrys/service/profiles/models/schema.py +91 -0
  996. chrys/service/profiles/models/serializer.py +76 -0
  997. chrys/service/session/__init__.py +3 -0
  998. chrys/service/session/checkpoint.py +156 -0
  999. chrys/service/session/history.py +1616 -0
  1000. chrys/service/session/message_metadata.py +151 -0
  1001. chrys/service/session/persistence.py +435 -0
  1002. chrys/service/session/runtime_metadata.py +210 -0
  1003. chrys/service/session/sub_agent_logs.py +1069 -0
  1004. chrys/service/session/sub_agent_transcript.py +654 -0
  1005. chrys/service/skills/__init__.py +3 -0
  1006. chrys/service/skills/adapter.py +408 -0
  1007. chrys/service/skills/constants.py +8 -0
  1008. chrys/service/skills/loader.py +575 -0
  1009. chrys/service/skills/model.py +130 -0
  1010. chrys/service/skills/provider.py +841 -0
  1011. chrys/service/skills/runner.py +390 -0
  1012. chrys/service/state/__init__.py +3 -0
  1013. chrys/service/state/_fork.py +710 -0
  1014. chrys/service/state/_session_files.py +175 -0
  1015. chrys/service/state/_session_meta.py +552 -0
  1016. chrys/service/state/locks.py +154 -0
  1017. chrys/service/state/serializers.py +156 -0
  1018. chrys/service/state/session_catalog.py +361 -0
  1019. chrys/service/state/session_listing.py +84 -0
  1020. chrys/service/state/session_migration.py +446 -0
  1021. chrys/service/state/session_mru.py +315 -0
  1022. chrys/service/state/store.py +2132 -0
  1023. chrys/service/state/workflow.py +158 -0
  1024. chrys/service/text_blocks.py +47 -0
  1025. chrys/service/todos/__init__.py +3 -0
  1026. chrys/service/todos/reminder.py +31 -0
  1027. chrys/service/todos/tracker.py +58 -0
  1028. chrys/service/tools/__init__.py +3 -0
  1029. chrys/service/tools/approval_targets.py +92 -0
  1030. chrys/service/tools/builtins/__init__.py +3 -0
  1031. chrys/service/tools/builtins/ask_user.py +326 -0
  1032. chrys/service/tools/builtins/doc_converter/__init__.py +494 -0
  1033. chrys/service/tools/builtins/doc_converter/artifacts.py +392 -0
  1034. chrys/service/tools/builtins/doc_converter/parsers/__init__.py +3 -0
  1035. chrys/service/tools/builtins/doc_converter/parsers/_table.py +34 -0
  1036. chrys/service/tools/builtins/doc_converter/parsers/base.py +101 -0
  1037. chrys/service/tools/builtins/doc_converter/parsers/docx.py +88 -0
  1038. chrys/service/tools/builtins/doc_converter/parsers/pdf.py +144 -0
  1039. chrys/service/tools/builtins/doc_converter/parsers/pptx.py +103 -0
  1040. chrys/service/tools/builtins/doc_converter/parsers/xls.py +32 -0
  1041. chrys/service/tools/builtins/doc_converter/parsers/xlsx.py +51 -0
  1042. chrys/service/tools/builtins/doc_converter/registry.py +55 -0
  1043. chrys/service/tools/builtins/filesystem.py +1071 -0
  1044. chrys/service/tools/builtins/search.py +1265 -0
  1045. chrys/service/tools/builtins/shell.py +967 -0
  1046. chrys/service/tools/builtins/shell_command_filtering/__init__.py +5 -0
  1047. chrys/service/tools/builtins/shell_command_filtering/policy.py +60 -0
  1048. chrys/service/tools/builtins/shell_command_filtering/presets.py +152 -0
  1049. chrys/service/tools/builtins/shell_command_filtering/readonly/__init__.py +358 -0
  1050. chrys/service/tools/builtins/shell_command_filtering/readonly/commands.py +416 -0
  1051. chrys/service/tools/builtins/shell_command_filtering/readonly/git.py +408 -0
  1052. chrys/service/tools/builtins/shell_command_filtering/readonly/syntax.py +87 -0
  1053. chrys/service/tools/builtins/shell_command_filtering/tokenizer.py +214 -0
  1054. chrys/service/tools/builtins/shell_filter.py +24 -0
  1055. chrys/service/tools/builtins/sleep.py +91 -0
  1056. chrys/service/tools/builtins/todo.py +64 -0
  1057. chrys/service/tools/builtins/web/__init__.py +6 -0
  1058. chrys/service/tools/builtins/web/build.py +268 -0
  1059. chrys/service/tools/builtins/web/config.py +338 -0
  1060. chrys/service/tools/builtins/web/credentials.py +37 -0
  1061. chrys/service/tools/builtins/web/fetch/__init__.py +3 -0
  1062. chrys/service/tools/builtins/web/fetch/cache.py +68 -0
  1063. chrys/service/tools/builtins/web/fetch/convert.py +56 -0
  1064. chrys/service/tools/builtins/web/fetch/tool.py +223 -0
  1065. chrys/service/tools/builtins/web/hosted.py +61 -0
  1066. chrys/service/tools/builtins/web/http.py +330 -0
  1067. chrys/service/tools/builtins/web/progress.py +18 -0
  1068. chrys/service/tools/builtins/web/search/__init__.py +3 -0
  1069. chrys/service/tools/builtins/web/search/exa_mcp.py +146 -0
  1070. chrys/service/tools/builtins/web/search/html.py +152 -0
  1071. chrys/service/tools/builtins/web/search/json_api.py +227 -0
  1072. chrys/service/tools/builtins/web/search/providers.py +77 -0
  1073. chrys/service/tools/builtins/web/search/tool.py +218 -0
  1074. chrys/service/tools/builtins/web/search/types.py +28 -0
  1075. chrys/service/tools/builtins/web/tls_identity.py +66 -0
  1076. chrys/service/tools/kinds.py +115 -0
  1077. chrys/service/tools/names.py +47 -0
  1078. chrys/service/tools/registry.py +242 -0
  1079. chrys/service/tools/result_metadata.py +103 -0
  1080. chrys/service/tools/session_artifacts.py +196 -0
  1081. chrys/service/tools/spill.py +218 -0
  1082. chrys/service/tools/workspace_paths.py +81 -0
  1083. chrys/service/trajectory/__init__.py +11 -0
  1084. chrys/service/trajectory/approvals.py +201 -0
  1085. chrys/service/trajectory/compaction.py +420 -0
  1086. chrys/service/trajectory/fork.py +75 -0
  1087. chrys/service/trajectory/hooks.py +217 -0
  1088. chrys/service/trajectory/items.py +41 -0
  1089. chrys/service/trajectory/preparation.py +374 -0
  1090. chrys/service/trajectory/retries.py +95 -0
  1091. chrys/service/trajectory/revisions.py +129 -0
  1092. chrys/service/trajectory/segmented.py +163 -0
  1093. chrys/service/trajectory/session.py +762 -0
  1094. chrys/service/trajectory/state.py +83 -0
  1095. chrys/service/trajectory/sub_agents.py +169 -0
  1096. chrys/service/trajectory/tombstone.py +262 -0
  1097. chrys/service/trajectory/tools.py +323 -0
  1098. chrys/service/trajectory/validation.py +130 -0
  1099. chrys/service/trajectory/waits.py +161 -0
  1100. chrys/service/trajectory/workflow.py +148 -0
  1101. chrys/service/vision.py +128 -0
  1102. chrys/service/workflows/__init__.py +3 -0
  1103. chrys/service/workflows/admission.py +151 -0
  1104. chrys/service/workflows/artifacts.py +109 -0
  1105. chrys/service/workflows/asks.py +130 -0
  1106. chrys/service/workflows/builtins/__init__.py +12 -0
  1107. chrys/service/workflows/builtins/demo-workflow.manifest.json +635 -0
  1108. chrys/service/workflows/builtins/demo-workflow.py +756 -0
  1109. chrys/service/workflows/discovery.py +554 -0
  1110. chrys/service/workflows/environment.py +284 -0
  1111. chrys/service/workflows/graph.py +430 -0
  1112. chrys/service/workflows/history.py +82 -0
  1113. chrys/service/workflows/interpreter.py +107 -0
  1114. chrys/service/workflows/journal.py +334 -0
  1115. chrys/service/workflows/layout.py +56 -0
  1116. chrys/service/workflows/ledger.py +149 -0
  1117. chrys/service/workflows/model_selection.py +18 -0
  1118. chrys/service/workflows/orphans.py +209 -0
  1119. chrys/service/workflows/outcomes.py +46 -0
  1120. chrys/service/workflows/protocol.py +210 -0
  1121. chrys/service/workflows/records.py +142 -0
  1122. chrys/service/workflows/scheduler.py +770 -0
  1123. chrys/service/workflows/sdk/__init__.py +51 -0
  1124. chrys/service/workflows/sdk/_ask.py +167 -0
  1125. chrys/service/workflows/sdk/_builder.py +781 -0
  1126. chrys/service/workflows/sdk/_values.py +92 -0
  1127. chrys/service/workflows/sdk_artifact.py +74 -0
  1128. chrys/service/workflows/store.py +494 -0
  1129. chrys/service/workflows/transcript.py +102 -0
  1130. chrys/service/workflows/values.py +73 -0
  1131. chrys/service/workflows/worker_host.py +1820 -0
  1132. chrys/workflows.py +38 -0
  1133. icode_tui-0.29.1.dist-info/METADATA +104 -0
  1134. icode_tui-0.29.1.dist-info/RECORD +1138 -0
  1135. icode_tui-0.29.1.dist-info/WHEEL +4 -0
  1136. icode_tui-0.29.1.dist-info/entry_points.txt +2 -0
  1137. icode_tui-0.29.1.dist-info/licenses/LICENSE +202 -0
  1138. icode_tui-0.29.1.dist-info/licenses/NOTICE +1955 -0
@@ -0,0 +1,1266 @@
1
+ # Copyright (c) Huawei Technologies Co., Ltd. 2026. All rights reserved.
2
+
3
+ """The trajectory dashboard's Insights page: tool, MCP and skill activity,
4
+ per-turn token load, findings and the diagnostics wall."""
5
+
6
+ from __future__ import annotations
7
+
8
+ from collections import Counter
9
+ from typing import TYPE_CHECKING
10
+
11
+ from rich.style import Style
12
+ from rich.text import Text
13
+
14
+ from chrys.app.tui.widgets.trajectory.chartkit import percentage_meter, section_interior_width
15
+ from chrys.app.tui.widgets.trajectory.presentation import (
16
+ BUCKET_IDLE,
17
+ BUCKET_MODEL,
18
+ BUCKET_TOOLS,
19
+ BUCKET_WAIT,
20
+ METRIC_CP_COMPUTE,
21
+ METRIC_CP_RESPONSE,
22
+ METRIC_ELAPSED,
23
+ METRIC_OVERLAP,
24
+ METRIC_PARALLELISM,
25
+ METRIC_USAGE,
26
+ METRIC_WORK,
27
+ PRECISION_SYMBOLS,
28
+ TOKEN_CACHE_HIT,
29
+ TOKEN_CACHE_READ,
30
+ TOKEN_INPUT,
31
+ TOKEN_OUTPUT,
32
+ TOKEN_REASONING,
33
+ TOOL_USAGE_MORE,
34
+ TURN_LABEL,
35
+ DashboardLook,
36
+ RenderContext,
37
+ ResponsiveTier,
38
+ align_edges,
39
+ badged_section_title,
40
+ bordered_section_row,
41
+ cache_hit_metric,
42
+ callsite,
43
+ derived_metric_precision,
44
+ format_duration,
45
+ format_tokens,
46
+ identity_with_hook_id,
47
+ precision_badge,
48
+ precision_label,
49
+ precision_style,
50
+ section_box,
51
+ section_row_widths,
52
+ section_style,
53
+ )
54
+ from chrys.foundation.i18n import MessageDef, MessageRef, msg
55
+ from chrys.service.analytics import (
56
+ ContextCarryingLoad,
57
+ FindingRow,
58
+ FindingSeverity,
59
+ McpServerRow,
60
+ Metric,
61
+ NamedCountRow,
62
+ Precision,
63
+ SkillInsightRow,
64
+ TimelineDiagnosticCode,
65
+ TimelineOperationDiagnostic,
66
+ TokenUsage,
67
+ ToolInsightRow,
68
+ TrajectoryAnalysis,
69
+ TrajectoryDiagnostics,
70
+ TrajectoryOverview,
71
+ TurnAnalysis,
72
+ UsageBucket,
73
+ WallBucket,
74
+ )
75
+
76
+ if TYPE_CHECKING:
77
+ from collections.abc import Callable
78
+
79
+
80
+ _DIAGNOSTICS = msg("tui.trajectory.diagnostics.title", fallback="Diagnostics")
81
+ _DIAGNOSTICS_INTRO = msg(
82
+ "tui.trajectory.diagnostics.intro",
83
+ fallback="Data-integrity notes for this session's events log.",
84
+ )
85
+ _DIAGNOSTICS_HEALTHY = msg(
86
+ "tui.trajectory.diagnostics.healthy",
87
+ fallback="The events log is intact; no problems were found.",
88
+ )
89
+ _CORRUPT_LINES = msg(
90
+ "tui.trajectory.diagnostics.corrupt",
91
+ fallback="Corrupt line {count} ({sequences}); metrics in the affected range degrade to unresolved.",
92
+ plural_fallback="Corrupt lines {count} ({sequences}); metrics in the affected ranges degrade to unresolved.",
93
+ )
94
+ _UNSUPPORTED_LINES = msg(
95
+ "tui.trajectory.diagnostics.unsupported",
96
+ fallback="Unsupported line {count} ({sequences}); metrics in the affected range degrade to unresolved.",
97
+ plural_fallback="Unsupported lines {count} ({sequences}); metrics in the affected ranges degrade to unresolved.",
98
+ )
99
+ _AFTER_SEQUENCE = msg("tui.trajectory.diagnostics.after_sequence", fallback="after seq {sequence}")
100
+ _SEQUENCE = msg("tui.trajectory.diagnostics.sequence", fallback="seq {sequence}")
101
+ _ACCOUNTED_PREFIX = msg(
102
+ "tui.trajectory.diagnostics.accounted_prefix",
103
+ fallback="Accounted-prefix seq {first}-{last}: {reason}",
104
+ )
105
+ _UNRESOLVED_METRIC = msg(
106
+ "tui.trajectory.diagnostics.unresolved_metric",
107
+ fallback="{metric} unresolved: {reason}",
108
+ )
109
+ _OPERATION_DIAGNOSTIC = msg(
110
+ "tui.trajectory.diagnostics.operation",
111
+ fallback="Turn {turn} · {operation}: {reason}",
112
+ )
113
+ _OPERATION_REASON_DETACHED_HOOK = msg(
114
+ "tui.trajectory.diagnostics.operation.detached_hook",
115
+ fallback="detached hook records spawn latency, not work duration",
116
+ )
117
+ _OPERATION_REASON_MISSING_START = msg(
118
+ "tui.trajectory.diagnostics.operation.missing_start",
119
+ fallback="lifecycle has no start endpoint",
120
+ )
121
+ _OPERATION_REASON_MISSING_TERMINAL = msg(
122
+ "tui.trajectory.diagnostics.operation.missing_terminal",
123
+ fallback="lifecycle has no terminal endpoint",
124
+ )
125
+ _OPERATION_REASON_NONUNIQUE = msg(
126
+ "tui.trajectory.diagnostics.operation.nonunique",
127
+ fallback="lifecycle is not uniquely closed",
128
+ )
129
+ _OPERATION_REASON_INVALID_ENDPOINTS = msg(
130
+ "tui.trajectory.diagnostics.operation.invalid_endpoints",
131
+ fallback="interval has invalid monotonic endpoints",
132
+ )
133
+ _OPERATION_REASON_OUTSIDE_COVERAGE = msg(
134
+ "tui.trajectory.diagnostics.operation.outside_coverage",
135
+ fallback="lifecycle falls outside the owning turn coverage",
136
+ )
137
+ _OPERATION_REASON_ROLLBACK_START = msg(
138
+ "tui.trajectory.diagnostics.operation.rollback_start",
139
+ fallback="lifecycle crosses rollback projection; only its start endpoint remains active",
140
+ )
141
+ _OPERATION_REASON_ROLLBACK_TERMINAL = msg(
142
+ "tui.trajectory.diagnostics.operation.rollback_terminal",
143
+ fallback="lifecycle crosses rollback projection; only its terminal endpoint remains active",
144
+ )
145
+ _OPERATION_REASON_MESSAGES = {
146
+ TimelineDiagnosticCode.DETACHED_HOOK: _OPERATION_REASON_DETACHED_HOOK,
147
+ TimelineDiagnosticCode.MISSING_START: _OPERATION_REASON_MISSING_START,
148
+ TimelineDiagnosticCode.MISSING_TERMINAL: _OPERATION_REASON_MISSING_TERMINAL,
149
+ TimelineDiagnosticCode.NONUNIQUE_LIFECYCLE: _OPERATION_REASON_NONUNIQUE,
150
+ TimelineDiagnosticCode.INVALID_ENDPOINTS: _OPERATION_REASON_INVALID_ENDPOINTS,
151
+ TimelineDiagnosticCode.OUTSIDE_TURN_COVERAGE: _OPERATION_REASON_OUTSIDE_COVERAGE,
152
+ TimelineDiagnosticCode.ROLLBACK_START_SURVIVES: _OPERATION_REASON_ROLLBACK_START,
153
+ TimelineDiagnosticCode.ROLLBACK_TERMINAL_SURVIVES: _OPERATION_REASON_ROLLBACK_TERMINAL,
154
+ }
155
+ _DURATION_MISMATCH_SUMMARY = msg(
156
+ "tui.trajectory.diagnostics.duration_mismatch_summary",
157
+ fallback=(
158
+ "{value} span's recorded duration drifts from its lifecycle interval ({families}; up to {delta})"
159
+ " — write-through acknowledgement and scheduling jitter; every metric uses the lifecycle interval."
160
+ ),
161
+ plural_fallback=(
162
+ "{value} spans' recorded durations drift from their lifecycle intervals ({families}; up to {delta})"
163
+ " — write-through acknowledgement and scheduling jitter; every metric uses the lifecycle interval."
164
+ ),
165
+ )
166
+ _CONTAINMENT = msg(
167
+ "tui.trajectory.diagnostics.containment",
168
+ fallback="Containment {family} @{callsite} outside {parent_family} @{parent_callsite}",
169
+ )
170
+ _TORN_TAIL = msg("tui.trajectory.diagnostics.torn_tail", fallback="Torn tail: {bytes} bytes")
171
+ _EXPLICIT_GAP = msg(
172
+ "tui.trajectory.diagnostics.gap",
173
+ fallback="Trajectory gap seq {first}-{last}: {reason}",
174
+ )
175
+ _ROLLBACK_UNRESOLVED = msg(
176
+ "tui.trajectory.diagnostics.rollback",
177
+ fallback="Rollback live-history projection is unresolved.",
178
+ )
179
+ _MALFORMED_HOOK_MODES = msg(
180
+ "tui.trajectory.diagnostics.hook_modes",
181
+ fallback="Malformed hook execution mode: {count}",
182
+ plural_fallback="Malformed hook execution modes: {count}",
183
+ )
184
+ _SIDE_CALL_EMPTY_SHELLS = msg(
185
+ "tui.trajectory.diagnostics.side_call_empty_shells",
186
+ fallback=(
187
+ "{value} side call (title generation, approval judging, etc.) recorded an empty"
188
+ " context snapshot — a known benign shape, excluded from all metrics."
189
+ ),
190
+ plural_fallback=(
191
+ "{value} side calls (title generation, approval judging, etc.) recorded empty"
192
+ " context snapshots — a known benign shape, excluded from all metrics."
193
+ ),
194
+ )
195
+ _UNIDENTIFIED_MEMBERSHIP = msg(
196
+ "tui.trajectory.diagnostics.unidentified_membership",
197
+ fallback=(
198
+ "{value} context snapshot carried an item without analytics identity (e.g. a sub-agent's"
199
+ " seed prompt); token re-send cost is unknown for such items, timing is unaffected."
200
+ ),
201
+ plural_fallback=(
202
+ "{value} context snapshots carried items without analytics identity (e.g. sub-agent"
203
+ " seed prompts); token re-send cost is unknown for such items, timing is unaffected."
204
+ ),
205
+ )
206
+ _WALL_METRIC = msg("tui.trajectory.diagnostics.wall_metric", fallback="{bucket} wall time")
207
+ _UTILIZATION_METRIC = msg(
208
+ "tui.trajectory.diagnostics.utilization_metric",
209
+ fallback="{bucket} busy share",
210
+ )
211
+ _FINDINGS = msg("tui.trajectory.findings.title", fallback="Findings")
212
+ _NO_FINDINGS = msg("tui.trajectory.findings.none", fallback="No active findings.")
213
+ _FINDING_TITLE_UNVERIFIED = msg(
214
+ "tui.trajectory.finding.unverified_change.title",
215
+ fallback="Unverified change",
216
+ )
217
+ _FINDING_DETAIL_UNVERIFIED = msg(
218
+ "tui.trajectory.finding.unverified_change.detail",
219
+ fallback="{count} edit action occurred after the last successful verification.",
220
+ plural_fallback="{count} edit actions occurred after the last successful verification.",
221
+ )
222
+ _FINDING_TITLE_REPEATED = msg(
223
+ "tui.trajectory.finding.repeated_tool_fingerprint.title",
224
+ fallback="Repeated tool fingerprint",
225
+ )
226
+ _FINDING_DETAIL_REPEATED = msg(
227
+ "tui.trajectory.finding.repeated_tool_fingerprint.detail",
228
+ fallback="The same argument fingerprint occurred {count} time.",
229
+ plural_fallback="The same argument fingerprint occurred {count} times.",
230
+ )
231
+ _FINDING_TITLE_FAILED_CP = msg(
232
+ "tui.trajectory.finding.failed_attempt_critical_path.title",
233
+ fallback="Failed attempt dominates the critical path",
234
+ )
235
+ _FINDING_DETAIL_FAILED_CP = msg(
236
+ "tui.trajectory.finding.failed_attempt_critical_path.detail",
237
+ fallback="One failed tool attempt accounts for {percentage}% of response critical-path time.",
238
+ )
239
+ _FINDING_TITLE_RETRY_AMPLIFICATION = msg(
240
+ "tui.trajectory.finding.retry_token_amplification.title",
241
+ fallback="Retry token amplification",
242
+ )
243
+ _FINDING_DETAIL_RETRY_AMPLIFICATION = msg(
244
+ "tui.trajectory.finding.retry_token_amplification.detail",
245
+ fallback="Retries added {tokens} normalized token.",
246
+ plural_fallback="Retries added {tokens} normalized tokens.",
247
+ )
248
+ _FINDING_TITLE_NET_ZERO = msg(
249
+ "tui.trajectory.finding.net_zero_churn.title",
250
+ fallback="Changes cancelled out",
251
+ )
252
+ _FINDING_DETAIL_NET_ZERO = msg(
253
+ "tui.trajectory.finding.net_zero_churn.detail",
254
+ fallback="{count} file returned to its original state.",
255
+ plural_fallback="{count} files returned to their original state.",
256
+ )
257
+ _FINDING_TITLE_APPROVAL_SHARE = msg(
258
+ "tui.trajectory.finding.approval_blocking_share.title",
259
+ fallback="Approval blocking share is high",
260
+ )
261
+ _FINDING_DETAIL_APPROVAL_SHARE = msg(
262
+ "tui.trajectory.finding.approval_blocking_share.detail",
263
+ fallback="Approval waits occupied {percentage}% of this turn.",
264
+ )
265
+ _FINDING_TITLE_CONTEXT_LOAD = msg(
266
+ "tui.trajectory.finding.context_carrying_load.title",
267
+ fallback="Heavily re-sent context item",
268
+ )
269
+ _FINDING_DETAIL_CONTEXT_LOAD = msg(
270
+ "tui.trajectory.finding.context_carrying_load.detail",
271
+ fallback="One context item cost an estimated {load} token across the model requests that re-sent it.",
272
+ plural_fallback="One context item cost an estimated {load} tokens across the model requests that re-sent it.",
273
+ )
274
+ _FINDING_TITLES = {
275
+ "unverified-change": _FINDING_TITLE_UNVERIFIED,
276
+ "repeated-tool-fingerprint": _FINDING_TITLE_REPEATED,
277
+ "failed-attempt-critical-path": _FINDING_TITLE_FAILED_CP,
278
+ "retry-token-amplification": _FINDING_TITLE_RETRY_AMPLIFICATION,
279
+ "net-zero-churn": _FINDING_TITLE_NET_ZERO,
280
+ "approval-blocking-share": _FINDING_TITLE_APPROVAL_SHARE,
281
+ "context-carrying-load": _FINDING_TITLE_CONTEXT_LOAD,
282
+ }
283
+ _FINDING_DETAILS = {
284
+ "unverified-change": _FINDING_DETAIL_UNVERIFIED,
285
+ "repeated-tool-fingerprint": _FINDING_DETAIL_REPEATED,
286
+ "failed-attempt-critical-path": _FINDING_DETAIL_FAILED_CP,
287
+ "retry-token-amplification": _FINDING_DETAIL_RETRY_AMPLIFICATION,
288
+ "net-zero-churn": _FINDING_DETAIL_NET_ZERO,
289
+ "approval-blocking-share": _FINDING_DETAIL_APPROVAL_SHARE,
290
+ "context-carrying-load": _FINDING_DETAIL_CONTEXT_LOAD,
291
+ }
292
+ _TOKEN_CACHE_CREATION = msg("tui.trajectory.token_usage.cache_creation", fallback="cache creation")
293
+ _INSIGHTS_TOOLS = msg("tui.trajectory.insights.tools.title", fallback="Tool activity")
294
+ _INSIGHTS_INTEGRATIONS_MCP = msg("tui.trajectory.insights.integrations.mcp", fallback="MCP servers")
295
+ _INSIGHTS_INTEGRATIONS_SKILLS = msg(
296
+ "tui.trajectory.insights.integrations.skills",
297
+ fallback="Skills",
298
+ )
299
+ _INSIGHTS_NO_TOOLS = msg(
300
+ "tui.trajectory.insights.tools.none",
301
+ fallback="This session has no tool calls.",
302
+ )
303
+ _INSIGHTS_NO_MCP = msg(
304
+ "tui.trajectory.insights.integrations.mcp_none",
305
+ fallback="This session has no MCP calls.",
306
+ )
307
+ _INSIGHTS_NO_SKILLS = msg(
308
+ "tui.trajectory.insights.integrations.skills_none",
309
+ fallback="This session has no skill usage.",
310
+ )
311
+ _INSIGHTS_NO_TURN_TOKENS = msg(
312
+ "tui.trajectory.insights.tokens.no_turn_data",
313
+ fallback="No per-turn data.",
314
+ )
315
+ _INSIGHTS_PER_TURN_TOKENS = msg(
316
+ "tui.trajectory.insights.tokens.per_turn",
317
+ fallback="Tokens per turn",
318
+ )
319
+ _INSIGHTS_CARRYING_LOAD = msg(
320
+ "tui.trajectory.insights.tokens.carrying_load",
321
+ fallback="Context re-send cost · top {value}",
322
+ )
323
+ _INSIGHTS_CARRYING_EXPLAINER = msg(
324
+ "tui.trajectory.insights.tokens.carrying_explainer",
325
+ fallback="tokens × model requests that re-sent the item", # noqa: RUF001
326
+ )
327
+ _INSIGHTS_CARRYING_ROW_HEAD = msg(
328
+ "tui.trajectory.insights.tokens.carrying_row_head",
329
+ fallback="{item} · since turn {turn}",
330
+ )
331
+ _INSIGHTS_CARRYING_ROW_DETAIL = msg(
332
+ "tui.trajectory.insights.tokens.carrying_row_detail",
333
+ fallback="{tokens} tok × {carries} re-sends", # noqa: RUF001
334
+ )
335
+ _INSIGHTS_CARRYING_USER = msg("tui.trajectory.insights.tokens.carrying_user", fallback="user message")
336
+ _INSIGHTS_CARRYING_ASSISTANT = msg("tui.trajectory.insights.tokens.carrying_assistant", fallback="assistant message")
337
+ _INSIGHTS_CARRYING_TOOL_RESULT = msg("tui.trajectory.insights.tokens.carrying_tool_result", fallback="tool result")
338
+ _INSIGHTS_CARRYING_ITEM = msg("tui.trajectory.insights.tokens.carrying_item", fallback="context item")
339
+ _INSIGHTS_INPUT_SHARE = msg(
340
+ "tui.trajectory.insights.tokens.input_share",
341
+ fallback="input share",
342
+ )
343
+ _INSIGHTS_UNATTRIBUTED = msg(
344
+ "tui.trajectory.insights.status.unattributed",
345
+ fallback="Unresolved attribution: {value}",
346
+ )
347
+ _INSIGHTS_UNCLASSIFIED = msg(
348
+ "tui.trajectory.insights.status.unclassified",
349
+ fallback="Unclassified: {value}",
350
+ )
351
+ _INSIGHTS_SKILL_CHANGED = msg(
352
+ "tui.trajectory.insights.status.skill_changed",
353
+ fallback="Skill changed during the session",
354
+ )
355
+ _INSIGHTS_SKILL_NOT_FOUND = msg(
356
+ "tui.trajectory.insights.status.skill_not_found",
357
+ fallback="Skill not found (configuration issue)",
358
+ )
359
+ _INSIGHTS_CALLS = msg("tui.trajectory.insights.column.calls", fallback="calls")
360
+ _INSIGHTS_DURATION_SHARE = msg("tui.trajectory.insights.column.duration_share", fallback="time share")
361
+ _INSIGHTS_P50 = msg("tui.trajectory.insights.column.p50", fallback="p50")
362
+ _INSIGHTS_P95 = msg("tui.trajectory.insights.column.p95", fallback="p95")
363
+ _INSIGHTS_RESULTS = msg("tui.trajectory.insights.column.results", fallback="results")
364
+ _INSIGHTS_APPROVAL = msg("tui.trajectory.insights.column.approval", fallback="approval blocking")
365
+ _INSIGHTS_RETURN_VOLUME = msg("tui.trajectory.insights.column.return_volume", fallback="return volume")
366
+ _INSIGHTS_TRUNCATED_SPILL = msg(
367
+ "tui.trajectory.insights.column.truncated_spill",
368
+ fallback="truncated · spilled",
369
+ )
370
+ _INSIGHTS_CP_EXCLUSIVE = msg(
371
+ "tui.trajectory.insights.column.cp_exclusive",
372
+ fallback="critical-path exclusive contribution",
373
+ )
374
+ _INSIGHTS_CONNECTION_WAIT = msg(
375
+ "tui.trajectory.insights.column.connection_wait",
376
+ fallback="connection wait",
377
+ )
378
+ _INSIGHTS_OTEL_CROSS_CHECK = msg(
379
+ "tui.trajectory.insights.column.otel_cross_check",
380
+ fallback="OTel cross-check",
381
+ )
382
+ _INSIGHTS_LOADS = msg("tui.trajectory.insights.column.loads", fallback="loads")
383
+ _INSIGHTS_TURNS = msg("tui.trajectory.insights.column.turns", fallback="turns")
384
+ _INSIGHTS_FIRST_ACTION = msg(
385
+ "tui.trajectory.insights.column.first_action",
386
+ fallback="median time to first action",
387
+ )
388
+ _INSIGHTS_SCRIPT_RUNS = msg("tui.trajectory.insights.column.script_runs", fallback="script runs")
389
+ _INSIGHTS_RESOURCE_READS = msg("tui.trajectory.insights.column.resource_reads", fallback="resource reads")
390
+ _INSIGHTS_INJECTED_TOKENS = msg("tui.trajectory.insights.column.injected_tokens", fallback="injected tokens")
391
+ _INSIGHTS_REVISIONS = msg("tui.trajectory.insights.column.revisions", fallback="revision")
392
+ _INSIGHTS_EXIT_CODES = msg("tui.trajectory.insights.column.exit_codes", fallback="exit codes")
393
+
394
+ # Side-by-side boxes pad the shorter one to the taller one's height; past this
395
+ # gap the dead space outweighs the width saving and the pair stacks full-width.
396
+ _SECTION_PAIR_MAX_HEIGHT_GAP = 10
397
+
398
+
399
+ def has_diagnostic_content(diagnostics: TrajectoryDiagnostics) -> bool:
400
+ """Whether the Insights diagnostic wall has session-specific content to show."""
401
+
402
+ return bool(
403
+ diagnostics.torn_tail_bytes
404
+ or diagnostics.corrupt_line_count
405
+ or diagnostics.corrupt_lines
406
+ or diagnostics.unsupported_event_count
407
+ or diagnostics.unsupported_lines
408
+ or diagnostics.accounted_prefix_violations
409
+ or diagnostics.accounted_prefix_violation_details
410
+ or diagnostics.explicit_gap_count
411
+ or diagnostics.explicit_gaps
412
+ or diagnostics.rollback_projection_unresolved
413
+ or diagnostics.span_duration_mismatch_count
414
+ or diagnostics.span_duration_mismatches
415
+ or diagnostics.containment_violation_count
416
+ or diagnostics.containment_violations
417
+ or diagnostics.malformed_hook_execution_mode_count
418
+ or diagnostics.timeline_operations
419
+ or diagnostics.side_call_empty_shell_revisions
420
+ or diagnostics.unidentified_membership_revision_count
421
+ )
422
+
423
+
424
+ def insights_lines(look: DashboardLook, context: RenderContext, analysis: TrajectoryAnalysis) -> list[Text]:
425
+ width = context.width
426
+ tier = context.tier
427
+ interior = section_interior_width(width)
428
+ insights = analysis.insights
429
+ carrying = (
430
+ sorted(
431
+ insights.context_carrying_load,
432
+ key=lambda row: (row.load, row.item_id),
433
+ reverse=True,
434
+ )[:5]
435
+ if insights is not None
436
+ else []
437
+ )
438
+ skills_precision = insights.skills.precision if insights is not None else Precision.MISSING
439
+ mcp_precision = insights.mcp.precision if insights is not None else Precision.MISSING
440
+ tools_precision = insights.tools.precision if insights is not None else Precision.MISSING
441
+ carrying_precision = insights.context_carrying_precision if insights is not None else Precision.MISSING
442
+ # Row order: the two integration summaries first, then the tool and
443
+ # context-cost details, the per-turn token table, and the findings
444
+ # and diagnostics wall last so the log-integrity notes close the page.
445
+ lines: list[Text] = []
446
+ lines.extend(
447
+ _adaptive_section_pair(
448
+ look,
449
+ badged_section_title(look, _INSIGHTS_INTEGRATIONS_SKILLS, skills_precision),
450
+ lambda box_width: _skills_insight_lines(look, analysis, width=box_width),
451
+ badged_section_title(look, _INSIGHTS_INTEGRATIONS_MCP, mcp_precision),
452
+ lambda box_width: _mcp_insight_lines(look, analysis, width=box_width),
453
+ width=width,
454
+ paired=tier is ResponsiveTier.WIDE,
455
+ balanced=False,
456
+ )
457
+ )
458
+ lines.extend(
459
+ _adaptive_section_pair(
460
+ look,
461
+ badged_section_title(look, _INSIGHTS_TOOLS, tools_precision),
462
+ lambda box_width: _tool_activity_lines(look, context, analysis, width=box_width),
463
+ badged_section_title(look, _INSIGHTS_CARRYING_LOAD.bind(value=5), carrying_precision),
464
+ lambda box_width: _carrying_load_lines(look, context, carrying, width=box_width),
465
+ width=width,
466
+ paired=tier is ResponsiveTier.WIDE,
467
+ balanced=False,
468
+ )
469
+ )
470
+ lines.extend(
471
+ section_box(
472
+ look,
473
+ _INSIGHTS_PER_TURN_TOKENS,
474
+ _per_turn_token_content(look, context, analysis, width=interior),
475
+ width=width,
476
+ )
477
+ )
478
+ lines.extend(
479
+ _adaptive_section_pair(
480
+ look,
481
+ _FINDINGS,
482
+ lambda _: _finding_lines(look, analysis),
483
+ _DIAGNOSTICS,
484
+ lambda _: _diagnostic_lines(look, analysis),
485
+ width=width,
486
+ paired=tier in {ResponsiveTier.WIDE, ResponsiveTier.MID},
487
+ )
488
+ )
489
+ return lines
490
+
491
+
492
+ def _adaptive_section_pair(
493
+ look: DashboardLook,
494
+ left_title: MessageDef | MessageRef | Text,
495
+ build_left: Callable[[int], list[Text]],
496
+ right_title: MessageDef | MessageRef | Text,
497
+ build_right: Callable[[int], list[Text]],
498
+ *,
499
+ width: int,
500
+ paired: bool,
501
+ balanced: bool = True,
502
+ ) -> list[Text]:
503
+ """Lay two sections side by side, or stack them full-width.
504
+
505
+ *balanced* pairs keep the side-by-side layout only while the two
506
+ boxes stay within the height-gap threshold; an unbalanced pair stays
507
+ side by side whenever *paired* holds, accepting the padding.
508
+ """
509
+ if paired:
510
+ halves = section_row_widths(width, 2)
511
+ left_lines = build_left(section_interior_width(halves[0]))
512
+ right_lines = build_right(section_interior_width(halves[1]))
513
+ left_box = section_box(look, left_title, left_lines, width=halves[0])
514
+ right_box = section_box(look, right_title, right_lines, width=halves[1])
515
+ if not balanced or abs(len(left_box) - len(right_box)) <= _SECTION_PAIR_MAX_HEIGHT_GAP:
516
+ return bordered_section_row(
517
+ look,
518
+ (
519
+ (left_title, left_lines, halves[0]),
520
+ (right_title, right_lines, halves[1]),
521
+ ),
522
+ )
523
+ interior = section_interior_width(width)
524
+ return [
525
+ *section_box(look, left_title, build_left(interior), width=width),
526
+ *section_box(look, right_title, build_right(interior), width=width),
527
+ ]
528
+
529
+
530
+ def _tool_activity_lines(
531
+ look: DashboardLook, context: RenderContext, analysis: TrajectoryAnalysis, *, width: int
532
+ ) -> list[Text]:
533
+ insights = analysis.insights
534
+ if insights is None or not insights.tools.total:
535
+ return [Text(look.message(_INSIGHTS_NO_TOOLS.bind()), style="dim")]
536
+ content = []
537
+ visible = insights.tools.rows[:12]
538
+ for row in visible:
539
+ content.extend(_tool_insight_row(look, context, row, width=width))
540
+ if len(insights.tools.rows) > len(visible):
541
+ content.append(
542
+ Text(
543
+ look.message(TOOL_USAGE_MORE.bind(value=len(insights.tools.rows) - len(visible))),
544
+ style="dim",
545
+ )
546
+ )
547
+ if insights.tools.unclassified:
548
+ content.append(
549
+ Text(
550
+ look.message(_INSIGHTS_UNCLASSIFIED.bind(value=insights.tools.unclassified)),
551
+ style=look.semantic_style("warning", "yellow"),
552
+ )
553
+ )
554
+ return content
555
+
556
+
557
+ def _tool_insight_row(look: DashboardLook, context: RenderContext, row: ToolInsightRow, *, width: int) -> list[Text]:
558
+ name = f"{row.tool_kind} · {row.tool_name or '—'}"
559
+ calls = look.message(_INSIGHTS_CALLS.bind())
560
+ share = look.message(_INSIGHTS_DURATION_SHARE.bind())
561
+ p50 = look.message(_INSIGHTS_P50.bind())
562
+ p95 = look.message(_INSIGHTS_P95.bind())
563
+ outcomes = look.message(_INSIGHTS_RESULTS.bind())
564
+ if context.tier is ResponsiveTier.FLOOR:
565
+ share_text = Text(_format_percentage_metric(row.duration_share))
566
+ else:
567
+ # Same bracket meter as the Overview operation shares, so every
568
+ # percentage on the dashboard reads the same way.
569
+ share_text = Text.assemble(
570
+ percentage_meter(
571
+ None if row.duration_share.value is None else float(row.duration_share.value) * 100,
572
+ width=max(6, min(16, width // 4)),
573
+ style=look.semantic_style("primary", "blue"),
574
+ ),
575
+ Text(" "),
576
+ precision_badge(look, row.duration_share.precision),
577
+ )
578
+ return [
579
+ align_edges(
580
+ Text(name, style=section_style(look)),
581
+ Text(f"{calls} {row.calls:,}"),
582
+ width,
583
+ ),
584
+ align_edges(Text(share), share_text, width),
585
+ align_edges(
586
+ Text(f"{p50} {_format_metric_duration(row.p50_ns)} · {p95} {_format_metric_duration(row.p95_ns)}"),
587
+ Text(f"{outcomes} {_format_named_counts(row.outcomes)}"),
588
+ width,
589
+ ),
590
+ ]
591
+
592
+
593
+ def _mcp_insight_lines(look: DashboardLook, analysis: TrajectoryAnalysis, *, width: int) -> list[Text]:
594
+ insights = analysis.insights
595
+ if insights is None:
596
+ return [Text(look.message(_INSIGHTS_NO_MCP.bind()), style="dim")]
597
+ mcp_lines: list[Text] = []
598
+ if not insights.mcp.total:
599
+ mcp_lines.append(Text(look.message(_INSIGHTS_NO_MCP.bind()), style="dim"))
600
+ else:
601
+ for row in insights.mcp.rows[:8]:
602
+ mcp_lines.extend(_mcp_server_lines(look, row, width=width))
603
+ if len(insights.mcp.rows) > 8:
604
+ mcp_lines.append(Text(look.message(TOOL_USAGE_MORE.bind(value=len(insights.mcp.rows) - 8)), style="dim"))
605
+ mcp_unattributed = insights.mcp.unattributed + insights.mcp.unattributed_connection_waits
606
+ if mcp_unattributed:
607
+ mcp_lines.append(
608
+ Text(
609
+ look.message(_INSIGHTS_UNATTRIBUTED.bind(value=mcp_unattributed)),
610
+ style=look.semantic_style("warning", "yellow"),
611
+ )
612
+ )
613
+ return mcp_lines
614
+
615
+
616
+ def _skills_insight_lines(look: DashboardLook, analysis: TrajectoryAnalysis, *, width: int) -> list[Text]:
617
+ insights = analysis.insights
618
+ if insights is None:
619
+ return [Text(look.message(_INSIGHTS_NO_SKILLS.bind()), style="dim")]
620
+ skill_lines: list[Text] = []
621
+ if not insights.skills.rows:
622
+ skill_lines.append(Text(look.message(_INSIGHTS_NO_SKILLS.bind()), style="dim"))
623
+ else:
624
+ for row in insights.skills.rows[:10]:
625
+ skill_lines.extend(_skill_insight_lines(look, row, width=width))
626
+ if len(insights.skills.rows) > 10:
627
+ skill_lines.append(
628
+ Text(look.message(TOOL_USAGE_MORE.bind(value=len(insights.skills.rows) - 10)), style="dim")
629
+ )
630
+ if insights.skills.unattributed:
631
+ skill_lines.append(
632
+ Text(
633
+ look.message(_INSIGHTS_UNATTRIBUTED.bind(value=insights.skills.unattributed)),
634
+ style=look.semantic_style("warning", "yellow"),
635
+ )
636
+ )
637
+ skill_lines.extend(
638
+ (
639
+ align_edges(
640
+ Text(
641
+ look.message(_INSIGHTS_SKILL_NOT_FOUND.bind()),
642
+ style=look.semantic_style("error", "red"),
643
+ ),
644
+ Text(f"{row.name} x{row.count}"),
645
+ width,
646
+ )
647
+ )
648
+ for row in insights.skills.not_found
649
+ )
650
+ return skill_lines
651
+
652
+
653
+ def _mcp_server_lines(look: DashboardLook, row: McpServerRow, *, width: int) -> list[Text]:
654
+ calls = look.message(_INSIGHTS_CALLS.bind())
655
+ share = look.message(_INSIGHTS_DURATION_SHARE.bind())
656
+ p50 = look.message(_INSIGHTS_P50.bind())
657
+ p95 = look.message(_INSIGHTS_P95.bind())
658
+ results = look.message(_INSIGHTS_RESULTS.bind())
659
+ approval = look.message(_INSIGHTS_APPROVAL.bind())
660
+ volume = look.message(_INSIGHTS_RETURN_VOLUME.bind())
661
+ truncated = look.message(_INSIGHTS_TRUNCATED_SPILL.bind())
662
+ cp = look.message(_INSIGHTS_CP_EXCLUSIVE.bind())
663
+ connection = look.message(_INSIGHTS_CONNECTION_WAIT.bind())
664
+ otel = look.message(_INSIGHTS_OTEL_CROSS_CHECK.bind())
665
+ lines = [
666
+ align_edges(
667
+ Text(row.server_name, style=section_style(look)),
668
+ Text(f"{calls} {row.calls:,} · {share} {_format_percentage_metric(row.duration_share)}"),
669
+ width,
670
+ ),
671
+ align_edges(
672
+ Text(f"{p50} {_format_metric_duration(row.p50_ns)} · {p95} {_format_metric_duration(row.p95_ns)}"),
673
+ Text(f"{results} {_format_named_counts(row.outcomes)}"),
674
+ width,
675
+ ),
676
+ align_edges(
677
+ Text(f"{approval} {_format_percentage_metric(row.approval_blocking_share)}"),
678
+ Text(f"{volume} {_format_metric_bytes(row.result_bytes)} + {_format_metric_tokens(row.result_tokens)}"),
679
+ width,
680
+ ),
681
+ align_edges(
682
+ Text(f"{truncated} {_format_metric_count(row.truncated_count)} · {_format_metric_count(row.spill_count)}"),
683
+ Text(f"{cp} {_format_metric_duration(row.critical_path_exclusive_ns)}"),
684
+ width,
685
+ ),
686
+ align_edges(
687
+ Text(
688
+ f"{connection} {_format_metric_count(row.connection_wait_count)} · "
689
+ f"{_format_metric_duration(row.connection_wait_ns)}"
690
+ ),
691
+ Text(f"{otel} —"),
692
+ width,
693
+ ),
694
+ ]
695
+ lines.extend(
696
+ align_edges(
697
+ Text(f" ↳ {remote.remote_name or '—'}", style="dim"),
698
+ Text(
699
+ f"{calls} {remote.calls:,} · {p50} {_format_metric_duration(remote.p50_ns)} · "
700
+ f"{p95} {_format_metric_duration(remote.p95_ns)} · {_format_named_counts(remote.outcomes)}"
701
+ ),
702
+ width,
703
+ )
704
+ for remote in row.remotes[:5]
705
+ )
706
+ if len(row.remotes) > 5:
707
+ lines.append(Text(f" {look.message(TOOL_USAGE_MORE.bind(value=len(row.remotes) - 5))}", style="dim"))
708
+ return lines
709
+
710
+
711
+ def _skill_insight_lines(look: DashboardLook, row: SkillInsightRow, *, width: int) -> list[Text]:
712
+ loads = look.message(_INSIGHTS_LOADS.bind())
713
+ turns = look.message(_INSIGHTS_TURNS.bind())
714
+ first_action = look.message(_INSIGHTS_FIRST_ACTION.bind())
715
+ script_runs = look.message(_INSIGHTS_SCRIPT_RUNS.bind())
716
+ resources = look.message(_INSIGHTS_RESOURCE_READS.bind())
717
+ injected = look.message(_INSIGHTS_INJECTED_TOKENS.bind())
718
+ revisions = look.message(_INSIGHTS_REVISIONS.bind())
719
+ exit_codes = look.message(_INSIGHTS_EXIT_CODES.bind())
720
+ lines = [
721
+ align_edges(
722
+ Text(row.skill_name, style=section_style(look)),
723
+ Text(f"{loads} {row.load_count:,} · {turns} {row.turn_count:,}"),
724
+ width,
725
+ ),
726
+ align_edges(
727
+ Text(f"{first_action} {_format_metric_duration(row.first_action_median_ns)}"),
728
+ Text(f"{script_runs} {row.script_count:,} · {resources} {row.resource_count:,}"),
729
+ width,
730
+ ),
731
+ align_edges(
732
+ Text(f"{injected} {_format_metric_tokens(row.injected_tokens)}"),
733
+ Text(f"{revisions} {', '.join(row.revisions) or '—'}"),
734
+ width,
735
+ ),
736
+ ]
737
+ if len(row.revisions) > 1:
738
+ lines.append(
739
+ Text(
740
+ look.message(_INSIGHTS_SKILL_CHANGED.bind()),
741
+ style=look.semantic_style("warning", "yellow"),
742
+ )
743
+ )
744
+ lines.extend(
745
+ align_edges(
746
+ Text(f" ↳ {child.name or '—'}", style="dim"),
747
+ Text(
748
+ f"{script_runs} {child.count:,} · {_format_named_counts(child.outcomes)}"
749
+ + (f" · {exit_codes} {_format_named_counts(child.exit_codes)}" if child.exit_codes else "")
750
+ ),
751
+ width,
752
+ )
753
+ for child in row.scripts[:5]
754
+ )
755
+ if len(row.scripts) > 5:
756
+ lines.append(Text(f" {look.message(TOOL_USAGE_MORE.bind(value=len(row.scripts) - 5))}", style="dim"))
757
+ lines.extend(
758
+ align_edges(
759
+ Text(f" ↳ {child.name or '—'}", style="dim"),
760
+ Text(f"{resources} {child.count:,}"),
761
+ width,
762
+ )
763
+ for child in row.resources[:5]
764
+ )
765
+ if len(row.resources) > 5:
766
+ lines.append(Text(f" {look.message(TOOL_USAGE_MORE.bind(value=len(row.resources) - 5))}", style="dim"))
767
+ return lines
768
+
769
+
770
+ def _per_turn_token_content(
771
+ look: DashboardLook, context: RenderContext, analysis: TrajectoryAnalysis, *, width: int
772
+ ) -> list[Text]:
773
+ per_turn: list[Text] = []
774
+ for turn in analysis.turns:
775
+ usage = turn.token_usage
776
+ if usage is None:
777
+ continue
778
+ per_turn.extend(_per_turn_token_lines(look, context, turn, usage, session=analysis.token_usage, width=width))
779
+ if not per_turn:
780
+ per_turn.append(Text(look.message(_INSIGHTS_NO_TURN_TOKENS.bind()), style="dim"))
781
+ return per_turn
782
+
783
+
784
+ def _per_turn_token_lines(
785
+ look: DashboardLook,
786
+ context: RenderContext,
787
+ turn: TurnAnalysis,
788
+ usage: TokenUsage,
789
+ *,
790
+ session: TokenUsage | None,
791
+ width: int,
792
+ ) -> list[Text]:
793
+ label = look.message(TURN_LABEL.bind(turn=turn.turn_number or "—"))
794
+ buckets = " · ".join(
795
+ f"{look.message(definition.bind())} {_format_metric_tokens(usage.buckets[bucket])}"
796
+ for bucket, definition in (
797
+ (UsageBucket.INPUT, TOKEN_INPUT),
798
+ (UsageBucket.OUTPUT, TOKEN_OUTPUT),
799
+ (UsageBucket.REASONING, TOKEN_REASONING),
800
+ (UsageBucket.CACHE_READ, TOKEN_CACHE_READ),
801
+ (UsageBucket.CACHE_CREATION, _TOKEN_CACHE_CREATION),
802
+ )
803
+ )
804
+ lines = [
805
+ align_edges(
806
+ Text(label, style=section_style(look)),
807
+ Text(buckets),
808
+ width,
809
+ )
810
+ ]
811
+ if context.tier is not ResponsiveTier.FLOOR:
812
+ share = _input_share_metric(usage, session)
813
+ cache_hit = cache_hit_metric(usage)
814
+ meter_width = max(6, min(30, (width - 46) // 2))
815
+ left = Text.assemble(
816
+ Text(f" {look.message(_INSIGHTS_INPUT_SHARE.bind())} "),
817
+ percentage_meter(
818
+ None if share.value is None else float(share.value),
819
+ width=meter_width,
820
+ style=look.semantic_style("primary", "blue"),
821
+ ),
822
+ Text(" "),
823
+ precision_badge(look, share.precision),
824
+ )
825
+ right = Text.assemble(
826
+ Text(f"{look.message(TOKEN_CACHE_HIT.bind())} "),
827
+ percentage_meter(
828
+ None if cache_hit.value is None else float(cache_hit.value),
829
+ width=meter_width,
830
+ style=_cache_hit_style(look, cache_hit.value),
831
+ ),
832
+ Text(" "),
833
+ precision_badge(look, cache_hit.precision),
834
+ )
835
+ lines.append(align_edges(left, right, width))
836
+ return lines
837
+
838
+
839
+ def _carrying_load_lines(
840
+ look: DashboardLook, context: RenderContext, rows: list[ContextCarryingLoad], *, width: int
841
+ ) -> list[Text]:
842
+ lines = [Text(look.message(_INSIGHTS_CARRYING_EXPLAINER.bind()), style="dim")]
843
+ if not rows:
844
+ lines.append(Text("—", style="dim"))
845
+ return lines
846
+ maximum = max(row.load for row in rows)
847
+ bar_width = min(16, max(4, width // 4))
848
+ for row in rows:
849
+ # Two lines per item: the identity and its total cost on the
850
+ # first, the cost formula and a relative bar on the second, so
851
+ # neither half gets truncated into the other at pair widths.
852
+ head = look.message(
853
+ _INSIGHTS_CARRYING_ROW_HEAD.bind(
854
+ item=_carrying_item_label(look, row),
855
+ turn=row.origin_turn_number or "—",
856
+ )
857
+ )
858
+ detail = look.message(
859
+ _INSIGHTS_CARRYING_ROW_DETAIL.bind(
860
+ tokens=format_tokens(row.token_count),
861
+ carries=row.carry_count,
862
+ )
863
+ )
864
+ lines.append(
865
+ align_edges(
866
+ Text(head, style=section_style(look)),
867
+ Text(format_tokens(row.load), style="bold"),
868
+ width,
869
+ )
870
+ )
871
+ bar = Text()
872
+ if context.tier is not ResponsiveTier.FLOOR and maximum:
873
+ filled = max(1, round(row.load / maximum * bar_width))
874
+ bar = Text.assemble(
875
+ Text("▬" * filled, style=look.semantic_style("primary", "blue")),
876
+ Text(" " * (bar_width - filled)),
877
+ )
878
+ lines.append(align_edges(Text(f" {detail}", style="dim"), bar, width))
879
+ return lines
880
+
881
+
882
+ def _carrying_item_label(look: DashboardLook, row: ContextCarryingLoad) -> str:
883
+ if row.role == "user":
884
+ kind = _INSIGHTS_CARRYING_USER
885
+ elif row.role == "assistant":
886
+ kind = _INSIGHTS_CARRYING_ASSISTANT
887
+ elif row.role == "tool":
888
+ kind = _INSIGHTS_CARRYING_TOOL_RESULT
889
+ else:
890
+ kind = _INSIGHTS_CARRYING_ITEM
891
+ label = look.message(kind.bind())
892
+ if not row.tool_names:
893
+ return label
894
+ names = ", ".join(
895
+ f"{name} ×{count}" if count > 1 else name # noqa: RUF001
896
+ for name, count in Counter(row.tool_names).items()
897
+ )
898
+ return f"{label} ({names})"
899
+
900
+
901
+ def _finding_lines(look: DashboardLook, analysis: TrajectoryAnalysis) -> list[Text]:
902
+ lines: list[Text] = []
903
+ if not analysis.findings:
904
+ lines.append(Text(look.message(_NO_FINDINGS.bind()), style="dim"))
905
+ else:
906
+ for finding in analysis.findings:
907
+ severity_style = _finding_style(look, finding.severity)
908
+ lines.append(
909
+ Text.assemble(
910
+ Text(f"{_finding_glyph(finding.severity)} ", style=severity_style),
911
+ Text(
912
+ look.message(_FINDING_TITLES[finding.rule_id].bind()),
913
+ style=severity_style,
914
+ ),
915
+ Text(" "),
916
+ precision_badge(look, finding.precision),
917
+ )
918
+ )
919
+ lines.append(
920
+ Text.assemble(
921
+ Text(" "),
922
+ Text(_finding_detail(look, finding), style="dim"),
923
+ )
924
+ )
925
+ return lines
926
+
927
+
928
+ def _finding_detail(look: DashboardLook, finding: FindingRow) -> str:
929
+ definition = _FINDING_DETAILS[finding.rule_id]
930
+ args = dict(finding.detail_args)
931
+ if finding.rule_id in {"unverified-change", "repeated-tool-fingerprint", "net-zero-churn"}:
932
+ return look.message(definition.bind(count=args["count"]))
933
+ if finding.rule_id == "retry-token-amplification":
934
+ tokens = args["tokens"]
935
+ return look.message(definition.bind(count=tokens, tokens=format_tokens(tokens)))
936
+ if finding.rule_id == "context-carrying-load":
937
+ load = args["load"]
938
+ return look.message(definition.bind(count=load, load=format_tokens(load)))
939
+ return look.message(definition.bind(**args))
940
+
941
+
942
+ def _finding_style(look: DashboardLook, severity: FindingSeverity) -> Style:
943
+ if severity is FindingSeverity.ERROR:
944
+ return look.semantic_style("error", "red", bold=True)
945
+ if severity is FindingSeverity.WARNING:
946
+ return look.semantic_style("warning", "yellow", bold=True)
947
+ return Style(dim=True)
948
+
949
+
950
+ def _diagnostic_lines(look: DashboardLook, analysis: TrajectoryAnalysis) -> list[Text]:
951
+ diagnostics = analysis.diagnostics
952
+ lines = [Text(look.message(_DIAGNOSTICS_INTRO.bind()), style="dim")]
953
+ problems: list[Text] = []
954
+ if diagnostics.corrupt_line_count:
955
+ corrupt_sequences = ", ".join(
956
+ look.message(_AFTER_SEQUENCE.bind(sequence=item.after_sequence)) for item in diagnostics.corrupt_lines
957
+ )
958
+ problems.append(
959
+ Text(
960
+ look.message(_CORRUPT_LINES.bind(count=diagnostics.corrupt_line_count, sequences=corrupt_sequences)),
961
+ style=look.semantic_style("error", "red"),
962
+ )
963
+ )
964
+ if diagnostics.unsupported_event_count:
965
+ unsupported_sequences = ", ".join(
966
+ look.message(_SEQUENCE.bind(sequence=item.sequence)) for item in diagnostics.unsupported_lines
967
+ )
968
+ problems.append(
969
+ Text(
970
+ look.message(
971
+ _UNSUPPORTED_LINES.bind(
972
+ count=diagnostics.unsupported_event_count,
973
+ sequences=unsupported_sequences,
974
+ )
975
+ ),
976
+ style=look.semantic_style("error", "red"),
977
+ )
978
+ )
979
+ problems.extend(
980
+ Text(
981
+ look.message(
982
+ _ACCOUNTED_PREFIX.bind(
983
+ first=item.first_sequence,
984
+ last=item.last_sequence,
985
+ reason=item.message,
986
+ )
987
+ ),
988
+ style=look.semantic_style("error", "red"),
989
+ )
990
+ for item in diagnostics.accounted_prefix_violation_details
991
+ )
992
+ for label, metric in _overview_metric_items(look, analysis.overview):
993
+ if metric.precision is Precision.UNRESOLVED:
994
+ problems.append(_unresolved_metric_line(look, label, metric))
995
+ for turn in analysis.turns:
996
+ turn_label = look.message(TURN_LABEL.bind(turn=turn.turn_number or "—"))
997
+ for label, metric in _turn_metric_items(look, turn):
998
+ if metric.precision is Precision.UNRESOLVED:
999
+ problems.append(_unresolved_metric_line(look, f"{turn_label} {label}", metric))
1000
+ problems.extend(_operation_diagnostic_line(look, item) for item in diagnostics.timeline_operations)
1001
+ problems.extend(
1002
+ Text(
1003
+ look.message(
1004
+ _CONTAINMENT.bind(
1005
+ family=item.family,
1006
+ callsite=callsite(item.operation_id),
1007
+ parent_family=item.parent_family,
1008
+ parent_callsite=callsite(item.parent_operation_id),
1009
+ )
1010
+ ),
1011
+ style=look.semantic_style("error", "red"),
1012
+ )
1013
+ for item in diagnostics.containment_violations
1014
+ )
1015
+ if diagnostics.torn_tail_bytes:
1016
+ problems.append(
1017
+ Text(
1018
+ look.message(_TORN_TAIL.bind(bytes=diagnostics.torn_tail_bytes)),
1019
+ style=look.semantic_style("error", "red"),
1020
+ )
1021
+ )
1022
+ problems.extend(
1023
+ Text(
1024
+ look.message(_EXPLICIT_GAP.bind(first=item.first_sequence, last=item.last_sequence, reason=item.message)),
1025
+ style=look.semantic_style("error", "red"),
1026
+ )
1027
+ for item in diagnostics.explicit_gaps
1028
+ )
1029
+ if diagnostics.rollback_projection_unresolved:
1030
+ problems.append(
1031
+ Text(
1032
+ look.message(_ROLLBACK_UNRESOLVED.bind()),
1033
+ style=look.semantic_style("warning", "yellow"),
1034
+ )
1035
+ )
1036
+ if diagnostics.malformed_hook_execution_mode_count:
1037
+ problems.append(
1038
+ Text(
1039
+ look.message(_MALFORMED_HOOK_MODES.bind(count=diagnostics.malformed_hook_execution_mode_count)),
1040
+ style=look.semantic_style("error", "red"),
1041
+ )
1042
+ )
1043
+ if problems:
1044
+ lines.extend(problems)
1045
+ else:
1046
+ lines.append(
1047
+ Text(
1048
+ look.message(_DIAGNOSTICS_HEALTHY.bind()),
1049
+ style=look.semantic_style("success", "green"),
1050
+ )
1051
+ )
1052
+ # Recorded-duration drift is a pure producer signal: no metric reads
1053
+ # duration_ms, so it is information, not a problem — one summary line
1054
+ # rather than a wall of per-span notes.
1055
+ if diagnostics.span_duration_mismatches:
1056
+ mismatches = diagnostics.span_duration_mismatches
1057
+ families = ", ".join(
1058
+ f"{family} ×{count}" if count > 1 else family # noqa: RUF001
1059
+ for family, count in Counter(item.family for item in mismatches).items()
1060
+ )
1061
+ delta_ns = max(abs(item.interval_ns - item.recorded_duration_ms * 1_000_000) for item in mismatches)
1062
+ lines.append(
1063
+ Text(
1064
+ look.message(
1065
+ _DURATION_MISMATCH_SUMMARY.bind(
1066
+ count=len(mismatches),
1067
+ value=len(mismatches),
1068
+ families=families,
1069
+ delta=format_duration(delta_ns),
1070
+ )
1071
+ ),
1072
+ style="dim",
1073
+ )
1074
+ )
1075
+ if diagnostics.side_call_empty_shell_revisions:
1076
+ shell_count = len(diagnostics.side_call_empty_shell_revisions)
1077
+ lines.append(
1078
+ Text(
1079
+ look.message(_SIDE_CALL_EMPTY_SHELLS.bind(count=shell_count, value=shell_count)),
1080
+ style="dim",
1081
+ )
1082
+ )
1083
+ if diagnostics.unidentified_membership_revision_count:
1084
+ unidentified_count = diagnostics.unidentified_membership_revision_count
1085
+ lines.append(
1086
+ Text(
1087
+ look.message(_UNIDENTIFIED_MEMBERSHIP.bind(count=unidentified_count, value=unidentified_count)),
1088
+ style="dim",
1089
+ )
1090
+ )
1091
+ return lines
1092
+
1093
+
1094
+ def _unresolved_metric_line(look: DashboardLook, label: str, metric: Metric) -> Text:
1095
+ return Text(
1096
+ look.message(_UNRESOLVED_METRIC.bind(metric=label, reason=metric.reason or _precision(look, metric))),
1097
+ style=look.semantic_style("warning", "yellow"),
1098
+ )
1099
+
1100
+
1101
+ def _operation_diagnostic_line(look: DashboardLook, diagnostic: TimelineOperationDiagnostic) -> Text:
1102
+ identity = diagnostic.identity or diagnostic.family
1103
+ identity = identity_with_hook_id(identity, diagnostic.hook_id)
1104
+ operation = f"{identity} @{callsite(diagnostic.operation_id)}"
1105
+ reason = look.message(_OPERATION_REASON_MESSAGES[diagnostic.code].bind())
1106
+ return Text(
1107
+ look.message(
1108
+ _OPERATION_DIAGNOSTIC.bind(
1109
+ turn=diagnostic.turn_number or "—",
1110
+ operation=operation,
1111
+ reason=reason,
1112
+ )
1113
+ ),
1114
+ style=precision_style(look, diagnostic.precision),
1115
+ )
1116
+
1117
+
1118
+ def _overview_metric_items(look: DashboardLook, overview: TrajectoryOverview | None) -> list[tuple[str, Metric]]:
1119
+ if overview is None:
1120
+ return []
1121
+ return _metric_items(
1122
+ look,
1123
+ overview.elapsed_ns,
1124
+ overview.response_cp_ns,
1125
+ overview.compute_cp_ns,
1126
+ overview.exclusive_work_ns,
1127
+ overview.parallelism,
1128
+ overview.overlap_gain_ns,
1129
+ overview.usage_tokens,
1130
+ overview.wall_time_ns,
1131
+ overview.utilization,
1132
+ )
1133
+
1134
+
1135
+ def _turn_metric_items(look: DashboardLook, turn: TurnAnalysis) -> list[tuple[str, Metric]]:
1136
+ return _metric_items(
1137
+ look,
1138
+ turn.elapsed_ns,
1139
+ turn.response_cp_ns,
1140
+ turn.compute_cp_ns,
1141
+ turn.exclusive_work_ns,
1142
+ turn.parallelism,
1143
+ turn.overlap_gain_ns,
1144
+ turn.usage_tokens,
1145
+ turn.wall_time_ns,
1146
+ turn.utilization,
1147
+ )
1148
+
1149
+
1150
+ def _metric_items(
1151
+ look: DashboardLook,
1152
+ elapsed: Metric,
1153
+ response_cp: Metric,
1154
+ compute_cp: Metric,
1155
+ work: Metric,
1156
+ parallelism: Metric,
1157
+ overlap: Metric,
1158
+ usage: Metric,
1159
+ wall: dict[WallBucket, Metric],
1160
+ utilization: dict[WallBucket, Metric],
1161
+ ) -> list[tuple[str, Metric]]:
1162
+ items = [
1163
+ (look.message(METRIC_ELAPSED.bind()), elapsed),
1164
+ (look.message(METRIC_CP_RESPONSE.bind()), response_cp),
1165
+ (look.message(METRIC_CP_COMPUTE.bind()), compute_cp),
1166
+ (look.message(METRIC_WORK.bind()), work),
1167
+ (look.message(METRIC_PARALLELISM.bind()), parallelism),
1168
+ (look.message(METRIC_OVERLAP.bind()), overlap),
1169
+ (look.message(METRIC_USAGE.bind()), usage),
1170
+ ]
1171
+ bucket_labels = {
1172
+ WallBucket.MODEL: look.message(BUCKET_MODEL.bind()),
1173
+ WallBucket.TOOLS: look.message(BUCKET_TOOLS.bind()),
1174
+ WallBucket.WAIT: look.message(BUCKET_WAIT.bind()),
1175
+ WallBucket.IDLE: look.message(BUCKET_IDLE.bind()),
1176
+ }
1177
+ items.extend(
1178
+ (
1179
+ look.message(_WALL_METRIC.bind(bucket=bucket_labels[bucket])),
1180
+ wall[bucket],
1181
+ )
1182
+ for bucket in WallBucket
1183
+ )
1184
+ items.extend(
1185
+ (
1186
+ look.message(_UTILIZATION_METRIC.bind(bucket=bucket_labels[bucket])),
1187
+ utilization[bucket],
1188
+ )
1189
+ for bucket in (WallBucket.MODEL, WallBucket.TOOLS)
1190
+ )
1191
+ return items
1192
+
1193
+
1194
+ def _cache_hit_style(look: DashboardLook, value: int | float | None) -> Style:
1195
+ if value is None or value > 60:
1196
+ return look.semantic_style("success", "green")
1197
+ if value >= 30:
1198
+ return look.semantic_style("warning", "yellow")
1199
+ return look.semantic_style("error", "red")
1200
+
1201
+
1202
+ def _precision(look: DashboardLook, metric: Metric) -> str:
1203
+ return precision_label(look, metric.precision)
1204
+
1205
+
1206
+ def _finding_glyph(severity: FindingSeverity) -> str:
1207
+ if severity is FindingSeverity.ERROR:
1208
+ return "!"
1209
+ if severity is FindingSeverity.WARNING:
1210
+ return "△"
1211
+ return "•"
1212
+
1213
+
1214
+ def _input_share_metric(usage: TokenUsage, session: TokenUsage | None) -> Metric:
1215
+ """Derive this turn's share of the session's input tokens."""
1216
+ if session is None:
1217
+ return Metric(None, Precision.MISSING)
1218
+ turn_input = usage.buckets[UsageBucket.INPUT]
1219
+ total_input = session.buckets[UsageBucket.INPUT]
1220
+ if turn_input.value is None:
1221
+ return Metric(None, turn_input.precision, turn_input.reason)
1222
+ if total_input.value is None:
1223
+ return Metric(None, total_input.precision, total_input.reason)
1224
+ if float(total_input.value) == 0:
1225
+ return Metric(None, Precision.MISSING, total_input.reason)
1226
+ if (
1227
+ float(total_input.value) < 0
1228
+ or float(turn_input.value) < 0
1229
+ or float(turn_input.value) > float(total_input.value)
1230
+ ):
1231
+ return Metric(None, Precision.UNRESOLVED)
1232
+ percent = 100 * float(turn_input.value) / float(total_input.value)
1233
+ precision, reason = derived_metric_precision(turn_input, total_input)
1234
+ return Metric(percent, precision, reason)
1235
+
1236
+
1237
+ def _format_metric_duration(metric: Metric) -> str:
1238
+ value = "—" if metric.value is None else format_duration(metric.value)
1239
+ return f"{value} {PRECISION_SYMBOLS[metric.precision]}"
1240
+
1241
+
1242
+ def _format_percentage_metric(metric: Metric) -> str:
1243
+ value = "—" if metric.value is None else f"{float(metric.value) * 100:.1f}%"
1244
+ return f"{value} {PRECISION_SYMBOLS[metric.precision]}"
1245
+
1246
+
1247
+ def _format_metric_tokens(metric: Metric) -> str:
1248
+ return f"{format_tokens(metric.value)} {PRECISION_SYMBOLS[metric.precision]}"
1249
+
1250
+
1251
+ def _format_metric_count(metric: Metric) -> str:
1252
+ value = "—" if metric.value is None else f"{int(metric.value):,}"
1253
+ return f"{value} {PRECISION_SYMBOLS[metric.precision]}"
1254
+
1255
+
1256
+ def _format_metric_bytes(metric: Metric) -> str:
1257
+ if metric.value is None:
1258
+ value = "—"
1259
+ else:
1260
+ size = float(metric.value)
1261
+ value = f"{size / 1024:.1f} KiB" if size >= 1024 else f"{int(size)} B"
1262
+ return f"{value} {PRECISION_SYMBOLS[metric.precision]}"
1263
+
1264
+
1265
+ def _format_named_counts(rows: tuple[NamedCountRow, ...]) -> str:
1266
+ return ", ".join(f"{row.name}:{row.count}" for row in rows) or "—"