vora-ai 0.1.37 → 0.1.39

package/dist/.buildstamp

@@ -1 +1 @@
-{"builtAt":1776477728789,"head":"7cb18f8b1e45487f1627768901dac2dc10dda292"}
+{"builtAt":1776495873671,"head":"9878c07c9b86f7c090fc2516587e78587cdd02bf"}

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.39",
+  "commit": "9878c07c9b86f7c090fc2516587e78587cdd02bf",
+  "builtAt": "2026-04-18T07:04:34.372Z"
 }

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

@@ -1 +1 @@
-61df678f55f820c36800453e93a0b24dc4caa6d8ac7e6ec54d71e4885e06c512
+cff3802555c03fed933598a392060fa774cd83785e5588aab671d80694fd31e2

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.39 (9878c07) — Powered by Agora. Listening on your command.\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-oO4_XKsL.js → command-registry-CO9_pUZG.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-DddwHMX2.js";
 export { registerCoreCliByName };

package/dist/{command-registry-DoRR_ykS.js → command-registry-DddwHMX2.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-B6o2P3FE.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-Cpq-B5e_.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-Dq9iFtBA.js")).registerOnboardCommand(program);
 		}
 	},
 	{
@@ -82,7 +82,7 @@ const coreEntries = [
 			}
 		],
 		register: async ({ program }) => {
-			(await import("./register.maintenance-DMZegmso.js")).registerMaintenanceCommands(program);
+			(await import("./register.maintenance-DSOh3Hhg.js")).registerMaintenanceCommands(program);
 		}
 	},
 	{

package/dist/{completion-cli-BSVP90BO.js → completion-cli-BIIBXfZj.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-B6o2P3FE.js";
+import { n as registerCoreCliByName, t as getCoreCliCommandNames } from "./command-registry-DddwHMX2.js";
 import { t as getProgramContext } from "./program-context-C0Ru__k1.js";
 import path from "node:path";
 import os from "node:os";

package/dist/completion-cli-oRV3KMRL.js

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

package/dist/{doctor-completion-CLfiq4-c.js → doctor-completion-C6bLYDy-.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-BIIBXfZj.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-Bwe4zE9G.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-18T07:04:33.559Z"
 }

package/dist/{gateway-cli-DNaH7pBF.js → gateway-cli-BO_W-26g.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-srafWXcp.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-Bwe4zE9G.js")]);
 	return {
 		installGaxiosFetchCompat,
 		runCli

package/dist/{onboard-VNwsDuUB.js → onboard-Nd5ClWnL.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-srafWXcp.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-C1tAki7e.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-DddwHMX2.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-CxGQYnYg.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-C6bLYDy-.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-DSOh3Hhg.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-CxGQYnYg.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-Dq9iFtBA.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-Nd5ClWnL.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-Cpq-B5e_.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-Nd5ClWnL.js";
 import fs from "node:fs/promises";
 import { z } from "zod";
 import JSON5 from "json5";

package/dist/{register.subclis-B-9NwtNV.js → register.subclis-B6o2P3FE.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-BO_W-26g.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-JpNFw9Go.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-EMFxDpgT.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-oRV3KMRL.js")).registerCompletionCli(program);
 		}
 	}
 ];

package/dist/{register.subclis-BQu4VqOI.js → register.subclis-yPh1RFXQ.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-B6o2P3FE.js";
 export { loadValidatedConfigForPluginRegistration, registerSubCliByName };

package/dist/{run-main-BWhbuxQt.js → run-main-Bwe4zE9G.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-C1tAki7e.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-CO9_pUZG.js");
 				await registerCoreCliByName(program, ctx, primary, parseArgv);
 			}
-			const { registerSubCliByName } = await import("./register.subclis-BQu4VqOI.js");
+			const { registerSubCliByName } = await import("./register.subclis-yPh1RFXQ.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-yPh1RFXQ.js");
 			const config = await loadValidatedConfigForPluginRegistration();
 			if (config) {
 				await registerPluginCliCommands(program, config, void 0, void 0, {

package/dist/{setup-B35nGXkQ.js → setup-srafWXcp.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-JpNFw9Go.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-VNsHuIdy.js");
 	const { launchedTui } = await finalizeSetupWizard({
 		flow,
 		opts,

package/dist/{setup.finalize-BueEFawv.js → setup.finalize-VNsHuIdy.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-BIIBXfZj.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-C6bLYDy-.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-JpNFw9Go.js");
 				await runVoiceLoop({
 					url: links.wsUrl,
 					token: settings.authMode === "token" ? settings.gatewayToken : void 0,

package/dist/{update-cli-BbcBxt3_.js → update-cli-EMFxDpgT.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-BIIBXfZj.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-CxGQYnYg.js";
+import { r as ensureCompletionCacheExists, t as checkShellCompletionStatus } from "./doctor-completion-C6bLYDy-.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-JpNFw9Go.js}

@@ -14,11 +14,11 @@ import readline from "node:readline";
 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_TIMEOUT_MS = 16e3;
+const DEFAULT_STT_LANGUAGE = "en-US";
 const DEFAULT_HUME_VOICE_ID = "9e068547-5ba4-4c8e-8e03-69282a008f04";
 const DEFAULT_HUME_SPEED = 1.2;
-const DEFAULT_TTS_TIMEOUT_MS = 2e4;
+const DEFAULT_TTS_TIMEOUT_MS = 8e3;
 const DEFAULT_TTS_MAX_CHARS = 900;
 const DEFAULT_ELEVENLABS_VOICE_ID = "JBFqnCBsd6RMkjVDRZzb";
 const DEFAULT_ELEVENLABS_MODEL_ID = "eleven_multilingual_v2";
@@ -26,16 +26,82 @@ const DEFAULT_ELEVENLABS_OUTPUT_FORMAT = "mp3_44100_128";
 const DEFAULT_VOICE_BACKEND_URL = "https://vora-ai-backend-uemj.onrender.com";
 const DEFAULT_FOLLOW_UP_MS = 45e3;
 const DEFAULT_FOLLOW_UP_MAX_TURNS = 4;
-const DEFAULT_FOLLOW_UP_STT_TIMEOUT_MS = 12e3;
+const DEFAULT_FOLLOW_UP_STT_TIMEOUT_MS = 1e4;
 const DEFAULT_BACKEND_PROBE_TIMEOUT_MS = 6e4;
 const DEFAULT_BACKEND_STT_PROBE_TIMEOUT_MS = 6e4;
-const DEFAULT_STT_BRIDGE_COMMAND_GRACE_MS = 6e4;
+const DEFAULT_STT_BRIDGE_COMMAND_GRACE_MS = 2e4;
+const DEFAULT_WAKE_ACK_WAIT_MS = 12e3;
 const WAKE_PYTHON_MODULES = [
 	"openwakeword",
 	"pyaudio",
 	"numpy"
 ];
 const WAKE_PYTHON_DEPENDENCY_CHECK_TIMEOUT_MS = 6e4;
+function boolFromEnv(value) {
+	if (typeof value !== "string") return false;
+	const normalized = value.trim().toLowerCase();
+	return [
+		"1",
+		"true",
+		"yes",
+		"on"
+	].includes(normalized);
+}
+function isVoiceDebug(opts) {
+	return Boolean(opts?.debug) || boolFromEnv(process.env.VORA_VOICE_DEBUG);
+}
+function formatMs(ms) {
+	if (ms < 1e3) return `${ms}ms`;
+	return `${(ms / 1e3).toFixed(ms % 1e3 === 0 ? 0 : 1)}s`;
+}
+function voiceDebugLog(message, opts) {
+	if (isVoiceDebug(opts)) defaultRuntime.log(theme.muted(message));
+}
+function voiceInfo(message) {
+	defaultRuntime.log(`${theme.accent("›")} ${message}`);
+}
+function voiceSuccess(message) {
+	defaultRuntime.log(`${theme.success("✓")} ${message}`);
+}
+function voiceWarn(message) {
+	defaultRuntime.log(`${theme.warn("!")} ${message}`);
+}
+function voiceBox(title, lines) {
+	const width = Math.max(title.length + 4, ...lines.map((line) => line.length + 4), 52);
+	const top = `┌─ ${title} ${"─".repeat(Math.max(0, width - title.length - 4))}`;
+	const bottom = `└${"─".repeat(width - 1)}`;
+	defaultRuntime.log(theme.accent(top));
+	for (const line of lines) defaultRuntime.log(`${theme.accent("│")} ${line}`);
+	defaultRuntime.log(theme.accent(bottom));
+}
+function wrapVoiceText(text, width = 86) {
+	const output = [];
+	for (const rawLine of text.replace(/\r/g, "").split("\n")) {
+		const line = rawLine.trim();
+		if (!line) {
+			output.push("");
+			continue;
+		}
+		let current = "";
+		for (const word of line.split(/\s+/g)) {
+			if (!current) {
+				current = word;
+				continue;
+			}
+			if (`${current} ${word}`.length > width) {
+				output.push(current);
+				current = word;
+				continue;
+			}
+			current = `${current} ${word}`;
+		}
+		if (current) output.push(current);
+	}
+	return output.length > 0 ? output : [""];
+}
+function voiceMessageBox(label, text) {
+	voiceBox(label, wrapVoiceText(text));
+}
 function resolveBundledAgoraBridgeScriptPath() {
 	const candidates = [path.resolve(import.meta.dirname, "..", "scripts", "agora-stt-bridge.mjs"), path.resolve(import.meta.dirname, "..", "..", "scripts", "agora-stt-bridge.mjs")];
 	return candidates.find((candidate) => existsSync(candidate)) ?? candidates[0];
@@ -248,6 +314,7 @@ function resolveVoiceRuntimeOptions(opts) {
 		backendUrl
 	});
 	return {
+		debug: isVoiceDebug(opts),
 		gateway: {
 			url: trimToUndefined(opts.url),
 			token: trimToUndefined(opts.token),
@@ -782,7 +849,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 +858,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,
@@ -807,13 +883,18 @@ async function runShellCommand(command, timeoutMs) {
 			});
 		});
 	});
+	let timeoutHandle;
 	const timeout = new Promise((_, reject) => {
-		setTimeout(() => {
+		timeoutHandle = setTimeout(() => {
 			child.kill("SIGTERM");
 			reject(/* @__PURE__ */ new Error(`command timeout after ${timeoutMs}ms`));
 		}, timeoutMs);
 	});
-	return await Promise.race([done, timeout]);
+	try {
+		return await Promise.race([done, timeout]);
+	} finally {
+		if (timeoutHandle) clearTimeout(timeoutHandle);
+	}
 }
 async function runStreamingCommand(bin, args, cwd) {
 	await new Promise((resolve, reject) => {
@@ -974,12 +1055,37 @@ 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";
+	const startedAt = Date.now();
+	voiceInfo(`STT ${phase}: starting Agora bridge (${resolved.stt.language}, timeout ${formatMs(timeoutMs)}). 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;
+			if (boolFromEnv(process.env.VORA_VOICE_BEEP)) process.stdout.write("\x07");
+			voiceSuccess(`Listening now (${resolved.stt.language}). Speak now.`);
+			return;
+		}
+		const stage = message.match(/^\[agora-stt-bridge\] stage=([a-z0-9_-]+)(?:\s+(.*))?$/i);
+		if (stage) {
+			const label = stage[1]?.replaceAll("_", " ") ?? "bridge";
+			const detail = stage[2]?.trim();
+			voiceInfo(`STT ${label}${detail ? `: ${detail}` : ""}`);
+			return;
+		}
+		if (message.includes("fatal:") || message.includes("managed browser unavailable") || message.includes("browser auto-open disabled") || message.includes("timeout waiting")) defaultRuntime.error(message);
+	} });
 	if (result.code !== 0) throw new Error(`Agora STT bridge failed (exit ${result.code}): ${result.stderr.trim() || "no stderr"}`);
-	return extractTranscriptFromCommandOutput(result.stdout);
+	if (!readyLogged) voiceWarn("STT bridge completed without an explicit ready signal");
+	const transcript = extractTranscriptFromCommandOutput(result.stdout);
+	voiceDebugLog(`[voice] STT ${phase} completed in ${formatMs(Date.now() - startedAt)}`);
+	return transcript;
 }
 function normalizeHistoryMessages(payload) {
 	if (!payload || typeof payload !== "object") return [];
@@ -1019,15 +1125,19 @@ function latestAssistantText(messages) {
 	}
 	return null;
 }
+function countAssistantMessages(messages) {
+	return messages.filter(isAssistantMessage).length;
+}
 async function waitForAssistantReply(params) {
 	const startedAt = Date.now();
 	while (Date.now() - startedAt < params.waitMs) {
-		await sleep(1e3);
-		const current = latestAssistantText(normalizeHistoryMessages(await params.client.loadHistory({
+		await sleep(350);
+		const messages = normalizeHistoryMessages(await params.client.loadHistory({
 			sessionKey: params.sessionKey,
 			limit: 100
-		})));
-		if (current && current !== params.beforeText) return current;
+		}));
+		const current = latestAssistantText(messages);
+		if (current && (current !== params.beforeText || countAssistantMessages(messages) > params.beforeAssistantCount)) return current;
 	}
 	return null;
 }
@@ -1202,6 +1312,7 @@ async function speakReply(resolved, text) {
 	if (resolved.tts.provider === "none") return;
 	const ttsText = prepareTtsText(text);
 	if (!ttsText) return;
+	const startedAt = Date.now();
 	if (resolved.tts.provider === "hume") {
 		if (!resolved.tts.backendUrl && !resolved.tts.humeApiKey) {
 			defaultRuntime.error("[voice] Hume TTS skipped: missing backend/API key");
@@ -1209,6 +1320,7 @@ async function speakReply(resolved, text) {
 		}
 		let audioPath;
 		try {
+			voiceInfo(`TTS: synthesizing with Hume (timeout ${formatMs(resolved.tts.timeoutMs)})`);
 			audioPath = await synthesizeHumeAudio({
 				text: ttsText,
 				apiKey: resolved.tts.humeApiKey,
@@ -1218,12 +1330,14 @@ async function speakReply(resolved, text) {
 				timeoutMs: resolved.tts.timeoutMs
 			});
 		} catch (error) {
-			defaultRuntime.error(`[voice] Hume TTS failed: ${String(error)}; using system fallback`);
+			defaultRuntime.error(`[voice] Hume TTS failed after ${formatMs(Date.now() - startedAt)}: ${String(error)}; using system fallback`);
 			if (!await speakWithSystemVoice(ttsText)) defaultRuntime.error("[voice] system TTS fallback unavailable");
 			return;
 		}
 		try {
+			voiceInfo(`TTS: audio ready in ${formatMs(Date.now() - startedAt)}; playing`);
 			if (!await playAudioFile(audioPath)) defaultRuntime.log(`[voice] Hume audio generated: ${audioPath}`);
+			else voiceSuccess(`TTS: finished in ${formatMs(Date.now() - startedAt)}`);
 		} finally {
 			await promises.rm(audioPath, { force: true }).catch(() => void 0);
 		}
@@ -1235,6 +1349,7 @@ async function speakReply(resolved, text) {
 	}
 	let audioPath;
 	try {
+		voiceInfo(`TTS: synthesizing with ElevenLabs (timeout ${formatMs(resolved.tts.timeoutMs)})`);
 		audioPath = await synthesizeElevenLabsAudio({
 			text: ttsText,
 			apiKey: resolved.tts.elevenLabsApiKey,
@@ -1245,12 +1360,14 @@ async function speakReply(resolved, text) {
 			timeoutMs: resolved.tts.timeoutMs
 		});
 	} catch (error) {
-		defaultRuntime.error(`[voice] ElevenLabs TTS failed: ${String(error)}`);
+		defaultRuntime.error(`[voice] ElevenLabs TTS failed after ${formatMs(Date.now() - startedAt)}: ${String(error)}`);
 		if (!await speakWithSystemVoice(ttsText)) defaultRuntime.error("[voice] system TTS fallback unavailable");
 		return;
 	}
 	try {
+		voiceInfo(`TTS: audio ready in ${formatMs(Date.now() - startedAt)}; playing`);
 		if (!await playAudioFile(audioPath)) defaultRuntime.log(`[voice] audio generated: ${audioPath}`);
+		else voiceSuccess(`TTS: finished in ${formatMs(Date.now() - startedAt)}`);
 	} finally {
 		await promises.rm(audioPath, { force: true }).catch(() => void 0);
 	}
@@ -1444,36 +1561,39 @@ async function prepareVoiceTurn(params) {
 async function runGatewayVoiceTurn(params) {
 	const transcript = params.transcript.trim();
 	if (!transcript) return { replied: false };
-	defaultRuntime.log(`You: ${transcript}`);
+	voiceMessageBox("You", transcript);
 	const turn = await prepareVoiceTurn({
 		transcript,
 		state: params.state,
 		followUp: params.followUp
 	});
-	const beforeText = latestAssistantText(normalizeHistoryMessages(await params.gatewayClient.loadHistory({
+	const beforeMessages = normalizeHistoryMessages(await params.gatewayClient.loadHistory({
 		sessionKey: params.resolved.gateway.sessionKey,
 		limit: 100
-	})));
-	const run = await params.gatewayClient.sendChat({
+	}));
+	const beforeText = latestAssistantText(beforeMessages);
+	const beforeAssistantCount = countAssistantMessages(beforeMessages);
+	voiceDebugLog(`[voice] run started: ${(await params.gatewayClient.sendChat({
 		sessionKey: params.resolved.gateway.sessionKey,
 		message: turn.message,
 		thinking: params.resolved.gateway.thinking,
 		deliver: params.resolved.gateway.deliver,
 		attachments: turn.attachments,
 		timeoutMs: params.resolved.gateway.timeoutMs
-	});
-	defaultRuntime.log(`[voice] run started: ${run.runId}`);
+	})).runId}`, params.resolved);
+	voiceInfo("VORA is thinking...");
 	const reply = await waitForAssistantReply({
 		client: params.gatewayClient,
 		sessionKey: params.resolved.gateway.sessionKey,
 		beforeText,
+		beforeAssistantCount,
 		waitMs: params.resolved.gateway.waitMs
 	});
 	if (!reply) {
 		defaultRuntime.error(`[voice] no assistant reply received within ${params.resolved.gateway.waitMs}ms`);
 		return { replied: false };
 	}
-	defaultRuntime.log(`Vora: ${reply}`);
+	voiceMessageBox("Vora", reply);
 	await speakReply(params.resolved, reply);
 	if (params.state) {
 		params.state.lastUser = transcript;
@@ -1507,26 +1627,27 @@ 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`);
+		voiceInfo(`Follow-up window: ${Math.round(followUpListenMs / 1e3)}s after STT is 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")) {
-				defaultRuntime.log("[voice] follow-up silence; returning to wake word");
+				voiceInfo("No follow-up heard; returning to wake word.");
 				return;
 			}
 			throw error;
 		}
 		if (!nextTranscript) {
-			defaultRuntime.log("[voice] follow-up silence; returning to wake word");
+			voiceInfo("No follow-up heard; returning to wake word.");
 			return;
 		}
 		if (isVoiceSleepIntent(nextTranscript)) {
-			defaultRuntime.log("[voice] sleeping; wake word armed next");
+			voiceInfo("Sleep command heard; wake word will arm again.");
 			return;
 		}
 		followUp = true;
@@ -1534,6 +1655,31 @@ async function runVoiceConversation(params) {
 		transcript = nextTranscript;
 	}
 }
+async function runWakeGreeting(params) {
+	const beforeMessages = normalizeHistoryMessages(await params.gatewayClient.loadHistory({
+		sessionKey: params.resolved.gateway.sessionKey,
+		limit: 100
+	}));
+	const beforeText = latestAssistantText(beforeMessages);
+	const beforeAssistantCount = countAssistantMessages(beforeMessages);
+	voiceInfo("Wake detected. Sending \"Hey Vora!\"");
+	voiceDebugLog(`[voice] wake ack run started: ${(await params.gatewayClient.sendChat({
+		sessionKey: params.resolved.gateway.sessionKey,
+		message: "Hey Vora!",
+		thinking: params.resolved.gateway.thinking,
+		deliver: false,
+		timeoutMs: params.resolved.gateway.timeoutMs
+	})).runId}`, params.resolved);
+	const reply = await waitForAssistantReply({
+		client: params.gatewayClient,
+		sessionKey: params.resolved.gateway.sessionKey,
+		beforeText,
+		beforeAssistantCount,
+		waitMs: Math.min(params.resolved.gateway.waitMs, DEFAULT_WAKE_ACK_WAIT_MS)
+	});
+	if (reply) voiceMessageBox("Vora", reply);
+	else voiceWarn("VORA did not answer \"Hey Vora!\" quickly; starting STT anyway.");
+}
 async function runVoiceLoop(opts) {
 	const resolved = resolveVoiceRuntimeOptions(opts);
 	if (!resolved.wake.pythonBin) throw new Error("python runtime missing. Install python3 and re-run `vora voice doctor`.");
@@ -1581,6 +1727,7 @@ async function runVoiceLoop(opts) {
 			}
 		}
 		wakeWord.onVolume((event) => {
+			if (!resolved.debug) return;
 			if (Date.now() - latestVolumeLogAt < 3e3) return;
 			latestVolumeLogAt = Date.now();
 			defaultRuntime.log(`[voice] mic level=${event.volume}%`);
@@ -1591,14 +1738,19 @@ async function runVoiceLoop(opts) {
 				busy = true;
 				wakeWord.stop();
 				try {
-					defaultRuntime.log(`[voice] wake trigger model=${event.model} score=${event.score.toFixed(2)} latency=${(Math.max(0, Date.now() / 1e3 - event.sourceTimestampSec) * 1e3).toFixed(0)}ms`);
-					const transcript = (await transcribeSpeech(resolved)).trim();
+					const latencyMs = (Math.max(0, Date.now() / 1e3 - event.sourceTimestampSec) * 1e3).toFixed(0);
+					voiceBox("Wake", [`Wake word detected. Score ${event.score.toFixed(2)}.`, resolved.debug ? `model=${event.model} latency=${latencyMs}ms` : "VORA is waking up."]);
+					await runWakeGreeting({
+						resolved,
+						gatewayClient
+					});
+					const transcript = (await transcribeSpeech(resolved, { phase: "command" })).trim();
 					if (!transcript) {
-						defaultRuntime.log("[voice] transcript empty; waiting for next wake trigger");
+						voiceInfo("Transcript empty; waiting for next wake trigger.");
 						return;
 					}
 					if (isVoiceSleepIntent(transcript)) {
-						defaultRuntime.log("[voice] sleep command heard; wake word remains armed");
+						voiceInfo("Sleep command heard; wake word remains armed.");
 						return;
 					}
 					await runVoiceConversation({
@@ -1617,7 +1769,7 @@ async function runVoiceLoop(opts) {
 					busy = false;
 					if (!stopRequested) try {
 						await wakeWord.start();
-						defaultRuntime.log("[voice] wake word armed for next turn");
+						voiceSuccess("Wake word armed for next turn.");
 					} catch (err) {
 						defaultRuntime.error(`[voice] failed to restart wake word: ${String(err)}`);
 						requestStop();
@@ -1626,10 +1778,15 @@ async function runVoiceLoop(opts) {
 			})();
 		});
 		await wakeWord.start();
-		defaultRuntime.log(theme.heading("Voice Loop"));
-		defaultRuntime.log(`wake=${resolved.wake.modelPath} threshold=${resolved.wake.threshold} stt=${resolved.stt.provider} tts=${resolved.tts.provider}`);
-		if (resolved.conversation.followUpEnabled && !resolved.once) defaultRuntime.log(`follow-up=on max=${resolved.conversation.followUpMaxTurns} listen=${Math.round(Math.min(resolved.conversation.followUpMs, resolved.conversation.followUpSttTimeoutMs) / 1e3)}s`);
-		defaultRuntime.log("Listening for wake word. Press Ctrl+C to stop. Run `vora voice doctor` if dependencies fail.");
+		voiceBox("VORA Voice", [
+			`Gateway session: ${resolved.gateway.sessionKey}`,
+			`Wake threshold: ${resolved.wake.threshold}`,
+			`STT: ${resolved.stt.provider} (${resolved.stt.language}; English-only default)`,
+			`TTS: ${resolved.tts.provider} (timeout ${formatMs(resolved.tts.timeoutMs)})`,
+			resolved.conversation.followUpEnabled && !resolved.once ? `Follow-up: on, max ${resolved.conversation.followUpMaxTurns}, listen ${Math.round(Math.min(resolved.conversation.followUpMs, resolved.conversation.followUpSttTimeoutMs) / 1e3)}s` : "Follow-up: off",
+			"Say: Hey Vora. Press Ctrl+C to stop.",
+			resolved.debug ? "Debug logs: on" : "Debug logs: off (set VORA_VOICE_DEBUG=1 to inspect internals)"
+		]);
 		await new Promise((resolve) => {
 			resolveStopLoop = resolve;
 			process.once("SIGINT", requestStop);
@@ -1643,7 +1800,7 @@ async function runVoiceLoop(opts) {
 	}
 }
 function addVoiceOptions(cmd) {
-	return cmd.option("--url <url>", "Gateway WebSocket URL").option("--token <token>", "Gateway token").option("--password <password>", "Gateway password").option("--session <key>", "Session key (default: \"main\")").option("--deliver", "Deliver assistant replies to linked channel routes", false).option("--message <text>", "Send an initial message before listening for wake word").option("--thinking <level>", "Thinking level override").option("--timeout-ms <ms>", "chat.send timeout override (ms)").option("--wait-ms <ms>", "Wait budget for assistant reply after send (ms)").option("--once", "Stop after one successful wake->reply turn", false).option("--wake-dir <path>", "Path to wake_word directory").option("--wake-model <path>", "Wake model path or file name").option("--wake-threshold <0..1>", "Wake word threshold").option("--python <bin>", "Python binary for wake word process").option("--stt-provider <manual|agora>", "STT mode (agora uses external bridge command)").option("--stt-lang <lang>", "STT language hint passed to bridge command").option("--stt-timeout-ms <ms>", "STT timeout (ms)").option("--agora-stt-command <cmd>", "External command for Agora STT bridge (supports {lang}, {timeout_ms}); default uses bundled Agora capture bridge").option("--backend-url <url>", `Voice backend URL for provider secrets/tokens (default: ${DEFAULT_VOICE_BACKEND_URL}; use "off" for local env mode)`).option("--tts-provider <none|hume|elevenlabs>", "Voice reply provider").option("--tts-timeout-ms <ms>", "TTS synthesis timeout (ms)").option("--hume-api-key <key>", "Hume API key").option("--hume-voice-id <id>", "Hume voice ID").option("--hume-speed <speed>", "Hume speaking speed (0.5..2, default 1.2)").option("--eleven-labs-api-key <key>", "ElevenLabs API key").option("--eleven-labs-voice-id <id>", "ElevenLabs voice ID").option("--eleven-labs-model-id <id>", "ElevenLabs model ID").option("--eleven-labs-output-format <format>", "ElevenLabs output format").option("--no-follow-up", "Require wake word before every voice turn").option("--follow-up-ms <ms>", "Maximum follow-up listening window after each reply").option("--follow-up-max-turns <n>", "Maximum follow-up turns before re-arming wake word").option("--follow-up-stt-timeout-ms <ms>", "STT timeout for each follow-up turn");
+	return cmd.option("--url <url>", "Gateway WebSocket URL").option("--token <token>", "Gateway token").option("--password <password>", "Gateway password").option("--session <key>", "Session key (default: \"main\")").option("--deliver", "Deliver assistant replies to linked channel routes", false).option("--message <text>", "Send an initial message before listening for wake word").option("--thinking <level>", "Thinking level override").option("--timeout-ms <ms>", "chat.send timeout override (ms)").option("--wait-ms <ms>", "Wait budget for assistant reply after send (ms)").option("--once", "Stop after one successful wake->reply turn", false).option("--wake-dir <path>", "Path to wake_word directory").option("--wake-model <path>", "Wake model path or file name").option("--wake-threshold <0..1>", "Wake word threshold").option("--python <bin>", "Python binary for wake word process").option("--stt-provider <manual|agora>", "STT mode (agora uses external bridge command)").option("--stt-lang <lang>", "STT language hint passed to bridge command").option("--stt-timeout-ms <ms>", "STT timeout (ms)").option("--agora-stt-command <cmd>", "External command for Agora STT bridge (supports {lang}, {timeout_ms}); default uses bundled Agora capture bridge").option("--backend-url <url>", `Voice backend URL for provider secrets/tokens (default: ${DEFAULT_VOICE_BACKEND_URL}; use "off" for local env mode)`).option("--tts-provider <none|hume|elevenlabs>", "Voice reply provider").option("--tts-timeout-ms <ms>", "TTS synthesis timeout (ms)").option("--hume-api-key <key>", "Hume API key").option("--hume-voice-id <id>", "Hume voice ID").option("--hume-speed <speed>", "Hume speaking speed (0.5..2, default 1.2)").option("--eleven-labs-api-key <key>", "ElevenLabs API key").option("--eleven-labs-voice-id <id>", "ElevenLabs voice ID").option("--eleven-labs-model-id <id>", "ElevenLabs model ID").option("--eleven-labs-output-format <format>", "ElevenLabs output format").option("--no-follow-up", "Require wake word before every voice turn").option("--follow-up-ms <ms>", "Maximum follow-up listening window after each reply").option("--follow-up-max-turns <n>", "Maximum follow-up turns before re-arming wake word").option("--follow-up-stt-timeout-ms <ms>", "STT timeout for each follow-up turn").option("--debug", "Show low-level voice runtime diagnostics", false);
 }
 function registerVoiceCli(program) {
 	const voice = addVoiceOptions(program.command("voice").description("Wake-word terminal voice loop (OpenWakeWord trigger + STT bridge + Gateway chat + optional Hume TTS)").addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/voice", "docs.vora.ai/cli/voice")}\n`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vora-ai",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "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 = "en-US";
 const DEFAULT_RTC_UID = "1002";
 const DEFAULT_STT_AUDIO_UID = "111";
 const DEFAULT_STT_TEXT_UID = "222";
@@ -625,6 +625,7 @@ function buildBrowserHtml(browserConfig) {
           });
           TextMessage = root.lookupType("agora.audio2text.Text");
 
+          await post("/stage", { stage: "rtc_join", message: "joining Agora RTC" });
           setStatus("Joining RTC channel...");
           client = AgoraRTC.createClient({ mode: "live", codec: "vp8" });
           if (typeof client.setClientRole === "function") {
@@ -640,25 +641,24 @@ function buildBrowserHtml(browserConfig) {
           const uid = Number.isFinite(uidRaw) ? uidRaw : null;
           await client.join(CONFIG.appId, CONFIG.channel, rtcToken, uid);
 
+          await post("/stage", { stage: "mic", message: "requesting microphone" });
           setStatus("Microphone setup...");
           micTrack = await AgoraRTC.createMicrophoneAudioTrack();
           await client.publish([micTrack]);
 
+          await post("/stage", { stage: "stt_join", message: "joining Agora STT" });
           const start = await post("/api/start", { lang: CONFIG.lang });
           if (!start?.agentId) {
             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 +831,26 @@ async function main() {
   let done = false;
   let currentAgentId = "";
   let browserController = null;
+  let ready = false;
+  let startupTimeout;
+  let listenTimeout;
+
+  const emitStage = (stage, message = "") => {
+    const safeStage = String(stage || "unknown").replace(/[^a-zA-Z0-9_-]/g, "_");
+    const detail = String(message || "").trim();
+    process.stderr.write(`[agora-stt-bridge] stage=${safeStage}${detail ? ` ${detail}` : ""}\n`);
+  };
+
+  const clearTimers = () => {
+    if (startupTimeout) {
+      clearTimeout(startupTimeout);
+      startupTimeout = undefined;
+    }
+    if (listenTimeout) {
+      clearTimeout(listenTimeout);
+      listenTimeout = undefined;
+    }
+  };
 
   const closeBrowser = async () => {
     if (!browserController) {
@@ -846,6 +866,7 @@ async function main() {
       return;
     }
     done = true;
+    clearTimers();
     await stopAgoraStt(resolvedConfig, currentAgentId).catch(() => undefined);
     await closeBrowser();
     if (server) {
@@ -860,6 +881,7 @@ async function main() {
       return;
     }
     done = true;
+    clearTimers();
     await stopAgoraStt(resolvedConfig, currentAgentId).catch(() => undefined);
     await closeBrowser();
     if (server) {
@@ -869,6 +891,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;
@@ -882,6 +913,7 @@ async function main() {
       try {
         const body = await readJsonBody(req);
         const lang = typeof body?.lang === "string" && body.lang.trim() ? body.lang.trim() : resolvedConfig.lang;
+        emitStage("backend_stt", "requesting STT agent");
         currentAgentId = await startAgoraStt(resolvedConfig, lang);
         jsonResponse(res, 200, { ok: true, agentId: currentAgentId });
       } catch (error) {
@@ -890,6 +922,39 @@ async function main() {
       return;
     }
 
+    if (req.method === "POST" && pathname === "/stage") {
+      try {
+        const body = await readJsonBody(req);
+        emitStage(body?.stage, body?.message);
+        jsonResponse(res, 200, { ok: true });
+      } catch (error) {
+        jsonResponse(res, 500, { ok: false, error: String(error) });
+      }
+      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);
@@ -957,15 +1022,16 @@ async function main() {
 
   const localUrl = `http://127.0.0.1:${address.port}/`;
   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");
+  emitStage("session", `channel=${resolvedConfig.channel} uid=${resolvedConfig.uid} ${source}`);
+  emitStage("server", `local capture URL ${localUrl}`);
+  emitStage("browser", "starting hidden capture browser");
+  startupTimeout = setTimeout(() => {
+    void fail("timeout waiting for microphone/STT readiness");
+  }, Math.max(18_000, resolvedConfig.timeoutMs + 8_000));
   if (config.browserMode === "managed") {
     try {
       browserController = await openManagedBrowser(localUrl, config.showBrowser);
-      process.stderr.write(
-        `[agora-stt-bridge] managed browser capture started${config.showBrowser ? "" : " (hidden)"}\n`,
-      );
+      emitStage("browser", `capture browser started${config.showBrowser ? "" : " hidden"}`);
     } catch (error) {
       await fail(
         [
@@ -981,12 +1047,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 };