phonic 0.30.11 → 0.30.13

package/dist/cjs/Client.js

@@ -50,8 +50,8 @@ class PhonicClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "phonic",
-                "X-Fern-SDK-Version": "0.30.11",
-                "User-Agent": "phonic/0.30.11",
+                "X-Fern-SDK-Version": "0.30.13",
+                "User-Agent": "phonic/0.30.13",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/resources/conversations/client/requests/ConversationsListRequest.d.ts

@@ -21,10 +21,10 @@ export interface ConversationsListRequest {
     started_at_min?: string;
     /** Maximum start date/time. Valid examples: `2025-04-17`, `2025-04-17T02:48:52.708Z` */
     started_at_max?: string;
-    /** Cursor for pagination (before). */
+    /** Cursor for backward pagination. Use a conversation ID from `pagination.prev_cursor` to fetch the previous page of conversations. Cannot be used with `after`. */
     before?: string;
-    /** Cursor for pagination (after). */
+    /** Cursor for forward pagination. Use a conversation ID from `pagination.next_cursor` to fetch the next page of conversations. Cannot be used with `before`. */
     after?: string;
-    /** Maximum number of conversations to return. */
+    /** Maximum number of conversations to return per page. */
     limit?: number;
 }

package/dist/cjs/api/resources/conversations/types/ConversationsListResponse.d.ts

@@ -4,6 +4,10 @@
 import * as Phonic from "../../../index.js";
 export type ConversationsListResponse = {
     conversations: Phonic.Conversation[];
+    pagination: {
+        prev_cursor: string | null;
+        next_cursor: string | null;
+    };
 } | {
     conversation: Phonic.Conversation;
 };

package/dist/cjs/api/resources/tools/client/Client.d.ts

@@ -66,12 +66,14 @@ export declare class Tools {
      *                 type: "string",
      *                 name: "date",
      *                 description: "The date for the appointment in YYYY-MM-DD format",
-     *                 is_required: true
+     *                 is_required: true,
+     *                 location: "request_body"
      *             }, {
      *                 type: "string",
      *                 name: "time",
      *                 description: "The time for the appointment in HH:MM format",
-     *                 is_required: true
+     *                 is_required: true,
+     *                 location: "request_body"
      *             }],
      *         endpoint_method: "POST",
      *         endpoint_url: "https://api.example.com/book-appointment",

package/dist/cjs/api/resources/tools/client/Client.js

@@ -154,12 +154,14 @@ class Tools {
      *                 type: "string",
      *                 name: "date",
      *                 description: "The date for the appointment in YYYY-MM-DD format",
-     *                 is_required: true
+     *                 is_required: true,
+     *                 location: "request_body"
      *             }, {
      *                 type: "string",
      *                 name: "time",
      *                 description: "The time for the appointment in HH:MM format",
-     *                 is_required: true
+     *                 is_required: true,
+     *                 location: "request_body"
      *             }],
      *         endpoint_method: "POST",
      *         endpoint_url: "https://api.example.com/book-appointment",

package/dist/cjs/api/resources/tools/client/requests/CreateToolRequest.d.ts

@@ -14,12 +14,14 @@ import * as Phonic from "../../../../index.js";
  *                 type: "string",
  *                 name: "date",
  *                 description: "The date for the appointment in YYYY-MM-DD format",
- *                 is_required: true
+ *                 is_required: true,
+ *                 location: "request_body"
  *             }, {
  *                 type: "string",
  *                 name: "time",
  *                 description: "The time for the appointment in HH:MM format",
- *                 is_required: true
+ *                 is_required: true,
+ *                 location: "request_body"
  *             }],
  *         endpoint_method: "POST",
  *         endpoint_url: "https://api.example.com/book-appointment",
