harnery 0.40.0 → 0.41.0

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 (441) hide show
  1. package/README.md +1 -1
  2. package/dist/commander.js +1 -0
  3. package/dist/commands/agents.d.ts.map +1 -1
  4. package/dist/commands/agents.js +25 -19
  5. package/dist/commands/browse-ai.d.ts.map +1 -1
  6. package/dist/commands/browse-ai.js +4 -0
  7. package/dist/commands/browse.d.ts.map +1 -1
  8. package/dist/commands/browse.js +141 -10
  9. package/dist/commands/checkpoint.js +8 -12
  10. package/dist/commands/deinit.d.ts +1 -1
  11. package/dist/commands/deinit.d.ts.map +1 -1
  12. package/dist/commands/deinit.js +8 -4
  13. package/dist/commands/docs.d.ts.map +1 -1
  14. package/dist/commands/docs.js +2 -0
  15. package/dist/commands/doctor.js +10 -2
  16. package/dist/commands/fetch.d.ts.map +1 -1
  17. package/dist/commands/fetch.js +10 -0
  18. package/dist/commands/init.d.ts +19 -3
  19. package/dist/commands/init.d.ts.map +1 -1
  20. package/dist/commands/init.js +232 -104
  21. package/dist/commands/instructions.js +5 -4
  22. package/dist/commands/ledger-v3.d.ts.map +1 -1
  23. package/dist/commands/ledger-v3.js +2 -1
  24. package/dist/commands/webview.d.ts +4 -0
  25. package/dist/commands/webview.d.ts.map +1 -0
  26. package/dist/commands/webview.js +94 -0
  27. package/dist/core/adapter.d.ts +50 -1
  28. package/dist/core/adapter.d.ts.map +1 -1
  29. package/dist/core/adapter.js +59 -1
  30. package/dist/core/adapters/attestation.d.ts.map +1 -1
  31. package/dist/core/adapters/attestation.js +3 -2
  32. package/dist/core/adapters/profiles.d.ts +20 -3
  33. package/dist/core/adapters/profiles.d.ts.map +1 -1
  34. package/dist/core/adapters/profiles.js +32 -1
  35. package/dist/core/adapters/registry.d.ts.map +1 -1
  36. package/dist/core/adapters/registry.js +33 -0
  37. package/dist/core/agents/canonical-emit.d.ts +1 -1
  38. package/dist/core/agents/canonical-emit.d.ts.map +1 -1
  39. package/dist/core/agents/canonical-emit.js +2 -7
  40. package/dist/core/agents/cli.js +18 -16
  41. package/dist/core/agents/coord-client.d.ts.map +1 -1
  42. package/dist/core/agents/coord-client.js +7 -2
  43. package/dist/core/agents/rules/claim-conflict.d.ts.map +1 -1
  44. package/dist/core/agents/rules/claim-conflict.js +3 -9
  45. package/dist/core/agents/rules/commit-conflict.d.ts.map +1 -1
  46. package/dist/core/agents/rules/commit-conflict.js +2 -8
  47. package/dist/core/agents/rules/stop-hook.d.ts +2 -0
  48. package/dist/core/agents/rules/stop-hook.d.ts.map +1 -1
  49. package/dist/core/agents/rules/stop-hook.js +1 -1
  50. package/dist/core/agents/session-events.d.ts +6 -2
  51. package/dist/core/agents/session-events.d.ts.map +1 -1
  52. package/dist/core/agents/session-events.js +105 -26
  53. package/dist/core/agents/session-finalization-state-v3.d.ts.map +1 -1
  54. package/dist/core/agents/session-finalization-state-v3.js +2 -1
  55. package/dist/core/agents/session-finalizer-v3.d.ts.map +1 -1
  56. package/dist/core/agents/session-finalizer-v3.js +5 -4
  57. package/dist/core/agents/session-name-display.d.ts +28 -0
  58. package/dist/core/agents/session-name-display.d.ts.map +1 -1
  59. package/dist/core/agents/session-name-display.js +43 -0
  60. package/dist/core/agents/state/heartbeat-reader.d.ts +7 -0
  61. package/dist/core/agents/state/heartbeat-reader.d.ts.map +1 -1
  62. package/dist/core/agents/state/heartbeat-writer.d.ts +10 -0
  63. package/dist/core/agents/state/heartbeat-writer.d.ts.map +1 -1
  64. package/dist/core/agents/state/heartbeat-writer.js +21 -2
  65. package/dist/core/agents/state/live-coordination-view.d.ts.map +1 -1
  66. package/dist/core/agents/state/live-coordination-view.js +1 -0
  67. package/dist/core/agents/state/live-coordination-writer.js +3 -0
  68. package/dist/core/agents/state/stale-sweep.d.ts.map +1 -1
  69. package/dist/core/agents/state/stale-sweep.js +2 -10
  70. package/dist/core/agents/turn-changes.d.ts +17 -0
  71. package/dist/core/agents/turn-changes.d.ts.map +1 -0
  72. package/dist/core/agents/turn-changes.js +76 -0
  73. package/dist/core/artifacts/delivery-card.d.ts.map +1 -1
  74. package/dist/core/artifacts/delivery-card.js +2 -1
  75. package/dist/core/artifacts/index.d.ts.map +1 -1
  76. package/dist/core/artifacts/index.js +4 -3
  77. package/dist/core/config.d.ts +5 -0
  78. package/dist/core/config.d.ts.map +1 -1
  79. package/dist/core/config.js +14 -0
  80. package/dist/core/context/index.d.ts.map +1 -1
  81. package/dist/core/context/index.js +2 -1
  82. package/dist/core/conversations/archive.d.ts.map +1 -1
  83. package/dist/core/conversations/archive.js +4 -3
  84. package/dist/core/diagnostics/bundle.d.ts.map +1 -1
  85. package/dist/core/diagnostics/bundle.js +3 -2
  86. package/dist/core/events/legacy-storage/canary.d.ts.map +1 -1
  87. package/dist/core/events/legacy-storage/canary.js +5 -4
  88. package/dist/core/events/legacy-storage/compression.d.ts.map +1 -1
  89. package/dist/core/events/legacy-storage/compression.js +2 -1
  90. package/dist/core/events/v3/adapter-id.d.ts +10 -2
  91. package/dist/core/events/v3/adapter-id.d.ts.map +1 -1
  92. package/dist/core/events/v3/adapter-id.js +16 -0
  93. package/dist/core/events/v3/authority-outbox.d.ts.map +1 -1
  94. package/dist/core/events/v3/authority-outbox.js +2 -1
  95. package/dist/core/events/v3/bootstrap.d.ts.map +1 -1
  96. package/dist/core/events/v3/bootstrap.js +5 -4
  97. package/dist/core/events/v3/capabilities.d.ts.map +1 -1
  98. package/dist/core/events/v3/capabilities.js +17 -0
  99. package/dist/core/events/v3/contract.d.ts +5 -0
  100. package/dist/core/events/v3/contract.d.ts.map +1 -1
  101. package/dist/core/events/v3/contract.js +7 -1
  102. package/dist/core/events/v3/control-witness.d.ts.map +1 -1
  103. package/dist/core/events/v3/control-witness.js +3 -2
  104. package/dist/core/events/v3/coordination-transaction-recovery.d.ts.map +1 -1
  105. package/dist/core/events/v3/coordination-transaction-recovery.js +4 -3
  106. package/dist/core/events/v3/fingerprint-keys.d.ts.map +1 -1
  107. package/dist/core/events/v3/fingerprint-keys.js +7 -6
  108. package/dist/core/events/v3/generated.d.ts +1 -1
  109. package/dist/core/events/v3/generated.js +1 -1
  110. package/dist/core/events/v3/live-feed.d.ts.map +1 -1
  111. package/dist/core/events/v3/live-feed.js +5 -4
  112. package/dist/core/events/v3/producers/command-recorder.d.ts.map +1 -1
  113. package/dist/core/events/v3/producers/command-recorder.js +8 -7
  114. package/dist/core/events/v3/producers/coordination-recorder.d.ts.map +1 -1
  115. package/dist/core/events/v3/producers/coordination-recorder.js +8 -7
  116. package/dist/core/events/v3/producers/diagnostic-summaries.d.ts.map +1 -1
  117. package/dist/core/events/v3/producers/diagnostic-summaries.js +5 -4
  118. package/dist/core/events/v3/producers/hook-base.d.ts +1 -0
  119. package/dist/core/events/v3/producers/hook-base.d.ts.map +1 -1
  120. package/dist/core/events/v3/producers/hook-base.js +10 -4
  121. package/dist/core/events/v3/producers/hook.d.ts +2 -0
  122. package/dist/core/events/v3/producers/hook.d.ts.map +1 -1
  123. package/dist/core/events/v3/producers/hook.js +16 -1
  124. package/dist/core/events/v3/producers/intake.d.ts.map +1 -1
  125. package/dist/core/events/v3/producers/intake.js +16 -6
  126. package/dist/core/events/v3/producers/recorder.d.ts +2 -4
  127. package/dist/core/events/v3/producers/recorder.d.ts.map +1 -1
  128. package/dist/core/events/v3/producers/recorder.js +109 -101
  129. package/dist/core/events/v3/recovery.d.ts.map +1 -1
  130. package/dist/core/events/v3/recovery.js +4 -3
  131. package/dist/core/events/v3/support-storage/inventory.d.ts.map +1 -1
  132. package/dist/core/events/v3/support-storage/inventory.js +2 -1
  133. package/dist/core/events/v3/support-storage/maintenance.d.ts.map +1 -1
  134. package/dist/core/events/v3/support-storage/maintenance.js +4 -3
  135. package/dist/core/events/v3/support-storage/pack-reader.d.ts.map +1 -1
  136. package/dist/core/events/v3/support-storage/pack-reader.js +4 -3
  137. package/dist/core/events/v3/support-storage/pack-writer.d.ts.map +1 -1
  138. package/dist/core/events/v3/support-storage/pack-writer.js +6 -5
  139. package/dist/core/events/v3/tool-line-changes.d.ts +8 -0
  140. package/dist/core/events/v3/tool-line-changes.d.ts.map +1 -0
  141. package/dist/core/events/v3/tool-line-changes.js +135 -0
  142. package/dist/core/events/v3/writer.d.ts.map +1 -1
  143. package/dist/core/events/v3/writer.js +8 -7
  144. package/dist/core/governor/planning.d.ts.map +1 -1
  145. package/dist/core/governor/planning.js +6 -5
  146. package/dist/core/governor/service.d.ts.map +1 -1
  147. package/dist/core/governor/service.js +12 -11
  148. package/dist/core/governor/state.d.ts.map +1 -1
  149. package/dist/core/governor/state.js +7 -6
  150. package/dist/core/guard/evaluator.js +1 -0
  151. package/dist/core/guard/storage.d.ts.map +1 -1
  152. package/dist/core/guard/storage.js +3 -2
  153. package/dist/core/hooks/adapter/behaviors/claude-code.d.ts +4 -0
  154. package/dist/core/hooks/adapter/behaviors/claude-code.d.ts.map +1 -0
  155. package/dist/core/hooks/adapter/behaviors/claude-code.js +31 -0
  156. package/dist/core/hooks/adapter/behaviors/codex.d.ts +15 -0
  157. package/dist/core/hooks/adapter/behaviors/codex.d.ts.map +1 -0
  158. package/dist/core/hooks/adapter/behaviors/codex.js +82 -0
  159. package/dist/core/hooks/adapter/behaviors/cursor.d.ts +7 -0
  160. package/dist/core/hooks/adapter/behaviors/cursor.d.ts.map +1 -0
  161. package/dist/core/hooks/adapter/behaviors/cursor.js +35 -0
  162. package/dist/core/hooks/adapter/behaviors/index.d.ts +11 -0
  163. package/dist/core/hooks/adapter/behaviors/index.d.ts.map +1 -0
  164. package/dist/core/hooks/adapter/behaviors/index.js +20 -0
  165. package/dist/core/hooks/adapter/behaviors/openclaw.d.ts +7 -0
  166. package/dist/core/hooks/adapter/behaviors/openclaw.d.ts.map +1 -0
  167. package/dist/core/hooks/adapter/behaviors/openclaw.js +34 -0
  168. package/dist/core/hooks/adapter/behaviors/opencode.d.ts +7 -0
  169. package/dist/core/hooks/adapter/behaviors/opencode.d.ts.map +1 -0
  170. package/dist/core/hooks/adapter/behaviors/opencode.js +34 -0
  171. package/dist/core/hooks/adapter/behaviors/types.d.ts +89 -0
  172. package/dist/core/hooks/adapter/behaviors/types.d.ts.map +1 -0
  173. package/dist/core/hooks/adapter/behaviors/types.js +1 -0
  174. package/dist/core/hooks/adapter/detect.d.ts +1 -1
  175. package/dist/core/hooks/adapter/detect.d.ts.map +1 -1
  176. package/dist/core/hooks/adapter/detect.js +2 -3
  177. package/dist/core/hooks/adapter/events.d.ts +29 -1
  178. package/dist/core/hooks/adapter/events.d.ts.map +1 -1
  179. package/dist/core/hooks/adapter/events.js +31 -0
  180. package/dist/core/hooks/adapter/opencode-plugin.d.ts +60 -0
  181. package/dist/core/hooks/adapter/opencode-plugin.d.ts.map +1 -0
  182. package/dist/core/hooks/adapter/opencode-plugin.js +129 -0
  183. package/dist/core/hooks/adapter/output.d.ts +7 -0
  184. package/dist/core/hooks/adapter/output.d.ts.map +1 -1
  185. package/dist/core/hooks/adapter/output.js +8 -1
  186. package/dist/core/hooks/adapter/wiring.d.ts +15 -1
  187. package/dist/core/hooks/adapter/wiring.d.ts.map +1 -1
  188. package/dist/core/hooks/adapter/wiring.js +74 -11
  189. package/dist/core/hooks/cli.js +635 -529
  190. package/dist/core/hooks/effects/image-capture.d.ts.map +1 -1
  191. package/dist/core/hooks/effects/image-capture.js +2 -1
  192. package/dist/core/hooks/prompt-context/contract.d.ts.map +1 -1
  193. package/dist/core/hooks/prompt-context/contract.js +1 -0
  194. package/dist/core/hooks/resolve/transcript.d.ts +1 -1
  195. package/dist/core/hooks/resolve/transcript.d.ts.map +1 -1
  196. package/dist/core/hooks/resolve/transcript.js +35 -4
  197. package/dist/core/hooks/session-name-presence.d.ts +3 -1
  198. package/dist/core/hooks/session-name-presence.d.ts.map +1 -1
  199. package/dist/core/hooks/session-name-presence.js +7 -2
  200. package/dist/core/hooks/shell-waiter.d.ts +2 -0
  201. package/dist/core/hooks/shell-waiter.d.ts.map +1 -0
  202. package/dist/core/hooks/shell-waiter.js +173 -0
  203. package/dist/core/resources/service.d.ts.map +1 -1
  204. package/dist/core/resources/service.js +5 -4
  205. package/dist/core/semantic/review.d.ts.map +1 -1
  206. package/dist/core/semantic/review.js +5 -4
  207. package/dist/core/semantic/service.d.ts.map +1 -1
  208. package/dist/core/semantic/service.js +15 -14
  209. package/dist/core/semantic/storage.d.ts.map +1 -1
  210. package/dist/core/semantic/storage.js +5 -4
  211. package/dist/core/storage/atomic-json.d.ts.map +1 -1
  212. package/dist/core/storage/atomic-json.js +7 -3
  213. package/dist/core/storage/durable-history.d.ts.map +1 -1
  214. package/dist/core/storage/durable-history.js +6 -5
  215. package/dist/core/storage/maintenance-providers.d.ts.map +1 -1
  216. package/dist/core/storage/maintenance-providers.js +2 -1
  217. package/dist/core/storage/maintenance.d.ts.map +1 -1
  218. package/dist/core/storage/maintenance.js +7 -6
  219. package/dist/core/storage/metrics.d.ts.map +1 -1
  220. package/dist/core/storage/metrics.js +5 -1
  221. package/dist/core/storage/modes.d.ts +17 -0
  222. package/dist/core/storage/modes.d.ts.map +1 -0
  223. package/dist/core/storage/modes.js +47 -0
  224. package/dist/core/storage/process-log.d.ts.map +1 -1
  225. package/dist/core/storage/process-log.js +3 -2
  226. package/dist/core/storage/receipts.d.ts.map +1 -1
  227. package/dist/core/storage/receipts.js +4 -3
  228. package/dist/core/storage/segments.d.ts.map +1 -1
  229. package/dist/core/storage/segments.js +7 -6
  230. package/dist/core/supervisor/hook-health.d.ts +2 -1
  231. package/dist/core/supervisor/hook-health.d.ts.map +1 -1
  232. package/dist/core/supervisor/hook-health.js +4 -3
  233. package/dist/core/supervisor/service.d.ts.map +1 -1
  234. package/dist/core/supervisor/service.js +7 -6
  235. package/dist/core/work/state.d.ts.map +1 -1
  236. package/dist/core/work/state.js +8 -7
  237. package/dist/core/workflow/adapters.d.ts +7 -0
  238. package/dist/core/workflow/adapters.d.ts.map +1 -1
  239. package/dist/core/workflow/adapters.js +9 -0
  240. package/dist/core/workflow/approvals.d.ts.map +1 -1
  241. package/dist/core/workflow/approvals.js +6 -5
  242. package/dist/core/workflow/billing.d.ts.map +1 -1
  243. package/dist/core/workflow/billing.js +33 -4
  244. package/dist/core/workflow/durable-record.d.ts.map +1 -1
  245. package/dist/core/workflow/durable-record.js +4 -3
  246. package/dist/core/workflow/live-session-v3.d.ts.map +1 -1
  247. package/dist/core/workflow/live-session-v3.js +2 -3
  248. package/dist/core/workflow/run-state.d.ts.map +1 -1
  249. package/dist/core/workflow/run-state.js +3 -2
  250. package/dist/core/workflow/spawn-opencode.d.ts +36 -0
  251. package/dist/core/workflow/spawn-opencode.d.ts.map +1 -0
  252. package/dist/core/workflow/spawn-opencode.js +132 -0
  253. package/dist/core/workflow/transcript.d.ts.map +1 -1
  254. package/dist/core/workflow/transcript.js +3 -2
  255. package/dist/core/workflow/workspaces/leases.d.ts.map +1 -1
  256. package/dist/core/workflow/workspaces/leases.js +5 -4
  257. package/dist/core/workflow/workspaces/local-git.d.ts.map +1 -1
  258. package/dist/core/workflow/workspaces/local-git.js +3 -2
  259. package/dist/core/workflow/workspaces/paths.d.ts.map +1 -1
  260. package/dist/core/workflow/workspaces/paths.js +2 -1
  261. package/dist/core/workflow/workspaces/state.d.ts.map +1 -1
  262. package/dist/core/workflow/workspaces/state.js +10 -9
  263. package/dist/lazy-commands.js +8 -1
  264. package/dist/lib/agent-browser/client.d.ts +9 -0
  265. package/dist/lib/agent-browser/client.d.ts.map +1 -1
  266. package/dist/lib/agent-browser/client.js +13 -0
  267. package/dist/lib/browser/client.d.ts +35 -1
  268. package/dist/lib/browser/client.d.ts.map +1 -1
  269. package/dist/lib/browser/client.js +117 -8
  270. package/dist/lib/browser/identity.d.ts +25 -0
  271. package/dist/lib/browser/identity.d.ts.map +1 -0
  272. package/dist/lib/browser/identity.js +66 -0
  273. package/dist/lib/browser/index.d.ts +2 -1
  274. package/dist/lib/browser/index.d.ts.map +1 -1
  275. package/dist/lib/browser/index.js +2 -1
  276. package/dist/lib/browser/launch-args.d.ts +26 -0
  277. package/dist/lib/browser/launch-args.d.ts.map +1 -1
  278. package/dist/lib/browser/launch-args.js +41 -1
  279. package/dist/lib/browser/user-agent.d.ts +53 -0
  280. package/dist/lib/browser/user-agent.d.ts.map +1 -0
  281. package/dist/lib/browser/user-agent.js +79 -0
  282. package/dist/lib/docs-metadata-managed.d.ts +1 -0
  283. package/dist/lib/docs-metadata-managed.d.ts.map +1 -1
  284. package/dist/lib/docs-metadata-managed.js +17 -1
  285. package/dist/lib/identities/assume.d.ts.map +1 -1
  286. package/dist/lib/identities/assume.js +4 -9
  287. package/dist/lib/instructions/apply.d.ts.map +1 -1
  288. package/dist/lib/instructions/apply.js +2 -0
  289. package/dist/lib/pace/index.d.ts +2 -0
  290. package/dist/lib/pace/index.d.ts.map +1 -0
  291. package/dist/lib/pace/index.js +1 -0
  292. package/dist/lib/pace/pace.d.ts +95 -0
  293. package/dist/lib/pace/pace.d.ts.map +1 -0
  294. package/dist/lib/pace/pace.js +313 -0
  295. package/dist/lib/tunnel/forward-headers.d.ts +11 -0
  296. package/dist/lib/tunnel/forward-headers.d.ts.map +1 -0
  297. package/dist/lib/tunnel/forward-headers.js +17 -0
  298. package/dist/lib/tunnel/gate.js +15 -10
  299. package/dist/lib/webview/index.d.ts +2 -0
  300. package/dist/lib/webview/index.d.ts.map +1 -0
  301. package/dist/lib/webview/index.js +1 -0
  302. package/dist/lib/webview/webview.d.ts +116 -0
  303. package/dist/lib/webview/webview.d.ts.map +1 -0
  304. package/dist/lib/webview/webview.js +289 -0
  305. package/opencode-plugin/package.json +19 -0
  306. package/opencode-plugin/src/index.ts +791 -0
  307. package/package.json +11 -4
  308. package/schemas/config.schema.json +13 -0
  309. package/schemas/event-v3.schema.json +164 -0
  310. package/src/commander.ts +7 -0
  311. package/src/commands/agents.ts +33 -18
  312. package/src/commands/browse-ai.ts +8 -0
  313. package/src/commands/browse.ts +189 -10
  314. package/src/commands/checkpoint.ts +7 -9
  315. package/src/commands/deinit.ts +9 -4
  316. package/src/commands/docs.ts +2 -0
  317. package/src/commands/doctor.ts +11 -2
  318. package/src/commands/fetch.ts +14 -0
  319. package/src/commands/init.ts +281 -119
  320. package/src/commands/instructions.ts +8 -4
  321. package/src/commands/ledger-v3.ts +2 -1
  322. package/src/commands/webview.ts +159 -0
  323. package/src/core/adapter.ts +102 -1
  324. package/src/core/adapters/attestation.ts +3 -2
  325. package/src/core/adapters/profiles.ts +42 -1
  326. package/src/core/adapters/registry.ts +37 -0
  327. package/src/core/agents/canonical-emit.ts +2 -5
  328. package/src/core/agents/cli.ts +18 -17
  329. package/src/core/agents/coord-client.ts +9 -3
  330. package/src/core/agents/rules/claim-conflict.ts +3 -8
  331. package/src/core/agents/rules/commit-conflict.ts +2 -7
  332. package/src/core/agents/rules/stop-hook.ts +3 -1
  333. package/src/core/agents/session-events.ts +120 -26
  334. package/src/core/agents/session-finalization-state-v3.ts +2 -1
  335. package/src/core/agents/session-finalizer-v3.ts +5 -4
  336. package/src/core/agents/session-name-display.ts +48 -0
  337. package/src/core/agents/state/heartbeat-reader.ts +7 -0
  338. package/src/core/agents/state/heartbeat-writer.ts +24 -2
  339. package/src/core/agents/state/live-coordination-view.ts +1 -0
  340. package/src/core/agents/state/live-coordination-writer.ts +3 -0
  341. package/src/core/agents/state/stale-sweep.ts +2 -9
  342. package/src/core/agents/turn-changes.ts +97 -0
  343. package/src/core/artifacts/delivery-card.ts +2 -1
  344. package/src/core/artifacts/index.ts +4 -3
  345. package/src/core/config.ts +23 -0
  346. package/src/core/context/index.ts +2 -1
  347. package/src/core/conversations/archive.ts +4 -3
  348. package/src/core/diagnostics/bundle.ts +3 -2
  349. package/src/core/events/legacy-storage/canary.ts +5 -4
  350. package/src/core/events/legacy-storage/compression.ts +2 -1
  351. package/src/core/events/v3/adapter-id.ts +29 -1
  352. package/src/core/events/v3/authority-outbox.ts +2 -1
  353. package/src/core/events/v3/bootstrap.ts +5 -4
  354. package/src/core/events/v3/capabilities.ts +17 -0
  355. package/src/core/events/v3/contract.ts +9 -1
  356. package/src/core/events/v3/control-witness.ts +3 -2
  357. package/src/core/events/v3/coordination-transaction-recovery.ts +4 -3
  358. package/src/core/events/v3/fingerprint-keys.ts +7 -6
  359. package/src/core/events/v3/generated.ts +1 -1
  360. package/src/core/events/v3/live-feed.ts +5 -4
  361. package/src/core/events/v3/producers/command-recorder.ts +8 -6
  362. package/src/core/events/v3/producers/coordination-recorder.ts +8 -7
  363. package/src/core/events/v3/producers/diagnostic-summaries.ts +5 -4
  364. package/src/core/events/v3/producers/hook-base.ts +11 -4
  365. package/src/core/events/v3/producers/hook.ts +19 -1
  366. package/src/core/events/v3/producers/intake.ts +18 -6
  367. package/src/core/events/v3/producers/recorder.ts +123 -114
  368. package/src/core/events/v3/recovery.ts +4 -3
  369. package/src/core/events/v3/support-storage/inventory.ts +2 -1
  370. package/src/core/events/v3/support-storage/maintenance.ts +8 -3
  371. package/src/core/events/v3/support-storage/pack-reader.ts +4 -3
  372. package/src/core/events/v3/support-storage/pack-writer.ts +6 -5
  373. package/src/core/events/v3/tool-line-changes.ts +139 -0
  374. package/src/core/events/v3/writer.ts +8 -7
  375. package/src/core/governor/planning.ts +6 -5
  376. package/src/core/governor/service.ts +12 -11
  377. package/src/core/governor/state.ts +7 -6
  378. package/src/core/guard/evaluator.ts +1 -0
  379. package/src/core/guard/storage.ts +3 -2
  380. package/src/core/hooks/adapter/behaviors/claude-code.ts +33 -0
  381. package/src/core/hooks/adapter/behaviors/codex.ts +96 -0
  382. package/src/core/hooks/adapter/behaviors/cursor.ts +37 -0
  383. package/src/core/hooks/adapter/behaviors/index.ts +31 -0
  384. package/src/core/hooks/adapter/behaviors/openclaw.ts +36 -0
  385. package/src/core/hooks/adapter/behaviors/opencode.ts +36 -0
  386. package/src/core/hooks/adapter/behaviors/types.ts +110 -0
  387. package/src/core/hooks/adapter/detect.ts +2 -3
  388. package/src/core/hooks/adapter/events.ts +53 -1
  389. package/src/core/hooks/adapter/opencode-plugin.ts +177 -0
  390. package/src/core/hooks/adapter/output.ts +8 -1
  391. package/src/core/hooks/adapter/wiring.ts +85 -11
  392. package/src/core/hooks/cli.ts +733 -537
  393. package/src/core/hooks/effects/image-capture.ts +2 -1
  394. package/src/core/hooks/prompt-context/contract.ts +1 -0
  395. package/src/core/hooks/resolve/transcript.ts +42 -5
  396. package/src/core/hooks/session-name-presence.ts +10 -3
  397. package/src/core/hooks/shell-waiter.ts +166 -0
  398. package/src/core/resources/service.ts +5 -4
  399. package/src/core/semantic/review.ts +5 -4
  400. package/src/core/semantic/service.ts +15 -14
  401. package/src/core/semantic/storage.ts +5 -4
  402. package/src/core/storage/atomic-json.ts +7 -3
  403. package/src/core/storage/durable-history.ts +6 -5
  404. package/src/core/storage/maintenance-providers.ts +2 -1
  405. package/src/core/storage/maintenance.ts +7 -6
  406. package/src/core/storage/metrics.ts +5 -1
  407. package/src/core/storage/modes.ts +53 -0
  408. package/src/core/storage/process-log.ts +3 -2
  409. package/src/core/storage/receipts.ts +4 -3
  410. package/src/core/storage/segments.ts +7 -6
  411. package/src/core/supervisor/hook-health.ts +4 -4
  412. package/src/core/supervisor/service.ts +7 -6
  413. package/src/core/work/state.ts +8 -7
  414. package/src/core/workflow/adapters.ts +15 -0
  415. package/src/core/workflow/approvals.ts +6 -5
  416. package/src/core/workflow/billing.ts +34 -4
  417. package/src/core/workflow/durable-record.ts +4 -3
  418. package/src/core/workflow/live-session-v3.ts +2 -3
  419. package/src/core/workflow/run-state.ts +3 -2
  420. package/src/core/workflow/spawn-opencode.ts +150 -0
  421. package/src/core/workflow/transcript.ts +3 -2
  422. package/src/core/workflow/workspaces/leases.ts +5 -4
  423. package/src/core/workflow/workspaces/local-git.ts +3 -2
  424. package/src/core/workflow/workspaces/paths.ts +2 -1
  425. package/src/core/workflow/workspaces/state.ts +10 -9
  426. package/src/lazy-commands.ts +11 -1
  427. package/src/lib/agent-browser/client.ts +18 -0
  428. package/src/lib/browser/client.ts +147 -9
  429. package/src/lib/browser/identity.ts +64 -0
  430. package/src/lib/browser/index.ts +15 -1
  431. package/src/lib/browser/launch-args.ts +53 -1
  432. package/src/lib/browser/user-agent.ts +130 -0
  433. package/src/lib/docs-metadata-managed.ts +21 -0
  434. package/src/lib/identities/assume.ts +7 -7
  435. package/src/lib/instructions/apply.ts +2 -0
  436. package/src/lib/pace/index.ts +14 -0
  437. package/src/lib/pace/pace.ts +370 -0
  438. package/src/lib/tunnel/forward-headers.ts +16 -0
  439. package/src/lib/tunnel/gate.ts +18 -10
  440. package/src/lib/webview/index.ts +13 -0
  441. package/src/lib/webview/webview.ts +457 -0
