@edvak99/voice-receptionist-widget 1.0.0 → 1.1.0

package/lib/knowledge/services/practice-faq-api.service.d.ts

@@ -0,0 +1,22 @@
+import { Observable } from 'rxjs';
+import { CreatePracticeFaqRequest, PracticeFaq, PracticeFaqSearchResult, UpdatePracticeFaqRequest } from '../models/practice-faq.model';
+import * as i0 from "@angular/core";
+export declare class PracticeFaqApiService {
+    private readonly http;
+    private readonly mock;
+    private readonly config;
+    private readonly paths;
+    private readonly base;
+    private get useMock();
+    list(activeOnly?: boolean): Observable<PracticeFaq[]>;
+    get(faqId: string): Observable<PracticeFaq | null>;
+    create(body: CreatePracticeFaqRequest): Observable<PracticeFaq>;
+    update(faqId: string, body: UpdatePracticeFaqRequest): Observable<PracticeFaq>;
+    delete(faqId: string): Observable<{
+        success: boolean;
+    }>;
+    search(q: string, limit?: number): Observable<PracticeFaqSearchResult>;
+    private asList;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PracticeFaqApiService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PracticeFaqApiService>;
+}

package/lib/knowledge/utils/faq.util.d.ts

@@ -0,0 +1,3 @@
+export declare function categoryBadgeClass(category: string | null): string;
+export declare function truncateText(text: string, max?: number): string;
+export declare function scorePercent(score: number): number;

package/lib/layout/eds-app-rail.component.d.ts

@@ -0,0 +1,6 @@
+import * as i0 from "@angular/core";
+export declare class EdsAppRailComponent {
+    protected readonly includePracticeNav: boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EdsAppRailComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EdsAppRailComponent, "eds-app-rail", never, {}, {}, never, never, true, never>;
+}

package/lib/layout/eds-app-shell.component.d.ts

@@ -0,0 +1,5 @@
+import * as i0 from "@angular/core";
+export declare class EdsAppShellComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<EdsAppShellComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EdsAppShellComponent, "eds-app-shell", never, {}, {}, never, never, true, never>;
+}

package/lib/layout/eds-module-nav.component.d.ts

@@ -0,0 +1,24 @@
+import * as i0 from "@angular/core";
+interface NavItem {
+    id: string;
+    label: string;
+    icon: string;
+    route: string;
+    badge?: number;
+    pulse?: boolean;
+    adminOnly?: boolean;
+}
+export declare class EdsModuleNavComponent {
+    private readonly config;
+    private readonly session;
+    private readonly agentOnline;
+    protected readonly agentOn: import("@angular/core").Signal<import("../services/agent-online.service").AgentOnlineKnownState>;
+    protected readonly includePracticeNav: boolean;
+    protected readonly receptionistNav: NavItem[];
+    protected readonly practiceNav: NavItem[];
+    constructor();
+    protected showNavItem(item: NavItem): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EdsModuleNavComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EdsModuleNavComponent, "eds-module-nav", never, {}, {}, never, never, true, never>;
+}
+export {};

package/lib/layout/eds-topbar.component.d.ts

