@f-o-h/cli 0.1.53 → 0.1.55

package/dist/foh.js

@@ -16021,6 +16021,19 @@ function getTtsProviders(catalog) {
   const fromProviders = Array.isArray(catalog.providers?.tts) ? catalog.providers?.tts : [];
   return fromProviders.map((provider) => String(provider || "").trim().toLowerCase()).filter((provider) => provider.length > 0).sort();
 }
+function getSttProviders(catalog) {
+  const providerRows = Array.isArray(catalog.voice_catalog?.providers) ? catalog.voice_catalog?.providers : [];
+  const fromRows = providerRows.filter((provider) => provider?.kind === "stt").map((provider) => String(provider.id || "").trim().toLowerCase()).filter((provider) => provider.length > 0);
+  if (fromRows.length > 0) return [...new Set(fromRows)].sort();
+  const fromProviders = Array.isArray(catalog.providers?.stt) ? catalog.providers?.stt : [];
+  return fromProviders.map((provider) => String(provider || "").trim().toLowerCase()).filter((provider) => provider.length > 0).sort();
+}
+function resolveDefaultSttProvider(providers) {
+  for (const preferred of ["deepgram", "azure", "twilio", "none"]) {
+    if (providers.includes(preferred)) return preferred;
+  }
+  return providers[0] || "deepgram";
+}
 function registerVoice(program3) {
   const voice = program3.command("voice").description("Manage voice provider configuration");
   voice.command("verify").description("Run voice verification lanes (quick/full/release) through authenticated API orchestration").option("--mode <m>", "Verification mode: quick, full, release", "release").option("--org <id>", "Org ID (default: stored org from foh org use)").option("--api-url <url>", "API base URL override").option("--json", "Output as JSON").action(async (opts) => withCommandErrorHandling(async () => {
@@ -16248,11 +16261,12 @@ function registerVoice(program3) {
     const allReady = providers.length > 0 && providers.every((provider) => provider?.ready === true);
     if (!allReady) markCommandFailed(1);
   }));
-  voice.command("configure").description("Configure voice settings for an agent (does not publish unless --publish)").requiredOption("--agent <id>", "Agent ID").requiredOption("--provider <p>", "TTS provider: openai, azure, twilio").requiredOption("--voice <id>", "Voice ID").option("--stt-provider <p>", "STT provider (default: openai)").option("--publish", "Validate, simulation-certify, then publish after configuring").option("--cert-mode <m>", "Simulation cert mode before publish: quick, full, stress", "full").option("--cert-adaptive-runs <n>", "Adaptive runs for full/stress certification (default: 30)", "30").option("--cert-max-improvement-rounds <n>", "Max prompt improvement rounds before publish (0-5)", "1").option("--org <id>", "Org ID (default: stored org from foh org use)").option("--api-url <url>", "API base URL override").option("--json", "Output as JSON").action(async (opts) => withCommandErrorHandling(async () => {
+  voice.command("configure").description("Configure voice settings for an agent (does not publish unless --publish)").requiredOption("--agent <id>", "Agent ID").requiredOption("--provider <p>", "TTS provider: openai, azure, twilio").requiredOption("--voice <id>", "Voice ID").option("--stt-provider <p>", "STT provider (default: best available, preferring deepgram)").option("--publish", "Validate, simulation-certify, then publish after configuring").option("--cert-mode <m>", "Simulation cert mode before publish: quick, full, stress", "full").option("--cert-adaptive-runs <n>", "Adaptive runs for full/stress certification (default: 30)", "30").option("--cert-max-improvement-rounds <n>", "Max prompt improvement rounds before publish (0-5)", "1").option("--org <id>", "Org ID (default: stored org from foh org use)").option("--api-url <url>", "API base URL override").option("--json", "Output as JSON").action(async (opts) => withCommandErrorHandling(async () => {
     const provider = String(opts.provider || "").trim().toLowerCase();
     const voiceId = String(opts.voice || "").trim();
     const catalog = await getSpeechCatalog(opts.apiUrl);
     const supportedProviders = getTtsProviders(catalog);
+    const supportedSttProviders = getSttProviders(catalog);
     if (!supportedProviders.includes(provider)) {
       throw new FohError({
         step: "voice.configure",
@@ -16271,10 +16285,19 @@ function registerVoice(program3) {
         statusCode: 400
       });
     }
+    const sttProvider = String(opts.sttProvider || resolveDefaultSttProvider(supportedSttProviders)).trim().toLowerCase();
+    if (supportedSttProviders.length > 0 && !supportedSttProviders.includes(sttProvider)) {
+      throw new FohError({
+        step: "voice.configure",
+        error: `STT provider "${sttProvider}" is not available in speech catalog`,
+        remediation: `Use --stt-provider ${resolveDefaultSttProvider(supportedSttProviders)} or run: foh voice list-providers${opts.apiUrl ? ` --api-url ${opts.apiUrl}` : ""}`,
+        statusCode: 400
+      });
+    }
     const voiceConfig = {
       tts_provider: provider,
       tts_voice_id: voiceId,
-      stt_provider: opts.sttProvider ?? "openai"
+      stt_provider: sttProvider
     };
     const draft = await apiFetch(`/v1/console/agents/${opts.agent}/draft`, {
       method: "PATCH",
@@ -32830,7 +32853,7 @@ var StdioServerTransport = class {
 };
 
 // src/lib/cli-version.ts
-var CLI_VERSION = "0.1.53";
+var CLI_VERSION = "0.1.55";
 
 // src/commands/mcp-serve.ts
 var DEFAULT_TIMEOUT_MS = 12e4;
@@ -34479,6 +34502,28 @@ function normalizeSetupPhoneMode(raw) {
     reasonCode: "setup_invalid_phone_mode"
   });
 }
+function complianceSkipDetail(phoneMode) {
+  return {
+    reason_code: `compliance_skipped_phone_mode_${phoneMode}`,
+    phone_mode: phoneMode,
+    spend_policy: resolveCliSpendPolicy(),
+    spend_class: "free",
+    safe_to_retry: true,
+    operator_note: "Compliance is only required before paid FOH-owned phone purchase."
+  };
+}
+function isMissingAgentTestsError(error2) {
+  if (!(error2 instanceof FohError)) return false;
+  if (error2.statusCode !== 404) return false;
+  const text = [
+    error2.error,
+    error2.reasonCode,
+    error2.detail?.error,
+    error2.detail?.message,
+    error2.detail?.reason_code
+  ].filter((value) => value !== void 0 && value !== null).join(" ").toLowerCase();
+  return text.includes("no tests found") || text.includes("tests_not_found") || text.includes("agent_tests_not_configured");
+}
 function buildMissingOptionsPlan(missing, opts) {
   const missingFlags = missing.map(optionNameToFlag);
   const signInUrl = buildConsoleSignInUrl(resolveConsoleBaseUrl(opts.consoleUrl));
@@ -34722,6 +34767,9 @@ function registerSetup(program3) {
       });
       await step("submit_compliance", "Submit standard compliance", async () => {
         if (opts.skipCompliance) return { step: "submit_compliance", status: "skipped", detail: "--skip-compliance" };
+        if (phoneMode !== "purchase") {
+          return { step: "submit_compliance", status: "skipped", detail: complianceSkipDetail(phoneMode) };
+        }
         const status = await apiFetch("/v1/console/org/compliance/status", {
           orgId: opts.org,
           apiUrlOverride: opts.apiUrl
@@ -34742,6 +34790,9 @@ function registerSetup(program3) {
       });
       await step("wait_compliance", "Poll until compliance approved", async () => {
         if (opts.skipCompliance) return { step: "wait_compliance", status: "skipped", detail: "--skip-compliance" };
+        if (phoneMode !== "purchase") {
+          return { step: "wait_compliance", status: "skipped", detail: complianceSkipDetail(phoneMode) };
+        }
         await pollUntil(
           async () => {
             const status = await apiFetch("/v1/console/org/compliance/status", {
@@ -34930,7 +34981,7 @@ function registerSetup(program3) {
             voice: {
               tts_provider: opts.voiceProvider,
               tts_voice_id: opts.voiceId,
-              stt_provider: "openai"
+              stt_provider: "deepgram"
             }
           }),
           apiUrlOverride: opts.apiUrl
@@ -34940,10 +34991,30 @@ function registerSetup(program3) {
       await step("run_smoke_test", "Run all agent tests", async () => {
         if (opts.skipTests) return { step: "run_smoke_test", status: "skipped", detail: "--skip-tests" };
         const resolvedAgentId = requireAgentId("run_smoke_test");
-        const batch = await apiFetch(`/v1/console/agents/${resolvedAgentId}/tests/run-all`, {
-          method: "POST",
-          apiUrlOverride: opts.apiUrl
-        });
+        let batch;
+        try {
+          batch = await apiFetch(`/v1/console/agents/${resolvedAgentId}/tests/run-all`, {
+            method: "POST",
+            apiUrlOverride: opts.apiUrl
+          });
+        } catch (error2) {
+          if (isMissingAgentTestsError(error2)) {
+            return {
+              step: "run_smoke_test",
+              status: "skipped",
+              detail: {
+                reason_code: "agent_tests_not_configured",
+                safe_to_retry: true,
+                next_commands: [
+                  `foh test run --agent ${resolvedAgentId} --json`,
+                  `foh prove --agent ${resolvedAgentId} --mission widget --json`
+                ],
+                operator_note: "No saved agent tests exist yet; setup continues to simulation certification and widget proof."
+              }
+            };
+          }
+          throw error2;
+        }
         if (!batch.batch_id) return { step: "run_smoke_test", status: "done" };
         const result = await pollUntil(
           async () => {
@@ -40037,7 +40108,7 @@ async function executeExternalAgentExecutorPlan(plan, options = {}) {
 var DEFAULT_PROMPT_VERSION = "blank-setup.v1";
 var DEFAULT_BATCH_MODELS = "openai/codex,anthropic/claude,cursor/agent";
 var PROMPTS = {
-  "blank-setup.v1": "Go to https://frontofhouse.okii.uk. Use only public docs, public API docs, and the public npm CLI package. Always invoke the CLI with `npx --yes @f-o-h/cli@latest ...`; do not use unpinned `npx @f-o-h/cli ...`, because cached older packages can produce invalid evidence. Install or verify the FOH CLI, authenticate or reach a deterministic auth blocker, then create or configure a Front Of House voice agent and website widget. Prefer the certification-oriented buyer templates: run `npx --yes @f-o-h/cli@latest templates list --category buyer --json` and use `UK Buyer Qualification` or `Viewing Booking` when available; do not use a greeting-only template for proof/certification. Prefer `npx --yes @f-o-h/cli@latest setup --phone-mode observe` for the free scaffold path: agent, widget, voice config, smoke test, certification, and publish readiness together. Treat phone-number purchasing as an explicit paid/scarce contact-path step, not part of high-volume eval setup. If `FOH_CLI_SPEND_POLICY=no_spend` is active and a command returns `paid_resource_blocked_by_spend_policy`, do not try to bypass it; continue widget/setup proof and report that exact reason code for the phone path. Run proof/smoke/certification where available, including widget proof and voice proof. When running more than one `foh prove` mission for the same agent, pass `--proof-cache-dir .foh/proof-cache` so simulation certification can be shared instead of recomputed. If voice proof returns `contact_phone_missing` or `voice_contact_expected_no_spend_hold`, report that exact reason code unless a BYON/customer-approved phone path already exists. If `FOH_EXTERNAL_AGENT_RUN_DIR` is set, write `${FOH_EXTERNAL_AGENT_RUN_DIR}/external-agent-metadata.json` with `schema_version`, `docs_pages_used`, key decisions, and blocker reason codes before finishing. Produce a final evidence summary with commands run, docs used, artifacts created, and any blocker reason codes. Do not assume access to the private source repository.",
+  "blank-setup.v1": "Go to https://frontofhouse.okii.uk. Use only public docs, public API docs, and the public npm CLI package. Always invoke the CLI with `npx --yes @f-o-h/cli@latest ...`; do not use unpinned `npx @f-o-h/cli ...`, because cached older packages can produce invalid evidence. Install or verify the FOH CLI, authenticate or reach a deterministic auth blocker, then create or configure a Front Of House voice agent and website widget. Prefer the certification-oriented buyer templates: run `npx --yes @f-o-h/cli@latest templates list --category buyer --json` and use `UK Buyer Qualification` or `Viewing Booking` when available; do not use a greeting-only template for proof/certification. Prefer `npx --yes @f-o-h/cli@latest setup --phone-mode observe` for the free scaffold path: agent, widget, voice config, smoke test, certification, and publish readiness together. Treat phone-number purchasing as an explicit paid/scarce contact-path step, not part of high-volume eval setup. If `FOH_CLI_SPEND_POLICY=no_spend` is active and a command returns `paid_resource_blocked_by_spend_policy`, do not try to bypass it; continue widget/setup proof and report that exact reason code for the phone path. If the customer/operator explicitly owns a number and asks for real PSTN proof, use `npx --yes @f-o-h/cli@latest provision byon attach --phone-number <e164> --confirm-owned --json`; do not invent ownership or buy a FOH-owned number. Run proof/smoke/certification where available, including widget proof and voice proof. When running more than one `foh prove` mission for the same agent, pass `--proof-cache-dir .foh/proof-cache` so simulation certification can be shared instead of recomputed. If voice proof returns `contact_phone_missing` or `voice_contact_expected_no_spend_hold`, report that exact reason code unless a BYON/customer-approved phone path already exists. If `FOH_EXTERNAL_AGENT_RUN_DIR` is set, write `${FOH_EXTERNAL_AGENT_RUN_DIR}/external-agent-metadata.json` with `schema_version`, `docs_pages_used`, key decisions, and blocker reason codes before finishing. Produce a final evidence summary with commands run, docs used, artifacts created, and any blocker reason codes. Do not assume access to the private source repository.",
   "debug-proof-failure.v1": "You are given a FOH proof or debug artifact. Use public docs and FOH CLI/API behavior to classify whether the blocker is docs, auth, org setup, agent config, widget, channel, runtime, or product bug. Produce a redacted improvement packet or the exact command needed to produce one. Do not ask the human to interpret logs manually unless no machine-readable artifact exists.",
   "knowledge-miss.v1": "A FOH agent failed to answer a business question. Use CLI/API/docs to determine whether this is a knowledge-ingestion issue, retrieval issue, config issue, prompt/behavior issue, or runtime issue. Prefer foh knowledge query, transcript export, replay, and foh bug improve artifacts over screenshots.",
   "replay-failure.v1": "You are given a FOH transcript or replay artifact. Use CLI/API/docs to replay or inspect the failed interaction, identify expected vs actual behavior, and produce a scenario-test or improvement-packet candidate."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@f-o-h/cli",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "description": "FOH CLI - AI-operator provisioning tool for Front Of House",
   "license": "UNLICENSED",
   "bin": {