@@ -0,0 +1,313 @@
1
+ import { closeSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
2
+ import { homedir } from "node:os";
3
+ import { dirname, resolve } from "node:path";
4
+ /**
5
+ * Human-pace gate for page loads.
6
+ *
7
+ * Every Harnery surface that loads a web page (`browse`, `browse-ai`, `fetch`,
8
+ * and the headed browse-session verbs) reserves a slot here before the request
9
+ * goes out. Consecutive loads against the same registrable site are spaced by
10
+ * a random gap inside `[minMs, maxMs]`, the way a person reads one page before
11
+ * opening the next. Loads against different sites do not wait on each other.
12
+ * Loopback, private-network, single-label, and reserved-suffix hosts are exempt
13
+ * so local development and page QA keep running at machine speed.
14
+ *
15
+ * The ledger is a small machine-local JSON file (`~/.cache/harnery/pace.json`)
16
+ * shared by every process, so separate `harn fetch` calls in a shell loop are
17
+ * paced the same as one long `harn browse` session. A caller reserves the next
18
+ * slot before it sleeps, so concurrent processes queue behind each other
19
+ * instead of all firing at once.
20
+ *
21
+ * The gate is on by default. `HARNERY_PACE=off` disables it machine-wide and
22
+ * each command carries `--no-pace` for a single run.
23
+ */
24
+ export const DEFAULT_PACE_MIN_MS = 3_000;
25
+ export const DEFAULT_PACE_MAX_MS = 9_000;
26
+ export const DEFAULT_PACE_LEDGER = resolve(homedir(), ".cache", "harnery", "pace.json");
27
+ /** Entries idle this long drop out of the ledger on the next write. */
28
+ const LEDGER_RETENTION_MS = 60 * 60 * 1_000;
29
+ /** A lock older than this belongs to a dead process and is reclaimed. */
30
+ const LOCK_STALE_MS = 5_000;
31
+ /** Total time a reservation waits for the ledger lock before proceeding anyway. */
32
+ const LOCK_WAIT_MS = 500;
33
+ const LOCK_POLL_MS = 5;
34
+ const OFF_VALUES = new Set(["off", "0", "false", "no", "none"]);
35
+ /**
36
+ * Resolve the pace policy from the environment.
37
+ *
38
+ * - `HARNERY_PACE`: `off` (or `0`, `false`, `no`) disables the gate. Unset or
39
+ * `human` keeps the default.
40
+ * - `HARNERY_PACE_MIN_MS` / `HARNERY_PACE_MAX_MS`: gap bounds in ms. Both must
41
+ * be non-negative integers with min <= max.
42
+ * - `HARNERY_PACE_EXEMPT`: comma-separated host suffixes that never wait.
43
+ * - `HARNERY_PACE_LEDGER`: ledger path override.
44
+ */
45
+ export function pacePolicyFromEnv(env = process.env) {
46
+ const mode = env.HARNERY_PACE?.trim().toLowerCase();
47
+ if (mode && mode !== "human" && !OFF_VALUES.has(mode)) {
48
+ throw new Error(`HARNERY_PACE must be "human" or "off" (got "${env.HARNERY_PACE}").`);
49
+ }
50
+ const minMs = readMs(env, "HARNERY_PACE_MIN_MS", DEFAULT_PACE_MIN_MS);
51
+ const maxMs = readMs(env, "HARNERY_PACE_MAX_MS", DEFAULT_PACE_MAX_MS);
52
+ if (minMs > maxMs) {
53
+ throw new Error(`HARNERY_PACE_MIN_MS (${minMs}) must not exceed HARNERY_PACE_MAX_MS (${maxMs}).`);
54
+ }
55
+ const exemptSuffixes = (env.HARNERY_PACE_EXEMPT ?? "")
56
+ .split(",")
57
+ .map((s) => normalizeHost(s))
58
+ .filter((s) => s !== null);
59
+ return {
60
+ enabled: !(mode && OFF_VALUES.has(mode)),
61
+ minMs,
62
+ maxMs,
63
+ exemptSuffixes,
64
+ ledgerPath: env.HARNERY_PACE_LEDGER?.trim() || DEFAULT_PACE_LEDGER,
65
+ };
66
+ }
67
+ function readMs(env, name, fallback) {
68
+ const raw = env[name]?.trim();
69
+ if (!raw)
70
+ return fallback;
71
+ if (!/^\d+$/.test(raw)) {
72
+ throw new Error(`${name} must be a non-negative integer number of milliseconds (got "${raw}").`);
73
+ }
74
+ return Number.parseInt(raw, 10);
75
+ }
76
+ /**
77
+ * Public suffixes that take two labels, so the registrable site is three
78
+ * labels deep (`news.bbc.co.uk` -> `bbc.co.uk`). A short curated list is
79
+ * enough here: the gate only needs sibling hosts of one site to share a key,
80
+ * and a miss degrades to per-hostname pacing, never to no pacing.
81
+ */
82
+ const TWO_LABEL_SUFFIXES = new Set([
83
+ "co.uk",
84
+ "org.uk",
85
+ "ac.uk",
86
+ "gov.uk",
87
+ "com.au",
88
+ "net.au",
89
+ "org.au",
90
+ "co.nz",
91
+ "co.jp",
92
+ "co.kr",
93
+ "co.in",
94
+ "co.za",
95
+ "com.br",
96
+ "com.mx",
97
+ "com.ar",
98
+ "com.cn",
99
+ "com.tw",
100
+ "com.sg",
101
+ "com.tr",
102
+ ]);
103
+ /** Reserved or local-only suffixes that are never paced. */
104
+ const EXEMPT_SUFFIXES = ["localhost", "local", "test", "internal", "example", "invalid"];
105
+ function normalizeHost(raw) {
106
+ const host = raw.trim().toLowerCase().replace(/\.+$/, "");
107
+ return host ? host : null;
108
+ }
109
+ function hasSuffix(host, suffix) {
110
+ return host === suffix || host.endsWith(`.${suffix}`);
111
+ }
112
+ function isExemptIpv4(host) {
113
+ const m = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(host);
114
+ if (!m)
115
+ return false;
116
+ const [a, b] = [Number(m[1]), Number(m[2])];
117
+ return (a === 127 ||
118
+ a === 10 ||
119
+ a === 0 ||
120
+ (a === 172 && b >= 16 && b <= 31) ||
121
+ (a === 192 && b === 168) ||
122
+ (a === 169 && b === 254));
123
+ }
124
+ function isExemptIpv6(host) {
125
+ const h = host.replace(/^\[|\]$/g, "");
126
+ return h === "::1" || h === "::" || /^f[cd]/.test(h) || /^fe[89ab]/.test(h);
127
+ }
128
+ /**
129
+ * Registrable site a URL belongs to for pacing purposes, or `null` when the
130
+ * URL is exempt: a non-HTTP scheme, a loopback or private address, a
131
+ * single-label or reserved-suffix host, or a configured exemption.
132
+ */
133
+ export function paceSiteKey(url, exemptSuffixes = []) {
134
+ let parsed;
135
+ try {
136
+ parsed = new URL(url);
137
+ }
138
+ catch {
139
+ return null;
140
+ }
141
+ if (parsed.protocol !== "http:" && parsed.protocol !== "https:")
142
+ return null;
143
+ const host = normalizeHost(parsed.hostname);
144
+ if (!host)
145
+ return null;
146
+ if (host.startsWith("[") || host.includes(":"))
147
+ return isExemptIpv6(host) ? null : host;
148
+ if (/^\d{1,3}(\.\d{1,3}){3}$/.test(host))
149
+ return isExemptIpv4(host) ? null : host;
150
+ for (const suffix of EXEMPT_SUFFIXES)
151
+ if (hasSuffix(host, suffix))
152
+ return null;
153
+ for (const suffix of exemptSuffixes)
154
+ if (hasSuffix(host, suffix))
155
+ return null;
156
+ const labels = host.split(".");
157
+ if (labels.length < 2)
158
+ return null;
159
+ const lastTwo = labels.slice(-2).join(".");
160
+ if (labels.length >= 3 && TWO_LABEL_SUFFIXES.has(lastTwo))
161
+ return labels.slice(-3).join(".");
162
+ return lastTwo;
163
+ }
164
+ /** Block the current thread for `ms`. Used by clients that drive a child process synchronously. */
165
+ export function sleepSync(ms) {
166
+ if (ms <= 0)
167
+ return;
168
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
169
+ }
170
+ export class PaceGate {
171
+ policy;
172
+ now;
173
+ random;
174
+ onWait;
175
+ constructor(policy, deps = {}) {
176
+ this.policy = policy;
177
+ this.now = deps.now ?? Date.now;
178
+ this.random = deps.random ?? Math.random;
179
+ this.onWait = deps.onWait;
180
+ }
181
+ /** A gate that never waits, for callers that opted out. */
182
+ static disabled() {
183
+ return new PaceGate({ ...pacePolicyFromEnv({}), enabled: false });
184
+ }
185
+ /**
186
+ * Reserve the next slot for `url` without sleeping. Returns how long the
187
+ * caller should wait before loading, or `null` when the URL is exempt or the
188
+ * gate is disabled. The reservation is recorded even when the wait is zero,
189
+ * so the next load of the same site owes a gap.
190
+ */
191
+ reserve(url) {
192
+ if (!this.policy.enabled)
193
+ return null;
194
+ const site = paceSiteKey(url, this.policy.exemptSuffixes);
195
+ if (!site)
196
+ return null;
197
+ const now = this.now();
198
+ const gap = this.policy.minMs + this.random() * (this.policy.maxMs - this.policy.minMs);
199
+ let readyAt = now;
200
+ withLedgerLock(this.policy.ledgerPath, this.now, () => {
201
+ const ledger = readLedger(this.policy.ledgerPath);
202
+ readyAt = Math.max(now, ledger.sites[site]?.nextAllowedAt ?? 0);
203
+ for (const [key, entry] of Object.entries(ledger.sites)) {
204
+ if (entry.nextAllowedAt < now - LEDGER_RETENTION_MS)
205
+ delete ledger.sites[key];
206
+ }
207
+ ledger.sites[site] = { nextAllowedAt: Math.round(readyAt + gap), lastAt: readyAt };
208
+ writeLedger(this.policy.ledgerPath, ledger);
209
+ });
210
+ const wait = { site, waitMs: Math.max(0, Math.round(readyAt - now)) };
211
+ this.onWait?.(wait);
212
+ return wait;
213
+ }
214
+ /** Reserve a slot and wait it out asynchronously. */
215
+ async before(url) {
216
+ const wait = this.reserve(url);
217
+ if (wait && wait.waitMs > 0) {
218
+ await new Promise((done) => setTimeout(done, wait.waitMs));
219
+ }
220
+ return wait;
221
+ }
222
+ /** Reserve a slot and block the thread for it. For `spawnSync`-driven clients. */
223
+ beforeSync(url) {
224
+ const wait = this.reserve(url);
225
+ if (wait && wait.waitMs > 0)
226
+ sleepSync(wait.waitMs);
227
+ return wait;
228
+ }
229
+ }
230
+ /**
231
+ * Gate for a CLI command run. `null` when the run passed `--no-pace`;
232
+ * otherwise the environment policy, with every non-zero wait reported through
233
+ * `log` so the operator can see why a load took longer.
234
+ */
235
+ export function commandPaceGate(optedIn, log) {
236
+ if (!optedIn)
237
+ return null;
238
+ return new PaceGate(pacePolicyFromEnv(), {
239
+ onWait: (wait) => {
240
+ if (wait.waitMs > 0)
241
+ log(describePaceWait(wait));
242
+ },
243
+ });
244
+ }
245
+ /** Describe a wait for a human-facing log line. */
246
+ export function describePaceWait(wait) {
247
+ const seconds = (wait.waitMs / 1_000).toFixed(1);
248
+ return `paced ${seconds}s before ${wait.site} (human pace; --no-pace or HARNERY_PACE=off skips)`;
249
+ }
250
+ function readLedger(path) {
251
+ try {
252
+ const parsed = JSON.parse(readFileSync(path, "utf8"));
253
+ if (parsed && parsed.version === 1 && parsed.sites && typeof parsed.sites === "object") {
254
+ const sites = {};
255
+ for (const [key, entry] of Object.entries(parsed.sites)) {
256
+ if (entry &&
257
+ typeof entry.nextAllowedAt === "number" &&
258
+ Number.isFinite(entry.nextAllowedAt) &&
259
+ typeof entry.lastAt === "number" &&
260
+ Number.isFinite(entry.lastAt)) {
261
+ sites[key] = { nextAllowedAt: entry.nextAllowedAt, lastAt: entry.lastAt };
262
+ }
263
+ }
264
+ return { version: 1, sites };
265
+ }
266
+ }
267
+ catch {
268
+ // Missing or corrupt ledger: start fresh. A lost ledger costs one unpaced
269
+ // load per site, never a crash.
270
+ }
271
+ return { version: 1, sites: {} };
272
+ }
273
+ function writeLedger(path, ledger) {
274
+ mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
275
+ const tmp = `${path}.${process.pid}.tmp`;
276
+ writeFileSync(tmp, `${JSON.stringify(ledger)}\n`, { mode: 0o600 });
277
+ renameSync(tmp, path);
278
+ }
279
+ /**
280
+ * Serialize ledger read-modify-write across processes with an exclusive lock
281
+ * file. The lock is best-effort: a stale lock from a dead process is reclaimed,
282
+ * and a caller that cannot get the lock within `LOCK_WAIT_MS` proceeds without
283
+ * it rather than blocking a page load on a bookkeeping file.
284
+ */
285
+ function withLedgerLock(path, now, fn) {
286
+ const lockPath = `${path}.lock`;
287
+ mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
288
+ const start = now();
289
+ let held = false;
290
+ while (!held && now() - start < LOCK_WAIT_MS) {
291
+ try {
292
+ closeSync(openSync(lockPath, "wx", 0o600));
293
+ held = true;
294
+ }
295
+ catch {
296
+ try {
297
+ if (Date.now() - statSync(lockPath).mtimeMs > LOCK_STALE_MS)
298
+ rmSync(lockPath, { force: true });
299
+ }
300
+ catch {
301
+ // Lock vanished between the failed open and the stat; retry.
302
+ }
303
+ sleepSync(LOCK_POLL_MS);
304
+ }
305
+ }
306
+ try {
307
+ fn();
308
+ }
309
+ finally {
310
+ if (held)
311
+ rmSync(lockPath, { force: true });
312
+ }
313
+ }
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Headers the tunnel gate sends to the upstream after the Host rewrite.
3
+ *
4
+ * The gate replaces Host so PHP (and other vhost-routed servers) see the
5
+ * configured review host. Callers that compare Origin to Host then fail,
6
+ * because the browser still sends the public tunnel hostname. Copy that
7
+ * original Host into X-Forwarded-Host, overwriting any client-supplied
8
+ * value, so the upstream can recover the hostname the browser used.
9
+ */
10
+ export declare function applyUpstreamHeaders(headers: Headers, vhost: string): void;
11
+ //# sourceMappingURL=forward-headers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"forward-headers.d.ts","sourceRoot":"","sources":["../../../src/lib/tunnel/forward-headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAM1E"}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Headers the tunnel gate sends to the upstream after the Host rewrite.
3
+ *
4
+ * The gate replaces Host so PHP (and other vhost-routed servers) see the
5
+ * configured review host. Callers that compare Origin to Host then fail,
6
+ * because the browser still sends the public tunnel hostname. Copy that
7
+ * original Host into X-Forwarded-Host, overwriting any client-supplied
8
+ * value, so the upstream can recover the hostname the browser used.
9
+ */
10
+ export function applyUpstreamHeaders(headers, vhost) {
11
+ const originalHost = headers.get("host") ?? "";
12
+ headers.set("host", vhost);
13
+ if (originalHost)
14
+ headers.set("x-forwarded-host", originalHost);
15
+ headers.set("accept-encoding", "identity");
16
+ headers.delete("connection");
17
+ }
@@ -1,14 +1,16 @@
1
1
  // Reverse-proxy worker spawned by `tunnel up`. Listens on 127.0.0.1:<port>
2
2
  // and forwards HTTP + WebSocket requests to an upstream with a Host header
3
- // rewrite and Content-Encoding stripped (Bun's fetch auto-decompresses the
4
- // body but retains the encoding header, which breaks browser decoding
5
- // downstream). Cloudflare provider mode checks CF-Connecting-IP against an
6
- // allowlist; trusted local proxy mode lets the local exposer own access.
3
+ // rewrite, the original Host copied to X-Forwarded-Host, and Content-Encoding
4
+ // stripped (Bun's fetch auto-decompresses the body but retains the encoding
5
+ // header, which breaks browser decoding downstream). Cloudflare provider mode
6
+ // checks CF-Connecting-IP against an allowlist; trusted local proxy mode lets
7
+ // the local exposer own access.
7
8
  //
8
9
  // Runs detached, outside the CLI command framework; no command context is
9
10
  // available; stdout/stderr is captured into .cache/tunnel/gate.log by the
10
11
  // spawner.
11
12
  import { renderTunnelErrorPage } from "./error-page";
13
+ import { applyUpstreamHeaders } from "./forward-headers";
12
14
  // `--port`/`--name` are also passed on argv (not just env) so the gate's port
13
15
  // and instance name show up in its process command line. That's what lets
14
16
  // `tunnel down` scope its stray-process sweep to a single instance via
@@ -78,15 +80,15 @@ const server = Bun.serve({
78
80
  }
79
81
  }
80
82
  if (req.headers.get("upgrade")?.toLowerCase() === "websocket") {
81
- if (server.upgrade(req, { data: { path: url.pathname + url.search } })) {
83
+ if (server.upgrade(req, {
84
+ data: { path: url.pathname + url.search, originalHost: req.headers.get("host") ?? "" },
85
+ })) {
82
86
  return undefined;
83
87
  }
84
88
  return new Response("WS upgrade failed\n", { status: 500 });
85
89
  }
86
90
  const headers = new Headers(req.headers);
87
- headers.set("host", VHOST);
88
- headers.set("accept-encoding", "identity");
89
- headers.delete("connection");
91
+ applyUpstreamHeaders(headers, VHOST);
90
92
  const init = {
91
93
  method: req.method,
92
94
  headers,
@@ -135,11 +137,14 @@ const server = Bun.serve({
135
137
  },
136
138
  websocket: {
137
139
  open(ws) {
138
- const { path } = ws.data;
140
+ const { path, originalHost } = ws.data;
139
141
  // Bun's WebSocket constructor accepts a `headers` option at runtime
140
142
  // even though the standard lib.dom.d.ts WebSocket type doesn't.
141
143
  const upstream = new WebSocket(UPSTREAM_WS + path, {
142
- headers: { host: VHOST },
144
+ headers: {
145
+ host: VHOST,
146
+ ...(originalHost ? { "x-forwarded-host": originalHost } : {}),
147
+ },
143
148
  });
144
149
  upstream.binaryType = "arraybuffer";
145
150
  ws.upstream = upstream;
@@ -0,0 +1,2 @@
1
+ export { type BunWebViewRuntime, buildWebViewBackend, parseWebViewTypeStep, parseWebViewViewport, type RunWebViewOptions, runWebView, type WebViewBackend, type WebViewConsoleEvent, type WebViewResult, type WebViewTypeStep, WebViewUnavailableError, } from "./webview.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/webview/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,uBAAuB,GACxB,MAAM,cAAc,CAAC"}
@@ -0,0 +1 @@
1
+ export { buildWebViewBackend, parseWebViewTypeStep, parseWebViewViewport, runWebView, WebViewUnavailableError, } from "./webview.js";
@@ -0,0 +1,116 @@
1
+ import { PaceGate } from "../pace/index.js";
2
+ export type WebViewBackend = "auto" | "chrome" | "webkit";
3
+ type WebViewConsoleHandler = (type: string, ...args: unknown[]) => void;
4
+ interface WebViewBackendOptions {
5
+ type: "chrome";
6
+ url: false;
7
+ path?: string;
8
+ argv?: string[];
9
+ }
10
+ interface WebViewConstructorOptions {
11
+ width: number;
12
+ height: number;
13
+ backend?: "webkit" | WebViewBackendOptions;
14
+ console?: WebViewConsoleHandler;
15
+ dataStore?: "ephemeral" | {
16
+ directory: string;
17
+ };
18
+ }
19
+ interface WebViewLike {
20
+ readonly url: string;
21
+ readonly title: string;
22
+ readonly loading: boolean;
23
+ onNavigated: ((url: string, title: string) => void) | null;
24
+ onNavigationFailed: ((error: Error) => void) | null;
25
+ navigate(url: string): Promise<void>;
26
+ evaluate(script: string): Promise<unknown>;
27
+ screenshot(options: {
28
+ format: "png";
29
+ encoding: "buffer";
30
+ }): Promise<Blob | Buffer | string | {
31
+ name: string;
32
+ size: number;
33
+ }>;
34
+ click(selector: string, options?: {
35
+ timeout?: number;
36
+ }): Promise<void>;
37
+ type(text: string): Promise<void>;
38
+ press(key: string): Promise<void>;
39
+ scrollTo(selector: string, options?: {
40
+ block?: "start" | "center" | "end" | "nearest";
41
+ timeout?: number;
42
+ }): Promise<void>;
43
+ close(): void;
44
+ }
45
+ export interface BunWebViewRuntime {
46
+ version?: string;
47
+ WebView: new (options: WebViewConstructorOptions) => WebViewLike;
48
+ }
49
+ export interface WebViewTypeStep {
50
+ selector: string;
51
+ text: string;
52
+ }
53
+ export interface RunWebViewOptions {
54
+ /** Explicit UA, "auto", or "native"; Chrome uses the shared store by default. */
55
+ userAgent?: string;
56
+ backend?: WebViewBackend;
57
+ viewport?: {
58
+ width: number;
59
+ height: number;
60
+ };
61
+ profileDir?: string;
62
+ chromePath?: string;
63
+ browserArgs?: string[];
64
+ timeoutMs?: number;
65
+ waitFor?: string;
66
+ typeSteps?: WebViewTypeStep[];
67
+ clicks?: string[];
68
+ presses?: string[];
69
+ evaluate?: string;
70
+ settleMs?: number;
71
+ screenshotPath?: string;
72
+ captureHtml?: boolean;
73
+ platform?: NodeJS.Platform;
74
+ runtime?: BunWebViewRuntime;
75
+ /**
76
+ * Human-pace gate applied before the load. Unset resolves the default from
77
+ * the `HARNERY_PACE*` environment; `null` disables pacing for this run.
78
+ */
79
+ pace?: PaceGate | null;
80
+ }
81
+ export interface WebViewConsoleEvent {
82
+ type: string;
83
+ args: unknown[];
84
+ }
85
+ export interface WebViewResult {
86
+ backend: "chrome" | "webkit";
87
+ runtimeVersion: string | null;
88
+ url: string;
89
+ title: string;
90
+ text: string;
91
+ html?: string;
92
+ evaluation?: unknown;
93
+ screenshotPath?: string;
94
+ consoleEvents: WebViewConsoleEvent[];
95
+ elapsedMs: number;
96
+ }
97
+ export declare class WebViewUnavailableError extends Error {
98
+ readonly code = "webview_unavailable";
99
+ constructor(message: string);
100
+ }
101
+ export declare function parseWebViewViewport(value: string): {
102
+ width: number;
103
+ height: number;
104
+ };
105
+ export declare function parseWebViewTypeStep(value: string): WebViewTypeStep;
106
+ export declare function buildWebViewBackend(backend: WebViewBackend, options: {
107
+ platform: NodeJS.Platform;
108
+ chromePath?: string;
109
+ browserArgs?: string[];
110
+ }): {
111
+ backend?: "webkit" | WebViewBackendOptions;
112
+ resolved: "chrome" | "webkit";
113
+ };
114
+ export declare function runWebView(url: string, options?: RunWebViewOptions): Promise<WebViewResult>;
115
+ export {};
116
+ //# sourceMappingURL=webview.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webview.d.ts","sourceRoot":"","sources":["../../../src/lib/webview/webview.ts"],"names":[],"mappings":"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"}