@seanhogg/builderforce-webcontainers 2026.10.11 → 2026.10.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (372) hide show
  1. package/README.md +22 -0
  2. package/dist/adaptive/controller.d.ts +39 -0
  3. package/dist/adaptive/controller.d.ts.map +1 -0
  4. package/dist/adaptive/controller.js +108 -0
  5. package/dist/adaptive/controller.js.map +1 -0
  6. package/dist/adaptive/costModel.d.ts +37 -0
  7. package/dist/adaptive/costModel.d.ts.map +1 -0
  8. package/dist/adaptive/costModel.js +102 -0
  9. package/dist/adaptive/costModel.js.map +1 -0
  10. package/dist/adaptive/planner.d.ts +22 -0
  11. package/dist/adaptive/planner.d.ts.map +1 -0
  12. package/dist/adaptive/planner.js +114 -0
  13. package/dist/adaptive/planner.js.map +1 -0
  14. package/dist/adaptive/types.d.ts +138 -0
  15. package/dist/adaptive/types.d.ts.map +1 -0
  16. package/dist/adaptive/types.js +12 -0
  17. package/dist/adaptive/types.js.map +1 -0
  18. package/dist/assets.js +2 -2
  19. package/dist/check/cachedFetch.js.map +1 -1
  20. package/dist/check/index.d.ts +6 -1
  21. package/dist/check/index.d.ts.map +1 -1
  22. package/dist/check/index.js +6 -1
  23. package/dist/check/index.js.map +1 -1
  24. package/dist/componentCompilers.d.ts.map +1 -1
  25. package/dist/componentCompilers.js.map +1 -1
  26. package/dist/esbuildWasm.js.map +1 -1
  27. package/dist/host.d.ts +11 -5
  28. package/dist/host.d.ts.map +1 -1
  29. package/dist/host.js +19 -8
  30. package/dist/host.js.map +1 -1
  31. package/dist/inference/backends/mock.d.ts +24 -0
  32. package/dist/inference/backends/mock.d.ts.map +1 -0
  33. package/dist/inference/backends/mock.js +55 -0
  34. package/dist/inference/backends/mock.js.map +1 -0
  35. package/dist/inference/backends/onnx.d.ts +33 -0
  36. package/dist/inference/backends/onnx.d.ts.map +1 -0
  37. package/dist/inference/backends/onnx.js +60 -0
  38. package/dist/inference/backends/onnx.js.map +1 -0
  39. package/dist/inference/backends/webllm.d.ts +27 -0
  40. package/dist/inference/backends/webllm.d.ts.map +1 -0
  41. package/dist/inference/backends/webllm.js +52 -0
  42. package/dist/inference/backends/webllm.js.map +1 -0
  43. package/dist/inference/backends/wllama.d.ts +29 -0
  44. package/dist/inference/backends/wllama.d.ts.map +1 -0
  45. package/dist/inference/backends/wllama.js +51 -0
  46. package/dist/inference/backends/wllama.js.map +1 -0
  47. package/dist/inference/capabilities.d.ts +20 -0
  48. package/dist/inference/capabilities.d.ts.map +1 -0
  49. package/dist/inference/capabilities.js +33 -0
  50. package/dist/inference/capabilities.js.map +1 -0
  51. package/dist/inference/client.d.ts +45 -0
  52. package/dist/inference/client.d.ts.map +1 -0
  53. package/dist/inference/client.js +201 -0
  54. package/dist/inference/client.js.map +1 -0
  55. package/dist/inference/modelCache.d.ts +71 -0
  56. package/dist/inference/modelCache.d.ts.map +1 -0
  57. package/dist/inference/modelCache.js +91 -0
  58. package/dist/inference/modelCache.js.map +1 -0
  59. package/dist/inference/protocol.d.ts +94 -0
  60. package/dist/inference/protocol.d.ts.map +1 -0
  61. package/dist/inference/protocol.js +19 -0
  62. package/dist/inference/protocol.js.map +1 -0
  63. package/dist/inference/tokenStream.d.ts +26 -0
  64. package/dist/inference/tokenStream.d.ts.map +1 -0
  65. package/dist/inference/tokenStream.js +79 -0
  66. package/dist/inference/tokenStream.js.map +1 -0
  67. package/dist/inference/types.d.ts +108 -0
  68. package/dist/inference/types.d.ts.map +1 -0
  69. package/dist/inference/types.js +8 -0
  70. package/dist/inference/types.js.map +1 -0
  71. package/dist/inference/worker.bundle.js +5 -0
  72. package/dist/inference/worker.d.ts +35 -0
  73. package/dist/inference/worker.d.ts.map +1 -0
  74. package/dist/inference/worker.js +157 -0
  75. package/dist/inference/worker.js.map +1 -0
  76. package/dist/inference/workerEntry.d.ts +15 -0
  77. package/dist/inference/workerEntry.d.ts.map +1 -0
  78. package/dist/inference/workerEntry.js +17 -0
  79. package/dist/inference/workerEntry.js.map +1 -0
  80. package/dist/kvcache/advanced.d.ts +39 -0
  81. package/dist/kvcache/advanced.d.ts.map +1 -0
  82. package/dist/kvcache/advanced.js +59 -0
  83. package/dist/kvcache/advanced.js.map +1 -0
  84. package/dist/kvcache/compatibility.d.ts +14 -0
  85. package/dist/kvcache/compatibility.d.ts.map +1 -0
  86. package/dist/kvcache/compatibility.js +44 -0
  87. package/dist/kvcache/compatibility.js.map +1 -0
  88. package/dist/kvcache/lru.d.ts +45 -0
  89. package/dist/kvcache/lru.d.ts.map +1 -0
  90. package/dist/kvcache/lru.js +91 -0
  91. package/dist/kvcache/lru.js.map +1 -0
  92. package/dist/kvcache/paged.d.ts +86 -0
  93. package/dist/kvcache/paged.d.ts.map +1 -0
  94. package/dist/kvcache/paged.js +238 -0
  95. package/dist/kvcache/paged.js.map +1 -0
  96. package/dist/kvcache/quant.d.ts +30 -0
  97. package/dist/kvcache/quant.d.ts.map +1 -0
  98. package/dist/kvcache/quant.js +73 -0
  99. package/dist/kvcache/quant.js.map +1 -0
  100. package/dist/kvcache/radix.d.ts +28 -0
  101. package/dist/kvcache/radix.d.ts.map +1 -0
  102. package/dist/kvcache/radix.js +58 -0
  103. package/dist/kvcache/radix.js.map +1 -0
  104. package/dist/kvcache/runtime.d.ts +11 -0
  105. package/dist/kvcache/runtime.d.ts.map +1 -0
  106. package/dist/kvcache/runtime.js +204 -0
  107. package/dist/kvcache/runtime.js.map +1 -0
  108. package/dist/kvcache/types.d.ts +151 -0
  109. package/dist/kvcache/types.d.ts.map +1 -0
  110. package/dist/kvcache/types.js +10 -0
  111. package/dist/kvcache/types.js.map +1 -0
  112. package/dist/learning/fingerprint.d.ts +17 -0
  113. package/dist/learning/fingerprint.d.ts.map +1 -0
  114. package/dist/learning/fingerprint.js +46 -0
  115. package/dist/learning/fingerprint.js.map +1 -0
  116. package/dist/learning/index.d.ts +5 -0
  117. package/dist/learning/index.d.ts.map +1 -0
  118. package/dist/learning/index.js +3 -0
  119. package/dist/learning/index.js.map +1 -0
  120. package/dist/learning/learner.d.ts +21 -0
  121. package/dist/learning/learner.d.ts.map +1 -0
  122. package/dist/learning/learner.js +272 -0
  123. package/dist/learning/learner.js.map +1 -0
  124. package/dist/learning/ledger.d.ts +26 -0
  125. package/dist/learning/ledger.d.ts.map +1 -0
  126. package/dist/learning/ledger.js +40 -0
  127. package/dist/learning/ledger.js.map +1 -0
  128. package/dist/learning/selection.d.ts +44 -0
  129. package/dist/learning/selection.d.ts.map +1 -0
  130. package/dist/learning/selection.js +111 -0
  131. package/dist/learning/selection.js.map +1 -0
  132. package/dist/learning/stats.d.ts +19 -0
  133. package/dist/learning/stats.d.ts.map +1 -0
  134. package/dist/learning/stats.js +31 -0
  135. package/dist/learning/stats.js.map +1 -0
  136. package/dist/learning/types.d.ts +133 -0
  137. package/dist/learning/types.d.ts.map +1 -0
  138. package/dist/learning/types.js +8 -0
  139. package/dist/learning/types.js.map +1 -0
  140. package/dist/memory/envProbe.d.ts +16 -0
  141. package/dist/memory/envProbe.d.ts.map +1 -0
  142. package/dist/memory/envProbe.js +28 -0
  143. package/dist/memory/envProbe.js.map +1 -0
  144. package/dist/memory/estimates.d.ts +46 -0
  145. package/dist/memory/estimates.d.ts.map +1 -0
  146. package/dist/memory/estimates.js +72 -0
  147. package/dist/memory/estimates.js.map +1 -0
  148. package/dist/memory/eviction.d.ts +42 -0
  149. package/dist/memory/eviction.d.ts.map +1 -0
  150. package/dist/memory/eviction.js +143 -0
  151. package/dist/memory/eviction.js.map +1 -0
  152. package/dist/memory/manager.d.ts +34 -0
  153. package/dist/memory/manager.d.ts.map +1 -0
  154. package/dist/memory/manager.js +346 -0
  155. package/dist/memory/manager.js.map +1 -0
  156. package/dist/memory/managerTypes.d.ts +49 -0
  157. package/dist/memory/managerTypes.d.ts.map +1 -0
  158. package/dist/memory/managerTypes.js +7 -0
  159. package/dist/memory/managerTypes.js.map +1 -0
  160. package/dist/memory/pressure.d.ts +56 -0
  161. package/dist/memory/pressure.d.ts.map +1 -0
  162. package/dist/memory/pressure.js +80 -0
  163. package/dist/memory/pressure.js.map +1 -0
  164. package/dist/memory/spillTier.d.ts +47 -0
  165. package/dist/memory/spillTier.d.ts.map +1 -0
  166. package/dist/memory/spillTier.js +128 -0
  167. package/dist/memory/spillTier.js.map +1 -0
  168. package/dist/memory/storageSink.d.ts +69 -0
  169. package/dist/memory/storageSink.d.ts.map +1 -0
  170. package/dist/memory/storageSink.js +221 -0
  171. package/dist/memory/storageSink.js.map +1 -0
  172. package/dist/memory/types.d.ts +202 -0
  173. package/dist/memory/types.d.ts.map +1 -0
  174. package/dist/memory/types.js +15 -0
  175. package/dist/memory/types.js.map +1 -0
  176. package/dist/memory/victims.d.ts +32 -0
  177. package/dist/memory/victims.d.ts.map +1 -0
  178. package/dist/memory/victims.js +74 -0
  179. package/dist/memory/victims.js.map +1 -0
  180. package/dist/memory/workspace.d.ts +34 -0
  181. package/dist/memory/workspace.d.ts.map +1 -0
  182. package/dist/memory/workspace.js +55 -0
  183. package/dist/memory/workspace.js.map +1 -0
  184. package/dist/memoryIntegration/index.d.ts +8 -0
  185. package/dist/memoryIntegration/index.d.ts.map +1 -0
  186. package/dist/memoryIntegration/index.js +4 -0
  187. package/dist/memoryIntegration/index.js.map +1 -0
  188. package/dist/memoryIntegration/knowledgeMemory.d.ts +43 -0
  189. package/dist/memoryIntegration/knowledgeMemory.d.ts.map +1 -0
  190. package/dist/memoryIntegration/knowledgeMemory.js +285 -0
  191. package/dist/memoryIntegration/knowledgeMemory.js.map +1 -0
  192. package/dist/memoryIntegration/persistence.d.ts +15 -0
  193. package/dist/memoryIntegration/persistence.d.ts.map +1 -0
  194. package/dist/memoryIntegration/persistence.js +43 -0
  195. package/dist/memoryIntegration/persistence.js.map +1 -0
  196. package/dist/memoryIntegration/text.d.ts +57 -0
  197. package/dist/memoryIntegration/text.d.ts.map +1 -0
  198. package/dist/memoryIntegration/text.js +179 -0
  199. package/dist/memoryIntegration/text.js.map +1 -0
  200. package/dist/memoryIntegration/types.d.ts +131 -0
  201. package/dist/memoryIntegration/types.d.ts.map +1 -0
  202. package/dist/memoryIntegration/types.js +11 -0
  203. package/dist/memoryIntegration/types.js.map +1 -0
  204. package/dist/ml.d.ts +52 -0
  205. package/dist/ml.d.ts.map +1 -0
  206. package/dist/ml.js +33 -0
  207. package/dist/ml.js.map +1 -0
  208. package/dist/node/childRelay.d.ts +10 -0
  209. package/dist/node/childRelay.d.ts.map +1 -1
  210. package/dist/node/childRelay.js +12 -2
  211. package/dist/node/childRelay.js.map +1 -1
  212. package/dist/node/index.js.map +1 -1
  213. package/dist/node/portResponder.d.ts +2 -0
  214. package/dist/node/portResponder.d.ts.map +1 -1
  215. package/dist/node/portResponder.js +3 -3
  216. package/dist/node/portResponder.js.map +1 -1
  217. package/dist/node/processHost.d.ts +4 -1
  218. package/dist/node/processHost.d.ts.map +1 -1
  219. package/dist/node/processHost.js +19 -16
  220. package/dist/node/processHost.js.map +1 -1
  221. package/dist/node/protocol.d.ts +1 -0
  222. package/dist/node/protocol.d.ts.map +1 -1
  223. package/dist/node/responseWire.d.ts.map +1 -1
  224. package/dist/node/worker.js +116 -109
  225. package/dist/node/workerProcess.js +1 -1
  226. package/dist/node/workerProcess.js.map +1 -1
  227. package/dist/prefetch/admission.d.ts +41 -0
  228. package/dist/prefetch/admission.d.ts.map +1 -0
  229. package/dist/prefetch/admission.js +49 -0
  230. package/dist/prefetch/admission.js.map +1 -0
  231. package/dist/prefetch/loadRegistry.d.ts +56 -0
  232. package/dist/prefetch/loadRegistry.d.ts.map +1 -0
  233. package/dist/prefetch/loadRegistry.js +108 -0
  234. package/dist/prefetch/loadRegistry.js.map +1 -0
  235. package/dist/prefetch/predictor.d.ts +40 -0
  236. package/dist/prefetch/predictor.d.ts.map +1 -0
  237. package/dist/prefetch/predictor.js +178 -0
  238. package/dist/prefetch/predictor.js.map +1 -0
  239. package/dist/prefetch/prefetcher.d.ts +37 -0
  240. package/dist/prefetch/prefetcher.d.ts.map +1 -0
  241. package/dist/prefetch/prefetcher.js +339 -0
  242. package/dist/prefetch/prefetcher.js.map +1 -0
  243. package/dist/prefetch/residentStore.d.ts +49 -0
  244. package/dist/prefetch/residentStore.d.ts.map +1 -0
  245. package/dist/prefetch/residentStore.js +87 -0
  246. package/dist/prefetch/residentStore.js.map +1 -0
  247. package/dist/prefetch/selfTuner.d.ts +40 -0
  248. package/dist/prefetch/selfTuner.d.ts.map +1 -0
  249. package/dist/prefetch/selfTuner.js +78 -0
  250. package/dist/prefetch/selfTuner.js.map +1 -0
  251. package/dist/prefetch/stats.d.ts +52 -0
  252. package/dist/prefetch/stats.d.ts.map +1 -0
  253. package/dist/prefetch/stats.js +72 -0
  254. package/dist/prefetch/stats.js.map +1 -0
  255. package/dist/prefetch/streaming.d.ts +132 -0
  256. package/dist/prefetch/streaming.d.ts.map +1 -0
  257. package/dist/prefetch/streaming.js +141 -0
  258. package/dist/prefetch/streaming.js.map +1 -0
  259. package/dist/prefetch/targetIndex.d.ts +18 -0
  260. package/dist/prefetch/targetIndex.d.ts.map +1 -0
  261. package/dist/prefetch/targetIndex.js +32 -0
  262. package/dist/prefetch/targetIndex.js.map +1 -0
  263. package/dist/prefetch/types.d.ts +283 -0
  264. package/dist/prefetch/types.d.ts.map +1 -0
  265. package/dist/prefetch/types.js +19 -0
  266. package/dist/prefetch/types.js.map +1 -0
  267. package/dist/previewBridge.d.ts +6 -0
  268. package/dist/previewBridge.d.ts.map +1 -1
  269. package/dist/previewBridge.js +25 -5
  270. package/dist/previewBridge.js.map +1 -1
  271. package/dist/previewMessages.d.ts +4 -3
  272. package/dist/previewMessages.d.ts.map +1 -1
  273. package/dist/previewMessages.js +12 -6
  274. package/dist/previewMessages.js.map +1 -1
  275. package/dist/process-worker.js +116 -109
  276. package/dist/relay.html +1 -1
  277. package/dist/shared/clock.d.ts +7 -0
  278. package/dist/shared/clock.d.ts.map +1 -0
  279. package/dist/shared/clock.js +10 -0
  280. package/dist/shared/clock.js.map +1 -0
  281. package/dist/shared/hardwareProbe.d.ts +26 -0
  282. package/dist/shared/hardwareProbe.d.ts.map +1 -0
  283. package/dist/shared/hardwareProbe.js +62 -0
  284. package/dist/shared/hardwareProbe.js.map +1 -0
  285. package/dist/shared/idb.d.ts +41 -0
  286. package/dist/shared/idb.d.ts.map +1 -0
  287. package/dist/shared/idb.js +184 -0
  288. package/dist/shared/idb.js.map +1 -0
  289. package/dist/shared/tokens.d.ts +7 -0
  290. package/dist/shared/tokens.d.ts.map +1 -0
  291. package/dist/shared/tokens.js +9 -0
  292. package/dist/shared/tokens.js.map +1 -0
  293. package/dist/snapshotStore.d.ts +2 -1
  294. package/dist/snapshotStore.d.ts.map +1 -1
  295. package/dist/snapshotStore.js +27 -12
  296. package/dist/snapshotStore.js.map +1 -1
  297. package/dist/styleCompilers.d.ts.map +1 -1
  298. package/dist/styleCompilers.js.map +1 -1
  299. package/dist/transport.js.map +1 -1
  300. package/package.json +11 -5
  301. package/src/adaptive/controller.ts +151 -0
  302. package/src/adaptive/costModel.ts +131 -0
  303. package/src/adaptive/planner.ts +127 -0
  304. package/src/adaptive/types.ts +137 -0
  305. package/src/check/index.ts +6 -1
  306. package/src/host.ts +33 -11
  307. package/src/inference/backends/mock.ts +77 -0
  308. package/src/inference/backends/onnx.ts +91 -0
  309. package/src/inference/backends/webllm.ts +79 -0
  310. package/src/inference/backends/wllama.ts +79 -0
  311. package/src/inference/capabilities.ts +46 -0
  312. package/src/inference/client.ts +276 -0
  313. package/src/inference/modelCache.ts +145 -0
  314. package/src/inference/protocol.ts +119 -0
  315. package/src/inference/tokenStream.ts +92 -0
  316. package/src/inference/types.ts +115 -0
  317. package/src/inference/worker.ts +191 -0
  318. package/src/inference/workerEntry.ts +18 -0
  319. package/src/kvcache/advanced.ts +86 -0
  320. package/src/kvcache/compatibility.ts +51 -0
  321. package/src/kvcache/lru.ts +100 -0
  322. package/src/kvcache/paged.ts +270 -0
  323. package/src/kvcache/quant.ts +88 -0
  324. package/src/kvcache/radix.ts +68 -0
  325. package/src/kvcache/runtime.ts +239 -0
  326. package/src/kvcache/types.ts +167 -0
  327. package/src/learning/fingerprint.ts +50 -0
  328. package/src/learning/index.ts +15 -0
  329. package/src/learning/learner.ts +304 -0
  330. package/src/learning/ledger.ts +54 -0
  331. package/src/learning/selection.ts +137 -0
  332. package/src/learning/stats.ts +39 -0
  333. package/src/learning/types.ts +142 -0
  334. package/src/memory/envProbe.ts +30 -0
  335. package/src/memory/estimates.ts +98 -0
  336. package/src/memory/eviction.ts +145 -0
  337. package/src/memory/manager.ts +380 -0
  338. package/src/memory/managerTypes.ts +61 -0
  339. package/src/memory/pressure.ts +120 -0
  340. package/src/memory/spillTier.ts +159 -0
  341. package/src/memory/storageSink.ts +289 -0
  342. package/src/memory/types.ts +217 -0
  343. package/src/memory/victims.ts +80 -0
  344. package/src/memory/workspace.ts +74 -0
  345. package/src/memoryIntegration/index.ts +7 -0
  346. package/src/memoryIntegration/knowledgeMemory.ts +339 -0
  347. package/src/memoryIntegration/persistence.ts +54 -0
  348. package/src/memoryIntegration/text.ts +185 -0
  349. package/src/memoryIntegration/types.ts +145 -0
  350. package/src/ml.ts +180 -0
  351. package/src/node/childRelay.ts +16 -3
  352. package/src/node/portResponder.ts +5 -3
  353. package/src/node/processHost.ts +16 -15
  354. package/src/node/protocol.ts +1 -1
  355. package/src/node/workerProcess.ts +1 -1
  356. package/src/prefetch/admission.ts +74 -0
  357. package/src/prefetch/loadRegistry.ts +156 -0
  358. package/src/prefetch/predictor.ts +199 -0
  359. package/src/prefetch/prefetcher.ts +369 -0
  360. package/src/prefetch/residentStore.ts +121 -0
  361. package/src/prefetch/selfTuner.ts +110 -0
  362. package/src/prefetch/stats.ts +120 -0
  363. package/src/prefetch/streaming.ts +231 -0
  364. package/src/prefetch/targetIndex.ts +40 -0
  365. package/src/prefetch/types.ts +307 -0
  366. package/src/previewBridge.ts +25 -5
  367. package/src/previewMessages.ts +11 -6
  368. package/src/shared/clock.ts +9 -0
  369. package/src/shared/hardwareProbe.ts +68 -0
  370. package/src/shared/idb.ts +203 -0
  371. package/src/shared/tokens.ts +8 -0
  372. package/src/snapshotStore.ts +25 -10