@@ -67,10 +69,15 @@ export interface CreateToolRequest {
     type: CreateToolRequest.Type;
     /** Mode of operation. */
     execution_mode: CreateToolRequest.ExecutionMode;
-    /** Array of parameter definitions. */
+    /**
+     * Array of parameter definitions.
+     * For `custom_webhook` tools with POST method, each parameter must include a `location` field.
+     * For `custom_webhook` tools with GET method, `location` defaults to `"query_string"` if not specified.
+     * For `custom_websocket` and `built_in_transfer_to_phone_number` tools, `location` must not be specified.
+     */
     parameters?: Phonic.ToolParameter[];
-    /** Required for webhook tools. */
-    endpoint_method?: "POST";
+    /** Required for webhook tools. HTTP method for the webhook endpoint. */
+    endpoint_method?: CreateToolRequest.EndpointMethod;
     /** Required for webhook tools. */
     endpoint_url?: string;
     /** Optional headers for webhook tools. */
@@ -100,4 +107,12 @@ export declare namespace CreateToolRequest {
         readonly Sync: "sync";
         readonly Async: "async";
     };
+    /**
+     * Required for webhook tools. HTTP method for the webhook endpoint.
+     */
+    type EndpointMethod = "GET" | "POST";
+    const EndpointMethod: {
+        readonly Get: "GET";
+        readonly Post: "POST";
+    };
 }

package/dist/cjs/api/resources/tools/client/requests/CreateToolRequest.js

@@ -15,4 +15,8 @@ var CreateToolRequest;
         Sync: "sync",
         Async: "async",
     };
+    CreateToolRequest.EndpointMethod = {
+        Get: "GET",
+        Post: "POST",
+    };
 })(CreateToolRequest || (exports.CreateToolRequest = CreateToolRequest = {}));

package/dist/cjs/api/resources/tools/client/requests/UpdateToolRequest.d.ts

@@ -24,9 +24,15 @@ export interface UpdateToolRequest {
     type?: UpdateToolRequest.Type;
     /** Mode of operation. */
     execution_mode?: UpdateToolRequest.ExecutionMode;
-    /** Array of parameter definitions. */
+    /**
+     * Array of parameter definitions.
+     * When updating `type` or `endpoint_method`, all parameters must include explicit `location` values.
+     * For `custom_webhook` tools: `location` is required for POST, defaults to `"query_string"` for GET.
+     * For `custom_websocket` and `built_in_transfer_to_phone_number` tools: `location` must not be specified.
+     */
     parameters?: Phonic.ToolParameter[];
-    endpoint_method?: "POST";
+    /** HTTP method for webhook tools. When changing this value, all parameters must include explicit `location` values. */
+    endpoint_method?: UpdateToolRequest.EndpointMethod;
     endpoint_url?: string;
     endpoint_headers?: Record<string, string>;
     endpoint_timeout_ms?: number;
@@ -52,4 +58,12 @@ export declare namespace UpdateToolRequest {
         readonly Sync: "sync";
         readonly Async: "async";
     };
+    /**
+     * HTTP method for webhook tools. When changing this value, all parameters must include explicit `location` values.
+     */
+    type EndpointMethod = "GET" | "POST";
+    const EndpointMethod: {
+        readonly Get: "GET";
+        readonly Post: "POST";
+    };
 }

package/dist/cjs/api/resources/tools/client/requests/UpdateToolRequest.js

@@ -15,4 +15,8 @@ var UpdateToolRequest;
         Sync: "sync",
         Async: "async",
     };
+    UpdateToolRequest.EndpointMethod = {
+        Get: "GET",
+        Post: "POST",
+    };
 })(UpdateToolRequest || (exports.UpdateToolRequest = UpdateToolRequest = {}));

package/dist/cjs/api/types/Tool.d.ts

@@ -17,7 +17,7 @@ export interface Tool {
     /** Array of parameter definitions for the tool. */
     parameters: Phonic.ToolParameter[];
     /** HTTP method for webhook tools. */
-    endpoint_method?: "POST";
+    endpoint_method?: Tool.EndpointMethod;
     /** URL for webhook tools. */
     endpoint_url?: string;
     /** Headers for webhook tools. */
@@ -51,4 +51,12 @@ export declare namespace Tool {
         readonly Sync: "sync";
         readonly Async: "async";
     };
+    /**
+     * HTTP method for webhook tools.
+     */
+    type EndpointMethod = "GET" | "POST";
+    const EndpointMethod: {
+        readonly Get: "GET";
+        readonly Post: "POST";
+    };
 }

package/dist/cjs/api/types/Tool.js

@@ -15,4 +15,8 @@ var Tool;
         Sync: "sync",
         Async: "async",
     };
+    Tool.EndpointMethod = {
+        Get: "GET",
+        Post: "POST",
+    };
 })(Tool || (exports.Tool = Tool = {}));

