@elizaos/app-core 2.0.0-beta.3 → 2.0.11-beta.5

package/cli/program/register.dashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.dashboard.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/program/register.dashboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6CzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,QAsHxD"}
+{"version":3,"file":"register.dashboard.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/program/register.dashboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4CzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,QAsHxD"}

package/cli/program/register.dashboard.js

@@ -34,7 +34,6 @@ async function openInBrowser(url) {
     child.unref();
 }
 const DEFAULT_PORT = 2138;
-const APP_DEV_PORT = 2138;
 export function registerDashboardCommand(program) {
     program
         .command("dashboard")
@@ -57,8 +56,8 @@ export function registerDashboardCommand(program) {
             openInBrowser(url);
             return;
         }
-        if (await isPortListening(APP_DEV_PORT)) {
-            const url = `http://localhost:${APP_DEV_PORT}`;
+        if (await isPortListening(DEFAULT_PORT)) {
+            const url = `http://localhost:${DEFAULT_PORT}`;
             console.log(`${theme.muted("→")} Opening Control UI (dev server): ${url}`);
             openInBrowser(url);
             return;
@@ -66,7 +65,7 @@ export function registerDashboardCommand(program) {
         console.log(`${theme.muted("→")} Server not running on port ${port}; starting app dev server…`);
         const path = await import("node:path");
         const fs = await import("node:fs");
-        const { resolveElizaPackageRootSync } = await import("../../utils/eliza-root");
+        const { resolveElizaPackageRootSync } = await import("../../utils/eliza-root.js");
         const pkgRoot = resolveElizaPackageRootSync({
             cwd: process.cwd(),
             argv1: process.argv[1],
@@ -96,18 +95,18 @@ export function registerDashboardCommand(program) {
             if (opened)
                 return;
             opened = true;
-            const devUrl = `http://localhost:${APP_DEV_PORT}`;
+            const devUrl = `http://localhost:${DEFAULT_PORT}`;
             console.log(`${theme.muted("→")} Opening Control UI: ${devUrl}`);
             openInBrowser(devUrl);
         };
-        child.stdout?.on("data", (chunk) => {
+        child.stdout.on("data", (chunk) => {
             const text = chunk.toString();
             process.stdout.write(text);
             if (!opened && text.includes("Local:")) {
                 tryOpen();
             }
         });
-        child.stderr?.on("data", (chunk) => {
+        child.stderr.on("data", (chunk) => {
             process.stderr.write(chunk.toString());
         });
         child.on("error", (err) => {

package/cli/program/register.db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.db.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/program/register.db.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,QAgDjD"}
+{"version":3,"file":"register.db.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/program/register.db.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,QAgDjD"}

package/cli/program/register.db.js

@@ -1,12 +1,11 @@
 import fs from "node:fs";
-import os from "node:os";
 import path from "node:path";
+import { resolveStateDir } from "@elizaos/core";
 import { theme } from "@elizaos/shared";
-import { runCommandWithRuntime } from "../cli-utils";
+import { runCommandWithRuntime } from "../cli-utils.js";
 const defaultRuntime = { error: console.error, exit: process.exit };
 function resolveDbDir(env = process.env) {
-    const stateDir = env.ELIZA_STATE_DIR ?? path.join(os.homedir(), ".eliza");
-    return path.join(stateDir, "workspace", ".eliza", ".elizadb");
+    return path.join(resolveStateDir(env), "workspace", ".elizadb");
 }
 export function registerDbCommand(program) {
     const db = program.command("db").description("Database management");

package/cli/program/register.doctor.js

@@ -1,6 +1,6 @@
 import { spawnSync } from "node:child_process";
 import { theme } from "@elizaos/shared";
-import { runCommandWithRuntime } from "../cli-utils";
+import { runCommandWithRuntime } from "../cli-utils.js";
 const defaultRuntime = { error: console.error, exit: process.exit };
 // ---------------------------------------------------------------------------
 // Formatting
@@ -80,20 +80,20 @@ function attemptFix(result) {
 // ---------------------------------------------------------------------------
 export function registerDoctorCommand(program) {
     program
-        .command("doctor:dflash")
-        .description("Check DFlash llama-server acceleration readiness")
+        .command("doctor:mtp")
+        .description("Check MTP llama-server acceleration readiness")
         .option("--json", "Output results as JSON")
         .action(async (opts) => {
         await runCommandWithRuntime(defaultRuntime, async () => {
-            const { runDflashDoctor } = await import("../../services/local-inference/dflash-doctor");
-            const report = await runDflashDoctor();
+            const { runMtpDoctor } = await import("@elizaos/plugin-local-inference/services");
+            const report = await runMtpDoctor();
             if (opts.json) {
                 process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
                 if (!report.ok)
                     process.exit(1);
                 return;
             }
-            console.log(`\n${theme.heading("DFlash Health Check")}\n`);
+            console.log(`\n${theme.heading("MTP Health Check")}\n`);
             for (const check of report.checks) {
                 const icon = check.status === "pass"
                     ? theme.success("✓")
@@ -118,7 +118,7 @@ export function registerDoctorCommand(program) {
         .option("--json", "Output results as JSON (CI-friendly)")
         .action(async (opts) => {
         await runCommandWithRuntime(defaultRuntime, async () => {
-            const { runAllChecks } = await import("../doctor/checks");
+            const { runAllChecks } = await import("../doctor/checks.js");
             const results = await runAllChecks({ checkPorts: opts.ports });
             // ── JSON output ──────────────────────────────────────────────────
             if (opts.json) {

package/cli/program/register.setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.setup.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/program/register.setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCzC,KAAK,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEpD,KAAK,qBAAqB,GAAG;IAC3B,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,CAAC;AA4FF,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAStE;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAIN;AAoBD,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,MAAM,GAAG,IAAI,CAyBf;AAMD,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CA0Ef;AAMD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAmIpD"}
+{"version":3,"file":"register.setup.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/program/register.setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCzC,KAAK,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEpD,KAAK,qBAAqB,GAAG;IAC3B,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,CAAC;AA4FF,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAetE;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAIN;AAoBD,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,MAAM,GAAG,IAAI,CAyBf;AAMD,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CA0Ef;AAMD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAmIpD"}

package/cli/program/register.setup.js

@@ -3,7 +3,7 @@ import path from "node:path";
 import { resolveConfigPath } from "@elizaos/agent";
 import { formatDocsLink, theme } from "@elizaos/shared";
 import JSON5 from "json5";
-import { runCommandWithRuntime } from "../cli-utils";
+import { runCommandWithRuntime } from "../cli-utils.js";
 const defaultRuntime = { error: console.error, exit: process.exit };
 // ---------------------------------------------------------------------------
 // Provider menu — shown when no key is configured yet
@@ -63,7 +63,7 @@ async function askSecret(prompt) {
             if (closed)
                 return;
             closed = true;
-            process.stdin.setRawMode?.(false);
+            process.stdin.setRawMode(false);
             process.stdin.removeListener("data", handler);
             rl.close();
         };
@@ -98,7 +98,7 @@ async function askSecret(prompt) {
             }
         };
         try {
-            process.stdin.setRawMode?.(true);
+            process.stdin.setRawMode(true);
             process.stdin.on("data", handler);
         }
         catch (error) {
@@ -123,14 +123,18 @@ export { resolveConfigPath };
 export function loadConfig(configPath) {
     if (!fs.existsSync(configPath))
         return {};
+    const raw = fs.readFileSync(configPath, "utf-8");
+    let parsed;
     try {
-        const raw = fs.readFileSync(configPath, "utf-8");
-        const parsed = JSON5.parse(raw);
-        return typeof parsed === "object" && parsed !== null ? parsed : {};
+        parsed = JSON5.parse(raw);
     }
-    catch {
-        return {};
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new Error(`Cannot parse config at ${configPath}: ${reason}. Fix or remove the file before running setup.`);
     }
+    return typeof parsed === "object" && parsed !== null
+        ? parsed
+        : {};
 }
 export function saveConfig(configPath, config) {
     const dir = path.dirname(configPath);
@@ -243,7 +247,7 @@ export async function runProviderWizard(configPath, options = {}) {
 export function registerSetupCommand(program) {
     program
         .command("setup")
-        .description("Initialize ~/.eliza/eliza.json and the agent workspace")
+        .description("Initialize the XDG state-dir config and agent workspace")
         .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/getting-started/setup", "docs.eliza.ai/getting-started/setup")}\n`)
         .option("--workspace <dir>", "Agent workspace directory")
         .option("--provider <name>", "Model provider (non-interactive)")
@@ -310,7 +314,7 @@ export function registerSetupCommand(program) {
             // ── Final doctor summary ─────────────────────────────────────────
             if (process.stdin.isTTY) {
                 console.log(`\n${theme.success("Setup complete.")} Running health check...\n`);
-                const { runAllChecks } = await import("../doctor/checks");
+                const { runAllChecks } = await import("../doctor/checks.js");
                 const results = await runAllChecks({ checkPorts: false });
                 for (const result of results) {
                     const icon = result.status === "pass"

package/cli/program/register.start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.start.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/program/register.start.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4EzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAuCpD"}
+{"version":3,"file":"register.start.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/program/register.start.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8EzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAuCpD"}

package/cli/program/register.start.js

@@ -1,6 +1,7 @@
 import crypto from "node:crypto";
 import { formatDocsLink, isLoopbackBindHost, resolveApiBindHost, resolveApiSecurityConfig, resolveApiToken, resolveServerOnlyPort, setApiToken, theme, } from "@elizaos/shared";
-import { runCommandWithRuntime } from "../cli-utils";
+import { bootLap } from "../../boot-profile.js";
+import { runCommandWithRuntime } from "../cli-utils.js";
 const defaultRuntime = { error: console.error, exit: process.exit };
 /**
  * Generate a random connection key for remote access.
@@ -23,6 +24,7 @@ function shouldDisableAutoConnectionKey() {
     return resolveApiSecurityConfig(process.env).disableAutoApiToken;
 }
 async function startAction() {
+    bootLap("start:startAction entry");
     // Auto-generate a connection key only when binding to a network address
     // and no token is already configured. Localhost access stays open.
     const existingToken = resolveApiToken(process.env);
@@ -31,8 +33,8 @@ async function startAction() {
     }
     const connectionKey = resolveApiToken(process.env);
     await runCommandWithRuntime(defaultRuntime, async () => {
-        const { startEliza } = await import("../../runtime/eliza");
-        const { ensureAuthPairingCodeForRemoteAccess } = await import("../../api/auth-pairing-compat-routes");
+        const { startEliza } = await import("../../runtime/eliza.js");
+        const { ensureAuthPairingCodeForRemoteAccess } = await import("../../api/auth-pairing-routes.js");
         // Use serverOnly mode: starts API server, no interactive chat loop
         await startEliza({
             serverOnly: true,

package/cli/program/register.subclis.js

@@ -1,5 +1,5 @@
 import { isTruthyEnvValue } from "@elizaos/shared";
-import { buildParseArgv, getPrimaryCommand, hasHelpOrVersion } from "../argv";
+import { buildParseArgv, getPrimaryCommand, hasHelpOrVersion } from "../argv.js";
 function resolveActionArgs(command) {
     return command?.args ?? [];
 }
@@ -8,7 +8,7 @@ const entries = [
         name: "plugins",
         description: "Plugin management (elizaOS plugins)",
         register: async (program) => {
-            const mod = await import("../plugins-cli");
+            const mod = await import("../plugins-cli.js");
             mod.registerPluginsCli(program);
         },
     },
@@ -16,7 +16,7 @@ const entries = [
         name: "models",
         description: "Model configuration",
         register: async (program) => {
-            const mod = await import("./register.models");
+            const mod = await import("./register.models.js");
             mod.registerModelsCli(program);
         },
     },

package/cli/program/register.update.d.ts

@@ -4,8 +4,14 @@
  *   eliza update                   # Check & update on current channel
  *   eliza update --channel beta    # Switch to beta and update
  *   eliza update --check           # Check only, don't install
+ *   eliza update --voice-models    # Also check voice sub-model updates
  *   eliza update status            # Show versions across all channels
  *   eliza update channel [name]    # View or change release channel
+ *
+ * `--voice-models` runs the R5-versioning voice-sub-model auto-updater
+ * (separate from the npm-registry update for the elizaos package itself).
+ * On a headless TTY-less environment the voice-model updater is the ONLY
+ * place auto-updates fire — the runtime tick is suppressed (R5 §4.5).
  */
 import type { Command } from "commander";
 export declare function registerUpdateCommand(program: Command): void;

package/cli/program/register.update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.update.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/program/register.update.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6OzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuB5D"}
+{"version":3,"file":"register.update.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/program/register.update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoTzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2B5D"}

package/cli/program/register.update.js

@@ -4,11 +4,17 @@
  *   eliza update                   # Check & update on current channel
  *   eliza update --channel beta    # Switch to beta and update
  *   eliza update --check           # Check only, don't install
+ *   eliza update --voice-models    # Also check voice sub-model updates
  *   eliza update status            # Show versions across all channels
  *   eliza update channel [name]    # View or change release channel
+ *
+ * `--voice-models` runs the R5-versioning voice-sub-model auto-updater
+ * (separate from the npm-registry update for the elizaos package itself).
+ * On a headless TTY-less environment the voice-model updater is the ONLY
+ * place auto-updates fire — the runtime tick is suppressed (R5 §4.5).
  */
 import { theme } from "@elizaos/shared";
-import { CLI_VERSION } from "../version";
+import { CLI_VERSION } from "../version.js";
 const ALL_CHANNELS = ["stable", "beta", "nightly"];
 const CHANNEL_LABELS = {
     stable: theme.success,
@@ -30,10 +36,42 @@ function parseChannelOrExit(raw) {
     console.error(theme.error(`Invalid channel "${raw}". Valid channels: ${ALL_CHANNELS.join(", ")}`));
     process.exit(1);
 }
+async function voiceModelsAction(opts) {
+    const { VOICE_MODEL_VERSIONS, latestVoiceModelVersion } = await import("@elizaos/shared");
+    console.log(`\n${theme.heading("Eliza voice sub-models")}\n`);
+    console.log(theme.muted("Per-sub-model versioning (R5-versioning §3). Auto-update gate: newer\n" +
+        "semver + publish-gate netImprovement + bundle compatibility. Pinned\n" +
+        "ids decline. See models/voice/CHANGELOG.md for the human history.\n"));
+    const seenIds = new Set();
+    for (const v of VOICE_MODEL_VERSIONS) {
+        if (seenIds.has(v.id))
+            continue;
+        seenIds.add(v.id);
+        const latest = latestVoiceModelVersion(v.id);
+        if (!latest)
+            continue;
+        const sizeMb = latest.ggufAssets.length === 0
+            ? "(unpublished)"
+            : `${(latest.ggufAssets.reduce((s, a) => s + a.sizeBytes, 0) / 1_048_576).toFixed(1)} MB`;
+        console.log(`  ${theme.accent(v.id.padEnd(24))} ${theme.success(latest.version.padEnd(8))} ${theme.muted(sizeMb)}`);
+        if (latest.changelogEntry) {
+            console.log(theme.muted(`    ${latest.changelogEntry}`));
+        }
+    }
+    if (opts.check) {
+        console.log(theme.muted("\n  Run `eliza update --voice-models` without `--check` to apply updates.\n"));
+        return;
+    }
+    console.log(theme.muted("\n  Live update path runs in the runtime (VoiceModelUpdater service)\n" +
+        "  with per-platform NetworkPolicy gating. CLI applies are headless-only.\n"));
+}
 async function updateAction(opts) {
+    if (opts.voiceModels) {
+        return voiceModelsAction({ check: opts.check, force: opts.force });
+    }
     const { loadElizaConfig, saveElizaConfig } = await import("@elizaos/agent");
     const { checkForUpdate, resolveChannel } = await import("@elizaos/agent");
-    const { detectInstallMethod, performUpdate } = await import("@elizaos/agent");
+    const { detectInstallMethod, getUpdateActionPlan, performUpdate } = await import("@elizaos/agent");
     const config = loadElizaConfig();
     let newChannel;
     if (opts.channel) {
@@ -75,11 +113,16 @@ async function updateAction(opts) {
         return;
     }
     const method = detectInstallMethod();
-    if (method === "local-dev") {
-        console.log(theme.warn("  Local development install detected. Use `git pull` to update.\n"));
+    const updatePlan = getUpdateActionPlan(method, effectiveChannel);
+    if (!updatePlan.canExecuteFromContext) {
+        console.log(theme.warn(`  ${updatePlan.message}\n`));
         return;
     }
     console.log(theme.muted(`  Install method: ${method}`));
+    console.log(theme.muted(`  Authority: ${updatePlan.authority}`));
+    if (updatePlan.command) {
+        console.log(theme.muted(`  Command: ${updatePlan.command}`));
+    }
     console.log("  Installing update...\n");
     const updateResult = await performUpdate(CLI_VERSION, effectiveChannel, method);
     if (!updateResult.success) {
@@ -99,13 +142,21 @@ async function updateAction(opts) {
 async function statusAction() {
     const { loadElizaConfig } = await import("@elizaos/agent");
     const { resolveChannel, fetchAllChannelVersions } = await import("@elizaos/agent");
-    const { detectInstallMethod } = await import("@elizaos/agent");
+    const { detectInstallMethod, getUpdateActionPlan } = await import("@elizaos/agent");
     console.log(`\n${theme.heading("Version Status")}\n`);
     const config = loadElizaConfig();
     const channel = resolveChannel(config.update);
     console.log(`  Installed:  ${theme.accent(CLI_VERSION)}`);
     console.log(`  Channel:    ${channelLabel(channel)}`);
-    console.log(`  Install:    ${theme.muted(detectInstallMethod())}`);
+    const method = detectInstallMethod();
+    const updatePlan = getUpdateActionPlan(method, channel);
+    console.log(`  Install:    ${theme.muted(method)}`);
+    console.log(`  Authority:  ${theme.muted(updatePlan.authority)}`);
+    console.log(`  Next:       ${theme.muted(updatePlan.nextAction)}`);
+    if (updatePlan.command) {
+        console.log(`  Command:    ${theme.muted(updatePlan.command)}`);
+    }
+    console.log(`  Can run:    ${updatePlan.canExecuteFromContext ? "yes" : "no"}`);
     console.log(`\n${theme.heading("Available Versions")}\n`);
     console.log("  Fetching from npm registry...\n");
     const versions = await fetchAllChannelVersions();
@@ -161,6 +212,7 @@ export function registerUpdateCommand(program) {
         .option("-c, --channel <channel>", "Switch release channel (stable, beta, nightly)")
         .option("--check", "Check for updates without installing")
         .option("--force", "Force update check (bypass interval cache)")
+        .option("--voice-models", "List voice sub-model versions (R5-versioning auto-updater)")
         .action(updateAction);
     updateCmd
         .command("status")

package/cli/program.js

@@ -1 +1 @@
-export { buildProgram } from "./program/build-program";
+export { buildProgram } from "./program/build-program.js";

package/cli/run-main.js

@@ -1,8 +1,8 @@
 import process from "node:process";
 import { getLogPrefix, RESTART_EXIT_CODE, setRestartHandler, } from "@elizaos/shared";
-import { formatUncaughtError, shouldIgnoreUnhandledRejection, } from "../runtime/error-handlers";
-import { getPrimaryCommand, hasHelpOrVersion } from "./argv";
-import { registerSubCliByName } from "./program/register.subclis";
+import { formatUncaughtError, shouldIgnoreUnhandledRejection, } from "../runtime/error-handlers.js";
+import { getPrimaryCommand, hasHelpOrVersion } from "./argv.js";
+import { registerSubCliByName } from "./program/register.subclis.js";
 let cliRestartHandlerRegistered = false;
 function registerCliRestartHandler() {
     if (cliRestartHandlerRegistered)
@@ -36,7 +36,7 @@ export async function runCli(argv = process.argv) {
         process.env.KIMI_API_KEY?.trim()) {
         process.env.MOONSHOT_API_KEY = process.env.KIMI_API_KEY;
     }
-    const { buildProgram } = await import("./program");
+    const { buildProgram } = await import("./program.js");
     const program = buildProgram();
     // Prevent Commander from calling process.exit() directly so that piped stdio (vitest etc)
     // has a chance to flush cleanly before the process spins down.

package/config/app-config.d.ts

@@ -0,0 +1,2 @@
+export { type AndroidUserAgentMarker, type AospVariantConfig, type AppAndroidConfig, type AppConfig, type AppDesktopConfig, type AppPackagingConfig, type AppWebConfig, DEFAULT_APP_CONFIG, resolveAppBranding, } from "@elizaos/shared";
+//# sourceMappingURL=app-config.d.ts.map

package/config/app-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.d.ts","sourceRoot":"","sources":["../../../../../src/config/app-config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/config/app-config.js

@@ -0,0 +1 @@
+export { DEFAULT_APP_CONFIG, resolveAppBranding, } from "@elizaos/shared";

package/connectors/capacitor-jsc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capacitor-jsc.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/capacitor-jsc.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAE5E;;;;OAIG;IACH,YAAY,CACV,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAEjC,mEAAmE;IACnE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,eAAO,MAAM,YAAY,oBAAqD,CAAC"}
+{"version":3,"file":"capacitor-jsc.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/capacitor-jsc.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAE5E;;;;OAIG;IACH,YAAY,CACV,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAEjC,mEAAmE;IACnE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,eAAO,MAAM,YAAY,oBAAqD,CAAC"}

package/connectors/capacitor-jsc.js

@@ -1,14 +1,21 @@
-// TODO(native): Swift implementation pending — this file is the TS-side
-// facade for the eventual `CapacitorJsc` Capacitor plugin. The Swift class
-// (target name: `CapacitorJscPlugin`, registered with
+// Native boundary contract for the `CapacitorJsc` Capacitor plugin. The Swift
+// class (target name: `CapacitorJscPlugin`, registered with
 // `@objc(CapacitorJscPlugin)`) must implement the methods declared on
-// `CapacitorJscPlugin` below. Use a host JSContext (JavaScriptCore) — NOT a
-// WKWebView — so App Review treats the runtime as a sandboxed scripting
-// engine, not a browser.
-import { registerPlugin } from "@capacitor/core";
+// `CapacitorJscPlugin` below. Use a host JSContext (JavaScriptCore), not a
+// WKWebView, so App Review treats the runtime as a sandboxed scripting engine.
+import { Capacitor, registerPlugin } from "@capacitor/core";
 import { registerJsRuntimeFactory, } from "@elizaos/agent";
 export const CapacitorJsc = registerPlugin("CapacitorJsc");
-/* ── Bridge adapter registration ───────────────────────────────────────── */
+function getCapacitorHost() {
+    return (globalThis.Capacitor ??
+        Capacitor);
+}
+function isJscPluginAvailable() {
+    const cap = getCapacitorHost();
+    return (cap.isNativePlatform?.() === true &&
+        cap.getPlatform?.() === "ios" &&
+        cap.isPluginAvailable?.("CapacitorJsc") === true);
+}
 class CapacitorJscBridge {
     plugin;
     kind = "jsc-ios";
@@ -30,8 +37,7 @@ class CapacitorJscBridge {
 registerJsRuntimeFactory({
     kind: "jsc-ios",
     async create() {
-        const cap = globalThis.Capacitor;
-        if (!cap?.isNativePlatform?.() || cap.getPlatform?.() !== "ios") {
+        if (!isJscPluginAvailable()) {
             return null;
         }
         return new CapacitorJscBridge(CapacitorJsc);

package/connectors/capacitor-quickjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capacitor-quickjs.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/capacitor-quickjs.ts"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CACN,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAE/B;;;;OAIG;IACH,YAAY,CACV,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAEjC,yEAAyE;IACzE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,eAAO,MAAM,gBAAgB,wBAC+B,CAAC"}
+{"version":3,"file":"capacitor-quickjs.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/capacitor-quickjs.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CACN,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAE/B;;;;OAIG;IACH,YAAY,CACV,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAEjC,yEAAyE;IACzE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,eAAO,MAAM,gBAAgB,wBAC+B,CAAC"}

package/connectors/capacitor-quickjs.js

@@ -1,14 +1,21 @@
-// TODO(native): Swift / Kotlin implementation pending — this file is the
-// TS-side facade for the eventual `CapacitorQuickJs` Capacitor plugin.
-// Android is the primary target: the Kotlin plugin must spawn a service with
-// `android:isolatedProcess="true"` so the QuickJS interpreter cannot escape
-// into the host process. iOS uses the same plugin as a fallback when JSC is
-// unavailable. Both implementations must implement the methods declared on
-// `CapacitorQuickJsPlugin` below.
-import { registerPlugin } from "@capacitor/core";
+// Native boundary contract for the `CapacitorQuickJs` Capacitor plugin.
+// Android is the primary target: the Kotlin plugin must run QuickJS in a
+// service with `android:isolatedProcess="true"` so interpreter faults and
+// untrusted code stay outside the host process. iOS may register the same
+// plugin only as the fallback runtime when JavaScriptCore is unavailable.
+import { Capacitor, registerPlugin } from "@capacitor/core";
 import { registerJsRuntimeFactory, } from "@elizaos/agent";
 export const CapacitorQuickJs = registerPlugin("CapacitorQuickJs");
-/* ── Bridge adapter registration ───────────────────────────────────────── */
+function getCapacitorHost() {
+    return (globalThis.Capacitor ??
+        Capacitor);
+}
+function isQuickJsPluginAvailable(platform) {
+    const cap = getCapacitorHost();
+    return (cap.isNativePlatform?.() === true &&
+        cap.getPlatform?.() === platform &&
+        cap.isPluginAvailable?.("CapacitorQuickJs") === true);
+}
 class CapacitorQuickJsBridge {
     plugin;
     kind;
@@ -31,8 +38,7 @@ class CapacitorQuickJsBridge {
 registerJsRuntimeFactory({
     kind: "quickjs-android",
     async create() {
-        const cap = globalThis.Capacitor;
-        if (!cap?.isNativePlatform?.() || cap.getPlatform?.() !== "android") {
+        if (!isQuickJsPluginAvailable("android")) {
             return null;
         }
         return new CapacitorQuickJsBridge(CapacitorQuickJs, "quickjs-android");
@@ -41,8 +47,7 @@ registerJsRuntimeFactory({
 registerJsRuntimeFactory({
     kind: "quickjs-ios-fallback",
     async create() {
-        const cap = globalThis.Capacitor;
-        if (!cap?.isNativePlatform?.() || cap.getPlatform?.() !== "ios") {
+        if (!isQuickJsPluginAvailable("ios")) {
             return null;
         }
         return new CapacitorQuickJsBridge(CapacitorQuickJs, "quickjs-ios-fallback");

package/connectors/capacitor-sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capacitor-sqlite.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/capacitor-sqlite.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,CAAC;CAC/C;AAED,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;CAAG;AAEnE,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,IAAI,EAAE,IAAI,EAAE,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAyDD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,cAAc,CAAC,CAczB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAgB1D"}
+{"version":3,"file":"capacitor-sqlite.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/capacitor-sqlite.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,CAAC;CAC/C;AAED,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;CAAG;AAEnE,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,IAAI,EAAE,IAAI,EAAE,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA0ED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,cAAc,CAAC,CAyBzB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAa1D"}

package/connectors/capacitor-sqlite.js

@@ -1,19 +1,26 @@
-// TODO(native): Native side is provided by `@capacitor-community/sqlite`
-// (real published plugin) — this file is a thin facade so the rest of the
-// app talks to a stable, parameterized API instead of touching the
-// community plugin's wider surface.
+// Boundary facade for `@capacitor-community/sqlite`. The native side is the
+// published community plugin; this module keeps app code on a stable,
+// parameterized API instead of exposing the plugin's wider surface.
+import { Capacitor } from "@capacitor/core";
 import { CapacitorSQLite, } from "@capacitor-community/sqlite";
-const PARAM_PLACEHOLDER = /\?/g;
 function rejectStringConcat(sql) {
     // Defensive: the contract is parameterized SQL only. We can't fully detect
     // unsafe concatenation from the call site, but we can refuse calls that
     // contain template-literal-style markers commonly used for unsafe interp.
     if (sql.includes("${")) {
-        throw new Error("[capacitor-sqlite] sql must be parameterized — use `values`, not `${...}` interpolation");
+        throw new Error("[capacitor-sqlite] sql must be parameterized — use `values`, not `" +
+            "$" +
+            "{...}` interpolation");
     }
-    // Cheap plausibility check: count placeholders so callers see a clear
-    // error if they forget to migrate from string concat.
-    void PARAM_PLACEHOLDER;
+}
+function getCapacitorHost() {
+    return (globalThis.Capacitor ??
+        Capacitor);
+}
+function isCommunitySqlitePluginRegistered() {
+    const cap = getCapacitorHost();
+    return (cap.isNativePlatform?.() === true &&
+        cap.isPluginAvailable?.("CapacitorSQLite") === true);
 }
 class SqliteDatabaseImpl {
     name;
@@ -49,6 +56,9 @@ class SqliteDatabaseImpl {
  * caller must `close()` when finished to release the underlying connection.
  */
 export async function openDatabase(opts) {
+    if (!isCommunitySqlitePluginRegistered()) {
+        throw new Error("[capacitor-sqlite] CapacitorSQLite native plugin is not registered");
+    }
     const encryption = opts.encryption ?? "none";
     await CapacitorSQLite.createConnection({
         database: opts.name,
@@ -57,6 +67,12 @@ export async function openDatabase(opts) {
         mode: encryption,
         readonly: false,
     });
+    // CapacitorSQLitePlugin's open() returns void; the underlying native bridge
+    // attaches a connection object. The @capacitor-community/sqlite v3 types do
+    // not expose a retrieveConnection on CapacitorSQLitePlugin — that method
+    // exists on SQLiteDBConnectionsWrapper, a different class. The cast below
+    // matches the plugin's actual runtime behavior where open() resolves to the
+    // SQLiteDBConnection on native. Filed as a typing gap in the community plugin.
     const connection = (await CapacitorSQLite.open({
         database: opts.name,
         readonly: false,
@@ -70,10 +86,9 @@ export async function openDatabase(opts) {
  */
 export async function isSqliteAvailable() {
     try {
-        const cap = globalThis.Capacitor;
-        if (!cap?.isNativePlatform?.())
+        if (!isCommunitySqlitePluginRegistered())
             return false;
-        // `checkConnectionsConsistency` is a no-op on a clean install but
+        // `checkConnectionsConsistency` has no visible work on a clean install but
         // confirms the native bridge is wired up.
         await CapacitorSQLite.checkConnectionsConsistency({
             dbNames: [],