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

package/dist/pathway.d.ts

@@ -0,0 +1,94 @@
+export type VoicePathwaySlotType = "string" | "number" | "boolean" | "date" | "time" | "phone" | "email" | "currency" | "choice";
+export type VoicePathwaySlot = {
+    id: string;
+    type: VoicePathwaySlotType;
+    prompt: string;
+    required?: boolean;
+    choices?: string[];
+    description?: string;
+    validation?: {
+        minLength?: number;
+        maxLength?: number;
+        pattern?: string;
+        min?: number;
+        max?: number;
+    };
+};
+export type VoicePathwayCondition = {
+    kind: "slot-equals";
+    slotId: string;
+    value: string | number | boolean;
+} | {
+    kind: "slot-filled";
+    slotId: string;
+} | {
+    kind: "slot-matches";
+    slotId: string;
+    pattern: string;
+} | {
+    kind: "always";
+} | {
+    kind: "fallback";
+};
+export type VoicePathwayAction = {
+    kind: "say";
+    text: string;
+} | {
+    kind: "collect-slot";
+    slotId: string;
+} | {
+    kind: "call-tool";
+    toolId: string;
+    argsFromSlots?: string[];
+} | {
+    kind: "set-slot";
+    slotId: string;
+    valueExpression: string;
+} | {
+    kind: "transfer";
+    destination: string;
+} | {
+    kind: "end-call";
+    reason?: string;
+};
+export type VoicePathwayTransition = {
+    to: string;
+    condition: VoicePathwayCondition;
+    description?: string;
+};
+export type VoicePathwayState = {
+    id: string;
+    label: string;
+    kind?: "entry" | "collect" | "branch" | "action" | "terminal";
+    description?: string;
+    systemNote?: string;
+    actions?: VoicePathwayAction[];
+    transitions: VoicePathwayTransition[];
+};
+export type VoicePathway = {
+    id: string;
+    label: string;
+    entryStateId: string;
+    states: VoicePathwayState[];
+    slots: VoicePathwaySlot[];
+    tools?: {
+        id: string;
+        description: string;
+    }[];
+    metadata?: Record<string, string>;
+};
+export type VoicePathwayValidationIssue = {
+    severity: "error" | "warning";
+    code: "duplicate-state" | "duplicate-slot" | "unknown-entry" | "unreachable-state" | "missing-transition-target" | "missing-slot-ref" | "no-terminal-reachable" | "fallback-not-last" | "duplicate-transition";
+    message: string;
+    stateId?: string;
+    slotId?: string;
+};
+export type VoicePathwayValidationReport = {
+    valid: boolean;
+    issues: VoicePathwayValidationIssue[];
+    reachableStates: string[];
+};
+export declare const validateVoicePathway: (pathway: VoicePathway) => VoicePathwayValidationReport;
+export declare const findVoicePathwayState: (pathway: VoicePathway, id: string) => VoicePathwayState | null;
+export declare const findVoicePathwaySlot: (pathway: VoicePathway, id: string) => VoicePathwaySlot | null;

package/dist/pathwayCompiler.d.ts

@@ -0,0 +1,31 @@
+import { type VoicePathway } from "./pathway";
+export type VoicePathwayCompilerToolDefinition = {
+    name: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: Record<string, {
+            type: string;
+            description?: string;
+            enum?: string[];
+        }>;
+        required: string[];
+    };
+};
+export type VoicePathwayCompiledAssistant = {
+    systemPrompt: string;
+    tools: VoicePathwayCompilerToolDefinition[];
+    initialPrompt?: string;
+    metadata: {
+        pathwayId: string;
+        pathwayLabel: string;
+        entryStateId: string;
+    };
+};
+export type CompileVoicePathwayOptions = {
+    pathway: VoicePathway;
+    introduction?: string;
+    fallbackBehavior?: "stay" | "end-call" | "transfer";
+    toolNamePrefix?: string;
+};
+export declare const compileVoicePathwayToAssistant: (options: CompileVoicePathwayOptions) => VoicePathwayCompiledAssistant;

package/dist/pathwayRuntime.d.ts

@@ -0,0 +1,57 @@
+import { type VoicePathway, type VoicePathwayAction } from "./pathway";
+export type VoicePathwaySlotValue = string | number | boolean | null;
+export type VoicePathwayRuntimeStatus = "ready" | "awaiting-slot" | "branching" | "ended" | "errored";
+export type VoicePathwayRuntimeState = {
+    currentStateId: string;
+    status: VoicePathwayRuntimeStatus;
+    slots: Record<string, VoicePathwaySlotValue>;
+    awaitingSlotId: string | null;
+    history: {
+        stateId: string;
+        at: number;
+    }[];
+    pendingActions: VoicePathwayAction[];
+    lastError?: string;
+    endedReason?: string;
+};
+export type VoicePathwayToolCall = {
+    toolId: string;
+    args: Record<string, VoicePathwaySlotValue>;
+};
+export type VoicePathwayRuntimeEvent = {
+    type: "say";
+    text: string;
+} | {
+    type: "ask-slot";
+    slotId: string;
+    prompt: string;
+} | {
+    type: "tool-call";
+    call: VoicePathwayToolCall;
+} | {
+    type: "transfer";
+    destination: string;
+} | {
+    type: "end-call";
+    reason?: string;
+} | {
+    type: "state-entered";
+    stateId: string;
+} | {
+    type: "errored";
+    message: string;
+};
+export type CreateVoicePathwayRuntimeOptions = {
+    pathway: VoicePathway;
+    initialSlots?: Record<string, VoicePathwaySlotValue>;
+    now?: () => number;
+    skipValidation?: boolean;
+};
+export declare const createVoicePathwayRuntime: (options: CreateVoicePathwayRuntimeOptions) => {
+    fillSlot: (slotId: string, value: VoicePathwaySlotValue) => void;
+    getState: () => VoicePathwayRuntimeState;
+    start: () => void;
+    subscribe(listener: (event: VoicePathwayRuntimeEvent) => void): () => void;
+    tryTransition: () => void;
+};
+export type VoicePathwayRuntime = ReturnType<typeof createVoicePathwayRuntime>;

