akm-cli 0.9.17-alpha.3 → 0.9.17-alpha.4

package/dist/setup/registry-stash-loader.js

@@ -12,9 +12,8 @@
  * target below so a configured registry cannot preselect a different source
  * merely by reusing a trusted display ID.
  */
-import { jsonWithByteCap } from "../core/common.js";
 import { hasRegistryUrlCredentials } from "../core/registry-url.js";
-import { allowPrivateRegistryFixtureForTests, cancelRegistryResponse, fetchRegistryResponse, } from "../registry/network.js";
+import { fetchRegistryJson } from "../registry/network.js";
 import { parseRegistryRef } from "../registry/resolve.js";
 // ── Default selections ──────────────────────────────────────────────────────
 const AUTHENTICATED_DEFAULT_TARGETS = {
@@ -74,20 +73,12 @@ export async function loadSetupStashes(registryUrl, timeoutMs = 4000) {
 }
 async function loadSetupStashesReal(registryUrl, timeoutMs = 4000) {
     try {
-        const response = await fetchRegistryResponse(registryUrl, { headers: { Accept: "application/json" } }, {
-            policy: { kind: "public-registry" },
+        const raw = await fetchRegistryJson(registryUrl, {
+            headers: { Accept: "application/json" },
             timeoutMs,
             retries: 0,
-            allowPrivateHostsForTesting: allowPrivateRegistryFixtureForTests(registryUrl),
         });
-        if (!response.ok) {
-            await cancelRegistryResponse(response);
-            return FALLBACK_STASHES;
-        }
-        const raw = await jsonWithByteCap(response, 10 * 1024 * 1024, {
-            bodyTimeoutMs: timeoutMs,
-        });
-        if (!Array.isArray(raw.stashes) || raw.stashes.length === 0)
+        if (!Array.isArray(raw?.stashes) || raw.stashes.length === 0)
             return FALLBACK_STASHES;
         const entries = raw.stashes.flatMap((item) => {
             if (!item || typeof item !== "object")

package/dist/setup/semantic-assets.js

@@ -4,21 +4,13 @@
 /**
  * Semantic-search asset preparation for the setup wizard. Transformers.js is
  * a normal external package dependency; setup never mutates the installed CLI.
- * This module only prepares the model and probes sqlite-vec.
+ * This module only prepares the model.
  */
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
 import * as p from "../cli/clack.js";
 import { isHttpUrl } from "../core/common.js";
 import { checkEmbeddingAvailability, DEFAULT_LOCAL_MODEL, isTransformersAvailable } from "../llm/embedder.js";
-import { closeDatabase, openIndexDatabase } from "../storage/repositories/index-connection.js";
-import { isVecAvailable } from "../storage/repositories/index-vec-repository.js";
-// Approximate first-download sizes used in the setup note.
-// LOCAL_MODEL_APPROX_SIZE_MB tracks the default local model (DEFAULT_LOCAL_MODEL).
+// Approximate first-download size of the default local model (DEFAULT_LOCAL_MODEL), used in the setup note.
 const LOCAL_MODEL_APPROX_SIZE_MB = 130;
-// SQLITE_VEC_APPROX_SIZE_MB reflects the optional sqlite-vec install footprint.
-const SQLITE_VEC_APPROX_SIZE_MB = 5;
 export function isRemoteEmbeddingConfig(embedding) {
     return isHttpUrl(embedding?.endpoint);
 }
@@ -27,14 +19,10 @@ export function isRemoteEmbeddingConfig(embedding) {
  */
 export function describeSemanticSearchAssets(embedding) {
     if (isRemoteEmbeddingConfig(embedding)) {
-        return [
-            `• Embedding endpoint: ${embedding?.provider ?? "custom"} / ${embedding?.model} (no local model download)`,
-            `• sqlite-vec acceleration: optional native extension (~${SQLITE_VEC_APPROX_SIZE_MB} MB when installed separately)`,
-        ];
+        return [`• Embedding endpoint: ${embedding?.provider ?? "custom"} / ${embedding?.model} (no local model download)`];
     }
     return [
         `• Local embedding model: ${embedding?.localModel ?? DEFAULT_LOCAL_MODEL} (~${LOCAL_MODEL_APPROX_SIZE_MB} MB download on first use)`,
-        `• sqlite-vec acceleration: optional native extension (~${SQLITE_VEC_APPROX_SIZE_MB} MB when installed separately)`,
     ];
 }
 export async function prepareSemanticSearchAssets(config) {
@@ -69,34 +57,5 @@ export async function prepareSemanticSearchAssets(config) {
         }
     }
     spin.stop(remote ? "Remote embedding endpoint is ready." : "Local embedding model downloaded and ready.");
-    let db;
-    let probeDir;
-    try {
-        probeDir = fs.mkdtempSync(path.join(os.tmpdir(), "akm-setup-vec-probe-"));
-        db = openIndexDatabase(path.join(probeDir, "probe.db"), config.embedding?.dimension ? { embeddingDim: config.embedding.dimension } : undefined);
-        if (isVecAvailable(db)) {
-            p.log.info("sqlite-vec is available for fast vector search.");
-        }
-        else {
-            p.log.info("sqlite-vec is not available. Semantic search will use the JS fallback until the optional extension is installed.");
-        }
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        p.log.warn(`Could not open the local database or check for sqlite-vec. Semantic search will use the JS fallback. (${message})\n` +
-            "Check file permissions and available disk space in the cache directory, or run `akm index --full --verbose` to diagnose.");
-    }
-    finally {
-        if (db)
-            closeDatabase(db);
-        if (probeDir) {
-            try {
-                fs.rmSync(probeDir, { recursive: true, force: true });
-            }
-            catch {
-                /* ignore cleanup failure */
-            }
-        }
-    }
     return { ok: true };
 }

package/dist/setup/setup.js

@@ -117,7 +117,7 @@ export function assertSetupConfigPreflight() {
     catch (error) {
         if (!(error instanceof ConfigError))
             throw error;
-        if (error.code !== "UNSUPPORTED_CONFIG_VERSION" && error.code !== "INVALID_CONFIG_FILE")
+        if (error.code !== "INVALID_CONFIG_FILE")
             throw error;
         throw new ConfigError(`\`akm setup\` cannot run: the config at ${configPath} did not load (${error.message}). ` +
             "It was left untouched — setup never writes over a config it cannot first read cleanly.", error.code, "Rewrite the file using the current config schema, or move it aside to start fresh " +

package/dist/setup/steps/tasks.js

@@ -9,11 +9,11 @@ import { parse as yamlParse, stringify as yamlStringify } from "yaml";
 import * as p from "../../cli/clack.js";
 import { akmTasksSync } from "../../commands/tasks/tasks.js";
 import { makeBundleRef } from "../../core/asset/asset-ref.js";
-import { loadConfig, mutateConfig } from "../../core/config/config.js";
+import { loadConfig, mutateConfig, resetConfigCache } from "../../core/config/config.js";
 import { UsageError } from "../../core/errors.js";
 import { commitWriteTargetBoundary, deleteAssetFromSource, prepareWriteTargetForMutation, resolveWriteTarget, writeAssetToSource, } from "../../core/write-source.js";
-import { schedulerActivationSourceId, schedulerActivations } from "../../tasks/activation-config.js";
-import { backendNameForPlatform } from "../../tasks/backends/index.js";
+import { enabledRefsFromInstalled, isSchedulerBundleActive, schedulerEnabledRefs } from "../../tasks/activation-config.js";
+import { backendNameForPlatform, selectBackend } from "../../tasks/backends/index.js";
 import { listEmbeddedTasks } from "../../tasks/embedded.js";
 import { parseSchedule } from "../../tasks/schedule.js";
 import { parseTaskSource } from "../../tasks/source/parse-task-source.js";
@@ -77,9 +77,7 @@ export function listSetupTaskDefinitions() {
     const config = loadConfig();
     const target = resolveWriteTarget(config, config.defaultBundle, { requireWritable: false });
     const taskDir = path.join(target.source.path, "tasks");
-    const enabledRefs = new Set(schedulerActivations(config)
-        .filter((activation) => activation.kind === "task")
-        .map((activation) => activation.ref));
+    const enabledRefs = new Set(schedulerEnabledRefs(config) ?? []);
     if (!fs.existsSync(taskDir))
         return [];
     const tasks = [];
@@ -178,17 +176,14 @@ export async function prepareSetupTaskDefinitions(tasks, deps = {}) {
     const selected = new Set(tasks.filter((plan) => plan.enabled).map((plan) => makeBundleRef(target.source.name, `tasks/${plan.task.id}`)));
     const managed = new Set(tasks.map((plan) => makeBundleRef(target.source.name, `tasks/${plan.task.id}`)));
     mutateConfig((current) => {
-        const existing = schedulerActivations(current);
-        const next = existing.filter((activation) => activation.kind !== "task" || !managed.has(activation.ref));
-        const sourceId = schedulerActivationSourceId(current, target.source.name);
-        if (selected.size > 0 && !sourceId) {
+        const existing = schedulerEnabledRefs(current) ?? [];
+        const next = existing.filter((ref) => !managed.has(ref));
+        if (selected.size > 0 && !isSchedulerBundleActive(current, target.source.name)) {
             throw new UsageError(`Cannot activate setup tasks from disabled bundle ${JSON.stringify(target.source.name)}.`);
         }
-        for (const ref of selected) {
-            next.push({ kind: "task", ref, sourceId: sourceId });
-        }
-        next.sort((left, right) => left.ref.localeCompare(right.ref) || left.kind.localeCompare(right.kind));
-        if (JSON.stringify(existing) === JSON.stringify(next))
+        next.push(...selected);
+        next.sort((left, right) => left.localeCompare(right));
+        if (current.scheduler?.enabled !== undefined && JSON.stringify([...existing]) === JSON.stringify(next))
             return current;
         return { ...current, scheduler: { ...current.scheduler, enabled: next } };
     });
@@ -198,6 +193,7 @@ const DEFAULT_SCHEDULED_TASKS_DEPS = {
     list: listSetupTaskDefinitions,
     prepare: prepareSetupTaskDefinitions,
     sync: akmTasksSync,
+    inspectInstalled: async () => ({ installed: await selectBackend().list() }),
 };
 export async function stepScheduledTasks(deps = DEFAULT_SCHEDULED_TASKS_DEPS, options = {}) {
     if (options.nonInteractive || isCiEnvironment()) {
@@ -212,6 +208,20 @@ export async function stepScheduledTasks(deps = DEFAULT_SCHEDULED_TASKS_DEPS, op
     const embedded = listEmbeddedTasks();
     if (embedded.length === 0)
         return;
+    // A config that predates `scheduler.enabled` means "keep what is installed":
+    // make that explicit before the review below reads and edits the list.
+    if (schedulerEnabledRefs(loadConfig()) === undefined) {
+        try {
+            const inspection = await deps.inspectInstalled();
+            const refs = enabledRefsFromInstalled(inspection.installed, loadConfig());
+            mutateConfig((current) => ({ ...current, scheduler: { ...current.scheduler, enabled: [...refs] } }));
+            resetConfigCache();
+        }
+        catch (cause) {
+            const message = cause instanceof Error ? cause.message : String(cause);
+            p.log.warn(`Native scheduler bindings could not be inspected: ${message}`);
+        }
+    }
     const installed = await deps.list();
     const byId = new Map();
     for (const task of installed)

package/dist/sources/provider-factory.js

@@ -1,23 +1,22 @@
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * Source provider factory map.
- *
- * Maps source kind identifiers (e.g. "filesystem", "git", "website", "npm")
- * to factory functions that build {@link SourceProvider} instances from a
- * {@link SourceConfigEntry}.
- *
- * Distinct from the registry-discovery factory (`registry/factory.ts`).
- * Both share `create-provider-registry.ts` for the underlying string→factory
- * map.
- */
-import { createProviderRegistry } from "../registry/create-provider-registry.js";
-// ── Factory map ─────────────────────────────────────────────────────────────
-const registry = createProviderRegistry();
-export function registerSourceProvider(type, factory) {
-    registry.register(type, factory);
-}
+import { createFilesystemProvider } from "./providers/filesystem.js";
+import { GitSourceProvider } from "./providers/git-provider.js";
+import { NpmSourceProvider } from "./providers/npm.js";
+import { createWebsiteProvider } from "./providers/website.js";
+/** The factory for a configured source kind, or null for a kind akm does not support. */
 export function resolveSourceProviderFactory(type) {
-    return registry.resolve(type);
+    switch (type) {
+        case "filesystem":
+            return createFilesystemProvider;
+        case "git":
+            return (config) => new GitSourceProvider(config);
+        case "npm":
+            return (config) => new NpmSourceProvider(config);
+        case "website":
+            return createWebsiteProvider;
+        default:
+            return null;
+    }
 }

package/dist/sources/providers/filesystem.js

@@ -3,14 +3,13 @@
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 import { resolveStashDir } from "../../core/common.js";
 import { ConfigError } from "../../core/errors.js";
-import { registerSourceProvider } from "../provider-factory.js";
 /**
  * Filesystem source — points at a directory the user already manages.
  *
  * Implements {@link SourceProvider} with `{ name, kind, path }`. No `sync()`:
  * content is the user's own directory, never refreshed by akm.
  */
-registerSourceProvider("filesystem", (entry) => {
+export function createFilesystemProvider(entry) {
     if (entry.type !== "filesystem") {
         throw new ConfigError(`filesystem source invoked with type="${entry.type}"`);
     }
@@ -26,4 +25,4 @@ registerSourceProvider("filesystem", (entry) => {
             return stashDir;
         },
     };
-});
+}

package/dist/sources/providers/git-install.js

@@ -114,8 +114,14 @@ function normalizeRemoteUrl(value) {
         .replace(/\/+$/, "")
         .replace(/\.git$/i, "");
 }
-function replaceDirectory(stagedDir, destination) {
+/**
+ * Move a fully materialized directory into place. POSIX cannot rename over a
+ * non-empty directory, so the old one is renamed aside first and restored if
+ * the second rename fails; the destination is missing for one syscall at most.
+ */
+export function replaceDirectory(stagedDir, destination) {
     const backup = `${destination}.backup-${randomBytes(4).toString("hex")}`;
+    fs.mkdirSync(path.dirname(destination), { recursive: true });
     const hadDestination = fs.existsSync(destination);
     if (hadDestination)
         fs.renameSync(destination, backup);

package/dist/sources/providers/git-provider.js

@@ -11,7 +11,6 @@ import { ConfigError, UsageError } from "../../core/errors.js";
 import { getRegistryIndexCacheDir } from "../../core/paths.js";
 import { validateGitUrl } from "../../registry/resolve.js";
 import { withFreshnessCache } from "../freshness.js";
-import { registerSourceProvider } from "../provider-factory.js";
 import { assertNoIgnoredPathOverwrite, cloneRepo, inspectGitUpstream, runGit } from "./git-install.js";
 import { sanitizeString } from "./provider-utils.js";
 /** Cache TTL before refreshing the mirrored repo (12 hours). */
@@ -60,8 +59,6 @@ function resolveGitContentDir(config) {
     }
     throw new ConfigError("git source entry must have either `path` or `url`");
 }
-// ── Self-register ───────────────────────────────────────────────────────────
-registerSourceProvider("git", (config) => new GitSourceProvider(config));
 // ── Cache management ────────────────────────────────────────────────────────
 export function getCachePaths(repoUrl, cacheRootOverride) {
     const key = createHash("sha256").update(repoUrl).digest("hex").slice(0, 16);

package/dist/sources/providers/git-stash.js

@@ -204,9 +204,6 @@ export function saveGitStash(name, message, writableOverride, options) {
     }
     assertNoIgnoredExactPaths(repoDir, requestedPaths);
     const baseHead = readOptionalHead(repoDir);
-    if (options?.expectedBaseHead !== undefined && (baseHead ?? null) !== options.expectedBaseHead) {
-        throw new Error(`Git target advanced before its exact-path commit could be created.`);
-    }
     const remoteResult = runGit(["-C", repoDir, "remote"]);
     if (remoteResult.status !== 0) {
         throw new Error(`git remote failed: ${remoteResult.stderr?.trim() || "unknown error"}`);
@@ -300,20 +297,6 @@ export function assertNoIgnoredExactPaths(repoDir, paths) {
         throw new UsageError(`Exact Git publication path is ignored: ${ignored[0]}. Update .gitignore or choose a tracked destination before writing.`);
     }
 }
-/** Reject exact staged/unstaged paths before an AKM filesystem mutation. */
-export function assertGitExactPathsClean(repoDir, paths) {
-    const normalized = normalizeExactPaths(repoDir, paths);
-    assertNoIgnoredExactPaths(repoDir, normalized);
-    for (const result of runExactPathChunks(repoDir, ["status", "--porcelain=v1", "-z", "--untracked-files=all"], normalized)) {
-        if (result.status !== 0) {
-            throw new Error(`git status failed: ${result.stderr.trim() || "unknown error"}`);
-        }
-        if (result.stdout.length > 0) {
-            const record = result.stdout.split("\0").find(Boolean) ?? "";
-            throw new UsageError(`Exact Git operation path has staged or unstaged work: ${record.slice(3)}. Commit, stash, or discard that path before retrying.`);
-        }
-    }
-}
 function readOptionalHead(repoDir) {
     const result = runGit(["-C", repoDir, "rev-parse", "--verify", "HEAD"]);
     return result.status === 0 && result.stdout.trim() ? result.stdout.trim() : undefined;

package/dist/sources/providers/npm.js

@@ -13,8 +13,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { ConfigError, UsageError } from "../../core/errors.js";
 import { getRegistryCacheDir } from "../../core/paths.js";
-import { npmArtifactNetworkPolicy, parseRegistryRef, resolveRegistryArtifact } from "../../registry/resolve.js";
-import { registerSourceProvider } from "../provider-factory.js";
+import { parseRegistryRef, resolveRegistryArtifact } from "../../registry/resolve.js";
 import { applyAkmIncludeConfig, buildInstallCacheDir, computeFileHash, detectStashRoot, downloadArchive, isDirectory, } from "./provider-utils.js";
 import { extractTarGzSecure, verifyArchiveIntegrity } from "./tar-utils.js";
 /**
@@ -45,7 +44,6 @@ class NpmSourceProvider {
         await syncNpmRef(ref, { force: options?.force });
     }
 }
-registerSourceProvider("npm", (config) => new NpmSourceProvider(config));
 function npmRefFromConfig(config) {
     const candidate = config.path;
     if (typeof candidate !== "string" || !candidate) {
@@ -108,7 +106,7 @@ async function doSyncNpm(parsed, options) {
     let installRoot;
     let stashRoot;
     try {
-        await downloadArchive(resolved.artifactUrl, archivePath, npmArtifactNetworkPolicy(resolved));
+        await downloadArchive(resolved.artifactUrl, archivePath);
         verifyArchiveIntegrity(archivePath, resolved.resolvedRevision, resolved.source);
         integrity = await computeFileHash(archivePath);
         extractTarGzSecure(archivePath, extractedDir);

package/dist/sources/providers/provider-utils.js

@@ -6,7 +6,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { getAdapters } from "../../core/adapter/registry.js";
 import { stashDirNames } from "../../core/asset/asset-placement.js";
-import { cancelRegistryResponse, fetchRegistryResponse } from "../../registry/network.js";
+import { fetchRegistry } from "../../registry/network.js";
 import { writeResponseToFileCapped } from "../../runtime.js";
 import { copyIncludedPaths, findNearestIncludeConfig } from "../include.js";
 const REGISTRY_STASH_DIR_NAMES = new Set(stashDirNames());
@@ -99,15 +99,10 @@ export function applyAkmIncludeConfig(sourceRoot, cacheDir, searchRoot = sourceR
     return selectedDir;
 }
 /** Stream a remote archive to disk via the runtime boundary's response writer. */
-export async function downloadArchive(url, destination, networkPolicy) {
-    const response = await fetchRegistryResponse(url, undefined, { policy: networkPolicy, timeoutMs: 120_000 });
-    if (!response.ok) {
-        await cancelRegistryResponse(response);
-        throw new Error(`Failed to download archive (${response.status}) from ${url}`);
-    }
-    // Stream to disk with an explicit byte cap + body-read deadline: the fetch
-    // timeout above bounds only the connection/header phase, so an unbounded or
-    // dribbling body could otherwise fill the disk or hang the install forever.
+export async function downloadArchive(url, destination) {
+    const response = await fetchRegistry(url, { timeoutMs: 120_000 });
+    // Stream to disk with an explicit byte cap + body-read deadline so an
+    // unbounded or dribbling body cannot fill the disk or hang the install.
     await writeResponseToFileCapped(destination, response);
 }
 /** SHA-256 of a file, returned as `sha256:<hex>`. */

package/dist/sources/providers/website.js

@@ -2,7 +2,6 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 import { ConfigError } from "../../core/errors.js";
-import { registerSourceProvider } from "../provider-factory.js";
 import { getWebsiteCachePaths, shouldAllowPrivateWebsiteUrlForTests, validateWebsiteUrl } from "../website-url.js";
 /** Website source provider — URL-derived path plus an injected mirror refresh. */
 export function createWebsiteProvider(config) {
@@ -33,4 +32,3 @@ export function createWebsiteProvider(config) {
         },
     };
 }
-registerSourceProvider("website", createWebsiteProvider);

package/dist/sources/snapshot-fetchers/website-ingest.js

@@ -76,7 +76,7 @@ function resolveFetcherStashDir(explicitStashDir) {
 export async function ensureWebsiteMirror(config, options) {
     const rawUrl = config.url ?? "";
     const normalizedUrl = validateWebsiteUrl(rawUrl, { allowPrivateHosts: options?.allowPrivateHosts });
-    const cachePaths = getWebsiteCachePaths(normalizedUrl, options?.cacheRootDir);
+    const cachePaths = getWebsiteCachePaths(normalizedUrl);
     const requireStashDir = options?.requireStashDir === true;
     await withFreshnessCache({
         markerPath: cachePaths.manifestPath,

package/dist/sources/website-url.js

@@ -35,9 +35,9 @@ export function shouldAllowPrivateWebsiteUrlForTests(rawUrl) {
     }
     return true;
 }
-export function getWebsiteCachePaths(siteUrl, cacheRootOverride) {
+export function getWebsiteCachePaths(siteUrl) {
     const key = createHash("sha256").update(normalizeSiteUrl(siteUrl)).digest("hex").slice(0, 16);
-    const rootDir = path.join(cacheRootOverride ?? getRegistryIndexCacheDir(), `website-${key}`);
+    const rootDir = path.join(getRegistryIndexCacheDir(), `website-${key}`);
     return {
         rootDir,
         stashDir: path.join(rootDir, "stash"),

package/dist/storage/database.js

@@ -23,7 +23,8 @@
  * This file is intentionally NOT an adapter/DI/ports-and-adapters layer. It is
  * a plain module: a structural type plus a factory function. The handle it
  * returns is the real underlying driver instance (so e.g. `sqlite-vec`'s
- * `load(db)` receives the genuine driver handle and works unchanged).
+ * `load(db)`, used to drop the retired `entries_vec` table, receives the
+ * genuine driver handle and works unchanged).
  *
  * @module storage/database
  */
@@ -35,39 +36,13 @@ const isBun = !!process.versions?.bun;
 // Bun built-in, unresolvable on Node) nor `better-sqlite3` (an optional native
 // dep, possibly absent under Bun) is statically imported.
 const nodeRequire = createRequire(import.meta.url);
-// bun:sqlite — Bun built-in, no native build. Cannot run on Node.
-const bunSqliteProvider = {
-    name: "bun:sqlite",
-    supported: () => isBun,
-    open: openBunDatabase,
-};
-// better-sqlite3 — native Node driver. Cannot run on Bun (oven-sh/bun#4290).
-const nodeSqliteProvider = {
-    name: "better-sqlite3",
-    supported: () => !isBun,
-    open: openNodeDatabase,
-};
 /**
- * Ordered provider registry. The factory selects the first supported provider.
- * A future Postgres provider is appended here — and only here. Both SQLite
- * engines are kept as distinct providers (not collapsed) because no single
- * SQLite driver runs on both Bun and Node today.
- */
-const PROVIDERS = [bunSqliteProvider, nodeSqliteProvider];
-/** Select the provider for the current runtime. */
-function selectProvider() {
-    const provider = PROVIDERS.find((p) => p.supported());
-    if (!provider) {
-        throw new Error(`No storage provider supports the current runtime (${isBun ? "Bun" : "Node"}).`);
-    }
-    return provider;
-}
-/**
- * Open a SQLite database handle at `path` via the active {@link StorageProvider}.
- * Returns a handle conforming to the structural {@link Database} type.
+ * Open a SQLite database handle at `path` on the current runtime's driver
+ * (`bun:sqlite` on Bun, `better-sqlite3` on Node). Returns a handle conforming
+ * to the structural {@link Database} type.
  */
 export function openDatabase(path, opts) {
-    return selectProvider().open(path, opts);
+    return isBun ? openBunDatabase(path, opts) : openNodeDatabase(path, opts);
 }
 /**
  * {@link openDatabase} with a finalize-on-close guard (issue #720).
@@ -90,7 +65,7 @@ export function openDatabase(path, opts) {
  * force-finalizing under them changes behavior they were built on.
  */
 export function openDatabaseFinalizing(path, opts) {
-    const db = selectProvider().open(path, opts);
+    const db = openDatabase(path, opts);
     const tracked = new Set();
     const origPrepare = db.prepare.bind(db);
     const origClose = db.close.bind(db);
@@ -251,9 +226,8 @@ function openNodeDatabase(path, opts) {
         // bun:sqlite also provides db.run(). Normalize the latter at the provider
         // boundary so callers and maintenance wrappers can rely on one contract.
         run: (sql, ...params) => db.prepare(sql).run(...params),
-        // sqlite-vec's load(db) calls db.loadExtension(). Without forwarding it the
-        // extension could never load on Node, so the vector fast path was dead
-        // across the entire npm distribution even when sqlite-vec was installed.
+        // sqlite-vec's load(db) calls db.loadExtension(); without forwarding it the
+        // extension could never load on Node.
         loadExtension: db.loadExtension.bind(db),
         transaction: db.transaction.bind(db),
         get inTransaction() {