@crouton-kit/crouter 0.3.32 → 0.3.33

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 (440) hide show
  1. package/README.md +8 -0
  2. package/dist/build-root.js +1 -0
  3. package/dist/builtin-memory/crouter-development/marketplaces.md +2 -2
  4. package/dist/builtin-memory/crouter-development/personas/base-prompt.md +2 -2
  5. package/dist/builtin-memory/crouter-development/personas/orchestrator-prompt.md +5 -5
  6. package/dist/builtin-memory/crouter-development/personas.md +3 -4
  7. package/dist/builtin-memory/crouter-development/plugins.md +18 -18
  8. package/dist/builtin-memory/design.md +4 -1
  9. package/dist/builtin-memory/development.md +4 -1
  10. package/dist/builtin-memory/internal/INDEX.md +1 -1
  11. package/dist/builtin-memory/internal/nodes-and-canvas.md +6 -6
  12. package/dist/builtin-memory/internal/storage-tiers.md +5 -5
  13. package/dist/builtin-memory/planning.md +4 -1
  14. package/dist/builtin-memory/product.md +80 -0
  15. package/dist/builtin-memory/spec.md +4 -1
  16. package/dist/builtin-personas/advisor/PERSONA.md +10 -0
  17. package/dist/builtin-personas/design/PERSONA.md +2 -2
  18. package/dist/builtin-personas/design/orchestrator.md +3 -3
  19. package/dist/builtin-personas/developer/PERSONA.md +1 -1
  20. package/dist/builtin-personas/developer/orchestrator.md +2 -2
  21. package/dist/builtin-personas/explore/PERSONA.md +3 -3
  22. package/dist/builtin-personas/explore/orchestrator.md +4 -2
  23. package/dist/builtin-personas/general/PERSONA.md +1 -1
  24. package/dist/builtin-personas/general/orchestrator.md +1 -1
  25. package/dist/builtin-personas/orchestration-kernel.md +7 -14
  26. package/dist/builtin-personas/plan/PERSONA.md +1 -1
  27. package/dist/builtin-personas/plan/orchestrator.md +2 -2
  28. package/dist/builtin-personas/plan/reviewers/architecture-fit/PERSONA.md +1 -1
  29. package/dist/builtin-personas/plan/reviewers/code-smells/PERSONA.md +1 -1
  30. package/dist/builtin-personas/plan/reviewers/pattern-consistency/PERSONA.md +1 -1
  31. package/dist/builtin-personas/plan/reviewers/requirements-coverage/PERSONA.md +1 -1
  32. package/dist/builtin-personas/plan/reviewers/security/PERSONA.md +1 -1
  33. package/dist/builtin-personas/product/PERSONA.md +18 -0
  34. package/dist/builtin-personas/product/orchestrator.md +14 -0
  35. package/dist/builtin-personas/product/teardown/PERSONA.md +13 -0
  36. package/dist/builtin-personas/review/PERSONA.md +1 -1
  37. package/dist/builtin-personas/review/orchestrator.md +1 -1
  38. package/dist/builtin-personas/runtime-base.md +5 -0
  39. package/dist/builtin-personas/spec/PERSONA.md +1 -1
  40. package/dist/builtin-personas/spec/orchestrator.md +2 -2
  41. package/dist/builtin-personas/spec/requirements/PERSONA.md +1 -1
  42. package/dist/builtin-views/canvas/core.mjs +82 -1
  43. package/dist/builtin-views/canvas/tui.mjs +9 -5
  44. package/dist/builtin-views/canvas/web.jsx +3 -2
  45. package/dist/builtin-views/chat/core.mjs +725 -0
  46. package/dist/builtin-views/chat/text.mjs +101 -0
  47. package/dist/builtin-views/chat/tui.mjs +368 -0
  48. package/dist/builtin-views/chat/web.jsx +367 -0
  49. package/dist/builtin-views/prompt-review/core.mjs +863 -0
  50. package/dist/builtin-views/prompt-review/text.mjs +15 -0
  51. package/dist/builtin-views/prompt-review/tui.mjs +196 -0
  52. package/dist/builtin-views/prompt-review/web.jsx +484 -0
  53. package/dist/builtin-views/settings/core.mjs +397 -0
  54. package/dist/builtin-views/settings/text.mjs +40 -0
  55. package/dist/builtin-views/settings/tui.mjs +95 -0
  56. package/dist/builtin-views/settings/web.jsx +167 -0
  57. package/dist/cli.js +16 -3
  58. package/dist/clients/attach/__tests__/autocomplete-and-bash-mode.test.js +96 -0
  59. package/dist/clients/attach/__tests__/bash-bang-routing.test.js +58 -0
  60. package/dist/clients/attach/__tests__/bundle-pi-tui-dedup.test.d.ts +1 -0
  61. package/dist/clients/attach/__tests__/bundle-pi-tui-dedup.test.js +56 -0
  62. package/dist/clients/attach/__tests__/titled-editor.test.js +22 -1
  63. package/dist/clients/attach/attach-cmd.d.ts +18 -0
  64. package/dist/clients/attach/attach-cmd.js +1723 -795
  65. package/dist/clients/attach/canvas-panels.js +2 -2
  66. package/dist/clients/attach/chat-view.d.ts +10 -0
  67. package/dist/clients/attach/chat-view.js +23 -0
  68. package/dist/clients/attach/config-load.d.ts +8 -4
  69. package/dist/clients/attach/config-load.js +2 -0
  70. package/dist/clients/attach/extension-dialogs.d.ts +2 -3
  71. package/dist/clients/attach/extension-dialogs.js +7 -9
  72. package/dist/clients/attach/graph-overlay.js +3 -2
  73. package/dist/clients/attach/input-controller.d.ts +4 -3
  74. package/dist/clients/attach/input-controller.js +24 -3
  75. package/dist/clients/attach/slash-commands.d.ts +7 -7
  76. package/dist/clients/attach/slash-commands.js +38 -14
  77. package/dist/clients/attach/titled-editor.js +18 -14
  78. package/dist/clients/attach/view-socket.d.ts +2 -1
  79. package/dist/clients/attach/view-socket.js +27 -8
  80. package/dist/clients/web/__tests__/source-cache.test.d.ts +1 -0
  81. package/dist/clients/web/__tests__/source-cache.test.js +32 -0
  82. package/dist/clients/web/dev-server.js +1 -0
  83. package/dist/clients/web/events.js +9 -11
  84. package/dist/clients/web/server.d.ts +4 -3
  85. package/dist/clients/web/server.js +138 -31
  86. package/dist/clients/web/source-cache.d.ts +10 -0
  87. package/dist/clients/web/source-cache.js +57 -0
  88. package/dist/clients/web/web-cmd.js +28 -9
  89. package/dist/commands/__tests__/human.test.js +30 -28
  90. package/dist/commands/canvas-history/search.js +1 -1
  91. package/dist/commands/canvas-history.js +5 -8
  92. package/dist/commands/canvas-issue.d.ts +2 -0
  93. package/dist/commands/canvas-issue.js +148 -0
  94. package/dist/commands/canvas-prune.js +19 -0
  95. package/dist/commands/canvas-rebuild-index.d.ts +2 -0
  96. package/dist/commands/canvas-rebuild-index.js +57 -0
  97. package/dist/commands/canvas-snapshot.d.ts +2 -0
  98. package/dist/commands/canvas-snapshot.js +48 -0
  99. package/dist/commands/canvas-tmux-spread.d.ts +2 -0
  100. package/dist/commands/canvas-tmux-spread.js +188 -0
  101. package/dist/commands/canvas.d.ts +1 -0
  102. package/dist/commands/canvas.js +16 -1
  103. package/dist/commands/chord.js +143 -48
  104. package/dist/commands/daemon.js +3 -3
  105. package/dist/commands/human/prompts.d.ts +0 -1
  106. package/dist/commands/human/prompts.js +39 -54
  107. package/dist/commands/human/queue.d.ts +12 -1
  108. package/dist/commands/human/queue.js +468 -73
  109. package/dist/commands/human/shared.d.ts +3 -4
  110. package/dist/commands/human/shared.js +3 -3
  111. package/dist/commands/human.js +11 -10
  112. package/dist/commands/memory/find.js +3 -2
  113. package/dist/commands/memory/list.js +4 -3
  114. package/dist/commands/memory/read.js +3 -3
  115. package/dist/commands/memory/shared.d.ts +1 -4
  116. package/dist/commands/memory/shared.js +6 -9
  117. package/dist/commands/memory/write.js +3 -3
  118. package/dist/commands/memory.js +4 -7
  119. package/dist/commands/node-context.d.ts +2 -0
  120. package/dist/commands/node-context.js +172 -0
  121. package/dist/commands/node-snapshot.d.ts +2 -0
  122. package/dist/commands/node-snapshot.js +123 -0
  123. package/dist/commands/node.js +228 -52
  124. package/dist/commands/pkg/plugin-inspect.js +6 -6
  125. package/dist/commands/pkg/plugin-manage.js +1 -1
  126. package/dist/commands/pkg/plugin.js +2 -2
  127. package/dist/commands/pkg.js +2 -2
  128. package/dist/commands/push.d.ts +2 -0
  129. package/dist/commands/push.js +79 -11
  130. package/dist/commands/revive.js +74 -1
  131. package/dist/commands/search/answer.d.ts +1 -0
  132. package/dist/commands/search/answer.js +50 -0
  133. package/dist/commands/search/contents.d.ts +1 -0
  134. package/dist/commands/search/contents.js +96 -0
  135. package/dist/commands/search/exa.d.ts +53 -0
  136. package/dist/commands/search/exa.js +155 -0
  137. package/dist/commands/search/puremd.d.ts +11 -0
  138. package/dist/commands/search/puremd.js +53 -0
  139. package/dist/commands/search/web.d.ts +1 -0
  140. package/dist/commands/search/web.js +65 -0
  141. package/dist/commands/search.d.ts +2 -0
  142. package/dist/commands/search.js +24 -0
  143. package/dist/commands/sys/__tests__/sync-import.test.d.ts +1 -0
  144. package/dist/commands/sys/__tests__/sync-import.test.js +72 -0
  145. package/dist/commands/sys/config.js +59 -10
  146. package/dist/commands/sys/doctor.js +56 -4
  147. package/dist/commands/sys/prompt-review.d.ts +1 -0
  148. package/dist/commands/sys/prompt-review.js +178 -0
  149. package/dist/commands/sys/promptstudio.d.ts +2 -0
  150. package/dist/commands/sys/promptstudio.js +65 -0
  151. package/dist/commands/sys/settings.d.ts +2 -0
  152. package/dist/commands/sys/settings.js +16 -0
  153. package/dist/commands/sys/sync.js +311 -159
  154. package/dist/commands/sys/sysprompt.d.ts +1 -0
  155. package/dist/commands/sys/sysprompt.js +86 -0
  156. package/dist/commands/sys.js +9 -5
  157. package/dist/commands/view-new.js +2 -2
  158. package/dist/core/__tests__/artifact-paths.test.d.ts +1 -0
  159. package/dist/core/__tests__/artifact-paths.test.js +44 -0
  160. package/dist/core/__tests__/broker-preflight.test.d.ts +1 -0
  161. package/dist/core/__tests__/broker-preflight.test.js +85 -0
  162. package/dist/core/__tests__/broker-sdk-wiring.test.js +15 -0
  163. package/dist/core/__tests__/canvas.test.js +37 -1
  164. package/dist/core/__tests__/chat-view-reconnect.test.d.ts +1 -0
  165. package/dist/core/__tests__/chat-view-reconnect.test.js +70 -0
  166. package/dist/core/__tests__/child-death-wake.test.js +11 -2
  167. package/dist/core/__tests__/close.test.js +39 -1
  168. package/dist/core/__tests__/connection-reconnect-resume.test.d.ts +1 -0
  169. package/dist/core/__tests__/connection-reconnect-resume.test.js +37 -0
  170. package/dist/core/__tests__/context-intro.test.js +48 -14
  171. package/dist/core/__tests__/daemon-boot.test.js +182 -9
  172. package/dist/core/__tests__/editor-label.test.d.ts +1 -0
  173. package/dist/core/__tests__/editor-label.test.js +26 -0
  174. package/dist/core/__tests__/fault-marker.test.d.ts +1 -0
  175. package/dist/core/__tests__/fault-marker.test.js +112 -0
  176. package/dist/core/__tests__/fault-retry-rewind.test.d.ts +1 -0
  177. package/dist/core/__tests__/fault-retry-rewind.test.js +123 -0
  178. package/dist/core/__tests__/fixtures/fake-engine.d.ts +30 -4
  179. package/dist/core/__tests__/fixtures/fake-engine.js +156 -17
  180. package/dist/core/__tests__/fixtures/fake-pi-host.js +10 -1
  181. package/dist/core/__tests__/full/human-new-window-regression.test.js +1 -1
  182. package/dist/core/__tests__/helpers/harness.d.ts +1 -1
  183. package/dist/core/__tests__/helpers/harness.js +2 -2
  184. package/dist/core/__tests__/human-stranded-deliver.test.js +38 -1
  185. package/dist/core/__tests__/human-surface-target.test.js +1 -1
  186. package/dist/core/__tests__/kickoff.test.js +18 -19
  187. package/dist/core/__tests__/memory-resolver.test.js +12 -1
  188. package/dist/core/__tests__/migration.test.js +49 -14
  189. package/dist/core/__tests__/model-ladders.test.d.ts +1 -0
  190. package/dist/core/__tests__/model-ladders.test.js +160 -0
  191. package/dist/core/__tests__/node-env.test.d.ts +1 -0
  192. package/dist/core/__tests__/node-env.test.js +26 -0
  193. package/dist/core/__tests__/push-final-guard.test.js +7 -1
  194. package/dist/core/__tests__/relaunch-root.test.js +9 -9
  195. package/dist/core/__tests__/revive.test.js +36 -6
  196. package/dist/core/__tests__/spawn-root.test.js +24 -1
  197. package/dist/core/__tests__/stop-guard.test.js +10 -0
  198. package/dist/core/__tests__/stranded-relaunch.test.d.ts +1 -0
  199. package/dist/core/__tests__/stranded-relaunch.test.js +72 -0
  200. package/dist/core/__tests__/tmux-surface.test.js +5 -1
  201. package/dist/core/__tests__/unknown-path.test.js +19 -19
  202. package/dist/core/__tests__/yield-ensures-daemon.test.d.ts +1 -0
  203. package/dist/core/__tests__/yield-ensures-daemon.test.js +54 -0
  204. package/dist/core/artifact.d.ts +2 -33
  205. package/dist/core/artifact.js +27 -87
  206. package/dist/core/bootstrap.js +2 -0
  207. package/dist/core/canvas/browse/__tests__/model.test.js +35 -1
  208. package/dist/core/canvas/browse/app.js +87 -17
  209. package/dist/core/canvas/browse/model.d.ts +10 -1
  210. package/dist/core/canvas/browse/model.js +37 -1
  211. package/dist/core/canvas/browse/render.js +35 -33
  212. package/dist/core/canvas/canvas.d.ts +7 -0
  213. package/dist/core/canvas/canvas.js +54 -5
  214. package/dist/core/canvas/db.js +35 -8
  215. package/dist/core/canvas/labels.d.ts +6 -8
  216. package/dist/core/canvas/labels.js +8 -11
  217. package/dist/core/canvas/nav-model.d.ts +5 -4
  218. package/dist/core/canvas/nav-model.js +31 -17
  219. package/dist/core/canvas/paths.d.ts +18 -1
  220. package/dist/core/canvas/paths.js +31 -2
  221. package/dist/core/canvas/render.d.ts +25 -0
  222. package/dist/core/canvas/render.js +96 -13
  223. package/dist/core/canvas/status-glyph.d.ts +35 -0
  224. package/dist/core/canvas/status-glyph.js +104 -0
  225. package/dist/core/canvas/types.d.ts +2 -2
  226. package/dist/core/config.js +114 -16
  227. package/dist/core/fault-classifier.d.ts +41 -0
  228. package/dist/core/fault-classifier.js +110 -0
  229. package/dist/core/feed/inbox.d.ts +15 -0
  230. package/dist/core/feed/inbox.js +40 -14
  231. package/dist/core/frontmatter.d.ts +1 -11
  232. package/dist/core/frontmatter.js +1 -55
  233. package/dist/core/hearth/config.d.ts +2 -0
  234. package/dist/core/hearth/config.js +75 -0
  235. package/dist/core/hearth/guest-env.d.ts +2 -0
  236. package/dist/core/hearth/guest-env.js +11 -0
  237. package/dist/core/hearth/index.d.ts +5 -0
  238. package/dist/core/hearth/index.js +5 -0
  239. package/dist/core/hearth/provider.d.ts +21 -0
  240. package/dist/core/hearth/provider.js +10 -0
  241. package/dist/core/hearth/providers/blaxel-bootstrap.d.ts +10 -0
  242. package/dist/core/hearth/providers/blaxel-bootstrap.js +39 -0
  243. package/dist/core/hearth/providers/blaxel-home.d.ts +11 -0
  244. package/dist/core/hearth/providers/blaxel-home.js +126 -0
  245. package/dist/core/hearth/providers/blaxel.d.ts +26 -0
  246. package/dist/core/hearth/providers/blaxel.js +208 -0
  247. package/dist/core/hearth/providers/types.d.ts +72 -0
  248. package/dist/core/hearth/providers/types.js +1 -0
  249. package/dist/core/hearth/registry.d.ts +15 -0
  250. package/dist/core/hearth/registry.js +179 -0
  251. package/dist/core/hearth/types.d.ts +121 -0
  252. package/dist/core/hearth/types.js +1 -0
  253. package/dist/core/host-exports/__tests__/export-prunes-boot-skill.test.d.ts +1 -0
  254. package/dist/core/host-exports/__tests__/export-prunes-boot-skill.test.js +79 -0
  255. package/dist/core/{skill-sync → host-exports}/builtins.d.ts +21 -13
  256. package/dist/core/host-exports/builtins.js +68 -0
  257. package/dist/core/{skill-sync → host-exports}/export.d.ts +9 -6
  258. package/dist/core/{skill-sync → host-exports}/export.js +37 -14
  259. package/dist/core/io.js +1 -1
  260. package/dist/core/log.d.ts +9 -0
  261. package/dist/core/log.js +113 -0
  262. package/dist/core/memory-resolver.d.ts +8 -8
  263. package/dist/core/memory-resolver.js +15 -28
  264. package/dist/core/personas/index.d.ts +4 -4
  265. package/dist/core/personas/index.js +2 -2
  266. package/dist/core/personas/loader.d.ts +51 -0
  267. package/dist/core/personas/loader.js +54 -50
  268. package/dist/core/personas/resolve.d.ts +43 -27
  269. package/dist/core/personas/resolve.js +336 -94
  270. package/dist/core/runtime/auth-reload.d.ts +7 -0
  271. package/dist/core/runtime/auth-reload.js +69 -0
  272. package/dist/core/runtime/bearings.d.ts +35 -15
  273. package/dist/core/runtime/bearings.js +305 -44
  274. package/dist/core/runtime/branded-host.d.ts +4 -2
  275. package/dist/core/runtime/branded-host.js +66 -4
  276. package/dist/core/runtime/broker-protocol.d.ts +38 -3
  277. package/dist/core/runtime/broker.js +343 -18
  278. package/dist/core/runtime/close.js +37 -29
  279. package/dist/core/runtime/connectivity.d.ts +12 -0
  280. package/dist/core/runtime/connectivity.js +73 -0
  281. package/dist/core/runtime/fault-recovery-nudge.d.ts +2 -0
  282. package/dist/core/runtime/fault-recovery-nudge.js +2 -0
  283. package/dist/core/runtime/fault-recovery.d.ts +23 -0
  284. package/dist/core/runtime/fault-recovery.js +74 -0
  285. package/dist/core/runtime/fault.d.ts +25 -0
  286. package/dist/core/runtime/fault.js +176 -0
  287. package/dist/core/runtime/front-door.d.ts +1 -1
  288. package/dist/core/runtime/front-door.js +2 -2
  289. package/dist/core/runtime/host.d.ts +10 -0
  290. package/dist/core/runtime/host.js +71 -9
  291. package/dist/core/runtime/kickoff.js +31 -45
  292. package/dist/core/runtime/launch.d.ts +32 -18
  293. package/dist/core/runtime/launch.js +148 -43
  294. package/dist/core/runtime/model-swap.d.ts +18 -0
  295. package/dist/core/runtime/model-swap.js +95 -0
  296. package/dist/core/runtime/naming.d.ts +7 -0
  297. package/dist/core/runtime/naming.js +61 -9
  298. package/dist/core/runtime/nodes.js +6 -1
  299. package/dist/core/runtime/persona.js +16 -17
  300. package/dist/core/runtime/placement.d.ts +36 -31
  301. package/dist/core/runtime/placement.js +149 -64
  302. package/dist/core/runtime/promote.d.ts +2 -0
  303. package/dist/core/runtime/promote.js +23 -3
  304. package/dist/core/runtime/recycle.js +6 -4
  305. package/dist/core/runtime/reset.d.ts +5 -2
  306. package/dist/core/runtime/reset.js +2 -2
  307. package/dist/core/runtime/revive.d.ts +4 -0
  308. package/dist/core/runtime/revive.js +27 -9
  309. package/dist/core/runtime/roadmap.d.ts +1 -1
  310. package/dist/core/runtime/roadmap.js +1 -1
  311. package/dist/core/runtime/spawn.d.ts +2 -2
  312. package/dist/core/runtime/spawn.js +30 -6
  313. package/dist/core/runtime/stop-guard.js +6 -1
  314. package/dist/core/runtime/tmux-chrome.d.ts +1 -1
  315. package/dist/core/runtime/tmux-chrome.js +1 -1
  316. package/dist/core/runtime/tmux.d.ts +29 -6
  317. package/dist/core/runtime/tmux.js +134 -80
  318. package/dist/core/runtime/view-socket-client.d.ts +46 -0
  319. package/dist/core/runtime/view-socket-client.js +203 -0
  320. package/dist/core/substrate/index.d.ts +1 -1
  321. package/dist/core/substrate/index.js +1 -1
  322. package/dist/core/substrate/on-read.js +16 -4
  323. package/dist/core/substrate/render.d.ts +10 -13
  324. package/dist/core/substrate/render.js +56 -51
  325. package/dist/core/tui/host.js +83 -18
  326. package/dist/core/view/__tests__/transport-cache.test.d.ts +1 -0
  327. package/dist/core/view/__tests__/transport-cache.test.js +62 -0
  328. package/dist/core/view/contract.d.ts +20 -0
  329. package/dist/core/view/stream-local.d.ts +3 -0
  330. package/dist/core/view/stream-local.js +184 -0
  331. package/dist/core/view/transport-cache.d.ts +8 -0
  332. package/dist/core/view/transport-cache.js +38 -0
  333. package/dist/core/view/transport-local.js +4 -0
  334. package/dist/core/view/transport.d.ts +7 -1
  335. package/dist/daemon/crtrd.d.ts +3 -19
  336. package/dist/daemon/crtrd.js +139 -178
  337. package/dist/daemon/manage.d.ts +18 -1
  338. package/dist/daemon/manage.js +54 -9
  339. package/dist/hearth/wake-proxy/__tests__/anthropic-oauth.test.d.ts +1 -0
  340. package/dist/hearth/wake-proxy/__tests__/anthropic-oauth.test.js +289 -0
  341. package/dist/hearth/wake-proxy/__tests__/config-timeout.test.d.ts +1 -0
  342. package/dist/hearth/wake-proxy/__tests__/config-timeout.test.js +34 -0
  343. package/dist/hearth/wake-proxy/__tests__/guest-source.test.d.ts +1 -0
  344. package/dist/hearth/wake-proxy/__tests__/guest-source.test.js +203 -0
  345. package/dist/hearth/wake-proxy/__tests__/hardening.test.d.ts +1 -0
  346. package/dist/hearth/wake-proxy/__tests__/hardening.test.js +59 -0
  347. package/dist/hearth/wake-proxy/__tests__/hearth-status-route.test.d.ts +1 -0
  348. package/dist/hearth/wake-proxy/__tests__/hearth-status-route.test.js +372 -0
  349. package/dist/hearth/wake-proxy/__tests__/http-running-route-fast-path.test.d.ts +1 -0
  350. package/dist/hearth/wake-proxy/__tests__/http-running-route-fast-path.test.js +258 -0
  351. package/dist/hearth/wake-proxy/__tests__/model-auth-routes.test.d.ts +1 -0
  352. package/dist/hearth/wake-proxy/__tests__/model-auth-routes.test.js +437 -0
  353. package/dist/hearth/wake-proxy/__tests__/source-bridge-gate.test.d.ts +1 -0
  354. package/dist/hearth/wake-proxy/__tests__/source-bridge-gate.test.js +455 -0
  355. package/dist/hearth/wake-proxy/__tests__/static-asset-allowlist.test.d.ts +1 -0
  356. package/dist/hearth/wake-proxy/__tests__/static-asset-allowlist.test.js +15 -0
  357. package/dist/hearth/wake-proxy/__tests__/warm-path-concurrency.test.d.ts +1 -0
  358. package/dist/hearth/wake-proxy/__tests__/warm-path-concurrency.test.js +141 -0
  359. package/dist/hearth/wake-proxy/__tests__/ws-teardown-accounting.test.d.ts +1 -0
  360. package/dist/hearth/wake-proxy/__tests__/ws-teardown-accounting.test.js +143 -0
  361. package/dist/hearth/wake-proxy/anthropic-oauth.d.ts +58 -0
  362. package/dist/hearth/wake-proxy/anthropic-oauth.js +189 -0
  363. package/dist/hearth/wake-proxy/auth.d.ts +22 -0
  364. package/dist/hearth/wake-proxy/auth.js +128 -0
  365. package/dist/hearth/wake-proxy/config.d.ts +2 -0
  366. package/dist/hearth/wake-proxy/config.js +151 -0
  367. package/dist/hearth/wake-proxy/guest-source.d.ts +14 -0
  368. package/dist/hearth/wake-proxy/guest-source.js +130 -0
  369. package/dist/hearth/wake-proxy/hearth-status.d.ts +44 -0
  370. package/dist/hearth/wake-proxy/hearth-status.js +267 -0
  371. package/dist/hearth/wake-proxy/home.d.ts +67 -0
  372. package/dist/hearth/wake-proxy/home.js +297 -0
  373. package/dist/hearth/wake-proxy/main.d.ts +1 -0
  374. package/dist/hearth/wake-proxy/main.js +134 -0
  375. package/dist/hearth/wake-proxy/model-auth.d.ts +13 -0
  376. package/dist/hearth/wake-proxy/model-auth.js +345 -0
  377. package/dist/hearth/wake-proxy/proxy.d.ts +35 -0
  378. package/dist/hearth/wake-proxy/proxy.js +716 -0
  379. package/dist/hearth/wake-proxy/public-source-gate.d.ts +9 -0
  380. package/dist/hearth/wake-proxy/public-source-gate.js +409 -0
  381. package/dist/hearth/wake-proxy/redact.d.ts +1 -0
  382. package/dist/hearth/wake-proxy/redact.js +17 -0
  383. package/dist/hearth/wake-proxy/server.d.ts +11 -0
  384. package/dist/hearth/wake-proxy/server.js +142 -0
  385. package/dist/hearth/wake-proxy/state.d.ts +18 -0
  386. package/dist/hearth/wake-proxy/state.js +342 -0
  387. package/dist/hearth/wake-proxy/types.d.ts +76 -0
  388. package/dist/hearth/wake-proxy/types.js +1 -0
  389. package/dist/index.js +3 -2
  390. package/dist/pi-extensions/__tests__/canvas-context-intro.test.js +6 -5
  391. package/dist/pi-extensions/canvas-context-intro.js +7 -7
  392. package/dist/pi-extensions/canvas-doc-substrate.js +19 -22
  393. package/dist/pi-extensions/canvas-nav.js +15 -8
  394. package/dist/pi-extensions/canvas-stophook.d.ts +1 -1
  395. package/dist/pi-extensions/canvas-stophook.js +78 -11
  396. package/dist/types.d.ts +39 -20
  397. package/dist/types.js +38 -13
  398. package/dist/web/runtime.js +141 -42
  399. package/dist/web/transport-http.js +7 -5
  400. package/dist/web/transport-stream.d.ts +3 -0
  401. package/dist/web/transport-stream.js +204 -0
  402. package/dist/web-client/assets/fragment-mono-latin-400-normal-BYwT3kSJ.woff +0 -0
  403. package/dist/web-client/assets/fragment-mono-latin-400-normal-yxdJ5AmL.woff2 +0 -0
  404. package/dist/web-client/assets/fragment-mono-latin-ext-400-normal-BbKYyvR9.woff2 +0 -0
  405. package/dist/web-client/assets/fragment-mono-latin-ext-400-normal-CT4YFKeK.woff +0 -0
  406. package/dist/web-client/assets/fraunces-latin-ext-wght-normal-Ca2vKHc0.woff2 +0 -0
  407. package/dist/web-client/assets/fraunces-latin-wght-normal-ukD16Tqj.woff2 +0 -0
  408. package/dist/web-client/assets/fraunces-vietnamese-wght-normal-CnvboYUG.woff2 +0 -0
  409. package/dist/web-client/assets/index-BZUxTkv5.css +2 -0
  410. package/dist/web-client/assets/index-D36PNBj4.js +80 -0
  411. package/dist/web-client/assets/instrument-sans-latin-ext-wght-normal-B5bTHO_g.woff2 +0 -0
  412. package/dist/web-client/assets/instrument-sans-latin-wght-normal-BbzFLZTg.woff2 +0 -0
  413. package/dist/web-client/assets/martian-mono-cyrillic-wght-normal-B84CD5C_.woff2 +0 -0
  414. package/dist/web-client/assets/martian-mono-latin-ext-wght-normal-DlL6xMw5.woff2 +0 -0
  415. package/dist/web-client/assets/martian-mono-latin-wght-normal-5W32yIyr.woff2 +0 -0
  416. package/dist/web-client/index.html +3 -2
  417. package/package.json +32 -10
  418. package/dist/core/__tests__/error-stall-recycle.test.js +0 -141
  419. package/dist/core/skill-sync/__tests__/dry-run-wrote-count.test.js +0 -57
  420. package/dist/core/skill-sync/builtins.js +0 -112
  421. package/dist/core/skill-sync/claude-plugins.d.ts +0 -23
  422. package/dist/core/skill-sync/claude-plugins.js +0 -71
  423. package/dist/core/skill-sync/engine.d.ts +0 -42
  424. package/dist/core/skill-sync/engine.js +0 -633
  425. package/dist/core/skill-sync/manifest.d.ts +0 -64
  426. package/dist/core/skill-sync/manifest.js +0 -181
  427. package/dist/core/skill-sync/profile.d.ts +0 -76
  428. package/dist/core/skill-sync/profile.js +0 -173
  429. package/dist/core/skill-sync/snapshot.d.ts +0 -57
  430. package/dist/core/skill-sync/snapshot.js +0 -120
  431. package/dist/pi-extensions/canvas-commands.d.ts +0 -37
  432. package/dist/pi-extensions/canvas-commands.js +0 -113
  433. package/dist/pi-extensions/canvas-resume.d.ts +0 -21
  434. package/dist/pi-extensions/canvas-resume.js +0 -83
  435. package/dist/pi-extensions/canvas-view.d.ts +0 -21
  436. package/dist/pi-extensions/canvas-view.js +0 -76
  437. package/dist/web-client/assets/index-BUvQb4hR.css +0 -2
  438. package/dist/web-client/assets/index-ClLQXYAE.js +0 -10
  439. /package/dist/{core/__tests__/error-stall-recycle.test.d.ts → clients/attach/__tests__/autocomplete-and-bash-mode.test.d.ts} +0 -0
  440. /package/dist/{core/skill-sync/__tests__/dry-run-wrote-count.test.d.ts → clients/attach/__tests__/bash-bang-routing.test.d.ts} +0 -0