package/dist/pathwaySlotCollector.d.ts

@@ -0,0 +1,29 @@
+import type { VoicePathwaySlot, VoicePathwaySlotType } from "./pathway";
+import type { VoicePathwaySlotValue } from "./pathwayRuntime";
+export type VoicePathwaySlotParseResult = {
+    ok: true;
+    value: VoicePathwaySlotValue;
+    normalized: string;
+} | {
+    ok: false;
+    reason: "empty" | "type-mismatch" | "out-of-range" | "no-match";
+    hint?: string;
+};
+export type VoicePathwaySlotParser = (raw: string, slot: VoicePathwaySlot) => VoicePathwaySlotParseResult;
+export declare const DEFAULT_VOICE_PATHWAY_SLOT_PARSERS: Record<VoicePathwaySlotType, VoicePathwaySlotParser>;
+export type CreateVoicePathwaySlotCollectorOptions = {
+    parsers?: Partial<Record<VoicePathwaySlotType, VoicePathwaySlotParser>>;
+    maxAttemptsPerSlot?: number;
+};
+export type VoicePathwaySlotCollectorAttempt = {
+    slotId: string;
+    raw: string;
+    result: VoicePathwaySlotParseResult;
+    attempt: number;
+};
+export declare const createVoicePathwaySlotCollector: (options?: CreateVoicePathwaySlotCollectorOptions) => {
+    attemptsExceeded: (slotId: string) => boolean;
+    interpret: (slot: VoicePathwaySlot, raw: string) => VoicePathwaySlotCollectorAttempt;
+    reset: (slotId?: string) => void;
+};
+export type VoicePathwaySlotCollector = ReturnType<typeof createVoicePathwaySlotCollector>;

package/dist/pathwayVisualizer.d.ts

@@ -0,0 +1,8 @@
+import type { VoicePathway } from "./pathway";
+export declare const renderVoicePathwayMermaid: (pathway: VoicePathway) => string;
+export declare const renderVoicePathwayText: (pathway: VoicePathway) => string;
+export type VoicePathwayVisualization = {
+    mermaid: string;
+    text: string;
+};
+export declare const visualizeVoicePathway: (pathway: VoicePathway) => VoicePathwayVisualization;

package/dist/qualityDriftDetector.d.ts

@@ -0,0 +1,44 @@
+import type { VoiceScorecard } from "./callScorecard";
+export type VoiceQualityDriftSeverity = "ok" | "watch" | "regression";
+export type VoiceQualityDriftCriterionAlert = {
+    criterionId: string;
+    baselineAverage: number;
+    currentAverage: number;
+    delta: number;
+    severity: VoiceQualityDriftSeverity;
+};
+export type VoiceQualityDriftReport = {
+    rubricId: string;
+    scope: {
+        from: number;
+        to: number;
+    };
+    baselineWindow: {
+        from: number;
+        to: number;
+        sampleSize: number;
+    };
+    currentWindow: {
+        from: number;
+        to: number;
+        sampleSize: number;
+    };
+    overall: {
+        baselineAverage: number;
+        currentAverage: number;
+        delta: number;
+        severity: VoiceQualityDriftSeverity;
+    };
+    criteria: VoiceQualityDriftCriterionAlert[];
+    alertCount: number;
+};
+export type DetectVoiceQualityDriftInput = {
+    rubricId: string;
+    scorecards: VoiceScorecard[];
+    baselineWindowMs?: number;
+    currentWindowMs?: number;
+    now?: () => number;
+    watchThreshold?: number;
+    regressionThreshold?: number;
+};
+export declare const detectVoiceQualityDrift: (input: DetectVoiceQualityDriftInput) => VoiceQualityDriftReport;

package/dist/scorecardCalibration.d.ts

@@ -0,0 +1,31 @@
+import type { VoiceScorecard } from "./callScorecard";
+export type VoiceScorecardCalibrationPair = {
+    sessionId: string;
+    human: VoiceScorecard;
+    llm: VoiceScorecard;
+};
+export type VoiceScorecardCalibrationDivergence = {
+    sessionId: string;
+    criterionId: string;
+    humanScore: number;
+    llmScore: number;
+    normalizedGap: number;
+};
+export type VoiceScorecardCalibrationReport = {
+    pairsCompared: number;
+    meanAbsoluteError: number;
+    rootMeanSquareError: number;
+    weightedScoreCorrelation: number;
+    gradeAgreementRate: number;
+    perCriterion: {
+        criterionId: string;
+        meanAbsoluteError: number;
+        averageHumanScore: number;
+        averageLLMScore: number;
+        bias: number;
+    }[];
+    worstDivergences: VoiceScorecardCalibrationDivergence[];
+};
+export declare const computeVoiceScorecardCalibration: (pairs: VoiceScorecardCalibrationPair[], options?: {
+    topDivergences?: number;
+}) => VoiceScorecardCalibrationReport;

package/dist/vue/VoiceCostDashboard.d.ts

@@ -53,5 +53,5 @@ export declare const VoiceCostDashboard: import("vue").DefineComponent<import("v
     title: string;
     currency: string;
     emptyMessage: string;
-    bucketBy: "day" | "hour" | "month" | undefined;
+    bucketBy: "day" | "month" | "hour" | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/package.json

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