nixflex 0.2.2 → 0.3.1

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 0.3.1 (2026-08-24)
+
+- Voicemail as a structured setting: `voicemail_leave_enabled` + `voicemail_message` on Agent (applies to dashboard-imported numbers) and on PhoneNumber / PhoneNumberUpdateParams (the only voicemail control for API-imported numbers - no inheritance across the two worlds)
+- Enabling without a message is rejected with `voicemail_message_required`
+- No breaking changes.
+## 0.3.0 (2026-08-23)
+
+- Call type: `charged_minutes` (minutes actually billed - transfers stop the meter at handoff, so this can be less than the recording length)
+- Call type: `ended_reason` documented with the full value list, including the new `callee_hangup` (outbound) and carrier words (`busy`, `failed`, `no-answer`, `canceled`)
+- No breaking changes. `list` pagination (`limit`/`offset`) shipped previously in 0.2.x.
 # Changelog
 
 All notable changes to the `nixflex` package. This project follows

package/dist/index.d.cts

@@ -66,6 +66,12 @@ interface AgentCreateParams {
     amd_enabled?: boolean;
     /** Keypad digits instead of speech. Three-state: true/false explicit, null = not set (a number's own setting decides). */
     dtmf_enabled?: boolean | null;
+    /** Leave a message on detected voicemails. Applies to DASHBOARD-imported numbers on
+     * this agent; API-imported numbers use their own per-number setting instead. Enabling
+     * without voicemail_message is rejected with voicemail_message_required. */
+    voicemail_leave_enabled?: boolean;
+    /** Spoken word for word on voicemail when enabled - the agent never rewrites it. */
+    voicemail_message?: string | null;
     /** Where to POST post-call data. */
     webhook_url?: string | null;
     /** Agent can end the call cleanly. Default true. */
@@ -124,6 +130,8 @@ interface Agent {
     fallback_message: string;
     post_call_sms_enabled?: boolean;
     post_call_sms_template?: string | null;
+    voicemail_leave_enabled?: boolean;
+    voicemail_message?: string | null;
     data_extraction_fields?: unknown[];
     is_active: boolean;
     created_at: string;
@@ -183,7 +191,14 @@ interface Call {
     answered_at: number | null;
     /** TIME CONNECTED in ms (answer to hangup) - the number you are billed on. Ring time excluded, so on outbound this is NOT end_timestamp - start_timestamp. */
     duration_ms: number;
+    /** Why the call ended: completed, transferred, voicemail_detected, silence_timeout,
+     * ivr_timeout, max_duration_reached, caller_hangup (inbound), callee_hangup (outbound),
+     * busy / failed / no-answer / canceled (carrier words for calls that never connected),
+     * concurrency_limit, and rare infrastructure endings. */
     ended_reason: string;
+    /** Minutes actually charged for this call. Transfers stop the meter at handoff, so
+     * this can be less than duration_ms suggests - the recording runs to the end either way. */
+    charged_minutes?: number;
     /** A single string, one turn per line - not an array of turn objects. */
     transcript: string;
     call_summary: string;
@@ -378,6 +393,12 @@ interface PhoneNumber {
     custom_prompt?: string | null;
     voice_id?: string | null;
     sms_reply_enabled?: boolean;
+    /** This number's own voicemail setting - the ONLY one that applies to API-imported
+     * numbers (dashboard-imported numbers follow the agent). null = not set = silent
+     * hangup on voicemail. */
+    voicemail_leave_enabled?: boolean | null;
+    /** Spoken word for word on a detected voicemail when enabled. */
+    voicemail_message?: string | null;
     sms_prompt?: string | null;
     web_prompt?: string | null;
     speaking_rate?: number | null;
@@ -394,6 +415,12 @@ interface PhoneNumberUpdateParams {
     voice_id?: string | null;
     /** SMS agent auto-reply on/off. Default false. */
     sms_reply_enabled?: boolean;
+    /** This number's own voicemail toggle - the only voicemail control for API-imported
+     * numbers. Enabling without a message (here or already saved) is rejected with
+     * voicemail_message_required. null clears. */
+    voicemail_leave_enabled?: boolean | null;
+    /** Spoken word for word on voicemail. Max 2000. null clears. */
+    voicemail_message?: string | null;
     /** SMS agent instructions (independent channel). Max 20000. null clears. */
     sms_prompt?: string | null;
     /** Web agent instructions (independent channel). Max 20000. null clears. */

package/dist/index.d.ts

@@ -66,6 +66,12 @@ interface AgentCreateParams {
     amd_enabled?: boolean;
     /** Keypad digits instead of speech. Three-state: true/false explicit, null = not set (a number's own setting decides). */
     dtmf_enabled?: boolean | null;
+    /** Leave a message on detected voicemails. Applies to DASHBOARD-imported numbers on
+     * this agent; API-imported numbers use their own per-number setting instead. Enabling
+     * without voicemail_message is rejected with voicemail_message_required. */
+    voicemail_leave_enabled?: boolean;
+    /** Spoken word for word on voicemail when enabled - the agent never rewrites it. */
+    voicemail_message?: string | null;
     /** Where to POST post-call data. */
     webhook_url?: string | null;
     /** Agent can end the call cleanly. Default true. */
@@ -124,6 +130,8 @@ interface Agent {
     fallback_message: string;
     post_call_sms_enabled?: boolean;
     post_call_sms_template?: string | null;
+    voicemail_leave_enabled?: boolean;
+    voicemail_message?: string | null;
     data_extraction_fields?: unknown[];
     is_active: boolean;
     created_at: string;
@@ -183,7 +191,14 @@ interface Call {
     answered_at: number | null;
     /** TIME CONNECTED in ms (answer to hangup) - the number you are billed on. Ring time excluded, so on outbound this is NOT end_timestamp - start_timestamp. */
     duration_ms: number;
+    /** Why the call ended: completed, transferred, voicemail_detected, silence_timeout,
+     * ivr_timeout, max_duration_reached, caller_hangup (inbound), callee_hangup (outbound),
+     * busy / failed / no-answer / canceled (carrier words for calls that never connected),
+     * concurrency_limit, and rare infrastructure endings. */
     ended_reason: string;
+    /** Minutes actually charged for this call. Transfers stop the meter at handoff, so
+     * this can be less than duration_ms suggests - the recording runs to the end either way. */
+    charged_minutes?: number;
     /** A single string, one turn per line - not an array of turn objects. */
     transcript: string;
     call_summary: string;
@@ -378,6 +393,12 @@ interface PhoneNumber {
     custom_prompt?: string | null;
     voice_id?: string | null;
     sms_reply_enabled?: boolean;
+    /** This number's own voicemail setting - the ONLY one that applies to API-imported
+     * numbers (dashboard-imported numbers follow the agent). null = not set = silent
+     * hangup on voicemail. */
+    voicemail_leave_enabled?: boolean | null;
+    /** Spoken word for word on a detected voicemail when enabled. */
+    voicemail_message?: string | null;
     sms_prompt?: string | null;
     web_prompt?: string | null;
     speaking_rate?: number | null;
@@ -394,6 +415,12 @@ interface PhoneNumberUpdateParams {
     voice_id?: string | null;
     /** SMS agent auto-reply on/off. Default false. */
     sms_reply_enabled?: boolean;
+    /** This number's own voicemail toggle - the only voicemail control for API-imported
+     * numbers. Enabling without a message (here or already saved) is rejected with
+     * voicemail_message_required. null clears. */
+    voicemail_leave_enabled?: boolean | null;
+    /** Spoken word for word on voicemail. Max 2000. null clears. */
+    voicemail_message?: string | null;
     /** SMS agent instructions (independent channel). Max 20000. null clears. */
     sms_prompt?: string | null;
     /** Web agent instructions (independent channel). Max 20000. null clears. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nixflex",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Official Node.js SDK for the Nixflex voice AI platform - AI phone agents, outbound campaigns, and SMS.",
   "keywords": [
     "nixflex",