@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
@@ -12,6 +12,10 @@
12
12
  *
13
13
  * One window listener per runtime, accepting only messages from the preview
14
14
  * origin whose page sits under this runtime's base (as `listenToPreview` does).
15
+ *
16
+ * A page that goes away posts `close` for its sockets (see the page end); a
17
+ * port that can no longer be posted to closes its connection too, so a server
18
+ * socket never outlives the page it served.
15
19
  */
16
20
  import {
17
21
  COOKIE_MESSAGE_TYPE,
@@ -30,6 +34,8 @@ export interface PreviewBridgeOptions {
30
34
  upgrade(port: number, request: HttpRequestData): ByteChannel | undefined;
31
35
  /** The runtime's cookie jars: sent with WebSocket handshakes and mirrored into `document.cookie`. */
32
36
  cookies?: PortCookieJars;
37
+ /** The runtime's nonce: pages must carry it (see `previewPageOf`). */
38
+ nonce?: string;
33
39
  }
34
40
 
35
41
  /** The slice of MessagePort the bridge uses. */
@@ -79,15 +85,29 @@ export function listenToPreviewBridge(
79
85
  if (typeof navigator !== 'undefined' && navigator.userAgent) headers['user-agent'] = navigator.userAgent;
80
86
  const connection = connectWebSocket((request) => options.upgrade(port, request), { path, protocols, headers });
81
87
  sockets.add(connection);
82
- connection.onOpen(({ protocol }) => channel.postMessage({ kind: 'open', protocol }));
88
+ /** Post to the page; a port that throws (the page is gone) ends the connection. */
89
+ let pageGone = false;
90
+ const toPage = (message: unknown, transfer?: Transferable[]): void => {
91
+ if (pageGone) return;
92
+ try {
93
+ channel.postMessage(message, transfer);
94
+ } catch {
95
+ // Posting failed: the page (and its port) is gone. Hang up on the server for it.
96
+ pageGone = true;
97
+ sockets.delete(connection);
98
+ channel.close();
99
+ connection.close(1001, 'The preview page is gone.');
100
+ }
101
+ };
102
+ connection.onOpen(({ protocol }) => toPage({ kind: 'open', protocol }));
83
103
  connection.onMessage((message) => {
84
- if (typeof message === 'string') return channel.postMessage({ kind: 'message', data: message });
104
+ if (typeof message === 'string') return toPage({ kind: 'message', data: message });
85
105
  const buffer = new Uint8Array(message).buffer as ArrayBuffer;
86
- channel.postMessage({ kind: 'message', data: buffer }, [buffer]);
106
+ toPage({ kind: 'message', data: buffer }, [buffer]);
87
107
  });
88
108
  connection.onClose((info) => {
89
109
  sockets.delete(connection);
90
- channel.postMessage({ kind: 'close', ...info });
110
+ toPage({ kind: 'close', ...info });
91
111
  channel.close();
92
112
  });
93
113
  channel.onmessage = (event) => {
@@ -125,7 +145,7 @@ export function listenToPreviewBridge(
125
145
  const onMessage = (event: MessageEvent) => {
126
146
  const data = event.data as BridgeMessage | null;
127
147
  const channel = event.ports?.[0] as BridgePort | undefined;
128
- const page = channel && data ? previewPageOf(event, origin, base) : undefined;
148
+ const page = channel && data ? previewPageOf(event, origin, base, options.nonce) : undefined;
129
149
  if (!page) return;
130
150
  if (data!.type === SOCKET_MESSAGE_TYPE) openSocket(channel!, data!, page);
131
151
  else if (data!.type === COOKIE_MESSAGE_TYPE) syncCookies(channel!, page);
@@ -3,7 +3,9 @@
3
3
  * posted by the bridge script every served page starts with. One window
4
4
  * listener per runtime, accepting only messages from the preview origin whose
5
5
  * page sits under this runtime's base, so two runtimes on one page never hear
6
- * each other's previews.
6
+ * each other's previews. A runtime with a nonce (startPreviewRuntime makes one)
7
+ * also requires it on every message: the bridge it injects carries it, so a
8
+ * frame on the preview origin cannot claim another runtime's base by `href`.
7
9
  */
8
10
  import { CONSOLE_MESSAGE_TYPE, ERROR_MESSAGE_TYPE } from '@seanhogg/builderforce-webcontainers-core';
9
11
 
@@ -32,11 +34,14 @@ const LEVELS = new Set<string>(['log', 'info', 'warn', 'error', 'debug']);
32
34
 
33
35
  /**
34
36
  * The preview page a window message came from, when it is one of THIS runtime's:
35
- * sent from the preview origin, by a page under `base`. Undefined otherwise.
37
+ * sent from the preview origin, by a page under `base`, carrying `nonce` when
38
+ * the runtime has one. Undefined otherwise.
36
39
  */
37
- export function previewPageOf(event: MessageEvent, origin: string, base: string): URL | undefined {
38
- const href = (event.data as { href?: unknown } | null)?.href;
40
+ export function previewPageOf(event: MessageEvent, origin: string, base: string, nonce?: string): URL | undefined {
41
+ const data = event.data as { href?: unknown; nonce?: unknown } | null;
42
+ const href = data?.href;
39
43
  if (typeof href !== 'string' || event.origin !== origin) return undefined;
44
+ if (nonce !== undefined && data!.nonce !== nonce) return undefined;
40
45
  try {
41
46
  const page = new URL(href);
42
47
  return page.pathname.startsWith(base) ? page : undefined; // else: another runtime's preview
@@ -50,12 +55,12 @@ function subscribe<T>(set: Set<(value: T) => void>, listener: (value: T) => void
50
55
  return () => set.delete(listener);
51
56
  }
52
57
 
53
- export function listenToPreview(target: Pick<Window, 'addEventListener' | 'removeEventListener'>, origin: string, base: string): PreviewMessages {
58
+ export function listenToPreview(target: Pick<Window, 'addEventListener' | 'removeEventListener'>, origin: string, base: string, nonce?: string): PreviewMessages {
54
59
  const errors = new Set<(error: PreviewError) => void>();
55
60
  const consoles = new Set<(message: PreviewConsoleMessage) => void>();
56
61
 
57
62
  const onMessage = (event: MessageEvent) => {
58
- if (!previewPageOf(event, origin, base)) return;
63
+ if (!previewPageOf(event, origin, base, nonce)) return;
59
64
  const data = event.data as { type?: unknown; href: string; message?: unknown; stack?: unknown; level?: unknown; text?: unknown };
60
65
  if (data.type === ERROR_MESSAGE_TYPE) {
61
66
  const error: PreviewError = { message: String(data.message ?? ''), stack: typeof data.stack === 'string' ? data.stack : undefined, href: data.href };
@@ -0,0 +1,9 @@
1
+ /**
2
+ * The ONE monotonic-ish clock for measuring elapsed time: `performance.now()`
3
+ * when the realm has it, `Date.now()` otherwise. Use it for durations only —
4
+ * the origin differs between the two sources, so never persist the value.
5
+ */
6
+ export function now(): number {
7
+ const g = globalThis as { performance?: { now?(): number } };
8
+ return g.performance?.now?.() ?? Date.now();
9
+ }
@@ -0,0 +1,68 @@
1
+ /**
2
+ * The ONE home for environment hardware/feature probes shared by the inference
3
+ * worker, the capability report, the adaptive controller and the memory
4
+ * manager. Every probe is best-effort and never throws: these are facts the
5
+ * planners weigh, not gates. When a probe is inconclusive it reports the
6
+ * conservative answer (false / undefined) rather than guessing.
7
+ */
8
+
9
+ /**
10
+ * Minimal WASM module whose single function body is
11
+ * `i32.const 0; i8x16.splat; drop; end` — `65,0` = i32.const 0, `253,15`
12
+ * (`0xFD 0x0F`) = i8x16.splat (i32 -> v128), `26` = drop, `11` = end. It
13
+ * validates only on engines that accept SIMD opcodes, which is exactly the
14
+ * feature being detected. 29 bytes total.
15
+ */
16
+ const SIMD_PROBE = new Uint8Array([
17
+ 0, 97, 115, 109, 1, 0, 0, 0, 1, 4, 1, 96, 0, 0, 3, 2, 1, 0, 10, 9, 1, 7, 0,
18
+ 65, 0, 253, 15, 26, 11,
19
+ ]);
20
+
21
+ /** True when WebAssembly exists in this realm. */
22
+ export function detectWasm(): boolean {
23
+ return typeof WebAssembly !== 'undefined';
24
+ }
25
+
26
+ /** True when the engine validates a module using a WASM SIMD opcode. */
27
+ export function detectWasmSimd(): boolean {
28
+ if (typeof WebAssembly === 'undefined' || typeof WebAssembly.validate !== 'function') return false;
29
+ try {
30
+ return WebAssembly.validate(SIMD_PROBE);
31
+ } catch {
32
+ return false;
33
+ }
34
+ }
35
+
36
+ /** True when `navigator.gpu` is present (WebGPU exposed; an adapter may still be unavailable). */
37
+ export function detectWebGpu(): boolean {
38
+ const nav = (globalThis as { navigator?: { gpu?: unknown } }).navigator;
39
+ return typeof nav !== 'undefined' && nav !== null && 'gpu' in nav && nav.gpu != null;
40
+ }
41
+
42
+ /** True when SharedArrayBuffer is constructible in this realm (optional fast path). */
43
+ export function detectSharedArrayBuffer(): boolean {
44
+ return typeof (globalThis as { SharedArrayBuffer?: unknown }).SharedArrayBuffer !== 'undefined';
45
+ }
46
+
47
+ /** True when the page/worker is cross-origin isolated (never required by this runtime). */
48
+ export function detectCrossOriginIsolated(): boolean {
49
+ return (globalThis as { crossOriginIsolated?: boolean }).crossOriginIsolated === true;
50
+ }
51
+
52
+ /** `navigator.hardwareConcurrency`, or undefined when unreported. */
53
+ export function probeHardwareConcurrency(): number | undefined {
54
+ const cores = (globalThis as { navigator?: { hardwareConcurrency?: number } }).navigator?.hardwareConcurrency;
55
+ return typeof cores === 'number' && cores > 0 ? cores : undefined;
56
+ }
57
+
58
+ const GIB = 1024 * 1024 * 1024;
59
+
60
+ /**
61
+ * `navigator.deviceMemory` (GiB, coarse and privacy-bucketed) in bytes, or
62
+ * undefined when the browser does not report it. Callers pick their own
63
+ * fallback.
64
+ */
65
+ export function probeDeviceMemoryBytes(): number | undefined {
66
+ const deviceMemory = (globalThis as { navigator?: { deviceMemory?: number } }).navigator?.deviceMemory;
67
+ return typeof deviceMemory === 'number' && deviceMemory > 0 ? deviceMemory * GIB : undefined;
68
+ }
@@ -0,0 +1,203 @@
1
+ /**
2
+ * The ONE IndexedDB open/run helper for the runtime's single-store databases
3
+ * (the model cache, the knowledge persistence). Defensive posture: when
4
+ * IndexedDB is missing, fails to open, or is blocked, `openIdbStore` resolves
5
+ * `undefined` and the caller degrades to a no-op store.
6
+ *
7
+ * Every request settles on its TRANSACTION, not the request: a write is only
8
+ * durable once `tx.oncomplete` fires, and an abort after `req.onsuccess`
9
+ * (quota, a constraint, a crash in a later request) must reject, not report
10
+ * success. Reads run in 'readonly' transactions so they never serialize behind
11
+ * writers.
12
+ */
13
+
14
+ export interface IdbStoreConfig {
15
+ dbName: string;
16
+ storeName: string;
17
+ /** Requested schema version. An existing database at a higher version is opened as-is. */
18
+ version: number;
19
+ }
20
+
21
+ export interface IdbStore {
22
+ /** Run one request in its own transaction; resolves with its result once the transaction commits. */
23
+ run<T>(mode: IDBTransactionMode, fn: (store: IDBObjectStore) => IDBRequest<T>): Promise<T>;
24
+ /** Close the connection (tests, teardown). */
25
+ close(): void;
26
+ }
27
+
28
+ /**
29
+ * Open requests that were answered `undefined` because they were BLOCKED but are
30
+ * still pending, per factory and database name. IndexedDB queues every later
31
+ * open of that database behind a pending upgrade, so issuing another open while
32
+ * one is blocked would hang until the blocker goes away; instead such opens
33
+ * resolve `undefined` at once. The entry is cleared when the blocked request
34
+ * finally settles (late success, closed immediately; or error), so the next
35
+ * call retries.
36
+ */
37
+ const blockedOpens = new WeakMap<IDBFactory, Set<string>>();
38
+
39
+ function isBlocked(factory: IDBFactory, name: string): boolean {
40
+ return blockedOpens.get(factory)?.has(name) ?? false;
41
+ }
42
+
43
+ function markBlocked(factory: IDBFactory, name: string): void {
44
+ let names = blockedOpens.get(factory);
45
+ if (!names) {
46
+ names = new Set();
47
+ blockedOpens.set(factory, names);
48
+ }
49
+ names.add(name);
50
+ }
51
+
52
+ function clearBlocked(factory: IDBFactory, name: string): void {
53
+ blockedOpens.get(factory)?.delete(name);
54
+ }
55
+
56
+ function openRaw(
57
+ factory: IDBFactory,
58
+ name: string,
59
+ version: number | undefined,
60
+ storeName: string,
61
+ ): Promise<IDBDatabase | undefined> {
62
+ return new Promise((resolve) => {
63
+ // A blocked open of this database is still pending: a new open would queue
64
+ // behind it and hang, so answer `undefined` now and let the next call retry.
65
+ if (isBlocked(factory, name)) {
66
+ resolve(undefined);
67
+ return;
68
+ }
69
+ let request: IDBOpenDBRequest;
70
+ try {
71
+ request = version === undefined ? factory.open(name) : factory.open(name, version);
72
+ } catch {
73
+ resolve(undefined);
74
+ return;
75
+ }
76
+ // Set once we have answered `undefined` (blocked): the open request keeps going
77
+ // and may still succeed later, and that late connection must not leak.
78
+ let gaveUp = false;
79
+ // Upgrade only ever ADDS the store when it is missing; existing data is never touched.
80
+ request.onupgradeneeded = () => {
81
+ const db = request.result;
82
+ if (!db.objectStoreNames.contains(storeName)) db.createObjectStore(storeName);
83
+ };
84
+ request.onsuccess = () => {
85
+ const db = request.result;
86
+ if (gaveUp) {
87
+ db.close();
88
+ clearBlocked(factory, name);
89
+ return;
90
+ }
91
+ // Never be the connection that blocks someone else's upgrade (another tab, a newer build).
92
+ db.onversionchange = () => db.close();
93
+ resolve(db);
94
+ };
95
+ request.onerror = () => {
96
+ if (gaveUp) clearBlocked(factory, name);
97
+ resolve(undefined);
98
+ };
99
+ request.onblocked = () => {
100
+ if (!gaveUp) markBlocked(factory, name);
101
+ gaveUp = true;
102
+ resolve(undefined);
103
+ };
104
+ });
105
+ }
106
+
107
+ function storeOf(db: IDBDatabase, storeName: string, onClosed?: () => void): IdbStore {
108
+ let closed = false;
109
+ const close = () => {
110
+ if (closed) return;
111
+ closed = true;
112
+ db.close();
113
+ onClosed?.();
114
+ };
115
+ // Another connection wants a newer version (or the browser closed us): release
116
+ // the database and let the owner reopen on its next call.
117
+ db.onversionchange = close;
118
+ (db as IDBDatabase & { onclose: (() => void) | null }).onclose = close;
119
+ return {
120
+ run<T>(mode: IDBTransactionMode, fn: (store: IDBObjectStore) => IDBRequest<T>): Promise<T> {
121
+ return new Promise<T>((resolve, reject) => {
122
+ let tx: IDBTransaction;
123
+ let req: IDBRequest<T> | undefined;
124
+ try {
125
+ tx = db.transaction(storeName, mode);
126
+ } catch (error) {
127
+ reject(error);
128
+ return;
129
+ }
130
+ const failure = () => tx.error ?? req?.error ?? new Error(`IndexedDB transaction on ${storeName} failed`);
131
+ tx.oncomplete = () => resolve(req!.result);
132
+ tx.onabort = () => reject(failure());
133
+ tx.onerror = () => reject(failure());
134
+ try {
135
+ req = fn(tx.objectStore(storeName));
136
+ } catch (error) {
137
+ // e.g. DataCloneError on put: nothing was queued, so abort and surface it.
138
+ try {
139
+ tx.abort();
140
+ } catch {
141
+ /* already finished */
142
+ }
143
+ reject(error);
144
+ }
145
+ });
146
+ },
147
+ close,
148
+ };
149
+ }
150
+
151
+ /**
152
+ * Open `config.dbName` and make sure `config.storeName` exists. A database that
153
+ * already exists at (or above) the requested version without the store is
154
+ * reopened one version up so the store can be added; nothing existing is
155
+ * dropped or migrated.
156
+ */
157
+ export async function openIdbStore(
158
+ factory: IDBFactory | undefined,
159
+ config: IdbStoreConfig,
160
+ onClosed?: () => void,
161
+ ): Promise<IdbStore | undefined> {
162
+ if (!factory) return undefined;
163
+ let db = await openRaw(factory, config.dbName, config.version, config.storeName);
164
+ if (!db) {
165
+ // The database may already exist at a higher version than requested (VersionError):
166
+ // open whatever version is there.
167
+ db = await openRaw(factory, config.dbName, undefined, config.storeName);
168
+ if (!db) return undefined;
169
+ }
170
+ if (!db.objectStoreNames.contains(config.storeName)) {
171
+ const next = db.version + 1;
172
+ db.close();
173
+ db = await openRaw(factory, config.dbName, next, config.storeName);
174
+ if (!db || !db.objectStoreNames.contains(config.storeName)) return undefined;
175
+ }
176
+ return storeOf(db, config.storeName, onClosed);
177
+ }
178
+
179
+ /**
180
+ * A lazily opened, memoised store for one database — what every IndexedDB-backed
181
+ * cache uses. Only a SUCCESSFUL open is memoised: a missing/blocked/failed open
182
+ * yields `undefined` for that call and is retried on the next one, so one
183
+ * transient block cannot turn the cache into a permanent no-op. When the
184
+ * connection closes (versionchange, browser close, `close()`), the memo is
185
+ * dropped and the next call reopens.
186
+ */
187
+ export function lazyIdbStore(
188
+ factory: IDBFactory | undefined,
189
+ config: IdbStoreConfig,
190
+ ): () => Promise<IdbStore | undefined> {
191
+ let opened: Promise<IdbStore | undefined> | undefined;
192
+ return () => {
193
+ if (opened) return opened;
194
+ const attempt: Promise<IdbStore | undefined> = openIdbStore(factory, config, () => {
195
+ if (opened === attempt) opened = undefined;
196
+ });
197
+ opened = attempt;
198
+ void attempt.then((store) => {
199
+ if (!store && opened === attempt) opened = undefined;
200
+ });
201
+ return attempt;
202
+ };
203
+ }
@@ -0,0 +1,8 @@
1
+ /**
2
+ * The ONE token-count heuristic used where no tokenizer is available:
3
+ * ~4 characters per token, the usual English/code budgeting average.
4
+ * An empty string is 0 tokens; callers that need a floor apply it.
5
+ */
6
+ export function estimateTokens(text: string): number {
7
+ return Math.ceil(text.length / 4);
8
+ }
@@ -4,7 +4,8 @@
4
4
  * reload can `importZip` an installed `node_modules` instead of reinstalling.
5
5
  *
6
6
  * Bounded: snapshots over `maxBytes` are not stored, and only the
7
- * `maxEntries` most recently used are kept. Every operation fails soft —
7
+ * `maxEntries` most recently used are kept. Recency is read from a `usedAt`
8
+ * index walked with a key cursor, so pruning and `keys()` never load a zip. Every operation fails soft —
8
9
  * storage blocked (private windows) or full means a miss, never a throw.
9
10
  */
10
11
 
@@ -36,6 +37,9 @@ interface Row {
36
37
  }
37
38
 
38
39
  const STORE = 'snapshots';
40
+ const USED_AT = 'usedAt';
41
+ /** v1: the store; v2: the `usedAt` index (built over existing rows by the upgrade itself). */
42
+ const DB_VERSION = 2;
39
43
 
40
44
  function request<T>(req: IDBRequest<T>): Promise<T> {
41
45
  return new Promise((resolve, reject) => {
@@ -62,9 +66,11 @@ export function createSnapshotStore(options: SnapshotStoreOptions = {}): Snapsho
62
66
  const factory = options.indexedDB ?? globalThis.indexedDB;
63
67
  if (!factory) return undefined;
64
68
  try {
65
- const req = factory.open(options.name ?? 'bfwc-snapshots', 1);
69
+ const req = factory.open(options.name ?? 'bfwc-snapshots', DB_VERSION);
66
70
  req.onupgradeneeded = () => {
67
- if (!req.result.objectStoreNames.contains(STORE)) req.result.createObjectStore(STORE, { keyPath: 'key' });
71
+ const db = req.result;
72
+ const store = db.objectStoreNames.contains(STORE) ? req.transaction!.objectStore(STORE) : db.createObjectStore(STORE, { keyPath: 'key' });
73
+ if (!store.indexNames.contains(USED_AT)) store.createIndex(USED_AT, USED_AT);
68
74
  };
69
75
  return await request(req);
70
76
  } catch {
@@ -72,10 +78,19 @@ export function createSnapshotStore(options: SnapshotStoreOptions = {}): Snapsho
72
78
  }
73
79
  })());
74
80
 
75
- const rows = async (db: IDBDatabase): Promise<Row[]> => {
76
- const all = (await request(db.transaction(STORE, 'readonly').objectStore(STORE).getAll())) as Row[];
77
- return all.sort((a, b) => b.usedAt - a.usedAt);
78
- };
81
+ /** Keys, most recently used first — walked off the `usedAt` index; no zip is read. */
82
+ const keysByRecency = (db: IDBDatabase): Promise<string[]> =>
83
+ new Promise((resolve, reject) => {
84
+ const keys: string[] = [];
85
+ const cursor = db.transaction(STORE, 'readonly').objectStore(STORE).index(USED_AT).openKeyCursor(null, 'prev');
86
+ cursor.onsuccess = () => {
87
+ const at = cursor.result;
88
+ if (!at) return resolve(keys);
89
+ keys.push(at.primaryKey as string);
90
+ at.continue();
91
+ };
92
+ cursor.onerror = () => reject(cursor.error);
93
+ });
79
94
 
80
95
  return {
81
96
  async load(key) {
@@ -100,10 +115,10 @@ export function createSnapshotStore(options: SnapshotStoreOptions = {}): Snapsho
100
115
  const tx = db.transaction(STORE, 'readwrite');
101
116
  tx.objectStore(STORE).put({ key, zip, usedAt: Date.now() } satisfies Row);
102
117
  await done(tx);
103
- const stale = (await rows(db)).slice(maxEntries);
118
+ const stale = (await keysByRecency(db)).slice(maxEntries);
104
119
  if (stale.length) {
105
120
  const prune = db.transaction(STORE, 'readwrite');
106
- for (const row of stale) prune.objectStore(STORE).delete(row.key);
121
+ for (const staleKey of stale) prune.objectStore(STORE).delete(staleKey);
107
122
  await done(prune);
108
123
  }
109
124
  return true;
@@ -126,7 +141,7 @@ export function createSnapshotStore(options: SnapshotStoreOptions = {}): Snapsho
126
141
  const db = await open();
127
142
  if (!db) return [];
128
143
  try {
129
- return (await rows(db)).map((row) => row.key);
144
+ return await keysByRecency(db);
130
145
  } catch {
131
146
  return [];
132
147
  }