@@ -0,0 +1,29 @@
+import { AgentOnlineService } from '../services/agent-online.service';
+import * as i0 from "@angular/core";
+export declare class EdsTopbarComponent {
+    private readonly router;
+    private readonly sessionAdapter;
+    private readonly toast;
+    protected readonly agentOnline: AgentOnlineService;
+    protected readonly pageTitle: import("@angular/core").WritableSignal<string>;
+    protected readonly confirmOffOpen: import("@angular/core").WritableSignal<boolean>;
+    protected readonly online: import("@angular/core").Signal<import("../services/agent-online.service").AgentOnlineKnownState>;
+    protected readonly loading: import("@angular/core").Signal<boolean>;
+    protected readonly toggling: import("@angular/core").Signal<boolean>;
+    protected readonly statusError: import("@angular/core").Signal<string | null>;
+    protected readonly userEmail: import("@angular/core").Signal<string | null>;
+    protected readonly showUser: import("@angular/core").Signal<boolean>;
+    protected readonly showLogout: import("@angular/core").Signal<boolean>;
+    protected readonly userInitials: import("@angular/core").Signal<string>;
+    protected readonly statusLabel: import("@angular/core").Signal<"Checking status…" | "Status unknown" | "AI receptionist is answering calls" | "AI is offline — calls go to front desk">;
+    protected readonly switchDisabled: import("@angular/core").Signal<boolean>;
+    constructor();
+    protected onToggleClick(): void;
+    protected cancelConfirmOff(): void;
+    protected confirmTurnOff(): void;
+    private applyOnline;
+    protected logout(): void;
+    private updateTitle;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EdsTopbarComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EdsTopbarComponent, "eds-topbar", never, {}, {}, never, never, true, never>;
+}

package/lib/mocks/api-log.seed.d.ts

@@ -0,0 +1,5 @@
+import { ApiLogDetail, ApiLogListItem, ApiLogStats } from '../models/api-log.types';
+export declare const SEED_CALL_API_LOGS: Record<string, ApiLogListItem[]>;
+export declare const SEED_API_LOG_DETAILS: Record<string, ApiLogDetail>;
+export declare function allSeedLogs(): ApiLogListItem[];
+export declare const SEED_API_LOG_STATS: ApiLogStats;

package/lib/mocks/outbound-purpose.seed.d.ts

@@ -0,0 +1,3 @@
+import { OutboundPurpose, OutboundPurposePlaceholder } from '../models/outbound-purpose.types';
+export declare const DEFAULT_PLACEHOLDERS: OutboundPurposePlaceholder[];
+export declare const SEED_OUTBOUND_PURPOSES: OutboundPurpose[];

package/lib/mocks/seed-data.d.ts

@@ -0,0 +1,38 @@
+import { AgentSettings, AnalyticsData, AuditEvent, DashboardData, HistoryCall, HistoryDetail, LiveCall, LocationOption, ProviderOption, SetupData, TaskItem, TranscriptLine } from '../models/ai-receptionist.types';
+export declare const SEED_LIVE_CALLS: LiveCall[];
+export declare const SEED_ATTENTION: ({
+    id: string;
+    callId: string;
+    title: string;
+    detail: string;
+    severity: "urgent";
+    time: number;
+} | {
+    id: string;
+    callId: string;
+    title: string;
+    detail: string;
+    severity: "warn";
+    time: number;
+} | {
+    id: string;
+    callId: string;
+    title: string;
+    detail: string;
+    severity: "info";
+    time: number;
+})[];
+export declare const SEED_HISTORY: HistoryCall[];
+export declare const SEED_HISTORY_DETAILS: Record<string, HistoryDetail>;
+export declare const SEED_TASKS: TaskItem[];
+export declare const SEED_AUDIT: AuditEvent[];
+export declare const SEED_ANALYTICS: AnalyticsData;
+export declare const SEED_SETTINGS: AgentSettings;
+export declare const SEED_SETUP: SetupData;
+export declare const SEED_LOCATIONS: LocationOption[];
+export declare const SEED_PROVIDERS: ProviderOption[];
+export declare function buildDashboard(): DashboardData;
+export declare function getStreamingLines(): TranscriptLine[];
+export declare function cloneLiveCalls(): LiveCall[];
+export declare function cloneHistory(): HistoryCall[];
+export declare function cloneTasks(): TaskItem[];

package/lib/models/ai-receptionist.types.d.ts

