@seanhogg/builderforce-webcontainers 2026.10.12 → 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 +127 -120
  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 +127 -120
  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,43 @@
1
+ /**
2
+ * Phase 6 — persistence for the knowledge layer. IndexedDB in the browser via the
3
+ * shared `lazyIdbStore` helper (no IndexedDB ⇒ a no-op store and the index is
4
+ * simply rebuilt), plus an in-memory implementation for tests.
5
+ */
6
+ import { lazyIdbStore } from '../shared/idb.js';
7
+ const DB_VERSION = 1;
8
+ const STORE = 'docs';
9
+ export function createIndexedDbKnowledgePersistence(options = {}) {
10
+ const factory = options.indexedDB ?? globalThis.indexedDB;
11
+ const config = { dbName: options.dbName ?? 'bfwc-memory-knowledge', storeName: STORE, version: DB_VERSION };
12
+ const open = lazyIdbStore(factory, config);
13
+ return {
14
+ async load() {
15
+ const store = await open();
16
+ if (!store)
17
+ return [];
18
+ return store.run('readonly', (s) => s.getAll());
19
+ },
20
+ async put(doc) {
21
+ await (await open())?.run('readwrite', (s) => s.put(doc, doc.id));
22
+ },
23
+ async delete(id) {
24
+ await (await open())?.run('readwrite', (s) => s.delete(id));
25
+ },
26
+ };
27
+ }
28
+ /** Non-persistent store (tests, or a session-only knowledge layer). */
29
+ export function createMemoryKnowledgePersistence() {
30
+ const map = new Map();
31
+ return {
32
+ async load() {
33
+ return [...map.values()];
34
+ },
35
+ async put(doc) {
36
+ map.set(doc.id, doc);
37
+ },
38
+ async delete(id) {
39
+ map.delete(id);
40
+ },
41
+ };
42
+ }
43
+ //# sourceMappingURL=persistence.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../src/memoryIntegration/persistence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,KAAK,GAAG,MAAM,CAAC;AAQrB,MAAM,UAAU,mCAAmC,CACjD,OAAO,GAAyC,EAAE;IAElD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,IAAK,UAAyC,CAAC,SAAS,CAAC;IAC1F,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,uBAAuB,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAC5G,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,KAAK,GAAG,MAAM,IAAI,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK;gBAAE,OAAO,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAsC,CAAC,CAAC;QACtF,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG;YACX,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAE;YACb,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gCAAgC;IAC9C,MAAM,GAAG,GAAG,IAAI,GAAG,EAA8B,CAAC;IAClD,OAAO;QACL,KAAK,CAAC,IAAI;YACR,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG;YACX,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAE;YACb,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,57 @@
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
+ export interface TextChunk {
11
+ text: string;
12
+ index: number;
13
+ start: number;
14
+ }
15
+ export interface ChunkOptions {
16
+ /** Max chunk size in characters. Default 1000 (memory default). */
17
+ chunkSize?: number;
18
+ /** Overlap carried between chunks. Default 200 (memory default). */
19
+ chunkOverlap?: number;
20
+ }
21
+ /** Capture normalisation: unify newlines, collapse runs of spaces/blank lines, trim. */
22
+ export declare function normalizeText(text: string): string;
23
+ /** Recursive character splitter with overlap — memory `chunkText` semantics. */
24
+ export declare function chunkText(text: string, opts?: ChunkOptions): TextChunk[];
25
+ /** Lowercase word tokens — memory `tokenize`. */
26
+ export declare function tokenize(text: string): string[];
27
+ /** Estimated prompt tokens (~4 chars/token) — the shared heuristic, re-exported for this module's API. */
28
+ export { estimateTokens } from '../shared/tokens.js';
29
+ /**
30
+ * Content hash: two independent 32-bit FNV-1a lanes → 16 hex chars. Synchronous and
31
+ * portable; used for change detection and duplicate-chunk identity, not security.
32
+ */
33
+ export declare function contentHash(text: string): string;
34
+ /** Scale `v` to unit length (a copy). Zero vectors stay zero. */
35
+ export declare function toUnit(v: ArrayLike<number>): Float32Array;
36
+ /** Incremental BM25 inverted index (memory `LexicalIndex` semantics). */
37
+ export declare class LexicalIndex {
38
+ private readonly postings;
39
+ private readonly docs;
40
+ private totalLen;
41
+ set(id: string, text: string): void;
42
+ delete(id: string): void;
43
+ /** Every positive-scoring id, best first (score desc, id asc). */
44
+ search(query: string): Array<{
45
+ id: string;
46
+ score: number;
47
+ }>;
48
+ }
49
+ /** Score descending, then id ascending (memory `compareHits` order). */
50
+ export declare function compareHits(a: {
51
+ id: string;
52
+ score: number;
53
+ }, b: {
54
+ id: string;
55
+ score: number;
56
+ }): number;
57
+ //# sourceMappingURL=text.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/memoryIntegration/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,SAAS,EAAE,CA+B5E;AAqBD,iDAAiD;AACjD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/C;AAED,0GAA0G;AAC1G,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAShD;AAED,iEAAiE;AACjE,wBAAgB,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,YAAY,CAOzD;AAKD,yEAAyE;AACzE,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuD;IAC5E,OAAO,CAAC,QAAQ,CAAK;IAErB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAYlC;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAUvB;IAED,kEAAkE;IAClE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAkB1D;CACF;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,CAAC,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKtG"}
@@ -0,0 +1,179 @@
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
+ const SEPARATORS = ['\n\n', '\n', '. ', ' ', ''];
11
+ /** Capture normalisation: unify newlines, collapse runs of spaces/blank lines, trim. */
12
+ export function normalizeText(text) {
13
+ return text
14
+ .replace(/\r\n?/g, '\n')
15
+ .replace(/[ \t]+/g, ' ')
16
+ .replace(/ *\n */g, '\n')
17
+ .replace(/\n{3,}/g, '\n\n')
18
+ .trim();
19
+ }
20
+ /** Recursive character splitter with overlap — memory `chunkText` semantics. */
21
+ export function chunkText(text, opts = {}) {
22
+ const chunkSize = Math.max(1, opts.chunkSize ?? 1000);
23
+ const overlap = Math.min(Math.max(0, opts.chunkOverlap ?? 200), chunkSize - 1);
24
+ const trimmed = text.trim();
25
+ if (trimmed.length === 0)
26
+ return [];
27
+ if (trimmed.length <= chunkSize)
28
+ return [{ text: trimmed, index: 0, start: 0 }];
29
+ const pieces = splitRecursive(trimmed, chunkSize, SEPARATORS);
30
+ const chunks = [];
31
+ let buf = '';
32
+ const flush = () => {
33
+ const t = buf.trim();
34
+ if (t.length > 0)
35
+ chunks.push({ text: t, index: chunks.length, start: Math.max(0, trimmed.indexOf(t)) });
36
+ buf = '';
37
+ };
38
+ for (const piece of pieces) {
39
+ if (buf.length + piece.length <= chunkSize) {
40
+ buf += piece;
41
+ }
42
+ else {
43
+ flush();
44
+ const prev = chunks[chunks.length - 1]?.text ?? '';
45
+ buf = (overlap > 0 ? prev.slice(-overlap) : '') + piece;
46
+ while (buf.length > chunkSize) {
47
+ const head = buf.slice(0, chunkSize);
48
+ chunks.push({ text: head.trim(), index: chunks.length, start: Math.max(0, trimmed.indexOf(head.trim())) });
49
+ buf = (overlap > 0 ? head.slice(-overlap) : '') + buf.slice(chunkSize);
50
+ }
51
+ }
52
+ }
53
+ flush();
54
+ return chunks.map((c, i) => ({ ...c, index: i }));
55
+ }
56
+ function splitRecursive(text, chunkSize, separators) {
57
+ if (text.length <= chunkSize)
58
+ return [text];
59
+ const [sep, ...rest] = separators;
60
+ if (sep === undefined)
61
+ return [text];
62
+ if (sep === '') {
63
+ const out = [];
64
+ for (let i = 0; i < text.length; i += chunkSize)
65
+ out.push(text.slice(i, i + chunkSize));
66
+ return out;
67
+ }
68
+ const parts = text.split(sep);
69
+ const out = [];
70
+ for (let i = 0; i < parts.length; i++) {
71
+ const part = i < parts.length - 1 ? parts[i] + sep : parts[i];
72
+ if (part.length > chunkSize)
73
+ out.push(...splitRecursive(part, chunkSize, rest));
74
+ else
75
+ out.push(part);
76
+ }
77
+ return out;
78
+ }
79
+ /** Lowercase word tokens — memory `tokenize`. */
80
+ export function tokenize(text) {
81
+ return text.toLowerCase().split(/[\s\W]+/).filter(Boolean);
82
+ }
83
+ /** Estimated prompt tokens (~4 chars/token) — the shared heuristic, re-exported for this module's API. */
84
+ export { estimateTokens } from '../shared/tokens.js';
85
+ /**
86
+ * Content hash: two independent 32-bit FNV-1a lanes → 16 hex chars. Synchronous and
87
+ * portable; used for change detection and duplicate-chunk identity, not security.
88
+ */
89
+ export function contentHash(text) {
90
+ let a = 0x811c9dc5;
91
+ let b = 0x01000193 ^ 0x5bd1e995;
92
+ for (let i = 0; i < text.length; i++) {
93
+ const c = text.charCodeAt(i);
94
+ a = Math.imul(a ^ c, 0x01000193);
95
+ b = Math.imul(b ^ c, 0x01000193) ^ (b >>> 13);
96
+ }
97
+ return (a >>> 0).toString(16).padStart(8, '0') + (b >>> 0).toString(16).padStart(8, '0');
98
+ }
99
+ /** Scale `v` to unit length (a copy). Zero vectors stay zero. */
100
+ export function toUnit(v) {
101
+ const out = Float32Array.from(v);
102
+ let n = 0;
103
+ for (let i = 0; i < out.length; i++)
104
+ n += out[i] * out[i];
105
+ n = Math.sqrt(n);
106
+ if (n > 0)
107
+ for (let i = 0; i < out.length; i++)
108
+ out[i] = out[i] / n;
109
+ return out;
110
+ }
111
+ const K1 = 1.5;
112
+ const B = 0.75;
113
+ /** Incremental BM25 inverted index (memory `LexicalIndex` semantics). */
114
+ export class LexicalIndex {
115
+ postings = new Map();
116
+ docs = new Map();
117
+ totalLen = 0;
118
+ set(id, text) {
119
+ this.delete(id);
120
+ const tokens = tokenize(text);
121
+ const tf = new Map();
122
+ for (const t of tokens)
123
+ tf.set(t, (tf.get(t) ?? 0) + 1);
124
+ for (const [term, f] of tf) {
125
+ let p = this.postings.get(term);
126
+ if (!p)
127
+ this.postings.set(term, (p = new Map()));
128
+ p.set(id, f);
129
+ }
130
+ this.docs.set(id, { terms: [...tf.keys()], len: tokens.length });
131
+ this.totalLen += tokens.length;
132
+ }
133
+ delete(id) {
134
+ const doc = this.docs.get(id);
135
+ if (!doc)
136
+ return;
137
+ for (const term of doc.terms) {
138
+ const p = this.postings.get(term);
139
+ p?.delete(id);
140
+ if (p && p.size === 0)
141
+ this.postings.delete(term);
142
+ }
143
+ this.totalLen -= doc.len;
144
+ this.docs.delete(id);
145
+ }
146
+ /** Every positive-scoring id, best first (score desc, id asc). */
147
+ search(query) {
148
+ const n = this.docs.size;
149
+ if (n === 0)
150
+ return [];
151
+ const avgdl = this.totalLen / n || 1;
152
+ const scores = new Map();
153
+ for (const term of [...new Set(tokenize(query))].sort()) {
154
+ const p = this.postings.get(term);
155
+ if (!p)
156
+ continue;
157
+ const df = p.size;
158
+ const idf = Math.log(1 + (n - df + 0.5) / (df + 0.5));
159
+ for (const [id, f] of p) {
160
+ const norm = 1 - B + B * (this.docs.get(id).len / avgdl);
161
+ scores.set(id, (scores.get(id) ?? 0) + (idf * f * (K1 + 1)) / (f + K1 * norm));
162
+ }
163
+ }
164
+ const hits = [];
165
+ for (const [id, score] of scores)
166
+ if (score > 0)
167
+ hits.push({ id, score });
168
+ return hits.sort(compareHits);
169
+ }
170
+ }
171
+ /** Score descending, then id ascending (memory `compareHits` order). */
172
+ export function compareHits(a, b) {
173
+ const qa = Math.round(a.score / 1e-6);
174
+ const qb = Math.round(b.score / 1e-6);
175
+ if (qa !== qb)
176
+ return qb - qa;
177
+ return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
178
+ }
179
+ //# sourceMappingURL=text.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/memoryIntegration/text.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,131 @@
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
+ /** Text → vector seam. Matches the memory-engine `TextEmbedder` interface exactly. */
11
+ export interface TextEmbedder {
12
+ /** Embed `text` as a vector of length {@link dimensions} (normalised here defensively). */
13
+ embed(text: string): Promise<Float32Array>;
14
+ readonly dimensions: number;
15
+ /** Model+tokenizer identity. Vectors are only comparable within one fingerprint. */
16
+ readonly fingerprint: string;
17
+ }
18
+ /** The knowledge classes the persistent layer holds. */
19
+ export type KnowledgeKind = 'business-doc' | 'source' | 'project' | 'structured' | 'decision' | 'approved';
20
+ export type MetadataValue = string | number | boolean;
21
+ /** One captured source document (a file, a business doc, a decision record, …). */
22
+ export interface KnowledgeDocument {
23
+ /** Stable id in the origin system. Re-ingesting the same id replaces its chunks. */
24
+ id: string;
25
+ text: string;
26
+ kind?: KnowledgeKind;
27
+ title?: string;
28
+ uri?: string;
29
+ metadata?: Record<string, MetadataValue>;
30
+ /** Write time (epoch ms) used by recency ranking and retention. Default `now`. */
31
+ updatedAt?: number;
32
+ }
33
+ /** Where a returned passage came from — carried by EVERY hit and citation. */
34
+ export interface SourceReference {
35
+ sourceId: string;
36
+ /** Increments each time the source's content changes. */
37
+ version: number;
38
+ contentHash: string;
39
+ chunkId: string;
40
+ chunkIndex: number;
41
+ /** Character offset of the chunk within the normalised source. */
42
+ start: number;
43
+ kind: KnowledgeKind;
44
+ title?: string;
45
+ uri?: string;
46
+ }
47
+ export interface StoredChunk {
48
+ id: string;
49
+ index: number;
50
+ start: number;
51
+ text: string;
52
+ hash: string;
53
+ tokens: number;
54
+ /** Unit-length embedding. */
55
+ vector: Float32Array;
56
+ }
57
+ /** The persisted form of one document — what IndexedDB holds across restarts. */
58
+ export interface StoredKnowledgeDoc {
59
+ id: string;
60
+ kind: KnowledgeKind;
61
+ title?: string;
62
+ uri?: string;
63
+ metadata: Record<string, MetadataValue>;
64
+ updatedAt: number;
65
+ version: number;
66
+ contentHash: string;
67
+ /** Embedder fingerprint the vectors were made with. */
68
+ fingerprint: string;
69
+ chunks: StoredChunk[];
70
+ }
71
+ export interface KnowledgeHit {
72
+ chunkId: string;
73
+ text: string;
74
+ score: number;
75
+ source: SourceReference;
76
+ metadata: Record<string, MetadataValue>;
77
+ }
78
+ /** Reranking hook: receives the fused candidates, returns them reordered/filtered. */
79
+ export type RerankHook = (query: string, hits: KnowledgeHit[]) => KnowledgeHit[] | Promise<KnowledgeHit[]>;
80
+ export interface RetrieveOptions {
81
+ topK?: number;
82
+ /** Equality filter over document metadata, or a predicate over the stored doc. */
83
+ filter?: Record<string, MetadataValue> | ((doc: StoredKnowledgeDoc) => boolean);
84
+ kinds?: KnowledgeKind[];
85
+ /** Half-life recency decay over fused scores (memory `decay.ts` semantics). 0/unset = off. */
86
+ recencyHalfLifeDays?: number;
87
+ now?: number;
88
+ /** Candidates taken from each of the dense and sparse rankings before fusion. Default 100. */
89
+ candidatePool?: number;
90
+ denseWeight?: number;
91
+ sparseWeight?: number;
92
+ /** RRF damping constant. Default 60 (memory `RRF_DEFAULT_K`). */
93
+ rrfK?: number;
94
+ rerank?: RerankHook;
95
+ }
96
+ export interface ContextOptions extends RetrieveOptions {
97
+ /** Hard cap on the estimated tokens injected into the prompt. */
98
+ tokenBudget: number;
99
+ }
100
+ export interface AssembledContext {
101
+ text: string;
102
+ tokens: number;
103
+ citations: SourceReference[];
104
+ hits: KnowledgeHit[];
105
+ duplicatesRemoved: number;
106
+ droppedForBudget: number;
107
+ }
108
+ export interface IngestResult {
109
+ id: string;
110
+ status: 'added' | 'updated' | 'unchanged';
111
+ version: number;
112
+ chunks: number;
113
+ /** Chunks that were actually sent to the embedder (0 when unchanged). */
114
+ embedded: number;
115
+ }
116
+ export interface RetentionPolicy {
117
+ /** Remove documents older than this (by `updatedAt`). */
118
+ maxAgeMs?: number;
119
+ /** Keep at most this many documents (oldest removed first). */
120
+ maxDocuments?: number;
121
+ /** Kinds retention never removes (e.g. user-approved knowledge). Default `['approved']`. */
122
+ keepKinds?: KnowledgeKind[];
123
+ now?: number;
124
+ }
125
+ /** Persistence port; `createIndexedDbKnowledgePersistence` is the browser implementation. */
126
+ export interface KnowledgePersistence {
127
+ load(): Promise<StoredKnowledgeDoc[]>;
128
+ put(doc: StoredKnowledgeDoc): Promise<void>;
129
+ delete(id: string): Promise<void>;
130
+ }
131
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memoryIntegration/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
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
+ export {};
11
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memoryIntegration/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}
package/dist/ml.d.ts ADDED
@@ -0,0 +1,52 @@
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 { BackendInfo, BackendKind, ChatMessage, GenerateOptions, GenerationStats, InferenceBackend, InferenceModel, InferenceToken, ModelRef, Quantization, RuntimeCapabilities, } from './inference/types.js';
24
+ export { createAdaptiveController, probeHardware } from './adaptive/controller.js';
25
+ export type { AdaptiveController } from './adaptive/controller.js';
26
+ export { planExecution } from './adaptive/planner.js';
27
+ export type { ControllerConfig, ExecutionDecision, ExecutionGraph, ExecutionOutcome, ExecutionPlan, ExecutionStrategy, ExecutorLike, HardwareProfile, LayerNode, WorkloadProfile, } from './adaptive/types.js';
28
+ export { createMemoryManager, probeRamBytes, probeStorageQuotaBytes } from './memory/manager.js';
29
+ export type { AdmitResult, MemoryManager, MemoryManagerOptions } from './memory/manager.js';
30
+ export { arcStrategy, costAwareStrategy, lfuStrategy, lruStrategy, retentionValue, strategyByName } from './memory/eviction.js';
31
+ export { bytesPerParam, estimateReloadCostMs, estimateReuseProbability, estimateWeightBytes } from './memory/estimates.js';
32
+ export type { ReloadCostInput, ReuseObservation } from './memory/estimates.js';
33
+ export { detectPressure, planWorkspace } from './memory/pressure.js';
34
+ export type { PressureInput, WorkspaceBounds, WorkspaceDecision } from './memory/pressure.js';
35
+ export { createMemorySink, createModelCacheSink } from './memory/storageSink.js';
36
+ export type { SpilledRecord, StorageSink, StorageSinkOptions } from './memory/storageSink.js';
37
+ export type { AdmitOptions, EvictionStrategy, LookupResult, MemoryManagerConfig, MemoryPressure, Quota, ResidencyEvent, ResidencyEventKind, ResidencyStats, ResidencyTier, ResidentEntry, TrackedEntry, } from './memory/types.js';
38
+ export { createKnowledgeMemory, createIndexedDbKnowledgePersistence, createMemoryKnowledgePersistence, chunkText as chunkKnowledgeText, normalizeText as normalizeKnowledgeText, contentHash as knowledgeContentHash, estimateTokens, } from './memoryIntegration/index.js';
39
+ export type { KnowledgeMemory, KnowledgeMemoryOptions, KnowledgeMemoryStats, IndexedDbKnowledgePersistenceOptions, TextEmbedder, KnowledgeKind, KnowledgeDocument, KnowledgeHit, KnowledgePersistence, StoredKnowledgeDoc, StoredChunk, SourceReference, RetrieveOptions, ContextOptions, AssembledContext, IngestResult, RetentionPolicy, RerankHook, } from './memoryIntegration/index.js';
40
+ export { createPrefetcher } from './prefetch/prefetcher.js';
41
+ export { mergePredictions, predictFromContext, predictFromGraph, predictFromHistory, PREFETCH_STRATEGIES, } from './prefetch/predictor.js';
42
+ export { createDoubleBuffer, createPrefillStream, probeSupport, pumpDoubleBuffer, } from './prefetch/streaming.js';
43
+ export type { DoubleBuffer, PrefillStream, PrefillStreamBackend, PrefillStreamOptions, PrefillStreamResult, PrefillToken, StreamChunk, } from './prefetch/streaming.js';
44
+ export type { PrefetchConfig, PrefetchContext, PrefetchEvent, PrefetchGraph, PrefetchEdge, Prefetcher, PrefetchOutcome, PrefetchPrediction, PrefetchReason, PrefetchRequestResult, PrefetchSkipReason, PrefetchStats, PrefetchStrategy, PrefetchTarget, PrefetchTuningConfig, ShouldThrottle, } from './prefetch/types.js';
45
+ export { createKvCacheRuntime } from './kvcache/runtime.js';
46
+ export { encodeCompatibilityKey, parseCompatibilityKey, compatibilityEquals, exactPrefixLength, } from './kvcache/compatibility.js';
47
+ export { planQuantization, defaultQualityScorer, DEFAULT_QUALITY_TOLERANCE } from './kvcache/quant.js';
48
+ export type { AdvancedCapabilities, CompatibilityKey, CompatibilityParts, KvCacheRuntime, KvCacheRuntimeOptions, KvCacheStats, KvGenerateRequest, KvGenerateResult, KvQuantization, OptimizationFlag, QualityScorer, QuantPlan, } from './kvcache/types.js';
49
+ export { createLearner, fingerprintWorkload, observationFromExecution } from './learning/index.js';
50
+ export { emptyStat, observeStat, ucb1, variance } from './learning/index.js';
51
+ export type { RunningStat, ConfigDeltaField, HistoryEntry, Learner, LearnerConfig, LearningStats, ObserveResult, OutcomeObservation, Recommendation, SafeStrategy, WorkloadFingerprintInput, } from './learning/index.js';
52
+ //# sourceMappingURL=ml.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ml.d.ts","sourceRoot":"","sources":["../src/ml.ts"],"names":[],"mappings":"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"}
package/dist/ml.js ADDED
@@ -0,0 +1,33 @@
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 { createModelCache, createMemoryModelCache } from './inference/modelCache.js';
11
+ export { createOnnxBackend } from './inference/backends/onnx.js';
12
+ export { createWllamaBackend } from './inference/backends/wllama.js';
13
+ export { createWebLlmBackend } from './inference/backends/webllm.js';
14
+ export { createMockBackend, MOCK_VOCAB } from './inference/backends/mock.js';
15
+ export { probeRuntimeCapabilities } from './inference/capabilities.js';
16
+ export { startInferenceWorkerHost, runInferenceWorker } from './inference/worker.js';
17
+ export { createAdaptiveController, probeHardware } from './adaptive/controller.js';
18
+ export { planExecution } from './adaptive/planner.js';
19
+ export { createMemoryManager, probeRamBytes, probeStorageQuotaBytes } from './memory/manager.js';
20
+ export { arcStrategy, costAwareStrategy, lfuStrategy, lruStrategy, retentionValue, strategyByName } from './memory/eviction.js';
21
+ export { bytesPerParam, estimateReloadCostMs, estimateReuseProbability, estimateWeightBytes } from './memory/estimates.js';
22
+ export { detectPressure, planWorkspace } from './memory/pressure.js';
23
+ export { createMemorySink, createModelCacheSink } from './memory/storageSink.js';
24
+ export { createKnowledgeMemory, createIndexedDbKnowledgePersistence, createMemoryKnowledgePersistence, chunkText as chunkKnowledgeText, normalizeText as normalizeKnowledgeText, contentHash as knowledgeContentHash, estimateTokens, } from './memoryIntegration/index.js';
25
+ export { createPrefetcher } from './prefetch/prefetcher.js';
26
+ export { mergePredictions, predictFromContext, predictFromGraph, predictFromHistory, PREFETCH_STRATEGIES, } from './prefetch/predictor.js';
27
+ export { createDoubleBuffer, createPrefillStream, probeSupport, pumpDoubleBuffer, } from './prefetch/streaming.js';
28
+ export { createKvCacheRuntime } from './kvcache/runtime.js';
29
+ export { encodeCompatibilityKey, parseCompatibilityKey, compatibilityEquals, exactPrefixLength, } from './kvcache/compatibility.js';
30
+ export { planQuantization, defaultQualityScorer, DEFAULT_QUALITY_TOLERANCE } from './kvcache/quant.js';
31
+ export { createLearner, fingerprintWorkload, observationFromExecution } from './learning/index.js';
32
+ export { emptyStat, observeStat, ucb1, variance } from './learning/index.js';
33
+ //# sourceMappingURL=ml.js.map
package/dist/ml.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ml.js","sourceRoot":"","sources":["../src/ml.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAErF,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAcrF,OAAO,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAatD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEjG,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAChI,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE3H,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAgBjF,OAAO,EACL,qBAAqB,EACrB,mCAAmC,EACnC,gCAAgC,EAChC,SAAS,IAAI,kBAAkB,EAC/B,aAAa,IAAI,sBAAsB,EACvC,WAAW,IAAI,oBAAoB,EACnC,cAAc,GACf,MAAM,8BAA8B,CAAC;AAqBtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AA4BjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAevG,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC"}
@@ -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,6 +20,12 @@ export declare class ChildRelay {
16
20
  private readonly children;
17
21
  constructor(spawn: (command: string, args: string[], options: ProcessOptions) => ChildHandle, post: (message: HostToWorker) => void);
18
22
  receive(message: ChildMessage): void;
23
+ /**
24
+ * Signal every child still running, except `detached` ones (they outlive their
25
+ * parent). Each child's own exit kills its children in turn, so this reaches
26
+ * grandchildren too; SIGTERM falls back to terminating after the grace period.
27
+ */
28
+ killAll(signal: string): void;
19
29
  private start;
20
30
  }
