@absolutejs/voice 0.0.22-beta.49 → 0.0.22-beta.50

package/dist/index.js

@@ -9191,6 +9191,86 @@ var toOpsLinks = (links) => links.map((link) => ({
   statusHref: link.statusHref
 }));
 var toResilienceLinks = (links) => links.map(({ href, label }) => ({ href, label }));
+var countStatus = (statuses) => ({
+  failed: statuses.filter((status) => status === "fail").length,
+  passed: statuses.filter((status) => status === "pass").length,
+  total: statuses.length
+});
+var summarizeVoiceAppKitStatus = async (options) => {
+  const links = resolveLinks(options.links);
+  const events = filterVoiceTraceEvents(await options.store.list());
+  const [quality, workflows, providers, sessions, handoffs] = await Promise.all([
+    options.quality === false ? undefined : evaluateVoiceQuality({
+      events,
+      thresholds: options.quality?.thresholds
+    }),
+    options.evals === false ? undefined : runVoiceScenarioEvals({
+      events,
+      scenarios: options.evals?.scenarios
+    }),
+    options.providerHealth === false ? undefined : summarizeVoiceProviderHealth({
+      events,
+      providers: options.llmProviders
+    }),
+    options.sessions === false ? undefined : summarizeVoiceSessions({
+      events
+    }),
+    options.handoffs === false ? undefined : summarizeVoiceHandoffHealth({
+      events
+    })
+  ]);
+  const surfaces = {};
+  const statuses = [];
+  if (quality) {
+    surfaces.quality = { status: quality.status };
+    statuses.push(quality.status);
+  }
+  if (workflows) {
+    const status = workflows.status;
+    surfaces.workflows = {
+      failed: workflows.failed,
+      status,
+      total: workflows.total
+    };
+    statuses.push(status);
+  }
+  if (providers) {
+    const degraded = providers.filter((provider) => provider.status === "degraded" || provider.status === "rate-limited" || provider.status === "suppressed").length;
+    const status = degraded > 0 ? "fail" : "pass";
+    surfaces.providers = {
+      degraded,
+      status,
+      total: providers.length
+    };
+    statuses.push(status);
+  }
+  if (sessions) {
+    const failed = sessions.filter((session) => session.status === "failed").length;
+    const status = failed > 0 ? "fail" : "pass";
+    surfaces.sessions = {
+      failed,
+      status,
+      total: sessions.length
+    };
+    statuses.push(status);
+  }
+  if (handoffs) {
+    const status = handoffs.failed > 0 ? "fail" : "pass";
+    surfaces.handoffs = {
+      failed: handoffs.failed,
+      status,
+      total: handoffs.total
+    };
+    statuses.push(status);
+  }
+  return {
+    checkedAt: Date.now(),
+    links,
+    status: statuses.includes("fail") ? "fail" : "pass",
+    surfaces,
+    ...countStatus(statuses)
+  };
+};
 var createVoiceAppKitRoutes = (options) => {
   const routes = new Elysia11({
     name: options.name ?? "absolutejs-voice-app-kit"
@@ -9201,6 +9281,9 @@ var createVoiceAppKitRoutes = (options) => {
     store: options.store
   };
   const surfaces = [];
+  if (options.appStatus !== false) {
+    routes.get(options.appStatus?.path ?? "/app-kit/status", () => summarizeVoiceAppKitStatus(options));
+  }
   if (options.providerHealth !== false) {
     surfaces.push("providerHealth");
     routes.use(createVoiceProviderHealthRoutes({
@@ -13859,6 +13942,7 @@ export {
   summarizeVoiceHandoffDeliveries,
   summarizeVoiceAssistantRuns,
   summarizeVoiceAssistantHealth,
+  summarizeVoiceAppKitStatus,
   startVoiceOpsTask,
   shapeTelephonyAssistantText,
   selectVoiceTraceEventsForPrune,

package/dist/react/index.d.ts

@@ -1,3 +1,4 @@
+export { useVoiceAppKitStatus } from './useVoiceAppKitStatus';
 export { useVoiceStream } from './useVoiceStream';
 export { useVoiceController } from './useVoiceController';
 export { useVoiceProviderStatus } from './useVoiceProviderStatus';

package/dist/react/index.js

@@ -69,9 +69,107 @@ var __decorateElement = (array, flags, name, decorators, target, extra) => {
   return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
 };
 
-// src/react/useVoiceStream.tsx
+// src/react/useVoiceAppKitStatus.tsx
 import { useEffect, useRef, useSyncExternalStore } from "react";
 
+// src/client/appKitStatus.ts
+var fetchVoiceAppKitStatus = async (path = "/app-kit/status", options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path);
+  if (!response.ok) {
+    throw new Error(`Voice app kit status failed: HTTP ${response.status}`);
+  }
+  return await response.json();
+};
+var createVoiceAppKitStatusStore = (path = "/app-kit/status", options = {}) => {
+  const listeners = new Set;
+  let closed = false;
+  let timer;
+  let snapshot = {
+    error: null,
+    isLoading: false
+  };
+  const emit = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const refresh = async () => {
+    if (closed) {
+      return snapshot.report;
+    }
+    snapshot = {
+      ...snapshot,
+      error: null,
+      isLoading: true
+    };
+    emit();
+    try {
+      const report = await fetchVoiceAppKitStatus(path, options);
+      snapshot = {
+        error: null,
+        isLoading: false,
+        report,
+        updatedAt: Date.now()
+      };
+      emit();
+      return report;
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isLoading: false
+      };
+      emit();
+      throw error;
+    }
+  };
+  const close = () => {
+    closed = true;
+    if (timer) {
+      clearInterval(timer);
+      timer = undefined;
+    }
+    listeners.clear();
+  };
+  if (typeof window !== "undefined" && options.intervalMs && options.intervalMs > 0) {
+    timer = setInterval(() => {
+      refresh().catch(() => {});
+    }, options.intervalMs);
+  }
+  return {
+    close,
+    getServerSnapshot: () => snapshot,
+    getSnapshot: () => snapshot,
+    refresh,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+};
+
+// src/react/useVoiceAppKitStatus.tsx
+var useVoiceAppKitStatus = (path = "/app-kit/status", options = {}) => {
+  const storeRef = useRef(null);
+  if (!storeRef.current) {
+    storeRef.current = createVoiceAppKitStatusStore(path, options);
+  }
+  const store = storeRef.current;
+  useEffect(() => {
+    store.refresh().catch(() => {});
+    return () => store.close();
+  }, [store]);
+  return {
+    ...useSyncExternalStore(store.subscribe, store.getSnapshot, store.getServerSnapshot),
+    refresh: store.refresh
+  };
+};
+// src/react/useVoiceStream.tsx
+import { useEffect as useEffect2, useRef as useRef2, useSyncExternalStore as useSyncExternalStore2 } from "react";
+
 // src/client/actions.ts
 var normalizeErrorMessage = (value) => {
   if (typeof value === "string" && value.trim()) {
@@ -598,13 +696,13 @@ var EMPTY_SNAPSHOT = {
   turns: []
 };
 var useVoiceStream = (path, options = {}) => {
-  const streamRef = useRef(null);
+  const streamRef = useRef2(null);
   if (!streamRef.current) {
     streamRef.current = createVoiceStream(path, options);
   }
   const stream = streamRef.current;
-  useEffect(() => () => stream.close(), [stream]);
-  const snapshot = useSyncExternalStore(stream.subscribe, stream.getSnapshot, stream.getServerSnapshot) ?? EMPTY_SNAPSHOT;
+  useEffect2(() => () => stream.close(), [stream]);
+  const snapshot = useSyncExternalStore2(stream.subscribe, stream.getSnapshot, stream.getServerSnapshot) ?? EMPTY_SNAPSHOT;
   return {
     ...snapshot,
     callControl: (message) => stream.callControl(message),
@@ -614,7 +712,7 @@ var useVoiceStream = (path, options = {}) => {
   };
 };
 // src/react/useVoiceController.tsx
-import { useEffect as useEffect2, useRef as useRef2, useSyncExternalStore as useSyncExternalStore2 } from "react";
+import { useEffect as useEffect3, useRef as useRef3, useSyncExternalStore as useSyncExternalStore3 } from "react";
 
 // src/client/htmx.ts
 var DEFAULT_EVENT_NAME = "voice-refresh";
@@ -1261,13 +1359,13 @@ var EMPTY_SNAPSHOT2 = {
   turns: []
 };
 var useVoiceController = (path, options = {}) => {
-  const controllerRef = useRef2(null);
+  const controllerRef = useRef3(null);
   if (!controllerRef.current) {
     controllerRef.current = createVoiceController(path, options);
   }
   const controller = controllerRef.current;
-  useEffect2(() => () => controller.close(), [controller]);
-  const snapshot = useSyncExternalStore2(controller.subscribe, controller.getSnapshot, controller.getServerSnapshot) ?? EMPTY_SNAPSHOT2;
+  useEffect3(() => () => controller.close(), [controller]);
+  const snapshot = useSyncExternalStore3(controller.subscribe, controller.getSnapshot, controller.getServerSnapshot) ?? EMPTY_SNAPSHOT2;
   return {
     ...snapshot,
     bindHTMX: controller.bindHTMX,
@@ -1281,7 +1379,7 @@ var useVoiceController = (path, options = {}) => {
   };
 };
 // src/react/useVoiceProviderStatus.tsx
-import { useEffect as useEffect3, useRef as useRef3, useSyncExternalStore as useSyncExternalStore3 } from "react";
+import { useEffect as useEffect4, useRef as useRef4, useSyncExternalStore as useSyncExternalStore4 } from "react";
 
 // src/client/providerStatus.ts
 var fetchVoiceProviderStatus = async (path = "/api/provider-status", options = {}) => {
@@ -1365,22 +1463,22 @@ var createVoiceProviderStatusStore = (path = "/api/provider-status", options = {
 
 // src/react/useVoiceProviderStatus.tsx
 var useVoiceProviderStatus = (path = "/api/provider-status", options = {}) => {
-  const storeRef = useRef3(null);
+  const storeRef = useRef4(null);
   if (!storeRef.current) {
     storeRef.current = createVoiceProviderStatusStore(path, options);
   }
   const store = storeRef.current;
-  useEffect3(() => {
+  useEffect4(() => {
     store.refresh().catch(() => {});
     return () => store.close();
   }, [store]);
   return {
-    ...useSyncExternalStore3(store.subscribe, store.getSnapshot, store.getServerSnapshot),
+    ...useSyncExternalStore4(store.subscribe, store.getSnapshot, store.getServerSnapshot),
     refresh: store.refresh
   };
 };
 // src/react/useVoiceWorkflowStatus.tsx
-import { useEffect as useEffect4, useRef as useRef4, useSyncExternalStore as useSyncExternalStore4 } from "react";
+import { useEffect as useEffect5, useRef as useRef5, useSyncExternalStore as useSyncExternalStore5 } from "react";
 
 // src/client/workflowStatus.ts
 var fetchVoiceWorkflowStatus = async (path = "/evals/scenarios/json", options = {}) => {
@@ -1463,17 +1561,17 @@ var createVoiceWorkflowStatusStore = (path = "/evals/scenarios/json", options =
 
 // src/react/useVoiceWorkflowStatus.tsx
 var useVoiceWorkflowStatus = (path = "/evals/scenarios/json", options = {}) => {
-  const storeRef = useRef4(null);
+  const storeRef = useRef5(null);
   if (!storeRef.current) {
     storeRef.current = createVoiceWorkflowStatusStore(path, options);
   }
   const store = storeRef.current;
-  useEffect4(() => {
+  useEffect5(() => {
     store.refresh().catch(() => {});
     return () => store.close();
   }, [store]);
   return {
-    ...useSyncExternalStore4(store.subscribe, store.getSnapshot, store.getServerSnapshot),
+    ...useSyncExternalStore5(store.subscribe, store.getSnapshot, store.getServerSnapshot),
     refresh: store.refresh
   };
 };
@@ -1481,5 +1579,6 @@ export {
   useVoiceWorkflowStatus,
   useVoiceStream,
   useVoiceProviderStatus,
-  useVoiceController
+  useVoiceController,
+  useVoiceAppKitStatus
 };

package/dist/react/useVoiceAppKitStatus.d.ts

@@ -0,0 +1,8 @@
+import { type VoiceAppKitStatusClientOptions } from '../client/appKitStatus';
+export declare const useVoiceAppKitStatus: (path?: string, options?: VoiceAppKitStatusClientOptions) => {
+    refresh: () => Promise<import("..").VoiceAppKitStatusReport | undefined>;
+    error: string | null;
+    isLoading: boolean;
+    report?: import("..").VoiceAppKitStatusReport;
+    updatedAt?: number;
+};

package/dist/svelte/createVoiceAppKitStatus.d.ts

@@ -0,0 +1,8 @@
+import type { VoiceAppKitStatusClientOptions } from '../client/appKitStatus';
+export declare const createVoiceAppKitStatus: (path?: string, options?: VoiceAppKitStatusClientOptions) => {
+    close: () => void;
+    getServerSnapshot: () => import("../client").VoiceAppKitStatusSnapshot;
+    getSnapshot: () => import("../client").VoiceAppKitStatusSnapshot;
+    refresh: () => Promise<import("..").VoiceAppKitStatusReport | undefined>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/svelte/index.d.ts

@@ -1,3 +1,4 @@
+export { createVoiceAppKitStatus } from './createVoiceAppKitStatus';
 export { createVoiceStream } from './createVoiceStream';
 export { createVoiceProviderStatus } from './createVoiceProviderStatus';
 export { createVoiceWorkflowStatus } from './createVoiceWorkflowStatus';

package/dist/svelte/index.js

@@ -69,6 +69,87 @@ var __decorateElement = (array, flags, name, decorators, target, extra) => {
   return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
 };
 
+// src/client/appKitStatus.ts
+var fetchVoiceAppKitStatus = async (path = "/app-kit/status", options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path);
+  if (!response.ok) {
+    throw new Error(`Voice app kit status failed: HTTP ${response.status}`);
+  }
+  return await response.json();
+};
+var createVoiceAppKitStatusStore = (path = "/app-kit/status", options = {}) => {
+  const listeners = new Set;
+  let closed = false;
+  let timer;
+  let snapshot = {
+    error: null,
+    isLoading: false
+  };
+  const emit = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const refresh = async () => {
+    if (closed) {
+      return snapshot.report;
+    }
+    snapshot = {
+      ...snapshot,
+      error: null,
+      isLoading: true
+    };
+    emit();
+    try {
+      const report = await fetchVoiceAppKitStatus(path, options);
+      snapshot = {
+        error: null,
+        isLoading: false,
+        report,
+        updatedAt: Date.now()
+      };
+      emit();
+      return report;
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isLoading: false
+      };
+      emit();
+      throw error;
+    }
+  };
+  const close = () => {
+    closed = true;
+    if (timer) {
+      clearInterval(timer);
+      timer = undefined;
+    }
+    listeners.clear();
+  };
+  if (typeof window !== "undefined" && options.intervalMs && options.intervalMs > 0) {
+    timer = setInterval(() => {
+      refresh().catch(() => {});
+    }, options.intervalMs);
+  }
+  return {
+    close,
+    getServerSnapshot: () => snapshot,
+    getSnapshot: () => snapshot,
+    refresh,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+};
+
+// src/svelte/createVoiceAppKitStatus.ts
+var createVoiceAppKitStatus = (path = "/app-kit/status", options = {}) => createVoiceAppKitStatusStore(path, options);
 // src/client/actions.ts
 var normalizeErrorMessage = (value) => {
   if (typeof value === "string" && value.trim()) {
@@ -1380,5 +1461,6 @@ export {
   createVoiceWorkflowStatus,
   createVoiceStream2 as createVoiceStream,
   createVoiceProviderStatus,
-  createVoiceController
+  createVoiceController,
+  createVoiceAppKitStatus
 };

package/dist/vue/index.d.ts

@@ -1,3 +1,4 @@
+export { useVoiceAppKitStatus } from './useVoiceAppKitStatus';
 export { useVoiceStream } from './useVoiceStream';
 export { useVoiceController } from './useVoiceController';
 export { useVoiceProviderStatus } from './useVoiceProviderStatus';