@@ -0,0 +1,185 @@
1
+ /**
2
+ * Phase 6 — text primitives: normalisation, chunking, tokenising, hashing, token
3
+ * estimation, BM25 scoring.
4
+ *
5
+ * Chunking, tokenising and the Okapi BM25 core mirror the memory layer's
6
+ * `retrieval/chunk.ts`, `similarity/index.ts` and `retrieval/bm25.ts` +
7
+ * `knowledge-index/lexical.ts` (same defaults, same formula), restated here only
8
+ * because this package must stay dependency-free.
9
+ */
10
+
11
+ export interface TextChunk {
12
+ text: string;
13
+ index: number;
14
+ start: number;
15
+ }
16
+
17
+ export interface ChunkOptions {
18
+ /** Max chunk size in characters. Default 1000 (memory default). */
19
+ chunkSize?: number;
20
+ /** Overlap carried between chunks. Default 200 (memory default). */
21
+ chunkOverlap?: number;
22
+ }
23
+
24
+ const SEPARATORS = ['\n\n', '\n', '. ', ' ', ''];
25
+
26
+ /** Capture normalisation: unify newlines, collapse runs of spaces/blank lines, trim. */
27
+ export function normalizeText(text: string): string {
28
+ return text
29
+ .replace(/\r\n?/g, '\n')
30
+ .replace(/[ \t]+/g, ' ')
31
+ .replace(/ *\n */g, '\n')
32
+ .replace(/\n{3,}/g, '\n\n')
33
+ .trim();
34
+ }
35
+
36
+ /** Recursive character splitter with overlap — memory `chunkText` semantics. */
37
+ export function chunkText(text: string, opts: ChunkOptions = {}): TextChunk[] {
38
+ const chunkSize = Math.max(1, opts.chunkSize ?? 1000);
39
+ const overlap = Math.min(Math.max(0, opts.chunkOverlap ?? 200), chunkSize - 1);
40
+ const trimmed = text.trim();
41
+ if (trimmed.length === 0) return [];
42
+ if (trimmed.length <= chunkSize) return [{ text: trimmed, index: 0, start: 0 }];
43
+
44
+ const pieces = splitRecursive(trimmed, chunkSize, SEPARATORS);
45
+ const chunks: TextChunk[] = [];
46
+ let buf = '';
47
+ const flush = () => {
48
+ const t = buf.trim();
49
+ if (t.length > 0) chunks.push({ text: t, index: chunks.length, start: Math.max(0, trimmed.indexOf(t)) });
50
+ buf = '';
51
+ };
52
+ for (const piece of pieces) {
53
+ if (buf.length + piece.length <= chunkSize) {
54
+ buf += piece;
55
+ } else {
56
+ flush();
57
+ const prev = chunks[chunks.length - 1]?.text ?? '';
58
+ buf = (overlap > 0 ? prev.slice(-overlap) : '') + piece;
59
+ while (buf.length > chunkSize) {
60
+ const head = buf.slice(0, chunkSize);
61
+ chunks.push({ text: head.trim(), index: chunks.length, start: Math.max(0, trimmed.indexOf(head.trim())) });
62
+ buf = (overlap > 0 ? head.slice(-overlap) : '') + buf.slice(chunkSize);
63
+ }
64
+ }
65
+ }
66
+ flush();
67
+ return chunks.map((c, i) => ({ ...c, index: i }));
68
+ }
69
+
70
+ function splitRecursive(text: string, chunkSize: number, separators: string[]): string[] {
71
+ if (text.length <= chunkSize) return [text];
72
+ const [sep, ...rest] = separators;
73
+ if (sep === undefined) return [text];
74
+ if (sep === '') {
75
+ const out: string[] = [];
76
+ for (let i = 0; i < text.length; i += chunkSize) out.push(text.slice(i, i + chunkSize));
77
+ return out;
78
+ }
79
+ const parts = text.split(sep);
80
+ const out: string[] = [];
81
+ for (let i = 0; i < parts.length; i++) {
82
+ const part = i < parts.length - 1 ? parts[i]! + sep : parts[i]!;
83
+ if (part.length > chunkSize) out.push(...splitRecursive(part, chunkSize, rest));
84
+ else out.push(part);
85
+ }
86
+ return out;
87
+ }
88
+
89
+ /** Lowercase word tokens — memory `tokenize`. */
90
+ export function tokenize(text: string): string[] {
91
+ return text.toLowerCase().split(/[\s\W]+/).filter(Boolean);
92
+ }
93
+
94
+ /** Estimated prompt tokens (~4 chars/token) — the shared heuristic, re-exported for this module's API. */
95
+ export { estimateTokens } from '../shared/tokens.js';
96
+
97
+ /**
98
+ * Content hash: two independent 32-bit FNV-1a lanes → 16 hex chars. Synchronous and
99
+ * portable; used for change detection and duplicate-chunk identity, not security.
100
+ */
101
+ export function contentHash(text: string): string {
102
+ let a = 0x811c9dc5;
103
+ let b = 0x01000193 ^ 0x5bd1e995;
104
+ for (let i = 0; i < text.length; i++) {
105
+ const c = text.charCodeAt(i);
106
+ a = Math.imul(a ^ c, 0x01000193);
107
+ b = Math.imul(b ^ c, 0x01000193) ^ (b >>> 13);
108
+ }
109
+ return (a >>> 0).toString(16).padStart(8, '0') + (b >>> 0).toString(16).padStart(8, '0');
110
+ }
111
+
112
+ /** Scale `v` to unit length (a copy). Zero vectors stay zero. */
113
+ export function toUnit(v: ArrayLike<number>): Float32Array {
114
+ const out = Float32Array.from(v);
115
+ let n = 0;
116
+ for (let i = 0; i < out.length; i++) n += out[i]! * out[i]!;
117
+ n = Math.sqrt(n);
118
+ if (n > 0) for (let i = 0; i < out.length; i++) out[i] = out[i]! / n;
119
+ return out;
120
+ }
121
+
122
+ const K1 = 1.5;
123
+ const B = 0.75;
124
+
125
+ /** Incremental BM25 inverted index (memory `LexicalIndex` semantics). */
126
+ export class LexicalIndex {
127
+ private readonly postings = new Map<string, Map<string, number>>();
128
+ private readonly docs = new Map<string, { terms: string[]; len: number }>();
129
+ private totalLen = 0;
130
+
131
+ set(id: string, text: string): void {
132
+ this.delete(id);
133
+ const tokens = tokenize(text);
134
+ const tf = new Map<string, number>();
135
+ for (const t of tokens) tf.set(t, (tf.get(t) ?? 0) + 1);
136
+ for (const [term, f] of tf) {
137
+ let p = this.postings.get(term);
138
+ if (!p) this.postings.set(term, (p = new Map()));
139
+ p.set(id, f);
140
+ }
141
+ this.docs.set(id, { terms: [...tf.keys()], len: tokens.length });
142
+ this.totalLen += tokens.length;
143
+ }
144
+
145
+ delete(id: string): void {
146
+ const doc = this.docs.get(id);
147
+ if (!doc) return;
148
+ for (const term of doc.terms) {
149
+ const p = this.postings.get(term);
150
+ p?.delete(id);
151
+ if (p && p.size === 0) this.postings.delete(term);
152
+ }
153
+ this.totalLen -= doc.len;
154
+ this.docs.delete(id);
155
+ }
156
+
157
+ /** Every positive-scoring id, best first (score desc, id asc). */
158
+ search(query: string): Array<{ id: string; score: number }> {
159
+ const n = this.docs.size;
160
+ if (n === 0) return [];
161
+ const avgdl = this.totalLen / n || 1;
162
+ const scores = new Map<string, number>();
163
+ for (const term of [...new Set(tokenize(query))].sort()) {
164
+ const p = this.postings.get(term);
165
+ if (!p) continue;
166
+ const df = p.size;
167
+ const idf = Math.log(1 + (n - df + 0.5) / (df + 0.5));
168
+ for (const [id, f] of p) {
169
+ const norm = 1 - B + B * (this.docs.get(id)!.len / avgdl);
170
+ scores.set(id, (scores.get(id) ?? 0) + (idf * f * (K1 + 1)) / (f + K1 * norm));
171
+ }
172
+ }
173
+ const hits: Array<{ id: string; score: number }> = [];
174
+ for (const [id, score] of scores) if (score > 0) hits.push({ id, score });
175
+ return hits.sort(compareHits);
176
+ }
177
+ }
178
+
179
+ /** Score descending, then id ascending (memory `compareHits` order). */
180
+ export function compareHits(a: { id: string; score: number }, b: { id: string; score: number }): number {
181
+ const qa = Math.round(a.score / 1e-6);
182
+ const qb = Math.round(b.score / 1e-6);
183
+ if (qa !== qb) return qb - qa;
184
+ return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
185
+ }
@@ -0,0 +1,145 @@
1
+ /**
2
+ * Phase 6 — BuilderForce Memory Integration: shared types.
3
+ *
4
+ * This is an ADAPTER over the memory layer's primitives, not a copy of the memory
5
+ * package. The embedder seam is structurally identical to the memory-engine's
6
+ * `TextEmbedder` (`EvermindTextEmbedder` in `memory-engine/src/lm/text_embedder.ts`):
7
+ * `embed(text) → Float32Array`, `dimensions`, `fingerprint`. A host passes an
8
+ * `EvermindTextEmbedder` straight in; there is no import dependency on it.
9
+ */
10
+
11
+ /** Text → vector seam. Matches the memory-engine `TextEmbedder` interface exactly. */
12
+ export interface TextEmbedder {
13
+ /** Embed `text` as a vector of length {@link dimensions} (normalised here defensively). */
14
+ embed(text: string): Promise<Float32Array>;
15
+ readonly dimensions: number;
16
+ /** Model+tokenizer identity. Vectors are only comparable within one fingerprint. */
17
+ readonly fingerprint: string;
18
+ }
19
+
20
+ /** The knowledge classes the persistent layer holds. */
21
+ export type KnowledgeKind = 'business-doc' | 'source' | 'project' | 'structured' | 'decision' | 'approved';
22
+
23
+ export type MetadataValue = string | number | boolean;
24
+
25
+ /** One captured source document (a file, a business doc, a decision record, …). */
26
+ export interface KnowledgeDocument {
27
+ /** Stable id in the origin system. Re-ingesting the same id replaces its chunks. */
28
+ id: string;
29
+ text: string;
30
+ kind?: KnowledgeKind;
31
+ title?: string;
32
+ uri?: string;
33
+ metadata?: Record<string, MetadataValue>;
34
+ /** Write time (epoch ms) used by recency ranking and retention. Default `now`. */
35
+ updatedAt?: number;
36
+ }
37
+
38
+ /** Where a returned passage came from — carried by EVERY hit and citation. */
39
+ export interface SourceReference {
40
+ sourceId: string;
41
+ /** Increments each time the source's content changes. */
42
+ version: number;
43
+ contentHash: string;
44
+ chunkId: string;
45
+ chunkIndex: number;
46
+ /** Character offset of the chunk within the normalised source. */
47
+ start: number;
48
+ kind: KnowledgeKind;
49
+ title?: string;
50
+ uri?: string;
51
+ }
52
+
53
+ export interface StoredChunk {
54
+ id: string;
55
+ index: number;
56
+ start: number;
57
+ text: string;
58
+ hash: string;
59
+ tokens: number;
60
+ /** Unit-length embedding. */
61
+ vector: Float32Array;
62
+ }
63
+
64
+ /** The persisted form of one document — what IndexedDB holds across restarts. */
65
+ export interface StoredKnowledgeDoc {
66
+ id: string;
67
+ kind: KnowledgeKind;
68
+ title?: string;
69
+ uri?: string;
70
+ metadata: Record<string, MetadataValue>;
71
+ updatedAt: number;
72
+ version: number;
73
+ contentHash: string;
74
+ /** Embedder fingerprint the vectors were made with. */
75
+ fingerprint: string;
76
+ chunks: StoredChunk[];
77
+ }
78
+
79
+ export interface KnowledgeHit {
80
+ chunkId: string;
81
+ text: string;
82
+ score: number;
83
+ source: SourceReference;
84
+ metadata: Record<string, MetadataValue>;
85
+ }
86
+
87
+ /** Reranking hook: receives the fused candidates, returns them reordered/filtered. */
88
+ export type RerankHook = (query: string, hits: KnowledgeHit[]) => KnowledgeHit[] | Promise<KnowledgeHit[]>;
89
+
90
+ export interface RetrieveOptions {
91
+ topK?: number;
92
+ /** Equality filter over document metadata, or a predicate over the stored doc. */
93
+ filter?: Record<string, MetadataValue> | ((doc: StoredKnowledgeDoc) => boolean);
94
+ kinds?: KnowledgeKind[];
95
+ /** Half-life recency decay over fused scores (memory `decay.ts` semantics). 0/unset = off. */
96
+ recencyHalfLifeDays?: number;
97
+ now?: number;
98
+ /** Candidates taken from each of the dense and sparse rankings before fusion. Default 100. */
99
+ candidatePool?: number;
100
+ denseWeight?: number;
101
+ sparseWeight?: number;
102
+ /** RRF damping constant. Default 60 (memory `RRF_DEFAULT_K`). */
103
+ rrfK?: number;
104
+ rerank?: RerankHook;
105
+ }
106
+
107
+ export interface ContextOptions extends RetrieveOptions {
108
+ /** Hard cap on the estimated tokens injected into the prompt. */
109
+ tokenBudget: number;
110
+ }
111
+
112
+ export interface AssembledContext {
113
+ text: string;
114
+ tokens: number;
115
+ citations: SourceReference[];
116
+ hits: KnowledgeHit[];
117
+ duplicatesRemoved: number;
118
+ droppedForBudget: number;
119
+ }
120
+
121
+ export interface IngestResult {
122
+ id: string;
123
+ status: 'added' | 'updated' | 'unchanged';
124
+ version: number;
125
+ chunks: number;
126
+ /** Chunks that were actually sent to the embedder (0 when unchanged). */
127
+ embedded: number;
128
+ }
129
+
130
+ export interface RetentionPolicy {
131
+ /** Remove documents older than this (by `updatedAt`). */
132
+ maxAgeMs?: number;
133
+ /** Keep at most this many documents (oldest removed first). */
134
+ maxDocuments?: number;
135
+ /** Kinds retention never removes (e.g. user-approved knowledge). Default `['approved']`. */
136
+ keepKinds?: KnowledgeKind[];
137
+ now?: number;
138
+ }
139
+
140
+ /** Persistence port; `createIndexedDbKnowledgePersistence` is the browser implementation. */
141
+ export interface KnowledgePersistence {
142
+ load(): Promise<StoredKnowledgeDoc[]>;
143
+ put(doc: StoredKnowledgeDoc): Promise<void>;
144
+ delete(id: string): Promise<void>;
145
+ }
package/src/ml.ts ADDED
@@ -0,0 +1,180 @@
1
+ /**
2
+ * `@seanhogg/builderforce-webcontainers/ml` — the in-browser ML runtime: local
3
+ * inference (client, worker host, backends, model cache), the adaptive
4
+ * execution controller, memory residency, the knowledge/retrieval layer,
5
+ * prefetch, KV-cache optimisation and online learning. Kept off the package
6
+ * root so dev-runtime consumers never load it. The inference worker bundle is
7
+ * `@seanhogg/builderforce-webcontainers/ml/worker.js`.
8
+ */
9
+ export { createInferenceClient } from './inference/client.js';
10
+ export type { InferenceClient, InferenceClientOptions, InferenceWorkerLike } from './inference/client.js';
11
+ export { createModelCache, createMemoryModelCache } from './inference/modelCache.js';
12
+ export type { ModelCache, ModelCacheEntry, ModelCacheOptions, ModelCacheValueFormat } from './inference/modelCache.js';
13
+ export { createOnnxBackend } from './inference/backends/onnx.js';
14
+ export type { OnnxBackendOptions, OrtWasmModule, OrtSession } from './inference/backends/onnx.js';
15
+ export { createWllamaBackend } from './inference/backends/wllama.js';
16
+ export type { WllamaBackendOptions, WllamaModule, WllamaModel } from './inference/backends/wllama.js';
17
+ export { createWebLlmBackend } from './inference/backends/webllm.js';
18
+ export type { WebLlmBackendOptions, WebLlmModule, WebLlmModel } from './inference/backends/webllm.js';
19
+ export { createMockBackend, MOCK_VOCAB } from './inference/backends/mock.js';
20
+ export type { MockBackendOptions } from './inference/backends/mock.js';
21
+ export { probeRuntimeCapabilities } from './inference/capabilities.js';
22
+ export { startInferenceWorkerHost, runInferenceWorker } from './inference/worker.js';
23
+ export type {
24
+ BackendInfo,
25
+ BackendKind,
26
+ ChatMessage,
27
+ GenerateOptions,
28
+ GenerationStats,
29
+ InferenceBackend,
30
+ InferenceModel,
31
+ InferenceToken,
32
+ ModelRef,
33
+ Quantization,
34
+ RuntimeCapabilities,
35
+ } from './inference/types.js';
36
+ export { createAdaptiveController, probeHardware } from './adaptive/controller.js';
37
+ export type { AdaptiveController } from './adaptive/controller.js';
38
+ export { planExecution } from './adaptive/planner.js';
39
+ export type {
40
+ ControllerConfig,
41
+ ExecutionDecision,
42
+ ExecutionGraph,
43
+ ExecutionOutcome,
44
+ ExecutionPlan,
45
+ ExecutionStrategy,
46
+ ExecutorLike,
47
+ HardwareProfile,
48
+ LayerNode,
49
+ WorkloadProfile,
50
+ } from './adaptive/types.js';
51
+ export { createMemoryManager, probeRamBytes, probeStorageQuotaBytes } from './memory/manager.js';
52
+ export type { AdmitResult, MemoryManager, MemoryManagerOptions } from './memory/manager.js';
53
+ export { arcStrategy, costAwareStrategy, lfuStrategy, lruStrategy, retentionValue, strategyByName } from './memory/eviction.js';
54
+ export { bytesPerParam, estimateReloadCostMs, estimateReuseProbability, estimateWeightBytes } from './memory/estimates.js';
55
+ export type { ReloadCostInput, ReuseObservation } from './memory/estimates.js';
56
+ export { detectPressure, planWorkspace } from './memory/pressure.js';
57
+ export type { PressureInput, WorkspaceBounds, WorkspaceDecision } from './memory/pressure.js';
58
+ export { createMemorySink, createModelCacheSink } from './memory/storageSink.js';
59
+ export type { SpilledRecord, StorageSink, StorageSinkOptions } from './memory/storageSink.js';
60
+ export type {
61
+ AdmitOptions,
62
+ EvictionStrategy,
63
+ LookupResult,
64
+ MemoryManagerConfig,
65
+ MemoryPressure,
66
+ Quota,
67
+ ResidencyEvent,
68
+ ResidencyEventKind,
69
+ ResidencyStats,
70
+ ResidencyTier,
71
+ ResidentEntry,
72
+ TrackedEntry,
73
+ } from './memory/types.js';
74
+ export {
75
+ createKnowledgeMemory,
76
+ createIndexedDbKnowledgePersistence,
77
+ createMemoryKnowledgePersistence,
78
+ chunkText as chunkKnowledgeText,
79
+ normalizeText as normalizeKnowledgeText,
80
+ contentHash as knowledgeContentHash,
81
+ estimateTokens,
82
+ } from './memoryIntegration/index.js';
83
+ export type {
84
+ KnowledgeMemory,
85
+ KnowledgeMemoryOptions,
86
+ KnowledgeMemoryStats,
87
+ IndexedDbKnowledgePersistenceOptions,
88
+ TextEmbedder,
89
+ KnowledgeKind,
90
+ KnowledgeDocument,
91
+ KnowledgeHit,
92
+ KnowledgePersistence,
93
+ StoredKnowledgeDoc,
94
+ StoredChunk,
95
+ SourceReference,
96
+ RetrieveOptions,
97
+ ContextOptions,
98
+ AssembledContext,
99
+ IngestResult,
100
+ RetentionPolicy,
101
+ RerankHook,
102
+ } from './memoryIntegration/index.js';
103
+ export { createPrefetcher } from './prefetch/prefetcher.js';
104
+ export {
105
+ mergePredictions,
106
+ predictFromContext,
107
+ predictFromGraph,
108
+ predictFromHistory,
109
+ PREFETCH_STRATEGIES,
110
+ } from './prefetch/predictor.js';
111
+ export {
112
+ createDoubleBuffer,
113
+ createPrefillStream,
114
+ probeSupport,
115
+ pumpDoubleBuffer,
116
+ } from './prefetch/streaming.js';
117
+ export type {
118
+ DoubleBuffer,
119
+ PrefillStream,
120
+ PrefillStreamBackend,
121
+ PrefillStreamOptions,
122
+ PrefillStreamResult,
123
+ PrefillToken,
124
+ StreamChunk,
125
+ } from './prefetch/streaming.js';
126
+ export type {
127
+ PrefetchConfig,
128
+ PrefetchContext,
129
+ PrefetchEvent,
130
+ PrefetchGraph,
131
+ PrefetchEdge,
132
+ Prefetcher,
133
+ PrefetchOutcome,
134
+ PrefetchPrediction,
135
+ PrefetchReason,
136
+ PrefetchRequestResult,
137
+ PrefetchSkipReason,
138
+ PrefetchStats,
139
+ PrefetchStrategy,
140
+ PrefetchTarget,
141
+ PrefetchTuningConfig,
142
+ ShouldThrottle,
143
+ } from './prefetch/types.js';
144
+ export { createKvCacheRuntime } from './kvcache/runtime.js';
145
+ export {
146
+ encodeCompatibilityKey,
147
+ parseCompatibilityKey,
148
+ compatibilityEquals,
149
+ exactPrefixLength,
150
+ } from './kvcache/compatibility.js';
151
+ export { planQuantization, defaultQualityScorer, DEFAULT_QUALITY_TOLERANCE } from './kvcache/quant.js';
152
+ export type {
153
+ AdvancedCapabilities,
154
+ CompatibilityKey,
155
+ CompatibilityParts,
156
+ KvCacheRuntime,
157
+ KvCacheRuntimeOptions,
158
+ KvCacheStats,
159
+ KvGenerateRequest,
160
+ KvGenerateResult,
161
+ KvQuantization,
162
+ OptimizationFlag,
163
+ QualityScorer,
164
+ QuantPlan,
165
+ } from './kvcache/types.js';
166
+ export { createLearner, fingerprintWorkload, observationFromExecution } from './learning/index.js';
167
+ export { emptyStat, observeStat, ucb1, variance } from './learning/index.js';
168
+ export type {
169
+ RunningStat,
170
+ ConfigDeltaField,
171
+ HistoryEntry,
172
+ Learner,
173
+ LearnerConfig,
174
+ LearningStats,
175
+ ObserveResult,
176
+ OutcomeObservation,
177
+ Recommendation,
178
+ SafeStrategy,
179
+ WorkloadFingerprintInput,
180
+ } from './learning/index.js';
@@ -3,6 +3,10 @@
3
3
  * `node`, `child_process.fork`, a `worker_threads` Worker): each is started as a