21
31
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"childRelay.d.ts","sourceRoot":"","sources":["../../src/node/childRelay.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhE,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,YAAY,GAAG,cAAc,GAAG,WAAW,GAAG,sBAAsB,CAAA;CAAE,CAAC,CAAC;AAIpJ,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,IAAI,YAAY,CAE7E;AAED,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;gBAGxC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,KAAK,WAAW,EAChF,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI;IAGxD,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAmBpC,OAAO,CAAC,KAAK;CAkBd"}
1
+ {"version":3,"file":"childRelay.d.ts","sourceRoot":"","sources":["../../src/node/childRelay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhE,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,YAAY,GAAG,cAAc,GAAG,WAAW,GAAG,sBAAsB,CAAA;CAAE,CAAC,CAAC;AAIpJ,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,IAAI,YAAY,CAE7E;AAED,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiE;IAE1F,YACmB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,KAAK,WAAW,EAChF,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,EACpD;IAEJ,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAiBnC;IAED;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE5B;IAED,OAAO,CAAC,KAAK;CAkBd"}
@@ -13,7 +13,7 @@ export class ChildRelay {
13
13
  receive(message) {
14
14
  if (message.type === 'spawn')
15
15
  return this.start(message);
16
- const child = this.children.get(message.childId);
16
+ const child = this.children.get(message.childId)?.handle;
17
17
  switch (message.type) {
18
18
  case 'child-stdin':
19
19
  if (message.data === null)
@@ -31,6 +31,16 @@ export class ChildRelay {
31
31
  return child?.ipc?.disconnect();
32
32
  }
33
33
  }
34
+ /**
35
+ * Signal every child still running, except `detached` ones (they outlive their
36
+ * parent). Each child's own exit kills its children in turn, so this reaches
37
+ * grandchildren too; SIGTERM falls back to terminating after the grace period.
38
+ */
39
+ killAll(signal) {
40
+ for (const { handle, detached } of this.children.values())
41
+ if (!detached)
42
+ handle.kill(signal);
43
+ }
34
44
  start(message) {
35
45
  const { childId } = message;
36
46
  let child;
@@ -40,7 +50,7 @@ export class ChildRelay {
40
50
  catch (error) {
41
51
  return this.post({ type: 'child-error', childId, code: error.code ?? 'EFAIL', message: error.message });
42
52
  }
43
- this.children.set(childId, child);
53
+ this.children.set(childId, { handle: child, detached: !!message.detached });
44
54
  child.onStdout((data) => this.post({ type: 'child-out', childId, stream: 'stdout', data }));
45
55
  child.onStderr((data) => this.post({ type: 'child-out', childId, stream: 'stderr', data }));
46
56
  child.ipc?.onMessage((data) => this.post({ type: 'child-ipc', childId, data }));