@absolutejs/voice 0.0.22-beta.202 → 0.0.22-beta.204

package/dist/index.js

@@ -14095,6 +14095,17 @@ import { Elysia as Elysia21 } from "elysia";
 // src/outcomeContract.ts
 import { Elysia as Elysia19 } from "elysia";
 var escapeHtml21 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var resolveSessionHref2 = (value, sessionId) => {
+  if (value === false) {
+    return;
+  }
+  const href = value ?? "/voice-operations/:sessionId";
+  if (typeof href === "function") {
+    return href(sessionId);
+  }
+  const encoded = encodeURIComponent(sessionId);
+  return href.includes(":sessionId") ? href.replace(":sessionId", encoded) : `${href.replace(/\/$/, "")}/${encoded}`;
+};
 var getPayloadString = (event, key) => typeof event.payload[key] === "string" ? event.payload[key] : undefined;
 var toList = async (input) => Array.isArray(input) ? input : await input?.list() ?? [];
 var hydrateSessions = async (input) => {
@@ -14118,6 +14129,7 @@ var reportContract = (input) => {
   const { contract } = input;
   const sessions = input.sessions.filter((session) => (!contract.scenarioId || session.scenarioId === contract.scenarioId) && matchesDisposition(dispositionForSession(session), contract.expectedDisposition));
   const sessionIds = new Set(sessions.map((session) => session.id));
+  const operationsRecordHrefs = [...sessionIds].map((sessionId) => resolveSessionHref2(input.operationsRecordHref, sessionId)).filter((href) => Boolean(href));
   const reviews = input.reviews.filter((review) => matchesDisposition(review.summary.outcome, contract.expectedDisposition));
   const tasks = input.tasks.filter((task) => matchesDisposition(task.outcome, contract.expectedDisposition));
   const handoffs = input.handoffs.filter((handoff) => (!contract.expectedDisposition || handoff.action === contract.expectedDisposition || contract.expectedDisposition === "transferred" && handoff.action === "transfer" || contract.expectedDisposition === "escalated" && handoff.action === "escalate") && (sessionIds.size === 0 || sessionIds.has(handoff.sessionId)));
@@ -14174,7 +14186,9 @@ var reportContract = (input) => {
       sessions: sessions.length,
       tasks: tasks.length
     },
-    pass: issues.length === 0
+    operationsRecordHrefs,
+    pass: issues.length === 0,
+    sessionIds: [...sessionIds]
   };
 };
 var runVoiceOutcomeContractSuite = async (options) => {
@@ -14185,7 +14199,15 @@ var runVoiceOutcomeContractSuite = async (options) => {
     toList(options.events),
     toList(options.handoffs)
   ]);
