@kognitivedev/cloud-voice 0.2.29

package/src/types.ts

@@ -0,0 +1,927 @@
+import type { HttpTransportConfig, LogLevel } from "@kognitivedev/client-core";
+
+export type { LogLevel };
+
+export interface CloudVoiceClientConfig extends HttpTransportConfig {}
+
+export type CloudVoiceAgentStatus = "draft" | "published" | "archived";
+export type CloudVoiceSessionStatus = "created" | "connecting" | "active" | "completed" | "cancelled" | "error";
+export type CloudVoiceChannel = "web" | "iframe" | "script" | "phone" | "sip" | "outbound";
+export type CloudVoiceProvider = "openai-realtime" | "gemini-live" | "kognitive-voice" | "xai-realtime";
+export type CloudVoiceTransport = "webrtc" | "websocket";
+export type CloudVoiceToolType = "cloud_flow" | "web_search" | "knowledge_base" | "platform_action" | "calendar_action" | "appointment_action" | "cloud_voice_agent" | "external_webhook" | "sip_transfer" | "code_defined_tool";
+export type CloudVoiceCustomVoiceSource = "imported" | "api_clone";
+export type CloudVoiceCustomVoiceVerificationStatus = "verified" | "unverified" | "error" | string;
+
+export interface CloudVoiceCustomVoiceConsent {
+    accepted: boolean;
+    country?: string;
+    state?: string;
+    consentAcceptedAt?: string;
+    consentTextVersion?: string;
+    actor?: string | null;
+    ip?: string | null;
+    userAgent?: string | null;
+    [key: string]: unknown;
+}
+
+export interface CloudVoiceCustomVoiceRecord {
+    id: string;
+    projectId: string;
+    provider: "xai-realtime" | string;
+    voiceId: string;
+    name: string | null;
+    description: string | null;
+    gender: string | null;
+    accent: string | null;
+    age: string | null;
+    language: string | null;
+    useCase: string | null;
+    tone: string | null;
+    source: CloudVoiceCustomVoiceSource | string;
+    verificationStatus: CloudVoiceCustomVoiceVerificationStatus;
+    consent: Record<string, unknown>;
+    xaiMetadata: Record<string, unknown>;
+    lastVerifiedAt: string | Date | null;
+    createdAt: string | Date;
+    updatedAt: string | Date;
+}
+
+export interface ImportCloudVoiceCustomVoiceInput {
+    voiceId: string;
+    name?: string | null;
+    consent: CloudVoiceCustomVoiceConsent;
+}
+
+export interface CloneCloudVoiceCustomVoiceInput {
+    file: Blob;
+    fileName?: string;
+    name?: string;
+    description?: string;
+    gender?: "male" | "female" | "neutral" | string;
+    accent?: string;
+    age?: "young" | "middle-aged" | "old" | string;
+    language?: string;
+    useCase?: "conversational" | "narration" | "characters" | "educational" | "advertisement" | "social_media" | "entertainment" | string;
+    tone?: "warm" | "casual" | "professional" | "friendly" | "authoritative" | "expressive" | "calm" | string;
+    consent: CloudVoiceCustomVoiceConsent;
+}
+
+export interface UpdateCloudVoiceCustomVoiceInput {
+    name?: string | null;
+    description?: string | null;
+    gender?: string | null;
+    accent?: string | null;
+    age?: string | null;
+    language?: string | null;
+    useCase?: string | null;
+    tone?: string | null;
+}
+
+export interface CloudVoiceChannelSettings {
+    web: boolean;
+    iframe: boolean;
+    script: boolean;
+    phone: boolean;
+    sip: boolean;
+    outbound: boolean;
+}
+
+export interface CloudVoiceWidgetConfig {
+    title: string;
+    subtitle?: string;
+    layout?: "expanded" | "compact";
+    accentColor?: string;
+    backgroundColor?: string;
+    surfaceColor?: string;
+    textColor?: string;
+    mutedColor?: string;
+    ctaLabel?: string;
+    launcher?: "button" | "inline";
+    position?: "bottom-right" | "bottom-left";
+}
+
+export interface CloudVoiceHumanizationConfig {
+    enabled?: boolean;
+    openingMode?: "auto" | "wait";
+    openingStyle?: "brief" | "warm" | "professional";
+    fillerStyle?: "off" | "light" | "natural";
+    backchannelFrequency?: "off" | "low" | "medium";
+    disfluency?: "off" | "rare";
+    toolLatencyFillerMs?: number;
+}
+
+export interface CloudVoiceSpeechConfig extends Record<string, unknown> {
+    language?: string;
+    accent?: string;
+    style?: string;
+    pace?: string;
+    emotion?: string;
+}
+
+export interface CloudVoiceNodeVoiceSettings extends Record<string, unknown> {
+    speed?: number;
+    pitch?: number;
+    backgroundNoise?: boolean;
+    fillerWords?: boolean;
+}
+
+export interface CloudVoiceNodeModelSettings extends Record<string, unknown> {
+    temperature?: number;
+    maxOutputTokens?: number;
+    sentimentGuardrails?: boolean;
+    recordTranscript?: boolean;
+}
+
+export type CloudVoiceTelephonyProvider = "telnyx" | "cm_com" | "didww" | "sinch" | "bird" | "sip_custom" | string;
+
+export type CloudVoiceTelephonyDestination =
+    | { type: "phone_number"; phoneNumber: string; connectionId?: string; callerId?: string; metadata?: Record<string, unknown> }
+    | { type: "sip_uri"; uri: string; connectionId?: string; transport?: "udp" | "tcp" | "tls"; metadata?: Record<string, unknown> }
+    | { type: "extension"; extension: string; connectionId: string; metadata?: Record<string, unknown> }
+    | { type: "queue"; queueId: string; metadata?: Record<string, unknown> }
+    | { type: "browser_queue"; queueId?: string; label?: string; metadata?: Record<string, unknown> };
+
+export type CloudVoiceTransferMode = "blind" | "attended" | "warm";
+
+export interface CloudVoiceTransferPolicy {
+    mode?: CloudVoiceTransferMode;
+    timeoutSeconds?: number;
+    fallback?: "return_to_ai" | "alternate_destination" | "voicemail" | "hangup";
+    fallbackDestinationId?: string;
+    announceBeforeTransfer?: boolean;
+    allowSipRefer?: boolean;
+}
+
+export interface CloudVoiceTransferDestination {
+    id: string;
+    name: string;
+    provider?: CloudVoiceTelephonyProvider;
+    destination: CloudVoiceTelephonyDestination;
+    policy?: CloudVoiceTransferPolicy;
+    metadata?: Record<string, unknown>;
+}
+
+export interface CloudVoiceSipConfig {
+    enabled?: boolean;
+    defaultConnectionId?: string;
+    defaultProvider?: CloudVoiceTelephonyProvider;
+    inboundRouting?: {
+        mode: "agent" | "flow" | "queue";
+        agentId?: string;
+        flowId?: string;
+        queueId?: string;
+    };
+    transferPolicy?: CloudVoiceTransferPolicy;
+}
+
+export interface CloudVoiceToolBinding {
+    id: string;
+    type: CloudVoiceToolType;
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    parameterBindings?: Record<string, { parameter: string }>;
+    ui?: {
+        type?: "card" | "status" | "table" | "timeline" | "custom";
+        title?: string;
+        description?: string;
+        renderer?: string;
+        config?: Record<string, unknown>;
+    };
+    config: Record<string, unknown>;
+}
+
+export interface CloudVoiceToolCatalogSource {
+    id: string;
+    projectId: string;
+    sourceKey: string;
+    sourceType: "platform" | "bridge" | string;
+    name: string;
+    status: string;
+    hasBridgeAuthorization?: boolean;
+    metadata?: Record<string, unknown>;
+    lastSyncedAt?: string | Date;
+    createdAt?: string | Date;
+    updatedAt?: string | Date;
+}
+
+export interface CloudVoiceToolCatalogEntry {
+    id: string;
+    projectId: string;
+    sourceId: string;
+    source?: CloudVoiceToolCatalogSource;
+    sourceKey: string;
+    toolId: string;
+    name: string;
+    description?: string | null;
+    origin: "platform_defined" | "code_defined" | string;
+    bindingType: CloudVoiceToolType | string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    requireApproval: boolean;
+    status: string;
+    config: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    lastSyncedAt?: string | Date;
+    createdAt?: string | Date;
+    updatedAt?: string | Date;
+}
+
+export interface CloudVoiceToolCatalog {
+    sources: CloudVoiceToolCatalogSource[];
+    tools: CloudVoiceToolCatalogEntry[];
+    count: number;
+}
+
+export interface SyncCloudVoiceToolCatalogInput {
+    sourceKey: string;
+    name?: string;
+    bridgeUrl: string;
+    bridgeAuthorization?: string | null;
+    bridgeToken?: string | null;
+    metadata?: Record<string, unknown>;
+    tools: Array<{
+        id: string;
+        name?: string;
+        description?: string;
+        inputSchema?: Record<string, unknown>;
+        outputSchema?: Record<string, unknown>;
+        requireApproval?: boolean;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+
+export type CloudVoiceFlowNodeType = "initial" | "case" | "tool" | "transfer" | "end" | string;
+
+export interface CloudVoiceFlowNodeOutput {
+    id: string;
+    label: string;
+    description?: string;
+    desc?: string;
+    condition?: string;
+    icon?: string;
+    metadata?: Record<string, unknown>;
+}
+
+export interface CloudVoiceFlowNode {
+    id: string;
+    type: CloudVoiceFlowNodeType;
+    title?: string;
+    prompt?: string;
+    firstMessage?: string;
+    language?: string;
+    maxDuration?: string | number;
+    provider?: CloudVoiceProvider;
+    model?: string;
+    voice?: string;
+    transport?: CloudVoiceTransport;
+    providerOptions?: Record<string, unknown>;
+    transcription?: Record<string, unknown> | null;
+    turnDetection?: Record<string, unknown> | null;
+    inputNoiseReduction?: Record<string, unknown> | null;
+    humanization?: CloudVoiceHumanizationConfig;
+    speech?: CloudVoiceSpeechConfig;
+    phoneNumberIds?: string[];
+    voiceSettings?: CloudVoiceNodeVoiceSettings;
+    modelSettings?: CloudVoiceNodeModelSettings;
+    outputs?: CloudVoiceFlowNodeOutput[];
+    toolId?: string;
+    toolIds?: string[];
+    transferTarget?: string;
+    transferDestinationId?: string;
+    transferMode?: CloudVoiceTransferMode;
+    metadata?: Record<string, unknown>;
+}
+
+export interface CloudVoiceFlowEdge {
+    id?: string;
+    from: string;
+    fromPort?: string | null;
+    to: string;
+}
+
+export interface CloudVoiceFlowGraph {
+    version?: 1;
+    startNodeId?: string;
+    nodes: CloudVoiceFlowNode[];
+    edges: CloudVoiceFlowEdge[];
+    metadata?: Record<string, unknown>;
+}
+
+export interface CloudVoiceAgentMetadata extends Record<string, unknown> {
+    flowGraph?: CloudVoiceFlowGraph;
+    speech?: CloudVoiceSpeechConfig;
+    sip?: CloudVoiceSipConfig;
+    transferDestinations?: CloudVoiceTransferDestination[];
+}
+
+export type CloudVoiceParameterType = "string" | "number" | "boolean" | "json" | "phone" | "email";
+export type CloudVoiceParameterSource = "system" | "session" | "call" | "custom";
+export type CloudVoiceParameterPreset =
+    | "user_id"
+    | "session_id"
+    | "agent_slug"
+    | "channel"
+    | "phone"
+    | "caller_phone"
+    | "from_phone"
+    | "to_phone"
+    | "provider"
+    | "provider_call_id"
+    | "call_direction"
+    | "phone_number_id"
+    | "embed_origin";
+export type CloudVoiceParameterValueMap = Record<string, unknown>;
+
+export interface CloudVoiceParameterDefinition {
+    key: string;
+    label: string;
+    type: CloudVoiceParameterType;
+    required?: boolean;
+    description?: string;
+    defaultValue?: unknown;
+    enum?: unknown[];
+    source?: CloudVoiceParameterSource;
+    preset?: CloudVoiceParameterPreset;
+    sensitive?: boolean;
+    jsonSchema?: Record<string, unknown>;
+}
+
+export interface CloudVoiceAgentConfig {
+    instructions: string;
+    provider: CloudVoiceProvider;
+    model: string;
+    voice: string;
+    transport: CloudVoiceTransport;
+    memoryEnabled?: boolean;
+    providerOptions?: Record<string, unknown>;
+    transcription?: Record<string, unknown> | null;
+    turnDetection?: Record<string, unknown> | null;
+    inputNoiseReduction?: Record<string, unknown> | null;
+    tools: CloudVoiceToolBinding[];
+    knowledgeBases: Array<{ pipelineId: string; name?: string; topK?: number }>;
+    webSearch?: { enabled?: boolean; maxResults?: number; maxPages?: number };
+    widget: CloudVoiceWidgetConfig;
+    channels: CloudVoiceChannelSettings;
+    humanization?: CloudVoiceHumanizationConfig;
+    parameters?: CloudVoiceParameterDefinition[];
+    metadata?: CloudVoiceAgentMetadata;
+}
+
+export interface CloudVoiceAgentConfigInput {
+    instructions?: string;
+    provider?: CloudVoiceProvider;
+    model?: string;
+    voice?: string;
+    transport?: CloudVoiceTransport;
+    memoryEnabled?: boolean;
+    providerOptions?: Record<string, unknown>;
+    transcription?: Record<string, unknown> | null;
+    turnDetection?: Record<string, unknown> | null;
+    inputNoiseReduction?: Record<string, unknown> | null;
+    tools?: CloudVoiceToolBinding[];
+    knowledgeBases?: Array<{ pipelineId: string; name?: string; topK?: number }>;
+    webSearch?: { enabled?: boolean; maxResults?: number; maxPages?: number };
+    widget?: Partial<CloudVoiceWidgetConfig>;
+    channels?: Partial<CloudVoiceChannelSettings>;
+    humanization?: CloudVoiceHumanizationConfig;
+    metadata?: CloudVoiceAgentMetadata;
+}
+
+export interface CloudVoiceAgentRecord {
+    id: string;
+    projectId: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    status: CloudVoiceAgentStatus | string;
+    draftConfig: CloudVoiceAgentConfig;
+    publishedConfig: CloudVoiceAgentConfig | null;
+    draftVersion: number;
+    publishedVersion: number | null;
+    publishedAt: string | Date | null;
+    createdAt: string | Date;
+    updatedAt: string | Date;
+}
+
+export interface CreateCloudVoiceAgentInput {
+    projectId?: string;
+    name: string;
+    slug: string;
+    description?: string | null;
+    config?: CloudVoiceAgentConfigInput;
+}
+
+export interface UpdateCloudVoiceAgentInput {
+    name?: string;
+    slug?: string;
+    description?: string | null;
+    status?: CloudVoiceAgentStatus;
+    config?: CloudVoiceAgentConfigInput;
+}
+
+export interface UseCloudVoiceAgentInput {
+    name?: string;
+    description?: string | null;
+    status?: CloudVoiceAgentStatus;
+    config?: CloudVoiceAgentConfigInput;
+    publish?: boolean;
+}
+
+export type UseCloudVoiceAgentAction = "created" | "updated" | "used";
+
+export interface UseCloudVoiceAgentResult {
+    action: UseCloudVoiceAgentAction;
+    agent: CloudVoiceAgentRecord;
+}
+
+export interface CloudVoiceSessionRecord {
+    id: string;
+    projectId: string;
+    agentId: string | null;
+    agentSlug: string;
+    agentVersion: number | null;
+    channel: CloudVoiceChannel | string;
+    status: CloudVoiceSessionStatus | string;
+    userId: string;
+    sessionId: string;
+    sessionDbId: string | null;
+    traceDbId: string | null;
+    provider: string;
+    modelId: string;
+    voice: string | null;
+    transport: string;
+    callId: string | null;
+    resourceId: Record<string, unknown>;
+    parameters?: CloudVoiceParameterValueMap;
+    metadata: Record<string, unknown>;
+    startedAt: string | Date;
+    connectedAt: string | Date | null;
+    endedAt: string | Date | null;
+    durationMs: number | null;
+    outcomeStatus: string | null;
+    outcomeReason: string | null;
+    outcomeConfidence: number | null;
+    outcomeJudgeResultId?: string | null;
+    outcomeUpdatedAt?: string | Date | null;
+    errorMessage: string | null;
+}
+
+export interface CreateCloudVoiceSessionInput {
+    agentSlug?: string;
+    agent?: string;
+    channel?: CloudVoiceChannel;
+    userId?: string;
+    resourceId?: Record<string, unknown>;
+    parameters?: CloudVoiceParameterValueMap;
+    metadata?: Record<string, unknown>;
+    clientTools?: CloudVoiceClientToolManifest[];
+}
+
+export interface CloudVoicePhoneConnectionRecord {
+    id: string;
+    projectId: string;
+    provider: "twilio" | string;
+    name: string;
+    accountSid: string | null;
+    status: string;
+    hasAuthToken: boolean;
+    metadata: Record<string, unknown>;
+    createdAt: string | Date;
+    updatedAt: string | Date;
+}
+
+export interface CloudVoiceSipDiagnostics {
+    bridge?: CloudVoicePhoneBridgeHealth;
+    registrations?: Record<string, unknown>;
+    diagnostics?: Record<string, unknown>;
+}
+
+export interface CloudVoicePhoneNumberRecord {
+    id: string;
+    projectId: string;
+    connectionId: string | null;
+    provider: "twilio" | string;
+    phoneNumber: string;
+    label: string | null;
+    providerNumberId: string | null;
+    inboundEnabled: boolean;
+    outboundEnabled: boolean;
+    inboundAgentId: string | null;
+    inboundAgentSlug: string | null;
+    inboundFlowId: string | null;
+    inboundFlowSlug: string | null;
+    allocationMode: "exclusive" | "shared_outbound" | "shared_inbound" | "shared_both" | string;
+    maxProjects: number;
+    priceTier: string;
+    capabilities: Record<string, unknown>;
+    status: string;
+    metadata: Record<string, unknown>;
+    assignments?: CloudVoicePhoneNumberProjectAssignmentRecord[];
+    createdAt: string | Date;
+    updatedAt: string | Date;
+}
+
+export interface CloudVoicePhoneNumberProjectAssignmentRecord {
+    id: string;
+    phoneNumberId: string;
+    projectId: string;
+    status: string;
+    direction: "inbound" | "outbound" | "both" | string;
+    maxProjects: number;
+    priceTier: string;
+    inboundAgentId: string | null;
+    inboundAgentSlug: string | null;
+    inboundFlowId: string | null;
+    inboundFlowSlug: string | null;
+    routingMetadata: Record<string, unknown>;
+    createdAt: string | Date;
+    updatedAt: string | Date;
+}
+
+export interface CreateCloudVoicePhoneConnectionInput {
+    provider?: string;
+    name?: string;
+    accountSid?: string | null;
+    authToken?: string | null;
+    status?: string;
+    metadata?: Record<string, unknown>;
+}
+
+export interface CreateCloudVoicePhoneNumberInput {
+    connectionId?: string | null;
+    phoneNumber: string;
+    label?: string | null;
+    providerNumberId?: string | null;
+    inboundEnabled?: boolean;
+    outboundEnabled?: boolean;
+    inboundAgentSlug?: string | null;
+    agentSlug?: string | null;
+    inboundFlowSlug?: string | null;
+    flowSlug?: string | null;
+    allocationMode?: "exclusive" | "shared_outbound" | "shared_inbound" | "shared_both" | string;
+    maxProjects?: number;
+    priceTier?: string;
+    capabilities?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+
+export interface UpdateCloudVoicePhoneNumberInput extends Partial<CreateCloudVoicePhoneNumberInput> {
+    id: string;
+    status?: string;
+}
+
+export interface CloudVoiceCallLegRecord {
+    id: string;
+    projectId: string;
+    sessionId: string | null;
+    connectionId: string | null;
+    phoneNumberId: string | null;
+    provider: "twilio" | string;
+    providerCallId: string | null;
+    direction: "inbound" | "outbound" | string;
+    fromNumber: string;
+    toNumber: string;
+    status: string;
+    metadata: Record<string, unknown>;
+    startedAt: string | Date;
+    answeredAt: string | Date | null;
+    endedAt: string | Date | null;
+    createdAt: string | Date;
+    updatedAt: string | Date;
+}
+
+export interface CloudVoiceLiveCallTranscriptMessage {
+    id: string;
+    who: "agent" | "caller" | "manager" | "system";
+    text: string;
+    t: string;
+    tool?: string | null;
+    eventType: string;
+    createdAt: string | Date;
+}
+
+export interface CloudVoiceCallJudgeResult {
+    id: string;
+    judgeId: string;
+    judgeName: string;
+    outputType: string;
+    resultValue: string | null;
+    resultNumeric: number | null;
+    resultTags: unknown;
+    status: string;
+    errorMessage: string | null;
+    createdAt: string | Date;
+}
+
+export type CloudVoiceHandoffMode = "browser" | "carrier";
+export type CloudVoiceHandoffStatus = "requested" | "briefing" | "listening" | "accepted" | "active" | "returned_to_ai" | "completed" | "cancelled" | "failed";
+export type CloudVoiceHandoffAction = "listen" | "takeover" | "return_to_ai" | "cancel" | "carrier_transfer";
+
+export interface CloudVoiceHandoffRecord {
+    id: string;
+    projectId: string;
+    sessionId: string;
+    callLegId: string | null;
+    mode: CloudVoiceHandoffMode | string;
+    status: CloudVoiceHandoffStatus | string;
+    destinationId: string | null;
+    requestedBy: string;
+    acceptedBy: string | null;
+    summary: string | null;
+    errorMessage: string | null;
+    metadata: Record<string, unknown>;
+    startedAt: string | Date;
+    acceptedAt: string | Date | null;
+    endedAt: string | Date | null;
+    createdAt: string | Date;
+    updatedAt: string | Date;
+}
+
+export interface CloudVoiceLiveCallHandoffState {
+    current: CloudVoiceHandoffRecord | null;
+    status: CloudVoiceHandoffStatus | "none" | string;
+    mode: CloudVoiceHandoffMode | null | string;
+    summaryPreview: string | null;
+    activeManagerCount: number;
+    availableActions: CloudVoiceHandoffAction[];
+    recordingStatus: string;
+    recordingAssetCount: number;
+    transcriptStatus: string;
+}
+
+export type CloudVoiceRecordingAssetKind = "mixed" | "user_input" | "assistant_output" | "manager_input";
+
+export interface CloudVoiceRecordingAsset {
+    id: string;
+    kind: CloudVoiceRecordingAssetKind | string;
+    mimeType: string;
+    byteSize: number;
+    durationMs?: number | null;
+    sampleRate?: number | null;
+    channels?: number | null;
+    checksum?: string | null;
+    storageKey: string;
+    metadata?: Record<string, unknown>;
+    playbackUrl?: string | null;
+}
+
+export interface CreateCloudVoiceHandoffInput {
+    mode?: CloudVoiceHandoffMode;
+    destinationId?: string | null;
+    requestedBy?: string;
+    managerId?: string;
+    reason?: string;
+    metadata?: Record<string, unknown>;
+}
+
+export interface AcceptCloudVoiceHandoffInput {
+    managerId?: string;
+    announce?: boolean;
+    metadata?: Record<string, unknown>;
+}
+
+export interface CancelCloudVoiceHandoffInput {
+    reason?: string;
+    returnToAi?: boolean;
+    metadata?: Record<string, unknown>;
+}
+
+export interface CloudVoiceListenTokenResult {
+    token: string;
+    expiresAt: string;
+    wsUrl: string;
+    sessionId: string;
+    callLegId: string | null;
+    scopes: Array<"listen" | "takeover">;
+}
+
+export interface CloudVoiceLiveCallRecord {
+    id: string;
+    callLegId: string;
+    sessionId: string | null;
+    sessionPublicId: string | null;
+    projectId: string;
+    agentId: string | null;
+    agentSlug: string | null;
+    agentName: string;
+    callerNumber: string;
+    callerName: string | null;
+    fromNumber: string;
+    toNumber: string;
+    direction: string;
+    provider: string;
+    providerCallId: string | null;
+    status: string;
+    sessionStatus: string | null;
+    outcomeStatus: string | null;
+    outcomeReason: string | null;
+    outcomeConfidence: number | null;
+    stateLabel: string;
+    startedAt: string | Date;
+    answeredAt: string | Date | null;
+    endedAt: string | Date | null;
+    durationSeconds: number;
+    costCents: number | null;
+    costUsd: number | null;
+    sentiment: number | null;
+    latestEventType: string | null;
+    latestMessage: string | null;
+    latestEventAt: string | Date | null;
+    audioActive: boolean;
+    parameters?: CloudVoiceParameterValueMap;
+    metadata: Record<string, unknown>;
+    transcript: CloudVoiceLiveCallTranscriptMessage[];
+    judgeResults: CloudVoiceCallJudgeResult[];
+    handoff: CloudVoiceLiveCallHandoffState;
+}
+
+export interface CloudVoiceCallOutcome {
+    status: string;
+    reason: string | null;
+    confidence: number | null;
+}
+
+export type CloudVoiceCallOutcomeSource = "determiner" | "derived";
+
+export interface CloudVoiceCallWaitResult {
+    call: CloudVoiceLiveCallRecord;
+    status: string;
+    outcome: CloudVoiceCallOutcome;
+    outcomeSource: CloudVoiceCallOutcomeSource;
+}
+
+export interface CloudVoiceCallStatusChange {
+    call: CloudVoiceLiveCallRecord;
+    status: string;
+    previousStatus?: string;
+    sessionStatus: string | null;
+    stateLabel: string;
+    latestEventType: string | null;
+    outcomeStatus: string | null;
+}
+
+export interface CloudVoiceCallWaitOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+    onStatusChange?: (event: CloudVoiceCallStatusChange) => void;
+    onEvent?: (event: CloudVoiceCallStatusChange) => void;
+}
+
+export interface CloudVoicePhoneBridgeHealth {
+    enabled: boolean;
+    online: boolean;
+    status: "online" | "offline" | "unknown";
+    checkedAt: string;
+    port: number;
+    internalUrl: string;
+    publicBaseUrl: string | null;
+    mediaPath: string;
+    error?: string;
+    details?: Record<string, unknown>;
+}
+
+export interface CreateCloudVoiceOutboundCallInput {
+    agentSlug?: string;
+    agent?: string;
+    fromNumberId: string;
+    to: string;
+    userId?: string;
+    parameters?: CloudVoiceParameterValueMap;
+    metadata?: Record<string, unknown>;
+    simulate?: boolean;
+}
+
+export interface CloudVoiceClientToolManifest {
+    id: string;
+    name?: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+
+export type CloudVoiceClientToolState = "input-available" | "output-available" | "error";
+
+export interface CloudVoiceClientToolRenderContext<TInput = unknown, TOutput = unknown> {
+    toolName: string;
+    toolCallId: string;
+    input?: TInput;
+    output?: TOutput;
+    error?: string;
+    state: CloudVoiceClientToolState;
+}
+
+export interface CloudVoiceClientToolExecuteContext {
+    toolName: string;
+    toolCallId: string;
+    callId?: string;
+    sessionId?: string;
+}
+
+export type CloudVoiceClientToolRenderer<TInput = unknown, TOutput = unknown> = (
+    context: CloudVoiceClientToolRenderContext<TInput, TOutput>,
+) => unknown;
+
+export interface CloudVoiceClientToolDefinition<TInput = unknown, TOutput = unknown> {
+    name?: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+    execute?: (
+        input: TInput,
+        context: CloudVoiceClientToolExecuteContext,
+    ) => Promise<TOutput> | TOutput;
+    render?: CloudVoiceClientToolRenderer<TInput, TOutput>;
+}
+
+export type CloudVoiceClientTool<TInput = unknown, TOutput = unknown> =
+    | CloudVoiceClientToolDefinition<TInput, TOutput>
+    | CloudVoiceClientToolRenderer<TInput, TOutput>;
+
+export type CloudVoiceClientTools = Record<string, CloudVoiceClientTool>;
+
+export interface CloudVoiceSessionEventRecord {
+    id: string;
+    sessionId: string;
+    projectId: string;
+    sequence: number;
+    eventType: string;
+    role: string | null;
+    message: string | null;
+    payload: Record<string, unknown>;
+    createdAt: string | Date;
+}
+
+export interface CloudVoiceSessionBootstrap {
+    sessionId?: string;
+    callId?: string;
+    transport?: {
+        type: "webrtc" | "websocket";
+        url: string;
+        sessionId?: string;
+        callId?: string;
+        headers?: Record<string, string>;
+        provider?: string;
+    };
+    session: CloudVoiceSessionRecord;
+    prepare: Record<string, unknown>;
+    credentials: {
+        value: string;
+        kind?: string;
+        raw?: unknown;
+    };
+    endpoints: {
+        events: string;
+        stream: string;
+        cancel: string;
+        toolBase: string;
+    };
+}
+
+export interface CloudVoiceEmbedConfig {
+    agent: {
+        id: string;
+        slug: string;
+        name: string;
+        description: string | null;
+        publishedVersion: number | null;
+        widget: Record<string, unknown>;
+    };
+    theme: Record<string, unknown>;
+}
+
+export interface CloudVoiceEmbedOptions {
+    baseUrl: string;
+    publicKey: string;
+    agent: string;
+    userId?: string;
+    parameters?: CloudVoiceParameterValueMap;
+    target?: HTMLElement | string;
+    tools?: CloudVoiceClientTools;
+    toolTarget?: HTMLElement | string;
+    onToolState?: (state: CloudVoiceClientToolRenderContext) => void;
+    style?: {
+        theme?: "default" | "minimal" | "solid" | "glass";
+        accentColor?: string;
+        backgroundColor?: string;
+        surfaceColor?: string;
+        textColor?: string;
+        mutedColor?: string;
+        width?: string;
+        padding?: string;
+        gap?: string;
+        radius?: string;
+        panelRadius?: string;
+        buttonRadius?: string;
+        orbSize?: string;
+        shadow?: "none" | "soft" | "strong";
+        align?: "center" | "bottom" | "top";
+        density?: "compact" | "comfortable";
+    };
+    iframe?: {
+        width?: string;
+        height?: string;
+        title?: string;
+        style?: Partial<CSSStyleDeclaration> | Record<string, string>;
+    };
+}