@dialgem/sdk 0.1.0-beta.0 → 0.1.0-beta.1

package/dist/index.d.cts

@@ -110,7 +110,12 @@ type Fetch = (url: string, init: FetchInit) => Promise<FetchResponse>;
 interface FetchInit {
     method: string;
     headers: Record<string, string>;
-    body?: string;
+    /**
+     * A JSON string, or a `FormData` for a file upload — in which case
+     * `Content-Type` is deliberately absent, since only `fetch` knows the
+     * multipart boundary it is about to generate.
+     */
+    body?: string | FormData;
     signal: AbortSignal;
     /**
      * Always `"manual"`. A followed redirect re-sends the API key to wherever the
@@ -143,7 +148,9 @@ interface RequestOptions {
     /** Extra headers for this request only. */
     headers?: Record<string, string> | undefined;
 }
-type QueryValue = string | number | boolean | null | undefined;
+type QueryScalar = string | number | boolean;
+/** Arrays are sent as repeated parameters: `{ status: ["a", "b"] }` → `?status=a&status=b`. */
+type QueryValue = QueryScalar | QueryScalar[] | null | undefined;
 type Query = Record<string, QueryValue>;
 interface HttpClientOptions {
     apiKey: string;
@@ -160,6 +167,14 @@ declare class HttpClient {
     constructor(options: HttpClientOptions);
     get<T>(path: string, query?: Query, options?: RequestOptions): Promise<T>;
     post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * POST a `FormData` body — file uploads.
+     *
+     * The body is sent as-is and `Content-Type` is left unset, because only
+     * `fetch` knows the multipart boundary it is about to generate. Setting the
+     * header ourselves produces a request no server can parse.
+     */
+    postForm<T>(path: string, form: FormData, options?: RequestOptions): Promise<T>;
     patch<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
     delete<T>(path: string, options?: RequestOptions): Promise<T>;
     request<T>(method: Method, path: string, { query, body, options }: {
@@ -181,6 +196,11 @@ interface components {
              * @enum {string}
              */
             agent_type?: "llm" | "multi_prompt" | "flow";
+            /**
+             * Allow User Dtmf
+             * @default false
+             */
+            allow_user_dtmf?: boolean;
             /**
              * Ambient Sound
              * @default none
@@ -206,6 +226,12 @@ interface components {
             boosted_keywords?: string[];
             /** Data Retention Days */
             data_retention_days?: number | null;
+            /**
+             * Data Storage Setting
+             * @default everything
+             * @enum {string}
+             */
+            data_storage_setting?: "everything" | "everything_except_pii" | "basic_attributes_only";
             /** Default Dynamic Variables */
             default_dynamic_variables?: {
                 [key: string]: string;
@@ -279,6 +305,8 @@ interface components {
              * @default false
              */
             opt_out_transcript_storage?: boolean;
+            /** Pii Categories */
+            pii_categories?: ("email" | "credit_card" | "ssn" | "phone_number")[];
             /**
              * Pii Redaction Enabled
              * @default false
@@ -291,6 +319,10 @@ interface components {
              * @default claude-sonnet-4-6
              */
             post_call_analysis_model?: string;
+            /** Pronunciation Dictionary */
+            pronunciation_dictionary?: components["schemas"]["PronunciationEntry"][];
+            /** Reminder Max Count */
+            reminder_max_count?: number | null;
             /**
              * Reminder Message
              * @default
@@ -335,6 +367,7 @@ interface components {
              * @default cartesia
              */
             tts_engine?: string;
+            user_dtmf_options?: components["schemas"]["UserDtmfOptions"];
             /**
              * Voice Id
              * @default
@@ -419,6 +452,8 @@ interface components {
         AgentUpdate: {
             /** Agent Type */
             agent_type?: ("llm" | "multi_prompt" | "flow") | null;
+            /** Allow User Dtmf */
+            allow_user_dtmf?: boolean | null;
             /** Ambient Sound */
             ambient_sound?: ("none" | "coffee-shop" | "call-center" | "convention-hall" | "summer-outdoor" | "mountain-outdoor" | "static-noise") | null;
             /** Ambient Sound Volume */
@@ -431,6 +466,8 @@ interface components {
             boosted_keywords?: string[] | null;
             /** Data Retention Days */
             data_retention_days?: number | null;
+            /** Data Storage Setting */
+            data_storage_setting?: ("everything" | "everything_except_pii" | "basic_attributes_only") | null;
             /** Default Dynamic Variables */
             default_dynamic_variables?: {
                 [key: string]: string;
@@ -470,12 +507,18 @@ interface components {
             opt_out_call_recording?: boolean | null;
             /** Opt Out Transcript Storage */
             opt_out_transcript_storage?: boolean | null;
+            /** Pii Categories */
+            pii_categories?: ("email" | "credit_card" | "ssn" | "phone_number")[] | null;
             /** Pii Redaction Enabled */
             pii_redaction_enabled?: boolean | null;
             /** Post Call Analysis Data */
             post_call_analysis_data?: components["schemas"]["PostCallAnalysisVariable"][] | null;
             /** Post Call Analysis Model */
             post_call_analysis_model?: string | null;
+            /** Pronunciation Dictionary */
+            pronunciation_dictionary?: components["schemas"]["PronunciationEntry"][] | null;
+            /** Reminder Max Count */
+            reminder_max_count?: number | null;
             /** Reminder Message */
             reminder_message?: string | null;
             /** Reminder Trigger Ms */
@@ -496,6 +539,7 @@ interface components {
             temperature?: number | null;
             /** Tts Engine */
             tts_engine?: string | null;
+            user_dtmf_options?: components["schemas"]["UserDtmfOptions"] | null;
             /** Voice Id */
             voice_id?: string | null;
             /** Voice Speed */
@@ -515,6 +559,13 @@ interface components {
             /** Webhook Url */
             webhook_url?: string | null;
         };
+        /** AgentVersionCreate */
+        AgentVersionCreate: {
+            /** Description */
+            description?: string | null;
+            /** Title */
+            title?: string | null;
+        };
         /** AgentWeightIn */
         AgentWeightIn: {
             /** Agent Id */
@@ -523,13 +574,34 @@ interface components {
              * Agent Version
              * @default 0
              */
-            agent_version?: number;
+            agent_version?: number | "latest_published";
             /**
              * Weight
              * @default 1
              */
             weight?: number;
         };
+        /** Body_clone_voice_v1_voices_clone_post */
+        Body_clone_voice_v1_voices_clone_post: {
+            /** Consent Confirmed */
+            consent_confirmed: boolean;
+            /** Description */
+            description?: string | null;
+            /**
+             * Engine
+             * @default elevenlabs
+             */
+            engine?: string;
+            /** Files */
+            files: string[];
+            /**
+             * Language
+             * @default en
+             */
+            language?: string;
+            /** Name */
+            name: string;
+        };
         /** BranchNode */
         BranchNode: {
             display_position?: components["schemas"]["DisplayPosition"] | null;
@@ -551,6 +623,39 @@ interface components {
         } & {
             [key: string]: unknown;
         };
+        /** CallPatch */
+        CallPatch: {
+            /** Amd Result */
+            amd_result?: {
+                [key: string]: unknown;
+            } | null;
+            /** Call Sid */
+            call_sid?: string | null;
+            /** Disconnection Reason */
+            disconnection_reason?: string | null;
+            /** Duration S */
+            duration_s?: number | null;
+            /** Ended At */
+            ended_at?: string | null;
+            /** Events */
+            events?: unknown[] | null;
+            /** Meta */
+            meta?: {
+                [key: string]: unknown;
+            } | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+            /** Origination State */
+            origination_state?: string | null;
+            /** Recording Key */
+            recording_key?: string | null;
+            /** Status */
+            status?: string | null;
+            /** Transcript */
+            transcript?: unknown[] | null;
+        };
         /** ConversationNode */
         ConversationNode: {
             /** Allow Dtmf Interruption */
@@ -794,6 +899,11 @@ interface components {
         };
         /** FunctionCreate */
         FunctionCreate: {
+            /**
+             * Args At Root
+             * @default false
+             */
+            args_at_root?: boolean;
             /** Config */
             config?: {
                 [key: string]: unknown;
@@ -848,6 +958,11 @@ interface components {
         };
         /** FunctionDef */
         FunctionDef: {
+            /**
+             * Args At Root
+             * @default false
+             */
+            args_at_root?: boolean;
             /** Config */
             config?: {
                 [key: string]: unknown;
@@ -935,6 +1050,8 @@ interface components {
         };
         /** FunctionUpdate */
         FunctionUpdate: {
+            /** Args At Root */
+            args_at_root?: boolean | null;
             /** Config */
             config?: {
                 [key: string]: unknown;
@@ -1155,12 +1272,21 @@ interface components {
         OutboundCallRequest: {
             /** Agent Id */
             agent_id?: string | null;
+            /**
+             * Agent Version
+             * @default 0
+             */
+            agent_version?: number | "latest_published";
             /** Dialgem Llm Dynamic Variables */
             dialgem_llm_dynamic_variables?: {
                 [key: string]: unknown;
             } | null;
             /** From */
             from_: string;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
             /** To */
             to: string;
         };
@@ -1168,6 +1294,8 @@ interface components {
         PhoneNumberAssign: {
             /** Agent Id */
             agent_id?: string | null;
+            /** Agent Version */
+            agent_version?: number | "latest_published" | null;
         };
         /** PhoneNumberCreate */
         PhoneNumberCreate: {
@@ -1183,12 +1311,26 @@ interface components {
             flow_sms_sender_enabled?: boolean;
             /** Inbound Agent Id */
             inbound_agent_id?: string | null;
+            /**
+             * Inbound Agent Version
+             * @default 0
+             */
+            inbound_agent_version?: number | "latest_published";
+            /** Inbound Agents */
+            inbound_agents?: components["schemas"]["AgentWeightIn"][] | null;
             /** Nickname */
             nickname?: string | null;
             /** Number */
             number?: string | null;
             /** Outbound Agent Id */
             outbound_agent_id?: string | null;
+            /**
+             * Outbound Agent Version
+             * @default 0
+             */
+            outbound_agent_version?: number | "latest_published";
+            /** Outbound Agents */
+            outbound_agents?: components["schemas"]["AgentWeightIn"][] | null;
             /** Phone Number */
             phone_number?: string | null;
             /**
@@ -1213,12 +1355,16 @@ interface components {
             flow_sms_sender_enabled?: boolean | null;
             /** Inbound Agent Id */
             inbound_agent_id?: string | null;
+            /** Inbound Agent Version */
+            inbound_agent_version?: number | "latest_published" | null;
             /** Inbound Agents */
             inbound_agents?: components["schemas"]["AgentWeightIn"][] | null;
             /** Nickname */
             nickname?: string | null;
             /** Outbound Agent Id */
             outbound_agent_id?: string | null;
+            /** Outbound Agent Version */
+            outbound_agent_version?: number | "latest_published" | null;
             /** Outbound Agents */
             outbound_agents?: components["schemas"]["AgentWeightIn"][] | null;
             /** Phone Number Type */
@@ -1244,8 +1390,15 @@ interface components {
              * @default
              */
             description?: string;
+            /** Examples */
+            examples?: string[];
             /** Name */
             name: string;
+            /**
+             * Required
+             * @default false
+             */
+            required?: boolean;
             /**
              * Type
              * @enum {string}
@@ -1374,10 +1527,27 @@ interface components {
             /** Variable Names */
             variable_names: string[];
         };
+        /** PronunciationEntry */
+        PronunciationEntry: {
+            /** Alias */
+            alias: string;
+            /**
+             * Case Sensitive
+             * @default false
+             */
+            case_sensitive?: boolean;
+            /** Word */
+            word: string;
+        };
         /** RegisterCallRequest */
         RegisterCallRequest: {
             /** Agent Id */
             agent_id: string;
+            /**
+             * Agent Version
+             * @default 0
+             */
+            agent_version?: number | "latest_published";
             /** Call Sid */
             call_sid?: string | null;
             /** Dialgem Llm Dynamic Variables */
@@ -1583,6 +1753,18 @@ interface components {
         } & {
             [key: string]: unknown;
         };
+        /** UserDtmfOptions */
+        UserDtmfOptions: {
+            /** Digit Limit */
+            digit_limit?: number | null;
+            /** Termination Key */
+            termination_key?: ("#" | "*") | null;
+            /**
+             * Timeout Ms
+             * @default 2500
+             */
+            timeout_ms?: number;
+        };
         /** ValidationError */
         ValidationError: {
             /** Context */
@@ -1746,6 +1928,11 @@ interface AgentFunction {
     query_params: KeyValuePair[];
     speak_during_execution: string | null;
     speak_after_execution: boolean;
+    /**
+     * `false` (the default for new functions): the request body is
+     * `{ name, call, args }`. `true`: the body is the arguments object alone.
+     */
+    args_at_root: boolean;
     sort_order: number;
     kind: FunctionKind;
     /** Kind-specific settings (e.g. Cal.com credentials for the `*_cal` kinds). */
@@ -1791,6 +1978,77 @@ interface MCPServerTestResult {
     at: string;
 }
 
+/**
+ * A published agent version: a frozen copy of the agent's configuration, its
+ * functions and its MCP servers.
+ *
+ * The editable agent is the **draft**, version `0`, and is what a call runs
+ * unless something pins a version. Publishing never changes the draft, and a
+ * published version never changes at all — editing a function's URL afterwards
+ * does not move the copy inside a version that already shipped.
+ *
+ * Pin one on a phone number (`inbound_agent_version` / `outbound_agent_version`),
+ * on an outbound call, or on a registered call. The version a call ran is
+ * reported as `agent_version` on its call record and in every webhook.
+ */
+interface AgentVersionSummary {
+    id: string;
+    agent_id: string;
+    /** 1 for the first publish, then upwards. The draft is 0 and is not listed here. */
+    version: number;
+    /** The agent's name at publish time. */
+    name: string;
+    /** Your label for the release, if you gave one. */
+    title: string | null;
+    description: string | null;
+    /** ISO 8601, no timezone suffix (UTC). */
+    published_at: string | null;
+    /** Whoever published it, as the API identity that made the call. */
+    published_by: string | null;
+    function_count: number;
+    mcp_server_count: number;
+}
+/** A version with its snapshot, returned by `publish` and `retrieve`. */
+interface AgentVersion extends AgentVersionSummary {
+    /**
+     * The frozen configuration. Same fields as {@link Agent}, minus the ones that
+     * belong to the agent rather than to a snapshot (`id`, `created_at`,
+     * `call_count`). `webhook_signing_secret` is never included; read it from the
+     * agent itself.
+     */
+    config: AgentVersionConfig;
+    functions: AgentFunction[];
+    /** `auth_token` is stripped; `has_auth_token` says whether one is set. */
+    mcp_servers: AgentVersionMCPServer[];
+}
+type AgentVersionConfig = Partial<Omit<Agent, "id" | "agent_id" | "created_at" | "call_count">> & {
+    has_webhook_signing_secret: boolean;
+} & Record<string, unknown>;
+type AgentVersionMCPServer = Omit<MCPServer, "id"> & {
+    id: string;
+    has_auth_token: boolean;
+};
+interface AgentVersionListResponse {
+    /** Newest first. */
+    versions: AgentVersionSummary[];
+    /** Whether older versions remain below the last one returned. */
+    has_more: boolean;
+}
+interface AgentVersionListParams {
+    /** Versions per page, 1-100. Default 50. */
+    limit?: number | undefined;
+    /**
+     * Return versions below this one. Page by passing the `version` of the last
+     * entry you received.
+     */
+    before_version?: number | undefined;
+}
+interface AgentVersionPublishParams {
+    /** A label for the release, e.g. "adds the refund flow". */
+    title?: string | undefined;
+    description?: string | undefined;
+}
+
 declare abstract class APIResource {
     protected readonly _client: HttpClient;
     constructor(client: HttpClient);
@@ -1803,6 +2061,8 @@ declare class Agents extends APIResource {
     readonly knowledge: AgentKnowledge;
     /** Remote MCP servers whose tools are exposed to the agent. */
     readonly mcpServers: AgentMCPServers;
+    /** Frozen snapshots of the agent that a number or a call can pin. */
+    readonly versions: AgentVersions;
     constructor(client: HttpClient);
     /** Create an agent. Only `name` is required; everything else has a server default. */
     create(body: AgentCreateParams, options?: RequestOptions): Promise<Agent>;
@@ -1813,6 +2073,29 @@ declare class Agents extends APIResource {
     update(agentId: string, body: AgentUpdateParams, options?: RequestOptions): Promise<Agent>;
     delete(agentId: string, options?: RequestOptions): Promise<AgentDeleteResponse>;
 }
+/**
+ * Published versions of an agent.
+ *
+ * The agent itself is the draft, version 0, and every call runs it unless a
+ * number or a request pins a published version. Publishing takes a copy;
+ * editing the agent afterwards changes only the draft.
+ */
+declare class AgentVersions extends APIResource {
+    /** Freeze the agent as it is now. Returns the new version, snapshot included. */
+    publish(agentId: string, body?: AgentVersionPublishParams, options?: RequestOptions): Promise<AgentVersion>;
+    /**
+       * One page of published versions, newest first, without their snapshots.
+       *
+       * Returns the array. When you need to page — an agent published on every
+       * deploy accumulates versions, and nothing prunes them — read `has_more` from
+       * {@link listPage} instead and pass the last `version` as `before_version`.
+       */
+    list(agentId: string, params?: AgentVersionListParams, options?: RequestOptions): Promise<AgentVersionSummary[]>;
+    /** {@link list} with the `has_more` flag, for paging. */
+    listPage(agentId: string, params?: AgentVersionListParams, options?: RequestOptions): Promise<AgentVersionListResponse>;
+    /** One version with its full snapshot. Version 0 is the draft: use `agents.retrieve`. */
+    retrieve(agentId: string, version: number, options?: RequestOptions): Promise<AgentVersion>;
+}
 declare class AgentFunctions extends APIResource {
     list(agentId: string, options?: RequestOptions): Promise<AgentFunction[]>;
     create(agentId: string, body: FunctionCreateParams, options?: RequestOptions): Promise<AgentFunction>;
@@ -1836,28 +2119,25 @@ declare class AgentMCPServers extends APIResource {
     test(agentId: string, serverId: string, options?: RequestOptions): Promise<MCPServerTestResult>;
 }
 
-interface PageFetcher<T> {
-    (page: number): Promise<PageData<T>>;
-}
 interface PageData<T> {
     data: T[];
-    total: number;
-    page: number;
-    page_size: number;
+    has_more: boolean;
+    /** Pass to the next request to continue; `null` on the last page. */
+    pagination_key: string | null;
 }
+type PageFetcher<T> = (paginationKey: string | null) => Promise<PageData<T>>;
 declare class Page<T> implements PageData<T> {
     #private;
     readonly data: T[];
-    readonly total: number;
-    readonly page: number;
-    readonly page_size: number;
+    readonly has_more: boolean;
+    readonly pagination_key: string | null;
     constructor(data: PageData<T>, fetchPage: PageFetcher<T>);
     hasNextPage(): boolean;
     getNextPage(): Promise<Page<T>>;
 }
 declare class PagePromise<T> implements PromiseLike<Page<T>>, AsyncIterable<T> {
     #private;
-    constructor(fetchPage: PageFetcher<T>, startPage: number);
+    constructor(fetchPage: PageFetcher<T>, startKey?: string | null);
     then<R1 = Page<T>, R2 = never>(onfulfilled?: ((value: Page<T>) => R1 | PromiseLike<R1>) | null, onrejected?: ((reason: unknown) => R2 | PromiseLike<R2>) | null): Promise<R1 | R2>;
     catch<R = never>(onrejected?: ((reason: unknown) => R | PromiseLike<R>) | null): Promise<Page<T> | R>;
     finally(onfinally?: (() => void) | null): Promise<Page<T>>;
@@ -1865,46 +2145,71 @@ declare class PagePromise<T> implements PromiseLike<Page<T>>, AsyncIterable<T> {
 }
 
 /**
- * A call, as returned by `GET /v1/calls` and `GET /v1/calls/{id}`.
- * The shape is the same for both endpoints.
+ * A call, as returned by `GET /v1/calls`, `GET /v1/calls/{id}` and every call webhook.
+ * The shape is the same everywhere.
  */
 interface Call {
     id: string;
     /** Empty string when the call has no agent. */
     agent_id: string;
+    /**
+     * The published agent version this call ran. 0 is the live draft, which is
+     * what a call runs unless a number or the request that created it pinned a
+     * version.
+     */
+    agent_version: number;
     agent_name: string;
     /** Dialgem's lifecycle state. */
     status: CallStatus;
     /** The same state in session vocabulary: active→ongoing, completed→ended, failed→error, queued→registered. */
     call_status: CallSessionStatus;
-    duration_s: number;
-    /**
-     * Empty when the agent opts out of transcript storage, and once the agent's
-     * `data_retention_days` purge has run. PII-redacted when redaction is on.
-     */
-    transcript: TranscriptTurn[];
+    call_type: "phone_call" | "web_call" | (string & {});
+    direction: "inbound" | "outbound" | (string & {});
+    /** Your own data, attached when the call was created or later with `calls.update`. */
+    metadata: Record<string, unknown>;
+    /** The dynamic variables the call was started with. */
+    dynamic_variables: Record<string, string>;
     /** ISO 8601, no timezone suffix (UTC). Empty string if unknown. */
     started_at: string;
+    /** ISO 8601, no timezone suffix (UTC). `null` while the call is ongoing. */
+    ended_at: string | null;
+    /** Epoch milliseconds. */
+    start_timestamp: number | null;
+    /** Epoch milliseconds. `null` while the call is ongoing. */
+    end_timestamp: number | null;
+    duration_s: number;
+    duration_ms: number | null;
     phone_number: string;
-    direction: "inbound" | "outbound" | (string & {});
-    call_type: "phone_call" | "web_call" | (string & {});
-    /** Carrier call id (Twilio CallSid). Empty string if none. */
-    call_sid: string;
     from_number: string;
     to_number: string;
+    /** Carrier call id (Twilio CallSid). Empty string if none. */
+    call_sid: string;
     origination_state: string | null;
+    /**
+     * One entry per turn. Empty when the agent opts out of transcript storage, and
+     * once the agent's `data_retention_days` purge has run. PII-redacted when
+     * redaction is on.
+     */
+    transcript: TranscriptTurn[];
+    /** The same transcript as one string, `Agent: …` / `User: …` per line. */
+    transcript_text: string;
     /** Presigned URL that expires; download it promptly rather than storing the link. */
     recording_url: string | null;
-    amd_result: Record<string, unknown> | null;
     events: Record<string, unknown>[];
-    /** Post-call extraction. `null` until the call has ended and been analyzed, and after a retention purge. */
+    disconnection_reason: DisconnectionReason | null;
+    /** Whether the call reached voicemail or an answering machine. */
+    in_voicemail: boolean;
+    amd_result: Record<string, unknown> | null;
+    /** Post-call analysis. `null` until the call has ended and been analyzed, and after a retention purge. */
     analysis: CallAnalysis | null;
-    disconnection_reason: string | null;
     /** Set once the call is finalized. */
     call_cost: CallCost | null;
     /** Mean time from the caller's final transcript to the agent's first audio byte. */
     end_to_end_latency_ms: number | null;
+    /** Per-stage latency percentiles, recorded when the call ends. `null` if no turn completed. */
+    latency: CallLatency | null;
 }
+type DisconnectionReason = "user_hangup" | "agent_hangup" | "call_transfer" | "voicemail_reached" | "inactivity" | "max_duration_reached" | "manual_stopped" | "dial_no_answer" | "flow_dead_end" | "flow_loop_guard" | "error" | (string & {});
 /** Every amount is an integer in units of **$0.0001**: `combined_cost: 1700` is $0.17. */
 interface CallCost {
     combined_cost: number;
@@ -1925,23 +2230,76 @@ interface TranscriptTurn {
     timestamp: string;
 }
 interface CallAnalysis {
+    /** A one-to-three sentence summary of the call. */
+    call_summary: string | null;
+    user_sentiment: "Positive" | "Neutral" | "Negative" | (string & {}) | null;
+    call_successful: boolean | null;
+    in_voicemail: boolean;
     /** Values for the agent's `post_call_analysis_data` fields, keyed by name. */
     variables: Record<string, unknown>;
     model: string;
     extracted_at: string;
-    user_sentiment: "Positive" | "Neutral" | "Negative" | (string & {}) | null;
-    call_successful: boolean | null;
     /** Set when extraction failed; `variables` may then be partial or empty. */
     error: string | null;
 }
+/** Milliseconds. Each stage has at least one sample, or is omitted. */
+interface LatencyStats {
+    p50: number;
+    p90: number;
+    p95: number;
+    p99: number;
+    min: number;
+    max: number;
+    num: number;
+}
+interface CallLatency {
+    /** Caller's final transcript to the agent's first audio byte. */
+    e2e?: LatencyStats;
+    /** Time to the model's first sentence. */
+    llm?: LatencyStats;
+    /** Time to the first synthesized audio. */
+    tts?: LatencyStats;
+    /** How long end-of-speech detection waited. */
+    endpointing?: LatencyStats;
+}
 interface CallListParams {
+    agent_id?: string | string[] | undefined;
+    status?: CallStatus | CallStatus[] | undefined;
+    direction?: "inbound" | "outbound" | undefined;
+    call_type?: "phone_call" | "web_call" | undefined;
+    disconnection_reason?: DisconnectionReason | DisconnectionReason[] | undefined;
+    from_number?: string | undefined;
+    to_number?: string | undefined;
+    user_sentiment?: "Positive" | "Neutral" | "Negative" | undefined;
+    call_successful?: boolean | undefined;
+    /** Started at or after this time, epoch ms. */
+    start_after?: number | undefined;
+    /** Started before this time, epoch ms. */
+    start_before?: number | undefined;
+    /**
+     * Match calls whose metadata has these values, e.g. `{ crm_id: "42" }`.
+     * Values are compared as strings.
+     */
+    metadata?: Record<string, string | number | boolean> | undefined;
     /** Case-insensitive match on the agent's name. */
     search?: string | undefined;
-    status?: CallStatus | "all" | undefined;
-    /** 1-based. Default 1. */
-    page?: number | undefined;
-    /** 1–100. Default 10. */
-    page_size?: number | undefined;
+    /** Default `desc` (newest first). */
+    sort_order?: "asc" | "desc" | undefined;
+    /** Calls per page, 1–100. Default 10. */
+    limit?: number | undefined;
+}
+interface CallUpdateParams {
+    /** Replaces the call's metadata. A JSON object of at most 16 KB. */
+    metadata: Record<string, unknown>;
+}
+interface CallDeleteResponse {
+    deleted: true;
+    id: string;
+}
+interface CallStopResponse {
+    id: string;
+    /** The call is tearing down; it becomes `completed` with `disconnection_reason: "manual_stopped"` shortly. */
+    stopping: true;
 }
 /** Result of `calls.createPhoneCall`. The call is dialing; its outcome arrives via webhooks or `calls.retrieve`. */
 interface PhoneCallCreateResponse {
@@ -1960,16 +2318,31 @@ interface CallRegisterResponse {
 
 declare class Calls extends APIResource {
     /**
-     * Calls, newest first. Await for one page, or iterate for every call:
+     * Calls, newest first by default. Await for one page, or iterate for every call:
      *
-     *   const page = await dialgem.calls.list({ page_size: 50 })
-     *   for await (const call of dialgem.calls.list({ status: "completed" })) {
-     *     if (call.started_at < cutoff) break // newest first: everything after is older
-     *   }
+     *   const page = await dialgem.calls.list({ limit: 50 })
+     *   for await (const call of dialgem.calls.list({ status: "completed", start_after: since })) { ... }
      */
     list(params?: CallListParams, options?: RequestOptions): PagePromise<Call>;
-    /** One call, including its transcript, analysis and recording URL. */
+    /** One call, including its transcript, analysis, latency and recording URL. */
     retrieve(callId: string, options?: RequestOptions): Promise<Call>;
+    /** Replace the call's `metadata`. */
+    update(callId: string, body: CallUpdateParams, options?: RequestOptions): Promise<Call>;
+    /**
+     * Permanently delete a finished call: its record, transcript, analysis and
+     * recording. A call still in progress is refused with `ConflictError`; stop it first.
+     */
+    delete(callId: string, options?: RequestOptions): Promise<CallDeleteResponse>;
+    /**
+     * End an ongoing call now, as if the agent had hung up. The call becomes
+     * `completed` with `disconnection_reason: "manual_stopped"` a moment later, and
+     * the usual `call_ended` webhook follows.
+     *
+     * `ConflictError` with `errCode` `call_not_ongoing` if it already ended, or
+     * `call_not_connected` if no agent is on the call yet (e.g. still ringing).
+     * Not retried by default.
+     */
+    stop(callId: string, options?: RequestOptions): Promise<CallStopResponse>;
     /**
      * Dial `to` from one of your organization's numbers, with `agent_id` (or the
      * number's outbound agent) on the line.
@@ -2001,9 +2374,51 @@ interface Voice {
     language: string[];
     preview_url: string | null;
     raw_metadata: Record<string, unknown> | null;
+    /** True for a voice your organization cloned; false for the shared catalog. */
+    is_custom: boolean;
+    /** Who uploaded the audio, for a cloned voice. */
+    created_by: string | null;
     created_at: string | null;
     updated_at: string | null;
 }
+/** One audio sample for cloning. `Blob` and `File` both satisfy this. */
+type VoiceCloneFile = Blob | {
+    name?: string;
+    type?: string;
+};
+interface VoiceCloneParams {
+    /** Display name for the new voice. */
+    name: string;
+    /**
+     * The audio to clone from.
+     *
+     * ElevenLabs takes up to 25 files; **Cartesia takes exactly one** and refuses
+     * more rather than silently picking one, since that would make the same
+     * upload produce a noticeably different voice on the two providers.
+     */
+    files: Blob[];
+    /**
+     * You are asserting that you hold the rights to this audio and have the
+     * speaker's consent to clone their voice. Required, and recorded against
+     * your API identity — a cloned voice is built from a real person's speech.
+     */
+    consent_confirmed: true;
+    /** Which provider clones it. Defaults to `elevenlabs`. */
+    engine?: "elevenlabs" | "cartesia" | undefined;
+    description?: string | undefined;
+    /** Cartesia clones per language; ElevenLabs ignores this. Defaults to `en`. */
+    language?: string | undefined;
+    /**
+     * Filenames sent with each blob, in order. The provider infers the audio
+     * container from the extension, so a `Blob` with no name needs one here.
+     * Defaults to `clip-1.wav`, `clip-2.wav`, …
+     */
+    filenames?: string[] | undefined;
+}
+interface VoiceDeleteResponse {
+    deleted: boolean;
+    voice_id: string;
+}
 interface VoiceListParams {
     provider?: string | undefined;
     gender?: string | undefined;
@@ -2053,8 +2468,33 @@ interface FlowTemplate extends FlowTemplateSummary {
 }
 
 declare class Voices extends APIResource {
-    /** Voices available to agents, by name. Put a voice's `provider_voice_id` in an agent's `voice_id`. */
+    /**
+     * Voices available to agents: the shared catalog plus the ones your
+     * organization cloned, yours first. Put a voice's `provider_voice_id` in an
+     * agent's `voice_id`.
+     */
     list(params?: VoiceListParams, options?: RequestOptions): Promise<Voice[]>;
+    /**
+     * Clone a voice from audio you upload. The new voice is private to your
+     * organization and never appears in another one's catalog.
+     *
+     * Consent is required: you are asserting that you hold the rights to the
+     * audio and have the speaker's consent, and that assertion is recorded
+     * against your API identity.
+     *
+     * The upload is never retried, whatever `maxRetries` says — a retried
+     * multipart body can send truncated audio, and a clone built from half the
+     * recording succeeds and sounds wrong.
+     */
+    clone(params: VoiceCloneParams, options?: RequestOptions): Promise<Voice>;
+    /**
+     * Delete a voice your organization cloned, at the provider and here.
+     *
+     * Only your own cloned voices: the shared catalog is not deletable, and a
+     * voice an agent still uses is refused with a 409 rather than leaving that
+     * agent without one.
+     */
+    delete(voiceId: string, options?: RequestOptions): Promise<VoiceDeleteResponse>;
 }
 declare class FlowTemplates extends APIResource {
     /** Built-in conversation-flow templates (summaries, without `flow_config`). */
@@ -2067,6 +2507,18 @@ declare class PromptTemplates extends APIResource {
     retrieve(templateId: string, options?: RequestOptions): Promise<PromptTemplate>;
 }
 
+/**
+ * Which published agent version a number answers on.
+ *
+ * A number is the frozen version with that number; `0` is the live draft, which
+ * is what a number does when nothing is pinned. `"latest_published"` is a
+ * pointer rather than a choice — it follows the newest publish, so shipping a
+ * new version moves every number set to it without touching them.
+ *
+ * A *call* never reports this type: `Call.agent_version` is always the concrete
+ * number that ran, resolved when the call was placed.
+ */
+type AgentVersionRef = number | "latest_published";
 /**
  * A phone number, as returned by `/v1/phone-numbers`.
  * The shape is the same across all phone-number endpoints.
@@ -2082,9 +2534,9 @@ interface PhoneNumber {
     phone_number_type: string;
     nickname: string;
     inbound_agent_id: string | null;
-    inbound_agent_version: number;
+    inbound_agent_version: AgentVersionRef;
     outbound_agent_id: string | null;
-    outbound_agent_version: number;
+    outbound_agent_version: AgentVersionRef;
     /** Weighted inbound routing. `inbound_agent_id` is its primary entry. */
     inbound_agents: PhoneNumberAgentWeight[];
     outbound_agents: PhoneNumberAgentWeight[];
@@ -2098,7 +2550,7 @@ interface PhoneNumber {
 }
 interface PhoneNumberAgentWeight {
     agent_id: string;
-    agent_version: number;
+    agent_version: AgentVersionRef;
     weight: number;
 }
 interface SipOutboundTrunkConfig {
@@ -2113,6 +2565,14 @@ declare class PhoneNumbers extends APIResource {
     create(body: PhoneNumberCreateParams, options?: RequestOptions): Promise<PhoneNumber>;
     /** Every active (not released) number in the organization, newest first. */
     list(options?: RequestOptions): Promise<PhoneNumber[]>;
+    /**
+     * One number by its E.164 value, e.g. `+14155550123`.
+     *
+     * Keyed on the number rather than on `id`, because the number is what you
+     * have when you are asking whether it is registered at all. Throws
+     * `NotFoundError` when it is not.
+     */
+    retrieve(phoneNumber: string, options?: RequestOptions): Promise<PhoneNumber>;
     /**
      * Partial update.
      *
@@ -2129,45 +2589,79 @@ declare class PhoneNumbers extends APIResource {
 }
 
 /**
- * Payloads Dialgem POSTs to an agent's `webhook_url`, subscribed per agent via
- * `webhook_events`. Flat objects with an `event` discriminator; see
- * the "Verify webhooks" section of the README.
+ * Payloads Dialgem POSTs to an agent's `webhook_url`, for the events subscribed in
+ * `webhook_events`. Each carries the full call record; see the "Verify webhooks"
+ * section of the README.
  *
- * Delivery is at-least-once in practice: a failed POST is retried once after a
- * second, so a slow 2xx can arrive twice. Make handlers idempotent on
- * `(event, call_id)`.
+ * A failed delivery is retried up to three times, and every attempt carries the
+ * same `x-dialgem-delivery` id. Use it (or `event` + `call_id`) to drop duplicates.
  */
 type WebhookEvent = CallStartedEvent | CallEndedEvent | CallAnalyzedEvent;
-interface CallStartedEvent {
-    event: "call_started";
+interface CallEventBase {
     call_id: string;
     agent_id: string;
+    /** The full call record at the moment the event was sent. */
+    call: Call;
 }
-interface CallEndedEvent {
+interface CallStartedEvent extends CallEventBase {
+    event: "call_started";
+}
+/** Sent as soon as the call ends; post-call analysis follows in `call_analyzed`. */
+interface CallEndedEvent extends CallEventBase {
     event: "call_ended";
-    call_id: string;
-    agent_id: string;
-    status: CallStatus;
-    duration_s: number | null;
 }
-/** Sent before `call_ended`, and only for calls that produced a transcript. */
-interface CallAnalyzedEvent {
+/** Sent after `call_ended`, once analysis has run, and only for calls that produced a transcript. */
+interface CallAnalyzedEvent extends CallEventBase {
     event: "call_analyzed";
+}
+/**
+ * The body Dialgem POSTs to a custom function's URL when the agent calls it,
+ * unless the function has `args_at_root`, in which case the body is `args` alone.
+ */
+interface FunctionCallRequest<Args = Record<string, unknown>> {
+    /** The function's name. */
+    name: string;
+    call: FunctionCallContext;
+    /** The arguments the agent supplied, per the function's `parameters` schema. */
+    args: Args;
+}
+interface FunctionCallContext {
     call_id: string;
-    agent_id: string;
-    analysis: CallAnalysis;
+    agent_id: string | null;
+    call_type: "phone_call" | "web_call";
+    direction: "inbound" | "outbound" | null;
+    from_number: string | null;
+    to_number: string | null;
+    dynamic_variables: Record<string, string>;
+    metadata: Record<string, unknown>;
 }
 
-/** Header carrying the hex HMAC-SHA256 of the raw request body. */
+/** Header carrying the request signature: `v=<timestamp_ms>,d=<hex>`. */
 declare const WEBHOOK_SIGNATURE_HEADER = "x-dialgem-signature";
 /** Header naming the event; the same value as the body's `event`. */
 declare const WEBHOOK_EVENT_HEADER = "x-dialgem-event";
+/** Header with an id that stays the same across retries of one delivery. */
+declare const WEBHOOK_DELIVERY_HEADER = "x-dialgem-delivery";
+/** Signatures older or newer than this are rejected, so a captured request cannot be replayed. */
+declare const DEFAULT_SIGNATURE_TOLERANCE_MS: number;
 /** The raw request body, byte-for-byte as received. Node `Buffer` is a `Uint8Array`. */
 type WebhookPayload = string | Uint8Array | ArrayBuffer;
 /** A header value as Node's `IncomingHttpHeaders`, `Headers.get()` or a framework hands it over. */
 type SignatureHeader = string | string[] | null | undefined;
+interface VerifyOptions {
+    /** Maximum age (and clock skew) of a signature, in ms. Default 5 minutes. */
+    toleranceMs?: number | undefined;
+    /** The current time in epoch ms. For tests; defaults to `Date.now()`. */
+    now?: number | undefined;
+}
 /**
- * Verifies and parses Dialgem webhooks.
+ * Verifies and parses what Dialgem sends to your servers: event webhooks, and
+ * requests to your custom functions. Both use one signature scheme:
+ *
+ *   x-dialgem-signature: v=<timestamp_ms>,d=<hex>
+ *   hex = HMAC-SHA256(secret, raw_body + timestamp_ms)
+ *
+ * The secret is the agent's `webhook_signing_secret`.
  *
  * **Pass the raw body.** The signature covers the exact bytes Dialgem sent. A body
  * that was parsed and re-serialized (`express.json()`, `JSON.stringify(req.body)`)
@@ -2175,27 +2669,36 @@ type SignatureHeader = string | string[] | null | undefined;
  * Fastify's raw body, or `await request.text()` in a route handler.
  */
 declare class Webhooks {
+    #private;
     /**
-     * Returns whether `signature` is the HMAC-SHA256 of `payload` under `secret`.
-     * Constant-time. Returns `false` for a missing or malformed signature; throws only
-     * if `secret` is empty, which is a configuration error rather than a bad request.
+     * Returns whether `signature` is a current, valid signature of `payload` under
+     * `secret`. Constant-time. Returns `false` for a missing, malformed, tampered or
+     * stale signature; throws only if `secret` is empty, which is a configuration
+     * error rather than a bad request.
+     */
+    verify(payload: WebhookPayload, signature: SignatureHeader, secret: string, options?: VerifyOptions): Promise<boolean>;
+    /**
+     * Verifies a webhook's signature, then parses its body.
+     *
+     * @throws WebhookVerificationError if the signature is missing, invalid or stale.
      */
-    verify(payload: WebhookPayload, signature: SignatureHeader, secret: string): Promise<boolean>;
+    constructEvent(payload: WebhookPayload, signature: SignatureHeader, secret: string, options?: VerifyOptions): Promise<WebhookEvent>;
     /**
-     * Verifies the signature, then parses the body.
+     * Verifies a request Dialgem made to one of your custom functions, then parses
+     * its body. For functions with `args_at_root`, the body is the arguments object
+     * alone; use `verify` and parse it yourself.
      *
-     * @throws WebhookVerificationError if the signature is missing or does not match.
+     * @throws WebhookVerificationError if the signature is missing, invalid or stale.
      */
-    constructEvent(payload: WebhookPayload, signature: SignatureHeader, secret: string): Promise<WebhookEvent>;
+    constructFunctionCall<Args = Record<string, unknown>>(payload: WebhookPayload, signature: SignatureHeader, secret: string, options?: VerifyOptions): Promise<FunctionCallRequest<Args>>;
 }
 declare const webhooks: Webhooks;
 
-declare const DEFAULT_BASE_URL = "https://api.dialgem.com";
+/** The Dialgem API. Fixed: the SDK talks to Dialgem and nothing else. */
+declare const BASE_URL = "https://api.dialgem.com";
 interface ClientOptions {
     /** Organization API key (`zk_…`). Defaults to `process.env.DIALGEM_API_KEY`. */
     apiKey?: string | undefined;
-    /** Defaults to `process.env.DIALGEM_BASE_URL`, then `https://api.dialgem.com`. */
-    baseURL?: string | undefined;
     /** Per-attempt timeout in milliseconds (> 0). Default 60000. */
     timeout?: number | undefined;
     /** Retries for GET/PATCH/DELETE on 408/429/5xx and connection errors. Default 2. POST is not retried. */
@@ -2221,7 +2724,7 @@ interface ClientOptions {
  * ```
  */
 declare class Dialgem {
-    static readonly DEFAULT_BASE_URL = "https://api.dialgem.com";
+    static readonly BASE_URL = "https://api.dialgem.com";
     /** Webhook verification without a client instance: `Dialgem.webhooks.constructEvent(...)`. */
     static readonly webhooks: Webhooks;
     readonly agents: Agents;
@@ -2231,10 +2734,11 @@ declare class Dialgem {
     readonly flowTemplates: FlowTemplates;
     readonly promptTemplates: PromptTemplates;
     readonly webhooks: Webhooks;
+    /** Always `https://api.dialgem.com`. */
     readonly baseURL: string;
     constructor(options?: ClientOptions);
 }
 
-declare const VERSION = "0.1.0-beta.0";
+declare const VERSION = "0.1.0-beta.1";
 
-export { APIConnectionError, APIConnectionTimeoutError, APIError, APIUserAbortError, type Agent, type AgentCreateParams, type AgentDeleteResponse, type AgentFunction, AgentFunctions, AgentKnowledge, AgentMCPServers, type AgentType, type AgentUpdateParams, type AgentWeight, Agents, AuthenticationError, BadRequestError, type Call, type CallAnalysis, type CallAnalyzedEvent, type CallCost, type CallCreatePhoneCallParams, type CallEndedEvent, type CallListParams, type CallRegisterParams, type CallRegisterResponse, type CallSessionStatus, type CallStartedEvent, type CallStatus, Calls, type ClientOptions, ConflictError, DEFAULT_BASE_URL, Dialgem, DialgemError, type ErrorBody, type ErrorIssue, type Fetch, type FetchInit, type FetchResponse, type FlowConfig, type FlowTemplate, type FlowTemplateSummary, FlowTemplates, type FunctionCreateParams, type FunctionKind, type FunctionReorderParams, type FunctionUpdateParams, type HeadersLike, InternalServerError, type KeyValuePair, type KnowledgeDocument, type KnowledgeDocumentCreateParams, type MCPServer, type MCPServerCreateParams, type MCPServerTestResult, type MCPServerUpdateParams, NotFoundError, Page, type PageData, PagePromise, PermissionDeniedError, type PhoneCallCreateResponse, type PhoneNumber, type PhoneNumberAgentWeight, type PhoneNumberAssignParams, type PhoneNumberCreateParams, type PhoneNumberUpdateParams, PhoneNumbers, type PostCallAnalysisVariable, type PromptState, type PromptTemplate, type PromptTemplateSummary, PromptTemplates, RateLimitError, type RequestBody, type RequestOptions, type SignatureHeader, type SipOutboundTrunkConfig, type TemplateListParams, type TranscriptTurn, UnprocessableEntityError, VERSION, type Voice, type VoiceListParams, Voices, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, type WebhookEvent, type WebhookEventType, type WebhookPayload, WebhookVerificationError, Webhooks, webhooks };
+export { APIConnectionError, APIConnectionTimeoutError, APIError, APIUserAbortError, type Agent, type AgentCreateParams, type AgentDeleteResponse, type AgentFunction, AgentFunctions, AgentKnowledge, AgentMCPServers, type AgentType, type AgentUpdateParams, type AgentVersion, type AgentVersionConfig, type AgentVersionListParams, type AgentVersionListResponse, type AgentVersionMCPServer, type AgentVersionPublishParams, type AgentVersionRef, type AgentVersionSummary, AgentVersions, type AgentWeight, Agents, AuthenticationError, BASE_URL, BadRequestError, type Call, type CallAnalysis, type CallAnalyzedEvent, type CallCost, type CallCreatePhoneCallParams, type CallDeleteResponse, type CallEndedEvent, type CallLatency, type CallListParams, type CallRegisterParams, type CallRegisterResponse, type CallSessionStatus, type CallStartedEvent, type CallStatus, type CallStopResponse, type CallUpdateParams, Calls, type ClientOptions, ConflictError, DEFAULT_SIGNATURE_TOLERANCE_MS, Dialgem, DialgemError, type DisconnectionReason, type ErrorBody, type ErrorIssue, type Fetch, type FetchInit, type FetchResponse, type FlowConfig, type FlowTemplate, type FlowTemplateSummary, FlowTemplates, type FunctionCallContext, type FunctionCallRequest, type FunctionCreateParams, type FunctionKind, type FunctionReorderParams, type FunctionUpdateParams, type HeadersLike, InternalServerError, type KeyValuePair, type KnowledgeDocument, type KnowledgeDocumentCreateParams, type LatencyStats, type MCPServer, type MCPServerCreateParams, type MCPServerTestResult, type MCPServerUpdateParams, NotFoundError, Page, type PageData, PagePromise, PermissionDeniedError, type PhoneCallCreateResponse, type PhoneNumber, type PhoneNumberAgentWeight, type PhoneNumberAssignParams, type PhoneNumberCreateParams, type PhoneNumberUpdateParams, PhoneNumbers, type PostCallAnalysisVariable, type PromptState, type PromptTemplate, type PromptTemplateSummary, PromptTemplates, RateLimitError, type RequestBody, type RequestOptions, type SignatureHeader, type SipOutboundTrunkConfig, type TemplateListParams, type TranscriptTurn, UnprocessableEntityError, VERSION, type VerifyOptions, type Voice, type VoiceCloneFile, type VoiceCloneParams, type VoiceDeleteResponse, type VoiceListParams, Voices, WEBHOOK_DELIVERY_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, type WebhookEvent, type WebhookEventType, type WebhookPayload, WebhookVerificationError, Webhooks, webhooks };