package/dist/cjs/api/types/ToolParameter.d.ts

@@ -12,6 +12,14 @@ export interface ToolParameter {
     description: string;
     /** Whether the parameter is required. */
     is_required: boolean;
+    /**
+     * Only applicable for `custom_webhook` tools. Specifies where the parameter should be sent in the webhook request.
+     * - For GET webhooks: defaults to `"query_string"` and `"request_body"` is not allowed.
+     * - For POST webhooks: required, can be either `"request_body"` or `"query_string"`.
+     * - Not allowed for `custom_websocket` or `built_in_transfer_to_phone_number` tools.
+     * When updating a tool's type or endpoint_method, all parameters must include explicit `location` values.
+     */
+    location?: ToolParameter.Location;
 }
 export declare namespace ToolParameter {
     /**
@@ -35,4 +43,16 @@ export declare namespace ToolParameter {
         readonly Number: "number";
         readonly Boolean: "boolean";
     };
+    /**
+     * Only applicable for `custom_webhook` tools. Specifies where the parameter should be sent in the webhook request.
+     * - For GET webhooks: defaults to `"query_string"` and `"request_body"` is not allowed.
+     * - For POST webhooks: required, can be either `"request_body"` or `"query_string"`.
+     * - Not allowed for `custom_websocket` or `built_in_transfer_to_phone_number` tools.
+     * When updating a tool's type or endpoint_method, all parameters must include explicit `location` values.
+     */
+    type Location = "request_body" | "query_string";
+    const Location: {
+        readonly RequestBody: "request_body";
+        readonly QueryString: "query_string";
+    };
 }

package/dist/cjs/api/types/ToolParameter.js

@@ -19,4 +19,8 @@ var ToolParameter;
         Number: "number",
         Boolean: "boolean",
     };
+    ToolParameter.Location = {
+        RequestBody: "request_body",
+        QueryString: "query_string",
+    };
 })(ToolParameter || (exports.ToolParameter = ToolParameter = {}));

package/dist/cjs/version.d.ts

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

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.30.11";
+exports.SDK_VERSION = "0.30.13";

package/dist/esm/Client.mjs

@@ -14,8 +14,8 @@ export class PhonicClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "phonic",
-                "X-Fern-SDK-Version": "0.30.11",
-                "User-Agent": "phonic/0.30.11",
+                "X-Fern-SDK-Version": "0.30.13",
+                "User-Agent": "phonic/0.30.13",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/resources/conversations/client/requests/ConversationsListRequest.d.mts

@@ -21,10 +21,10 @@ export interface ConversationsListRequest {
     started_at_min?: string;
     /** Maximum start date/time. Valid examples: `2025-04-17`, `2025-04-17T02:48:52.708Z` */
     started_at_max?: string;
-    /** Cursor for pagination (before). */
+    /** Cursor for backward pagination. Use a conversation ID from `pagination.prev_cursor` to fetch the previous page of conversations. Cannot be used with `after`. */
     before?: string;
-    /** Cursor for pagination (after). */
+    /** Cursor for forward pagination. Use a conversation ID from `pagination.next_cursor` to fetch the next page of conversations. Cannot be used with `before`. */
     after?: string;
-    /** Maximum number of conversations to return. */
+    /** Maximum number of conversations to return per page. */
     limit?: number;
 }

package/dist/esm/api/resources/conversations/types/ConversationsListResponse.d.mts

@@ -4,6 +4,10 @@
 import * as Phonic from "../../../index.mjs";
 export type ConversationsListResponse = {
     conversations: Phonic.Conversation[];
+    pagination: {
+        prev_cursor: string | null;
+        next_cursor: string | null;
+    };
 } | {
     conversation: Phonic.Conversation;
 };

package/dist/esm/api/resources/tools/client/Client.d.mts

@@ -66,12 +66,14 @@ export declare class Tools {
      *                 type: "string",
      *                 name: "date",
      *                 description: "The date for the appointment in YYYY-MM-DD format",
-     *                 is_required: true
+     *                 is_required: true,
+     *                 location: "request_body"
      *             }, {
      *                 type: "string",
      *                 name: "time",
      *                 description: "The time for the appointment in HH:MM format",
-     *                 is_required: true
+     *                 is_required: true,
+     *                 location: "request_body"
      *             }],
      *         endpoint_method: "POST",
      *         endpoint_url: "https://api.example.com/book-appointment",

