@absolutejs/voice 0.0.22-beta.152 → 0.0.22-beta.153

package/README.md

@@ -653,6 +653,8 @@ export function DeliveryWorkers() {
 }
 ```
 
+The widget includes operator actions by default: `Tick workers` drains pending/failed deliveries, and `Requeue dead letters` moves reviewed dead-lettered audit/trace deliveries back into the live queues. Pass `includeActions={false}` when you only want a read-only status card.
+
 ```ts
 import { VoiceDeliveryRuntime } from '@absolutejs/voice/vue';
 import { createVoiceDeliveryRuntime } from '@absolutejs/voice/svelte';

package/dist/angular/index.js

@@ -197,6 +197,12 @@ let _VoiceOpsStatusService = VoiceOpsStatusService;
 import { computed as computed2, Injectable as Injectable2, signal as signal2 } from "@angular/core";
 
 // src/client/deliveryRuntime.ts
+var getDefaultActionPath = (path, action, options) => {
+  if (action === "tick") {
+    return options.tickPath ?? `${path.replace(/\/$/, "")}/tick`;
+  }
+  return options.requeueDeadLettersPath ?? `${path.replace(/\/$/, "")}/requeue-dead-letters`;
+};
 var fetchVoiceDeliveryRuntime = async (path = "/api/voice-delivery-runtime", options = {}) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
   const response = await fetchImpl(path);
@@ -205,11 +211,29 @@ var fetchVoiceDeliveryRuntime = async (path = "/api/voice-delivery-runtime", opt
   }
   return await response.json();
 };