@@ -0,0 +1,257 @@
+export type Verification = 'verified' | 'partial' | 'failed' | 'unknown';
+export type CallStatus = 'ai' | 'needs-help' | 'human-requested' | 'urgent' | 'takeover' | 'transferring';
+export type Sentiment = 'calm' | 'neutral' | 'frustrated' | 'urgent';
+export type ToolState = 'ok' | 'warn' | 'error' | 'active';
+export type TranscriptWho = 'ai' | 'patient' | 'staff' | 'system';
+export interface TranscriptLine {
+    who: TranscriptWho;
+    text: string;
+    flag?: 'verify' | 'fail' | 'escalate' | string;
+    at?: number;
+}
+export interface ToolEvent {
+    t: string;
+    /** Stable tool identifier, e.g. check_doctor_availability */
+    key?: string;
+    /** Human-readable V3 label, e.g. Checked Doctor Availability */
+    name: string;
+    tech: string;
+    result: string;
+    state: ToolState;
+}
+export interface LiveCall {
+    id: string;
+    name: string;
+    initials: string;
+    avatar: string | null;
+    phone: string;
+    verification: Verification;
+    direction: 'inbound' | 'outbound';
+    reason: string;
+    status: CallStatus;
+    started: number;
+    sentiment: Sentiment;
+    confidence: number;
+    goal: string;
+    dob?: string;
+    location: string;
+    provider: string | null;
+    language: string;
+    matched: boolean;
+    assigned: string | null;
+    tools: ToolEvent[];
+    transcript: TranscriptLine[];
+    aiPaused?: boolean;
+    reviewed?: boolean;
+}
+export interface HistoryCall {
+    id: string;
+    name: string;
+    initials: string;
+    phone: string;
+    direction: 'inbound' | 'outbound';
+    outcome: string;
+    reason: string;
+    duration: number;
+    durationLabel?: string;
+    started: number;
+    whenLabel?: string;
+    location: string;
+    verification: Verification;
+    review: 'needs' | 'reviewed';
+}
+export interface HistoryDetail extends HistoryCall {
+    summary: string;
+    transcript: TranscriptLine[];
+    tools: ToolEvent[];
+    /** @deprecated Use CallRecordingPlayerComponent — URL requires JWT blob fetch */
+    recordingUrl?: string;
+}
+export interface RegenerateSummaryResult {
+    callId: string;
+    summary: string;
+    summaryModel?: string;
+    summaryGeneratedAt?: string;
+    transcriptTurnCount?: number;
+}
+export type CallRecordingStatus = 'ready' | 'pending' | 'unavailable' | 'failed';
+export interface CallRecordingMeta {
+    callId: string;
+    status: CallRecordingStatus;
+    url: string | null;
+    contentType?: string;
+    durationSeconds?: number;
+    message?: string;
+}
+export interface AttentionItem {
+    id: string;
+    callId: string;
+    title: string;
+    detail: string;
+    severity: 'urgent' | 'warn' | 'info';
+    time: number;
+    timeLabel?: string;
+}
+export interface DashboardData {
+    stats: {
+        activeCalls: number;
+        answeredToday: number;
+        appointmentsBooked: number;
+        tasksCreated: number;
+        completionRate: number;
+    };
+    liveCalls: LiveCall[];
+    latestTasks: TaskItem[];
+    latestAppointments: AiCreatedAppointment[];
+    recentHistory: HistoryCall[];
+}
+export interface AiCreatedAppointment {
+    id: string;
+    appointmentId: string;
+    patientName: string;
+    providerName: string | null;
+    startTime: number;
+    createdAt: number;
+    callId: string | null;
+    status: string | null;
+}
+export type TaskStatus = 'open' | 'in_progress' | 'done';
+export type TaskPriority = 'urgent' | 'normal';
+export type TaskSource = 'voice' | 'sync' | 'manual';
+export interface TaskItem {
+    id: string;
+    created: number;
+    title: string;
+    type: string;
+    description: string;
+    patient: string;
+    priority: TaskPriority;
+    status: TaskStatus;
+    source: TaskSource;
+    assignee: string;
+    callId?: string;
+    edvakTaskId?: string;
+    edvakStatus?: string;
+    medicationName?: string;
+    medicationId?: string;
+}
+export interface TaskFilters {
+    status?: TaskStatus;
+    type?: string;
+    source?: TaskSource;
+    callId?: string;
+    limit?: number;
+}
+export interface CreateTaskRequest {
+    title: string;
+    type: string;
+    callId?: string;
+    description?: string;
+    patient?: string;
+    priority?: TaskPriority;
+    assignee?: string;
+}
+export interface AuditEvent {
+    id: string;
+    actor: string;
+    action: string;
+    target: string;
+    detail: string;
+    at: number;
+}
+export interface AnalyticsKpiCard {
+    label: string;
+    value: string;
+    delta?: string;
+    tone?: string;
+    sub?: string;
+}
+export interface AnalyticsVolumePoint {
+    date: string;
+    day: string;
+    label: string;
+    count: number;
+}
+export interface AnalyticsVolumeSeries {
+    timezone: string;
+    startDate: string;
+    endDate: string;
+    points: AnalyticsVolumePoint[];
+}
+export interface AnalyticsPeakPoint {
+    hour: number;
+    label: string;
+    count: number;
+}
+export interface AnalyticsPeakSeries {
+    timezone: string;
+    points: AnalyticsPeakPoint[];
+}
+export interface AnalyticsData {
+    range: string;
+    kpiCards: AnalyticsKpiCard[];
+    volume: AnalyticsVolumeSeries;
+    outcomes: {
+        label: string;
+        value: number;
+        color: string;
+    }[];
+    reasons: {
+        label: string;
+        value: number;
+    }[];
+    transfers: {
+        label: string;
+        value: number;
+    }[];
+    peakHours: AnalyticsPeakSeries;
+    kpis: {
+        totalCalls: number;
+        avgDuration: number;
+        bookingRate: number;
+        transferRate: number;
+    };
+}
+export interface AgentSettings {
+    general: Record<string, string | boolean | number>;
+    phone: Record<string, string | boolean | number>;
+    tasks: Record<string, string | boolean | number>;
+    scheduling: Record<string, string | boolean | number>;
+    refill: Record<string, string | boolean | number>;
+    verify: Record<string, string | boolean | number>;
+    escalation: Record<string, string | boolean | number>;
+    outbound: Record<string, string | boolean | number>;
+    safety: {
+        id: string;
+        label: string;
+        status: 'ok' | 'warn';
+    }[];
+    transcripts: Record<string, string | boolean | number>;
+    advanced: Record<string, string | boolean | number>;
+    /** Resolved greeting spoken on inbound calls (from GET / PUT response). */
+    effectiveWelcomeMessage?: string;
+}
+export interface SetupStep {
+    id: number;
+    title: string;
+    description: string;
+    complete: boolean;
+}
+export interface SetupData {
+    readiness: number;
+    steps: SetupStep[];
+    testTranscript: TranscriptLine[];
+}
+export interface AiReceptionistStatus {
+    agentOn: boolean;
+    mode: 'live' | 'after-hours';
+    readiness: number;
+}
+export interface LocationOption {
+    id: string;
+    name: string;
+}
+export interface ProviderOption {
+    id: string;
+    name: string;
+}