package/dist/esm/api/resources/tools/client/Client.mjs

@@ -118,12 +118,14 @@ export class Tools {
      *                 type: "string",
      *                 name: "date",
      *                 description: "The date for the appointment in YYYY-MM-DD format",
-     *                 is_required: true
+     *                 is_required: true,
+     *                 location: "request_body"
      *             }, {
      *                 type: "string",
      *                 name: "time",
      *                 description: "The time for the appointment in HH:MM format",
-     *                 is_required: true
+     *                 is_required: true,
+     *                 location: "request_body"
      *             }],
      *         endpoint_method: "POST",
      *         endpoint_url: "https://api.example.com/book-appointment",

package/dist/esm/api/resources/tools/client/requests/CreateToolRequest.d.mts

@@ -14,12 +14,14 @@ import * as Phonic from "../../../../index.mjs";
  *                 type: "string",
  *                 name: "date",
  *                 description: "The date for the appointment in YYYY-MM-DD format",
- *                 is_required: true
+ *                 is_required: true,
+ *                 location: "request_body"
  *             }, {
  *                 type: "string",
  *                 name: "time",
  *                 description: "The time for the appointment in HH:MM format",
- *                 is_required: true
+ *                 is_required: true,
+ *                 location: "request_body"
  *             }],
  *         endpoint_method: "POST",
  *         endpoint_url: "https://api.example.com/book-appointment",
@@ -67,10 +69,15 @@ export interface CreateToolRequest {
     type: CreateToolRequest.Type;
     /** Mode of operation. */
     execution_mode: CreateToolRequest.ExecutionMode;
-    /** Array of parameter definitions. */
+    /**
+     * Array of parameter definitions.
+     * For `custom_webhook` tools with POST method, each parameter must include a `location` field.
+     * For `custom_webhook` tools with GET method, `location` defaults to `"query_string"` if not specified.
+     * For `custom_websocket` and `built_in_transfer_to_phone_number` tools, `location` must not be specified.
+     */
     parameters?: Phonic.ToolParameter[];
-    /** Required for webhook tools. */
-    endpoint_method?: "POST";
+    /** Required for webhook tools. HTTP method for the webhook endpoint. */
+    endpoint_method?: CreateToolRequest.EndpointMethod;
     /** Required for webhook tools. */
     endpoint_url?: string;
     /** Optional headers for webhook tools. */
@@ -100,4 +107,12 @@ export declare namespace CreateToolRequest {
         readonly Sync: "sync";
         readonly Async: "async";
     };
+    /**
+     * Required for webhook tools. HTTP method for the webhook endpoint.
+     */
+    type EndpointMethod = "GET" | "POST";
+    const EndpointMethod: {
+        readonly Get: "GET";
+        readonly Post: "POST";
+    };
 }

package/dist/esm/api/resources/tools/client/requests/CreateToolRequest.mjs

@@ -12,4 +12,8 @@ export var CreateToolRequest;
         Sync: "sync",
         Async: "async",
     };
+    CreateToolRequest.EndpointMethod = {
+        Get: "GET",
+        Post: "POST",
+    };
 })(CreateToolRequest || (CreateToolRequest = {}));

package/dist/esm/api/resources/tools/client/requests/UpdateToolRequest.d.mts

@@ -24,9 +24,15 @@ export interface UpdateToolRequest {
     type?: UpdateToolRequest.Type;
     /** Mode of operation. */
     execution_mode?: UpdateToolRequest.ExecutionMode;
-    /** Array of parameter definitions. */
+    /**
+     * Array of parameter definitions.
+     * When updating `type` or `endpoint_method`, all parameters must include explicit `location` values.
+     * For `custom_webhook` tools: `location` is required for POST, defaults to `"query_string"` for GET.
+     * For `custom_websocket` and `built_in_transfer_to_phone_number` tools: `location` must not be specified.
+     */
     parameters?: Phonic.ToolParameter[];
-    endpoint_method?: "POST";
+    /** HTTP method for webhook tools. When changing this value, all parameters must include explicit `location` values. */
+    endpoint_method?: UpdateToolRequest.EndpointMethod;
     endpoint_url?: string;
     endpoint_headers?: Record<string, string>;
     endpoint_timeout_ms?: number;
@@ -52,4 +58,12 @@ export declare namespace UpdateToolRequest {
         readonly Sync: "sync";
         readonly Async: "async";
     };
+    /**
+     * HTTP method for webhook tools. When changing this value, all parameters must include explicit `location` values.
+     */
+    type EndpointMethod = "GET" | "POST";
+    const EndpointMethod: {
+        readonly Get: "GET";
+        readonly Post: "POST";
+    };
 }

