vora-ai 0.1.37 → 0.1.38

package/dist/.buildstamp

@@ -1 +1 @@
-{"builtAt":1776477728789,"head":"7cb18f8b1e45487f1627768901dac2dc10dda292"}
+{"builtAt":1776480007494,"head":"93abfe1b07bd746d7181c78415ddc656e7bb8a4f"}

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.37",
-  "commit": "7cb18f8b1e45487f1627768901dac2dc10dda292",
-  "builtAt": "2026-04-18T02:02:09.438Z"
+  "version": "0.1.38",
+  "commit": "93abfe1b07bd746d7181c78415ddc656e7bb8a4f",
+  "builtAt": "2026-04-18T02:40:08.213Z"
 }

package/dist/canvas-host/a2ui/.bundle.hash

@@ -1 +1 @@
-61df678f55f820c36800453e93a0b24dc4caa6d8ac7e6ec54d71e4885e06c512
+01b677ec20c9e797dda796c71459c28ae4b6a18ed0c7a835cedc7b231dee672f

package/dist/cli-startup-metadata.json

@@ -10,5 +10,5 @@
     "signal",
     "imessage"
   ],
-  "rootHelpText": "\n🌊 VORA 0.1.37 (7cb18f8) — Local processing, global conversational AI.\n\nUsage: vora [options] [command]\n\nOptions:\n  --container <name>   Run the CLI inside a running Podman/Docker container\n                       named <name> (default: env VORA_CONTAINER)\n  --dev                Dev profile: isolate state under ~/.vora-dev, default\n                       gateway port 19001, and shift derived ports\n                       (browser/canvas)\n  -h, --help           Display help for command\n  --log-level <level>  Global log level override for file + console\n                       (silent|fatal|error|warn|info|debug|trace)\n  --no-color           Disable ANSI colors\n  --profile <name>     Use a named profile (isolates\n                       VORA_STATE_DIR/VORA_CONFIG_PATH under ~/.vora-<name>)\n  -V, --version        output the version number\n\nCommands:\n  Hint: commands suffixed with * have subcommands. Run <command> --help for details.\n  acp *                Agent Control Protocol tools\n  agent                Run one agent turn via the Gateway\n  agents *             Manage isolated agents (workspaces, auth, routing)\n  approvals *          Manage exec approvals (gateway or node host)\n  backup *             Create and verify local backup archives for Vora state\n  channels *           Manage connected chat channels (Telegram, Discord, etc.)\n  clawbot *            Legacy clawbot command aliases\n  completion           Generate shell completion script\n  config *             Non-interactive config helpers\n                       (get/set/unset/file/validate). Default: starts guided\n                       setup.\n  configure            Interactive configuration for credentials, channels,\n                       gateway, and agent defaults\n  cron *               Manage cron jobs via the Gateway scheduler\n  daemon *             Gateway service (legacy alias)\n  dashboard            Open the Control UI with your current token\n  devices *            Device pairing + token management\n  directory *          Lookup contact and group IDs (self, peers, groups) for\n                       supported chat channels\n  dns *                DNS helpers for wide-area discovery (Tailscale + CoreDNS)\n  docs                 Search the live Vora docs\n  doctor               Health checks + quick fixes for the gateway and channels\n  gateway *            Run, inspect, and query the WebSocket Gateway\n  health               Fetch health from the running gateway\n  help                 Display help for command\n  hooks *              Manage internal agent hooks\n  logs                 Tail gateway file logs via RPC\n  message *            Send, read, and manage messages\n  models *             Discover, scan, and configure models\n  node *               Run and manage the headless node host service\n  nodes *              Manage gateway-owned node pairing and node commands\n  onboard              Interactive onboarding for gateway, workspace, and skills\n  pairing *            Secure DM pairing (approve inbound requests)\n  plugins *            Manage Vora plugins and extensions\n  qr                   Generate iOS pairing QR/setup code\n  reset                Reset local config/state (keeps the CLI installed)\n  sandbox *            Manage sandbox containers for agent isolation\n  secrets *            Secrets runtime reload controls\n  security *           Security tools and local config audits\n  sessions *           List stored conversation sessions\n  setup                Initialize local config and agent workspace\n  skills *             List and inspect available skills\n  status               Show channel health and recent session recipients\n  system *             System events, heartbeat, and presence\n  tasks *              Inspect durable background task state\n  tui                  Open a terminal UI connected to the Gateway\n  uninstall            Uninstall the gateway service + local data (CLI remains)\n  update *             Update Vora and inspect update channel status\n  voice *              Wake-word terminal voice loop (OpenWakeWord trigger + STT\n                       bridge + Gateway chat + optional Hume TTS)\n  webhooks *           Webhook helpers and integrations\n\nExamples:\n  vora models --help\n    Show detailed help for the models command.\n  vora onboard\n    Run interactive onboarding for the gateway, workspace, and skills.\n  vora configure --section model --section gateway\n    Re-open only the model and gateway configuration sections.\n  vora gateway --port 27106\n    Run the WebSocket Gateway locally.\n  vora --dev gateway\n    Run a dev Gateway (isolated state/config) on ws://127.0.0.1:19001.\n  vora gateway --force\n    Kill anything bound to the default gateway port, then start it.\n  vora models status --plain\n    Show the configured provider and default-model state.\n  vora gateway ...\n    Gateway control via WebSocket.\n  vora message send --channel telegram --target @mychat --message \"Hi\"\n    Send through a configured channel and print the result in the terminal.\n\nDocs: https://docs.vora.ai/cli\n\n"
+  "rootHelpText": "\n🌊 VORA 0.1.38 (93abfe1) — I speak fluent Audio, mild sarcasm, and aggressive Voice Activity Detection.\n\nUsage: vora [options] [command]\n\nOptions:\n  --container <name>   Run the CLI inside a running Podman/Docker container\n                       named <name> (default: env VORA_CONTAINER)\n  --dev                Dev profile: isolate state under ~/.vora-dev, default\n                       gateway port 19001, and shift derived ports\n                       (browser/canvas)\n  -h, --help           Display help for command\n  --log-level <level>  Global log level override for file + console\n                       (silent|fatal|error|warn|info|debug|trace)\n  --no-color           Disable ANSI colors\n  --profile <name>     Use a named profile (isolates\n                       VORA_STATE_DIR/VORA_CONFIG_PATH under ~/.vora-<name>)\n  -V, --version        output the version number\n\nCommands:\n  Hint: commands suffixed with * have subcommands. Run <command> --help for details.\n  acp *                Agent Control Protocol tools\n  agent                Run one agent turn via the Gateway\n  agents *             Manage isolated agents (workspaces, auth, routing)\n  approvals *          Manage exec approvals (gateway or node host)\n  backup *             Create and verify local backup archives for Vora state\n  channels *           Manage connected chat channels (Telegram, Discord, etc.)\n  clawbot *            Legacy clawbot command aliases\n  completion           Generate shell completion script\n  config *             Non-interactive config helpers\n                       (get/set/unset/file/validate). Default: starts guided\n                       setup.\n  configure            Interactive configuration for credentials, channels,\n                       gateway, and agent defaults\n  cron *               Manage cron jobs via the Gateway scheduler\n  daemon *             Gateway service (legacy alias)\n  dashboard            Open the Control UI with your current token\n  devices *            Device pairing + token management\n  directory *          Lookup contact and group IDs (self, peers, groups) for\n                       supported chat channels\n  dns *                DNS helpers for wide-area discovery (Tailscale + CoreDNS)\n  docs                 Search the live Vora docs\n  doctor               Health checks + quick fixes for the gateway and channels\n  gateway *            Run, inspect, and query the WebSocket Gateway\n  health               Fetch health from the running gateway\n  help                 Display help for command\n  hooks *              Manage internal agent hooks\n  logs                 Tail gateway file logs via RPC\n  message *            Send, read, and manage messages\n  models *             Discover, scan, and configure models\n  node *               Run and manage the headless node host service\n  nodes *              Manage gateway-owned node pairing and node commands\n  onboard              Interactive onboarding for gateway, workspace, and skills\n  pairing *            Secure DM pairing (approve inbound requests)\n  plugins *            Manage Vora plugins and extensions\n  qr                   Generate iOS pairing QR/setup code\n  reset                Reset local config/state (keeps the CLI installed)\n  sandbox *            Manage sandbox containers for agent isolation\n  secrets *            Secrets runtime reload controls\n  security *           Security tools and local config audits\n  sessions *           List stored conversation sessions\n  setup                Initialize local config and agent workspace\n  skills *             List and inspect available skills\n  status               Show channel health and recent session recipients\n  system *             System events, heartbeat, and presence\n  tasks *              Inspect durable background task state\n  tui                  Open a terminal UI connected to the Gateway\n  uninstall            Uninstall the gateway service + local data (CLI remains)\n  update *             Update Vora and inspect update channel status\n  voice *              Wake-word terminal voice loop (OpenWakeWord trigger + STT\n                       bridge + Gateway chat + optional Hume TTS)\n  webhooks *           Webhook helpers and integrations\n\nExamples:\n  vora models --help\n    Show detailed help for the models command.\n  vora onboard\n    Run interactive onboarding for the gateway, workspace, and skills.\n  vora configure --section model --section gateway\n    Re-open only the model and gateway configuration sections.\n  vora gateway --port 27106\n    Run the WebSocket Gateway locally.\n  vora --dev gateway\n    Run a dev Gateway (isolated state/config) on ws://127.0.0.1:19001.\n  vora gateway --force\n    Kill anything bound to the default gateway port, then start it.\n  vora models status --plain\n    Show the configured provider and default-model state.\n  vora gateway ...\n    Gateway control via WebSocket.\n  vora message send --channel telegram --target @mychat --message \"Hi\"\n    Send through a configured channel and print the result in the terminal.\n\nDocs: https://docs.vora.ai/cli\n\n"
 }