package/lib/models/api-dto.types.d.ts

@@ -0,0 +1,215 @@
+/** Backend DTO shapes — source of truth from node API */
+export interface LiveTranscriptLineDto {
+    who: 'ai' | 'patient' | 'staff' | 'system';
+    text: string;
+    flag?: string;
+    /** Seconds from call start — enables audio-synced transcript highlighting */
+    at?: number;
+    offsetSeconds?: number;
+    startTime?: number;
+}
+export interface LiveCallToolDto {
+    t: string;
+    key?: string;
+    name: string;
+    tech: string;
+    result: string;
+    state: 'ok' | 'warn' | 'error' | 'active';
+}
+export interface LiveCallDto {
+    id: string;
+    name: string;
+    initials: string;
+    avatar: string | null;
+    phone: string;
+    verification: 'verified' | 'partial' | 'failed' | 'unknown';
+    direction: 'inbound' | 'outbound';
+    reason: string;
+    status: string;
+    started: number;
+    sentiment: string;
+    confidence: number;
+    goal: string;
+    dob: string | null;
+    location: string | null;
+    provider: string | null;
+    language: string;
+    matched: boolean;
+    assigned: string | null;
+    tools: LiveCallToolDto[];
+    transcript: LiveTranscriptLineDto[];
+}
+export interface HistoryCallDto {
+    id: string;
+    dir: 'inbound' | 'outbound';
+    name: string;
+    initials: string;
+    avatar: string | null;
+    phone: string;
+    reason: string;
+    outcome: string;
+    actions: string[];
+    tasks: number;
+    dur: string;
+    review: 'needs' | 'reviewed';
+    verify: string;
+    risk: 'urgent' | 'review' | null;
+    when: string;
+    /** ISO-8601 timestamp. Preferred over the legacy human-readable `when`. */
+    startedAt?: string;
+    provider: string;
+    location: string;
+}
+export interface HistoryDetailDto {
+    id: string;
+    summary: string;
+    collected: string[];
+    completed: string[];
+    notDone: string[];
+    followUp: boolean;
+    flags: string[];
+    transcript: LiveTranscriptLineDto[];
+    tools: LiveCallToolDto[];
+}
+export interface AttentionItemDto {
+    id: string;
+    name: string;
+    phone: string;
+    reason: string;
+    why: string;
+    sev: 'urgent' | 'review';
+    time: string;
+}
+export interface TaskDto {
+    id: string;
+    created: string;
+    title: string;
+    patient: string;
+    call: string;
+    type: string;
+    summary: string;
+    priority: 'urgent' | 'normal';
+    assignee: string;
+    status: 'open' | 'in-progress' | 'done';
+    source?: 'voice' | 'sync' | 'manual';
+    edvakTaskId?: string;
+    edvakStatus?: string;
+    medicationName?: string;
+    medicationId?: string;
+}
+export interface CreateTaskDto {
+    title: string;
+    type: string;
+    call?: string;
+    summary?: string;
+    patient?: string;
+    priority?: 'urgent' | 'normal';
+    assignee?: string;
+}
+export interface RegenerateSummaryResponseDto {
+    ok: boolean;
+    callId: string;
+    summary: string;
+    summaryModel?: string;
+    summaryGeneratedAt?: string;
+    transcriptTurnCount?: number;
+}
+export interface AuditEventDto {
+    ts: string;
+    actor: 'AI' | 'user';
+    actorName: string;
+    event: string;
+    cat: string;
+    patient: string;
+    call: string;
+    detail: string;
+}
+export interface DashboardSummaryDto {
+    liveCalls: number;
+    openTasks: number;
+    callsToday: number;
+    needsReview: number;
+    appointmentsBooked?: number;
+    aiHandledRate: string;
+    avgHandleTime: string;
+}
+export interface AiCreatedAppointmentDto {
+    id: string;
+    appointmentId?: string;
+    patientName: string;
+    providerName?: string | null;
+    startTime: string;
+    createdAt: string;
+    callId?: string | null;
+    status?: string | null;
+}
+export interface HistoryListDto {
+    items: HistoryCallDto[];
+    total: number;
+    page: number;
+    limit: number;
+}
+export interface AnalyticsVolumePointDto {
+    date: string;
+    day: string;
+    label: string;
+    count: number;
+}
+export interface AnalyticsVolumeSeriesDto {
+    timezone?: string;
+    startDate?: string;
+    endDate?: string;
+    points?: AnalyticsVolumePointDto[];
+}
+export interface AnalyticsPeakPointDto {
+    hour: number;
+    label: string;
+    count: number;
+}
+export interface AnalyticsPeakSeriesDto {
+    timezone?: string;
+    points?: AnalyticsPeakPointDto[];
+}
+export interface AnalyticsDto {
+    kpis: Array<{
+        label: string;
+        value: string;
+        delta: string;
+        tone: string;
+        sub: string;
+    }>;
+    volume: number[] | AnalyticsVolumeSeriesDto;
+    reasons: Array<{
+        label: string;
+        v: number;
+        tone: string;
+    }>;
+    outcomes: Array<{
+        label: string;
+        v: number;
+        tone: string;
+    }>;
+    transfers: Array<{
+        label: string;
+        v: number;
+    }>;
+    peak: number[] | AnalyticsPeakSeriesDto;
+}
+export interface AiStatusDto {
+    activated: boolean;
+    setupStep?: number;
+    agentOnline: boolean;
+}
+export interface SetupDto {
+    step: number;
+    setup: Record<string, unknown>;
+    activated: boolean;
+}
+export interface RecordingDto {
+    callId: string;
+    status?: 'ready' | 'pending' | 'unavailable' | 'failed';
+    url: string | null;
+    contentType?: string;
+    durationSeconds?: number;
+    message?: string;
+}

