@absolutejs/voice 0.0.22-beta.510 → 0.0.22-beta.512

package/dist/liveCoach.d.ts

@@ -0,0 +1,43 @@
+export type VoiceCoachNudgeKind = "hint" | "correction" | "warning" | "script-line" | "knowledge";
+export type VoiceCoachNudge = {
+    id: string;
+    sessionId: string;
+    supervisorId: string;
+    kind: VoiceCoachNudgeKind;
+    text: string;
+    createdAt: number;
+    injected: boolean;
+    injectedAt?: number;
+    acknowledged: boolean;
+    acknowledgedAt?: number;
+    expiresAt?: number;
+};
+export type VoiceCoachNudgeInjection = {
+    role: "system" | "developer";
+    content: string;
+    metadata: {
+        nudgeId: string;
+        supervisorId: string;
+        kind: VoiceCoachNudgeKind;
+    };
+};
+export type CreateVoiceLiveCoachOptions = {
+    sessionId: string;
+    injectionRole?: "system" | "developer";
+    templateForKind?: Partial<Record<VoiceCoachNudgeKind, string>>;
+    defaultExpiryMs?: number;
+    generateId?: () => string;
+    now?: () => number;
+};
+export declare const createVoiceLiveCoach: (options: CreateVoiceLiveCoachOptions) => {
+    acknowledge: (id: string) => boolean;
+    consumeForInjection: () => VoiceCoachNudgeInjection[];
+    history: () => VoiceCoachNudge[];
+    pending: () => VoiceCoachNudge[];
+    push: (input: Omit<VoiceCoachNudge, "id" | "createdAt" | "injected" | "acknowledged" | "sessionId"> & {
+        id?: string;
+    }) => VoiceCoachNudge;
+    sessionId: string;
+    subscribe(listener: (nudge: VoiceCoachNudge) => void): () => void;
+};
+export type VoiceLiveCoach = ReturnType<typeof createVoiceLiveCoach>;

package/dist/noShowPredictor.d.ts

@@ -0,0 +1,46 @@
+export type VoiceNoShowHistoricalRecord = {
+    appointmentId: string;
+    scheduledStartMs: number;
+    outcome: "kept" | "no-show" | "cancelled" | "rescheduled";
+};
+export type VoiceNoShowSignal = {
+    kind: "lead-time-hours";
+    value: number;
+} | {
+    kind: "weekday";
+    value: number;
+} | {
+    kind: "hour-of-day";
+    value: number;
+} | {
+    kind: "prior-no-show-count";
+    value: number;
+} | {
+    kind: "prior-kept-count";
+    value: number;
+} | {
+    kind: "reminder-confirmed";
+    value: boolean;
+} | {
+    kind: "callback-distance-hours";
+    value: number;
+} | {
+    kind: "weather-disruption";
+    value: boolean;
+};
+export type VoiceNoShowScoreInput = {
+    appointmentStartMs: number;
+    bookedAtMs: number;
+    history?: VoiceNoShowHistoricalRecord[];
+    reminderConfirmed?: boolean;
+    weatherDisruption?: boolean;
+    callbackDistanceHours?: number;
+    now?: () => number;
+};
+export type VoiceNoShowVerdict = {
+    score: number;
+    band: "low" | "moderate" | "high";
+    drivers: VoiceNoShowSignal[];
+};
+export declare const scoreVoiceNoShowRisk: (input: VoiceNoShowScoreInput) => VoiceNoShowVerdict;
+export declare const summarizeVoiceNoShowVerdict: (verdict: VoiceNoShowVerdict) => string;

package/dist/react/index.js

