tmux-ide 2.8.0 → 2.9.0-beta.14

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 (1442) hide show
  1. package/README.md +88 -125
  2. package/bin/cli.js +75949 -12803
  3. package/package.json +74 -37
  4. package/packages/contracts/package.json +9 -3
  5. package/packages/contracts/src/__tests__/actions-contract.test.ts +119 -0
  6. package/packages/contracts/src/__tests__/agent-graph-overlay.test.ts +428 -0
  7. package/packages/contracts/src/__tests__/app-window-mutation.test.ts +51 -0
  8. package/packages/contracts/src/__tests__/app-window-state.test.ts +34 -0
  9. package/packages/contracts/src/__tests__/application-shell.test.ts +635 -0
  10. package/packages/contracts/src/__tests__/causal-cell.test.ts +47 -0
  11. package/packages/contracts/src/__tests__/client-view-state.test.ts +115 -0
  12. package/packages/contracts/src/__tests__/cohesion-fixture.test.ts +106 -0
  13. package/packages/contracts/src/__tests__/commands.test.ts +86 -0
  14. package/packages/contracts/src/__tests__/daemon-events.test.ts +400 -0
  15. package/packages/contracts/src/__tests__/daemon-resources.test.ts +143 -0
  16. package/packages/contracts/src/__tests__/daemon-wire.test.ts +117 -0
  17. package/packages/contracts/src/__tests__/desktop-host.test.ts +269 -0
  18. package/packages/contracts/src/__tests__/desktop-missions.test.ts +211 -0
  19. package/packages/contracts/src/__tests__/experience-conformance.test.ts +153 -0
  20. package/packages/contracts/src/__tests__/experience-kernel-boundary.test.ts +109 -0
  21. package/packages/contracts/src/__tests__/experience-shell.test.ts +65 -0
  22. package/packages/contracts/src/__tests__/fixtures/daemon-wire-v2.json +35 -0
  23. package/packages/contracts/src/__tests__/fleet-agent-graph.test.ts +231 -0
  24. package/packages/contracts/src/__tests__/fleet-catalog.test.ts +268 -0
  25. package/packages/contracts/src/__tests__/fleet-lifecycle.test.ts +62 -0
  26. package/packages/contracts/src/__tests__/focus-overlay.test.ts +110 -0
  27. package/packages/contracts/src/__tests__/ide-config.test.ts +18 -0
  28. package/packages/contracts/src/__tests__/issue-error.test.ts +78 -0
  29. package/packages/contracts/src/__tests__/mission-projections.test.ts +186 -0
  30. package/packages/contracts/src/__tests__/missions.test.ts +272 -0
  31. package/packages/contracts/src/__tests__/multiplexer-verbs.test.ts +240 -0
  32. package/packages/contracts/src/__tests__/pane-appearance.test.ts +146 -0
  33. package/packages/contracts/src/__tests__/pane-stream.test.ts +488 -0
  34. package/packages/contracts/src/__tests__/pane-widget-marker.test.ts +327 -0
  35. package/packages/contracts/src/__tests__/performance-metrics.test.ts +73 -0
  36. package/packages/contracts/src/__tests__/performance-qualification.test.ts +137 -0
  37. package/packages/contracts/src/__tests__/rich-card-widget.test.ts +29 -0
  38. package/packages/contracts/src/__tests__/session-runtime.test.ts +504 -0
  39. package/packages/contracts/src/__tests__/startup-readiness.test.ts +409 -0
  40. package/packages/contracts/src/__tests__/terminal-attachment-stream.test.ts +72 -0
  41. package/packages/contracts/src/__tests__/terminal-attachments.test.ts +329 -0
  42. package/packages/contracts/src/__tests__/terminal-delivery.test.ts +88 -0
  43. package/packages/contracts/src/__tests__/terminal-runtime-inventory.test.ts +68 -0
  44. package/packages/contracts/src/__tests__/transport-contract-loading.test.ts +91 -0
  45. package/packages/contracts/src/__tests__/visual-tokens.test.ts +224 -0
  46. package/packages/contracts/src/__tests__/workspace-changes-resource.test.ts +317 -0
  47. package/packages/contracts/src/__tests__/workspace-changes-view.test.ts +122 -0
  48. package/packages/contracts/src/__tests__/workspace-config.test.ts +294 -0
  49. package/packages/contracts/src/__tests__/workspace-files-resource.test.ts +261 -0
  50. package/packages/contracts/src/__tests__/workspace-files-tree.test.ts +147 -0
  51. package/packages/contracts/src/__tests__/workspace-pane-creation.test.ts +249 -0
  52. package/packages/contracts/src/__tests__/workspace-promotion.test.ts +94 -0
  53. package/packages/contracts/src/__tests__/workspace-resource-identity.test.ts +90 -0
  54. package/packages/contracts/src/actions-contract.ts +205 -0
  55. package/packages/contracts/src/actions-errors.ts +20 -0
  56. package/packages/contracts/src/agent-graph-overlay.ts +425 -0
  57. package/packages/contracts/src/app-window-mutation.ts +101 -0
  58. package/packages/contracts/src/app-window-state.ts +446 -0
  59. package/packages/contracts/src/application-shell-resource.ts +54 -0
  60. package/packages/contracts/src/application-shell.ts +1094 -0
  61. package/packages/contracts/src/causal-cell.ts +168 -0
  62. package/packages/contracts/src/client-view-state.ts +156 -0
  63. package/packages/contracts/src/cohesion-fixture.ts +647 -0
  64. package/packages/contracts/src/commands.ts +153 -0
  65. package/packages/contracts/src/daemon-events.ts +374 -0
  66. package/packages/contracts/src/daemon-resource-request.test.ts +192 -0
  67. package/packages/contracts/src/daemon-resource-request.ts +397 -0
  68. package/packages/contracts/src/daemon-resources.ts +108 -0
  69. package/packages/contracts/src/daemon-wire.ts +100 -0
  70. package/packages/contracts/src/desktop-daemon-capability-error.ts +31 -0
  71. package/packages/contracts/src/desktop-daemon-issue.ts +83 -0
  72. package/packages/contracts/src/desktop-host.ts +728 -0
  73. package/packages/contracts/src/desktop-missions.ts +159 -0
  74. package/packages/contracts/src/desktop-update.ts +48 -0
  75. package/packages/contracts/src/desktop-workspace-name.ts +18 -0
  76. package/packages/contracts/src/domain.ts +493 -0
  77. package/packages/contracts/src/experience-identifiers.ts +53 -0
  78. package/packages/contracts/src/experience-shell.ts +249 -0
  79. package/packages/contracts/src/fleet-agent-graph.ts +171 -0
  80. package/packages/contracts/src/fleet-catalog.ts +190 -0
  81. package/packages/contracts/src/fleet-lifecycle.ts +136 -0
  82. package/packages/contracts/src/focus-overlay.ts +175 -0
  83. package/packages/contracts/src/ide-config.ts +40 -20
  84. package/packages/contracts/src/index.ts +70 -0
  85. package/packages/contracts/src/interaction-receipts.ts +438 -0
  86. package/packages/contracts/src/issue-error.ts +107 -0
  87. package/packages/contracts/src/mission-projections.ts +269 -0
  88. package/packages/contracts/src/multiplexer-verbs.ts +447 -0
  89. package/packages/contracts/src/pane-appearance.ts +248 -0
  90. package/packages/contracts/src/pane-stream.ts +711 -0
  91. package/packages/contracts/src/pane-widget-descriptor.ts +62 -0
  92. package/packages/contracts/src/pane-widget-marker.ts +301 -0
  93. package/packages/contracts/src/performance-metrics.ts +128 -0
  94. package/packages/contracts/src/performance-qualification.ts +276 -0
  95. package/packages/contracts/src/rich-card-widget.ts +72 -0
  96. package/packages/contracts/src/saved-machines.ts +50 -0
  97. package/packages/contracts/src/semantic-identity.ts +39 -0
  98. package/packages/contracts/src/session-runtime.ts +364 -0
  99. package/packages/contracts/src/shared-monotonic-clock.ts +18 -0
  100. package/packages/contracts/src/startup-readiness.ts +432 -0
  101. package/packages/contracts/src/terminal-attachment-stream.ts +119 -0
  102. package/packages/contracts/src/terminal-attachments.ts +347 -0
  103. package/packages/contracts/src/terminal-delivery.ts +245 -0
  104. package/packages/contracts/src/terminal-replica.ts +133 -0
  105. package/packages/contracts/src/terminal-runtime-inventory.ts +42 -0
  106. package/packages/contracts/src/visual-recipes.ts +126 -0
  107. package/packages/contracts/src/visual-theme-presets.ts +499 -0
  108. package/packages/contracts/src/visual-tokens.ts +883 -0
  109. package/packages/contracts/src/widget-asset.ts +43 -0
  110. package/packages/contracts/src/workspace-catalog-resource.test.ts +146 -0
  111. package/packages/contracts/src/workspace-catalog-resource.ts +180 -0
  112. package/packages/contracts/src/workspace-changes-resource.ts +405 -0
  113. package/packages/contracts/src/workspace-changes-view.ts +195 -0
  114. package/packages/contracts/src/workspace-config.ts +303 -0
  115. package/packages/contracts/src/workspace-files-resource.ts +310 -0
  116. package/packages/contracts/src/workspace-files-tree.ts +167 -0
  117. package/packages/contracts/src/workspace-missions-resource.ts +32 -0
  118. package/packages/contracts/src/workspace-multiplexer.ts +373 -0
  119. package/packages/contracts/src/workspace-open-handoff.ts +99 -0
  120. package/packages/contracts/src/workspace-open.ts +62 -0
  121. package/packages/contracts/src/workspace-pane-creation.ts +221 -0
  122. package/packages/contracts/src/workspace-promotion.ts +107 -0
  123. package/packages/contracts/src/workspace-resource-identity.ts +81 -0
  124. package/packages/contracts/src/workspace-state.ts +530 -0
  125. package/packages/contracts/src/workspace.ts +14 -2
  126. package/packages/core/package.json +35 -0
  127. package/packages/core/src/agent-provisioning.test.ts +42 -0
  128. package/packages/core/src/agent-provisioning.ts +112 -0
  129. package/packages/core/src/app-window-identity.ts +33 -0
  130. package/packages/core/src/application-shell-session.test.ts +105 -0
  131. package/packages/core/src/application-shell-session.ts +195 -0
  132. package/packages/core/src/index.ts +17 -0
  133. package/packages/core/src/interaction-flow.test.ts +66 -0
  134. package/packages/core/src/interaction-flow.ts +159 -0
  135. package/packages/core/src/interaction-receipts.test.ts +361 -0
  136. package/packages/core/src/interaction-receipts.ts +336 -0
  137. package/packages/core/src/navigator.test.ts +34 -0
  138. package/packages/core/src/navigator.ts +74 -0
  139. package/packages/core/src/optimistic-projection-conformance.test.ts +75 -0
  140. package/packages/core/src/optimistic-projection-conformance.ts +61 -0
  141. package/packages/core/src/optimistic-projection-store.ts +71 -0
  142. package/packages/core/src/optimistic-projection.test.ts +118 -0
  143. package/packages/core/src/optimistic-projection.ts +194 -0
  144. package/packages/core/src/performance-metrics.test.ts +121 -0
  145. package/packages/core/src/performance-metrics.ts +241 -0
  146. package/packages/core/src/performance-qualification.test.ts +283 -0
  147. package/packages/core/src/performance-qualification.ts +360 -0
  148. package/packages/core/src/saved-machines.test.ts +80 -0
  149. package/packages/core/src/saved-machines.ts +53 -0
  150. package/packages/core/src/terminal-compact-capability.ts +31 -0
  151. package/packages/core/src/terminal-compact-cold.test.ts +87 -0
  152. package/packages/core/src/terminal-conformance.test.ts +48 -0
  153. package/packages/core/src/terminal-conformance.ts +405 -0
  154. package/packages/core/src/terminal-delivery-cache-lifetime.test.ts +167 -0
  155. package/packages/core/src/terminal-delivery-encode-cooperative.test.ts +140 -0
  156. package/packages/core/src/terminal-delivery.test.ts +1471 -0
  157. package/packages/core/src/terminal-delivery.ts +3154 -0
  158. package/packages/core/src/terminal-fnv64-wasm-bytes.ts +20 -0
  159. package/packages/core/src/terminal-fnv64-wasm.test.ts +61 -0
  160. package/packages/core/src/terminal-fnv64-wasm.ts +110 -0
  161. package/packages/core/src/terminal-replica-cold.test.ts +31 -0
  162. package/packages/core/src/terminal-replica-cooperative.test.ts +170 -0
  163. package/packages/core/src/terminal-replica-hash-cache.test.ts +283 -0
  164. package/packages/core/src/terminal-replica-hash-cache.ts +399 -0
  165. package/packages/core/src/terminal-replica.test.ts +347 -0
  166. package/packages/core/src/terminal-replica.ts +1149 -0
  167. package/packages/core/src/workspace-selection.test.ts +63 -0
  168. package/packages/core/src/workspace-selection.ts +97 -0
  169. package/packages/daemon/dist/attach.js +2 -2
  170. package/packages/daemon/dist/canonical.js +1 -1
  171. package/packages/daemon/dist/cli.js +38 -37
  172. package/packages/daemon/dist/command-center/actions/command-definitions.js +70 -0
  173. package/packages/daemon/dist/command-center/actions/dispatcher.js +228 -10
  174. package/packages/daemon/dist/command-center/actions/handlers/_project-context.js +3 -4
  175. package/packages/daemon/dist/command-center/actions/handlers/app-set-remote-access.js +6 -2
  176. package/packages/daemon/dist/command-center/actions/handlers/app-window-mutate.js +39 -0
  177. package/packages/daemon/dist/command-center/actions/handlers/config-actions.js +44 -20
  178. package/packages/daemon/dist/command-center/actions/handlers/daemon-shutdown.js +11 -1
  179. package/packages/daemon/dist/command-center/actions/handlers/fleet-lifecycle.js +56 -0
  180. package/packages/daemon/dist/command-center/actions/handlers/project-launch.js +16 -4
  181. package/packages/daemon/dist/command-center/actions/handlers/workspace-multiplexer.js +55 -0
  182. package/packages/daemon/dist/command-center/actions/handlers/workspace-open.js +89 -0
  183. package/packages/daemon/dist/command-center/actions/handlers/workspace-pane-create.js +34 -0
  184. package/packages/daemon/dist/command-center/actions/handlers/workspace-promote.js +34 -0
  185. package/packages/daemon/dist/command-center/actions/registry.js +126 -0
  186. package/packages/daemon/dist/command-center/actions/semantic-multiplexer-actions.js +16 -0
  187. package/packages/daemon/dist/command-center/agent-status-watch.js +170 -0
  188. package/packages/daemon/dist/command-center/daemon-fleet-facts-observer.js +395 -0
  189. package/packages/daemon/dist/command-center/discovery.js +262 -3
  190. package/packages/daemon/dist/command-center/owner-authority.js +46 -0
  191. package/packages/daemon/dist/command-center/pane-stream-issue.js +185 -0
  192. package/packages/daemon/dist/command-center/resources/agent-graph-overlay.js +234 -0
  193. package/packages/daemon/dist/command-center/resources/application-shell.js +641 -0
  194. package/packages/daemon/dist/command-center/resources/desktop-missions.js +132 -0
  195. package/packages/daemon/dist/command-center/resources/fleet-catalog.js +163 -0
  196. package/packages/daemon/dist/command-center/resources/fleet-resource-route.js +48 -0
  197. package/packages/daemon/dist/command-center/resources/startup-readiness-route.js +121 -0
  198. package/packages/daemon/dist/command-center/resources/startup-readiness.js +183 -0
  199. package/packages/daemon/dist/command-center/resources/terminal-native-backing-route.js +92 -0
  200. package/packages/daemon/dist/command-center/resources/terminal-runtime-inventory.js +24 -0
  201. package/packages/daemon/dist/command-center/resources/workspace-changes-authority.js +451 -0
  202. package/packages/daemon/dist/command-center/resources/workspace-changes-git.js +222 -0
  203. package/packages/daemon/dist/command-center/resources/workspace-files-authority.js +493 -0
  204. package/packages/daemon/dist/command-center/resources/workspace-missions-route.js +75 -0
  205. package/packages/daemon/dist/command-center/resources/workspace-resource-ids.js +69 -0
  206. package/packages/daemon/dist/command-center/resources/workspace-resource-routes.js +116 -0
  207. package/packages/daemon/dist/command-center/server.js +540 -51
  208. package/packages/daemon/dist/command-center/terminal-attachment-issue.js +191 -0
  209. package/packages/daemon/dist/command-center/workspace-resource-observer.js +453 -0
  210. package/packages/daemon/dist/command-center/ws-events.js +681 -63
  211. package/packages/daemon/dist/config.js +31 -25
  212. package/packages/daemon/dist/control/lifecycle.js +12 -2
  213. package/packages/daemon/dist/control/server.js +3 -3
  214. package/packages/daemon/dist/detect.js +23 -20
  215. package/packages/daemon/dist/doctor.js +25 -8
  216. package/packages/daemon/dist/index.js +20 -1
  217. package/packages/daemon/dist/init.js +24 -22
  218. package/packages/daemon/dist/inspect.js +33 -8
  219. package/packages/daemon/dist/launch.js +38 -26
  220. package/packages/daemon/dist/lib/__tests__/fixtures/workspace-state-writer.js +58 -0
  221. package/packages/daemon/dist/lib/agent-kind.js +24 -0
  222. package/packages/daemon/dist/lib/app-config.js +29 -1
  223. package/packages/daemon/dist/lib/app-window-kernel.js +556 -0
  224. package/packages/daemon/dist/lib/app-window-mutation.js +139 -0
  225. package/packages/daemon/dist/lib/app-window-repository.js +368 -0
  226. package/packages/daemon/dist/lib/app-window-state.js +415 -0
  227. package/packages/daemon/dist/lib/application-shell-app-windows.js +285 -0
  228. package/packages/daemon/dist/lib/auth/middleware.js +7 -3
  229. package/packages/daemon/dist/lib/bundled-tmux.js +93 -0
  230. package/packages/daemon/dist/lib/canonical-daemon-bootstrap.js +276 -0
  231. package/packages/daemon/dist/lib/canonical-daemon.js +507 -70
  232. package/packages/daemon/dist/lib/chrome-front-door.js +13 -0
  233. package/packages/daemon/dist/lib/cli-action-bridge.js +112 -82
  234. package/packages/daemon/dist/lib/command-registry.js +107 -0
  235. package/packages/daemon/dist/lib/config-context.js +34 -0
  236. package/packages/daemon/dist/lib/daemon-embed.js +1072 -363
  237. package/packages/daemon/dist/lib/daemon-session-monitor.js +194 -0
  238. package/packages/daemon/dist/lib/daemon.js +3 -47
  239. package/packages/daemon/dist/lib/directory-watcher.js +118 -0
  240. package/packages/daemon/dist/lib/embedded-daemon-lifecycle.js +102 -0
  241. package/packages/daemon/dist/lib/environment-identity.js +79 -0
  242. package/packages/daemon/dist/lib/fleet-agent-lifecycle.js +65 -0
  243. package/packages/daemon/dist/lib/fleet-lifecycle-authority.js +437 -0
  244. package/packages/daemon/dist/lib/headless-daemon.js +353 -0
  245. package/packages/daemon/dist/lib/launch-plan.js +96 -1
  246. package/packages/daemon/dist/lib/legacy-config-adapter.js +19 -0
  247. package/packages/daemon/dist/lib/legacy-config-migration.js +110 -0
  248. package/packages/daemon/dist/lib/legacy-theme-compat.js +25 -0
  249. package/packages/daemon/dist/lib/mission-projections.js +615 -0
  250. package/packages/daemon/dist/lib/mission-repository.js +775 -0
  251. package/packages/daemon/dist/lib/onboarding-marker.js +51 -0
  252. package/packages/daemon/dist/lib/pane-chrome.js +12 -0
  253. package/packages/daemon/dist/lib/pane-source-credentials.js +178 -0
  254. package/packages/daemon/dist/lib/pane-widget.js +126 -0
  255. package/packages/daemon/dist/lib/project-inspect.js +4 -0
  256. package/packages/daemon/dist/lib/project-onboard.js +17 -21
  257. package/packages/daemon/dist/lib/project-probe.js +28 -22
  258. package/packages/daemon/dist/lib/project-readiness-probe.js +425 -0
  259. package/packages/daemon/dist/lib/project-readiness.js +680 -0
  260. package/packages/daemon/dist/lib/project-registry.js +42 -9
  261. package/packages/daemon/dist/lib/project-resolver.js +245 -0
  262. package/packages/daemon/dist/lib/project-runtime-errors.js +21 -0
  263. package/packages/daemon/dist/lib/project-runtime-repository.js +876 -0
  264. package/packages/daemon/dist/lib/remote-daemon-info.js +21 -0
  265. package/packages/daemon/dist/lib/resolved-config.js +318 -0
  266. package/packages/daemon/dist/lib/runtime-namespace.js +136 -0
  267. package/packages/daemon/dist/lib/saved-machines.js +53 -0
  268. package/packages/daemon/dist/lib/semantic-resource-id.js +14 -0
  269. package/packages/daemon/dist/lib/session-monitor.js +29 -23
  270. package/packages/daemon/dist/lib/session-options.js +3 -10
  271. package/packages/daemon/dist/lib/ssh-daemon-transport.js +280 -0
  272. package/packages/daemon/dist/lib/state-home.js +2 -3
  273. package/packages/daemon/dist/lib/theme-mode.js +9 -0
  274. package/packages/daemon/dist/lib/tmux-authority-replacement.js +102 -0
  275. package/packages/daemon/dist/lib/tmux-external-interaction-observer.js +534 -0
  276. package/packages/daemon/dist/lib/tmux-interaction-options.js +126 -0
  277. package/packages/daemon/dist/lib/tmux-named-socket-fence.js +61 -0
  278. package/packages/daemon/dist/lib/tmux-terminal-color.js +37 -0
  279. package/packages/daemon/dist/lib/tui-binary.js +291 -28
  280. package/packages/daemon/dist/lib/unix-socket-authority.js +48 -0
  281. package/packages/daemon/dist/lib/widget-asset-policy.js +3 -0
  282. package/packages/daemon/dist/lib/widget-asset-store.js +166 -0
  283. package/packages/daemon/dist/lib/workspace-config-loader.js +280 -0
  284. package/packages/daemon/dist/lib/workspace-multiplexer-verbs.js +1138 -0
  285. package/packages/daemon/dist/lib/workspace-open-handoff.js +219 -0
  286. package/packages/daemon/dist/lib/workspace-open.js +740 -0
  287. package/packages/daemon/dist/lib/workspace-pane-creation.js +1137 -0
  288. package/packages/daemon/dist/lib/workspace-promotion.js +809 -0
  289. package/packages/daemon/dist/lib/workspace-registry.js +150 -23
  290. package/packages/daemon/dist/lib/workspace-state-repository.js +790 -0
  291. package/packages/daemon/dist/lib/workspace-state.js +765 -0
  292. package/packages/daemon/dist/lib/yaml-io.js +4 -18
  293. package/packages/daemon/dist/migrate.js +105 -0
  294. package/packages/daemon/dist/native/tmux/darwin-arm64/COPYING +13 -0
  295. package/packages/daemon/dist/native/tmux/darwin-arm64/lib/libevent_core-2.1.7.dylib +0 -0
  296. package/packages/daemon/dist/native/tmux/darwin-arm64/lib/libncursesw.6.dylib +0 -0
  297. package/packages/daemon/dist/native/tmux/darwin-arm64/lib/libutf8proc.3.2.3.dylib +0 -0
  298. package/packages/daemon/dist/native/tmux/darwin-arm64/licenses/libevent_core-2.1.7.dylib.txt +99 -0
  299. package/packages/daemon/dist/native/tmux/darwin-arm64/licenses/libncursesw.6.dylib.txt +29 -0
  300. package/packages/daemon/dist/native/tmux/darwin-arm64/licenses/libutf8proc.3.2.3.dylib.txt +93 -0
  301. package/packages/daemon/dist/native/tmux/darwin-arm64/manifest.json +21 -0
  302. package/packages/daemon/dist/native/tmux/darwin-arm64/tmux +0 -0
  303. package/packages/daemon/dist/restart.js +2 -2
  304. package/packages/daemon/dist/restore.js +10 -6
  305. package/packages/daemon/dist/schemas/inspect.js +9 -1
  306. package/packages/daemon/dist/schemas/registry.js +5 -19
  307. package/packages/daemon/dist/schemas/ws-events.js +4 -107
  308. package/packages/daemon/dist/send.js +106 -3
  309. package/packages/daemon/dist/server/index.js +4 -2
  310. package/packages/daemon/dist/server/pane-stream-upgrade.js +117 -0
  311. package/packages/daemon/dist/server/terminal-attachment-upgrade.js +121 -0
  312. package/packages/daemon/dist/status.js +11 -8
  313. package/packages/daemon/dist/stop.js +2 -2
  314. package/packages/daemon/dist/terminal/MonotonicPtyInput.js +130 -0
  315. package/packages/daemon/dist/terminal/NodePtyAdapter.js +37 -10
  316. package/packages/daemon/dist/terminal/PtyAdapter.js +18 -0
  317. package/packages/daemon/dist/terminal/__tests__/MockPtyAdapter.js +33 -6
  318. package/packages/daemon/dist/terminal/attachments/admission-util.js +87 -0
  319. package/packages/daemon/dist/terminal/attachments/agent-status-probe.js +325 -0
  320. package/packages/daemon/dist/terminal/attachments/direct-websocket.js +1069 -0
  321. package/packages/daemon/dist/terminal/attachments/grouped-tmux.js +213 -0
  322. package/packages/daemon/dist/terminal/attachments/lease-manager.js +655 -0
  323. package/packages/daemon/dist/terminal/attachments/native-runtime.js +1597 -0
  324. package/packages/daemon/dist/terminal/attachments/pty-tmux-attachment-launcher.js +607 -0
  325. package/packages/daemon/dist/terminal/attachments/semantic-pane-catalog.js +208 -0
  326. package/packages/daemon/dist/terminal/attachments/tmux-view-executor.js +825 -0
  327. package/packages/daemon/dist/terminal/mirror/__tests__/scripted-channel.js +90 -0
  328. package/packages/daemon/dist/terminal/mirror/__tests__/simulated-channel.js +147 -0
  329. package/packages/daemon/dist/terminal/mirror/control-channel.js +768 -0
  330. package/packages/daemon/dist/terminal/mirror/control-mode-ownership.js +30 -0
  331. package/packages/daemon/dist/terminal/mirror/flow-ledger.js +56 -0
  332. package/packages/daemon/dist/terminal/mirror/mirror-service.js +338 -0
  333. package/packages/daemon/dist/terminal/mirror/native-frozen-grid.js +128 -0
  334. package/packages/daemon/dist/terminal/mirror/native-grid-capture.js +179 -0
  335. package/packages/daemon/dist/terminal/mirror/native-grid-projection.js +99 -0
  336. package/packages/daemon/dist/terminal/mirror/native-grid-reader.js +81 -0
  337. package/packages/daemon/dist/terminal/mirror/native-grid-reflow.js +207 -0
  338. package/packages/daemon/dist/terminal/mirror/pane-feed.js +209 -0
  339. package/packages/daemon/dist/terminal/mirror/session-channel.js +2774 -0
  340. package/packages/daemon/dist/terminal/pane-stream/lease-manager.js +245 -0
  341. package/packages/daemon/dist/terminal/pane-stream/pane-stream-websocket.js +2067 -0
  342. package/packages/daemon/dist/terminal/pane-stream/runtime.js +53 -0
  343. package/packages/daemon/dist/terminal/pane-stream/wire-ledger.js +110 -0
  344. package/packages/daemon/dist/terminal/protocol/chunk-bytes.js +21 -0
  345. package/packages/daemon/dist/terminal/protocol/control.js +111 -0
  346. package/packages/daemon/dist/terminal/protocol/input-coalescer.js +125 -0
  347. package/packages/daemon/dist/terminal/protocol/layout-parse.js +127 -0
  348. package/packages/daemon/dist/terminal/protocol/native-backing-client.js +44 -0
  349. package/packages/daemon/dist/terminal/protocol/pane-display-name.js +155 -0
  350. package/packages/daemon/dist/terminal/protocol/session-descriptor-discovery.js +294 -0
  351. package/packages/daemon/dist/terminal/protocol/workspace-tmux-adapter.js +213 -0
  352. package/packages/daemon/dist/terminal/session-runtime/authority-arbiter.js +266 -0
  353. package/packages/daemon/dist/terminal/session-runtime/causal-cell-ledger.js +278 -0
  354. package/packages/daemon/dist/terminal/session-runtime/interaction-receipt-facts.js +147 -0
  355. package/packages/daemon/dist/terminal/session-runtime/multiplexer-backend.js +116 -0
  356. package/packages/daemon/dist/terminal/session-runtime/native-seed-backing.js +41 -0
  357. package/packages/daemon/dist/terminal/session-runtime/registry.js +1390 -0
  358. package/packages/daemon/dist/terminal/session-runtime/runtime-observability.js +72 -0
  359. package/packages/daemon/dist/terminal/session-runtime/runtime-scheduler.js +16 -0
  360. package/packages/daemon/dist/terminal/session-runtime/runtime-trace-correlator.js +48 -0
  361. package/packages/daemon/dist/terminal/session-runtime/semantic-mutation-executor.js +353 -0
  362. package/packages/daemon/dist/terminal/session-runtime/semantic-mutation-resource-changes.js +32 -0
  363. package/packages/daemon/dist/terminal/session-runtime/terminal-delivery-hub.js +1770 -0
  364. package/packages/daemon/dist/terminal/session-runtime/terminal-delivery-observation-identity.js +9 -0
  365. package/packages/daemon/dist/terminal/session-runtime/terminal-replica-interpreter.js +582 -0
  366. package/packages/daemon/dist/terminal/session-runtime/terminal-replica-owner.js +568 -0
  367. package/packages/daemon/dist/terminal/session-runtime/terminal-replica-shadow-projections.js +21 -0
  368. package/packages/daemon/dist/terminal/session-runtime/transport-binding.js +474 -0
  369. package/packages/daemon/dist/terminal/session-runtime/xterm-terminal-interpreter-backend.js +515 -0
  370. package/packages/daemon/dist/tui/async-disposable-slot.js +57 -0
  371. package/packages/daemon/dist/tui/chrome/cheatsheet.js +211 -0
  372. package/packages/daemon/dist/tui/chrome/chip.js +25 -0
  373. package/packages/daemon/dist/tui/chrome/events.js +94 -0
  374. package/packages/daemon/dist/tui/chrome/front-door.js +16 -0
  375. package/packages/daemon/dist/tui/chrome/kitty-keys.js +54 -0
  376. package/packages/daemon/dist/tui/chrome/menu.js +251 -0
  377. package/packages/daemon/dist/tui/chrome/notify-prefs.js +13 -0
  378. package/packages/daemon/dist/tui/chrome/notify-state.js +77 -0
  379. package/packages/daemon/dist/tui/chrome/notify.js +711 -0
  380. package/packages/daemon/dist/tui/chrome/panels.js +60 -0
  381. package/packages/daemon/dist/tui/chrome/sidebar.js +183 -0
  382. package/packages/daemon/dist/tui/chrome/snapshot.js +290 -0
  383. package/packages/daemon/dist/tui/chrome/statusline.js +552 -0
  384. package/packages/daemon/dist/tui/chrome/updater.js +651 -0
  385. package/packages/daemon/dist/tui/chrome/welcome.js +117 -0
  386. package/packages/daemon/dist/tui/compiled.js +194 -0
  387. package/packages/daemon/dist/tui/detect/agent-resolution.js +60 -0
  388. package/packages/daemon/dist/tui/detect/classify.js +184 -0
  389. package/packages/daemon/dist/tui/detect/manifest-loader.js +242 -0
  390. package/packages/daemon/dist/tui/detect/manifest.js +126 -0
  391. package/packages/daemon/dist/tui/detect/manifests.js +535 -0
  392. package/packages/daemon/dist/tui/detect/process-tree.js +194 -0
  393. package/packages/daemon/dist/tui/detect/session-id.js +414 -0
  394. package/packages/daemon/dist/tui/detect/snapshot.js +81 -0
  395. package/packages/daemon/dist/tui/integrations/claude.js +151 -0
  396. package/packages/daemon/dist/tui/integrations/offer.js +134 -0
  397. package/packages/daemon/dist/tui/integrations/opencode.js +117 -0
  398. package/packages/daemon/dist/tui/mirror/ack-writer.js +78 -0
  399. package/packages/daemon/dist/tui/mirror/activity-surface-view.jsx +69 -0
  400. package/packages/daemon/dist/tui/mirror/activity-surface.js +271 -0
  401. package/packages/daemon/dist/tui/mirror/agent-chip.js +84 -0
  402. package/packages/daemon/dist/tui/mirror/agent-lifecycle.js +372 -0
  403. package/packages/daemon/dist/tui/mirror/agent-provisioning-executor.js +111 -0
  404. package/packages/daemon/dist/tui/mirror/agent-rows.js +126 -0
  405. package/packages/daemon/dist/tui/mirror/ansi-palette.js +3 -0
  406. package/packages/daemon/dist/tui/mirror/app-state.js +294 -0
  407. package/packages/daemon/dist/tui/mirror/application-keybindings.js +33 -0
  408. package/packages/daemon/dist/tui/mirror/application-shell-daemon-connection.js +270 -0
  409. package/packages/daemon/dist/tui/mirror/application-shell-daemon-session.js +45 -0
  410. package/packages/daemon/dist/tui/mirror/attention.js +59 -0
  411. package/packages/daemon/dist/tui/mirror/blit.js +120 -0
  412. package/packages/daemon/dist/tui/mirror/canonical-workspace-routing.js +54 -0
  413. package/packages/daemon/dist/tui/mirror/changes-surface-view.jsx +92 -0
  414. package/packages/daemon/dist/tui/mirror/changes-surface.js +210 -0
  415. package/packages/daemon/dist/tui/mirror/composite-layout.js +539 -0
  416. package/packages/daemon/dist/tui/mirror/configless-session-bootstrap.js +134 -0
  417. package/packages/daemon/dist/tui/mirror/dialog-model.js +183 -0
  418. package/packages/daemon/dist/tui/mirror/dialog-stack-core.js +232 -0
  419. package/packages/daemon/dist/tui/mirror/dialog-stack.js +2 -0
  420. package/packages/daemon/dist/tui/mirror/diff-model.js +332 -0
  421. package/packages/daemon/dist/tui/mirror/editor-buffer.js +47 -0
  422. package/packages/daemon/dist/tui/mirror/editor-open-policy.js +9 -0
  423. package/packages/daemon/dist/tui/mirror/features/changes/controller.js +454 -0
  424. package/packages/daemon/dist/tui/mirror/features/changes/feature.jsx +9 -0
  425. package/packages/daemon/dist/tui/mirror/features/dialogs/feature.jsx +123 -0
  426. package/packages/daemon/dist/tui/mirror/features/dialogs/session.js +160 -0
  427. package/packages/daemon/dist/tui/mirror/features/files/feature.jsx +15 -0
  428. package/packages/daemon/dist/tui/mirror/features/files/session.js +617 -0
  429. package/packages/daemon/dist/tui/mirror/features/home/feature.jsx +122 -0
  430. package/packages/daemon/dist/tui/mirror/features/missions-activity/contract.js +3 -0
  431. package/packages/daemon/dist/tui/mirror/features/missions-activity/feature.jsx +5 -0
  432. package/packages/daemon/dist/tui/mirror/features/missions-activity/session.js +377 -0
  433. package/packages/daemon/dist/tui/mirror/features/palette/buffer-geometry.js +36 -0
  434. package/packages/daemon/dist/tui/mirror/features/palette/contract.js +9 -0
  435. package/packages/daemon/dist/tui/mirror/features/palette/feature.js +3 -0
  436. package/packages/daemon/dist/tui/mirror/features/palette/session.js +394 -0
  437. package/packages/daemon/dist/tui/mirror/features/palette/surface.jsx +50 -0
  438. package/packages/daemon/dist/tui/mirror/features/performance-hud/contract.js +1 -0
  439. package/packages/daemon/dist/tui/mirror/features/performance-hud/feature.jsx +2 -0
  440. package/packages/daemon/dist/tui/mirror/features/performance-hud/session.js +148 -0
  441. package/packages/daemon/dist/tui/mirror/features/performance-hud/surface.jsx +64 -0
  442. package/packages/daemon/dist/tui/mirror/features/rich-preview/asset-loader.js +125 -0
  443. package/packages/daemon/dist/tui/mirror/features/rich-preview/contract.js +1 -0
  444. package/packages/daemon/dist/tui/mirror/features/rich-preview/feature.jsx +103 -0
  445. package/packages/daemon/dist/tui/mirror/features/rich-preview/session.js +310 -0
  446. package/packages/daemon/dist/tui/mirror/features/settings/catalog.js +10 -0
  447. package/packages/daemon/dist/tui/mirror/features/settings/contract.js +1 -0
  448. package/packages/daemon/dist/tui/mirror/features/settings/feature.js +2 -0
  449. package/packages/daemon/dist/tui/mirror/features/settings/session.js +309 -0
  450. package/packages/daemon/dist/tui/mirror/file-tree.js +283 -0
  451. package/packages/daemon/dist/tui/mirror/files-surface-view.jsx +92 -0
  452. package/packages/daemon/dist/tui/mirror/files-surface.js +237 -0
  453. package/packages/daemon/dist/tui/mirror/focus-projection.js +80 -0
  454. package/packages/daemon/dist/tui/mirror/folder-picker.js +114 -0
  455. package/packages/daemon/dist/tui/mirror/frame-coalescer.js +74 -0
  456. package/packages/daemon/dist/tui/mirror/home-model.js +125 -0
  457. package/packages/daemon/dist/tui/mirror/home-surface-model.js +297 -0
  458. package/packages/daemon/dist/tui/mirror/home-surface.jsx +110 -0
  459. package/packages/daemon/dist/tui/mirror/hosted.js +239 -0
  460. package/packages/daemon/dist/tui/mirror/input-lifecycle.js +147 -0
  461. package/packages/daemon/dist/tui/mirror/interaction-flow.js +41 -0
  462. package/packages/daemon/dist/tui/mirror/legacy/missions-workspace-loader.js +84 -0
  463. package/packages/daemon/dist/tui/mirror/menu-model.js +143 -0
  464. package/packages/daemon/dist/tui/mirror/missions-dashboard.js +261 -0
  465. package/packages/daemon/dist/tui/mirror/missions-render-fixtures.js +330 -0
  466. package/packages/daemon/dist/tui/mirror/missions-surface-controller.js +314 -0
  467. package/packages/daemon/dist/tui/mirror/missions-surface.jsx +239 -0
  468. package/packages/daemon/dist/tui/mirror/missions-workspace.js +1399 -0
  469. package/packages/daemon/dist/tui/mirror/multiplexer-action-executor.js +252 -0
  470. package/packages/daemon/dist/tui/mirror/open-tui-pane-stream-socket.js +32 -0
  471. package/packages/daemon/dist/tui/mirror/open-tui-verified-routing.js +95 -0
  472. package/packages/daemon/dist/tui/mirror/open-tui-workspace-runtime-port.js +1182 -0
  473. package/packages/daemon/dist/tui/mirror/palette-surface-adapter.js +384 -0
  474. package/packages/daemon/dist/tui/mirror/palette.js +522 -0
  475. package/packages/daemon/dist/tui/mirror/pane-frame-state.js +124 -0
  476. package/packages/daemon/dist/tui/mirror/pane-mirror.js +1 -0
  477. package/packages/daemon/dist/tui/mirror/pane-surface.jsx +950 -0
  478. package/packages/daemon/dist/tui/mirror/panel-host-reactive.js +13 -0
  479. package/packages/daemon/dist/tui/mirror/panel-host.js +242 -0
  480. package/packages/daemon/dist/tui/mirror/perf-tap.js +32 -0
  481. package/packages/daemon/dist/tui/mirror/performance-events.js +46 -0
  482. package/packages/daemon/dist/tui/mirror/recipe-components.jsx +135 -0
  483. package/packages/daemon/dist/tui/mirror/recipes.js +395 -0
  484. package/packages/daemon/dist/tui/mirror/reference-performance-trace.js +598 -0
  485. package/packages/daemon/dist/tui/mirror/renderer-commands.js +250 -0
  486. package/packages/daemon/dist/tui/mirror/resize-model.js +105 -0
  487. package/packages/daemon/dist/tui/mirror/resize-transaction.js +221 -0
  488. package/packages/daemon/dist/tui/mirror/rich-placement-projection.js +80 -0
  489. package/packages/daemon/dist/tui/mirror/runtime/application-appearance-owner.js +176 -0
  490. package/packages/daemon/dist/tui/mirror/runtime/application-bootstrap.js +51 -0
  491. package/packages/daemon/dist/tui/mirror/runtime/application-daemon-authority-owner.js +235 -0
  492. package/packages/daemon/dist/tui/mirror/runtime/application-daemon-authority.js +8 -0
  493. package/packages/daemon/dist/tui/mirror/runtime/application-generation-starter.js +90 -0
  494. package/packages/daemon/dist/tui/mirror/runtime/application-home-agent-navigation.js +86 -0
  495. package/packages/daemon/dist/tui/mirror/runtime/application-home-agent-observer.js +301 -0
  496. package/packages/daemon/dist/tui/mirror/runtime/application-home-agent-roster.jsx +170 -0
  497. package/packages/daemon/dist/tui/mirror/runtime/application-home-agent-selection.js +83 -0
  498. package/packages/daemon/dist/tui/mirror/runtime/application-home-agent-transport.js +199 -0
  499. package/packages/daemon/dist/tui/mirror/runtime/application-home-agents-owner.js +221 -0
  500. package/packages/daemon/dist/tui/mirror/runtime/application-home-agents.js +30 -0
  501. package/packages/daemon/dist/tui/mirror/runtime/application-home-catalog-owner.js +104 -0
  502. package/packages/daemon/dist/tui/mirror/runtime/application-home-catalog.js +329 -0
  503. package/packages/daemon/dist/tui/mirror/runtime/application-host-focus-control-binding.js +111 -0
  504. package/packages/daemon/dist/tui/mirror/runtime/application-host-focus-control-capability.js +25 -0
  505. package/packages/daemon/dist/tui/mirror/runtime/application-host-focus-presentation.js +129 -0
  506. package/packages/daemon/dist/tui/mirror/runtime/application-host-focus-test-control.js +242 -0
  507. package/packages/daemon/dist/tui/mirror/runtime/application-input-readiness.js +20 -0
  508. package/packages/daemon/dist/tui/mirror/runtime/application-lifecycle.js +297 -0
  509. package/packages/daemon/dist/tui/mirror/runtime/application-machine-agent-navigation.js +61 -0
  510. package/packages/daemon/dist/tui/mirror/runtime/application-machine-agents.js +158 -0
  511. package/packages/daemon/dist/tui/mirror/runtime/application-machine-authority.js +289 -0
  512. package/packages/daemon/dist/tui/mirror/runtime/application-machine-catalog.js +223 -0
  513. package/packages/daemon/dist/tui/mirror/runtime/application-machine-navigation.js +164 -0
  514. package/packages/daemon/dist/tui/mirror/runtime/application-machine-sidebar.jsx +215 -0
  515. package/packages/daemon/dist/tui/mirror/runtime/application-machine-startup.js +35 -0
  516. package/packages/daemon/dist/tui/mirror/runtime/application-optional-features.js +12 -0
  517. package/packages/daemon/dist/tui/mirror/runtime/application-palette-command-owner.js +132 -0
  518. package/packages/daemon/dist/tui/mirror/runtime/application-palette-input.js +69 -0
  519. package/packages/daemon/dist/tui/mirror/runtime/application-palette-search-owner.js +67 -0
  520. package/packages/daemon/dist/tui/mirror/runtime/application-pane-activity-owner.js +61 -0
  521. package/packages/daemon/dist/tui/mirror/runtime/application-pane-menu-owner.js +82 -0
  522. package/packages/daemon/dist/tui/mirror/runtime/application-pane-rename-input.js +41 -0
  523. package/packages/daemon/dist/tui/mirror/runtime/application-pane-rename-owner.js +46 -0
  524. package/packages/daemon/dist/tui/mirror/runtime/application-pending-terminal-input.js +74 -0
  525. package/packages/daemon/dist/tui/mirror/runtime/application-performance-log.js +126 -0
  526. package/packages/daemon/dist/tui/mirror/runtime/application-post-render-runtime.js +117 -0
  527. package/packages/daemon/dist/tui/mirror/runtime/application-root-configuration.js +21 -0
  528. package/packages/daemon/dist/tui/mirror/runtime/application-root-renderer.js +160 -0
  529. package/packages/daemon/dist/tui/mirror/runtime/application-session-focus-owner.js +65 -0
  530. package/packages/daemon/dist/tui/mirror/runtime/application-shell-binding.js +313 -0
  531. package/packages/daemon/dist/tui/mirror/runtime/application-shell-home.jsx +113 -0
  532. package/packages/daemon/dist/tui/mirror/runtime/application-shell-viewport.js +14 -0
  533. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-frame-readiness-owner.js +20 -0
  534. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-host-focus-owner.js +25 -0
  535. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-input-ingress.js +102 -0
  536. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-interaction-controller.js +1360 -0
  537. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-palette-owner.js +217 -0
  538. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-paste.js +22 -0
  539. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-renderer-sources.js +31 -0
  540. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-selection-owner.js +217 -0
  541. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-workspace-policy.js +193 -0
  542. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-workspace.jsx +1286 -0
  543. package/packages/daemon/dist/tui/mirror/runtime/application-theme-repaint.js +34 -0
  544. package/packages/daemon/dist/tui/mirror/runtime/application-transient-note-owner.js +29 -0
  545. package/packages/daemon/dist/tui/mirror/runtime/bounded-performance-record-writer.js +67 -0
  546. package/packages/daemon/dist/tui/mirror/runtime/causal-cell-client-ledger.js +281 -0
  547. package/packages/daemon/dist/tui/mirror/runtime/causal-cell-input-fixture.js +43 -0
  548. package/packages/daemon/dist/tui/mirror/runtime/changes-deferred-identity.js +17 -0
  549. package/packages/daemon/dist/tui/mirror/runtime/daemon-authority-rebind.js +128 -0
  550. package/packages/daemon/dist/tui/mirror/runtime/deferred-intent-queue.js +40 -0
  551. package/packages/daemon/dist/tui/mirror/runtime/editor-primitives.js +39 -0
  552. package/packages/daemon/dist/tui/mirror/runtime/file-content-primitives.js +9 -0
  553. package/packages/daemon/dist/tui/mirror/runtime/fleet-lifecycle-client.js +30 -0
  554. package/packages/daemon/dist/tui/mirror/runtime/focus-framebuffer-projection.js +53 -0
  555. package/packages/daemon/dist/tui/mirror/runtime/generation-bound-slot.js +23 -0
  556. package/packages/daemon/dist/tui/mirror/runtime/host-local-tmux-adapter.js +203 -0
  557. package/packages/daemon/dist/tui/mirror/runtime/hosted-tty-size-bridge.js +166 -0
  558. package/packages/daemon/dist/tui/mirror/runtime/latest-intent-fence.js +14 -0
  559. package/packages/daemon/dist/tui/mirror/runtime/local-view-controller.js +58 -0
  560. package/packages/daemon/dist/tui/mirror/runtime/modal-admission-coordinator.js +118 -0
  561. package/packages/daemon/dist/tui/mirror/runtime/modal-pointer-capture.js +12 -0
  562. package/packages/daemon/dist/tui/mirror/runtime/open-tui-generation-host.js +833 -0
  563. package/packages/daemon/dist/tui/mirror/runtime/open-tui-session-owner.js +178 -0
  564. package/packages/daemon/dist/tui/mirror/runtime/optional-feature-registry.js +178 -0
  565. package/packages/daemon/dist/tui/mirror/runtime/optional-feature-registry.typecheck.js +1 -0
  566. package/packages/daemon/dist/tui/mirror/runtime/palette-production-controller.js +126 -0
  567. package/packages/daemon/dist/tui/mirror/runtime/pane-resize-geometry.js +17 -0
  568. package/packages/daemon/dist/tui/mirror/runtime/pane-scoped-terminal-surface.jsx +67 -0
  569. package/packages/daemon/dist/tui/mirror/runtime/product-surface-policy.js +12 -0
  570. package/packages/daemon/dist/tui/mirror/runtime/renderer-cadence.js +7 -0
  571. package/packages/daemon/dist/tui/mirror/runtime/renderer-frame-optimizer.js +88 -0
  572. package/packages/daemon/dist/tui/mirror/runtime/renderer-output-transport.js +56 -0
  573. package/packages/daemon/dist/tui/mirror/runtime/resize-terminal-pane.js +91 -0
  574. package/packages/daemon/dist/tui/mirror/runtime/rich-preview-demand.js +14 -0
  575. package/packages/daemon/dist/tui/mirror/runtime/runtime-layout-presentation.js +111 -0
  576. package/packages/daemon/dist/tui/mirror/runtime/select-terminal-pane.js +90 -0
  577. package/packages/daemon/dist/tui/mirror/runtime/semantic-pane-publication.js +14 -0
  578. package/packages/daemon/dist/tui/mirror/runtime/semantic-shell-viewport-resize.js +56 -0
  579. package/packages/daemon/dist/tui/mirror/runtime/terminal-copy-cursor.js +122 -0
  580. package/packages/daemon/dist/tui/mirror/runtime/terminal-copy-selection.js +65 -0
  581. package/packages/daemon/dist/tui/mirror/runtime/terminal-dimensions-owner.js +9 -0
  582. package/packages/daemon/dist/tui/mirror/runtime/terminal-fast-lane-renderer-adapter.js +911 -0
  583. package/packages/daemon/dist/tui/mirror/runtime/terminal-frame-readiness.js +84 -0
  584. package/packages/daemon/dist/tui/mirror/runtime/terminal-host-focus.js +347 -0
  585. package/packages/daemon/dist/tui/mirror/runtime/terminal-host-frame-diagnostics.js +37 -0
  586. package/packages/daemon/dist/tui/mirror/runtime/terminal-input-adapter.js +50 -0
  587. package/packages/daemon/dist/tui/mirror/runtime/terminal-layout-projection.js +105 -0
  588. package/packages/daemon/dist/tui/mirror/runtime/terminal-link-opener.js +23 -0
  589. package/packages/daemon/dist/tui/mirror/runtime/terminal-links.js +81 -0
  590. package/packages/daemon/dist/tui/mirror/runtime/terminal-pane-input-router.js +83 -0
  591. package/packages/daemon/dist/tui/mirror/runtime/terminal-row-projection-cache.js +88 -0
  592. package/packages/daemon/dist/tui/mirror/runtime/terminal-selection-units.js +123 -0
  593. package/packages/daemon/dist/tui/mirror/runtime/terminal-selection.js +202 -0
  594. package/packages/daemon/dist/tui/mirror/runtime/terminal-session-handoff.js +89 -0
  595. package/packages/daemon/dist/tui/mirror/runtime/terminal-tool-readiness.js +64 -0
  596. package/packages/daemon/dist/tui/mirror/runtime/tool-resource-controller.js +636 -0
  597. package/packages/daemon/dist/tui/mirror/runtime/tool-resource-projection.js +169 -0
  598. package/packages/daemon/dist/tui/mirror/runtime/viewport-fit-coordinator.js +7 -0
  599. package/packages/daemon/dist/tui/mirror/runtime/workspace-terminal-fast-lane.js +498 -0
  600. package/packages/daemon/dist/tui/mirror/scrollbar-model.js +64 -0
  601. package/packages/daemon/dist/tui/mirror/search-model.js +62 -0
  602. package/packages/daemon/dist/tui/mirror/selection.js +264 -0
  603. package/packages/daemon/dist/tui/mirror/semantic-pane-render-source.js +581 -0
  604. package/packages/daemon/dist/tui/mirror/semantic-session-view.js +269 -0
  605. package/packages/daemon/dist/tui/mirror/settings-model.js +304 -0
  606. package/packages/daemon/dist/tui/mirror/shell-chrome.js +313 -0
  607. package/packages/daemon/dist/tui/mirror/size-truth.js +104 -0
  608. package/packages/daemon/dist/tui/mirror/spans.js +31 -0
  609. package/packages/daemon/dist/tui/mirror/status-grammar.js +29 -0
  610. package/packages/daemon/dist/tui/mirror/terminal-native-reflow.js +1 -0
  611. package/packages/daemon/dist/tui/mirror/terminal-retained-row.js +10 -0
  612. package/packages/daemon/dist/tui/mirror/terminal-surface.js +92 -0
  613. package/packages/daemon/dist/tui/mirror/terminal-text.js +52 -0
  614. package/packages/daemon/dist/tui/mirror/terminal-viewport.js +462 -0
  615. package/packages/daemon/dist/tui/mirror/theme.js +765 -0
  616. package/packages/daemon/dist/tui/mirror/ui/agent-badge.jsx +14 -0
  617. package/packages/daemon/dist/tui/mirror/ui/badge.jsx +15 -0
  618. package/packages/daemon/dist/tui/mirror/ui/button.jsx +66 -0
  619. package/packages/daemon/dist/tui/mirror/ui/dialog.jsx +8 -0
  620. package/packages/daemon/dist/tui/mirror/ui/index.js +16 -0
  621. package/packages/daemon/dist/tui/mirror/ui/key-hint.jsx +39 -0
  622. package/packages/daemon/dist/tui/mirror/ui/keyboard-router.jsx +46 -0
  623. package/packages/daemon/dist/tui/mirror/ui/menu.jsx +24 -0
  624. package/packages/daemon/dist/tui/mirror/ui/navigation-row.jsx +62 -0
  625. package/packages/daemon/dist/tui/mirror/ui/overlay-frame.jsx +54 -0
  626. package/packages/daemon/dist/tui/mirror/ui/overlay-host.jsx +33 -0
  627. package/packages/daemon/dist/tui/mirror/ui/overlay-list-row.jsx +29 -0
  628. package/packages/daemon/dist/tui/mirror/ui/overlay-model.js +45 -0
  629. package/packages/daemon/dist/tui/mirror/ui/state.js +171 -0
  630. package/packages/daemon/dist/tui/mirror/ui/status-bar.jsx +102 -0
  631. package/packages/daemon/dist/tui/mirror/ui/surface.jsx +45 -0
  632. package/packages/daemon/dist/tui/mirror/ui/tabs.jsx +88 -0
  633. package/packages/daemon/dist/tui/mirror/widget-fallback.js +52 -0
  634. package/packages/daemon/dist/tui/mirror/widget-surface-model.js +145 -0
  635. package/packages/daemon/dist/tui/mirror/widget-surface.jsx +31 -0
  636. package/packages/daemon/dist/tui/mirror/workspace/agent-terminal-canvas.js +77 -0
  637. package/packages/daemon/dist/tui/mirror/workspace/application-command-description.js +44 -0
  638. package/packages/daemon/dist/tui/mirror/workspace/application-root-controller.js +99 -0
  639. package/packages/daemon/dist/tui/mirror/workspace/application-shell-controller.js +292 -0
  640. package/packages/daemon/dist/tui/mirror/workspace/application-shell-surface-commands.js +28 -0
  641. package/packages/daemon/dist/tui/mirror/workspace/application-shell.js +97 -0
  642. package/packages/daemon/dist/tui/mirror/workspace/command-palette-surface-view.jsx +158 -0
  643. package/packages/daemon/dist/tui/mirror/workspace/command-palette-surface.js +353 -0
  644. package/packages/daemon/dist/tui/mirror/workspace/connection-feedback.js +99 -0
  645. package/packages/daemon/dist/tui/mirror/workspace/icons.js +43 -0
  646. package/packages/daemon/dist/tui/mirror/workspace/pane-action-menu-model.js +8 -0
  647. package/packages/daemon/dist/tui/mirror/workspace/pane-action-menu.jsx +15 -0
  648. package/packages/daemon/dist/tui/mirror/workspace/pane-frame.js +452 -0
  649. package/packages/daemon/dist/tui/mirror/workspace/terminal-pane-chrome.js +555 -0
  650. package/packages/daemon/dist/tui/mirror/workspace/terminal-pane-header.jsx +159 -0
  651. package/packages/daemon/dist/tui/mirror/workspace/terminal-scrollback.js +183 -0
  652. package/packages/daemon/dist/tui/mirror/workspace/terminal-window-strip.jsx +253 -0
  653. package/packages/daemon/dist/tui/mirror/workspace/text.js +27 -0
  654. package/packages/daemon/dist/tui/mirror/workspace/workbench-controller.js +34 -0
  655. package/packages/daemon/dist/tui/mirror/workspace/workbench-shell.js +286 -0
  656. package/packages/daemon/dist/tui/mirror/workspace-ui-state.js +885 -0
  657. package/packages/daemon/dist/tui/readiness.js +34 -0
  658. package/packages/daemon/dist/tui/team/entry.js +20 -0
  659. package/packages/daemon/dist/tui/team/fuzzy.js +141 -0
  660. package/packages/daemon/dist/tui/team/home.js +115 -0
  661. package/packages/daemon/dist/tui/team/input.js +21 -0
  662. package/packages/daemon/dist/tui/team/keymap.js +99 -0
  663. package/packages/daemon/dist/tui/team/mouse.js +17 -0
  664. package/packages/daemon/dist/tui/team/nav.js +33 -0
  665. package/packages/daemon/dist/tui/team/preview.js +35 -0
  666. package/packages/daemon/dist/tui/team/projects.js +159 -0
  667. package/packages/daemon/dist/tui/team/report.js +37 -0
  668. package/packages/daemon/dist/tui/team/sessions.js +292 -0
  669. package/packages/daemon/dist/tui/team/tree.js +42 -0
  670. package/packages/daemon/dist/tui/team/wait-receipts.js +153 -0
  671. package/packages/daemon/dist/tui/team/wait.js +90 -0
  672. package/packages/daemon/dist/validate.js +16 -10
  673. package/packages/daemon/dist/widgets/lib/watcher.js +5 -92
  674. package/packages/daemon/dist/widgets/resolve.js +12 -9
  675. package/packages/daemon/dist/widgets/setup/setup-model.js +7 -9
  676. package/packages/daemon/src/attach.ts +2 -2
  677. package/packages/daemon/src/canonical.ts +19 -2
  678. package/packages/daemon/src/cli.ts +39 -37
  679. package/packages/daemon/src/command-center/actions/command-definitions.ts +91 -0
  680. package/packages/daemon/src/command-center/actions/dispatcher.ts +291 -10
  681. package/packages/daemon/src/command-center/actions/errors.ts +40 -0
  682. package/packages/daemon/src/command-center/actions/handlers/_project-context.ts +4 -5
  683. package/packages/daemon/src/command-center/actions/handlers/app-set-remote-access.ts +9 -1
  684. package/packages/daemon/src/command-center/actions/handlers/app-window-mutate.ts +54 -0
  685. package/packages/daemon/src/command-center/actions/handlers/config-actions.ts +59 -29
  686. package/packages/daemon/src/command-center/actions/handlers/daemon-shutdown.ts +12 -0
  687. package/packages/daemon/src/command-center/actions/handlers/fleet-lifecycle.ts +104 -0
  688. package/packages/daemon/src/command-center/actions/handlers/project-launch.ts +20 -4
  689. package/packages/daemon/src/command-center/actions/handlers/workspace-multiplexer.ts +96 -0
  690. package/packages/daemon/src/command-center/actions/handlers/workspace-open.ts +141 -0
  691. package/packages/daemon/src/command-center/actions/handlers/workspace-pane-create.ts +48 -0
  692. package/packages/daemon/src/command-center/actions/handlers/workspace-promote.ts +48 -0
  693. package/packages/daemon/src/command-center/actions/registry.ts +200 -1
  694. package/packages/daemon/src/command-center/actions/semantic-multiplexer-actions.ts +26 -0
  695. package/packages/daemon/src/command-center/agent-status-watch.ts +222 -0
  696. package/packages/daemon/src/command-center/daemon-fleet-facts-observer.ts +465 -0
  697. package/packages/daemon/src/command-center/discovery.ts +310 -5
  698. package/packages/daemon/src/command-center/owner-authority.ts +118 -0
  699. package/packages/daemon/src/command-center/pane-stream-issue.ts +247 -0
  700. package/packages/daemon/src/command-center/resources/agent-graph-overlay.ts +270 -0
  701. package/packages/daemon/src/command-center/resources/application-shell.ts +909 -0
  702. package/packages/daemon/src/command-center/resources/desktop-missions.ts +171 -0
  703. package/packages/daemon/src/command-center/resources/fleet-catalog.ts +200 -0
  704. package/packages/daemon/src/command-center/resources/fleet-resource-route.ts +69 -0
  705. package/packages/daemon/src/command-center/resources/startup-readiness-route.ts +172 -0
  706. package/packages/daemon/src/command-center/resources/startup-readiness.ts +250 -0
  707. package/packages/daemon/src/command-center/resources/terminal-native-backing-route.ts +104 -0
  708. package/packages/daemon/src/command-center/resources/terminal-runtime-inventory.ts +45 -0
  709. package/packages/daemon/src/command-center/resources/workspace-changes-authority.ts +594 -0
  710. package/packages/daemon/src/command-center/resources/workspace-changes-git.ts +278 -0
  711. package/packages/daemon/src/command-center/resources/workspace-files-authority.ts +583 -0
  712. package/packages/daemon/src/command-center/resources/workspace-missions-route.ts +125 -0
  713. package/packages/daemon/src/command-center/resources/workspace-resource-ids.ts +81 -0
  714. package/packages/daemon/src/command-center/resources/workspace-resource-routes.ts +147 -0
  715. package/packages/daemon/src/command-center/server.ts +732 -59
  716. package/packages/daemon/src/command-center/terminal-attachment-issue.ts +257 -0
  717. package/packages/daemon/src/command-center/workspace-resource-observer.ts +560 -0
  718. package/packages/daemon/src/command-center/ws-events.ts +853 -66
  719. package/packages/daemon/src/config.ts +35 -25
  720. package/packages/daemon/src/control/lifecycle.ts +14 -2
  721. package/packages/daemon/src/control/server.ts +3 -3
  722. package/packages/daemon/src/detect.ts +25 -20
  723. package/packages/daemon/src/doctor.ts +24 -7
  724. package/packages/daemon/src/index.ts +244 -2
  725. package/packages/daemon/src/init.ts +23 -22
  726. package/packages/daemon/src/inspect.ts +41 -8
  727. package/packages/daemon/src/launch.ts +56 -28
  728. package/packages/daemon/src/lib/agent-kind.ts +23 -0
  729. package/packages/daemon/src/lib/app-config.ts +44 -5
  730. package/packages/daemon/src/lib/app-window-kernel.ts +777 -0
  731. package/packages/daemon/src/lib/app-window-mutation.ts +178 -0
  732. package/packages/daemon/src/lib/app-window-repository.ts +650 -0
  733. package/packages/daemon/src/lib/app-window-state.ts +599 -0
  734. package/packages/daemon/src/lib/application-shell-app-windows.ts +357 -0
  735. package/packages/daemon/src/lib/auth/middleware.ts +9 -3
  736. package/packages/daemon/src/lib/bundled-tmux.ts +103 -0
  737. package/packages/daemon/src/lib/canonical-daemon-bootstrap.ts +392 -0
  738. package/packages/daemon/src/lib/canonical-daemon.ts +695 -73
  739. package/packages/daemon/src/lib/chrome-front-door.ts +17 -0
  740. package/packages/daemon/src/lib/cli-action-bridge.ts +127 -91
  741. package/packages/daemon/src/lib/command-registry.ts +152 -0
  742. package/packages/daemon/src/lib/config-context.ts +61 -0
  743. package/packages/daemon/src/lib/daemon-embed.ts +1374 -390
  744. package/packages/daemon/src/lib/daemon-session-monitor.ts +274 -0
  745. package/packages/daemon/src/lib/daemon.ts +3 -46
  746. package/packages/daemon/src/lib/directory-watcher.ts +166 -0
  747. package/packages/daemon/src/lib/embedded-daemon-lifecycle.ts +106 -0
  748. package/packages/daemon/src/lib/environment-identity.ts +82 -0
  749. package/packages/daemon/src/lib/errors.ts +7 -1
  750. package/packages/daemon/src/lib/fleet-agent-lifecycle.ts +74 -0
  751. package/packages/daemon/src/lib/fleet-lifecycle-authority.ts +535 -0
  752. package/packages/daemon/src/lib/headless-daemon.ts +459 -0
  753. package/packages/daemon/src/lib/launch-plan.ts +123 -4
  754. package/packages/daemon/src/lib/legacy-config-adapter.ts +28 -0
  755. package/packages/daemon/src/lib/legacy-config-migration.ts +145 -0
  756. package/packages/daemon/src/lib/legacy-theme-compat.ts +40 -0
  757. package/packages/daemon/src/lib/mission-projections.ts +775 -0
  758. package/packages/daemon/src/lib/mission-repository.ts +1311 -0
  759. package/packages/daemon/src/lib/onboarding-marker.ts +51 -0
  760. package/packages/daemon/src/lib/pane-chrome.ts +14 -0
  761. package/packages/daemon/src/lib/pane-source-credentials.ts +200 -0
  762. package/packages/daemon/src/lib/pane-widget.ts +182 -0
  763. package/packages/daemon/src/lib/project-inspect.ts +4 -0
  764. package/packages/daemon/src/lib/project-onboard.ts +19 -24
  765. package/packages/daemon/src/lib/project-probe.ts +38 -30
  766. package/packages/daemon/src/lib/project-readiness-probe.ts +578 -0
  767. package/packages/daemon/src/lib/project-readiness.ts +1034 -0
  768. package/packages/daemon/src/lib/project-registry.ts +45 -9
  769. package/packages/daemon/src/lib/project-resolver.ts +350 -0
  770. package/packages/daemon/src/lib/project-runtime-errors.ts +41 -0
  771. package/packages/daemon/src/lib/project-runtime-repository.ts +1194 -0
  772. package/packages/daemon/src/lib/remote-daemon-info.ts +42 -0
  773. package/packages/daemon/src/lib/resolved-config.ts +425 -0
  774. package/packages/daemon/src/lib/runtime-namespace.ts +186 -0
  775. package/packages/daemon/src/lib/saved-machines.ts +63 -0
  776. package/packages/daemon/src/lib/semantic-resource-id.ts +17 -0
  777. package/packages/daemon/src/lib/session-monitor.ts +28 -20
  778. package/packages/daemon/src/lib/session-options.ts +3 -10
  779. package/packages/daemon/src/lib/ssh-daemon-transport.ts +303 -0
  780. package/packages/daemon/src/lib/state-home.ts +2 -3
  781. package/packages/daemon/src/lib/theme-mode.ts +11 -0
  782. package/packages/daemon/src/lib/tmux-authority-replacement.ts +119 -0
  783. package/packages/daemon/src/lib/tmux-external-interaction-observer.ts +632 -0
  784. package/packages/daemon/src/lib/tmux-interaction-options.ts +171 -0
  785. package/packages/daemon/src/lib/tmux-named-socket-fence.ts +66 -0
  786. package/packages/daemon/src/lib/tmux-terminal-color.ts +44 -0
  787. package/packages/daemon/src/lib/tui-binary.ts +354 -34
  788. package/packages/daemon/src/lib/unix-socket-authority.ts +65 -0
  789. package/packages/daemon/src/lib/widget-asset-policy.ts +3 -0
  790. package/packages/daemon/src/lib/widget-asset-store.ts +218 -0
  791. package/packages/daemon/src/lib/workspace-config-loader.ts +378 -0
  792. package/packages/daemon/src/lib/workspace-multiplexer-verbs.ts +1362 -0
  793. package/packages/daemon/src/lib/workspace-open-handoff.ts +340 -0
  794. package/packages/daemon/src/lib/workspace-open.ts +983 -0
  795. package/packages/daemon/src/lib/workspace-pane-creation.ts +1434 -0
  796. package/packages/daemon/src/lib/workspace-promotion.ts +1035 -0
  797. package/packages/daemon/src/lib/workspace-registry.ts +193 -25
  798. package/packages/daemon/src/lib/workspace-state-repository.ts +1204 -0
  799. package/packages/daemon/src/lib/workspace-state.ts +960 -0
  800. package/packages/daemon/src/lib/yaml-io.ts +8 -17
  801. package/packages/daemon/src/migrate.ts +134 -0
  802. package/packages/daemon/src/restart.ts +2 -2
  803. package/packages/daemon/src/restore.ts +14 -9
  804. package/packages/daemon/src/schemas/inspect.ts +9 -1
  805. package/packages/daemon/src/schemas/registry.ts +12 -22
  806. package/packages/daemon/src/schemas/ws-events.ts +14 -131
  807. package/packages/daemon/src/send.ts +138 -3
  808. package/packages/daemon/src/server/README.md +1 -1
  809. package/packages/daemon/src/server/index.ts +6 -2
  810. package/packages/daemon/src/server/pane-stream-upgrade.ts +141 -0
  811. package/packages/daemon/src/server/terminal-attachment-upgrade.ts +153 -0
  812. package/packages/daemon/src/status.ts +13 -8
  813. package/packages/daemon/src/stop.ts +2 -2
  814. package/packages/daemon/src/terminal/MonotonicPtyInput.ts +153 -0
  815. package/packages/daemon/src/terminal/NodePtyAdapter.ts +53 -11
  816. package/packages/daemon/src/terminal/PtyAdapter.ts +111 -3
  817. package/packages/daemon/src/terminal/README.md +34 -16
  818. package/packages/daemon/src/terminal/attachments/admission-util.ts +97 -0
  819. package/packages/daemon/src/terminal/attachments/agent-status-probe.ts +474 -0
  820. package/packages/daemon/src/terminal/attachments/direct-websocket.ts +1482 -0
  821. package/packages/daemon/src/terminal/attachments/grouped-tmux.ts +293 -0
  822. package/packages/daemon/src/terminal/attachments/lease-manager.ts +1042 -0
  823. package/packages/daemon/src/terminal/attachments/native-runtime.ts +2246 -0
  824. package/packages/daemon/src/terminal/attachments/pty-tmux-attachment-launcher.ts +750 -0
  825. package/packages/daemon/src/terminal/attachments/semantic-pane-catalog.ts +365 -0
  826. package/packages/daemon/src/terminal/attachments/tmux-view-executor.ts +1095 -0
  827. package/packages/daemon/src/terminal/mirror/control-channel.ts +1031 -0
  828. package/packages/daemon/src/terminal/mirror/control-mode-ownership.ts +34 -0
  829. package/packages/daemon/src/terminal/mirror/events.ts +164 -0
  830. package/packages/daemon/src/terminal/mirror/flow-ledger.ts +65 -0
  831. package/packages/daemon/src/terminal/mirror/mirror-service.ts +503 -0
  832. package/packages/daemon/src/terminal/mirror/native-frozen-grid.ts +154 -0
  833. package/packages/daemon/src/terminal/mirror/native-grid-capture.ts +235 -0
  834. package/packages/daemon/src/terminal/mirror/native-grid-projection.ts +125 -0
  835. package/packages/daemon/src/terminal/mirror/native-grid-reader.ts +109 -0
  836. package/packages/daemon/src/terminal/mirror/native-grid-reflow.ts +241 -0
  837. package/packages/daemon/src/terminal/mirror/pane-feed.ts +272 -0
  838. package/packages/daemon/src/terminal/mirror/session-channel.ts +3378 -0
  839. package/packages/daemon/src/terminal/mirror/trusted-inventory.ts +29 -0
  840. package/packages/daemon/src/terminal/pane-stream/lease-manager.ts +375 -0
  841. package/packages/daemon/src/terminal/pane-stream/pane-stream-websocket.ts +2625 -0
  842. package/packages/daemon/src/terminal/pane-stream/runtime.ts +78 -0
  843. package/packages/daemon/src/terminal/pane-stream/wire-ledger.ts +155 -0
  844. package/packages/daemon/src/terminal/protocol/README.md +14 -0
  845. package/packages/daemon/src/terminal/protocol/chunk-bytes.ts +20 -0
  846. package/packages/daemon/src/terminal/protocol/control.ts +130 -0
  847. package/packages/daemon/src/terminal/protocol/input-coalescer.ts +131 -0
  848. package/packages/daemon/src/terminal/protocol/native-backing-client.ts +65 -0
  849. package/packages/daemon/src/terminal/protocol/pane-display-name.ts +192 -0
  850. package/packages/daemon/src/terminal/protocol/session-descriptor-discovery.ts +382 -0
  851. package/packages/daemon/src/terminal/protocol/workspace-tmux-adapter.ts +470 -0
  852. package/packages/daemon/src/terminal/session-runtime/authority-arbiter.ts +318 -0
  853. package/packages/daemon/src/terminal/session-runtime/causal-cell-ledger.ts +359 -0
  854. package/packages/daemon/src/terminal/session-runtime/interaction-receipt-facts.ts +173 -0
  855. package/packages/daemon/src/terminal/session-runtime/multiplexer-backend.ts +194 -0
  856. package/packages/daemon/src/terminal/session-runtime/native-seed-backing.ts +80 -0
  857. package/packages/daemon/src/terminal/session-runtime/registry.ts +2084 -0
  858. package/packages/daemon/src/terminal/session-runtime/runtime-observability.ts +267 -0
  859. package/packages/daemon/src/terminal/session-runtime/runtime-scheduler.ts +30 -0
  860. package/packages/daemon/src/terminal/session-runtime/runtime-trace-correlator.ts +58 -0
  861. package/packages/daemon/src/terminal/session-runtime/semantic-mutation-executor.ts +555 -0
  862. package/packages/daemon/src/terminal/session-runtime/semantic-mutation-resource-changes.ts +48 -0
  863. package/packages/daemon/src/terminal/session-runtime/terminal-delivery-hub.ts +2324 -0
  864. package/packages/daemon/src/terminal/session-runtime/terminal-delivery-observation-identity.ts +18 -0
  865. package/packages/daemon/src/terminal/session-runtime/terminal-interpreter-backend.ts +78 -0
  866. package/packages/daemon/src/terminal/session-runtime/terminal-replica-interpreter.ts +765 -0
  867. package/packages/daemon/src/terminal/session-runtime/terminal-replica-owner.ts +698 -0
  868. package/packages/daemon/src/terminal/session-runtime/terminal-replica-shadow-projections.ts +36 -0
  869. package/packages/daemon/src/terminal/session-runtime/transport-binding.ts +682 -0
  870. package/packages/daemon/src/terminal/session-runtime/xterm-headless-provenance.json +51 -0
  871. package/packages/daemon/src/terminal/session-runtime/xterm-terminal-interpreter-backend.ts +697 -0
  872. package/packages/daemon/src/tui/async-disposable-slot.ts +60 -0
  873. package/packages/daemon/src/tui/chrome/front-door.ts +11 -23
  874. package/packages/daemon/src/tui/chrome/sidebar.ts +11 -5
  875. package/packages/daemon/src/tui/chrome/statusline.ts +15 -6
  876. package/packages/daemon/src/tui/chrome/updater.ts +100 -3
  877. package/packages/daemon/src/tui/compiled.ts +132 -6
  878. package/packages/daemon/src/tui/detect/agent-resolution.ts +85 -0
  879. package/packages/daemon/src/tui/detect/process-tree.ts +17 -1
  880. package/packages/daemon/src/tui/detect/snapshot.ts +38 -3
  881. package/packages/daemon/src/tui/integrations/claude.ts +1 -0
  882. package/packages/daemon/src/tui/main.ts +56 -0
  883. package/packages/daemon/src/tui/mirror/RECIPES.md +59 -0
  884. package/packages/daemon/src/tui/mirror/SHELL_CHROME.md +39 -0
  885. package/packages/daemon/src/tui/mirror/THEME.md +48 -0
  886. package/packages/daemon/src/tui/mirror/__snapshots__/activity-surface-renderer.test.tsx.snap +42 -0
  887. package/packages/daemon/src/tui/mirror/__snapshots__/changes-terminal-surface-renderer.test.tsx.snap +267 -0
  888. package/packages/daemon/src/tui/mirror/__snapshots__/home-files-surface-renderer.test.tsx.snap +267 -0
  889. package/packages/daemon/src/tui/mirror/__snapshots__/missions-surface-renderer.test.tsx.snap +134 -0
  890. package/packages/daemon/src/tui/mirror/__snapshots__/recipes-gallery-renderer.test.tsx.snap +141 -0
  891. package/packages/daemon/src/tui/mirror/__snapshots__/shell-chrome-renderer.test.tsx.snap +134 -0
  892. package/packages/daemon/src/tui/mirror/activity-surface-view.tsx +169 -0
  893. package/packages/daemon/src/tui/mirror/activity-surface.ts +430 -0
  894. package/packages/daemon/src/tui/mirror/agent-lifecycle.ts +36 -5
  895. package/packages/daemon/src/tui/mirror/agent-provisioning-executor.ts +175 -0
  896. package/packages/daemon/src/tui/mirror/agent-rows.ts +34 -0
  897. package/packages/daemon/src/tui/mirror/ansi-palette.ts +3 -0
  898. package/packages/daemon/src/tui/mirror/app-state.ts +14 -1
  899. package/packages/daemon/src/tui/mirror/app.tsx +2 -7047
  900. package/packages/daemon/src/tui/mirror/application-keybindings.ts +54 -0
  901. package/packages/daemon/src/tui/mirror/application-shell-daemon-connection.ts +370 -0
  902. package/packages/daemon/src/tui/mirror/application-shell-daemon-session.ts +74 -0
  903. package/packages/daemon/src/tui/mirror/canonical-workspace-routing.ts +90 -0
  904. package/packages/daemon/src/tui/mirror/changes-surface-view.tsx +263 -0
  905. package/packages/daemon/src/tui/mirror/changes-surface.ts +338 -0
  906. package/packages/daemon/src/tui/mirror/composite-layout.ts +710 -0
  907. package/packages/daemon/src/tui/mirror/configless-session-bootstrap.ts +192 -0
  908. package/packages/daemon/src/tui/mirror/dialog-model.ts +2 -2
  909. package/packages/daemon/src/tui/mirror/dialog-stack-core.ts +264 -0
  910. package/packages/daemon/src/tui/mirror/dialog-stack.ts +2 -367
  911. package/packages/daemon/src/tui/mirror/editor-buffer.ts +9 -70
  912. package/packages/daemon/src/tui/mirror/editor-open-policy.ts +16 -0
  913. package/packages/daemon/src/tui/mirror/features/changes/contract.ts +84 -0
  914. package/packages/daemon/src/tui/mirror/features/changes/controller.ts +470 -0
  915. package/packages/daemon/src/tui/mirror/features/changes/feature.tsx +19 -0
  916. package/packages/daemon/src/tui/mirror/features/dialogs/contract.ts +64 -0
  917. package/packages/daemon/src/tui/mirror/features/dialogs/feature.tsx +227 -0
  918. package/packages/daemon/src/tui/mirror/features/dialogs/session.ts +186 -0
  919. package/packages/daemon/src/tui/mirror/features/files/feature.tsx +54 -0
  920. package/packages/daemon/src/tui/mirror/features/files/session.ts +694 -0
  921. package/packages/daemon/src/tui/mirror/features/home/feature.tsx +172 -0
  922. package/packages/daemon/src/tui/mirror/features/missions-activity/contract.ts +106 -0
  923. package/packages/daemon/src/tui/mirror/features/missions-activity/feature.tsx +19 -0
  924. package/packages/daemon/src/tui/mirror/features/missions-activity/session.ts +470 -0
  925. package/packages/daemon/src/tui/mirror/features/palette/buffer-geometry.ts +46 -0
  926. package/packages/daemon/src/tui/mirror/features/palette/contract.ts +121 -0
  927. package/packages/daemon/src/tui/mirror/features/palette/feature.ts +14 -0
  928. package/packages/daemon/src/tui/mirror/features/palette/session.ts +443 -0
  929. package/packages/daemon/src/tui/mirror/features/palette/surface.tsx +133 -0
  930. package/packages/daemon/src/tui/mirror/features/performance-hud/contract.ts +20 -0
  931. package/packages/daemon/src/tui/mirror/features/performance-hud/feature.tsx +8 -0
  932. package/packages/daemon/src/tui/mirror/features/performance-hud/session.ts +152 -0
  933. package/packages/daemon/src/tui/mirror/features/performance-hud/surface.tsx +137 -0
  934. package/packages/daemon/src/tui/mirror/features/rich-preview/asset-loader.ts +153 -0
  935. package/packages/daemon/src/tui/mirror/features/rich-preview/contract.ts +94 -0
  936. package/packages/daemon/src/tui/mirror/features/rich-preview/feature.tsx +141 -0
  937. package/packages/daemon/src/tui/mirror/features/rich-preview/session.ts +387 -0
  938. package/packages/daemon/src/tui/mirror/features/settings/catalog.ts +26 -0
  939. package/packages/daemon/src/tui/mirror/features/settings/contract.ts +41 -0
  940. package/packages/daemon/src/tui/mirror/features/settings/feature.ts +3 -0
  941. package/packages/daemon/src/tui/mirror/features/settings/session.ts +375 -0
  942. package/packages/daemon/src/tui/mirror/files-surface-view.tsx +242 -0
  943. package/packages/daemon/src/tui/mirror/files-surface.ts +371 -0
  944. package/packages/daemon/src/tui/mirror/focus-projection.ts +113 -0
  945. package/packages/daemon/src/tui/mirror/frame-coalescer.ts +87 -0
  946. package/packages/daemon/src/tui/mirror/home-model.ts +1 -1
  947. package/packages/daemon/src/tui/mirror/home-surface-model.ts +440 -0
  948. package/packages/daemon/src/tui/mirror/home-surface.tsx +254 -0
  949. package/packages/daemon/src/tui/mirror/hosted.ts +87 -6
  950. package/packages/daemon/src/tui/mirror/input-lifecycle.ts +248 -0
  951. package/packages/daemon/src/tui/mirror/interaction-flow.ts +83 -0
  952. package/packages/daemon/src/tui/mirror/legacy/missions-workspace-loader.ts +117 -0
  953. package/packages/daemon/src/tui/mirror/menu-model.ts +1 -14
  954. package/packages/daemon/src/tui/mirror/missions-dashboard.ts +451 -0
  955. package/packages/daemon/src/tui/mirror/missions-render-fixtures.ts +371 -0
  956. package/packages/daemon/src/tui/mirror/missions-surface-controller.ts +530 -0
  957. package/packages/daemon/src/tui/mirror/missions-surface.tsx +434 -0
  958. package/packages/daemon/src/tui/mirror/missions-workspace.ts +1996 -0
  959. package/packages/daemon/src/tui/mirror/multiplexer-action-executor.ts +393 -0
  960. package/packages/daemon/src/tui/mirror/open-tui-pane-stream-socket.ts +47 -0
  961. package/packages/daemon/src/tui/mirror/open-tui-verified-routing.ts +152 -0
  962. package/packages/daemon/src/tui/mirror/open-tui-workspace-runtime-port.ts +1451 -0
  963. package/packages/daemon/src/tui/mirror/palette-surface-adapter.ts +465 -0
  964. package/packages/daemon/src/tui/mirror/palette.ts +189 -28
  965. package/packages/daemon/src/tui/mirror/pane-frame-state.ts +209 -0
  966. package/packages/daemon/src/tui/mirror/pane-mirror.ts +11 -593
  967. package/packages/daemon/src/tui/mirror/pane-surface.tsx +858 -53
  968. package/packages/daemon/src/tui/mirror/panel-host-reactive.ts +17 -0
  969. package/packages/daemon/src/tui/mirror/panel-host.ts +384 -0
  970. package/packages/daemon/src/tui/mirror/perf-tap.ts +1 -148
  971. package/packages/daemon/src/tui/mirror/performance-events.ts +494 -0
  972. package/packages/daemon/src/tui/mirror/recipe-components.tsx +310 -0
  973. package/packages/daemon/src/tui/mirror/recipes-gallery.tsx +256 -0
  974. package/packages/daemon/src/tui/mirror/recipes.ts +543 -0
  975. package/packages/daemon/src/tui/mirror/reference-performance-trace.ts +727 -0
  976. package/packages/daemon/src/tui/mirror/renderer-commands.ts +344 -0
  977. package/packages/daemon/src/tui/mirror/resize-model.ts +74 -9
  978. package/packages/daemon/src/tui/mirror/resize-transaction.ts +342 -0
  979. package/packages/daemon/src/tui/mirror/rich-placement-projection.ts +173 -0
  980. package/packages/daemon/src/tui/mirror/runtime/__snapshots__/application-shell-view-renderer.test.tsx.snap +87 -0
  981. package/packages/daemon/src/tui/mirror/runtime/application-add-machine-dialog.tsx +88 -0
  982. package/packages/daemon/src/tui/mirror/runtime/application-appearance-owner.ts +229 -0
  983. package/packages/daemon/src/tui/mirror/runtime/application-bootstrap.ts +118 -0
  984. package/packages/daemon/src/tui/mirror/runtime/application-daemon-authority-owner.ts +259 -0
  985. package/packages/daemon/src/tui/mirror/runtime/application-daemon-authority.ts +16 -0
  986. package/packages/daemon/src/tui/mirror/runtime/application-entry.ts +226 -0
  987. package/packages/daemon/src/tui/mirror/runtime/application-generation-starter.ts +130 -0
  988. package/packages/daemon/src/tui/mirror/runtime/application-home-agent-navigation.ts +174 -0
  989. package/packages/daemon/src/tui/mirror/runtime/application-home-agent-observer.ts +363 -0
  990. package/packages/daemon/src/tui/mirror/runtime/application-home-agent-roster.tsx +276 -0
  991. package/packages/daemon/src/tui/mirror/runtime/application-home-agent-selection.ts +99 -0
  992. package/packages/daemon/src/tui/mirror/runtime/application-home-agent-transport.ts +232 -0
  993. package/packages/daemon/src/tui/mirror/runtime/application-home-agents-owner.ts +295 -0
  994. package/packages/daemon/src/tui/mirror/runtime/application-home-agents.ts +70 -0
  995. package/packages/daemon/src/tui/mirror/runtime/application-home-catalog-owner.ts +130 -0
  996. package/packages/daemon/src/tui/mirror/runtime/application-home-catalog.ts +451 -0
  997. package/packages/daemon/src/tui/mirror/runtime/application-host-focus-control-binding.ts +143 -0
  998. package/packages/daemon/src/tui/mirror/runtime/application-host-focus-control-capability.ts +46 -0
  999. package/packages/daemon/src/tui/mirror/runtime/application-host-focus-presentation.ts +176 -0
  1000. package/packages/daemon/src/tui/mirror/runtime/application-host-focus-test-control.ts +313 -0
  1001. package/packages/daemon/src/tui/mirror/runtime/application-input-readiness.ts +28 -0
  1002. package/packages/daemon/src/tui/mirror/runtime/application-lifecycle.ts +374 -0
  1003. package/packages/daemon/src/tui/mirror/runtime/application-machine-agent-navigation.ts +91 -0
  1004. package/packages/daemon/src/tui/mirror/runtime/application-machine-agents.ts +199 -0
  1005. package/packages/daemon/src/tui/mirror/runtime/application-machine-authority.ts +337 -0
  1006. package/packages/daemon/src/tui/mirror/runtime/application-machine-catalog.ts +256 -0
  1007. package/packages/daemon/src/tui/mirror/runtime/application-machine-navigation.ts +177 -0
  1008. package/packages/daemon/src/tui/mirror/runtime/application-machine-sidebar.tsx +356 -0
  1009. package/packages/daemon/src/tui/mirror/runtime/application-machine-startup.ts +39 -0
  1010. package/packages/daemon/src/tui/mirror/runtime/application-optional-features.ts +25 -0
  1011. package/packages/daemon/src/tui/mirror/runtime/application-palette-command-owner.ts +162 -0
  1012. package/packages/daemon/src/tui/mirror/runtime/application-palette-input.ts +108 -0
  1013. package/packages/daemon/src/tui/mirror/runtime/application-palette-search-owner.ts +78 -0
  1014. package/packages/daemon/src/tui/mirror/runtime/application-pane-activity-owner.ts +79 -0
  1015. package/packages/daemon/src/tui/mirror/runtime/application-pane-menu-owner.ts +95 -0
  1016. package/packages/daemon/src/tui/mirror/runtime/application-pane-rename-input.ts +61 -0
  1017. package/packages/daemon/src/tui/mirror/runtime/application-pane-rename-owner.ts +50 -0
  1018. package/packages/daemon/src/tui/mirror/runtime/application-pending-terminal-input.ts +117 -0
  1019. package/packages/daemon/src/tui/mirror/runtime/application-performance-log.ts +166 -0
  1020. package/packages/daemon/src/tui/mirror/runtime/application-post-render-runtime.ts +163 -0
  1021. package/packages/daemon/src/tui/mirror/runtime/application-root-configuration.ts +47 -0
  1022. package/packages/daemon/src/tui/mirror/runtime/application-root-renderer.ts +165 -0
  1023. package/packages/daemon/src/tui/mirror/runtime/application-root-v2.tsx +632 -0
  1024. package/packages/daemon/src/tui/mirror/runtime/application-session-focus-owner.ts +80 -0
  1025. package/packages/daemon/src/tui/mirror/runtime/application-shell-binding.ts +375 -0
  1026. package/packages/daemon/src/tui/mirror/runtime/application-shell-catalog.tsx +448 -0
  1027. package/packages/daemon/src/tui/mirror/runtime/application-shell-home.tsx +252 -0
  1028. package/packages/daemon/src/tui/mirror/runtime/application-shell-overlay-stack.tsx +37 -0
  1029. package/packages/daemon/src/tui/mirror/runtime/application-shell-overlays.tsx +381 -0
  1030. package/packages/daemon/src/tui/mirror/runtime/application-shell-sidebar.tsx +188 -0
  1031. package/packages/daemon/src/tui/mirror/runtime/application-shell-view.tsx +537 -0
  1032. package/packages/daemon/src/tui/mirror/runtime/application-shell-viewport.ts +18 -0
  1033. package/packages/daemon/src/tui/mirror/runtime/application-terminal-frame-readiness-owner.ts +33 -0
  1034. package/packages/daemon/src/tui/mirror/runtime/application-terminal-host-focus-owner.ts +36 -0
  1035. package/packages/daemon/src/tui/mirror/runtime/application-terminal-input-ingress.ts +139 -0
  1036. package/packages/daemon/src/tui/mirror/runtime/application-terminal-interaction-controller.ts +1673 -0
  1037. package/packages/daemon/src/tui/mirror/runtime/application-terminal-palette-owner.ts +302 -0
  1038. package/packages/daemon/src/tui/mirror/runtime/application-terminal-paste.ts +33 -0
  1039. package/packages/daemon/src/tui/mirror/runtime/application-terminal-renderer-sources.ts +33 -0
  1040. package/packages/daemon/src/tui/mirror/runtime/application-terminal-selection-owner.ts +277 -0
  1041. package/packages/daemon/src/tui/mirror/runtime/application-terminal-workspace-policy.ts +311 -0
  1042. package/packages/daemon/src/tui/mirror/runtime/application-terminal-workspace.tsx +1921 -0
  1043. package/packages/daemon/src/tui/mirror/runtime/application-theme-repaint.ts +45 -0
  1044. package/packages/daemon/src/tui/mirror/runtime/application-transient-note-owner.ts +42 -0
  1045. package/packages/daemon/src/tui/mirror/runtime/bounded-performance-record-writer.ts +75 -0
  1046. package/packages/daemon/src/tui/mirror/runtime/causal-cell-client-ledger.ts +406 -0
  1047. package/packages/daemon/src/tui/mirror/runtime/causal-cell-input-fixture.ts +55 -0
  1048. package/packages/daemon/src/tui/mirror/runtime/changes-deferred-identity.ts +34 -0
  1049. package/packages/daemon/src/tui/mirror/runtime/daemon-authority-rebind.ts +163 -0
  1050. package/packages/daemon/src/tui/mirror/runtime/deferred-intent-queue.ts +45 -0
  1051. package/packages/daemon/src/tui/mirror/runtime/editor-primitives.ts +56 -0
  1052. package/packages/daemon/src/tui/mirror/runtime/file-content-primitives.ts +8 -0
  1053. package/packages/daemon/src/tui/mirror/runtime/fleet-lifecycle-client.ts +67 -0
  1054. package/packages/daemon/src/tui/mirror/runtime/focus-framebuffer-projection.ts +71 -0
  1055. package/packages/daemon/src/tui/mirror/runtime/generation-bound-slot.ts +23 -0
  1056. package/packages/daemon/src/tui/mirror/runtime/host-local-tmux-adapter.ts +233 -0
  1057. package/packages/daemon/src/tui/mirror/runtime/hosted-tty-size-bridge.ts +213 -0
  1058. package/packages/daemon/src/tui/mirror/runtime/latest-intent-fence.ts +22 -0
  1059. package/packages/daemon/src/tui/mirror/runtime/local-view-controller.ts +95 -0
  1060. package/packages/daemon/src/tui/mirror/runtime/modal-admission-coordinator.ts +158 -0
  1061. package/packages/daemon/src/tui/mirror/runtime/modal-pointer-capture.ts +23 -0
  1062. package/packages/daemon/src/tui/mirror/runtime/open-tui-generation-host.ts +1003 -0
  1063. package/packages/daemon/src/tui/mirror/runtime/open-tui-session-owner.ts +229 -0
  1064. package/packages/daemon/src/tui/mirror/runtime/optional-feature-registry.ts +234 -0
  1065. package/packages/daemon/src/tui/mirror/runtime/optional-feature-registry.typecheck.ts +14 -0
  1066. package/packages/daemon/src/tui/mirror/runtime/palette-production-controller.ts +170 -0
  1067. package/packages/daemon/src/tui/mirror/runtime/palette-production-overlay.tsx +65 -0
  1068. package/packages/daemon/src/tui/mirror/runtime/pane-resize-geometry.ts +29 -0
  1069. package/packages/daemon/src/tui/mirror/runtime/pane-scoped-terminal-surface.tsx +156 -0
  1070. package/packages/daemon/src/tui/mirror/runtime/product-surface-policy.ts +16 -0
  1071. package/packages/daemon/src/tui/mirror/runtime/renderer-cadence.ts +7 -0
  1072. package/packages/daemon/src/tui/mirror/runtime/renderer-frame-optimizer.ts +92 -0
  1073. package/packages/daemon/src/tui/mirror/runtime/renderer-output-transport.ts +57 -0
  1074. package/packages/daemon/src/tui/mirror/runtime/resize-terminal-pane.ts +134 -0
  1075. package/packages/daemon/src/tui/mirror/runtime/rich-preview-demand.ts +26 -0
  1076. package/packages/daemon/src/tui/mirror/runtime/rich-preview-overlay.tsx +54 -0
  1077. package/packages/daemon/src/tui/mirror/runtime/runtime-layout-presentation.ts +119 -0
  1078. package/packages/daemon/src/tui/mirror/runtime/select-terminal-pane.ts +127 -0
  1079. package/packages/daemon/src/tui/mirror/runtime/semantic-pane-publication.ts +26 -0
  1080. package/packages/daemon/src/tui/mirror/runtime/semantic-shell-viewport-resize.ts +88 -0
  1081. package/packages/daemon/src/tui/mirror/runtime/terminal-copy-cursor.ts +169 -0
  1082. package/packages/daemon/src/tui/mirror/runtime/terminal-copy-selection.ts +79 -0
  1083. package/packages/daemon/src/tui/mirror/runtime/terminal-dimensions-owner.ts +20 -0
  1084. package/packages/daemon/src/tui/mirror/runtime/terminal-fast-lane-renderer-adapter.ts +1085 -0
  1085. package/packages/daemon/src/tui/mirror/runtime/terminal-frame-readiness.ts +100 -0
  1086. package/packages/daemon/src/tui/mirror/runtime/terminal-host-focus.ts +519 -0
  1087. package/packages/daemon/src/tui/mirror/runtime/terminal-host-frame-diagnostics.ts +47 -0
  1088. package/packages/daemon/src/tui/mirror/runtime/terminal-input-adapter.ts +69 -0
  1089. package/packages/daemon/src/tui/mirror/runtime/terminal-layout-projection.ts +145 -0
  1090. package/packages/daemon/src/tui/mirror/runtime/terminal-link-opener.ts +30 -0
  1091. package/packages/daemon/src/tui/mirror/runtime/terminal-links.ts +97 -0
  1092. package/packages/daemon/src/tui/mirror/runtime/terminal-pane-input-router.ts +95 -0
  1093. package/packages/daemon/src/tui/mirror/runtime/terminal-row-projection-cache.ts +115 -0
  1094. package/packages/daemon/src/tui/mirror/runtime/terminal-selection-units.ts +128 -0
  1095. package/packages/daemon/src/tui/mirror/runtime/terminal-selection.ts +285 -0
  1096. package/packages/daemon/src/tui/mirror/runtime/terminal-session-handoff.ts +143 -0
  1097. package/packages/daemon/src/tui/mirror/runtime/terminal-tool-readiness.ts +72 -0
  1098. package/packages/daemon/src/tui/mirror/runtime/tool-resource-controller.ts +799 -0
  1099. package/packages/daemon/src/tui/mirror/runtime/tool-resource-projection.ts +223 -0
  1100. package/packages/daemon/src/tui/mirror/runtime/viewport-fit-coordinator.ts +12 -0
  1101. package/packages/daemon/src/tui/mirror/runtime/workspace-terminal-fast-lane.ts +597 -0
  1102. package/packages/daemon/src/tui/mirror/selection.ts +0 -21
  1103. package/packages/daemon/src/tui/mirror/semantic-pane-render-source.ts +786 -0
  1104. package/packages/daemon/src/tui/mirror/semantic-session-view.ts +366 -0
  1105. package/packages/daemon/src/tui/mirror/settings-model.ts +24 -66
  1106. package/packages/daemon/src/tui/mirror/shell-chrome-view.tsx +346 -0
  1107. package/packages/daemon/src/tui/mirror/shell-chrome.ts +509 -0
  1108. package/packages/daemon/src/tui/mirror/sidebar.tsx +138 -35
  1109. package/packages/daemon/src/tui/mirror/size-truth.ts +1 -1
  1110. package/packages/daemon/src/tui/mirror/terminal-native-reflow.ts +1 -0
  1111. package/packages/daemon/src/tui/mirror/terminal-retained-row.ts +24 -0
  1112. package/packages/daemon/src/tui/mirror/terminal-surface.ts +157 -0
  1113. package/packages/daemon/src/tui/mirror/terminal-surface.tsx +84 -0
  1114. package/packages/daemon/src/tui/mirror/terminal-text.ts +54 -0
  1115. package/packages/daemon/src/tui/mirror/terminal-viewport.ts +544 -0
  1116. package/packages/daemon/src/tui/mirror/theme.ts +1069 -33
  1117. package/packages/daemon/src/tui/mirror/ui/agent-badge.tsx +41 -0
  1118. package/packages/daemon/src/tui/mirror/ui/badge.tsx +42 -0
  1119. package/packages/daemon/src/tui/mirror/ui/button.tsx +127 -0
  1120. package/packages/daemon/src/tui/mirror/ui/dialog.tsx +45 -0
  1121. package/packages/daemon/src/tui/mirror/ui/index.ts +59 -0
  1122. package/packages/daemon/src/tui/mirror/ui/key-hint.tsx +63 -0
  1123. package/packages/daemon/src/tui/mirror/ui/keyboard-router.tsx +72 -0
  1124. package/packages/daemon/src/tui/mirror/ui/menu.tsx +86 -0
  1125. package/packages/daemon/src/tui/mirror/ui/navigation-row.tsx +114 -0
  1126. package/packages/daemon/src/tui/mirror/ui/overlay-frame.tsx +117 -0
  1127. package/packages/daemon/src/tui/mirror/ui/overlay-host.tsx +71 -0
  1128. package/packages/daemon/src/tui/mirror/ui/overlay-list-row.tsx +68 -0
  1129. package/packages/daemon/src/tui/mirror/ui/overlay-model.ts +75 -0
  1130. package/packages/daemon/src/tui/mirror/ui/state.ts +218 -0
  1131. package/packages/daemon/src/tui/mirror/ui/status-bar.tsx +208 -0
  1132. package/packages/daemon/src/tui/mirror/ui/surface.tsx +71 -0
  1133. package/packages/daemon/src/tui/mirror/ui/tabs.tsx +168 -0
  1134. package/packages/daemon/src/tui/mirror/widget-fallback.ts +66 -0
  1135. package/packages/daemon/src/tui/mirror/widget-surface-model.ts +170 -0
  1136. package/packages/daemon/src/tui/mirror/widget-surface.tsx +79 -0
  1137. package/packages/daemon/src/tui/mirror/workspace/README.md +79 -0
  1138. package/packages/daemon/src/tui/mirror/workspace/__snapshots__/agent-terminal-canvas-renderer.test.tsx.snap +348 -0
  1139. package/packages/daemon/src/tui/mirror/workspace/__snapshots__/application-shell-renderer.test.tsx.snap +134 -0
  1140. package/packages/daemon/src/tui/mirror/workspace/__snapshots__/command-palette-surface-renderer.test.tsx.snap +255 -0
  1141. package/packages/daemon/src/tui/mirror/workspace/__snapshots__/pane-frame-renderer.test.tsx.snap +525 -0
  1142. package/packages/daemon/src/tui/mirror/workspace/__snapshots__/terminal-pane-header-polish-renderer.test.tsx.snap +31 -0
  1143. package/packages/daemon/src/tui/mirror/workspace/__snapshots__/workbench-shell-renderer.test.tsx.snap +134 -0
  1144. package/packages/daemon/src/tui/mirror/workspace/agent-terminal-canvas-view.tsx +61 -0
  1145. package/packages/daemon/src/tui/mirror/workspace/agent-terminal-canvas.ts +131 -0
  1146. package/packages/daemon/src/tui/mirror/workspace/application-command-description.ts +77 -0
  1147. package/packages/daemon/src/tui/mirror/workspace/application-root-controller.ts +169 -0
  1148. package/packages/daemon/src/tui/mirror/workspace/application-shell-controller.ts +430 -0
  1149. package/packages/daemon/src/tui/mirror/workspace/application-shell-surface-commands.ts +64 -0
  1150. package/packages/daemon/src/tui/mirror/workspace/application-shell-view.tsx +169 -0
  1151. package/packages/daemon/src/tui/mirror/workspace/application-shell.ts +179 -0
  1152. package/packages/daemon/src/tui/mirror/workspace/command-palette-surface-view.tsx +356 -0
  1153. package/packages/daemon/src/tui/mirror/workspace/command-palette-surface.ts +557 -0
  1154. package/packages/daemon/src/tui/mirror/workspace/connection-feedback.ts +105 -0
  1155. package/packages/daemon/src/tui/mirror/workspace/icons.ts +56 -0
  1156. package/packages/daemon/src/tui/mirror/workspace/pane-action-menu-model.ts +33 -0
  1157. package/packages/daemon/src/tui/mirror/workspace/pane-action-menu.tsx +54 -0
  1158. package/packages/daemon/src/tui/mirror/workspace/pane-frame.ts +675 -0
  1159. package/packages/daemon/src/tui/mirror/workspace/pane-frame.tsx +490 -0
  1160. package/packages/daemon/src/tui/mirror/workspace/terminal-pane-chrome-view.tsx +125 -0
  1161. package/packages/daemon/src/tui/mirror/workspace/terminal-pane-chrome.ts +833 -0
  1162. package/packages/daemon/src/tui/mirror/workspace/terminal-pane-header.tsx +326 -0
  1163. package/packages/daemon/src/tui/mirror/workspace/terminal-scrollback.ts +220 -0
  1164. package/packages/daemon/src/tui/mirror/workspace/terminal-window-strip.tsx +466 -0
  1165. package/packages/daemon/src/tui/mirror/workspace/text.ts +28 -0
  1166. package/packages/daemon/src/tui/mirror/workspace/workbench-controller.ts +75 -0
  1167. package/packages/daemon/src/tui/mirror/workspace/workbench-dock-opentui.tsx +224 -0
  1168. package/packages/daemon/src/tui/mirror/workspace/workbench-shell.ts +486 -0
  1169. package/packages/daemon/src/tui/mirror/workspace/workbench-shell.tsx +95 -0
  1170. package/packages/daemon/src/tui/mirror/workspace-ui-state.ts +1278 -0
  1171. package/packages/daemon/src/tui/readiness.ts +52 -0
  1172. package/packages/daemon/src/tui/team/entry.ts +23 -13
  1173. package/packages/daemon/src/tui/team/home.ts +1 -1
  1174. package/packages/daemon/src/tui/team/index.tsx +27 -8
  1175. package/packages/daemon/src/tui/team/projects.ts +12 -0
  1176. package/packages/daemon/src/tui/team/sessions.ts +43 -48
  1177. package/packages/daemon/src/tui/team/wait-receipts.ts +192 -0
  1178. package/packages/daemon/src/ui/pane-frame/fixture.ts +43 -0
  1179. package/packages/daemon/src/ui/workbench-dock/fixture.ts +61 -0
  1180. package/packages/daemon/src/validate.ts +21 -9
  1181. package/packages/daemon/src/widgets/config/README.md +1 -1
  1182. package/packages/daemon/src/widgets/config/index.tsx +15 -115
  1183. package/packages/daemon/src/widgets/lib/watcher.ts +3 -130
  1184. package/packages/daemon/src/widgets/resolve.ts +18 -9
  1185. package/packages/daemon/src/widgets/setup/footer.tsx +0 -7
  1186. package/packages/daemon/src/widgets/setup/index.tsx +18 -20
  1187. package/packages/daemon/src/widgets/setup/review-panel.tsx +15 -10
  1188. package/packages/daemon/src/widgets/setup/setup-model.ts +7 -10
  1189. package/packages/daemon-client/package.json +42 -0
  1190. package/packages/daemon-client/src/application-shell-session.test.ts +196 -0
  1191. package/packages/daemon-client/src/application-shell-session.ts +450 -0
  1192. package/packages/daemon-client/src/bootstrap-coordinator.test.ts +122 -0
  1193. package/packages/daemon-client/src/bootstrap-coordinator.ts +293 -0
  1194. package/packages/daemon-client/src/connection-supervisor.test.ts +109 -0
  1195. package/packages/daemon-client/src/connection-supervisor.ts +216 -0
  1196. package/packages/daemon-client/src/direct-application-shell-transport.test.ts +939 -0
  1197. package/packages/daemon-client/src/direct-application-shell-transport.ts +1144 -0
  1198. package/packages/daemon-client/src/first-latest-coordinator.test.ts +175 -0
  1199. package/packages/daemon-client/src/first-latest-coordinator.ts +82 -0
  1200. package/packages/daemon-client/src/generation-bound-store-timers.test.ts +74 -0
  1201. package/packages/daemon-client/src/generation-bound-store.ts +908 -0
  1202. package/packages/daemon-client/src/index.ts +25 -0
  1203. package/packages/daemon-client/src/owner-action-client.test.ts +180 -0
  1204. package/packages/daemon-client/src/owner-action-client.ts +113 -0
  1205. package/packages/daemon-client/src/pane-stream-client.test.ts +2771 -0
  1206. package/packages/daemon-client/src/pane-stream-client.ts +1665 -0
  1207. package/packages/daemon-client/src/pane-stream-clock-calibration.test.ts +207 -0
  1208. package/packages/daemon-client/src/pane-stream-clock-calibration.ts +161 -0
  1209. package/packages/daemon-client/src/pane-stream-loopback-benchmark.test.ts +51 -0
  1210. package/packages/daemon-client/src/push-resource-session.test.ts +509 -0
  1211. package/packages/daemon-client/src/push-resource-session.ts +797 -0
  1212. package/packages/daemon-client/src/resource-replica.test.ts +186 -0
  1213. package/packages/daemon-client/src/resource-replica.ts +280 -0
  1214. package/packages/daemon-client/src/runtime-resource-ledger.test.ts +18 -0
  1215. package/packages/daemon-client/src/runtime-resource-ledger.ts +69 -0
  1216. package/packages/daemon-client/src/terminal-fast-lane.test.ts +817 -0
  1217. package/packages/daemon-client/src/terminal-fast-lane.ts +817 -0
  1218. package/packages/daemon-client/src/terminal-fast-lane.typecheck.ts +16 -0
  1219. package/packages/daemon-client/src/workspace-catalog-v2.test.ts +109 -0
  1220. package/packages/daemon-client/src/workspace-catalog-v2.ts +66 -0
  1221. package/packages/daemon-client/src/workspace-client-boundaries.test.ts +59 -0
  1222. package/packages/daemon-client/src/workspace-client-conformance.ts +67 -0
  1223. package/packages/daemon-client/src/workspace-client-operations.test.ts +47 -0
  1224. package/packages/daemon-client/src/workspace-client-operations.ts +220 -0
  1225. package/packages/daemon-client/src/workspace-client-types.ts +302 -0
  1226. package/packages/daemon-client/src/workspace-client.test.ts +2752 -0
  1227. package/packages/daemon-client/src/workspace-client.ts +1452 -0
  1228. package/packages/daemon-client/src/workspace-event-supervisor.test.ts +1086 -0
  1229. package/packages/daemon-client/src/workspace-event-supervisor.ts +719 -0
  1230. package/packages/daemon-client/src/workspace-pane-client.test.ts +80 -0
  1231. package/packages/daemon-client/src/workspace-pane-client.ts +63 -0
  1232. package/packages/presentation/package.json +28 -0
  1233. package/packages/presentation/src/index.ts +2 -0
  1234. package/packages/presentation/src/pane-frame/action-state.ts +72 -0
  1235. package/packages/presentation/src/pane-frame/index.ts +3 -0
  1236. package/packages/presentation/src/pane-frame/model.ts +517 -0
  1237. package/packages/presentation/src/pane-frame/presenter.tsx +335 -0
  1238. package/packages/presentation/src/pane-frame/web-entry.tsx +22 -0
  1239. package/packages/presentation/src/pane-frame/web-host-unstyled.tsx +280 -0
  1240. package/packages/presentation/src/pane-frame/web-host.css +388 -0
  1241. package/packages/presentation/src/pane-frame/web-host.tsx +3 -0
  1242. package/packages/presentation/src/presentation-contract.test.ts +63 -0
  1243. package/packages/presentation/src/workbench-dock/index.ts +2 -0
  1244. package/packages/presentation/src/workbench-dock/navigation.ts +54 -0
  1245. package/packages/presentation/src/workbench-dock/presenter.tsx +252 -0
  1246. package/packages/presentation/src/workbench-dock/web-entry.tsx +19 -0
  1247. package/packages/presentation/src/workbench-dock/web-host-unstyled.tsx +198 -0
  1248. package/packages/presentation/src/workbench-dock/web-host.css +204 -0
  1249. package/packages/presentation/src/workbench-dock/web-host.tsx +3 -0
  1250. package/packages/tmux-bridge/src/index.ts +9 -1
  1251. package/packages/tmux-bridge/src/panes.ts +4 -0
  1252. package/packages/tmux-bridge/src/runner.test.ts +72 -0
  1253. package/packages/tmux-bridge/src/runner.ts +43 -2
  1254. package/packages/tmux-bridge/src/sessions.ts +8 -1
  1255. package/scripts/postinstall.js +57 -6
  1256. package/skill/SKILL.md +27 -28
  1257. package/templates/agent-team-monorepo.yml +28 -30
  1258. package/templates/agent-team-nextjs.yml +24 -26
  1259. package/templates/agent-team.yml +24 -24
  1260. package/templates/convex.yml +24 -16
  1261. package/templates/default.yml +26 -21
  1262. package/templates/go.yml +21 -14
  1263. package/templates/missions.yml +25 -40
  1264. package/templates/nextjs.yml +24 -16
  1265. package/templates/python.yml +21 -14
  1266. package/templates/vite.yml +21 -14
  1267. package/bin/cli.ts +0 -1773
  1268. package/packages/daemon/dist/__tests__/support.d.ts +0 -7
  1269. package/packages/daemon/dist/agent-explain.d.ts +0 -52
  1270. package/packages/daemon/dist/attach.d.ts +0 -3
  1271. package/packages/daemon/dist/bin.d.ts +0 -2
  1272. package/packages/daemon/dist/canonical.d.ts +0 -2
  1273. package/packages/daemon/dist/cli.d.ts +0 -1
  1274. package/packages/daemon/dist/command-center/actions/contract.d.ts +0 -1
  1275. package/packages/daemon/dist/command-center/actions/dispatcher.d.ts +0 -27
  1276. package/packages/daemon/dist/command-center/actions/errors.d.ts +0 -38
  1277. package/packages/daemon/dist/command-center/actions/handlers/_project-context.d.ts +0 -12
  1278. package/packages/daemon/dist/command-center/actions/handlers/_resolve-project.d.ts +0 -42
  1279. package/packages/daemon/dist/command-center/actions/handlers/app-set-remote-access.d.ts +0 -23
  1280. package/packages/daemon/dist/command-center/actions/handlers/config-actions.d.ts +0 -12
  1281. package/packages/daemon/dist/command-center/actions/handlers/daemon-shutdown.d.ts +0 -6
  1282. package/packages/daemon/dist/command-center/actions/handlers/project-activate.d.ts +0 -7
  1283. package/packages/daemon/dist/command-center/actions/handlers/project-launch.d.ts +0 -18
  1284. package/packages/daemon/dist/command-center/actions/handlers/project-open-terminal.d.ts +0 -32
  1285. package/packages/daemon/dist/command-center/actions/handlers/project-restart.d.ts +0 -17
  1286. package/packages/daemon/dist/command-center/actions/handlers/project-stop.d.ts +0 -24
  1287. package/packages/daemon/dist/command-center/actions/handlers/terminal-respawn.d.ts +0 -24
  1288. package/packages/daemon/dist/command-center/actions/handlers/terminal-stop.d.ts +0 -14
  1289. package/packages/daemon/dist/command-center/actions/registry.d.ts +0 -35
  1290. package/packages/daemon/dist/command-center/discovery.d.ts +0 -23
  1291. package/packages/daemon/dist/command-center/index.d.ts +0 -10
  1292. package/packages/daemon/dist/command-center/schemas.d.ts +0 -76
  1293. package/packages/daemon/dist/command-center/server.d.ts +0 -26
  1294. package/packages/daemon/dist/command-center/ws-events.d.ts +0 -59
  1295. package/packages/daemon/dist/config.d.ts +0 -19
  1296. package/packages/daemon/dist/control/client.d.ts +0 -23
  1297. package/packages/daemon/dist/control/dispatch.d.ts +0 -34
  1298. package/packages/daemon/dist/control/fanout.d.ts +0 -19
  1299. package/packages/daemon/dist/control/frames.d.ts +0 -23
  1300. package/packages/daemon/dist/control/lifecycle.d.ts +0 -45
  1301. package/packages/daemon/dist/control/server.d.ts +0 -16
  1302. package/packages/daemon/dist/control/verbs.d.ts +0 -11
  1303. package/packages/daemon/dist/detect.d.ts +0 -15
  1304. package/packages/daemon/dist/doctor.d.ts +0 -39
  1305. package/packages/daemon/dist/embed.d.ts +0 -1
  1306. package/packages/daemon/dist/index.d.ts +0 -3
  1307. package/packages/daemon/dist/init.d.ts +0 -4
  1308. package/packages/daemon/dist/inspect.d.ts +0 -54
  1309. package/packages/daemon/dist/launch.d.ts +0 -23
  1310. package/packages/daemon/dist/lib/active-projects.d.ts +0 -12
  1311. package/packages/daemon/dist/lib/agent-discovery.d.ts +0 -68
  1312. package/packages/daemon/dist/lib/app-config.d.ts +0 -253
  1313. package/packages/daemon/dist/lib/app-settings.d.ts +0 -9
  1314. package/packages/daemon/dist/lib/auth/auth-service.d.ts +0 -33
  1315. package/packages/daemon/dist/lib/auth/middleware.d.ts +0 -16
  1316. package/packages/daemon/dist/lib/auth/types.d.ts +0 -1
  1317. package/packages/daemon/dist/lib/auth-token.d.ts +0 -1
  1318. package/packages/daemon/dist/lib/authorship.d.ts +0 -62
  1319. package/packages/daemon/dist/lib/canonical-daemon.d.ts +0 -21
  1320. package/packages/daemon/dist/lib/cli-action-bridge.d.ts +0 -27
  1321. package/packages/daemon/dist/lib/daemon-embed.d.ts +0 -31
  1322. package/packages/daemon/dist/lib/daemon-watchdog.d.ts +0 -16
  1323. package/packages/daemon/dist/lib/daemon.d.ts +0 -8
  1324. package/packages/daemon/dist/lib/dot-path.d.ts +0 -2
  1325. package/packages/daemon/dist/lib/errors.d.ts +0 -37
  1326. package/packages/daemon/dist/lib/filesystem-browser.d.ts +0 -85
  1327. package/packages/daemon/dist/lib/launch-plan.d.ts +0 -6
  1328. package/packages/daemon/dist/lib/log.d.ts +0 -40
  1329. package/packages/daemon/dist/lib/manifest-pack.d.ts +0 -79
  1330. package/packages/daemon/dist/lib/output.d.ts +0 -9
  1331. package/packages/daemon/dist/lib/project-init-runner.d.ts +0 -46
  1332. package/packages/daemon/dist/lib/project-inspect.d.ts +0 -28
  1333. package/packages/daemon/dist/lib/project-onboard.d.ts +0 -58
  1334. package/packages/daemon/dist/lib/project-probe.d.ts +0 -35
  1335. package/packages/daemon/dist/lib/project-registry.d.ts +0 -76
  1336. package/packages/daemon/dist/lib/session-monitor.d.ts +0 -15
  1337. package/packages/daemon/dist/lib/session-options.d.ts +0 -13
  1338. package/packages/daemon/dist/lib/shell.d.ts +0 -5
  1339. package/packages/daemon/dist/lib/sizes.d.ts +0 -16
  1340. package/packages/daemon/dist/lib/skill-sync.d.ts +0 -60
  1341. package/packages/daemon/dist/lib/slugify.d.ts +0 -4
  1342. package/packages/daemon/dist/lib/state-home.d.ts +0 -2
  1343. package/packages/daemon/dist/lib/terminals-store.d.ts +0 -27
  1344. package/packages/daemon/dist/lib/tui-binary.d.ts +0 -57
  1345. package/packages/daemon/dist/lib/update-check.d.ts +0 -118
  1346. package/packages/daemon/dist/lib/update.d.ts +0 -65
  1347. package/packages/daemon/dist/lib/workspace-registry.d.ts +0 -84
  1348. package/packages/daemon/dist/lib/worktree.d.ts +0 -76
  1349. package/packages/daemon/dist/lib/yaml-io.d.ts +0 -10
  1350. package/packages/daemon/dist/ls.d.ts +0 -3
  1351. package/packages/daemon/dist/native/TmuxIdeNotifier.app/Contents/Info.plist +0 -34
  1352. package/packages/daemon/dist/native/TmuxIdeNotifier.app/Contents/MacOS/tmux-ide-notifier +0 -0
  1353. package/packages/daemon/dist/native/TmuxIdeNotifier.app/Contents/PkgInfo +0 -1
  1354. package/packages/daemon/dist/native/TmuxIdeNotifier.app/Contents/Resources/AppIcon.icns +0 -0
  1355. package/packages/daemon/dist/native/TmuxIdeNotifier.app/Contents/Resources/Assets.car +0 -0
  1356. package/packages/daemon/dist/native/TmuxIdeNotifier.app/Contents/_CodeSignature/CodeResources +0 -139
  1357. package/packages/daemon/dist/restart.d.ts +0 -4
  1358. package/packages/daemon/dist/restore.d.ts +0 -113
  1359. package/packages/daemon/dist/schemas/domain.d.ts +0 -1
  1360. package/packages/daemon/dist/schemas/filesystem.d.ts +0 -29
  1361. package/packages/daemon/dist/schemas/ide-config.d.ts +0 -1
  1362. package/packages/daemon/dist/schemas/index.d.ts +0 -12
  1363. package/packages/daemon/dist/schemas/inspect.d.ts +0 -53
  1364. package/packages/daemon/dist/schemas/registry.d.ts +0 -35
  1365. package/packages/daemon/dist/schemas/ws-events.d.ts +0 -72
  1366. package/packages/daemon/dist/send.d.ts +0 -59
  1367. package/packages/daemon/dist/server/index.d.ts +0 -10
  1368. package/packages/daemon/dist/server/pty-bridge.d.ts +0 -174
  1369. package/packages/daemon/dist/server/ws-route.d.ts +0 -74
  1370. package/packages/daemon/dist/status.d.ts +0 -3
  1371. package/packages/daemon/dist/stop.d.ts +0 -3
  1372. package/packages/daemon/dist/terminal/NodePtyAdapter.d.ts +0 -44
  1373. package/packages/daemon/dist/terminal/PtyAdapter.d.ts +0 -124
  1374. package/packages/daemon/dist/terminal/__tests__/MockPtyAdapter.d.ts +0 -77
  1375. package/packages/daemon/dist/types.d.ts +0 -2
  1376. package/packages/daemon/dist/validate.d.ts +0 -4
  1377. package/packages/daemon/dist/widgets/changes/index.jsx +0 -575
  1378. package/packages/daemon/dist/widgets/config/index.d.ts +0 -1
  1379. package/packages/daemon/dist/widgets/config/index.jsx +0 -395
  1380. package/packages/daemon/dist/widgets/explorer/breadcrumbs.d.ts +0 -10
  1381. package/packages/daemon/dist/widgets/explorer/breadcrumbs.jsx +0 -51
  1382. package/packages/daemon/dist/widgets/explorer/footer.d.ts +0 -6
  1383. package/packages/daemon/dist/widgets/explorer/footer.jsx +0 -11
  1384. package/packages/daemon/dist/widgets/explorer/index.jsx +0 -393
  1385. package/packages/daemon/dist/widgets/explorer/tree-model.d.ts +0 -13
  1386. package/packages/daemon/dist/widgets/explorer/tree.d.ts +0 -13
  1387. package/packages/daemon/dist/widgets/explorer/tree.jsx +0 -108
  1388. package/packages/daemon/dist/widgets/lib/config-model.d.ts +0 -22
  1389. package/packages/daemon/dist/widgets/lib/files.d.ts +0 -11
  1390. package/packages/daemon/dist/widgets/lib/git.d.ts +0 -11
  1391. package/packages/daemon/dist/widgets/lib/grammar.d.ts +0 -79
  1392. package/packages/daemon/dist/widgets/lib/help-overlay.d.ts +0 -19
  1393. package/packages/daemon/dist/widgets/lib/help-overlay.jsx +0 -69
  1394. package/packages/daemon/dist/widgets/lib/pane-comms.d.ts +0 -28
  1395. package/packages/daemon/dist/widgets/lib/theme.d.ts +0 -44
  1396. package/packages/daemon/dist/widgets/lib/watcher.d.ts +0 -9
  1397. package/packages/daemon/dist/widgets/preview/index.jsx +0 -371
  1398. package/packages/daemon/dist/widgets/resolve.d.ts +0 -20
  1399. package/packages/daemon/dist/widgets/setup/agent-naming.d.ts +0 -9
  1400. package/packages/daemon/dist/widgets/setup/agent-naming.jsx +0 -81
  1401. package/packages/daemon/dist/widgets/setup/config-tree.d.ts +0 -13
  1402. package/packages/daemon/dist/widgets/setup/config-tree.jsx +0 -203
  1403. package/packages/daemon/dist/widgets/setup/detect-panel.d.ts +0 -14
  1404. package/packages/daemon/dist/widgets/setup/detect-panel.jsx +0 -48
  1405. package/packages/daemon/dist/widgets/setup/field-editor.d.ts +0 -12
  1406. package/packages/daemon/dist/widgets/setup/field-editor.jsx +0 -163
  1407. package/packages/daemon/dist/widgets/setup/footer.d.ts +0 -17
  1408. package/packages/daemon/dist/widgets/setup/footer.jsx +0 -64
  1409. package/packages/daemon/dist/widgets/setup/index.d.ts +0 -1
  1410. package/packages/daemon/dist/widgets/setup/index.jsx +0 -261
  1411. package/packages/daemon/dist/widgets/setup/layout-picker.d.ts +0 -9
  1412. package/packages/daemon/dist/widgets/setup/layout-picker.jsx +0 -69
  1413. package/packages/daemon/dist/widgets/setup/setup-model.d.ts +0 -15
  1414. package/packages/daemon/dist/widgets/sidebar/index.jsx +0 -462
  1415. package/packages/daemon/src/tui/mirror/control-client.ts +0 -214
  1416. package/packages/daemon/src/tui/mirror/control.ts +0 -97
  1417. package/packages/daemon/src/tui/mirror/focus-border.ts +0 -57
  1418. package/packages/daemon/src/tui/mirror/host-terminal.ts +0 -49
  1419. package/packages/daemon/src/tui/mirror/input-coalescer.ts +0 -105
  1420. package/packages/daemon/src/tui/mirror/session-mirror.ts +0 -724
  1421. package/packages/daemon/src/widgets/setup/orchestrator-panel.tsx +0 -200
  1422. package/scripts/build-cli.mjs +0 -101
  1423. package/scripts/build-macos-notifier.mjs +0 -160
  1424. package/scripts/build-tui.mjs +0 -65
  1425. package/scripts/capture-codex-traffic.mjs +0 -195
  1426. package/scripts/check-src-additions.sh +0 -74
  1427. package/scripts/coverage-summary.mjs +0 -68
  1428. package/scripts/install-git-hooks.js +0 -53
  1429. package/scripts/merge-update-manifests.mjs +0 -58
  1430. package/scripts/merge-update-manifests.test.mjs +0 -82
  1431. package/scripts/pack-check-run.mjs +0 -83
  1432. package/scripts/perf-mirror.mjs +0 -313
  1433. package/scripts/prepublish-check.mjs +0 -80
  1434. package/scripts/publish-tap.sh +0 -55
  1435. package/scripts/stress-test.ts +0 -141
  1436. package/scripts/verify-endpoints.sh +0 -90
  1437. /package/packages/daemon/dist/{server/standalone.d.ts → terminal/mirror/events.js} +0 -0
  1438. /package/packages/daemon/dist/{widgets/changes/index.d.ts → terminal/mirror/trusted-inventory.js} +0 -0
  1439. /package/packages/daemon/dist/{widgets/explorer/index.d.ts → terminal/session-runtime/terminal-interpreter-backend.js} +0 -0
  1440. /package/packages/daemon/dist/{widgets/preview/index.d.ts → tui/mirror/features/changes/contract.js} +0 -0
  1441. /package/packages/daemon/dist/{widgets/sidebar/index.d.ts → tui/mirror/features/dialogs/contract.js} +0 -0
  1442. /package/packages/daemon/src/{tui/mirror → terminal/protocol}/layout-parse.ts +0 -0
