@absolutejs/voice 0.0.22-beta.421 → 0.0.22-beta.423

package/dist/audit.d.ts

@@ -34,6 +34,7 @@ export type VoiceAuditEventFilter = {
     beforeOrAt?: number;
     limit?: number;
     outcome?: VoiceAuditOutcome | VoiceAuditOutcome[];
+    readWindow?: 'recent';
     resourceId?: string;
     resourceType?: string;
     sessionId?: string;

package/dist/index.d.ts

@@ -157,7 +157,7 @@ export type { VoiceMonitorDefinition, VoiceMonitorEvaluation, VoiceMonitorEvalua
 export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRecommendation, VoiceReadinessProfileRecommendationScore, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
 export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixAssertionInput, VoiceProviderContractMatrixAssertionReport, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackAssertionInput, VoiceProviderStackAssertionReport, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';
 export type { VoiceFailureReplayMediaStep, VoiceFailureReplayOptions, VoiceFailureReplayProviderStep, VoiceFailureReplayReport, VoiceFailureReplayStatus, VoiceFailureReplayTurn, VoiceOperationsRecord, VoiceOperationsRecordAgentHandoff, VoiceOperationsRecordAuditSummary, VoiceOperationsRecordGuardrailAssertionInput, VoiceOperationsRecordGuardrailAssertionReport, VoiceOperationsRecordGuardrailDecision, VoiceOperationsRecordGuardrailFinding, VoiceOperationsRecordGuardrailSummary, VoiceOperationsRecordIntegrationEventSummary, VoiceOperationsRecordOptions, VoiceOperationsRecordOutcome, VoiceOperationsRecordProviderDecision, VoiceOperationsRecordProviderDecisionRecoveryStatus, VoiceOperationsRecordProviderDecisionSummary, VoiceOperationsRecordProviderRecoveryAssertionInput, VoiceOperationsRecordProviderRecoveryAssertionReport, VoiceOperationsRecordReviewSummary, VoiceOperationsRecordRoutesOptions, VoiceOperationsRecordStatus, VoiceOperationsRecordTaskSummary, VoiceOperationsRecordTelephonyMediaEvent, VoiceOperationsRecordTelephonyMediaSummary, VoiceOperationsRecordTranscriptTurn, VoiceOperationsRecordTool } from './operationsRecord';
-export type { VoiceObservabilityExportArtifact, VoiceObservabilityExportArtifactChecksum, VoiceObservabilityExportArtifactFreshness, VoiceObservabilityExportArtifactIndex, VoiceObservabilityExportArtifactIndexItem, VoiceObservabilityExportArtifactKind, VoiceObservabilityExportDeliveryAssertionInput, VoiceObservabilityExportDeliveryAssertionReport, VoiceObservabilityExportDeliverySummary, VoiceObservabilityExportDeliveryDestination, VoiceObservabilityExportDeliveryDestinationResult, VoiceObservabilityExportDeliveryHistory, VoiceObservabilityExportDeliveryOptions, VoiceObservabilityExportDeliveryReceipt, VoiceObservabilityExportDeliveryReceiptStore, VoiceObservabilityExportDeliveryReport, VoiceObservabilityExportEnvelope, VoiceObservabilityExportIssue, VoiceObservabilityExportIssueCode, VoiceObservabilityExportOptions, VoiceObservabilityExportIngestedRecordKind, VoiceObservabilityExportRedactionSummary, VoiceObservabilityExportRecordValidationOptions, VoiceObservabilityExportReplayIssue, VoiceObservabilityExportReplayIssueCode, VoiceObservabilityExportReplayAssertionInput, VoiceObservabilityExportReplayAssertionReport, VoiceObservabilityExportReplayRecords, VoiceObservabilityExportReplayReport, VoiceObservabilityExportReplayRoutesOptions, VoiceObservabilityExportReplaySource, VoiceObservabilityExportReport, VoiceObservabilityExportRoutesOptions, VoiceObservabilityExportSchema, VoiceObservabilityExportStatus, VoiceObservabilityExportValidationIssue, VoiceObservabilityExportValidationResult } from './observabilityExport';
+export type { VoiceObservabilityExportArtifact, VoiceObservabilityExportArtifactChecksum, VoiceObservabilityExportArtifactFreshness, VoiceObservabilityExportArtifactIndex, VoiceObservabilityExportArtifactIndexItem, VoiceObservabilityExportArtifactKind, VoiceObservabilityExportDeliveryAssertionInput, VoiceObservabilityExportDeliveryAssertionReport, VoiceObservabilityExportDeliverySummary, VoiceObservabilityExportDeliveryDestination, VoiceObservabilityExportDeliveryDestinationResult, VoiceObservabilityExportDeliveryHistory, VoiceObservabilityExportDeliveryOptions, VoiceObservabilityExportDeliveryReceipt, VoiceObservabilityExportDeliveryReceiptStore, VoiceObservabilityExportDeliveryReport, VoiceObservabilityExportEnvelope, VoiceObservabilityExportIssue, VoiceObservabilityExportIssueCode, VoiceObservabilityExportOptions, VoiceObservabilityExportIngestedRecordKind, VoiceObservabilityExportRedactionSummary, VoiceObservabilityExportRecordValidationOptions, VoiceObservabilityExportReplayIssue, VoiceObservabilityExportReplayIssueCode, VoiceObservabilityExportReplayAssertionInput, VoiceObservabilityExportReplayAssertionReport, VoiceObservabilityExportReplayRecords, VoiceObservabilityExportReplayReport, VoiceObservabilityExportReplayRoutesOptions, VoiceObservabilityExportReplaySource, VoiceObservabilityExportReport, VoiceObservabilityExportRoutesOptions, VoiceObservabilityExportSchema, VoiceObservabilityExportStatus, VoiceObservabilityExportTiming, VoiceObservabilityExportValidationIssue, VoiceObservabilityExportValidationResult } from './observabilityExport';
 export type { VoiceOpsRecoveryFailedSession, VoiceOpsRecoveryInterventionSummary, VoiceOpsRecoveryIssue, VoiceOpsRecoveryIssueCode, VoiceOpsRecoveryLinks, VoiceOpsRecoveryProviderSummary, VoiceOpsRecoveryReport, VoiceOpsRecoveryReportOptions, VoiceOpsRecoveryRoutesOptions, VoiceOpsRecoveryStatus } from './opsRecovery';
 export type { StoredVoiceIncidentBundleArtifact, VoiceIncidentBundle, VoiceIncidentBundleArtifactOptions, VoiceIncidentBundleFormat, VoiceIncidentBundleOptions, VoiceIncidentBundleRetentionOptions, VoiceIncidentBundleRetentionReport, VoiceIncidentBundleRoutesOptions, VoiceIncidentBundleStore, VoiceIncidentBundleStoreFilter, VoiceIncidentBundleSummary } from './incidentBundle';
 export type { VoiceQualityLink, VoiceQualityMetric, VoiceQualityReport, VoiceQualityRoutesOptions, VoiceQualityStatus, VoiceQualityThresholds } from './qualityRoutes';

package/dist/index.js

@@ -28724,7 +28724,15 @@ var createVoicePhoneAgent = (options) => {
   };
 };
 // src/fileStore.ts
-import { mkdir as mkdir3, readFile, readdir, rename, rm, writeFile } from "fs/promises";
+import {
+  mkdir as mkdir3,
+  readFile,
+  readdir,
+  rename,
+  rm,
+  stat,
+  writeFile
+} from "fs/promises";
 import { join as join2 } from "path";
 var listJsonFiles = async (directory) => {
   try {
@@ -28739,6 +28747,31 @@ var listJsonFiles = async (directory) => {
     throw error;
   }
 };
+var listRecentJsonFiles = async (directory, limit) => {
+  if (limit === 0) {
+    return [];
+  }
+  const files = await listJsonFiles(directory);
+  const candidates = await Promise.all(files.map(async (path) => {
+    try {
+      return {
+        path,
+        updatedAt: (await stat(path)).mtimeMs
+      };
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        return;
+      }
+      throw error;
+    }
+  }));
+  return candidates.filter((candidate) => Boolean(candidate)).sort((left, right) => right.updatedAt - left.updatedAt).slice(0, limit).map((candidate) => candidate.path);
+};
+var shouldUseRecentReadWindow = (filter) => filter.readWindow === "recent" && typeof filter.limit === "number" && filter.limit >= 0;
+var omitReadWindow = (filter) => {
+  const { readWindow: _readWindow, ...next } = filter;
+  return next;
+};
 var encodeStoreId = (id) => `${encodeURIComponent(id)}.json`;
 var resolveFilePath = (directory, id) => join2(directory, encodeStoreId(id));
 var createMemoryStoreId = (input) => `${input.assistantId}:${input.namespace}:${input.key}`;
@@ -28947,9 +28980,9 @@ var createVoiceFileTraceEventStore = (options) => {
     }
   };
   const list = async (filter = {}) => {
-    const files = await listJsonFiles(options.directory);
+    const files = shouldUseRecentReadWindow(filter) ? await listRecentJsonFiles(options.directory, filter.limit) : await listJsonFiles(options.directory);
     const events = await Promise.all(files.map((file) => readJsonFile(file)));
-    return filterVoiceTraceEvents(events, filter);
+    return filterVoiceTraceEvents(events, omitReadWindow(filter));
   };
   const remove = async (id) => {
     await rm(resolveFilePath(options.directory, id), {
@@ -29006,9 +29039,10 @@ var createVoiceFileAuditEventStore = (options) => {
     return stored;
   };
   const list = async (filter) => {
-    const files = await listJsonFiles(options.directory);
+    const resolvedFilter = filter ?? {};
+    const files = shouldUseRecentReadWindow(resolvedFilter) ? await listRecentJsonFiles(options.directory, resolvedFilter.limit) : await listJsonFiles(options.directory);
     const events = await Promise.all(files.map((file) => readJsonFile(file)));
-    return filterVoiceAuditEvents(events, filter);
+    return filterVoiceAuditEvents(events, omitReadWindow(resolvedFilter));
   };
   return { append, get, list };
 };
@@ -32162,7 +32196,7 @@ var createVoiceOpsRecoveryRoutes = (options = {}) => {
 import { Elysia as Elysia55 } from "elysia";
 import { Database as Database4 } from "bun:sqlite";
 import { createHash } from "crypto";
-import { mkdir as mkdir4, readFile as readFile2, stat, unlink } from "fs/promises";
+import { mkdir as mkdir4, readFile as readFile2, stat as stat2, unlink } from "fs/promises";
 import { join as join3 } from "path";
 var voiceObservabilityExportSchemaVersion = "1.0.0";
 var voiceObservabilityExportSchemaId = "com.absolutejs.voice.observability-export";
@@ -33097,7 +33131,7 @@ var verifyArtifact = async (artifact, options) => {
   }
   const filePath = stripArtifactPathAnchor(artifact.path);
   try {
-    const file = await stat(filePath);
+    const file = await stat2(filePath);
     const generatedAt = artifact.generatedAt ?? file.mtimeMs;
     const generatedAtMs = toEpochMs(generatedAt);
     const ageMs = generatedAtMs === undefined ? undefined : now - generatedAtMs;
@@ -33248,60 +33282,78 @@ var buildAuditEnvelope = (event, operationsRecordHref) => ({
 });
 var resolveObservabilityExportList = async (value) => typeof value === "function" ? await value() : value ?? [];
 var buildVoiceObservabilityExport = async (options = {}) => {
-  const events = options.events ?? await options.store?.list() ?? [];
-  const auditEvents = options.audit ? await options.audit.list() : [];
+  const time = async (label, run) => {
+    const startedAt = Date.now();
+    try {
+      return await run();
+    } finally {
+      const endedAt = Date.now();
+      options.onTiming?.({
+        durationMs: Math.max(0, endedAt - startedAt),
+        endedAt,
+        label,
+        startedAt
+      });
+    }
+  };
+  const events = await time("events", async () => options.events ?? await options.store?.list() ?? []);
+  const auditEvents = await time("auditEvents", async () => options.audit ? await options.audit.list() : []);
   const baseOperationsRecords = options.operationsRecords ?? [];
-  const [sessionSnapshots, callDebuggerReports] = await Promise.all([
+  const [sessionSnapshots, callDebuggerReports] = await time("supportArtifacts", () => Promise.all([
     resolveObservabilityExportList(options.sessionSnapshots),
     resolveObservabilityExportList(options.callDebuggerReports)
-  ]);
-  const sessionIds = collectSessionIds({
+  ]));
+  const sessionIds = await time("sessionIds", () => collectSessionIds({
     auditEvents,
     callDebuggerReports,
     events,
     operationsRecords: baseOperationsRecords,
     sessionIds: options.sessionIds,
     sessionSnapshots
-  });
+  }));
   const shouldBuildOperationsRecords = options.includeOperationsRecords === true && options.store;
-  const builtOperationsRecords = shouldBuildOperationsRecords ? await Promise.all(sessionIds.map((sessionId) => buildVoiceOperationsRecord({
+  const builtOperationsRecords = await time("operationsRecords", () => shouldBuildOperationsRecords ? Promise.all(sessionIds.map((sessionId) => buildVoiceOperationsRecord({
     audit: options.audit,
     redact: options.redact,
     sessionId,
     store: options.store
-  }))) : [];
+  }))) : []);
   const operationsRecords = [
     ...baseOperationsRecords,
     ...builtOperationsRecords.filter((record) => !baseOperationsRecords.some((existing) => existing.sessionId === record.sessionId))
   ];
-  const traceDeliveries = options.traceDeliveries ? isDeliveryStore(options.traceDeliveries) ? await options.traceDeliveries.list() : options.traceDeliveries : undefined;
-  const auditDeliveries = options.auditDeliveries ? isDeliveryStore(options.auditDeliveries) ? await options.auditDeliveries.list() : options.auditDeliveries : undefined;
-  const traceDeliverySummary = traceDeliveries ? await summarizeVoiceTraceSinkDeliveries(traceDeliveries) : undefined;
-  const auditDeliverySummary = auditDeliveries ? await summarizeVoiceAuditSinkDeliveries(auditDeliveries) : undefined;
-  const operationArtifacts = operationsRecords.map((record) => createOperationArtifact(record, options.links?.operationsRecord?.(record.sessionId)));
-  const sessionSnapshotArtifacts = sessionSnapshots.map((snapshot) => createSessionSnapshotArtifact(snapshot, options.links?.sessionSnapshot?.(snapshot.sessionId)));
-  const callDebuggerArtifacts = callDebuggerReports.map((report) => createCallDebuggerArtifact(report, options.links?.callDebugger?.(report.sessionId)));
-  const artifacts = addArtifactDownloadHrefs(await verifyArtifacts([
+  const [traceDeliveries, auditDeliveries] = await time("deliveries", () => Promise.all([
+    options.traceDeliveries ? isDeliveryStore(options.traceDeliveries) ? options.traceDeliveries.list() : options.traceDeliveries : undefined,
+    options.auditDeliveries ? isDeliveryStore(options.auditDeliveries) ? options.auditDeliveries.list() : options.auditDeliveries : undefined
+  ]));
+  const [traceDeliverySummary, auditDeliverySummary] = await time("deliverySummaries", () => Promise.all([
+    traceDeliveries ? summarizeVoiceTraceSinkDeliveries(traceDeliveries) : undefined,
+    auditDeliveries ? summarizeVoiceAuditSinkDeliveries(auditDeliveries) : undefined
+  ]));
+  const operationArtifacts = await time("operationArtifacts", () => operationsRecords.map((record) => createOperationArtifact(record, options.links?.operationsRecord?.(record.sessionId))));
+  const sessionSnapshotArtifacts = await time("sessionSnapshotArtifacts", () => sessionSnapshots.map((snapshot) => createSessionSnapshotArtifact(snapshot, options.links?.sessionSnapshot?.(snapshot.sessionId))));
+  const callDebuggerArtifacts = await time("callDebuggerArtifacts", () => callDebuggerReports.map((report) => createCallDebuggerArtifact(report, options.links?.callDebugger?.(report.sessionId))));
+  const artifacts = await time("artifacts", async () => addArtifactDownloadHrefs(await verifyArtifacts([
     ...operationArtifacts,
     ...sessionSnapshotArtifacts,
     ...callDebuggerArtifacts,
     ...options.artifacts ?? []
-  ], options.artifactIntegrity), options.links);
+  ], options.artifactIntegrity), options.links));
   const operationHrefBySessionId = new Map(sessionIds.map((sessionId) => [
     sessionId,
     options.links?.operationsRecord?.(sessionId)
   ]));
-  const envelopes = [
+  const envelopes = await time("envelopes", () => [
     ...events.map((event) => buildTraceEnvelope(event, operationHrefBySessionId.get(event.sessionId))),
     ...auditEvents.map((event) => buildAuditEnvelope(event, event.sessionId ? operationHrefBySessionId.get(event.sessionId) : undefined))
-  ].sort((left, right) => left.at - right.at);
-  const issues = collectIssues({
+  ].sort((left, right) => left.at - right.at));
+  const issues = await time("issues", () => collectIssues({
     artifacts,
     auditDeliveries: auditDeliverySummary,
     operationsRecords,
     totalEvidence: events.length + auditEvents.length + operationsRecords.length + artifacts.length,
     traceDeliveries: traceDeliverySummary
-  });
+  }));
   const status = issues.some((issue) => issue.severity === "fail") ? "fail" : issues.some((issue) => issue.severity === "warn") ? "warn" : "pass";
   return {
     artifacts,

package/dist/observabilityExport.d.ts

@@ -390,12 +390,19 @@ export type VoiceObservabilityExportOptions = {
     };
     callDebuggerReports?: VoiceCallDebuggerReport[] | (() => VoiceCallDebuggerReport[] | Promise<VoiceCallDebuggerReport[]>);
     operationsRecords?: VoiceOperationsRecord[];
+    onTiming?: (timing: VoiceObservabilityExportTiming) => void;
     redact?: VoiceTraceRedactionConfig;
     sessionIds?: string[];
     sessionSnapshots?: VoiceSessionSnapshot[] | (() => VoiceSessionSnapshot[] | Promise<VoiceSessionSnapshot[]>);
     store?: VoiceTraceEventStore;
     traceDeliveries?: VoiceTraceSinkDeliveryRecord[] | VoiceTraceSinkDeliveryStore;
 };
+export type VoiceObservabilityExportTiming = {
+    durationMs: number;
+    endedAt: number;
+    label: string;
+    startedAt: number;
+};
 export type VoiceObservabilityExportRoutesOptions = VoiceObservabilityExportOptions & {
     headers?: HeadersInit;
     artifactDownloadPath?: false | string;

package/dist/trace.d.ts

@@ -16,6 +16,7 @@ export type StoredVoiceTraceEvent<TPayload extends Record<string, unknown> = Rec
 };
 export type VoiceTraceEventFilter = {
     limit?: number;
+    readWindow?: 'recent';
     scenarioId?: string;
     sessionId?: string;
     traceId?: string;

package/package.json

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