@@ -0,0 +1,372 @@
1
+ import assert from 'node:assert/strict';
2
+ import { createHash } from 'node:crypto';
3
+ import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs';
4
+ import { tmpdir } from 'node:os';
5
+ import { join } from 'node:path';
6
+ import { Readable } from 'node:stream';
7
+ import { test } from 'node:test';
8
+ import { routeRequest } from '../server.js';
9
+ const ownerToken = 'owner-secret-token';
10
+ const ownerTokenHash = createHash('sha256').update(ownerToken, 'utf8').digest('hex');
11
+ const publicOrigin = 'https://hearth.example';
12
+ function makeRuntime(tenantId, statePath) {
13
+ return {
14
+ proxy: {
15
+ host: '127.0.0.1',
16
+ port: 7878,
17
+ publicOrigin,
18
+ statePath,
19
+ m0RegistryPath: join(statePath, 'homes.json'),
20
+ ownerUserId: 'owner-user',
21
+ defaultTenantId: tenantId,
22
+ ownerTokenHash,
23
+ idlePauseMs: 60_000,
24
+ wakeTimeoutMs: 30_000,
25
+ readyTimeoutMs: 2_000,
26
+ cookieSecure: true,
27
+ seedHome: null,
28
+ },
29
+ m0: {
30
+ providerName: 'none',
31
+ registryPath: join(statePath, 'homes.json'),
32
+ guestUser: 'agent',
33
+ guestHome: '/home/agent',
34
+ guestCodePath: '/opt/crouter',
35
+ webPort: 7878,
36
+ nodeKind: 'general',
37
+ piPackages: [],
38
+ piAuthJson: null,
39
+ relayToken: null,
40
+ },
41
+ };
42
+ }
43
+ function writeState(statePath, tenantId) {
44
+ mkdirSync(join(statePath, '..'), { recursive: true });
45
+ writeFileSync(statePath, `${JSON.stringify({
46
+ version: 1,
47
+ owner: {
48
+ ownerUserId: 'owner-user',
49
+ defaultTenantId: tenantId,
50
+ tokenHash: ownerTokenHash,
51
+ createdAt: '2026-06-26T00:00:00.000Z',
52
+ },
53
+ tenants: {},
54
+ }, null, 2)}\n`, 'utf8');
55
+ }
56
+ function writeHome(registryPath, home) {
57
+ mkdirSync(join(registryPath, '..'), { recursive: true });
58
+ writeFileSync(registryPath, `${JSON.stringify({
59
+ [home.tenantId]: home,
60
+ }, null, 2)}\n`, 'utf8');
61
+ }
62
+ function makeRequest(method, url, headers = {}, body = '') {
63
+ const req = new Readable({ read() { } });
64
+ req.method = method;
65
+ req.url = url;
66
+ req.headers = headers;
67
+ process.nextTick(() => {
68
+ if (body !== '')
69
+ req.push(body);
70
+ req.push(null);
71
+ });
72
+ return req;
73
+ }
74
+ function makeResponse() {
75
+ return {
76
+ statusCode: 200,
77
+ headersSent: false,
78
+ headers: {},
79
+ body: '',
80
+ writeHead(statusCode, headers) {
81
+ this.statusCode = statusCode;
82
+ this.headers = { ...this.headers, ...headers };
83
+ this.headersSent = true;
84
+ return this;
85
+ },
86
+ setHeader(name, value) {
87
+ this.headers[name.toLowerCase()] = value;
88
+ },
89
+ end(chunk) {
90
+ if (chunk !== undefined)
91
+ this.body += Buffer.isBuffer(chunk) ? chunk.toString('utf8') : chunk;
92
+ this.headersSent = true;
93
+ return this;
94
+ },
95
+ destroy() {
96
+ this.headersSent = true;
97
+ },
98
+ };
99
+ }
100
+ function parseJsonBody(res) {
101
+ return JSON.parse(res.body);
102
+ }
103
+ test('status route returns 401 without owner auth', async () => {
104
+ const tenantId = 'tenant-status-unauthenticated';
105
+ const tempDir = mkdtempSync(join(tmpdir(), 'crouter-hearth-status-unauth-'));
106
+ const statePath = join(tempDir, 'state.json');
107
+ writeState(statePath, tenantId);
108
+ const runtime = makeRuntime(tenantId, statePath);
109
+ const res = makeResponse();
110
+ const handled = await routeRequest(makeRequest('GET', '/__hearth/status'), res, runtime, {});
111
+ assert.equal(handled, undefined);
112
+ assert.equal(res.statusCode, 401);
113
+ });
114
+ test('status route returns runtime stats when existing relay already serves', async () => {
115
+ const tenantId = 'tenant-status-runtime';
116
+ const tempDir = mkdtempSync(join(tmpdir(), 'crouter-hearth-status-runtime-'));
117
+ const statePath = join(tempDir, 'state.json');
118
+ const registryPath = join(tempDir, 'homes.json');
119
+ writeState(statePath, tenantId);
120
+ const runtime = makeRuntime(tenantId, statePath);
121
+ runtime.proxy.m0RegistryPath = registryPath;
122
+ runtime.m0.registryPath = registryPath;
123
+ const capturedAt = new Date().toISOString();
124
+ const fetchCalls = [];
125
+ writeHome(registryPath, {
126
+ tenantId,
127
+ providerName: 'none',
128
+ machineId: 'test-machine',
129
+ homeStorage: {
130
+ kind: 'volume',
131
+ durability: 'durable-volume',
132
+ longTermContract: true,
133
+ ownerMachineId: 'test-machine',
134
+ guestHome: '/home/agent',
135
+ volumeId: 'volume-123',
136
+ mountPath: '/home/agent',
137
+ },
138
+ state: 'running',
139
+ nodeId: 'test-node',
140
+ relayToken: 'relay-token',
141
+ webRoute: {
142
+ routeId: 'https://relay.example',
143
+ machineId: 'test-machine',
144
+ targetPort: 7878,
145
+ url: 'https://relay.example',
146
+ concreteUrl: 'https://relay.example',
147
+ concreteUrlSource: 'config',
148
+ createdAt: '2026-06-26T00:00:00.000Z',
149
+ raw: null,
150
+ },
151
+ createdAt: '2026-06-26T00:00:00.000Z',
152
+ updatedAt: '2026-06-26T00:00:00.000Z',
153
+ });
154
+ const res = makeResponse();
155
+ const handled = await routeRequest(makeRequest('GET', '/__hearth/status', { authorization: `Bearer ${ownerToken}` }), res, runtime, {
156
+ status: {
157
+ fetch: (async (url, init) => {
158
+ fetchCalls.push({ url: String(url), init: init ?? {} });
159
+ return {
160
+ ok: true,
161
+ status: 200,
162
+ statusText: 'OK',
163
+ async text() {
164
+ return JSON.stringify({
165
+ ok: true,
166
+ exitCode: 0,
167
+ stdout: JSON.stringify({
168
+ cpuPct: 17.5,
169
+ memoryUsedMB: 612,
170
+ memoryAvailableMB: 1436,
171
+ crtrRssKB: 45000,
172
+ piRssKB: 32000,
173
+ nodeRssKB: 12000,
174
+ totalRssKB: 89000,
175
+ capturedAt,
176
+ }),
177
+ stderr: '',
178
+ });
179
+ },
180
+ };
181
+ }),
182
+ },
183
+ });
184
+ assert.equal(handled, undefined);
185
+ assert.equal(res.statusCode, 200);
186
+ const body = parseJsonBody(res);
187
+ assert.equal(body.runtimeStats?.cpuPct, 17.5);
188
+ assert.equal(body.machineResources, null);
189
+ assert.equal(fetchCalls.length, 1);
190
+ assert.equal(fetchCalls[0]?.url, 'https://relay.example/__crtr/source');
191
+ assert.deepEqual(fetchCalls[0]?.init?.headers, {
192
+ authorization: 'Bearer relay-token',
193
+ 'content-type': 'application/json',
194
+ });
195
+ });
196
+ test('status miss does not start wake/restore', async () => {
197
+ const tenantId = 'tenant-status-probe-fail';
198
+ const tempDir = mkdtempSync(join(tmpdir(), 'crouter-hearth-status-probe-fail-'));
199
+ const statePath = join(tempDir, 'state.json');
200
+ const registryPath = join(tempDir, 'homes.json');
201
+ writeState(statePath, tenantId);
202
+ const runtime = makeRuntime(tenantId, statePath);
203
+ runtime.proxy.m0RegistryPath = registryPath;
204
+ runtime.m0.registryPath = registryPath;
205
+ writeHome(registryPath, {
206
+ tenantId,
207
+ providerName: 'none',
208
+ machineId: 'test-machine',
209
+ homeStorage: {
210
+ kind: 'volume',
211
+ durability: 'durable-volume',
212
+ longTermContract: true,
213
+ ownerMachineId: 'test-machine',
214
+ guestHome: '/home/agent',
215
+ volumeId: 'volume-123',
216
+ mountPath: '/home/agent',
217
+ },
218
+ state: 'running',
219
+ nodeId: 'test-node',
220
+ relayToken: 'relay-token',
221
+ webRoute: {
222
+ routeId: 'https://relay.example',
223
+ machineId: 'test-machine',
224
+ targetPort: 7878,
225
+ url: 'https://relay.example',
226
+ concreteUrl: 'https://relay.example',
227
+ concreteUrlSource: 'config',
228
+ createdAt: '2026-06-26T00:00:00.000Z',
229
+ raw: null,
230
+ },
231
+ createdAt: '2026-06-26T00:00:00.000Z',
232
+ updatedAt: '2026-06-26T00:00:00.000Z',
233
+ });
234
+ let guestSourceCalls = 0;
235
+ const fetchCalls = [];
236
+ const res = makeResponse();
237
+ const handled = await routeRequest(makeRequest('GET', '/__hearth/status', { authorization: `Bearer ${ownerToken}` }), res, runtime, {
238
+ status: {
239
+ fetch: (async (url, init) => {
240
+ fetchCalls.push({ url: String(url), init: init ?? {} });
241
+ return {
242
+ ok: false,
243
+ status: 503,
244
+ statusText: 'Service Unavailable',
245
+ async text() {
246
+ return 'relay is down';
247
+ },
248
+ };
249
+ }),
250
+ guestSource: async () => {
251
+ guestSourceCalls += 1;
252
+ throw new Error('guestSource should not run on a status miss');
253
+ },
254
+ },
255
+ });
256
+ assert.equal(handled, undefined);
257
+ assert.equal(res.statusCode, 200);
258
+ const body = parseJsonBody(res);
259
+ assert.equal(body.runtimeStats, null);
260
+ assert.equal(fetchCalls.length, 1);
261
+ assert.equal(fetchCalls[0]?.url, 'https://relay.example/__crtr/source');
262
+ assert.equal(guestSourceCalls, 0);
263
+ });
264
+ test('status route returns null runtime stats when the probe output is invalid JSON', async () => {
265
+ const tenantId = 'tenant-status-parse-fail';
266
+ const tempDir = mkdtempSync(join(tmpdir(), 'crouter-hearth-status-parse-fail-'));
267
+ const statePath = join(tempDir, 'state.json');
268
+ const registryPath = join(tempDir, 'homes.json');
269
+ writeState(statePath, tenantId);
270
+ const runtime = makeRuntime(tenantId, statePath);
271
+ runtime.proxy.m0RegistryPath = registryPath;
272
+ runtime.m0.registryPath = registryPath;
273
+ writeHome(registryPath, {
274
+ tenantId,
275
+ providerName: 'none',
276
+ machineId: 'test-machine',
277
+ homeStorage: {
278
+ kind: 'volume',
279
+ durability: 'durable-volume',
280
+ longTermContract: true,
281
+ ownerMachineId: 'test-machine',
282
+ guestHome: '/home/agent',
283
+ volumeId: 'volume-123',
284
+ mountPath: '/home/agent',
285
+ },
286
+ state: 'running',
287
+ nodeId: 'test-node',
288
+ relayToken: 'relay-token',
289
+ webRoute: {
290
+ routeId: 'https://relay.example',
291
+ machineId: 'test-machine',
292
+ targetPort: 7878,
293
+ url: 'https://relay.example',
294
+ concreteUrl: 'https://relay.example',
295
+ concreteUrlSource: 'config',
296
+ createdAt: '2026-06-26T00:00:00.000Z',
297
+ raw: null,
298
+ },
299
+ createdAt: '2026-06-26T00:00:00.000Z',
300
+ updatedAt: '2026-06-26T00:00:00.000Z',
301
+ });
302
+ const res = makeResponse();
303
+ const handled = await routeRequest(makeRequest('GET', '/__hearth/status', { authorization: `Bearer ${ownerToken}` }), res, runtime, {
304
+ status: {
305
+ fetch: (async () => ({
306
+ ok: true,
307
+ status: 200,
308
+ statusText: 'OK',
309
+ async text() {
310
+ return 'not json';
311
+ },
312
+ })),
313
+ },
314
+ });
315
+ assert.equal(handled, undefined);
316
+ assert.equal(res.statusCode, 200);
317
+ const body = parseJsonBody(res);
318
+ assert.equal(body.runtimeStats, null);
319
+ });
320
+ test('status route returns machine resources from getMachine', async () => {
321
+ const tenantId = 'tenant-status-machine';
322
+ const tempDir = mkdtempSync(join(tmpdir(), 'crouter-hearth-status-machine-'));
323
+ const statePath = join(tempDir, 'state.json');
324
+ const registryPath = join(tempDir, 'homes.json');
325
+ writeState(statePath, tenantId);
326
+ writeFileSync(registryPath, `${JSON.stringify({
327
+ [tenantId]: {
328
+ tenantId,
329
+ providerName: 'none',
330
+ machineId: 'test-machine',
331
+ homeStorage: {
332
+ kind: 'volume',
333
+ durability: 'durable-volume',
334
+ longTermContract: true,
335
+ ownerMachineId: 'test-machine',
336
+ guestHome: '/home/agent',
337
+ volumeId: 'volume-123',
338
+ mountPath: '/home/agent',
339
+ },
340
+ state: 'running',
341
+ createdAt: '2026-06-26T00:00:00.000Z',
342
+ updatedAt: '2026-06-26T00:00:00.000Z',
343
+ },
344
+ }, null, 2)}\n`, 'utf8');
345
+ const runtime = makeRuntime(tenantId, statePath);
346
+ runtime.proxy.m0RegistryPath = registryPath;
347
+ runtime.m0.registryPath = registryPath;
348
+ const getMachine = async (machineId) => {
349
+ assert.equal(machineId, 'test-machine');
350
+ return {
351
+ providerName: 'none',
352
+ machineId: 'test-machine',
353
+ state: 'running',
354
+ raw: {
355
+ cpuCount: 2,
356
+ memoryMB: 2048,
357
+ status: 'running',
358
+ },
359
+ };
360
+ };
361
+ const res = makeResponse();
362
+ const handled = await routeRequest(makeRequest('GET', '/__hearth/status', { authorization: `Bearer ${ownerToken}` }), res, runtime, {
363
+ status: {
364
+ getMachine,
365
+ guestSource: async () => ({ ok: false, stdout: '', stderr: 'timeout' }),
366
+ },
367
+ });
368
+ assert.equal(handled, undefined);
369
+ assert.equal(res.statusCode, 200);
370
+ const body = parseJsonBody(res);
371
+ assert.deepEqual(body.machineResources, { cpuCount: 2, memoryMB: 2048 });
372
+ });
@@ -0,0 +1,258 @@
1
+ import assert from 'node:assert/strict';
2
+ import { createHash } from 'node:crypto';
3
+ import { EventEmitter } from 'node:events';
4
+ import { mkdtempSync, writeFileSync } from 'node:fs';
5
+ import { tmpdir } from 'node:os';
6
+ import { join } from 'node:path';
7
+ import { test } from 'node:test';
8
+ import { configureWakeProxyRuntime, wakeProxyInternals } from '../home.js';
9
+ import { proxyHttpRequest } from '../proxy.js';
10
+ // Regression for the HTTP wake-path 502/asset-timeout (hearth-soak-4a0dc43-report.md §4): every HTTP
11
+ // forward routed through ensureAwake, so a single momentary slow `probeRelayServing` under guest
12
+ // load false-negatived and escalated the request into the 150s wakeHome/waitForRelayReady
13
+ // path (serial guest execs) — while the direct route was returning 200 in ~0.1s the whole
14
+ // time. The fix: a home crtr already records `running` with a route+token is forwarded DIRECTLY (the
15
+ // forward is the liveness check); ensureAwake/restore is reserved for missing/not-running state or a
16
+ // clear upstream failure. These tests fail on the pre-fix code that gated all HTTP through ensureAwake.
17
+ const tenantId = 'silas';
18
+ const machineId = 'igd2fkrn1y1ol3vw5i6mt';
19
+ const nodeId = 'mqt64sus-e71caa94';
20
+ const routeUrl = 'https://7878-igd2fkrn1y1ol3vw5i6mt.example.dev';
21
+ const ownerToken = 'owner-secret-token';
22
+ const now = '2026-06-25T00:00:00.000Z';
23
+ function makeHome(overrides = {}) {
24
+ return {
25
+ tenantId,
26
+ providerName: 'none',
27
+ machineId,
28
+ homeStorage: {
29
+ kind: 'volume',
30
+ durability: 'durable-volume',
31
+ longTermContract: true,
32
+ ownerMachineId: machineId,
33
+ guestHome: '/home/agent',
34
+ volumeId: '48b59d07-8cc9-46f9-bdfd-ac99a55dff40',
35
+ mountPath: '/home/agent',
36
+ },
37
+ state: 'running',
38
+ nodeId,
39
+ relayToken: 'relay-token',
40
+ webRoute: {
41
+ routeId: '7878-igd2fkrn1y1ol3vw5i6mt.example.dev',
42
+ machineId,
43
+ targetPort: 7878,
44
+ url: routeUrl,
45
+ concreteUrl: routeUrl,
46
+ concreteUrlSource: 'provider',
47
+ createdAt: now,
48
+ raw: null,
49
+ },
50
+ createdAt: now,
51
+ updatedAt: now,
52
+ ...overrides,
53
+ };
54
+ }
55
+ function makeRuntime(registryPath, statePath) {
56
+ return {
57
+ proxy: {
58
+ host: '127.0.0.1',
59
+ port: 7878,
60
+ publicOrigin: 'https://hearth-wake-proxy.fly.dev',
61
+ statePath,
62
+ m0RegistryPath: registryPath,
63
+ ownerUserId: 'owner-user',
64
+ defaultTenantId: tenantId,
65
+ ownerTokenHash: createHash('sha256').update(ownerToken, 'utf8').digest('hex'),
66
+ idlePauseMs: 0,
67
+ wakeTimeoutMs: 30_000,
68
+ readyTimeoutMs: 2_000,
69
+ cookieSecure: true,
70
+ seedHome: null,
71
+ },
72
+ m0: {
73
+ providerName: 'none',
74
+ registryPath,
75
+ guestUser: 'agent',
76
+ guestHome: '/home/agent',
77
+ guestCodePath: '/opt/crouter',
78
+ webPort: 7878,
79
+ nodeKind: 'general',
80
+ piPackages: [],
81
+ piAuthJson: null,
82
+ relayToken: null,
83
+ },
84
+ };
85
+ }
86
+ function setup(home = makeHome()) {
87
+ const tempDir = mkdtempSync(join(tmpdir(), 'crouter-hearth-http-fast-'));
88
+ const registryPath = join(tempDir, 'homes.json');
89
+ const statePath = join(tempDir, 'state.json');
90
+ writeFileSync(registryPath, `${JSON.stringify({ [tenantId]: home }, null, 2)}\n`, 'utf8');
91
+ const runtime = makeRuntime(registryPath, statePath);
92
+ configureWakeProxyRuntime(runtime);
93
+ return runtime;
94
+ }
95
+ class FakeReq extends EventEmitter {
96
+ url;
97
+ method;
98
+ headers;
99
+ constructor(path, method = 'GET') {
100
+ super();
101
+ this.url = path;
102
+ this.method = method;
103
+ this.headers = { authorization: `Bearer ${ownerToken}`, host: 'hearth-wake-proxy.fly.dev' };
104
+ }
105
+ }
106
+ class FakeRes extends EventEmitter {
107
+ statusCode = 200;
108
+ statusMessage = '';
109
+ headersSent = false;
110
+ writableEnded = false;
111
+ headers = new Map();
112
+ chunks = [];
113
+ socket = { setNoDelay() { } };
114
+ setHeader(name, value) {
115
+ this.headers.set(name.toLowerCase(), value);
116
+ }
117
+ getHeader(name) {
118
+ return this.headers.get(name.toLowerCase());
119
+ }
120
+ hasHeader(name) {
121
+ return this.headers.has(name.toLowerCase());
122
+ }
123
+ writeHead(code, headers) {
124
+ this.statusCode = code;
125
+ this.headersSent = true;
126
+ if (headers)
127
+ for (const [k, v] of Object.entries(headers))
128
+ this.setHeader(k, v);
129
+ }
130
+ flushHeaders() {
131
+ this.headersSent = true;
132
+ }
133
+ write(chunk) {
134
+ this.headersSent = true;
135
+ this.chunks.push(Buffer.from(chunk));
136
+ return true;
137
+ }
138
+ end(chunk) {
139
+ this.headersSent = true;
140
+ if (chunk !== undefined)
141
+ this.chunks.push(Buffer.from(chunk));
142
+ this.writableEnded = true;
143
+ this.emit('finish');
144
+ }
145
+ destroy() {
146
+ this.writableEnded = true;
147
+ }
148
+ body() {
149
+ return Buffer.concat(this.chunks).toString('utf8');
150
+ }
151
+ }
152
+ function asReq(req) {
153
+ return req;
154
+ }
155
+ function asRes(res) {
156
+ return res;
157
+ }
158
+ function htmlResponse(text) {
159
+ return new Response(text, { status: 200, headers: { 'content-type': 'text/html; charset=utf-8' } });
160
+ }
161
+ function guardHeavyPath(t) {
162
+ const probe = t.mock.method(wakeProxyInternals, 'probeRelayServing', async () => {
163
+ throw new Error('probeRelayServing must not run on the running-route fast path');
164
+ });
165
+ const wake = t.mock.method(wakeProxyInternals, 'wakeHome', async () => {
166
+ throw new Error('wakeHome must not run on the running-route fast path');
167
+ });
168
+ return { probe, wake };
169
+ }
170
+ test('HTTP request against a known-running route forwards directly without the heavy wake/restore path', async (t) => {
171
+ const runtime = setup();
172
+ const { probe, wake } = guardHeavyPath(t);
173
+ const fetchMock = t.mock.method(globalThis, 'fetch', async () => htmlResponse('<html>chat</html>'));
174
+ const res = new FakeRes();
175
+ await proxyHttpRequest(asReq(new FakeReq('/views/chat')), asRes(res), runtime);
176
+ assert.equal(res.statusCode, 200);
177
+ assert.equal(res.body(), '<html>chat</html>');
178
+ assert.equal(fetchMock.mock.callCount(), 1);
179
+ // The forward went straight to the persisted route — never through ensureAwake's probe/wake.
180
+ assert.equal(probe.mock.callCount(), 0);
181
+ assert.equal(wake.mock.callCount(), 0);
182
+ });
183
+ test('concurrent asset/page requests forward in parallel without serializing behind a slow guest probe', async (t) => {
184
+ const runtime = setup();
185
+ const { probe, wake } = guardHeavyPath(t);
186
+ let inFlight = 0;
187
+ let maxInFlight = 0;
188
+ let release;
189
+ const gate = new Promise((resolve) => {
190
+ release = resolve;
191
+ });
192
+ const fetchMock = t.mock.method(globalThis, 'fetch', async () => {
193
+ inFlight += 1;
194
+ maxInFlight = Math.max(maxInFlight, inFlight);
195
+ await gate;
196
+ inFlight -= 1;
197
+ return htmlResponse('<html>asset</html>');
198
+ });
199
+ const paths = ['/views/chat', '/assets/index-a.css', '/assets/index-b.js', '/assets/index-c.js', '/favicon.svg'];
200
+ const responses = paths.map(() => new FakeRes());
201
+ const calls = paths.map((p, i) => proxyHttpRequest(asReq(new FakeReq(p)), asRes(responses[i]), runtime));
202
+ // Let all five enter forwardUpstream before any resolves; if they serialized behind a per-tenant
203
+ // wake lock/probe, only one would be in flight here.
204
+ await new Promise((resolve) => setTimeout(resolve, 20));
205
+ const concurrentBeforeRelease = maxInFlight;
206
+ release();
207
+ await Promise.all(calls);
208
+ assert.equal(concurrentBeforeRelease, paths.length);
209
+ assert.equal(fetchMock.mock.callCount(), paths.length);
210
+ for (const res of responses) {
211
+ assert.equal(res.statusCode, 200);
212
+ assert.equal(res.body(), '<html>asset</html>');
213
+ }
214
+ assert.equal(probe.mock.callCount(), 0);
215
+ assert.equal(wake.mock.callCount(), 0);
216
+ });
217
+ test('a clear upstream failure against the running route invalidates the verdict and wakes deliberately', async (t) => {
218
+ const runtime = setup();
219
+ // ensureAwake's deliberate wake path: the route IS serving (probe true), so it confirms via the
220
+ // cheap probe and never restores — the point is that the failed direct forward ESCALATED into
221
+ // ensureAwake rather than silently 502ing.
222
+ const probe = t.mock.method(wakeProxyInternals, 'probeRelayServing', async () => true);
223
+ const wake = t.mock.method(wakeProxyInternals, 'wakeHome', async () => {
224
+ throw new Error('wakeHome must not run when the relay is serving');
225
+ });
226
+ t.mock.method(wakeProxyInternals, 'touchTenantWake', async () => undefined);
227
+ let fetchCalls = 0;
228
+ const fetchMock = t.mock.method(globalThis, 'fetch', async () => {
229
+ fetchCalls += 1;
230
+ if (fetchCalls === 1)
231
+ throw new TypeError('fetch failed'); // connection refused against stale route
232
+ return htmlResponse('<html>recovered</html>');
233
+ });
234
+ const res = new FakeRes();
235
+ await proxyHttpRequest(asReq(new FakeReq('/views/chat')), asRes(res), runtime);
236
+ assert.equal(res.statusCode, 200);
237
+ assert.equal(res.body(), '<html>recovered</html>');
238
+ assert.equal(fetchMock.mock.callCount(), 2); // direct forward failed, deliberate wake forward succeeded
239
+ assert.equal(probe.mock.callCount(), 1); // entered ensureAwake exactly once
240
+ assert.equal(wake.mock.callCount(), 0);
241
+ });
242
+ test('not-running home skips the fast path and goes straight to the deliberate wake', async (t) => {
243
+ const runtime = setup(makeHome({ state: 'paused' }));
244
+ const probe = t.mock.method(wakeProxyInternals, 'probeRelayServing', async () => true);
245
+ const wake = t.mock.method(wakeProxyInternals, 'wakeHome', async () => {
246
+ throw new Error('wakeHome must not run when the relay is serving');
247
+ });
248
+ t.mock.method(wakeProxyInternals, 'touchTenantWake', async () => undefined);
249
+ const fetchMock = t.mock.method(globalThis, 'fetch', async () => htmlResponse('<html>woke</html>'));
250
+ const res = new FakeRes();
251
+ await proxyHttpRequest(asReq(new FakeReq('/views/chat')), asRes(res), runtime);
252
+ assert.equal(res.statusCode, 200);
253
+ assert.equal(res.body(), '<html>woke</html>');
254
+ // Paused home is not trusted directly — it must enter ensureAwake (probe runs) before forwarding.
255
+ assert.equal(probe.mock.callCount(), 1);
256
+ assert.equal(wake.mock.callCount(), 0);
257
+ assert.equal(fetchMock.mock.callCount(), 1);
258
+ });