@@ -0,0 +1,2084 @@
1
+ import type {
2
+ NativeBackingIdentity,
3
+ TerminalNativeBackingResponse,
4
+ } from "./native-seed-backing.ts";
5
+ import {
6
+ SessionRuntimeClientIdSchemaZ,
7
+ SessionRuntimeAuthorityLeaseSchemaZ,
8
+ SessionRuntimeControllerLeaseSchemaZ,
9
+ SessionRuntimeGenerationSchemaZ,
10
+ SessionRuntimeSemanticIntentSchemaZ,
11
+ SessionRuntimeTerminalInputSchemaZ,
12
+ CausalCellProbeV1SchemaZ,
13
+ type AuthoredInteractionOrigin,
14
+ type InteractionReceipt,
15
+ type SessionRuntimeControllerLease,
16
+ type SessionRuntimeControllerRole,
17
+ type SessionRuntimeControllerSnapshot,
18
+ type SessionRuntimeActivityKind,
19
+ type SessionRuntimeAuthorityKind,
20
+ type SessionRuntimeAuthorityLease,
21
+ type SessionRuntimeAuthoritySnapshot,
22
+ type SessionRuntimePresenceState,
23
+ type SessionRuntimeGeneration,
24
+ type SessionRuntimeSemanticIntent,
25
+ type SessionRuntimeTerminalInput,
26
+ type CanonicalTerminalReplicaUpdate,
27
+ type CausalCellFailureReasonV1,
28
+ type CausalCellProbeV1,
29
+ type TerminalDeliveryAck,
30
+ type TerminalDeliveryNack,
31
+ type TerminalDeliveryOffer,
32
+ type TerminalDeliveryServerMessage,
33
+ type TerminalDeliveryVisibility,
34
+ } from "@tmux-ide/contracts";
35
+ import { randomUUID } from "node:crypto";
36
+ import { z } from "zod";
37
+ import type {
38
+ MirrorLayoutAuthoritySnapshot,
39
+ MirrorLayoutEvent,
40
+ MirrorPaneEvent,
41
+ MirrorSessionDescription,
42
+ } from "../mirror/events.ts";
43
+ import {
44
+ MirrorService,
45
+ type MirrorAuthoritativeLayoutRequest,
46
+ type MirrorLayoutSubscription,
47
+ type MirrorServiceOptions,
48
+ type MirrorSubscribeRequest,
49
+ type MirrorSubscription,
50
+ } from "../mirror/mirror-service.ts";
51
+ import type { PaneStreamMirror } from "../pane-stream/pane-stream-websocket.ts";
52
+ import {
53
+ SessionSemanticMutationExecutor,
54
+ type SessionRuntimeIntentResult,
55
+ type SessionRuntimeTmuxObservation,
56
+ type SessionSemanticMutationExecutorOptions,
57
+ type SessionSemanticMutationMetrics,
58
+ } from "./semantic-mutation-executor.ts";
59
+ import {
60
+ SessionRuntimeTerminalReplicaOwner,
61
+ type TerminalReplicaQualificationSnapshot,
62
+ type TerminalReplicaSubscription,
63
+ } from "./terminal-replica-owner.ts";
64
+ import {
65
+ SessionRuntimeTerminalDeliveryHub,
66
+ type TerminalDeliveryConnection,
67
+ type TerminalDeliveryConvergenceSnapshot,
68
+ type TerminalDeliveryMetrics,
69
+ } from "./terminal-delivery-hub.ts";
70
+ import {
71
+ SYSTEM_SESSION_RUNTIME_SCHEDULER,
72
+ type SessionRuntimeScheduler,
73
+ } from "./runtime-scheduler.ts";
74
+ import {
75
+ DISABLED_SESSION_RUNTIME_OBSERVABILITY,
76
+ type SessionRuntimeObservability,
77
+ type SessionRuntimeObservabilitySnapshot,
78
+ type SessionRuntimeTraceContext,
79
+ } from "./runtime-observability.ts";
80
+ import { RuntimeTraceCorrelator } from "./runtime-trace-correlator.ts";
81
+ import type { MirrorOutputTiming } from "../mirror/control-channel.ts";
82
+ import type { TrustedMirrorSessionInventory } from "../mirror/trusted-inventory.ts";
83
+ import { SessionRuntimeAuthorityArbiter } from "./authority-arbiter.ts";
84
+ import type { CausalCellLedgerResult } from "./causal-cell-ledger.ts";
85
+
86
+ async function abortable<T>(promise: Promise<T>, signal?: AbortSignal): Promise<T> {
87
+ if (!signal) return promise;
88
+ signal.throwIfAborted();
89
+ return new Promise<T>((resolve, reject) => {
90
+ const onAbort = (): void => reject(signal.reason);
91
+ signal.addEventListener("abort", onAbort, { once: true });
92
+ void promise.then(resolve, reject).then(
93
+ () => signal.removeEventListener("abort", onAbort),
94
+ () => signal.removeEventListener("abort", onAbort),
95
+ );
96
+ });
97
+ }
98
+
99
+ export interface SessionRuntimeRegistryOptions {
100
+ readonly generation: string;
101
+ readonly mirror?: MirrorServiceOptions;
102
+ readonly semanticMutations?: SessionSemanticMutationExecutorOptions;
103
+ /** Deterministic seam for lease tests. Production uses cryptographic UUIDs. */
104
+ readonly createControllerToken?: () => string;
105
+ /** Native terminal activity quiet period before tmux-ide may size again. */
106
+ readonly nativeGeometryHysteresisMs?: number;
107
+ readonly scheduler?: SessionRuntimeScheduler;
108
+ readonly observability?: SessionRuntimeObservability;
109
+ /** Deterministic qualification seam; never invoked while observability is disabled. */
110
+ readonly createTraceCorrelator?: (scheduler: SessionRuntimeScheduler) => RuntimeTraceCorrelator;
111
+ }
112
+
113
+ /** Opaque daemon-internal proof that an inventory came from one exact runtime owner. */
114
+ export interface TrustedSessionInventoryCandidate {
115
+ readonly inventory: TrustedMirrorSessionInventory;
116
+ readonly token: object;
117
+ }
118
+
119
+ export interface SessionRuntimeQualificationSnapshot {
120
+ readonly generation: SessionRuntimeGeneration;
121
+ readonly controlChannels: number;
122
+ readonly controllerLeases: number;
123
+ readonly sessions: readonly {
124
+ readonly session: string;
125
+ readonly consumers: number;
126
+ readonly retained: boolean;
127
+ readonly delivery: TerminalDeliveryMetrics;
128
+ readonly convergence: TerminalDeliveryConvergenceSnapshot;
129
+ readonly replicas: Readonly<Record<string, TerminalReplicaQualificationSnapshot>>;
130
+ }[];
131
+ readonly mutations: SessionSemanticMutationMetrics | null;
132
+ readonly observability: SessionRuntimeObservabilitySnapshot;
133
+ }
134
+
135
+ export type {
136
+ SessionRuntimeControllerLease,
137
+ SessionRuntimeControllerRole,
138
+ SessionRuntimeControllerSnapshot,
139
+ } from "@tmux-ide/contracts";
140
+
141
+ function authoredOriginForSurface(surface: string): AuthoredInteractionOrigin {
142
+ if (surface === "opentui") return "tui";
143
+ if (surface === "command-center") return "sdk";
144
+ if (surface === "cli") return "cli";
145
+ return "gui";
146
+ }
147
+
148
+ export type SessionRuntimeControllerLeaseErrorCode =
149
+ | "controller-conflict"
150
+ | "controller-target-unavailable"
151
+ | "stale-controller-lease"
152
+ | "invalid-client-capability"
153
+ | "invalid-source-pane-binding"
154
+ | "intent-session-mismatch";
155
+
156
+ export class SessionRuntimeControllerLeaseError extends Error {
157
+ constructor(
158
+ readonly code: SessionRuntimeControllerLeaseErrorCode,
159
+ message: string,
160
+ ) {
161
+ super(message);
162
+ this.name = "SessionRuntimeControllerLeaseError";
163
+ }
164
+ }
165
+
166
+ export interface SessionRuntimeConsumer {
167
+ readonly generation: SessionRuntimeGeneration;
168
+ readonly session: string;
169
+ readonly surface: string;
170
+ readonly clientId: string;
171
+ controllerRole(): SessionRuntimeControllerRole;
172
+ controllerSnapshot(): SessionRuntimeControllerSnapshot;
173
+ authoritySnapshot(): SessionRuntimeAuthoritySnapshot;
174
+ onAuthoritySnapshot(listener: (snapshot: SessionRuntimeAuthoritySnapshot) => void): () => void;
175
+ updatePresence(state: SessionRuntimePresenceState): void;
176
+ noteActivity(activity: SessionRuntimeActivityKind): void;
177
+ acquireAuthority(authority: SessionRuntimeAuthorityKind): SessionRuntimeAuthorityLease | null;
178
+ releaseAuthority(authority: SessionRuntimeAuthorityKind): void;
179
+ acquireController(): SessionRuntimeControllerLease;
180
+ handoffController(
181
+ lease: SessionRuntimeControllerLease,
182
+ targetClientId: string,
183
+ ): SessionRuntimeControllerLease;
184
+ releaseController(lease: SessionRuntimeControllerLease): void;
185
+ submitIntent(
186
+ lease: SessionRuntimeControllerLease,
187
+ operationId: string,
188
+ intent: SessionRuntimeSemanticIntent,
189
+ ): Promise<SessionRuntimeIntentResult>;
190
+ sendInput(
191
+ lease: SessionRuntimeControllerLease,
192
+ semanticPaneId: string,
193
+ input: SessionRuntimeTerminalInput,
194
+ performanceTraceId?: string,
195
+ causalProbe?: CausalCellProbeV1,
196
+ onCausalResult?: (result: CausalCellLedgerResult) => void,
197
+ ): void;
198
+ failCausalCellProbe(
199
+ semanticPaneId: string,
200
+ traceId: string,
201
+ reason: CausalCellFailureReasonV1,
202
+ ): void;
203
+ fitViewport(lease: SessionRuntimeControllerLease, cols: number, rows: number): void;
204
+ fitViewportWithAuthority(lease: SessionRuntimeAuthorityLease, cols: number, rows: number): void;
205
+ describe(): Promise<MirrorSessionDescription>;
206
+ subscribe(
207
+ semanticPaneId: string,
208
+ onEvent: (event: MirrorPaneEvent) => void,
209
+ onLayout?: (event: MirrorLayoutEvent) => void,
210
+ ): Promise<MirrorSubscription>;
211
+ subscribeReplica(
212
+ semanticPaneId: string,
213
+ onUpdate: (update: CanonicalTerminalReplicaUpdate) => void,
214
+ ): Promise<TerminalReplicaSubscription>;
215
+ openTerminalDelivery(
216
+ deliverySubscriberId: string,
217
+ deliveryRequestId: string,
218
+ semanticPaneId: string,
219
+ offer: TerminalDeliveryOffer,
220
+ onMessage: (message: TerminalDeliveryServerMessage) => void | Promise<void>,
221
+ ): Promise<TerminalDeliveryConnection>;
222
+ close(): Promise<void>;
223
+ }
224
+
225
+ /**
226
+ * Trusted, in-process execution proof. Transport redemption or another daemon
227
+ * host boundary retains it; HTTP request bodies can never construct authority
228
+ * merely by matching this shape because every opaque token is checked against
229
+ * the live registry generation and consumer.
230
+ */
231
+ export type SessionRuntimeExecutionHandle = object;
232
+
233
+ interface ExecutionHandleState {
234
+ readonly runtime: SessionRuntime;
235
+ readonly consumer: SessionRuntimeConsumerImpl;
236
+ readonly lease: SessionRuntimeControllerLease;
237
+ readonly allowedSourcePaneIds: ReadonlySet<string>;
238
+ readonly sourceSemanticPaneId: string | null;
239
+ readonly authorizeLiveScope: ((semanticPaneId?: string) => void) | null;
240
+ }
241
+
242
+ /**
243
+ * One daemon-generation lifecycle owner for every discovered tmux session.
244
+ *
245
+ * A session runtime retains the canonical MirrorService channel independently
246
+ * of its GUI/TUI/SDK consumers. Consumer departure therefore cannot churn the
247
+ * tmux control client. A channel exit invalidates only that retention; the next
248
+ * operation rebuilds it through the same registry and generation without
249
+ * starting, stopping, or otherwise owning the tmux server process.
250
+ */
251
+ export class SessionRuntimeRegistry implements PaneStreamMirror {
252
+ readonly generation: SessionRuntimeGeneration;
253
+ readonly #mirror: MirrorService;
254
+ readonly #semanticMutations: SessionSemanticMutationExecutor | null;
255
+ readonly #resolveSession: ((workspaceName: string) => string | null) | null;
256
+ readonly #createControllerToken: () => string;
257
+ readonly #nativeGeometryHysteresisMs: number | undefined;
258
+ readonly #scheduler: SessionRuntimeScheduler;
259
+ readonly #observability: SessionRuntimeObservability;
260
+ readonly #createTraceCorrelator: (scheduler: SessionRuntimeScheduler) => RuntimeTraceCorrelator;
261
+ readonly #sessions = new Map<string, SessionRuntime>();
262
+ readonly #proofPrewarmOwnership = new Map<SessionRuntime, { owned: boolean; claims: number }>();
263
+ readonly #trustedInventoryTokens = new WeakMap<object, SessionRuntime>();
264
+ readonly #executionHandles = new WeakMap<object, ExecutionHandleState>();
265
+ readonly #stopExitObserver: () => void;
266
+ #disposed = false;
267
+ #disposePromise: Promise<void> | null = null;
268
+
269
+ constructor(options: SessionRuntimeRegistryOptions) {
270
+ this.generation = SessionRuntimeGenerationSchemaZ.parse(options.generation);
271
+ this.#scheduler = options.scheduler ?? SYSTEM_SESSION_RUNTIME_SCHEDULER;
272
+ this.#observability = options.observability ?? DISABLED_SESSION_RUNTIME_OBSERVABILITY;
273
+ this.#createTraceCorrelator =
274
+ options.createTraceCorrelator ?? ((scheduler) => new RuntimeTraceCorrelator(scheduler));
275
+ const diagnosticMirrorOptions: Partial<MirrorServiceOptions> = {
276
+ onInputAccepted: (session, action, acceptedAtMicros, ok) => {
277
+ for (const traceId of action.traceIds ?? []) {
278
+ this.#sessions.get(session)?.noteInputControlReply(traceId, ok);
279
+ if (!this.#observability.enabled) continue;
280
+ const trace = this.#observability.beginTrace(
281
+ "terminal-input-to-paint",
282
+ { generation: this.generation, incarnation: null },
283
+ traceId,
284
+ );
285
+ this.#observability.recordSpan(
286
+ "tmux",
287
+ ok ? "control-command-accepted" : "control-command-rejected",
288
+ acceptedAtMicros,
289
+ acceptedAtMicros,
290
+ trace,
291
+ );
292
+ }
293
+ },
294
+ ...(this.#observability.enabled
295
+ ? {
296
+ nowMicros: () => this.#observability.nowMicros(),
297
+ onInputWrite: (_session, action, startedAtMicros, endedAtMicros, pendingBeforeSend) => {
298
+ for (const traceId of action.traceIds ?? []) {
299
+ const trace = this.#observability.beginTrace(
300
+ "terminal-input-to-paint",
301
+ { generation: this.generation, incarnation: null },
302
+ traceId,
303
+ );
304
+ this.#observability.recordSpan(
305
+ "tmux",
306
+ "control-write",
307
+ startedAtMicros,
308
+ endedAtMicros,
309
+ trace,
310
+ );
311
+ this.#observability.recordSpan(
312
+ "tmux",
313
+ pendingBeforeSend === 0
314
+ ? "control-queue-empty-at-send"
315
+ : "control-queue-nonempty-at-send",
316
+ endedAtMicros,
317
+ endedAtMicros,
318
+ trace,
319
+ );
320
+ }
321
+ },
322
+ }
323
+ : {}),
324
+ };
325
+ const observeOutput =
326
+ this.#observability.enabled || options.mirror?.onOutputObserved
327
+ ? (
328
+ session: string,
329
+ semanticPaneId: string,
330
+ ageMs: number | null,
331
+ timing?: MirrorOutputTiming,
332
+ ) => {
333
+ options.mirror?.onOutputObserved?.(session, semanticPaneId, ageMs, timing);
334
+ if (this.#observability.enabled)
335
+ this.#sessions.get(session)?.noteOutputObserved(semanticPaneId, ageMs, timing);
336
+ }
337
+ : undefined;
338
+ const observeFlowRecovery =
339
+ this.#observability.enabled || options.mirror?.onFlowRecoveryObserved
340
+ ? (
341
+ session: string,
342
+ observation: Parameters<NonNullable<MirrorServiceOptions["onFlowRecoveryObserved"]>>[1],
343
+ ) => {
344
+ options.mirror?.onFlowRecoveryObserved?.(session, observation);
345
+ if (!this.#observability.enabled) return;
346
+ const atMicros = this.#observability.nowMicros();
347
+ this.#observability.recordSpan(
348
+ "tmux",
349
+ `terminal-mirror-flow-${observation.phase}`,
350
+ atMicros,
351
+ atMicros,
352
+ null,
353
+ undefined,
354
+ {
355
+ workspaceName: session,
356
+ semanticPaneId: observation.semanticPaneId,
357
+ mirrorFlowPhase: observation.phase,
358
+ mirrorFlowRecoveryOrdinal: observation.recoveryOrdinal,
359
+ mirrorPaneIncarnation: observation.paneIncarnation,
360
+ mirrorOutputOrdinal: observation.outputOrdinal,
361
+ mirrorRecoveryElapsedMicros: observation.elapsedMicros,
362
+ mirrorRecoveryConfirmationOrdinal: observation.confirmationOrdinal,
363
+ mirrorCollectorStarted: observation.collectorStarted,
364
+ mirrorCollectorLastCompletedOrdinal: observation.collectorLastCompletedOrdinal,
365
+ mirrorCollectorCaptureLineCount: observation.collectorCaptureLineCount,
366
+ mirrorCollectorCaptureByteCount: observation.collectorCaptureByteCount,
367
+ mirrorCollectorContinueObserved: observation.collectorContinueObserved,
368
+ mirrorCollectorStatusObserved: observation.collectorStatusObserved,
369
+ mirrorCollectorObserverEmissionObserved:
370
+ observation.collectorObserverEmissionObserved,
371
+ ...(observation.collectorFailureReason
372
+ ? { mirrorCollectorFailureReason: observation.collectorFailureReason }
373
+ : {}),
374
+ ...(observation.fingerprintExact === null
375
+ ? {}
376
+ : { mirrorRecoveryFingerprintExact: observation.fingerprintExact }),
377
+ ...(observation.failureReason
378
+ ? { mirrorFlowFailureReason: observation.failureReason }
379
+ : {}),
380
+ },
381
+ );
382
+ }
383
+ : undefined;
384
+ this.#mirror = new MirrorService({
385
+ ...options.mirror,
386
+ ...diagnosticMirrorOptions,
387
+ onNativeClientActivity: (session) => {
388
+ options.mirror?.onNativeClientActivity?.(session);
389
+ this.#sessions.get(session)?.noteNativeGeometryActivity();
390
+ },
391
+ ...(observeOutput ? { onOutputObserved: observeOutput } : {}),
392
+ ...(observeFlowRecovery ? { onFlowRecoveryObserved: observeFlowRecovery } : {}),
393
+ });
394
+ this.#semanticMutations = options.semanticMutations
395
+ ? new SessionSemanticMutationExecutor({
396
+ ...options.semanticMutations,
397
+ scheduler: options.semanticMutations.scheduler ?? this.#scheduler,
398
+ observability: options.semanticMutations.observability ?? this.#observability,
399
+ })
400
+ : null;
401
+ this.#resolveSession = options.semanticMutations?.resolveSession ?? null;
402
+ this.#createControllerToken = options.createControllerToken ?? randomUUID;
403
+ this.#nativeGeometryHysteresisMs = options.nativeGeometryHysteresisMs;
404
+ this.#stopExitObserver = this.#mirror.onSessionExit((session) => {
405
+ this.#sessions.get(session)?.noteControlExit();
406
+ });
407
+ }
408
+
409
+ connect(session: string, surface: string, clientId: string): SessionRuntimeConsumer {
410
+ return this.#runtime(session).connect(surface, SessionRuntimeClientIdSchemaZ.parse(clientId));
411
+ }
412
+
413
+ /**
414
+ * Start the daemon-owned tmux control channel before a renderer asks for a
415
+ * pane-stream ticket. This uses the exact same SessionRuntime subsequently
416
+ * consumed by admission, so prewarming cannot weaken pane enumeration or
417
+ * create a second control authority.
418
+ */
419
+ async prewarmSession(session: string, signal?: AbortSignal): Promise<void> {
420
+ signal?.throwIfAborted();
421
+ const runtime = this.#runtime(session);
422
+ await abortable(runtime.whenReady(), signal);
423
+ if (this.#sessions.get(session) !== runtime) {
424
+ throw new Error(`SessionRuntime ${session} was retired while prewarming`);
425
+ }
426
+ }
427
+
428
+ /**
429
+ * Mark the exact retained runtime as eligible for daemon-private inventory.
430
+ * This is intentionally separate from ordinary renderer prewarming: only
431
+ * the native discovery path may call it after its parser and global catalog
432
+ * analyzer proved the session attachable.
433
+ */
434
+ async prewarmProofQualifiedSession(
435
+ session: string,
436
+ runtimeSessionId: string,
437
+ signal?: AbortSignal,
438
+ ): Promise<void> {
439
+ signal?.throwIfAborted();
440
+ if (!/^\$(?:0|[1-9][0-9]*)$/u.test(runtimeSessionId)) {
441
+ throw new Error(`SessionRuntime ${session} received an invalid runtime session identity`);
442
+ }
443
+ let runtime = this.#acquireProofPrewarmRuntime(session);
444
+ try {
445
+ await this.#observeTerminalAttempt(
446
+ "terminal-prewarm-readiness",
447
+ abortable(runtime.whenReady(), signal),
448
+ );
449
+ if (this.#sessions.get(session) !== runtime) {
450
+ throw new Error(`SessionRuntime ${session} was retired while qualifying inventory`);
451
+ }
452
+ let attachedIdentity = await this.#observeTerminalAttempt(
453
+ "terminal-attached-identity",
454
+ abortable(runtime.attachedSessionIdentity(), signal),
455
+ );
456
+ if (attachedIdentity?.runtimeSessionId !== runtimeSessionId) {
457
+ if (this.#sessions.get(session) === runtime) this.#sessions.delete(session);
458
+ await abortable(runtime.dispose(), signal);
459
+ this.#releaseProofPrewarmRuntime(runtime);
460
+ signal?.throwIfAborted();
461
+ runtime = this.#acquireProofPrewarmRuntime(session);
462
+ await this.#observeTerminalAttempt(
463
+ "terminal-prewarm-readiness",
464
+ abortable(runtime.whenReady(), signal),
465
+ );
466
+ if (this.#sessions.get(session) !== runtime) {
467
+ throw new Error(`SessionRuntime ${session} was retired while replacing inventory`);
468
+ }
469
+ attachedIdentity = await this.#observeTerminalAttempt(
470
+ "terminal-attached-identity",
471
+ abortable(runtime.attachedSessionIdentity(), signal),
472
+ );
473
+ }
474
+ if (
475
+ attachedIdentity?.sessionName !== session ||
476
+ attachedIdentity.runtimeSessionId !== runtimeSessionId
477
+ ) {
478
+ throw new Error(`SessionRuntime ${session} is attached to a different tmux identity`);
479
+ }
480
+ signal?.throwIfAborted();
481
+ runtime.qualifyTrustedInventory(runtimeSessionId);
482
+ } finally {
483
+ this.#releaseProofPrewarmRuntime(runtime);
484
+ }
485
+ }
486
+
487
+ /** Daemon-internal only. Runtime tmux ids in the result must never cross wire. */
488
+ async describeTrustedSessionInventory(
489
+ session: string,
490
+ signal?: AbortSignal,
491
+ ): Promise<TrustedMirrorSessionInventory> {
492
+ return (await this.describeTrustedSessionInventoryCandidate(session, signal)).inventory;
493
+ }
494
+
495
+ /**
496
+ * Return an opaque token bound to the exact runtime that produced the
497
+ * inventory. Consumers must revalidate it after their final await.
498
+ */
499
+ async describeTrustedSessionInventoryCandidate(
500
+ session: string,
501
+ signal?: AbortSignal,
502
+ ): Promise<TrustedSessionInventoryCandidate> {
503
+ signal?.throwIfAborted();
504
+ if (this.#disposed) throw new Error("SessionRuntimeRegistry is disposed");
505
+ const runtime = this.#sessions.get(session);
506
+ if (!runtime?.trustedInventoryQualified()) {
507
+ throw new Error(`SessionRuntime ${session} has no proof-qualified inventory authority`);
508
+ }
509
+ const inventory = await this.#observeTerminalAttempt(
510
+ "terminal-trusted-inventory-attempt",
511
+ abortable(runtime.describeTrustedInventory(), signal),
512
+ );
513
+ if (this.#sessions.get(session) !== runtime || !runtime.trustedInventoryQualified()) {
514
+ throw new Error(`SessionRuntime ${session} changed during trusted inventory discovery`);
515
+ }
516
+ if (!inventory) {
517
+ throw new Error(`SessionRuntime ${session} lost its retained inventory authority`);
518
+ }
519
+ const token = Object.freeze({});
520
+ this.#trustedInventoryTokens.set(token, runtime);
521
+ return Object.freeze({ inventory, token });
522
+ }
523
+
524
+ isTrustedSessionInventoryCandidateCurrent(session: string, token: object): boolean {
525
+ if (this.#disposed) return false;
526
+ const runtime = this.#trustedInventoryTokens.get(token);
527
+ return (
528
+ runtime !== undefined &&
529
+ this.#sessions.get(session) === runtime &&
530
+ runtime.trustedInventoryQualified()
531
+ );
532
+ }
533
+
534
+ hasProofQualifiedInventory(session: string): boolean {
535
+ return (
536
+ (this.#sessions.get(session)?.trustedInventoryQualified() ?? false) &&
537
+ this.#mirror.hasRetainedSession(session)
538
+ );
539
+ }
540
+
541
+ /** Retire one no-longer-registered session without disturbing siblings. */
542
+ async retireSession(session: string): Promise<void> {
543
+ const runtime = this.#sessions.get(session);
544
+ if (!runtime) return;
545
+ this.#sessions.delete(session);
546
+ await runtime.dispose();
547
+ }
548
+
549
+ createExecutionHandle(
550
+ consumer: SessionRuntimeConsumer,
551
+ lease: SessionRuntimeControllerLease,
552
+ allowedSourcePaneIds: readonly string[],
553
+ authorizeLiveScope?: (semanticPaneId?: string) => void,
554
+ ): SessionRuntimeExecutionHandle {
555
+ const runtime = this.#sessions.get(consumer.session);
556
+ if (!runtime || !runtime.ownsConsumer(consumer)) {
557
+ throw new SessionRuntimeControllerLeaseError(
558
+ "invalid-client-capability",
559
+ "The execution handle consumer is not owned by this daemon generation.",
560
+ );
561
+ }
562
+ runtime.assertController(lease, consumer.clientId);
563
+ const handle = Object.freeze(Object.create(null)) as object;
564
+ this.#executionHandles.set(handle, {
565
+ runtime,
566
+ consumer: consumer as SessionRuntimeConsumerImpl,
567
+ lease,
568
+ allowedSourcePaneIds: new Set(allowedSourcePaneIds),
569
+ sourceSemanticPaneId: null,
570
+ authorizeLiveScope: authorizeLiveScope ?? null,
571
+ });
572
+ return handle;
573
+ }
574
+
575
+ bindExecutionSource(
576
+ handle: SessionRuntimeExecutionHandle,
577
+ semanticPaneId: string,
578
+ ): SessionRuntimeExecutionHandle {
579
+ const state = this.#assertExecutionHandle(handle, semanticPaneId);
580
+ const bound = Object.freeze(Object.create(null)) as object;
581
+ this.#executionHandles.set(bound, { ...state, sourceSemanticPaneId: semanticPaneId });
582
+ return bound;
583
+ }
584
+
585
+ assertExecutionHandle(handle: SessionRuntimeExecutionHandle, semanticPaneId?: string): void {
586
+ this.#assertExecutionHandle(handle, semanticPaneId);
587
+ }
588
+
589
+ /** Execute one send as a separately authenticated local tmux-pane principal. */
590
+ submitPaneCredentialIntent(
591
+ session: string,
592
+ operationId: string,
593
+ rawIntent: SessionRuntimeSemanticIntent,
594
+ semanticPaneId: string,
595
+ authorizeBeforeEffect?: () => void,
596
+ ): Promise<SessionRuntimeIntentResult> {
597
+ const intent = SessionRuntimeSemanticIntentSchemaZ.parse(rawIntent);
598
+ if (intent.verb !== "workspace.pane.send") {
599
+ return Promise.reject(new Error("Pane credentials authorize pane sends only"));
600
+ }
601
+ if ((this.#resolveSession?.(intent.workspaceName) ?? null) !== session) {
602
+ return Promise.reject(
603
+ new SessionRuntimeControllerLeaseError(
604
+ "intent-session-mismatch",
605
+ "The pane credential intent does not belong to its authenticated session.",
606
+ ),
607
+ );
608
+ }
609
+ if (!this.#semanticMutations) {
610
+ return Promise.reject(new Error("Session semantic mutations are unavailable"));
611
+ }
612
+ return this.#semanticMutations.submit(
613
+ operationId,
614
+ { ...intent, sourceSemanticPaneId: semanticPaneId },
615
+ {
616
+ origin: "cli",
617
+ authenticatedSourceSemanticPaneId: semanticPaneId,
618
+ authorizeBeforeEffect,
619
+ },
620
+ );
621
+ }
622
+
623
+ submitAuthenticatedIntent(
624
+ handle: SessionRuntimeExecutionHandle,
625
+ operationId: string,
626
+ intent: SessionRuntimeSemanticIntent,
627
+ ): Promise<SessionRuntimeIntentResult> {
628
+ let state: ExecutionHandleState;
629
+ try {
630
+ state = this.#assertExecutionHandle(handle);
631
+ } catch (error) {
632
+ return Promise.reject(error);
633
+ }
634
+ let authenticatedSourceSemanticPaneId: string | null = null;
635
+ let normalizedIntent = SessionRuntimeSemanticIntentSchemaZ.parse(intent);
636
+ if (normalizedIntent.verb === "workspace.pane.send") {
637
+ if (state.sourceSemanticPaneId !== null) {
638
+ if (
639
+ normalizedIntent.sourceSemanticPaneId !== undefined &&
640
+ normalizedIntent.sourceSemanticPaneId !== state.sourceSemanticPaneId
641
+ ) {
642
+ return Promise.reject(
643
+ new SessionRuntimeControllerLeaseError(
644
+ "invalid-source-pane-binding",
645
+ "The claimed source pane does not match the authenticated transport binding.",
646
+ ),
647
+ );
648
+ }
649
+ authenticatedSourceSemanticPaneId = state.sourceSemanticPaneId;
650
+ normalizedIntent = {
651
+ ...normalizedIntent,
652
+ sourceSemanticPaneId: state.sourceSemanticPaneId,
653
+ };
654
+ } else {
655
+ const sourceLess = { ...normalizedIntent };
656
+ delete sourceLess.sourceSemanticPaneId;
657
+ normalizedIntent = sourceLess;
658
+ }
659
+ }
660
+ return this.#submitAuthorizedIntent(
661
+ state.runtime,
662
+ state.lease,
663
+ operationId,
664
+ normalizedIntent,
665
+ authenticatedSourceSemanticPaneId,
666
+ () => this.#assertExecutionHandle(handle, state.sourceSemanticPaneId ?? undefined),
667
+ authoredOriginForSurface(state.consumer.surface),
668
+ );
669
+ }
670
+
671
+ #assertExecutionHandle(
672
+ handle: SessionRuntimeExecutionHandle,
673
+ semanticPaneId?: string,
674
+ ): ExecutionHandleState {
675
+ const state = this.#executionHandles.get(handle);
676
+ if (!state) {
677
+ throw new SessionRuntimeControllerLeaseError(
678
+ "invalid-client-capability",
679
+ "The opaque execution handle is invalid for this daemon generation.",
680
+ );
681
+ }
682
+ state.runtime.assertController(state.lease, state.consumer.clientId);
683
+ if (semanticPaneId !== undefined && !state.allowedSourcePaneIds.has(semanticPaneId)) {
684
+ throw new SessionRuntimeControllerLeaseError(
685
+ "invalid-source-pane-binding",
686
+ "The source pane is outside this transport's exact daemon grant.",
687
+ );
688
+ }
689
+ state.authorizeLiveScope?.(semanticPaneId);
690
+ return state;
691
+ }
692
+
693
+ async describeSession(session: string): Promise<MirrorSessionDescription> {
694
+ return await this.#runtime(session).describe();
695
+ }
696
+
697
+ async captureNativeBacking(
698
+ session: string,
699
+ semanticPaneId: string,
700
+ expected?: NativeBackingIdentity,
701
+ ): Promise<TerminalNativeBackingResponse> {
702
+ const runtime = this.#sessions.get(session);
703
+ if (this.#disposed || !runtime) return { status: "unavailable" };
704
+ const result = await runtime.captureNativeBacking(semanticPaneId, expected);
705
+ if (this.#disposed || this.#sessions.get(session) !== runtime) return { status: "retired" };
706
+ return result;
707
+ }
708
+
709
+ async describeSessionAuthority(session: string): Promise<{
710
+ readonly description: MirrorSessionDescription;
711
+ readonly runtimeSessionId: string;
712
+ }> {
713
+ const runtime = this.#runtime(session);
714
+ await runtime.whenReady();
715
+ const authority = await this.#mirror.describeSessionAuthority(session);
716
+ if (this.#disposed || this.#sessions.get(session) !== runtime) {
717
+ const error = new Error(`session runtime ${session} changed topology`);
718
+ error.name = "MirrorTopologyChangedError";
719
+ throw error;
720
+ }
721
+ return authority;
722
+ }
723
+
724
+ async subscribeLayout(
725
+ session: string,
726
+ onLayout: (event: MirrorLayoutEvent) => void,
727
+ authority?: MirrorAuthoritativeLayoutRequest,
728
+ ): Promise<MirrorLayoutSubscription> {
729
+ const runtime = this.#runtime(session);
730
+ await runtime.whenReady();
731
+ let retired = false;
732
+ const isCurrent = (): boolean =>
733
+ !retired && !this.#disposed && this.#sessions.get(session) === runtime;
734
+ const assertCurrent = (): void => {
735
+ if (!isCurrent()) {
736
+ const error = new Error(`session runtime ${session} changed topology`);
737
+ error.name = "MirrorTopologyChangedError";
738
+ throw error;
739
+ }
740
+ };
741
+ assertCurrent();
742
+ const expectedRuntimeSessionId = authority?.expectedRuntimeSessionId;
743
+ const stagedAuthority: { value: MirrorLayoutAuthoritySnapshot | null } = { value: null };
744
+ const stagedLayouts: MirrorLayoutEvent[] = [];
745
+ let layoutOverflow = false;
746
+ let activated = false;
747
+ const subscription = await this.#mirror.subscribeLayout(
748
+ session,
749
+ (event) => {
750
+ if (!isCurrent()) return;
751
+ if (activated) onLayout(event);
752
+ else if (stagedLayouts.length < 256) stagedLayouts.push(event);
753
+ else layoutOverflow = true;
754
+ },
755
+ authority
756
+ ? {
757
+ ...authority,
758
+ onAuthority: (snapshot) => {
759
+ if (!isCurrent()) return;
760
+ if (activated) authority.onAuthority?.(snapshot);
761
+ else stagedAuthority.value = snapshot;
762
+ },
763
+ }
764
+ : undefined,
765
+ );
766
+ try {
767
+ assertCurrent();
768
+ if (
769
+ layoutOverflow ||
770
+ (authority &&
771
+ (stagedAuthority.value === null ||
772
+ stagedAuthority.value.runtimeSessionId !== expectedRuntimeSessionId))
773
+ ) {
774
+ const error = new Error(`session runtime ${session} lacks layout authority`);
775
+ error.name = "MirrorTopologyChangedError";
776
+ throw error;
777
+ }
778
+ activated = true;
779
+ if (authority?.onAuthority && stagedAuthority.value)
780
+ authority.onAuthority(stagedAuthority.value);
781
+ for (const event of stagedLayouts) onLayout(event);
782
+ } catch (error) {
783
+ await subscription.close().catch(() => undefined);
784
+ throw error;
785
+ }
786
+ return {
787
+ session,
788
+ close: async () => {
789
+ if (retired) return;
790
+ retired = true;
791
+ await subscription.close();
792
+ },
793
+ };
794
+ }
795
+
796
+ async subscribe(request: MirrorSubscribeRequest): Promise<MirrorSubscription> {
797
+ const runtime = this.#runtime(request.session);
798
+ await runtime.whenReady();
799
+ return await this.#mirror.subscribe(request);
800
+ }
801
+
802
+ #submitAuthorizedIntent(
803
+ runtime: SessionRuntime,
804
+ lease: SessionRuntimeControllerLease,
805
+ operationId: string,
806
+ rawIntent: SessionRuntimeSemanticIntent,
807
+ authenticatedSourceSemanticPaneId: string | null = null,
808
+ authorizeBeforeEffect?: () => void,
809
+ authenticatedOrigin?: AuthoredInteractionOrigin,
810
+ ): Promise<SessionRuntimeIntentResult> {
811
+ if (this.#disposed) return Promise.reject(new Error("SessionRuntimeRegistry is disposed"));
812
+ runtime.assertController(lease);
813
+ let intent = SessionRuntimeSemanticIntentSchemaZ.parse(rawIntent);
814
+ const resolvedSession = this.#resolveSession?.(intent.workspaceName) ?? null;
815
+ if (resolvedSession !== runtime.session) {
816
+ return Promise.reject(
817
+ new SessionRuntimeControllerLeaseError(
818
+ "intent-session-mismatch",
819
+ "The semantic intent does not belong to the controller lease session.",
820
+ ),
821
+ );
822
+ }
823
+ if (intent.verb === "workspace.pane.send") {
824
+ if (authenticatedSourceSemanticPaneId === null) {
825
+ // The owner bearer and a request-body pane id are not source proof.
826
+ const sourceLess = { ...intent };
827
+ delete sourceLess.sourceSemanticPaneId;
828
+ intent = sourceLess;
829
+ }
830
+ }
831
+ if (!this.#semanticMutations) {
832
+ return Promise.reject(new Error("Session semantic mutations are unavailable"));
833
+ }
834
+ return this.#semanticMutations.submit(operationId, intent, {
835
+ origin: authenticatedOrigin ?? "sdk",
836
+ authenticatedSourceSemanticPaneId,
837
+ authorizeBeforeEffect,
838
+ });
839
+ }
840
+
841
+ observeTmuxInteraction(observation: SessionRuntimeTmuxObservation): boolean {
842
+ return this.#semanticMutations?.observe(observation) ?? false;
843
+ }
844
+
845
+ onReceipt(listener: (receipt: InteractionReceipt) => void): () => void {
846
+ return this.#semanticMutations?.onReceipt(listener) ?? (() => undefined);
847
+ }
848
+
849
+ sessionCount(): number {
850
+ return this.#sessions.size;
851
+ }
852
+
853
+ activeControlChannelCount(): number {
854
+ return this.#mirror.activeChannelCount();
855
+ }
856
+
857
+ activeControllerLeaseCount(): number {
858
+ let count = 0;
859
+ for (const runtime of this.#sessions.values()) {
860
+ if (runtime.hasController()) count += 1;
861
+ }
862
+ return count;
863
+ }
864
+
865
+ authoritySnapshot(session: string): SessionRuntimeAuthoritySnapshot {
866
+ return this.#runtime(session).authoritySnapshot();
867
+ }
868
+
869
+ /** Native client activity makes an existing daemon runtime size-passive. */
870
+ noteNativeGeometryActivity(session: string): void {
871
+ this.#sessions.get(session)?.noteNativeGeometryActivity();
872
+ }
873
+
874
+ qualificationSnapshot(): SessionRuntimeQualificationSnapshot {
875
+ return Object.freeze({
876
+ generation: this.generation,
877
+ controlChannels: this.activeControlChannelCount(),
878
+ controllerLeases: this.activeControllerLeaseCount(),
879
+ sessions: Object.freeze(
880
+ [...this.#sessions.values()].map((runtime) => runtime.qualificationSnapshot()),
881
+ ),
882
+ mutations: this.#semanticMutations?.metrics() ?? null,
883
+ observability: this.#observability.snapshot(),
884
+ });
885
+ }
886
+
887
+ dispose(): Promise<void> {
888
+ if (!this.#disposePromise) {
889
+ this.#disposed = true;
890
+ this.#stopExitObserver();
891
+ this.#disposePromise = (async () => {
892
+ await this.#semanticMutations?.dispose();
893
+ await Promise.allSettled([...this.#sessions.values()].map((runtime) => runtime.dispose()));
894
+ this.#sessions.clear();
895
+ this.#proofPrewarmOwnership.clear();
896
+ await this.#mirror.dispose();
897
+ })();
898
+ }
899
+ return this.#disposePromise;
900
+ }
901
+
902
+ #runtime(session: string): SessionRuntime {
903
+ if (this.#disposed) throw new Error("SessionRuntimeRegistry is disposed");
904
+ const existing = this.#sessions.get(session);
905
+ if (existing) {
906
+ const ownership = this.#proofPrewarmOwnership.get(existing);
907
+ if (ownership) ownership.owned = false;
908
+ return existing;
909
+ }
910
+ const runtime: SessionRuntime = new SessionRuntime(
911
+ this.generation,
912
+ session,
913
+ this.#mirror,
914
+ this.#createControllerToken,
915
+ this.#scheduler,
916
+ this.#observability,
917
+ this.#createTraceCorrelator,
918
+ this.#nativeGeometryHysteresisMs,
919
+ (
920
+ owner,
921
+ lease,
922
+ operationId,
923
+ intent,
924
+ origin,
925
+ authorizeBeforeEffect,
926
+ ): Promise<SessionRuntimeIntentResult> =>
927
+ this.#submitAuthorizedIntent(
928
+ owner,
929
+ lease,
930
+ operationId,
931
+ intent,
932
+ null,
933
+ authorizeBeforeEffect,
934
+ origin,
935
+ ),
936
+ );
937
+ this.#sessions.set(session, runtime);
938
+ return runtime;
939
+ }
940
+
941
+ #acquireProofPrewarmRuntime(session: string): SessionRuntime {
942
+ const existing = this.#sessions.get(session);
943
+ const runtime = existing ?? this.#runtime(session);
944
+ const ownership = this.#proofPrewarmOwnership.get(runtime);
945
+ if (ownership) ownership.claims += 1;
946
+ else this.#proofPrewarmOwnership.set(runtime, { owned: existing === undefined, claims: 1 });
947
+ return runtime;
948
+ }
949
+
950
+ #releaseProofPrewarmRuntime(runtime: SessionRuntime): void {
951
+ const ownership = this.#proofPrewarmOwnership.get(runtime);
952
+ if (!ownership) return;
953
+ ownership.claims -= 1;
954
+ if (ownership.claims > 0) return;
955
+ this.#proofPrewarmOwnership.delete(runtime);
956
+ if (
957
+ !ownership.owned ||
958
+ this.#sessions.get(runtime.session) !== runtime ||
959
+ runtime.hasConsumers() ||
960
+ runtime.trustedInventoryQualified()
961
+ ) {
962
+ return;
963
+ }
964
+ this.#sessions.delete(runtime.session);
965
+ void runtime.dispose().catch(() => undefined);
966
+ }
967
+
968
+ async #observeTerminalAttempt<Value>(operation: string, promise: Promise<Value>): Promise<Value> {
969
+ if (!this.#observability.enabled) return promise;
970
+ let startedAtMicros: number;
971
+ try {
972
+ startedAtMicros = this.#observability.nowMicros();
973
+ } catch {
974
+ return promise;
975
+ }
976
+ try {
977
+ return await promise;
978
+ } finally {
979
+ try {
980
+ this.#observability.recordSpan(
981
+ "transport",
982
+ operation,
983
+ startedAtMicros,
984
+ this.#observability.nowMicros(),
985
+ );
986
+ } catch {
987
+ // Diagnostics never change qualification success or failure.
988
+ }
989
+ }
990
+ }
991
+ }
992
+
993
+ class SessionRuntime {
994
+ readonly #mirror: MirrorService;
995
+ readonly #consumers = new Set<SessionRuntimeConsumerImpl>();
996
+ readonly #consumersByClientId = new Map<string, SessionRuntimeConsumerImpl>();
997
+ readonly #terminalReplicas = new Map<string, SessionRuntimeTerminalReplicaOwner>();
998
+ readonly #terminalReplicaClocks = new Map<string, { epoch: number; revision: number }>();
999
+ #outputTraces: RuntimeTraceCorrelator | null;
1000
+ readonly #outputObservations = new Map<
1001
+ string,
1002
+ { readonly ageMs: number | null; readonly timing?: MirrorOutputTiming }
1003
+ >();
1004
+ readonly #createTraceCorrelator: (scheduler: SessionRuntimeScheduler) => RuntimeTraceCorrelator;
1005
+ readonly #terminalDeliveryHub: SessionRuntimeTerminalDeliveryHub;
1006
+ readonly #authority: SessionRuntimeAuthorityArbiter;
1007
+ readonly #authorityListeners = new Set<(snapshot: SessionRuntimeAuthoritySnapshot) => void>();
1008
+ readonly #scheduler: SessionRuntimeScheduler;
1009
+ readonly #observability: SessionRuntimeObservability;
1010
+ readonly #createControllerToken: () => string;
1011
+ readonly #submitAuthorized: (
1012
+ runtime: SessionRuntime,
1013
+ lease: SessionRuntimeControllerLease,
1014
+ operationId: string,
1015
+ intent: SessionRuntimeSemanticIntent,
1016
+ origin: AuthoredInteractionOrigin,
1017
+ authorizeBeforeEffect: () => void,
1018
+ ) => Promise<SessionRuntimeIntentResult>;
1019
+ #retention: Awaited<ReturnType<MirrorService["retainSession"]>> | null = null;
1020
+ #startPromise: Promise<void> | null = null;
1021
+ #restartBarrier: Promise<void> = Promise.resolve();
1022
+ #controllerClientId: string | null = null;
1023
+ #controllerToken: string | null = null;
1024
+ #controllerRevision = 0;
1025
+ readonly #completedHandoffs = new Map<string, SessionRuntimeControllerLease>();
1026
+ readonly #releasedLeases = new Set<string>();
1027
+ #disposed = false;
1028
+ #trustedInventoryRuntimeSessionId: string | null = null;
1029
+ #activeCausalCellProbes = 0;
1030
+
1031
+ constructor(
1032
+ readonly generation: SessionRuntimeGeneration,
1033
+ readonly session: string,
1034
+ mirror: MirrorService,
1035
+ createControllerToken: () => string,
1036
+ scheduler: SessionRuntimeScheduler,
1037
+ observability: SessionRuntimeObservability,
1038
+ createTraceCorrelator: (scheduler: SessionRuntimeScheduler) => RuntimeTraceCorrelator,
1039
+ nativeGeometryHysteresisMs: number | undefined,
1040
+ submitAuthorized: (
1041
+ runtime: SessionRuntime,
1042
+ lease: SessionRuntimeControllerLease,
1043
+ operationId: string,
1044
+ intent: SessionRuntimeSemanticIntent,
1045
+ origin: AuthoredInteractionOrigin,
1046
+ authorizeBeforeEffect: () => void,
1047
+ ) => Promise<SessionRuntimeIntentResult>,
1048
+ ) {
1049
+ this.#mirror = mirror;
1050
+ this.#scheduler = scheduler;
1051
+ this.#createTraceCorrelator = createTraceCorrelator;
1052
+ this.#outputTraces = observability.enabled ? createTraceCorrelator(scheduler) : null;
1053
+ this.#observability = observability;
1054
+ this.#createControllerToken = createControllerToken;
1055
+ this.#submitAuthorized = submitAuthorized;
1056
+ this.#authority = new SessionRuntimeAuthorityArbiter({
1057
+ generation,
1058
+ session,
1059
+ scheduler,
1060
+ nativeGeometryHysteresisMs,
1061
+ onGeometryAuthorityChanged: (clientId) =>
1062
+ this.#mirror.setGeometryParticipation(this.session, clientId !== null),
1063
+ onNativeGeometryYieldExpired: () => this.#publishAuthority(),
1064
+ });
1065
+ this.#terminalDeliveryHub = new SessionRuntimeTerminalDeliveryHub(
1066
+ generation,
1067
+ session,
1068
+ (semanticPaneId) => this.#terminalReplicaOwner(semanticPaneId),
1069
+ { scheduler, observability },
1070
+ );
1071
+ }
1072
+
1073
+ connect(surface: string, clientId: string): SessionRuntimeConsumer {
1074
+ if (this.#disposed) throw new Error(`SessionRuntime ${this.session} is disposed`);
1075
+ if (this.#consumersByClientId.has(clientId)) {
1076
+ throw new TypeError(`SessionRuntime client ${clientId} is already connected`);
1077
+ }
1078
+ const consumer = new SessionRuntimeConsumerImpl(this, surface, clientId);
1079
+ this.#consumers.add(consumer);
1080
+ this.#consumersByClientId.set(clientId, consumer);
1081
+ this.#authority.connect(clientId, surface);
1082
+ this.#publishAuthority();
1083
+ return consumer;
1084
+ }
1085
+
1086
+ controllerRole(clientId: string): SessionRuntimeControllerRole {
1087
+ return this.#controllerClientId === clientId ? "controller" : "viewer";
1088
+ }
1089
+
1090
+ controllerSnapshot(): SessionRuntimeControllerSnapshot {
1091
+ return {
1092
+ generation: this.generation,
1093
+ session: this.session,
1094
+ controllerClientId: this.#controllerClientId,
1095
+ revision: this.#controllerRevision,
1096
+ };
1097
+ }
1098
+
1099
+ authoritySnapshot(): SessionRuntimeAuthoritySnapshot {
1100
+ return this.#authority.snapshot();
1101
+ }
1102
+
1103
+ updatePresence(clientId: string, state: SessionRuntimePresenceState): void {
1104
+ this.#authority.updatePresence(clientId, state);
1105
+ this.#publishAuthority();
1106
+ }
1107
+
1108
+ noteActivity(clientId: string, activity: SessionRuntimeActivityKind): void {
1109
+ this.#authority.noteActivity(clientId, activity);
1110
+ this.#publishAuthority();
1111
+ }
1112
+
1113
+ acquireAuthority(
1114
+ clientId: string,
1115
+ authority: SessionRuntimeAuthorityKind,
1116
+ ): SessionRuntimeAuthorityLease | null {
1117
+ if (authority === "input" && this.#controllerClientId !== clientId) {
1118
+ // Input's executable proof is the compatibility controller lease. The
1119
+ // transport synchronization seam must establish/handoff it first.
1120
+ return null;
1121
+ }
1122
+ const lease = this.#authority.claim(clientId, authority);
1123
+ this.#publishAuthority();
1124
+ return lease;
1125
+ }
1126
+
1127
+ releaseAuthority(clientId: string, authority: SessionRuntimeAuthorityKind): void {
1128
+ if (authority === "input" && this.#controllerClientId === clientId) {
1129
+ throw new SessionRuntimeControllerLeaseError(
1130
+ "invalid-client-capability",
1131
+ "Release the executable controller before releasing input authority.",
1132
+ );
1133
+ }
1134
+ this.#authority.release(clientId, authority);
1135
+ this.#publishAuthority();
1136
+ }
1137
+
1138
+ noteNativeGeometryActivity(): void {
1139
+ this.#authority.noteNativeGeometryActivity();
1140
+ this.#publishAuthority();
1141
+ }
1142
+
1143
+ onAuthoritySnapshot(listener: (snapshot: SessionRuntimeAuthoritySnapshot) => void): () => void {
1144
+ this.#authorityListeners.add(listener);
1145
+ // A binding must start from current retained authority truth. Registration
1146
+ // is synchronous and precedes replay, so a re-entrant mutation is observed
1147
+ // after this snapshot and cannot be lost between snapshot and subscribe.
1148
+ listener(this.#authority.snapshot());
1149
+ return () => this.#authorityListeners.delete(listener);
1150
+ }
1151
+
1152
+ ownsConsumer(candidate: SessionRuntimeConsumer): boolean {
1153
+ return this.#consumers.has(candidate as SessionRuntimeConsumerImpl);
1154
+ }
1155
+
1156
+ hasController(): boolean {
1157
+ return this.#controllerClientId !== null;
1158
+ }
1159
+
1160
+ hasConsumers(): boolean {
1161
+ return this.#consumers.size > 0;
1162
+ }
1163
+
1164
+ qualificationSnapshot(): SessionRuntimeQualificationSnapshot["sessions"][number] {
1165
+ return Object.freeze({
1166
+ session: this.session,
1167
+ consumers: this.#consumers.size,
1168
+ retained: this.#retention !== null,
1169
+ delivery: this.#terminalDeliveryHub.metrics(),
1170
+ convergence: this.#terminalDeliveryHub.convergenceSnapshot(),
1171
+ replicas: Object.freeze(
1172
+ Object.fromEntries(
1173
+ [...this.#terminalReplicas.entries()].map(([paneId, owner]) => [
1174
+ paneId,
1175
+ owner.qualificationSnapshot(),
1176
+ ]),
1177
+ ),
1178
+ ),
1179
+ });
1180
+ }
1181
+
1182
+ acquireController(clientId: string): SessionRuntimeControllerLease {
1183
+ this.#assertConnected(clientId);
1184
+ if (this.#controllerClientId === clientId) {
1185
+ this.#authority.updatePresence(clientId, "foreground");
1186
+ this.#authority.claim(clientId, "input");
1187
+ return this.#currentLease();
1188
+ }
1189
+ if (this.#controllerClientId !== null) {
1190
+ throw new SessionRuntimeControllerLeaseError(
1191
+ "controller-conflict",
1192
+ `Session ${this.session} already has a controller.`,
1193
+ );
1194
+ }
1195
+ // Compatibility adapter for v1 clients: the historical controller means
1196
+ // input authority only. Geometry is acquired lazily by fitViewport and
1197
+ // shared focus is never implied by interactivity.
1198
+ this.#authority.updatePresence(clientId, "foreground");
1199
+ this.#authority.claim(clientId, "input");
1200
+ return this.#assignController(clientId);
1201
+ }
1202
+
1203
+ handoffController(
1204
+ callerClientId: string,
1205
+ lease: SessionRuntimeControllerLease,
1206
+ targetClientId: string,
1207
+ ): SessionRuntimeControllerLease {
1208
+ const candidate = this.#validatedLease(lease);
1209
+ const parsedTarget = SessionRuntimeClientIdSchemaZ.parse(targetClientId);
1210
+ const replayKey = this.#handoffKey(candidate, parsedTarget);
1211
+ const replay = this.#completedHandoffs.get(replayKey);
1212
+ if (replay && candidate.clientId === callerClientId) {
1213
+ if (this.#consumersByClientId.has(parsedTarget) && this.#isCurrentControllerLease(replay)) {
1214
+ return replay;
1215
+ }
1216
+ throw new SessionRuntimeControllerLeaseError(
1217
+ "stale-controller-lease",
1218
+ "The replayed handoff no longer names the current connected controller.",
1219
+ );
1220
+ }
1221
+ this.assertController(candidate, callerClientId);
1222
+ if (!this.#consumersByClientId.has(parsedTarget)) {
1223
+ throw new SessionRuntimeControllerLeaseError(
1224
+ "controller-target-unavailable",
1225
+ "The handoff target is not connected to this session runtime.",
1226
+ );
1227
+ }
1228
+ if (parsedTarget === this.#controllerClientId) return this.#currentLease();
1229
+ this.#authority.release(callerClientId, "input");
1230
+ this.#authority.release(callerClientId, "geometry");
1231
+ this.#authority.updatePresence(callerClientId, "background");
1232
+ this.#authority.updatePresence(parsedTarget, "foreground");
1233
+ this.#authority.claim(parsedTarget, "input");
1234
+ const handedOff = this.#assignController(parsedTarget);
1235
+ this.#completedHandoffs.set(replayKey, handedOff);
1236
+ if (this.#completedHandoffs.size > 32) {
1237
+ this.#completedHandoffs.delete(this.#completedHandoffs.keys().next().value!);
1238
+ }
1239
+ return handedOff;
1240
+ }
1241
+
1242
+ releaseController(callerClientId: string, lease: SessionRuntimeControllerLease): void {
1243
+ const candidate = this.#validatedLease(lease);
1244
+ const releaseKey = this.#leaseKey(candidate);
1245
+ if (this.#releasedLeases.has(releaseKey) && candidate.clientId === callerClientId) return;
1246
+ this.assertController(candidate, callerClientId);
1247
+ this.#releasedLeases.add(releaseKey);
1248
+ if (this.#releasedLeases.size > 32) {
1249
+ this.#releasedLeases.delete(this.#releasedLeases.values().next().value!);
1250
+ }
1251
+ this.#clearController();
1252
+ this.#authority.release(callerClientId, "input");
1253
+ this.#authority.release(callerClientId, "geometry");
1254
+ }
1255
+
1256
+ assertController(lease: SessionRuntimeControllerLease, callerClientId?: string): void {
1257
+ const parsedLease = this.#validatedLease(lease);
1258
+ if (
1259
+ parsedLease.generation !== this.generation ||
1260
+ parsedLease.session !== this.session ||
1261
+ (callerClientId !== undefined && parsedLease.clientId !== callerClientId) ||
1262
+ parsedLease.clientId !== this.#controllerClientId ||
1263
+ parsedLease.token !== this.#controllerToken ||
1264
+ parsedLease.revision !== this.#controllerRevision
1265
+ ) {
1266
+ throw new SessionRuntimeControllerLeaseError(
1267
+ "stale-controller-lease",
1268
+ "The controller lease is stale or belongs to another session generation.",
1269
+ );
1270
+ }
1271
+ }
1272
+
1273
+ submitIntent(
1274
+ callerClientId: string,
1275
+ lease: SessionRuntimeControllerLease,
1276
+ operationId: string,
1277
+ intent: SessionRuntimeSemanticIntent,
1278
+ ): Promise<SessionRuntimeIntentResult> {
1279
+ try {
1280
+ this.assertController(lease, callerClientId);
1281
+ const surface = this.#consumersByClientId.get(callerClientId)?.surface;
1282
+ if (surface === undefined) throw new Error("Session runtime consumer disappeared");
1283
+ return this.#submitAuthorized(
1284
+ this,
1285
+ lease,
1286
+ operationId,
1287
+ intent,
1288
+ authoredOriginForSurface(surface),
1289
+ () => this.assertController(lease, callerClientId),
1290
+ );
1291
+ } catch (error) {
1292
+ return Promise.reject(error);
1293
+ }
1294
+ }
1295
+
1296
+ sendInput(
1297
+ clientId: string,
1298
+ lease: SessionRuntimeControllerLease,
1299
+ semanticPaneId: string,
1300
+ rawInput: SessionRuntimeTerminalInput,
1301
+ performanceTraceId?: string,
1302
+ rawCausalProbe?: CausalCellProbeV1,
1303
+ onCausalResult?: (result: CausalCellLedgerResult) => void,
1304
+ ): void {
1305
+ this.assertController(lease, clientId);
1306
+ const inputLease = this.#authority.leaseFor(clientId, "input");
1307
+ if (!inputLease) {
1308
+ throw new SessionRuntimeControllerLeaseError(
1309
+ "stale-controller-lease",
1310
+ "The client no longer owns input authority.",
1311
+ );
1312
+ }
1313
+ const input = SessionRuntimeTerminalInputSchemaZ.parse(rawInput);
1314
+ if (performanceTraceId !== undefined) performanceTraceId = z.uuid().parse(performanceTraceId);
1315
+ const causalProbe =
1316
+ rawCausalProbe === undefined ? null : CausalCellProbeV1SchemaZ.parse(rawCausalProbe);
1317
+ if (causalProbe) {
1318
+ if (
1319
+ causalProbe.traceId !== performanceTraceId ||
1320
+ causalProbe.clientId !== clientId ||
1321
+ causalProbe.semanticPaneId !== semanticPaneId ||
1322
+ causalProbe.generation !== this.generation
1323
+ )
1324
+ throw new Error("Causal-cell authority binding mismatch");
1325
+ if (!onCausalResult) throw new Error("Causal-cell result sink is required");
1326
+ if (this.#activeCausalCellProbes >= 16) throw new Error("Causal-cell capacity exhausted");
1327
+ }
1328
+ const trace: SessionRuntimeTraceContext | null = performanceTraceId
1329
+ ? Object.freeze({
1330
+ traceId: performanceTraceId,
1331
+ scenario: "terminal-input-to-paint",
1332
+ authority: { generation: this.generation, incarnation: null },
1333
+ })
1334
+ : this.#observability.enabled
1335
+ ? this.#observability.beginTrace("terminal-input-to-paint", {
1336
+ generation: this.generation,
1337
+ incarnation: null,
1338
+ })
1339
+ : null;
1340
+ const started = this.#observability.enabled ? this.#observability.nowMicros() : 0;
1341
+ const replicaOwner = this.#terminalReplicaOwner(semanticPaneId);
1342
+ if (causalProbe) {
1343
+ this.#activeCausalCellProbes += 1;
1344
+ let settled = false;
1345
+ try {
1346
+ replicaOwner.armCausalCellProbe(causalProbe, (result) => {
1347
+ if (!settled) {
1348
+ settled = true;
1349
+ this.#activeCausalCellProbes -= 1;
1350
+ }
1351
+ onCausalResult!(result);
1352
+ });
1353
+ } catch (error) {
1354
+ this.#activeCausalCellProbes -= 1;
1355
+ throw error;
1356
+ }
1357
+ }
1358
+ if (trace && performanceTraceId) {
1359
+ this.#outputTraces ??= this.#createTraceCorrelator(this.#scheduler);
1360
+ replicaOwner.installOutputTraceReader(() => this.#takeOutputTrace(semanticPaneId));
1361
+ this.#outputTraces.arm(semanticPaneId, trace);
1362
+ }
1363
+ try {
1364
+ if (input.kind === "text")
1365
+ this.#mirror.sendText(
1366
+ this.session,
1367
+ semanticPaneId,
1368
+ input.data,
1369
+ performanceTraceId,
1370
+ causalProbe !== null,
1371
+ );
1372
+ else if (input.kind === "bytes")
1373
+ this.#mirror.sendBytes(
1374
+ this.session,
1375
+ semanticPaneId,
1376
+ Buffer.from(input.data, "hex"),
1377
+ performanceTraceId,
1378
+ );
1379
+ else this.#mirror.sendKey(this.session, semanticPaneId, input.data, performanceTraceId);
1380
+ // Admission succeeded. Arm one product write independently of optional
1381
+ // qualification traces; rejected control writes must never affect the
1382
+ // parser's next unrelated output.
1383
+ replicaOwner.prioritizeNextWrite();
1384
+ } catch (error) {
1385
+ if (causalProbe) replicaOwner.failCausalCell("transport-closed");
1386
+ if (trace && performanceTraceId) this.#outputTraces?.take(semanticPaneId);
1387
+ throw error;
1388
+ }
1389
+ if (this.#observability.enabled)
1390
+ this.#observability.recordSpan(
1391
+ "tmux",
1392
+ "raw-input-command",
1393
+ started,
1394
+ this.#observability.nowMicros(),
1395
+ trace,
1396
+ );
1397
+ if (this.#observability.enabled && trace && performanceTraceId) {
1398
+ const scheduledAt = this.#observability.nowMicros();
1399
+ setImmediate(() => {
1400
+ this.#observability.recordSpan(
1401
+ "transport",
1402
+ "daemon-event-loop-turn",
1403
+ scheduledAt,
1404
+ this.#observability.nowMicros(),
1405
+ trace,
1406
+ );
1407
+ });
1408
+ }
1409
+ }
1410
+
1411
+ failCausalCellProbe(
1412
+ semanticPaneId: string,
1413
+ traceId: string,
1414
+ reason: CausalCellFailureReasonV1,
1415
+ ): void {
1416
+ this.#terminalReplicas.get(semanticPaneId)?.failCausalCell(reason, traceId);
1417
+ }
1418
+
1419
+ noteInputControlReply(traceId: string, ok: boolean): void {
1420
+ for (const owner of this.#terminalReplicas.values())
1421
+ owner.noteCausalCellControlReply(traceId, ok);
1422
+ }
1423
+
1424
+ /**
1425
+ * Synchronous control-reader seam. SessionChannel invokes this immediately
1426
+ * before feeding the same output bytes to the terminal replica owner, so a
1427
+ * subsequent trace take observes timing for that exact output publication.
1428
+ */
1429
+ noteOutputObserved(
1430
+ semanticPaneId: string,
1431
+ ageMs: number | null,
1432
+ timing?: MirrorOutputTiming,
1433
+ ): void {
1434
+ if (!this.#observability.enabled) return;
1435
+ this.#outputObservations.set(
1436
+ semanticPaneId,
1437
+ Object.freeze({ ageMs, ...(timing ? { timing } : {}) }),
1438
+ );
1439
+ }
1440
+
1441
+ fitViewport(
1442
+ clientId: string,
1443
+ lease: SessionRuntimeControllerLease,
1444
+ cols: number,
1445
+ rows: number,
1446
+ ): void {
1447
+ this.assertController(lease, clientId);
1448
+ const geometryLease =
1449
+ this.#authority.leaseFor(clientId, "geometry") ?? this.#authority.claim(clientId, "geometry");
1450
+ if (!geometryLease) {
1451
+ throw new SessionRuntimeControllerLeaseError(
1452
+ "invalid-client-capability",
1453
+ "The client is not the foreground geometry authority.",
1454
+ );
1455
+ }
1456
+ this.#mirror.setGeometryParticipation(this.session, true);
1457
+ this.#mirror.fitViewport(this.session, cols, rows);
1458
+ }
1459
+
1460
+ fitViewportWithAuthority(
1461
+ clientId: string,
1462
+ lease: SessionRuntimeAuthorityLease,
1463
+ cols: number,
1464
+ rows: number,
1465
+ ): void {
1466
+ const parsed = SessionRuntimeAuthorityLeaseSchemaZ.parse(lease);
1467
+ let exact: SessionRuntimeAuthorityLease;
1468
+ try {
1469
+ exact = this.#authority.assertLease(parsed);
1470
+ } catch {
1471
+ throw new SessionRuntimeControllerLeaseError(
1472
+ "stale-controller-lease",
1473
+ "Geometry authority retired.",
1474
+ );
1475
+ }
1476
+ if (exact.clientId !== clientId || exact.authority !== "geometry") {
1477
+ throw new SessionRuntimeControllerLeaseError(
1478
+ "invalid-client-capability",
1479
+ "The client does not own this geometry authority lease.",
1480
+ );
1481
+ }
1482
+ this.#mirror.setGeometryParticipation(this.session, true);
1483
+ this.#mirror.fitViewport(this.session, cols, rows);
1484
+ }
1485
+
1486
+ async whenReady(): Promise<void> {
1487
+ if (this.#disposed) throw new Error(`SessionRuntime ${this.session} is disposed`);
1488
+ if (!this.#startPromise) {
1489
+ this.#startPromise = (async () => {
1490
+ await this.#restartBarrier;
1491
+ if (this.#disposed) throw new Error(`SessionRuntime ${this.session} is disposed`);
1492
+ const retention = await this.#mirror.retainSession(this.session);
1493
+ if (this.#disposed) {
1494
+ await retention.close();
1495
+ throw new Error(`SessionRuntime ${this.session} is disposed`);
1496
+ }
1497
+ this.#retention = retention;
1498
+ })().catch((error) => {
1499
+ this.#startPromise = null;
1500
+ throw error;
1501
+ });
1502
+ }
1503
+ await this.#startPromise;
1504
+ }
1505
+
1506
+ async describe(): Promise<MirrorSessionDescription> {
1507
+ await this.whenReady();
1508
+ return await this.#mirror.describeSession(this.session);
1509
+ }
1510
+
1511
+ qualifyTrustedInventory(runtimeSessionId: string): void {
1512
+ if (this.#disposed || !this.#retention) {
1513
+ throw new Error(`SessionRuntime ${this.session} is not retained`);
1514
+ }
1515
+ this.#trustedInventoryRuntimeSessionId = runtimeSessionId;
1516
+ }
1517
+
1518
+ trustedInventoryQualified(): boolean {
1519
+ return !this.#disposed && this.#trustedInventoryRuntimeSessionId !== null;
1520
+ }
1521
+
1522
+ async describeTrustedInventory(): Promise<TrustedMirrorSessionInventory | null> {
1523
+ if (!this.trustedInventoryQualified()) {
1524
+ throw new Error(`SessionRuntime ${this.session} is not inventory-qualified`);
1525
+ }
1526
+ await this.whenReady();
1527
+ const expectedRuntimeSessionId = this.#trustedInventoryRuntimeSessionId;
1528
+ if (!expectedRuntimeSessionId) return null;
1529
+ const inventory = await this.#mirror.describeTrustedInventory(
1530
+ this.session,
1531
+ expectedRuntimeSessionId,
1532
+ );
1533
+ if (
1534
+ inventory !== null &&
1535
+ inventory.runtimeSessionId !== this.#trustedInventoryRuntimeSessionId
1536
+ ) {
1537
+ return null;
1538
+ }
1539
+ if (!this.trustedInventoryQualified()) {
1540
+ throw new Error(`SessionRuntime ${this.session} changed during trusted inventory discovery`);
1541
+ }
1542
+ return inventory;
1543
+ }
1544
+
1545
+ async attachedSessionIdentity(): Promise<{
1546
+ sessionName: string;
1547
+ runtimeSessionId: string;
1548
+ } | null> {
1549
+ await this.whenReady();
1550
+ return await this.#mirror.retainedSessionIdentity(this.session);
1551
+ }
1552
+
1553
+ async subscribe(
1554
+ semanticPaneId: string,
1555
+ onEvent: (event: MirrorPaneEvent) => void,
1556
+ onLayout?: (event: MirrorLayoutEvent) => void,
1557
+ ): Promise<MirrorSubscription> {
1558
+ await this.whenReady();
1559
+ return await this.#mirror.subscribe({
1560
+ session: this.session,
1561
+ semanticPaneId,
1562
+ onEvent,
1563
+ onLayout,
1564
+ });
1565
+ }
1566
+
1567
+ async subscribeReplica(
1568
+ semanticPaneId: string,
1569
+ onUpdate: (update: CanonicalTerminalReplicaUpdate) => void,
1570
+ ): Promise<TerminalReplicaSubscription> {
1571
+ await this.whenReady();
1572
+ // A replacement parser must never overlap the faulted owner's terminal or
1573
+ // revision epoch. This is intentionally separate from transport readiness:
1574
+ // the retained tmux channel may remain healthy while one pane parser fails.
1575
+ await this.#restartBarrier;
1576
+ const owner = this.#terminalReplicaOwner(semanticPaneId);
1577
+ try {
1578
+ return await owner.subscribe(onUpdate);
1579
+ } catch (error) {
1580
+ if (this.#terminalReplicas.get(semanticPaneId) === owner) {
1581
+ this.#terminalReplicas.delete(semanticPaneId);
1582
+ }
1583
+ await owner.dispose("session-restarted");
1584
+ throw error;
1585
+ }
1586
+ }
1587
+
1588
+ async captureNativeBacking(
1589
+ semanticPaneId: string,
1590
+ expected?: NativeBackingIdentity,
1591
+ ): Promise<TerminalNativeBackingResponse> {
1592
+ const owner = this.#terminalReplicas.get(semanticPaneId);
1593
+ if (!owner) return { status: "unavailable" };
1594
+ const retained = expected
1595
+ ? this.#terminalDeliveryHub.retainedNativeBacking(semanticPaneId, expected)
1596
+ : null;
1597
+ return retained ?? (await owner.captureNativeBacking());
1598
+ }
1599
+
1600
+ async openTerminalDelivery(
1601
+ clientId: string,
1602
+ surface: string,
1603
+ deliverySubscriberId: string,
1604
+ deliveryRequestId: string,
1605
+ semanticPaneId: string,
1606
+ offer: TerminalDeliveryOffer,
1607
+ onMessage: (message: TerminalDeliveryServerMessage) => void | Promise<void>,
1608
+ ): Promise<TerminalDeliveryConnection> {
1609
+ await this.whenReady();
1610
+ await this.#restartBarrier;
1611
+ this.#assertConnected(clientId);
1612
+ return await this.#terminalDeliveryHub.open(
1613
+ deliverySubscriberId,
1614
+ semanticPaneId,
1615
+ offer,
1616
+ onMessage,
1617
+ Object.freeze({
1618
+ clientId,
1619
+ surface,
1620
+ laneId: deliverySubscriberId,
1621
+ requestId: deliveryRequestId,
1622
+ }),
1623
+ );
1624
+ }
1625
+
1626
+ #terminalReplicaOwner(semanticPaneId: string): SessionRuntimeTerminalReplicaOwner {
1627
+ let owner = this.#terminalReplicas.get(semanticPaneId);
1628
+ if (!owner) {
1629
+ this.#outputTraces?.clearPane(semanticPaneId);
1630
+ const clock = this.#terminalReplicaClocks.get(semanticPaneId) ?? { epoch: 0, revision: -1 };
1631
+ const initialRevision = clock.revision + 1;
1632
+ let candidate: SessionRuntimeTerminalReplicaOwner;
1633
+ candidate = new SessionRuntimeTerminalReplicaOwner(
1634
+ this.generation,
1635
+ this.session,
1636
+ semanticPaneId,
1637
+ this.#mirror,
1638
+ {
1639
+ incarnation: `${this.generation}:${clock.epoch}`,
1640
+ initialRevision,
1641
+ onRevision: (revision) => {
1642
+ const current = this.#terminalReplicaClocks.get(semanticPaneId) ?? clock;
1643
+ if (revision > current.revision) current.revision = revision;
1644
+ this.#terminalReplicaClocks.set(semanticPaneId, current);
1645
+ },
1646
+ onClosed: () => {
1647
+ if (this.#terminalReplicas.get(semanticPaneId) !== candidate) return;
1648
+ this.#outputTraces?.clearPane(semanticPaneId);
1649
+ this.#terminalReplicas.delete(semanticPaneId);
1650
+ const current = this.#terminalReplicaClocks.get(semanticPaneId) ?? clock;
1651
+ current.epoch += 1;
1652
+ this.#terminalReplicaClocks.set(semanticPaneId, current);
1653
+ },
1654
+ onFault: () => {
1655
+ if (this.#terminalReplicas.get(semanticPaneId) !== candidate) return;
1656
+ this.#outputTraces?.clearPane(semanticPaneId);
1657
+ this.#terminalReplicas.delete(semanticPaneId);
1658
+ this.#restartBarrier = this.#restartBarrier.then(async () => {
1659
+ await candidate.dispose("session-restarted");
1660
+ const current = this.#terminalReplicaClocks.get(semanticPaneId) ?? clock;
1661
+ current.epoch += 1;
1662
+ this.#terminalReplicaClocks.set(semanticPaneId, current);
1663
+ });
1664
+ },
1665
+ scheduler: this.#scheduler,
1666
+ observability: this.#observability,
1667
+ ...(this.#outputTraces
1668
+ ? { takeOutputTrace: () => this.#takeOutputTrace(semanticPaneId) }
1669
+ : {}),
1670
+ },
1671
+ );
1672
+ owner = candidate;
1673
+ this.#terminalReplicas.set(semanticPaneId, owner);
1674
+ }
1675
+ return owner;
1676
+ }
1677
+
1678
+ #takeOutputTrace(semanticPaneId: string): SessionRuntimeTraceContext | null {
1679
+ const pending = this.#outputTraces?.take(semanticPaneId) ?? null;
1680
+ if (!pending) return null;
1681
+ const incarnation = this.#terminalReplicas
1682
+ .get(semanticPaneId)
1683
+ ?.qualificationSnapshot().incarnation;
1684
+ const authority = { generation: this.generation, incarnation: incarnation ?? null };
1685
+ if (!this.#observability.enabled) return Object.freeze({ ...pending, authority });
1686
+ const trace = this.#observability.beginTrace(pending.scenario, authority, pending.traceId);
1687
+ const observation = this.#outputObservations.get(semanticPaneId);
1688
+ this.#outputObservations.delete(semanticPaneId);
1689
+ if (trace && observation) {
1690
+ const observedAtMicros = this.#observability.nowMicros();
1691
+ if (observation.ageMs !== null) {
1692
+ this.#observability.recordSpan(
1693
+ "tmux",
1694
+ "tmux-output-server-age",
1695
+ observedAtMicros - observation.ageMs * 1_000,
1696
+ observedAtMicros,
1697
+ trace,
1698
+ );
1699
+ }
1700
+ if (observation.timing) {
1701
+ this.#observability.recordSpan(
1702
+ "parse",
1703
+ "control-stdout-parse",
1704
+ observation.timing.receivedAtMicros,
1705
+ observation.timing.parsedAtMicros,
1706
+ trace,
1707
+ );
1708
+ this.#observability.recordSpan(
1709
+ "reduce",
1710
+ "control-output-to-replica",
1711
+ observation.timing.parsedAtMicros,
1712
+ observedAtMicros,
1713
+ trace,
1714
+ );
1715
+ }
1716
+ }
1717
+ return trace;
1718
+ }
1719
+
1720
+ release(consumer: SessionRuntimeConsumerImpl): void {
1721
+ this.#consumers.delete(consumer);
1722
+ if (this.#consumersByClientId.get(consumer.clientId) === consumer) {
1723
+ this.#consumersByClientId.delete(consumer.clientId);
1724
+ }
1725
+ if (this.#controllerClientId === consumer.clientId) this.#clearController();
1726
+ this.#authority.disconnect(consumer.clientId);
1727
+ this.#publishAuthority();
1728
+ }
1729
+
1730
+ noteControlExit(): void {
1731
+ this.#trustedInventoryRuntimeSessionId = null;
1732
+ const retention = this.#retention;
1733
+ this.#retention = null;
1734
+ this.#startPromise = null;
1735
+ this.#outputTraces?.clear();
1736
+ this.#outputObservations.clear();
1737
+ const owners = [...this.#terminalReplicas.values()];
1738
+ this.#terminalReplicas.clear();
1739
+ this.#restartBarrier = this.#restartBarrier.then(async () => {
1740
+ await this.#terminalDeliveryHub.resetForSessionRestart();
1741
+ await Promise.allSettled(owners.map((owner) => owner.dispose("session-restarted")));
1742
+ await retention?.close();
1743
+ for (const clock of this.#terminalReplicaClocks.values()) clock.epoch += 1;
1744
+ });
1745
+ }
1746
+
1747
+ async dispose(): Promise<void> {
1748
+ if (this.#disposed) return;
1749
+ this.#disposed = true;
1750
+ this.#trustedInventoryRuntimeSessionId = null;
1751
+ const consumers = [...this.#consumers];
1752
+ await Promise.allSettled(consumers.map((consumer) => consumer.close()));
1753
+ this.#clearController();
1754
+ this.#authority.dispose();
1755
+ this.#authorityListeners.clear();
1756
+ this.#completedHandoffs.clear();
1757
+ this.#releasedLeases.clear();
1758
+ this.#outputTraces?.clear();
1759
+ await Promise.allSettled(
1760
+ [...this.#terminalReplicas.values()].map((owner) => owner.dispose("runtime-disposed")),
1761
+ );
1762
+ this.#terminalReplicas.clear();
1763
+ await this.#terminalDeliveryHub.close();
1764
+ await this.#startPromise?.catch(() => undefined);
1765
+ await this.#restartBarrier;
1766
+ await this.#retention?.close();
1767
+ this.#retention = null;
1768
+ }
1769
+
1770
+ #assertConnected(clientId: string): void {
1771
+ if (!this.#consumersByClientId.has(clientId)) {
1772
+ throw new SessionRuntimeControllerLeaseError(
1773
+ "controller-target-unavailable",
1774
+ "The controller client is not connected to this session runtime.",
1775
+ );
1776
+ }
1777
+ }
1778
+
1779
+ #assignController(clientId: string): SessionRuntimeControllerLease {
1780
+ this.#controllerRevision += 1;
1781
+ this.#controllerClientId = clientId;
1782
+ this.#controllerToken = z.uuid().parse(this.#createControllerToken());
1783
+ return this.#currentLease();
1784
+ }
1785
+
1786
+ #clearController(): void {
1787
+ if (this.#controllerClientId === null && this.#controllerToken === null) return;
1788
+ this.#controllerRevision += 1;
1789
+ this.#controllerClientId = null;
1790
+ this.#controllerToken = null;
1791
+ }
1792
+
1793
+ #currentLease(): SessionRuntimeControllerLease {
1794
+ if (this.#controllerClientId === null || this.#controllerToken === null) {
1795
+ throw new SessionRuntimeControllerLeaseError(
1796
+ "stale-controller-lease",
1797
+ "The session has no active controller.",
1798
+ );
1799
+ }
1800
+ return {
1801
+ generation: this.generation,
1802
+ session: this.session,
1803
+ clientId: this.#controllerClientId,
1804
+ token: this.#controllerToken,
1805
+ revision: this.#controllerRevision,
1806
+ };
1807
+ }
1808
+
1809
+ #handoffKey(lease: SessionRuntimeControllerLease, targetClientId: string): string {
1810
+ return `${this.#leaseKey(lease)}\0${targetClientId}`;
1811
+ }
1812
+
1813
+ #leaseKey(lease: SessionRuntimeControllerLease): string {
1814
+ return `${lease.generation}\0${lease.session}\0${lease.clientId}\0${lease.token}\0${lease.revision}`;
1815
+ }
1816
+
1817
+ #isCurrentControllerLease(lease: SessionRuntimeControllerLease): boolean {
1818
+ return (
1819
+ lease.generation === this.generation &&
1820
+ lease.session === this.session &&
1821
+ lease.clientId === this.#controllerClientId &&
1822
+ lease.token === this.#controllerToken &&
1823
+ lease.revision === this.#controllerRevision
1824
+ );
1825
+ }
1826
+
1827
+ #validatedLease(lease: SessionRuntimeControllerLease): SessionRuntimeControllerLease {
1828
+ const parsed = SessionRuntimeControllerLeaseSchemaZ.safeParse(lease);
1829
+ if (!parsed.success) {
1830
+ throw new SessionRuntimeControllerLeaseError(
1831
+ "stale-controller-lease",
1832
+ "The controller lease is malformed or belongs to another session generation.",
1833
+ );
1834
+ }
1835
+ return parsed.data;
1836
+ }
1837
+
1838
+ #publishAuthority(): void {
1839
+ if (this.#disposed) return;
1840
+ const snapshot = this.#authority.snapshot();
1841
+ for (const listener of this.#authorityListeners) listener(snapshot);
1842
+ }
1843
+ }
1844
+
1845
+ class SessionRuntimeConsumerImpl implements SessionRuntimeConsumer {
1846
+ readonly #runtime: SessionRuntime;
1847
+ readonly generation: SessionRuntimeGeneration;
1848
+ readonly session: string;
1849
+ readonly clientId: string;
1850
+ readonly #subscriptions = new Set<MirrorSubscription>();
1851
+ readonly #replicaSubscriptions = new Set<TerminalReplicaSubscription>();
1852
+ readonly #deliveryConnections = new Set<TerminalDeliveryConnection>();
1853
+ #closed = false;
1854
+
1855
+ constructor(
1856
+ runtime: SessionRuntime,
1857
+ readonly surface: string,
1858
+ clientId: string,
1859
+ ) {
1860
+ this.#runtime = runtime;
1861
+ this.generation = runtime.generation;
1862
+ this.session = runtime.session;
1863
+ this.clientId = clientId;
1864
+ }
1865
+
1866
+ controllerRole(): SessionRuntimeControllerRole {
1867
+ this.#assertOpen();
1868
+ return this.#runtime.controllerRole(this.clientId);
1869
+ }
1870
+
1871
+ controllerSnapshot(): SessionRuntimeControllerSnapshot {
1872
+ this.#assertOpen();
1873
+ return this.#runtime.controllerSnapshot();
1874
+ }
1875
+
1876
+ authoritySnapshot(): SessionRuntimeAuthoritySnapshot {
1877
+ this.#assertOpen();
1878
+ return this.#runtime.authoritySnapshot();
1879
+ }
1880
+
1881
+ onAuthoritySnapshot(listener: (snapshot: SessionRuntimeAuthoritySnapshot) => void): () => void {
1882
+ this.#assertOpen();
1883
+ return this.#runtime.onAuthoritySnapshot(listener);
1884
+ }
1885
+
1886
+ updatePresence(state: SessionRuntimePresenceState): void {
1887
+ this.#assertOpen();
1888
+ this.#runtime.updatePresence(this.clientId, state);
1889
+ }
1890
+
1891
+ noteActivity(activity: SessionRuntimeActivityKind): void {
1892
+ this.#assertOpen();
1893
+ this.#runtime.noteActivity(this.clientId, activity);
1894
+ }
1895
+
1896
+ acquireAuthority(authority: SessionRuntimeAuthorityKind): SessionRuntimeAuthorityLease | null {
1897
+ this.#assertOpen();
1898
+ return this.#runtime.acquireAuthority(this.clientId, authority);
1899
+ }
1900
+
1901
+ releaseAuthority(authority: SessionRuntimeAuthorityKind): void {
1902
+ this.#assertOpen();
1903
+ this.#runtime.releaseAuthority(this.clientId, authority);
1904
+ }
1905
+
1906
+ acquireController(): SessionRuntimeControllerLease {
1907
+ this.#assertOpen();
1908
+ return this.#runtime.acquireController(this.clientId);
1909
+ }
1910
+
1911
+ handoffController(
1912
+ lease: SessionRuntimeControllerLease,
1913
+ targetClientId: string,
1914
+ ): SessionRuntimeControllerLease {
1915
+ this.#assertOpen();
1916
+ return this.#runtime.handoffController(this.clientId, lease, targetClientId);
1917
+ }
1918
+
1919
+ releaseController(lease: SessionRuntimeControllerLease): void {
1920
+ this.#assertOpen();
1921
+ this.#runtime.releaseController(this.clientId, lease);
1922
+ }
1923
+
1924
+ submitIntent(
1925
+ lease: SessionRuntimeControllerLease,
1926
+ operationId: string,
1927
+ intent: SessionRuntimeSemanticIntent,
1928
+ ): Promise<SessionRuntimeIntentResult> {
1929
+ this.#assertOpen();
1930
+ return this.#runtime.submitIntent(this.clientId, lease, operationId, intent);
1931
+ }
1932
+
1933
+ sendInput(
1934
+ lease: SessionRuntimeControllerLease,
1935
+ semanticPaneId: string,
1936
+ input: SessionRuntimeTerminalInput,
1937
+ performanceTraceId?: string,
1938
+ causalProbe?: CausalCellProbeV1,
1939
+ onCausalResult?: (result: CausalCellLedgerResult) => void,
1940
+ ): void {
1941
+ this.#assertOpen();
1942
+ this.#runtime.sendInput(
1943
+ this.clientId,
1944
+ lease,
1945
+ semanticPaneId,
1946
+ input,
1947
+ performanceTraceId,
1948
+ causalProbe,
1949
+ onCausalResult,
1950
+ );
1951
+ }
1952
+
1953
+ failCausalCellProbe(
1954
+ semanticPaneId: string,
1955
+ traceId: string,
1956
+ reason: CausalCellFailureReasonV1,
1957
+ ): void {
1958
+ this.#runtime.failCausalCellProbe(semanticPaneId, traceId, reason);
1959
+ }
1960
+
1961
+ fitViewport(lease: SessionRuntimeControllerLease, cols: number, rows: number): void {
1962
+ this.#assertOpen();
1963
+ this.#runtime.fitViewport(this.clientId, lease, cols, rows);
1964
+ }
1965
+
1966
+ fitViewportWithAuthority(lease: SessionRuntimeAuthorityLease, cols: number, rows: number): void {
1967
+ this.#assertOpen();
1968
+ this.#runtime.fitViewportWithAuthority(this.clientId, lease, cols, rows);
1969
+ }
1970
+
1971
+ async describe(): Promise<MirrorSessionDescription> {
1972
+ this.#assertOpen();
1973
+ return await this.#runtime.describe();
1974
+ }
1975
+
1976
+ async subscribe(
1977
+ semanticPaneId: string,
1978
+ onEvent: (event: MirrorPaneEvent) => void,
1979
+ onLayout?: (event: MirrorLayoutEvent) => void,
1980
+ ): Promise<MirrorSubscription> {
1981
+ this.#assertOpen();
1982
+ const upstream = await this.#runtime.subscribe(semanticPaneId, onEvent, onLayout);
1983
+ if (this.#closed) {
1984
+ await upstream.close();
1985
+ throw new Error(`SessionRuntime consumer ${this.surface} is closed`);
1986
+ }
1987
+ let closed = false;
1988
+ const subscription: MirrorSubscription = {
1989
+ ...upstream,
1990
+ close: async () => {
1991
+ if (closed) return;
1992
+ closed = true;
1993
+ this.#subscriptions.delete(subscription);
1994
+ await upstream.close();
1995
+ },
1996
+ };
1997
+ this.#subscriptions.add(subscription);
1998
+ return subscription;
1999
+ }
2000
+
2001
+ async subscribeReplica(
2002
+ semanticPaneId: string,
2003
+ onUpdate: (update: CanonicalTerminalReplicaUpdate) => void,
2004
+ ): Promise<TerminalReplicaSubscription> {
2005
+ this.#assertOpen();
2006
+ const upstream = await this.#runtime.subscribeReplica(semanticPaneId, onUpdate);
2007
+ if (this.#closed) {
2008
+ await upstream.close();
2009
+ throw new Error(`SessionRuntime consumer ${this.surface} is closed`);
2010
+ }
2011
+ let closed = false;
2012
+ const subscription: TerminalReplicaSubscription = {
2013
+ ...upstream,
2014
+ close: async () => {
2015
+ if (closed) return;
2016
+ closed = true;
2017
+ this.#replicaSubscriptions.delete(subscription);
2018
+ await upstream.close();
2019
+ },
2020
+ };
2021
+ this.#replicaSubscriptions.add(subscription);
2022
+ return subscription;
2023
+ }
2024
+
2025
+ async openTerminalDelivery(
2026
+ deliverySubscriberId: string,
2027
+ deliveryRequestId: string,
2028
+ semanticPaneId: string,
2029
+ offer: TerminalDeliveryOffer,
2030
+ onMessage: (message: TerminalDeliveryServerMessage) => void | Promise<void>,
2031
+ ): Promise<TerminalDeliveryConnection> {
2032
+ this.#assertOpen();
2033
+ const upstream = await this.#runtime.openTerminalDelivery(
2034
+ this.clientId,
2035
+ this.surface,
2036
+ deliverySubscriberId,
2037
+ deliveryRequestId,
2038
+ semanticPaneId,
2039
+ offer,
2040
+ onMessage,
2041
+ );
2042
+ if (this.#closed) {
2043
+ await upstream.close();
2044
+ throw new Error(`SessionRuntime consumer ${this.surface} is closed`);
2045
+ }
2046
+ let closed = false;
2047
+ const connection: TerminalDeliveryConnection = {
2048
+ negotiation: upstream.negotiation,
2049
+ closed: upstream.closed,
2050
+ ack: (ack: TerminalDeliveryAck) => upstream.ack(ack),
2051
+ nack: (nack: TerminalDeliveryNack) => upstream.nack(nack),
2052
+ setVisibility: (visibility: TerminalDeliveryVisibility) => upstream.setVisibility(visibility),
2053
+ close: async () => {
2054
+ if (closed) return;
2055
+ closed = true;
2056
+ this.#deliveryConnections.delete(connection);
2057
+ await upstream.close();
2058
+ },
2059
+ };
2060
+ this.#deliveryConnections.add(connection);
2061
+ return connection;
2062
+ }
2063
+
2064
+ async close(): Promise<void> {
2065
+ if (this.#closed) return;
2066
+ this.#closed = true;
2067
+ const subscriptions = [...this.#subscriptions];
2068
+ const replicaSubscriptions = [...this.#replicaSubscriptions];
2069
+ const deliveryConnections = [...this.#deliveryConnections];
2070
+ this.#subscriptions.clear();
2071
+ this.#replicaSubscriptions.clear();
2072
+ this.#deliveryConnections.clear();
2073
+ // Authority retirement is synchronous. A slow/frozen mirror subscription
2074
+ // must never keep controller leases or previously issued handles alive.
2075
+ this.#runtime.release(this);
2076
+ await Promise.allSettled(subscriptions.map((subscription) => subscription.close()));
2077
+ await Promise.allSettled(replicaSubscriptions.map((subscription) => subscription.close()));
2078
+ await Promise.allSettled(deliveryConnections.map((connection) => connection.close()));
2079
+ }
2080
+
2081
+ #assertOpen(): void {
2082
+ if (this.#closed) throw new Error(`SessionRuntime consumer ${this.surface} is closed`);
2083
+ }
2084
+ }