tmux-ide 2.7.0 → 2.9.0-beta.5

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 (1746) hide show
  1. package/README.md +95 -115
  2. package/bin/cli.js +69987 -11819
  3. package/bin/cli.ts +772 -114
  4. package/package.json +64 -30
  5. package/packages/contracts/package.json +3 -2
  6. package/packages/contracts/src/__tests__/actions-contract.test.ts +119 -0
  7. package/packages/contracts/src/__tests__/agent-graph-overlay.test.ts +428 -0
  8. package/packages/contracts/src/__tests__/app-window-mutation.test.ts +51 -0
  9. package/packages/contracts/src/__tests__/app-window-state.test.ts +34 -0
  10. package/packages/contracts/src/__tests__/application-shell.test.ts +635 -0
  11. package/packages/contracts/src/__tests__/causal-cell.test.ts +47 -0
  12. package/packages/contracts/src/__tests__/client-view-state.test.ts +115 -0
  13. package/packages/contracts/src/__tests__/cohesion-fixture.test.ts +106 -0
  14. package/packages/contracts/src/__tests__/commands.test.ts +86 -0
  15. package/packages/contracts/src/__tests__/control.test.ts +154 -0
  16. package/packages/contracts/src/__tests__/daemon-events.test.ts +400 -0
  17. package/packages/contracts/src/__tests__/daemon-resources.test.ts +143 -0
  18. package/packages/contracts/src/__tests__/daemon-wire.test.ts +117 -0
  19. package/packages/contracts/src/__tests__/desktop-host.test.ts +269 -0
  20. package/packages/contracts/src/__tests__/desktop-missions.test.ts +211 -0
  21. package/packages/contracts/src/__tests__/experience-conformance.test.ts +153 -0
  22. package/packages/contracts/src/__tests__/experience-kernel-boundary.test.ts +109 -0
  23. package/packages/contracts/src/__tests__/experience-shell.test.ts +65 -0
  24. package/packages/contracts/src/__tests__/fixtures/daemon-wire-v2.json +35 -0
  25. package/packages/contracts/src/__tests__/fleet-agent-graph.test.ts +231 -0
  26. package/packages/contracts/src/__tests__/fleet-catalog.test.ts +268 -0
  27. package/packages/contracts/src/__tests__/fleet-lifecycle.test.ts +62 -0
  28. package/packages/contracts/src/__tests__/focus-overlay.test.ts +110 -0
  29. package/packages/contracts/src/__tests__/ide-config.test.ts +18 -0
  30. package/packages/contracts/src/__tests__/issue-error.test.ts +78 -0
  31. package/packages/contracts/src/__tests__/mission-projections.test.ts +186 -0
  32. package/packages/contracts/src/__tests__/missions.test.ts +272 -0
  33. package/packages/contracts/src/__tests__/multiplexer-verbs.test.ts +240 -0
  34. package/packages/contracts/src/__tests__/pane-appearance.test.ts +146 -0
  35. package/packages/contracts/src/__tests__/pane-stream.test.ts +466 -0
  36. package/packages/contracts/src/__tests__/pane-widget-marker.test.ts +327 -0
  37. package/packages/contracts/src/__tests__/performance-metrics.test.ts +73 -0
  38. package/packages/contracts/src/__tests__/performance-qualification.test.ts +137 -0
  39. package/packages/contracts/src/__tests__/rich-card-widget.test.ts +29 -0
  40. package/packages/contracts/src/__tests__/session-runtime.test.ts +490 -0
  41. package/packages/contracts/src/__tests__/startup-readiness.test.ts +409 -0
  42. package/packages/contracts/src/__tests__/terminal-attachment-stream.test.ts +72 -0
  43. package/packages/contracts/src/__tests__/terminal-attachments.test.ts +329 -0
  44. package/packages/contracts/src/__tests__/terminal-delivery.test.ts +88 -0
  45. package/packages/contracts/src/__tests__/terminal-runtime-inventory.test.ts +68 -0
  46. package/packages/contracts/src/__tests__/visual-tokens.test.ts +224 -0
  47. package/packages/contracts/src/__tests__/workspace-changes-resource.test.ts +317 -0
  48. package/packages/contracts/src/__tests__/workspace-changes-view.test.ts +122 -0
  49. package/packages/contracts/src/__tests__/workspace-config.test.ts +294 -0
  50. package/packages/contracts/src/__tests__/workspace-files-resource.test.ts +261 -0
  51. package/packages/contracts/src/__tests__/workspace-files-tree.test.ts +147 -0
  52. package/packages/contracts/src/__tests__/workspace-pane-creation.test.ts +249 -0
  53. package/packages/contracts/src/__tests__/workspace-promotion.test.ts +94 -0
  54. package/packages/contracts/src/__tests__/workspace-resource-identity.test.ts +90 -0
  55. package/packages/contracts/src/actions-contract.ts +205 -0
  56. package/packages/contracts/src/actions-errors.ts +20 -0
  57. package/packages/contracts/src/agent-graph-overlay.ts +425 -0
  58. package/packages/contracts/src/app-window-mutation.ts +103 -0
  59. package/packages/contracts/src/app-window-state.ts +446 -0
  60. package/packages/contracts/src/application-shell-resource.ts +54 -0
  61. package/packages/contracts/src/application-shell.ts +1094 -0
  62. package/packages/contracts/src/causal-cell.ts +168 -0
  63. package/packages/contracts/src/client-view-state.ts +156 -0
  64. package/packages/contracts/src/cohesion-fixture.ts +647 -0
  65. package/packages/contracts/src/commands.ts +153 -0
  66. package/packages/contracts/src/control.ts +217 -0
  67. package/packages/contracts/src/daemon-events.ts +374 -0
  68. package/packages/contracts/src/daemon-resource-request.test.ts +192 -0
  69. package/packages/contracts/src/daemon-resource-request.ts +397 -0
  70. package/packages/contracts/src/daemon-resources.ts +108 -0
  71. package/packages/contracts/src/daemon-wire.ts +100 -0
  72. package/packages/contracts/src/desktop-daemon-issue.ts +83 -0
  73. package/packages/contracts/src/desktop-host.ts +746 -0
  74. package/packages/contracts/src/desktop-missions.ts +159 -0
  75. package/packages/contracts/src/desktop-update.ts +48 -0
  76. package/packages/contracts/src/desktop-workspace-name.ts +18 -0
  77. package/packages/contracts/src/domain.ts +493 -0
  78. package/packages/contracts/src/experience-identifiers.ts +53 -0
  79. package/packages/contracts/src/experience-shell.ts +249 -0
  80. package/packages/contracts/src/fleet-agent-graph.ts +171 -0
  81. package/packages/contracts/src/fleet-catalog.ts +190 -0
  82. package/packages/contracts/src/fleet-lifecycle.ts +136 -0
  83. package/packages/contracts/src/focus-overlay.ts +175 -0
  84. package/packages/contracts/src/ide-config.ts +40 -20
  85. package/packages/contracts/src/index.ts +60 -0
  86. package/packages/contracts/src/interaction-receipts.ts +438 -0
  87. package/packages/contracts/src/issue-error.ts +107 -0
  88. package/packages/contracts/src/mission-projections.ts +269 -0
  89. package/packages/contracts/src/multiplexer-verbs.ts +447 -0
  90. package/packages/contracts/src/pane-appearance.ts +248 -0
  91. package/packages/contracts/src/pane-stream.ts +709 -0
  92. package/packages/contracts/src/pane-widget-descriptor.ts +62 -0
  93. package/packages/contracts/src/pane-widget-marker.ts +301 -0
  94. package/packages/contracts/src/performance-metrics.ts +128 -0
  95. package/packages/contracts/src/performance-qualification.ts +276 -0
  96. package/packages/contracts/src/rich-card-widget.ts +72 -0
  97. package/packages/contracts/src/semantic-identity.ts +39 -0
  98. package/packages/contracts/src/session-runtime.ts +351 -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-tokens.ts +883 -0
  108. package/packages/contracts/src/widget-asset.ts +43 -0
  109. package/packages/contracts/src/workspace-catalog-resource.test.ts +146 -0
  110. package/packages/contracts/src/workspace-catalog-resource.ts +180 -0
  111. package/packages/contracts/src/workspace-changes-resource.ts +405 -0
  112. package/packages/contracts/src/workspace-changes-view.ts +195 -0
  113. package/packages/contracts/src/workspace-config.ts +303 -0
  114. package/packages/contracts/src/workspace-files-resource.ts +310 -0
  115. package/packages/contracts/src/workspace-files-tree.ts +167 -0
  116. package/packages/contracts/src/workspace-missions-resource.ts +32 -0
  117. package/packages/contracts/src/workspace-multiplexer.ts +373 -0
  118. package/packages/contracts/src/workspace-open-handoff.ts +99 -0
  119. package/packages/contracts/src/workspace-open.ts +64 -0
  120. package/packages/contracts/src/workspace-pane-creation.ts +223 -0
  121. package/packages/contracts/src/workspace-promotion.ts +109 -0
  122. package/packages/contracts/src/workspace-resource-identity.ts +81 -0
  123. package/packages/contracts/src/workspace-state.ts +530 -0
  124. package/packages/contracts/src/workspace.ts +14 -2
  125. package/packages/core/package.json +35 -0
  126. package/packages/core/src/agent-provisioning.test.ts +42 -0
  127. package/packages/core/src/agent-provisioning.ts +112 -0
  128. package/packages/core/src/app-window-identity.ts +33 -0
  129. package/packages/core/src/application-shell-session.test.ts +105 -0
  130. package/packages/core/src/application-shell-session.ts +195 -0
  131. package/packages/core/src/index.ts +15 -0
  132. package/packages/core/src/interaction-flow.test.ts +66 -0
  133. package/packages/core/src/interaction-flow.ts +159 -0
  134. package/packages/core/src/interaction-receipts.test.ts +361 -0
  135. package/packages/core/src/interaction-receipts.ts +335 -0
  136. package/packages/core/src/navigator.test.ts +34 -0
  137. package/packages/core/src/navigator.ts +74 -0
  138. package/packages/core/src/optimistic-projection-conformance.test.ts +75 -0
  139. package/packages/core/src/optimistic-projection-conformance.ts +61 -0
  140. package/packages/core/src/optimistic-projection-store.ts +71 -0
  141. package/packages/core/src/optimistic-projection.test.ts +118 -0
  142. package/packages/core/src/optimistic-projection.ts +194 -0
  143. package/packages/core/src/performance-metrics.test.ts +121 -0
  144. package/packages/core/src/performance-metrics.ts +241 -0
  145. package/packages/core/src/performance-qualification.test.ts +283 -0
  146. package/packages/core/src/performance-qualification.ts +360 -0
  147. package/packages/core/src/terminal-compact-capability.ts +31 -0
  148. package/packages/core/src/terminal-compact-cold.test.ts +87 -0
  149. package/packages/core/src/terminal-conformance.test.ts +48 -0
  150. package/packages/core/src/terminal-conformance.ts +405 -0
  151. package/packages/core/src/terminal-delivery.test.ts +1196 -0
  152. package/packages/core/src/terminal-delivery.ts +2918 -0
  153. package/packages/core/src/terminal-replica-cold.test.ts +31 -0
  154. package/packages/core/src/terminal-replica-hash-cache.test.ts +201 -0
  155. package/packages/core/src/terminal-replica-hash-cache.ts +367 -0
  156. package/packages/core/src/terminal-replica.test.ts +282 -0
  157. package/packages/core/src/terminal-replica.ts +943 -0
  158. package/packages/core/src/workspace-selection.test.ts +63 -0
  159. package/packages/core/src/workspace-selection.ts +97 -0
  160. package/packages/daemon/dist/attach.js +2 -2
  161. package/packages/daemon/dist/canonical.d.ts +2 -2
  162. package/packages/daemon/dist/canonical.js +1 -1
  163. package/packages/daemon/dist/cli.js +37 -36
  164. package/packages/daemon/dist/command-center/actions/command-definitions.d.ts +4 -0
  165. package/packages/daemon/dist/command-center/actions/command-definitions.js +70 -0
  166. package/packages/daemon/dist/command-center/actions/dispatcher.d.ts +29 -0
  167. package/packages/daemon/dist/command-center/actions/dispatcher.js +228 -10
  168. package/packages/daemon/dist/command-center/actions/errors.d.ts +1 -1
  169. package/packages/daemon/dist/command-center/actions/handlers/_project-context.d.ts +1 -1
  170. package/packages/daemon/dist/command-center/actions/handlers/_project-context.js +3 -4
  171. package/packages/daemon/dist/command-center/actions/handlers/app-window-mutate.d.ts +8 -0
  172. package/packages/daemon/dist/command-center/actions/handlers/app-window-mutate.js +39 -0
  173. package/packages/daemon/dist/command-center/actions/handlers/config-actions.d.ts +6 -6
  174. package/packages/daemon/dist/command-center/actions/handlers/config-actions.js +44 -20
  175. package/packages/daemon/dist/command-center/actions/handlers/daemon-shutdown.d.ts +2 -1
  176. package/packages/daemon/dist/command-center/actions/handlers/daemon-shutdown.js +11 -1
  177. package/packages/daemon/dist/command-center/actions/handlers/fleet-lifecycle.d.ts +10 -0
  178. package/packages/daemon/dist/command-center/actions/handlers/fleet-lifecycle.js +56 -0
  179. package/packages/daemon/dist/command-center/actions/handlers/project-launch.js +16 -4
  180. package/packages/daemon/dist/command-center/actions/handlers/workspace-multiplexer.d.ts +186 -0
  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.d.ts +16 -0
  183. package/packages/daemon/dist/command-center/actions/handlers/workspace-open.js +89 -0
  184. package/packages/daemon/dist/command-center/actions/handlers/workspace-pane-create.d.ts +8 -0
  185. package/packages/daemon/dist/command-center/actions/handlers/workspace-pane-create.js +34 -0
  186. package/packages/daemon/dist/command-center/actions/handlers/workspace-promote.d.ts +8 -0
  187. package/packages/daemon/dist/command-center/actions/handlers/workspace-promote.js +34 -0
  188. package/packages/daemon/dist/command-center/actions/registry.d.ts +33 -2
  189. package/packages/daemon/dist/command-center/actions/registry.js +126 -0
  190. package/packages/daemon/dist/command-center/actions/semantic-multiplexer-actions.d.ts +3 -0
  191. package/packages/daemon/dist/command-center/actions/semantic-multiplexer-actions.js +16 -0
  192. package/packages/daemon/dist/command-center/agent-status-watch.d.ts +100 -0
  193. package/packages/daemon/dist/command-center/agent-status-watch.js +170 -0
  194. package/packages/daemon/dist/command-center/daemon-fleet-facts-observer.d.ts +57 -0
  195. package/packages/daemon/dist/command-center/daemon-fleet-facts-observer.js +395 -0
  196. package/packages/daemon/dist/command-center/discovery.d.ts +98 -1
  197. package/packages/daemon/dist/command-center/discovery.js +262 -3
  198. package/packages/daemon/dist/command-center/owner-authority.d.ts +71 -0
  199. package/packages/daemon/dist/command-center/owner-authority.js +46 -0
  200. package/packages/daemon/dist/command-center/pane-stream-issue.d.ts +26 -0
  201. package/packages/daemon/dist/command-center/pane-stream-issue.js +185 -0
  202. package/packages/daemon/dist/command-center/resources/agent-graph-overlay.d.ts +45 -0
  203. package/packages/daemon/dist/command-center/resources/agent-graph-overlay.js +234 -0
  204. package/packages/daemon/dist/command-center/resources/application-shell.d.ts +201 -0
  205. package/packages/daemon/dist/command-center/resources/application-shell.js +641 -0
  206. package/packages/daemon/dist/command-center/resources/desktop-missions.d.ts +10 -0
  207. package/packages/daemon/dist/command-center/resources/desktop-missions.js +132 -0
  208. package/packages/daemon/dist/command-center/resources/fleet-catalog.d.ts +25 -0
  209. package/packages/daemon/dist/command-center/resources/fleet-catalog.js +163 -0
  210. package/packages/daemon/dist/command-center/resources/fleet-resource-route.d.ts +25 -0
  211. package/packages/daemon/dist/command-center/resources/fleet-resource-route.js +46 -0
  212. package/packages/daemon/dist/command-center/resources/startup-readiness-route.d.ts +38 -0
  213. package/packages/daemon/dist/command-center/resources/startup-readiness-route.js +121 -0
  214. package/packages/daemon/dist/command-center/resources/startup-readiness.d.ts +57 -0
  215. package/packages/daemon/dist/command-center/resources/startup-readiness.js +183 -0
  216. package/packages/daemon/dist/command-center/resources/terminal-runtime-inventory.d.ts +5 -0
  217. package/packages/daemon/dist/command-center/resources/terminal-runtime-inventory.js +24 -0
  218. package/packages/daemon/dist/command-center/resources/workspace-changes-authority.d.ts +39 -0
  219. package/packages/daemon/dist/command-center/resources/workspace-changes-authority.js +451 -0
  220. package/packages/daemon/dist/command-center/resources/workspace-changes-git.d.ts +63 -0
  221. package/packages/daemon/dist/command-center/resources/workspace-changes-git.js +222 -0
  222. package/packages/daemon/dist/command-center/resources/workspace-files-authority.d.ts +44 -0
  223. package/packages/daemon/dist/command-center/resources/workspace-files-authority.js +493 -0
  224. package/packages/daemon/dist/command-center/resources/workspace-missions-route.d.ts +22 -0
  225. package/packages/daemon/dist/command-center/resources/workspace-missions-route.js +75 -0
  226. package/packages/daemon/dist/command-center/resources/workspace-resource-ids.d.ts +24 -0
  227. package/packages/daemon/dist/command-center/resources/workspace-resource-ids.js +69 -0
  228. package/packages/daemon/dist/command-center/resources/workspace-resource-routes.d.ts +17 -0
  229. package/packages/daemon/dist/command-center/resources/workspace-resource-routes.js +116 -0
  230. package/packages/daemon/dist/command-center/schemas.d.ts +1 -1
  231. package/packages/daemon/dist/command-center/server.d.ts +57 -1
  232. package/packages/daemon/dist/command-center/server.js +540 -51
  233. package/packages/daemon/dist/command-center/terminal-attachment-issue.d.ts +22 -0
  234. package/packages/daemon/dist/command-center/terminal-attachment-issue.js +191 -0
  235. package/packages/daemon/dist/command-center/workspace-resource-observer.d.ts +50 -0
  236. package/packages/daemon/dist/command-center/workspace-resource-observer.js +453 -0
  237. package/packages/daemon/dist/command-center/ws-events.d.ts +82 -7
  238. package/packages/daemon/dist/command-center/ws-events.js +681 -63
  239. package/packages/daemon/dist/config.js +31 -25
  240. package/packages/daemon/dist/control/client.d.ts +23 -0
  241. package/packages/daemon/dist/control/client.js +105 -0
  242. package/packages/daemon/dist/control/dispatch.d.ts +34 -0
  243. package/packages/daemon/dist/control/dispatch.js +83 -0
  244. package/packages/daemon/dist/control/fanout.d.ts +19 -0
  245. package/packages/daemon/dist/control/fanout.js +37 -0
  246. package/packages/daemon/dist/control/frames.d.ts +23 -0
  247. package/packages/daemon/dist/control/frames.js +37 -0
  248. package/packages/daemon/dist/control/lifecycle.d.ts +45 -0
  249. package/packages/daemon/dist/control/lifecycle.js +124 -0
  250. package/packages/daemon/dist/control/server.d.ts +16 -0
  251. package/packages/daemon/dist/control/server.js +214 -0
  252. package/packages/daemon/dist/control/verbs.d.ts +11 -0
  253. package/packages/daemon/dist/control/verbs.js +91 -0
  254. package/packages/daemon/dist/detect.js +23 -20
  255. package/packages/daemon/dist/doctor.d.ts +18 -0
  256. package/packages/daemon/dist/doctor.js +127 -21
  257. package/packages/daemon/dist/index.d.ts +21 -2
  258. package/packages/daemon/dist/index.js +20 -1
  259. package/packages/daemon/dist/init.js +24 -22
  260. package/packages/daemon/dist/inspect.d.ts +7 -1
  261. package/packages/daemon/dist/inspect.js +33 -8
  262. package/packages/daemon/dist/launch.d.ts +2 -0
  263. package/packages/daemon/dist/launch.js +38 -26
  264. package/packages/daemon/dist/lib/__tests__/fixtures/workspace-state-writer.js +58 -0
  265. package/packages/daemon/dist/lib/agent-discovery.d.ts +27 -2
  266. package/packages/daemon/dist/lib/agent-discovery.js +29 -14
  267. package/packages/daemon/dist/lib/agent-kind.d.ts +7 -0
  268. package/packages/daemon/dist/lib/agent-kind.js +24 -0
  269. package/packages/daemon/dist/lib/app-config.d.ts +111 -0
  270. package/packages/daemon/dist/lib/app-config.js +130 -5
  271. package/packages/daemon/dist/lib/app-window-kernel.d.ts +64 -0
  272. package/packages/daemon/dist/lib/app-window-kernel.js +556 -0
  273. package/packages/daemon/dist/lib/app-window-mutation.d.ts +28 -0
  274. package/packages/daemon/dist/lib/app-window-mutation.js +139 -0
  275. package/packages/daemon/dist/lib/app-window-repository.d.ts +81 -0
  276. package/packages/daemon/dist/lib/app-window-repository.js +368 -0
  277. package/packages/daemon/dist/lib/app-window-state.d.ts +57 -0
  278. package/packages/daemon/dist/lib/app-window-state.js +415 -0
  279. package/packages/daemon/dist/lib/application-shell-app-windows.d.ts +16 -0
  280. package/packages/daemon/dist/lib/application-shell-app-windows.js +285 -0
  281. package/packages/daemon/dist/lib/auth/middleware.d.ts +1 -1
  282. package/packages/daemon/dist/lib/auth/middleware.js +7 -3
  283. package/packages/daemon/dist/lib/canonical-daemon-bootstrap.d.ts +25 -0
  284. package/packages/daemon/dist/lib/canonical-daemon-bootstrap.js +174 -0
  285. package/packages/daemon/dist/lib/canonical-daemon.d.ts +80 -14
  286. package/packages/daemon/dist/lib/canonical-daemon.js +507 -70
  287. package/packages/daemon/dist/lib/chrome-front-door.d.ts +7 -0
  288. package/packages/daemon/dist/lib/chrome-front-door.js +13 -0
  289. package/packages/daemon/dist/lib/cli-action-bridge.d.ts +8 -3
  290. package/packages/daemon/dist/lib/cli-action-bridge.js +112 -82
  291. package/packages/daemon/dist/lib/command-registry.d.ts +37 -0
  292. package/packages/daemon/dist/lib/command-registry.js +107 -0
  293. package/packages/daemon/dist/lib/config-context.d.ts +18 -0
  294. package/packages/daemon/dist/lib/config-context.js +34 -0
  295. package/packages/daemon/dist/lib/daemon-embed.d.ts +30 -0
  296. package/packages/daemon/dist/lib/daemon-embed.js +1060 -356
  297. package/packages/daemon/dist/lib/daemon-session-monitor.d.ts +50 -0
  298. package/packages/daemon/dist/lib/daemon-session-monitor.js +194 -0
  299. package/packages/daemon/dist/lib/daemon.js +3 -47
  300. package/packages/daemon/dist/lib/directory-watcher.d.ts +12 -0
  301. package/packages/daemon/dist/lib/directory-watcher.js +118 -0
  302. package/packages/daemon/dist/lib/environment-identity.d.ts +9 -0
  303. package/packages/daemon/dist/lib/environment-identity.js +79 -0
  304. package/packages/daemon/dist/lib/errors.d.ts +1 -1
  305. package/packages/daemon/dist/lib/fleet-agent-lifecycle.d.ts +8 -0
  306. package/packages/daemon/dist/lib/fleet-agent-lifecycle.js +65 -0
  307. package/packages/daemon/dist/lib/fleet-lifecycle-authority.d.ts +21 -0
  308. package/packages/daemon/dist/lib/fleet-lifecycle-authority.js +437 -0
  309. package/packages/daemon/dist/lib/headless-daemon.d.ts +33 -0
  310. package/packages/daemon/dist/lib/headless-daemon.js +306 -0
  311. package/packages/daemon/dist/lib/launch-plan.d.ts +20 -1
  312. package/packages/daemon/dist/lib/launch-plan.js +96 -1
  313. package/packages/daemon/dist/lib/legacy-config-adapter.d.ts +12 -0
  314. package/packages/daemon/dist/lib/legacy-config-adapter.js +19 -0
  315. package/packages/daemon/dist/lib/legacy-config-migration.d.ts +15 -0
  316. package/packages/daemon/dist/lib/legacy-config-migration.js +110 -0
  317. package/packages/daemon/dist/lib/legacy-theme-compat.d.ts +14 -0
  318. package/packages/daemon/dist/lib/legacy-theme-compat.js +25 -0
  319. package/packages/daemon/dist/lib/manifest-pack.d.ts +79 -0
  320. package/packages/daemon/dist/lib/manifest-pack.js +232 -0
  321. package/packages/daemon/dist/lib/mission-projections.d.ts +24 -0
  322. package/packages/daemon/dist/lib/mission-projections.js +615 -0
  323. package/packages/daemon/dist/lib/mission-repository.d.ts +941 -0
  324. package/packages/daemon/dist/lib/mission-repository.js +775 -0
  325. package/packages/daemon/dist/lib/onboarding-marker.d.ts +13 -0
  326. package/packages/daemon/dist/lib/onboarding-marker.js +51 -0
  327. package/packages/daemon/dist/lib/pane-chrome.d.ts +12 -0
  328. package/packages/daemon/dist/lib/pane-chrome.js +12 -0
  329. package/packages/daemon/dist/lib/pane-source-credentials.d.ts +32 -0
  330. package/packages/daemon/dist/lib/pane-source-credentials.js +178 -0
  331. package/packages/daemon/dist/lib/pane-widget.d.ts +61 -0
  332. package/packages/daemon/dist/lib/pane-widget.js +126 -0
  333. package/packages/daemon/dist/lib/project-inspect.js +4 -0
  334. package/packages/daemon/dist/lib/project-onboard.d.ts +5 -5
  335. package/packages/daemon/dist/lib/project-onboard.js +17 -21
  336. package/packages/daemon/dist/lib/project-probe.d.ts +9 -3
  337. package/packages/daemon/dist/lib/project-probe.js +28 -22
  338. package/packages/daemon/dist/lib/project-readiness-probe.d.ts +60 -0
  339. package/packages/daemon/dist/lib/project-readiness-probe.js +425 -0
  340. package/packages/daemon/dist/lib/project-readiness.d.ts +157 -0
  341. package/packages/daemon/dist/lib/project-readiness.js +680 -0
  342. package/packages/daemon/dist/lib/project-registry.d.ts +8 -0
  343. package/packages/daemon/dist/lib/project-registry.js +42 -9
  344. package/packages/daemon/dist/lib/project-resolver.d.ts +77 -0
  345. package/packages/daemon/dist/lib/project-resolver.js +245 -0
  346. package/packages/daemon/dist/lib/project-runtime-errors.d.ts +13 -0
  347. package/packages/daemon/dist/lib/project-runtime-errors.js +21 -0
  348. package/packages/daemon/dist/lib/project-runtime-repository.d.ts +193 -0
  349. package/packages/daemon/dist/lib/project-runtime-repository.js +876 -0
  350. package/packages/daemon/dist/lib/resolved-config.d.ts +48 -0
  351. package/packages/daemon/dist/lib/resolved-config.js +318 -0
  352. package/packages/daemon/dist/lib/runtime-namespace.d.ts +34 -0
  353. package/packages/daemon/dist/lib/runtime-namespace.js +136 -0
  354. package/packages/daemon/dist/lib/semantic-resource-id.d.ts +7 -0
  355. package/packages/daemon/dist/lib/semantic-resource-id.js +14 -0
  356. package/packages/daemon/dist/lib/session-monitor.d.ts +2 -0
  357. package/packages/daemon/dist/lib/session-monitor.js +29 -23
  358. package/packages/daemon/dist/lib/session-options.js +3 -10
  359. package/packages/daemon/dist/lib/state-home.d.ts +2 -0
  360. package/packages/daemon/dist/lib/state-home.js +11 -0
  361. package/packages/daemon/dist/lib/theme-mode.d.ts +10 -0
  362. package/packages/daemon/dist/lib/theme-mode.js +9 -0
  363. package/packages/daemon/dist/lib/tmux-external-interaction-observer.d.ts +88 -0
  364. package/packages/daemon/dist/lib/tmux-external-interaction-observer.js +534 -0
  365. package/packages/daemon/dist/lib/tmux-interaction-options.d.ts +34 -0
  366. package/packages/daemon/dist/lib/tmux-interaction-options.js +126 -0
  367. package/packages/daemon/dist/lib/tmux-terminal-color.d.ts +18 -0
  368. package/packages/daemon/dist/lib/tmux-terminal-color.js +37 -0
  369. package/packages/daemon/dist/lib/tui-binary.d.ts +30 -5
  370. package/packages/daemon/dist/lib/tui-binary.js +291 -28
  371. package/packages/daemon/dist/lib/unix-socket-authority.d.ts +9 -0
  372. package/packages/daemon/dist/lib/unix-socket-authority.js +48 -0
  373. package/packages/daemon/dist/lib/update-check.js +5 -0
  374. package/packages/daemon/dist/lib/widget-asset-policy.d.ts +3 -0
  375. package/packages/daemon/dist/lib/widget-asset-policy.js +3 -0
  376. package/packages/daemon/dist/lib/widget-asset-store.d.ts +22 -0
  377. package/packages/daemon/dist/lib/widget-asset-store.js +166 -0
  378. package/packages/daemon/dist/lib/workspace-config-loader.d.ts +68 -0
  379. package/packages/daemon/dist/lib/workspace-config-loader.js +280 -0
  380. package/packages/daemon/dist/lib/workspace-multiplexer-verbs.d.ts +109 -0
  381. package/packages/daemon/dist/lib/workspace-multiplexer-verbs.js +1138 -0
  382. package/packages/daemon/dist/lib/workspace-open-handoff.d.ts +41 -0
  383. package/packages/daemon/dist/lib/workspace-open-handoff.js +219 -0
  384. package/packages/daemon/dist/lib/workspace-open.d.ts +44 -0
  385. package/packages/daemon/dist/lib/workspace-open.js +740 -0
  386. package/packages/daemon/dist/lib/workspace-pane-creation.d.ts +64 -0
  387. package/packages/daemon/dist/lib/workspace-pane-creation.js +1107 -0
  388. package/packages/daemon/dist/lib/workspace-promotion.d.ts +41 -0
  389. package/packages/daemon/dist/lib/workspace-promotion.js +804 -0
  390. package/packages/daemon/dist/lib/workspace-registry.d.ts +49 -2
  391. package/packages/daemon/dist/lib/workspace-registry.js +150 -23
  392. package/packages/daemon/dist/lib/workspace-state-repository.d.ts +139 -0
  393. package/packages/daemon/dist/lib/workspace-state-repository.js +790 -0
  394. package/packages/daemon/dist/lib/workspace-state.d.ts +37 -0
  395. package/packages/daemon/dist/lib/workspace-state.js +765 -0
  396. package/packages/daemon/dist/lib/yaml-io.js +4 -18
  397. package/packages/daemon/dist/migrate.d.ts +11 -0
  398. package/packages/daemon/dist/migrate.js +105 -0
  399. package/packages/daemon/dist/restart.js +2 -2
  400. package/packages/daemon/dist/restore.d.ts +40 -13
  401. package/packages/daemon/dist/restore.js +62 -21
  402. package/packages/daemon/dist/schemas/inspect.d.ts +8 -0
  403. package/packages/daemon/dist/schemas/inspect.js +9 -1
  404. package/packages/daemon/dist/schemas/registry.d.ts +18 -4
  405. package/packages/daemon/dist/schemas/registry.js +5 -19
  406. package/packages/daemon/dist/schemas/ws-events.d.ts +5 -69
  407. package/packages/daemon/dist/schemas/ws-events.js +4 -107
  408. package/packages/daemon/dist/send.d.ts +41 -1
  409. package/packages/daemon/dist/send.js +136 -20
  410. package/packages/daemon/dist/server/pane-stream-upgrade.d.ts +12 -0
  411. package/packages/daemon/dist/server/pane-stream-upgrade.js +117 -0
  412. package/packages/daemon/dist/server/terminal-attachment-upgrade.d.ts +11 -0
  413. package/packages/daemon/dist/server/terminal-attachment-upgrade.js +121 -0
  414. package/packages/daemon/dist/status.js +11 -8
  415. package/packages/daemon/dist/stop.js +2 -2
  416. package/packages/daemon/dist/terminal/MonotonicPtyInput.d.ts +30 -0
  417. package/packages/daemon/dist/terminal/MonotonicPtyInput.js +130 -0
  418. package/packages/daemon/dist/terminal/NodePtyAdapter.d.ts +9 -3
  419. package/packages/daemon/dist/terminal/NodePtyAdapter.js +37 -10
  420. package/packages/daemon/dist/terminal/PtyAdapter.d.ts +93 -3
  421. package/packages/daemon/dist/terminal/PtyAdapter.js +18 -0
  422. package/packages/daemon/dist/terminal/__tests__/MockPtyAdapter.d.ts +14 -4
  423. package/packages/daemon/dist/terminal/__tests__/MockPtyAdapter.js +33 -6
  424. package/packages/daemon/dist/terminal/attachments/admission-util.d.ts +14 -0
  425. package/packages/daemon/dist/terminal/attachments/admission-util.js +87 -0
  426. package/packages/daemon/dist/terminal/attachments/agent-status-probe.d.ts +102 -0
  427. package/packages/daemon/dist/terminal/attachments/agent-status-probe.js +325 -0
  428. package/packages/daemon/dist/terminal/attachments/direct-websocket.d.ts +141 -0
  429. package/packages/daemon/dist/terminal/attachments/direct-websocket.js +1069 -0
  430. package/packages/daemon/dist/terminal/attachments/grouped-tmux.d.ts +106 -0
  431. package/packages/daemon/dist/terminal/attachments/grouped-tmux.js +213 -0
  432. package/packages/daemon/dist/terminal/attachments/lease-manager.d.ts +188 -0
  433. package/packages/daemon/dist/terminal/attachments/lease-manager.js +655 -0
  434. package/packages/daemon/dist/terminal/attachments/native-runtime.d.ts +196 -0
  435. package/packages/daemon/dist/terminal/attachments/native-runtime.js +1564 -0
  436. package/packages/daemon/dist/terminal/attachments/pty-tmux-attachment-launcher.d.ts +66 -0
  437. package/packages/daemon/dist/terminal/attachments/pty-tmux-attachment-launcher.js +607 -0
  438. package/packages/daemon/dist/terminal/attachments/semantic-pane-catalog.d.ts +81 -0
  439. package/packages/daemon/dist/terminal/attachments/semantic-pane-catalog.js +208 -0
  440. package/packages/daemon/dist/terminal/attachments/tmux-view-executor.d.ts +111 -0
  441. package/packages/daemon/dist/terminal/attachments/tmux-view-executor.js +825 -0
  442. package/packages/daemon/dist/terminal/mirror/__tests__/scripted-channel.d.ts +25 -0
  443. package/packages/daemon/dist/terminal/mirror/__tests__/scripted-channel.js +80 -0
  444. package/packages/daemon/dist/terminal/mirror/__tests__/simulated-channel.d.ts +66 -0
  445. package/packages/daemon/dist/terminal/mirror/__tests__/simulated-channel.js +133 -0
  446. package/packages/daemon/dist/terminal/mirror/control-channel.d.ts +188 -0
  447. package/packages/daemon/dist/terminal/mirror/control-channel.js +624 -0
  448. package/packages/daemon/dist/terminal/mirror/control-mode-ownership.d.ts +14 -0
  449. package/packages/daemon/dist/terminal/mirror/control-mode-ownership.js +30 -0
  450. package/packages/daemon/dist/terminal/mirror/events.d.ts +115 -0
  451. package/packages/daemon/dist/terminal/mirror/events.js +18 -0
  452. package/packages/daemon/dist/terminal/mirror/flow-ledger.d.ts +40 -0
  453. package/packages/daemon/dist/terminal/mirror/flow-ledger.js +56 -0
  454. package/packages/daemon/dist/terminal/mirror/mirror-service.d.ts +137 -0
  455. package/packages/daemon/dist/terminal/mirror/mirror-service.js +329 -0
  456. package/packages/daemon/dist/terminal/mirror/pane-feed.d.ts +90 -0
  457. package/packages/daemon/dist/terminal/mirror/pane-feed.js +140 -0
  458. package/packages/daemon/dist/terminal/mirror/session-channel.d.ts +216 -0
  459. package/packages/daemon/dist/terminal/mirror/session-channel.js +2301 -0
  460. package/packages/daemon/dist/terminal/mirror/trusted-inventory.d.ts +28 -0
  461. package/packages/daemon/dist/terminal/pane-stream/lease-manager.d.ts +72 -0
  462. package/packages/daemon/dist/terminal/pane-stream/lease-manager.js +245 -0
  463. package/packages/daemon/dist/terminal/pane-stream/pane-stream-websocket.d.ts +208 -0
  464. package/packages/daemon/dist/terminal/pane-stream/pane-stream-websocket.js +2058 -0
  465. package/packages/daemon/dist/terminal/pane-stream/runtime.d.ts +26 -0
  466. package/packages/daemon/dist/terminal/pane-stream/runtime.js +53 -0
  467. package/packages/daemon/dist/terminal/pane-stream/wire-ledger.d.ts +59 -0
  468. package/packages/daemon/dist/terminal/pane-stream/wire-ledger.js +110 -0
  469. package/packages/daemon/dist/terminal/protocol/chunk-bytes.d.ts +3 -0
  470. package/packages/daemon/dist/terminal/protocol/chunk-bytes.js +21 -0
  471. package/packages/daemon/dist/terminal/protocol/control.d.ts +66 -0
  472. package/packages/daemon/dist/terminal/protocol/control.js +111 -0
  473. package/packages/daemon/dist/terminal/protocol/input-coalescer.d.ts +55 -0
  474. package/packages/daemon/dist/terminal/protocol/input-coalescer.js +111 -0
  475. package/packages/daemon/dist/terminal/protocol/layout-parse.d.ts +68 -0
  476. package/packages/daemon/dist/terminal/protocol/layout-parse.js +127 -0
  477. package/packages/daemon/dist/terminal/protocol/pane-display-name.d.ts +16 -0
  478. package/packages/daemon/dist/terminal/protocol/pane-display-name.js +153 -0
  479. package/packages/daemon/dist/terminal/protocol/session-descriptor-discovery.d.ts +78 -0
  480. package/packages/daemon/dist/terminal/protocol/session-descriptor-discovery.js +294 -0
  481. package/packages/daemon/dist/terminal/protocol/workspace-tmux-adapter.d.ts +90 -0
  482. package/packages/daemon/dist/terminal/protocol/workspace-tmux-adapter.js +213 -0
  483. package/packages/daemon/dist/terminal/session-runtime/authority-arbiter.d.ts +36 -0
  484. package/packages/daemon/dist/terminal/session-runtime/authority-arbiter.js +260 -0
  485. package/packages/daemon/dist/terminal/session-runtime/causal-cell-ledger.d.ts +29 -0
  486. package/packages/daemon/dist/terminal/session-runtime/causal-cell-ledger.js +278 -0
  487. package/packages/daemon/dist/terminal/session-runtime/interaction-receipt-facts.d.ts +12 -0
  488. package/packages/daemon/dist/terminal/session-runtime/interaction-receipt-facts.js +147 -0
  489. package/packages/daemon/dist/terminal/session-runtime/multiplexer-backend.d.ts +16 -0
  490. package/packages/daemon/dist/terminal/session-runtime/multiplexer-backend.js +116 -0
  491. package/packages/daemon/dist/terminal/session-runtime/registry.d.ts +148 -0
  492. package/packages/daemon/dist/terminal/session-runtime/registry.js +1368 -0
  493. package/packages/daemon/dist/terminal/session-runtime/runtime-observability.d.ts +118 -0
  494. package/packages/daemon/dist/terminal/session-runtime/runtime-observability.js +72 -0
  495. package/packages/daemon/dist/terminal/session-runtime/runtime-scheduler.d.ts +11 -0
  496. package/packages/daemon/dist/terminal/session-runtime/runtime-scheduler.js +10 -0
  497. package/packages/daemon/dist/terminal/session-runtime/runtime-trace-correlator.d.ts +18 -0
  498. package/packages/daemon/dist/terminal/session-runtime/runtime-trace-correlator.js +48 -0
  499. package/packages/daemon/dist/terminal/session-runtime/semantic-mutation-executor.d.ts +69 -0
  500. package/packages/daemon/dist/terminal/session-runtime/semantic-mutation-executor.js +353 -0
  501. package/packages/daemon/dist/terminal/session-runtime/semantic-mutation-resource-changes.d.ts +8 -0
  502. package/packages/daemon/dist/terminal/session-runtime/semantic-mutation-resource-changes.js +32 -0
  503. package/packages/daemon/dist/terminal/session-runtime/terminal-delivery-hub.d.ts +91 -0
  504. package/packages/daemon/dist/terminal/session-runtime/terminal-delivery-hub.js +1362 -0
  505. package/packages/daemon/dist/terminal/session-runtime/terminal-delivery-observation-identity.d.ts +3 -0
  506. package/packages/daemon/dist/terminal/session-runtime/terminal-delivery-observation-identity.js +9 -0
  507. package/packages/daemon/dist/terminal/session-runtime/terminal-interpreter-backend.d.ts +55 -0
  508. package/packages/daemon/dist/terminal/session-runtime/terminal-replica-interpreter.d.ts +91 -0
  509. package/packages/daemon/dist/terminal/session-runtime/terminal-replica-interpreter.js +528 -0
  510. package/packages/daemon/dist/terminal/session-runtime/terminal-replica-owner.d.ts +50 -0
  511. package/packages/daemon/dist/terminal/session-runtime/terminal-replica-owner.js +387 -0
  512. package/packages/daemon/dist/terminal/session-runtime/terminal-replica-shadow-projections.d.ts +37 -0
  513. package/packages/daemon/dist/terminal/session-runtime/terminal-replica-shadow-projections.js +21 -0
  514. package/packages/daemon/dist/terminal/session-runtime/transport-binding.d.ts +75 -0
  515. package/packages/daemon/dist/terminal/session-runtime/transport-binding.js +474 -0
  516. package/packages/daemon/dist/terminal/session-runtime/xterm-terminal-interpreter-backend.d.ts +26 -0
  517. package/packages/daemon/dist/terminal/session-runtime/xterm-terminal-interpreter-backend.js +276 -0
  518. package/packages/daemon/dist/tui/async-disposable-slot.d.ts +18 -0
  519. package/packages/daemon/dist/tui/async-disposable-slot.js +57 -0
  520. package/packages/daemon/dist/tui/chrome/cheatsheet.d.ts +59 -0
  521. package/packages/daemon/dist/tui/chrome/cheatsheet.js +211 -0
  522. package/packages/daemon/dist/tui/chrome/chip.d.ts +21 -0
  523. package/packages/daemon/dist/tui/chrome/chip.js +25 -0
  524. package/packages/daemon/dist/tui/chrome/events.d.ts +51 -0
  525. package/packages/daemon/dist/tui/chrome/events.js +94 -0
  526. package/packages/daemon/dist/tui/chrome/front-door.d.ts +16 -0
  527. package/packages/daemon/dist/tui/chrome/front-door.js +16 -0
  528. package/packages/daemon/dist/tui/chrome/kitty-keys.d.ts +41 -0
  529. package/packages/daemon/dist/tui/chrome/kitty-keys.js +54 -0
  530. package/packages/daemon/dist/tui/chrome/menu.d.ts +92 -0
  531. package/packages/daemon/dist/tui/chrome/menu.js +251 -0
  532. package/packages/daemon/dist/tui/chrome/notify-prefs.d.ts +47 -0
  533. package/packages/daemon/dist/tui/chrome/notify-prefs.js +13 -0
  534. package/packages/daemon/dist/tui/chrome/notify-state.d.ts +13 -0
  535. package/packages/daemon/dist/tui/chrome/notify-state.js +77 -0
  536. package/packages/daemon/dist/tui/chrome/notify.d.ts +361 -0
  537. package/packages/daemon/dist/tui/chrome/notify.js +711 -0
  538. package/packages/daemon/dist/tui/chrome/panels.d.ts +72 -0
  539. package/packages/daemon/dist/tui/chrome/panels.js +60 -0
  540. package/packages/daemon/dist/tui/chrome/sidebar.d.ts +77 -0
  541. package/packages/daemon/dist/tui/chrome/sidebar.js +183 -0
  542. package/packages/daemon/dist/tui/chrome/snapshot.d.ts +110 -0
  543. package/packages/daemon/dist/tui/chrome/snapshot.js +290 -0
  544. package/packages/daemon/dist/tui/chrome/statusline.d.ts +237 -0
  545. package/packages/daemon/dist/tui/chrome/statusline.js +552 -0
  546. package/packages/daemon/dist/tui/chrome/updater.d.ts +230 -0
  547. package/packages/daemon/dist/tui/chrome/updater.js +651 -0
  548. package/packages/daemon/dist/tui/chrome/welcome.d.ts +41 -0
  549. package/packages/daemon/dist/tui/chrome/welcome.js +117 -0
  550. package/packages/daemon/dist/tui/compiled.d.ts +86 -0
  551. package/packages/daemon/dist/tui/compiled.js +165 -0
  552. package/packages/daemon/dist/tui/detect/agent-resolution.d.ts +56 -0
  553. package/packages/daemon/dist/tui/detect/agent-resolution.js +60 -0
  554. package/packages/daemon/dist/tui/detect/classify.d.ts +107 -0
  555. package/packages/daemon/dist/tui/detect/classify.js +184 -0
  556. package/packages/daemon/dist/tui/detect/manifest-loader.d.ts +54 -0
  557. package/packages/daemon/dist/tui/detect/manifest-loader.js +242 -0
  558. package/packages/daemon/dist/tui/detect/manifest.d.ts +111 -0
  559. package/packages/daemon/dist/tui/detect/manifest.js +126 -0
  560. package/packages/daemon/dist/tui/detect/manifests.d.ts +40 -0
  561. package/packages/daemon/dist/tui/detect/manifests.js +535 -0
  562. package/packages/daemon/dist/tui/detect/process-tree.d.ts +96 -0
  563. package/packages/daemon/dist/tui/detect/process-tree.js +194 -0
  564. package/packages/daemon/dist/tui/detect/session-id.d.ts +110 -0
  565. package/packages/daemon/dist/tui/detect/session-id.js +414 -0
  566. package/packages/daemon/dist/tui/detect/snapshot.d.ts +27 -0
  567. package/packages/daemon/dist/tui/detect/snapshot.js +81 -0
  568. package/packages/daemon/dist/tui/integrations/claude.d.ts +65 -0
  569. package/packages/daemon/dist/tui/integrations/claude.js +151 -0
  570. package/packages/daemon/dist/tui/integrations/offer.d.ts +47 -0
  571. package/packages/daemon/dist/tui/integrations/offer.js +134 -0
  572. package/packages/daemon/dist/tui/integrations/opencode.d.ts +37 -0
  573. package/packages/daemon/dist/tui/integrations/opencode.js +117 -0
  574. package/packages/daemon/dist/tui/mirror/ack-writer.d.ts +36 -0
  575. package/packages/daemon/dist/tui/mirror/ack-writer.js +78 -0
  576. package/packages/daemon/dist/tui/mirror/activity-surface-view.d.ts +8 -0
  577. package/packages/daemon/dist/tui/mirror/activity-surface-view.jsx +69 -0
  578. package/packages/daemon/dist/tui/mirror/activity-surface.d.ts +103 -0
  579. package/packages/daemon/dist/tui/mirror/activity-surface.js +271 -0
  580. package/packages/daemon/dist/tui/mirror/agent-chip.d.ts +76 -0
  581. package/packages/daemon/dist/tui/mirror/agent-chip.js +84 -0
  582. package/packages/daemon/dist/tui/mirror/agent-lifecycle.d.ts +217 -0
  583. package/packages/daemon/dist/tui/mirror/agent-lifecycle.js +372 -0
  584. package/packages/daemon/dist/tui/mirror/agent-provisioning-executor.d.ts +42 -0
  585. package/packages/daemon/dist/tui/mirror/agent-provisioning-executor.js +86 -0
  586. package/packages/daemon/dist/tui/mirror/agent-rows.d.ts +119 -0
  587. package/packages/daemon/dist/tui/mirror/agent-rows.js +126 -0
  588. package/packages/daemon/dist/tui/mirror/ansi-palette.d.ts +3 -0
  589. package/packages/daemon/dist/tui/mirror/ansi-palette.js +3 -0
  590. package/packages/daemon/dist/tui/mirror/app-state.d.ts +114 -0
  591. package/packages/daemon/dist/tui/mirror/app-state.js +294 -0
  592. package/packages/daemon/dist/tui/mirror/application-keybindings.d.ts +18 -0
  593. package/packages/daemon/dist/tui/mirror/application-keybindings.js +33 -0
  594. package/packages/daemon/dist/tui/mirror/application-shell-daemon-connection.d.ts +53 -0
  595. package/packages/daemon/dist/tui/mirror/application-shell-daemon-connection.js +253 -0
  596. package/packages/daemon/dist/tui/mirror/application-shell-daemon-session.d.ts +22 -0
  597. package/packages/daemon/dist/tui/mirror/application-shell-daemon-session.js +45 -0
  598. package/packages/daemon/dist/tui/mirror/attention.d.ts +63 -0
  599. package/packages/daemon/dist/tui/mirror/attention.js +59 -0
  600. package/packages/daemon/dist/tui/mirror/blit.d.ts +82 -0
  601. package/packages/daemon/dist/tui/mirror/blit.js +120 -0
  602. package/packages/daemon/dist/tui/mirror/canonical-workspace-routing.d.ts +11 -0
  603. package/packages/daemon/dist/tui/mirror/canonical-workspace-routing.js +45 -0
  604. package/packages/daemon/dist/tui/mirror/changes-surface-view.d.ts +19 -0
  605. package/packages/daemon/dist/tui/mirror/changes-surface-view.jsx +92 -0
  606. package/packages/daemon/dist/tui/mirror/changes-surface.d.ts +115 -0
  607. package/packages/daemon/dist/tui/mirror/changes-surface.js +210 -0
  608. package/packages/daemon/dist/tui/mirror/composite-layout.d.ts +91 -0
  609. package/packages/daemon/dist/tui/mirror/composite-layout.js +539 -0
  610. package/packages/daemon/dist/tui/mirror/configless-session-bootstrap.d.ts +39 -0
  611. package/packages/daemon/dist/tui/mirror/configless-session-bootstrap.js +133 -0
  612. package/packages/daemon/dist/tui/mirror/dialog-model.d.ts +154 -0
  613. package/packages/daemon/dist/tui/mirror/dialog-model.js +183 -0
  614. package/packages/daemon/dist/tui/mirror/dialog-stack-core.d.ts +45 -0
  615. package/packages/daemon/dist/tui/mirror/dialog-stack-core.js +232 -0
  616. package/packages/daemon/dist/tui/mirror/dialog-stack.d.ts +2 -0
  617. package/packages/daemon/dist/tui/mirror/dialog-stack.js +2 -0
  618. package/packages/daemon/dist/tui/mirror/diff-model.d.ts +169 -0
  619. package/packages/daemon/dist/tui/mirror/diff-model.js +332 -0
  620. package/packages/daemon/dist/tui/mirror/editor-buffer.d.ts +24 -0
  621. package/packages/daemon/dist/tui/mirror/editor-buffer.js +47 -0
  622. package/packages/daemon/dist/tui/mirror/editor-open-policy.d.ts +9 -0
  623. package/packages/daemon/dist/tui/mirror/editor-open-policy.js +9 -0
  624. package/packages/daemon/dist/tui/mirror/features/changes/contract.d.ts +75 -0
  625. package/packages/daemon/dist/tui/mirror/features/changes/controller.d.ts +10 -0
  626. package/packages/daemon/dist/tui/mirror/features/changes/controller.js +454 -0
  627. package/packages/daemon/dist/tui/mirror/features/changes/feature.d.ts +10 -0
  628. package/packages/daemon/dist/tui/mirror/features/changes/feature.jsx +9 -0
  629. package/packages/daemon/dist/tui/mirror/features/dialogs/contract.d.ts +47 -0
  630. package/packages/daemon/dist/tui/mirror/features/dialogs/contract.js +1 -0
  631. package/packages/daemon/dist/tui/mirror/features/dialogs/feature.d.ts +12 -0
  632. package/packages/daemon/dist/tui/mirror/features/dialogs/feature.jsx +123 -0
  633. package/packages/daemon/dist/tui/mirror/features/dialogs/session.d.ts +9 -0
  634. package/packages/daemon/dist/tui/mirror/features/dialogs/session.js +160 -0
  635. package/packages/daemon/dist/tui/mirror/features/files/feature.d.ts +16 -0
  636. package/packages/daemon/dist/tui/mirror/features/files/feature.jsx +15 -0
  637. package/packages/daemon/dist/tui/mirror/features/files/session.d.ts +133 -0
  638. package/packages/daemon/dist/tui/mirror/features/files/session.js +617 -0
  639. package/packages/daemon/dist/tui/mirror/features/home/feature.d.ts +28 -0
  640. package/packages/daemon/dist/tui/mirror/features/home/feature.jsx +122 -0
  641. package/packages/daemon/dist/tui/mirror/features/missions-activity/contract.d.ts +84 -0
  642. package/packages/daemon/dist/tui/mirror/features/missions-activity/contract.js +3 -0
  643. package/packages/daemon/dist/tui/mirror/features/missions-activity/feature.d.ts +6 -0
  644. package/packages/daemon/dist/tui/mirror/features/missions-activity/feature.jsx +5 -0
  645. package/packages/daemon/dist/tui/mirror/features/missions-activity/session.d.ts +5 -0
  646. package/packages/daemon/dist/tui/mirror/features/missions-activity/session.js +377 -0
  647. package/packages/daemon/dist/tui/mirror/features/palette/contract.d.ts +116 -0
  648. package/packages/daemon/dist/tui/mirror/features/palette/contract.js +9 -0
  649. package/packages/daemon/dist/tui/mirror/features/palette/feature.d.ts +4 -0
  650. package/packages/daemon/dist/tui/mirror/features/palette/feature.js +3 -0
  651. package/packages/daemon/dist/tui/mirror/features/palette/session.d.ts +2 -0
  652. package/packages/daemon/dist/tui/mirror/features/palette/session.js +393 -0
  653. package/packages/daemon/dist/tui/mirror/features/palette/surface.d.ts +7 -0
  654. package/packages/daemon/dist/tui/mirror/features/palette/surface.jsx +48 -0
  655. package/packages/daemon/dist/tui/mirror/features/performance-hud/contract.d.ts +17 -0
  656. package/packages/daemon/dist/tui/mirror/features/performance-hud/contract.js +1 -0
  657. package/packages/daemon/dist/tui/mirror/features/performance-hud/feature.d.ts +3 -0
  658. package/packages/daemon/dist/tui/mirror/features/performance-hud/feature.jsx +2 -0
  659. package/packages/daemon/dist/tui/mirror/features/performance-hud/session.d.ts +8 -0
  660. package/packages/daemon/dist/tui/mirror/features/performance-hud/session.js +148 -0
  661. package/packages/daemon/dist/tui/mirror/features/performance-hud/surface.d.ts +17 -0
  662. package/packages/daemon/dist/tui/mirror/features/performance-hud/surface.jsx +64 -0
  663. package/packages/daemon/dist/tui/mirror/features/rich-preview/asset-loader.d.ts +9 -0
  664. package/packages/daemon/dist/tui/mirror/features/rich-preview/asset-loader.js +125 -0
  665. package/packages/daemon/dist/tui/mirror/features/rich-preview/contract.d.ts +71 -0
  666. package/packages/daemon/dist/tui/mirror/features/rich-preview/contract.js +1 -0
  667. package/packages/daemon/dist/tui/mirror/features/rich-preview/feature.d.ts +23 -0
  668. package/packages/daemon/dist/tui/mirror/features/rich-preview/feature.jsx +103 -0
  669. package/packages/daemon/dist/tui/mirror/features/rich-preview/session.d.ts +23 -0
  670. package/packages/daemon/dist/tui/mirror/features/rich-preview/session.js +310 -0
  671. package/packages/daemon/dist/tui/mirror/features/settings/catalog.d.ts +7 -0
  672. package/packages/daemon/dist/tui/mirror/features/settings/catalog.js +10 -0
  673. package/packages/daemon/dist/tui/mirror/features/settings/contract.d.ts +35 -0
  674. package/packages/daemon/dist/tui/mirror/features/settings/contract.js +1 -0
  675. package/packages/daemon/dist/tui/mirror/features/settings/feature.d.ts +3 -0
  676. package/packages/daemon/dist/tui/mirror/features/settings/feature.js +2 -0
  677. package/packages/daemon/dist/tui/mirror/features/settings/session.d.ts +3 -0
  678. package/packages/daemon/dist/tui/mirror/features/settings/session.js +309 -0
  679. package/packages/daemon/dist/tui/mirror/file-tree.d.ts +142 -0
  680. package/packages/daemon/dist/tui/mirror/file-tree.js +283 -0
  681. package/packages/daemon/dist/tui/mirror/files-surface-view.d.ts +17 -0
  682. package/packages/daemon/dist/tui/mirror/files-surface-view.jsx +92 -0
  683. package/packages/daemon/dist/tui/mirror/files-surface.d.ts +123 -0
  684. package/packages/daemon/dist/tui/mirror/files-surface.js +237 -0
  685. package/packages/daemon/dist/tui/mirror/focus-projection.d.ts +20 -0
  686. package/packages/daemon/dist/tui/mirror/focus-projection.js +80 -0
  687. package/packages/daemon/dist/tui/mirror/folder-picker.d.ts +38 -0
  688. package/packages/daemon/dist/tui/mirror/folder-picker.js +114 -0
  689. package/packages/daemon/dist/tui/mirror/frame-coalescer.d.ts +29 -0
  690. package/packages/daemon/dist/tui/mirror/frame-coalescer.js +74 -0
  691. package/packages/daemon/dist/tui/mirror/home-model.d.ts +81 -0
  692. package/packages/daemon/dist/tui/mirror/home-model.js +125 -0
  693. package/packages/daemon/dist/tui/mirror/home-surface-model.d.ts +113 -0
  694. package/packages/daemon/dist/tui/mirror/home-surface-model.js +297 -0
  695. package/packages/daemon/dist/tui/mirror/home-surface.d.ts +11 -0
  696. package/packages/daemon/dist/tui/mirror/home-surface.jsx +110 -0
  697. package/packages/daemon/dist/tui/mirror/host-terminal.d.ts +28 -0
  698. package/packages/daemon/dist/tui/mirror/host-terminal.js +33 -0
  699. package/packages/daemon/dist/tui/mirror/hosted.d.ts +179 -0
  700. package/packages/daemon/dist/tui/mirror/hosted.js +239 -0
  701. package/packages/daemon/dist/tui/mirror/input-lifecycle.d.ts +140 -0
  702. package/packages/daemon/dist/tui/mirror/input-lifecycle.js +147 -0
  703. package/packages/daemon/dist/tui/mirror/interaction-flow.d.ts +30 -0
  704. package/packages/daemon/dist/tui/mirror/interaction-flow.js +41 -0
  705. package/packages/daemon/dist/tui/mirror/legacy/missions-workspace-loader.d.ts +19 -0
  706. package/packages/daemon/dist/tui/mirror/legacy/missions-workspace-loader.js +84 -0
  707. package/packages/daemon/dist/tui/mirror/menu-model.d.ts +89 -0
  708. package/packages/daemon/dist/tui/mirror/menu-model.js +143 -0
  709. package/packages/daemon/dist/tui/mirror/missions-dashboard.d.ts +68 -0
  710. package/packages/daemon/dist/tui/mirror/missions-dashboard.js +261 -0
  711. package/packages/daemon/dist/tui/mirror/missions-render-fixtures.d.ts +13 -0
  712. package/packages/daemon/dist/tui/mirror/missions-render-fixtures.js +330 -0
  713. package/packages/daemon/dist/tui/mirror/missions-surface-controller.d.ts +84 -0
  714. package/packages/daemon/dist/tui/mirror/missions-surface-controller.js +314 -0
  715. package/packages/daemon/dist/tui/mirror/missions-surface.d.ts +17 -0
  716. package/packages/daemon/dist/tui/mirror/missions-surface.jsx +239 -0
  717. package/packages/daemon/dist/tui/mirror/missions-workspace.d.ts +341 -0
  718. package/packages/daemon/dist/tui/mirror/missions-workspace.js +1399 -0
  719. package/packages/daemon/dist/tui/mirror/multiplexer-action-executor.d.ts +71 -0
  720. package/packages/daemon/dist/tui/mirror/multiplexer-action-executor.js +233 -0
  721. package/packages/daemon/dist/tui/mirror/open-tui-pane-stream-socket.d.ts +16 -0
  722. package/packages/daemon/dist/tui/mirror/open-tui-pane-stream-socket.js +32 -0
  723. package/packages/daemon/dist/tui/mirror/open-tui-verified-routing.d.ts +19 -0
  724. package/packages/daemon/dist/tui/mirror/open-tui-verified-routing.js +45 -0
  725. package/packages/daemon/dist/tui/mirror/open-tui-workspace-runtime-port.d.ts +36 -0
  726. package/packages/daemon/dist/tui/mirror/open-tui-workspace-runtime-port.js +1069 -0
  727. package/packages/daemon/dist/tui/mirror/palette-surface-adapter.d.ts +58 -0
  728. package/packages/daemon/dist/tui/mirror/palette-surface-adapter.js +384 -0
  729. package/packages/daemon/dist/tui/mirror/palette.d.ts +315 -0
  730. package/packages/daemon/dist/tui/mirror/palette.js +522 -0
  731. package/packages/daemon/dist/tui/mirror/pane-frame-state.d.ts +68 -0
  732. package/packages/daemon/dist/tui/mirror/pane-frame-state.js +124 -0
  733. package/packages/daemon/dist/tui/mirror/pane-mirror.d.ts +205 -0
  734. package/packages/daemon/dist/tui/mirror/pane-mirror.js +584 -0
  735. package/packages/daemon/dist/tui/mirror/pane-surface.d.ts +257 -0
  736. package/packages/daemon/dist/tui/mirror/pane-surface.jsx +855 -0
  737. package/packages/daemon/dist/tui/mirror/panel-host-reactive.d.ts +7 -0
  738. package/packages/daemon/dist/tui/mirror/panel-host-reactive.js +13 -0
  739. package/packages/daemon/dist/tui/mirror/panel-host.d.ts +69 -0
  740. package/packages/daemon/dist/tui/mirror/panel-host.js +242 -0
  741. package/packages/daemon/dist/tui/mirror/perf-tap.d.ts +13 -0
  742. package/packages/daemon/dist/tui/mirror/perf-tap.js +32 -0
  743. package/packages/daemon/dist/tui/mirror/performance-events.d.ts +404 -0
  744. package/packages/daemon/dist/tui/mirror/performance-events.js +46 -0
  745. package/packages/daemon/dist/tui/mirror/recipe-components.d.ts +93 -0
  746. package/packages/daemon/dist/tui/mirror/recipe-components.jsx +135 -0
  747. package/packages/daemon/dist/tui/mirror/recipes.d.ts +90 -0
  748. package/packages/daemon/dist/tui/mirror/recipes.js +395 -0
  749. package/packages/daemon/dist/tui/mirror/reference-performance-trace.d.ts +80 -0
  750. package/packages/daemon/dist/tui/mirror/reference-performance-trace.js +597 -0
  751. package/packages/daemon/dist/tui/mirror/renderer-commands.d.ts +60 -0
  752. package/packages/daemon/dist/tui/mirror/renderer-commands.js +250 -0
  753. package/packages/daemon/dist/tui/mirror/resize-model.d.ts +76 -0
  754. package/packages/daemon/dist/tui/mirror/resize-model.js +105 -0
  755. package/packages/daemon/dist/tui/mirror/resize-transaction.d.ts +102 -0
  756. package/packages/daemon/dist/tui/mirror/resize-transaction.js +221 -0
  757. package/packages/daemon/dist/tui/mirror/rich-placement-projection.d.ts +64 -0
  758. package/packages/daemon/dist/tui/mirror/rich-placement-projection.js +80 -0
  759. package/packages/daemon/dist/tui/mirror/runtime/application-appearance-owner.d.ts +22 -0
  760. package/packages/daemon/dist/tui/mirror/runtime/application-appearance-owner.js +79 -0
  761. package/packages/daemon/dist/tui/mirror/runtime/application-bootstrap.d.ts +61 -0
  762. package/packages/daemon/dist/tui/mirror/runtime/application-bootstrap.js +51 -0
  763. package/packages/daemon/dist/tui/mirror/runtime/application-generation-starter.d.ts +26 -0
  764. package/packages/daemon/dist/tui/mirror/runtime/application-generation-starter.js +80 -0
  765. package/packages/daemon/dist/tui/mirror/runtime/application-home-catalog-owner.d.ts +21 -0
  766. package/packages/daemon/dist/tui/mirror/runtime/application-home-catalog-owner.js +88 -0
  767. package/packages/daemon/dist/tui/mirror/runtime/application-home-catalog.d.ts +60 -0
  768. package/packages/daemon/dist/tui/mirror/runtime/application-home-catalog.js +320 -0
  769. package/packages/daemon/dist/tui/mirror/runtime/application-host-focus-control-binding.d.ts +28 -0
  770. package/packages/daemon/dist/tui/mirror/runtime/application-host-focus-control-binding.js +111 -0
  771. package/packages/daemon/dist/tui/mirror/runtime/application-host-focus-control-capability.d.ts +16 -0
  772. package/packages/daemon/dist/tui/mirror/runtime/application-host-focus-control-capability.js +25 -0
  773. package/packages/daemon/dist/tui/mirror/runtime/application-host-focus-presentation.d.ts +38 -0
  774. package/packages/daemon/dist/tui/mirror/runtime/application-host-focus-presentation.js +129 -0
  775. package/packages/daemon/dist/tui/mirror/runtime/application-host-focus-test-control.d.ts +43 -0
  776. package/packages/daemon/dist/tui/mirror/runtime/application-host-focus-test-control.js +242 -0
  777. package/packages/daemon/dist/tui/mirror/runtime/application-input-readiness.d.ts +5 -0
  778. package/packages/daemon/dist/tui/mirror/runtime/application-input-readiness.js +20 -0
  779. package/packages/daemon/dist/tui/mirror/runtime/application-lifecycle.d.ts +72 -0
  780. package/packages/daemon/dist/tui/mirror/runtime/application-lifecycle.js +297 -0
  781. package/packages/daemon/dist/tui/mirror/runtime/application-optional-features.d.ts +14 -0
  782. package/packages/daemon/dist/tui/mirror/runtime/application-optional-features.js +12 -0
  783. package/packages/daemon/dist/tui/mirror/runtime/application-palette-command-owner.d.ts +23 -0
  784. package/packages/daemon/dist/tui/mirror/runtime/application-palette-command-owner.js +61 -0
  785. package/packages/daemon/dist/tui/mirror/runtime/application-palette-input.d.ts +31 -0
  786. package/packages/daemon/dist/tui/mirror/runtime/application-palette-input.js +60 -0
  787. package/packages/daemon/dist/tui/mirror/runtime/application-pane-rename-input.d.ts +22 -0
  788. package/packages/daemon/dist/tui/mirror/runtime/application-pane-rename-input.js +30 -0
  789. package/packages/daemon/dist/tui/mirror/runtime/application-pane-rename-owner.d.ts +14 -0
  790. package/packages/daemon/dist/tui/mirror/runtime/application-pane-rename-owner.js +38 -0
  791. package/packages/daemon/dist/tui/mirror/runtime/application-pending-terminal-input.d.ts +53 -0
  792. package/packages/daemon/dist/tui/mirror/runtime/application-pending-terminal-input.js +74 -0
  793. package/packages/daemon/dist/tui/mirror/runtime/application-performance-log.d.ts +20 -0
  794. package/packages/daemon/dist/tui/mirror/runtime/application-performance-log.js +81 -0
  795. package/packages/daemon/dist/tui/mirror/runtime/application-post-render-runtime.d.ts +37 -0
  796. package/packages/daemon/dist/tui/mirror/runtime/application-post-render-runtime.js +117 -0
  797. package/packages/daemon/dist/tui/mirror/runtime/application-root-configuration.d.ts +21 -0
  798. package/packages/daemon/dist/tui/mirror/runtime/application-root-configuration.js +21 -0
  799. package/packages/daemon/dist/tui/mirror/runtime/application-root-renderer.d.ts +9 -0
  800. package/packages/daemon/dist/tui/mirror/runtime/application-root-renderer.js +27 -0
  801. package/packages/daemon/dist/tui/mirror/runtime/application-session-focus-owner.d.ts +14 -0
  802. package/packages/daemon/dist/tui/mirror/runtime/application-session-focus-owner.js +65 -0
  803. package/packages/daemon/dist/tui/mirror/runtime/application-shell-binding.d.ts +34 -0
  804. package/packages/daemon/dist/tui/mirror/runtime/application-shell-binding.js +307 -0
  805. package/packages/daemon/dist/tui/mirror/runtime/application-shell-viewport.d.ts +8 -0
  806. package/packages/daemon/dist/tui/mirror/runtime/application-shell-viewport.js +14 -0
  807. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-frame-readiness-owner.d.ts +6 -0
  808. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-frame-readiness-owner.js +20 -0
  809. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-host-focus-owner.d.ts +3 -0
  810. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-host-focus-owner.js +25 -0
  811. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-input-ingress.d.ts +15 -0
  812. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-input-ingress.js +96 -0
  813. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-interaction-controller.d.ts +65 -0
  814. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-interaction-controller.js +1326 -0
  815. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-palette-owner.d.ts +65 -0
  816. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-palette-owner.js +217 -0
  817. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-paste.d.ts +4 -0
  818. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-paste.js +22 -0
  819. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-renderer-sources.d.ts +15 -0
  820. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-renderer-sources.js +31 -0
  821. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-selection-owner.d.ts +47 -0
  822. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-selection-owner.js +161 -0
  823. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-workspace-policy.d.ts +44 -0
  824. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-workspace-policy.js +177 -0
  825. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-workspace.d.ts +103 -0
  826. package/packages/daemon/dist/tui/mirror/runtime/application-terminal-workspace.jsx +720 -0
  827. package/packages/daemon/dist/tui/mirror/runtime/application-theme-repaint.d.ts +24 -0
  828. package/packages/daemon/dist/tui/mirror/runtime/application-theme-repaint.js +34 -0
  829. package/packages/daemon/dist/tui/mirror/runtime/application-transient-note-owner.d.ts +15 -0
  830. package/packages/daemon/dist/tui/mirror/runtime/application-transient-note-owner.js +29 -0
  831. package/packages/daemon/dist/tui/mirror/runtime/bounded-performance-record-writer.d.ts +17 -0
  832. package/packages/daemon/dist/tui/mirror/runtime/bounded-performance-record-writer.js +67 -0
  833. package/packages/daemon/dist/tui/mirror/runtime/causal-cell-client-ledger.d.ts +64 -0
  834. package/packages/daemon/dist/tui/mirror/runtime/causal-cell-client-ledger.js +271 -0
  835. package/packages/daemon/dist/tui/mirror/runtime/causal-cell-input-fixture.d.ts +12 -0
  836. package/packages/daemon/dist/tui/mirror/runtime/causal-cell-input-fixture.js +43 -0
  837. package/packages/daemon/dist/tui/mirror/runtime/changes-deferred-identity.d.ts +15 -0
  838. package/packages/daemon/dist/tui/mirror/runtime/changes-deferred-identity.js +17 -0
  839. package/packages/daemon/dist/tui/mirror/runtime/daemon-authority-rebind.d.ts +29 -0
  840. package/packages/daemon/dist/tui/mirror/runtime/daemon-authority-rebind.js +128 -0
  841. package/packages/daemon/dist/tui/mirror/runtime/deferred-intent-queue.d.ts +12 -0
  842. package/packages/daemon/dist/tui/mirror/runtime/deferred-intent-queue.js +40 -0
  843. package/packages/daemon/dist/tui/mirror/runtime/editor-primitives.d.ts +23 -0
  844. package/packages/daemon/dist/tui/mirror/runtime/editor-primitives.js +39 -0
  845. package/packages/daemon/dist/tui/mirror/runtime/file-content-primitives.d.ts +3 -0
  846. package/packages/daemon/dist/tui/mirror/runtime/file-content-primitives.js +9 -0
  847. package/packages/daemon/dist/tui/mirror/runtime/fleet-lifecycle-client.d.ts +4 -0
  848. package/packages/daemon/dist/tui/mirror/runtime/fleet-lifecycle-client.js +27 -0
  849. package/packages/daemon/dist/tui/mirror/runtime/focus-framebuffer-projection.d.ts +16 -0
  850. package/packages/daemon/dist/tui/mirror/runtime/focus-framebuffer-projection.js +53 -0
  851. package/packages/daemon/dist/tui/mirror/runtime/generation-bound-slot.d.ts +7 -0
  852. package/packages/daemon/dist/tui/mirror/runtime/generation-bound-slot.js +23 -0
  853. package/packages/daemon/dist/tui/mirror/runtime/host-local-tmux-adapter.d.ts +17 -0
  854. package/packages/daemon/dist/tui/mirror/runtime/host-local-tmux-adapter.js +90 -0
  855. package/packages/daemon/dist/tui/mirror/runtime/hosted-tty-size-bridge.d.ts +55 -0
  856. package/packages/daemon/dist/tui/mirror/runtime/hosted-tty-size-bridge.js +166 -0
  857. package/packages/daemon/dist/tui/mirror/runtime/latest-intent-fence.d.ts +11 -0
  858. package/packages/daemon/dist/tui/mirror/runtime/latest-intent-fence.js +14 -0
  859. package/packages/daemon/dist/tui/mirror/runtime/local-view-controller.d.ts +30 -0
  860. package/packages/daemon/dist/tui/mirror/runtime/local-view-controller.js +58 -0
  861. package/packages/daemon/dist/tui/mirror/runtime/modal-admission-coordinator.d.ts +44 -0
  862. package/packages/daemon/dist/tui/mirror/runtime/modal-admission-coordinator.js +118 -0
  863. package/packages/daemon/dist/tui/mirror/runtime/modal-pointer-capture.d.ts +13 -0
  864. package/packages/daemon/dist/tui/mirror/runtime/modal-pointer-capture.js +12 -0
  865. package/packages/daemon/dist/tui/mirror/runtime/open-tui-generation-host.d.ts +68 -0
  866. package/packages/daemon/dist/tui/mirror/runtime/open-tui-generation-host.js +834 -0
  867. package/packages/daemon/dist/tui/mirror/runtime/open-tui-session-owner.d.ts +19 -0
  868. package/packages/daemon/dist/tui/mirror/runtime/open-tui-session-owner.js +146 -0
  869. package/packages/daemon/dist/tui/mirror/runtime/optional-feature-registry.d.ts +45 -0
  870. package/packages/daemon/dist/tui/mirror/runtime/optional-feature-registry.js +178 -0
  871. package/packages/daemon/dist/tui/mirror/runtime/optional-feature-registry.typecheck.d.ts +11 -0
  872. package/packages/daemon/dist/tui/mirror/runtime/optional-feature-registry.typecheck.js +1 -0
  873. package/packages/daemon/dist/tui/mirror/runtime/palette-production-controller.d.ts +55 -0
  874. package/packages/daemon/dist/tui/mirror/runtime/palette-production-controller.js +126 -0
  875. package/packages/daemon/dist/tui/mirror/runtime/pane-resize-geometry.d.ts +11 -0
  876. package/packages/daemon/dist/tui/mirror/runtime/pane-resize-geometry.js +13 -0
  877. package/packages/daemon/dist/tui/mirror/runtime/pane-scoped-terminal-surface.d.ts +42 -0
  878. package/packages/daemon/dist/tui/mirror/runtime/pane-scoped-terminal-surface.jsx +67 -0
  879. package/packages/daemon/dist/tui/mirror/runtime/product-surface-policy.d.ts +11 -0
  880. package/packages/daemon/dist/tui/mirror/runtime/product-surface-policy.js +12 -0
  881. package/packages/daemon/dist/tui/mirror/runtime/renderer-cadence.d.ts +4 -0
  882. package/packages/daemon/dist/tui/mirror/runtime/renderer-cadence.js +4 -0
  883. package/packages/daemon/dist/tui/mirror/runtime/resize-terminal-pane.d.ts +35 -0
  884. package/packages/daemon/dist/tui/mirror/runtime/resize-terminal-pane.js +91 -0
  885. package/packages/daemon/dist/tui/mirror/runtime/rich-preview-demand.d.ts +14 -0
  886. package/packages/daemon/dist/tui/mirror/runtime/rich-preview-demand.js +14 -0
  887. package/packages/daemon/dist/tui/mirror/runtime/runtime-layout-presentation.d.ts +20 -0
  888. package/packages/daemon/dist/tui/mirror/runtime/runtime-layout-presentation.js +111 -0
  889. package/packages/daemon/dist/tui/mirror/runtime/select-terminal-pane.d.ts +25 -0
  890. package/packages/daemon/dist/tui/mirror/runtime/select-terminal-pane.js +90 -0
  891. package/packages/daemon/dist/tui/mirror/runtime/semantic-pane-publication.d.ts +10 -0
  892. package/packages/daemon/dist/tui/mirror/runtime/semantic-pane-publication.js +14 -0
  893. package/packages/daemon/dist/tui/mirror/runtime/semantic-shell-viewport-resize.d.ts +15 -0
  894. package/packages/daemon/dist/tui/mirror/runtime/semantic-shell-viewport-resize.js +56 -0
  895. package/packages/daemon/dist/tui/mirror/runtime/terminal-dimensions-owner.d.ts +9 -0
  896. package/packages/daemon/dist/tui/mirror/runtime/terminal-dimensions-owner.js +9 -0
  897. package/packages/daemon/dist/tui/mirror/runtime/terminal-fast-lane-renderer-adapter.d.ts +52 -0
  898. package/packages/daemon/dist/tui/mirror/runtime/terminal-fast-lane-renderer-adapter.js +610 -0
  899. package/packages/daemon/dist/tui/mirror/runtime/terminal-frame-readiness.d.ts +16 -0
  900. package/packages/daemon/dist/tui/mirror/runtime/terminal-frame-readiness.js +84 -0
  901. package/packages/daemon/dist/tui/mirror/runtime/terminal-host-focus.d.ts +41 -0
  902. package/packages/daemon/dist/tui/mirror/runtime/terminal-host-focus.js +347 -0
  903. package/packages/daemon/dist/tui/mirror/runtime/terminal-host-frame-diagnostics.d.ts +3 -0
  904. package/packages/daemon/dist/tui/mirror/runtime/terminal-host-frame-diagnostics.js +37 -0
  905. package/packages/daemon/dist/tui/mirror/runtime/terminal-input-adapter.d.ts +10 -0
  906. package/packages/daemon/dist/tui/mirror/runtime/terminal-input-adapter.js +50 -0
  907. package/packages/daemon/dist/tui/mirror/runtime/terminal-layout-projection.d.ts +22 -0
  908. package/packages/daemon/dist/tui/mirror/runtime/terminal-layout-projection.js +28 -0
  909. package/packages/daemon/dist/tui/mirror/runtime/terminal-pane-input-router.d.ts +23 -0
  910. package/packages/daemon/dist/tui/mirror/runtime/terminal-pane-input-router.js +82 -0
  911. package/packages/daemon/dist/tui/mirror/runtime/terminal-selection.d.ts +66 -0
  912. package/packages/daemon/dist/tui/mirror/runtime/terminal-selection.js +141 -0
  913. package/packages/daemon/dist/tui/mirror/runtime/terminal-session-handoff.d.ts +50 -0
  914. package/packages/daemon/dist/tui/mirror/runtime/terminal-session-handoff.js +89 -0
  915. package/packages/daemon/dist/tui/mirror/runtime/terminal-tool-readiness.d.ts +31 -0
  916. package/packages/daemon/dist/tui/mirror/runtime/terminal-tool-readiness.js +64 -0
  917. package/packages/daemon/dist/tui/mirror/runtime/tool-resource-controller.d.ts +92 -0
  918. package/packages/daemon/dist/tui/mirror/runtime/tool-resource-controller.js +636 -0
  919. package/packages/daemon/dist/tui/mirror/runtime/tool-resource-projection.d.ts +59 -0
  920. package/packages/daemon/dist/tui/mirror/runtime/tool-resource-projection.js +169 -0
  921. package/packages/daemon/dist/tui/mirror/runtime/viewport-fit-coordinator.d.ts +8 -0
  922. package/packages/daemon/dist/tui/mirror/runtime/viewport-fit-coordinator.js +7 -0
  923. package/packages/daemon/dist/tui/mirror/runtime/workspace-terminal-fast-lane.d.ts +22 -0
  924. package/packages/daemon/dist/tui/mirror/runtime/workspace-terminal-fast-lane.js +498 -0
  925. package/packages/daemon/dist/tui/mirror/scrollbar-model.d.ts +35 -0
  926. package/packages/daemon/dist/tui/mirror/scrollbar-model.js +64 -0
  927. package/packages/daemon/dist/tui/mirror/search-model.d.ts +41 -0
  928. package/packages/daemon/dist/tui/mirror/search-model.js +62 -0
  929. package/packages/daemon/dist/tui/mirror/selection.d.ts +175 -0
  930. package/packages/daemon/dist/tui/mirror/selection.js +264 -0
  931. package/packages/daemon/dist/tui/mirror/semantic-pane-render-source.d.ts +147 -0
  932. package/packages/daemon/dist/tui/mirror/semantic-pane-render-source.js +562 -0
  933. package/packages/daemon/dist/tui/mirror/semantic-session-view.d.ts +86 -0
  934. package/packages/daemon/dist/tui/mirror/semantic-session-view.js +269 -0
  935. package/packages/daemon/dist/tui/mirror/settings-model.d.ts +108 -0
  936. package/packages/daemon/dist/tui/mirror/settings-model.js +304 -0
  937. package/packages/daemon/dist/tui/mirror/shell-chrome.d.ts +151 -0
  938. package/packages/daemon/dist/tui/mirror/shell-chrome.js +313 -0
  939. package/packages/daemon/dist/tui/mirror/size-truth.d.ts +92 -0
  940. package/packages/daemon/dist/tui/mirror/size-truth.js +104 -0
  941. package/packages/daemon/dist/tui/mirror/spans.d.ts +26 -0
  942. package/packages/daemon/dist/tui/mirror/spans.js +31 -0
  943. package/packages/daemon/dist/tui/mirror/status-grammar.d.ts +18 -0
  944. package/packages/daemon/dist/tui/mirror/status-grammar.js +29 -0
  945. package/packages/daemon/dist/tui/mirror/terminal-surface.d.ts +55 -0
  946. package/packages/daemon/dist/tui/mirror/terminal-surface.js +92 -0
  947. package/packages/daemon/dist/tui/mirror/terminal-text.d.ts +9 -0
  948. package/packages/daemon/dist/tui/mirror/terminal-text.js +38 -0
  949. package/packages/daemon/dist/tui/mirror/theme.d.ts +207 -0
  950. package/packages/daemon/dist/tui/mirror/theme.js +744 -0
  951. package/packages/daemon/dist/tui/mirror/ui/agent-badge.d.ts +11 -0
  952. package/packages/daemon/dist/tui/mirror/ui/agent-badge.jsx +14 -0
  953. package/packages/daemon/dist/tui/mirror/ui/badge.d.ts +13 -0
  954. package/packages/daemon/dist/tui/mirror/ui/badge.jsx +15 -0
  955. package/packages/daemon/dist/tui/mirror/ui/button.d.ts +26 -0
  956. package/packages/daemon/dist/tui/mirror/ui/button.jsx +66 -0
  957. package/packages/daemon/dist/tui/mirror/ui/dialog.d.ts +19 -0
  958. package/packages/daemon/dist/tui/mirror/ui/dialog.jsx +8 -0
  959. package/packages/daemon/dist/tui/mirror/ui/index.d.ts +16 -0
  960. package/packages/daemon/dist/tui/mirror/ui/index.js +16 -0
  961. package/packages/daemon/dist/tui/mirror/ui/key-hint.d.ts +13 -0
  962. package/packages/daemon/dist/tui/mirror/ui/key-hint.jsx +39 -0
  963. package/packages/daemon/dist/tui/mirror/ui/keyboard-router.d.ts +25 -0
  964. package/packages/daemon/dist/tui/mirror/ui/keyboard-router.jsx +46 -0
  965. package/packages/daemon/dist/tui/mirror/ui/menu.d.ts +24 -0
  966. package/packages/daemon/dist/tui/mirror/ui/menu.jsx +15 -0
  967. package/packages/daemon/dist/tui/mirror/ui/navigation-row.d.ts +21 -0
  968. package/packages/daemon/dist/tui/mirror/ui/navigation-row.jsx +62 -0
  969. package/packages/daemon/dist/tui/mirror/ui/overlay-frame.d.ts +25 -0
  970. package/packages/daemon/dist/tui/mirror/ui/overlay-frame.jsx +52 -0
  971. package/packages/daemon/dist/tui/mirror/ui/overlay-host.d.ts +24 -0
  972. package/packages/daemon/dist/tui/mirror/ui/overlay-host.jsx +33 -0
  973. package/packages/daemon/dist/tui/mirror/ui/overlay-list-row.d.ts +13 -0
  974. package/packages/daemon/dist/tui/mirror/ui/overlay-list-row.jsx +23 -0
  975. package/packages/daemon/dist/tui/mirror/ui/overlay-model.d.ts +29 -0
  976. package/packages/daemon/dist/tui/mirror/ui/overlay-model.js +45 -0
  977. package/packages/daemon/dist/tui/mirror/ui/state.d.ts +27 -0
  978. package/packages/daemon/dist/tui/mirror/ui/state.js +171 -0
  979. package/packages/daemon/dist/tui/mirror/ui/status-bar.d.ts +43 -0
  980. package/packages/daemon/dist/tui/mirror/ui/status-bar.jsx +102 -0
  981. package/packages/daemon/dist/tui/mirror/ui/surface.d.ts +14 -0
  982. package/packages/daemon/dist/tui/mirror/ui/surface.jsx +45 -0
  983. package/packages/daemon/dist/tui/mirror/ui/tabs.d.ts +26 -0
  984. package/packages/daemon/dist/tui/mirror/ui/tabs.jsx +88 -0
  985. package/packages/daemon/dist/tui/mirror/widget-fallback.d.ts +15 -0
  986. package/packages/daemon/dist/tui/mirror/widget-fallback.js +52 -0
  987. package/packages/daemon/dist/tui/mirror/widget-surface-model.d.ts +26 -0
  988. package/packages/daemon/dist/tui/mirror/widget-surface-model.js +145 -0
  989. package/packages/daemon/dist/tui/mirror/widget-surface.d.ts +13 -0
  990. package/packages/daemon/dist/tui/mirror/widget-surface.jsx +31 -0
  991. package/packages/daemon/dist/tui/mirror/workspace/agent-terminal-canvas.d.ts +53 -0
  992. package/packages/daemon/dist/tui/mirror/workspace/agent-terminal-canvas.js +77 -0
  993. package/packages/daemon/dist/tui/mirror/workspace/application-root-controller.d.ts +266 -0
  994. package/packages/daemon/dist/tui/mirror/workspace/application-root-controller.js +99 -0
  995. package/packages/daemon/dist/tui/mirror/workspace/application-shell-controller.d.ts +83 -0
  996. package/packages/daemon/dist/tui/mirror/workspace/application-shell-controller.js +292 -0
  997. package/packages/daemon/dist/tui/mirror/workspace/application-shell-surface-commands.d.ts +5 -0
  998. package/packages/daemon/dist/tui/mirror/workspace/application-shell-surface-commands.js +28 -0
  999. package/packages/daemon/dist/tui/mirror/workspace/application-shell.d.ts +49 -0
  1000. package/packages/daemon/dist/tui/mirror/workspace/application-shell.js +97 -0
  1001. package/packages/daemon/dist/tui/mirror/workspace/command-palette-surface-view.d.ts +11 -0
  1002. package/packages/daemon/dist/tui/mirror/workspace/command-palette-surface-view.jsx +158 -0
  1003. package/packages/daemon/dist/tui/mirror/workspace/command-palette-surface.d.ts +128 -0
  1004. package/packages/daemon/dist/tui/mirror/workspace/command-palette-surface.js +342 -0
  1005. package/packages/daemon/dist/tui/mirror/workspace/icons.d.ts +154 -0
  1006. package/packages/daemon/dist/tui/mirror/workspace/icons.js +43 -0
  1007. package/packages/daemon/dist/tui/mirror/workspace/pane-action-menu.d.ts +24 -0
  1008. package/packages/daemon/dist/tui/mirror/workspace/pane-action-menu.jsx +20 -0
  1009. package/packages/daemon/dist/tui/mirror/workspace/pane-frame.d.ts +143 -0
  1010. package/packages/daemon/dist/tui/mirror/workspace/pane-frame.js +452 -0
  1011. package/packages/daemon/dist/tui/mirror/workspace/terminal-pane-chrome.d.ts +152 -0
  1012. package/packages/daemon/dist/tui/mirror/workspace/terminal-pane-chrome.js +555 -0
  1013. package/packages/daemon/dist/tui/mirror/workspace/terminal-pane-header.d.ts +58 -0
  1014. package/packages/daemon/dist/tui/mirror/workspace/terminal-pane-header.jsx +93 -0
  1015. package/packages/daemon/dist/tui/mirror/workspace/terminal-window-strip.d.ts +75 -0
  1016. package/packages/daemon/dist/tui/mirror/workspace/terminal-window-strip.jsx +253 -0
  1017. package/packages/daemon/dist/tui/mirror/workspace/text.d.ts +2 -0
  1018. package/packages/daemon/dist/tui/mirror/workspace/text.js +27 -0
  1019. package/packages/daemon/dist/tui/mirror/workspace/workbench-controller.d.ts +23 -0
  1020. package/packages/daemon/dist/tui/mirror/workspace/workbench-controller.js +34 -0
  1021. package/packages/daemon/dist/tui/mirror/workspace/workbench-shell.d.ts +123 -0
  1022. package/packages/daemon/dist/tui/mirror/workspace/workbench-shell.js +286 -0
  1023. package/packages/daemon/dist/tui/mirror/workspace-ui-state.d.ts +174 -0
  1024. package/packages/daemon/dist/tui/mirror/workspace-ui-state.js +885 -0
  1025. package/packages/daemon/dist/tui/readiness.d.ts +22 -0
  1026. package/packages/daemon/dist/tui/readiness.js +34 -0
  1027. package/packages/daemon/dist/tui/team/entry.d.ts +37 -0
  1028. package/packages/daemon/dist/tui/team/entry.js +20 -0
  1029. package/packages/daemon/dist/tui/team/fuzzy.d.ts +38 -0
  1030. package/packages/daemon/dist/tui/team/fuzzy.js +141 -0
  1031. package/packages/daemon/dist/tui/team/home.d.ts +94 -0
  1032. package/packages/daemon/dist/tui/team/home.js +115 -0
  1033. package/packages/daemon/dist/tui/team/input.d.ts +22 -0
  1034. package/packages/daemon/dist/tui/team/input.js +21 -0
  1035. package/packages/daemon/dist/tui/team/keymap.d.ts +33 -0
  1036. package/packages/daemon/dist/tui/team/keymap.js +99 -0
  1037. package/packages/daemon/dist/tui/team/mouse.d.ts +18 -0
  1038. package/packages/daemon/dist/tui/team/mouse.js +17 -0
  1039. package/packages/daemon/dist/tui/team/nav.d.ts +21 -0
  1040. package/packages/daemon/dist/tui/team/nav.js +33 -0
  1041. package/packages/daemon/dist/tui/team/preview.d.ts +19 -0
  1042. package/packages/daemon/dist/tui/team/preview.js +35 -0
  1043. package/packages/daemon/dist/tui/team/projects.d.ts +52 -0
  1044. package/packages/daemon/dist/tui/team/projects.js +159 -0
  1045. package/packages/daemon/dist/tui/team/report.d.ts +51 -0
  1046. package/packages/daemon/dist/tui/team/report.js +37 -0
  1047. package/packages/daemon/dist/tui/team/sessions.d.ts +235 -0
  1048. package/packages/daemon/dist/tui/team/sessions.js +292 -0
  1049. package/packages/daemon/dist/tui/team/tree.d.ts +41 -0
  1050. package/packages/daemon/dist/tui/team/tree.js +42 -0
  1051. package/packages/daemon/dist/tui/team/wait-receipts.d.ts +60 -0
  1052. package/packages/daemon/dist/tui/team/wait-receipts.js +153 -0
  1053. package/packages/daemon/dist/tui/team/wait.d.ts +62 -0
  1054. package/packages/daemon/dist/tui/team/wait.js +90 -0
  1055. package/packages/daemon/dist/validate.js +16 -10
  1056. package/packages/daemon/dist/widgets/lib/watcher.d.ts +5 -9
  1057. package/packages/daemon/dist/widgets/lib/watcher.js +5 -92
  1058. package/packages/daemon/dist/widgets/resolve.js +10 -7
  1059. package/packages/daemon/dist/widgets/setup/setup-model.js +7 -9
  1060. package/packages/daemon/src/attach.ts +2 -2
  1061. package/packages/daemon/src/canonical.ts +19 -2
  1062. package/packages/daemon/src/cli.ts +38 -36
  1063. package/packages/daemon/src/command-center/actions/command-definitions.ts +91 -0
  1064. package/packages/daemon/src/command-center/actions/dispatcher.ts +291 -10
  1065. package/packages/daemon/src/command-center/actions/errors.ts +40 -0
  1066. package/packages/daemon/src/command-center/actions/handlers/_project-context.ts +4 -5
  1067. package/packages/daemon/src/command-center/actions/handlers/app-window-mutate.ts +54 -0
  1068. package/packages/daemon/src/command-center/actions/handlers/config-actions.ts +59 -29
  1069. package/packages/daemon/src/command-center/actions/handlers/daemon-shutdown.ts +12 -0
  1070. package/packages/daemon/src/command-center/actions/handlers/fleet-lifecycle.ts +104 -0
  1071. package/packages/daemon/src/command-center/actions/handlers/project-launch.ts +20 -4
  1072. package/packages/daemon/src/command-center/actions/handlers/workspace-multiplexer.ts +96 -0
  1073. package/packages/daemon/src/command-center/actions/handlers/workspace-open.ts +141 -0
  1074. package/packages/daemon/src/command-center/actions/handlers/workspace-pane-create.ts +48 -0
  1075. package/packages/daemon/src/command-center/actions/handlers/workspace-promote.ts +48 -0
  1076. package/packages/daemon/src/command-center/actions/registry.ts +200 -1
  1077. package/packages/daemon/src/command-center/actions/semantic-multiplexer-actions.ts +26 -0
  1078. package/packages/daemon/src/command-center/agent-status-watch.ts +222 -0
  1079. package/packages/daemon/src/command-center/daemon-fleet-facts-observer.ts +465 -0
  1080. package/packages/daemon/src/command-center/discovery.ts +310 -5
  1081. package/packages/daemon/src/command-center/owner-authority.ts +118 -0
  1082. package/packages/daemon/src/command-center/pane-stream-issue.ts +247 -0
  1083. package/packages/daemon/src/command-center/resources/agent-graph-overlay.ts +270 -0
  1084. package/packages/daemon/src/command-center/resources/application-shell.ts +909 -0
  1085. package/packages/daemon/src/command-center/resources/desktop-missions.ts +171 -0
  1086. package/packages/daemon/src/command-center/resources/fleet-catalog.ts +200 -0
  1087. package/packages/daemon/src/command-center/resources/fleet-resource-route.ts +61 -0
  1088. package/packages/daemon/src/command-center/resources/startup-readiness-route.ts +172 -0
  1089. package/packages/daemon/src/command-center/resources/startup-readiness.ts +250 -0
  1090. package/packages/daemon/src/command-center/resources/terminal-runtime-inventory.ts +45 -0
  1091. package/packages/daemon/src/command-center/resources/workspace-changes-authority.ts +594 -0
  1092. package/packages/daemon/src/command-center/resources/workspace-changes-git.ts +278 -0
  1093. package/packages/daemon/src/command-center/resources/workspace-files-authority.ts +583 -0
  1094. package/packages/daemon/src/command-center/resources/workspace-missions-route.ts +125 -0
  1095. package/packages/daemon/src/command-center/resources/workspace-resource-ids.ts +81 -0
  1096. package/packages/daemon/src/command-center/resources/workspace-resource-routes.ts +147 -0
  1097. package/packages/daemon/src/command-center/server.ts +732 -59
  1098. package/packages/daemon/src/command-center/terminal-attachment-issue.ts +257 -0
  1099. package/packages/daemon/src/command-center/workspace-resource-observer.ts +560 -0
  1100. package/packages/daemon/src/command-center/ws-events.ts +853 -66
  1101. package/packages/daemon/src/config.ts +35 -25
  1102. package/packages/daemon/src/control/client.ts +128 -0
  1103. package/packages/daemon/src/control/dispatch.ts +107 -0
  1104. package/packages/daemon/src/control/fanout.ts +44 -0
  1105. package/packages/daemon/src/control/frames.ts +40 -0
  1106. package/packages/daemon/src/control/lifecycle.ts +163 -0
  1107. package/packages/daemon/src/control/server.ts +237 -0
  1108. package/packages/daemon/src/control/verbs.ts +118 -0
  1109. package/packages/daemon/src/detect.ts +25 -20
  1110. package/packages/daemon/src/doctor.ts +133 -33
  1111. package/packages/daemon/src/index.ts +244 -2
  1112. package/packages/daemon/src/init.ts +23 -22
  1113. package/packages/daemon/src/inspect.ts +41 -8
  1114. package/packages/daemon/src/launch.ts +56 -28
  1115. package/packages/daemon/src/lib/agent-discovery.ts +53 -13
  1116. package/packages/daemon/src/lib/agent-kind.ts +23 -0
  1117. package/packages/daemon/src/lib/app-config.ts +143 -9
  1118. package/packages/daemon/src/lib/app-window-kernel.ts +777 -0
  1119. package/packages/daemon/src/lib/app-window-mutation.ts +178 -0
  1120. package/packages/daemon/src/lib/app-window-repository.ts +650 -0
  1121. package/packages/daemon/src/lib/app-window-state.ts +599 -0
  1122. package/packages/daemon/src/lib/application-shell-app-windows.ts +357 -0
  1123. package/packages/daemon/src/lib/auth/middleware.ts +9 -3
  1124. package/packages/daemon/src/lib/canonical-daemon-bootstrap.ts +266 -0
  1125. package/packages/daemon/src/lib/canonical-daemon.ts +695 -73
  1126. package/packages/daemon/src/lib/chrome-front-door.ts +17 -0
  1127. package/packages/daemon/src/lib/cli-action-bridge.ts +127 -91
  1128. package/packages/daemon/src/lib/command-registry.ts +152 -0
  1129. package/packages/daemon/src/lib/config-context.ts +61 -0
  1130. package/packages/daemon/src/lib/daemon-embed.ts +1347 -387
  1131. package/packages/daemon/src/lib/daemon-session-monitor.ts +274 -0
  1132. package/packages/daemon/src/lib/daemon.ts +3 -46
  1133. package/packages/daemon/src/lib/directory-watcher.ts +166 -0
  1134. package/packages/daemon/src/lib/environment-identity.ts +82 -0
  1135. package/packages/daemon/src/lib/errors.ts +7 -1
  1136. package/packages/daemon/src/lib/fleet-agent-lifecycle.ts +74 -0
  1137. package/packages/daemon/src/lib/fleet-lifecycle-authority.ts +535 -0
  1138. package/packages/daemon/src/lib/headless-daemon.ts +406 -0
  1139. package/packages/daemon/src/lib/launch-plan.ts +123 -4
  1140. package/packages/daemon/src/lib/legacy-config-adapter.ts +28 -0
  1141. package/packages/daemon/src/lib/legacy-config-migration.ts +145 -0
  1142. package/packages/daemon/src/lib/legacy-theme-compat.ts +40 -0
  1143. package/packages/daemon/src/lib/manifest-pack.ts +255 -0
  1144. package/packages/daemon/src/lib/mission-projections.ts +775 -0
  1145. package/packages/daemon/src/lib/mission-repository.ts +1311 -0
  1146. package/packages/daemon/src/lib/onboarding-marker.ts +51 -0
  1147. package/packages/daemon/src/lib/pane-chrome.ts +14 -0
  1148. package/packages/daemon/src/lib/pane-source-credentials.ts +200 -0
  1149. package/packages/daemon/src/lib/pane-widget.ts +182 -0
  1150. package/packages/daemon/src/lib/project-inspect.ts +4 -0
  1151. package/packages/daemon/src/lib/project-onboard.ts +19 -24
  1152. package/packages/daemon/src/lib/project-probe.ts +38 -30
  1153. package/packages/daemon/src/lib/project-readiness-probe.ts +578 -0
  1154. package/packages/daemon/src/lib/project-readiness.ts +1034 -0
  1155. package/packages/daemon/src/lib/project-registry.ts +45 -9
  1156. package/packages/daemon/src/lib/project-resolver.ts +350 -0
  1157. package/packages/daemon/src/lib/project-runtime-errors.ts +41 -0
  1158. package/packages/daemon/src/lib/project-runtime-repository.ts +1194 -0
  1159. package/packages/daemon/src/lib/resolved-config.ts +425 -0
  1160. package/packages/daemon/src/lib/runtime-namespace.ts +186 -0
  1161. package/packages/daemon/src/lib/semantic-resource-id.ts +17 -0
  1162. package/packages/daemon/src/lib/session-monitor.ts +28 -20
  1163. package/packages/daemon/src/lib/session-options.ts +3 -10
  1164. package/packages/daemon/src/lib/state-home.ts +12 -0
  1165. package/packages/daemon/src/lib/theme-mode.ts +11 -0
  1166. package/packages/daemon/src/lib/tmux-external-interaction-observer.ts +632 -0
  1167. package/packages/daemon/src/lib/tmux-interaction-options.ts +171 -0
  1168. package/packages/daemon/src/lib/tmux-terminal-color.ts +44 -0
  1169. package/packages/daemon/src/lib/tui-binary.ts +354 -34
  1170. package/packages/daemon/src/lib/unix-socket-authority.ts +65 -0
  1171. package/packages/daemon/src/lib/update-check.ts +5 -0
  1172. package/packages/daemon/src/lib/widget-asset-policy.ts +3 -0
  1173. package/packages/daemon/src/lib/widget-asset-store.ts +218 -0
  1174. package/packages/daemon/src/lib/workspace-config-loader.ts +378 -0
  1175. package/packages/daemon/src/lib/workspace-multiplexer-verbs.ts +1362 -0
  1176. package/packages/daemon/src/lib/workspace-open-handoff.ts +340 -0
  1177. package/packages/daemon/src/lib/workspace-open.ts +983 -0
  1178. package/packages/daemon/src/lib/workspace-pane-creation.ts +1406 -0
  1179. package/packages/daemon/src/lib/workspace-promotion.ts +1031 -0
  1180. package/packages/daemon/src/lib/workspace-registry.ts +193 -25
  1181. package/packages/daemon/src/lib/workspace-state-repository.ts +1204 -0
  1182. package/packages/daemon/src/lib/workspace-state.ts +960 -0
  1183. package/packages/daemon/src/lib/yaml-io.ts +8 -17
  1184. package/packages/daemon/src/migrate.ts +134 -0
  1185. package/packages/daemon/src/restart.ts +2 -2
  1186. package/packages/daemon/src/restore.ts +67 -24
  1187. package/packages/daemon/src/schemas/inspect.ts +9 -1
  1188. package/packages/daemon/src/schemas/registry.ts +12 -22
  1189. package/packages/daemon/src/schemas/ws-events.ts +14 -131
  1190. package/packages/daemon/src/send.ts +191 -22
  1191. package/packages/daemon/src/server/pane-stream-upgrade.ts +141 -0
  1192. package/packages/daemon/src/server/terminal-attachment-upgrade.ts +153 -0
  1193. package/packages/daemon/src/status.ts +13 -8
  1194. package/packages/daemon/src/stop.ts +2 -2
  1195. package/packages/daemon/src/terminal/MonotonicPtyInput.ts +153 -0
  1196. package/packages/daemon/src/terminal/NodePtyAdapter.ts +53 -11
  1197. package/packages/daemon/src/terminal/PtyAdapter.ts +111 -3
  1198. package/packages/daemon/src/terminal/README.md +34 -16
  1199. package/packages/daemon/src/terminal/attachments/admission-util.ts +97 -0
  1200. package/packages/daemon/src/terminal/attachments/agent-status-probe.ts +474 -0
  1201. package/packages/daemon/src/terminal/attachments/direct-websocket.ts +1482 -0
  1202. package/packages/daemon/src/terminal/attachments/grouped-tmux.ts +293 -0
  1203. package/packages/daemon/src/terminal/attachments/lease-manager.ts +1042 -0
  1204. package/packages/daemon/src/terminal/attachments/native-runtime.ts +2206 -0
  1205. package/packages/daemon/src/terminal/attachments/pty-tmux-attachment-launcher.ts +750 -0
  1206. package/packages/daemon/src/terminal/attachments/semantic-pane-catalog.ts +365 -0
  1207. package/packages/daemon/src/terminal/attachments/tmux-view-executor.ts +1095 -0
  1208. package/packages/daemon/src/terminal/mirror/control-channel.ts +827 -0
  1209. package/packages/daemon/src/terminal/mirror/control-mode-ownership.ts +34 -0
  1210. package/packages/daemon/src/terminal/mirror/events.ts +128 -0
  1211. package/packages/daemon/src/terminal/mirror/flow-ledger.ts +65 -0
  1212. package/packages/daemon/src/terminal/mirror/mirror-service.ts +480 -0
  1213. package/packages/daemon/src/terminal/mirror/pane-feed.ts +193 -0
  1214. package/packages/daemon/src/terminal/mirror/session-channel.ts +2820 -0
  1215. package/packages/daemon/src/terminal/mirror/trusted-inventory.ts +29 -0
  1216. package/packages/daemon/src/terminal/pane-stream/lease-manager.ts +375 -0
  1217. package/packages/daemon/src/terminal/pane-stream/pane-stream-websocket.ts +2612 -0
  1218. package/packages/daemon/src/terminal/pane-stream/runtime.ts +78 -0
  1219. package/packages/daemon/src/terminal/pane-stream/wire-ledger.ts +155 -0
  1220. package/packages/daemon/src/terminal/protocol/README.md +14 -0
  1221. package/packages/daemon/src/terminal/protocol/chunk-bytes.ts +20 -0
  1222. package/packages/daemon/src/{tui/mirror → terminal/protocol}/control.ts +39 -6
  1223. package/packages/daemon/src/{tui/mirror → terminal/protocol}/input-coalescer.ts +18 -7
  1224. package/packages/daemon/src/terminal/protocol/layout-parse.ts +154 -0
  1225. package/packages/daemon/src/terminal/protocol/pane-display-name.ts +185 -0
  1226. package/packages/daemon/src/terminal/protocol/session-descriptor-discovery.ts +382 -0
  1227. package/packages/daemon/src/terminal/protocol/workspace-tmux-adapter.ts +470 -0
  1228. package/packages/daemon/src/terminal/session-runtime/authority-arbiter.ts +312 -0
  1229. package/packages/daemon/src/terminal/session-runtime/causal-cell-ledger.ts +359 -0
  1230. package/packages/daemon/src/terminal/session-runtime/interaction-receipt-facts.ts +173 -0
  1231. package/packages/daemon/src/terminal/session-runtime/multiplexer-backend.ts +194 -0
  1232. package/packages/daemon/src/terminal/session-runtime/registry.ts +2047 -0
  1233. package/packages/daemon/src/terminal/session-runtime/runtime-observability.ts +267 -0
  1234. package/packages/daemon/src/terminal/session-runtime/runtime-scheduler.ts +22 -0
  1235. package/packages/daemon/src/terminal/session-runtime/runtime-trace-correlator.ts +58 -0
  1236. package/packages/daemon/src/terminal/session-runtime/semantic-mutation-executor.ts +555 -0
  1237. package/packages/daemon/src/terminal/session-runtime/semantic-mutation-resource-changes.ts +48 -0
  1238. package/packages/daemon/src/terminal/session-runtime/terminal-delivery-hub.ts +1806 -0
  1239. package/packages/daemon/src/terminal/session-runtime/terminal-delivery-observation-identity.ts +18 -0
  1240. package/packages/daemon/src/terminal/session-runtime/terminal-interpreter-backend.ts +64 -0
  1241. package/packages/daemon/src/terminal/session-runtime/terminal-replica-interpreter.ts +690 -0
  1242. package/packages/daemon/src/terminal/session-runtime/terminal-replica-owner.ts +498 -0
  1243. package/packages/daemon/src/terminal/session-runtime/terminal-replica-shadow-projections.ts +36 -0
  1244. package/packages/daemon/src/terminal/session-runtime/transport-binding.ts +682 -0
  1245. package/packages/daemon/src/terminal/session-runtime/xterm-headless-provenance.json +25 -0
  1246. package/packages/daemon/src/terminal/session-runtime/xterm-terminal-interpreter-backend.ts +379 -0
  1247. package/packages/daemon/src/tui/async-disposable-slot.ts +60 -0
  1248. package/packages/daemon/src/tui/chrome/events.ts +4 -4
  1249. package/packages/daemon/src/tui/chrome/front-door.ts +27 -0
  1250. package/packages/daemon/src/tui/chrome/notify-prefs.ts +58 -0
  1251. package/packages/daemon/src/tui/chrome/notify-state.ts +76 -0
  1252. package/packages/daemon/src/tui/chrome/notify.ts +582 -84
  1253. package/packages/daemon/src/tui/chrome/sidebar.ts +9 -4
  1254. package/packages/daemon/src/tui/chrome/statusline.ts +15 -6
  1255. package/packages/daemon/src/tui/chrome/updater.ts +367 -64
  1256. package/packages/daemon/src/tui/compiled.ts +102 -6
  1257. package/packages/daemon/src/tui/detect/agent-resolution.ts +85 -0
  1258. package/packages/daemon/src/tui/detect/classify.ts +34 -0
  1259. package/packages/daemon/src/tui/detect/manifest-loader.ts +54 -5
  1260. package/packages/daemon/src/tui/detect/manifest.ts +24 -3
  1261. package/packages/daemon/src/tui/detect/manifests.ts +240 -6
  1262. package/packages/daemon/src/tui/detect/process-tree.ts +30 -4
  1263. package/packages/daemon/src/tui/detect/session-id.ts +503 -0
  1264. package/packages/daemon/src/tui/detect/snapshot.ts +38 -3
  1265. package/packages/daemon/src/tui/integrations/claude.ts +1 -0
  1266. package/packages/daemon/src/tui/integrations/opencode.ts +121 -0
  1267. package/packages/daemon/src/tui/main.ts +53 -0
  1268. package/packages/daemon/src/tui/mirror/RECIPES.md +59 -0
  1269. package/packages/daemon/src/tui/mirror/SHELL_CHROME.md +39 -0
  1270. package/packages/daemon/src/tui/mirror/THEME.md +48 -0
  1271. package/packages/daemon/src/tui/mirror/__snapshots__/activity-surface-renderer.test.tsx.snap +42 -0
  1272. package/packages/daemon/src/tui/mirror/__snapshots__/changes-terminal-surface-renderer.test.tsx.snap +267 -0
  1273. package/packages/daemon/src/tui/mirror/__snapshots__/home-files-surface-renderer.test.tsx.snap +267 -0
  1274. package/packages/daemon/src/tui/mirror/__snapshots__/missions-surface-renderer.test.tsx.snap +134 -0
  1275. package/packages/daemon/src/tui/mirror/__snapshots__/recipes-gallery-renderer.test.tsx.snap +141 -0
  1276. package/packages/daemon/src/tui/mirror/__snapshots__/shell-chrome-renderer.test.tsx.snap +134 -0
  1277. package/packages/daemon/src/tui/mirror/activity-surface-view.tsx +169 -0
  1278. package/packages/daemon/src/tui/mirror/activity-surface.ts +430 -0
  1279. package/packages/daemon/src/tui/mirror/agent-chip.ts +40 -11
  1280. package/packages/daemon/src/tui/mirror/agent-lifecycle.ts +468 -0
  1281. package/packages/daemon/src/tui/mirror/agent-provisioning-executor.ts +151 -0
  1282. package/packages/daemon/src/tui/mirror/agent-rows.ts +61 -5
  1283. package/packages/daemon/src/tui/mirror/ansi-palette.ts +3 -0
  1284. package/packages/daemon/src/tui/mirror/app-state.ts +185 -9
  1285. package/packages/daemon/src/tui/mirror/app.tsx +2 -5264
  1286. package/packages/daemon/src/tui/mirror/application-keybindings.ts +54 -0
  1287. package/packages/daemon/src/tui/mirror/application-shell-daemon-connection.ts +344 -0
  1288. package/packages/daemon/src/tui/mirror/application-shell-daemon-session.ts +74 -0
  1289. package/packages/daemon/src/tui/mirror/attention.ts +110 -0
  1290. package/packages/daemon/src/tui/mirror/canonical-workspace-routing.ts +63 -0
  1291. package/packages/daemon/src/tui/mirror/changes-surface-view.tsx +263 -0
  1292. package/packages/daemon/src/tui/mirror/changes-surface.ts +338 -0
  1293. package/packages/daemon/src/tui/mirror/composite-layout.ts +710 -0
  1294. package/packages/daemon/src/tui/mirror/configless-session-bootstrap.ts +192 -0
  1295. package/packages/daemon/src/tui/mirror/dialog-model.ts +2 -2
  1296. package/packages/daemon/src/tui/mirror/dialog-stack-core.ts +264 -0
  1297. package/packages/daemon/src/tui/mirror/dialog-stack.ts +2 -354
  1298. package/packages/daemon/src/tui/mirror/diff-model.ts +279 -4
  1299. package/packages/daemon/src/tui/mirror/editor-buffer.ts +9 -70
  1300. package/packages/daemon/src/tui/mirror/editor-open-policy.ts +16 -0
  1301. package/packages/daemon/src/tui/mirror/features/changes/contract.ts +84 -0
  1302. package/packages/daemon/src/tui/mirror/features/changes/controller.ts +470 -0
  1303. package/packages/daemon/src/tui/mirror/features/changes/feature.tsx +19 -0
  1304. package/packages/daemon/src/tui/mirror/features/dialogs/contract.ts +64 -0
  1305. package/packages/daemon/src/tui/mirror/features/dialogs/feature.tsx +227 -0
  1306. package/packages/daemon/src/tui/mirror/features/dialogs/session.ts +186 -0
  1307. package/packages/daemon/src/tui/mirror/features/files/feature.tsx +54 -0
  1308. package/packages/daemon/src/tui/mirror/features/files/session.ts +694 -0
  1309. package/packages/daemon/src/tui/mirror/features/home/feature.tsx +172 -0
  1310. package/packages/daemon/src/tui/mirror/features/missions-activity/contract.ts +106 -0
  1311. package/packages/daemon/src/tui/mirror/features/missions-activity/feature.tsx +19 -0
  1312. package/packages/daemon/src/tui/mirror/features/missions-activity/session.ts +470 -0
  1313. package/packages/daemon/src/tui/mirror/features/palette/contract.ts +121 -0
  1314. package/packages/daemon/src/tui/mirror/features/palette/feature.ts +14 -0
  1315. package/packages/daemon/src/tui/mirror/features/palette/session.ts +427 -0
  1316. package/packages/daemon/src/tui/mirror/features/palette/surface.tsx +92 -0
  1317. package/packages/daemon/src/tui/mirror/features/performance-hud/contract.ts +20 -0
  1318. package/packages/daemon/src/tui/mirror/features/performance-hud/feature.tsx +8 -0
  1319. package/packages/daemon/src/tui/mirror/features/performance-hud/session.ts +152 -0
  1320. package/packages/daemon/src/tui/mirror/features/performance-hud/surface.tsx +137 -0
  1321. package/packages/daemon/src/tui/mirror/features/rich-preview/asset-loader.ts +153 -0
  1322. package/packages/daemon/src/tui/mirror/features/rich-preview/contract.ts +94 -0
  1323. package/packages/daemon/src/tui/mirror/features/rich-preview/feature.tsx +141 -0
  1324. package/packages/daemon/src/tui/mirror/features/rich-preview/session.ts +387 -0
  1325. package/packages/daemon/src/tui/mirror/features/settings/catalog.ts +26 -0
  1326. package/packages/daemon/src/tui/mirror/features/settings/contract.ts +41 -0
  1327. package/packages/daemon/src/tui/mirror/features/settings/feature.ts +3 -0
  1328. package/packages/daemon/src/tui/mirror/features/settings/session.ts +375 -0
  1329. package/packages/daemon/src/tui/mirror/file-tree.ts +231 -6
  1330. package/packages/daemon/src/tui/mirror/files-surface-view.tsx +242 -0
  1331. package/packages/daemon/src/tui/mirror/files-surface.ts +371 -0
  1332. package/packages/daemon/src/tui/mirror/focus-projection.ts +113 -0
  1333. package/packages/daemon/src/tui/mirror/frame-coalescer.ts +87 -0
  1334. package/packages/daemon/src/tui/mirror/home-model.ts +1 -1
  1335. package/packages/daemon/src/tui/mirror/home-surface-model.ts +440 -0
  1336. package/packages/daemon/src/tui/mirror/home-surface.tsx +254 -0
  1337. package/packages/daemon/src/tui/mirror/host-terminal.ts +49 -0
  1338. package/packages/daemon/src/tui/mirror/hosted.ts +286 -0
  1339. package/packages/daemon/src/tui/mirror/input-lifecycle.ts +248 -0
  1340. package/packages/daemon/src/tui/mirror/interaction-flow.ts +83 -0
  1341. package/packages/daemon/src/tui/mirror/legacy/missions-workspace-loader.ts +117 -0
  1342. package/packages/daemon/src/tui/mirror/menu-model.ts +28 -18
  1343. package/packages/daemon/src/tui/mirror/missions-dashboard.ts +451 -0
  1344. package/packages/daemon/src/tui/mirror/missions-render-fixtures.ts +371 -0
  1345. package/packages/daemon/src/tui/mirror/missions-surface-controller.ts +530 -0
  1346. package/packages/daemon/src/tui/mirror/missions-surface.tsx +434 -0
  1347. package/packages/daemon/src/tui/mirror/missions-workspace.ts +1996 -0
  1348. package/packages/daemon/src/tui/mirror/multiplexer-action-executor.ts +379 -0
  1349. package/packages/daemon/src/tui/mirror/open-tui-pane-stream-socket.ts +47 -0
  1350. package/packages/daemon/src/tui/mirror/open-tui-verified-routing.ts +83 -0
  1351. package/packages/daemon/src/tui/mirror/open-tui-workspace-runtime-port.ts +1314 -0
  1352. package/packages/daemon/src/tui/mirror/palette-surface-adapter.ts +465 -0
  1353. package/packages/daemon/src/tui/mirror/palette.ts +485 -34
  1354. package/packages/daemon/src/tui/mirror/pane-frame-state.ts +209 -0
  1355. package/packages/daemon/src/tui/mirror/pane-mirror.ts +215 -50
  1356. package/packages/daemon/src/tui/mirror/pane-surface.tsx +720 -51
  1357. package/packages/daemon/src/tui/mirror/panel-host-reactive.ts +17 -0
  1358. package/packages/daemon/src/tui/mirror/panel-host.ts +384 -0
  1359. package/packages/daemon/src/tui/mirror/perf-tap.ts +1 -122
  1360. package/packages/daemon/src/tui/mirror/performance-events.ts +488 -0
  1361. package/packages/daemon/src/tui/mirror/recipe-components.tsx +310 -0
  1362. package/packages/daemon/src/tui/mirror/recipes-gallery.tsx +256 -0
  1363. package/packages/daemon/src/tui/mirror/recipes.ts +543 -0
  1364. package/packages/daemon/src/tui/mirror/reference-performance-trace.ts +726 -0
  1365. package/packages/daemon/src/tui/mirror/renderer-commands.ts +344 -0
  1366. package/packages/daemon/src/tui/mirror/resize-model.ts +74 -9
  1367. package/packages/daemon/src/tui/mirror/resize-transaction.ts +342 -0
  1368. package/packages/daemon/src/tui/mirror/rich-placement-projection.ts +173 -0
  1369. package/packages/daemon/src/tui/mirror/runtime/__snapshots__/application-shell-view-renderer.test.tsx.snap +87 -0
  1370. package/packages/daemon/src/tui/mirror/runtime/application-appearance-owner.ts +121 -0
  1371. package/packages/daemon/src/tui/mirror/runtime/application-bootstrap.ts +118 -0
  1372. package/packages/daemon/src/tui/mirror/runtime/application-entry.ts +194 -0
  1373. package/packages/daemon/src/tui/mirror/runtime/application-generation-starter.ts +116 -0
  1374. package/packages/daemon/src/tui/mirror/runtime/application-home-catalog-owner.ts +112 -0
  1375. package/packages/daemon/src/tui/mirror/runtime/application-home-catalog.ts +440 -0
  1376. package/packages/daemon/src/tui/mirror/runtime/application-host-focus-control-binding.ts +143 -0
  1377. package/packages/daemon/src/tui/mirror/runtime/application-host-focus-control-capability.ts +46 -0
  1378. package/packages/daemon/src/tui/mirror/runtime/application-host-focus-presentation.ts +176 -0
  1379. package/packages/daemon/src/tui/mirror/runtime/application-host-focus-test-control.ts +313 -0
  1380. package/packages/daemon/src/tui/mirror/runtime/application-input-readiness.ts +28 -0
  1381. package/packages/daemon/src/tui/mirror/runtime/application-lifecycle.ts +374 -0
  1382. package/packages/daemon/src/tui/mirror/runtime/application-optional-features.ts +25 -0
  1383. package/packages/daemon/src/tui/mirror/runtime/application-palette-command-owner.ts +87 -0
  1384. package/packages/daemon/src/tui/mirror/runtime/application-palette-input.ts +105 -0
  1385. package/packages/daemon/src/tui/mirror/runtime/application-pane-rename-input.ts +43 -0
  1386. package/packages/daemon/src/tui/mirror/runtime/application-pane-rename-owner.ts +43 -0
  1387. package/packages/daemon/src/tui/mirror/runtime/application-pending-terminal-input.ts +117 -0
  1388. package/packages/daemon/src/tui/mirror/runtime/application-performance-log.ts +110 -0
  1389. package/packages/daemon/src/tui/mirror/runtime/application-post-render-runtime.ts +163 -0
  1390. package/packages/daemon/src/tui/mirror/runtime/application-root-configuration.ts +47 -0
  1391. package/packages/daemon/src/tui/mirror/runtime/application-root-renderer.ts +32 -0
  1392. package/packages/daemon/src/tui/mirror/runtime/application-root-v2.tsx +506 -0
  1393. package/packages/daemon/src/tui/mirror/runtime/application-session-focus-owner.ts +80 -0
  1394. package/packages/daemon/src/tui/mirror/runtime/application-shell-binding.ts +365 -0
  1395. package/packages/daemon/src/tui/mirror/runtime/application-shell-catalog.tsx +372 -0
  1396. package/packages/daemon/src/tui/mirror/runtime/application-shell-home.tsx +161 -0
  1397. package/packages/daemon/src/tui/mirror/runtime/application-shell-overlay-stack.tsx +42 -0
  1398. package/packages/daemon/src/tui/mirror/runtime/application-shell-overlays.tsx +154 -0
  1399. package/packages/daemon/src/tui/mirror/runtime/application-shell-sidebar.tsx +140 -0
  1400. package/packages/daemon/src/tui/mirror/runtime/application-shell-view.tsx +425 -0
  1401. package/packages/daemon/src/tui/mirror/runtime/application-shell-viewport.ts +18 -0
  1402. package/packages/daemon/src/tui/mirror/runtime/application-terminal-frame-readiness-owner.ts +33 -0
  1403. package/packages/daemon/src/tui/mirror/runtime/application-terminal-host-focus-owner.ts +36 -0
  1404. package/packages/daemon/src/tui/mirror/runtime/application-terminal-input-ingress.ts +133 -0
  1405. package/packages/daemon/src/tui/mirror/runtime/application-terminal-interaction-controller.ts +1630 -0
  1406. package/packages/daemon/src/tui/mirror/runtime/application-terminal-palette-owner.ts +302 -0
  1407. package/packages/daemon/src/tui/mirror/runtime/application-terminal-paste.ts +33 -0
  1408. package/packages/daemon/src/tui/mirror/runtime/application-terminal-renderer-sources.ts +33 -0
  1409. package/packages/daemon/src/tui/mirror/runtime/application-terminal-selection-owner.ts +218 -0
  1410. package/packages/daemon/src/tui/mirror/runtime/application-terminal-workspace-policy.ts +285 -0
  1411. package/packages/daemon/src/tui/mirror/runtime/application-terminal-workspace.tsx +1150 -0
  1412. package/packages/daemon/src/tui/mirror/runtime/application-theme-repaint.ts +45 -0
  1413. package/packages/daemon/src/tui/mirror/runtime/application-transient-note-owner.ts +42 -0
  1414. package/packages/daemon/src/tui/mirror/runtime/bounded-performance-record-writer.ts +75 -0
  1415. package/packages/daemon/src/tui/mirror/runtime/causal-cell-client-ledger.ts +394 -0
  1416. package/packages/daemon/src/tui/mirror/runtime/causal-cell-input-fixture.ts +55 -0
  1417. package/packages/daemon/src/tui/mirror/runtime/changes-deferred-identity.ts +34 -0
  1418. package/packages/daemon/src/tui/mirror/runtime/daemon-authority-rebind.ts +163 -0
  1419. package/packages/daemon/src/tui/mirror/runtime/deferred-intent-queue.ts +45 -0
  1420. package/packages/daemon/src/tui/mirror/runtime/editor-primitives.ts +56 -0
  1421. package/packages/daemon/src/tui/mirror/runtime/file-content-primitives.ts +8 -0
  1422. package/packages/daemon/src/tui/mirror/runtime/fleet-lifecycle-client.ts +61 -0
  1423. package/packages/daemon/src/tui/mirror/runtime/focus-framebuffer-projection.ts +71 -0
  1424. package/packages/daemon/src/tui/mirror/runtime/generation-bound-slot.ts +23 -0
  1425. package/packages/daemon/src/tui/mirror/runtime/host-local-tmux-adapter.ts +105 -0
  1426. package/packages/daemon/src/tui/mirror/runtime/hosted-tty-size-bridge.ts +213 -0
  1427. package/packages/daemon/src/tui/mirror/runtime/latest-intent-fence.ts +22 -0
  1428. package/packages/daemon/src/tui/mirror/runtime/local-view-controller.ts +95 -0
  1429. package/packages/daemon/src/tui/mirror/runtime/modal-admission-coordinator.ts +158 -0
  1430. package/packages/daemon/src/tui/mirror/runtime/modal-pointer-capture.ts +23 -0
  1431. package/packages/daemon/src/tui/mirror/runtime/open-tui-generation-host.ts +996 -0
  1432. package/packages/daemon/src/tui/mirror/runtime/open-tui-session-owner.ts +195 -0
  1433. package/packages/daemon/src/tui/mirror/runtime/optional-feature-registry.ts +234 -0
  1434. package/packages/daemon/src/tui/mirror/runtime/optional-feature-registry.typecheck.ts +14 -0
  1435. package/packages/daemon/src/tui/mirror/runtime/palette-production-controller.ts +170 -0
  1436. package/packages/daemon/src/tui/mirror/runtime/palette-production-overlay.tsx +65 -0
  1437. package/packages/daemon/src/tui/mirror/runtime/pane-resize-geometry.ts +22 -0
  1438. package/packages/daemon/src/tui/mirror/runtime/pane-scoped-terminal-surface.tsx +146 -0
  1439. package/packages/daemon/src/tui/mirror/runtime/product-surface-policy.ts +16 -0
  1440. package/packages/daemon/src/tui/mirror/runtime/renderer-cadence.ts +4 -0
  1441. package/packages/daemon/src/tui/mirror/runtime/resize-terminal-pane.ts +134 -0
  1442. package/packages/daemon/src/tui/mirror/runtime/rich-preview-demand.ts +26 -0
  1443. package/packages/daemon/src/tui/mirror/runtime/rich-preview-overlay.tsx +54 -0
  1444. package/packages/daemon/src/tui/mirror/runtime/runtime-layout-presentation.ts +119 -0
  1445. package/packages/daemon/src/tui/mirror/runtime/select-terminal-pane.ts +127 -0
  1446. package/packages/daemon/src/tui/mirror/runtime/semantic-pane-publication.ts +26 -0
  1447. package/packages/daemon/src/tui/mirror/runtime/semantic-shell-viewport-resize.ts +78 -0
  1448. package/packages/daemon/src/tui/mirror/runtime/terminal-dimensions-owner.ts +20 -0
  1449. package/packages/daemon/src/tui/mirror/runtime/terminal-fast-lane-renderer-adapter.ts +719 -0
  1450. package/packages/daemon/src/tui/mirror/runtime/terminal-frame-readiness.ts +100 -0
  1451. package/packages/daemon/src/tui/mirror/runtime/terminal-host-focus.ts +519 -0
  1452. package/packages/daemon/src/tui/mirror/runtime/terminal-host-frame-diagnostics.ts +47 -0
  1453. package/packages/daemon/src/tui/mirror/runtime/terminal-input-adapter.ts +69 -0
  1454. package/packages/daemon/src/tui/mirror/runtime/terminal-layout-projection.ts +45 -0
  1455. package/packages/daemon/src/tui/mirror/runtime/terminal-pane-input-router.ts +94 -0
  1456. package/packages/daemon/src/tui/mirror/runtime/terminal-selection.ts +218 -0
  1457. package/packages/daemon/src/tui/mirror/runtime/terminal-session-handoff.ts +143 -0
  1458. package/packages/daemon/src/tui/mirror/runtime/terminal-tool-readiness.ts +72 -0
  1459. package/packages/daemon/src/tui/mirror/runtime/tool-resource-controller.ts +799 -0
  1460. package/packages/daemon/src/tui/mirror/runtime/tool-resource-projection.ts +223 -0
  1461. package/packages/daemon/src/tui/mirror/runtime/viewport-fit-coordinator.ts +12 -0
  1462. package/packages/daemon/src/tui/mirror/runtime/workspace-terminal-fast-lane.ts +597 -0
  1463. package/packages/daemon/src/tui/mirror/selection.ts +122 -29
  1464. package/packages/daemon/src/tui/mirror/semantic-pane-render-source.ts +767 -0
  1465. package/packages/daemon/src/tui/mirror/semantic-session-view.ts +366 -0
  1466. package/packages/daemon/src/tui/mirror/settings-model.ts +95 -57
  1467. package/packages/daemon/src/tui/mirror/shell-chrome-view.tsx +346 -0
  1468. package/packages/daemon/src/tui/mirror/shell-chrome.ts +508 -0
  1469. package/packages/daemon/src/tui/mirror/sidebar.tsx +321 -0
  1470. package/packages/daemon/src/tui/mirror/size-truth.ts +53 -0
  1471. package/packages/daemon/src/tui/mirror/terminal-surface.ts +157 -0
  1472. package/packages/daemon/src/tui/mirror/terminal-surface.tsx +84 -0
  1473. package/packages/daemon/src/tui/mirror/terminal-text.ts +42 -0
  1474. package/packages/daemon/src/tui/mirror/theme.ts +1059 -0
  1475. package/packages/daemon/src/tui/mirror/ui/agent-badge.tsx +41 -0
  1476. package/packages/daemon/src/tui/mirror/ui/badge.tsx +42 -0
  1477. package/packages/daemon/src/tui/mirror/ui/button.tsx +127 -0
  1478. package/packages/daemon/src/tui/mirror/ui/dialog.tsx +45 -0
  1479. package/packages/daemon/src/tui/mirror/ui/index.ts +59 -0
  1480. package/packages/daemon/src/tui/mirror/ui/key-hint.tsx +63 -0
  1481. package/packages/daemon/src/tui/mirror/ui/keyboard-router.tsx +72 -0
  1482. package/packages/daemon/src/tui/mirror/ui/menu.tsx +68 -0
  1483. package/packages/daemon/src/tui/mirror/ui/navigation-row.tsx +114 -0
  1484. package/packages/daemon/src/tui/mirror/ui/overlay-frame.tsx +115 -0
  1485. package/packages/daemon/src/tui/mirror/ui/overlay-host.tsx +71 -0
  1486. package/packages/daemon/src/tui/mirror/ui/overlay-list-row.tsx +59 -0
  1487. package/packages/daemon/src/tui/mirror/ui/overlay-model.ts +75 -0
  1488. package/packages/daemon/src/tui/mirror/ui/state.ts +218 -0
  1489. package/packages/daemon/src/tui/mirror/ui/status-bar.tsx +208 -0
  1490. package/packages/daemon/src/tui/mirror/ui/surface.tsx +71 -0
  1491. package/packages/daemon/src/tui/mirror/ui/tabs.tsx +168 -0
  1492. package/packages/daemon/src/tui/mirror/widget-fallback.ts +66 -0
  1493. package/packages/daemon/src/tui/mirror/widget-surface-model.ts +170 -0
  1494. package/packages/daemon/src/tui/mirror/widget-surface.tsx +79 -0
  1495. package/packages/daemon/src/tui/mirror/workspace/README.md +79 -0
  1496. package/packages/daemon/src/tui/mirror/workspace/__snapshots__/agent-terminal-canvas-renderer.test.tsx.snap +348 -0
  1497. package/packages/daemon/src/tui/mirror/workspace/__snapshots__/application-shell-renderer.test.tsx.snap +134 -0
  1498. package/packages/daemon/src/tui/mirror/workspace/__snapshots__/command-palette-surface-renderer.test.tsx.snap +255 -0
  1499. package/packages/daemon/src/tui/mirror/workspace/__snapshots__/pane-frame-renderer.test.tsx.snap +525 -0
  1500. package/packages/daemon/src/tui/mirror/workspace/__snapshots__/workbench-shell-renderer.test.tsx.snap +134 -0
  1501. package/packages/daemon/src/tui/mirror/workspace/agent-terminal-canvas-view.tsx +61 -0
  1502. package/packages/daemon/src/tui/mirror/workspace/agent-terminal-canvas.ts +131 -0
  1503. package/packages/daemon/src/tui/mirror/workspace/application-root-controller.ts +169 -0
  1504. package/packages/daemon/src/tui/mirror/workspace/application-shell-controller.ts +430 -0
  1505. package/packages/daemon/src/tui/mirror/workspace/application-shell-surface-commands.ts +64 -0
  1506. package/packages/daemon/src/tui/mirror/workspace/application-shell-view.tsx +169 -0
  1507. package/packages/daemon/src/tui/mirror/workspace/application-shell.ts +179 -0
  1508. package/packages/daemon/src/tui/mirror/workspace/command-palette-surface-view.tsx +356 -0
  1509. package/packages/daemon/src/tui/mirror/workspace/command-palette-surface.ts +544 -0
  1510. package/packages/daemon/src/tui/mirror/workspace/icons.ts +56 -0
  1511. package/packages/daemon/src/tui/mirror/workspace/pane-action-menu.tsx +68 -0
  1512. package/packages/daemon/src/tui/mirror/workspace/pane-frame.ts +675 -0
  1513. package/packages/daemon/src/tui/mirror/workspace/pane-frame.tsx +490 -0
  1514. package/packages/daemon/src/tui/mirror/workspace/terminal-pane-chrome-view.tsx +125 -0
  1515. package/packages/daemon/src/tui/mirror/workspace/terminal-pane-chrome.ts +833 -0
  1516. package/packages/daemon/src/tui/mirror/workspace/terminal-pane-header.tsx +225 -0
  1517. package/packages/daemon/src/tui/mirror/workspace/terminal-window-strip.tsx +466 -0
  1518. package/packages/daemon/src/tui/mirror/workspace/text.ts +28 -0
  1519. package/packages/daemon/src/tui/mirror/workspace/workbench-controller.ts +75 -0
  1520. package/packages/daemon/src/tui/mirror/workspace/workbench-dock-opentui.tsx +224 -0
  1521. package/packages/daemon/src/tui/mirror/workspace/workbench-shell.ts +486 -0
  1522. package/packages/daemon/src/tui/mirror/workspace/workbench-shell.tsx +95 -0
  1523. package/packages/daemon/src/tui/mirror/workspace-ui-state.ts +1278 -0
  1524. package/packages/daemon/src/tui/readiness.ts +52 -0
  1525. package/packages/daemon/src/tui/team/entry.ts +23 -13
  1526. package/packages/daemon/src/tui/team/fuzzy.ts +20 -0
  1527. package/packages/daemon/src/tui/team/home.ts +1 -1
  1528. package/packages/daemon/src/tui/team/index.tsx +27 -8
  1529. package/packages/daemon/src/tui/team/projects.ts +12 -0
  1530. package/packages/daemon/src/tui/team/sessions.ts +119 -46
  1531. package/packages/daemon/src/tui/team/wait-receipts.ts +192 -0
  1532. package/packages/daemon/src/tui/team/wait.ts +144 -0
  1533. package/packages/daemon/src/ui/pane-frame/fixture.ts +43 -0
  1534. package/packages/daemon/src/ui/workbench-dock/fixture.ts +61 -0
  1535. package/packages/daemon/src/validate.ts +21 -9
  1536. package/packages/daemon/src/widgets/config/README.md +1 -1
  1537. package/packages/daemon/src/widgets/config/index.tsx +15 -115
  1538. package/packages/daemon/src/widgets/lib/watcher.ts +3 -130
  1539. package/packages/daemon/src/widgets/resolve.ts +15 -7
  1540. package/packages/daemon/src/widgets/setup/footer.tsx +0 -7
  1541. package/packages/daemon/src/widgets/setup/index.tsx +18 -20
  1542. package/packages/daemon/src/widgets/setup/review-panel.tsx +15 -10
  1543. package/packages/daemon/src/widgets/setup/setup-model.ts +7 -10
  1544. package/packages/daemon-client/package.json +42 -0
  1545. package/packages/daemon-client/src/application-shell-session.test.ts +196 -0
  1546. package/packages/daemon-client/src/application-shell-session.ts +450 -0
  1547. package/packages/daemon-client/src/bootstrap-coordinator.test.ts +122 -0
  1548. package/packages/daemon-client/src/bootstrap-coordinator.ts +293 -0
  1549. package/packages/daemon-client/src/connection-supervisor.test.ts +109 -0
  1550. package/packages/daemon-client/src/connection-supervisor.ts +216 -0
  1551. package/packages/daemon-client/src/direct-application-shell-transport.test.ts +939 -0
  1552. package/packages/daemon-client/src/direct-application-shell-transport.ts +1144 -0
  1553. package/packages/daemon-client/src/first-latest-coordinator.test.ts +175 -0
  1554. package/packages/daemon-client/src/first-latest-coordinator.ts +82 -0
  1555. package/packages/daemon-client/src/generation-bound-store-timers.test.ts +74 -0
  1556. package/packages/daemon-client/src/generation-bound-store.ts +908 -0
  1557. package/packages/daemon-client/src/index.ts +25 -0
  1558. package/packages/daemon-client/src/owner-action-client.test.ts +180 -0
  1559. package/packages/daemon-client/src/owner-action-client.ts +113 -0
  1560. package/packages/daemon-client/src/pane-stream-client.test.ts +2754 -0
  1561. package/packages/daemon-client/src/pane-stream-client.ts +1665 -0
  1562. package/packages/daemon-client/src/pane-stream-clock-calibration.test.ts +207 -0
  1563. package/packages/daemon-client/src/pane-stream-clock-calibration.ts +161 -0
  1564. package/packages/daemon-client/src/pane-stream-loopback-benchmark.test.ts +51 -0
  1565. package/packages/daemon-client/src/push-resource-session.test.ts +509 -0
  1566. package/packages/daemon-client/src/push-resource-session.ts +797 -0
  1567. package/packages/daemon-client/src/resource-replica.test.ts +186 -0
  1568. package/packages/daemon-client/src/resource-replica.ts +280 -0
  1569. package/packages/daemon-client/src/runtime-resource-ledger.test.ts +18 -0
  1570. package/packages/daemon-client/src/runtime-resource-ledger.ts +69 -0
  1571. package/packages/daemon-client/src/terminal-fast-lane.test.ts +817 -0
  1572. package/packages/daemon-client/src/terminal-fast-lane.ts +817 -0
  1573. package/packages/daemon-client/src/terminal-fast-lane.typecheck.ts +16 -0
  1574. package/packages/daemon-client/src/workspace-catalog-v2.test.ts +109 -0
  1575. package/packages/daemon-client/src/workspace-catalog-v2.ts +66 -0
  1576. package/packages/daemon-client/src/workspace-client-boundaries.test.ts +59 -0
  1577. package/packages/daemon-client/src/workspace-client-conformance.ts +67 -0
  1578. package/packages/daemon-client/src/workspace-client-operations.ts +203 -0
  1579. package/packages/daemon-client/src/workspace-client-types.ts +302 -0
  1580. package/packages/daemon-client/src/workspace-client.test.ts +2626 -0
  1581. package/packages/daemon-client/src/workspace-client.ts +1421 -0
  1582. package/packages/daemon-client/src/workspace-event-supervisor.test.ts +1086 -0
  1583. package/packages/daemon-client/src/workspace-event-supervisor.ts +719 -0
  1584. package/packages/daemon-client/src/workspace-pane-client.test.ts +80 -0
  1585. package/packages/daemon-client/src/workspace-pane-client.ts +63 -0
  1586. package/packages/presentation/package.json +28 -0
  1587. package/packages/presentation/src/index.ts +2 -0
  1588. package/packages/presentation/src/pane-frame/action-state.ts +72 -0
  1589. package/packages/presentation/src/pane-frame/index.ts +3 -0
  1590. package/packages/presentation/src/pane-frame/model.ts +517 -0
  1591. package/packages/presentation/src/pane-frame/presenter.tsx +335 -0
  1592. package/packages/presentation/src/pane-frame/web-entry.tsx +22 -0
  1593. package/packages/presentation/src/pane-frame/web-host-unstyled.tsx +280 -0
  1594. package/packages/presentation/src/pane-frame/web-host.css +388 -0
  1595. package/packages/presentation/src/pane-frame/web-host.tsx +3 -0
  1596. package/packages/presentation/src/presentation-contract.test.ts +63 -0
  1597. package/packages/presentation/src/workbench-dock/index.ts +2 -0
  1598. package/packages/presentation/src/workbench-dock/navigation.ts +54 -0
  1599. package/packages/presentation/src/workbench-dock/presenter.tsx +252 -0
  1600. package/packages/presentation/src/workbench-dock/web-entry.tsx +19 -0
  1601. package/packages/presentation/src/workbench-dock/web-host-unstyled.tsx +198 -0
  1602. package/packages/presentation/src/workbench-dock/web-host.css +204 -0
  1603. package/packages/presentation/src/workbench-dock/web-host.tsx +3 -0
  1604. package/packages/tmux-bridge/src/index.ts +9 -1
  1605. package/packages/tmux-bridge/src/panes.ts +4 -0
  1606. package/packages/tmux-bridge/src/runner.test.ts +72 -0
  1607. package/packages/tmux-bridge/src/runner.ts +43 -2
  1608. package/packages/tmux-bridge/src/sessions.ts +8 -1
  1609. package/scripts/architecture-debt-budget.json +10 -0
  1610. package/scripts/architecture-debt-inventory.mjs +98 -0
  1611. package/scripts/build-cli.mjs +22 -1
  1612. package/scripts/build-macos-notifier.mjs +160 -0
  1613. package/scripts/build-tui.mjs +59 -3
  1614. package/scripts/check-control-bytes.mjs +70 -0
  1615. package/scripts/dev-web.mjs +66 -0
  1616. package/scripts/lib/bounded-child-command.mjs +59 -0
  1617. package/scripts/lib/bounded-child-command.test.mjs +148 -0
  1618. package/scripts/lib/bounded-diagnostic-tail.mjs +82 -0
  1619. package/scripts/lib/bounded-diagnostic-tail.test.mjs +97 -0
  1620. package/scripts/lib/npm-release-tag.mjs +27 -0
  1621. package/scripts/lib/npm-release-tag.test.mjs +116 -0
  1622. package/scripts/lib/packed-opentui-frame.mjs +18 -0
  1623. package/scripts/lib/packed-opentui-frame.test.mjs +40 -0
  1624. package/scripts/lib/performance-reference-budgets.mjs +36 -0
  1625. package/scripts/lib/performance-reference-report.mjs +157 -0
  1626. package/scripts/lib/performance-reference-report.test.mjs +62 -0
  1627. package/scripts/lib/portable-performance-evidence.mjs +210 -0
  1628. package/scripts/lib/portable-performance-evidence.test.mjs +208 -0
  1629. package/scripts/lib/product-ansi-cursor-alt-screen-fixture.mjs +132 -0
  1630. package/scripts/lib/product-ansi-cursor-alt-screen.mjs +4618 -0
  1631. package/scripts/lib/product-ansi-cursor-alt-screen.test.mjs +4120 -0
  1632. package/scripts/lib/product-ansi-tmux-precondition.mjs +159 -0
  1633. package/scripts/lib/product-ansi-tmux-precondition.test.mjs +147 -0
  1634. package/scripts/lib/product-card5-host-topology.mjs +873 -0
  1635. package/scripts/lib/product-card5-host-topology.test.mjs +1070 -0
  1636. package/scripts/lib/product-card5-production-host-owner.mjs +4864 -0
  1637. package/scripts/lib/product-card5-production-host-owner.test.mjs +5051 -0
  1638. package/scripts/lib/product-configless-owner.mjs +1578 -0
  1639. package/scripts/lib/product-configless-owner.test.mjs +2169 -0
  1640. package/scripts/lib/product-cross-client-handoff.mjs +1165 -0
  1641. package/scripts/lib/product-cross-client-handoff.test.mjs +1062 -0
  1642. package/scripts/lib/product-cross-client-host-evidence.mjs +4780 -0
  1643. package/scripts/lib/product-cross-client-host-evidence.test.mjs +3897 -0
  1644. package/scripts/lib/product-first-input.mjs +1546 -0
  1645. package/scripts/lib/product-first-input.test.mjs +1731 -0
  1646. package/scripts/lib/product-focus-tmux.mjs +46 -0
  1647. package/scripts/lib/product-focus.mjs +1198 -0
  1648. package/scripts/lib/product-focus.test.mjs +1504 -0
  1649. package/scripts/lib/product-idle-process-proof.mjs +270 -0
  1650. package/scripts/lib/product-idle-process-proof.test.mjs +210 -0
  1651. package/scripts/lib/product-keyboard-pointer-resize.mjs +471 -0
  1652. package/scripts/lib/product-keyboard-pointer-resize.test.mjs +363 -0
  1653. package/scripts/lib/product-rig-causal-cell-fixture.mjs +91 -0
  1654. package/scripts/lib/product-rig-causal-fixture-geometry.mjs +27 -0
  1655. package/scripts/lib/product-rig-causal-fixture-geometry.test.mjs +45 -0
  1656. package/scripts/lib/product-rig-sleep-assertion.mjs +179 -0
  1657. package/scripts/lib/product-selection-copy-app-mouse.mjs +1585 -0
  1658. package/scripts/lib/product-selection-copy-app-mouse.test.mjs +1602 -0
  1659. package/scripts/lib/product-tui-host-readiness.mjs +133 -0
  1660. package/scripts/lib/product-tui-host-readiness.test.mjs +258 -0
  1661. package/scripts/lib/product-window-lifecycle.mjs +1351 -0
  1662. package/scripts/lib/product-window-lifecycle.test.mjs +1305 -0
  1663. package/scripts/lib/release-source-state.mjs +28 -0
  1664. package/scripts/lib/release-source-state.test.mjs +26 -0
  1665. package/scripts/lib/tui-diagnostics.mjs +159 -0
  1666. package/scripts/lib/tui-host-publication.mjs +38 -0
  1667. package/scripts/lib/tui-testdrive-clipboard-hook.mjs +543 -0
  1668. package/scripts/lib/tui-testdrive-clipboard-hook.test.mjs +626 -0
  1669. package/scripts/lib/tui-testdrive-input.mjs +1940 -0
  1670. package/scripts/lib/tui-testdrive-input.test.mjs +3434 -0
  1671. package/scripts/lib/tui-testdrive-launch.mjs +180 -0
  1672. package/scripts/lib/tui-testdrive-launch.test.mjs +294 -0
  1673. package/scripts/opentui-release-check.mjs +209 -0
  1674. package/scripts/pack-check-run.mjs +1779 -30
  1675. package/scripts/pack-tui-check.mjs +73 -0
  1676. package/scripts/pack-web-check.mjs +19 -0
  1677. package/scripts/performance-portable-evidence.mjs +419 -0
  1678. package/scripts/performance-qualification.mjs +456 -0
  1679. package/scripts/performance-reference-memory.ts +177 -0
  1680. package/scripts/performance-reference-pane-stream.ts +74 -0
  1681. package/scripts/performance-reference.mjs +681 -0
  1682. package/scripts/postinstall.js +14 -6
  1683. package/scripts/prepublish-check.mjs +37 -1
  1684. package/scripts/prepublish-opentui-check.mjs +24 -0
  1685. package/scripts/product-test-rig-journeys.mjs +2700 -0
  1686. package/scripts/product-test-rig-journeys.test.mjs +3959 -0
  1687. package/scripts/product-test-rig-lib.mjs +2359 -0
  1688. package/scripts/product-test-rig-multiclient.ts +434 -0
  1689. package/scripts/product-test-rig-native-client.mjs +45 -0
  1690. package/scripts/product-test-rig.mjs +20260 -0
  1691. package/scripts/product-test-rig.test.mjs +3634 -0
  1692. package/scripts/publish-tap.sh +55 -0
  1693. package/scripts/smoke-tui-missions.mjs +329 -0
  1694. package/scripts/tui-diagnose.mjs +258 -0
  1695. package/scripts/tui-diagnose.test.mjs +200 -0
  1696. package/scripts/tui-testdrive-capture.test.mjs +161 -0
  1697. package/scripts/tui-testdrive.mjs +1955 -0
  1698. package/skill/SKILL.md +115 -30
  1699. package/templates/agent-team-monorepo.yml +28 -30
  1700. package/templates/agent-team-nextjs.yml +24 -26
  1701. package/templates/agent-team.yml +24 -24
  1702. package/templates/convex.yml +24 -16
  1703. package/templates/default.yml +26 -21
  1704. package/templates/go.yml +21 -14
  1705. package/templates/missions.yml +25 -40
  1706. package/templates/nextjs.yml +24 -16
  1707. package/templates/python.yml +21 -14
  1708. package/templates/vite.yml +21 -14
  1709. package/packages/daemon/dist/widgets/changes/index.jsx +0 -575
  1710. package/packages/daemon/dist/widgets/config/index.d.ts +0 -1
  1711. package/packages/daemon/dist/widgets/config/index.jsx +0 -395
  1712. package/packages/daemon/dist/widgets/explorer/breadcrumbs.d.ts +0 -10
  1713. package/packages/daemon/dist/widgets/explorer/breadcrumbs.jsx +0 -51
  1714. package/packages/daemon/dist/widgets/explorer/footer.d.ts +0 -6
  1715. package/packages/daemon/dist/widgets/explorer/footer.jsx +0 -11
  1716. package/packages/daemon/dist/widgets/explorer/index.jsx +0 -393
  1717. package/packages/daemon/dist/widgets/explorer/tree.d.ts +0 -13
  1718. package/packages/daemon/dist/widgets/explorer/tree.jsx +0 -108
  1719. package/packages/daemon/dist/widgets/lib/help-overlay.d.ts +0 -19
  1720. package/packages/daemon/dist/widgets/lib/help-overlay.jsx +0 -69
  1721. package/packages/daemon/dist/widgets/preview/index.jsx +0 -371
  1722. package/packages/daemon/dist/widgets/setup/agent-naming.d.ts +0 -9
  1723. package/packages/daemon/dist/widgets/setup/agent-naming.jsx +0 -81
  1724. package/packages/daemon/dist/widgets/setup/config-tree.d.ts +0 -13
  1725. package/packages/daemon/dist/widgets/setup/config-tree.jsx +0 -203
  1726. package/packages/daemon/dist/widgets/setup/detect-panel.d.ts +0 -14
  1727. package/packages/daemon/dist/widgets/setup/detect-panel.jsx +0 -48
  1728. package/packages/daemon/dist/widgets/setup/field-editor.d.ts +0 -12
  1729. package/packages/daemon/dist/widgets/setup/field-editor.jsx +0 -163
  1730. package/packages/daemon/dist/widgets/setup/footer.d.ts +0 -17
  1731. package/packages/daemon/dist/widgets/setup/footer.jsx +0 -64
  1732. package/packages/daemon/dist/widgets/setup/index.d.ts +0 -1
  1733. package/packages/daemon/dist/widgets/setup/index.jsx +0 -261
  1734. package/packages/daemon/dist/widgets/setup/layout-picker.d.ts +0 -9
  1735. package/packages/daemon/dist/widgets/setup/layout-picker.jsx +0 -69
  1736. package/packages/daemon/dist/widgets/sidebar/index.jsx +0 -462
  1737. package/packages/daemon/src/tui/mirror/control-client.ts +0 -214
  1738. package/packages/daemon/src/tui/mirror/focus-border.ts +0 -57
  1739. package/packages/daemon/src/tui/mirror/session-mirror.ts +0 -443
  1740. package/packages/daemon/src/widgets/setup/orchestrator-panel.tsx +0 -200
  1741. package/scripts/perf-mirror.mjs +0 -313
  1742. package/scripts/verify-endpoints.sh +0 -90
  1743. /package/packages/daemon/dist/{widgets/changes/index.d.ts → lib/__tests__/fixtures/workspace-state-writer.d.ts} +0 -0
  1744. /package/packages/daemon/dist/{widgets/explorer/index.d.ts → terminal/mirror/trusted-inventory.js} +0 -0
  1745. /package/packages/daemon/dist/{widgets/preview/index.d.ts → terminal/session-runtime/terminal-interpreter-backend.js} +0 -0
  1746. /package/packages/daemon/dist/{widgets/sidebar/index.d.ts → tui/mirror/features/changes/contract.js} +0 -0
@@ -0,0 +1,4618 @@
1
+ import { createHash, createHmac } from "node:crypto";
2
+
3
+ import {
4
+ TUI_CURSOR_PRESENTATION_P99_CEILING_MICROS,
5
+ TUI_EVENT_LOOP_CURRENT_ENDPOINT_CEILING_MICROS,
6
+ TUI_EVENT_LOOP_GENERATION_STICKY_PEAK_CEILING_MICROS,
7
+ TUI_EVENT_LOOP_WORKLOAD_P99_CEILING_MS,
8
+ TUI_HEAP_ABSOLUTE_CEILING_BYTES,
9
+ TUI_RSS_ABSOLUTE_CEILING_BYTES,
10
+ } from "./performance-reference-budgets.mjs";
11
+
12
+ const SHA256 = /^[0-9a-f]{64}$/u;
13
+ const UUID_V4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u;
14
+ const CANONICAL_STATE_HASH = /^[0-9a-f]{16}$/u;
15
+ const DAEMON_PROCESS_ID = /^daemon:([1-9][0-9]*)$/u;
16
+ const MAX_MICROS = 5_000_000;
17
+
18
+ export const ANSI_CURSOR_SAMPLE_COUNT = 30;
19
+ export const ANSI_CURSOR_P95_BUDGET_MICROS = 16_670;
20
+ export const ANSI_CURSOR_P99_BUDGET_MICROS = TUI_CURSOR_PRESENTATION_P99_CEILING_MICROS;
21
+ const RESOURCE_ENDPOINT_COUNT = 16;
22
+ const ANSI_DAEMON_STAGES = Object.freeze([
23
+ ["pane-stream-socket-message-callback-entry", "transport"],
24
+ ["pane-stream-input-frame-ingress", "transport"],
25
+ ["raw-input-command", "tmux"],
26
+ ["control-write", "tmux"],
27
+ ["control-command-accepted", "tmux"],
28
+ ["first-output-observed", "tmux"],
29
+ ["terminal-replica-write", "parse"],
30
+ ["terminal-replica-project-commit", "reduce"],
31
+ ["terminal-delivery-encode-enqueue", "transport"],
32
+ ["pane-stream-socket-send", "transport"],
33
+ ]);
34
+ const ANSI_DAEMON_NULL_INCARNATION_OPERATIONS = new Set([
35
+ "raw-input-command",
36
+ "control-write",
37
+ "control-command-accepted",
38
+ ]);
39
+
40
+ export function ansiDeliverySubscriberTopologyStatus({ records, expected }) {
41
+ if (!Array.isArray(records) || records.length > 100_000)
42
+ return Object.freeze({ exact: false, reason: "records-bounded", lanes: Object.freeze([]) });
43
+ const clients = expected?.deliveryClients;
44
+ if (
45
+ clients === null ||
46
+ typeof clients !== "object" ||
47
+ Array.isArray(clients) ||
48
+ Object.keys(clients).length < 1 ||
49
+ Object.keys(clients).length > 4 ||
50
+ new Set(Object.values(clients)).size !== Object.keys(clients).length
51
+ )
52
+ return Object.freeze({ exact: false, reason: "clients-exact", lanes: Object.freeze([]) });
53
+ const expectedClientSurface = new Map(
54
+ Object.entries(clients).map(([surface, clientId]) => [clientId, surface]),
55
+ );
56
+ const lifecycle = records.filter(
57
+ (record) =>
58
+ record?.type === "performance.stage" &&
59
+ record.operation === "terminal-delivery-subscriber-lifecycle" &&
60
+ record.stage === "transport" &&
61
+ record.terminalDelivery?.workspaceName === expected?.deliveryWorkspaceName &&
62
+ record.terminalDelivery?.semanticPaneId === expected?.semanticPaneId &&
63
+ record.terminalDelivery?.canonicalGeneration === expected?.canonicalGeneration,
64
+ );
65
+ const active = new Map();
66
+ let previousOrdinal = 0;
67
+ let reason = null;
68
+ for (const record of lifecycle) {
69
+ const delivery = record.terminalDelivery;
70
+ const surface = expectedClientSurface.get(delivery?.deliveryClientId);
71
+ const shapeExact =
72
+ record.processId === expected?.daemonProcessId &&
73
+ record.clockId === expected?.daemonClockId &&
74
+ record.clockKind === "performance-now" &&
75
+ safeTimestamp(record.startedAtMicros) &&
76
+ safeTimestamp(record.endedAtMicros) &&
77
+ record.startedAtMicros <= record.endedAtMicros &&
78
+ delivery?.canonicalIncarnation === expected?.canonicalIncarnation &&
79
+ surface === delivery?.deliverySurface &&
80
+ delivery?.deliveryPurpose === "terminal-surface" &&
81
+ typeof delivery?.deliveryLaneId === "string" &&
82
+ delivery.deliveryLaneId.length >= 1 &&
83
+ delivery.deliveryLaneId.length <= 256 &&
84
+ typeof delivery?.deliveryRequestId === "string" &&
85
+ UUID_V4.test(delivery.deliveryRequestId) &&
86
+ Number.isSafeInteger(delivery?.deliveryLifecycleOrdinal) &&
87
+ delivery.deliveryLifecycleOrdinal > previousOrdinal &&
88
+ new Set(["open", "close"]).has(delivery?.deliveryLifecycleEvent);
89
+ if (!shapeExact) {
90
+ reason = "lifecycle-shape";
91
+ break;
92
+ }
93
+ previousOrdinal = delivery.deliveryLifecycleOrdinal;
94
+ const lane = delivery.deliveryLaneId;
95
+ if (delivery.deliveryLifecycleEvent === "open") {
96
+ if (active.has(lane)) {
97
+ reason = "duplicate-open";
98
+ break;
99
+ }
100
+ active.set(
101
+ lane,
102
+ Object.freeze({
103
+ clientId: delivery.deliveryClientId,
104
+ surface: delivery.deliverySurface,
105
+ laneId: lane,
106
+ requestId: delivery.deliveryRequestId,
107
+ purpose: delivery.deliveryPurpose,
108
+ }),
109
+ );
110
+ } else if (!active.delete(lane)) {
111
+ reason = "stale-close";
112
+ break;
113
+ }
114
+ }
115
+ const lanes = Object.freeze(
116
+ [...active.values()].sort((left, right) => left.laneId.localeCompare(right.laneId)),
117
+ );
118
+ if (lanes.length < 1 || lanes.length > 16)
119
+ return Object.freeze({
120
+ exact: false,
121
+ reason: "lane-count",
122
+ lifecycleOrdinal: previousOrdinal,
123
+ lanes,
124
+ });
125
+ if (new Set(lanes.map(({ requestId }) => requestId)).size !== lanes.length)
126
+ return Object.freeze({
127
+ exact: false,
128
+ reason: "request-collision",
129
+ lifecycleOrdinal: previousOrdinal,
130
+ lanes,
131
+ });
132
+ if (
133
+ reason === null &&
134
+ Object.values(clients).every(
135
+ (clientId) => lanes.filter((lane) => lane.clientId === clientId).length >= 1,
136
+ )
137
+ )
138
+ return Object.freeze({ exact: true, reason: null, lifecycleOrdinal: previousOrdinal, lanes });
139
+ return Object.freeze({
140
+ exact: false,
141
+ reason: reason ?? "client-lane-missing",
142
+ lifecycleOrdinal: previousOrdinal,
143
+ lanes,
144
+ });
145
+ }
146
+
147
+ const ANSI_DELIVERY_READINESS_REASONS = new Set([
148
+ "topology-not-exact",
149
+ "status-shape",
150
+ "status-missing",
151
+ "lineage-cardinality",
152
+ "lineage-identity",
153
+ "lineage-order",
154
+ "canonical-predecessor",
155
+ "lane-not-visible",
156
+ "lane-in-flight",
157
+ "lane-queue-not-empty",
158
+ "later-enqueue",
159
+ ]);
160
+
161
+ /**
162
+ * Proves that every independently-qualified active subscriber has adopted the
163
+ * exact canonical predecessor before an input watermark can be taken.
164
+ */
165
+ export function ansiDeliverySubscriberReadinessStatus({ records, expected, topology }) {
166
+ const unavailable = (reason, laneCount = 0, readyLaneCount = 0, firstInvalidLaneOrdinal = null) =>
167
+ Object.freeze({
168
+ exact: false,
169
+ reason: ANSI_DELIVERY_READINESS_REASONS.has(reason) ? reason : "status-shape",
170
+ laneCount: Math.min(Math.max(laneCount, 0), 17),
171
+ readyLaneCount: Math.min(Math.max(readyLaneCount, 0), 16),
172
+ firstInvalidLaneOrdinal:
173
+ Number.isSafeInteger(firstInvalidLaneOrdinal) && firstInvalidLaneOrdinal >= 0
174
+ ? Math.min(firstInvalidLaneOrdinal, 15)
175
+ : null,
176
+ });
177
+ const currentTopology = Array.isArray(records)
178
+ ? ansiDeliverySubscriberTopologyStatus({ records, expected })
179
+ : null;
180
+ if (
181
+ !Array.isArray(records) ||
182
+ records.length > 100_000 ||
183
+ topology?.exact !== true ||
184
+ !Array.isArray(topology?.lanes) ||
185
+ topology.lanes.length < 1 ||
186
+ topology.lanes.length > 16 ||
187
+ !Number.isSafeInteger(expected?.predecessorRevision) ||
188
+ expected.predecessorRevision < 0 ||
189
+ !CANONICAL_STATE_HASH.test(expected?.predecessorStateHash ?? "") ||
190
+ currentTopology?.exact !== true ||
191
+ currentTopology.lifecycleOrdinal !== topology.lifecycleOrdinal ||
192
+ JSON.stringify(currentTopology.lanes) !== JSON.stringify(topology.lanes)
193
+ )
194
+ return unavailable("topology-not-exact", topology?.lanes?.length ?? 0);
195
+
196
+ const targetAuthority = (record) =>
197
+ record?.type === "performance.stage" &&
198
+ record.stage === "transport" &&
199
+ record.processId === expected?.daemonProcessId &&
200
+ record.clockId === expected?.daemonClockId &&
201
+ record.clockKind === "performance-now" &&
202
+ safeTimestamp(record.startedAtMicros) &&
203
+ safeTimestamp(record.endedAtMicros) &&
204
+ record.startedAtMicros <= record.endedAtMicros &&
205
+ record.terminalDelivery?.workspaceName === expected?.deliveryWorkspaceName &&
206
+ record.terminalDelivery?.semanticPaneId === expected?.semanticPaneId &&
207
+ record.terminalDelivery?.canonicalGeneration === expected?.canonicalGeneration &&
208
+ record.terminalDelivery?.canonicalIncarnation === expected?.canonicalIncarnation;
209
+ const predecessor = (record, operation) =>
210
+ targetAuthority(record) &&
211
+ record.operation === operation &&
212
+ record.terminalDelivery.canonicalRevision === expected.predecessorRevision &&
213
+ record.terminalDelivery.canonicalStateHash === expected.predecessorStateHash;
214
+ const statuses = records.filter(
215
+ (record) =>
216
+ targetAuthority(record) && record.operation === "terminal-delivery-subscriber-status",
217
+ );
218
+ let priorStatusOrdinal = 0;
219
+ for (const record of statuses) {
220
+ const delivery = record.terminalDelivery;
221
+ if (
222
+ delivery?.deliveryPurpose !== "terminal-surface" ||
223
+ !Number.isSafeInteger(delivery.deliveryStatusOrdinal) ||
224
+ delivery.deliveryStatusOrdinal <= priorStatusOrdinal ||
225
+ typeof delivery.deliveryClientId !== "string" ||
226
+ typeof delivery.deliverySurface !== "string" ||
227
+ typeof delivery.deliveryLaneId !== "string" ||
228
+ !UUID_V4.test(delivery.deliveryRequestId ?? "") ||
229
+ !new Set(["visible", "background", "hidden", "frozen"]).has(delivery.deliveryVisibility) ||
230
+ !Number.isSafeInteger(delivery.deliveryBaselineRevision) ||
231
+ !(
232
+ delivery.deliveryBaselineHash === null ||
233
+ CANONICAL_STATE_HASH.test(delivery.deliveryBaselineHash ?? "")
234
+ ) ||
235
+ !(
236
+ delivery.deliveryInFlightRevision === null ||
237
+ (Number.isSafeInteger(delivery.deliveryInFlightRevision) &&
238
+ delivery.deliveryInFlightRevision >= 0)
239
+ ) ||
240
+ !(
241
+ delivery.deliveryInFlightHash === null ||
242
+ CANONICAL_STATE_HASH.test(delivery.deliveryInFlightHash ?? "")
243
+ ) ||
244
+ !(
245
+ delivery.deliveryLatestRevision === null ||
246
+ (Number.isSafeInteger(delivery.deliveryLatestRevision) &&
247
+ delivery.deliveryLatestRevision >= 0)
248
+ ) ||
249
+ !Number.isSafeInteger(delivery.deliveryClientQueueDepth) ||
250
+ delivery.deliveryClientQueueDepth < 0 ||
251
+ delivery.deliveryClientQueueDepth > 1_024
252
+ )
253
+ return unavailable("status-shape", topology.lanes.length);
254
+ priorStatusOrdinal = delivery.deliveryStatusOrdinal;
255
+ }
256
+
257
+ let readyLaneCount = 0;
258
+ let statusOrdinal = 0;
259
+ for (const [laneOrdinal, lane] of topology.lanes.entries()) {
260
+ const laneIdentity = (record) => {
261
+ const delivery = record.terminalDelivery;
262
+ return (
263
+ delivery?.deliveryClientId === lane.clientId &&
264
+ delivery?.deliverySurface === lane.surface &&
265
+ delivery?.deliveryLaneId === lane.laneId &&
266
+ delivery?.deliveryRequestId === lane.requestId
267
+ );
268
+ };
269
+ const activeOpen = records.findLast(
270
+ (record) =>
271
+ targetAuthority(record) &&
272
+ record.operation === "terminal-delivery-subscriber-lifecycle" &&
273
+ record.terminalDelivery?.deliveryLifecycleEvent === "open" &&
274
+ laneIdentity(record),
275
+ );
276
+ if (!activeOpen)
277
+ return unavailable("topology-not-exact", topology.lanes.length, readyLaneCount, laneOrdinal);
278
+ const afterActiveOpen = (record) => record.startedAtMicros >= activeOpen.endedAtMicros;
279
+ const enqueues = records.filter(
280
+ (record) =>
281
+ predecessor(record, "terminal-delivery-encode-enqueue") &&
282
+ laneIdentity(record) &&
283
+ afterActiveOpen(record),
284
+ );
285
+ const sockets = records.filter(
286
+ (record) =>
287
+ predecessor(record, "pane-stream-socket-send") &&
288
+ laneIdentity(record) &&
289
+ afterActiveOpen(record),
290
+ );
291
+ const settlements = records.filter(
292
+ (record) =>
293
+ predecessor(record, "terminal-delivery-settled") &&
294
+ laneIdentity(record) &&
295
+ afterActiveOpen(record),
296
+ );
297
+ if (enqueues.length !== 1 || sockets.length !== 1 || settlements.length !== 1)
298
+ return unavailable("lineage-cardinality", topology.lanes.length, readyLaneCount, laneOrdinal);
299
+ const [enqueue, socket, settlement] = [enqueues[0], sockets[0], settlements[0]];
300
+ const lineageFields = ["deliveryNonce", "transactionId", "deliveryOrdinal"];
301
+ if (
302
+ !lineageFields.every(
303
+ (field) =>
304
+ enqueue.terminalDelivery[field] === socket.terminalDelivery[field] &&
305
+ enqueue.terminalDelivery[field] === settlement.terminalDelivery[field],
306
+ ) ||
307
+ typeof enqueue.terminalDelivery.deliveryNonce !== "string" ||
308
+ enqueue.terminalDelivery.deliveryNonce.length < 1 ||
309
+ enqueue.terminalDelivery.deliveryNonce.length > 256 ||
310
+ typeof enqueue.terminalDelivery.transactionId !== "string" ||
311
+ enqueue.terminalDelivery.transactionId.length < 1 ||
312
+ enqueue.terminalDelivery.transactionId.length > 256 ||
313
+ !Number.isSafeInteger(enqueue.terminalDelivery.deliveryOrdinal) ||
314
+ enqueue.terminalDelivery.deliveryOrdinal < 1
315
+ )
316
+ return unavailable("lineage-identity", topology.lanes.length, readyLaneCount, laneOrdinal);
317
+ if (
318
+ enqueue.endedAtMicros > socket.startedAtMicros ||
319
+ socket.endedAtMicros > settlement.startedAtMicros
320
+ )
321
+ return unavailable("lineage-order", topology.lanes.length, readyLaneCount, laneOrdinal);
322
+ const laneStatuses = statuses.filter(
323
+ (record) => laneIdentity(record) && afterActiveOpen(record),
324
+ );
325
+ const status = laneStatuses.at(-1);
326
+ if (!status)
327
+ return unavailable("status-missing", topology.lanes.length, readyLaneCount, laneOrdinal);
328
+ const delivery = status.terminalDelivery;
329
+ if (
330
+ delivery.canonicalRevision !== expected.predecessorRevision ||
331
+ delivery.canonicalStateHash !== expected.predecessorStateHash ||
332
+ delivery.deliveryBaselineRevision !== expected.predecessorRevision ||
333
+ delivery.deliveryBaselineHash !== expected.predecessorStateHash ||
334
+ delivery.deliveryLatestRevision !== null
335
+ )
336
+ return unavailable(
337
+ "canonical-predecessor",
338
+ topology.lanes.length,
339
+ readyLaneCount,
340
+ laneOrdinal,
341
+ );
342
+ if (delivery.deliveryVisibility !== "visible")
343
+ return unavailable("lane-not-visible", topology.lanes.length, readyLaneCount, laneOrdinal);
344
+ if (delivery.deliveryInFlightRevision !== null || delivery.deliveryInFlightHash !== null)
345
+ return unavailable("lane-in-flight", topology.lanes.length, readyLaneCount, laneOrdinal);
346
+ if (delivery.deliveryClientQueueDepth !== 0)
347
+ return unavailable(
348
+ "lane-queue-not-empty",
349
+ topology.lanes.length,
350
+ readyLaneCount,
351
+ laneOrdinal,
352
+ );
353
+ if (
354
+ records.some(
355
+ (record) =>
356
+ targetAuthority(record) &&
357
+ record.operation === "terminal-delivery-encode-enqueue" &&
358
+ laneIdentity(record) &&
359
+ record.startedAtMicros > settlement.endedAtMicros,
360
+ )
361
+ )
362
+ return unavailable("later-enqueue", topology.lanes.length, readyLaneCount, laneOrdinal);
363
+ if (status.startedAtMicros < settlement.endedAtMicros)
364
+ return unavailable("lineage-order", topology.lanes.length, readyLaneCount, laneOrdinal);
365
+ statusOrdinal = Math.max(statusOrdinal, delivery.deliveryStatusOrdinal);
366
+ readyLaneCount += 1;
367
+ }
368
+ return Object.freeze({
369
+ exact: true,
370
+ reason: null,
371
+ laneCount: topology.lanes.length,
372
+ readyLaneCount,
373
+ firstInvalidLaneOrdinal: null,
374
+ statusOrdinal,
375
+ });
376
+ }
377
+
378
+ export async function waitForAnsiDeliverySubscriberReadiness({
379
+ readRecords,
380
+ now,
381
+ sleep,
382
+ expected,
383
+ timeoutMs = 60_000,
384
+ stableMs = 40,
385
+ pollMs = 10,
386
+ }) {
387
+ if (
388
+ typeof readRecords !== "function" ||
389
+ typeof now !== "function" ||
390
+ typeof sleep !== "function" ||
391
+ timeoutMs !== 60_000 ||
392
+ stableMs !== 40 ||
393
+ pollMs !== 10
394
+ )
395
+ throw new TypeError("invalid ANSI delivery readiness wait contract");
396
+ const startedAt = now();
397
+ if (!Number.isFinite(startedAt) || startedAt < 0)
398
+ throw new TypeError("invalid ANSI delivery readiness clock");
399
+ let previous = null;
400
+ let stableSince = null;
401
+ let topology;
402
+ let readiness;
403
+ for (;;) {
404
+ const records = await readRecords();
405
+ topology = ansiDeliverySubscriberTopologyStatus({ records, expected });
406
+ readiness = ansiDeliverySubscriberReadinessStatus({ records, expected, topology });
407
+ const sampledAt = now();
408
+ if (!Number.isFinite(sampledAt) || sampledAt < startedAt)
409
+ throw new TypeError("invalid ANSI delivery readiness clock");
410
+ const serialized =
411
+ topology.exact && readiness.exact ? JSON.stringify([topology, readiness]) : null;
412
+ if (serialized !== null && serialized === previous) {
413
+ stableSince ??= sampledAt;
414
+ if (sampledAt - stableSince >= stableMs)
415
+ return Object.freeze({ qualified: true, topology, readiness });
416
+ } else {
417
+ previous = serialized;
418
+ stableSince = serialized === null ? null : sampledAt;
419
+ }
420
+ if (sampledAt - startedAt >= timeoutMs)
421
+ return Object.freeze({ qualified: false, topology, readiness });
422
+ await sleep(pollMs);
423
+ }
424
+ }
425
+
426
+ export async function runAnsiDeliveryReadyAction({ takeWatermark, driveInput, ...waitOptions }) {
427
+ if (typeof takeWatermark !== "function" || typeof driveInput !== "function")
428
+ throw new TypeError("invalid ANSI delivery ready action contract");
429
+ const wait = await waitForAnsiDeliverySubscriberReadiness(waitOptions);
430
+ if (!wait.qualified) return Object.freeze({ ...wait, watermark: null, delivery: null });
431
+ const watermark = await takeWatermark();
432
+ const delivery = await driveInput();
433
+ return Object.freeze({ ...wait, watermark, delivery });
434
+ }
435
+
436
+ export function ansiWorkloadMarker(marker, cycle) {
437
+ if (
438
+ typeof marker !== "string" ||
439
+ marker.length < 1 ||
440
+ marker.length > 256 ||
441
+ !Number.isSafeInteger(cycle) ||
442
+ cycle < 1 ||
443
+ cycle > 24
444
+ )
445
+ throw new TypeError("invalid ANSI workload marker identity");
446
+ return `ANSI_WORKLOAD_END_${marker}_${String(cycle).padStart(2, "0")}`;
447
+ }
448
+
449
+ export function ansiWorkloadPayload(marker, cycle) {
450
+ let payload = "";
451
+ for (let row = 0; row < 4_096; row += 1)
452
+ payload += `LOAD_${String(row).padStart(4, "0")} 0123456789abcdef\r\n`;
453
+ return `${payload}\x1b[40;1H\x1b[2K${ansiWorkloadMarker(marker, cycle)}`;
454
+ }
455
+
456
+ export function ansiWorkloadProducerStatus(records, expected) {
457
+ const unavailable = (state, reason, record = null) =>
458
+ Object.freeze({ exact: false, state, reason, record });
459
+ if (
460
+ !Array.isArray(records) ||
461
+ records.length > 8 ||
462
+ !Number.isSafeInteger(expected?.cycle) ||
463
+ expected.cycle < 1 ||
464
+ expected.cycle > 24 ||
465
+ !Number.isSafeInteger(expected?.ordinal) ||
466
+ expected.ordinal !== expected.cycle ||
467
+ !Number.isSafeInteger(expected?.payloadBytes) ||
468
+ expected.payloadBytes < 1 ||
469
+ expected.payloadBytes > 16_777_216 ||
470
+ !SHA256.test(expected?.payloadSha256 ?? "")
471
+ )
472
+ return unavailable("invalid", "expected-shape");
473
+ const workloadRecords = records.filter(
474
+ (record) => record?.type === "performance.ansi-fixture-workload",
475
+ );
476
+ if (workloadRecords.length === 0) return unavailable("pending", "completion-absent");
477
+ if (workloadRecords.length !== 1 || workloadRecords.length !== records.length)
478
+ return unavailable("invalid", "completion-cardinality");
479
+ const record = workloadRecords[0];
480
+ const shapeExact =
481
+ exactKeys(record, [
482
+ "version",
483
+ "type",
484
+ "cycle",
485
+ "ordinal",
486
+ "payloadBytes",
487
+ "payloadSha256",
488
+ "status",
489
+ "backpressureCount",
490
+ ]) &&
491
+ record.version === 1 &&
492
+ record.cycle === expected.cycle &&
493
+ record.ordinal === expected.ordinal &&
494
+ record.payloadBytes === expected.payloadBytes &&
495
+ record.payloadSha256 === expected.payloadSha256 &&
496
+ new Set(["complete", "error"]).has(record.status) &&
497
+ Number.isSafeInteger(record.backpressureCount) &&
498
+ record.backpressureCount >= 0 &&
499
+ record.backpressureCount <= 8_192;
500
+ if (!shapeExact) return unavailable("invalid", "completion-shape", record);
501
+ if (record.status === "error") return unavailable("error", "stdout-write", record);
502
+ return Object.freeze({ exact: true, state: "complete", reason: null, record });
503
+ }
504
+
505
+ export function ansiCursorAltScreenFixtureProgram() {
506
+ return [
507
+ "const marker=process.argv[1]",
508
+ `const ansiWorkloadMarker=${ansiWorkloadMarker.toString()}`,
509
+ `const ansiWorkloadPayload=${ansiWorkloadPayload.toString()}`,
510
+ "const baselineBytes='\\x1b[3J\\x1b[2J\\x1b[H\\x1b[2 q\\x1b[?25h'+marker+'\\x1b[2;1H'",
511
+ "const baseline=()=>process.stdout.write(baselineBytes)",
512
+ "baseline()",
513
+ "if(typeof process.stdin.setRawMode==='function')process.stdin.setRawMode(true);process.stdin.resume()",
514
+ "let cursor=0,workload=0",
515
+ "process.stdin.on('data',chunk=>{for(const byte of chunk){if(byte===98){baseline()}else if(byte===114){process.stdout.write('\\x1b[3J\\x1b[H\\x1b[2K\\x1b[1;3;4;38;5;196;48;2;1;2;3mANSI_RICH界é\\x1b[0m\\x1b[2;129H\\x1b[38;2;90;180;255;48;5;17;1;4mW界éZ\\x1b[0m\\x1b[4;7H\\x1b[5 q\\x1b[?25h')}else if(byte===99){cursor=(cursor+1)%30;const row=2+(cursor%8),col=3+(cursor%20),shape=1+(cursor%6);process.stdout.write('\\x1b['+row+';'+col+'H\\x1b['+shape+' q\\x1b[?25h')}else if(byte===97){process.stdout.write('\\x1b[?1049h\\x1b[2J\\x1b[HALT_SCREEN界é\\x1b[8;12H\\x1b[4 q\\x1b[?25l')}else if(byte===110){process.stdout.write('\\x1b[?1049l\\x1b[0m\\x1b[2;1H\\x1b[2 q\\x1b[?25h')}else if(byte===119){workload+=1;process.stdout.write(ansiWorkloadPayload(marker,workload))}}})",
516
+ "setInterval(()=>{},2147483647)",
517
+ ].join(";");
518
+ }
519
+
520
+ function boundedIdentity(value) {
521
+ return typeof value === "string" && value.length > 0 && value.length <= 256;
522
+ }
523
+
524
+ function safeMicros(value) {
525
+ return Number.isSafeInteger(value) && value >= 0 && value <= MAX_MICROS;
526
+ }
527
+
528
+ function safeTimestamp(value) {
529
+ return Number.isSafeInteger(value) && value >= 0;
530
+ }
531
+
532
+ function exactKeys(value, keys) {
533
+ return (
534
+ value !== null &&
535
+ typeof value === "object" &&
536
+ !Array.isArray(value) &&
537
+ Object.keys(value).sort().join("\0") === [...keys].sort().join("\0")
538
+ );
539
+ }
540
+
541
+ const ANSI_WORKLOAD_CYCLE_COUNT = 24;
542
+ const ANSI_WORKLOAD_STABLE_TAIL_MS = 40;
543
+ export const ANSI_WORKLOAD_NO_PROGRESS_MS = 15_000;
544
+ export const ANSI_WORKLOAD_ABSOLUTE_MS = 30_000;
545
+ export const ANSI_TUI_RSS_ABSOLUTE_CEILING_BYTES = TUI_RSS_ABSOLUTE_CEILING_BYTES;
546
+ export const ANSI_TUI_HEAP_ABSOLUTE_CEILING_BYTES = TUI_HEAP_ABSOLUTE_CEILING_BYTES;
547
+ export const ANSI_TUI_EVENT_LOOP_CURRENT_ENDPOINT_CEILING_MICROS =
548
+ TUI_EVENT_LOOP_CURRENT_ENDPOINT_CEILING_MICROS;
549
+ export const ANSI_TUI_EVENT_LOOP_GENERATION_STICKY_PEAK_CEILING_MICROS =
550
+ TUI_EVENT_LOOP_GENERATION_STICKY_PEAK_CEILING_MICROS;
551
+
552
+ export function ansiEventLoopResourceCapStatus(sample) {
553
+ if (
554
+ !Number.isSafeInteger(sample?.eventLoopDelayMicros) ||
555
+ sample.eventLoopDelayMicros < 0 ||
556
+ sample.eventLoopDelayMicros > ANSI_TUI_EVENT_LOOP_CURRENT_ENDPOINT_CEILING_MICROS
557
+ )
558
+ return "event-loop-current-cap";
559
+ if (
560
+ !Number.isSafeInteger(sample?.eventLoopDelayPeakMicros) ||
561
+ sample.eventLoopDelayPeakMicros < sample.eventLoopDelayMicros ||
562
+ sample.eventLoopDelayPeakMicros > ANSI_TUI_EVENT_LOOP_GENERATION_STICKY_PEAK_CEILING_MICROS
563
+ )
564
+ return "event-loop-cap";
565
+ return null;
566
+ }
567
+
568
+ function boundedSizeFact(value, cap) {
569
+ if (!Number.isSafeInteger(value) || value < 0)
570
+ return Object.freeze({ value: null, atLeast: null, sizeCapped: null });
571
+ return value <= cap
572
+ ? Object.freeze({ value, atLeast: null, sizeCapped: false })
573
+ : Object.freeze({ value: null, atLeast: cap + 1, sizeCapped: true });
574
+ }
575
+
576
+ export function boundedAnsiResourceFailureFacts({ rssBytes, heapUsedBytes, eventLoopDelayMicros }) {
577
+ const rss = boundedSizeFact(rssBytes, 2_147_483_648);
578
+ const heap = boundedSizeFact(heapUsedBytes, 1_073_741_824);
579
+ const delay = boundedSizeFact(eventLoopDelayMicros, 60_000_000);
580
+ return Object.freeze({
581
+ rssBytes: rss.value,
582
+ rssAtLeastBytes: rss.atLeast,
583
+ rssSizeCapped: rss.sizeCapped,
584
+ heapBytes: heap.value,
585
+ heapAtLeastBytes: heap.atLeast,
586
+ heapSizeCapped: heap.sizeCapped,
587
+ eventLoopDelayMicros: delay.value,
588
+ eventLoopDelayAtLeastMicros: delay.atLeast,
589
+ eventLoopDelaySizeCapped: delay.sizeCapped,
590
+ });
591
+ }
592
+
593
+ export function boundedAnsiResourcePeakFailureFacts({
594
+ rssPeakBytes,
595
+ heapUsedPeakBytes,
596
+ eventLoopDelayPeakMicros,
597
+ }) {
598
+ const rss = boundedSizeFact(rssPeakBytes, 2_147_483_648);
599
+ const heap = boundedSizeFact(heapUsedPeakBytes, 1_073_741_824);
600
+ const delay = boundedSizeFact(eventLoopDelayPeakMicros, 60_000_000);
601
+ return Object.freeze({
602
+ rssPeakBytes: rss.value,
603
+ rssPeakAtLeastBytes: rss.atLeast,
604
+ rssPeakSizeCapped: rss.sizeCapped,
605
+ heapPeakBytes: heap.value,
606
+ heapPeakAtLeastBytes: heap.atLeast,
607
+ heapPeakSizeCapped: heap.sizeCapped,
608
+ eventLoopDelayPeakMicros: delay.value,
609
+ eventLoopDelayPeakAtLeastMicros: delay.atLeast,
610
+ eventLoopDelayPeakSizeCapped: delay.sizeCapped,
611
+ });
612
+ }
613
+
614
+ const ANSI_RESOURCE_EPOCH_IDENTITY_FIELDS = Object.freeze([
615
+ "processId",
616
+ "clockId",
617
+ "clockKind",
618
+ "semanticPaneId",
619
+ "generation",
620
+ "incarnation",
621
+ "revision",
622
+ "stateHash",
623
+ "cols",
624
+ "rows",
625
+ "sourceEpoch",
626
+ "rendererEpoch",
627
+ "viewportCols",
628
+ "viewportRows",
629
+ "acceptedUpdateType",
630
+ "acceptedRevision",
631
+ ]);
632
+
633
+ export function ansiResourceEpochIdentityExact(left, right) {
634
+ return (
635
+ left !== null &&
636
+ typeof left === "object" &&
637
+ right !== null &&
638
+ typeof right === "object" &&
639
+ ANSI_RESOURCE_EPOCH_IDENTITY_FIELDS.every((field) => left[field] === right[field])
640
+ );
641
+ }
642
+
643
+ const ANSI_WORKLOAD_PROGRESS_FIELDS = Object.freeze([
644
+ "canonicalRevision",
645
+ "enqueueOrdinal",
646
+ "enqueueCanonicalRevision",
647
+ "settledOrdinal",
648
+ "settledCanonicalRevision",
649
+ "frameRevision",
650
+ "fenceRevision",
651
+ "producerOrdinal",
652
+ ]);
653
+
654
+ export function advanceAnsiWorkloadProgress(previous, observation, nowMs) {
655
+ if (
656
+ !Number.isSafeInteger(nowMs) ||
657
+ nowMs < 0 ||
658
+ !exactKeys(observation, ANSI_WORKLOAD_PROGRESS_FIELDS) ||
659
+ !ANSI_WORKLOAD_PROGRESS_FIELDS.every(
660
+ (field) =>
661
+ observation[field] === null ||
662
+ (Number.isSafeInteger(observation[field]) && observation[field] >= 0),
663
+ )
664
+ )
665
+ throw new TypeError("invalid ANSI workload progress observation");
666
+ if (previous === null) {
667
+ return Object.freeze({
668
+ startedAtMs: nowMs,
669
+ lastProgressAtMs: nowMs,
670
+ progressCount: 0,
671
+ ...Object.fromEntries(ANSI_WORKLOAD_PROGRESS_FIELDS.map((field) => [field, -1])),
672
+ });
673
+ }
674
+ if (
675
+ !exactKeys(previous, [
676
+ "startedAtMs",
677
+ "lastProgressAtMs",
678
+ "progressCount",
679
+ ...ANSI_WORKLOAD_PROGRESS_FIELDS,
680
+ ]) ||
681
+ !Number.isSafeInteger(previous.startedAtMs) ||
682
+ !Number.isSafeInteger(previous.lastProgressAtMs) ||
683
+ !Number.isSafeInteger(previous.progressCount) ||
684
+ previous.startedAtMs < 0 ||
685
+ previous.lastProgressAtMs < previous.startedAtMs ||
686
+ nowMs < previous.lastProgressAtMs ||
687
+ previous.progressCount < 0 ||
688
+ previous.progressCount > 65_536 ||
689
+ !ANSI_WORKLOAD_PROGRESS_FIELDS.every(
690
+ (field) => Number.isSafeInteger(previous[field]) && previous[field] >= -1,
691
+ )
692
+ )
693
+ throw new TypeError("invalid ANSI workload progress state");
694
+ const regressedField = ANSI_WORKLOAD_PROGRESS_FIELDS.find(
695
+ (field) => observation[field] !== null && observation[field] < previous[field],
696
+ );
697
+ if (regressedField) {
698
+ const error = new Error("ANSI workload progress regressed");
699
+ error.code = "ANSI_WORKLOAD_PROGRESS_REGRESSION";
700
+ error.field = regressedField;
701
+ throw error;
702
+ }
703
+ const advanced = ANSI_WORKLOAD_PROGRESS_FIELDS.some(
704
+ (field) => observation[field] !== null && observation[field] > previous[field],
705
+ );
706
+ return Object.freeze({
707
+ startedAtMs: previous.startedAtMs,
708
+ lastProgressAtMs: advanced ? nowMs : previous.lastProgressAtMs,
709
+ progressCount: advanced ? Math.min(previous.progressCount + 1, 65_536) : previous.progressCount,
710
+ ...Object.fromEntries(
711
+ ANSI_WORKLOAD_PROGRESS_FIELDS.map((field) => [
712
+ field,
713
+ observation[field] === null ? previous[field] : observation[field],
714
+ ]),
715
+ ),
716
+ });
717
+ }
718
+
719
+ export function ansiWorkloadProgressExpiry(progress, nowMs) {
720
+ if (
721
+ !progress ||
722
+ !Number.isSafeInteger(nowMs) ||
723
+ nowMs < progress.lastProgressAtMs ||
724
+ nowMs < progress.startedAtMs
725
+ )
726
+ throw new TypeError("invalid ANSI workload progress deadline");
727
+ if (nowMs - progress.startedAtMs >= ANSI_WORKLOAD_ABSOLUTE_MS) return "absolute-deadline";
728
+ if (nowMs - progress.lastProgressAtMs >= ANSI_WORKLOAD_NO_PROGRESS_MS)
729
+ return "no-progress-deadline";
730
+ return null;
731
+ }
732
+
733
+ export function ansiWorkloadOrderedTailStatus({
734
+ transitions,
735
+ modes,
736
+ enqueues,
737
+ settlements,
738
+ frames,
739
+ fences,
740
+ }) {
741
+ const collections = [transitions, modes, enqueues, settlements, frames, fences];
742
+ const counts = Object.freeze({
743
+ canonicalTransitionCount: Math.min(
744
+ Array.isArray(transitions) ? transitions.length : 65_537,
745
+ 65_537,
746
+ ),
747
+ modeCount: Math.min(Array.isArray(modes) ? modes.length : 65_537, 65_537),
748
+ enqueueCount: Math.min(Array.isArray(enqueues) ? enqueues.length : 65_537, 65_537),
749
+ settlementCount: Math.min(Array.isArray(settlements) ? settlements.length : 65_537, 65_537),
750
+ frameCount: Math.min(Array.isArray(frames) ? frames.length : 65_537, 65_537),
751
+ fenceCount: Math.min(Array.isArray(fences) ? fences.length : 65_537, 65_537),
752
+ });
753
+ const rejected = (reason, offendingRevision = null, offendingAcceptedType = null) =>
754
+ Object.freeze({
755
+ exact: false,
756
+ reason,
757
+ progress: null,
758
+ counts,
759
+ pendingDeliveryCount: null,
760
+ offendingRevision,
761
+ offendingAcceptedType,
762
+ });
763
+ if (collections.some((records) => !Array.isArray(records) || records.length > 65_536))
764
+ return rejected("tail-bounds");
765
+ const monotonic = (records, project) => {
766
+ let previous = null;
767
+ for (const record of records) {
768
+ const current = project(record);
769
+ if (
770
+ !current ||
771
+ (previous &&
772
+ (current.ordinal <= previous.ordinal || current.at < (previous.endedAt ?? previous.at)))
773
+ )
774
+ return false;
775
+ previous = current;
776
+ }
777
+ return true;
778
+ };
779
+ const canonical = (record) =>
780
+ Number.isSafeInteger(record?.revision) &&
781
+ record.revision >= 0 &&
782
+ CANONICAL_STATE_HASH.test(record?.stateHash ?? "") &&
783
+ safeTimestamp(record?.atMicros)
784
+ ? { ordinal: record.revision, at: record.atMicros, hash: record.stateHash }
785
+ : null;
786
+ const delivery = (record) =>
787
+ Number.isSafeInteger(record?.terminalDelivery?.deliveryOrdinal) &&
788
+ record.terminalDelivery.deliveryOrdinal >= 0 &&
789
+ Number.isSafeInteger(record?.terminalDelivery?.canonicalRevision) &&
790
+ record.terminalDelivery.canonicalRevision >= 0 &&
791
+ CANONICAL_STATE_HASH.test(record?.terminalDelivery?.canonicalStateHash ?? "") &&
792
+ boundedIdentity(record?.terminalDelivery?.transactionId) &&
793
+ safeTimestamp(record?.startedAtMicros) &&
794
+ safeTimestamp(record?.endedAtMicros) &&
795
+ record.startedAtMicros <= record.endedAtMicros
796
+ ? {
797
+ ordinal: record.terminalDelivery.deliveryOrdinal,
798
+ at: record.startedAtMicros,
799
+ revision: record.terminalDelivery.canonicalRevision,
800
+ hash: record.terminalDelivery.canonicalStateHash,
801
+ transactionId: record.terminalDelivery.transactionId,
802
+ endedAt: record.endedAtMicros,
803
+ }
804
+ : null;
805
+ if (
806
+ transitions.some(
807
+ (record) => !new Set(["terminal.seed", "terminal.patch"]).has(record?.updateType),
808
+ )
809
+ )
810
+ return rejected("transition-shape");
811
+ if (!monotonic(transitions, canonical)) return rejected("transition-order");
812
+ if (!monotonic(modes, canonical)) return rejected("mode-order");
813
+ if (!monotonic(frames, canonical)) return rejected("frame-order");
814
+ if (!monotonic(fences, canonical)) return rejected("fence-order");
815
+ if (!monotonic(enqueues, delivery)) return rejected("enqueue-order");
816
+ if (!monotonic(settlements, delivery)) return rejected("settlement-order");
817
+ for (const [records, reason] of [
818
+ [enqueues, "delivery-revision-order"],
819
+ [settlements, "delivery-revision-order"],
820
+ ]) {
821
+ let previousRevision = -1;
822
+ for (const record of records) {
823
+ const currentRevision = record.terminalDelivery.canonicalRevision;
824
+ if (currentRevision <= previousRevision) return rejected(reason, currentRevision);
825
+ previousRevision = currentRevision;
826
+ }
827
+ }
828
+ const hashesByRevision = new Map();
829
+ for (const record of [...enqueues, ...settlements]) {
830
+ const revision = record.terminalDelivery.canonicalRevision;
831
+ const hash = record.terminalDelivery.canonicalStateHash;
832
+ const prior = hashesByRevision.get(revision);
833
+ if (prior !== undefined && prior !== hash) return rejected("delivery-revision-hash", revision);
834
+ hashesByRevision.set(revision, hash);
835
+ }
836
+ const transitionsByRevision = new Map(transitions.map((record) => [record.revision, record]));
837
+ const latestTransitionRevision = transitions.at(-1)?.revision ?? -1;
838
+ for (const record of modes) {
839
+ const transition = transitionsByRevision.get(record.revision);
840
+ if (
841
+ !transition ||
842
+ transition.stateHash !== record.stateHash ||
843
+ transition.atMicros > record.atMicros
844
+ )
845
+ return rejected("canonical-transition-state", record.revision);
846
+ }
847
+ for (const record of [...frames, ...fences]) {
848
+ const transition = transitionsByRevision.get(record.revision);
849
+ if (
850
+ !transition ||
851
+ transition.stateHash !== record.stateHash ||
852
+ transition.atMicros > record.atMicros ||
853
+ record.acceptedRevision !== record.revision ||
854
+ record.acceptedUpdateType !== transition.updateType
855
+ )
856
+ return rejected(
857
+ "accepted-transition-state",
858
+ Number.isSafeInteger(record?.revision) ? record.revision : null,
859
+ new Set(["terminal.seed", "terminal.patch"]).has(record?.acceptedUpdateType)
860
+ ? record.acceptedUpdateType
861
+ : null,
862
+ );
863
+ }
864
+ for (const record of [...enqueues, ...settlements]) {
865
+ const revision = record.terminalDelivery.canonicalRevision;
866
+ const transition = transitionsByRevision.get(revision);
867
+ if (
868
+ revision <= latestTransitionRevision &&
869
+ (!transition || transition.stateHash !== record.terminalDelivery.canonicalStateHash)
870
+ )
871
+ return rejected("delivery-transition-state", revision);
872
+ }
873
+ for (const record of enqueues) {
874
+ const revision = record.terminalDelivery.canonicalRevision;
875
+ if (revision > latestTransitionRevision) continue;
876
+ const transition = transitionsByRevision.get(revision);
877
+ const expectedRepresentation = transition?.updateType === "terminal.seed" ? "seed" : "patch";
878
+ if (record.terminalDelivery.representation !== expectedRepresentation)
879
+ return rejected("delivery-transition-type", revision, transition?.updateType ?? null);
880
+ }
881
+ for (const record of settlements) {
882
+ const revision = record.terminalDelivery.canonicalRevision;
883
+ if (
884
+ revision <= latestTransitionRevision &&
885
+ record.terminalDelivery.representation !== undefined
886
+ ) {
887
+ const transition = transitionsByRevision.get(revision);
888
+ const expectedRepresentation = transition?.updateType === "terminal.seed" ? "seed" : "patch";
889
+ if (record.terminalDelivery.representation !== expectedRepresentation)
890
+ return rejected("delivery-transition-type", revision, transition?.updateType ?? null);
891
+ }
892
+ }
893
+ const coherentEnqueues = enqueues.filter(
894
+ (record) => record.terminalDelivery.canonicalRevision <= latestTransitionRevision,
895
+ );
896
+ const coherentSettlements = settlements.filter(
897
+ (record) => record.terminalDelivery.canonicalRevision <= latestTransitionRevision,
898
+ );
899
+ const pendingDeliveryCount =
900
+ enqueues.length + settlements.length - coherentEnqueues.length - coherentSettlements.length;
901
+ const framesByRevision = new Map(frames.map((record) => [record.revision, record]));
902
+ for (const fence of fences) {
903
+ const frame = framesByRevision.get(fence.revision);
904
+ if (frame && frame.atMicros > fence.atMicros)
905
+ return rejected("presentation-order", fence.revision);
906
+ }
907
+ const enqueueByOrdinal = new Map(
908
+ enqueues.map((record) => [record.terminalDelivery.deliveryOrdinal, record]),
909
+ );
910
+ for (const settled of settlements) {
911
+ const enqueue = enqueueByOrdinal.get(settled.terminalDelivery.deliveryOrdinal);
912
+ if (
913
+ !enqueue ||
914
+ enqueue.terminalDelivery.canonicalRevision !== settled.terminalDelivery.canonicalRevision ||
915
+ enqueue.terminalDelivery.canonicalStateHash !== settled.terminalDelivery.canonicalStateHash ||
916
+ enqueue.terminalDelivery.transactionId !== settled.terminalDelivery.transactionId ||
917
+ enqueue.endedAtMicros > settled.startedAtMicros
918
+ )
919
+ return rejected("delivery-pair", settled.terminalDelivery.canonicalRevision);
920
+ }
921
+ const latestTransition = transitions.at(-1) ?? null;
922
+ const latestEnqueue = coherentEnqueues.at(-1) ?? null;
923
+ const latestSettled = coherentSettlements.at(-1) ?? null;
924
+ const latestFrame = frames.at(-1) ?? null;
925
+ const latestFence = fences.at(-1) ?? null;
926
+ return Object.freeze({
927
+ exact: true,
928
+ reason: null,
929
+ counts,
930
+ pendingDeliveryCount,
931
+ offendingRevision: null,
932
+ offendingAcceptedType: null,
933
+ progress: Object.freeze({
934
+ canonicalRevision: latestTransition?.revision ?? null,
935
+ enqueueOrdinal: latestEnqueue?.terminalDelivery?.deliveryOrdinal ?? null,
936
+ enqueueCanonicalRevision: latestEnqueue?.terminalDelivery?.canonicalRevision ?? null,
937
+ settledOrdinal: latestSettled?.terminalDelivery?.deliveryOrdinal ?? null,
938
+ settledCanonicalRevision: latestSettled?.terminalDelivery?.canonicalRevision ?? null,
939
+ frameRevision: latestFrame?.revision ?? null,
940
+ fenceRevision: latestFence?.revision ?? null,
941
+ }),
942
+ });
943
+ }
944
+
945
+ export function ansiWorkloadDeliveryAuthorityTail({ daemonRecords, expected }) {
946
+ if (
947
+ !expected ||
948
+ !Array.isArray(daemonRecords) ||
949
+ daemonRecords.length > 65_536 ||
950
+ !boundedIdentity(expected.workspaceName) ||
951
+ !boundedIdentity(expected.semanticPaneId) ||
952
+ !boundedIdentity(expected.generation) ||
953
+ !boundedIdentity(expected.incarnation) ||
954
+ !/^daemon:[1-9][0-9]*$/.test(expected.daemonProcessId ?? "") ||
955
+ expected.daemonClockId !== "node-performance-now" ||
956
+ expected.daemonClockKind !== "performance-now"
957
+ )
958
+ return Object.freeze({
959
+ exact: false,
960
+ enqueues: Object.freeze([]),
961
+ settlements: Object.freeze([]),
962
+ });
963
+ const authorityExact = (record) =>
964
+ record?.processId === expected.daemonProcessId &&
965
+ record?.clockId === expected.daemonClockId &&
966
+ record?.clockKind === expected.daemonClockKind &&
967
+ record?.terminalDelivery?.workspaceName === expected.workspaceName &&
968
+ record?.terminalDelivery?.semanticPaneId === expected.semanticPaneId &&
969
+ record?.terminalDelivery?.canonicalGeneration === expected.generation &&
970
+ record?.terminalDelivery?.canonicalIncarnation === expected.incarnation;
971
+ return Object.freeze({
972
+ exact: true,
973
+ enqueues: Object.freeze(
974
+ daemonRecords.filter(
975
+ (record) =>
976
+ record?.type === "performance.stage" &&
977
+ record.operation === "terminal-delivery-encode-enqueue" &&
978
+ authorityExact(record),
979
+ ),
980
+ ),
981
+ settlements: Object.freeze(
982
+ daemonRecords.filter(
983
+ (record) =>
984
+ record?.type === "performance.stage" &&
985
+ record.operation === "terminal-delivery-settled" &&
986
+ authorityExact(record),
987
+ ),
988
+ ),
989
+ });
990
+ }
991
+
992
+ export function ansiWorkloadDeliveryJoin({ canonical, daemonRecords, expected }) {
993
+ const unavailable = () =>
994
+ Object.freeze({
995
+ exact: false,
996
+ encode: null,
997
+ settled: null,
998
+ enqueueCount: 0,
999
+ settledCount: 0,
1000
+ latestEnqueueOrdinal: null,
1001
+ latestSettledOrdinal: null,
1002
+ enqueues: Object.freeze([]),
1003
+ settlements: Object.freeze([]),
1004
+ });
1005
+ if (
1006
+ !canonical ||
1007
+ !expected ||
1008
+ !Array.isArray(daemonRecords) ||
1009
+ daemonRecords.length > 65_536 ||
1010
+ !boundedIdentity(expected.workspaceName) ||
1011
+ !boundedIdentity(expected.semanticPaneId) ||
1012
+ !new Set(["terminal.seed", "terminal.patch"]).has(canonical.updateType) ||
1013
+ canonical.semanticPaneId !== expected.semanticPaneId ||
1014
+ !/^daemon:[1-9][0-9]*$/.test(expected.daemonProcessId ?? "") ||
1015
+ expected.daemonClockId !== "node-performance-now" ||
1016
+ expected.daemonClockKind !== "performance-now"
1017
+ )
1018
+ return unavailable();
1019
+ const authority = ansiWorkloadDeliveryAuthorityTail({
1020
+ daemonRecords,
1021
+ expected: {
1022
+ ...expected,
1023
+ generation: canonical.generation,
1024
+ incarnation: canonical.incarnation,
1025
+ },
1026
+ });
1027
+ if (!authority.exact) return unavailable();
1028
+ const { enqueues, settlements } = authority;
1029
+ const matches = (record) =>
1030
+ record.terminalDelivery.canonicalGeneration === canonical.generation &&
1031
+ record.terminalDelivery.canonicalIncarnation === canonical.incarnation &&
1032
+ record.terminalDelivery.canonicalRevision === canonical.revision &&
1033
+ record.terminalDelivery.canonicalStateHash === canonical.stateHash;
1034
+ const encodeMatches = enqueues.filter(matches);
1035
+ const settledMatches = settlements.filter(matches);
1036
+ const encode = encodeMatches.length === 1 ? encodeMatches[0] : null;
1037
+ const settled = settledMatches.length === 1 ? settledMatches[0] : null;
1038
+ const expectedRepresentation = canonical.updateType === "terminal.seed" ? "seed" : "patch";
1039
+ return Object.freeze({
1040
+ exact:
1041
+ encode !== null &&
1042
+ settled !== null &&
1043
+ encode.terminalDelivery.representation === expectedRepresentation &&
1044
+ (settled.terminalDelivery.representation === undefined ||
1045
+ settled.terminalDelivery.representation === expectedRepresentation) &&
1046
+ encode === enqueues.at(-1) &&
1047
+ settled === settlements.at(-1) &&
1048
+ Number.isSafeInteger(encode.terminalDelivery.deliveryOrdinal) &&
1049
+ encode.terminalDelivery.deliveryOrdinal === settled.terminalDelivery.deliveryOrdinal &&
1050
+ boundedIdentity(encode.terminalDelivery.transactionId) &&
1051
+ encode.terminalDelivery.transactionId === settled.terminalDelivery.transactionId &&
1052
+ safeTimestamp(encode.endedAtMicros) &&
1053
+ safeTimestamp(settled.startedAtMicros) &&
1054
+ encode.endedAtMicros <= settled.startedAtMicros &&
1055
+ settled.terminalDelivery.queueDepth === 0 &&
1056
+ settled.terminalDelivery.inFlight === 0 &&
1057
+ settled.terminalDelivery.inFlightBytes === 0,
1058
+ encode,
1059
+ settled,
1060
+ enqueueCount: Math.min(enqueues.length, 65_537),
1061
+ settledCount: Math.min(settlements.length, 65_537),
1062
+ latestEnqueueOrdinal: Number.isSafeInteger(enqueues.at(-1)?.terminalDelivery?.deliveryOrdinal)
1063
+ ? enqueues.at(-1).terminalDelivery.deliveryOrdinal
1064
+ : null,
1065
+ latestSettledOrdinal: Number.isSafeInteger(
1066
+ settlements.at(-1)?.terminalDelivery?.deliveryOrdinal,
1067
+ )
1068
+ ? settlements.at(-1).terminalDelivery.deliveryOrdinal
1069
+ : null,
1070
+ enqueues: Object.freeze(enqueues),
1071
+ settlements: Object.freeze(settlements),
1072
+ });
1073
+ }
1074
+
1075
+ export function assessAnsiWorkloadFinalitySamples(samples, expected) {
1076
+ const sampleKeys = [
1077
+ "cycle",
1078
+ "markerHmac",
1079
+ "payloadBytes",
1080
+ "producerStatus",
1081
+ "producerOrdinal",
1082
+ "producerPayloadHmac",
1083
+ "producerBackpressureCount",
1084
+ "deliveryBytes",
1085
+ "representation",
1086
+ "attemptedPatchBytes",
1087
+ "attemptedSeedBytes",
1088
+ "attemptedLegacyPatchBytes",
1089
+ "attemptedLegacySeedBytes",
1090
+ "attemptedCompactPatchBytes",
1091
+ "attemptedCompactSeedBytes",
1092
+ "selectedEncoding",
1093
+ "selectionStatus",
1094
+ "deliveryOrdinal",
1095
+ "deliveryHmac",
1096
+ "originCount",
1097
+ "canonicalTransitionType",
1098
+ "canonicalTransitionCount",
1099
+ "frameCount",
1100
+ "fenceCount",
1101
+ "settledCount",
1102
+ "markerCount",
1103
+ "finalCursorY",
1104
+ "viewportRows",
1105
+ "cursorVisible",
1106
+ "queueDepth",
1107
+ "inFlight",
1108
+ "inFlightBytes",
1109
+ "stableTailMs",
1110
+ "elapsedMs",
1111
+ "noProgressElapsedMs",
1112
+ "progressCount",
1113
+ "absoluteDeadlineMs",
1114
+ "noProgressDeadlineMs",
1115
+ "laterTransitionCount",
1116
+ "laterEnqueueCount",
1117
+ "laterPaintCount",
1118
+ "authorityIdentityExact",
1119
+ "finalityExact",
1120
+ "drainExact",
1121
+ "faulted",
1122
+ "rebound",
1123
+ ];
1124
+ const expectedKeys = ["cycle", "markerHmac", "payloadBytes", "producerPayloadHmac"];
1125
+ if (
1126
+ !Array.isArray(samples) ||
1127
+ !Array.isArray(expected) ||
1128
+ samples.length !== ANSI_WORKLOAD_CYCLE_COUNT ||
1129
+ expected.length !== ANSI_WORKLOAD_CYCLE_COUNT
1130
+ )
1131
+ return Object.freeze({ qualified: false, sampleCount: 0, firstInvalidOrdinal: 1 });
1132
+ const markerHmacs = new Set();
1133
+ const deliveryHmacs = new Set();
1134
+ const deliveryOrdinals = new Set();
1135
+ let previousDeliveryOrdinal = 0;
1136
+ let firstInvalidOrdinal = null;
1137
+ for (let index = 0; index < ANSI_WORKLOAD_CYCLE_COUNT; index += 1) {
1138
+ const sample = samples[index];
1139
+ const contract = expected[index];
1140
+ const exact =
1141
+ exactKeys(sample, sampleKeys) &&
1142
+ exactKeys(contract, expectedKeys) &&
1143
+ sample.cycle === index + 1 &&
1144
+ contract.cycle === sample.cycle &&
1145
+ SHA256.test(sample.markerHmac) &&
1146
+ sample.markerHmac === contract.markerHmac &&
1147
+ !markerHmacs.has(sample.markerHmac) &&
1148
+ Number.isSafeInteger(sample.payloadBytes) &&
1149
+ sample.payloadBytes >= 65_536 &&
1150
+ sample.payloadBytes <= 16_777_216 &&
1151
+ sample.payloadBytes === contract.payloadBytes &&
1152
+ sample.producerStatus === "complete" &&
1153
+ sample.producerOrdinal === sample.cycle &&
1154
+ SHA256.test(sample.producerPayloadHmac) &&
1155
+ sample.producerPayloadHmac === contract.producerPayloadHmac &&
1156
+ Number.isSafeInteger(sample.producerBackpressureCount) &&
1157
+ sample.producerBackpressureCount >= 0 &&
1158
+ sample.producerBackpressureCount <= 8_192 &&
1159
+ Number.isSafeInteger(sample.deliveryBytes) &&
1160
+ sample.deliveryBytes > 0 &&
1161
+ sample.deliveryBytes <= 16_777_216 &&
1162
+ ["patch", "seed"].includes(sample.representation) &&
1163
+ (sample.attemptedPatchBytes === null ||
1164
+ (Number.isSafeInteger(sample.attemptedPatchBytes) &&
1165
+ sample.attemptedPatchBytes > 0 &&
1166
+ sample.attemptedPatchBytes <= 67_108_864)) &&
1167
+ (sample.attemptedSeedBytes === null ||
1168
+ (Number.isSafeInteger(sample.attemptedSeedBytes) &&
1169
+ sample.attemptedSeedBytes > 0 &&
1170
+ sample.attemptedSeedBytes <= 67_108_864)) &&
1171
+ ["semantic-v1", "semantic-compact-v1"].includes(sample.selectedEncoding) &&
1172
+ [
1173
+ sample.attemptedLegacyPatchBytes,
1174
+ sample.attemptedLegacySeedBytes,
1175
+ sample.attemptedCompactPatchBytes,
1176
+ sample.attemptedCompactSeedBytes,
1177
+ ].every(
1178
+ (bytes) =>
1179
+ bytes === null || (Number.isSafeInteger(bytes) && bytes > 0 && bytes <= 67_108_864),
1180
+ ) &&
1181
+ (sample.selectedEncoding === "semantic-compact-v1"
1182
+ ? sample.attemptedCompactPatchBytes === sample.attemptedPatchBytes &&
1183
+ sample.attemptedCompactSeedBytes === sample.attemptedSeedBytes
1184
+ : sample.attemptedLegacyPatchBytes === sample.attemptedPatchBytes &&
1185
+ sample.attemptedLegacySeedBytes === sample.attemptedSeedBytes &&
1186
+ (sample.selectionStatus === "legacy-patch-fallback"
1187
+ ? sample.attemptedCompactPatchBytes !== null
1188
+ : sample.selectionStatus === "legacy-seed-fallback"
1189
+ ? sample.attemptedCompactSeedBytes !== null
1190
+ : sample.attemptedCompactPatchBytes === null &&
1191
+ sample.attemptedCompactSeedBytes === null)) &&
1192
+ [
1193
+ "patch-preferred",
1194
+ "seed-preferred",
1195
+ "patch-fallback",
1196
+ "direct-seed",
1197
+ "legacy-patch-fallback",
1198
+ "legacy-seed-fallback",
1199
+ ].includes(sample.selectionStatus) &&
1200
+ (sample.selectionStatus === "patch-preferred"
1201
+ ? sample.representation === "patch" &&
1202
+ sample.attemptedPatchBytes === sample.deliveryBytes &&
1203
+ (sample.attemptedSeedBytes === null ||
1204
+ (sample.attemptedPatchBytes > 524_288 &&
1205
+ sample.attemptedPatchBytes <= sample.attemptedSeedBytes))
1206
+ : sample.selectionStatus === "patch-fallback"
1207
+ ? sample.representation === "patch" &&
1208
+ sample.attemptedPatchBytes === sample.deliveryBytes &&
1209
+ sample.attemptedSeedBytes > 16_777_216
1210
+ : sample.selectionStatus === "direct-seed"
1211
+ ? sample.representation === "seed" &&
1212
+ sample.attemptedPatchBytes === null &&
1213
+ sample.attemptedSeedBytes === sample.deliveryBytes
1214
+ : sample.selectionStatus === "legacy-patch-fallback"
1215
+ ? sample.selectedEncoding === "semantic-v1" &&
1216
+ sample.representation === "patch" &&
1217
+ sample.attemptedLegacyPatchBytes === sample.deliveryBytes &&
1218
+ (sample.attemptedLegacySeedBytes === null ||
1219
+ sample.attemptedLegacyPatchBytes <= sample.attemptedLegacySeedBytes)
1220
+ : sample.selectionStatus === "legacy-seed-fallback"
1221
+ ? sample.selectedEncoding === "semantic-v1" &&
1222
+ sample.representation === "seed" &&
1223
+ sample.attemptedLegacySeedBytes === sample.deliveryBytes &&
1224
+ (sample.attemptedLegacyPatchBytes === null ||
1225
+ sample.attemptedLegacySeedBytes < sample.attemptedLegacyPatchBytes)
1226
+ : sample.representation === "seed" &&
1227
+ sample.attemptedPatchBytes > 524_288 &&
1228
+ sample.attemptedSeedBytes < sample.attemptedPatchBytes &&
1229
+ sample.attemptedSeedBytes === sample.deliveryBytes) &&
1230
+ Number.isSafeInteger(sample.deliveryOrdinal) &&
1231
+ sample.deliveryOrdinal > previousDeliveryOrdinal &&
1232
+ !deliveryOrdinals.has(sample.deliveryOrdinal) &&
1233
+ SHA256.test(sample.deliveryHmac) &&
1234
+ !deliveryHmacs.has(sample.deliveryHmac) &&
1235
+ sample.originCount === 1 &&
1236
+ new Set(["terminal.seed", "terminal.patch"]).has(sample.canonicalTransitionType) &&
1237
+ (sample.canonicalTransitionType === "terminal.seed" ? "seed" : "patch") ===
1238
+ sample.representation &&
1239
+ sample.canonicalTransitionCount >= 1 &&
1240
+ sample.canonicalTransitionCount <= 8_192 &&
1241
+ sample.frameCount >= 1 &&
1242
+ sample.frameCount <= 64 &&
1243
+ sample.fenceCount === 1 &&
1244
+ Number.isSafeInteger(sample.settledCount) &&
1245
+ sample.settledCount >= 1 &&
1246
+ sample.settledCount <= 8_192 &&
1247
+ sample.markerCount === 1 &&
1248
+ sample.finalCursorY === 39 &&
1249
+ sample.viewportRows === 40 &&
1250
+ sample.cursorVisible === true &&
1251
+ sample.queueDepth === 0 &&
1252
+ sample.inFlight === 0 &&
1253
+ sample.inFlightBytes === 0 &&
1254
+ Number.isSafeInteger(sample.stableTailMs) &&
1255
+ sample.stableTailMs >= ANSI_WORKLOAD_STABLE_TAIL_MS &&
1256
+ sample.stableTailMs <= 6_000 &&
1257
+ Number.isSafeInteger(sample.elapsedMs) &&
1258
+ sample.elapsedMs >= 0 &&
1259
+ sample.elapsedMs < ANSI_WORKLOAD_ABSOLUTE_MS &&
1260
+ Number.isSafeInteger(sample.noProgressElapsedMs) &&
1261
+ sample.noProgressElapsedMs >= 0 &&
1262
+ sample.noProgressElapsedMs < ANSI_WORKLOAD_NO_PROGRESS_MS &&
1263
+ Number.isSafeInteger(sample.progressCount) &&
1264
+ sample.progressCount >= 1 &&
1265
+ sample.progressCount <= 65_536 &&
1266
+ sample.absoluteDeadlineMs === ANSI_WORKLOAD_ABSOLUTE_MS &&
1267
+ sample.noProgressDeadlineMs === ANSI_WORKLOAD_NO_PROGRESS_MS &&
1268
+ sample.laterTransitionCount === 0 &&
1269
+ sample.laterEnqueueCount === 0 &&
1270
+ sample.laterPaintCount === 0 &&
1271
+ sample.authorityIdentityExact === true &&
1272
+ sample.finalityExact === true &&
1273
+ sample.drainExact === true &&
1274
+ sample.faulted === false &&
1275
+ sample.rebound === false;
1276
+ if (!exact && firstInvalidOrdinal === null) firstInvalidOrdinal = index + 1;
1277
+ if (SHA256.test(sample?.markerHmac ?? "")) markerHmacs.add(sample.markerHmac);
1278
+ if (Number.isSafeInteger(sample?.deliveryOrdinal)) {
1279
+ deliveryOrdinals.add(sample.deliveryOrdinal);
1280
+ previousDeliveryOrdinal = sample.deliveryOrdinal;
1281
+ }
1282
+ if (SHA256.test(sample?.deliveryHmac ?? "")) deliveryHmacs.add(sample.deliveryHmac);
1283
+ }
1284
+ return Object.freeze({
1285
+ qualified: firstInvalidOrdinal === null,
1286
+ sampleCount: samples.length,
1287
+ firstInvalidOrdinal,
1288
+ });
1289
+ }
1290
+
1291
+ export function ansiSemanticBodyProjection(bodyRect) {
1292
+ if (
1293
+ !exactKeys(bodyRect, [
1294
+ "left",
1295
+ "firstBodyRow",
1296
+ "width",
1297
+ "bodyRows",
1298
+ "origin",
1299
+ "valid",
1300
+ "semanticChromeMatches",
1301
+ ]) ||
1302
+ bodyRect.valid !== true ||
1303
+ bodyRect.origin !== "semantic-pane-chrome" ||
1304
+ bodyRect.semanticChromeMatches !== 1 ||
1305
+ !Number.isSafeInteger(bodyRect.left) ||
1306
+ bodyRect.left < 0 ||
1307
+ !Number.isSafeInteger(bodyRect.firstBodyRow) ||
1308
+ bodyRect.firstBodyRow < 0 ||
1309
+ !Number.isSafeInteger(bodyRect.width) ||
1310
+ bodyRect.width <= 0 ||
1311
+ !Number.isSafeInteger(bodyRect.bodyRows) ||
1312
+ bodyRect.bodyRows <= 0
1313
+ )
1314
+ return null;
1315
+ return Object.freeze({
1316
+ viewportCols: bodyRect.width,
1317
+ viewportRows: bodyRect.bodyRows,
1318
+ screenOffsetX: bodyRect.left,
1319
+ screenOffsetY: bodyRect.firstBodyRow,
1320
+ });
1321
+ }
1322
+
1323
+ export function ansiNativePaneLeaseStatus(rows, expected) {
1324
+ const expectedExact =
1325
+ exactKeys(expected, ["sessionName", "windowResourceId", "semanticPaneId"]) &&
1326
+ boundedIdentity(expected.sessionName) &&
1327
+ boundedIdentity(expected.windowResourceId) &&
1328
+ boundedIdentity(expected.semanticPaneId);
1329
+ const rowsExact =
1330
+ Array.isArray(rows) &&
1331
+ rows.length > 0 &&
1332
+ rows.length <= 513 &&
1333
+ rows.every(
1334
+ (row) =>
1335
+ exactKeys(row, [
1336
+ "sessionName",
1337
+ "nativeWindowId",
1338
+ "resourceId",
1339
+ "name",
1340
+ "active",
1341
+ "paneId",
1342
+ "semanticPaneId",
1343
+ "geometry",
1344
+ ]) &&
1345
+ exactKeys(row.geometry, ["windowCols", "windowRows", "left", "top", "cols", "rows"]) &&
1346
+ boundedIdentity(row.sessionName) &&
1347
+ /^@[0-9]+$/u.test(row.nativeWindowId ?? "") &&
1348
+ /^%[0-9]+$/u.test(row.paneId ?? "") &&
1349
+ boundedIdentity(row.resourceId) &&
1350
+ boundedIdentity(row.name) &&
1351
+ typeof row.active === "boolean" &&
1352
+ boundedIdentity(row.semanticPaneId) &&
1353
+ Object.values(row.geometry).every(Number.isSafeInteger) &&
1354
+ row.geometry.windowCols > 0 &&
1355
+ row.geometry.windowRows > 0 &&
1356
+ row.geometry.left >= 0 &&
1357
+ row.geometry.top >= 0 &&
1358
+ row.geometry.cols > 0 &&
1359
+ row.geometry.rows > 0,
1360
+ );
1361
+ if (!expectedExact || !rowsExact)
1362
+ return Object.freeze({ matchCount: null, mappingExact: false, lease: null });
1363
+ const matches = rows.filter(
1364
+ (row) =>
1365
+ row.sessionName === expected.sessionName &&
1366
+ `terminal-window.${createHash("sha256").update(row.resourceId).digest("hex").slice(0, 20)}` ===
1367
+ expected.windowResourceId &&
1368
+ row.semanticPaneId === expected.semanticPaneId &&
1369
+ row.active === true,
1370
+ );
1371
+ const mappingExact = matches.length === 1 && rows.filter(({ active }) => active).length === 1;
1372
+ return Object.freeze({
1373
+ matchCount: Math.min(matches.length, 513),
1374
+ mappingExact,
1375
+ lease: mappingExact
1376
+ ? Object.freeze({
1377
+ paneId: matches[0].paneId,
1378
+ nativeWindowId: matches[0].nativeWindowId,
1379
+ })
1380
+ : null,
1381
+ });
1382
+ }
1383
+
1384
+ export function advanceAnsiCanonicalPredecessor(predecessor, qualifiedResult) {
1385
+ const origin = qualifiedResult?.raw?.origin;
1386
+ const canonical =
1387
+ qualifiedResult?.raw?.transition ?? qualifiedResult?.raw?.update ?? qualifiedResult?.raw?.mode;
1388
+ if (
1389
+ !exactKeys(predecessor, ["revision", "stateHash"]) ||
1390
+ !Number.isSafeInteger(predecessor.revision) ||
1391
+ predecessor.revision < 0 ||
1392
+ !CANONICAL_STATE_HASH.test(predecessor.stateHash ?? "") ||
1393
+ qualifiedResult?.qualified !== true ||
1394
+ origin?.revision !== predecessor.revision ||
1395
+ origin?.stateHash !== predecessor.stateHash ||
1396
+ !Number.isSafeInteger(canonical?.revision) ||
1397
+ canonical.revision <= predecessor.revision ||
1398
+ !CANONICAL_STATE_HASH.test(canonical?.stateHash ?? "")
1399
+ )
1400
+ return null;
1401
+ return Object.freeze({ revision: canonical.revision, stateHash: canonical.stateHash });
1402
+ }
1403
+
1404
+ export function ansiBaselinePreviousCounters(records, currentIndex, expected) {
1405
+ const result = (status, reason = null, counters = null) =>
1406
+ Object.freeze({ status, reason, counters });
1407
+ if (!Array.isArray(records) || records.length > 65_536) return result("invalid", "records-shape");
1408
+ if (!Number.isSafeInteger(currentIndex) || currentIndex < 0 || currentIndex > records.length)
1409
+ return result("invalid", "current-index");
1410
+ if (
1411
+ !boundedIdentity(expected?.processId) ||
1412
+ !boundedIdentity(expected?.clockId) ||
1413
+ !boundedIdentity(expected?.semanticPaneId) ||
1414
+ !boundedIdentity(expected?.generation) ||
1415
+ !boundedIdentity(expected?.incarnation) ||
1416
+ !Number.isSafeInteger(expected?.sourceEpoch) ||
1417
+ expected.sourceEpoch < 0 ||
1418
+ !Number.isSafeInteger(expected?.rendererEpoch) ||
1419
+ expected.rendererEpoch < 0 ||
1420
+ !Number.isSafeInteger(expected?.revision) ||
1421
+ expected.revision < 0 ||
1422
+ !Number.isSafeInteger(expected?.viewportRows) ||
1423
+ expected.viewportRows < 0 ||
1424
+ expected.viewportRows > 4_096
1425
+ )
1426
+ return result("invalid", "expected-shape");
1427
+ const sameAuthority = records
1428
+ .slice(0, currentIndex)
1429
+ .filter(
1430
+ (record) =>
1431
+ record?.type === "performance.terminal-cursor-presentation" &&
1432
+ record.processId === expected.processId &&
1433
+ record.clockId === expected.clockId &&
1434
+ record.clockKind === "performance-now" &&
1435
+ record.semanticPaneId === expected.semanticPaneId &&
1436
+ record.generation === expected.generation &&
1437
+ record.incarnation === expected.incarnation &&
1438
+ record.sourceEpoch === expected.sourceEpoch &&
1439
+ record.rendererEpoch === expected.rendererEpoch,
1440
+ );
1441
+ if (
1442
+ sameAuthority.some(
1443
+ ({ revision }) =>
1444
+ !Number.isSafeInteger(revision) || revision < 0 || revision >= expected.revision,
1445
+ )
1446
+ )
1447
+ return result("invalid", "predecessor-shape");
1448
+ if (sameAuthority.length === 0) return result("none");
1449
+ const highestRevision = Math.max(...sameAuthority.map(({ revision }) => revision));
1450
+ const candidates = sameAuthority.filter(({ revision }) => revision === highestRevision);
1451
+ if (candidates.length !== 1) return result("invalid", "duplicate-revision");
1452
+ const predecessor = candidates.length === 1 ? candidates[0] : null;
1453
+ if (
1454
+ !predecessor ||
1455
+ !Number.isSafeInteger(predecessor.gridRowsReadTotal) ||
1456
+ predecessor.gridRowsReadTotal < 0 ||
1457
+ !Number.isSafeInteger(predecessor.fullWalkTotal) ||
1458
+ predecessor.fullWalkTotal < 0 ||
1459
+ !Number.isSafeInteger(predecessor.presentationCount) ||
1460
+ predecessor.presentationCount < 1
1461
+ )
1462
+ return result("invalid", "counter-shape");
1463
+ if (
1464
+ !Number.isSafeInteger(predecessor.gridRowsReadTotal + expected.viewportRows) ||
1465
+ !Number.isSafeInteger(predecessor.fullWalkTotal + 1) ||
1466
+ !Number.isSafeInteger(predecessor.presentationCount + 1)
1467
+ )
1468
+ return result("invalid", "counter-overflow");
1469
+ return result(
1470
+ "exact",
1471
+ null,
1472
+ Object.freeze({
1473
+ gridRowsReadTotal: predecessor.gridRowsReadTotal,
1474
+ fullWalkTotal: predecessor.fullWalkTotal,
1475
+ presentationCount: predecessor.presentationCount,
1476
+ }),
1477
+ );
1478
+ }
1479
+
1480
+ function boundedCounterDelta(current, previous) {
1481
+ if (!Number.isSafeInteger(current) || !Number.isSafeInteger(previous)) return null;
1482
+ const delta = current - previous;
1483
+ return Number.isSafeInteger(delta) ? Math.max(-65_536, Math.min(delta, 65_536)) : null;
1484
+ }
1485
+
1486
+ function boundedRowEvidence(value) {
1487
+ return Number.isSafeInteger(value) && value >= 0 && value <= 4_096 ? value : null;
1488
+ }
1489
+
1490
+ export function ansiBaselineCursorEvidenceStatus(value, expected) {
1491
+ const shapeExact =
1492
+ exactKeys(value, ["modes", "presentations"]) &&
1493
+ Array.isArray(value.modes) &&
1494
+ value.modes.length <= 2 &&
1495
+ Array.isArray(value.presentations) &&
1496
+ value.presentations.length <= 2 &&
1497
+ exactKeys(expected, [
1498
+ "processId",
1499
+ "clockId",
1500
+ "semanticPaneId",
1501
+ "generation",
1502
+ "incarnation",
1503
+ "revision",
1504
+ "stateHash",
1505
+ "canonicalCols",
1506
+ "canonicalRows",
1507
+ "viewportCols",
1508
+ "viewportRows",
1509
+ "screenOffsetX",
1510
+ "screenOffsetY",
1511
+ "sourceEpoch",
1512
+ "rendererEpoch",
1513
+ "cursor",
1514
+ "alternateScreen",
1515
+ "wraparound",
1516
+ "mouseProtocol",
1517
+ "mouseEncoding",
1518
+ "baselinePredecessor",
1519
+ "activePaneExact",
1520
+ "seedRevisionExact",
1521
+ "seedGeometryExact",
1522
+ "seedIdentityExact",
1523
+ ]) &&
1524
+ exactKeys(expected?.cursor, ["x", "y", "hidden", "style", "blink"]) &&
1525
+ exactKeys(expected?.baselinePredecessor, ["status", "reason", "counters"]) &&
1526
+ (["none", "invalid"].includes(expected.baselinePredecessor.status)
1527
+ ? expected.baselinePredecessor.counters === null &&
1528
+ (expected.baselinePredecessor.status === "none"
1529
+ ? expected.baselinePredecessor.reason === null
1530
+ : [
1531
+ "records-shape",
1532
+ "current-index",
1533
+ "expected-shape",
1534
+ "predecessor-shape",
1535
+ "duplicate-revision",
1536
+ "counter-shape",
1537
+ "counter-overflow",
1538
+ ].includes(expected.baselinePredecessor.reason))
1539
+ : expected.baselinePredecessor.status === "exact" &&
1540
+ expected.baselinePredecessor.reason === null &&
1541
+ exactKeys(expected.baselinePredecessor.counters, [
1542
+ "gridRowsReadTotal",
1543
+ "fullWalkTotal",
1544
+ "presentationCount",
1545
+ ]));
1546
+ const mode = shapeExact && value.modes.length === 1 ? value.modes[0] : null;
1547
+ const presentation =
1548
+ shapeExact && value.presentations.length === 1 ? value.presentations[0] : null;
1549
+ const timestamp = (candidate) =>
1550
+ Number.isSafeInteger(candidate?.atMicros) && candidate.atMicros >= 0;
1551
+ const modeLineageExact =
1552
+ mode !== null &&
1553
+ mode.processId === expected.processId &&
1554
+ mode.clockId === expected.clockId &&
1555
+ mode.clockKind === "performance-now" &&
1556
+ mode.semanticPaneId === expected.semanticPaneId &&
1557
+ mode.generation === expected.generation &&
1558
+ mode.incarnation === expected.incarnation &&
1559
+ mode.revision === expected.revision &&
1560
+ mode.stateHash === expected.stateHash &&
1561
+ timestamp(mode);
1562
+ const modeStateExact =
1563
+ mode !== null &&
1564
+ mode.alternateScreen === expected.alternateScreen &&
1565
+ mode.wraparound === expected.wraparound &&
1566
+ mode.mouseProtocol === expected.mouseProtocol &&
1567
+ mode.mouseEncoding === expected.mouseEncoding;
1568
+ const modeCursorExact =
1569
+ mode !== null &&
1570
+ mode.cursor?.x === expected.cursor.x &&
1571
+ mode.cursor?.y === expected.cursor.y &&
1572
+ mode.cursor?.hidden === expected.cursor.hidden &&
1573
+ mode.cursor?.style === expected.cursor.style &&
1574
+ mode.cursor?.blink === expected.cursor.blink;
1575
+ const modeIdentityExact = modeLineageExact && modeStateExact && modeCursorExact;
1576
+ const presentationLineageExact =
1577
+ presentation !== null &&
1578
+ presentation.processId === expected.processId &&
1579
+ presentation.clockId === expected.clockId &&
1580
+ presentation.clockKind === "performance-now" &&
1581
+ presentation.semanticPaneId === expected.semanticPaneId &&
1582
+ presentation.generation === expected.generation &&
1583
+ presentation.incarnation === expected.incarnation &&
1584
+ presentation.revision === expected.revision &&
1585
+ presentation.stateHash === expected.stateHash &&
1586
+ presentation.sourceEpoch === expected.sourceEpoch &&
1587
+ presentation.rendererEpoch === expected.rendererEpoch &&
1588
+ timestamp(presentation);
1589
+ const presentationCanonicalGeometryExact =
1590
+ presentation !== null &&
1591
+ presentation.cols === expected.canonicalCols &&
1592
+ presentation.rows === expected.canonicalRows;
1593
+ const presentationViewportGeometryExact =
1594
+ presentation !== null &&
1595
+ presentation.viewportCols === expected.viewportCols &&
1596
+ presentation.viewportRows === expected.viewportRows;
1597
+ const presentationScreenMappingExact =
1598
+ presentation !== null &&
1599
+ Number.isSafeInteger(presentation.screenX) &&
1600
+ Number.isSafeInteger(presentation.screenY) &&
1601
+ Number.isSafeInteger(expected.screenOffsetX) &&
1602
+ Number.isSafeInteger(expected.screenOffsetY) &&
1603
+ presentation.screenX === expected.screenOffsetX + expected.cursor.x + 1 &&
1604
+ presentation.screenY === expected.screenOffsetY + expected.cursor.y + 1;
1605
+ const presentationGeometryExact =
1606
+ presentationCanonicalGeometryExact &&
1607
+ presentationViewportGeometryExact &&
1608
+ presentationScreenMappingExact;
1609
+ const presentationCursorExact =
1610
+ presentation !== null &&
1611
+ presentation.cursorX === expected.cursor.x &&
1612
+ presentation.cursorY === expected.cursor.y &&
1613
+ presentation.visible === !expected.cursor.hidden &&
1614
+ presentation.style === (expected.cursor.style === "bar" ? "line" : expected.cursor.style) &&
1615
+ presentation.blink === expected.cursor.blink;
1616
+ const predecessorValid = ["none", "exact"].includes(expected?.baselinePredecessor?.status);
1617
+ const predecessorPresent = expected?.baselinePredecessor?.status === "exact";
1618
+ const predecessorCounters = predecessorPresent ? expected.baselinePredecessor.counters : null;
1619
+ const previousGridRowsReadTotal = predecessorPresent ? predecessorCounters?.gridRowsReadTotal : 0;
1620
+ const previousFullWalkTotal = predecessorPresent ? predecessorCounters?.fullWalkTotal : 0;
1621
+ const previousPresentationCount = predecessorPresent ? predecessorCounters?.presentationCount : 0;
1622
+ const expectedFullWalk = !predecessorPresent;
1623
+ const presentationCounterInputExact =
1624
+ presentation !== null &&
1625
+ predecessorValid &&
1626
+ presentation.gridWalked === true &&
1627
+ presentation.gridRowsRead === expected.viewportRows &&
1628
+ presentation.fullWalk === expectedFullWalk &&
1629
+ Number.isSafeInteger(presentation.gridRowsReadTotal) &&
1630
+ Number.isSafeInteger(presentation.fullWalkTotal) &&
1631
+ Number.isSafeInteger(presentation.presentationCount) &&
1632
+ Number.isSafeInteger(previousGridRowsReadTotal) &&
1633
+ Number.isSafeInteger(previousFullWalkTotal) &&
1634
+ Number.isSafeInteger(previousPresentationCount) &&
1635
+ previousGridRowsReadTotal >= 0 &&
1636
+ previousFullWalkTotal >= 0 &&
1637
+ previousPresentationCount >= 0;
1638
+ const presentationCounterExact =
1639
+ presentationCounterInputExact &&
1640
+ presentation.gridRowsReadTotal === previousGridRowsReadTotal + expected.viewportRows &&
1641
+ presentation.fullWalkTotal === previousFullWalkTotal + (expectedFullWalk ? 1 : 0) &&
1642
+ presentation.presentationCount === previousPresentationCount + 1;
1643
+ const presentationIdentityExact =
1644
+ presentationLineageExact &&
1645
+ presentationGeometryExact &&
1646
+ presentationCursorExact &&
1647
+ presentationCounterExact;
1648
+ const orderExact =
1649
+ mode !== null &&
1650
+ presentation !== null &&
1651
+ timestamp(mode) &&
1652
+ timestamp(presentation) &&
1653
+ mode.atMicros <= presentation.atMicros;
1654
+ const firstFailedPredicate = !shapeExact
1655
+ ? "shapeExact"
1656
+ : expected.activePaneExact !== true
1657
+ ? "activePaneExact"
1658
+ : expected.seedRevisionExact !== true
1659
+ ? "seedRevisionExact"
1660
+ : expected.seedGeometryExact !== true
1661
+ ? "seedGeometryExact"
1662
+ : expected.seedIdentityExact !== true
1663
+ ? "seedIdentityExact"
1664
+ : value.modes.length !== 1
1665
+ ? "modeExact"
1666
+ : value.presentations.length !== 1
1667
+ ? "presentationExact"
1668
+ : !modeLineageExact
1669
+ ? "modeLineageExact"
1670
+ : !modeStateExact
1671
+ ? "modeStateExact"
1672
+ : !modeCursorExact
1673
+ ? "modeCursorExact"
1674
+ : !presentationLineageExact
1675
+ ? "presentationLineageExact"
1676
+ : !presentationCanonicalGeometryExact
1677
+ ? "presentationCanonicalGeometryExact"
1678
+ : !presentationViewportGeometryExact
1679
+ ? "presentationViewportGeometryExact"
1680
+ : !presentationScreenMappingExact
1681
+ ? "presentationScreenMappingExact"
1682
+ : !presentationCursorExact
1683
+ ? "presentationCursorExact"
1684
+ : !predecessorValid
1685
+ ? "predecessorExact"
1686
+ : !presentationCounterInputExact
1687
+ ? "presentationCounterInputExact"
1688
+ : !presentationCounterExact
1689
+ ? "presentationCounterExact"
1690
+ : !orderExact
1691
+ ? "orderExact"
1692
+ : null;
1693
+ return Object.freeze({
1694
+ qualified: firstFailedPredicate === null,
1695
+ firstFailedPredicate,
1696
+ modeCount: shapeExact ? value.modes.length : null,
1697
+ presentationCount: shapeExact ? value.presentations.length : null,
1698
+ activePaneExact: shapeExact ? expected.activePaneExact === true : false,
1699
+ seedRevisionExact: shapeExact ? expected.seedRevisionExact === true : false,
1700
+ seedGeometryExact: shapeExact ? expected.seedGeometryExact === true : false,
1701
+ seedIdentityExact: shapeExact ? expected.seedIdentityExact === true : false,
1702
+ modeLineageExact,
1703
+ modeStateExact,
1704
+ modeCursorExact,
1705
+ modeIdentityExact,
1706
+ presentationLineageExact,
1707
+ presentationCanonicalGeometryExact,
1708
+ presentationViewportGeometryExact,
1709
+ presentationScreenMappingExact,
1710
+ presentationGeometryExact,
1711
+ presentationCursorExact,
1712
+ predecessorStatus: shapeExact ? expected.baselinePredecessor.status : null,
1713
+ predecessorInvalidReason:
1714
+ shapeExact && expected.baselinePredecessor.status === "invalid"
1715
+ ? expected.baselinePredecessor.reason
1716
+ : null,
1717
+ predecessorPresent,
1718
+ actualGridRowsRead: boundedRowEvidence(presentation?.gridRowsRead),
1719
+ expectedGridRowsRead: boundedRowEvidence(expected?.viewportRows),
1720
+ actualFullWalk: typeof presentation?.fullWalk === "boolean" ? presentation.fullWalk : null,
1721
+ expectedFullWalk,
1722
+ gridRowsReadDelta: boundedCounterDelta(
1723
+ presentation?.gridRowsReadTotal,
1724
+ previousGridRowsReadTotal,
1725
+ ),
1726
+ fullWalkDelta: boundedCounterDelta(presentation?.fullWalkTotal, previousFullWalkTotal),
1727
+ presentationDelta: boundedCounterDelta(
1728
+ presentation?.presentationCount,
1729
+ previousPresentationCount,
1730
+ ),
1731
+ presentationCounterInputExact,
1732
+ presentationCounterExact,
1733
+ presentationIdentityExact,
1734
+ orderExact,
1735
+ });
1736
+ }
1737
+
1738
+ function privateHmac(key, domain, value) {
1739
+ if (!(key instanceof Uint8Array) || key.byteLength !== 32 || !boundedIdentity(value)) return null;
1740
+ return createHmac("sha256", key).update(domain).update("\0").update(value).digest("hex");
1741
+ }
1742
+
1743
+ export function ansiCanonicalPresentationHmac(key, mode, presentation) {
1744
+ if (!mode || !presentation) return null;
1745
+ return createHmac("sha256", key)
1746
+ .update("ansi-presentation\0")
1747
+ .update(
1748
+ JSON.stringify([
1749
+ mode.stateHash,
1750
+ mode.alternateScreen,
1751
+ mode.cursor.x,
1752
+ mode.cursor.y,
1753
+ mode.cursor.hidden,
1754
+ mode.cursor.style,
1755
+ mode.cursor.blink,
1756
+ presentation.cursorX,
1757
+ presentation.cursorY,
1758
+ presentation.visible,
1759
+ presentation.style,
1760
+ presentation.blink,
1761
+ ]),
1762
+ )
1763
+ .digest("hex");
1764
+ }
1765
+
1766
+ export function ansiPreAlternateNormalStatus(value, expected) {
1767
+ const cursorExact =
1768
+ value?.stage?.cursor?.x === expected?.cursor?.x &&
1769
+ value?.stage?.cursor?.y === expected?.cursor?.y &&
1770
+ value?.stage?.cursor?.hidden === expected?.cursor?.hidden &&
1771
+ value?.stage?.cursor?.style === expected?.cursor?.style &&
1772
+ value?.stage?.cursor?.blink === expected?.cursor?.blink;
1773
+ const semanticExact =
1774
+ value?.stage?.alternateScreen === false &&
1775
+ SHA256.test(value?.stage?.presentationHmac ?? "") &&
1776
+ value.stage.presentationHmac === expected?.presentationHmac &&
1777
+ SHA256.test(value?.stage?.framebufferHmac ?? "") &&
1778
+ value.stage.framebufferHmac === expected?.framebufferHmac &&
1779
+ cursorExact;
1780
+ const nativeExact =
1781
+ value?.nativeGeometryExact === true &&
1782
+ SHA256.test(value?.nativeCaptureHmac ?? "") &&
1783
+ value.nativeCaptureHmac === expected?.nativeCaptureHmac;
1784
+ return Object.freeze({
1785
+ qualified: semanticExact && nativeExact,
1786
+ semanticExact,
1787
+ nativeExact,
1788
+ cursorExact,
1789
+ });
1790
+ }
1791
+
1792
+ /** Strictly joins one printable-key ingress to its canonical mode, actual cursor, frame and fence. */
1793
+ export function ansiCursorStageFromRecords({
1794
+ records,
1795
+ daemonRecords,
1796
+ watermark = 0,
1797
+ expected,
1798
+ evidenceKey,
1799
+ }) {
1800
+ if (
1801
+ !Array.isArray(records) ||
1802
+ records.length > 100_000 ||
1803
+ !Array.isArray(daemonRecords) ||
1804
+ daemonRecords.length > 100_000 ||
1805
+ !Number.isSafeInteger(watermark) ||
1806
+ watermark < 0 ||
1807
+ watermark > records.length
1808
+ )
1809
+ return Object.freeze({ qualified: false, firstFailedPredicate: "recordsBounded" });
1810
+ if (
1811
+ !new Set([
1812
+ "rich-ansi",
1813
+ "cursor-next",
1814
+ "pre-alternate-normal",
1815
+ "enter-alternate",
1816
+ "restore-normal",
1817
+ ]).has(expected?.action)
1818
+ )
1819
+ return Object.freeze({ qualified: false, firstFailedPredicate: "actionExact" });
1820
+ const tail = records.slice(watermark);
1821
+ const origins = tail.filter(
1822
+ (record) =>
1823
+ record?.type === "performance.input-origin" &&
1824
+ record.origin === "keyboard" &&
1825
+ record.semanticPaneId === expected?.semanticPaneId &&
1826
+ record.generation === expected?.canonicalGeneration,
1827
+ );
1828
+ const origin = origins[0];
1829
+ const modes = tail.filter(
1830
+ (record) =>
1831
+ record?.type === "performance.terminal-canonical-mode" &&
1832
+ record.semanticPaneId === expected?.semanticPaneId &&
1833
+ record.generation === expected?.canonicalGeneration &&
1834
+ record.incarnation === expected?.canonicalIncarnation &&
1835
+ Number.isSafeInteger(record.revision) &&
1836
+ record.revision > expected?.afterRevision,
1837
+ );
1838
+ const mode = modes[0];
1839
+ const presentations = tail.filter(
1840
+ (record) =>
1841
+ record?.type === "performance.terminal-cursor-presentation" &&
1842
+ record.traceId === origin?.traceId &&
1843
+ record.semanticPaneId === expected?.semanticPaneId &&
1844
+ record.generation === mode?.generation &&
1845
+ record.incarnation === mode?.incarnation &&
1846
+ record.revision === mode?.revision &&
1847
+ record.stateHash === mode?.stateHash,
1848
+ );
1849
+ const presentation = presentations[0];
1850
+ const framebufferProjections = tail.filter(
1851
+ (record) =>
1852
+ record?.type === "performance.terminal-framebuffer-projection" &&
1853
+ record.traceId === origin?.traceId &&
1854
+ record.semanticPaneId === expected?.semanticPaneId &&
1855
+ record.generation === mode?.generation &&
1856
+ record.incarnation === mode?.incarnation &&
1857
+ record.revision === mode?.revision &&
1858
+ record.stateHash === mode?.stateHash,
1859
+ );
1860
+ const framebuffer = framebufferProjections[0];
1861
+ const frames = tail.filter(
1862
+ (record) =>
1863
+ record?.type === "performance.terminal-canonical-host-frame" &&
1864
+ record.semanticPaneId === expected?.semanticPaneId &&
1865
+ record.generation === mode?.generation &&
1866
+ record.incarnation === mode?.incarnation &&
1867
+ record.revision === mode?.revision &&
1868
+ record.stateHash === mode?.stateHash &&
1869
+ record.atMicros >= presentation?.atMicros,
1870
+ );
1871
+ const frame = frames[0];
1872
+ const fences = tail.filter(
1873
+ (record) =>
1874
+ record?.type === "performance.terminal-frame-fence" &&
1875
+ record.semanticPaneId === expected?.semanticPaneId &&
1876
+ record.generation === mode?.generation &&
1877
+ record.incarnation === mode?.incarnation &&
1878
+ record.revision === mode?.revision &&
1879
+ record.stateHash === mode?.stateHash &&
1880
+ record.atMicros >= frame?.atMicros,
1881
+ );
1882
+ const fence = fences[0];
1883
+ const stagePresentationCandidates = tail.filter(
1884
+ (record) =>
1885
+ record?.type === "performance.terminal-cursor-presentation" &&
1886
+ record.semanticPaneId === expected?.semanticPaneId &&
1887
+ record.generation === expected?.canonicalGeneration &&
1888
+ record.incarnation === expected?.canonicalIncarnation &&
1889
+ Number.isSafeInteger(record.revision) &&
1890
+ record.revision > expected?.afterRevision,
1891
+ );
1892
+ const stageFrameCandidates = tail.filter(
1893
+ (record) =>
1894
+ record?.type === "performance.terminal-canonical-host-frame" &&
1895
+ record.semanticPaneId === expected?.semanticPaneId &&
1896
+ record.generation === expected?.canonicalGeneration &&
1897
+ record.incarnation === expected?.canonicalIncarnation &&
1898
+ Number.isSafeInteger(record.revision) &&
1899
+ record.revision > expected?.afterRevision,
1900
+ );
1901
+ const stageFenceCandidates = tail.filter(
1902
+ (record) =>
1903
+ record?.type === "performance.terminal-frame-fence" &&
1904
+ record.semanticPaneId === expected?.semanticPaneId &&
1905
+ record.generation === expected?.canonicalGeneration &&
1906
+ record.incarnation === expected?.canonicalIncarnation &&
1907
+ Number.isSafeInteger(record.revision) &&
1908
+ record.revision > expected?.afterRevision,
1909
+ );
1910
+ const finalMode = modes.at(-1);
1911
+ const finalCursor = finalMode?.cursor;
1912
+ const stagePredicates = Object.freeze({
1913
+ modeCardinalityExact: modes.length === 1,
1914
+ tracedCandidateExact: presentations.length === 1,
1915
+ presentationCardinalityExact: stagePresentationCandidates.length === 1,
1916
+ frameCardinalityExact: stageFrameCandidates.length === 1,
1917
+ fenceCardinalityExact: stageFenceCandidates.length === 1,
1918
+ finalAlternateExact: finalMode?.alternateScreen === expected?.alternateScreen,
1919
+ finalCursorStatePresent:
1920
+ typeof finalCursor?.hidden === "boolean" &&
1921
+ typeof finalCursor?.blink === "boolean" &&
1922
+ new Set(["block", "underline", "bar"]).has(finalCursor?.style),
1923
+ });
1924
+ const stageEvidence = Object.freeze({
1925
+ modeCandidateCount: Math.min(modes.length, 2),
1926
+ presentationCandidateCount: Math.min(stagePresentationCandidates.length, 2),
1927
+ frameCandidateCount: Math.min(stageFrameCandidates.length, 2),
1928
+ fenceCandidateCount: Math.min(stageFenceCandidates.length, 2),
1929
+ tracedCandidateExact: stagePredicates.tracedCandidateExact,
1930
+ finalAlternateScreen:
1931
+ typeof finalMode?.alternateScreen === "boolean" ? finalMode.alternateScreen : null,
1932
+ finalCursorVisible: typeof finalCursor?.hidden === "boolean" ? !finalCursor.hidden : null,
1933
+ finalCursorBlink: typeof finalCursor?.blink === "boolean" ? finalCursor.blink : null,
1934
+ firstFailedStageSubpredicate:
1935
+ Object.entries(stagePredicates).find(([, passed]) => !passed)?.[0] ?? null,
1936
+ });
1937
+ const ordered = expected?.framebufferHmac
1938
+ ? [origin, mode, framebuffer, presentation, frame, fence]
1939
+ : [origin, mode, presentation, frame, fence];
1940
+ const indexes = ordered.map((record) => tail.indexOf(record));
1941
+ const upstreamStageDefinitions = ANSI_DAEMON_STAGES.slice(0, 8);
1942
+ const daemonStages = upstreamStageDefinitions.map(([operation, stage]) =>
1943
+ daemonRecords.filter(
1944
+ (record) =>
1945
+ record?.type === "performance.stage" &&
1946
+ record.traceId === origin?.traceId &&
1947
+ record.operation === operation &&
1948
+ record.stage === stage,
1949
+ ),
1950
+ );
1951
+ const expectedDeliverySurfaces = expected?.deliverySurfaces;
1952
+ const expectedDeliveryClients = expected?.deliveryClients;
1953
+ const expectedDeliveryTopology = expected?.deliveryTopology;
1954
+ const expectedDeliveryLanes = expectedDeliveryTopology?.lanes;
1955
+ const deliverySurfaceContractExact =
1956
+ Array.isArray(expectedDeliverySurfaces) &&
1957
+ expectedDeliverySurfaces.length >= 1 &&
1958
+ expectedDeliverySurfaces.length <= 4 &&
1959
+ new Set(expectedDeliverySurfaces).size === expectedDeliverySurfaces.length &&
1960
+ expectedDeliverySurfaces.every(
1961
+ (surface) => typeof surface === "string" && /^[a-z][a-z0-9-]{0,31}$/u.test(surface),
1962
+ ) &&
1963
+ expectedDeliveryClients !== null &&
1964
+ typeof expectedDeliveryClients === "object" &&
1965
+ !Array.isArray(expectedDeliveryClients) &&
1966
+ Object.keys(expectedDeliveryClients).length === expectedDeliverySurfaces.length &&
1967
+ expectedDeliverySurfaces.every(
1968
+ (surface) =>
1969
+ typeof expectedDeliveryClients[surface] === "string" &&
1970
+ expectedDeliveryClients[surface].length >= 1 &&
1971
+ expectedDeliveryClients[surface].length <= 256,
1972
+ ) &&
1973
+ new Set(Object.values(expectedDeliveryClients)).size === expectedDeliverySurfaces.length;
1974
+ const deliveryTopologyContractExact =
1975
+ deliverySurfaceContractExact &&
1976
+ expectedDeliveryTopology?.exact === true &&
1977
+ Number.isSafeInteger(expectedDeliveryTopology?.lifecycleOrdinal) &&
1978
+ expectedDeliveryTopology.lifecycleOrdinal >= 1 &&
1979
+ Array.isArray(expectedDeliveryLanes) &&
1980
+ expectedDeliveryLanes.length >= expectedDeliverySurfaces.length &&
1981
+ expectedDeliveryLanes.length <= 16 &&
1982
+ new Set(expectedDeliveryLanes.map((lane) => lane?.laneId)).size ===
1983
+ expectedDeliveryLanes.length &&
1984
+ expectedDeliveryLanes.every(
1985
+ (lane) =>
1986
+ lane?.purpose === "terminal-surface" &&
1987
+ expectedDeliveryClients[lane.surface] === lane.clientId &&
1988
+ typeof lane.laneId === "string" &&
1989
+ lane.laneId.length >= 1 &&
1990
+ lane.laneId.length <= 256 &&
1991
+ UUID_V4.test(lane.requestId),
1992
+ );
1993
+ const currentDeliveryTopology = ansiDeliverySubscriberTopologyStatus({
1994
+ records: daemonRecords,
1995
+ expected,
1996
+ });
1997
+ const deliveryTopologyExact =
1998
+ deliveryTopologyContractExact &&
1999
+ currentDeliveryTopology.exact === true &&
2000
+ currentDeliveryTopology.lifecycleOrdinal === expectedDeliveryTopology.lifecycleOrdinal &&
2001
+ JSON.stringify(currentDeliveryTopology.lanes) === JSON.stringify(expectedDeliveryLanes);
2002
+ const targetDelivery = (record, operation) =>
2003
+ record?.type === "performance.stage" &&
2004
+ record.traceId === origin?.traceId &&
2005
+ record.operation === operation &&
2006
+ record.stage === "transport" &&
2007
+ record.terminalDelivery?.workspaceName === expected?.deliveryWorkspaceName &&
2008
+ record.terminalDelivery?.semanticPaneId === expected?.semanticPaneId &&
2009
+ record.terminalDelivery?.canonicalGeneration === expected?.canonicalGeneration &&
2010
+ record.terminalDelivery?.canonicalIncarnation === expected?.canonicalIncarnation &&
2011
+ record.terminalDelivery?.canonicalRevision === mode?.revision &&
2012
+ record.terminalDelivery?.canonicalStateHash === mode?.stateHash;
2013
+ const deliveryEnqueues = daemonRecords.filter((record) =>
2014
+ targetDelivery(record, "terminal-delivery-encode-enqueue"),
2015
+ );
2016
+ const deliverySockets = daemonRecords.filter((record) =>
2017
+ targetDelivery(record, "pane-stream-socket-send"),
2018
+ );
2019
+ const deliverySettlements = daemonRecords.filter((record) =>
2020
+ targetDelivery(record, "terminal-delivery-settled"),
2021
+ );
2022
+ const deliveryRecords = [...deliveryEnqueues, ...deliverySockets, ...deliverySettlements];
2023
+ const deliveryIdentityShapeExact = deliveryRecords.every((record) => {
2024
+ const delivery = record.terminalDelivery;
2025
+ return (
2026
+ typeof delivery?.deliveryClientId === "string" &&
2027
+ delivery.deliveryClientId.length >= 1 &&
2028
+ delivery.deliveryClientId.length <= 256 &&
2029
+ typeof delivery?.deliverySurface === "string" &&
2030
+ deliverySurfaceContractExact &&
2031
+ expectedDeliverySurfaces.includes(delivery.deliverySurface) &&
2032
+ delivery.deliveryClientId === expectedDeliveryClients[delivery.deliverySurface] &&
2033
+ typeof delivery?.deliveryLaneId === "string" &&
2034
+ delivery.deliveryLaneId.length >= 1 &&
2035
+ delivery.deliveryLaneId.length <= 256 &&
2036
+ typeof delivery?.deliveryRequestId === "string" &&
2037
+ UUID_V4.test(delivery.deliveryRequestId) &&
2038
+ typeof delivery?.deliveryNonce === "string" &&
2039
+ delivery.deliveryNonce.length >= 1 &&
2040
+ delivery.deliveryNonce.length <= 256 &&
2041
+ typeof delivery?.transactionId === "string" &&
2042
+ delivery.transactionId.length >= 1 &&
2043
+ delivery.transactionId.length <= 256
2044
+ );
2045
+ });
2046
+ const deliveryPartitions = deliveryTopologyContractExact
2047
+ ? expectedDeliveryLanes.map((expectedLane) => {
2048
+ const enqueues = deliveryEnqueues.filter(
2049
+ (record) => record.terminalDelivery.deliveryLaneId === expectedLane.laneId,
2050
+ );
2051
+ const sockets = deliverySockets.filter(
2052
+ (record) => record.terminalDelivery.deliveryLaneId === expectedLane.laneId,
2053
+ );
2054
+ const settlements = deliverySettlements.filter(
2055
+ (record) => record.terminalDelivery.deliveryLaneId === expectedLane.laneId,
2056
+ );
2057
+ const [enqueue, socket, settled] = [enqueues[0], sockets[0], settlements[0]];
2058
+ const identityFields = [
2059
+ "deliveryClientId",
2060
+ "deliverySurface",
2061
+ "deliveryLaneId",
2062
+ "deliveryRequestId",
2063
+ "deliveryNonce",
2064
+ "transactionId",
2065
+ ];
2066
+ const identityExact =
2067
+ identityFields.every(
2068
+ (field) =>
2069
+ enqueue?.terminalDelivery?.[field] === socket?.terminalDelivery?.[field] &&
2070
+ enqueue?.terminalDelivery?.[field] === settled?.terminalDelivery?.[field],
2071
+ ) &&
2072
+ enqueue?.terminalDelivery?.deliveryClientId === expectedLane.clientId &&
2073
+ enqueue?.terminalDelivery?.deliverySurface === expectedLane.surface &&
2074
+ enqueue?.terminalDelivery?.deliveryLaneId === expectedLane.laneId &&
2075
+ enqueue?.terminalDelivery?.deliveryRequestId === expectedLane.requestId;
2076
+ const ordinalExact =
2077
+ Number.isSafeInteger(enqueue?.terminalDelivery?.deliveryOrdinal) &&
2078
+ enqueue.terminalDelivery.deliveryOrdinal >= 1 &&
2079
+ socket?.terminalDelivery?.deliveryOrdinal === enqueue.terminalDelivery.deliveryOrdinal &&
2080
+ settled?.terminalDelivery?.deliveryOrdinal === enqueue.terminalDelivery.deliveryOrdinal;
2081
+ const orderedExact =
2082
+ safeTimestamp(enqueue?.startedAtMicros) &&
2083
+ safeTimestamp(enqueue?.endedAtMicros) &&
2084
+ safeTimestamp(socket?.startedAtMicros) &&
2085
+ safeTimestamp(socket?.endedAtMicros) &&
2086
+ safeTimestamp(settled?.startedAtMicros) &&
2087
+ safeTimestamp(settled?.endedAtMicros) &&
2088
+ enqueue.startedAtMicros <= enqueue.endedAtMicros &&
2089
+ enqueue.endedAtMicros <= socket.startedAtMicros &&
2090
+ socket.startedAtMicros <= socket.endedAtMicros &&
2091
+ socket.endedAtMicros <= settled.startedAtMicros &&
2092
+ settled.startedAtMicros <= settled.endedAtMicros;
2093
+ return Object.freeze({
2094
+ laneId: expectedLane.laneId,
2095
+ cardinalityExact:
2096
+ enqueues.length === 1 && sockets.length === 1 && settlements.length === 1,
2097
+ identityExact,
2098
+ ordinalExact,
2099
+ orderedExact,
2100
+ });
2101
+ })
2102
+ : [];
2103
+ const deliveryFanoutExact =
2104
+ deliveryTopologyExact &&
2105
+ deliveryEnqueues.length === expectedDeliveryLanes.length &&
2106
+ deliverySockets.length === expectedDeliveryLanes.length &&
2107
+ deliverySettlements.length === expectedDeliveryLanes.length &&
2108
+ deliveryIdentityShapeExact &&
2109
+ [
2110
+ "deliveryLaneId",
2111
+ "deliveryRequestId",
2112
+ "deliveryNonce",
2113
+ "transactionId",
2114
+ "deliveryOrdinal",
2115
+ ].every(
2116
+ (field) =>
2117
+ new Set(deliveryEnqueues.map((record) => record.terminalDelivery[field])).size ===
2118
+ expectedDeliveryLanes.length,
2119
+ ) &&
2120
+ deliveryPartitions.every(
2121
+ ({ cardinalityExact, identityExact, ordinalExact, orderedExact }) =>
2122
+ cardinalityExact && identityExact && ordinalExact && orderedExact,
2123
+ );
2124
+ const daemonFlat = [...daemonStages.flat(), ...deliveryRecords];
2125
+ const daemonProcesses = new Set(daemonFlat.map(({ processId }) => processId));
2126
+ const daemonClocks = new Set(daemonFlat.map(({ clockId }) => clockId));
2127
+ const [callback, ingress, raw, controlWrite, accepted, output, parse, reduce] =
2128
+ daemonStages.flat();
2129
+ const daemonCardinalityExact = daemonStages.every((matches) => matches.length === 1);
2130
+ const expectedDaemonPid = DAEMON_PROCESS_ID.exec(expected?.daemonProcessId ?? "")?.[1];
2131
+ const daemonProcessExact =
2132
+ daemonFlat.length === upstreamStageDefinitions.length + expectedDeliveryLanes?.length * 3 &&
2133
+ daemonProcesses.size === 1 &&
2134
+ expectedDaemonPid !== undefined &&
2135
+ Number.isSafeInteger(Number(expectedDaemonPid)) &&
2136
+ daemonFlat.every((record) => record.processId === expected.daemonProcessId);
2137
+ const daemonClockExact =
2138
+ daemonFlat.length === upstreamStageDefinitions.length + expectedDeliveryLanes?.length * 3 &&
2139
+ daemonClocks.size === 1 &&
2140
+ expected?.daemonClockId === "node-performance-now" &&
2141
+ daemonFlat.every((record) => record.clockId === expected.daemonClockId);
2142
+ const daemonClockKindExact = daemonFlat.every((record) => record.clockKind === "performance-now");
2143
+ const daemonAuthorityClassMaskExact = daemonFlat.every(
2144
+ (record) =>
2145
+ record.authority?.generation === expected?.canonicalGeneration &&
2146
+ (ANSI_DAEMON_NULL_INCARNATION_OPERATIONS.has(record.operation)
2147
+ ? record.authority?.incarnation === null
2148
+ : record.authority?.incarnation === expected?.canonicalIncarnation),
2149
+ );
2150
+ const daemonTimestampExact = daemonFlat.every(
2151
+ (record) =>
2152
+ safeTimestamp(record.startedAtMicros) &&
2153
+ safeTimestamp(record.endedAtMicros) &&
2154
+ record.startedAtMicros <= record.endedAtMicros,
2155
+ );
2156
+ const daemonOrderExact =
2157
+ callback?.endedAtMicros <= ingress?.startedAtMicros &&
2158
+ ingress?.endedAtMicros <= raw?.startedAtMicros &&
2159
+ raw?.endedAtMicros <= controlWrite?.startedAtMicros &&
2160
+ controlWrite?.endedAtMicros <= accepted?.startedAtMicros &&
2161
+ accepted?.endedAtMicros <= output?.startedAtMicros &&
2162
+ output?.endedAtMicros <= parse?.startedAtMicros &&
2163
+ parse?.startedAtMicros <= parse?.endedAtMicros &&
2164
+ parse?.endedAtMicros <= reduce?.startedAtMicros &&
2165
+ reduce?.startedAtMicros <= reduce?.endedAtMicros &&
2166
+ deliveryPartitions.every(
2167
+ ({ laneId, orderedExact }) =>
2168
+ orderedExact &&
2169
+ reduce?.endedAtMicros <=
2170
+ deliveryEnqueues.find((record) => record.terminalDelivery.deliveryLaneId === laneId)
2171
+ ?.startedAtMicros,
2172
+ );
2173
+ const daemonScenarioExact = daemonFlat.every(
2174
+ (record) => record.scenario === "terminal-input-to-paint" && record.traceId === origin?.traceId,
2175
+ );
2176
+ const daemonPredicates = Object.freeze({
2177
+ deliveryTopologyExact,
2178
+ cardinalityExact: daemonCardinalityExact && deliveryFanoutExact,
2179
+ deliveryFanoutExact,
2180
+ processExact: daemonProcessExact,
2181
+ clockExact: daemonClockExact,
2182
+ clockKindExact: daemonClockKindExact,
2183
+ authorityClassMaskExact: daemonAuthorityClassMaskExact,
2184
+ timestampExact: daemonTimestampExact,
2185
+ scenarioExact: daemonScenarioExact,
2186
+ orderExact: daemonOrderExact,
2187
+ });
2188
+ const firstFailedDaemonPredicate =
2189
+ Object.entries(daemonPredicates).find(([, passed]) => !passed)?.[0] ?? null;
2190
+ const daemonEvidence = Object.freeze({
2191
+ stageCountVector: Object.freeze([
2192
+ ...daemonStages.map((matches) => Math.min(matches.length, 2)),
2193
+ Math.min(deliveryEnqueues.length, 5),
2194
+ Math.min(deliverySockets.length, 5),
2195
+ Math.min(deliverySettlements.length, 5),
2196
+ ]),
2197
+ deliveryLaneCount: Math.min(currentDeliveryTopology.lanes.length, 17),
2198
+ ...daemonPredicates,
2199
+ firstFailedDaemonPredicate,
2200
+ });
2201
+ const daemonExact = firstFailedDaemonPredicate === null;
2202
+ const predicates = Object.freeze({
2203
+ inputExact:
2204
+ origins.length === 1 &&
2205
+ origin?.processId === expected?.processId &&
2206
+ origin?.clockId === expected?.clockId &&
2207
+ origin?.clockKind === "performance-now" &&
2208
+ origin?.incarnation === expected?.canonicalIncarnation &&
2209
+ origin?.revision === expected?.afterRevision &&
2210
+ origin?.stateHash === expected?.priorStateHash &&
2211
+ CANONICAL_STATE_HASH.test(origin?.stateHash ?? "") &&
2212
+ UUID_V4.test(origin?.traceId ?? "") &&
2213
+ origin?.payloadByteCount === 1 &&
2214
+ origin?.parserConsumption === "keyboard-event",
2215
+ modeExact:
2216
+ modes.length === 1 &&
2217
+ mode?.alternateScreen === expected?.alternateScreen &&
2218
+ mode?.processId === expected?.processId &&
2219
+ mode?.clockId === expected?.clockId &&
2220
+ mode?.clockKind === "performance-now" &&
2221
+ CANONICAL_STATE_HASH.test(mode?.stateHash ?? ""),
2222
+ presentationExact:
2223
+ presentations.length === 1 &&
2224
+ presentation?.processId === expected?.processId &&
2225
+ presentation?.clockId === expected?.clockId &&
2226
+ presentation?.clockKind === "performance-now" &&
2227
+ presentation?.sourceEpoch === expected?.sourceEpoch &&
2228
+ presentation?.rendererEpoch === expected?.rendererEpoch &&
2229
+ presentation?.cols === expected?.canonicalCols &&
2230
+ presentation?.rows === expected?.canonicalRows &&
2231
+ presentation?.gridWalked === expected?.gridWalked &&
2232
+ presentation?.gridRowsRead === expected?.gridRowsRead &&
2233
+ presentation?.fullWalk === expected?.fullWalk &&
2234
+ presentation?.gridWalked === presentation?.gridRowsRead > 0 &&
2235
+ Number.isSafeInteger(presentation?.gridRowsRead) &&
2236
+ presentation.gridRowsRead >= 0 &&
2237
+ presentation.gridRowsRead <= expected?.viewportRows &&
2238
+ (presentation.fullWalk !== true || presentation.gridRowsRead === expected?.viewportRows) &&
2239
+ presentation?.visible === !mode?.cursor?.hidden &&
2240
+ presentation?.cursorX === mode?.cursor?.x &&
2241
+ presentation?.cursorY === mode?.cursor?.y &&
2242
+ presentation?.style === (mode?.cursor?.style === "bar" ? "line" : mode?.cursor?.style) &&
2243
+ presentation?.blink === mode?.cursor?.blink &&
2244
+ presentation?.viewportCols === expected?.viewportCols &&
2245
+ presentation?.viewportRows === expected?.viewportRows &&
2246
+ presentation?.screenX === expected?.screenOffsetX + presentation.cursorX + 1 &&
2247
+ presentation?.screenY === expected?.screenOffsetY + presentation.cursorY + 1 &&
2248
+ Number.isSafeInteger(presentation?.gridRowsReadTotal) &&
2249
+ Number.isSafeInteger(presentation?.fullWalkTotal) &&
2250
+ Number.isSafeInteger(presentation?.presentationCount) &&
2251
+ presentation.gridRowsReadTotal ===
2252
+ expected?.previousCounters?.gridRowsReadTotal + presentation.gridRowsRead &&
2253
+ presentation.fullWalkTotal ===
2254
+ expected?.previousCounters?.fullWalkTotal + (presentation.fullWalk === true ? 1 : 0) &&
2255
+ presentation.presentationCount === expected?.previousCounters?.presentationCount + 1,
2256
+ framebufferExact:
2257
+ expected?.framebufferHmac === null
2258
+ ? framebufferProjections.length === 0
2259
+ : framebufferProjections.length === 1 &&
2260
+ framebuffer?.processId === expected?.processId &&
2261
+ framebuffer?.clockId === expected?.clockId &&
2262
+ framebuffer?.clockKind === "performance-now" &&
2263
+ framebuffer?.sourceEpoch === expected?.sourceEpoch &&
2264
+ framebuffer?.rendererEpoch === expected?.rendererEpoch &&
2265
+ framebuffer?.cols === expected?.canonicalCols &&
2266
+ framebuffer?.rows === expected?.canonicalRows &&
2267
+ framebuffer?.projectionHmac === expected?.framebufferHmac &&
2268
+ framebuffer?.cellCount === expected?.framebufferCellCount &&
2269
+ framebuffer?.wideContinuationCount === expected?.framebufferWideContinuationCount &&
2270
+ framebuffer?.combiningCount === expected?.framebufferCombiningCount &&
2271
+ framebuffer?.styledCellCount === expected?.framebufferStyledCellCount,
2272
+ frameExact:
2273
+ frames.length === 1 &&
2274
+ frame?.processId === expected?.processId &&
2275
+ frame?.clockId === expected?.clockId &&
2276
+ frame?.clockKind === "performance-now" &&
2277
+ frame?.sourceEpoch === expected?.sourceEpoch &&
2278
+ frame?.rendererEpoch === expected?.rendererEpoch &&
2279
+ frame?.cols === expected?.canonicalCols &&
2280
+ frame?.rows === expected?.canonicalRows &&
2281
+ frame?.viewportCols === expected?.viewportCols &&
2282
+ frame?.viewportRows === expected?.viewportRows &&
2283
+ frame?.acceptedUpdateType === "terminal.patch" &&
2284
+ frame?.acceptedRevision === mode?.revision,
2285
+ fenceExact:
2286
+ fences.length === 1 &&
2287
+ fence?.processId === expected?.processId &&
2288
+ fence?.clockId === expected?.clockId &&
2289
+ fence?.clockKind === "performance-now" &&
2290
+ fence?.daemonGeneration === expected?.daemonGeneration &&
2291
+ fence?.sourceEpoch === expected?.sourceEpoch &&
2292
+ fence?.rendererEpoch === expected?.rendererEpoch &&
2293
+ fence?.cols === expected?.canonicalCols &&
2294
+ fence?.rows === expected?.canonicalRows &&
2295
+ fence?.viewportCols === expected?.viewportCols &&
2296
+ fence?.viewportRows === expected?.viewportRows &&
2297
+ fence?.acceptedUpdateType === "terminal.patch" &&
2298
+ fence?.acceptedRevision === mode?.revision &&
2299
+ fence?.writerHealth?.droppedRecords === 0 &&
2300
+ fence?.writerHealth?.oversizedRecords === 0 &&
2301
+ fence?.writerHealth?.failed === false &&
2302
+ fence?.writerHealth?.pendingCriticalRecords === 0,
2303
+ orderExact:
2304
+ indexes.every((index) => index >= 0) &&
2305
+ indexes.every((index, offset) => offset === 0 || index > indexes[offset - 1]) &&
2306
+ safeTimestamp(origin?.atMicros) &&
2307
+ safeTimestamp(mode?.atMicros) &&
2308
+ (!expected?.framebufferHmac || safeTimestamp(framebuffer?.atMicros)) &&
2309
+ safeTimestamp(presentation?.atMicros) &&
2310
+ safeTimestamp(frame?.atMicros) &&
2311
+ safeTimestamp(fence?.atMicros) &&
2312
+ origin.atMicros <= mode.atMicros &&
2313
+ (!expected?.framebufferHmac || mode.atMicros <= framebuffer.atMicros) &&
2314
+ (!expected?.framebufferHmac || framebuffer.atMicros <= presentation.atMicros) &&
2315
+ mode.atMicros <= presentation.atMicros &&
2316
+ presentation.atMicros <= frame.atMicros &&
2317
+ frame.atMicros <= fence.atMicros,
2318
+ daemonExact,
2319
+ });
2320
+ const firstFailedPredicate =
2321
+ Object.entries(predicates).find(([, passed]) => !passed)?.[0] ?? null;
2322
+ if (firstFailedPredicate)
2323
+ return Object.freeze({
2324
+ qualified: false,
2325
+ firstFailedPredicate,
2326
+ predicates,
2327
+ daemonEvidence,
2328
+ stageEvidence,
2329
+ });
2330
+ const presentationHmac = ansiCanonicalPresentationHmac(evidenceKey, mode, presentation);
2331
+ const identity = (record) =>
2332
+ Object.freeze({
2333
+ processHmac: privateHmac(evidenceKey, "process", record.processId),
2334
+ clockId: record.clockId,
2335
+ clockKind: record.clockKind,
2336
+ paneHmac: privateHmac(evidenceKey, "pane", record.semanticPaneId),
2337
+ generationHmac: privateHmac(evidenceKey, "generation", record.generation),
2338
+ incarnationHmac: privateHmac(evidenceKey, "incarnation", record.incarnation),
2339
+ revision: record.revision,
2340
+ stateHmac: privateHmac(evidenceKey, "state", record.stateHash),
2341
+ presentationHmac,
2342
+ canonicalCols: record.cols,
2343
+ canonicalRows: record.rows,
2344
+ viewportCols: record.viewportCols,
2345
+ viewportRows: record.viewportRows,
2346
+ sourceEpoch: record.sourceEpoch,
2347
+ rendererEpoch: record.rendererEpoch,
2348
+ });
2349
+ const presentationIdentity = identity(presentation);
2350
+ const frameIdentity = identity(frame);
2351
+ const fenceIdentity = identity(fence);
2352
+ const stage = Object.freeze({
2353
+ ...presentationIdentity,
2354
+ alternateScreen: mode.alternateScreen,
2355
+ cursor: Object.freeze({
2356
+ x: presentation.cursorX,
2357
+ y: presentation.cursorY,
2358
+ hidden: !presentation.visible,
2359
+ style: presentation.style,
2360
+ blink: presentation.blink,
2361
+ }),
2362
+ framebufferHmac: expected.framebufferHmac,
2363
+ framebufferCellCount: expected.framebufferCellCount,
2364
+ framebufferWideContinuationCount: expected.framebufferWideContinuationCount,
2365
+ framebufferCombiningCount: expected.framebufferCombiningCount,
2366
+ framebufferStyledCellCount: expected.framebufferStyledCellCount,
2367
+ gridRowsReadTotal: presentation.gridRowsReadTotal,
2368
+ fullWalkTotal: presentation.fullWalkTotal,
2369
+ presentationCount: presentation.presentationCount,
2370
+ });
2371
+ return Object.freeze({
2372
+ qualified: true,
2373
+ firstFailedPredicate: null,
2374
+ predicates,
2375
+ daemonEvidence,
2376
+ stageEvidence,
2377
+ stage,
2378
+ sample: Object.freeze({
2379
+ startedAtMicros: origin.atMicros,
2380
+ presentedAtMicros: presentation.atMicros,
2381
+ frameAtMicros: frame.atMicros,
2382
+ fenceAtMicros: fence.atMicros,
2383
+ durationMicros: fence.atMicros - origin.atMicros,
2384
+ traceHmac: privateHmac(evidenceKey, "trace", origin.traceId),
2385
+ gestureHmac: privateHmac(evidenceKey, "gesture", origin.traceId),
2386
+ causal: Object.freeze({
2387
+ dirtyRows: Object.freeze([]),
2388
+ gridRowsReadDelta:
2389
+ presentation.gridRowsReadTotal - expected.previousCounters.gridRowsReadTotal,
2390
+ fullWalkDelta: presentation.fullWalkTotal - expected.previousCounters.fullWalkTotal,
2391
+ presentationCountDelta:
2392
+ presentation.presentationCount - expected.previousCounters.presentationCount,
2393
+ inputAccepted: predicates.inputExact && daemonExact,
2394
+ canonicalReceiptExact: predicates.modeExact && predicates.presentationExact,
2395
+ daemonStageCount: ANSI_DAEMON_STAGES.length,
2396
+ daemonProcessHmac: privateHmac(evidenceKey, "daemon-process", daemonFlat[0].processId),
2397
+ daemonClockId: daemonFlat[0].clockId,
2398
+ }),
2399
+ action: expected.action,
2400
+ cursor: Object.freeze({
2401
+ x: mode.cursor.x,
2402
+ y: mode.cursor.y,
2403
+ hidden: mode.cursor.hidden,
2404
+ canonicalStyle: mode.cursor.style,
2405
+ rendererStyle: presentation.style,
2406
+ blink: mode.cursor.blink,
2407
+ }),
2408
+ presentation: Object.freeze({
2409
+ ...presentationIdentity,
2410
+ gridWalked: presentation.gridWalked,
2411
+ gridRowsRead: presentation.gridRowsRead,
2412
+ fullWalk: presentation.fullWalk,
2413
+ gridRowsReadTotal: presentation.gridRowsReadTotal,
2414
+ fullWalkTotal: presentation.fullWalkTotal,
2415
+ presentationCount: presentation.presentationCount,
2416
+ }),
2417
+ frame: frameIdentity,
2418
+ fence: fenceIdentity,
2419
+ }),
2420
+ writerHealth: fence.writerHealth,
2421
+ raw: Object.freeze({
2422
+ mode,
2423
+ presentation,
2424
+ frame,
2425
+ fence,
2426
+ origin,
2427
+ deliveryTopology: expectedDeliveryTopology,
2428
+ }),
2429
+ counters: Object.freeze({
2430
+ gridRowsReadTotal: presentation.gridRowsReadTotal,
2431
+ fullWalkTotal: presentation.fullWalkTotal,
2432
+ presentationCount: presentation.presentationCount,
2433
+ }),
2434
+ });
2435
+ }
2436
+
2437
+ function exactIdentity(value, expected) {
2438
+ return (
2439
+ SHA256.test(value?.processHmac ?? "") &&
2440
+ value.processHmac === expected?.processHmac &&
2441
+ value?.clockId === expected?.clockId &&
2442
+ value?.clockKind === "performance-now" &&
2443
+ value.clockKind === expected?.clockKind &&
2444
+ SHA256.test(value?.paneHmac ?? "") &&
2445
+ value.paneHmac === expected?.paneHmac &&
2446
+ SHA256.test(value?.generationHmac ?? "") &&
2447
+ value.generationHmac === expected?.generationHmac &&
2448
+ SHA256.test(value?.incarnationHmac ?? "") &&
2449
+ value.incarnationHmac === expected?.incarnationHmac &&
2450
+ Number.isSafeInteger(value?.revision) &&
2451
+ value.revision >= 0 &&
2452
+ SHA256.test(value?.stateHmac ?? "") &&
2453
+ value.stateHmac === expected?.stateHmac &&
2454
+ SHA256.test(value?.presentationHmac ?? "") &&
2455
+ value.presentationHmac === expected?.presentationHmac &&
2456
+ Number.isSafeInteger(value?.canonicalCols) &&
2457
+ value.canonicalCols > 0 &&
2458
+ value.canonicalCols === expected?.canonicalCols &&
2459
+ Number.isSafeInteger(value?.canonicalRows) &&
2460
+ value.canonicalRows > 0 &&
2461
+ value.canonicalRows === expected?.canonicalRows &&
2462
+ Number.isSafeInteger(value?.viewportCols) &&
2463
+ value.viewportCols > 0 &&
2464
+ value.viewportCols === expected?.viewportCols &&
2465
+ Number.isSafeInteger(value?.viewportRows) &&
2466
+ value.viewportRows > 0 &&
2467
+ value.viewportRows === expected?.viewportRows &&
2468
+ Number.isSafeInteger(value?.sourceEpoch) &&
2469
+ value.sourceEpoch >= 0 &&
2470
+ value.sourceEpoch === expected?.sourceEpoch &&
2471
+ Number.isSafeInteger(value?.rendererEpoch) &&
2472
+ value.rendererEpoch >= 0 &&
2473
+ value.rendererEpoch === expected?.rendererEpoch &&
2474
+ value.revision === expected?.revision
2475
+ );
2476
+ }
2477
+
2478
+ function percentile(sorted, percentileValue) {
2479
+ return sorted[Math.max(0, Math.ceil(sorted.length * percentileValue) - 1)] ?? null;
2480
+ }
2481
+
2482
+ function theilSen(values) {
2483
+ const slopes = [];
2484
+ for (let left = 0; left < values.length; left += 1)
2485
+ for (let right = left + 1; right < values.length; right += 1)
2486
+ slopes.push((values[right] - values[left]) / (right - left));
2487
+ slopes.sort((left, right) => left - right);
2488
+ return slopes.length === 0 ? null : slopes[Math.floor(slopes.length / 2)];
2489
+ }
2490
+
2491
+ export function assessAnsiQuiescentResourceSamples(samples, expectedSamples) {
2492
+ if (!Array.isArray(samples) || samples.length !== RESOURCE_ENDPOINT_COUNT)
2493
+ return Object.freeze({
2494
+ qualified: false,
2495
+ sampleCount: Array.isArray(samples) ? samples.length : 0,
2496
+ firstInvalidEndpointOrdinal: null,
2497
+ firstInvalidPredicate: "endpoint-cardinality",
2498
+ });
2499
+ const ordinals = new Set();
2500
+ const fences = new Set();
2501
+ const daemonTraces = new Set();
2502
+ const daemonProcesses = new Set();
2503
+ const daemonClocks = new Set();
2504
+ let previousAtMicros = -1;
2505
+ let previousDaemonEndedAtMicros = -1;
2506
+ let exact = true;
2507
+ let firstInvalidEndpointOrdinal = null;
2508
+ let firstInvalidPredicate = null;
2509
+ for (let index = 0; index < samples.length; index += 1) {
2510
+ const sample = samples[index];
2511
+ const expected = expectedSamples?.[index];
2512
+ const sampleExact =
2513
+ exactKeys(expected, [
2514
+ "endpointOrdinal",
2515
+ "sampleOrdinal",
2516
+ "fenceHmac",
2517
+ "markerHmac",
2518
+ "processHmac",
2519
+ "clockId",
2520
+ "fenceAtMicros",
2521
+ "daemonTraceHmac",
2522
+ "daemonProcessHmac",
2523
+ "daemonClockId",
2524
+ ]) &&
2525
+ exactKeys(sample, [
2526
+ "endpointOrdinal",
2527
+ "sampleOrdinal",
2528
+ "fenceHmac",
2529
+ "markerHmac",
2530
+ "processHmac",
2531
+ "clockId",
2532
+ "clockKind",
2533
+ "atMicros",
2534
+ "inputPending",
2535
+ "inputInFlight",
2536
+ "inputPendingBytes",
2537
+ "daemonTraceHmac",
2538
+ "daemonProcessHmac",
2539
+ "daemonClockId",
2540
+ "daemonClockKind",
2541
+ "daemonStartedAtMicros",
2542
+ "daemonEndedAtMicros",
2543
+ "representationCacheBytes",
2544
+ "rawJournalBytes",
2545
+ "deliveryQueueDepth",
2546
+ "deliveryMaxQueueDepth",
2547
+ "deliveryInFlight",
2548
+ "deliveryInFlightBytes",
2549
+ "rssBytes",
2550
+ "heapUsedBytes",
2551
+ "eventLoopDelayMicros",
2552
+ ]) &&
2553
+ sample?.endpointOrdinal === index + 1 &&
2554
+ expected?.endpointOrdinal === index + 1 &&
2555
+ Number.isSafeInteger(sample?.sampleOrdinal) &&
2556
+ sample.sampleOrdinal === expected?.sampleOrdinal &&
2557
+ sample.sampleOrdinal >= 1 &&
2558
+ sample.sampleOrdinal <= 512 &&
2559
+ !ordinals.has(sample.sampleOrdinal) &&
2560
+ SHA256.test(sample?.fenceHmac ?? "") &&
2561
+ !fences.has(sample.fenceHmac) &&
2562
+ sample.fenceHmac === expected?.fenceHmac &&
2563
+ SHA256.test(sample?.markerHmac ?? "") &&
2564
+ sample.markerHmac === expected?.markerHmac &&
2565
+ SHA256.test(sample?.processHmac ?? "") &&
2566
+ sample.processHmac === expected?.processHmac &&
2567
+ sample?.clockId === expected?.clockId &&
2568
+ sample?.clockKind === "performance-now" &&
2569
+ safeTimestamp(sample?.atMicros) &&
2570
+ safeTimestamp(expected?.fenceAtMicros) &&
2571
+ sample.atMicros >= expected.fenceAtMicros &&
2572
+ sample.atMicros > previousAtMicros &&
2573
+ sample?.inputPending === 0 &&
2574
+ sample?.inputInFlight === 0 &&
2575
+ sample?.inputPendingBytes === 0 &&
2576
+ SHA256.test(sample?.daemonTraceHmac ?? "") &&
2577
+ !daemonTraces.has(sample.daemonTraceHmac) &&
2578
+ sample.daemonTraceHmac === expected?.daemonTraceHmac &&
2579
+ SHA256.test(sample?.daemonProcessHmac ?? "") &&
2580
+ sample.daemonProcessHmac === expected?.daemonProcessHmac &&
2581
+ boundedIdentity(sample?.daemonClockId) &&
2582
+ sample.daemonClockId === expected?.daemonClockId &&
2583
+ sample?.daemonClockKind === "performance-now" &&
2584
+ safeTimestamp(sample?.daemonStartedAtMicros) &&
2585
+ safeTimestamp(sample?.daemonEndedAtMicros) &&
2586
+ sample.daemonStartedAtMicros <= sample.daemonEndedAtMicros &&
2587
+ sample.daemonStartedAtMicros > previousDaemonEndedAtMicros &&
2588
+ Number.isSafeInteger(sample?.representationCacheBytes) &&
2589
+ sample.representationCacheBytes >= 0 &&
2590
+ sample.representationCacheBytes <= 16_777_216 &&
2591
+ Number.isSafeInteger(sample?.rawJournalBytes) &&
2592
+ sample.rawJournalBytes >= 0 &&
2593
+ sample.rawJournalBytes <= 4_194_304 &&
2594
+ Number.isSafeInteger(sample?.deliveryQueueDepth) &&
2595
+ sample.deliveryQueueDepth >= 0 &&
2596
+ sample.deliveryQueueDepth <= 64 &&
2597
+ Number.isSafeInteger(sample?.deliveryMaxQueueDepth) &&
2598
+ sample.deliveryMaxQueueDepth >= sample.deliveryQueueDepth &&
2599
+ sample.deliveryMaxQueueDepth <= 64 &&
2600
+ sample?.deliveryQueueDepth === 0 &&
2601
+ sample?.deliveryInFlight === 0 &&
2602
+ sample?.deliveryInFlightBytes === 0 &&
2603
+ Number.isSafeInteger(sample?.rssBytes) &&
2604
+ sample.rssBytes >= 0 &&
2605
+ sample.rssBytes <= ANSI_TUI_RSS_ABSOLUTE_CEILING_BYTES &&
2606
+ Number.isSafeInteger(sample?.heapUsedBytes) &&
2607
+ sample.heapUsedBytes >= 0 &&
2608
+ sample.heapUsedBytes <= ANSI_TUI_HEAP_ABSOLUTE_CEILING_BYTES &&
2609
+ Number.isSafeInteger(sample?.eventLoopDelayMicros) &&
2610
+ sample.eventLoopDelayMicros >= 0 &&
2611
+ sample.eventLoopDelayMicros <= ANSI_TUI_EVENT_LOOP_CURRENT_ENDPOINT_CEILING_MICROS;
2612
+ exact &&= sampleExact;
2613
+ if (!sampleExact && firstInvalidEndpointOrdinal === null) {
2614
+ firstInvalidEndpointOrdinal = index + 1;
2615
+ firstInvalidPredicate = "endpoint-shape-or-authority";
2616
+ }
2617
+ if (Number.isSafeInteger(sample?.sampleOrdinal)) ordinals.add(sample.sampleOrdinal);
2618
+ if (SHA256.test(sample?.fenceHmac ?? "")) fences.add(sample.fenceHmac);
2619
+ if (SHA256.test(sample?.daemonTraceHmac ?? "")) daemonTraces.add(sample.daemonTraceHmac);
2620
+ if (safeTimestamp(sample?.atMicros)) previousAtMicros = sample.atMicros;
2621
+ if (safeTimestamp(sample?.daemonEndedAtMicros))
2622
+ previousDaemonEndedAtMicros = sample.daemonEndedAtMicros;
2623
+ if (SHA256.test(sample?.daemonProcessHmac ?? "")) daemonProcesses.add(sample.daemonProcessHmac);
2624
+ if (boundedIdentity(sample?.daemonClockId)) daemonClocks.add(sample.daemonClockId);
2625
+ }
2626
+ const rss = samples.map(({ rssBytes }) => rssBytes);
2627
+ const heap = samples.map(({ heapUsedBytes }) => heapUsedBytes);
2628
+ const rssSlope = exact ? theilSen(rss) : null;
2629
+ const heapSlope = exact ? theilSen(heap) : null;
2630
+ const rssGrowth = exact ? Math.max(0, rss.at(-1) - rss[0]) : null;
2631
+ const heapGrowth = exact ? Math.max(0, heap.at(-1) - heap[0]) : null;
2632
+ const rssPeak = exact ? Math.max(...rss) : null;
2633
+ const heapPeak = exact ? Math.max(...heap) : null;
2634
+ if (exact && rssGrowth > 67_108_864) firstInvalidPredicate = "rss-growth";
2635
+ else if (exact && heapGrowth > 33_554_432) firstInvalidPredicate = "heap-growth";
2636
+ else if (exact && rssPeak > ANSI_TUI_RSS_ABSOLUTE_CEILING_BYTES)
2637
+ firstInvalidPredicate = "rss-absolute-cap";
2638
+ else if (exact && heapPeak > ANSI_TUI_HEAP_ABSOLUTE_CEILING_BYTES)
2639
+ firstInvalidPredicate = "heap-absolute-cap";
2640
+ const qualified =
2641
+ exact &&
2642
+ fences.size === RESOURCE_ENDPOINT_COUNT &&
2643
+ daemonTraces.size === RESOURCE_ENDPOINT_COUNT &&
2644
+ daemonProcesses.size === 1 &&
2645
+ daemonClocks.size === 1 &&
2646
+ rssGrowth <= 67_108_864 &&
2647
+ heapGrowth <= 33_554_432 &&
2648
+ rssPeak <= ANSI_TUI_RSS_ABSOLUTE_CEILING_BYTES &&
2649
+ heapPeak <= ANSI_TUI_HEAP_ABSOLUTE_CEILING_BYTES;
2650
+ return Object.freeze({
2651
+ qualified,
2652
+ sampleCount: samples.length,
2653
+ rssSlopeBytesPerSample: rssSlope,
2654
+ heapSlopeBytesPerSample: heapSlope,
2655
+ rssGrowthBytes: rssGrowth,
2656
+ heapGrowthBytes: heapGrowth,
2657
+ rssPeakBytes: rssPeak,
2658
+ heapPeakBytes: heapPeak,
2659
+ firstInvalidEndpointOrdinal,
2660
+ firstInvalidPredicate: qualified ? null : firstInvalidPredicate,
2661
+ });
2662
+ }
2663
+
2664
+ export function assessAnsiIdleRetainedResourceSamples(samples, timing) {
2665
+ const countExact = Array.isArray(samples) && samples.length === 8;
2666
+ let exact = countExact;
2667
+ let firstInvalidOrdinal = countExact ? null : 1;
2668
+ let firstInvalidPredicate = countExact ? null : "idle-retained-cardinality";
2669
+ let previousAtMicros = -1;
2670
+ const timingExact =
2671
+ safeTimestamp(timing?.fenceAtMicros) &&
2672
+ safeTimestamp(timing?.endpointAtMicros) &&
2673
+ timing.endpointAtMicros >= timing.fenceAtMicros + 9_800_000 &&
2674
+ timing.endpointAtMicros <= timing.fenceAtMicros + 10_200_000;
2675
+ if (!timingExact) {
2676
+ exact = false;
2677
+ firstInvalidPredicate = "idle-retained-window";
2678
+ }
2679
+ for (let index = 0; countExact && index < samples.length; index += 1) {
2680
+ const sample = samples[index];
2681
+ const cadence = index === 0 ? null : sample?.atMicros - previousAtMicros;
2682
+ const shapeExact =
2683
+ exactKeys(sample, [
2684
+ "ordinal",
2685
+ "atMicros",
2686
+ "rssBytes",
2687
+ "heapUsedBytes",
2688
+ "inputPending",
2689
+ "inputInFlight",
2690
+ "inputPendingBytes",
2691
+ ]) &&
2692
+ sample?.ordinal === index + 1 &&
2693
+ safeTimestamp(sample?.atMicros) &&
2694
+ sample.atMicros > previousAtMicros &&
2695
+ sample.atMicros > timing?.fenceAtMicros &&
2696
+ sample.atMicros < timing?.endpointAtMicros &&
2697
+ (index !== 0 ||
2698
+ (sample.atMicros >= timing.fenceAtMicros + 1_800_000 &&
2699
+ sample.atMicros <= timing.fenceAtMicros + 2_200_000)) &&
2700
+ (index !== 7 ||
2701
+ (sample.atMicros >= timing.fenceAtMicros + 8_800_000 &&
2702
+ sample.atMicros <= timing.fenceAtMicros + 9_200_000)) &&
2703
+ (index === 0 || (cadence >= 900_000 && cadence <= 1_100_000)) &&
2704
+ Number.isSafeInteger(sample?.rssBytes) &&
2705
+ sample.rssBytes >= 0 &&
2706
+ Number.isSafeInteger(sample?.heapUsedBytes) &&
2707
+ sample.heapUsedBytes >= 0 &&
2708
+ sample?.inputPending === 0 &&
2709
+ sample?.inputInFlight === 0 &&
2710
+ sample?.inputPendingBytes === 0;
2711
+ if (!shapeExact && firstInvalidOrdinal === null) {
2712
+ firstInvalidOrdinal = index + 1;
2713
+ firstInvalidPredicate =
2714
+ sample?.ordinal !== index + 1
2715
+ ? "idle-retained-ordinal"
2716
+ : !safeTimestamp(sample?.atMicros) ||
2717
+ sample.atMicros <= previousAtMicros ||
2718
+ (index > 0 && (cadence < 900_000 || cadence > 1_100_000))
2719
+ ? "idle-retained-cadence"
2720
+ : sample.atMicros <= timing?.fenceAtMicros ||
2721
+ sample.atMicros >= timing?.endpointAtMicros ||
2722
+ (index === 0 &&
2723
+ (sample.atMicros < timing.fenceAtMicros + 1_800_000 ||
2724
+ sample.atMicros > timing.fenceAtMicros + 2_200_000)) ||
2725
+ (index === 7 &&
2726
+ (sample.atMicros < timing.fenceAtMicros + 8_800_000 ||
2727
+ sample.atMicros > timing.fenceAtMicros + 9_200_000))
2728
+ ? "idle-retained-window"
2729
+ : sample?.inputPending !== 0 ||
2730
+ sample?.inputInFlight !== 0 ||
2731
+ sample?.inputPendingBytes !== 0
2732
+ ? "idle-retained-queue"
2733
+ : "idle-retained-endpoint";
2734
+ }
2735
+ exact &&= shapeExact;
2736
+ if (safeTimestamp(sample?.atMicros)) previousAtMicros = sample.atMicros;
2737
+ }
2738
+ const rss = exact ? samples.map(({ rssBytes }) => rssBytes) : [];
2739
+ const heap = exact ? samples.map(({ heapUsedBytes }) => heapUsedBytes) : [];
2740
+ const rssSlope = exact ? theilSen(rss) : null;
2741
+ const heapSlope = exact ? theilSen(heap) : null;
2742
+ const rssGrowth = exact ? rss.at(-1) - rss[0] : null;
2743
+ const heapGrowth = exact ? heap.at(-1) - heap[0] : null;
2744
+ const rssHigh = exact ? Math.max(...rss) : null;
2745
+ const heapHigh = exact ? Math.max(...heap) : null;
2746
+ if (exact && rssSlope > 262_144) firstInvalidPredicate = "rss-slope";
2747
+ else if (exact && heapSlope > 131_072) firstInvalidPredicate = "heap-slope";
2748
+ else if (exact && rssGrowth > 67_108_864) firstInvalidPredicate = "idle-retained-rss-growth";
2749
+ else if (exact && heapGrowth > 33_554_432) firstInvalidPredicate = "idle-retained-heap-growth";
2750
+ else if (exact && rssHigh > ANSI_TUI_RSS_ABSOLUTE_CEILING_BYTES)
2751
+ firstInvalidPredicate = "idle-retained-rss-high";
2752
+ else if (exact && heapHigh > ANSI_TUI_HEAP_ABSOLUTE_CEILING_BYTES)
2753
+ firstInvalidPredicate = "idle-retained-heap-high";
2754
+ const qualified =
2755
+ exact &&
2756
+ rssSlope <= 262_144 &&
2757
+ heapSlope <= 131_072 &&
2758
+ rssGrowth <= 67_108_864 &&
2759
+ heapGrowth <= 33_554_432 &&
2760
+ rssHigh <= ANSI_TUI_RSS_ABSOLUTE_CEILING_BYTES &&
2761
+ heapHigh <= ANSI_TUI_HEAP_ABSOLUTE_CEILING_BYTES;
2762
+ return Object.freeze({
2763
+ qualified,
2764
+ sampleCount: Array.isArray(samples) ? samples.length : 0,
2765
+ rssSlopeBytesPerSample: rssSlope,
2766
+ heapSlopeBytesPerSample: heapSlope,
2767
+ rssGrowthBytes: rssGrowth,
2768
+ heapGrowthBytes: heapGrowth,
2769
+ rssHighBytes: rssHigh,
2770
+ heapHighBytes: heapHigh,
2771
+ firstInvalidOrdinal,
2772
+ firstInvalidPredicate: qualified ? null : firstInvalidPredicate,
2773
+ });
2774
+ }
2775
+
2776
+ export function assessAnsiResourceLifecycle(samples, expectedSamples) {
2777
+ if (
2778
+ !Array.isArray(samples) ||
2779
+ samples.length !== 26 ||
2780
+ !Array.isArray(expectedSamples) ||
2781
+ expectedSamples.length !== 26
2782
+ )
2783
+ return Object.freeze({
2784
+ qualified: false,
2785
+ sampleCount: Array.isArray(samples) ? samples.length : 0,
2786
+ });
2787
+ let previousOrdinal = 0;
2788
+ let previousAtMicros = -1;
2789
+ let previousRssPeak = 0;
2790
+ let previousHeapPeak = 0;
2791
+ let previousDelayPeak = 0;
2792
+ let resourceEpochIdentityHmac = null;
2793
+ let qualified = true;
2794
+ for (let index = 0; index < samples.length; index += 1) {
2795
+ const sample = samples[index];
2796
+ const phase = index === 0 ? "baseline" : index === 25 ? "idle" : "cycle";
2797
+ const cycle = index === 25 ? 25 : index;
2798
+ const expected = expectedSamples[index];
2799
+ qualified &&=
2800
+ exactKeys(expected, [
2801
+ "phase",
2802
+ "cycle",
2803
+ "operation",
2804
+ "resourceEpochIdentityHmac",
2805
+ "lowWaterFirstSampleOrdinal",
2806
+ "lowWaterLastSampleOrdinal",
2807
+ "lowWaterSampleCount",
2808
+ "identityHmac",
2809
+ "stateHmac",
2810
+ "processHmac",
2811
+ "clockId",
2812
+ ]) &&
2813
+ exactKeys(sample, [
2814
+ "phase",
2815
+ "cycle",
2816
+ "sampleOrdinal",
2817
+ "operation",
2818
+ "resourceEpochArmed",
2819
+ "resourceEpochIdentityHmac",
2820
+ "lowWaterFirstSampleOrdinal",
2821
+ "lowWaterLastSampleOrdinal",
2822
+ "lowWaterSampleCount",
2823
+ "lowWaterWindowMicros",
2824
+ "identityHmac",
2825
+ "stateHmac",
2826
+ "processHmac",
2827
+ "clockId",
2828
+ "clockKind",
2829
+ "atMicros",
2830
+ "rssBytes",
2831
+ "heapUsedBytes",
2832
+ "eventLoopDelayMicros",
2833
+ "rssPeakBytes",
2834
+ "heapUsedPeakBytes",
2835
+ "eventLoopDelayPeakMicros",
2836
+ "eventLoopDelayPeakSource",
2837
+ "inputPending",
2838
+ "inputInFlight",
2839
+ "inputPendingBytes",
2840
+ "inputPendingPeak",
2841
+ "inputInFlightPeak",
2842
+ "inputPendingBytesPeak",
2843
+ "resourceSamplingFailureCount",
2844
+ ]) &&
2845
+ sample?.phase === phase &&
2846
+ sample.phase === expected?.phase &&
2847
+ sample?.cycle === cycle &&
2848
+ sample.cycle === expected?.cycle &&
2849
+ sample?.operation === (phase === "idle" ? "idle" : "post-fence") &&
2850
+ sample.operation === expected?.operation &&
2851
+ sample?.resourceEpochArmed === true &&
2852
+ sample?.lowWaterFirstSampleOrdinal === 1 &&
2853
+ sample?.lowWaterLastSampleOrdinal === (phase === "idle" ? 1 : 8) &&
2854
+ sample?.lowWaterSampleCount === (phase === "idle" ? 1 : 8) &&
2855
+ sample?.lowWaterWindowMicros >= (phase === "idle" ? 0 : 40_000) &&
2856
+ sample?.lowWaterWindowMicros <= (phase === "idle" ? 0 : 2_000_000) &&
2857
+ sample.lowWaterFirstSampleOrdinal === expected?.lowWaterFirstSampleOrdinal &&
2858
+ sample.lowWaterLastSampleOrdinal === expected?.lowWaterLastSampleOrdinal &&
2859
+ sample.lowWaterSampleCount === expected?.lowWaterSampleCount &&
2860
+ SHA256.test(sample?.resourceEpochIdentityHmac ?? "") &&
2861
+ sample.resourceEpochIdentityHmac === expected?.resourceEpochIdentityHmac &&
2862
+ (index === 0 || sample.resourceEpochIdentityHmac === resourceEpochIdentityHmac) &&
2863
+ SHA256.test(sample?.identityHmac ?? "") &&
2864
+ sample.identityHmac === expected?.identityHmac &&
2865
+ SHA256.test(sample?.stateHmac ?? "") &&
2866
+ sample.stateHmac === expected?.stateHmac &&
2867
+ Number.isSafeInteger(sample?.sampleOrdinal) &&
2868
+ sample.sampleOrdinal > previousOrdinal &&
2869
+ sample.sampleOrdinal <= 512 &&
2870
+ sample?.processHmac === expected?.processHmac &&
2871
+ sample?.clockId === expected?.clockId &&
2872
+ sample?.clockKind === "performance-now" &&
2873
+ safeTimestamp(sample?.atMicros) &&
2874
+ sample.atMicros > previousAtMicros &&
2875
+ Number.isSafeInteger(sample?.rssBytes) &&
2876
+ sample.rssBytes >= 0 &&
2877
+ sample.rssBytes <= ANSI_TUI_RSS_ABSOLUTE_CEILING_BYTES &&
2878
+ Number.isSafeInteger(sample?.heapUsedBytes) &&
2879
+ sample.heapUsedBytes >= 0 &&
2880
+ sample.heapUsedBytes <= ANSI_TUI_HEAP_ABSOLUTE_CEILING_BYTES &&
2881
+ Number.isSafeInteger(sample?.eventLoopDelayMicros) &&
2882
+ sample.eventLoopDelayMicros >= 0 &&
2883
+ sample.eventLoopDelayMicros <= ANSI_TUI_EVENT_LOOP_CURRENT_ENDPOINT_CEILING_MICROS &&
2884
+ Number.isSafeInteger(sample?.rssPeakBytes) &&
2885
+ sample.rssPeakBytes >= Math.max(previousRssPeak, sample.rssBytes) &&
2886
+ sample.rssPeakBytes <= ANSI_TUI_RSS_ABSOLUTE_CEILING_BYTES &&
2887
+ Number.isSafeInteger(sample?.heapUsedPeakBytes) &&
2888
+ sample.heapUsedPeakBytes >= Math.max(previousHeapPeak, sample.heapUsedBytes) &&
2889
+ sample.heapUsedPeakBytes <= ANSI_TUI_HEAP_ABSOLUTE_CEILING_BYTES &&
2890
+ Number.isSafeInteger(sample?.eventLoopDelayPeakMicros) &&
2891
+ sample.eventLoopDelayPeakMicros >= Math.max(previousDelayPeak, sample.eventLoopDelayMicros) &&
2892
+ sample.eventLoopDelayPeakMicros <=
2893
+ ANSI_TUI_EVENT_LOOP_GENERATION_STICKY_PEAK_CEILING_MICROS &&
2894
+ new Set(["heartbeat", "endpoint"]).has(sample?.eventLoopDelayPeakSource) &&
2895
+ sample?.inputPending === 0 &&
2896
+ sample?.inputInFlight === 0 &&
2897
+ sample?.inputPendingBytes === 0 &&
2898
+ sample?.inputPendingPeak === 0 &&
2899
+ sample?.inputInFlightPeak === 0 &&
2900
+ sample?.inputPendingBytesPeak === 0;
2901
+ qualified &&= sample?.resourceSamplingFailureCount === 0;
2902
+ if (Number.isSafeInteger(sample?.sampleOrdinal)) previousOrdinal = sample.sampleOrdinal;
2903
+ if (safeTimestamp(sample?.atMicros)) previousAtMicros = sample.atMicros;
2904
+ if (Number.isSafeInteger(sample?.rssPeakBytes)) previousRssPeak = sample.rssPeakBytes;
2905
+ if (Number.isSafeInteger(sample?.heapUsedPeakBytes))
2906
+ previousHeapPeak = sample.heapUsedPeakBytes;
2907
+ if (Number.isSafeInteger(sample?.eventLoopDelayPeakMicros))
2908
+ previousDelayPeak = sample.eventLoopDelayPeakMicros;
2909
+ if (SHA256.test(sample?.resourceEpochIdentityHmac ?? "") && index === 0)
2910
+ resourceEpochIdentityHmac = sample.resourceEpochIdentityHmac;
2911
+ }
2912
+ return Object.freeze({ qualified, sampleCount: samples.length });
2913
+ }
2914
+
2915
+ export function assessAnsiCursorPresentationSamples(samples, expectedSamples) {
2916
+ if (!Array.isArray(samples) || samples.length !== ANSI_CURSOR_SAMPLE_COUNT)
2917
+ return Object.freeze({
2918
+ qualified: false,
2919
+ sampleCount: Array.isArray(samples) ? samples.length : 0,
2920
+ p95Micros: null,
2921
+ p99Micros: null,
2922
+ });
2923
+ const traces = new Set();
2924
+ const gestures = new Set();
2925
+ const daemonProcesses = new Set();
2926
+ const daemonClocks = new Set();
2927
+ const durations = [];
2928
+ let previousRevision = -1;
2929
+ let commonPresentationIdentity = null;
2930
+ let exact = true;
2931
+ for (let index = 0; index < samples.length; index += 1) {
2932
+ const sample = samples[index];
2933
+ const durationMicros = sample?.durationMicros;
2934
+ const causal = sample?.causal;
2935
+ const presentation = sample?.presentation;
2936
+ const frame = sample?.frame;
2937
+ const fence = sample?.fence;
2938
+ const expected = expectedSamples?.[index];
2939
+ exact &&=
2940
+ exactKeys(expected, [
2941
+ "ordinal",
2942
+ "action",
2943
+ "traceHmac",
2944
+ "gestureHmac",
2945
+ "daemonProcessHmac",
2946
+ "daemonClockId",
2947
+ "presentation",
2948
+ "cursor",
2949
+ ]) &&
2950
+ exactKeys(expected?.cursor, [
2951
+ "x",
2952
+ "y",
2953
+ "hidden",
2954
+ "canonicalStyle",
2955
+ "rendererStyle",
2956
+ "blink",
2957
+ ]) &&
2958
+ exactKeys(expected?.presentation, [
2959
+ "processHmac",
2960
+ "clockId",
2961
+ "clockKind",
2962
+ "paneHmac",
2963
+ "generationHmac",
2964
+ "incarnationHmac",
2965
+ "revision",
2966
+ "stateHmac",
2967
+ "presentationHmac",
2968
+ "canonicalCols",
2969
+ "canonicalRows",
2970
+ "viewportCols",
2971
+ "viewportRows",
2972
+ "sourceEpoch",
2973
+ "rendererEpoch",
2974
+ "gridWalked",
2975
+ "gridRowsRead",
2976
+ "fullWalk",
2977
+ "gridRowsReadTotal",
2978
+ "fullWalkTotal",
2979
+ "presentationCount",
2980
+ ]) &&
2981
+ exactKeys(sample, [
2982
+ "ordinal",
2983
+ "action",
2984
+ "traceHmac",
2985
+ "gestureHmac",
2986
+ "durationMicros",
2987
+ "startedAtMicros",
2988
+ "presentedAtMicros",
2989
+ "frameAtMicros",
2990
+ "fenceAtMicros",
2991
+ "causal",
2992
+ "cursor",
2993
+ "presentation",
2994
+ "frame",
2995
+ "fence",
2996
+ ]) &&
2997
+ exactKeys(causal, [
2998
+ "dirtyRows",
2999
+ "gridRowsReadDelta",
3000
+ "fullWalkDelta",
3001
+ "presentationCountDelta",
3002
+ "inputAccepted",
3003
+ "canonicalReceiptExact",
3004
+ "daemonStageCount",
3005
+ "daemonProcessHmac",
3006
+ "daemonClockId",
3007
+ ]) &&
3008
+ sample?.ordinal === index + 1 &&
3009
+ expected?.ordinal === index + 1 &&
3010
+ sample?.action === "cursor-next" &&
3011
+ expected?.action === "cursor-next" &&
3012
+ exactKeys(sample?.cursor, ["x", "y", "hidden", "canonicalStyle", "rendererStyle", "blink"]) &&
3013
+ sample.cursor.x === expected?.cursor?.x &&
3014
+ sample.cursor.y === expected?.cursor?.y &&
3015
+ sample.cursor.hidden === expected?.cursor?.hidden &&
3016
+ sample.cursor.canonicalStyle === expected?.cursor?.canonicalStyle &&
3017
+ sample.cursor.rendererStyle === expected?.cursor?.rendererStyle &&
3018
+ sample.cursor.blink === expected?.cursor?.blink &&
3019
+ safeMicros(durationMicros) &&
3020
+ SHA256.test(sample?.traceHmac ?? "") &&
3021
+ sample.traceHmac === expected?.traceHmac &&
3022
+ SHA256.test(sample?.gestureHmac ?? "") &&
3023
+ sample.gestureHmac === expected?.gestureHmac &&
3024
+ !traces.has(sample.traceHmac) &&
3025
+ !gestures.has(sample.gestureHmac) &&
3026
+ Array.isArray(causal?.dirtyRows) &&
3027
+ causal.dirtyRows.length === 0 &&
3028
+ causal?.gridRowsReadDelta === 0 &&
3029
+ causal?.fullWalkDelta === 0 &&
3030
+ causal?.presentationCountDelta === 1 &&
3031
+ causal?.inputAccepted === true &&
3032
+ causal?.canonicalReceiptExact === true &&
3033
+ causal?.daemonStageCount === ANSI_DAEMON_STAGES.length &&
3034
+ SHA256.test(causal?.daemonProcessHmac ?? "") &&
3035
+ causal.daemonProcessHmac === expected?.daemonProcessHmac &&
3036
+ boundedIdentity(causal?.daemonClockId) &&
3037
+ causal.daemonClockId === expected?.daemonClockId &&
3038
+ exactKeys(presentation, [
3039
+ "processHmac",
3040
+ "clockId",
3041
+ "clockKind",
3042
+ "paneHmac",
3043
+ "generationHmac",
3044
+ "incarnationHmac",
3045
+ "revision",
3046
+ "stateHmac",
3047
+ "presentationHmac",
3048
+ "canonicalCols",
3049
+ "canonicalRows",
3050
+ "viewportCols",
3051
+ "viewportRows",
3052
+ "sourceEpoch",
3053
+ "rendererEpoch",
3054
+ "gridWalked",
3055
+ "gridRowsRead",
3056
+ "fullWalk",
3057
+ "gridRowsReadTotal",
3058
+ "fullWalkTotal",
3059
+ "presentationCount",
3060
+ ]) &&
3061
+ exactIdentity(presentation, expected?.presentation) &&
3062
+ presentation.revision > previousRevision &&
3063
+ (commonPresentationIdentity === null ||
3064
+ (presentation.processHmac === commonPresentationIdentity.processHmac &&
3065
+ presentation.clockId === commonPresentationIdentity.clockId &&
3066
+ presentation.paneHmac === commonPresentationIdentity.paneHmac &&
3067
+ presentation.generationHmac === commonPresentationIdentity.generationHmac &&
3068
+ presentation.incarnationHmac === commonPresentationIdentity.incarnationHmac &&
3069
+ presentation.sourceEpoch === commonPresentationIdentity.sourceEpoch &&
3070
+ presentation.rendererEpoch === commonPresentationIdentity.rendererEpoch &&
3071
+ presentation.canonicalCols === commonPresentationIdentity.canonicalCols &&
3072
+ presentation.canonicalRows === commonPresentationIdentity.canonicalRows &&
3073
+ presentation.viewportCols === commonPresentationIdentity.viewportCols &&
3074
+ presentation.viewportRows === commonPresentationIdentity.viewportRows)) &&
3075
+ presentation?.gridWalked === false &&
3076
+ presentation?.gridRowsRead === 0 &&
3077
+ presentation?.fullWalk === false &&
3078
+ Number.isSafeInteger(presentation?.gridRowsReadTotal) &&
3079
+ presentation.gridRowsReadTotal === expected?.presentation?.gridRowsReadTotal &&
3080
+ Number.isSafeInteger(presentation?.fullWalkTotal) &&
3081
+ presentation.fullWalkTotal === expected?.presentation?.fullWalkTotal &&
3082
+ Number.isSafeInteger(presentation?.presentationCount) &&
3083
+ presentation.presentationCount === expected?.presentation?.presentationCount &&
3084
+ exactKeys(frame, [
3085
+ "processHmac",
3086
+ "clockId",
3087
+ "clockKind",
3088
+ "paneHmac",
3089
+ "generationHmac",
3090
+ "incarnationHmac",
3091
+ "revision",
3092
+ "stateHmac",
3093
+ "presentationHmac",
3094
+ "canonicalCols",
3095
+ "canonicalRows",
3096
+ "viewportCols",
3097
+ "viewportRows",
3098
+ "sourceEpoch",
3099
+ "rendererEpoch",
3100
+ ]) &&
3101
+ exactIdentity(frame, expected?.presentation) &&
3102
+ exactKeys(fence, [
3103
+ "processHmac",
3104
+ "clockId",
3105
+ "clockKind",
3106
+ "paneHmac",
3107
+ "generationHmac",
3108
+ "incarnationHmac",
3109
+ "revision",
3110
+ "stateHmac",
3111
+ "presentationHmac",
3112
+ "canonicalCols",
3113
+ "canonicalRows",
3114
+ "viewportCols",
3115
+ "viewportRows",
3116
+ "sourceEpoch",
3117
+ "rendererEpoch",
3118
+ ]) &&
3119
+ exactIdentity(fence, expected?.presentation) &&
3120
+ presentation.revision === frame.revision &&
3121
+ frame.revision === fence.revision &&
3122
+ presentation.presentationHmac === frame.presentationHmac &&
3123
+ frame.presentationHmac === fence.presentationHmac &&
3124
+ safeTimestamp(sample?.startedAtMicros) &&
3125
+ safeTimestamp(sample?.presentedAtMicros) &&
3126
+ safeTimestamp(sample?.frameAtMicros) &&
3127
+ safeTimestamp(sample?.fenceAtMicros) &&
3128
+ sample.startedAtMicros <= sample.presentedAtMicros &&
3129
+ sample.presentedAtMicros <= sample.frameAtMicros &&
3130
+ sample.frameAtMicros <= sample.fenceAtMicros &&
3131
+ durationMicros === sample.fenceAtMicros - sample.startedAtMicros;
3132
+ if (SHA256.test(sample?.traceHmac ?? "")) traces.add(sample.traceHmac);
3133
+ if (SHA256.test(sample?.gestureHmac ?? "")) gestures.add(sample.gestureHmac);
3134
+ if (SHA256.test(causal?.daemonProcessHmac ?? "")) daemonProcesses.add(causal.daemonProcessHmac);
3135
+ if (boundedIdentity(causal?.daemonClockId)) daemonClocks.add(causal.daemonClockId);
3136
+ if (safeMicros(durationMicros)) durations.push(durationMicros);
3137
+ if (Number.isSafeInteger(presentation?.revision)) previousRevision = presentation.revision;
3138
+ commonPresentationIdentity ??= presentation;
3139
+ }
3140
+ const sorted = durations.slice().sort((left, right) => left - right);
3141
+ const p95Micros = durations.length === ANSI_CURSOR_SAMPLE_COUNT ? percentile(sorted, 0.95) : null;
3142
+ const p99Micros = durations.length === ANSI_CURSOR_SAMPLE_COUNT ? percentile(sorted, 0.99) : null;
3143
+ return Object.freeze({
3144
+ qualified:
3145
+ exact &&
3146
+ daemonProcesses.size === 1 &&
3147
+ daemonClocks.size === 1 &&
3148
+ p95Micros !== null &&
3149
+ p95Micros <= ANSI_CURSOR_P95_BUDGET_MICROS &&
3150
+ p99Micros !== null &&
3151
+ p99Micros <= ANSI_CURSOR_P99_BUDGET_MICROS,
3152
+ sampleCount: samples.length,
3153
+ p95Micros,
3154
+ p99Micros,
3155
+ });
3156
+ }
3157
+
3158
+ export function ansiCursorWebEvidence(web, expected) {
3159
+ const readiness = web?.readiness;
3160
+ const normalized = readiness?.normalized;
3161
+ const stages = Array.isArray(web?.presentations) ? web.presentations : [];
3162
+ const expectedStages = ["normal", "rich", "cursor-only", "alternate", "restored"];
3163
+ const stageExact =
3164
+ stages.length === expectedStages.length &&
3165
+ stages.every(
3166
+ (stage, index) =>
3167
+ exactKeys(expected?.presentations?.[index], [
3168
+ "generationHmac",
3169
+ "incarnationHmac",
3170
+ "stateHmac",
3171
+ "deliveryRequestHmacs",
3172
+ "revision",
3173
+ "sourceEpoch",
3174
+ "activeBuffer",
3175
+ "cursorX",
3176
+ "cursorY",
3177
+ "cursorHidden",
3178
+ "cursorStyle",
3179
+ "canonicalCursorStyle",
3180
+ "cursorBlink",
3181
+ "cols",
3182
+ "rows",
3183
+ "renditionHmac",
3184
+ "positionWrappedHmac",
3185
+ "renditionCellCount",
3186
+ "wideContinuationCount",
3187
+ "combiningCount",
3188
+ "styledCellCount",
3189
+ "gridRowsRead",
3190
+ "gridCellsRead",
3191
+ "fullGridWalks",
3192
+ "rendererEpoch",
3193
+ "rendererCols",
3194
+ "rendererRows",
3195
+ ]) &&
3196
+ exactKeys(stage, [
3197
+ "stage",
3198
+ "semanticPaneHmac",
3199
+ "generationHmac",
3200
+ "incarnationHmac",
3201
+ "stateHmac",
3202
+ "deliveryRequestHmac",
3203
+ "domRowsHmac",
3204
+ "domCursorHmac",
3205
+ "domSemanticExact",
3206
+ "domRowCountExact",
3207
+ "domTextExact",
3208
+ "domStyleExact",
3209
+ "domFirstMismatchRow",
3210
+ "domFirstMismatchColumn",
3211
+ "domFirstMismatchComponent",
3212
+ "domCursorExact",
3213
+ "renditionHmac",
3214
+ "positionWrappedHmac",
3215
+ "renditionCellCount",
3216
+ "wideContinuationCount",
3217
+ "combiningCount",
3218
+ "styledCellCount",
3219
+ "rowCount",
3220
+ "cursorCount",
3221
+ "cursorVisible",
3222
+ "activeBuffer",
3223
+ "cursorX",
3224
+ "cursorY",
3225
+ "cursorHidden",
3226
+ "cursorStyle",
3227
+ "cursorBlink",
3228
+ "revision",
3229
+ "sourceEpoch",
3230
+ "rendererEpoch",
3231
+ "rendererCols",
3232
+ "rendererRows",
3233
+ "cols",
3234
+ "rows",
3235
+ "gridRowsRead",
3236
+ "gridCellsRead",
3237
+ "fullGridWalks",
3238
+ "canonicalBuffer",
3239
+ "canonicalCursorX",
3240
+ "canonicalCursorY",
3241
+ "canonicalCursorHidden",
3242
+ "canonicalCursorStyle",
3243
+ "canonicalCursorBlink",
3244
+ "stableSamples",
3245
+ ]) &&
3246
+ stage?.stage === expectedStages[index] &&
3247
+ stage?.semanticPaneHmac === expected?.semanticPaneHmac &&
3248
+ stage?.generationHmac === expected?.presentations?.[index]?.generationHmac &&
3249
+ stage?.incarnationHmac === expected?.presentations?.[index]?.incarnationHmac &&
3250
+ stage?.stateHmac === expected?.presentations?.[index]?.stateHmac &&
3251
+ Array.isArray(expected?.presentations?.[index]?.deliveryRequestHmacs) &&
3252
+ expected.presentations[index].deliveryRequestHmacs.length >= 1 &&
3253
+ expected.presentations[index].deliveryRequestHmacs.length <= 16 &&
3254
+ expected.presentations[index].deliveryRequestHmacs.every((value) => SHA256.test(value)) &&
3255
+ new Set(expected.presentations[index].deliveryRequestHmacs).size ===
3256
+ expected.presentations[index].deliveryRequestHmacs.length &&
3257
+ SHA256.test(stage?.deliveryRequestHmac ?? "") &&
3258
+ expected.presentations[index].deliveryRequestHmacs.includes(stage.deliveryRequestHmac) &&
3259
+ stage?.renditionHmac === expected?.presentations?.[index]?.renditionHmac &&
3260
+ stage?.positionWrappedHmac === expected?.presentations?.[index]?.positionWrappedHmac &&
3261
+ SHA256.test(stage?.domRowsHmac ?? "") &&
3262
+ SHA256.test(stage?.domCursorHmac ?? "") &&
3263
+ stage?.domSemanticExact === true &&
3264
+ stage?.domRowCountExact === true &&
3265
+ stage?.domTextExact === true &&
3266
+ stage?.domStyleExact === true &&
3267
+ stage?.domFirstMismatchRow === null &&
3268
+ stage?.domFirstMismatchColumn === null &&
3269
+ stage?.domFirstMismatchComponent === null &&
3270
+ stage?.domCursorExact === true &&
3271
+ stage?.renditionCellCount === expected?.presentations?.[index]?.renditionCellCount &&
3272
+ stage?.wideContinuationCount === expected?.presentations?.[index]?.wideContinuationCount &&
3273
+ stage?.combiningCount === expected?.presentations?.[index]?.combiningCount &&
3274
+ stage?.styledCellCount === expected?.presentations?.[index]?.styledCellCount &&
3275
+ stage?.revision === expected?.presentations?.[index]?.revision &&
3276
+ stage?.sourceEpoch === expected?.presentations?.[index]?.sourceEpoch &&
3277
+ stage?.rendererEpoch === expected?.presentations?.[index]?.rendererEpoch &&
3278
+ stage?.rendererCols === expected?.presentations?.[index]?.rendererCols &&
3279
+ stage?.rendererRows === expected?.presentations?.[index]?.rendererRows &&
3280
+ stage?.rendererCols === expected?.presentations?.[index]?.cols &&
3281
+ stage?.rendererRows === expected?.presentations?.[index]?.rows &&
3282
+ stage?.cols === expected?.presentations?.[index]?.cols &&
3283
+ stage?.rows === expected?.presentations?.[index]?.rows &&
3284
+ stage?.stableSamples === 2 &&
3285
+ stage?.activeBuffer === expected?.presentations?.[index]?.activeBuffer &&
3286
+ stage?.cursorX === expected?.presentations?.[index]?.cursorX &&
3287
+ stage?.cursorY === expected?.presentations?.[index]?.cursorY &&
3288
+ stage?.cursorHidden === expected?.presentations?.[index]?.cursorHidden &&
3289
+ stage?.cursorStyle === expected?.presentations?.[index]?.cursorStyle &&
3290
+ stage?.cursorBlink === expected?.presentations?.[index]?.cursorBlink &&
3291
+ stage?.canonicalBuffer === expected?.presentations?.[index]?.activeBuffer &&
3292
+ stage?.canonicalCursorX === expected?.presentations?.[index]?.cursorX &&
3293
+ stage?.canonicalCursorY === expected?.presentations?.[index]?.cursorY &&
3294
+ stage?.canonicalCursorHidden === expected?.presentations?.[index]?.cursorHidden &&
3295
+ stage?.canonicalCursorStyle === expected?.presentations?.[index]?.canonicalCursorStyle &&
3296
+ stage?.canonicalCursorBlink === expected?.presentations?.[index]?.cursorBlink &&
3297
+ stage?.gridRowsRead === expected?.presentations?.[index]?.gridRowsRead &&
3298
+ stage?.gridCellsRead === expected?.presentations?.[index]?.gridCellsRead &&
3299
+ stage?.fullGridWalks === expected?.presentations?.[index]?.fullGridWalks &&
3300
+ stage?.cursorVisible === !expected?.presentations?.[index]?.cursorHidden &&
3301
+ Number.isSafeInteger(stage?.rowCount) &&
3302
+ stage.rowCount > 0 &&
3303
+ stage.rowCount <= 4_096 &&
3304
+ stage?.cursorCount === (expected?.presentations?.[index]?.cursorHidden ? 0 : 1),
3305
+ );
3306
+ const sameCanonicalCursor = (left, right) =>
3307
+ left?.canonicalCursorX === right?.canonicalCursorX &&
3308
+ left?.canonicalCursorY === right?.canonicalCursorY &&
3309
+ left?.canonicalCursorHidden === right?.canonicalCursorHidden &&
3310
+ left?.canonicalCursorStyle === right?.canonicalCursorStyle &&
3311
+ left?.canonicalCursorBlink === right?.canonicalCursorBlink &&
3312
+ left?.cursorVisible === right?.cursorVisible &&
3313
+ left?.cursorCount === right?.cursorCount;
3314
+ const restorationPredicates = Object.freeze({
3315
+ normalRestoredDomRenditionExact:
3316
+ SHA256.test(stages[0]?.domRowsHmac ?? "") &&
3317
+ stages[0]?.domRowsHmac === stages[4]?.domRowsHmac,
3318
+ normalRestoredSemanticRenditionExact:
3319
+ SHA256.test(stages[0]?.renditionHmac ?? "") &&
3320
+ stages[0]?.renditionHmac === stages[4]?.renditionHmac &&
3321
+ stages[0]?.positionWrappedHmac === stages[4]?.positionWrappedHmac,
3322
+ normalRestoredCanonicalCursorExact: sameCanonicalCursor(stages[0], stages[4]),
3323
+ normalRestoredDomCursorExact:
3324
+ SHA256.test(stages[0]?.domCursorHmac ?? "") &&
3325
+ stages[0]?.domCursorHmac === stages[4]?.domCursorHmac,
3326
+ normalBufferExact:
3327
+ stages[0]?.activeBuffer === "normal" &&
3328
+ stages[0]?.canonicalBuffer === "normal" &&
3329
+ stages[4]?.activeBuffer === "normal" &&
3330
+ stages[4]?.canonicalBuffer === "normal",
3331
+ richDomDistinctFromNormalExact: stages[1]?.domRowsHmac !== stages[0]?.domRowsHmac,
3332
+ richCursorDomRenditionExact:
3333
+ SHA256.test(stages[1]?.domRowsHmac ?? "") &&
3334
+ stages[1]?.domRowsHmac === stages[2]?.domRowsHmac,
3335
+ richCursorSemanticRenditionExact:
3336
+ SHA256.test(stages[1]?.renditionHmac ?? "") &&
3337
+ stages[1]?.renditionHmac === stages[2]?.renditionHmac &&
3338
+ stages[1]?.positionWrappedHmac === stages[2]?.positionWrappedHmac,
3339
+ cursorOnlyZeroGridExact:
3340
+ stages[2]?.gridRowsRead === 0 &&
3341
+ stages[2]?.gridCellsRead === 0 &&
3342
+ stages[2]?.fullGridWalks === 0,
3343
+ richCursorDistinctExact:
3344
+ !sameCanonicalCursor(stages[1], stages[2]) &&
3345
+ SHA256.test(stages[1]?.domCursorHmac ?? "") &&
3346
+ SHA256.test(stages[2]?.domCursorHmac ?? "") &&
3347
+ stages[1]?.domCursorHmac !== stages[2]?.domCursorHmac,
3348
+ alternateSemanticDistinct:
3349
+ SHA256.test(stages[3]?.renditionHmac ?? "") &&
3350
+ stages[3]?.renditionHmac !== stages[1]?.renditionHmac &&
3351
+ stages[3]?.domRowsHmac !== stages[1]?.domRowsHmac,
3352
+ alternateBufferHiddenExact:
3353
+ stages[3]?.activeBuffer === "alternate" &&
3354
+ stages[3]?.canonicalBuffer === "alternate" &&
3355
+ stages[3]?.canonicalCursorHidden === true &&
3356
+ stages[3]?.cursorVisible === false &&
3357
+ stages[3]?.cursorCount === 0,
3358
+ rendererCanonicalDimensionsExact: stages.every(
3359
+ (stage) =>
3360
+ stage?.rendererCols === stage?.cols &&
3361
+ stage?.rendererRows === stage?.rows &&
3362
+ Number.isSafeInteger(stage?.cols) &&
3363
+ Number.isSafeInteger(stage?.rows),
3364
+ ),
3365
+ });
3366
+ const firstFailedRestorationPredicate =
3367
+ Object.entries(restorationPredicates).find(([, exact]) => exact !== true)?.[0] ?? null;
3368
+ const restorationExact = firstFailedRestorationPredicate === null;
3369
+ const readinessExact = readiness?.qualified === true && web?.stableExactSamples === 2;
3370
+ const topologyExact =
3371
+ normalized?.expectedGroupCount === 1 &&
3372
+ normalized?.observedTerminalCount === 1 &&
3373
+ normalized?.terminalExact === true;
3374
+ return Object.freeze({
3375
+ qualified:
3376
+ exactKeys(web, ["readiness", "stableExactSamples", "presentations"]) &&
3377
+ exactKeys(expected, ["semanticPaneHmac", "presentations"]) &&
3378
+ readinessExact &&
3379
+ topologyExact &&
3380
+ SHA256.test(expected?.semanticPaneHmac ?? "") &&
3381
+ Array.isArray(expected?.presentations) &&
3382
+ expected.presentations.length === expectedStages.length &&
3383
+ stageExact &&
3384
+ restorationExact,
3385
+ stableExactSamples: Number.isSafeInteger(web?.stableExactSamples)
3386
+ ? web.stableExactSamples
3387
+ : null,
3388
+ stageCount: Math.min(stages.length, 6),
3389
+ readinessExact,
3390
+ topologyExact,
3391
+ stageExact,
3392
+ restorationExact,
3393
+ restorationPredicates,
3394
+ firstFailedRestorationPredicate,
3395
+ });
3396
+ }
3397
+
3398
+ export function ansiWebExpectedGridProjection(stage, driven) {
3399
+ const canonicalRows = driven?.stage?.canonicalRows;
3400
+ const canonicalCols = driven?.stage?.canonicalCols;
3401
+ const rawRows = driven?.raw?.presentation?.gridRowsRead;
3402
+ const sealedRows = driven?.sample?.presentation?.gridRowsRead;
3403
+ const stageExact = new Set(["normal", "rich", "cursor-only", "alternate", "restored"]).has(stage);
3404
+ if (driven?.qualified !== true)
3405
+ return Object.freeze({
3406
+ exact: false,
3407
+ reason: "qualified-stage",
3408
+ canonicalRows: null,
3409
+ canonicalCols: null,
3410
+ presentationRows: null,
3411
+ gridRowsRead: null,
3412
+ gridCellsRead: null,
3413
+ fullGridWalks: null,
3414
+ });
3415
+ const canonicalExact =
3416
+ Number.isSafeInteger(canonicalRows) &&
3417
+ canonicalRows > 0 &&
3418
+ canonicalRows <= 4_096 &&
3419
+ Number.isSafeInteger(canonicalCols) &&
3420
+ canonicalCols > 0 &&
3421
+ canonicalCols <= 4_096;
3422
+ const presentationExact =
3423
+ Number.isSafeInteger(rawRows) &&
3424
+ rawRows >= 0 &&
3425
+ rawRows <= 4_096 &&
3426
+ rawRows === sealedRows &&
3427
+ canonicalExact &&
3428
+ rawRows <= canonicalRows;
3429
+ if (!stageExact)
3430
+ return Object.freeze({
3431
+ exact: false,
3432
+ reason: "stage",
3433
+ canonicalRows: null,
3434
+ canonicalCols: null,
3435
+ presentationRows: null,
3436
+ gridRowsRead: null,
3437
+ gridCellsRead: null,
3438
+ fullGridWalks: null,
3439
+ });
3440
+ if (!canonicalExact)
3441
+ return Object.freeze({
3442
+ exact: false,
3443
+ reason: "canonical-geometry",
3444
+ canonicalRows: Number.isSafeInteger(canonicalRows) ? canonicalRows : null,
3445
+ canonicalCols: Number.isSafeInteger(canonicalCols) ? canonicalCols : null,
3446
+ presentationRows: null,
3447
+ gridRowsRead: null,
3448
+ gridCellsRead: null,
3449
+ fullGridWalks: null,
3450
+ });
3451
+ if (!presentationExact)
3452
+ return Object.freeze({
3453
+ exact: false,
3454
+ reason: "presentation-rows",
3455
+ canonicalRows,
3456
+ canonicalCols,
3457
+ presentationRows:
3458
+ Number.isSafeInteger(rawRows) && rawRows >= 0 && rawRows <= 4_096 ? rawRows : null,
3459
+ gridRowsRead: null,
3460
+ gridCellsRead: null,
3461
+ fullGridWalks: null,
3462
+ });
3463
+ const fullGridWalk = stage === "alternate" || stage === "restored";
3464
+ const gridRowsRead = fullGridWalk ? canonicalRows : rawRows;
3465
+ const gridCellsRead = gridRowsRead * canonicalCols;
3466
+ if (!Number.isSafeInteger(gridCellsRead))
3467
+ return Object.freeze({
3468
+ exact: false,
3469
+ reason: "cell-overflow",
3470
+ canonicalRows,
3471
+ canonicalCols,
3472
+ presentationRows: rawRows,
3473
+ gridRowsRead: null,
3474
+ gridCellsRead: null,
3475
+ fullGridWalks: null,
3476
+ });
3477
+ return Object.freeze({
3478
+ exact: true,
3479
+ reason: null,
3480
+ canonicalRows,
3481
+ canonicalCols,
3482
+ presentationRows: rawRows,
3483
+ gridRowsRead,
3484
+ gridCellsRead,
3485
+ fullGridWalks: fullGridWalk ? 1 : 0,
3486
+ });
3487
+ }
3488
+
3489
+ export function ansiRenditionFailureLocalization(candidate, expected) {
3490
+ const hmac = (value) => (typeof value === "string" && SHA256.test(value) ? value : null);
3491
+ const expectedCells = Array.isArray(expected?.cellHmacs) ? expected.cellHmacs : null;
3492
+ const actualCells = Array.isArray(candidate?.cellHmacs)
3493
+ ? candidate.cellHmacs.slice(0, 256).map(hmac)
3494
+ : null;
3495
+ const expectedRows = Array.isArray(expected?.rows) ? expected.rows : null;
3496
+ let firstDifferenceOrdinal = null;
3497
+ if (
3498
+ expectedCells &&
3499
+ expectedCells.length <= 256 &&
3500
+ expectedCells.every((value) => hmac(value) === value) &&
3501
+ actualCells
3502
+ ) {
3503
+ const ordinal = expectedCells.findIndex((value, index) => actualCells[index] !== value);
3504
+ if (ordinal >= 0) firstDifferenceOrdinal = ordinal;
3505
+ else if (actualCells.length !== expectedCells.length)
3506
+ firstDifferenceOrdinal = Math.min(actualCells.length, expectedCells.length);
3507
+ }
3508
+ const differenceRow =
3509
+ firstDifferenceOrdinal !== null &&
3510
+ expectedRows &&
3511
+ Number.isSafeInteger(expectedRows[firstDifferenceOrdinal]) &&
3512
+ expectedRows[firstDifferenceOrdinal] >= 0 &&
3513
+ expectedRows[firstDifferenceOrdinal] <= 4095
3514
+ ? expectedRows[firstDifferenceOrdinal]
3515
+ : null;
3516
+ const dimension = (value) =>
3517
+ Number.isSafeInteger(value) && value >= 1 && value <= 4096 ? value : null;
3518
+ const componentExact = (actual, required) => {
3519
+ const expectedHmac = hmac(required);
3520
+ return expectedHmac !== null && hmac(actual) === expectedHmac;
3521
+ };
3522
+ return Object.freeze({
3523
+ positionWrappedExact: componentExact(
3524
+ candidate?.positionWrappedHmac,
3525
+ expected?.positionWrappedHmac,
3526
+ ),
3527
+ graphemeWidthExact: componentExact(candidate?.graphemeWidthHmac, expected?.graphemeWidthHmac),
3528
+ colorExact: componentExact(candidate?.colorHmac, expected?.colorHmac),
3529
+ attributesExact: componentExact(candidate?.attributesHmac, expected?.attributesHmac),
3530
+ firstDifferenceOrdinal,
3531
+ firstDifferenceRow: differenceRow,
3532
+ rendererCols: dimension(candidate?.rendererCols),
3533
+ rendererRows: dimension(candidate?.rendererRows),
3534
+ });
3535
+ }
3536
+
3537
+ /** Browser-side observation hashes actual xterm DOM rows/cursor before crossing realms. */
3538
+ export async function captureAnsiCursorWebPresentation(
3539
+ page,
3540
+ { keyHex, stage, semanticPaneId, expectedRendition, expectedCursor },
3541
+ ) {
3542
+ if (
3543
+ !/^[0-9a-f]{64}$/u.test(keyHex) ||
3544
+ !boundedIdentity(stage) ||
3545
+ !boundedIdentity(semanticPaneId) ||
3546
+ !Array.isArray(expectedRendition) ||
3547
+ expectedRendition.length > 256 ||
3548
+ !expectedRendition.every(
3549
+ (cell) =>
3550
+ Number.isSafeInteger(cell?.row) &&
3551
+ cell.row >= 0 &&
3552
+ cell.row <= 4_095 &&
3553
+ Number.isSafeInteger(cell?.column) &&
3554
+ cell.column >= 0 &&
3555
+ cell.column <= 4_095 &&
3556
+ typeof cell?.chars === "string" &&
3557
+ cell.chars.length <= 4_096 &&
3558
+ new Set([0, 1, 2]).has(cell?.width) &&
3559
+ typeof cell?.foreground === "string" &&
3560
+ typeof cell?.background === "string" &&
3561
+ typeof cell?.bold === "boolean" &&
3562
+ typeof cell?.italic === "boolean" &&
3563
+ typeof cell?.underline === "boolean",
3564
+ ) ||
3565
+ !expectedCursor ||
3566
+ !Number.isSafeInteger(expectedCursor.x) ||
3567
+ !Number.isSafeInteger(expectedCursor.y) ||
3568
+ expectedCursor.x < 0 ||
3569
+ expectedCursor.y < 0 ||
3570
+ expectedCursor.x > 4_095 ||
3571
+ expectedCursor.y > 4_095 ||
3572
+ !new Set(["block", "bar", "underline"]).has(expectedCursor.style) ||
3573
+ typeof expectedCursor.hidden !== "boolean" ||
3574
+ typeof expectedCursor.blink !== "boolean"
3575
+ )
3576
+ throw new TypeError("ANSI Web presentation request was malformed");
3577
+ return page.evaluate(
3578
+ async ({ evidenceKey, expectedStage, expectedPane, expectedCells, expectedDomCursor }) => {
3579
+ const bytes = (hex) =>
3580
+ new Uint8Array(hex.match(/.{2}/gu)?.map((value) => Number.parseInt(value, 16)) ?? []);
3581
+ const hmac = async (domain, value) => {
3582
+ const key = await crypto.subtle.importKey(
3583
+ "raw",
3584
+ bytes(evidenceKey),
3585
+ { name: "HMAC", hash: "SHA-256" },
3586
+ false,
3587
+ ["sign"],
3588
+ );
3589
+ const digest = await crypto.subtle.sign(
3590
+ "HMAC",
3591
+ key,
3592
+ new TextEncoder().encode(`${domain}\0${value}`),
3593
+ );
3594
+ return [...new Uint8Array(digest)]
3595
+ .map((value) => value.toString(16).padStart(2, "0"))
3596
+ .join("");
3597
+ };
3598
+ const probe = globalThis.__TMUX_IDE_PROBE_TERMINAL_RENDITION__;
3599
+ const diagnostic =
3600
+ typeof probe === "function" ? await probe(expectedPane, evidenceKey) : null;
3601
+ const surface = diagnostic?.surface ?? null;
3602
+ if (
3603
+ !(surface instanceof globalThis.HTMLElement) ||
3604
+ surface.getAttribute("data-phase") !== "connected" ||
3605
+ surface.getAttribute("data-semantic-pane-id") !== expectedPane
3606
+ )
3607
+ return null;
3608
+ const rows = [...surface.querySelectorAll(".xterm-rows > div")];
3609
+ const allCursors = [...surface.querySelectorAll(".xterm-cursor")];
3610
+ const cursors = allCursors.filter((cursor) => {
3611
+ const style = globalThis.getComputedStyle(cursor);
3612
+ const rect = cursor.getBoundingClientRect();
3613
+ return (
3614
+ style.display !== "none" &&
3615
+ style.visibility !== "hidden" &&
3616
+ Number(style.opacity) > 0 &&
3617
+ rect.width > 0 &&
3618
+ rect.height > 0
3619
+ );
3620
+ });
3621
+ const cursor = cursors[0] ?? null;
3622
+ const cursorRect = cursor?.getBoundingClientRect();
3623
+ const rendition = diagnostic?.rendition ?? null;
3624
+ const presentation = diagnostic?.presentation ?? null;
3625
+ const canonical = diagnostic?.canonical ?? null;
3626
+ const normalizedStyle = (element) => {
3627
+ const style = globalThis.getComputedStyle(element);
3628
+ return Object.freeze({
3629
+ color: style.color,
3630
+ backgroundColor: style.backgroundColor,
3631
+ fontWeight: style.fontWeight,
3632
+ fontStyle: style.fontStyle,
3633
+ textDecorationLine: style.textDecorationLine,
3634
+ });
3635
+ };
3636
+ const semanticCellStyle = (element) => {
3637
+ const cursorCell = element.closest(".xterm-cursor");
3638
+ if (!cursorCell || !cursorCell.parentElement) return normalizedStyle(element);
3639
+ // The DOM renderer puts both cursor paint classes and the original
3640
+ // cell's color/attribute classes on one span. Measure a same-parent
3641
+ // clone with only cursor-owned classes removed, preserving every cell
3642
+ // class and inline style without mutating the live cursor node.
3643
+ const semanticClone = cursorCell.cloneNode(false);
3644
+ for (const name of [...semanticClone.classList])
3645
+ if (name.startsWith("xterm-cursor")) semanticClone.classList.remove(name);
3646
+ cursorCell.parentElement.insertBefore(semanticClone, cursorCell);
3647
+ const style = normalizedStyle(semanticClone);
3648
+ semanticClone.remove();
3649
+ return style;
3650
+ };
3651
+ const cssColor = (value) => {
3652
+ const serialized = String(value).trim();
3653
+ if (serialized === "transparent") return { rgb: [0, 0, 0], alpha: 0 };
3654
+ const hex = serialized.match(/^#([0-9a-f]{3}|[0-9a-f]{6})$/iu)?.[1];
3655
+ if (hex) {
3656
+ const expanded =
3657
+ hex.length === 3 ? [...hex].map((digit) => `${digit}${digit}`).join("") : hex;
3658
+ return {
3659
+ rgb: [
3660
+ Number.parseInt(expanded.slice(0, 2), 16),
3661
+ Number.parseInt(expanded.slice(2, 4), 16),
3662
+ Number.parseInt(expanded.slice(4, 6), 16),
3663
+ ],
3664
+ alpha: 1,
3665
+ };
3666
+ }
3667
+ const match = serialized.match(
3668
+ /^rgba?\(\s*(\d+)\s*(?:,\s*|\s+)(\d+)\s*(?:,\s*|\s+)(\d+)(?:\s*(?:,|\/)\s*(\d*\.?\d+%?))?\s*\)$/u,
3669
+ );
3670
+ if (!match) return null;
3671
+ const alpha = match[4]?.endsWith("%")
3672
+ ? Number(match[4].slice(0, -1)) / 100
3673
+ : Number(match[4] ?? 1);
3674
+ if (!Number.isFinite(alpha) || alpha < 0 || alpha > 1) return null;
3675
+ return { rgb: [Number(match[1]), Number(match[2]), Number(match[3])], alpha };
3676
+ };
3677
+ const rgb = (value) => cssColor(value)?.rgb ?? null;
3678
+ const indexed = (index) => {
3679
+ if (!Number.isSafeInteger(index) || index < 16 || index > 255) return null;
3680
+ if (index >= 232) {
3681
+ const value = 8 + (index - 232) * 10;
3682
+ return [value, value, value];
3683
+ }
3684
+ const level = [0, 95, 135, 175, 215, 255];
3685
+ const offset = index - 16;
3686
+ return [
3687
+ level[Math.floor(offset / 36)],
3688
+ level[Math.floor((offset % 36) / 6)],
3689
+ level[offset % 6],
3690
+ ];
3691
+ };
3692
+ const colorExact = (actual, expected, fallback, background = false) => {
3693
+ const parsedActual = cssColor(actual);
3694
+ const parsedFallback = cssColor(fallback);
3695
+ if (!parsedActual || !parsedFallback || parsedFallback.alpha !== 1) return false;
3696
+ const defaultTransparentBackground =
3697
+ expected === "default" && background && parsedActual.alpha === 0;
3698
+ if (!defaultTransparentBackground && parsedActual.alpha !== 1) return false;
3699
+ const actualRgb = defaultTransparentBackground ? parsedFallback.rgb : parsedActual.rgb;
3700
+ const expectedRgb = expected.startsWith("rgb:")
3701
+ ? [
3702
+ Number.parseInt(expected.slice(4, 6), 16),
3703
+ Number.parseInt(expected.slice(6, 8), 16),
3704
+ Number.parseInt(expected.slice(8, 10), 16),
3705
+ ]
3706
+ : expected.startsWith("indexed:")
3707
+ ? indexed(Number(expected.slice(8)))
3708
+ : rgb(fallback);
3709
+ return (
3710
+ actualRgb !== null &&
3711
+ expectedRgb !== null &&
3712
+ actualRgb.every((component, index) => component === expectedRgb[index])
3713
+ );
3714
+ };
3715
+ const expectedByRow = new Map();
3716
+ for (const cell of expectedCells) {
3717
+ const row = expectedByRow.get(cell.row) ?? new Map();
3718
+ row.set(cell.column, cell);
3719
+ expectedByRow.set(cell.row, row);
3720
+ }
3721
+ let domRowCountExact = rows.length === rendition?.rendererRows;
3722
+ let domTextExact = true;
3723
+ let domStyleExact = true;
3724
+ let domFirstMismatchRow = null;
3725
+ let domFirstMismatchColumn = null;
3726
+ let domFirstMismatchComponent = null;
3727
+ const mismatch = (row, column, component) => {
3728
+ if (domFirstMismatchComponent !== null) return;
3729
+ domFirstMismatchRow = Number.isSafeInteger(row) && row >= 0 && row <= 4_095 ? row : null;
3730
+ domFirstMismatchColumn =
3731
+ Number.isSafeInteger(column) && column >= 0 && column <= 4_095 ? column : null;
3732
+ domFirstMismatchComponent = component;
3733
+ };
3734
+ if (!domRowCountExact) mismatch(0, 0, "row-cardinality");
3735
+ const domRowsProjection = [];
3736
+ const themeForeground = rendition?.defaultForeground ?? "missing";
3737
+ const themeBackground = rendition?.defaultBackground ?? "missing";
3738
+ for (const [rowIndex, row] of rows.entries()) {
3739
+ const expectedRow = expectedByRow.get(rowIndex) ?? new Map();
3740
+ const actualCells = [];
3741
+ let column = 0;
3742
+ const walker = globalThis.document.createTreeWalker(row, globalThis.NodeFilter.SHOW_TEXT);
3743
+ for (let node = walker.nextNode(); node; node = walker.nextNode()) {
3744
+ const text = node.nodeValue ?? "";
3745
+ const element = node.parentElement ?? row;
3746
+ if (text.length === 0) continue;
3747
+ const style = semanticCellStyle(element);
3748
+ const graphemes = [
3749
+ ...new Intl.Segmenter(undefined, { granularity: "grapheme" }).segment(text),
3750
+ ];
3751
+ for (const { segment } of graphemes) {
3752
+ // xterm's DOM renderer uses NBSP for a buffer cell containing a
3753
+ // literal space so layout cannot collapse it. This is the one
3754
+ // renderer spelling that maps back to the canonical grapheme.
3755
+ const chars = segment === "\u00a0" ? " " : segment;
3756
+ // DomRenderer coalesces adjacent cells into one span and does not
3757
+ // expose wide-cell markers. Width is already independently proven
3758
+ // by the exact same renderer's canonical rendition; use that
3759
+ // bound cell only to advance this DOM text/style projection.
3760
+ const expectedAtColumn = expectedRow.get(column);
3761
+ const width = expectedAtColumn?.chars === chars ? expectedAtColumn.width : 1;
3762
+ const bold =
3763
+ Number.parseInt(style.fontWeight, 10) >= 600 || style.fontWeight === "bold";
3764
+ const italic = style.fontStyle !== "normal";
3765
+ const underline = style.textDecorationLine.includes("underline");
3766
+ const defaultSpace =
3767
+ chars === " " &&
3768
+ width === 1 &&
3769
+ colorExact(style.color, "default", themeForeground) &&
3770
+ colorExact(style.backgroundColor, "default", themeBackground, true) &&
3771
+ !bold &&
3772
+ !italic &&
3773
+ !underline;
3774
+ if (!defaultSpace)
3775
+ actualCells.push({ column, chars, width, style, bold, italic, underline });
3776
+ column += width;
3777
+ }
3778
+ }
3779
+ domRowsProjection.push({
3780
+ row: rowIndex,
3781
+ cells: actualCells.map(({ column, chars, width, style, bold, italic, underline }) => ({
3782
+ column,
3783
+ chars,
3784
+ width,
3785
+ style,
3786
+ bold,
3787
+ italic,
3788
+ underline,
3789
+ })),
3790
+ });
3791
+ const actualByColumn = new Map(actualCells.map((cell) => [cell.column, cell]));
3792
+ for (const expected of expectedRow.values()) {
3793
+ if (expected.width === 0 || expected.chars.length === 0) continue;
3794
+ const actual = actualByColumn.get(expected.column);
3795
+ if (!actual) {
3796
+ domTextExact = false;
3797
+ mismatch(rowIndex, expected.column, "cell-missing");
3798
+ continue;
3799
+ }
3800
+ if (actual.chars !== expected.chars) {
3801
+ domTextExact = false;
3802
+ mismatch(rowIndex, expected.column, "row-text");
3803
+ } else if (actual.width !== expected.width) {
3804
+ domTextExact = false;
3805
+ mismatch(rowIndex, expected.column, "width");
3806
+ }
3807
+ const component = !colorExact(actual.style.color, expected.foreground, themeForeground)
3808
+ ? "foreground"
3809
+ : !colorExact(actual.style.backgroundColor, expected.background, themeBackground, true)
3810
+ ? "background"
3811
+ : actual.bold !== expected.bold
3812
+ ? "bold"
3813
+ : actual.italic !== expected.italic
3814
+ ? "italic"
3815
+ : actual.underline !== expected.underline
3816
+ ? "underline"
3817
+ : null;
3818
+ if (component) {
3819
+ domStyleExact = false;
3820
+ mismatch(rowIndex, expected.column, component);
3821
+ }
3822
+ actualByColumn.delete(expected.column);
3823
+ }
3824
+ if (actualByColumn.size > 0) {
3825
+ domTextExact = false;
3826
+ mismatch(rowIndex, Math.min(...actualByColumn.keys()), "row-text");
3827
+ }
3828
+ }
3829
+ const domSemanticExact = domRowCountExact && domTextExact && domStyleExact;
3830
+ const screen = surface.querySelector(".xterm-screen") ?? surface;
3831
+ const screenRect = screen.getBoundingClientRect();
3832
+ const surfaceRect = surface.getBoundingClientRect();
3833
+ const rendererCols = rendition?.rendererCols;
3834
+ const rendererRows = rendition?.rendererRows;
3835
+ const rawCursorProjection = cursor
3836
+ ? JSON.stringify({
3837
+ className: cursor.className,
3838
+ left: Math.round((cursorRect.left - surfaceRect.left) * 1_000) / 1_000,
3839
+ top: Math.round((cursorRect.top - surfaceRect.top) * 1_000) / 1_000,
3840
+ width: Math.round(cursorRect.width * 1_000) / 1_000,
3841
+ height: Math.round(cursorRect.height * 1_000) / 1_000,
3842
+ backgroundColor: globalThis.getComputedStyle(cursor).backgroundColor,
3843
+ })
3844
+ : "missing";
3845
+ const domCursorProjection = cursor
3846
+ ? JSON.stringify({
3847
+ row:
3848
+ Number.isSafeInteger(rendererRows) && rendererRows > 0 && screenRect.height > 0
3849
+ ? Math.round(((cursorRect.top - screenRect.top) * rendererRows) / screenRect.height)
3850
+ : -1,
3851
+ column:
3852
+ Number.isSafeInteger(rendererCols) && rendererCols > 0 && screenRect.width > 0
3853
+ ? Math.round(
3854
+ ((cursorRect.left - screenRect.left) * rendererCols) / screenRect.width,
3855
+ )
3856
+ : -1,
3857
+ classes: [...cursor.classList].filter((name) => name.startsWith("xterm-cursor")).sort(),
3858
+ })
3859
+ : "missing";
3860
+ const domCursorClasses = cursor
3861
+ ? [...cursor.classList].filter((name) => name.startsWith("xterm-cursor"))
3862
+ : [];
3863
+ const domCursorRow =
3864
+ cursor && Number.isSafeInteger(rendererRows) && rendererRows > 0 && screenRect.height > 0
3865
+ ? Math.round(((cursorRect.top - screenRect.top) * rendererRows) / screenRect.height)
3866
+ : -1;
3867
+ const domCursorColumn =
3868
+ cursor && Number.isSafeInteger(rendererCols) && rendererCols > 0 && screenRect.width > 0
3869
+ ? Math.round(((cursorRect.left - screenRect.left) * rendererCols) / screenRect.width)
3870
+ : -1;
3871
+ const domCursorExact = expectedDomCursor.hidden
3872
+ ? cursor === null && allCursors.length === 0
3873
+ : cursor !== null &&
3874
+ domCursorRow === expectedDomCursor.y &&
3875
+ domCursorColumn === expectedDomCursor.x &&
3876
+ domCursorClasses.includes(`xterm-cursor-${expectedDomCursor.style}`) &&
3877
+ domCursorClasses.includes("xterm-cursor-blink") === expectedDomCursor.blink;
3878
+ return {
3879
+ stage: expectedStage,
3880
+ semanticPaneHmac: await hmac("pane", expectedPane),
3881
+ generationHmac: await hmac("generation", canonical?.generation ?? "missing"),
3882
+ incarnationHmac: await hmac("incarnation", canonical?.incarnation ?? "missing"),
3883
+ stateHmac: await hmac("state", canonical?.stateHash ?? "missing"),
3884
+ deliveryRequestHmac: await hmac(
3885
+ "delivery-request",
3886
+ canonical?.deliveryRequestId ?? "missing",
3887
+ ),
3888
+ rowsHmac: await hmac("web-rows", rows.map((row) => row.innerHTML).join("\n")),
3889
+ cursorHmac: await hmac("web-cursor", rawCursorProjection),
3890
+ domRowsHmac: await hmac("web-dom-rendition", JSON.stringify(domRowsProjection)),
3891
+ domCursorHmac: await hmac("web-dom-cursor", domCursorProjection),
3892
+ domSemanticExact,
3893
+ domRowCountExact,
3894
+ domTextExact,
3895
+ domStyleExact,
3896
+ domFirstMismatchRow,
3897
+ domFirstMismatchColumn,
3898
+ domFirstMismatchComponent,
3899
+ domCursorExact,
3900
+ renditionHmac: rendition?.renditionHmac ?? null,
3901
+ positionWrappedHmac: rendition?.positionWrappedHmac ?? null,
3902
+ graphemeWidthHmac: rendition?.graphemeWidthHmac ?? null,
3903
+ colorHmac: rendition?.colorHmac ?? null,
3904
+ attributesHmac: rendition?.attributesHmac ?? null,
3905
+ cellHmacs: Array.isArray(rendition?.cellHmacs) ? rendition.cellHmacs.slice(0, 256) : null,
3906
+ rendererCols: rendition?.rendererCols ?? -1,
3907
+ rendererRows: rendition?.rendererRows ?? -1,
3908
+ renditionCellCount: rendition?.renditionCellCount ?? -1,
3909
+ wideContinuationCount: rendition?.wideContinuationCount ?? -1,
3910
+ combiningCount: rendition?.combiningCount ?? -1,
3911
+ styledCellCount: rendition?.styledCellCount ?? -1,
3912
+ rowCount: rows.length,
3913
+ cursorCount: allCursors.length,
3914
+ cursorVisible: cursor !== null,
3915
+ activeBuffer: presentation?.activeBuffer ?? null,
3916
+ cursorX: presentation?.cursorX ?? -1,
3917
+ cursorY: presentation?.cursorY ?? -1,
3918
+ cursorHidden: presentation?.cursorHidden ?? null,
3919
+ cursorStyle: presentation?.cursorStyle ?? null,
3920
+ cursorBlink: presentation?.cursorBlink ?? null,
3921
+ revision: canonical?.revision ?? -1,
3922
+ sourceEpoch: canonical?.sourceEpoch ?? -1,
3923
+ rendererEpoch: canonical?.rendererEpoch ?? -1,
3924
+ cols: canonical?.cols ?? -1,
3925
+ rows: canonical?.rows ?? -1,
3926
+ gridRowsRead: canonical?.gridRowsRead ?? -1,
3927
+ gridCellsRead: canonical?.gridCellsRead ?? -1,
3928
+ fullGridWalks: canonical?.fullGridWalks ?? -1,
3929
+ canonicalBuffer: canonical ? (canonical.alternateScreen ? "alternate" : "normal") : null,
3930
+ canonicalCursorX: canonical?.cursor.x ?? -1,
3931
+ canonicalCursorY: canonical?.cursor.y ?? -1,
3932
+ canonicalCursorHidden: canonical?.cursor.hidden ?? null,
3933
+ canonicalCursorStyle: canonical?.cursor.style ?? null,
3934
+ canonicalCursorBlink: canonical?.cursor.blink ?? null,
3935
+ };
3936
+ },
3937
+ {
3938
+ evidenceKey: keyHex,
3939
+ expectedStage: stage,
3940
+ expectedPane: semanticPaneId,
3941
+ expectedCells: expectedRendition,
3942
+ expectedDomCursor: expectedCursor,
3943
+ },
3944
+ );
3945
+ }
3946
+
3947
+ function exactStage(value, expected) {
3948
+ const keys = [
3949
+ "processHmac",
3950
+ "clockId",
3951
+ "clockKind",
3952
+ "paneHmac",
3953
+ "generationHmac",
3954
+ "incarnationHmac",
3955
+ "revision",
3956
+ "stateHmac",
3957
+ "presentationHmac",
3958
+ "canonicalCols",
3959
+ "canonicalRows",
3960
+ "viewportCols",
3961
+ "viewportRows",
3962
+ "sourceEpoch",
3963
+ "rendererEpoch",
3964
+ "alternateScreen",
3965
+ "cursor",
3966
+ "framebufferHmac",
3967
+ "framebufferCellCount",
3968
+ "framebufferWideContinuationCount",
3969
+ "framebufferCombiningCount",
3970
+ "framebufferStyledCellCount",
3971
+ "gridRowsReadTotal",
3972
+ "fullWalkTotal",
3973
+ "presentationCount",
3974
+ ];
3975
+ return (
3976
+ exactKeys(value, keys) &&
3977
+ exactKeys(expected, keys) &&
3978
+ exactKeys(value?.cursor, ["x", "y", "hidden", "style", "blink"]) &&
3979
+ exactKeys(expected?.cursor, ["x", "y", "hidden", "style", "blink"]) &&
3980
+ exactIdentity(value, expected) &&
3981
+ value?.alternateScreen === expected?.alternateScreen &&
3982
+ value?.cursor?.hidden === expected?.cursor?.hidden &&
3983
+ value?.cursor?.style === expected?.cursor?.style &&
3984
+ value?.cursor?.blink === expected?.cursor?.blink &&
3985
+ Number.isSafeInteger(value?.cursor?.x) &&
3986
+ Number.isSafeInteger(value?.cursor?.y) &&
3987
+ value.cursor.x >= 0 &&
3988
+ value.cursor.x === expected?.cursor?.x &&
3989
+ value.cursor.y >= 0 &&
3990
+ value.cursor.y === expected?.cursor?.y &&
3991
+ value.cursor.x < value.viewportCols &&
3992
+ value.cursor.y < value.viewportRows &&
3993
+ value?.framebufferHmac === expected?.framebufferHmac &&
3994
+ value?.framebufferCellCount === expected?.framebufferCellCount &&
3995
+ value?.framebufferWideContinuationCount === expected?.framebufferWideContinuationCount &&
3996
+ value?.framebufferCombiningCount === expected?.framebufferCombiningCount &&
3997
+ value?.framebufferStyledCellCount === expected?.framebufferStyledCellCount &&
3998
+ Number.isSafeInteger(value?.gridRowsReadTotal) &&
3999
+ value.gridRowsReadTotal >= 0 &&
4000
+ value.gridRowsReadTotal === expected?.gridRowsReadTotal &&
4001
+ Number.isSafeInteger(value?.fullWalkTotal) &&
4002
+ value.fullWalkTotal >= 0 &&
4003
+ value.fullWalkTotal === expected?.fullWalkTotal &&
4004
+ Number.isSafeInteger(value?.presentationCount) &&
4005
+ value.presentationCount >= 1 &&
4006
+ value.presentationCount === expected?.presentationCount
4007
+ );
4008
+ }
4009
+
4010
+ function exactPreAlternate(value, expected, evidence) {
4011
+ const sample = value?.sample;
4012
+ const causal = sample?.causal;
4013
+ const counters = value?.counters;
4014
+ const cardinality = value?.cardinality;
4015
+ const predecessor = value?.predecessor;
4016
+ const native = value?.native;
4017
+ const cursorLast = evidence?.cursorSamples?.at(-1);
4018
+ const identityKeys = [
4019
+ "processHmac",
4020
+ "clockId",
4021
+ "clockKind",
4022
+ "paneHmac",
4023
+ "generationHmac",
4024
+ "incarnationHmac",
4025
+ "revision",
4026
+ "stateHmac",
4027
+ "presentationHmac",
4028
+ "canonicalCols",
4029
+ "canonicalRows",
4030
+ "viewportCols",
4031
+ "viewportRows",
4032
+ "sourceEpoch",
4033
+ "rendererEpoch",
4034
+ ];
4035
+ const counterFields = [
4036
+ "beforeGridRowsReadTotal",
4037
+ "afterGridRowsReadTotal",
4038
+ "beforeFullWalkTotal",
4039
+ "afterFullWalkTotal",
4040
+ "beforePresentationCount",
4041
+ "afterPresentationCount",
4042
+ "gridRowsReadDelta",
4043
+ "fullWalkDelta",
4044
+ "presentationCountDelta",
4045
+ ];
4046
+ const safeCounter = (number) =>
4047
+ Number.isSafeInteger(number) && number >= 0 && number <= 1_000_000_000;
4048
+ return (
4049
+ exactKeys(value, ["stage", "sample", "cardinality", "predecessor", "counters", "native"]) &&
4050
+ exactKeys(expected, [
4051
+ "stage",
4052
+ "predecessorRevision",
4053
+ "predecessorStateHmac",
4054
+ "presentationHmac",
4055
+ "framebufferHmac",
4056
+ "nativeCaptureHmac",
4057
+ "cursor",
4058
+ "beforeGridRowsReadTotal",
4059
+ "afterGridRowsReadTotal",
4060
+ "beforeFullWalkTotal",
4061
+ "afterFullWalkTotal",
4062
+ "beforePresentationCount",
4063
+ "afterPresentationCount",
4064
+ "gridRowsReadDelta",
4065
+ "fullWalkDelta",
4066
+ "presentationCountDelta",
4067
+ "daemonProcessHmac",
4068
+ "daemonClockId",
4069
+ ]) &&
4070
+ exactStage(value?.stage, expected?.stage) &&
4071
+ exactKeys(expected?.cursor, ["x", "y", "hidden", "style", "blink"]) &&
4072
+ exactKeys(predecessor, ["revision", "stateHmac"]) &&
4073
+ predecessor?.revision === expected?.predecessorRevision &&
4074
+ predecessor?.revision === cursorLast?.presentation?.revision &&
4075
+ predecessor?.stateHmac === expected?.predecessorStateHmac &&
4076
+ predecessor?.stateHmac === cursorLast?.presentation?.stateHmac &&
4077
+ Number.isSafeInteger(value?.stage?.revision) &&
4078
+ value.stage.revision === predecessor.revision + 1 &&
4079
+ value.stage.processHmac === evidence?.baseline?.processHmac &&
4080
+ value.stage.clockId === evidence?.baseline?.clockId &&
4081
+ value.stage.clockKind === evidence?.baseline?.clockKind &&
4082
+ value.stage.paneHmac === evidence?.baseline?.paneHmac &&
4083
+ value.stage.generationHmac === evidence?.baseline?.generationHmac &&
4084
+ value.stage.incarnationHmac === evidence?.baseline?.incarnationHmac &&
4085
+ value.stage.canonicalCols === evidence?.baseline?.canonicalCols &&
4086
+ value.stage.canonicalRows === evidence?.baseline?.canonicalRows &&
4087
+ value.stage.viewportCols === evidence?.baseline?.viewportCols &&
4088
+ value.stage.viewportRows === evidence?.baseline?.viewportRows &&
4089
+ value.stage.sourceEpoch === evidence?.baseline?.sourceEpoch &&
4090
+ value.stage.rendererEpoch === evidence?.baseline?.rendererEpoch &&
4091
+ value.stage.stateHmac === evidence?.baseline?.stateHmac &&
4092
+ value.stage.presentationHmac === expected?.presentationHmac &&
4093
+ value.stage.presentationHmac === evidence?.baseline?.presentationHmac &&
4094
+ value.stage.framebufferHmac === expected?.framebufferHmac &&
4095
+ value.stage.alternateScreen === false &&
4096
+ Object.entries(expected.cursor).every(([field, expectedValue]) =>
4097
+ Object.is(value.stage.cursor[field], expectedValue),
4098
+ ) &&
4099
+ exactKeys(cardinality, ["mode", "presentation", "frame", "fence", "traced"]) &&
4100
+ cardinality?.mode === 1 &&
4101
+ cardinality?.presentation === 1 &&
4102
+ cardinality?.frame === 1 &&
4103
+ cardinality?.fence === 1 &&
4104
+ cardinality?.traced === true &&
4105
+ exactKeys(counters, counterFields) &&
4106
+ counterFields.every((field) => safeCounter(counters?.[field])) &&
4107
+ counters.gridRowsReadDelta === expected?.gridRowsReadDelta &&
4108
+ counters.fullWalkDelta === expected?.fullWalkDelta &&
4109
+ counters.presentationCountDelta === expected?.presentationCountDelta &&
4110
+ counters.beforeGridRowsReadTotal === expected?.beforeGridRowsReadTotal &&
4111
+ counters.afterGridRowsReadTotal === expected?.afterGridRowsReadTotal &&
4112
+ counters.beforeFullWalkTotal === expected?.beforeFullWalkTotal &&
4113
+ counters.afterFullWalkTotal === expected?.afterFullWalkTotal &&
4114
+ counters.beforePresentationCount === expected?.beforePresentationCount &&
4115
+ counters.afterPresentationCount === expected?.afterPresentationCount &&
4116
+ counters.afterGridRowsReadTotal - counters.beforeGridRowsReadTotal ===
4117
+ counters.gridRowsReadDelta &&
4118
+ counters.afterFullWalkTotal - counters.beforeFullWalkTotal === counters.fullWalkDelta &&
4119
+ counters.afterPresentationCount - counters.beforePresentationCount ===
4120
+ counters.presentationCountDelta &&
4121
+ exactKeys(native, [
4122
+ "paneCount",
4123
+ "matchCount",
4124
+ "mappingExact",
4125
+ "geometryExact",
4126
+ "captureHmac",
4127
+ ]) &&
4128
+ native?.paneCount === 1 &&
4129
+ native?.matchCount === 1 &&
4130
+ native?.mappingExact === true &&
4131
+ native?.geometryExact === true &&
4132
+ SHA256.test(native?.captureHmac ?? "") &&
4133
+ native.captureHmac === expected?.nativeCaptureHmac &&
4134
+ exactKeys(sample, [
4135
+ "startedAtMicros",
4136
+ "presentedAtMicros",
4137
+ "frameAtMicros",
4138
+ "fenceAtMicros",
4139
+ "durationMicros",
4140
+ "traceHmac",
4141
+ "gestureHmac",
4142
+ "causal",
4143
+ "action",
4144
+ "cursor",
4145
+ "presentation",
4146
+ "frame",
4147
+ "fence",
4148
+ ]) &&
4149
+ sample?.action === "pre-alternate-normal" &&
4150
+ SHA256.test(sample?.traceHmac ?? "") &&
4151
+ SHA256.test(sample?.gestureHmac ?? "") &&
4152
+ safeMicros(sample?.durationMicros) &&
4153
+ safeTimestamp(sample?.startedAtMicros) &&
4154
+ safeTimestamp(sample?.presentedAtMicros) &&
4155
+ safeTimestamp(sample?.frameAtMicros) &&
4156
+ safeTimestamp(sample?.fenceAtMicros) &&
4157
+ sample.startedAtMicros <= sample.presentedAtMicros &&
4158
+ sample.presentedAtMicros <= sample.frameAtMicros &&
4159
+ sample.frameAtMicros <= sample.fenceAtMicros &&
4160
+ sample.durationMicros === sample.fenceAtMicros - sample.startedAtMicros &&
4161
+ exactKeys(causal, [
4162
+ "dirtyRows",
4163
+ "gridRowsReadDelta",
4164
+ "fullWalkDelta",
4165
+ "presentationCountDelta",
4166
+ "inputAccepted",
4167
+ "canonicalReceiptExact",
4168
+ "daemonStageCount",
4169
+ "daemonProcessHmac",
4170
+ "daemonClockId",
4171
+ ]) &&
4172
+ Array.isArray(causal?.dirtyRows) &&
4173
+ causal.dirtyRows.length === 0 &&
4174
+ causal.gridRowsReadDelta === counters.gridRowsReadDelta &&
4175
+ causal.fullWalkDelta === counters.fullWalkDelta &&
4176
+ causal.presentationCountDelta === counters.presentationCountDelta &&
4177
+ causal.inputAccepted === true &&
4178
+ causal.canonicalReceiptExact === true &&
4179
+ causal.daemonStageCount === ANSI_DAEMON_STAGES.length &&
4180
+ SHA256.test(causal?.daemonProcessHmac ?? "") &&
4181
+ causal.daemonProcessHmac === expected?.daemonProcessHmac &&
4182
+ causal.daemonProcessHmac === cursorLast?.causal?.daemonProcessHmac &&
4183
+ boundedIdentity(causal?.daemonClockId) &&
4184
+ causal.daemonClockId === expected?.daemonClockId &&
4185
+ causal.daemonClockId === cursorLast?.causal?.daemonClockId &&
4186
+ exactKeys(sample?.cursor, ["x", "y", "hidden", "canonicalStyle", "rendererStyle", "blink"]) &&
4187
+ sample.cursor.x === expected.cursor.x &&
4188
+ sample.cursor.y === expected.cursor.y &&
4189
+ sample.cursor.hidden === expected.cursor.hidden &&
4190
+ sample.cursor.canonicalStyle === expected.cursor.style &&
4191
+ sample.cursor.rendererStyle === expected.cursor.style &&
4192
+ sample.cursor.blink === expected.cursor.blink &&
4193
+ exactKeys(sample?.presentation, [
4194
+ ...identityKeys,
4195
+ "gridWalked",
4196
+ "gridRowsRead",
4197
+ "fullWalk",
4198
+ "gridRowsReadTotal",
4199
+ "fullWalkTotal",
4200
+ "presentationCount",
4201
+ ]) &&
4202
+ exactIdentity(sample.presentation, expected.stage) &&
4203
+ sample.presentation.gridWalked === true &&
4204
+ sample.presentation.gridRowsRead === expected.gridRowsReadDelta &&
4205
+ sample.presentation.fullWalk === false &&
4206
+ sample.presentation.gridRowsReadTotal === counters.afterGridRowsReadTotal &&
4207
+ sample.presentation.fullWalkTotal === counters.afterFullWalkTotal &&
4208
+ sample.presentation.presentationCount === counters.afterPresentationCount &&
4209
+ exactKeys(sample?.frame, identityKeys) &&
4210
+ exactIdentity(sample.frame, expected.stage) &&
4211
+ exactKeys(sample?.fence, identityKeys) &&
4212
+ exactIdentity(sample.fence, expected.stage)
4213
+ );
4214
+ }
4215
+
4216
+ export function assessAnsiCursorAltScreenEvidence(evidence, expected) {
4217
+ const topLevelExact =
4218
+ exactKeys(evidence, [
4219
+ "baseline",
4220
+ "rich",
4221
+ "cursorSamples",
4222
+ "preAlternate",
4223
+ "alternate",
4224
+ "restored",
4225
+ "workload",
4226
+ "workloadFinalities",
4227
+ "resourceSamples",
4228
+ "resourceLifecycle",
4229
+ "idle",
4230
+ "web",
4231
+ "tmux",
4232
+ "writer",
4233
+ ]) &&
4234
+ exactKeys(expected, [
4235
+ "baseline",
4236
+ "rich",
4237
+ "cursorSamples",
4238
+ "preAlternate",
4239
+ "alternate",
4240
+ "restored",
4241
+ "normalBeforeAlternateHmac",
4242
+ "workloadFinalities",
4243
+ "resourceSamples",
4244
+ "resourceLifecycle",
4245
+ "web",
4246
+ ]);
4247
+ const distribution = assessAnsiCursorPresentationSamples(
4248
+ evidence?.cursorSamples,
4249
+ expected?.cursorSamples,
4250
+ );
4251
+ const baseline = exactStage(evidence?.baseline, expected?.baseline);
4252
+ const rich = exactStage(evidence?.rich, expected?.rich);
4253
+ const preAlternate = exactPreAlternate(evidence?.preAlternate, expected?.preAlternate, evidence);
4254
+ const alternate = exactStage(evidence?.alternate, expected?.alternate);
4255
+ const restored = exactStage(evidence?.restored, expected?.restored);
4256
+ const restoreExact =
4257
+ restored &&
4258
+ preAlternate &&
4259
+ evidence?.restored?.alternateScreen === false &&
4260
+ evidence.restored.presentationHmac === expected?.restored?.presentationHmac &&
4261
+ evidence.restored.presentationHmac === evidence?.preAlternate?.stage?.presentationHmac &&
4262
+ evidence.restored.stateHmac === evidence?.preAlternate?.stage?.stateHmac &&
4263
+ expected?.restored?.presentationHmac === expected?.normalBeforeAlternateHmac;
4264
+ const workload = evidence?.workload;
4265
+ const workloadFinalities = assessAnsiWorkloadFinalitySamples(
4266
+ evidence?.workloadFinalities,
4267
+ expected?.workloadFinalities,
4268
+ );
4269
+ const resources = assessAnsiQuiescentResourceSamples(
4270
+ evidence?.resourceSamples,
4271
+ expected?.resourceSamples,
4272
+ );
4273
+ const resourceLifecycle = assessAnsiResourceLifecycle(
4274
+ evidence?.resourceLifecycle,
4275
+ expected?.resourceLifecycle,
4276
+ );
4277
+ const workloadShapeExact = exactKeys(workload, [
4278
+ "cycleCount",
4279
+ "conditioningCycleCount",
4280
+ "measuredCycleCount",
4281
+ "bytes",
4282
+ "maxQueueDepth",
4283
+ "settledDeliveryQueueDepth",
4284
+ "representationCacheBytes",
4285
+ "rawJournalBytes",
4286
+ "eventLoopP99Ms",
4287
+ "finalityCycleCount",
4288
+ "markerCount",
4289
+ "stableTailMs",
4290
+ "finalityExact",
4291
+ "drainExact",
4292
+ "faulted",
4293
+ "rebound",
4294
+ ]);
4295
+ const workloadPredicates = Object.freeze({
4296
+ resourceSamplesExact: resources.qualified,
4297
+ resourceLifecycleExact: resourceLifecycle.qualified,
4298
+ workloadFinalitiesExact: workloadFinalities.qualified,
4299
+ workloadShapeExact,
4300
+ workloadCountsExact:
4301
+ workload?.cycleCount === 24 &&
4302
+ workload?.conditioningCycleCount === 8 &&
4303
+ workload?.measuredCycleCount === 16 &&
4304
+ workload?.finalityCycleCount === 24 &&
4305
+ workload?.markerCount === 24,
4306
+ workloadBytesExact:
4307
+ Number.isSafeInteger(workload?.bytes) &&
4308
+ workload.bytes >= 1_048_576 &&
4309
+ workload.bytes <= 64 * 1_048_576,
4310
+ workloadQueueExact:
4311
+ Number.isSafeInteger(workload?.maxQueueDepth) &&
4312
+ workload.maxQueueDepth <= 64 &&
4313
+ workload?.settledDeliveryQueueDepth === 0,
4314
+ workloadCacheExact:
4315
+ Number.isSafeInteger(workload?.representationCacheBytes) &&
4316
+ workload.representationCacheBytes >= 0 &&
4317
+ workload.representationCacheBytes <= 16_777_216,
4318
+ workloadJournalExact:
4319
+ Number.isSafeInteger(workload?.rawJournalBytes) &&
4320
+ workload.rawJournalBytes >= 0 &&
4321
+ workload.rawJournalBytes <= 4_194_304,
4322
+ workloadEventLoopExact:
4323
+ Number.isFinite(workload?.eventLoopP99Ms) &&
4324
+ workload.eventLoopP99Ms <= TUI_EVENT_LOOP_WORKLOAD_P99_CEILING_MS,
4325
+ workloadFinalStateExact:
4326
+ workload?.stableTailMs === 40 &&
4327
+ workload?.finalityExact === true &&
4328
+ workload?.drainExact === true &&
4329
+ workload?.faulted === false &&
4330
+ workload?.rebound === false,
4331
+ });
4332
+ const workloadExact = Object.values(workloadPredicates).every(Boolean);
4333
+ const idleExact =
4334
+ exactKeys(evidence?.idle, [
4335
+ "durationMs",
4336
+ "frameCount",
4337
+ "paintCount",
4338
+ "gridRowsReadDelta",
4339
+ "fullWalkDelta",
4340
+ "presentationCountDelta",
4341
+ "framebufferHmacBefore",
4342
+ "framebufferHmacAfter",
4343
+ "queueDepth",
4344
+ "resourceExact",
4345
+ "resourceSampleOrdinal",
4346
+ "resourceEpochArmed",
4347
+ "resourceEpochIdentityHmac",
4348
+ "lowWaterFirstSampleOrdinal",
4349
+ "lowWaterLastSampleOrdinal",
4350
+ "lowWaterSampleCount",
4351
+ "lowWaterWindowMicros",
4352
+ "resourceProcessHmac",
4353
+ "resourceClockId",
4354
+ "resourceClockKind",
4355
+ "resourceAtMicros",
4356
+ "resourceIdentityHmac",
4357
+ "resourceStateHmac",
4358
+ "resourceInputPending",
4359
+ "resourceInputInFlight",
4360
+ "resourceInputPendingBytes",
4361
+ "resourceInputPendingPeak",
4362
+ "resourceInputInFlightPeak",
4363
+ "resourceInputPendingBytesPeak",
4364
+ "resourceSamplingFailureCount",
4365
+ "rssBytes",
4366
+ "heapUsedBytes",
4367
+ "eventLoopDelayMicros",
4368
+ "rssPeakBytes",
4369
+ "heapUsedPeakBytes",
4370
+ "eventLoopDelayPeakMicros",
4371
+ "eventLoopDelayPeakSource",
4372
+ "idleRetainedSampleCount",
4373
+ "idleRetainedRssSlopeBytesPerSample",
4374
+ "idleRetainedHeapSlopeBytesPerSample",
4375
+ "idleRetainedRssGrowthBytes",
4376
+ "idleRetainedHeapGrowthBytes",
4377
+ "idleRetainedRssHighBytes",
4378
+ "idleRetainedHeapHighBytes",
4379
+ "idleRetainedFirstInvalidOrdinal",
4380
+ "idleRetainedFirstInvalidPredicate",
4381
+ ]) &&
4382
+ Number.isSafeInteger(evidence?.idle?.durationMs) &&
4383
+ evidence.idle.durationMs >= 10_000 &&
4384
+ evidence.idle.durationMs <= 12_000 &&
4385
+ evidence?.idle?.frameCount === 0 &&
4386
+ evidence?.idle?.paintCount === 0 &&
4387
+ evidence?.idle?.gridRowsReadDelta === 0 &&
4388
+ evidence?.idle?.fullWalkDelta === 0 &&
4389
+ evidence?.idle?.presentationCountDelta === 0 &&
4390
+ SHA256.test(evidence?.idle?.framebufferHmacBefore ?? "") &&
4391
+ evidence.idle.framebufferHmacBefore === evidence.idle.framebufferHmacAfter &&
4392
+ evidence?.idle?.queueDepth === 0 &&
4393
+ evidence?.idle?.resourceExact === true &&
4394
+ Number.isSafeInteger(evidence?.idle?.resourceSampleOrdinal) &&
4395
+ evidence.idle.resourceSampleOrdinal >= 1 &&
4396
+ evidence.idle.resourceSampleOrdinal <= 512 &&
4397
+ evidence?.idle?.resourceEpochArmed === true &&
4398
+ evidence?.idle?.lowWaterFirstSampleOrdinal === 1 &&
4399
+ evidence?.idle?.lowWaterLastSampleOrdinal === 1 &&
4400
+ evidence?.idle?.lowWaterSampleCount === 1 &&
4401
+ evidence?.idle?.lowWaterWindowMicros === 0 &&
4402
+ SHA256.test(evidence?.idle?.resourceEpochIdentityHmac ?? "") &&
4403
+ evidence.idle.resourceEpochIdentityHmac ===
4404
+ evidence?.resourceLifecycle?.[0]?.resourceEpochIdentityHmac &&
4405
+ evidence?.idle?.resourceProcessHmac === evidence?.baseline?.processHmac &&
4406
+ evidence?.idle?.resourceClockId === evidence?.baseline?.clockId &&
4407
+ evidence?.idle?.resourceClockKind === "performance-now" &&
4408
+ safeTimestamp(evidence?.idle?.resourceAtMicros) &&
4409
+ SHA256.test(evidence?.idle?.resourceIdentityHmac ?? "") &&
4410
+ SHA256.test(evidence?.idle?.resourceStateHmac ?? "") &&
4411
+ evidence?.idle?.resourceInputPending === 0 &&
4412
+ evidence?.idle?.resourceInputInFlight === 0 &&
4413
+ evidence?.idle?.resourceInputPendingBytes === 0 &&
4414
+ evidence?.idle?.resourceInputPendingPeak === 0 &&
4415
+ evidence?.idle?.resourceInputInFlightPeak === 0 &&
4416
+ evidence?.idle?.resourceInputPendingBytesPeak === 0 &&
4417
+ evidence?.idle?.resourceSamplingFailureCount === 0 &&
4418
+ Number.isSafeInteger(evidence?.idle?.rssBytes) &&
4419
+ evidence.idle.rssBytes >= 0 &&
4420
+ evidence.idle.rssBytes <= ANSI_TUI_RSS_ABSOLUTE_CEILING_BYTES &&
4421
+ Number.isSafeInteger(evidence?.idle?.rssPeakBytes) &&
4422
+ evidence.idle.rssPeakBytes >= evidence.idle.rssBytes &&
4423
+ evidence.idle.rssPeakBytes <= ANSI_TUI_RSS_ABSOLUTE_CEILING_BYTES &&
4424
+ Number.isSafeInteger(evidence?.idle?.heapUsedBytes) &&
4425
+ evidence.idle.heapUsedBytes >= 0 &&
4426
+ evidence.idle.heapUsedBytes <= ANSI_TUI_HEAP_ABSOLUTE_CEILING_BYTES &&
4427
+ Number.isSafeInteger(evidence?.idle?.heapUsedPeakBytes) &&
4428
+ evidence.idle.heapUsedPeakBytes >= evidence.idle.heapUsedBytes &&
4429
+ evidence.idle.heapUsedPeakBytes <= ANSI_TUI_HEAP_ABSOLUTE_CEILING_BYTES &&
4430
+ Number.isSafeInteger(evidence?.idle?.eventLoopDelayMicros) &&
4431
+ evidence.idle.eventLoopDelayMicros >= 0 &&
4432
+ evidence.idle.eventLoopDelayMicros <= ANSI_TUI_EVENT_LOOP_CURRENT_ENDPOINT_CEILING_MICROS &&
4433
+ Number.isSafeInteger(evidence?.idle?.eventLoopDelayPeakMicros) &&
4434
+ evidence.idle.eventLoopDelayPeakMicros >= evidence.idle.eventLoopDelayMicros &&
4435
+ evidence.idle.eventLoopDelayPeakMicros <=
4436
+ ANSI_TUI_EVENT_LOOP_GENERATION_STICKY_PEAK_CEILING_MICROS &&
4437
+ new Set(["heartbeat", "endpoint"]).has(evidence?.idle?.eventLoopDelayPeakSource) &&
4438
+ evidence?.idle?.idleRetainedSampleCount === 8 &&
4439
+ Number.isFinite(evidence?.idle?.idleRetainedRssSlopeBytesPerSample) &&
4440
+ evidence.idle.idleRetainedRssSlopeBytesPerSample <= 262_144 &&
4441
+ Number.isFinite(evidence?.idle?.idleRetainedHeapSlopeBytesPerSample) &&
4442
+ evidence.idle.idleRetainedHeapSlopeBytesPerSample <= 131_072 &&
4443
+ Number.isSafeInteger(evidence?.idle?.idleRetainedRssGrowthBytes) &&
4444
+ evidence.idle.idleRetainedRssGrowthBytes <= 67_108_864 &&
4445
+ Number.isSafeInteger(evidence?.idle?.idleRetainedHeapGrowthBytes) &&
4446
+ evidence.idle.idleRetainedHeapGrowthBytes <= 33_554_432 &&
4447
+ Number.isSafeInteger(evidence?.idle?.idleRetainedRssHighBytes) &&
4448
+ evidence.idle.idleRetainedRssHighBytes <= ANSI_TUI_RSS_ABSOLUTE_CEILING_BYTES &&
4449
+ Number.isSafeInteger(evidence?.idle?.idleRetainedHeapHighBytes) &&
4450
+ evidence.idle.idleRetainedHeapHighBytes <= ANSI_TUI_HEAP_ABSOLUTE_CEILING_BYTES &&
4451
+ evidence?.idle?.idleRetainedFirstInvalidOrdinal === null &&
4452
+ evidence?.idle?.idleRetainedFirstInvalidPredicate === null;
4453
+ const web = ansiCursorWebEvidence(evidence?.web, expected?.web);
4454
+ const writerExact =
4455
+ exactKeys(evidence?.writer, [
4456
+ "droppedRecords",
4457
+ "oversizedRecords",
4458
+ "failed",
4459
+ "pendingCriticalRecords",
4460
+ ]) &&
4461
+ evidence?.writer?.droppedRecords === 0 &&
4462
+ evidence?.writer?.oversizedRecords === 0 &&
4463
+ evidence?.writer?.failed === false &&
4464
+ evidence?.writer?.pendingCriticalRecords === 0;
4465
+ const tmuxExact =
4466
+ exactKeys(evidence?.tmux, [
4467
+ "paneCount",
4468
+ "geometryStable",
4469
+ "markerExact",
4470
+ "baselineCaptureHmac",
4471
+ "alternateCaptureHmac",
4472
+ "alternateGeometryStable",
4473
+ "alternateMarkerAbsent",
4474
+ "alternateCursorExact",
4475
+ "finalCaptureHmac",
4476
+ ]) &&
4477
+ evidence?.tmux?.paneCount === 1 &&
4478
+ evidence?.tmux?.geometryStable === true &&
4479
+ evidence?.tmux?.markerExact === true &&
4480
+ SHA256.test(evidence?.tmux?.baselineCaptureHmac ?? "") &&
4481
+ SHA256.test(evidence?.tmux?.alternateCaptureHmac ?? "") &&
4482
+ evidence.tmux.alternateCaptureHmac !== evidence.tmux.baselineCaptureHmac &&
4483
+ evidence?.tmux?.alternateGeometryStable === true &&
4484
+ evidence?.tmux?.alternateMarkerAbsent === true &&
4485
+ evidence?.tmux?.alternateCursorExact === true &&
4486
+ evidence.tmux.baselineCaptureHmac === evidence.tmux.finalCaptureHmac;
4487
+ const cursorCounterContinuity = Array.isArray(evidence?.cursorSamples)
4488
+ ? evidence.cursorSamples.every((sample, index) => {
4489
+ const prior =
4490
+ index === 0 ? evidence?.rich : evidence.cursorSamples[index - 1]?.presentation;
4491
+ return (
4492
+ sample?.presentation?.gridRowsReadTotal === prior?.gridRowsReadTotal &&
4493
+ sample?.presentation?.fullWalkTotal === prior?.fullWalkTotal &&
4494
+ sample?.presentation?.presentationCount === prior?.presentationCount + 1
4495
+ );
4496
+ })
4497
+ : false;
4498
+ const counterContinuityExact =
4499
+ baseline &&
4500
+ rich &&
4501
+ preAlternate &&
4502
+ alternate &&
4503
+ restored &&
4504
+ evidence.baseline.gridRowsReadTotal === evidence.baseline.viewportRows &&
4505
+ evidence.baseline.fullWalkTotal === 1 &&
4506
+ evidence.baseline.presentationCount === 1 &&
4507
+ evidence.rich.gridRowsReadTotal === evidence.baseline.gridRowsReadTotal + 3 &&
4508
+ evidence.rich.fullWalkTotal === evidence.baseline.fullWalkTotal &&
4509
+ evidence.rich.presentationCount === evidence.baseline.presentationCount + 1 &&
4510
+ cursorCounterContinuity &&
4511
+ evidence.preAlternate.counters.beforeGridRowsReadTotal ===
4512
+ evidence.cursorSamples.at(-1)?.presentation?.gridRowsReadTotal &&
4513
+ evidence.preAlternate.counters.beforeFullWalkTotal ===
4514
+ evidence.cursorSamples.at(-1)?.presentation?.fullWalkTotal &&
4515
+ evidence.preAlternate.counters.beforePresentationCount ===
4516
+ evidence.cursorSamples.at(-1)?.presentation?.presentationCount &&
4517
+ evidence.alternate.gridRowsReadTotal ===
4518
+ evidence.preAlternate.counters.afterGridRowsReadTotal + evidence.alternate.viewportRows &&
4519
+ evidence.alternate.fullWalkTotal === evidence.preAlternate.counters.afterFullWalkTotal &&
4520
+ evidence.alternate.presentationCount ===
4521
+ evidence.preAlternate.counters.afterPresentationCount + 1 &&
4522
+ evidence.restored.gridRowsReadTotal ===
4523
+ evidence.alternate.gridRowsReadTotal + evidence.restored.viewportRows &&
4524
+ evidence.restored.fullWalkTotal === evidence.alternate.fullWalkTotal &&
4525
+ evidence.restored.presentationCount === evidence.alternate.presentationCount + 1;
4526
+ const lineageExact =
4527
+ baseline &&
4528
+ rich &&
4529
+ preAlternate &&
4530
+ alternate &&
4531
+ restored &&
4532
+ [evidence.rich, evidence.preAlternate.stage, evidence.alternate, evidence.restored].every(
4533
+ (stage) =>
4534
+ stage.generationHmac === evidence.baseline.generationHmac &&
4535
+ stage.incarnationHmac === evidence.baseline.incarnationHmac &&
4536
+ stage.sourceEpoch === evidence.baseline.sourceEpoch &&
4537
+ stage.rendererEpoch === evidence.baseline.rendererEpoch &&
4538
+ stage.revision > evidence.baseline.revision,
4539
+ ) &&
4540
+ evidence.rich.revision < evidence.preAlternate.stage.revision &&
4541
+ evidence.preAlternate.stage.revision + 1 === evidence.alternate.revision &&
4542
+ evidence.alternate.revision + 1 === evidence.restored.revision;
4543
+ const predicates = Object.freeze({
4544
+ topLevelExact,
4545
+ baselineExact: baseline,
4546
+ richExact: rich,
4547
+ cursorDistributionExact: distribution.qualified,
4548
+ preAlternateExact: preAlternate,
4549
+ counterContinuityExact,
4550
+ alternateExact: alternate,
4551
+ restoreExact,
4552
+ lineageExact,
4553
+ workloadExact,
4554
+ idleExact,
4555
+ webExact: web.qualified,
4556
+ tmuxExact,
4557
+ writerExact,
4558
+ });
4559
+ return Object.freeze({
4560
+ qualified: Object.values(predicates).every(Boolean),
4561
+ predicates,
4562
+ distribution,
4563
+ workloadFinalities,
4564
+ resources,
4565
+ resourceLifecycle,
4566
+ workloadPredicates,
4567
+ web,
4568
+ });
4569
+ }
4570
+
4571
+ export function ansiCursorAltJourneyStatus({ timeline, assessment, correlationComplete }) {
4572
+ const required = [
4573
+ "ansi-normal-baseline",
4574
+ "ansi-rich-presentation",
4575
+ "ansi-cursor-only-distribution",
4576
+ "ansi-alternate-screen",
4577
+ "ansi-normal-restored",
4578
+ "ansi-sustained-workload",
4579
+ "ansi-idle-quiescent",
4580
+ "ansi-web-correlation",
4581
+ ];
4582
+ const observed =
4583
+ Array.isArray(timeline) && timeline.length <= 4_096
4584
+ ? timeline.map(({ phase }) => phase).filter((phase) => required.includes(phase))
4585
+ : [];
4586
+ const orderedExact =
4587
+ observed.length === required.length &&
4588
+ observed.every((phase, index) => phase === required[index]);
4589
+ const boundaries = required.map((id) =>
4590
+ Object.freeze({
4591
+ id,
4592
+ status: orderedExact || observed.indexOf(id) === required.indexOf(id) ? "passed" : "failed",
4593
+ }),
4594
+ );
4595
+ if (!orderedExact) {
4596
+ const mismatch = required.findIndex((phase, index) => observed[index] !== phase);
4597
+ const firstFailedIndex = mismatch >= 0 ? mismatch : required.length - 1;
4598
+ for (let index = firstFailedIndex; index < boundaries.length; index += 1)
4599
+ boundaries[index] = Object.freeze({ id: boundaries[index].id, status: "failed" });
4600
+ }
4601
+ boundaries.push(
4602
+ Object.freeze({
4603
+ id: "ansi-causal-proof",
4604
+ status: assessment?.qualified === true ? "passed" : "failed",
4605
+ }),
4606
+ Object.freeze({
4607
+ id: "diagnostic-correlation",
4608
+ status: correlationComplete === true ? "passed" : "failed",
4609
+ }),
4610
+ );
4611
+ const firstBrokenBoundary = boundaries.find(({ status }) => status !== "passed")?.id ?? null;
4612
+ return Object.freeze({
4613
+ status: firstBrokenBoundary === null ? "passed" : "failed",
4614
+ firstBrokenBoundary,
4615
+ firstUnmeasuredBoundary: null,
4616
+ boundaries: Object.freeze(boundaries),
4617
+ });
4618
+ }