package/lib/models/api-log.types.d.ts

@@ -0,0 +1,53 @@
+export type ApiProvider = 'edvak' | 'vonage' | 'openai' | 'livekit';
+export interface ApiLogListItem {
+    id: string;
+    callId: string | null;
+    provider: ApiProvider;
+    operation: string;
+    method: string;
+    urlPath: string;
+    statusCode: number | null;
+    success: boolean;
+    durationMs: number;
+    toolName: string | null;
+    errorMessage: string | null;
+    startedAt: string;
+    requestPreview: string;
+    responsePreview: string;
+}
+export interface ApiLogDetail extends ApiLogListItem {
+    traceId: string | null;
+    requestBody: Record<string, unknown> | null;
+    responseBody: Record<string, unknown> | null;
+    metadata: Record<string, unknown> | null;
+    completedAt: string | null;
+}
+export interface ApiLogStats {
+    last24h: {
+        total: number;
+        failed: number;
+        avgDurationMs: number;
+    };
+    byProvider: {
+        provider: ApiProvider;
+        total: number;
+        failed: number;
+    }[];
+    recentFailures: ApiLogListItem[];
+}
+export interface ApiLogListResponse {
+    items: ApiLogListItem[];
+    total: number;
+}
+export interface ApiLogFilters {
+    provider?: string;
+    success?: boolean;
+    statusCode?: number;
+    operation?: string;
+    callId?: string;
+    from?: string;
+    to?: string;
+    search?: string;
+    page?: number;
+    limit?: number;
+}

package/lib/models/live-transcript.types.d.ts

@@ -0,0 +1,26 @@
+import { ToolEvent, TranscriptLine } from './ai-receptionist.types';
+/** Socket.io `new_chunk` payload from /dashboard namespace */
+export interface TranscriptChunk {
+    role: 'user' | 'assistant';
+    text: string;
+    isFinal: boolean;
+    timestamp: string;
+}
+/** Socket.io `call_event` payload — tools + lifecycle */
+export interface CallEventStreamPayload {
+    eventType: string;
+    occurredAt: string;
+    payload: Record<string, unknown>;
+}
+export interface LiveTranscriptState {
+    lines: TranscriptLine[];
+    patientInterim: string | null;
+    aiInterim: string | null;
+    connected: boolean;
+    error: string | null;
+}
+export declare function mapChunkToLine(chunk: TranscriptChunk): TranscriptLine;
+export declare function formatEventTime(iso: string): string;
+export declare function mapCallEventToTool(event: CallEventStreamPayload): ToolEvent;
+export declare function mapLifecycleEventToTool(event: CallEventStreamPayload): ToolEvent;
+export declare function isDuplicateTranscriptLine(lines: TranscriptLine[], line: TranscriptLine): boolean;