@@ -10,6 +10,19 @@ var __name = (target, name) => {
   });
   return target;
 };
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
 var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
 var __typeError = (msg) => {
   throw TypeError(msg);

package/dist/reminderScheduler.d.ts

@@ -0,0 +1,43 @@
+export type VoiceReminderChannel = "call" | "sms" | "email";
+export type VoiceReminderTrigger = {
+    id: string;
+    channel: VoiceReminderChannel;
+    offsetMinutesBeforeStart: number;
+    templateId?: string;
+    retryOnFailure?: boolean;
+};
+export type VoiceReminderJob = {
+    id: string;
+    appointmentId: string;
+    triggerId: string;
+    channel: VoiceReminderChannel;
+    scheduledAtMs: number;
+    status: "pending" | "in-flight" | "sent" | "skipped" | "failed" | "cancelled";
+    attempts: number;
+    lastError?: string;
+    metadata?: Record<string, string>;
+};
+export type ScheduleVoiceRemindersInput = {
+    appointmentId: string;
+    appointmentStartMs: number;
+    triggers: VoiceReminderTrigger[];
+    metadata?: Record<string, string>;
+};
+export type CreateVoiceReminderSchedulerOptions = {
+    generateJobId?: () => string;
+    now?: () => number;
+    defaultTriggers?: VoiceReminderTrigger[];
+    maxAttempts?: number;
+};
+export declare const DEFAULT_VOICE_REMINDER_TRIGGERS: VoiceReminderTrigger[];
+export declare const createVoiceReminderScheduler: (options?: CreateVoiceReminderSchedulerOptions) => {
+    cancelForAppointment: (appointmentId: string) => number;
+    due: (at?: number) => VoiceReminderJob[];
+    list: (appointmentId?: string) => VoiceReminderJob[];
+    markFailed: (jobId: string, error: string) => boolean;
+    markInFlight: (jobId: string) => boolean;
+    markSent: (jobId: string) => boolean;
+    schedule: (input: ScheduleVoiceRemindersInput) => VoiceReminderJob[];
+    subscribe(listener: (job: VoiceReminderJob) => void): () => void;
+};
+export type VoiceReminderScheduler = ReturnType<typeof createVoiceReminderScheduler>;

package/dist/supervisorPermissions.d.ts

@@ -0,0 +1,33 @@
+export type VoiceSupervisorCapability = "monitor" | "annotate" | "coach" | "whisper" | "barge" | "takeover" | "release" | "end-call" | "view-pii" | "export-recording";
+export type VoiceSupervisorTier = "monitor-only" | "annotate" | "coach" | "whisper" | "full-control";
+export type VoiceSupervisorPermission = {
+    supervisorId: string;
+    tier: VoiceSupervisorTier;
+    extraCapabilities?: VoiceSupervisorCapability[];
+    deniedCapabilities?: VoiceSupervisorCapability[];
+    expiresAt?: number;
+};
+export type VoiceSupervisorPermissionCheck = {
+    allowed: boolean;
+    reason?: "no-permission" | "expired" | "denied" | "tier-too-low";
+};
+export type CreateVoiceSupervisorPermissionsOptions = {
+    defaultTier?: VoiceSupervisorTier;
+    permissions?: VoiceSupervisorPermission[];
+    now?: () => number;
+};
+export declare const createVoiceSupervisorPermissions: (options?: CreateVoiceSupervisorPermissionsOptions) => {
+    can: (supervisorId: string, capability: VoiceSupervisorCapability) => VoiceSupervisorPermissionCheck;
+    capabilitiesFor: (supervisorId: string) => VoiceSupervisorCapability[];
+    enforce: (supervisorId: string, capability: VoiceSupervisorCapability) => void;
+    get: (supervisorId: string) => VoiceSupervisorPermission | null;
+    grant: (supervisorId: string, tier: VoiceSupervisorTier, options?: {
+        extraCapabilities?: VoiceSupervisorCapability[];
+        deniedCapabilities?: VoiceSupervisorCapability[];
+        expiresAt?: number;
+    }) => VoiceSupervisorPermission;
+    revoke: (supervisorId: string) => boolean;
+    tiers: () => VoiceSupervisorTier[];
+};
+export type VoiceSupervisorPermissions = ReturnType<typeof createVoiceSupervisorPermissions>;
+export declare const VOICE_SUPERVISOR_TIER_CAPABILITIES: Record<VoiceSupervisorTier, VoiceSupervisorCapability[]>;

package/dist/supervisorPresence.d.ts

@@ -0,0 +1,49 @@
+export type VoiceSupervisorRole = "viewer" | "coach" | "whisperer" | "owner";
+export type VoiceSupervisorWatcher = {
+    supervisorId: string;
+    sessionId: string;
+    joinedAt: number;
+    lastSeenAt: number;
+    role: VoiceSupervisorRole;
+    displayName?: string;
+};
+export type VoiceSupervisorPresenceEvent = {
+    type: "join";
+    watcher: VoiceSupervisorWatcher;
+} | {
+    type: "leave";
+    supervisorId: string;
+    sessionId: string;
+    at: number;
+} | {
+    type: "role-change";
+    supervisorId: string;
+    sessionId: string;
+    from: VoiceSupervisorRole;
+    to: VoiceSupervisorRole;
+    at: number;
+} | {
+    type: "heartbeat";
+    supervisorId: string;
+    sessionId: string;
+    at: number;
+};
+export type CreateVoiceSupervisorPresenceOptions = {
+    staleAfterMs?: number;
+    now?: () => number;
+};
+export declare const createVoiceSupervisorPresence: (options?: CreateVoiceSupervisorPresenceOptions) => {
+    heartbeat: (sessionId: string, supervisorId: string) => boolean;
+    join: (input: {
+        supervisorId: string;
+        sessionId: string;
+        role?: VoiceSupervisorRole;
+        displayName?: string;
+    }) => VoiceSupervisorWatcher;
+    leave: (sessionId: string, supervisorId: string) => boolean;
+    list: (sessionId: string) => VoiceSupervisorWatcher[];
+    setRole: (sessionId: string, supervisorId: string, role: VoiceSupervisorRole) => boolean;
+    sessionsWatchedBy(supervisorId: string): string[];
+    subscribe(listener: (event: VoiceSupervisorPresenceEvent) => void): () => void;
+};
+export type VoiceSupervisorPresence = ReturnType<typeof createVoiceSupervisorPresence>;

package/dist/svelte/index.js

@@ -10,6 +10,19 @@ var __name = (target, name) => {
   });
   return target;
 };
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
 var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
 var __typeError = (msg) => {
   throw TypeError(msg);

package/dist/testing/index.js

@@ -10,6 +10,19 @@ var __name = (target, name) => {
   });
   return target;
 };
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
 var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
 var __typeError = (msg) => {
   throw TypeError(msg);

package/dist/transcriptAnnotator.d.ts

@@ -0,0 +1,41 @@
+export type VoiceTranscriptAnnotationKind = "great-recovery" | "missed-objection" | "compliance-concern" | "tone-issue" | "knowledge-gap" | "follow-up-needed" | "custom";
+export type VoiceTranscriptAnnotation = {
+    id: string;
+    sessionId: string;
+    supervisorId: string;
+    kind: VoiceTranscriptAnnotationKind;
+    customLabel?: string;
+    text?: string;
+    turnId?: string;
+    rangeStartMs: number;
+    rangeEndMs?: number;
+    createdAt: number;
+    severity: "info" | "minor" | "major";
+};
+export type CreateVoiceTranscriptAnnotatorOptions = {
+    sessionId: string;
+    generateId?: () => string;
+    now?: () => number;
+};
+export declare const DEFAULT_VOICE_ANNOTATION_KIND_SEVERITY: Record<VoiceTranscriptAnnotationKind, VoiceTranscriptAnnotation["severity"]>;
+export declare const createVoiceTranscriptAnnotator: (options: CreateVoiceTranscriptAnnotatorOptions) => {
+    add: (input: Omit<VoiceTranscriptAnnotation, "id" | "createdAt" | "sessionId" | "severity"> & {
+        severity?: VoiceTranscriptAnnotation["severity"];
+        id?: string;
+    }) => VoiceTranscriptAnnotation;
+    list: (filter?: {
+        kind?: VoiceTranscriptAnnotationKind;
+        supervisorId?: string;
+        severity?: VoiceTranscriptAnnotation["severity"];
+        fromMs?: number;
+        toMs?: number;
+    }) => VoiceTranscriptAnnotation[];
+    remove: (id: string) => boolean;
+    sessionId: string;
+    summarize: () => {
+        byKind: Partial<Record<VoiceTranscriptAnnotationKind, number>>;
+        bySeverity: Record<"info" | "minor" | "major", number>;
+        total: number;
+    };
+};
+export type VoiceTranscriptAnnotator = ReturnType<typeof createVoiceTranscriptAnnotator>;

package/dist/vue/index.js

@@ -10,6 +10,19 @@ var __name = (target, name) => {
   });
   return target;
 };
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
 var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
 var __typeError = (msg) => {
   throw TypeError(msg);

package/dist/whisperChannel.d.ts

@@ -0,0 +1,50 @@
+export type VoiceWhisperFrame = {
+    sessionId: string;
+    supervisorId: string;
+    pcm: ArrayBuffer | Uint8Array;
+    sampleRate: number;
+    timestamp: number;
+};
+export type VoiceWhisperRoute = "agent-only" | "agent-and-caller" | "drop";
+export type VoiceWhisperEvent = {
+    type: "started";
+    supervisorId: string;
+    at: number;
+} | {
+    type: "stopped";
+    supervisorId: string;
+    at: number;
+} | {
+    type: "frame";
+    frame: VoiceWhisperFrame;
+} | {
+    type: "ducked";
+    supervisorId: string;
+    level: number;
+    at: number;
+};
+export type CreateVoiceWhisperChannelOptions = {
+    sessionId: string;
+    defaultRoute?: VoiceWhisperRoute;
+    duckCallerToLevel?: number;
+    maxConcurrentWhispers?: number;
+    now?: () => number;
+};
+type ActiveWhisper = {
+    supervisorId: string;
+    route: VoiceWhisperRoute;
+    startedAt: number;
+};
+export declare const createVoiceWhisperChannel: (options: CreateVoiceWhisperChannelOptions) => {
+    activeSupervisors: () => string[];
+    isWhispering: (supervisorId: string) => boolean;
+    pushFrame: (frame: VoiceWhisperFrame) => VoiceWhisperRoute;
+    routeFor: (supervisorId: string) => VoiceWhisperRoute | null;
+    sessionId: string;
+    setRoute(supervisorId: string, route: VoiceWhisperRoute): boolean;
+    start: (supervisorId: string, route?: VoiceWhisperRoute) => ActiveWhisper | undefined;
+    stop: (supervisorId: string) => boolean;
+    subscribe(listener: (event: VoiceWhisperEvent) => void): () => void;
+};
+export type VoiceWhisperChannel = ReturnType<typeof createVoiceWhisperChannel>;
+export {};

package/package.json

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