package/dist/esm/api/resources/tools/client/requests/UpdateToolRequest.mjs

@@ -12,4 +12,8 @@ export var UpdateToolRequest;
         Sync: "sync",
         Async: "async",
     };
+    UpdateToolRequest.EndpointMethod = {
+        Get: "GET",
+        Post: "POST",
+    };
 })(UpdateToolRequest || (UpdateToolRequest = {}));

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

@@ -17,7 +17,7 @@ export interface Tool {
     /** Array of parameter definitions for the tool. */
     parameters: Phonic.ToolParameter[];
     /** HTTP method for webhook tools. */
-    endpoint_method?: "POST";
+    endpoint_method?: Tool.EndpointMethod;
     /** URL for webhook tools. */
     endpoint_url?: string;
     /** Headers for webhook tools. */
@@ -51,4 +51,12 @@ export declare namespace Tool {
         readonly Sync: "sync";
         readonly Async: "async";
     };
+    /**
+     * HTTP method for webhook tools.
+     */
+    type EndpointMethod = "GET" | "POST";
+    const EndpointMethod: {
+        readonly Get: "GET";
+        readonly Post: "POST";
+    };
 }

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

@@ -12,4 +12,8 @@ export var Tool;
         Sync: "sync",
         Async: "async",
     };
+    Tool.EndpointMethod = {
+        Get: "GET",
+        Post: "POST",
+    };
 })(Tool || (Tool = {}));

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

@@ -12,6 +12,14 @@ export interface ToolParameter {
     description: string;
     /** Whether the parameter is required. */
     is_required: boolean;
+    /**
+     * Only applicable for `custom_webhook` tools. Specifies where the parameter should be sent in the webhook request.
+     * - For GET webhooks: defaults to `"query_string"` and `"request_body"` is not allowed.
+     * - For POST webhooks: required, can be either `"request_body"` or `"query_string"`.
+     * - Not allowed for `custom_websocket` or `built_in_transfer_to_phone_number` tools.
+     * When updating a tool's type or endpoint_method, all parameters must include explicit `location` values.
+     */
+    location?: ToolParameter.Location;
 }
 export declare namespace ToolParameter {
     /**
@@ -35,4 +43,16 @@ export declare namespace ToolParameter {
         readonly Number: "number";
         readonly Boolean: "boolean";
     };
+    /**
+     * Only applicable for `custom_webhook` tools. Specifies where the parameter should be sent in the webhook request.
+     * - For GET webhooks: defaults to `"query_string"` and `"request_body"` is not allowed.
+     * - For POST webhooks: required, can be either `"request_body"` or `"query_string"`.
+     * - Not allowed for `custom_websocket` or `built_in_transfer_to_phone_number` tools.
+     * When updating a tool's type or endpoint_method, all parameters must include explicit `location` values.
+     */
+    type Location = "request_body" | "query_string";
+    const Location: {
+        readonly RequestBody: "request_body";
+        readonly QueryString: "query_string";
+    };
 }

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

@@ -16,4 +16,8 @@ export var ToolParameter;
         Number: "number",
         Boolean: "boolean",
     };
+    ToolParameter.Location = {
+        RequestBody: "request_body",
+        QueryString: "query_string",
+    };
 })(ToolParameter || (ToolParameter = {}));

package/dist/esm/version.d.mts

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

package/dist/esm/version.mjs

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

package/package.json

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

package/reference.md

@@ -605,12 +605,14 @@ await client.tools.create({
             name: "date",
             description: "The date for the appointment in YYYY-MM-DD format",
             is_required: true,
+            location: "request_body",
         },
         {
             type: "string",
             name: "time",
             description: "The time for the appointment in HH:MM format",
             is_required: true,
+            location: "request_body",
         },
     ],
     endpoint_method: "POST",