package/dist/{command-registry-DoRR_ykS.js → command-registry-BRC9rQRa.js}

@@ -1,7 +1,7 @@
 import { O as hasHelpOrVersion, T as getPrimaryCommand } from "./logger-DtBbg3AQ.js";
 import { n as removeCommandByName, t as registerLazyCommand } from "./register-lazy-command-C4_WvYdL.js";
 import { t as getCoreCliCommandDescriptors } from "./core-command-descriptors-Dmh3xVCU.js";
-import { i as registerSubCliCommands } from "./register.subclis-B-9NwtNV.js";
+import { i as registerSubCliCommands } from "./register.subclis-BMN-F1BZ.js";
 //#region src/cli/program/command-registry.ts
 const shouldRegisterCorePrimaryOnly = (argv) => {
 	if (hasHelpOrVersion(argv)) return false;
@@ -15,7 +15,7 @@ const coreEntries = [
 			hasSubcommands: false
 		}],
 		register: async ({ program }) => {
-			(await import("./register.setup-BT2-kAsK.js")).registerSetupCommand(program);
+			(await import("./register.setup-BJyCA8h7.js")).registerSetupCommand(program);
 		}
 	},
 	{
@@ -25,7 +25,7 @@ const coreEntries = [
 			hasSubcommands: false
 		}],
 		register: async ({ program }) => {
-			(await import("./register.onboard-CxR6bI1n.js")).registerOnboardCommand(program);
+			(await import("./register.onboard-D-PZwo7h.js")).registerOnboardCommand(program);
 		}
 	},
 	{
@@ -82,7 +82,7 @@ const coreEntries = [
 			}
 		],
 		register: async ({ program }) => {
-			(await import("./register.maintenance-DMZegmso.js")).registerMaintenanceCommands(program);
+			(await import("./register.maintenance-Bpuqh4Q-.js")).registerMaintenanceCommands(program);
 		}
 	},
 	{

package/dist/{command-registry-oO4_XKsL.js → command-registry-CNW-_45W.js}

@@ -1,3 +1,3 @@
 import "./core-command-descriptors-Dmh3xVCU.js";
-import { n as registerCoreCliByName } from "./command-registry-DoRR_ykS.js";
+import { n as registerCoreCliByName } from "./command-registry-BRC9rQRa.js";
 export { registerCoreCliByName };

package/dist/completion-cli-CZqBPvMj.js

@@ -0,0 +1,2 @@
+import { a as registerCompletionCli } from "./completion-cli-wmAo3zAc.js";
+export { registerCompletionCli };

package/dist/{completion-cli-BSVP90BO.js → completion-cli-wmAo3zAc.js}

@@ -3,8 +3,8 @@ import { t as formatDocsLink } from "./links-D-QW4VCX.js";
 import { r as theme } from "./theme-DEBOahQW.js";
 import { _ as resolveStateDir } from "./paths-5dqsPi5h.js";
 import { m as pathExists } from "./utils-D25qzO4S.js";
-import { n as loadValidatedConfigForPluginRegistration, r as registerSubCliByName, t as getSubCliEntries } from "./register.subclis-B-9NwtNV.js";
-import { n as registerCoreCliByName, t as getCoreCliCommandNames } from "./command-registry-DoRR_ykS.js";
+import { n as loadValidatedConfigForPluginRegistration, r as registerSubCliByName, t as getSubCliEntries } from "./register.subclis-BMN-F1BZ.js";
+import { n as registerCoreCliByName, t as getCoreCliCommandNames } from "./command-registry-BRC9rQRa.js";
 import { t as getProgramContext } from "./program-context-C0Ru__k1.js";
 import path from "node:path";
 import os from "node:os";

package/dist/{doctor-completion-CLfiq4-c.js → doctor-completion-D9ct64dl.js}

@@ -1,7 +1,7 @@
 import { t as resolveVoraPackageRoot } from "./vora-root-fqgy2cBi.js";
 import { n as resolveCliName } from "./cli-name-C_IzpPbS.js";
 import { t as note } from "./note-DfcrAbT0.js";
-import { c as usesSlowDynamicCompletion, i as isCompletionInstalled, o as resolveCompletionCachePath, r as installCompletion, s as resolveShellFromEnv, t as completionCacheExists } from "./completion-cli-BSVP90BO.js";
+import { c as usesSlowDynamicCompletion, i as isCompletionInstalled, o as resolveCompletionCachePath, r as installCompletion, s as resolveShellFromEnv, t as completionCacheExists } from "./completion-cli-wmAo3zAc.js";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
 //#region src/commands/doctor-completion.ts

package/dist/entry.js

@@ -200,7 +200,7 @@ function tryHandleRootHelpFastPath(argv, deps = {}) {
 }
 function runMainOrRootHelp(argv) {
 	if (tryHandleRootHelpFastPath(argv)) return;
-	import("./run-main-BWhbuxQt.js").then(({ runCli }) => runCli(argv)).catch((error) => {
+	import("./run-main-CHgQSnRn.js").then(({ runCli }) => runCli(argv)).catch((error) => {
 		console.error("[vora] Failed to start CLI:", error instanceof Error ? error.stack ?? error.message : error);
 		process$1.exitCode = 1;
 	});

package/dist/extensions/telegram/.vora-runtime-deps-stamp.json

@@ -1,4 +1,4 @@
 {
   "fingerprint": "f5cc4428157244c03371a02e98bc2b0556e1853613db4dfe31efcfd24cef35f1",
-  "generatedAt": "2026-04-18T02:02:08.668Z"
+  "generatedAt": "2026-04-18T02:40:07.361Z"
 }

package/dist/{gateway-cli-DNaH7pBF.js → gateway-cli-DDZpfER2.js}

@@ -196,7 +196,7 @@ import { s as normalizeUpdateChannel } from "./update-channels-C8-n6_kE.js";
 import { n as compareSemverStrings, o as resolveNpmChannelTag, t as checkUpdateStatus } from "./update-check-Cw2Zo7Rn.js";
 import { i as resolveGatewayStartupPluginIds, r as resolveConfiguredDeferredChannelPluginIds } from "./channel-plugin-ids-BgeBHwp9.js";
 import { l as startTaskRegistryMaintenance, n as getInspectableTaskRegistrySummary } from "./task-registry.maintenance-CfvslEdg.js";
-import { t as runSetupWizard } from "./setup-B35nGXkQ.js";
+import { t as runSetupWizard } from "./setup-Cu2MyUlf.js";
 import { _ as buildGogWatchStartArgs, g as buildGogWatchServeArgs, i as ensureTailscaleEndpoint, w as resolveGmailHookRuntimeConfig } from "./gmail-setup-utils-CstpQWwK.js";
 import { i as loadAgentIdentity, o as pruneAgentConfig, r as findAgentEntryIndex, t as applyAgentConfig } from "./agents.config-BXIFVvWT.js";
 import { a as resolveApnsAuthConfigFromEnv, c as shouldClearStoredApnsRegistration, d as MediaOffloadError, f as parseMessageWithAttachments, l as resolveApnsRelayConfigFromEnv, n as loadApnsRegistration, o as sendApnsAlert, r as normalizeApnsEnvironment, s as sendApnsBackgroundWake, t as clearApnsRegistrationIfCurrent, u as normalizeRpcAttachmentsToChatAttachments } from "./push-apns-wrSw6X5_.js";

package/dist/index.js

@@ -28,7 +28,7 @@ let saveSessionStore;
 let toWhatsappJid;
 let waitForever;
 async function loadLegacyCliDeps() {
-	const [{ installGaxiosFetchCompat }, { runCli }] = await Promise.all([import("./gaxios-fetch-compat-BZRlVrBH.js"), import("./run-main-BWhbuxQt.js")]);
+	const [{ installGaxiosFetchCompat }, { runCli }] = await Promise.all([import("./gaxios-fetch-compat-BZRlVrBH.js"), import("./run-main-CHgQSnRn.js")]);
 	return {
 		installGaxiosFetchCompat,
 		runCli

package/dist/{onboard-VNwsDuUB.js → onboard-BgmpmwJd.js}

@@ -11,7 +11,7 @@ import { c as normalizeGatewayTokenInput, d as randomToken, f as resolveControlU
 import { n as logConfigUpdated } from "./logging-BQ-k0nK2.js";
 import { t as WizardCancelledError } from "./prompts-BVJ3zQFl.js";
 import { t as createClackPrompter } from "./clack-prompter-Be8sX0Lg.js";
-import { t as runSetupWizard } from "./setup-B35nGXkQ.js";
+import { t as runSetupWizard } from "./setup-Cu2MyUlf.js";
 import { a as resolveManifestProviderOnboardAuthFlags } from "./provider-auth-choices-DcNzlbgs.js";
 import { i as resolveDeprecatedAuthChoiceReplacement, n as isDeprecatedAuthChoice, r as normalizeLegacyOnboardAuthChoice, t as formatDeprecatedNonInteractiveAuthChoiceError } from "./auth-choice-legacy-DGeZIT-G.js";
 import { r as applyLocalSetupWorkspaceConfig } from "./onboard-config-DkkHPbTO.js";

package/dist/{program-q6W4mv2i.js → program-CSIyPhvT.js}

@@ -7,7 +7,7 @@ import { n as VERSION } from "./version-A4Ns-pm9.js";
 import { n as resolveCliName } from "./cli-name-C_IzpPbS.js";
 import { t as emitCliBanner } from "./banner-C5yJCudk.js";
 import { n as resolveCliChannelOptions } from "./channel-options-D_8z6c-h.js";
-import { i as registerProgramCommands } from "./command-registry-DoRR_ykS.js";
+import { i as registerProgramCommands } from "./command-registry-BRC9rQRa.js";
 import { n as setProgramContext } from "./program-context-C0Ru__k1.js";
 import { t as isCommandJsonOutputMode } from "./json-mode-KmFHsA3R.js";
 import "./ports-CQo1U86K.js";

package/dist/{prompt-select-styled-2R-9jWL7.js → prompt-select-styled-BXm08-uh.js}

@@ -108,7 +108,7 @@ import { t as ensureSystemdUserLingerInteractive } from "./systemd-linger-B_gzrf
 import { t as formatHealthCheckFailure } from "./health-format-TyQPx9cW.js";
 import { a as stripUnknownConfigKeys, i as resolveConfigPathTarget, n as formatConfigPath, r as noteOpencodeProviderOverrides, t as runDoctorConfigPreflight } from "./doctor-config-preflight-B2IpAFkH.js";
 import { a as isMattermostMutableAllowEntry, i as isMSTeamsMutableAllowEntry, n as isGoogleChatMutableAllowEntry, o as isSlackMutableAllowEntry, r as isIrcMutableAllowEntry, s as isZalouserMutableGroupEntry, t as isDiscordMutableAllowEntry } from "./mutable-allowlist-detectors-zVflHd8P.js";
-import { n as doctorShellCompletion } from "./doctor-completion-CLfiq4-c.js";
+import { n as doctorShellCompletion } from "./doctor-completion-D9ct64dl.js";
 import { t as collectChannelStatusIssues } from "./channels-status-issues-CCJ10zgF.js";
 import { t as resolveDefaultChannelAccountContext } from "./channel-account-context-ChxhkByq.js";
 import "./doctor-state-migrations-BlH3irT5.js";

package/dist/{register.maintenance-DMZegmso.js → register.maintenance-Bpuqh4Q-.js}

@@ -16,7 +16,7 @@ import { r as resolveGatewayService } from "./service-BnUY5mkU.js";
 import { n as resolveConfiguredSecretInputWithFallback } from "./resolve-configured-secret-input-string-BGHutVyf.js";
 import { n as runCommandWithRuntime } from "./cli-utils-4n6KI2ho.js";
 import { a as removePath, i as listAgentSessionDirs, o as removeStateAndLinkedPaths, r as buildCleanupPlan, s as removeWorkspaceDirs } from "./backup-create-DZood8Ea.js";
-import { n as doctorCommand, t as selectStyled } from "./prompt-select-styled-2R-9jWL7.js";
+import { n as doctorCommand, t as selectStyled } from "./prompt-select-styled-BXm08-uh.js";
 import path from "node:path";
 import { cancel, confirm, isCancel, multiselect } from "@clack/prompts";
 //#region src/infra/clipboard.ts

package/dist/{register.onboard-CxR6bI1n.js → register.onboard-D-PZwo7h.js}

@@ -4,7 +4,7 @@ import { r as theme } from "./theme-DEBOahQW.js";
 import { n as runCommandWithRuntime } from "./cli-utils-4n6KI2ho.js";
 import { a as resolveManifestProviderOnboardAuthFlags } from "./provider-auth-choices-DcNzlbgs.js";
 import { n as formatAuthChoiceChoicesForCli } from "./auth-choice-options-Blz8a0tL.js";
-import { n as CORE_ONBOARD_AUTH_FLAGS, t as setupWizardCommand } from "./onboard-VNwsDuUB.js";
+import { n as CORE_ONBOARD_AUTH_FLAGS, t as setupWizardCommand } from "./onboard-BgmpmwJd.js";
 //#region src/cli/program/register.onboard.ts
 function resolveInstallDaemonFlag(command, opts) {
 	if (!command || typeof command !== "object") return;

package/dist/{register.setup-BT2-kAsK.js → register.setup-BJyCA8h7.js}

@@ -11,7 +11,7 @@ import { s as resolveSessionTranscriptsDir } from "./paths-UyCuvwtc.js";
 import { n as safeParseWithSchema } from "./zod-parse-DHX0rEx9.js";
 import { n as runCommandWithRuntime } from "./cli-utils-4n6KI2ho.js";
 import { n as logConfigUpdated, t as formatConfigPath } from "./logging-BQ-k0nK2.js";
-import { t as setupWizardCommand } from "./onboard-VNwsDuUB.js";
+import { t as setupWizardCommand } from "./onboard-BgmpmwJd.js";
 import fs from "node:fs/promises";
 import { z } from "zod";
 import JSON5 from "json5";

package/dist/{register.subclis-B-9NwtNV.js → register.subclis-BMN-F1BZ.js}

@@ -30,7 +30,7 @@ const entries = [
 		description: "Run, inspect, and query the WebSocket Gateway",
 		hasSubcommands: true,
 		register: async (program) => {
-			(await import("./gateway-cli-DNaH7pBF.js")).registerGatewayCli(program);
+			(await import("./gateway-cli-DDZpfER2.js")).registerGatewayCli(program);
 		}
 	},
 	{
@@ -118,7 +118,7 @@ const entries = [
 		description: "Wake-word terminal voice loop (OpenWakeWord trigger + STT bridge + Gateway chat + optional Hume TTS)",
 		hasSubcommands: true,
 		register: async (program) => {
-			(await import("./voice-cli-CXiYCrQf.js")).registerVoiceCli(program);
+			(await import("./voice-cli-BRD6l0Sl.js")).registerVoiceCli(program);
 		}
 	},
 	{
@@ -244,7 +244,7 @@ const entries = [
 		description: "Update Vora and inspect update channel status",
 		hasSubcommands: true,
 		register: async (program) => {
-			(await import("./update-cli-BbcBxt3_.js")).registerUpdateCli(program);
+			(await import("./update-cli-DhdDYxXa.js")).registerUpdateCli(program);
 		}
 	},
 	{
@@ -252,7 +252,7 @@ const entries = [
 		description: "Generate shell completion script",
 		hasSubcommands: false,
 		register: async (program) => {
-			(await import("./completion-cli-B6W-7yKI.js")).registerCompletionCli(program);
+			(await import("./completion-cli-CZqBPvMj.js")).registerCompletionCli(program);
 		}
 	}
 ];

package/dist/{register.subclis-BQu4VqOI.js → register.subclis-Cdl19lw2.js}

@@ -1,3 +1,3 @@
 import "./subcli-descriptors-Cc423xKz.js";
-import { n as loadValidatedConfigForPluginRegistration, r as registerSubCliByName } from "./register.subclis-B-9NwtNV.js";
+import { n as loadValidatedConfigForPluginRegistration, r as registerSubCliByName } from "./register.subclis-BMN-F1BZ.js";
 export { loadValidatedConfigForPluginRegistration, registerSubCliByName };

package/dist/{run-main-BWhbuxQt.js → run-main-CHgQSnRn.js}

@@ -374,7 +374,7 @@ async function runCli(argv = process$1.argv) {
 		}
 		if (await tryRouteCli(normalizedArgv)) return;
 		enableConsoleCapture();
-		const { buildProgram } = await import("./program-q6W4mv2i.js");
+		const { buildProgram } = await import("./program-CSIyPhvT.js");
 		const program = buildProgram();
 		const { installUnhandledRejectionHandler } = await import("./unhandled-rejections-D0HD8aaS.js");
 		installUnhandledRejectionHandler();
@@ -388,10 +388,10 @@ async function runCli(argv = process$1.argv) {
 			const { getProgramContext } = await import("./program-context-Bntrf4rW.js");
 			const ctx = getProgramContext(program);
 			if (ctx) {
-				const { registerCoreCliByName } = await import("./command-registry-oO4_XKsL.js");
+				const { registerCoreCliByName } = await import("./command-registry-CNW-_45W.js");
 				await registerCoreCliByName(program, ctx, primary, parseArgv);
 			}
-			const { registerSubCliByName } = await import("./register.subclis-BQu4VqOI.js");
+			const { registerSubCliByName } = await import("./register.subclis-Cdl19lw2.js");
 			await registerSubCliByName(program, primary);
 		}
 		if (!shouldSkipPluginCommandRegistration({
@@ -400,7 +400,7 @@ async function runCli(argv = process$1.argv) {
 			hasBuiltinPrimary: primary !== null && program.commands.some((command) => command.name() === primary)
 		})) {
 			const { registerPluginCliCommands } = await import("./cli-QwFXIS1_.js");
-			const { loadValidatedConfigForPluginRegistration } = await import("./register.subclis-BQu4VqOI.js");
+			const { loadValidatedConfigForPluginRegistration } = await import("./register.subclis-Cdl19lw2.js");
 			const config = await loadValidatedConfigForPluginRegistration();
 			if (config) {
 				await registerPluginCliCommands(program, config, void 0, void 0, {

package/dist/{setup-B35nGXkQ.js → setup-Cu2MyUlf.js}

@@ -106,7 +106,7 @@ async function setupQuickstartVoiceRuntime(params) {
 		"STT/TTS use the VORA backend by default, so local Agora/Hume keys are not required."
 	].join("\n"), "Voice runtime");
 	try {
-		const { runVoiceSetup } = await import("./voice-cli-CXiYCrQf.js");
+		const { runVoiceSetup } = await import("./voice-cli-BRD6l0Sl.js");
 		await runVoiceSetup({}, params.runtime);
 		await params.prompter.note([
 			"Voice runtime is ready.",
@@ -464,7 +464,7 @@ async function runSetupWizard(opts, runtime = defaultRuntime, prompter) {
 		mode
 	});
 	await writeConfigFile(nextConfig);
-	const { finalizeSetupWizard } = await import("./setup.finalize-BueEFawv.js");
+	const { finalizeSetupWizard } = await import("./setup.finalize-CRAM1yrm.js");
 	const { launchedTui } = await finalizeSetupWizard({
 		flow,
 		opts,

package/dist/{setup.finalize-BueEFawv.js → setup.finalize-CRAM1yrm.js}

@@ -10,12 +10,12 @@ import { f as resolveControlUiLinks, g as waitForGatewayReachable, i as formatCo
 import { r as resolveGatewayService, t as describeGatewayServiceRestart } from "./service-BnUY5mkU.js";
 import { i as isSystemdUserServiceAvailable } from "./systemd-9Gclqlhk.js";
 import { t as listConfiguredWebSearchProviders } from "./runtime-B0GlgEXr.js";
-import { r as installCompletion } from "./completion-cli-BSVP90BO.js";
+import { r as installCompletion } from "./completion-cli-wmAo3zAc.js";
 import { r as healthCommand } from "./health-DJqooRWK.js";
 import { t as ensureControlUiAssetsBuilt } from "./control-ui-assets-DVSZ-yd-.js";
 import { t as resolveSetupSecretInputString } from "./setup.secret-input-DeWdLao-.js";
 import { t as formatHealthCheckFailure } from "./health-format-TyQPx9cW.js";
-import { r as ensureCompletionCacheExists, t as checkShellCompletionStatus } from "./doctor-completion-CLfiq4-c.js";
+import { r as ensureCompletionCacheExists, t as checkShellCompletionStatus } from "./doctor-completion-D9ct64dl.js";
 import { t as runTui } from "./tui-DCtnC9C0.js";
 import path from "node:path";
 import os from "node:os";
@@ -351,7 +351,7 @@ async function finalizeSetupWizard(options) {
 		if (hatchChoice === "voice") {
 			restoreTerminalState("pre-setup voice", { resumeStdinIfPaused: true });
 			try {
-				const { runVoiceLoop } = await import("./voice-cli-CXiYCrQf.js");
+				const { runVoiceLoop } = await import("./voice-cli-BRD6l0Sl.js");
 				await runVoiceLoop({
 					url: links.wsUrl,
 					token: settings.authMode === "token" ? settings.gatewayToken : void 0,

package/dist/{update-cli-BbcBxt3_.js → update-cli-DhdDYxXa.js}

@@ -21,14 +21,14 @@ import { a as terminateStaleGatewayPids, i as renderRestartDiagnostics, s as wai
 import { r as formatDurationPrecise } from "./format-duration-C7KLrjgc.js";
 import { o as trimLogTail } from "./restart-sentinel-CjIY0IZ8.js";
 import { t as formatHelpExamples } from "./help-format-DC7U6A-Y.js";
-import { r as installCompletion } from "./completion-cli-BSVP90BO.js";
+import { r as installCompletion } from "./completion-cli-wmAo3zAc.js";
 import { n as renderTable, t as getTerminalTableWidth } from "./table-CYPwb2Cg.js";
 import { c as resolveEffectiveUpdateChannel, i as formatUpdateChannelLabel, l as resolveUpdateChannelDisplay, r as channelToNpmTag, s as normalizeUpdateChannel } from "./update-channels-C8-n6_kE.js";
 import { i as fetchNpmTagVersion, n as compareSemverStrings, o as resolveNpmChannelTag, r as fetchNpmPackageTargetStatus, t as checkUpdateStatus } from "./update-check-Cw2Zo7Rn.js";
 import { a as collectInstalledGlobalPackageErrors, c as detectGlobalInstallManagerForRoot, d as resolveGlobalInstallSpec, f as resolveGlobalPackageRoot, h as readPackageVersion, i as cleanupGlobalRenameDirs, l as globalInstallArgs, m as readPackageName, n as runGatewayUpdate, o as createGlobalInstallEnv, p as normalizePackageTagInput, r as canResolveRegistryVersionForPackageTarget, s as detectGlobalInstallManagerByPresence, u as resolveExpectedInstalledVersionFromSpec } from "./server-startup-matrix-migration-DL743qrx.js";
 import { n as updateNpmInstalledPlugins, t as syncPluginsForUpdateChannel } from "./update-XayfF-ly.js";
-import { n as doctorCommand, t as selectStyled } from "./prompt-select-styled-2R-9jWL7.js";
-import { r as ensureCompletionCacheExists, t as checkShellCompletionStatus } from "./doctor-completion-CLfiq4-c.js";
+import { n as doctorCommand, t as selectStyled } from "./prompt-select-styled-BXm08-uh.js";
+import { r as ensureCompletionCacheExists, t as checkShellCompletionStatus } from "./doctor-completion-D9ct64dl.js";
 import { i as resolveUpdateAvailability, n as formatUpdateOneLiner, t as formatUpdateAvailableHint } from "./status.update-209xudNW.js";
 import path from "node:path";
 import { spawn, spawnSync } from "node:child_process";

package/dist/{voice-cli-CXiYCrQf.js → voice-cli-BRD6l0Sl.js}

@@ -15,7 +15,7 @@ const DEFAULT_WAKE_MODEL_FILE = "hey_vora.onnx";
 const DEFAULT_WAKE_THRESHOLD = .5;
 const DEFAULT_WAIT_MS = 4e4;
 const DEFAULT_STT_TIMEOUT_MS = 25e3;
-const DEFAULT_STT_LANGUAGE = "en-US,vi-VN";
+const DEFAULT_STT_LANGUAGE = "vi-VN,en-US";
 const DEFAULT_HUME_VOICE_ID = "9e068547-5ba4-4c8e-8e03-69282a008f04";
 const DEFAULT_HUME_SPEED = 1.2;
 const DEFAULT_TTS_TIMEOUT_MS = 2e4;
@@ -782,7 +782,7 @@ function resolveShellCommand(command) {
 		args: ["-lc", command]
 	};
 }
-async function runShellCommand(command, timeoutMs) {
+async function runShellCommand(command, timeoutMs, opts) {
 	const shell = resolveShellCommand(command);
 	const child = spawn(shell.bin, shell.args, { stdio: [
 		"ignore",
@@ -791,15 +791,24 @@ async function runShellCommand(command, timeoutMs) {
 	] });
 	let stdout = "";
 	let stderr = "";
+	let stderrLineBuffer = "";
 	child.stdout?.on("data", (chunk) => {
 		stdout += chunk.toString();
 	});
 	child.stderr?.on("data", (chunk) => {
-		stderr += chunk.toString();
+		const text = chunk.toString();
+		stderr += text;
+		if (opts?.onStderrLine) {
+			stderrLineBuffer += text;
+			const lines = stderrLineBuffer.split(/\r?\n/g);
+			stderrLineBuffer = lines.pop() ?? "";
+			for (const line of lines) opts.onStderrLine(line);
+		}
 	});
 	const done = new Promise((resolve, reject) => {
 		child.on("error", reject);
 		child.on("close", (code) => {
+			if (opts?.onStderrLine && stderrLineBuffer.trim().length > 0) opts.onStderrLine(stderrLineBuffer);
 			resolve({
 				code: typeof code === "number" ? code : 1,
 				stdout,
@@ -974,11 +983,26 @@ async function transcribeSpeech(resolved, opts) {
 	const command = resolved.stt.agoraCommand;
 	if (!command) throw new Error("Agora STT provider selected but no bridge command is available. Set --agora-stt-command or VORA_AGORA_STT_COMMAND.");
 	const timeoutMs = opts?.timeoutMs ?? resolved.stt.timeoutMs;
-	const result = await runShellCommand(applyTemplate(command, {
+	const rendered = applyTemplate(command, {
 		lang: resolved.stt.language,
 		timeout_ms: String(timeoutMs)
-	}), timeoutMs + DEFAULT_STT_BRIDGE_COMMAND_GRACE_MS);
+	});
+	const phase = opts?.phase ?? "voice";
+	defaultRuntime.log(`[voice] preparing ${phase} STT (${resolved.stt.language}); wait for "listening now" before speaking`);
+	let readyLogged = false;
+	const result = await runShellCommand(rendered, timeoutMs + DEFAULT_STT_BRIDGE_COMMAND_GRACE_MS, { onStderrLine: (line) => {
+		const message = line.trim();
+		if (!message) return;
+		if (message === "[agora-stt-bridge] ready") {
+			readyLogged = true;
+			process.stdout.write("\x07");
+			defaultRuntime.log(`[voice] listening now (${resolved.stt.language}); speak now`);
+			return;
+		}
+		if (message.includes("fatal:") || message.includes("managed browser unavailable") || message.includes("browser auto-open disabled")) defaultRuntime.error(message);
+	} });
 	if (result.code !== 0) throw new Error(`Agora STT bridge failed (exit ${result.code}): ${result.stderr.trim() || "no stderr"}`);
+	if (!readyLogged) defaultRuntime.log("[voice] STT bridge completed without an explicit ready signal");
 	return extractTranscriptFromCommandOutput(result.stdout);
 }
 function normalizeHistoryMessages(payload) {
@@ -1507,12 +1531,13 @@ async function runVoiceConversation(params) {
 		if (params.resolved.once) return;
 		if (!params.resolved.conversation.followUpEnabled || followUpTurns >= params.resolved.conversation.followUpMaxTurns) return;
 		const followUpListenMs = Math.min(params.resolved.conversation.followUpMs, params.resolved.conversation.followUpSttTimeoutMs);
-		defaultRuntime.log(`[voice] follow-up window open for ${Math.round(followUpListenMs / 1e3)}s; speak naturally, or stay quiet to sleep`);
+		defaultRuntime.log(`[voice] preparing follow-up window (${Math.round(followUpListenMs / 1e3)}s after ready); wait for "listening now"`);
 		let nextTranscript = "";
 		try {
 			nextTranscript = (await transcribeSpeech(params.resolved, {
 				timeoutMs: followUpListenMs,
-				prompt: "Follow-up (blank to sleep): "
+				prompt: "Follow-up (blank to sleep): ",
+				phase: "follow-up"
 			})).trim();
 		} catch (error) {
 			if (String(error).toLowerCase().includes("timeout")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vora-ai",
-  "version": "0.1.37",
+  "version": "0.1.38",
   "description": "Voice-first AI agent core engine — VORA",
   "keywords": [],
   "homepage": "https://github.com/vora-ai/vora-core#readme",

package/scripts/agora-stt-bridge.mjs

@@ -7,7 +7,7 @@ import http from "node:http";
 const DEFAULT_TIMEOUT_MS = 45_000;
 const DEFAULT_API_BASE = "https://api.agora.io";
 const DEFAULT_BACKEND_URL = "https://vora-ai-backend-uemj.onrender.com";
-const DEFAULT_LANGUAGE = "en-US,vi-VN";
+const DEFAULT_LANGUAGE = "vi-VN,en-US";
 const DEFAULT_RTC_UID = "1002";
 const DEFAULT_STT_AUDIO_UID = "111";
 const DEFAULT_STT_TEXT_UID = "222";
@@ -649,16 +649,13 @@ function buildBrowserHtml(browserConfig) {
             throw new Error("Agora STT start returned no agentId");
           }
           agentId = String(start.agentId);
+          await post("/ready", { agentId });
           setStatus("Listening... speak your command now.", "ok");
         } catch (error) {
           await resolveError(String(error));
         }
       }
 
-      setTimeout(() => {
-        void resolveError("timeout waiting for final transcript");
-      }, Math.max(1000, CONFIG.timeoutMs));
-
       window.addEventListener("beforeunload", () => {
         void cleanup();
       });
@@ -831,6 +828,20 @@ async function main() {
   let done = false;
   let currentAgentId = "";
   let browserController = null;
+  let ready = false;
+  let startupTimeout;
+  let listenTimeout;
+
+  const clearTimers = () => {
+    if (startupTimeout) {
+      clearTimeout(startupTimeout);
+      startupTimeout = undefined;
+    }
+    if (listenTimeout) {
+      clearTimeout(listenTimeout);
+      listenTimeout = undefined;
+    }
+  };
 
   const closeBrowser = async () => {
     if (!browserController) {
@@ -846,6 +857,7 @@ async function main() {
       return;
     }
     done = true;
+    clearTimers();
     await stopAgoraStt(resolvedConfig, currentAgentId).catch(() => undefined);
     await closeBrowser();
     if (server) {
@@ -860,6 +872,7 @@ async function main() {
       return;
     }
     done = true;
+    clearTimers();
     await stopAgoraStt(resolvedConfig, currentAgentId).catch(() => undefined);
     await closeBrowser();
     if (server) {
@@ -869,6 +882,15 @@ async function main() {
     process.exit(0);
   };
 
+  const armListenTimeout = () => {
+    if (listenTimeout) {
+      return;
+    }
+    listenTimeout = setTimeout(() => {
+      void fail(`timeout after ${resolvedConfig.timeoutMs}ms`);
+    }, resolvedConfig.timeoutMs);
+  };
+
   server = http.createServer(async (req, res) => {
     const requestUrl = new URL(req.url || "/", "http://127.0.0.1");
     const pathname = requestUrl.pathname;
@@ -890,6 +912,28 @@ async function main() {
       return;
     }
 
+    if (req.method === "POST" && pathname === "/ready") {
+      try {
+        const body = await readJsonBody(req);
+        const agentId =
+          typeof body?.agentId === "string" && body.agentId.trim().length > 0
+            ? body.agentId.trim()
+            : currentAgentId;
+        if (agentId && agentId !== currentAgentId) {
+          currentAgentId = agentId;
+        }
+        if (!ready) {
+          ready = true;
+          process.stderr.write("[agora-stt-bridge] ready\n");
+          armListenTimeout();
+        }
+        jsonResponse(res, 200, { ok: true });
+      } catch (error) {
+        jsonResponse(res, 500, { ok: false, error: String(error) });
+      }
+      return;
+    }
+
     if (req.method === "POST" && pathname === "/api/stop") {
       try {
         const body = await readJsonBody(req);
@@ -959,7 +1003,10 @@ async function main() {
   const source = resolvedConfig.backendUrl ? `backend=${safeBase(resolvedConfig.backendUrl)}` : "direct-agora";
   process.stderr.write(`[agora-stt-bridge] channel=${resolvedConfig.channel} uid=${resolvedConfig.uid} ${source}\n`);
   process.stderr.write(`[agora-stt-bridge] local capture URL:\n${localUrl}\n`);
-  process.stderr.write("[agora-stt-bridge] waiting for one final transcript...\n");
+  process.stderr.write("[agora-stt-bridge] preparing microphone capture...\n");
+  startupTimeout = setTimeout(() => {
+    void fail("timeout waiting for microphone/STT readiness");
+  }, Math.max(45_000, resolvedConfig.timeoutMs + 15_000));
   if (config.browserMode === "managed") {
     try {
       browserController = await openManagedBrowser(localUrl, config.showBrowser);
@@ -981,12 +1028,8 @@ async function main() {
     process.stderr.write("[agora-stt-bridge] browser auto-open disabled; open the local capture URL manually.\n");
   }
 
-  const timeout = setTimeout(() => {
-    void fail(`timeout after ${resolvedConfig.timeoutMs}ms`);
-  }, resolvedConfig.timeoutMs + 15_000);
-
   const stop = async () => {
-    clearTimeout(timeout);
+    clearTimers();
     if (!done) {
       await fail("interrupted");
     }

package/dist/completion-cli-B6W-7yKI.js

@@ -1,2 +0,0 @@
-import { a as registerCompletionCli } from "./completion-cli-BSVP90BO.js";
-export { registerCompletionCli };