mlx-bun 0.4.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (601) hide show
  1. package/README.md +1453 -88
  2. package/THIRD_PARTY_NOTICES.md +882 -0
  3. package/bin/mlx-bun.convert.mjs +4 -0
  4. package/bin/mlx-bun.fuse.mjs +4 -0
  5. package/bin/mlx-bun.generate.mjs +4 -0
  6. package/bin/mlx-bun.lora.mjs +4 -0
  7. package/bin/mlx-bun.mjs +13 -21
  8. package/bin/mlx-bun.server.mjs +4 -0
  9. package/bin/mlx-bun.upload.mjs +4 -0
  10. package/dist/web/app.js +9584 -0
  11. package/package.json +50 -53
  12. package/src/cli/ane-install.ts +76 -0
  13. package/src/cli/args.ts +179 -0
  14. package/src/cli/engine-entry.ts +68 -0
  15. package/src/cli/inference.ts +214 -0
  16. package/src/cli/job-entry.ts +97 -0
  17. package/src/cli/library-host.ts +117 -0
  18. package/src/cli/main.ts +57 -0
  19. package/src/cli/memory-engine.ts +163 -0
  20. package/src/cli/memory.ts +36 -0
  21. package/src/cli/mlx-lm-aliases.ts +309 -0
  22. package/src/cli/model-choice.ts +33 -0
  23. package/src/cli/model-selection.ts +84 -0
  24. package/src/cli/module-host.ts +11 -0
  25. package/src/cli/module-verbs.ts +50 -0
  26. package/src/cli/numerical-policy.ts +12 -0
  27. package/src/cli/perplexity.ts +89 -0
  28. package/src/cli/serve-host.ts +423 -0
  29. package/src/cli/serve-isolated.ts +217 -0
  30. package/src/cli/serve-options.ts +106 -0
  31. package/src/cli/serve-state.ts +205 -0
  32. package/src/cli/serve.ts +500 -0
  33. package/src/cli/served-model-host.ts +102 -0
  34. package/src/cli/server-entry.ts +148 -0
  35. package/src/cli/serving-unit.ts +177 -0
  36. package/src/{tui.ts → cli/terminal.ts} +13 -8
  37. package/src/cli/worker-adapters.ts +34 -0
  38. package/src/cli/worker-entry.ts +272 -0
  39. package/src/cli/worker-unit.ts +179 -0
  40. package/src/engine/adapter-operation.ts +26 -0
  41. package/src/engine/cache-services.ts +114 -0
  42. package/src/engine/completion.ts +39 -0
  43. package/src/engine/generation-gateway.ts +358 -0
  44. package/src/engine/index.ts +59 -0
  45. package/src/engine/kv-budget.ts +120 -0
  46. package/src/engine/media-preparation.ts +232 -0
  47. package/src/engine/model-binding.ts +24 -0
  48. package/src/engine/model-host.ts +513 -0
  49. package/src/engine/model-serving.ts +89 -0
  50. package/src/{serve → engine}/preparation.ts +10 -8
  51. package/src/{serve → engine}/session-completion-engine.ts +6 -6
  52. package/src/engine/telemetry.ts +109 -0
  53. package/src/hub/downloads.ts +116 -0
  54. package/src/jobs/db.ts +16 -7
  55. package/src/jobs/events.ts +29 -0
  56. package/src/jobs/executable.ts +5 -0
  57. package/src/jobs/host.ts +51 -0
  58. package/src/jobs/in-process.ts +55 -0
  59. package/src/{contracts/jobs.ts → jobs/protocol.ts} +7 -9
  60. package/src/jobs/runner.ts +150 -231
  61. package/src/jobs/service.ts +75 -0
  62. package/src/jobs/sse.ts +59 -23
  63. package/src/jobs/worker-memory.ts +46 -0
  64. package/src/jobs/worker-process.ts +163 -0
  65. package/src/jobs/worker-supervisor.ts +258 -0
  66. package/src/modules.ts +58 -0
  67. package/src/publishing/catalog-hub.ts +18 -0
  68. package/src/publishing/credentials.ts +31 -0
  69. package/src/publishing/upload.ts +37 -0
  70. package/src/residency/leased-adapters.ts +21 -0
  71. package/src/residency/local-records.ts +16 -0
  72. package/src/residency/model-residency.ts +405 -0
  73. package/src/residency/record-index.ts +28 -0
  74. package/src/residency/resident-estimate.ts +50 -0
  75. package/src/{anthropic.ts → server/anthropic.ts} +3 -81
  76. package/src/server/cache-routes.ts +36 -0
  77. package/src/{serve → server}/chat-request.ts +12 -10
  78. package/src/{serve → server}/chat-stage.ts +27 -22
  79. package/src/{client.ts → server/client.ts} +28 -2
  80. package/src/{serve → server}/completion-executor.ts +42 -42
  81. package/src/server/decision-body.ts +55 -0
  82. package/src/server/decision-routes.ts +134 -0
  83. package/src/server/decision-wire.ts +228 -0
  84. package/src/{serve → server}/discovery-routes.ts +42 -83
  85. package/src/server/generated-token-history.ts +57 -0
  86. package/src/{serve → server}/http.ts +25 -13
  87. package/src/{serve → server}/inference-request.ts +5 -5
  88. package/src/server/job-routes.ts +20 -0
  89. package/src/server/media-prompt.ts +63 -0
  90. package/src/server/memory-completion-client.ts +46 -0
  91. package/src/server/model-routes.ts +192 -0
  92. package/src/{serve → server}/openai-wire.ts +3 -2
  93. package/src/{serve → server}/pipeline.ts +1 -1
  94. package/src/server/prompt-builder.ts +13 -0
  95. package/src/server/prompt-contracts.ts +17 -0
  96. package/src/server/proxy-routes.ts +187 -0
  97. package/src/server/publishing-routes.ts +41 -0
  98. package/src/{serve → server}/request-plan.ts +8 -8
  99. package/src/{serve → server}/request-prep.ts +82 -68
  100. package/src/{serve → server}/responses-client.ts +30 -13
  101. package/src/{responses.ts → server/responses.ts} +12 -93
  102. package/src/server/routes.ts +205 -0
  103. package/src/server/start.ts +72 -0
  104. package/src/server/status-routes.ts +108 -0
  105. package/src/{serve → server}/text-completion-stage.ts +25 -4
  106. package/src/server/text-prompt.ts +12 -0
  107. package/src/{serve → server}/token-streams.ts +36 -38
  108. package/src/server/worker-routes.ts +311 -0
  109. package/src/storage/paths.ts +61 -0
  110. package/src/web/assets.ts +37 -0
  111. package/src/web/{src → browser}/api.ts +5 -23
  112. package/src/web/browser/chat-host.ts +17 -0
  113. package/src/web/browser/installed-panels.ts +6 -0
  114. package/src/web/browser/main.ts +55 -0
  115. package/src/web/browser/markdown.ts +279 -0
  116. package/src/web/browser/memory-panel.ts +9 -0
  117. package/src/web/browser/palette.ts +64 -0
  118. package/src/web/browser/protocol.ts +13 -0
  119. package/src/web/browser/shell.ts +467 -0
  120. package/src/web/{src → browser}/status.ts +32 -36
  121. package/src/web/build.ts +51 -0
  122. package/src/web/public/app.html +1054 -0
  123. package/src/web/{sw.js → public/sw.js} +4 -3
  124. package/src/web/{vendor → public/vendor}/hljs-theme.css +2 -2
  125. package/src/web/{vendor → public/vendor}/hljs.js +2 -2
  126. package/THIRD_PARTY_LICENSES.md +0 -51
  127. package/docs/README.md +0 -94
  128. package/docs/archive/hlg-sampling.md +0 -350
  129. package/docs/archive/investigations/audio-input-plan.md +0 -356
  130. package/docs/archive/investigations/chunk-finetune-experiment.md +0 -84
  131. package/docs/archive/investigations/colibri-glm52-port.md +0 -1486
  132. package/docs/archive/investigations/colibri-oracle-pin.md +0 -1284
  133. package/docs/archive/investigations/curve-bisector-routing.md +0 -123
  134. package/docs/archive/investigations/decode-roofline-lookagain.md +0 -348
  135. package/docs/archive/investigations/diffusion-gemma-port.md +0 -602
  136. package/docs/archive/investigations/dspark-handoff.md +0 -224
  137. package/docs/archive/investigations/expert-offload-single-user-moe.md +0 -292
  138. package/docs/archive/investigations/faithful-l1-consolidation.md +0 -310
  139. package/docs/archive/investigations/hlg-sampling-investigation.md +0 -970
  140. package/docs/archive/investigations/indexshare-performance-spike.md +0 -357
  141. package/docs/archive/investigations/kernel-perf-review-2026-07.md +0 -171
  142. package/docs/archive/investigations/lab-build-journal.md +0 -157
  143. package/docs/archive/investigations/minicpm5-decode-megakernel.md +0 -489
  144. package/docs/archive/investigations/openjarvis-fit.md +0 -198
  145. package/docs/archive/investigations/openwiki-evaluation.md +0 -249
  146. package/docs/archive/investigations/optimization_plan.md +0 -346
  147. package/docs/archive/investigations/orpo-base-uf-experiment-and-directions.md +0 -120
  148. package/docs/archive/investigations/orpo-flash-cce-pin-leak.md +0 -167
  149. package/docs/archive/investigations/orpo-uf-testing-handoff.md +0 -126
  150. package/docs/archive/investigations/pareto-specialized-runtime-findings.md +0 -92
  151. package/docs/archive/investigations/pi-builtin-investigation.md +0 -308
  152. package/docs/archive/investigations/pre-colibri-stabilization.md +0 -329
  153. package/docs/archive/investigations/qwen38-27b-campaign-log.md +0 -1092
  154. package/docs/archive/investigations/segmented-backward-handoff.md +0 -148
  155. package/docs/archive/investigations/starter-model-port-handoff.md +0 -342
  156. package/docs/archive/investigations/steel-flash-cce-handoff.md +0 -489
  157. package/docs/archive/investigations/the-dreaming-handoff.md +0 -141
  158. package/docs/archive/investigations/trainer-validation-experiment.md +0 -173
  159. package/docs/archive/planning/chat-ui-vision-memory-first.md +0 -199
  160. package/docs/archive/planning/chat-ui-vision.md +0 -50
  161. package/docs/archive/planning/chunk-task-roadmap.md +0 -77
  162. package/docs/archive/planning/curve-sampler-research-plan.md +0 -331
  163. package/docs/archive/planning/journal.md +0 -316
  164. package/docs/archive/planning/memory-docs-and-dag-plan.md +0 -194
  165. package/docs/archive/planning/pi-integration-review.md +0 -178
  166. package/docs/archive/planning/release-notes-v0.0.10.md +0 -57
  167. package/docs/archive/planning/release-notes-v0.0.11.md +0 -239
  168. package/docs/archive/planning/release-notes-v0.0.12.md +0 -80
  169. package/docs/archive/planning/release-notes-v0.0.13.md +0 -77
  170. package/docs/archive/planning/release-notes-v0.0.9.md +0 -122
  171. package/docs/archive/planning/release-notes-v0.2.0.md +0 -49
  172. package/docs/archive/planning/release-notes-v0.3.0.md +0 -35
  173. package/docs/archive/planning/web-ui-pass-plan.md +0 -213
  174. package/docs/archive/planning/website-readme-pass-plan.md +0 -224
  175. package/docs/design/batching.md +0 -1841
  176. package/docs/design/decode-speed-program.md +0 -2349
  177. package/docs/design/dreaming-nightly-pipeline.md +0 -684
  178. package/docs/design/generic-model-support.md +0 -705
  179. package/docs/design/kv-cache.md +0 -824
  180. package/docs/design/orpo-training.md +0 -680
  181. package/docs/design/speculative-decoding.md +0 -1990
  182. package/docs/design/turboquant.md +0 -2212
  183. package/docs/design/unified-engine-frontier-plan.md +0 -1880
  184. package/docs/design/web-chat-redesign.md +0 -695
  185. package/docs/planning/PRODUCT_ROADMAP.md +0 -594
  186. package/docs/planning/ResearchTopics.md +0 -119
  187. package/docs/planning/release-notes-v0.4.0.md +0 -45
  188. package/docs/planning/video-series.md +0 -421
  189. package/docs/reference/benchmarks.md +0 -3613
  190. package/docs/reference/cli.md +0 -585
  191. package/docs/reference/distribution.md +0 -355
  192. package/docs/reference/environment.md +0 -398
  193. package/docs/reference/glossary.md +0 -39
  194. package/docs/reference/library-api.md +0 -674
  195. package/docs/reference/memory.md +0 -260
  196. package/docs/reference/models.md +0 -334
  197. package/docs/reference/server-api.md +0 -1775
  198. package/docs/reference/server-config.md +0 -846
  199. package/docs/reference/training.md +0 -462
  200. package/docs/reference/troubleshooting.md +0 -158
  201. package/src/admission-plan.ts +0 -18
  202. package/src/audio/conformer.ts +0 -647
  203. package/src/audio/decode.ts +0 -133
  204. package/src/audio/features.ts +0 -202
  205. package/src/audio/transcode.ts +0 -67
  206. package/src/backends/mlx/assistant-target.ts +0 -46
  207. package/src/backends/mlx/autoregressive-draft-rows.ts +0 -120
  208. package/src/backends/mlx/autoregressive.ts +0 -108
  209. package/src/backends/mlx/batch-group.ts +0 -1790
  210. package/src/backends/mlx/cache-attachment.ts +0 -67
  211. package/src/backends/mlx/cache-layout.ts +0 -31
  212. package/src/backends/mlx/checkpoint-state.ts +0 -53
  213. package/src/backends/mlx/continuation-persistence.ts +0 -106
  214. package/src/backends/mlx/continuation-request.ts +0 -43
  215. package/src/backends/mlx/continuation.ts +0 -77
  216. package/src/backends/mlx/diffusion.ts +0 -39
  217. package/src/backends/mlx/draft-target.ts +0 -32
  218. package/src/backends/mlx/evaluation.ts +0 -105
  219. package/src/backends/mlx/fill-append.ts +0 -45
  220. package/src/backends/mlx/full-kv-row-append.ts +0 -32
  221. package/src/backends/mlx/full-kv-row-donor.ts +0 -54
  222. package/src/backends/mlx/full-transitioning-kv-rows.ts +0 -65
  223. package/src/backends/mlx/gateway-binding.ts +0 -130
  224. package/src/backends/mlx/graph.ts +0 -38
  225. package/src/backends/mlx/kv-codec.ts +0 -9
  226. package/src/backends/mlx/kv-maintenance.ts +0 -133
  227. package/src/backends/mlx/kv-tensor-rows.ts +0 -212
  228. package/src/backends/mlx/memory-client.ts +0 -189
  229. package/src/backends/mlx/methods.ts +0 -90
  230. package/src/backends/mlx/model-prompt.ts +0 -164
  231. package/src/backends/mlx/model-serving.ts +0 -79
  232. package/src/backends/mlx/prefill-cohort.ts +0 -89
  233. package/src/backends/mlx/prefill-rows.ts +0 -200
  234. package/src/backends/mlx/prefill.ts +0 -33
  235. package/src/backends/mlx/projected-context-rows.ts +0 -72
  236. package/src/backends/mlx/request-policy.ts +0 -20
  237. package/src/backends/mlx/request-state-policy.ts +0 -41
  238. package/src/backends/mlx/rollback.ts +0 -89
  239. package/src/backends/mlx/row-sampling.ts +0 -49
  240. package/src/backends/mlx/serial-executor.ts +0 -242
  241. package/src/backends/mlx/speculative-group.ts +0 -359
  242. package/src/backends/mlx/speculative-round.ts +0 -161
  243. package/src/backends/mlx/speculative.ts +0 -114
  244. package/src/backends/mlx/state-rows.ts +0 -104
  245. package/src/backends/mlx/state-views.ts +0 -46
  246. package/src/backends/mlx/target-layout-capability.ts +0 -35
  247. package/src/backends/mlx/text-engine.ts +0 -73
  248. package/src/backends/mlx/transitioning-kv-rows.ts +0 -165
  249. package/src/chat-template.ts +0 -382
  250. package/src/cli.ts +0 -3168
  251. package/src/config.ts +0 -399
  252. package/src/contracts/completion.ts +0 -16
  253. package/src/contracts/execution.ts +0 -60
  254. package/src/contracts/generation.ts +0 -103
  255. package/src/contracts/host.ts +0 -7
  256. package/src/contracts/pi-provider.ts +0 -30
  257. package/src/contracts/pi.ts +0 -259
  258. package/src/contracts/prefix-cache.ts +0 -23
  259. package/src/contracts/resources.ts +0 -25
  260. package/src/contracts/sampling.ts +0 -23
  261. package/src/contracts/scheduling.ts +0 -45
  262. package/src/contracts/tsconfig.json +0 -14
  263. package/src/dataset/generators.ts +0 -1087
  264. package/src/dataset/index.ts +0 -12
  265. package/src/dataset/job.ts +0 -81
  266. package/src/dataset/llm.ts +0 -71
  267. package/src/dataset/registry.ts +0 -528
  268. package/src/diffusion/diffusion-generate.ts +0 -507
  269. package/src/download.ts +0 -505
  270. package/src/embed.ts +0 -77
  271. package/src/engine/admission.ts +0 -59
  272. package/src/engine/cancellation.ts +0 -38
  273. package/src/engine/engine.ts +0 -56
  274. package/src/engine/execution-coordinator.ts +0 -70
  275. package/src/engine/execution-plan.ts +0 -53
  276. package/src/engine/resources.ts +0 -53
  277. package/src/engine/scheduler.ts +0 -72
  278. package/src/engine/session.ts +0 -247
  279. package/src/eval/README.md +0 -130
  280. package/src/eval/ifeval.ts +0 -81
  281. package/src/eval/kl-prompts.ts +0 -29
  282. package/src/eval/kl.ts +0 -590
  283. package/src/eval/perplexity.ts +0 -164
  284. package/src/eval/quality-db.ts +0 -92
  285. package/src/eval/reference-logits.ts +0 -207
  286. package/src/eval/runner.ts +0 -124
  287. package/src/eval/score.ts +0 -49
  288. package/src/eval/tasks/bfcl.ts +0 -535
  289. package/src/eval/tasks/gsm8k.ts +0 -98
  290. package/src/eval/tasks/hashhop.ts +0 -139
  291. package/src/eval/tasks/humaneval.ts +0 -275
  292. package/src/eval/tasks/ifeval.ts +0 -525
  293. package/src/eval/tasks/mmlu.ts +0 -157
  294. package/src/eval/ultrafeedback.ts +0 -60
  295. package/src/evaldb.ts +0 -199
  296. package/src/expert-io.ts +0 -393
  297. package/src/expert-offload-build.ts +0 -77
  298. package/src/expert-offload.ts +0 -76
  299. package/src/expert-residency.ts +0 -1134
  300. package/src/expert-usage.ts +0 -415
  301. package/src/fill/echo-index.ts +0 -188
  302. package/src/fill/fill-session.ts +0 -452
  303. package/src/fill/proposal.ts +0 -68
  304. package/src/fill/schema-rows.ts +0 -506
  305. package/src/fill/tool-boundary.ts +0 -103
  306. package/src/fit.ts +0 -249
  307. package/src/generate.ts +0 -1346
  308. package/src/grammar.ts +0 -591
  309. package/src/harness-pi.ts +0 -184
  310. package/src/hf-push.ts +0 -628
  311. package/src/hub-rest.ts +0 -242
  312. package/src/index.ts +0 -63
  313. package/src/inference/denoising.ts +0 -17
  314. package/src/inference/draft-acceptance.ts +0 -41
  315. package/src/inference/draft-output.ts +0 -49
  316. package/src/inference/graph.ts +0 -33
  317. package/src/inference/prefill.ts +0 -39
  318. package/src/inference/rollback.ts +0 -7
  319. package/src/jobs/index.ts +0 -31
  320. package/src/jobs/job-entry.ts +0 -107
  321. package/src/jobs/task-client.ts +0 -19
  322. package/src/jobs/types.ts +0 -2
  323. package/src/kv-scheme.ts +0 -257
  324. package/src/kv-store.ts +0 -1099
  325. package/src/lab/README.md +0 -18
  326. package/src/lab/curve/curve-designer.html +0 -303
  327. package/src/lab/curve/curve-sampler.ts +0 -122
  328. package/src/lab/expert-trace/expert-trace.ts +0 -69
  329. package/src/lab/paged-kv/paged-kv-rows.ts +0 -83
  330. package/src/lab/paged-kv/paged-kv.ts +0 -270
  331. package/src/library.ts +0 -40
  332. package/src/lora.ts +0 -408
  333. package/src/md-modules.d.ts +0 -49
  334. package/src/media-fetch.ts +0 -442
  335. package/src/memory/article.ts +0 -558
  336. package/src/memory/chunk-validation.ts +0 -150
  337. package/src/memory/chunk.ts +0 -318
  338. package/src/memory/cluster.ts +0 -351
  339. package/src/memory/coverage.ts +0 -134
  340. package/src/memory/crosslink.ts +0 -0
  341. package/src/memory/db.ts +0 -253
  342. package/src/memory/entity.ts +0 -203
  343. package/src/memory/gate.ts +0 -187
  344. package/src/memory/history.ts +0 -152
  345. package/src/memory/ingest.ts +0 -335
  346. package/src/memory/model.ts +0 -183
  347. package/src/memory/normalize.ts +0 -671
  348. package/src/memory/parse.ts +0 -22
  349. package/src/memory/pipeline.ts +0 -275
  350. package/src/memory/prompts.ts +0 -65
  351. package/src/memory/query.ts +0 -334
  352. package/src/memory/reconcile.ts +0 -734
  353. package/src/memory/redirect.ts +0 -108
  354. package/src/memory/reindex.ts +0 -325
  355. package/src/memory/resolve.ts +0 -307
  356. package/src/memory/rest.ts +0 -245
  357. package/src/memory/route.ts +0 -272
  358. package/src/memory/schedule.ts +0 -165
  359. package/src/memory/stages.ts +0 -777
  360. package/src/memory/synthesize.ts +0 -1638
  361. package/src/memory/tools.ts +0 -749
  362. package/src/memory/vault.ts +0 -1194
  363. package/src/memory/wikify.ts +0 -1064
  364. package/src/mlx/array.ts +0 -388
  365. package/src/mlx/autograd.ts +0 -304
  366. package/src/mlx/checkpoint.ts +0 -149
  367. package/src/mlx/compile.ts +0 -168
  368. package/src/mlx/custom-vjp.ts +0 -188
  369. package/src/mlx/ffi.ts +0 -512
  370. package/src/mlx/materialize.ts +0 -23
  371. package/src/mlx/metal-kernel.ts +0 -159
  372. package/src/mlx/ops.ts +0 -1021
  373. package/src/mlx/quantized-rows.ts +0 -36
  374. package/src/mlx/token-bitmask.ts +0 -52
  375. package/src/mlx/turboquant-kv-decode.ts +0 -82
  376. package/src/mlx/turboquant-kv-inverse.ts +0 -122
  377. package/src/mlx/turboquant-ops.ts +0 -861
  378. package/src/mlx/turboquant-tables.ts +0 -237
  379. package/src/mmap.ts +0 -90
  380. package/src/model/artifact-identity.ts +0 -73
  381. package/src/model/batched-kv.ts +0 -235
  382. package/src/model/batched-mask.ts +0 -279
  383. package/src/model/batched-quant.ts +0 -212
  384. package/src/model/batched-quantized-kv.ts +0 -144
  385. package/src/model/batched-rotating-quant.ts +0 -353
  386. package/src/model/batched-rotating-state.ts +0 -149
  387. package/src/model/batched-rotating.ts +0 -338
  388. package/src/model/batched-row-storage.ts +0 -179
  389. package/src/model/batched-ssm.ts +0 -52
  390. package/src/model/batched-turboquant-kv.ts +0 -93
  391. package/src/model/compiled-decode.ts +0 -712
  392. package/src/model/decoded-kv-donor.ts +0 -12
  393. package/src/model/delayed-quantized-kv.ts +0 -72
  394. package/src/model/delayed-rotating-quantized-kv.ts +0 -93
  395. package/src/model/delayed-turboquant-kv.ts +0 -55
  396. package/src/model/diffusion-gemma.ts +0 -1026
  397. package/src/model/factory.ts +0 -189
  398. package/src/model/fingerprint.ts +0 -33
  399. package/src/model/flash-attention.ts +0 -694
  400. package/src/model/full-prefill-padding.ts +0 -56
  401. package/src/model/full-prefill-row.ts +0 -105
  402. package/src/model/gemma4-base.ts +0 -2351
  403. package/src/model/gemma4.ts +0 -1315
  404. package/src/model/generated/gemma4-12b.ts +0 -429
  405. package/src/model/generated/gemma4-26b.ts +0 -448
  406. package/src/model/generated/gemma4-e4b.ts +0 -717
  407. package/src/model/generated/index.ts +0 -18
  408. package/src/model/glm52-atlas.ts +0 -511
  409. package/src/model/glm52-cache.ts +0 -792
  410. package/src/model/glm52-config.ts +0 -262
  411. package/src/model/glm52-container.ts +0 -305
  412. package/src/model/glm52-coupling.ts +0 -388
  413. package/src/model/glm52-dsa.ts +0 -606
  414. package/src/model/glm52-expert-layout.ts +0 -253
  415. package/src/model/glm52-layout.ts +0 -152
  416. package/src/model/glm52-memory.ts +0 -500
  417. package/src/model/glm52-mla.ts +0 -792
  418. package/src/model/glm52-moe.ts +0 -223
  419. package/src/model/glm52-pilot.ts +0 -537
  420. package/src/model/glm52-reference.ts +0 -445
  421. package/src/model/glm52-residency.ts +0 -557
  422. package/src/model/glm52-resident-weights.ts +0 -135
  423. package/src/model/glm52-streamed-experts.ts +0 -453
  424. package/src/model/glm52-streamed-metal.ts +0 -610
  425. package/src/model/glm52-weights.ts +0 -503
  426. package/src/model/glm52.ts +0 -1132
  427. package/src/model/implementation.ts +0 -69
  428. package/src/model/kv-attention-view.ts +0 -67
  429. package/src/model/minicpm5.ts +0 -376
  430. package/src/model/profile.ts +0 -443
  431. package/src/model/qwen-append.ts +0 -12
  432. package/src/model/qwen-conv.ts +0 -52
  433. package/src/model/qwen3-delta-state.ts +0 -74
  434. package/src/model/qwen3-delta.ts +0 -451
  435. package/src/model/qwen3-moe.ts +0 -404
  436. package/src/model/qwen3-mrope.ts +0 -252
  437. package/src/model/qwen3.ts +0 -277
  438. package/src/model/qwen3_5-checkpoint.ts +0 -164
  439. package/src/model/qwen3_5.ts +0 -819
  440. package/src/model/rotating-kv-donor.ts +0 -35
  441. package/src/model/rotating-kv-layout.ts +0 -262
  442. package/src/model/rotating-row-transaction.ts +0 -35
  443. package/src/model/speculative-rotating-kv.ts +0 -101
  444. package/src/model/ssm-prefill-padding.ts +0 -39
  445. package/src/model/support.ts +0 -102
  446. package/src/model/trellis-balanced-scatter.ts +0 -51
  447. package/src/model/trellis-linear.ts +0 -672
  448. package/src/model/trellis-shared-m.ts +0 -151
  449. package/src/model/trellis-shared-scatter.ts +0 -144
  450. package/src/model/trellis-splitk-prefill.ts +0 -158
  451. package/src/model/trellis-tiled-prefill.ts +0 -136
  452. package/src/model/trellis-vector-expand.ts +0 -62
  453. package/src/model/trellis-wide-prefill.ts +0 -94
  454. package/src/model/turboquant-codec.ts +0 -83
  455. package/src/model/universal/archs.ts +0 -332
  456. package/src/model/universal/dense.ts +0 -612
  457. package/src/model/universal/modules.ts +0 -170
  458. package/src/model/universal/rope.ts +0 -381
  459. package/src/native/expert_io.c +0 -523
  460. package/src/native/frame_extract.swift +0 -140
  461. package/src/native-pack.ts +0 -162
  462. package/src/pi-provider.ts +0 -53
  463. package/src/pi-session.ts +0 -81
  464. package/src/pi-terminal.ts +0 -274
  465. package/src/pi-web.ts +0 -1932
  466. package/src/preflight.ts +0 -158
  467. package/src/prompt-cache.ts +0 -460
  468. package/src/quantize/allocator.ts +0 -627
  469. package/src/quantize/atomic-output.ts +0 -38
  470. package/src/quantize/calibration.ts +0 -181
  471. package/src/quantize/config-writer.ts +0 -145
  472. package/src/quantize/index.ts +0 -84
  473. package/src/quantize/job.ts +0 -162
  474. package/src/quantize/quantizer.ts +0 -666
  475. package/src/quantize/rotate.ts +0 -603
  476. package/src/quantize/safetensors-writer.ts +0 -249
  477. package/src/quantize/sensitivity.ts +0 -216
  478. package/src/quantize/trellis.ts +0 -586
  479. package/src/quantize/weight-transform.ts +0 -292
  480. package/src/registry.ts +0 -602
  481. package/src/runtime-config.ts +0 -81
  482. package/src/safetensors.ts +0 -158
  483. package/src/sampler.ts +0 -1011
  484. package/src/serve/admin-routes.ts +0 -184
  485. package/src/serve/assets/curve-terrain.html +0 -105
  486. package/src/serve/assets/training-inference-map.html +0 -575
  487. package/src/serve/aux-routes.ts +0 -132
  488. package/src/serve/batch-scheduler.ts +0 -8
  489. package/src/serve/checkpoint-identity.ts +0 -64
  490. package/src/serve/generation-gateway.ts +0 -496
  491. package/src/serve/isolate.ts +0 -609
  492. package/src/serve/kv-budget.ts +0 -14
  493. package/src/serve/lab-routes.ts +0 -341
  494. package/src/serve/lane-registry.ts +0 -45
  495. package/src/serve/model-admin-routes.ts +0 -155
  496. package/src/serve/model-binding.ts +0 -43
  497. package/src/serve/model-host.ts +0 -511
  498. package/src/serve/parent-application.ts +0 -56
  499. package/src/serve/prompt-response-trace.ts +0 -147
  500. package/src/serve/response-lease.ts +0 -24
  501. package/src/serve/session-search.ts +0 -326
  502. package/src/serve/static-routes.ts +0 -101
  503. package/src/server.ts +0 -1314
  504. package/src/spec/assistant-rows.ts +0 -92
  505. package/src/spec/assistant-source.ts +0 -126
  506. package/src/spec/cache-identity.ts +0 -22
  507. package/src/spec/deepspec-rows.ts +0 -29
  508. package/src/spec/deepspec-source.ts +0 -145
  509. package/src/spec/dflash-source.ts +0 -149
  510. package/src/spec/drafter.ts +0 -304
  511. package/src/spec/dspark/ab-stats.ts +0 -136
  512. package/src/spec/dspark/calibration.ts +0 -112
  513. package/src/spec/dspark/data-dflash.ts +0 -156
  514. package/src/spec/dspark/data.ts +0 -201
  515. package/src/spec/dspark/deepspec-module.ts +0 -776
  516. package/src/spec/dspark/generate-dflash.ts +0 -245
  517. package/src/spec/dspark/generate.ts +0 -290
  518. package/src/spec/dspark/loader.ts +0 -23
  519. package/src/spec/dspark/loss.ts +0 -213
  520. package/src/spec/dspark/module-dflash.ts +0 -560
  521. package/src/spec/dspark/module.ts +0 -540
  522. package/src/spec/dspark/quantize-drafter.ts +0 -91
  523. package/src/spec/dspark/sample.ts +0 -112
  524. package/src/spec/generate.ts +0 -276
  525. package/src/spec/glm52-mtp-graph.ts +0 -29
  526. package/src/spec/glm52-mtp-rows.ts +0 -132
  527. package/src/spec/glm52-mtp-source.ts +0 -317
  528. package/src/spec/glm52-mtp-state.ts +0 -33
  529. package/src/spec/ngram-source.ts +0 -204
  530. package/src/spec/projected-draft-rows.ts +0 -73
  531. package/src/spec/qwen-mtp-module.ts +0 -171
  532. package/src/spec/qwen-mtp-rows.ts +0 -219
  533. package/src/spec/qwen-mtp-source.ts +0 -383
  534. package/src/spec/qwen-mtp-state.ts +0 -30
  535. package/src/spec/serve-loop.ts +0 -585
  536. package/src/spec/source.ts +0 -215
  537. package/src/spec/two-model-rows.ts +0 -61
  538. package/src/spec/two-model.ts +0 -113
  539. package/src/ssd-cache.ts +0 -372
  540. package/src/ssd-durability.ts +0 -211
  541. package/src/tokenizer.ts +0 -335
  542. package/src/tool-approvals.ts +0 -131
  543. package/src/tool-call.ts +0 -695
  544. package/src/train/dataset.ts +0 -484
  545. package/src/train/diffusion-lora.ts +0 -216
  546. package/src/train/export.ts +0 -32
  547. package/src/train/flash-cce.ts +0 -1234
  548. package/src/train/forward.ts +0 -266
  549. package/src/train/fuse.ts +0 -243
  550. package/src/train/index.ts +0 -46
  551. package/src/train/job.ts +0 -205
  552. package/src/train/lora-params.ts +0 -254
  553. package/src/train/loss.ts +0 -1591
  554. package/src/train/merge.ts +0 -195
  555. package/src/train/optimizer.ts +0 -183
  556. package/src/train/prefix-shared.ts +0 -490
  557. package/src/train/rank.ts +0 -137
  558. package/src/train/segmented.ts +0 -1828
  559. package/src/train/steel-qmm-header.ts +0 -1461
  560. package/src/train/trainer.ts +0 -1221
  561. package/src/train/watch.ts +0 -542
  562. package/src/vision/diffusion-vision.ts +0 -620
  563. package/src/vision/embedder.ts +0 -168
  564. package/src/vision/preprocess.ts +0 -247
  565. package/src/vision/prompt.ts +0 -373
  566. package/src/vision/qwen3vl-preprocess.ts +0 -409
  567. package/src/vision/qwen3vl-prompt.ts +0 -196
  568. package/src/vision/qwen3vl-tower.ts +0 -555
  569. package/src/vision/siglip.ts +0 -599
  570. package/src/vision/video-frames.ts +0 -148
  571. package/src/web/app.html +0 -2143
  572. package/src/web/app.js +0 -5703
  573. package/src/web/skills/memory/SKILL.md +0 -120
  574. package/src/web/skills/web-research/SKILL.md +0 -46
  575. package/src/web/skills.ts +0 -97
  576. package/src/web/src/adapters-panel.ts +0 -288
  577. package/src/web/src/assistant.ts +0 -451
  578. package/src/web/src/chat.ts +0 -1057
  579. package/src/web/src/composer.ts +0 -959
  580. package/src/web/src/dataset.ts +0 -132
  581. package/src/web/src/finetune.ts +0 -267
  582. package/src/web/src/hub.ts +0 -428
  583. package/src/web/src/main.ts +0 -98
  584. package/src/web/src/markdown.ts +0 -0
  585. package/src/web/src/memory-panel.ts +0 -572
  586. package/src/web/src/model-picker.ts +0 -159
  587. package/src/web/src/palette.ts +0 -346
  588. package/src/web/src/protocol.ts +0 -26
  589. package/src/web/src/quantize.ts +0 -167
  590. package/src/web/src/rag.ts +0 -274
  591. package/src/web/src/sessions.ts +0 -469
  592. package/src/web/src/shell.ts +0 -804
  593. package/src/web/src/ui-catalog.ts +0 -78
  594. package/src/web/vendor/README.md +0 -61
  595. package/src/web-assets.ts +0 -47
  596. package/src/web-tools.ts +0 -478
  597. package/src/weights.ts +0 -255
  598. /package/src/{serve → server}/completion-sink.ts +0 -0
  599. /package/src/web/{icon.svg → public/icon.svg} +0 -0
  600. /package/src/web/{manifest.webmanifest → public/manifest.webmanifest} +0 -0
  601. /package/src/web/{vendor → public/vendor}/hljs-LICENSE +0 -0
