@absolutejs/voice 0.0.22-beta.432 → 0.0.22-beta.434

package/dist/incidentTimeline.d.ts

@@ -10,6 +10,30 @@ export type VoiceIncidentTimelineAction = {
     label: string;
     method?: 'GET' | 'POST';
 };
+export type VoiceIncidentRecoveryAction = {
+    detail?: string;
+    disabled?: boolean;
+    eventId?: string;
+    href?: string;
+    id: string;
+    label: string;
+    method?: 'GET' | 'POST';
+    sessionId?: string;
+};
+export type VoiceIncidentRecoveryActionResult = {
+    actionId: string;
+    detail?: string;
+    href?: string;
+    ok: boolean;
+    status?: string;
+};
+export type VoiceIncidentRecoveryActionHandlerInput = {
+    action: VoiceIncidentRecoveryAction;
+    actionId: string;
+    report: VoiceIncidentTimelineReport;
+    request: Request;
+};
+export type VoiceIncidentRecoveryActionHandler = (input: VoiceIncidentRecoveryActionHandlerInput) => Promise<VoiceIncidentRecoveryActionResult> | VoiceIncidentRecoveryActionResult;
 export type VoiceIncidentTimelineEvent = {
     action?: VoiceIncidentTimelineAction;
     at: number;
@@ -24,6 +48,7 @@ export type VoiceIncidentTimelineEvent = {
     value?: number | string;
 };
 export type VoiceIncidentTimelineReport = {
+    actions: VoiceIncidentRecoveryAction[];
     events: VoiceIncidentTimelineEvent[];
     generatedAt: number;
     links: VoiceIncidentTimelineLinks;
@@ -57,9 +82,15 @@ export type VoiceIncidentTimelineOptions = {
     operationalStatus?: VoiceIncidentTimelineValue<VoiceOperationalStatusReport>;
     operationsRecords?: VoiceIncidentTimelineValue<readonly VoiceOperationsRecord[]>;
     opsRecovery?: VoiceIncidentTimelineValue<VoiceOpsRecoveryReport>;
+    recoveryActions?: readonly VoiceIncidentRecoveryAction[] | ((input: {
+        events: readonly VoiceIncidentTimelineEvent[];
+        report: Omit<VoiceIncidentTimelineReport, 'actions'>;
+    }) => Promise<readonly VoiceIncidentRecoveryAction[]> | readonly VoiceIncidentRecoveryAction[]);
     windowMs?: number;
 };
 export type VoiceIncidentTimelineRoutesOptions = VoiceIncidentTimelineOptions & {
+    actionHandlers?: Record<string, VoiceIncidentRecoveryActionHandler>;
+    actionPath?: false | string;
     headers?: HeadersInit;
     htmlPath?: false | string;
     markdownPath?: false | string;
@@ -73,6 +104,7 @@ export declare const renderVoiceIncidentTimelineMarkdown: (report: VoiceIncident
     title?: string;
 }) => string;
 export declare const renderVoiceIncidentTimelineHTML: (report: VoiceIncidentTimelineReport, options?: {
+    actionPath?: string;
     title?: string;
 }) => string;
 export declare const createVoiceIncidentTimelineRoutes: (options: VoiceIncidentTimelineRoutesOptions) => Elysia<"", {

package/dist/index.d.ts

@@ -60,7 +60,7 @@ export type { VoiceDeliverySinkDescriptor, VoiceDeliverySinkDescriptorInput, Voi
 export type { VoiceOpsActionAuditRecord, VoiceOpsActionAuditRoutesOptions, VoiceOpsActionHistoryEntry, VoiceOpsActionHistoryReport } from './opsActionAuditRoutes';
 export type { VoiceDeliveryRuntime, VoiceDeliveryRuntimeAuditConfig, VoiceDeliveryRuntimeConfig, VoiceDeliveryRuntimeFilePresetOptions, VoiceDeliveryRuntimePresetLeaseConfig, VoiceDeliveryRuntimePresetMode, VoiceDeliveryRuntimePresetOptions, VoiceDeliveryRuntimeReport, VoiceDeliveryRuntimeRoutesOptions, VoiceDeliveryRuntimeS3PresetOptions, VoiceDeliveryRuntimeSummary, VoiceDeliveryRuntimeTickResult, VoiceDeliveryRuntimeTraceConfig, VoiceDeliveryRuntimeWebhookPresetOptions } from './deliveryRuntime';
 export type { VoiceOperationalStatus, VoiceOperationalStatusCheck, VoiceOperationalStatusOptions, VoiceOperationalStatusReport, VoiceOperationalStatusRoutesOptions, VoiceOperationalStatusValue } from './operationalStatus';
-export type { VoiceIncidentTimelineAction, VoiceIncidentTimelineEvent, VoiceIncidentTimelineLinks, VoiceIncidentTimelineOptions, VoiceIncidentTimelineReport, VoiceIncidentTimelineRoutesOptions, VoiceIncidentTimelineSeverity, VoiceIncidentTimelineStatus, VoiceIncidentTimelineValue } from './incidentTimeline';
+export type { VoiceIncidentRecoveryAction, VoiceIncidentRecoveryActionHandler, VoiceIncidentRecoveryActionHandlerInput, VoiceIncidentRecoveryActionResult, VoiceIncidentTimelineAction, VoiceIncidentTimelineEvent, VoiceIncidentTimelineLinks, VoiceIncidentTimelineOptions, VoiceIncidentTimelineReport, VoiceIncidentTimelineRoutesOptions, VoiceIncidentTimelineSeverity, VoiceIncidentTimelineStatus, VoiceIncidentTimelineValue } from './incidentTimeline';
 export { compareVoiceEvalBaseline, createVoiceFileEvalBaselineStore, createVoiceFileScenarioFixtureStore, createVoiceEvalRoutes, renderVoiceEvalBaselineHTML, renderVoiceEvalHTML, renderVoiceScenarioEvalHTML, renderVoiceScenarioFixtureEvalHTML, runVoiceScenarioEvals, runVoiceScenarioFixtureEvals, runVoiceSessionEvals } from './evalRoutes';
 export { assertVoiceSimulationSuiteEvidence, createVoiceSimulationSuiteRoutes, evaluateVoiceSimulationSuiteEvidence, renderVoiceSimulationSuiteHTML, runVoiceSimulationSuite } from './simulationSuite';
 export { createVoiceWorkflowContract, createVoiceWorkflowContractHandler, createVoiceWorkflowContractPreset, createVoiceWorkflowScenario, recordVoiceWorkflowContractTrace, validateVoiceWorkflowRouteResult } from './workflowContract';

package/dist/index.js

@@ -30127,6 +30127,61 @@ var statusToSeverity = (status) => status === "fail" || status === "failed" ? "c
 var failureReplayStatusToSeverity = (status) => status === "failed" ? "critical" : status === "healthy" ? "info" : "warn";
 var withinWindow = (event, now, windowMs) => !windowMs || event.at >= now - windowMs;
 var eventStatus2 = (event) => event.severity === "critical" ? "fail" : event.severity === "warn" ? "warn" : "pass";
+var defaultIncidentRecoveryActions = (events, links) => {
+  const actions = [];
+  const add = (action) => {
+    const key = `${action.id}:${action.sessionId ?? ""}:${action.href ?? ""}`;
+    if (actions.some((existing) => `${existing.id}:${existing.sessionId ?? ""}:${existing.href ?? ""}` === key)) {
+      return;
+    }
+    actions.push(action);
+  };
+  for (const event of events) {
+    if (event.category === "delivery") {
+      add({
+        detail: "Ask the app to tick delivery workers or retry failed delivery queue work.",
+        eventId: event.id,
+        href: links.deliveryRuntime,
+        id: "delivery.retry",
+        label: "Retry delivery work",
+        method: "POST",
+        sessionId: event.sessionId
+      });
+    }
+    if (event.category === "readiness" || event.category === "operational-status") {
+      add({
+        detail: "Refresh production readiness and proof freshness before declaring the incident resolved.",
+        eventId: event.id,
+        href: links.productionReadiness ?? links.operationalStatus,
+        id: "readiness.refresh",
+        label: "Refresh readiness proof",
+        method: "POST",
+        sessionId: event.sessionId
+      });
+    }
+    if (event.sessionId) {
+      add({
+        detail: "Generate or open a support/debug artifact for the affected call.",
+        eventId: event.id,
+        href: linkForSession(links.supportBundle, event.sessionId) ?? linkForSession(links.callDebugger, event.sessionId),
+        id: "support.bundle",
+        label: "Generate support bundle",
+        method: "POST",
+        sessionId: event.sessionId
+      });
+    }
+  }
+  if (events.some((event) => event.severity !== "info")) {
+    add({
+      detail: "Rerun the app proof pack to confirm the current release evidence is fresh.",
+      href: links.proofPack,
+      id: "proof.rerun",
+      label: "Rerun proof pack",
+      method: "POST"
+    });
+  }
+  return actions;
+};
 var worstStatus3 = (statuses) => statuses.includes("fail") ? "fail" : statuses.includes("warn") ? "warn" : "pass";
 var pushOperationalStatusEvents = (events, report, links) => {
   if (!report) {
@@ -30304,7 +30359,7 @@ var buildVoiceIncidentTimelineReport = async (options) => {
     total: filtered.length,
     warn: filtered.filter((event) => event.severity === "warn").length
   };
-  return {
+  const baseReport = {
     events: filtered,
     generatedAt: now,
     links,
@@ -30312,6 +30367,14 @@ var buildVoiceIncidentTimelineReport = async (options) => {
     summary,
     windowMs: options.windowMs
   };
+  const configuredActions = typeof options.recoveryActions === "function" ? await options.recoveryActions({
+    events: filtered,
+    report: baseReport
+  }) : options.recoveryActions;
+  return {
+    ...baseReport,
+    actions: configuredActions === undefined ? defaultIncidentRecoveryActions(filtered, links) : [...configuredActions]
+  };
 };
 var renderVoiceIncidentTimelineMarkdown = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Incident Timeline";
@@ -30334,10 +30397,16 @@ Summary: ${report.summary.critical} critical, ${report.summary.warn} warn, ${rep
 ## Events
 
 ${rows || "- No incident timeline events."}
+
+## Recovery Actions
+
+${report.actions.map((action) => `- ${action.method ?? "GET"} ${action.id}: ${action.label}${action.href ? ` (${action.href})` : ""}${action.detail ? ` - ${action.detail}` : ""}`).join(`
+`) || "- No recovery actions."}
 `;
 };
 var renderVoiceIncidentTimelineHTML = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Incident Timeline";
+  const actionPath = options.actionPath ?? "/api/voice/incident-timeline/actions";
   const events = report.events.map((event) => `<article class="${escapeHtml43(event.severity)}">
   <span>${escapeHtml43(event.severity.toUpperCase())} / ${escapeHtml43(event.category)}</span>
   <h2>${escapeHtml43(event.label)}</h2>
@@ -30346,12 +30415,20 @@ var renderVoiceIncidentTimelineHTML = (report, options = {}) => {
   ${event.detail ? `<p>${escapeHtml43(event.detail)}</p>` : ""}
   <div>${event.href ? `<a href="${escapeHtml43(event.href)}">Open source</a>` : ""}${event.action?.href ? `<a href="${escapeHtml43(event.action.href)}">${escapeHtml43(event.action.label)}</a>` : ""}</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>${escapeHtml43(title)}</title><style>body{background:#11110d;color:#faf4df;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1100px;padding:32px}.hero{background:linear-gradient(135deg,rgba(248,113,113,.2),rgba(245,158,11,.13),rgba(34,197,94,.12));border:1px solid #39301d;border-radius:30px;margin-bottom:18px;padding:28px}.eyebrow{color:#fcd34d;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}.status{border:1px solid #575030;border-radius:999px;display:inline-flex;font-weight:900;padding:8px 12px}.status.pass{border-color:rgba(34,197,94,.65)}.status.warn{border-color:rgba(245,158,11,.75)}.status.fail{border-color:rgba(239,68,68,.85)}.grid{display:grid;gap:14px}.summary{display:flex;flex-wrap:wrap;gap:10px}.summary span{background:#181711;border:1px solid #39301d;border-radius:999px;padding:8px 12px}article{background:#181711;border:1px solid #39301d;border-radius:22px;padding:18px}article.critical{border-color:rgba(239,68,68,.85)}article.warn{border-color:rgba(245,158,11,.75)}article.info{border-color:rgba(34,197,94,.55)}article span{color:#fcd34d;font-size:.78rem;font-weight:900;letter-spacing:.08em}article h2{margin:.35rem 0}.muted,article p{color:#cfc5a8}article strong{display:block;font-size:1.3rem;margin:.5rem 0}a{color:#fde68a;margin-right:12px}</style></head><body><main><section class="hero"><p class="eyebrow">Operational triage</p><h1>${escapeHtml43(title)}</h1><p class="status ${escapeHtml43(report.status)}">Overall: ${escapeHtml43(report.status.toUpperCase())}</p><p class="muted">Generated ${escapeHtml43(new Date(report.generatedAt).toLocaleString())}</p><div class="summary"><span>${String(report.summary.critical)} critical</span><span>${String(report.summary.warn)} warn</span><span>${String(report.summary.info)} info</span><span>${String(report.summary.total)} total</span></div></section><section class="grid">${events || '<article class="info"><span>INFO</span><h2>No incident events</h2><p>No non-pass operational events were found in this window.</p></article>'}</section></main></body></html>`;
+  const actions = report.actions.map((action) => {
+    const label = escapeHtml43(action.label);
+    const detail = action.detail ? `<p>${escapeHtml43(action.detail)}</p>` : "";
+    const href = action.href ? `<a href="${escapeHtml43(action.href)}">Open target</a>` : "";
+    const control = action.method === "POST" ? `<button type="button" data-voice-incident-action="${escapeHtml43(action.id)}" ${action.disabled ? "disabled" : ""}>${label}</button>` : href;
+    return `<article class="action"><span>${escapeHtml43(action.method ?? "GET")}</span><h2>${label}</h2>${detail}<div>${control}${href && action.method === "POST" ? href : ""}</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>${escapeHtml43(title)}</title><style>body{background:#11110d;color:#faf4df;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1100px;padding:32px}.hero{background:linear-gradient(135deg,rgba(248,113,113,.2),rgba(245,158,11,.13),rgba(34,197,94,.12));border:1px solid #39301d;border-radius:30px;margin-bottom:18px;padding:28px}.eyebrow{color:#fcd34d;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}.status{border:1px solid #575030;border-radius:999px;display:inline-flex;font-weight:900;padding:8px 12px}.status.pass{border-color:rgba(34,197,94,.65)}.status.warn{border-color:rgba(245,158,11,.75)}.status.fail{border-color:rgba(239,68,68,.85)}.grid{display:grid;gap:14px}.actions{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));margin:0 0 18px}.summary{display:flex;flex-wrap:wrap;gap:10px}.summary span{background:#181711;border:1px solid #39301d;border-radius:999px;padding:8px 12px}article{background:#181711;border:1px solid #39301d;border-radius:22px;padding:18px}article.critical{border-color:rgba(239,68,68,.85)}article.warn{border-color:rgba(245,158,11,.75)}article.info{border-color:rgba(34,197,94,.55)}article.action{border-color:#5b4a22}article span{color:#fcd34d;font-size:.78rem;font-weight:900;letter-spacing:.08em}article h2{margin:.35rem 0}.muted,article p{color:#cfc5a8}article strong{display:block;font-size:1.3rem;margin:.5rem 0}a{color:#fde68a;margin-right:12px}button{background:#fcd34d;border:0;border-radius:999px;color:#171307;cursor:pointer;font-weight:900;padding:10px 14px}button:disabled{cursor:not-allowed;opacity:.55}</style></head><body><main><section class="hero"><p class="eyebrow">Operational triage</p><h1>${escapeHtml43(title)}</h1><p class="status ${escapeHtml43(report.status)}">Overall: ${escapeHtml43(report.status.toUpperCase())}</p><p class="muted">Generated ${escapeHtml43(new Date(report.generatedAt).toLocaleString())}</p><div class="summary"><span>${String(report.summary.critical)} critical</span><span>${String(report.summary.warn)} warn</span><span>${String(report.summary.info)} info</span><span>${String(report.summary.total)} total</span></div></section><h2>Recovery actions</h2><section class="actions">${actions || '<article class="action"><span>NONE</span><h2>No recovery actions</h2><p>No executable actions are available for this report.</p></article>'}</section><h2>Timeline</h2><section class="grid">${events || '<article class="info"><span>INFO</span><h2>No incident events</h2><p>No non-pass operational events were found in this window.</p></article>'}</section></main><script>const voiceIncidentActionPath=${JSON.stringify(actionPath)};document.querySelectorAll("[data-voice-incident-action]").forEach((button)=>{button.addEventListener("click",async()=>{const id=button.getAttribute("data-voice-incident-action");if(!id)return;button.disabled=true;const original=button.textContent;button.textContent="Running...";try{const response=await fetch(voiceIncidentActionPath+"/"+encodeURIComponent(id),{method:"POST"});button.textContent=response.ok?"Done":"Failed";if(response.ok)setTimeout(()=>location.reload(),700)}catch{button.textContent="Failed"}finally{setTimeout(()=>{button.disabled=false;button.textContent=original},1600)}})});</script></body></html>`;
 };
 var createVoiceIncidentTimelineRoutes = (options) => {
   const path = options.path ?? "/api/voice/incident-timeline";
   const htmlPath = options.htmlPath === undefined ? "/voice/incident-timeline" : options.htmlPath;
   const markdownPath = options.markdownPath === undefined ? "/voice/incident-timeline.md" : options.markdownPath;
+  const actionPath = options.actionPath === undefined ? "/api/voice/incident-timeline/actions" : options.actionPath;
   const routes = new Elysia46({
     name: options.name ?? "absolutejs-voice-incident-timeline"
   }).get(path, async () => {
@@ -30367,7 +30444,10 @@ var createVoiceIncidentTimelineRoutes = (options) => {
   if (htmlPath !== false) {
     routes.get(htmlPath, async () => {
       const report = await buildVoiceIncidentTimelineReport(options);
-      const body = await (options.render ?? ((input) => renderVoiceIncidentTimelineHTML(input, { title: options.title })))(report);
+      const body = await (options.render ?? ((input) => renderVoiceIncidentTimelineHTML(input, {
+        actionPath: actionPath === false ? undefined : actionPath,
+        title: options.title
+      })))(report);
       return new Response(body, {
         headers: {
           "Content-Type": "text/html; charset=utf-8",
@@ -30389,6 +30469,65 @@ var createVoiceIncidentTimelineRoutes = (options) => {
       });
     });
   }
+  if (actionPath !== false) {
+    routes.get(actionPath, async () => {
+      const report = await buildVoiceIncidentTimelineReport(options);
+      return new Response(JSON.stringify({
+        actions: report.actions,
+        generatedAt: report.generatedAt,
+        status: report.status
+      }), {
+        headers: {
+          "Content-Type": "application/json; charset=utf-8",
+          ...options.headers
+        }
+      });
+    }).post(`${actionPath}/:actionId`, async ({ params, request }) => {
+      const actionId = params.actionId;
+      const report = await buildVoiceIncidentTimelineReport(options);
+      const action = report.actions.find((item) => item.id === actionId);
+      const handler = options.actionHandlers?.[actionId];
+      if (!action) {
+        return new Response(JSON.stringify({
+          actionId,
+          ok: false,
+          status: "not_found"
+        }), {
+          headers: {
+            "Content-Type": "application/json; charset=utf-8",
+            ...options.headers
+          },
+          status: 404
+        });
+      }
+      if (action.disabled || action.method !== "POST" || !handler) {
+        return new Response(JSON.stringify({
+          actionId,
+          ok: false,
+          status: action.disabled ? "disabled" : "not_executable"
+        }), {
+          headers: {
+            "Content-Type": "application/json; charset=utf-8",
+            ...options.headers
+          },
+          status: 409
+        });
+      }
+      const result = await handler({
+        action,
+        actionId,
+        report,
+        request
+      });
+      return new Response(JSON.stringify(result), {
+        headers: {
+          "Content-Type": "application/json; charset=utf-8",
+          ...options.headers
+        },
+        status: result.ok ? 200 : 500
+      });
+    });
+  }
   return routes;
 };
 // src/dataControl.ts

package/package.json

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