@absolutejs/voice 0.0.22-beta.119 → 0.0.22-beta.120

package/dist/index.d.ts

@@ -75,7 +75,7 @@ export type { VoiceLiveLatencyOptions, VoiceLiveLatencyReport, VoiceLiveLatencyR
 export type { VoiceTurnQualityHTMLHandlerOptions, VoiceTurnQualityItem, VoiceTurnQualityOptions, VoiceTurnQualityReport, VoiceTurnQualityRoutesOptions, VoiceTurnQualityStatus } from './turnQuality';
 export type { VoiceOutcomeContractDefinition, VoiceOutcomeContractHTMLHandlerOptions, VoiceOutcomeContractIssue, VoiceOutcomeContractOptions, VoiceOutcomeContractReport, VoiceOutcomeContractRoutesOptions, VoiceOutcomeContractStatus, VoiceOutcomeContractSuiteReport } from './outcomeContract';
 export type { VoiceTelephonyOutcomeAction, VoiceTelephonyOutcomeDecision, VoiceTelephonyOutcomePolicy, VoiceTelephonyOutcomeProviderEvent, VoiceTelephonyOutcomeRouteResult, VoiceTelephonyOutcomeStatusDecision, VoiceTelephonyWebhookDecision, VoiceTelephonyWebhookHandlerOptions, VoiceTelephonyWebhookIdempotencyStore, VoiceTelephonyWebhookParseInput, VoiceTelephonyWebhookProvider, VoiceTelephonyWebhookRoutesOptions, VoiceTelephonyWebhookVerificationResult, StoredVoiceTelephonyWebhookDecision } from './telephonyOutcome';
-export type { VoicePhoneAgentCarrier, VoicePhoneAgentPlivoCarrier, VoicePhoneAgentRoutes, VoicePhoneAgentRoutesOptions, VoicePhoneAgentTelnyxCarrier, VoicePhoneAgentTwilioCarrier } from './phoneAgent';
+export type { VoicePhoneAgentCarrier, VoicePhoneAgentCarrierSummary, VoicePhoneAgentLifecycleStage, VoicePhoneAgentPlivoCarrier, VoicePhoneAgentRoutes, VoicePhoneAgentRoutesOptions, VoicePhoneAgentSetupReport, VoicePhoneAgentTelnyxCarrier, VoicePhoneAgentTwilioCarrier } from './phoneAgent';
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 export type { VoiceProductionReadinessAction, VoiceProductionReadinessCheck, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessStatus } from './productionReadiness';
 export type { VoiceQualityLink, VoiceQualityMetric, VoiceQualityReport, VoiceQualityRoutesOptions, VoiceQualityStatus, VoiceQualityThresholds } from './qualityRoutes';

package/dist/index.js

@@ -11486,14 +11486,14 @@ var createProofFetch = (provider, requests) => {
   };
 };
 var createProofDialer = (input) => {
-  const fetch2 = createProofFetch(input.provider, input.requests);
+  const fetch = createProofFetch(input.provider, input.requests);
   if (input.provider === "twilio") {
     return createVoiceTwilioCampaignDialer({
       accountSid: "AC_dry_run",
       answerUrl: joinUrlPath(input.baseUrl, "/api/twilio/voice"),
       apiBaseUrl: "https://twilio.dry-run.absolutejs.local",
       authToken: "dry-run-token",
-      fetch: fetch2,
+      fetch,
       from: input.from,
       statusCallbackEvents: ["answered", "completed"],
       statusCallbackUrl: joinUrlPath(input.baseUrl, "/api/telephony-webhook")
@@ -11504,7 +11504,7 @@ var createProofDialer = (input) => {
       apiBaseUrl: "https://telnyx.dry-run.absolutejs.local",
       apiKey: "dry-run-token",
       connectionId: "dry-run-connection",
-      fetch: fetch2,
+      fetch,
       from: input.from,
       webhookUrl: joinUrlPath(input.baseUrl, "/api/telnyx/webhook")
     });
@@ -11515,7 +11515,7 @@ var createProofDialer = (input) => {
     authId: "dry-run-auth-id",
     authToken: "dry-run-token",
     callbackUrl: joinUrlPath(input.baseUrl, "/api/plivo/webhook"),
-    fetch: fetch2,
+    fetch,
     from: input.from
   });
 };
@@ -15283,12 +15283,25 @@ var resolveSmokePath = (carrier) => {
   }
   return carrier.options?.smoke?.path === false ? false : carrier.options?.smoke?.path ?? defaultSmokePath(carrier.provider);
 };