@@ -1,572 +0,0 @@
1
- // GENERATED-ADJACENT source module — part of the src/web/src/* split (plan
2
- // §7/§9 Phase 2). Built into src/web/app.js by scripts/build-web.ts.
3
- //
4
- // The Memory panel (plan §5.5), provenance chips (§5.4.2), personalized
5
- // hero chips + consent card (§5.1), and the sidebar entry that opens the
6
- // panel. Everything here talks to the /api/memory/* REST wrappers
7
- // (src/memory/rest.ts) — no new WS frames, per the task brief. esc()
8
- // discipline on every interpolation site: article names/content/commit
9
- // subjects/paths are all vault (i.e. user/model) data, never trusted.
10
- //
11
- // State model: the panel is a single overlay with two "screens" — a list
12
- // screen (status strip + search + article/reference lists) and an article
13
- // screen (rendered content + History toggle + links line). `view` tracks
14
- // which is showing so Back/Escape/re-open behave predictably; there is no
15
- // deep router here (the panel is not URL-addressable — matching the plan's
16
- // "reachable from the sidebar, not a nav tab" framing).
17
-
18
- import { $, el, toast, trapFocus, setMemPanelClose, type FocusTrap } from "./shell";
19
- import { api } from "./api";
20
- import type { ApiEnvelope } from "./protocol";
21
- import { esc, mdToHtml, wireCanvasToggle } from "./markdown";
22
-
23
- /* ────────────────────────────────────────────────────────────────────
24
- REST response shapes (mirrors src/memory/rest.ts's jsonOk() bodies —
25
- frontend-only types since these are HTTP JSON envelopes, not part of
26
- the typed WS contract in pi-web.ts). Each extends ApiEnvelope (api()'s
27
- generic constraint, api.ts) via intersection, per that file's own
28
- doc-comment convention.
29
- ──────────────────────────────────────────────────────────────────── */
30
-
31
- interface VaultStatusBody {
32
- root: string;
33
- exists: boolean;
34
- articleCount: number;
35
- referenceCount: number;
36
- isGitRepo: boolean;
37
- recentArticles: { article: string; mtimeMs: number }[];
38
- }
39
- type StatusResp = ApiEnvelope & { enabled?: boolean; status?: VaultStatusBody; root?: string };
40
- type ListResp = ApiEnvelope & { enabled?: boolean; articles?: string[]; reference?: string[] };
41
- interface SearchSummary { article: string; occurrences: number; matched_terms?: string[]; title_matches?: number }
42
- interface SearchHit { article: string; anchor: string | null; line: number; excerpt: string }
43
- type SearchResp = ApiEnvelope & { summaries?: SearchSummary[]; hits?: SearchHit[] };
44
- type ArticleResp = ApiEnvelope & {
45
- name?: string; path?: string; content?: string;
46
- infobox?: { entityKind?: string } | null; lead?: string | null;
47
- };
48
- type LinksResp = ApiEnvelope & { name?: string; outbound?: string[]; inbound?: string[] };
49
- interface HistoryEntry { hash: string; date: string; subject: string }
50
- type HistoryResp = ApiEnvelope & { name?: string; isGitRepo?: boolean; entries?: HistoryEntry[] };
51
- type DiffResp = ApiEnvelope & { name?: string; rev?: string; diff?: string };
52
- type InitResp = ApiEnvelope & { result?: { root: string; gitInitialized: boolean }; status?: VaultStatusBody };
53
-
54
- async function getJson<T extends ApiEnvelope>(path: string): Promise<T> {
55
- return api<T>(path);
56
- }
57
-
58
- /* ────────────────────────────────────────────────────────────────────
59
- Cached status — the panel, the sidebar entry, the hero chips, and the
60
- consent card all need "is memory enabled + how many articles" without
61
- each firing their own /api/memory/status round trip.
62
- ──────────────────────────────────────────────────────────────────── */
63
-
64
- let cachedStatus: StatusResp | null = null;
65
-
66
- async function fetchStatus(force = false): Promise<StatusResp> {
67
- if (cachedStatus && !force) return cachedStatus;
68
- const d = await getJson<StatusResp>("/api/memory/status").catch((): StatusResp => ({ ok: false, enabled: false }));
69
- cachedStatus = d;
70
- return d;
71
- }
72
-
73
- /* ────────────────────────────────────────────────────────────────────
74
- Panel open/close + focus trap (same mechanism as the HF modal / drawer)
75
- ──────────────────────────────────────────────────────────────────── */
76
-
77
- let panelTrap: FocusTrap;
78
- type View = { kind: "list" } | { kind: "article"; name: string; historyOpen?: boolean };
79
- let currentView: View = { kind: "list" };
80
- let lastListScroll = 0;
81
-
82
- export function isMemPanelOpen(): boolean {
83
- const ov = $("mem-overlay");
84
- return !!ov && ov.classList.contains("open");
85
- }
86
-
87
- export function closeMemPanel(): void {
88
- $("mem-overlay").classList.remove("open");
89
- $("chat-memory-entry").setAttribute("aria-expanded", "false");
90
- panelTrap.restore();
91
- }
92
-
93
- /** Opens the panel. `articleName` jumps straight to that article's view
94
- * (used by provenance chips and link-chip navigation); omitted opens/keeps
95
- * the list view. */
96
- export async function openMemPanel(articleName?: string): Promise<void> {
97
- panelTrap.capture();
98
- $("mem-overlay").classList.add("open");
99
- $("chat-memory-entry").setAttribute("aria-expanded", "true");
100
- if (articleName) await showArticle(articleName);
101
- else await showList();
102
- setTimeout(() => { const s = $("mem-search") as HTMLInputElement | null; if (s) s.focus(); }, 30);
103
- }
104
-
105
- function setBack(show: boolean): void {
106
- $("mem-back").classList.toggle("show", show);
107
- }
108
-
109
- /* ────────────────────────────────────────────────────────────────────
110
- Status strip
111
- ──────────────────────────────────────────────────────────────────── */
112
-
113
- function relDate(ms: number | undefined): string {
114
- if (!ms) return "—";
115
- const days = (Date.now() - ms) / 86_400_000;
116
- if (days < 1) return "today";
117
- if (days < 2) return "yesterday";
118
- if (days < 30) return Math.floor(days) + "d ago";
119
- try { return new Date(ms).toLocaleDateString(); } catch { return "—"; }
120
- }
121
-
122
- function renderStatusStrip(st: VaultStatusBody): void {
123
- const lastArticle = st.recentArticles[0];
124
- $("mem-status").innerHTML =
125
- '<span class="mem-stat"><b>' + st.articleCount + '</b> article' + (st.articleCount === 1 ? "" : "s") + "</span>" +
126
- '<span class="mem-stat">last touched <b>' + esc(relDate(lastArticle && lastArticle.mtimeMs)) + "</b></span>" +
127
- '<span class="mem-stat">' + (st.isGitRepo ? "git-tracked" : "not a git repo") + "</span>";
128
- }
129
-
130
- /* ────────────────────────────────────────────────────────────────────
131
- List view: status + search + article/reference lists
132
- ──────────────────────────────────────────────────────────────────── */
133
-
134
- function emptyVaultHtml(root: string): string {
135
- return (
136
- '<div class="mem-empty">' +
137
- "<p>No memory vault yet at <code>" + esc(root) + "</code>.</p>" +
138
- '<p style="margin-top:8px">Memory is a local, git-tracked wiki the assistant reads from (never writes to during chat) — nightly synthesis is what updates it.</p>' +
139
- '<div class="mcta"><button class="btn primary sm" id="mem-empty-init">Set up memory</button></div>' +
140
- "</div>"
141
- );
142
- }
143
-
144
- function articleRowHtml(name: string, excerpt?: string, icon = "📄"): string {
145
- const display = name.startsWith("Reference/") ? name.slice("Reference/".length) : name;
146
- return (
147
- '<div class="mem-art" data-article="' + esc(name) + '" tabindex="0" role="button">' +
148
- '<span class="mem-art-ico" aria-hidden="true">' + esc(icon) + "</span>" +
149
- '<div style="min-width:0;flex:1 1 auto">' +
150
- '<div class="mem-art-name">' + esc(display.replace(/_/g, " ")) + "</div>" +
151
- (excerpt ? '<div class="mem-art-excerpt">' + esc(excerpt) + "</div>" : "") +
152
- "</div></div>"
153
- );
154
- }
155
-
156
- function wireArticleRows(container: HTMLElement): void {
157
- container.querySelectorAll<HTMLElement>(".mem-art").forEach((row) => {
158
- const open = () => { const name = row.dataset.article; if (name) showArticle(name); };
159
- row.addEventListener("click", open);
160
- row.addEventListener("keydown", (e) => { if ((e as KeyboardEvent).key === "Enter") open(); });
161
- });
162
- }
163
-
164
- async function renderListBody(): Promise<void> {
165
- const body = $("mem-body");
166
- const st = await fetchStatus();
167
- if (!st.enabled || !st.status) {
168
- body.innerHTML = emptyVaultHtml(st.root || "~/.mlx-bun/wiki");
169
- const btn = $("mem-empty-init") as HTMLButtonElement | null;
170
- if (btn) btn.onclick = () => runInit(body);
171
- return;
172
- }
173
- renderStatusStrip(st.status);
174
- body.innerHTML =
175
- '<input type="search" id="mem-search" placeholder="Search articles…" aria-label="Search memory" autocomplete="off">' +
176
- '<div id="mem-list"></div>';
177
- await renderArticleLists("");
178
- const search = $("mem-search") as HTMLInputElement;
179
- let debounce: ReturnType<typeof setTimeout> | undefined;
180
- search.addEventListener("input", () => {
181
- clearTimeout(debounce);
182
- debounce = setTimeout(() => renderArticleLists(search.value.trim()), 180);
183
- });
184
- }
185
-
186
- async function renderArticleLists(query: string): Promise<void> {
187
- const listEl = $("mem-list");
188
- if (!query) {
189
- const d = await getJson<ListResp>("/api/memory/list").catch((): ListResp => ({ ok: false }));
190
- if (!d.ok) { listEl.innerHTML = '<div class="mem-list-empty">Couldn\'t load the vault contents.</div>'; return; }
191
- const articles = d.articles || [], reference = d.reference || [];
192
- listEl.innerHTML =
193
- '<div class="mem-sec"><div class="mem-sec-title">Articles</div>' +
194
- (articles.length
195
- ? articles.map((a) => articleRowHtml(a)).join("")
196
- : '<div class="mem-list-empty">No articles yet — nightly synthesis writes here after a few conversations.</div>') +
197
- "</div>" +
198
- // Reference/ docs are clearly separated (plan §5.5) — mlx-bun's own
199
- // docs, not personal memory.
200
- (reference.length
201
- ? '<div class="mem-sec"><div class="mem-sec-title">Reference</div>' +
202
- reference.map((r) => articleRowHtml(r, undefined, "📘")).join("") + "</div>"
203
- : "");
204
- wireArticleRows(listEl);
205
- return;
206
- }
207
- const d = await getJson<SearchResp>("/api/memory/search?q=" + encodeURIComponent(query)).catch((): SearchResp => ({ ok: false }));
208
- if (!d.ok || !d.summaries || !d.summaries.length) {
209
- listEl.innerHTML = '<div class="mem-list-empty">No matches for “' + esc(query) + '”.</div>';
210
- return;
211
- }
212
- const hitsByArticle = new Map<string, SearchHit>();
213
- for (const h of d.hits || []) if (!hitsByArticle.has(h.article)) hitsByArticle.set(h.article, h);
214
- listEl.innerHTML =
215
- '<div class="mem-sec"><div class="mem-sec-title">' + d.summaries.length + " match" + (d.summaries.length === 1 ? "" : "es") + "</div>" +
216
- d.summaries.map((s) => articleRowHtml(s.article, hitsByArticle.get(s.article)?.excerpt, s.article.startsWith("Reference/") ? "📘" : "📄")).join("") +
217
- "</div>";
218
- wireArticleRows(listEl);
219
- }
220
-
221
- async function runInit(body: HTMLElement): Promise<void> {
222
- body.innerHTML = '<div class="mem-empty"><p><span class="shimmer">setting up your local memory vault…</span></p></div>';
223
- const d = await api<InitResp>("/api/memory/init", { method: "POST" }).catch((): InitResp => ({ ok: false, error: "request failed" }));
224
- if (!d.ok) {
225
- toast("Couldn't set up memory: " + (d.error || "unknown error"), "err");
226
- cachedStatus = null;
227
- await renderListBody();
228
- return;
229
- }
230
- toast("Memory vault created", "ok");
231
- cachedStatus = null;
232
- await refreshSidebarEntry();
233
- await showList();
234
- }
235
-
236
- async function showList(): Promise<void> {
237
- currentView = { kind: "list" };
238
- setBack(false);
239
- $("mem-title").textContent = "Memory";
240
- $("mem-body").scrollTop = 0;
241
- await renderListBody();
242
- }
243
-
244
- /* ────────────────────────────────────────────────────────────────────
245
- Article view: rendered content + links line + History toggle
246
- ──────────────────────────────────────────────────────────────────── */
247
-
248
- function linksLineHtml(outbound: string[], inbound: string[]): string {
249
- if (!outbound.length && !inbound.length) return "";
250
- const row = (label: string, names: string[]) => names.length
251
- ? '<div class="mem-links-row"><span class="lbl">' + label + "</span>" +
252
- names.map((n) => '<button class="mem-link-chip" type="button" data-article="' + esc(n) + '">' + esc(n.replace(/_/g, " ")) + "</button>").join("") +
253
- "</div>"
254
- : "";
255
- return '<div class="mem-links">' + row("links to", outbound) + row("linked from", inbound) + "</div>";
256
- }
257
-
258
- function wireLinkChips(container: HTMLElement): void {
259
- container.querySelectorAll<HTMLButtonElement>(".mem-link-chip").forEach((btn) => {
260
- btn.addEventListener("click", () => { const name = btn.dataset.article; if (name) showArticle(name); });
261
- });
262
- }
263
-
264
- async function showArticle(name: string): Promise<void> {
265
- currentView = { kind: "article", name };
266
- setBack(true);
267
- const display = name.startsWith("Reference/") ? name.slice("Reference/".length) : name;
268
- $("mem-title").textContent = display.replace(/_/g, " ");
269
- const body = $("mem-body");
270
- body.innerHTML = '<p class="mem-list-empty"><span class="shimmer">loading article…</span></p>';
271
- body.scrollTop = 0;
272
-
273
- const [artRes, linksRes] = await Promise.all([
274
- getJson<ArticleResp>("/api/memory/article?name=" + encodeURIComponent(name)).catch((): ArticleResp => ({ ok: false })),
275
- getJson<LinksResp>("/api/memory/links?name=" + encodeURIComponent(name)).catch((): LinksResp => ({ ok: false })),
276
- ]);
277
- if (!artRes.ok || artRes.content == null) {
278
- body.innerHTML = '<div class="mem-list-empty">Couldn\'t load “' + esc(display) + '”.</div>';
279
- return;
280
- }
281
-
282
- body.innerHTML =
283
- '<div class="mem-art-head">' +
284
- '<div class="mem-art-tabs">' +
285
- '<button class="mem-art-tab active" id="mem-tab-view" type="button">Article</button>' +
286
- '<button class="mem-art-tab" id="mem-tab-history" type="button">History</button>' +
287
- "</div></div>" +
288
- '<div id="mem-art-view">' +
289
- // data-ui-chrome="content": rendered vault-article markdown (synthesized
290
- // from past conversations, not app-authored UI) can contain arbitrary
291
- // links — excluded from captureUiSnapshot for the same reason chat-thread
292
- // is (see assistant.ts's isAgentChrome doc comment: that snapshot is
293
- // re-served to the model verbatim as trusted UI state).
294
- '<div class="mem-article-render" data-ui-chrome="content">' + mdToHtml(artRes.content) + "</div>" +
295
- linksLineHtml((linksRes.outbound || []), (linksRes.inbound || [])) +
296
- "</div>" +
297
- '<div id="mem-art-history" style="display:none"></div>';
298
-
299
- wireLinkChips(body);
300
- ($("mem-tab-view") as HTMLButtonElement).onclick = () => switchArticleTab("view");
301
- ($("mem-tab-history") as HTMLButtonElement).onclick = () => switchArticleTab("history", name);
302
- }
303
-
304
- async function switchArticleTab(tab: "view" | "history", name?: string): Promise<void> {
305
- $("mem-tab-view").classList.toggle("active", tab === "view");
306
- $("mem-tab-history").classList.toggle("active", tab === "history");
307
- $("mem-art-view").style.display = tab === "view" ? "" : "none";
308
- $("mem-art-history").style.display = tab === "history" ? "" : "none";
309
- if (tab === "history" && name) await renderHistoryPane(name);
310
- }
311
-
312
- async function renderHistoryPane(name: string): Promise<void> {
313
- const pane = $("mem-art-history");
314
- if (pane.dataset.loaded === name) return; // cheap: don't re-fetch on every tab click
315
- pane.innerHTML = '<p class="mem-list-empty"><span class="shimmer">loading history…</span></p>';
316
- const d = await getJson<HistoryResp>("/api/memory/history?name=" + encodeURIComponent(name)).catch((): HistoryResp => ({ ok: false }));
317
- if (!d.ok || !d.entries) {
318
- pane.innerHTML = '<div class="mem-list-empty">No history available (not a git-tracked vault, or nothing committed yet).</div>';
319
- return;
320
- }
321
- if (!d.entries.length) {
322
- pane.innerHTML = '<div class="mem-list-empty">No commits touch this article yet.</div>';
323
- return;
324
- }
325
- pane.dataset.loaded = name;
326
- pane.innerHTML =
327
- d.entries.map((e) =>
328
- '<div class="mem-hist-entry" data-hash="' + esc(e.hash) + '" tabindex="0" role="button">' +
329
- '<span class="mem-hist-subject">' + esc(e.subject || "(no subject)") + "</span>" +
330
- '<span class="mem-hist-date">' + esc(e.date) + "</span>" +
331
- '<span class="mem-hist-hash">' + esc(e.hash.slice(0, 7)) + "</span>" +
332
- "</div>",
333
- ).join("") + '<div class="mem-diff" id="mem-diff-body" style="display:none"></div>';
334
- pane.querySelectorAll<HTMLElement>(".mem-hist-entry").forEach((row) => {
335
- const open = async () => {
336
- pane.querySelectorAll(".mem-hist-entry").forEach((r) => r.classList.remove("active"));
337
- row.classList.add("active");
338
- const hash = row.dataset.hash!;
339
- const diffEl = $("mem-diff-body");
340
- diffEl.style.display = "";
341
- diffEl.textContent = "loading diff…";
342
- const dr = await getJson<DiffResp>(
343
- "/api/memory/diff?name=" + encodeURIComponent(name) + "&rev=" + encodeURIComponent(hash),
344
- ).catch((): DiffResp => ({ ok: false }));
345
- diffEl.innerHTML = dr.ok && dr.diff ? diffToHtml(dr.diff) : '<span class="diffctx">Couldn\'t load this diff.</span>';
346
- };
347
- row.addEventListener("click", open);
348
- row.addEventListener("keydown", (e) => { if ((e as KeyboardEvent).key === "Enter") open(); });
349
- });
350
- }
351
-
352
- /** Render a `git show` unified diff as an added/removed-lines block, matching
353
- * the existing code-panel visual language (.diffadd/.diffdel, same classes
354
- * the approval card's edit-diff view uses). Line-oriented and escaped —
355
- * never trusts diff content as markup. */
356
- function diffToHtml(diff: string): string {
357
- return diff
358
- .split("\n")
359
- .map((line) => {
360
- if (line.startsWith("+++") || line.startsWith("---")) return '<span class="diffctx">' + esc(line) + "</span>";
361
- if (line.startsWith("@@")) return '<span class="diffhunk">' + esc(line) + "</span>";
362
- if (line.startsWith("+")) return '<span class="diffadd">' + esc(line) + "</span>";
363
- if (line.startsWith("-")) return '<span class="diffdel">' + esc(line) + "</span>";
364
- return '<span class="diffctx">' + esc(line) + "</span>";
365
- })
366
- .join("\n");
367
- }
368
-
369
- /* ────────────────────────────────────────────────────────────────────
370
- Sidebar entry (article count, quiet — not a nav tab)
371
- ──────────────────────────────────────────────────────────────────── */
372
-
373
- export async function refreshSidebarEntry(): Promise<void> {
374
- const st = await fetchStatus(true);
375
- const entry = $("chat-memory-entry");
376
- if (!st.ok || !st.enabled || !st.status) {
377
- // No vault yet: keep the entry reachable (opening it shows the
378
- // "set up memory" empty state) but the count reads as an invite, not
379
- // a stat, so it never looks like a broken zero.
380
- entry.style.display = "";
381
- $("chat-memory-count").textContent = "set up";
382
- return;
383
- }
384
- entry.style.display = "";
385
- $("chat-memory-count").textContent = String(st.status.articleCount);
386
- }
387
-
388
- /* ────────────────────────────────────────────────────────────────────
389
- Provenance chips (plan §5.4.2) — rendered by chat.ts in place of the
390
- generic wrench tool card for any memory_ or reference_ tool call.
391
- ──────────────────────────────────────────────────────────────────── */
392
-
393
- // Kept in sync with MEMORY_TOOL_NAMES/REFERENCE_TOOL_NAMES (src/memory/tools.ts)
394
- // by a literal list rather than an import: this module must stay
395
- // server-code-free (bundler-enforced, see chat.ts's header comment), so it
396
- // can't import a value from src/memory/tools.ts even though the identifiers
397
- // are the same. tests/using/web-app.test.ts cross-checks this list against the
398
- // real export so drift is caught at test time instead of silently.
399
- export const MEMORY_CHIP_TOOL_NAMES = [
400
- "memory_resolve", "memory_category", "memory_read", "memory_section",
401
- "memory_links", "memory_infobox", "memory_list", "memory_status", "memory_search",
402
- "reference_search", "reference_read", "reference_list",
403
- ] as const;
404
-
405
- export function isMemoryToolName(tool: string): boolean {
406
- return (MEMORY_CHIP_TOOL_NAMES as readonly string[]).includes(tool);
407
- }
408
-
409
- /** Best-effort article name out of a memory tool call's args (every memory_*
410
- * tool takes some form of `article`/`name`/`category`/`query`) — used only
411
- * for the chip's label and as the target for "open in Memory panel"; never
412
- * trusted for anything security-sensitive. */
413
- function articleNameFromArgs(tool: string, args: unknown): string | null {
414
- if (!args || typeof args !== "object") return null;
415
- const a = args as Record<string, unknown>;
416
- const cand = a.article ?? a.name ?? a.category ?? a.query;
417
- return typeof cand === "string" && cand.trim() ? cand.trim() : null;
418
- }
419
-
420
- function chipVerb(tool: string): string {
421
- if (tool === "memory_search" || tool === "reference_search") return "searched";
422
- if (tool === "memory_links") return "traced links from";
423
- if (tool === "memory_list" || tool === "memory_status" || tool === "reference_list") return "checked";
424
- return "read";
425
- }
426
-
427
- /** Builds the collapsed citation-chip DOM node for a memory/reference tool
428
- * call, appended into the assistant bubble in place of the generic .tool
429
- * wrench card (chat.ts dispatches on isMemoryToolName() before falling
430
- * back to its own toolCard()). Returns handles chat.ts needs to update the
431
- * chip as tool_update/tool_end frames arrive, mirroring ToolCardState's
432
- * shape closely enough that the call sites read the same way. */
433
- export interface MemChipHandle {
434
- wrap: HTMLElement;
435
- setResult(result: unknown): void;
436
- }
437
-
438
- export function memoryToolChip(parent: HTMLElement, tool: string, args: unknown): MemChipHandle {
439
- const articleName = articleNameFromArgs(tool, args);
440
- const wrap = el("div", "memchip", parent);
441
- const label = articleName
442
- ? "<b>" + chipVerb(tool) + "</b> " + esc(articleName.replace(/_/g, " "))
443
- : "<b>" + chipVerb(tool) + "</b> memory";
444
- wrap.innerHTML =
445
- '<div class="mchead"><span class="mcicon" aria-hidden="true">◆</span>' +
446
- '<span class="mclabel">' + label + "</span>" +
447
- '<span class="mccaret">›</span></div>' +
448
- '<div class="mcbody"><pre class="mcresult"></pre>' +
449
- (articleName ? '<button class="mcopen" type="button">Open in Memory</button>' : "") +
450
- "</div>";
451
- wrap.querySelector(".mchead")!.addEventListener("click", () => wrap.classList.toggle("open"));
452
- const openBtn = wrap.querySelector(".mcopen") as HTMLButtonElement | null;
453
- if (openBtn && articleName) openBtn.onclick = (e) => { e.stopPropagation(); openMemPanel(articleName); };
454
- const resultEl = wrap.querySelector(".mcresult") as HTMLElement;
455
- return {
456
- wrap,
457
- setResult(result: unknown) {
458
- const text = result != null ? (typeof result === "string" ? result : JSON.stringify(result, null, 2)) : "";
459
- resultEl.textContent = String(text).slice(-4000);
460
- },
461
- };
462
- }
463
-
464
- /* ────────────────────────────────────────────────────────────────────
465
- Personalized hero chips (plan §5.1) — replaces the 4 static chips with
466
- one drawn from a real article + one adapter offer when either backend
467
- signal is available; falls back to the existing static chips otherwise
468
- (never fewer chips than today, never a broken/empty row).
469
- ──────────────────────────────────────────────────────────────────── */
470
-
471
- interface AdapterAvailable { id: string; compatible?: boolean }
472
-
473
- /** Swaps in up to 2 personalized chips ahead of the static ones, using the
474
- * SAME .chip class + data-q click contract chat.ts already wires up (see
475
- * chat.ts's `#chat-hello .chip` listener) — so no new click-handling path
476
- * is needed for these chips to actually send a message. */
477
- export async function personalizeHeroChips(): Promise<void> {
478
- const container = $("chat-hello-chips");
479
- if (!container) return;
480
- const extra: string[] = [];
481
-
482
- const st = await fetchStatus();
483
- if (st.ok && st.enabled && st.status && st.status.recentArticles.length) {
484
- const name = st.status.recentArticles[0]!.article;
485
- const display = name.replace(/_/g, " ");
486
- extra.push(
487
- '<button class="chip" data-q="' + esc("What do you remember about " + display + "?") + '">Ask about ' + esc(display) + "</button>",
488
- );
489
- }
490
-
491
- try {
492
- const d = await getJson<{ adapters?: AdapterAvailable[] }>("/v1/adapters/available");
493
- const compatible = (d.adapters || []).find((a) => a.compatible !== false);
494
- if (compatible) {
495
- extra.push(
496
- '<button class="chip" data-q="' + esc("Can you try answering with the " + compatible.id + " adapter?") + '">Try the ' + esc(compatible.id) + " adapter</button>",
497
- );
498
- }
499
- } catch { /* adapters are optional personalization — no adapter list is not an error */ }
500
-
501
- if (!extra.length) return; // keep the existing static chips exactly as they are
502
- // No per-chip click wiring needed: chat.ts's init() binds ONE delegated
503
- // listener on #chat-hello-chips (not per-.chip), so newly-inserted nodes
504
- // work for free regardless of init() vs. this async call's ordering.
505
- container.insertAdjacentHTML("afterbegin", extra.join(""));
506
- }
507
-
508
- /* ────────────────────────────────────────────────────────────────────
509
- Consent card (plan §5.1) — first run only, never auto-creates the vault.
510
- ──────────────────────────────────────────────────────────────────── */
511
-
512
- const CONSENT_DISMISSED_KEY = "mlxbun.memoryConsentDismissed";
513
-
514
- function isConsentDismissed(): boolean {
515
- return localStorage.getItem(CONSENT_DISMISSED_KEY) === "1";
516
- }
517
- function dismissConsent(): void {
518
- localStorage.setItem(CONSENT_DISMISSED_KEY, "1");
519
- $("chat-consent").classList.remove("show");
520
- }
521
-
522
- /** Shows the consent card iff there's no vault yet and it's never been
523
- * dismissed. Called once after the first status fetch (chat.ts's init,
524
- * alongside personalizeHeroChips) — never polled/re-shown mid-session. */
525
- export async function maybeShowConsentCard(): Promise<void> {
526
- const card = $("chat-consent");
527
- if (!card) return;
528
- if (isConsentDismissed()) return;
529
- const st = await fetchStatus();
530
- if (st.ok && st.enabled) return; // vault already exists — nothing to consent to
531
- card.classList.add("show");
532
- }
533
-
534
- function wireConsentCard(): void {
535
- const skip = $("chat-consent-skip") as HTMLButtonElement | null;
536
- const yes = $("chat-consent-yes") as HTMLButtonElement | null;
537
- if (skip) skip.onclick = dismissConsent;
538
- if (yes) yes.onclick = async () => {
539
- yes.disabled = true;
540
- const d = await api<InitResp>("/api/memory/init", { method: "POST" }).catch((): InitResp => ({ ok: false, error: "request failed" }));
541
- yes.disabled = false;
542
- if (!d.ok) { toast("Couldn't set up memory: " + (d.error || "unknown error"), "err"); return; }
543
- dismissConsent();
544
- cachedStatus = null;
545
- toast("Memory vault created", "ok");
546
- await refreshSidebarEntry();
547
- await openMemPanel();
548
- };
549
- }
550
-
551
- /* ────────────────────────────────────────────────────────────────────
552
- Init — wires the sidebar entry, panel chrome (close/back/focus-trap/
553
- Escape), and the consent card. Call once at chat controller init.
554
- ──────────────────────────────────────────────────────────────────── */
555
-
556
- export function initMemoryPanel(): void {
557
- panelTrap = trapFocus($("mem-overlay"), isMemPanelOpen);
558
- setMemPanelClose(closeMemPanel); // registers with shell.ts's global Escape sweep
559
- const entry = $("chat-memory-entry") as HTMLButtonElement;
560
- entry.onclick = () => openMemPanel();
561
- ($("mem-close") as HTMLButtonElement).onclick = closeMemPanel;
562
- ($("mem-back") as HTMLButtonElement).onclick = () => showList();
563
- $("mem-overlay").addEventListener("click", (e) => { if (e.target === $("mem-overlay")) closeMemPanel(); });
564
- // Canvas v1 (plan §9 Phase 3): same Preview|Source toggle as the chat
565
- // thread, shared via markdown.ts — mem-body is the stable ancestor whose
566
- // innerHTML gets replaced per article, same delegation pattern as chat.ts.
567
- wireCanvasToggle($("mem-body"));
568
- wireConsentCard();
569
- refreshSidebarEntry();
570
- personalizeHeroChips();
571
- maybeShowConsentCard();
572
- }