@absolutejs/voice 0.0.22-beta.63 → 0.0.22-beta.65

package/dist/appKit.d.ts

@@ -5,11 +5,12 @@ import { type VoiceEvalRoutesOptions, type VoiceEvalLink } from './evalRoutes';
 import { type VoiceHandoffHealthRoutesOptions } from './handoffHealth';
 import { type VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 import { type VoiceProviderHealthRoutesOptions } from './providerHealth';
+import { type VoiceProviderCapabilityRoutesOptions } from './providerCapabilities';
 import { type VoiceQualityRoutesOptions } from './qualityRoutes';
 import { type VoiceResilienceRoutesOptions } from './resilienceRoutes';
 import { type VoiceSessionListRoutesOptions, type VoiceSessionReplayRoutesOptions } from './sessionReplay';
 import { type VoiceTraceEventStore } from './trace';
-export type VoiceAppKitSurface = 'assistantHealth' | 'diagnostics' | 'evals' | 'handoffs' | 'opsConsole' | 'providerHealth' | 'quality' | 'resilience' | 'sessionReplay' | 'sessions';
+export type VoiceAppKitSurface = 'assistantHealth' | 'diagnostics' | 'evals' | 'handoffs' | 'opsConsole' | 'providerCapabilities' | 'providerHealth' | 'quality' | 'resilience' | 'sessionReplay' | 'sessions';
 export type VoiceAppKitLink = VoiceEvalLink & {
     description?: string;
     statusHref?: string;
@@ -25,6 +26,7 @@ export type VoiceAppKitRoutesOptions<TProvider extends string = string> = {
     llmProviders?: readonly TProvider[];
     name?: string;
     opsConsole?: false | Partial<VoiceOpsConsoleRoutesOptions>;
+    providerCapabilities?: false | Partial<VoiceProviderCapabilityRoutesOptions<TProvider>>;
     providerHealth?: false | Partial<VoiceProviderHealthRoutesOptions<TProvider>>;
     quality?: false | Partial<VoiceQualityRoutesOptions>;
     resilience?: false | Partial<VoiceResilienceRoutesOptions>;

package/dist/client/opsStatusWidget.d.ts

@@ -29,7 +29,7 @@ export type VoiceOpsStatusWidgetOptions = VoiceAppKitStatusClientOptions & {
     includeLinks?: boolean;
     title?: string;
 };
-export declare const getVoiceOpsStatusLabel: (report?: VoiceAppKitStatusReport | null, error?: string | null) => "Unavailable" | "Checking" | "Passing" | "Needs attention";
+export declare const getVoiceOpsStatusLabel: (report?: VoiceAppKitStatusReport | null, error?: string | null) => "Passing" | "Unavailable" | "Checking" | "Needs attention";
 export declare const createVoiceOpsStatusViewModel: (snapshot: VoiceAppKitStatusSnapshot, options?: VoiceOpsStatusWidgetOptions) => VoiceOpsStatusViewModel;
 export declare const renderVoiceOpsStatusHTML: (snapshot: VoiceAppKitStatusSnapshot, options?: VoiceOpsStatusWidgetOptions) => string;
 export declare const getVoiceOpsStatusCSS: () => string;

package/dist/index.d.ts

@@ -8,11 +8,12 @@ export { createVoiceWorkflowContract, createVoiceWorkflowContractHandler, create
 export { createVoiceSessionListRoutes, createVoiceSessionReplayHTMLHandler, createVoiceSessionReplayJSONHandler, createVoiceSessionReplayRoutes, createVoiceSessionsHTMLHandler, createVoiceSessionsJSONHandler, renderVoiceSessionsHTML, summarizeVoiceSessions, summarizeVoiceSessionReplay } from './sessionReplay';
 export { createVoiceAgent, createVoiceAgentSquad, createVoiceAgentTool } from './agent';
 export { createVoiceToolIdempotencyKey, createVoiceToolRuntime } from './toolRuntime';
-export { createVoiceToolContract, createVoiceToolRuntimeContractDefaults, runVoiceToolContract } from './toolContract';
+export { createVoiceToolContract, createVoiceToolContractHTMLHandler, createVoiceToolContractJSONHandler, createVoiceToolContractRoutes, createVoiceToolRuntimeContractDefaults, renderVoiceToolContractHTML, runVoiceToolContractSuite, runVoiceToolContract } from './toolContract';
 export { createStoredVoiceCallReviewArtifact, createStoredVoiceExternalObjectMap, createStoredVoiceIntegrationEvent, createStoredVoiceOpsTask, createVoiceFileExternalObjectMapStore, createVoiceFileAssistantMemoryStore, createVoiceFileIntegrationEventStore, createVoiceFileReviewStore, createVoiceFileRuntimeStorage, createVoiceFileSessionStore, createVoiceFileTaskStore, createVoiceFileTraceSinkDeliveryStore, createVoiceFileTraceEventStore } from './fileStore';
 export { createVoiceAssistantMemoryHandle, createVoiceAssistantMemoryRecord, createVoiceMemoryAssistantMemoryStore, resolveVoiceAssistantMemoryNamespace } from './assistantMemory';
 export { createAnthropicVoiceAssistantModel, createGeminiVoiceAssistantModel, createJSONVoiceAssistantModel, createOpenAIVoiceAssistantModel, resolveVoiceProviderRoutingPolicyPreset, createVoiceProviderRouter } from './modelAdapters';
 export { createVoiceProviderHealthHTMLHandler, createVoiceProviderHealthJSONHandler, createVoiceProviderHealthRoutes, renderVoiceProviderHealthHTML, summarizeVoiceProviderHealth } from './providerHealth';
+export { createVoiceProviderCapabilityHTMLHandler, createVoiceProviderCapabilityJSONHandler, createVoiceProviderCapabilityRoutes, renderVoiceProviderCapabilityHTML, summarizeVoiceProviderCapabilities } from './providerCapabilities';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
 export { createVoiceQualityRoutes, evaluateVoiceQuality, renderVoiceQualityHTML } from './qualityRoutes';
 export { createVoiceResilienceRoutes, createVoiceRoutingDecisionSummary, listVoiceRoutingEvents, renderVoiceResilienceHTML, summarizeVoiceRoutingDecision } from './resilienceRoutes';
@@ -50,13 +51,14 @@ export type { VoiceWorkflowContract, VoiceWorkflowContractDefinition, VoiceWorkf
 export type { VoiceSessionListHTMLHandlerOptions, VoiceSessionListItem, VoiceSessionListOptions, VoiceSessionListRoutesOptions, VoiceSessionListStatus, VoiceSessionReplay, VoiceSessionReplayHTMLHandlerOptions, VoiceSessionReplayOptions, VoiceSessionReplayRoutesOptions, VoiceSessionReplayTurn } from './sessionReplay';
 export type { AnthropicVoiceAssistantModelOptions, GeminiVoiceAssistantModelOptions, OpenAIVoiceAssistantModelOptions, VoiceProviderRouterEvent, VoiceProviderRouterFallbackMode, VoiceProviderRouterHealthOptions, VoiceProviderRouterOptions, VoiceProviderRouterPolicy, VoiceProviderRouterPolicyPreset, VoiceProviderRouterPolicyWeights, VoiceProviderRouterProviderHealth, VoiceProviderRouterProviderProfile, VoiceProviderRouterStrategy, VoiceJSONAssistantModelHandler, VoiceJSONAssistantModelOptions } from './modelAdapters';
 export type { VoiceProviderHealthStatus, VoiceProviderHealthSummary, VoiceProviderHealthSummaryOptions } from './providerHealth';
+export type { VoiceProviderCapabilityDefinition, VoiceProviderCapabilityHandlerOptions, VoiceProviderCapabilityHTMLHandlerOptions, VoiceProviderCapabilityKind, VoiceProviderCapabilityOptions, VoiceProviderCapabilityReport, VoiceProviderCapabilityRoutesOptions, VoiceProviderCapabilitySummary } from './providerCapabilities';
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 export type { VoiceQualityLink, VoiceQualityMetric, VoiceQualityReport, VoiceQualityRoutesOptions, VoiceQualityStatus, VoiceQualityThresholds } from './qualityRoutes';
 export type { VoiceResilienceIOSimulator, VoiceResilienceLink, VoiceResiliencePageData, VoiceResilienceRoutesOptions, VoiceResilienceSimulationProvider, VoiceRoutingDecisionSummary, VoiceRoutingDecisionSummaryOptions, VoiceRoutingEvent, VoiceRoutingEventKind } from './resilienceRoutes';
 export type { VoiceIOProviderRouterEvent, VoiceIOProviderRouterOptions, VoiceIOProviderRouterPolicy, VoiceIOProviderRouterPolicyConfig, VoiceSTTProviderRouterOptions, VoiceTTSProviderRouterOptions } from './providerAdapters';
 export type { VoiceAgent, VoiceAgentMessage, VoiceAgentMessageRole, VoiceAgentModel, VoiceAgentModelInput, VoiceAgentModelOutput, VoiceAgentOptions, VoiceAgentRunResult, VoiceAgentSquadOptions, VoiceAgentTool, VoiceAgentToolCall, VoiceAgentToolResult } from './agent';
 export type { VoiceToolRetryDelay, VoiceToolRuntime, VoiceToolRuntimeExecuteInput, VoiceToolRuntimeOptions, VoiceToolRuntimeResult } from './toolRuntime';
-export type { VoiceToolContractCase, VoiceToolContractCaseReport, VoiceToolContractDefinition, VoiceToolContractExpectation, VoiceToolContractIssue, VoiceToolContractReport } from './toolContract';
+export type { VoiceToolContractCase, VoiceToolContractCaseReport, VoiceToolContractDefinition, VoiceToolContractExpectation, VoiceToolContractHandlerOptions, VoiceToolContractHTMLHandlerOptions, VoiceToolContractIssue, VoiceToolContractReport, VoiceToolContractRoutesOptions, VoiceToolContractSuiteReport } from './toolContract';
 export type { VoiceOpsRuntime, VoiceOpsRuntimeConfig, VoiceOpsRuntimeSummary, VoiceOpsRuntimeSinkWorkerConfig, VoiceOpsRuntimeTaskWorkerConfig, VoiceOpsRuntimeTickResult, VoiceOpsRuntimeWebhookWorkerConfig } from './opsRuntime';
 export type { VoiceOpsPresetName, VoiceOpsPresetOverrides, VoiceResolvedOpsPreset } from './opsPresets';
 export type { VoiceOutcomeRecipe, VoiceOutcomeRecipeName, VoiceOutcomeRecipeOptions } from './outcomeRecipes';

package/dist/index.js

@@ -5474,7 +5474,7 @@ var voice = (config) => {
   }).use(htmxRoutes());
 };
 // src/appKit.ts
-import { Elysia as Elysia11 } from "elysia";
+import { Elysia as Elysia12 } from "elysia";
 
 // src/assistantHealth.ts
 import { Elysia as Elysia3 } from "elysia";
@@ -9186,6 +9186,117 @@ var createVoiceOpsConsoleRoutes = (options) => {
   return routes;
 };
 
+// src/providerCapabilities.ts
+import { Elysia as Elysia11 } from "elysia";
+var escapeHtml13 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var fromProviderList = (kind, providers, options) => (providers ?? []).map((provider) => ({
+  configured: true,
+  features: options.features?.[provider],
+  kind,
+  model: options.models?.[provider],
+  provider,
+  selected: options.selected?.[kind] === provider
+}));
+var resolveCapabilityDefinitions = (options) => {
+  const definitions = [
+    ...fromProviderList("llm", options.llmProviders, options),
+    ...fromProviderList("stt", options.sttProviders, options),
+    ...fromProviderList("tts", options.ttsProviders, options),
+    ...options.providers ?? []
+  ];
+  const seen = new Set;
+  return definitions.filter((definition) => {
+    const key = `${definition.kind}:${definition.provider}`;
+    if (seen.has(key)) {
+      return false;
+    }
+    seen.add(key);
+    return true;
+  });
+};
+var summarizeVoiceProviderCapabilities = async (options) => {
+  const definitions = resolveCapabilityDefinitions(options);
+  const providerNames = [...new Set(definitions.map((entry) => entry.provider))];
+  const health = await summarizeVoiceProviderHealth({
+    events: options.events,
+    now: options.now,
+    providers: providerNames,
+    store: options.store
+  });
+  const healthByProvider = new Map(health.map((entry) => [entry.provider, entry]));
+  const capabilities = definitions.map((definition) => {
+    const configured = definition.configured !== false;
+    const providerHealth = healthByProvider.get(definition.provider);
+    const selected = definition.selected === true || options.selected?.[definition.kind] === definition.provider;
+    const status = !configured ? "unconfigured" : selected ? "selected" : providerHealth?.status ?? "idle";
+    return {
+      ...definition,
+      configured,
+      features: definition.features ?? options.features?.[definition.provider],
+      health: providerHealth,
+      model: definition.model ?? options.models?.[definition.provider],
+      selected,
+      status
+    };
+  });
+  return {
+    capabilities,
+    checkedAt: Date.now(),
+    configured: capabilities.filter((entry) => entry.configured).length,
+    selected: capabilities.filter((entry) => entry.selected).length,
+    total: capabilities.length,
+    unconfigured: capabilities.filter((entry) => !entry.configured).length
+  };
+};
+var renderVoiceProviderCapabilityHTML = (report, options = {}) => {
+  const title = options.title ?? "Voice Provider Capabilities";
+  const cards = report.capabilities.map((capability) => {
+    const features = (capability.features ?? []).map((feature) => `<span class="pill">${escapeHtml13(feature)}</span>`).join("");
+    return `<article class="card ${escapeHtml13(capability.status)}">
+  <div class="card-header">
+    <div>
+      <p class="eyebrow">${escapeHtml13(capability.kind)}</p>
+      <h2>${escapeHtml13(capability.label ?? capability.provider)}</h2>
+    </div>
+    <strong>${escapeHtml13(capability.status)}</strong>
+  </div>
+  ${capability.description ? `<p>${escapeHtml13(capability.description)}</p>` : ""}
+  <dl>
+    <div><dt>Configured</dt><dd>${capability.configured ? "yes" : "no"}</dd></div>
+    <div><dt>Selected</dt><dd>${capability.selected ? "yes" : "no"}</dd></div>
+    <div><dt>Model</dt><dd>${escapeHtml13(capability.model ?? "default")}</dd></div>
+    <div><dt>Runs</dt><dd>${String(capability.health?.runCount ?? 0)}</dd></div>
+    <div><dt>Errors</dt><dd>${String(capability.health?.errorCount ?? 0)}</dd></div>
+  </dl>
+  ${features ? `<div class="features">${features}</div>` : ""}
+</article>`;
+  }).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml13(title)}</title><style>body{background:#101316;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.hero,.card{background:#181d22;border:1px solid #2a323a;border-radius:20px;margin-bottom:16px;padding:20px}.hero{background:linear-gradient(135deg,rgba(14,165,233,.16),rgba(34,197,94,.12))}.eyebrow{color:#7dd3fc;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.3rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}h2{margin:.2rem 0 1rem}.summary,.features{display:flex;flex-wrap:wrap;gap:10px}.pill{background:#0f1217;border:1px solid #3f3f46;border-radius:999px;padding:7px 10px}.grid{display:grid;gap:16px;grid-template-columns:repeat(auto-fit,minmax(260px,1fr))}.card-header{align-items:flex-start;display:flex;gap:16px;justify-content:space-between}.selected,.healthy{color:#86efac}.unconfigured,.degraded,.rate-limited,.suppressed{color:#fca5a5}.idle,.recoverable{color:#fde68a}dl{display:grid;gap:8px;grid-template-columns:repeat(2,minmax(0,1fr))}dt{color:#a8b0b8;font-size:.8rem}dd{margin:0}@media(max-width:800px){main{padding:18px}.card-header{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Provider Discovery</p><h1>${escapeHtml13(title)}</h1><div class="summary"><span class="pill">${String(report.configured)} configured</span><span class="pill">${String(report.selected)} selected</span><span class="pill">${String(report.unconfigured)} missing</span><span class="pill">${String(report.total)} total</span></div></section><section class="grid">${cards || '<article class="card"><p>No provider capabilities configured.</p></article>'}</section></main></body></html>`;
+};
+var createVoiceProviderCapabilityJSONHandler = (options) => async () => summarizeVoiceProviderCapabilities(options);
+var createVoiceProviderCapabilityHTMLHandler = (options) => async () => {
+  const report = await summarizeVoiceProviderCapabilities(options);
+  const render = options.render ?? ((input) => renderVoiceProviderCapabilityHTML(input, options));
+  const body = await render(report);
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/html; charset=utf-8",
+      ...options.headers
+    }
+  });
+};
+var createVoiceProviderCapabilityRoutes = (options) => {
+  const path = options.path ?? "/api/provider-capabilities";
+  const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
+  const routes = new Elysia11({
+    name: options.name ?? "absolutejs-voice-provider-capabilities"
+  }).get(path, createVoiceProviderCapabilityJSONHandler(options));
+  if (htmlPath) {
+    routes.get(htmlPath, createVoiceProviderCapabilityHTMLHandler(options));
+  }
+  return routes;
+};
+
 // src/appKit.ts
 var DEFAULT_LINKS2 = [
   {
@@ -9342,7 +9453,7 @@ var summarizeVoiceAppKitStatus = async (options) => {
   };
 };
 var createVoiceAppKitRoutes = (options) => {
-  const routes = new Elysia11({
+  const routes = new Elysia12({
     name: options.name ?? "absolutejs-voice-app-kit"
   });
   const links = resolveLinks(options.links);
@@ -9362,6 +9473,19 @@ var createVoiceAppKitRoutes = (options) => {
       ...options.providerHealth
     }));
   }
+  if (options.providerCapabilities !== false) {
+    surfaces.push("providerCapabilities");
+    routes.use(createVoiceProviderCapabilityRoutes({
+      ...common,
+      htmlPath: "/provider-capabilities",
+      llmProviders: options.llmProviders,
+      path: "/api/provider-capabilities",
+      sttProviders: options.sttProviders,
+      title: options.title ? `${options.title} Provider Capabilities` : undefined,
+      ttsProviders: options.ttsProviders,
+      ...options.providerCapabilities
+    }));
+  }
   if (options.assistantHealth !== false) {
     surfaces.push("assistantHealth");
     routes.use(createVoiceAssistantHealthRoutes({
@@ -9947,6 +10071,7 @@ var createVoiceToolIdempotencyKey = (input) => {
   ].join(":");
 };
 // src/toolContract.ts
+import { Elysia as Elysia13 } from "elysia";
 var createDefaultSession = (contractId, caseId) => createVoiceSessionRecord(`tool-contract-${contractId}-${caseId}`);
 var createDefaultTurn = (caseId) => ({
   committedAt: Date.now(),
@@ -9956,6 +10081,7 @@ var createDefaultTurn = (caseId) => ({
 });
 var defaultApi = {};
 var sameJSON = (left, right) => JSON.stringify(left) === JSON.stringify(right);
+var escapeHtml14 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var evaluateExpectation = (input) => {
   const issues = [];
   const expect = input.expect;
@@ -10075,6 +10201,7 @@ var runVoiceToolContract = async (definition) => {
   return {
     cases,
     contractId: definition.id,
+    label: definition.label,
     issues,
     pass: issues.length === 0,
     toolName: definition.tool.name
@@ -10103,6 +10230,70 @@ var createVoiceToolRuntimeContractDefaults = () => ({
   maxRetries: 1,
   timeoutMs: 5000
 });
+var runVoiceToolContractSuite = async (options) => {
+  const contracts = await Promise.all(options.contracts.map((contract) => runVoiceToolContract(contract)));
+  const passed = contracts.filter((contract) => contract.pass).length;
+  const failed = contracts.length - passed;
+  return {
+    checkedAt: Date.now(),
+    contracts,
+    failed,
+    passed,
+    status: failed > 0 ? "fail" : "pass",
+    total: contracts.length
+  };
+};
+var renderVoiceToolContractHTML = (report, options = {}) => {
+  const title = options.title ?? "Voice Tool Contracts";
+  const contracts = report.contracts.map((contract) => {
+    const cases = contract.cases.map((testCase) => `<tr>
+  <td>${escapeHtml14(testCase.label ?? testCase.caseId)}</td>
+  <td class="${testCase.pass ? "pass" : "fail"}">${testCase.pass ? "pass" : "fail"}</td>
+  <td>${escapeHtml14(testCase.status)}</td>
+  <td>${String(testCase.attempts)}</td>
+  <td>${String(testCase.elapsedMs)}ms</td>
+  <td>${testCase.timedOut ? "yes" : "no"}</td>
+  <td>${escapeHtml14(testCase.issues.map((issue) => issue.message).join(" ") || testCase.error || "")}</td>
+</tr>`).join("");
+    return `<section class="contract ${contract.pass ? "pass" : "fail"}">
+  <div class="contract-header">
+    <div>
+      <p class="eyebrow">${escapeHtml14(contract.toolName)}</p>
+      <h2>${escapeHtml14(contract.label ?? contract.contractId)}</h2>
+    </div>
+    <strong class="${contract.pass ? "pass" : "fail"}">${contract.pass ? "Passing" : "Failing"}</strong>
+  </div>
+  <table>
+    <thead><tr><th>Case</th><th>Status</th><th>Result</th><th>Attempts</th><th>Elapsed</th><th>Timed out</th><th>Issues</th></tr></thead>
+    <tbody>${cases}</tbody>
+  </table>
+</section>`;
+  }).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml14(title)}</title><style>body{background:#101316;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.hero,.contract{background:#181d22;border:1px solid #2a323a;border-radius:20px;margin-bottom:16px;padding:20px}.hero{background:linear-gradient(135deg,rgba(34,197,94,.14),rgba(245,158,11,.12))}.eyebrow{color:#fbbf24;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.3rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{background:#0f1217;border:1px solid #3f3f46;border-radius:999px;padding:7px 10px}.contract-header{align-items:flex-start;display:flex;gap:16px;justify-content:space-between}h2{margin:.2rem 0 1rem}.pass{color:#86efac}.fail{color:#fca5a5}.contract.fail{border-color:rgba(248,113,113,.45)}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #2a323a;padding:12px;text-align:left;vertical-align:top}th{color:#a8b0b8;font-size:.82rem}@media(max-width:800px){main{padding:18px}table{display:block;overflow:auto}.contract-header{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Tool Reliability</p><h1>${escapeHtml14(title)}</h1><div class="summary"><span class="pill ${report.status === "pass" ? "pass" : "fail"}">${escapeHtml14(report.status)}</span><span class="pill">${String(report.passed)} passing</span><span class="pill">${String(report.failed)} failing</span><span class="pill">${String(report.total)} contracts</span></div></section>${contracts || '<section class="contract"><p>No tool contracts configured.</p></section>'}</main></body></html>`;
+};
+var createVoiceToolContractJSONHandler = (options) => () => runVoiceToolContractSuite(options);
+var createVoiceToolContractHTMLHandler = (options) => async () => {
+  const report = await runVoiceToolContractSuite(options);
+  const render = options.render ?? ((input) => renderVoiceToolContractHTML(input, options));
+  const body = await render(report);
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/html; charset=utf-8",
+      ...options.headers
+    }
+  });
+};
+var createVoiceToolContractRoutes = (options) => {
+  const path = options.path ?? "/api/tool-contracts";
+  const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
+  const routes = new Elysia13({
+    name: options.name ?? "absolutejs-voice-tool-contracts"
+  }).get(path, createVoiceToolContractJSONHandler(options));
+  if (htmlPath) {
+    routes.get(htmlPath, createVoiceToolContractHTMLHandler(options));
+  }
+  return routes;
+};
 // src/fileStore.ts
 import { mkdir as mkdir2, readFile, readdir, rename, rm, writeFile } from "fs/promises";
 import { join } from "path";
@@ -12196,7 +12387,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia12 } from "elysia";
+import { Elysia as Elysia14 } from "elysia";
 var toHex5 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder = new TextEncoder;
@@ -12326,7 +12517,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia12().post(path, async ({ body, request, set }) => {
+  return new Elysia14().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -14479,6 +14670,7 @@ export {
   summarizeVoiceSessionReplay,
   summarizeVoiceRoutingDecision,
   summarizeVoiceProviderHealth,
+  summarizeVoiceProviderCapabilities,
   summarizeVoiceOpsTasks,
   summarizeVoiceOpsTaskQueue,
   summarizeVoiceOpsTaskAnalytics,
@@ -14491,6 +14683,7 @@ export {
   startVoiceOpsTask,
   shapeTelephonyAssistantText,
   selectVoiceTraceEventsForPrune,
+  runVoiceToolContractSuite,
   runVoiceToolContract,
   runVoiceSessionEvals,
   runVoiceScenarioFixtureEvals,
@@ -14512,12 +14705,14 @@ export {
   reopenVoiceOpsTask,
   renderVoiceTraceMarkdown,
   renderVoiceTraceHTML,
+  renderVoiceToolContractHTML,
   renderVoiceSessionsHTML,
   renderVoiceScenarioFixtureEvalHTML,
   renderVoiceScenarioEvalHTML,
   renderVoiceResilienceHTML,
   renderVoiceQualityHTML,
   renderVoiceProviderHealthHTML,
+  renderVoiceProviderCapabilityHTML,
   renderVoiceOpsConsoleHTML,
   renderVoiceHandoffHealthHTML,
   renderVoiceEvalHTML,
@@ -14573,6 +14768,9 @@ export {
   createVoiceToolRuntimeContractDefaults,
   createVoiceToolRuntime,
   createVoiceToolIdempotencyKey,
+  createVoiceToolContractRoutes,
+  createVoiceToolContractJSONHandler,
+  createVoiceToolContractHTMLHandler,
   createVoiceToolContract,
   createVoiceTaskUpdatedEvent,
   createVoiceTaskSLABreachedEvent,
@@ -14607,6 +14805,9 @@ export {
   createVoiceProviderHealthRoutes,
   createVoiceProviderHealthJSONHandler,
   createVoiceProviderHealthHTMLHandler,
+  createVoiceProviderCapabilityRoutes,
+  createVoiceProviderCapabilityJSONHandler,
+  createVoiceProviderCapabilityHTMLHandler,
   createVoicePostgresTraceSinkDeliveryStore,
   createVoicePostgresTraceEventStore,
   createVoicePostgresTaskStore,

package/dist/providerCapabilities.d.ts

@@ -0,0 +1,92 @@
+import { Elysia } from 'elysia';
+import { type VoiceProviderHealthStatus, type VoiceProviderHealthSummary, type VoiceProviderHealthSummaryOptions } from './providerHealth';
+export type VoiceProviderCapabilityKind = 'llm' | 'stt' | 'tts' | 'custom';
+export type VoiceProviderCapabilityDefinition<TProvider extends string = string> = {
+    configured?: boolean;
+    description?: string;
+    features?: string[];
+    kind: VoiceProviderCapabilityKind;
+    label?: string;
+    model?: string;
+    provider: TProvider;
+    selected?: boolean;
+};
+export type VoiceProviderCapabilitySummary<TProvider extends string = string> = VoiceProviderCapabilityDefinition<TProvider> & {
+    configured: boolean;
+    health?: VoiceProviderHealthSummary<TProvider>;
+    status: VoiceProviderHealthStatus | 'selected' | 'unconfigured';
+};
+export type VoiceProviderCapabilityReport<TProvider extends string = string> = {
+    capabilities: VoiceProviderCapabilitySummary<TProvider>[];
+    checkedAt: number;
+    configured: number;
+    selected: number;
+    total: number;
+    unconfigured: number;
+};
+export type VoiceProviderCapabilityOptions<TProvider extends string = string> = VoiceProviderHealthSummaryOptions<TProvider> & {
+    features?: Partial<Record<TProvider, string[]>>;
+    llmProviders?: readonly TProvider[];
+    models?: Partial<Record<TProvider, string>>;
+    providers?: readonly VoiceProviderCapabilityDefinition<TProvider>[];
+    selected?: Partial<Record<VoiceProviderCapabilityKind, TProvider>>;
+    sttProviders?: readonly TProvider[];
+    ttsProviders?: readonly TProvider[];
+};
+export type VoiceProviderCapabilityHandlerOptions<TProvider extends string = string> = VoiceProviderCapabilityOptions<TProvider>;
+export type VoiceProviderCapabilityHTMLHandlerOptions<TProvider extends string = string> = VoiceProviderCapabilityHandlerOptions<TProvider> & {
+    headers?: HeadersInit;
+    render?: (report: VoiceProviderCapabilityReport<TProvider>) => string | Promise<string>;
+    title?: string;
+};
+export type VoiceProviderCapabilityRoutesOptions<TProvider extends string = string> = VoiceProviderCapabilityHTMLHandlerOptions<TProvider> & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
+export declare const summarizeVoiceProviderCapabilities: <TProvider extends string = string>(options: VoiceProviderCapabilityOptions<TProvider>) => Promise<VoiceProviderCapabilityReport<TProvider>>;
+export declare const renderVoiceProviderCapabilityHTML: <TProvider extends string = string>(report: VoiceProviderCapabilityReport<TProvider>, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceProviderCapabilityJSONHandler: <TProvider extends string = string>(options: VoiceProviderCapabilityHandlerOptions<TProvider>) => () => Promise<VoiceProviderCapabilityReport<TProvider>>;
+export declare const createVoiceProviderCapabilityHTMLHandler: <TProvider extends string = string>(options: VoiceProviderCapabilityHTMLHandlerOptions<TProvider>) => () => Promise<Response>;
+export declare const createVoiceProviderCapabilityRoutes: <TProvider extends string = string>(options: VoiceProviderCapabilityRoutesOptions<TProvider>) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoiceProviderCapabilityReport<TProvider>;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/toolContract.d.ts

@@ -1,3 +1,4 @@
+import { Elysia } from 'elysia';
 import type { VoiceAgentTool } from './agent';
 import { type VoiceToolRuntimeOptions } from './toolRuntime';
 import type { VoiceSessionRecord, VoiceTurnRecord } from './types';
@@ -48,10 +49,32 @@ export type VoiceToolContractCaseReport = {
 export type VoiceToolContractReport = {
     cases: VoiceToolContractCaseReport[];
     contractId: string;
+    label?: string;
     issues: VoiceToolContractIssue[];
     pass: boolean;
     toolName: string;
 };
+export type VoiceToolContractSuiteReport = {
+    checkedAt: number;
+    contracts: VoiceToolContractReport[];
+    failed: number;
+    passed: number;
+    status: 'fail' | 'pass';
+    total: number;
+};
+export type VoiceToolContractHandlerOptions = {
+    contracts: VoiceToolContractDefinition[];
+};
+export type VoiceToolContractHTMLHandlerOptions = VoiceToolContractHandlerOptions & {
+    headers?: HeadersInit;
+    render?: (report: VoiceToolContractSuiteReport) => string | Promise<string>;
+    title?: string;
+};
+export type VoiceToolContractRoutesOptions = VoiceToolContractHTMLHandlerOptions & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
 export declare const runVoiceToolContract: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TArgs = Record<string, unknown>, TToolResult = unknown, TRouteResult = unknown>(definition: VoiceToolContractDefinition<TContext, TSession, TArgs, TToolResult, TRouteResult>) => Promise<VoiceToolContractReport>;
 export declare const createVoiceToolContract: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TArgs = Record<string, unknown>, TToolResult = unknown, TRouteResult = unknown>(definition: VoiceToolContractDefinition<TContext, TSession, TArgs, TToolResult, TRouteResult>) => {
     assert: () => Promise<VoiceToolContractReport>;
@@ -59,3 +82,49 @@ export declare const createVoiceToolContract: <TContext = unknown, TSession exte
     run: () => Promise<VoiceToolContractReport>;
 };
 export declare const createVoiceToolRuntimeContractDefaults: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TRouteResult = unknown>() => VoiceToolRuntimeOptions<TContext, TSession, TRouteResult>;
+export declare const runVoiceToolContractSuite: (options: VoiceToolContractHandlerOptions) => Promise<VoiceToolContractSuiteReport>;
+export declare const renderVoiceToolContractHTML: (report: VoiceToolContractSuiteReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceToolContractJSONHandler: (options: VoiceToolContractHandlerOptions) => () => Promise<VoiceToolContractSuiteReport>;
+export declare const createVoiceToolContractHTMLHandler: (options: VoiceToolContractHTMLHandlerOptions) => () => Promise<Response>;
+export declare const createVoiceToolContractRoutes: (options: VoiceToolContractRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoiceToolContractSuiteReport;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/package.json

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