@absolutejs/voice 0.0.22-beta.368 → 0.0.22-beta.369

package/README.md

@@ -1486,6 +1486,22 @@ app.use(
 
 The point is not to benchmark a fake demo once. The point is to let every real call add profile evidence so `/api/voice/real-call-profile-history`, provider recommendations, profile-switch readiness, and operations records can explain which provider/runtime path is winning for each call shape.
 
+Use `createVoiceProfileTraceTagger(...)` when the app already has a trace store and needs every appended trace to carry a benchmark profile label. It wraps any `VoiceTraceEventStore`, preserves the underlying store behavior, and adds `profileId`/`benchmarkProfileId` metadata and payload fields that real-call profile history can ingest later.
+
+```ts
+import { createVoiceProfileTraceTagger } from '@absolutejs/voice';
+
+const trace = createVoiceProfileTraceTagger({
+	defaultProfile: {
+		id: 'meeting-recorder',
+		label: 'Meeting recorder'
+	},
+	resolveProfile: (event) =>
+		event.sessionId.startsWith('support-') ? 'support-agent' : undefined,
+	store: runtime.traces
+});
+```
+
 Built-in profiles:
 
 - `meeting-recorder`: live latency, session health, provider fallback, routing contracts, reconnect proof, and barge-in interruption proof.

package/dist/client/index.js

@@ -6081,6 +6081,46 @@ var createVoiceTraceSinkStore = (options) => {
     remove: (id) => options.store.remove(id)
   };
 };