-  const contracts = options.contracts.map((contract) => reportContract({ contract, events, handoffs, reviews, sessions, tasks }));
+  const contracts = options.contracts.map((contract) => reportContract({
+    contract,
+    events,
+    handoffs,
+    operationsRecordHref: options.operationsRecordHref,
+    reviews,
+    sessions,
+    tasks
+  }));
   const passed = contracts.filter((contract) => contract.pass).length;
   const failed = contracts.length - passed;
   return {
@@ -14199,12 +14221,15 @@ var runVoiceOutcomeContractSuite = async (options) => {
 };
 var renderVoiceOutcomeContractHTML = (report, options = {}) => {
   const title = options.title ?? "Voice Outcome Contracts";
-  const contracts = report.contracts.map((contract) => `<section class="contract ${contract.pass ? "pass" : "fail"}">
+  const contracts = report.contracts.map((contract) => {
+    const sessionLinks = contract.operationsRecordHrefs.length ? `<p>${contract.operationsRecordHrefs.map((href, index) => `<a href="${escapeHtml21(href)}">${escapeHtml21(contract.sessionIds[index] ?? href)}</a>`).join(" \xB7 ")}</p>` : "";
+    return `<section class="contract ${contract.pass ? "pass" : "fail"}">
   <div class="contract-header">
     <div>
       <p class="eyebrow">${escapeHtml21(contract.contractId)}</p>
       <h2>${escapeHtml21(contract.label ?? contract.contractId)}</h2>
       ${contract.description ? `<p>${escapeHtml21(contract.description)}</p>` : ""}
+      ${sessionLinks}
     </div>
     <strong>${contract.pass ? "pass" : "fail"}</strong>
   </div>
@@ -14216,7 +14241,8 @@ var renderVoiceOutcomeContractHTML = (report, options = {}) => {
     <span>events ${String(contract.matched.integrationEvents)}</span>
   </div>
   ${contract.issues.length ? `<ul>${contract.issues.map((issue) => `<li>${escapeHtml21(issue.message)}</li>`).join("")}</ul>` : ""}
-</section>`).join("");
+</section>`;
+  }).join("");
   return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml21(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(14,165,233,.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}.summary,.grid{display:flex;flex-wrap:wrap;gap:10px}.pill,.grid span{background:#0f1217;border:1px solid #3f3f46;border-radius:999px;padding:7px 10px}.contract-header{display:flex;gap:16px;justify-content:space-between}.pass{color:#86efac}.fail{color:#fca5a5}.contract.fail{border-color:rgba(248,113,113,.45)}li{margin:8px 0}@media(max-width:800px){main{padding:18px}.contract-header{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Business Outcome Verification</p><h1>${escapeHtml21(title)}</h1><div class="summary"><span class="pill ${report.status}">${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 outcome contracts configured.</p></section>'}</main></body></html>`;
 };
 var createVoiceOutcomeContractJSONHandler = (options) => async () => runVoiceOutcomeContractSuite(options);
@@ -14453,6 +14479,17 @@ var createDefaultTurn = (caseId) => ({
 var defaultApi = {};
 var sameJSON = (left, right) => JSON.stringify(left) === JSON.stringify(right);
 var escapeHtml22 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var resolveSessionHref3 = (value, sessionId) => {
+  if (value === false) {
+    return;
+  }
+  const href = value ?? "/voice-operations/:sessionId";
+  if (typeof href === "function") {
+    return href(sessionId);
+  }
+  const encoded = encodeURIComponent(sessionId);
+  return href.includes(":sessionId") ? href.replace(":sessionId", encoded) : `${href.replace(/\/$/, "")}/${encoded}`;
+};
 var evaluateExpectation = (input) => {
   const issues = [];
   const expect = input.expect;
@@ -14503,7 +14540,7 @@ var evaluateExpectation = (input) => {
   }
   return issues;
 };
-var runVoiceToolContract = async (definition) => {
+var runVoiceToolContract = async (definition, options = {}) => {
   const cases = [];
   for (const testCase of definition.cases) {
     const session = testCase.session ?? createDefaultSession(definition.id, testCase.id);
@@ -14563,7 +14600,9 @@ var runVoiceToolContract = async (definition) => {
       error: result.error,
       issues: issues2,
       label: testCase.label,
+      operationsRecordHref: resolveSessionHref3(options.operationsRecordHref, session.id),
       pass: issues2.length === 0,
+      sessionId: session.id,
       status: result.status,
       timedOut: result.timedOut
     });
@@ -14602,7 +14641,7 @@ var createVoiceToolRuntimeContractDefaults = () => ({
   timeoutMs: 5000
 });
 var runVoiceToolContractSuite = async (options) => {
-  const contracts = await Promise.all(options.contracts.map((contract) => runVoiceToolContract(contract)));
+  const contracts = await Promise.all(options.contracts.map((contract) => runVoiceToolContract(contract, options)));
   const passed = contracts.filter((contract) => contract.pass).length;
   const failed = contracts.length - passed;
   return {
@@ -14642,9 +14681,10 @@ var renderVoiceToolContractHTML = (report, options = {}) => {
 );`);
   const contracts = report.contracts.map((contract) => {
     const cases = contract.cases.map((testCase) => `<tr>
-  <td>${escapeHtml22(testCase.label ?? testCase.caseId)}</td>
+  <td>${testCase.operationsRecordHref ? `<a href="${escapeHtml22(testCase.operationsRecordHref)}">${escapeHtml22(testCase.label ?? testCase.caseId)}</a>` : escapeHtml22(testCase.label ?? testCase.caseId)}</td>
   <td class="${testCase.pass ? "pass" : "fail"}">${testCase.pass ? "pass" : "fail"}</td>
   <td>${escapeHtml22(testCase.status)}</td>
+  <td>${escapeHtml22(testCase.sessionId)}</td>
   <td>${String(testCase.attempts)}</td>
   <td>${String(testCase.elapsedMs)}ms</td>
   <td>${testCase.timedOut ? "yes" : "no"}</td>
@@ -14659,7 +14699,7 @@ var renderVoiceToolContractHTML = (report, options = {}) => {
     <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>
+    <thead><tr><th>Case</th><th>Status</th><th>Result</th><th>Session</th><th>Attempts</th><th>Elapsed</th><th>Timed out</th><th>Issues</th></tr></thead>
     <tbody>${cases}</tbody>
   </table>
 </section>`;
@@ -14705,7 +14745,7 @@ var collectSimulationActions = (input) => {
     const firstFailed = input.sessions.sessions.find((session) => session.status === "fail");
     actions.push({
       description: firstFailed ? `Inspect session ${firstFailed.sessionId}; at least one quality metric is outside threshold.` : "Inspect failing session quality reports.",
-      href: input.links?.sessions,
+      href: firstFailed?.operationsRecordHref ?? input.links?.sessions,
       label: "Review failing session quality",
       section: "sessions",
       severity: "error"
@@ -14716,9 +14756,10 @@ var collectSimulationActions = (input) => {
       continue;
     }
     const issue = scenario.issues[0] ?? scenario.sessions.find((session) => session.issues.length > 0)?.issues[0] ?? "Scenario did not meet its expected trace conditions.";
+    const failedSession = scenario.sessions.find((session) => session.status === "fail");
     actions.push({
       description: `${scenario.label}: ${issue}`,
-      href: input.links?.scenarios,
+      href: failedSession?.operationsRecordHref ?? input.links?.scenarios,
       label: `Fix scenario ${scenario.label}`,
       section: "scenarios",
       severity: "error"
@@ -14729,9 +14770,10 @@ var collectSimulationActions = (input) => {
       continue;
     }
     const failedScenario = fixture.report.scenarios.find((scenario) => scenario.status === "fail");
+    const failedSession = failedScenario?.sessions.find((session) => session.status === "fail");
     actions.push({
       description: failedScenario ? `${fixture.label}: ${failedScenario.label} failed.` : `${fixture.label}: fixture simulation failed.`,
-      href: input.links?.fixtures,
+      href: failedSession?.operationsRecordHref ?? input.links?.fixtures,
       label: `Update fixture ${fixture.label}`,
       section: "fixtures",
       severity: "error"
@@ -14774,16 +14816,19 @@ var runVoiceSimulationSuite = async (options) => {
   const [sessions, scenarios, fixtures, tools, outcomes] = await Promise.all([
     shouldRunSessions ? runVoiceSessionEvals({
       limit: options.limit,
+      operationsRecordHref: options.operationsRecordHref,
       store: options.store,
       thresholds: options.thresholds
     }) : undefined,
     shouldRunScenarios ? runVoiceScenarioEvals({
+      operationsRecordHref: options.operationsRecordHref,
       scenarios: options.scenarios,
       store: options.store
     }) : undefined,
     shouldRunFixtures ? runVoiceScenarioFixtureEvals({
       fixtures: options.fixtures,
       fixtureStore: options.fixtureStore,
+      operationsRecordHref: options.operationsRecordHref,
       scenarios: options.scenarios
     }) : undefined,
     shouldRunTools ? runVoiceToolContractSuite({
@@ -15191,7 +15236,7 @@ var escapeHtml24 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&l
 var increment4 = (record, key) => {
   record[key] = (record[key] ?? 0) + 1;
 };
-var resolveSessionHref2 = (value, session) => {
+var resolveSessionHref4 = (value, session) => {
   if (value === false) {
     return;
   }
@@ -15355,7 +15400,7 @@ var summarizeVoiceSessions = async (options = {}) => {
     const replayHref = options.replayHref === false ? "" : typeof options.replayHref === "function" ? options.replayHref(item) : `${options.replayHref ?? "/api/voice-sessions"}/${encodeURIComponent(sessionId)}/replay/htmx`;
     return {
       ...item,
-      operationsRecordHref: resolveSessionHref2(options.operationsRecordHref, item),
+      operationsRecordHref: resolveSessionHref4(options.operationsRecordHref, item),
       replayHref
     };
   });
@@ -23980,7 +24025,7 @@ var eventStatus = (event) => firstString3(event.payload, [
   "reason"
 ]);
 var eventElapsedMs2 = (event) => firstNumber3(event.payload, ["elapsedMs", "latencyMs", "durationMs"]);
-var resolveSessionHref3 = (value, sessionId) => {
+var resolveSessionHref5 = (value, sessionId) => {
   if (value === false) {
     return;
   }
@@ -24110,7 +24155,7 @@ var summarizeVoiceTraceTimeline = (events, options = {}) => {
         type: event.type
       })),
       lastEventAt: sorted.at(-1)?.at,
-      operationsRecordHref: resolveSessionHref3(options.operationsRecordHref, sessionId),
+      operationsRecordHref: resolveSessionHref5(options.operationsRecordHref, sessionId),
       providers: summarizeProviders(sorted),
       sessionId,
       startedAt: summary.startedAt,

package/dist/outcomeContract.d.ts

@@ -32,7 +32,9 @@ export type VoiceOutcomeContractReport = {
         sessions: number;
         tasks: number;
     };
+    operationsRecordHrefs: string[];
     pass: boolean;
+    sessionIds: string[];
 };
 export type VoiceOutcomeContractSuiteReport = {
     checkedAt: number;
@@ -49,6 +51,7 @@ export type VoiceOutcomeContractOptions<TSession extends VoiceSessionRecord = Vo
     contracts: VoiceOutcomeContractDefinition[];
     events?: StoredVoiceIntegrationEvent[] | ListStore<StoredVoiceIntegrationEvent>;
     handoffs?: StoredVoiceHandoffDelivery[] | VoiceHandoffDeliveryStore;
+    operationsRecordHref?: false | string | ((sessionId: string) => string);
     reviews?: StoredVoiceCallReviewArtifact[] | ListStore<StoredVoiceCallReviewArtifact>;
     sessions?: TSession[] | VoiceSessionStore<TSession>;
     tasks?: StoredVoiceOpsTask[] | ListStore<StoredVoiceOpsTask>;

package/dist/simulationSuite.d.ts

@@ -57,6 +57,7 @@ export type VoiceSimulationSuiteOptions<TSession extends VoiceSessionRecord = Vo
         tools?: boolean;
     };
     limit?: number;
+    operationsRecordHref?: false | string | ((sessionId: string) => string);
     outcomes?: Omit<VoiceOutcomeContractOptions<TSession>, 'contracts'> & {
         contracts: VoiceOutcomeContractDefinition[];
     };

package/dist/toolContract.d.ts

@@ -42,7 +42,9 @@ export type VoiceToolContractCaseReport = {
     error?: string;
     issues: VoiceToolContractIssue[];
     label?: string;
+    operationsRecordHref?: string;
     pass: boolean;
+    sessionId: string;
     status: 'error' | 'ok';
     timedOut: boolean;
 };
@@ -64,6 +66,7 @@ export type VoiceToolContractSuiteReport = {
 };
 export type VoiceToolContractHandlerOptions = {
     contracts: VoiceToolContractDefinition[];
+    operationsRecordHref?: false | string | ((sessionId: string) => string);
 };
 export type VoiceToolContractHTMLHandlerOptions = VoiceToolContractHandlerOptions & {
     headers?: HeadersInit;
@@ -75,7 +78,7 @@ export type VoiceToolContractRoutesOptions = VoiceToolContractHTMLHandlerOptions
     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 runVoiceToolContract: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TArgs = Record<string, unknown>, TToolResult = unknown, TRouteResult = unknown>(definition: VoiceToolContractDefinition<TContext, TSession, TArgs, TToolResult, TRouteResult>, options?: Pick<VoiceToolContractHandlerOptions, "operationsRecordHref">) => 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>;
     definition: VoiceToolContractDefinition<TContext, TSession, TArgs, TToolResult, TRouteResult>;

package/package.json

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