-var fetchJson = async (origin, path) => {
-  const response = await fetch(new URL(path, origin).toString(), {
+var PHONE_AGENT_LIFECYCLE_STAGES = [
+  "ringing",
+  "answered",
+  "media-started",
+  "transcript",
+  "assistant-response",
+  "transfer",
+  "voicemail",
+  "no-answer",
+  "completed",
+  "failed"
+];
+var escapeHtml28 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var loadRouteJson = async (input) => {
+  const response = await input.app.handle(new Request(new URL(input.path, input.origin).toString(), {
     headers: {
       accept: "application/json"
     }
-  });
+  }));
   if (!response.ok) {
     return;
   }
@@ -15302,12 +15315,20 @@ var loadCarrierMatrixInputs = async (input) => {
     if (!setupPath) {
       continue;
     }
-    const setup = await fetchJson(origin, setupPath);
+    const setup = await loadRouteJson({
+      app: input.app,
+      origin,
+      path: setupPath
+    });
     if (!setup) {
       continue;
     }
     const smokePath = resolveSmokePath(carrier);
-    const smoke = smokePath ? await fetchJson(origin, smokePath) : undefined;
+    const smoke = smokePath ? await loadRouteJson({
+      app: input.app,
+      origin,
+      path: smokePath
+    }) : undefined;
     entries.push({
       name: carrier.name,
       setup,
@@ -15316,6 +15337,11 @@ var loadCarrierMatrixInputs = async (input) => {
   }
   return entries;
 };
+var renderVoicePhoneAgentSetupHTML = (report) => {
+  const carrierRows = report.carriers.map((carrier) => `<tr><td>${escapeHtml28(carrier.name ?? carrier.provider)}</td><td>${escapeHtml28(carrier.provider)}</td><td><code>${escapeHtml28(carrier.setupPath || "disabled")}</code></td><td><code>${escapeHtml28(carrier.smokePath || "disabled")}</code></td></tr>`).join("");
+  const stageList = report.lifecycleStages.map((stage) => `<li><code>${escapeHtml28(stage)}</code></li>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml28(report.title)}</title><style>body{background:#10151c;color:#f8f3e7;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1080px;padding:32px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.2),rgba(245,158,11,.12));border:1px solid #283544;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#5eead4;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.3rem,6vw,4.8rem);line-height:.92;margin:.2rem 0 1rem}.badge{border:1px solid #3f3f46;border-radius:999px;display:inline-flex;padding:8px 12px}.pass{color:#86efac}.fail{color:#fca5a5}table{background:#151d27;border:1px solid #283544;border-collapse:collapse;border-radius:18px;overflow:hidden;width:100%}td,th{border-bottom:1px solid #283544;padding:12px;text-align:left}code{color:#fde68a}ul{display:grid;gap:8px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));padding-left:18px}</style></head><body><main><section class="hero"><p class="eyebrow">Phone agent setup</p><h1>${escapeHtml28(report.title)}</h1><p>One self-hosted entrypoint for carrier routes, setup reports, smoke checks, and normalized call lifecycle stages.</p><p class="badge ${report.ready ? "pass" : "fail"}">Ready: ${String(report.ready)}</p>${report.matrixPath ? `<p><a href="${escapeHtml28(report.matrixPath)}?format=html">Open carrier matrix</a></p>` : ""}</section><h2>Carriers</h2><table><thead><tr><th>Name</th><th>Provider</th><th>Setup</th><th>Smoke</th></tr></thead><tbody>${carrierRows}</tbody></table><h2>Lifecycle Schema</h2><ul>${stageList}</ul></main></body></html>`;
+};
 var createVoicePhoneAgent = (options) => {
   const carrierSummaries = options.carriers.map((carrier) => ({
     name: carrier.name,
@@ -15340,20 +15366,55 @@ var createVoicePhoneAgent = (options) => {
     }
   }
   const matrixPath = options.matrix === false ? undefined : options.matrix?.path ?? "/api/voice/phone/carriers";
+  const setupPath = options.setup === false ? undefined : options.setup?.path ?? "/api/voice/phone/setup";
+  const setupTitle = options.setup === false ? "AbsoluteJS Voice Phone Agent" : options.setup?.title ?? "AbsoluteJS Voice Phone Agent";
   if (options.matrix !== false) {
     app.use(createVoiceTelephonyCarrierMatrixRoutes({
       ...options.matrix ?? {},
       path: matrixPath,
       load: ({ request }) => loadCarrierMatrixInputs({
+        app,
         carriers: options.carriers,
         request
       })
     }));
   }
+  if (setupPath) {
+    app.get(setupPath, async ({ query, request }) => {
+      const matrixInputs = options.matrix === false ? [] : await loadCarrierMatrixInputs({
+        app,
+        carriers: options.carriers,
+        request
+      });
+      const matrix = options.matrix === false ? undefined : createVoiceTelephonyCarrierMatrix({
+        contract: options.matrix?.contract,
+        providers: matrixInputs
+      });
+      const report = {
+        carriers: carrierSummaries,
+        generatedAt: Date.now(),
+        lifecycleStages: PHONE_AGENT_LIFECYCLE_STAGES,
+        matrix,
+        matrixPath,
+        ready: matrix ? matrix.pass : carrierSummaries.length > 0,
+        setupPath,
+        title: setupTitle
+      };
+      if (query.format === "html") {
+        return new Response(renderVoicePhoneAgentSetupHTML(report), {
+          headers: {
+            "content-type": "text/html; charset=utf-8"
+          }
+        });
+      }
+      return report;
+    });
+  }
   return {
     carriers: carrierSummaries,
     matrixPath,
-    routes: app
+    routes: app,
+    setupPath
   };
 };
 // src/fileStore.ts
@@ -18785,7 +18846,7 @@ var createVoiceOpsRuntime = (config) => {
       pollIntervalMs: _pollIntervalMs,
       backoffMs,
       eventTypes,
-      fetch: fetch2,
+      fetch,
       headers,
       retries,
       signingSecret,
@@ -18799,7 +18860,7 @@ var createVoiceOpsRuntime = (config) => {
       webhook: {
         backoffMs,
         eventTypes,
-        fetch: fetch2,
+        fetch,
         headers,
         retries,
         signingSecret,

package/dist/phoneAgent.d.ts

@@ -2,8 +2,9 @@ import { Elysia } from 'elysia';
 import { type PlivoVoiceRoutesOptions } from './telephony/plivo';
 import { type TelnyxVoiceRoutesOptions } from './telephony/telnyx';
 import { type TwilioVoiceRoutesOptions } from './telephony/twilio';
-import { type VoiceTelephonyCarrierMatrixRoutesOptions } from './telephony/matrix';
+import { type VoiceTelephonyCarrierMatrix, type VoiceTelephonyCarrierMatrixRoutesOptions } from './telephony/matrix';
 import type { VoiceSessionRecord } from './types';
+export type VoicePhoneAgentLifecycleStage = 'ringing' | 'answered' | 'media-started' | 'transcript' | 'assistant-response' | 'transfer' | 'voicemail' | 'no-answer' | 'completed' | 'failed';
 type VoicePhoneAgentCarrierBase = {
     name?: string;
     smokePath?: false | string;
@@ -26,16 +27,32 @@ export type VoicePhoneAgentRoutesOptions<TContext = unknown, TSession extends Vo
     carriers: readonly VoicePhoneAgentCarrier<TContext, TSession, TResult>[];
     matrix?: false | Omit<VoiceTelephonyCarrierMatrixRoutesOptions, 'load'>;
     name?: string;
+    setup?: false | {
+        path?: string;
+        title?: string;
+    };
+};
+export type VoicePhoneAgentCarrierSummary = {
+    name?: string;
+    provider: 'plivo' | 'telnyx' | 'twilio';
+    setupPath?: false | string;
+    smokePath?: false | string;
 };
 export type VoicePhoneAgentRoutes = {
-    carriers: {
-        name?: string;
-        provider: 'plivo' | 'telnyx' | 'twilio';
-        setupPath?: false | string;
-        smokePath?: false | string;
-    }[];
+    carriers: VoicePhoneAgentCarrierSummary[];
     matrixPath?: string;
     routes: Elysia;
+    setupPath?: string;
+};
+export type VoicePhoneAgentSetupReport = {
+    carriers: VoicePhoneAgentCarrierSummary[];
+    generatedAt: number;
+    lifecycleStages: VoicePhoneAgentLifecycleStage[];
+    matrix?: VoiceTelephonyCarrierMatrix;
+    matrixPath?: string;
+    ready: boolean;
+    setupPath?: string;
+    title: string;
 };
 export declare const createVoicePhoneAgent: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown>(options: VoicePhoneAgentRoutesOptions<TContext, TSession, TResult>) => VoicePhoneAgentRoutes;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.119",
+	"version": "0.0.22-beta.120",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",