phonic 0.30.9 → 0.30.11

package/dist/esm/api/types/LanguageCode.mjs

@@ -0,0 +1,24 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const LanguageCode = {
+    Ar: "ar",
+    Zh: "zh",
+    Cs: "cs",
+    Da: "da",
+    Nl: "nl",
+    En: "en",
+    Fr: "fr",
+    De: "de",
+    Id: "id",
+    It: "it",
+    Ja: "ja",
+    Ko: "ko",
+    Pl: "pl",
+    Pt: "pt",
+    Ru: "ru",
+    Es: "es",
+    Sv: "sv",
+    Tr: "tr",
+    Vi: "vi",
+};

package/dist/esm/api/types/OutboundCallConfig.d.mts

@@ -1,6 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Phonic from "../index.mjs";
 /**
  * When an `agent` is provided, these `config` options override the agent settings.
  */
@@ -24,7 +25,7 @@ export interface OutboundCallConfig {
     /** Seconds of silence before ending the conversation. */
     no_input_end_conversation_sec?: number;
     /** Array of ISO 639-1 language codes that the agent should be able to recognize */
-    recognized_languages?: string[];
+    languages?: Phonic.LanguageCode[];
     /** These words, or short phrases, will be more accurately recognized by the agent. */
     boosted_keywords?: string[];
     /** Array of built-in or custom tool names to use. */

package/dist/esm/api/types/index.d.mts

@@ -2,6 +2,7 @@ export * from "./BadRequestErrorBody.mjs";
 export * from "./Error_.mjs";
 export * from "./BasicError.mjs";
 export * from "./ValidationError.mjs";
+export * from "./LanguageCode.mjs";
 export * from "./Agent.mjs";
 export * from "./CreateAgentRequest.mjs";
 export * from "./Tool.mjs";

package/dist/esm/api/types/index.mjs

@@ -2,6 +2,7 @@ export * from "./BadRequestErrorBody.mjs";
 export * from "./Error_.mjs";
 export * from "./BasicError.mjs";
 export * from "./ValidationError.mjs";
+export * from "./LanguageCode.mjs";
 export * from "./Agent.mjs";
 export * from "./CreateAgentRequest.mjs";
 export * from "./Tool.mjs";

package/dist/esm/core/fetcher/Fetcher.d.mts

@@ -6,7 +6,7 @@ export declare namespace Fetcher {
         url: string;
         method: string;
         contentType?: string;
-        headers?: Record<string, string | Supplier<string | undefined> | undefined>;
+        headers?: Record<string, string | Supplier<string | null | undefined> | null | undefined>;
         queryParameters?: Record<string, unknown>;
         body?: unknown;
         timeoutMs?: number;

package/dist/esm/core/fetcher/requestWithRetries.mjs

@@ -11,21 +11,57 @@ const INITIAL_RETRY_DELAY = 1000; // in milliseconds
 const MAX_RETRY_DELAY = 60000; // in milliseconds
 const DEFAULT_MAX_RETRIES = 2;
 const JITTER_FACTOR = 0.2; // 20% random jitter
-function addJitter(delay) {
-    // Generate a random value between -JITTER_FACTOR and +JITTER_FACTOR
-    const jitterMultiplier = 1 + (Math.random() * 2 - 1) * JITTER_FACTOR;
+function addPositiveJitter(delay) {
+    // Generate a random value between 0 and +JITTER_FACTOR
+    const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
     return delay * jitterMultiplier;
 }
+function addSymmetricJitter(delay) {
+    // Generate a random value in a JITTER_FACTOR-sized percentage range around delay
+    const jitterMultiplier = 1 + (Math.random() - 0.5) * JITTER_FACTOR;
+    return delay * jitterMultiplier;
+}
+function getRetryDelayFromHeaders(response, retryAttempt) {
+    // Check for Retry-After header first (RFC 7231), with no jitter
+    const retryAfter = response.headers.get("Retry-After");
+    if (retryAfter) {
+        // Parse as number of seconds...
+        const retryAfterSeconds = parseInt(retryAfter, 10);
+        if (!isNaN(retryAfterSeconds) && retryAfterSeconds > 0) {
+            return Math.min(retryAfterSeconds * 1000, MAX_RETRY_DELAY);
+        }
+        // ...or as an HTTP date; both are valid
+        const retryAfterDate = new Date(retryAfter);
+        if (!isNaN(retryAfterDate.getTime())) {
+            const delay = retryAfterDate.getTime() - Date.now();
+            if (delay > 0) {
+                return Math.min(Math.max(delay, 0), MAX_RETRY_DELAY);
+            }
+        }
+    }
+    // Then check for industry-standard X-RateLimit-Reset header, with positive jitter
+    const rateLimitReset = response.headers.get("X-RateLimit-Reset");
+    if (rateLimitReset) {
+        const resetTime = parseInt(rateLimitReset, 10);
+        if (!isNaN(resetTime)) {
+            // Assume Unix timestamp in epoch seconds
+            const delay = resetTime * 1000 - Date.now();
+            if (delay > 0) {
+                return addPositiveJitter(Math.min(delay, MAX_RETRY_DELAY));
+            }
+        }
+    }
+    // Fall back to exponential backoff, with symmetric jitter
+    return addSymmetricJitter(Math.min(INITIAL_RETRY_DELAY * Math.pow(2, retryAttempt), MAX_RETRY_DELAY));
+}
 export function requestWithRetries(requestFn_1) {
     return __awaiter(this, arguments, void 0, function* (requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
         let response = yield requestFn();
         for (let i = 0; i < maxRetries; ++i) {
             if ([408, 429].includes(response.status) || response.status >= 500) {
-                // Calculate base delay using exponential backoff (in milliseconds)
-                const baseDelay = Math.min(INITIAL_RETRY_DELAY * Math.pow(2, i), MAX_RETRY_DELAY);
-                // Add jitter to the delay
-                const delayWithJitter = addJitter(baseDelay);
-                yield new Promise((resolve) => setTimeout(resolve, delayWithJitter));
+                // Get delay with appropriate jitter applied
+                const delay = getRetryDelayFromHeaders(response, i);
+                yield new Promise((resolve) => setTimeout(resolve, delay));
                 response = yield requestFn();
             }
             else {

package/dist/esm/core/headers.d.mts

@@ -1,3 +1,3 @@
 import * as core from "./index.mjs";
-export declare function mergeHeaders(...headersArray: (Record<string, string | core.Supplier<string | undefined> | undefined> | undefined)[]): Record<string, string | core.Supplier<string | undefined>>;
-export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, string | core.Supplier<string | undefined> | undefined> | undefined)[]): Record<string, string | core.Supplier<string | undefined>>;
+export declare function mergeHeaders(...headersArray: (Record<string, string | core.Supplier<string | null | undefined> | null | undefined> | null | undefined)[]): Record<string, string | core.Supplier<string | null | undefined>>;
+export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, string | core.Supplier<string | null | undefined> | null | undefined> | null | undefined)[]): Record<string, string | core.Supplier<string | null | undefined>>;

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.30.9";
+export declare const SDK_VERSION = "0.30.11";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.30.9";
+export const SDK_VERSION = "0.30.11";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "phonic",
-    "version": "0.30.9",
+    "version": "0.30.11",
     "private": false,
     "repository": "github:Phonic-Co/phonic-node",
     "type": "commonjs",

package/reference.md

@@ -114,7 +114,7 @@ await client.agents.create({
     tools: ["keypad_input"],
     no_input_poke_sec: 30,
     no_input_poke_text: "Are you still there?",
-    recognized_languages: ["en", "es"],
+    languages: ["en", "es"],
     boosted_keywords: ["Load ID", "dispatch"],
     configuration_endpoint: {
         url: "https://api.example.com/config",
@@ -207,7 +207,7 @@ await client.agents.upsert({
     tools: ["keypad_input"],
     no_input_poke_sec: 30,
     no_input_poke_text: "Are you still there?",
-    recognized_languages: ["en", "es"],
+    languages: ["en", "es"],
     boosted_keywords: ["Load ID", "dispatch"],
     configuration_endpoint: {
         url: "https://api.example.com/config",
@@ -446,7 +446,7 @@ await client.agents.update("nameOrId", {
     tools: ["keypad_input"],
     no_input_poke_sec: 30,
     no_input_poke_text: "Are you still there?",
-    recognized_languages: ["en", "es"],
+    languages: ["en", "es"],
     boosted_keywords: ["Load ID", "dispatch"],
     configuration_endpoint: {
         url: "https://api.example.com/config",
@@ -1961,7 +1961,7 @@ await client.conversations.outboundCall({
         no_input_poke_sec: 30,
         no_input_poke_text: "Are you still there?",
         no_input_end_conversation_sec: 180,
-        recognized_languages: ["en", "es"],
+        languages: ["en", "es"],
         boosted_keywords: ["Load ID", "dispatch"],
         tools: ["keypad_input"],
     },