mlx-bun 0.3.0 → 0.4.0

package/src/ssd-cache.ts

@@ -1,3 +1,4 @@
+import type { CheckpointAttachment } from "./backends/mlx/checkpoint-state";
 // SSD cold tier for the prompt/KV cache (docs/design/kv-cache.md).
 //
 // Files ARE the database: no sidecar index. Layout
@@ -22,10 +23,11 @@ import { randomUUID } from "node:crypto";
 import { commonPrefixLength } from "./prompt-cache";
 import {
   saveKvCache, saveKvCacheAsync, loadKvCache, readKvHeader,
-  cacheHeadersTrimmable, legacyCacheCodecs, type CacheCodecProvider,
+  cacheHeadersTrimmable, cacheHeadersMinimumReusableOffset, legacyCacheCodecs, type CacheCodecProvider,
   type KvSaveMeta, type KvLoadExpect, type LoadedKvCache,
 } from "./kv-store";
 import type { Cache } from "./model/gemma4-base";
+import { minimumReusableOffset } from "./backends/mlx/state-views";
 
 export interface SsdIndexEntry {
   path: string;
@@ -39,6 +41,7 @@ export interface SsdIndexEntry {
    *  over a shorter usable one (the 2026-07-06 restart-0 defect: the
    *  [prompt+gen] file always won, always got rejected after restore). */
   trimmable: boolean;
+  minimumReusableOffset?: number;
   generationCheckpoint?: NonNullable<KvSaveMeta["generationCheckpoint"]>;
 }
 
@@ -92,7 +95,7 @@ export class SsdCacheStore {
    * trimmable descendant is equivalent to an exact boundary snapshot. */
   hasDurablePrefix(tokens: number[], ns = ""): boolean {
     return this.#index.some((entry) => {
-      if (entry.ns !== ns || entry.tokens.length < tokens.length) return false;
+      if (entry.ns !== ns || entry.tokens.length < tokens.length || tokens.length < (entry.minimumReusableOffset ?? 0)) return false;
       if (commonPrefixLength(entry.tokens, tokens) !== tokens.length) return false;
       return entry.tokens.length === tokens.length || entry.trimmable;
     });
@@ -129,7 +132,8 @@ export class SsdCacheStore {
           const st = statSync(path);
           this.#index.push({
             path, ns: h.ns ?? "", tokens: h.tokens, bytes: st.size, mtimeMs: st.mtimeMs,
-            trimmable: cacheHeadersTrimmable(h.caches, this.#codecs),
+            trimmable: !h.attachments?.length && cacheHeadersTrimmable(h.caches, this.#codecs),
+            minimumReusableOffset: cacheHeadersMinimumReusableOffset(h.caches),
             ...(h.generationCheckpoint
               ? { generationCheckpoint: h.generationCheckpoint }
               : {}),
@@ -157,7 +161,7 @@ export class SsdCacheStore {
     for (const e of this.#index) {
       if (e.ns !== ns) continue;
       const p = Math.min(commonPrefixLength(e.tokens, prompt), prompt.length - 1);
-      if (p === 0 || p <= bestLen) continue;
+      if (p === 0 || p <= bestLen || p < (e.minimumReusableOffset ?? 0)) continue;
       if (e.tokens.length - p > 0 && !e.trimmable) continue;
       bestLen = p;
       best = e;
@@ -201,13 +205,13 @@ export class SsdCacheStore {
    *  the same ns whose tokens are a PREFIX of the new entry are superseded
    *  (the agent-conversation pattern: one growing entry, not N generations
    *  of it). Returns true if stored. */
-  store(tokens: number[], caches: Cache[], ns = ""): boolean {
+  store(tokens: number[], caches: Cache[], ns = "", attachments?: CheckpointAttachment[]): boolean {
     const dir = join(this.#root, nsHash(ns));
     const path = join(dir, `${randomUUID()}.mlxkv`);
     try {
       mkdirSync(dir, { recursive: true });
-      saveKvCache(path, tokens, caches, this.#meta(ns), this.#codecs);
-      return this.#indexStored(path, tokens, caches, ns);
+      saveKvCache(path, tokens, caches, { ...this.#meta(ns), attachments }, this.#codecs);
+      return this.#indexStored(path, tokens, caches, ns, undefined, attachments);
     } catch (err) {
       return this.#storeFailed(path, err);
     }
@@ -224,13 +228,14 @@ export class SsdCacheStore {
   async storeAsync(
     tokens: number[], caches: Cache[], ns = "",
     runStep?: <T>(step: () => T) => Promise<T>,
+    attachments?: CheckpointAttachment[],
   ): Promise<boolean> {
     const dir = join(this.#root, nsHash(ns));
     const path = join(dir, `${randomUUID()}.mlxkv`);
     try {
       mkdirSync(dir, { recursive: true });
-      await saveKvCacheAsync(path, tokens, caches, this.#meta(ns), runStep, this.#codecs);
-      return this.#indexStored(path, tokens, caches, ns);
+      await saveKvCacheAsync(path, tokens, caches, { ...this.#meta(ns), attachments }, runStep, this.#codecs);
+      return this.#indexStored(path, tokens, caches, ns, undefined, attachments);
     } catch (err) {
       return this.#storeFailed(path, err);
     }
@@ -260,25 +265,30 @@ export class SsdCacheStore {
    *  its rename succeeds, so a crash during a write leaves the prior point. */
   async storeGenerationCheckpoint(
     tokens: number[], caches: Cache[], checkpoint: NonNullable<KvSaveMeta["generationCheckpoint"]>,
+    runStep?: <T>(step: () => T) => Promise<T>,
   ): Promise<boolean> {
     const ns = `__generation_checkpoint__:${checkpoint.key}`;
     const dir = join(this.#root, nsHash(ns));
     const path = join(dir, `${randomUUID()}.mlxkv`);
     try {
-      mkdirSync(dir, { recursive: true });
+      if (runStep) await runStep(() => mkdirSync(dir, { recursive: true }));
+      else mkdirSync(dir, { recursive: true });
       await saveKvCacheAsync(path, tokens, caches, {
         ...this.#meta(ns), generationCheckpoint: checkpoint,
-      }, undefined, this.#codecs);
-      const stored = this.#indexStored(path, tokens, caches, ns, checkpoint);
-      if (stored) {
-        for (const entry of [...this.#index]) {
-          if (entry.path === path) continue;
-          if (entry.generationCheckpoint?.key === checkpoint.key) this.remove(entry.path);
+      }, runStep, this.#codecs);
+      const index = () => {
+        const stored = this.#indexStored(path, tokens, caches, ns, checkpoint);
+        if (stored) {
+          for (const entry of [...this.#index]) {
+            if (entry.path === path) continue;
+            if (entry.generationCheckpoint?.key === checkpoint.key) this.remove(entry.path);
+          }
         }
-      }
-      return stored;
+        return stored;
+      };
+      return runStep ? await runStep(index) : index();
     } catch (err) {
-      return this.#storeFailed(path, err);
+      return runStep ? await runStep(() => this.#storeFailed(path, err)) : this.#storeFailed(path, err);
     }
   }
 
@@ -299,6 +309,7 @@ export class SsdCacheStore {
   #indexStored(
     path: string, tokens: number[], caches: Cache[], ns: string,
     generationCheckpoint?: NonNullable<KvSaveMeta["generationCheckpoint"]>,
+    attachments?: CheckpointAttachment[],
   ): boolean {
     const st = statSync(path);
     if (st.size > this.#opts.maxBytes) {
@@ -306,7 +317,7 @@ export class SsdCacheStore {
       console.warn(`[ssd-cache] entry not stored: ${st.size} bytes exceeds the ${this.#opts.maxBytes}-byte cap`);
       return false;
     }
-    const trimmable = caches.every((c) => c.isTrimmable());
+    const trimmable = !attachments?.length && caches.every((c) => c.isTrimmable());
     // Exact duplicates (same tokens) are replaced regardless of
     // trimmability — the new file serves exactly the old one's matches.
     for (const e of [...this.#index]) {
@@ -321,12 +332,13 @@ export class SsdCacheStore {
     // unrestorable one landed.
     if (trimmable) {
       for (const e of [...this.#index]) {
-        if (e.ns !== ns || e.tokens.length >= tokens.length) continue;
+        if (e.ns !== ns || e.tokens.length >= tokens.length || e.tokens.length < minimumReusableOffset(caches)) continue;
         if (commonPrefixLength(e.tokens, tokens) === e.tokens.length) this.remove(e.path);
       }
     }
     this.#index.push({
       path, ns, tokens, bytes: st.size, mtimeMs: Date.now(), trimmable,
+      minimumReusableOffset: minimumReusableOffset(caches),
       ...(generationCheckpoint ? { generationCheckpoint } : {}),
     });
     this.stats.spills++;

package/src/ssd-durability.ts

@@ -1,10 +1,12 @@
+import { cloneAttachments } from "./backends/mlx/checkpoint-state";
+import { cleanupFailure, disposeResources } from "./engine/resources";
 import type { Cache } from "./model/gemma4";
 import type { PromptCacheEntry } from "./prompt-cache";
 import type { SpillItem, SpillQueue } from "./kv-store";
 
 export interface DurabilityGateway {
   readonly busy: boolean;
-  runExclusive<T>(fn: () => Promise<T>): Promise<T>;
+  runWhenIdle<T>(fn: () => Promise<T>): Promise<T>;
 }
 
 export interface DurabilityPromptCache {
@@ -128,15 +130,17 @@ export class SsdDurabilityCoordinator {
   async #store(rec: DirtySnapshot): Promise<StoreOutcome> {
     let snap: SpillItem | null = null;
     try {
-      snap = await this.gateway.runExclusive(async () => {
+      snap = await this.gateway.runWhenIdle(async () => {
         if (this.isAlreadyDurable(rec.tokens, rec.ns)) return null;
         const entry = this.promptCache.findExact(rec.tokens, rec.ns);
         if (!entry) return null;
-        return {
-          tokens: [...entry.tokens],
-          caches: this.cloneCaches(entry.caches),
-          ns: rec.ns,
-        };
+        const caches = this.cloneCaches(entry.caches);
+        try {
+          return { tokens: [...entry.tokens], caches, ns: rec.ns,
+            attachments: cloneAttachments(entry.attachments) };
+        } catch (error) {
+          return cleanupFailure(error, () => disposeResources(caches));
+        }
       });
     } catch {
       return "failed";

package/src/web/app.js

@@ -994,14 +994,14 @@ function highlightIn(container) {
     return;
   const blocks = container.querySelectorAll("pre code");
   for (const block of blocks) {
-    const el2 = block;
-    if (el2.dataset.highlighted)
+    const el = block;
+    if (el.dataset.highlighted)
       continue;
-    const hasLang = /\blanguage-/.test(el2.className);
-    if (!hasLang && (el2.textContent || "").length > 20000)
+    const hasLang = /\blanguage-/.test(el.className);
+    if (!hasLang && (el.textContent || "").length > 20000)
       continue;
     try {
-      hljs.highlightElement(el2);
+      hljs.highlightElement(el);
     } catch {}
   }
 }
@@ -2611,12 +2611,12 @@ async function renderListBody() {
 async function renderArticleLists(query) {
   const listEl = $("mem-list");
   if (!query) {
-    const d2 = await getJson("/api/memory/list").catch(() => ({ ok: false }));
-    if (!d2.ok) {
+    const d = await getJson("/api/memory/list").catch(() => ({ ok: false }));
+    if (!d.ok) {
       listEl.innerHTML = `<div class="mem-list-empty">Couldn't load the vault contents.</div>`;
       return;
     }
-    const articles = d2.articles || [], reference = d2.reference || [];
+    const articles = d.articles || [], reference = d.reference || [];
     listEl.innerHTML = '<div class="mem-sec"><div class="mem-sec-title">Articles</div>' + (articles.length ? articles.map((a) => articleRowHtml(a)).join("") : '<div class="mem-list-empty">No articles yet — nightly synthesis writes here after a few conversations.</div>') + "</div>" + (reference.length ? '<div class="mem-sec"><div class="mem-sec-title">Reference</div>' + reference.map((r) => articleRowHtml(r, undefined, "\uD83D\uDCD8")).join("") + "</div>" : "");
     wireArticleRows(listEl);
     return;
@@ -2953,11 +2953,11 @@ var INTERACTIVE_SELECTOR = [
   "[data-spotlight]"
 ].join(", ");
 var MAX_ELEMENTS = 120;
-function isAgentChrome(el2) {
-  return !!el2.closest("[data-ui-chrome]") || !!el2.closest("#toasts");
+function isAgentChrome(el) {
+  return !!el.closest("[data-ui-chrome]") || !!el.closest("#toasts");
 }
-function isHiddenSelf(el2) {
-  const html = el2;
+function isHiddenSelf(el) {
+  const html = el;
   if (html.hidden)
     return true;
   const inline = html.style?.display;
@@ -2968,21 +2968,21 @@ function isHiddenSelf(el2) {
     return true;
   return false;
 }
-function isVisible(el2) {
-  const html = el2;
+function isVisible(el) {
+  const html = el;
   if (html.offsetParent === null) {
     const style = globalThis.getComputedStyle?.(html);
     if (style && style.position === "fixed")
       return true;
   }
-  for (let node = el2;node; node = node.parentElement) {
+  for (let node = el;node; node = node.parentElement) {
     if (isHiddenSelf(node))
       return false;
   }
   return true;
 }
-function elementLabel(el2) {
-  const html = el2;
+function elementLabel(el) {
+  const html = el;
   const uiLabel = html.getAttribute("data-ui-label")?.trim();
   if (uiLabel)
     return uiLabel;
@@ -3017,13 +3017,13 @@ function captureUiSnapshot(route) {
   const elements = [];
   const seenRefs = new Set;
   let index = 0;
-  for (const el2 of nodes) {
-    if (isAgentChrome(el2) || !isVisible(el2))
+  for (const el of nodes) {
+    if (isAgentChrome(el) || !isVisible(el))
       continue;
-    const label = elementLabel(el2);
+    const label = elementLabel(el);
     if (!label)
       continue;
-    const html = el2;
+    const html = el;
     const spotlightId = html.getAttribute("data-spotlight")?.trim() || undefined;
     const existingRef = html.getAttribute("data-ui-ref");
     const ref = existingRef ?? `ui-${route.replace(/[^a-zA-Z0-9]/g, "_") || "root"}-${index}`;
@@ -3067,12 +3067,12 @@ function findByLabel(snapshot, label) {
     return;
   let best;
   let bestScore = 0;
-  for (const el2 of snapshot.elements) {
-    const hay = [el2.label, el2.spotlightId].filter(Boolean).join(" ");
+  for (const el of snapshot.elements) {
+    const hay = [el.label, el.spotlightId].filter(Boolean).join(" ");
     const score = matchScore(hay, label);
     if (score > bestScore) {
       bestScore = score;
-      best = el2;
+      best = el;
     }
   }
   return bestScore >= 50 ? best : undefined;
@@ -3089,9 +3089,9 @@ function safeQuery(selector) {
 }
 function resolveSpotlightTarget(request, snapshot) {
   if (request.ref) {
-    const el2 = snapshot?.elements.find((e) => e.ref === request.ref);
-    if (el2)
-      return { selector: el2.selector, title: el2.label, message: request.message };
+    const el = snapshot?.elements.find((e) => e.ref === request.ref);
+    if (el)
+      return { selector: el.selector, title: el.label, message: request.message };
     const selector = `[data-ui-ref="${attrEscape(request.ref)}"]`;
     if (safeQuery(selector)) {
       return { selector, title: request.label ?? request.ref, message: request.message };
@@ -3101,9 +3101,9 @@ function resolveSpotlightTarget(request, snapshot) {
     return { selector: request.selector, title: request.label ?? "Here", message: request.message };
   }
   if (request.label) {
-    const el2 = findByLabel(snapshot, request.label);
-    if (el2)
-      return { selector: el2.selector, title: el2.label, message: request.message };
+    const el = findByLabel(snapshot, request.label);
+    if (el)
+      return { selector: el.selector, title: el.label, message: request.message };
     let bestEl = null;
     let bestScore = 0;
     for (const node of document.querySelectorAll("[data-ui-label]")) {
@@ -3144,15 +3144,15 @@ var AUTO_DISMISS_MS = 3000;
 var dismissTimer = null;
 var dismissListeners = null;
 function ensureOverlayEl() {
-  let el2 = document.getElementById("assistant-spotlight");
-  if (!el2) {
-    el2 = document.createElement("div");
-    el2.id = "assistant-spotlight";
-    el2.setAttribute("data-ui-chrome", "assistant");
-    el2.innerHTML = '<div class="asr-ring"></div><div class="asr-pop"><div class="asr-pop-text"></div></div>';
-    document.body.appendChild(el2);
+  let el = document.getElementById("assistant-spotlight");
+  if (!el) {
+    el = document.createElement("div");
+    el.id = "assistant-spotlight";
+    el.setAttribute("data-ui-chrome", "assistant");
+    el.innerHTML = '<div class="asr-ring"></div><div class="asr-pop"><div class="asr-pop-text"></div></div>';
+    document.body.appendChild(el);
   }
-  return el2;
+  return el;
 }
 function dismissSpotlight() {
   if (dismissTimer) {
@@ -3163,9 +3163,9 @@ function dismissSpotlight() {
     dismissListeners();
     dismissListeners = null;
   }
-  const el2 = document.getElementById("assistant-spotlight");
-  if (el2)
-    el2.classList.remove("show");
+  const el = document.getElementById("assistant-spotlight");
+  if (el)
+    el.classList.remove("show");
 }
 function showSpotlight(resolved) {
   const target = safeQuery(resolved.selector);
@@ -3332,7 +3332,7 @@ function createChatController() {
     }
     return false;
   }
-  function currentView2() {
+  function currentView() {
     if ($("mem-overlay")?.classList.contains("open"))
       return "memory-panel";
     if ($("hub-overlay")?.classList.contains("open"))
@@ -3345,16 +3345,16 @@ function createChatController() {
     const route = currentRoute();
     if (!isRouteId(route))
       return;
-    const ctx = buildAppContext(route, currentView2());
+    const ctx = buildAppContext(route, currentView());
     lastSnapshot = ctx.snapshot;
     send({ type: "context", context: ctx });
   }
   function watchWizardSteps() {
     const mo = new MutationObserver(() => pushAppContext());
     for (const id of ["q-steps", "f-steps", "d-steps"]) {
-      const el2 = $(id);
-      if (el2)
-        mo.observe(el2, { childList: true, subtree: true });
+      const el = $(id);
+      if (el)
+        mo.observe(el, { childList: true, subtree: true });
     }
   }
   function setChatStatus(s) {
@@ -3548,8 +3548,8 @@ function createChatController() {
     if (t)
       return t;
     if (isMemoryToolName(tool || "")) {
-      const handle2 = memoryToolChip(a.bubble, tool, args);
-      t = { kind: "memchip", wrap: handle2.wrap, handle: handle2, chunks: "" };
+      const handle = memoryToolChip(a.bubble, tool, args);
+      t = { kind: "memchip", wrap: handle.wrap, handle, chunks: "" };
       a.tools.set(callId, t);
       stick();
       return t;
@@ -3763,9 +3763,9 @@ function createChatController() {
     }
     for (const t of item.tools || []) {
       if (isMemoryToolName(t.name || "")) {
-        const handle2 = memoryToolChip(bubble, t.name, t.args);
+        const handle = memoryToolChip(bubble, t.name, t.args);
         if (t.result)
-          handle2.setResult(t.result);
+          handle.setResult(t.result);
         continue;
       }
       const wrap = el("div", "tool ok", bubble);
@@ -4081,9 +4081,9 @@ function createChatController() {
       watchWizardSteps();
       const overlayMo = new MutationObserver(() => pushAppContext());
       for (const id of ["mem-overlay", "hub-overlay", "adapters-overlay"]) {
-        const el2 = $(id);
-        if (el2)
-          overlayMo.observe(el2, { attributes: true, attributeFilter: ["class"] });
+        const el = $(id);
+        if (el)
+          overlayMo.observe(el, { attributes: true, attributeFilter: ["class"] });
       }
     },
     enter() {
@@ -4893,7 +4893,7 @@ function createStatusController() {
   async function loadFit() {
     let f;
     try {
-      f = await fetch("/fit").then((r2) => r2.json());
+      f = await fetch("/fit").then((r) => r.json());
     } catch {
       return;
     }
@@ -5319,9 +5319,9 @@ async function openHubPanel() {
   if (inFlightDownloads.size)
     ensureDownloadPolling();
   setTimeout(() => {
-    const el22 = $("hub-search-input");
-    if (el22)
-      el22.focus();
+    const el2 = $("hub-search-input");
+    if (el2)
+      el2.focus();
   }, 30);
 }
 function setOfflineFooter(offline) {

package/src/backends/mlx/memory-guard.ts

@@ -1,40 +0,0 @@
-import { DEFAULT_CHUNK, TRANSIENT_PER_TOKEN } from "../../fit";
-import { kvBytesAt, type KvSchemeOptions } from "../../kv-scheme";
-import { activeMemory, clearCache, maxRecommendedWorkingSetSize } from "../../mlx/ffi";
-import type { RuntimeModel } from "../../model/factory";
-import { Qwen35Model } from "../../model/qwen3_5";
-import type { PromptCache } from "../../prompt-cache";
-import { runtimeValue } from "../../runtime-config";
-
-/** Admission's ceiling and the cache that can release memory under the GPU lease. */
-export interface MlxMemoryBudget {
-  readonly usableBytes: number;
-  readonly kvOptions: KvSchemeOptions;
-  readonly promptCache: Pick<PromptCache, "relievePressure" | "totalBytes">;
-}
-
-/** Both execution paths enter after acquiring the request's reusable prefix.
- * The caller owns the GPU lease and must close the scope on every exit. */
-export function enterMlxMemoryGuard(model: RuntimeModel, budget: MlxMemoryBudget,
-  promptTokens: number, prefillChunkSize?: number): { check(): void; close(): void } {
-  const reserve = (prefillChunkSize ?? DEFAULT_CHUNK) * TRANSIENT_PER_TOKEN +
-    kvBytesAt(model.config, promptTokens, budget.kvOptions);
-  const ceiling = Math.min(budget.usableBytes, maxRecommendedWorkingSetSize());
-  const check = () => {
-    if (activeMemory() + reserve <= ceiling) return;
-    clearCache();
-    if (runtimeValue("MLX_BUN_PREFILL_MEM_LOG") === "1")
-      console.error(`[cache-memory] active=${activeMemory()} prompt=${budget.promptCache.totalBytes} reserve=${reserve} ceiling=${ceiling}`);
-    const count = budget.promptCache.relievePressure(() => {
-      clearCache();
-      return activeMemory() + reserve > ceiling;
-    });
-    if (count) console.log(`[prompt-cache] demoted ${count} entries for GPU headroom`);
-    if (activeMemory() + reserve > ceiling)
-      throw new Error("insufficient GPU headroom after prompt-cache demotion; saved generation checkpoints are retained");
-  };
-  const qwen = model instanceof Qwen35Model ? model : undefined;
-  const previous = qwen?.prefillMemoryGuard;
-  if (qwen) qwen.prefillMemoryGuard = check;
-  return { check, close() { if (qwen) qwen.prefillMemoryGuard = previous ?? null; } };
-}

package/src/spec/prefix-state.ts

@@ -1,45 +0,0 @@
-import type { Cache } from "../model/gemma4";
-import type { DisposableResource } from "../contracts/resources";
-import { cleanupFailure } from "../engine/resources";
-
-/** One most-recent, exact prefill boundary. Taking transfers ownership; a
- * recurrent target cannot be trimmed to an arbitrary common prefix. The
- * provider owns this state and releases it before its weights at shutdown. */
-export interface SpeculativePrefixState extends DisposableResource {
-  readonly tokens: number[];
-  readonly targetIdentity: object;
-  readonly namespace: string;
-  readonly bytes: number;
-  readonly target: Cache[];
-}
-
-export class SpeculativePrefixStore<T extends SpeculativePrefixState> {
-  #entry: T | null = null;
-
-  take(prompt: readonly number[], targetIdentity: object, namespace: string,
-    maxBytes: number): T | null {
-    const entry = this.#entry;
-    this.#entry = null;
-    if (!entry) return null;
-    if (entry.bytes <= maxBytes && entry.targetIdentity === targetIdentity &&
-      entry.namespace === namespace && entry.tokens.length < prompt.length &&
-      entry.tokens.every((token, index) => prompt[index] === token))
-      return entry;
-    entry.dispose();
-    return null;
-  }
-
-  /** Takes ownership even when the entry exceeds the configured RAM budget. */
-  put(entry: T, maxBytes: number): void {
-    try { this.dispose(); }
-    catch (error) { cleanupFailure(error, () => entry.dispose()); }
-    if (entry.bytes <= maxBytes && maxBytes > 0) this.#entry = entry;
-    else entry.dispose();
-  }
-
-  dispose(): void {
-    const entry = this.#entry;
-    this.#entry = null;
-    entry?.dispose();
-  }
-}