+var normalizeVoiceProfileTraceTaggerProfile = (profile) => typeof profile === "string" ? { id: profile } : profile?.id ? profile : undefined;
+var createVoiceProfileTraceTagger = (options) => {
+  const profiles = new Map((options.profiles ?? []).map((profile) => [profile.id, profile]));
+  const defaultProfile = normalizeVoiceProfileTraceTaggerProfile(options.defaultProfile);
+  const resolveProfile = async (event) => {
+    const resolved = normalizeVoiceProfileTraceTaggerProfile(await options.resolveProfile?.(event));
+    const profile = resolved ?? defaultProfile;
+    return profile ? profiles.get(profile.id) ?? profile : undefined;
+  };
+  return {
+    append: async (event) => {
+      const profile = await resolveProfile(event);
+      if (!profile) {
+        return options.store.append(event);
+      }
+      const metadata = {
+        ...event.metadata ?? {},
+        benchmarkProfileId: profile.id,
+        profileDescription: event.metadata?.profileDescription ?? profile.description,
+        profileId: profile.id,
+        profileLabel: event.metadata?.profileLabel ?? profile.label
+      };
+      const payload = event.payload && typeof event.payload === "object" ? {
+        ...event.payload,
+        benchmarkProfileId: event.payload.benchmarkProfileId ?? profile.id,
+        profileDescription: event.payload.profileDescription ?? profile.description,
+        profileId: event.payload.profileId ?? profile.id,
+        profileLabel: event.payload.profileLabel ?? profile.label
+      } : event.payload;
+      return options.store.append({
+        ...event,
+        metadata,
+        payload
+      });
+    },
+    get: (id) => options.store.get(id),
+    list: (filter) => options.store.list(filter),
+    remove: (id) => options.store.remove(id)
+  };
+};
 var createVoiceMemoryTraceSinkDeliveryStore = () => {
   const deliveries = new Map;
   return {

package/dist/index.d.ts

@@ -86,7 +86,7 @@ export { createVoiceOpsStatusRoutes, renderVoiceOpsStatusHTML } from './opsStatu
 export { createVoiceQualityRoutes, evaluateVoiceQuality, renderVoiceQualityHTML } from './qualityRoutes';
 export { createVoiceResilienceRoutes, createVoiceRoutingDecisionSummary, listVoiceRoutingEvents, renderVoiceResilienceHTML, summarizeVoiceRoutingDecision, summarizeVoiceRoutingSessions } from './resilienceRoutes';
 export { createVoiceSTTProviderRouter, createVoiceTTSProviderRouter } from './providerAdapters';
-export { buildVoiceTraceReplay, createVoiceMemoryTraceSinkDeliveryStore, createVoiceTraceHTTPSink, createVoiceTraceS3Sink, createVoiceMemoryTraceEventStore, createVoiceTraceSinkDeliveryId, createVoiceTraceSinkDeliveryRecord, createVoiceTraceSinkStore, createVoiceTraceEvent, createVoiceTraceEventId, deliverVoiceTraceEventsToSinks, evaluateVoiceTrace, exportVoiceTrace, filterVoiceTraceEvents, pruneVoiceTraceEvents, redactVoiceTraceEvent, redactVoiceTraceEvents, redactVoiceTraceText, renderVoiceTraceHTML, renderVoiceTraceMarkdown, resolveVoiceTraceRedactionOptions, selectVoiceTraceEventsForPrune, summarizeVoiceTrace } from './trace';
+export { buildVoiceTraceReplay, createVoiceMemoryTraceSinkDeliveryStore, createVoiceProfileTraceTagger, createVoiceTraceHTTPSink, createVoiceTraceS3Sink, createVoiceMemoryTraceEventStore, createVoiceTraceSinkDeliveryId, createVoiceTraceSinkDeliveryRecord, createVoiceTraceSinkStore, createVoiceTraceEvent, createVoiceTraceEventId, deliverVoiceTraceEventsToSinks, evaluateVoiceTrace, exportVoiceTrace, filterVoiceTraceEvents, pruneVoiceTraceEvents, redactVoiceTraceEvent, redactVoiceTraceEvents, redactVoiceTraceText, renderVoiceTraceHTML, renderVoiceTraceMarkdown, resolveVoiceTraceRedactionOptions, selectVoiceTraceEventsForPrune, summarizeVoiceTrace } from './trace';
 export { buildVoiceTraceDeliveryReport, createVoiceTraceDeliveryHTMLHandler, createVoiceTraceDeliveryJSONHandler, createVoiceTraceDeliveryRoutes, renderVoiceTraceDeliveryHTML, resolveVoiceTraceDeliveryFilter } from './traceDeliveryRoutes';
 export { createVoiceTraceTimelineRoutes, renderVoiceTraceTimelineHTML, renderVoiceTraceTimelineSessionHTML, summarizeVoiceTraceTimeline } from './traceTimeline';
 export { createVoiceSQLiteAuditEventStore, createVoiceSQLiteAuditSinkDeliveryStore, createVoiceSQLiteCampaignStore, createVoiceSQLiteExternalObjectMapStore, createVoiceSQLiteIntegrationEventStore, createVoiceSQLiteReviewStore, createVoiceSQLiteRuntimeStorage, createVoiceSQLiteSessionStore, createVoiceSQLiteTaskStore, createVoiceSQLiteTelephonyWebhookIdempotencyStore, createVoiceSQLiteTraceSinkDeliveryStore, createVoiceSQLiteTraceEventStore } from './sqliteStore';
@@ -174,7 +174,7 @@ export type { VoiceAuditExport } from './auditExport';
 export type { VoiceAuditHTTPSinkOptions, VoiceAuditS3SinkOptions, VoiceS3AuditSinkClient, VoiceS3AuditSinkFile, VoiceAuditSink, VoiceAuditSinkDeliveryQueueStatus, VoiceAuditSinkDeliveryQueueSummary, VoiceAuditSinkDeliveryRecord, VoiceAuditSinkDeliveryResult, VoiceAuditSinkDeliveryStatus, VoiceAuditSinkDeliveryStore, VoiceAuditSinkDeliveryWorkerLoop, VoiceAuditSinkDeliveryWorkerLoopOptions, VoiceAuditSinkDeliveryWorkerOptions, VoiceAuditSinkDeliveryWorkerResult, VoiceAuditSinkFanoutResult, VoiceAuditSinkStoreOptions } from './auditSinks';
 export type { VoiceAuditDeliveryDrainReport, VoiceAuditDeliveryDrainWorker, VoiceAuditDeliveryFilter, VoiceAuditDeliveryReport, VoiceAuditDeliveryRoutesOptions } from './auditDeliveryRoutes';
 export type { VoiceFileRuntimeStorage, VoiceFileStoreOptions } from './fileStore';
-export type { StoredVoiceTraceEvent, VoiceTraceEvaluation, VoiceTraceEvaluationOptions, VoiceTraceEvent, VoiceTraceEventFilter, VoiceTraceEventStore, VoiceTraceEventType, VoiceTraceIssue, VoiceTraceIssueSeverity, VoiceTraceHTTPSinkOptions, VoiceTraceS3SinkOptions, VoiceTracePruneFilter, VoiceTracePruneOptions, VoiceTracePruneResult, VoiceTraceRedactionConfig, VoiceTraceRedactionOptions, VoiceTraceRedactionReplacement, VoiceResolvedTraceRedactionOptions, VoiceTraceSink, VoiceTraceSinkDeliveryQueueStatus, VoiceTraceSinkDeliveryRecord, VoiceTraceSinkDeliveryResult, VoiceTraceSinkDeliveryStatus, VoiceTraceSinkDeliveryStore, VoiceTraceSinkFanoutResult, VoiceTraceSinkStoreOptions, VoiceTraceSummary, VoiceS3TraceSinkClient, VoiceS3TraceSinkFile } from './trace';
+export type { VoiceProfileTraceTaggerOptions, VoiceProfileTraceTaggerProfile, StoredVoiceTraceEvent, VoiceTraceEvaluation, VoiceTraceEvaluationOptions, VoiceTraceEvent, VoiceTraceEventFilter, VoiceTraceEventStore, VoiceTraceEventType, VoiceTraceIssue, VoiceTraceIssueSeverity, VoiceTraceHTTPSinkOptions, VoiceTraceS3SinkOptions, VoiceTracePruneFilter, VoiceTracePruneOptions, VoiceTracePruneResult, VoiceTraceRedactionConfig, VoiceTraceRedactionOptions, VoiceTraceRedactionReplacement, VoiceResolvedTraceRedactionOptions, VoiceTraceSink, VoiceTraceSinkDeliveryQueueStatus, VoiceTraceSinkDeliveryRecord, VoiceTraceSinkDeliveryResult, VoiceTraceSinkDeliveryStatus, VoiceTraceSinkDeliveryStore, VoiceTraceSinkFanoutResult, VoiceTraceSinkStoreOptions, VoiceTraceSummary, VoiceS3TraceSinkClient, VoiceS3TraceSinkFile } from './trace';
 export type { VoiceTraceDeliveryDrainReport, VoiceTraceDeliveryDrainWorker, VoiceTraceDeliveryFilter, VoiceTraceDeliveryReport, VoiceTraceDeliveryRoutesOptions } from './traceDeliveryRoutes';
 export type { VoiceTraceTimelineEvent, VoiceTraceTimelineProviderSummary, VoiceTraceTimelineReport, VoiceTraceTimelineRoutesOptions, VoiceTraceTimelineSession } from './traceTimeline';
 export type { VoicePostgresClient, VoicePostgresRuntimeStorage, VoicePostgresStoreOptions } from './postgresStore';

package/dist/index.js

@@ -10096,6 +10096,46 @@ var createVoiceTraceSinkStore = (options) => {
     remove: (id) => options.store.remove(id)
   };
 };
+var normalizeVoiceProfileTraceTaggerProfile = (profile) => typeof profile === "string" ? { id: profile } : profile?.id ? profile : undefined;
+var createVoiceProfileTraceTagger = (options) => {
+  const profiles = new Map((options.profiles ?? []).map((profile) => [profile.id, profile]));
+  const defaultProfile = normalizeVoiceProfileTraceTaggerProfile(options.defaultProfile);
+  const resolveProfile = async (event) => {
+    const resolved = normalizeVoiceProfileTraceTaggerProfile(await options.resolveProfile?.(event));
+    const profile = resolved ?? defaultProfile;
+    return profile ? profiles.get(profile.id) ?? profile : undefined;
+  };
+  return {
+    append: async (event) => {
+      const profile = await resolveProfile(event);
+      if (!profile) {
+        return options.store.append(event);
+      }
+      const metadata = {
+        ...event.metadata ?? {},
+        benchmarkProfileId: profile.id,
+        profileDescription: event.metadata?.profileDescription ?? profile.description,
+        profileId: profile.id,
+        profileLabel: event.metadata?.profileLabel ?? profile.label
+      };
+      const payload = event.payload && typeof event.payload === "object" ? {
+        ...event.payload,
+        benchmarkProfileId: event.payload.benchmarkProfileId ?? profile.id,
+        profileDescription: event.payload.profileDescription ?? profile.description,
+        profileId: event.payload.profileId ?? profile.id,
+        profileLabel: event.payload.profileLabel ?? profile.label
+      } : event.payload;
+      return options.store.append({
+        ...event,
+        metadata,
+        payload
+      });
+    },
+    get: (id) => options.store.get(id),
+    list: (filter) => options.store.list(filter),
+    remove: (id) => options.store.remove(id)
+  };
+};
 var createVoiceMemoryTraceSinkDeliveryStore = () => {
   const deliveries = new Map;
   return {
@@ -38597,6 +38637,7 @@ export {
   createVoiceProviderCapabilityHTMLHandler,
   createVoiceProofTrendRoutes,
   createVoiceProofTrendRecommendationRoutes,
+  createVoiceProfileTraceTagger,
   createVoiceProfileSwitchReadinessRoutes,
   createVoiceProfileSwitchPolicyProofRoutes,
   createVoiceProfileSwitchLiveDecisionRoutes,

package/dist/svelte/index.js

@@ -1359,6 +1359,46 @@ var createVoiceTraceSinkStore = (options) => {
     remove: (id) => options.store.remove(id)
   };
 };
+var normalizeVoiceProfileTraceTaggerProfile = (profile) => typeof profile === "string" ? { id: profile } : profile?.id ? profile : undefined;
+var createVoiceProfileTraceTagger = (options) => {
+  const profiles = new Map((options.profiles ?? []).map((profile) => [profile.id, profile]));
+  const defaultProfile = normalizeVoiceProfileTraceTaggerProfile(options.defaultProfile);
+  const resolveProfile = async (event) => {
+    const resolved = normalizeVoiceProfileTraceTaggerProfile(await options.resolveProfile?.(event));
+    const profile = resolved ?? defaultProfile;
+    return profile ? profiles.get(profile.id) ?? profile : undefined;
+  };
+  return {
+    append: async (event) => {
+      const profile = await resolveProfile(event);
+      if (!profile) {
+        return options.store.append(event);
+      }
+      const metadata = {
+        ...event.metadata ?? {},
+        benchmarkProfileId: profile.id,
+        profileDescription: event.metadata?.profileDescription ?? profile.description,
+        profileId: profile.id,
+        profileLabel: event.metadata?.profileLabel ?? profile.label
+      };
+      const payload = event.payload && typeof event.payload === "object" ? {
+        ...event.payload,
+        benchmarkProfileId: event.payload.benchmarkProfileId ?? profile.id,
+        profileDescription: event.payload.profileDescription ?? profile.description,
+        profileId: event.payload.profileId ?? profile.id,
+        profileLabel: event.payload.profileLabel ?? profile.label
+      } : event.payload;
+      return options.store.append({
+        ...event,
+        metadata,
+        payload
+      });
+    },
+    get: (id) => options.store.get(id),
+    list: (filter) => options.store.list(filter),
+    remove: (id) => options.store.remove(id)
+  };
+};
 var createVoiceMemoryTraceSinkDeliveryStore = () => {
   const deliveries = new Map;
   return {

package/dist/testing/index.js

@@ -9524,6 +9524,46 @@ var createVoiceTraceSinkStore = (options) => {
     remove: (id) => options.store.remove(id)
   };
 };
+var normalizeVoiceProfileTraceTaggerProfile = (profile) => typeof profile === "string" ? { id: profile } : profile?.id ? profile : undefined;
+var createVoiceProfileTraceTagger = (options) => {
+  const profiles = new Map((options.profiles ?? []).map((profile) => [profile.id, profile]));
+  const defaultProfile = normalizeVoiceProfileTraceTaggerProfile(options.defaultProfile);
+  const resolveProfile = async (event) => {
+    const resolved = normalizeVoiceProfileTraceTaggerProfile(await options.resolveProfile?.(event));
+    const profile = resolved ?? defaultProfile;
+    return profile ? profiles.get(profile.id) ?? profile : undefined;
+  };
+  return {
+    append: async (event) => {
+      const profile = await resolveProfile(event);
+      if (!profile) {
+        return options.store.append(event);
+      }
+      const metadata = {
+        ...event.metadata ?? {},
+        benchmarkProfileId: profile.id,
+        profileDescription: event.metadata?.profileDescription ?? profile.description,
+        profileId: profile.id,
+        profileLabel: event.metadata?.profileLabel ?? profile.label
+      };
+      const payload = event.payload && typeof event.payload === "object" ? {
+        ...event.payload,
+        benchmarkProfileId: event.payload.benchmarkProfileId ?? profile.id,
+        profileDescription: event.payload.profileDescription ?? profile.description,
+        profileId: event.payload.profileId ?? profile.id,
+        profileLabel: event.payload.profileLabel ?? profile.label
+      } : event.payload;
+      return options.store.append({
+        ...event,
+        metadata,
+        payload
+      });
+    },
+    get: (id) => options.store.get(id),
+    list: (filter) => options.store.list(filter),
+    remove: (id) => options.store.remove(id)
+  };
+};
 var createVoiceMemoryTraceSinkDeliveryStore = () => {
   const deliveries = new Map;
   return {

package/dist/trace.d.ts

@@ -127,6 +127,17 @@ export type VoiceTraceSinkStoreOptions<TEvent extends StoredVoiceTraceEvent = St
     sinks: VoiceTraceSink[];
     store: VoiceTraceEventStore<TEvent>;
 };
+export type VoiceProfileTraceTaggerProfile = {
+    description?: string;
+    id: string;
+    label?: string;
+};
+export type VoiceProfileTraceTaggerOptions<TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent> = {
+    defaultProfile?: VoiceProfileTraceTaggerProfile | string;
+    profiles?: readonly VoiceProfileTraceTaggerProfile[];
+    resolveProfile?: (event: VoiceTraceEvent | TEvent) => Promise<VoiceProfileTraceTaggerProfile | string | undefined> | VoiceProfileTraceTaggerProfile | string | undefined;
+    store: VoiceTraceEventStore<TEvent>;
+};
 export type VoiceTraceSummary = {
     assistantReplyCount: number;
     callDurationMs?: number;
@@ -211,6 +222,7 @@ export declare const deliverVoiceTraceEventsToSinks: (input: {
     sinks: VoiceTraceSink[];
 }) => Promise<VoiceTraceSinkFanoutResult>;
 export declare const createVoiceTraceSinkStore: <TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent>(options: VoiceTraceSinkStoreOptions<TEvent>) => VoiceTraceEventStore<TEvent>;
+export declare const createVoiceProfileTraceTagger: <TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent>(options: VoiceProfileTraceTaggerOptions<TEvent>) => VoiceTraceEventStore<TEvent>;
 export declare const createVoiceMemoryTraceSinkDeliveryStore: <TDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord>() => VoiceTraceSinkDeliveryStore<TDelivery>;
 export declare const createVoiceMemoryTraceEventStore: <TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent>() => VoiceTraceEventStore<TEvent>;
 export declare const exportVoiceTrace: (input: {

package/package.json

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