+var runVoiceDeliveryRuntimeAction = async (action, path = "/api/voice-delivery-runtime", options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(getDefaultActionPath(path, action, options), {
+    method: "POST"
+  });
+  if (!response.ok) {
+    throw new Error(`Voice delivery runtime ${action} failed: HTTP ${response.status}`);
+  }
+  const body = await response.json();
+  return {
+    action,
+    result: body.result,
+    summary: body.summary,
+    updatedAt: Date.now()
+  };
+};
 var createVoiceDeliveryRuntimeStore = (path = "/api/voice-delivery-runtime", options = {}) => {
   const listeners = new Set;
   let closed = false;
   let timer;
   let snapshot = {
+    actionError: null,
+    actionStatus: "idle",
     error: null,
     isLoading: false
   };
@@ -231,6 +255,7 @@ var createVoiceDeliveryRuntimeStore = (path = "/api/voice-delivery-runtime", opt
     try {
       const report = await fetchVoiceDeliveryRuntime(path, options);
       snapshot = {
+        ...snapshot,
         error: null,
         isLoading: false,
         report,
@@ -248,6 +273,37 @@ var createVoiceDeliveryRuntimeStore = (path = "/api/voice-delivery-runtime", opt
       throw error;
     }
   };
+  const runAction = async (action) => {
+    if (closed) {
+      return snapshot.lastAction;
+    }
+    snapshot = {
+      ...snapshot,
+      actionError: null,
+      actionStatus: "running"
+    };
+    emit();
+    try {
+      const result = await runVoiceDeliveryRuntimeAction(action, path, options);
+      snapshot = {
+        ...snapshot,
+        actionError: null,
+        actionStatus: "completed",
+        lastAction: result
+      };
+      emit();
+      await refresh();
+      return result;
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        actionError: error instanceof Error ? error.message : String(error),
+        actionStatus: "failed"
+      };
+      emit();
+      throw error;
+    }
+  };
   const close = () => {
     closed = true;
     if (timer) {
@@ -265,7 +321,9 @@ var createVoiceDeliveryRuntimeStore = (path = "/api/voice-delivery-runtime", opt
     close,
     getServerSnapshot: () => snapshot,
     getSnapshot: () => snapshot,
+    requeueDeadLetters: () => runAction("requeue-dead-letters"),
     refresh,
+    tick: () => runAction("tick"),
     subscribe: (listener) => {
       listeners.add(listener);
       return () => {
@@ -284,12 +342,16 @@ var _init = __decoratorStart(undefined);
 class VoiceDeliveryRuntimeService {
   connect(path = "/api/voice-delivery-runtime", options = {}) {
     const store = createVoiceDeliveryRuntimeStore(path, options);
+    const actionErrorSignal = signal2(null);
+    const actionStatusSignal = signal2("idle");
     const errorSignal = signal2(null);
     const isLoadingSignal = signal2(false);
     const reportSignal = signal2(undefined);
     const updatedAtSignal = signal2(undefined);
     const sync = () => {
       const snapshot = store.getSnapshot();
+      actionErrorSignal.set(snapshot.actionError);
+      actionStatusSignal.set(snapshot.actionStatus);
       errorSignal.set(snapshot.error);
       isLoadingSignal.set(snapshot.isLoading);
       reportSignal.set(snapshot.report);
@@ -306,9 +368,13 @@ class VoiceDeliveryRuntimeService {
         store.close();
       },
       error: computed2(() => errorSignal()),
+      actionError: computed2(() => actionErrorSignal()),
+      actionStatus: computed2(() => actionStatusSignal()),
       isLoading: computed2(() => isLoadingSignal()),
+      requeueDeadLetters: store.requeueDeadLetters,
       refresh: store.refresh,
       report: computed2(() => reportSignal()),
+      tick: store.tick,
       updatedAt: computed2(() => updatedAtSignal())
     };
   }
@@ -2817,6 +2883,8 @@ var createVoiceDeliveryRuntimeViewModel = (snapshot, options = {}) => {
   return {
     description: options.description ?? DEFAULT_DESCRIPTION,
     error: snapshot.error,
+    actionError: snapshot.actionError,
+    actionStatus: snapshot.actionStatus,
     isLoading: snapshot.isLoading,
     isRunning: Boolean(report?.isRunning),
     label: snapshot.error ? "Unavailable" : report ? report.isRunning ? "Running" : "Stopped" : "Checking",
@@ -2833,6 +2901,11 @@ var renderVoiceDeliveryRuntimeHTML = (snapshot, options = {}) => {
   <strong>${escapeHtml(surface.detail)}</strong>
   <small>${String(surface.failed)} failed &middot; ${String(surface.deadLettered)} dead-lettered</small>
 </li>`).join("");
+  const actions = options.includeActions === false ? "" : `<div class="absolute-voice-delivery-runtime__actions">
+  <button type="button" data-absolute-voice-delivery-runtime-action="tick">${model.actionStatus === "running" ? "Working..." : "Tick workers"}</button>
+  <button type="button" data-absolute-voice-delivery-runtime-action="requeue-dead-letters"${model.surfaces.some((surface) => surface.deadLettered > 0) ? "" : " disabled"}>Requeue dead letters</button>
+</div>`;
+  const actionError = model.actionError ? `<p class="absolute-voice-delivery-runtime__error">${escapeHtml(model.actionError)}</p>` : "";
   return `<section class="absolute-voice-delivery-runtime absolute-voice-delivery-runtime--${escapeHtml(model.status)}">
   <header class="absolute-voice-delivery-runtime__header">
     <span class="absolute-voice-delivery-runtime__eyebrow">${escapeHtml(model.title)}</span>
@@ -2840,20 +2913,38 @@ var renderVoiceDeliveryRuntimeHTML = (snapshot, options = {}) => {
   </header>
   <p class="absolute-voice-delivery-runtime__description">${escapeHtml(model.description)}</p>
   <ul class="absolute-voice-delivery-runtime__surfaces">${surfaces}</ul>
+  ${actions}
+  ${actionError}
   ${model.error ? `<p class="absolute-voice-delivery-runtime__error">${escapeHtml(model.error)}</p>` : ""}
 </section>`;
 };
-var getVoiceDeliveryRuntimeCSS = () => `.absolute-voice-delivery-runtime{border:1px solid #c9d8cf;border-radius:20px;background:#f6fff9;color:#0d1b12;padding:18px;box-shadow:0 18px 40px rgba(19,55,35,.12);font-family:inherit}.absolute-voice-delivery-runtime--warn,.absolute-voice-delivery-runtime--error{border-color:#f2b56b;background:#fff9ed}.absolute-voice-delivery-runtime__header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-delivery-runtime__eyebrow{color:#4e6b59;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-delivery-runtime__label{font-size:28px;line-height:1}.absolute-voice-delivery-runtime__description{color:#33483b;margin:12px 0 0}.absolute-voice-delivery-runtime__surfaces{display:grid;gap:8px;list-style:none;margin:16px 0 0;padding:0}.absolute-voice-delivery-runtime__surface{background:#fff;border:1px solid #d9eadf;border-radius:14px;display:grid;gap:4px;padding:10px 12px}.absolute-voice-delivery-runtime__surface--warn{border-color:#f2b56b}.absolute-voice-delivery-runtime__surface--disabled{opacity:.72}.absolute-voice-delivery-runtime__surface span,.absolute-voice-delivery-runtime__surface small{color:#587063}.absolute-voice-delivery-runtime__error{color:#9f1239;font-weight:700}`;
+var getVoiceDeliveryRuntimeCSS = () => `.absolute-voice-delivery-runtime{border:1px solid #c9d8cf;border-radius:20px;background:#f6fff9;color:#0d1b12;padding:18px;box-shadow:0 18px 40px rgba(19,55,35,.12);font-family:inherit}.absolute-voice-delivery-runtime--warn,.absolute-voice-delivery-runtime--error{border-color:#f2b56b;background:#fff9ed}.absolute-voice-delivery-runtime__header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-delivery-runtime__eyebrow{color:#4e6b59;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-delivery-runtime__label{font-size:28px;line-height:1}.absolute-voice-delivery-runtime__description{color:#33483b;margin:12px 0 0}.absolute-voice-delivery-runtime__surfaces{display:grid;gap:8px;list-style:none;margin:16px 0 0;padding:0}.absolute-voice-delivery-runtime__surface{background:#fff;border:1px solid #d9eadf;border-radius:14px;display:grid;gap:4px;padding:10px 12px}.absolute-voice-delivery-runtime__surface--warn{border-color:#f2b56b}.absolute-voice-delivery-runtime__surface--disabled{opacity:.72}.absolute-voice-delivery-runtime__surface span,.absolute-voice-delivery-runtime__surface small{color:#587063}.absolute-voice-delivery-runtime__actions{display:flex;flex-wrap:wrap;gap:8px;margin-top:14px}.absolute-voice-delivery-runtime__actions button{background:#134e2d;border:0;border-radius:999px;color:#f6fff9;cursor:pointer;font:inherit;font-weight:800;padding:8px 12px}.absolute-voice-delivery-runtime__actions button:disabled{cursor:not-allowed;opacity:.48}.absolute-voice-delivery-runtime__error{color:#9f1239;font-weight:700}`;
 var mountVoiceDeliveryRuntime = (element, path = "/api/voice-delivery-runtime", options = {}) => {
   const store = createVoiceDeliveryRuntimeStore(path, options);
   const render = () => {
     element.innerHTML = renderVoiceDeliveryRuntimeHTML(store.getSnapshot(), options);
   };
   const unsubscribe = store.subscribe(render);
+  const handleClick = (event) => {
+    const target = event.target;
+    if (!(target instanceof Element)) {
+      return;
+    }
+    const action = target.closest("[data-absolute-voice-delivery-runtime-action]");
+    const actionName = action?.getAttribute("data-absolute-voice-delivery-runtime-action");
+    if (actionName === "tick") {
+      store.tick().catch(() => {});
+    }
+    if (actionName === "requeue-dead-letters") {
+      store.requeueDeadLetters().catch(() => {});
+    }
+  };
+  element.addEventListener?.("click", handleClick);
   render();
   store.refresh().catch(() => {});
   return {
     close: () => {
+      element.removeEventListener?.("click", handleClick);
       unsubscribe();
       store.close();
     },
@@ -2932,6 +3023,29 @@ var _dec = [
 					</li>
 				}
 			</ul>
+			<div class="absolute-voice-delivery-runtime__actions">
+				<button
+					type="button"
+					[disabled]="model().actionStatus === 'running'"
+					(click)="tick()"
+				>
+					{{ model().actionStatus === "running" ? "Working..." : "Tick workers" }}
+				</button>
+				<button
+					type="button"
+					[disabled]="
+						model().actionStatus === 'running' || deadLettered() === 0
+					"
+					(click)="requeueDeadLetters()"
+				>
+					Requeue dead letters
+				</button>
+			</div>
+			@if (model().actionError) {
+				<p class="absolute-voice-delivery-runtime__error">
+					{{ model().actionError }}
+				</p>
+			}
 			@if (model().error) {
 				<p class="absolute-voice-delivery-runtime__error">
 					{{ model().error }}
@@ -2969,6 +3083,8 @@ class VoiceDeliveryRuntimeComponent {
   cleanup = () => {};
   store;
   model = signal13(createVoiceDeliveryRuntimeViewModel({
+    actionError: null,
+    actionStatus: "idle",
     error: null,
     isLoading: true
   }));
@@ -2988,6 +3104,15 @@ class VoiceDeliveryRuntimeComponent {
     this.cleanup();
     this.store?.close();
   }
+  deadLettered() {
+    return this.model().surfaces.reduce((total, surface) => total + surface.deadLettered, 0);
+  }
+  tick() {
+    this.store?.tick().catch(() => {});
+  }
+  requeueDeadLetters() {
+    this.store?.requeueDeadLetters().catch(() => {});
+  }
   options() {
     return {
       description: this.description,

package/dist/angular/voice-delivery-runtime.component.d.ts

@@ -10,5 +10,8 @@ export declare class VoiceDeliveryRuntimeComponent implements OnDestroy, OnInit
     model: import("@angular/core").WritableSignal<VoiceDeliveryRuntimeViewModel>;
     ngOnInit(): void;
     ngOnDestroy(): void;
+    deadLettered(): number;
+    tick(): void;
+    requeueDeadLetters(): void;
     private options;
 }

package/dist/angular/voice-delivery-runtime.service.d.ts

@@ -4,9 +4,13 @@ export declare class VoiceDeliveryRuntimeService {
     connect(path?: string, options?: VoiceDeliveryRuntimeClientOptions): {
         close: () => void;
         error: import("@angular/core").Signal<string | null>;
+        actionError: import("@angular/core").Signal<string | null>;
+        actionStatus: import("@angular/core").Signal<"completed" | "failed" | "idle" | "running">;
         isLoading: import("@angular/core").Signal<boolean>;
+        requeueDeadLetters: () => Promise<import("../client").VoiceDeliveryRuntimeActionResult | undefined>;
         refresh: () => Promise<VoiceDeliveryRuntimeReport | undefined>;
         report: import("@angular/core").Signal<VoiceDeliveryRuntimeReport | undefined>;
+        tick: () => Promise<import("../client").VoiceDeliveryRuntimeActionResult | undefined>;
         updatedAt: import("@angular/core").Signal<number | undefined>;
     };
 }

package/dist/client/deliveryRuntime.d.ts

@@ -2,18 +2,33 @@ import type { VoiceDeliveryRuntimeReport } from '../deliveryRuntime';
 export type VoiceDeliveryRuntimeClientOptions = {
     fetch?: typeof fetch;
     intervalMs?: number;
+    requeueDeadLettersPath?: string;
+    tickPath?: string;
 };
 export type VoiceDeliveryRuntimeSnapshot = {
+    actionError: string | null;
+    actionStatus: 'idle' | 'running' | 'completed' | 'failed';
     error: string | null;
     isLoading: boolean;
+    lastAction?: VoiceDeliveryRuntimeActionResult;
     report?: VoiceDeliveryRuntimeReport;
     updatedAt?: number;
 };
+export type VoiceDeliveryRuntimeAction = 'tick' | 'requeue-dead-letters';
+export type VoiceDeliveryRuntimeActionResult = {
+    action: VoiceDeliveryRuntimeAction;
+    result?: unknown;
+    summary?: VoiceDeliveryRuntimeReport['summary'];
+    updatedAt: number;
+};
 export declare const fetchVoiceDeliveryRuntime: (path?: string, options?: Pick<VoiceDeliveryRuntimeClientOptions, "fetch">) => Promise<VoiceDeliveryRuntimeReport>;
+export declare const runVoiceDeliveryRuntimeAction: (action: VoiceDeliveryRuntimeAction, path?: string, options?: VoiceDeliveryRuntimeClientOptions) => Promise<VoiceDeliveryRuntimeActionResult>;
 export declare const createVoiceDeliveryRuntimeStore: (path?: string, options?: VoiceDeliveryRuntimeClientOptions) => {
     close: () => void;
     getServerSnapshot: () => VoiceDeliveryRuntimeSnapshot;
     getSnapshot: () => VoiceDeliveryRuntimeSnapshot;
+    requeueDeadLetters: () => Promise<VoiceDeliveryRuntimeActionResult | undefined>;
     refresh: () => Promise<VoiceDeliveryRuntimeReport | undefined>;
+    tick: () => Promise<VoiceDeliveryRuntimeActionResult | undefined>;
     subscribe: (listener: () => void) => () => void;
 };

package/dist/client/deliveryRuntimeWidget.d.ts

@@ -12,6 +12,8 @@ export type VoiceDeliveryRuntimeSurfaceView = {
 export type VoiceDeliveryRuntimeViewModel = {
     description: string;
     error: string | null;
+    actionError: string | null;
+    actionStatus: VoiceDeliveryRuntimeSnapshot['actionStatus'];
     isLoading: boolean;
     isRunning: boolean;
     label: string;
@@ -22,6 +24,7 @@ export type VoiceDeliveryRuntimeViewModel = {
 };
 export type VoiceDeliveryRuntimeWidgetOptions = VoiceDeliveryRuntimeClientOptions & {
     description?: string;
+    includeActions?: boolean;
     title?: string;
 };
 export declare const createVoiceDeliveryRuntimeViewModel: (snapshot: VoiceDeliveryRuntimeSnapshot, options?: VoiceDeliveryRuntimeWidgetOptions) => VoiceDeliveryRuntimeViewModel;

package/dist/client/index.d.ts

@@ -8,7 +8,7 @@ export { createMicrophoneCapture } from './microphone';
 export { createVoiceBargeInMonitor } from './bargeInMonitor';
 export { createVoiceLiveTurnLatencyMonitor } from './liveTurnLatency';
 export { createVoiceOpsStatusStore, fetchVoiceOpsStatus } from './opsStatus';
-export { createVoiceDeliveryRuntimeStore, fetchVoiceDeliveryRuntime } from './deliveryRuntime';
+export { createVoiceDeliveryRuntimeStore, fetchVoiceDeliveryRuntime, runVoiceDeliveryRuntimeAction } from './deliveryRuntime';
 export { createVoiceOpsStatusViewModel, defineVoiceOpsStatusElement, getVoiceOpsStatusCSS, getVoiceOpsStatusLabel, mountVoiceOpsStatus, renderVoiceOpsStatusHTML } from './opsStatusWidget';
 export { createVoiceDeliveryRuntimeViewModel, defineVoiceDeliveryRuntimeElement, getVoiceDeliveryRuntimeCSS, mountVoiceDeliveryRuntime, renderVoiceDeliveryRuntimeHTML } from './deliveryRuntimeWidget';
 export { createVoiceRoutingStatusStore, fetchVoiceRoutingStatus } from './routingStatus';
@@ -28,7 +28,7 @@ export { createVoiceTurnLatencyViewModel, defineVoiceTurnLatencyElement, mountVo
 export { createVoiceTraceTimelineViewModel, defineVoiceTraceTimelineElement, getVoiceTraceTimelineCSS, mountVoiceTraceTimeline, renderVoiceTraceTimelineWidgetHTML } from './traceTimelineWidget';
 export { createVoiceWorkflowStatusStore, fetchVoiceWorkflowStatus } from './workflowStatus';
 export type { VoiceOpsStatusClientOptions, VoiceOpsStatusSnapshot } from './opsStatus';
-export type { VoiceDeliveryRuntimeClientOptions, VoiceDeliveryRuntimeSnapshot } from './deliveryRuntime';
+export type { VoiceDeliveryRuntimeClientOptions, VoiceDeliveryRuntimeAction, VoiceDeliveryRuntimeActionResult, VoiceDeliveryRuntimeSnapshot } from './deliveryRuntime';
 export type { VoiceBargeInMonitorOptions } from './bargeInMonitor';
 export type { VoiceLiveTurnLatencyEvent, VoiceLiveTurnLatencyMonitorOptions, VoiceLiveTurnLatencySnapshot, VoiceLiveTurnLatencyStatus } from './liveTurnLatency';
 export type { VoiceOpsStatusSurfaceView, VoiceOpsStatusViewModel, VoiceOpsStatusWidgetOptions } from './opsStatusWidget';

package/dist/client/index.js

@@ -2063,6 +2063,12 @@ var createVoiceOpsStatusStore = (path = "/api/voice/ops-status", options = {}) =
   };
 };
 // src/client/deliveryRuntime.ts
+var getDefaultActionPath = (path, action, options) => {
+  if (action === "tick") {
+    return options.tickPath ?? `${path.replace(/\/$/, "")}/tick`;
+  }
+  return options.requeueDeadLettersPath ?? `${path.replace(/\/$/, "")}/requeue-dead-letters`;
+};
 var fetchVoiceDeliveryRuntime = async (path = "/api/voice-delivery-runtime", options = {}) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
   const response = await fetchImpl(path);
@@ -2071,11 +2077,29 @@ var fetchVoiceDeliveryRuntime = async (path = "/api/voice-delivery-runtime", opt
   }
   return await response.json();
 };
+var runVoiceDeliveryRuntimeAction = async (action, path = "/api/voice-delivery-runtime", options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(getDefaultActionPath(path, action, options), {
+    method: "POST"
+  });
+  if (!response.ok) {
+    throw new Error(`Voice delivery runtime ${action} failed: HTTP ${response.status}`);
+  }
+  const body = await response.json();
+  return {
+    action,
+    result: body.result,
+    summary: body.summary,
+    updatedAt: Date.now()
+  };
+};
 var createVoiceDeliveryRuntimeStore = (path = "/api/voice-delivery-runtime", options = {}) => {
   const listeners = new Set;
   let closed = false;
   let timer;
   let snapshot = {
+    actionError: null,
+    actionStatus: "idle",
     error: null,
     isLoading: false
   };
@@ -2097,6 +2121,7 @@ var createVoiceDeliveryRuntimeStore = (path = "/api/voice-delivery-runtime", opt
     try {
       const report = await fetchVoiceDeliveryRuntime(path, options);
       snapshot = {
+        ...snapshot,
         error: null,
         isLoading: false,
         report,
@@ -2114,6 +2139,37 @@ var createVoiceDeliveryRuntimeStore = (path = "/api/voice-delivery-runtime", opt
       throw error;
     }
   };
+  const runAction = async (action) => {
+    if (closed) {
+      return snapshot.lastAction;
+    }
+    snapshot = {
+      ...snapshot,
+      actionError: null,
+      actionStatus: "running"
+    };
+    emit();
+    try {
+      const result = await runVoiceDeliveryRuntimeAction(action, path, options);
+      snapshot = {
+        ...snapshot,
+        actionError: null,
+        actionStatus: "completed",
+        lastAction: result
+      };
+      emit();
+      await refresh();
+      return result;
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        actionError: error instanceof Error ? error.message : String(error),
+        actionStatus: "failed"
+      };
+      emit();
+      throw error;
+    }
+  };
   const close = () => {
     closed = true;
     if (timer) {
@@ -2131,7 +2187,9 @@ var createVoiceDeliveryRuntimeStore = (path = "/api/voice-delivery-runtime", opt
     close,
     getServerSnapshot: () => snapshot,
     getSnapshot: () => snapshot,
+    requeueDeadLetters: () => runAction("requeue-dead-letters"),
     refresh,
+    tick: () => runAction("tick"),
     subscribe: (listener) => {
       listeners.add(listener);
       return () => {
@@ -2303,6 +2361,8 @@ var createVoiceDeliveryRuntimeViewModel = (snapshot, options = {}) => {
   return {
     description: options.description ?? DEFAULT_DESCRIPTION2,
     error: snapshot.error,
+    actionError: snapshot.actionError,
+    actionStatus: snapshot.actionStatus,
     isLoading: snapshot.isLoading,
     isRunning: Boolean(report?.isRunning),
     label: snapshot.error ? "Unavailable" : report ? report.isRunning ? "Running" : "Stopped" : "Checking",
@@ -2319,6 +2379,11 @@ var renderVoiceDeliveryRuntimeHTML = (snapshot, options = {}) => {
   <strong>${escapeHtml2(surface.detail)}</strong>
   <small>${String(surface.failed)} failed &middot; ${String(surface.deadLettered)} dead-lettered</small>
 </li>`).join("");
+  const actions = options.includeActions === false ? "" : `<div class="absolute-voice-delivery-runtime__actions">
+  <button type="button" data-absolute-voice-delivery-runtime-action="tick">${model.actionStatus === "running" ? "Working..." : "Tick workers"}</button>
+  <button type="button" data-absolute-voice-delivery-runtime-action="requeue-dead-letters"${model.surfaces.some((surface) => surface.deadLettered > 0) ? "" : " disabled"}>Requeue dead letters</button>
+</div>`;
+  const actionError = model.actionError ? `<p class="absolute-voice-delivery-runtime__error">${escapeHtml2(model.actionError)}</p>` : "";
   return `<section class="absolute-voice-delivery-runtime absolute-voice-delivery-runtime--${escapeHtml2(model.status)}">
   <header class="absolute-voice-delivery-runtime__header">
     <span class="absolute-voice-delivery-runtime__eyebrow">${escapeHtml2(model.title)}</span>
@@ -2326,20 +2391,38 @@ var renderVoiceDeliveryRuntimeHTML = (snapshot, options = {}) => {
   </header>
   <p class="absolute-voice-delivery-runtime__description">${escapeHtml2(model.description)}</p>
   <ul class="absolute-voice-delivery-runtime__surfaces">${surfaces}</ul>
+  ${actions}
+  ${actionError}
   ${model.error ? `<p class="absolute-voice-delivery-runtime__error">${escapeHtml2(model.error)}</p>` : ""}
 </section>`;
 };
-var getVoiceDeliveryRuntimeCSS = () => `.absolute-voice-delivery-runtime{border:1px solid #c9d8cf;border-radius:20px;background:#f6fff9;color:#0d1b12;padding:18px;box-shadow:0 18px 40px rgba(19,55,35,.12);font-family:inherit}.absolute-voice-delivery-runtime--warn,.absolute-voice-delivery-runtime--error{border-color:#f2b56b;background:#fff9ed}.absolute-voice-delivery-runtime__header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-delivery-runtime__eyebrow{color:#4e6b59;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-delivery-runtime__label{font-size:28px;line-height:1}.absolute-voice-delivery-runtime__description{color:#33483b;margin:12px 0 0}.absolute-voice-delivery-runtime__surfaces{display:grid;gap:8px;list-style:none;margin:16px 0 0;padding:0}.absolute-voice-delivery-runtime__surface{background:#fff;border:1px solid #d9eadf;border-radius:14px;display:grid;gap:4px;padding:10px 12px}.absolute-voice-delivery-runtime__surface--warn{border-color:#f2b56b}.absolute-voice-delivery-runtime__surface--disabled{opacity:.72}.absolute-voice-delivery-runtime__surface span,.absolute-voice-delivery-runtime__surface small{color:#587063}.absolute-voice-delivery-runtime__error{color:#9f1239;font-weight:700}`;
+var getVoiceDeliveryRuntimeCSS = () => `.absolute-voice-delivery-runtime{border:1px solid #c9d8cf;border-radius:20px;background:#f6fff9;color:#0d1b12;padding:18px;box-shadow:0 18px 40px rgba(19,55,35,.12);font-family:inherit}.absolute-voice-delivery-runtime--warn,.absolute-voice-delivery-runtime--error{border-color:#f2b56b;background:#fff9ed}.absolute-voice-delivery-runtime__header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-delivery-runtime__eyebrow{color:#4e6b59;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-delivery-runtime__label{font-size:28px;line-height:1}.absolute-voice-delivery-runtime__description{color:#33483b;margin:12px 0 0}.absolute-voice-delivery-runtime__surfaces{display:grid;gap:8px;list-style:none;margin:16px 0 0;padding:0}.absolute-voice-delivery-runtime__surface{background:#fff;border:1px solid #d9eadf;border-radius:14px;display:grid;gap:4px;padding:10px 12px}.absolute-voice-delivery-runtime__surface--warn{border-color:#f2b56b}.absolute-voice-delivery-runtime__surface--disabled{opacity:.72}.absolute-voice-delivery-runtime__surface span,.absolute-voice-delivery-runtime__surface small{color:#587063}.absolute-voice-delivery-runtime__actions{display:flex;flex-wrap:wrap;gap:8px;margin-top:14px}.absolute-voice-delivery-runtime__actions button{background:#134e2d;border:0;border-radius:999px;color:#f6fff9;cursor:pointer;font:inherit;font-weight:800;padding:8px 12px}.absolute-voice-delivery-runtime__actions button:disabled{cursor:not-allowed;opacity:.48}.absolute-voice-delivery-runtime__error{color:#9f1239;font-weight:700}`;
 var mountVoiceDeliveryRuntime = (element, path = "/api/voice-delivery-runtime", options = {}) => {
   const store = createVoiceDeliveryRuntimeStore(path, options);
   const render = () => {
     element.innerHTML = renderVoiceDeliveryRuntimeHTML(store.getSnapshot(), options);
   };
   const unsubscribe = store.subscribe(render);
+  const handleClick = (event) => {
+    const target = event.target;
+    if (!(target instanceof Element)) {
+      return;
+    }
+    const action = target.closest("[data-absolute-voice-delivery-runtime-action]");
+    const actionName = action?.getAttribute("data-absolute-voice-delivery-runtime-action");
+    if (actionName === "tick") {
+      store.tick().catch(() => {});
+    }
+    if (actionName === "requeue-dead-letters") {
+      store.requeueDeadLetters().catch(() => {});
+    }
+  };
+  element.addEventListener?.("click", handleClick);
   render();
   store.refresh().catch(() => {});
   return {
     close: () => {
+      element.removeEventListener?.("click", handleClick);
       unsubscribe();
       store.close();
     },
@@ -3852,6 +3935,7 @@ var createVoiceWorkflowStatusStore = (path = "/evals/scenarios/json", options =
 };
 export {
   runVoiceTurnLatencyProof,
+  runVoiceDeliveryRuntimeAction,
   runVoiceCampaignDialerProofAction,
   renderVoiceTurnQualityHTML,
   renderVoiceTurnLatencyHTML,

package/dist/deliveryRuntime.d.ts

@@ -21,6 +21,11 @@ export type VoiceDeliveryRuntimeTickResult = {
     audit?: VoiceAuditSinkDeliveryWorkerResult;
     trace?: VoiceTraceSinkDeliveryWorkerResult;
 };
+export type VoiceDeliveryRuntimeRequeueDeadLettersResult = {
+    audit: number;
+    trace: number;
+    total: number;
+};
 export type VoiceDeliveryRuntimeSummary = {
     audit?: VoiceAuditSinkDeliveryQueueSummary;
     trace?: VoiceTraceSinkDeliveryQueueSummary;
@@ -28,6 +33,7 @@ export type VoiceDeliveryRuntimeSummary = {
 export type VoiceDeliveryRuntime = {
     audit?: ReturnType<typeof createVoiceAuditSinkDeliveryWorker>;
     isRunning: () => boolean;
+    requeueDeadLetters: () => Promise<VoiceDeliveryRuntimeRequeueDeadLettersResult>;
     start: () => void;
     stop: () => void;
     summarize: () => Promise<VoiceDeliveryRuntimeSummary>;
@@ -44,8 +50,13 @@ export type VoiceDeliveryRuntimeRoutesOptions = {
     htmlPath?: false | string;
     name?: string;
     path?: string;
-    render?: (report: VoiceDeliveryRuntimeReport) => string | Promise<string>;
+    render?: (report: VoiceDeliveryRuntimeReport, options: {
+        requeueDeadLettersPath?: false | string;
+        tickPath?: false | string;
+        title?: string;
+    }) => string | Promise<string>;
     runtime: VoiceDeliveryRuntime;
+    requeueDeadLettersPath?: false | string;
     tickPath?: false | string;
     title?: string;
 };
@@ -101,6 +112,7 @@ export declare const createVoiceDeliveryRuntimePresetConfig: (options: VoiceDeli
 export declare const createVoiceDeliveryRuntime: <TAuditDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord, TTraceDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord>(config: VoiceDeliveryRuntimeConfig<TAuditDelivery, TTraceDelivery>) => VoiceDeliveryRuntime;
 export declare const buildVoiceDeliveryRuntimeReport: (runtime: VoiceDeliveryRuntime) => Promise<VoiceDeliveryRuntimeReport>;
 export declare const renderVoiceDeliveryRuntimeHTML: (report: VoiceDeliveryRuntimeReport, options?: {
+    requeueDeadLettersPath?: false | string;
     tickPath?: false | string;
     title?: string;
 }) => string;

package/dist/index.js

@@ -11579,6 +11579,15 @@ var resolvePresetLeases = (leases) => ("claim" in leases) ? {
   audit: leases,
   trace: leases
 } : leases;
+var requeueDelivery = (delivery) => ({
+  ...delivery,
+  deliveredAt: undefined,
+  deliveryAttempts: 0,
+  deliveryError: undefined,
+  deliveryStatus: "pending",
+  sinkDeliveries: undefined,
+  updatedAt: Date.now()
+});
 var createDeliveryRuntimeFileSink = (input) => ({
   deliver: async ({ events }) => {
     const firstEvent = events[0];
@@ -11706,6 +11715,29 @@ var createVoiceDeliveryRuntime = (config) => {
   return {
     audit,
     isRunning: () => Boolean(auditLoop?.isRunning() || traceLoop?.isRunning()),
+    requeueDeadLetters: async () => {
+      let audit2 = 0;
+      let trace2 = 0;
+      if (config.audit?.deadLetters) {
+        for (const delivery of await config.audit.deadLetters.list()) {
+          await config.audit.deliveries.set(delivery.id, requeueDelivery(delivery));
+          await config.audit.deadLetters.remove(delivery.id);
+          audit2 += 1;
+        }
+      }
+      if (config.trace?.deadLetters) {
+        for (const delivery of await config.trace.deadLetters.list()) {
+          await config.trace.deliveries.set(delivery.id, requeueDelivery(delivery));
+          await config.trace.deadLetters.remove(delivery.id);
+          trace2 += 1;
+        }
+      }
+      return {
+        audit: audit2,
+        trace: trace2,
+        total: audit2 + trace2
+      };
+    },
     start: () => {
       if (config.audit?.autoStart) {
         auditLoop?.start();
@@ -11753,15 +11785,18 @@ var buildVoiceDeliveryRuntimeReport = async (runtime) => ({
 var renderVoiceDeliveryRuntimeHTML = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Delivery Runtime";
   const tickForm = options.tickPath === false ? "" : `<form method="post" action="${escapeHtml15(options.tickPath ?? "/api/voice-delivery-runtime/tick")}"><button type="submit">Tick delivery workers</button></form>`;
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml15(title)}</title><style>body{background:#0f1411;color:#f7f2df;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1080px;padding:32px}a{color:#86efac;text-decoration:none}.hero{background:linear-gradient(135deg,rgba(34,197,94,.18),rgba(14,165,233,.13));border:1px solid #263a30;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#86efac;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.2rem,5vw,4.8rem);line-height:.92;margin:.2rem 0 1rem}.status{border:1px solid #64748b;border-radius:999px;display:inline-flex;font-weight:900;padding:8px 12px}.status.running{border-color:rgba(34,197,94,.7);color:#bbf7d0}.muted{color:#b9c3b4}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));margin:18px 0}article,.card{background:#151d18;border:1px solid #263a30;border-radius:22px;padding:18px}article span{color:#b9c3b4;display:block;font-weight:800}article strong{display:block;font-size:2.3rem;margin-top:8px}button{background:#86efac;border:0;border-radius:999px;color:#07120b;cursor:pointer;font-weight:900;margin-top:12px;padding:10px 14px}pre{background:#09100c;border:1px solid #263a30;border-radius:18px;color:#dcfce7;overflow:auto;padding:16px}</style></head><body><main><p><a href="/delivery-sinks">Delivery sinks</a></p><section class="hero"><p class="eyebrow">Worker control plane</p><h1>${escapeHtml15(title)}</h1><p class="muted">Inspect queue summaries and manually tick audit and trace delivery workers from one runtime primitive.</p><p class="status ${report.isRunning ? "running" : ""}">${report.isRunning ? "Running" : "Stopped"}</p><p class="muted">Checked ${escapeHtml15(new Date(report.checkedAt).toLocaleString())}</p>${tickForm}</section><section class="grid">${renderSummaryCard("Audit", report.summary.audit)}${renderSummaryCard("Trace", report.summary.trace)}</section><section class="card"><h2>Runtime shape</h2><pre>const runtime = createVoiceDeliveryRuntime({ audit, trace })
+  const requeueForm = options.requeueDeadLettersPath === false ? "" : `<form method="post" action="${escapeHtml15(options.requeueDeadLettersPath ?? "/api/voice-delivery-runtime/requeue-dead-letters")}"><button type="submit">Requeue dead letters</button></form>`;
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml15(title)}</title><style>body{background:#0f1411;color:#f7f2df;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1080px;padding:32px}a{color:#86efac;text-decoration:none}.hero{background:linear-gradient(135deg,rgba(34,197,94,.18),rgba(14,165,233,.13));border:1px solid #263a30;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#86efac;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.2rem,5vw,4.8rem);line-height:.92;margin:.2rem 0 1rem}.status{border:1px solid #64748b;border-radius:999px;display:inline-flex;font-weight:900;padding:8px 12px}.status.running{border-color:rgba(34,197,94,.7);color:#bbf7d0}.muted{color:#b9c3b4}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));margin:18px 0}article,.card{background:#151d18;border:1px solid #263a30;border-radius:22px;padding:18px}article span{color:#b9c3b4;display:block;font-weight:800}article strong{display:block;font-size:2.3rem;margin-top:8px}.actions{display:flex;flex-wrap:wrap;gap:10px}button{background:#86efac;border:0;border-radius:999px;color:#07120b;cursor:pointer;font-weight:900;margin-top:12px;padding:10px 14px}pre{background:#09100c;border:1px solid #263a30;border-radius:18px;color:#dcfce7;overflow:auto;padding:16px}</style></head><body><main><p><a href="/delivery-sinks">Delivery sinks</a></p><section class="hero"><p class="eyebrow">Worker control plane</p><h1>${escapeHtml15(title)}</h1><p class="muted">Inspect queue summaries, manually tick failed/pending audit and trace deliveries, and requeue dead letters after operator review.</p><p class="status ${report.isRunning ? "running" : ""}">${report.isRunning ? "Running" : "Stopped"}</p><p class="muted">Checked ${escapeHtml15(new Date(report.checkedAt).toLocaleString())}</p><div class="actions">${tickForm}${requeueForm}</div></section><section class="grid">${renderSummaryCard("Audit", report.summary.audit)}${renderSummaryCard("Trace", report.summary.trace)}</section><section class="card"><h2>Runtime shape</h2><pre>const runtime = createVoiceDeliveryRuntime({ audit, trace })
 
 await runtime.tick()
+await runtime.requeueDeadLetters()
 await runtime.summarize()</pre></section></main></body></html>`;
 };
 var createVoiceDeliveryRuntimeRoutes = (options) => {
   const path = options.path ?? "/api/voice-delivery-runtime";
   const htmlPath = options.htmlPath === undefined ? "/delivery-runtime" : options.htmlPath;
   const tickPath = options.tickPath === undefined ? "/api/voice-delivery-runtime/tick" : options.tickPath;
+  const requeueDeadLettersPath = options.requeueDeadLettersPath === undefined ? "/api/voice-delivery-runtime/requeue-dead-letters" : options.requeueDeadLettersPath;
   const routes = new Elysia12({
     name: options.name ?? "absolutejs-voice-delivery-runtime"
   }).get(path, () => buildVoiceDeliveryRuntimeReport(options.runtime));
@@ -11772,11 +11807,19 @@ var createVoiceDeliveryRuntimeRoutes = (options) => {
       summary: await options.runtime.summarize()
     }));
   }
+  if (requeueDeadLettersPath !== false) {
+    routes.post(requeueDeadLettersPath, async () => ({
+      requeuedAt: Date.now(),
+      result: await options.runtime.requeueDeadLetters(),
+      summary: await options.runtime.summarize()
+    }));
+  }
   if (htmlPath !== false) {
     routes.get(htmlPath, async () => {
       const report = await buildVoiceDeliveryRuntimeReport(options.runtime);
       const body = await (options.render ?? renderVoiceDeliveryRuntimeHTML)(report, {
         tickPath,
+        requeueDeadLettersPath,
         title: options.title
       });
       return new Response(body, {