4
4
  * process of its own, and its output, exit and message channel are relayed back
5
5
  * to the spawning Worker, keyed by the Worker's own child id.
6
+ *
7
+ * Children are sibling Workers, so terminating the spawner's Worker does not
8
+ * stop them: whoever ends the spawner calls `killAll` (a child's own end does
9
+ * the same for ITS children, so the whole tree goes).
6
10
  */
7
11
  import type { ChildHandle, ProcessOptions } from '@seanhogg/builderforce-webcontainers-core';
8
12
  import type { HostToWorker, WorkerToHost } from './protocol.js';
@@ -16,7 +20,7 @@ export function isChildMessage(message: WorkerToHost): message is ChildMessage {
16
20
  }
17
21
 
18
22
  export class ChildRelay {
19
- private readonly children = new Map<number, ChildHandle>();
23
+ private readonly children = new Map<number, { handle: ChildHandle; detached: boolean }>();
20
24
 
21
25
  constructor(
22
26
  private readonly spawn: (command: string, args: string[], options: ProcessOptions) => ChildHandle,
@@ -25,7 +29,7 @@ export class ChildRelay {
25
29
 
26
30
  receive(message: ChildMessage): void {
27
31
  if (message.type === 'spawn') return this.start(message);
28
- const child = this.children.get(message.childId);
32
+ const child = this.children.get(message.childId)?.handle;
29
33
  switch (message.type) {
30
34
  case 'child-stdin':
31
35
  if (message.data === null) child?.closeStdin();
@@ -42,6 +46,15 @@ export class ChildRelay {
42
46
  }
43
47
  }
44
48
 
49
+ /**
50
+ * Signal every child still running, except `detached` ones (they outlive their
51
+ * parent). Each child's own exit kills its children in turn, so this reaches
52
+ * grandchildren too; SIGTERM falls back to terminating after the grace period.
53
+ */
54
+ killAll(signal: string): void {
55
+ for (const { handle, detached } of this.children.values()) if (!detached) handle.kill(signal);
56
+ }
57
+
45
58
  private start(message: Extract<ChildMessage, { type: 'spawn' }>): void {
46
59
  const { childId } = message;
47
60
  let child: ChildHandle;
@@ -50,7 +63,7 @@ export class ChildRelay {
50
63
  } catch (error) {
51
64
  return this.post({ type: 'child-error', childId, code: (error as { code?: string }).code ?? 'EFAIL', message: (error as Error).message });
52
65
  }
53
- this.children.set(childId, child);
66
+ this.children.set(childId, { handle: child, detached: !!message.detached });
54
67
  child.onStdout((data) => this.post({ type: 'child-out', childId, stream: 'stdout', data }));
55
68
  child.onStderr((data) => this.post({ type: 'child-out', childId, stream: 'stderr', data }));
56
69
  child.ipc?.onMessage((data) => this.post({ type: 'child-ipc', childId, data }));
@@ -29,6 +29,8 @@ export interface PortResponderOptions {
29
29
  bridge?: boolean;
30
30
  /** The host's preview scripts, read per page so `setPreviewScripts` applies to virtual servers too. */
31
31
  scripts?: () => readonly string[];
32
+ /** The runtime's nonce, carried by every message the injected bridge posts to the host. */
33
+ nonce?: string;
32
34
  }
33
35
 
34
36
  export interface OpenedPortResponse {
@@ -70,7 +72,7 @@ export async function openPortResponse(host: ProcessHost, request: WireRequest,
70
72
  // A compressed body cannot be edited in flight; such a page goes without the bridge.
71
73
  const hasBody = request.method !== 'HEAD' && response.status !== 204 && response.status !== 304;
72
74
  if (options.bridge !== false && hasBody && type && /^\s*text\/html/i.test(out[type]!) && !headerKey(out, 'content-encoding')) {
73
- body = injectBridge(body, bridgeFor(jar, target.path, options.scripts?.() ?? []));
75
+ body = injectBridge(body, bridgeFor(jar, target.path, options.scripts?.() ?? [], options.nonce));
74
76
  const length = headerKey(out, 'content-length');
75
77
  if (length) delete out[length];
76
78
  // The bridge pushes a `<meta charset>` past the 1,024-byte prescan; say it in the header instead.
@@ -80,8 +82,8 @@ export async function openPortResponse(host: ProcessHost, request: WireRequest,
80
82
  }
81
83
 
82
84
  /** The same bridge a dev-server page gets (errors, console, sockets), plus cookies and the host's scripts. */
83
- function bridgeFor(jar: CookieJar | undefined, path: string, scripts: readonly string[]): string {
84
- return [errorBridgeScript(), previewSocketScript(), jar ? previewCookieScript(jar.documentCookie(path)) : '', ...scripts.map(scriptTag)].join('');
85
+ function bridgeFor(jar: CookieJar | undefined, path: string, scripts: readonly string[], nonce?: string): string {
86
+ return [errorBridgeScript(nonce), previewSocketScript(nonce), jar ? previewCookieScript(jar.documentCookie(path), nonce) : '', ...scripts.map(scriptTag)].join('');
85
87
  }
86
88
 
87
89
  /** Insert `script` into a streamed document, after `<head>` (see `bridgeInsertionPoint`), passing the rest through as it arrives. */
@@ -4,7 +4,8 @@
4
4
  * the files at start, and writes flow both ways as batched ops (a worker's
5
5
  * write reaches the page, then every other worker). Children a worker spawns
6
6
  * (the shell running `node`, `child_process`) are started here too, so every
7
- * process — however deep — can be killed by terminating its worker.
7
+ * process — however deep — can be killed by terminating its worker. Ending a
8
+ * process (exit, kill, dispose) ends its children too, unless spawned `detached`.
8
9
  *
9
10
  * Responses from a worker's servers stream through here chunk by chunk (see
10
11
  * responseWire.ts), and upgraded connections (WebSockets) are relayed as raw
@@ -17,6 +18,7 @@ import {
17
18
  allocatePid,
18
19
  createIpcEndpoint,
19
20
  runArguments,
21
+ signalExitCode,
20
22
  textResponse,
21
23
  toRuntimeProcess,
22
24
  type ByteChannel,
@@ -61,8 +63,6 @@ export interface ProcessHostOptions {
61
63
  killGraceMs?: number;
62
64
  }
63
65
 
64
- const SIGNAL_CODES: Record<string, number> = { SIGINT: 130, SIGTERM: 143, SIGKILL: 137, SIGHUP: 129 };
65
-
66
66
  /** A running process, as `listProcesses()` reports it. */
67
67
  export interface ProcessInfo {
68
68
  pid: number;
@@ -223,30 +223,29 @@ export class ProcessHost {
223
223
  }
224
224
 
225
225
  dispose(): void {
226
- for (const proc of [...this.procs]) {
227
- proc.worker.terminate();
228
- proc.resolveExit(SIGNAL_CODES.SIGKILL!);
229
- }
226
+ for (const proc of [...this.procs]) this.terminate(proc, signalExitCode('SIGKILL'));
230
227
  this.unwatch();
231
228
  this.stopPorts();
232
229
  }
233
230
 
234
231
  private kill(proc: Proc, signal: string): void {
235
232
  if (proc.exited) return;
236
- if (signal === 'SIGKILL') {
237
- proc.worker.terminate();
238
- proc.resolveExit(SIGNAL_CODES.SIGKILL!);
239
- return;
240
- }
233
+ if (signal === 'SIGKILL') return this.terminate(proc, signalExitCode('SIGKILL'));
241
234
  this.post(proc, { type: 'kill', signal });
242
235
  // A process stuck in a loop never sees the signal: terminate its worker.
243
236
  setTimeout(() => {
244
- if (proc.exited) return;
245
- proc.worker.terminate();
246
- proc.resolveExit(SIGNAL_CODES[signal] ?? 1);
237
+ if (!proc.exited) this.terminate(proc, signalExitCode(signal));
247
238
  }, this.options.killGraceMs ?? 2000);
248
239
  }
249
240
 
241
+ /** Stop a process now: its children first (sibling Workers that would outlive it), then its own Worker. */
242
+ private terminate(proc: Proc, code: number): void {
243
+ if (proc.exited) return;
244
+ proc.children.killAll('SIGKILL');
245
+ proc.worker.terminate();
246
+ proc.resolveExit(code);
247
+ }
248
+
250
249
  private cleanup(proc: Proc): void {
251
250
  for (const registration of proc.registrations.values()) registration.close();
252
251
  proc.registrations.clear();
@@ -256,6 +255,8 @@ export class ProcessHost {
256
255
  for (const socket of proc.sockets.values()) socket.close();
257
256
  proc.sockets.clear();
258
257
  proc.ipc?.closed();
258
+ // Exited on its own: its children get SIGTERM (and the grace period), as a real parent's would.
259
+ proc.children.killAll('SIGTERM');
259
260
  this.procs.delete(proc);
260
261
  queueMicrotask(() => proc.worker.terminate());
261
262
  }
@@ -81,7 +81,7 @@ export type WorkerToHost =
81
81
  | { type: 'stdout' | 'stderr'; data: StdioChunk }
82
82
  | { type: 'exit'; code: number }
83
83
  | { type: 'fs'; ops: FsOp[] }
84
- | { type: 'spawn'; childId: number; command: string; args: string[]; cwd?: string; env?: Record<string, string>; terminal?: { cols: number; rows: number }; ipc?: boolean; thread?: ThreadInfo }
84
+ | { type: 'spawn'; childId: number; command: string; args: string[]; cwd?: string; env?: Record<string, string>; terminal?: { cols: number; rows: number }; ipc?: boolean; thread?: ThreadInfo; detached?: boolean }
85
85
  | { type: 'child-stdin'; childId: number; data: StdioChunk | null }
86
86
  | { type: 'child-kill'; childId: number; signal: string }
87
87
  | { type: 'child-resize'; childId: number; cols: number; rows: number }
@@ -105,7 +105,7 @@ export function createWorkerProcess(deps: WorkerProcessDeps): { receive(message:
105
105
  ? createIpcEndpoint((data) => deps.post({ type: 'child-ipc', childId, data }), () => deps.post({ type: 'child-ipc-disconnect', childId }))
106
106
  : undefined;
107
107
  children.set(childId, { stdout, stderr, exit: resolveExit, ipc });
108
- deps.post({ type: 'spawn', childId, command, args, cwd: options.cwd, env: options.env, terminal: options.terminal, ipc: options.ipc, thread: options.thread });
108
+ deps.post({ type: 'spawn', childId, command, args, cwd: options.cwd, env: options.env, terminal: options.terminal, ipc: options.ipc, thread: options.thread, detached: options.detached });
109
109
  return {
110
110
  pid: childId,
111
111
  onStdout: (l) => (stdout.add(l), () => stdout.delete(l)),