phonic 0.20.0 → 0.21.0

package/README.md

@@ -4,17 +4,24 @@ Node.js library for the Phonic API.
 
 - [Installation](#installation)
 - [Setup](#setup)
-- [Usage](#usage)
-  - [Get voices](#get-voices)
-  - [Get voice by id](#get-voice-by-id)
+- [Agents](#agents)
+  - [List agents](#list-agents)
+  - [Get agent](#get-agent)
+  - [Create agent](#create-agent)
+  - [Update agent](#update-agent)
+  - [Delete agent](#delete-agent)
+- [Voices](#voices)
+  - [List voices](#list-voices)
+  - [Get voice](#get-voice)
+- [Conversations](#conversations)
+  - [List conversations](#list-conversations)
   - [Get conversation by id](#get-conversation-by-id)
   - [Get conversation by external id](#get-conversation-by-external-id)
-  - [List conversations](#list-conversations)
-  - [STS outbound call](#sts-outbound-call)
-  - [STS outbound call using own Twilio account](#sts-outbound-call-using-own-twilio-account)
-  - [STS via WebSocket](#sts-via-websocket)
-    - [Messages that Phonic sends back to you](#messages-that-phonic-sends-back-to-you)
-  
+- [STS outbound call](#sts-outbound-call)
+- [STS outbound call using own Twilio account](#sts-outbound-call-using-own-twilio-account)
+- [STS via WebSocket](#sts-via-websocket)
+  - [Messages that Phonic sends back to you](#messages-that-phonic-sends-back-to-you)
+- [License](#license)
 
 ## Installation
 
@@ -32,69 +39,150 @@ import { Phonic } from "phonic";
 const phonic = new Phonic("ph_...");
 ```
 
-## Usage
+## Agents
 
-### Get voices
+### List agents
 
 ```ts
-const { data, error } = await phonic.voices.list({ model: "merritt" });
-
-if (error === null) {
-  console.log(data.voices);
-}
+const agentsResult = await phonic.agents.list({ project: "my-project" });
 ```
 
+### Get agent
 
-### Get voice by id
+```ts
+const agentResult = await phonic.agents.get("my-agent", { project: "my-project" });
+```
+
+### Create agent
 
 ```ts
-const { data, error } = await phonic.voices.get("grant");
+const createAgentResult = await phonic.agents.create({
+  name: "my-agent",
+  
+  // Optional fields
+  project: "my-project", // Defaults to "main"
+  phoneNumber: "assign-automatically", // Defaults to null
+  audioFormat: "mulaw_8000", // Defaults to "pcm_44100". Must be "mulaw_8000" when `phoneNumber` is "assign-automatically"
+  voiceId: "sarah", // Defaults to "grant"
+  welcomeMessage: "Hello, how can I help you?", // Defaults to ""
+  systemPrompt: "You are an expert in {{subject}}. Be kind to {{user_name}}.", // Defaults to "Respond in 1-2 sentences."
+  templateVariables: {
+    subject: {
+      defaultValue: "Maths"
+    },
+    user_name: {
+      defaultValue: null
+    }
+  },
+  tools: ["keypad_input", "natural_conversation_ending", "my-custom-tool"], // Defaults to []
+  noInputPokeSec: 30, // Defaults to null
+  noInputPokeText: "Hey, are you with me?", // Defaults to "Are you still there?"
+  noInputEndConversationSec: 150, // Defaults to 180
+  boostedKeywords: ["Salamanca Market", "Bonorong Wildlife Sanctuary"], // Defaults to []
+  configurationEndpoint: {
+    url: "https://myapp.com/webhooks/phonic-config",
+    headers: {
+      Authorization: "Bearer 123"
+    },
+    timeoutMs: 10000 // Defaults to 3000
+  } // Defaults to null
+});
+```
 
-if (error === null) {
-  console.log(data.voice);
-}
+### Update agent
+
+```ts
+const updateAgentResult = await phonic.agents.update("my-agent", {
+  name: "my-updated-agent",
+  
+  // Optional fields
+  project: "my-project",
+  phoneNumber: "assign-automatically", // or null
+  voiceId: "sarah",
+  audioFormat: "mulaw_8000", // Must be "mulaw_8000" when `phoneNumber` is "assign-automatically"
+  welcomeMessage: "Hello, how can I help you?",
+  systemPrompt: "You are an expert in {{subject}}. Be kind to {{user_name}}.",
+  templateVariables: {
+    subject: {
+      defaultValue: "Maths"
+    },
+    user_name: {
+      defaultValue: null
+    }
+  },
+  tools: ["keypad_input", "natural_conversation_ending", "my-custom-tool"],
+  noInputPokeSec: 30,
+  noInputPokeText: "Hey, are you with me?",
+  noInputEndConversationSec: 150,
+  boostedKeywords: ["Salamanca Market", "Bonorong Wildlife Sanctuary"],
+  configurationEndpoint: {
+    url: "https://myapp.com/webhooks/phonic-config",
+    headers: {
+      Authorization: "Bearer 123"
+    },
+    timeoutMs: 7000
+  }
+});
 ```
 
-### Get conversation by id
+### Delete agent
 
 ```ts
-const { data, error } = await phonic.conversations.get("conv_b1804883-5be4-42fe-b1cf-aa84450d5c84");
+const deleteAgentResult = await phonic.agents.delete({
+  name: "my-agent",
 
-if (error === null) {
-  console.log(data.conversation);
-}
+  // Optional fields
+  project: "my-project",
+});
 ```
 
-### Get conversation by external id
+## Voices
+
+### List voices
 
 ```ts
-const { data, error } = await phonic.conversations.getByExternalId({
-  project: "main",
-  externalId: "CAdb9c032c809fec7feb932ea4c96d71e1"
-});
+const voicesResult = await phonic.voices.list({ model: "merritt" });
+```
 
-if (error === null) {
-  console.log(data.conversation);
-}
+
+### Get voice
+
+```ts
+const voiceResult = await phonic.voices.get("grant");
 ```
 
+## Conversations
+
 ### List conversations
 
 ```ts
-const { data, error } = await phonic.conversations.list({
+const conversationsResult = await phonic.conversations.list({
   project: "main",
   durationMin: 10, // sec
   durationMax: 20, // sec
   startedAtMin: "2025-04-17", // 00:00:00 UTC time is assumed
   startedAtMax: "2025-09-05T10:30:00.000Z",
 });
+```
 
-if (error === null) {
-  console.log(data.conversations);
-}
+
+### Get conversation by id
+
+```ts
+const conversationResult = await phonic.conversations.get("conv_b1804883-5be4-42fe-b1cf-aa84450d5c84");
+```
+
+### Get conversation by external id
+
+```ts
+const conversationResult = await phonic.conversations.getByExternalId({
+  project: "main",
+  externalId: "CAdb9c032c809fec7feb932ea4c96d71e1"
+});
 ```
 
-### STS outbound call
+
+## STS outbound call
 
 ```ts
 const { data, error } = await phonic.sts.outboundCall("+19189396241", {
@@ -112,7 +200,7 @@ const { data, error } = await phonic.sts.outboundCall("+19189396241", {
 });
 ```
 
-### STS outbound call using own Twilio account
+## STS outbound call using own Twilio account
 
 In Twilio, create a restricted API key with the following permissions: `voice -> calls -> read` and `voice -> calls -> create`.
 
@@ -141,7 +229,7 @@ const { data, error } = await phonic.sts.twilio.outboundCall(
 );
 ```
 
-### STS via WebSocket
+## STS via WebSocket
 
 To start a conversation, open a WebSocket connection:
 
@@ -235,9 +323,9 @@ phonicWebSocket.onError((event) => {
 });
 ```
 
-#### Messages that Phonic sends back to you
+### Messages that Phonic sends back to you
 
-##### `input_text`
+#### `input_text`
 
 ```ts
 {
@@ -248,7 +336,7 @@ phonicWebSocket.onError((event) => {
 
 Phonic sends this message once user's audio is transcribed.
 
-##### `audio_chunk`
+#### `audio_chunk`
 
 ```ts
 {
@@ -260,7 +348,7 @@ Phonic sends this message once user's audio is transcribed.
 
 These are the assistant response audio chunks.
 
-##### `audio_finished`
+#### `audio_finished`
 
 ```ts
 {
@@ -270,7 +358,7 @@ These are the assistant response audio chunks.
 
 Sent after the last "audio_chunk" is sent.
 
-##### `interrupted_response`
+#### `interrupted_response`
 
 ```ts
 {
@@ -281,7 +369,7 @@ Sent after the last "audio_chunk" is sent.
 
 Sent when the user interrupts the assistant, after the user has finished speaking.
 
-#### `assistant_ended_conversation`
+### `assistant_ended_conversation`
 
 ```ts
 {

package/dist/index.d.mts

@@ -12,6 +12,13 @@ type FetchOptions = {
     method: "POST";
     headers?: Record<string, string>;
     body: string;
+} | {
+    method: "PATCH";
+    headers?: Record<string, string>;
+    body: string;
+} | {
+    method: "DELETE";
+    headers?: Record<string, string>;
 };
 type DataOrError<T> = Promise<{
     data: T;
@@ -21,65 +28,12 @@ type DataOrError<T> = Promise<{
     error: {
         message: string;
         code?: string;
+        param_errors?: Record<string, string>;
     };
 }>;
 type ISODate = `${string}-${string}-${string}`;
 type ISODateTime$1 = `${string}Z`;
 
-type ISODateTime = `${string}Z`;
-type ConversationItem = {
-    role: "user";
-    item_idx: number;
-    text: string;
-    duration_ms: number;
-    started_at: string;
-} | {
-    role: "assistant";
-    item_idx: number;
-    text: string;
-    voice_id: string;
-    system_prompt: string;
-    output_audio_speed: number;
-    duration_ms: number;
-    started_at: string;
-};
-type Conversation = {
-    id: string;
-    external_id: string | null;
-    model: string;
-    welcome_message: string | null;
-    input_format: "pcm_44100" | "mulaw_8000";
-    output_format: "pcm_44100" | "mulaw_8000";
-    text: string;
-    duration_ms: number;
-    started_at: ISODateTime;
-    ended_at: ISODateTime;
-    items: Array<ConversationItem>;
-};
-type ConversationSuccessResponse = {
-    conversation: Conversation;
-};
-type ConversationsSuccessResponse = {
-    conversations: Array<Conversation>;
-};
-
-declare class Conversations {
-    private readonly phonic;
-    constructor(phonic: Phonic);
-    get(id: string): DataOrError<ConversationSuccessResponse>;
-    getByExternalId({ project, externalId, }: {
-        project?: string;
-        externalId: string;
-    }): DataOrError<ConversationSuccessResponse>;
-    list({ project, durationMin, durationMax, startedAtMin, startedAtMax, }: {
-        project?: string;
-        durationMin?: number;
-        durationMax?: number;
-        startedAtMin?: ISODate | ISODateTime$1;
-        startedAtMax?: ISODate | ISODateTime$1;
-    }): DataOrError<ConversationsSuccessResponse>;
-}
-
 type PhonicSTSTool = "keypad_input" | "natural_conversation_ending" | (string & {});
 interface PhonicSTSConfigBase {
     input_format: "pcm_44100" | "mulaw_8000";
@@ -162,6 +116,169 @@ type PhonicConfigurationEndpointResponsePayload = {
     boosted_keywords?: string[];
 };
 
+type Agent = {
+    id: string;
+    name: string;
+    org_id: string;
+    project: {
+        id: string;
+        name: string;
+    };
+    phone_number: string | null;
+    voice_id: string;
+    audio_format: "pcm_44100" | "mulaw_8000";
+    welcome_message: string | null;
+    system_prompt: string;
+    template_variables: Record<string, {
+        default_value: string | null;
+    }>;
+    tools: Array<PhonicSTSTool>;
+    no_input_poke_sec: number | null;
+    no_input_poke_text: string;
+    no_input_end_conversation_sec: number;
+    boosted_keywords: string[];
+    configuration_endpoint: {
+        url: string;
+        headers: Record<string, string>;
+        timeout_ms: number;
+    } | null;
+};
+type ListAgentParams = {
+    project?: string;
+};
+type ListAgentSuccessResponse = DataOrError<{
+    agents: Array<Agent>;
+}>;
+type GetAgentParams = {
+    project?: string;
+};
+type GetAgentSuccessResponse = DataOrError<{
+    agent: Agent;
+}>;
+interface AgentOptionalParams {
+    project?: string;
+    voiceId?: string;
+    welcomeMessage?: string;
+    systemPrompt?: string;
+    templateVariables?: Record<string, {
+        defaultValue: string | null;
+    }>;
+    tools?: Array<PhonicSTSTool>;
+    noInputPokeSec?: number | null;
+    noInputPokeText?: string;
+    noInputEndConversationSec?: number;
+    boostedKeywords?: string[];
+    configurationEndpoint?: {
+        url: string;
+        headers?: Record<string, string>;
+        timeoutMs?: number;
+    } | null;
+}
+interface CreateAgentBaseParams extends AgentOptionalParams {
+    name: string;
+}
+interface AgentPhoneNumberParams {
+    phoneNumber: "assign-automatically";
+    audioFormat?: "mulaw_8000";
+}
+interface AgentNoPhoneNumberParams {
+    phoneNumber?: null;
+    audioFormat?: "pcm_44100" | "mulaw_8000";
+}
+interface CreateAgentWithPhoneNumberParams extends CreateAgentBaseParams, AgentPhoneNumberParams {
+}
+interface CreateAgentWithoutPhoneNumberParams extends CreateAgentBaseParams, AgentNoPhoneNumberParams {
+}
+type CreateAgentParams = CreateAgentWithPhoneNumberParams | CreateAgentWithoutPhoneNumberParams;
+type CreateAgentSuccessResponse = {
+    id: string;
+    name: string;
+};
+interface UpdateAgentBaseParams extends AgentOptionalParams {
+    name?: string;
+}
+interface UpdateAgentWithPhoneNumberParams extends UpdateAgentBaseParams, AgentPhoneNumberParams {
+}
+interface UpdateAgentWithoutPhoneNumberParams extends UpdateAgentBaseParams, AgentNoPhoneNumberParams {
+}
+type UpdateAgentParams = UpdateAgentWithPhoneNumberParams | UpdateAgentWithoutPhoneNumberParams;
+type UpdateAgentSuccessResponse = {
+    success: true;
+};
+type DeleteAgentParams = {
+    project?: string;
+};
+type DeleteAgentSuccessResponse = {
+    success: true;
+};
+
+declare class Agents {
+    private readonly phonic;
+    constructor(phonic: Phonic);
+    private getQueryString;
+    private getTemplateVariablesForBody;
+    private getConfigurationEndpointForBody;
+    list(params?: ListAgentParams): DataOrError<ListAgentSuccessResponse>;
+    get(name: string, params?: GetAgentParams): DataOrError<GetAgentSuccessResponse>;
+    create(params: CreateAgentParams): DataOrError<CreateAgentSuccessResponse>;
+    update(name: string, params: UpdateAgentParams): DataOrError<UpdateAgentSuccessResponse>;
+    delete(name: string, params?: DeleteAgentParams): DataOrError<DeleteAgentSuccessResponse>;
+}
+
+type ISODateTime = `${string}Z`;
+type ConversationItem = {
+    role: "user";
+    item_idx: number;
+    text: string;
+    duration_ms: number;
+    started_at: string;
+} | {
+    role: "assistant";
+    item_idx: number;
+    text: string;
+    voice_id: string;
+    system_prompt: string;
+    output_audio_speed: number;
+    duration_ms: number;
+    started_at: string;
+};
+type Conversation = {
+    id: string;
+    external_id: string | null;
+    model: string;
+    welcome_message: string | null;
+    input_format: "pcm_44100" | "mulaw_8000";
+    output_format: "pcm_44100" | "mulaw_8000";
+    text: string;
+    duration_ms: number;
+    started_at: ISODateTime;
+    ended_at: ISODateTime;
+    items: Array<ConversationItem>;
+};
+type ConversationSuccessResponse = {
+    conversation: Conversation;
+};
+type ConversationsSuccessResponse = {
+    conversations: Array<Conversation>;
+};
+
+declare class Conversations {
+    private readonly phonic;
+    constructor(phonic: Phonic);
+    get(id: string): DataOrError<ConversationSuccessResponse>;
+    getByExternalId({ project, externalId, }: {
+        project?: string;
+        externalId: string;
+    }): DataOrError<ConversationSuccessResponse>;
+    list({ project, durationMin, durationMax, startedAtMin, startedAtMax, }: {
+        project?: string;
+        durationMin?: number;
+        durationMax?: number;
+        startedAtMin?: ISODate | ISODateTime$1;
+        startedAtMax?: ISODate | ISODateTime$1;
+    }): DataOrError<ConversationsSuccessResponse>;
+}
+
 type PhonicSTSTwilioOutboundCallParams = {
     account_sid: string;
     api_key_sid: string;
@@ -238,6 +355,7 @@ declare class Phonic {
     readonly baseUrl: string;
     readonly __downstreamWebSocketUrl: string | null;
     readonly headers: Record<string, string>;
+    readonly agents: Agents;
     readonly conversations: Conversations;
     readonly voices: Voices;
     readonly sts: SpeechToSpeech;
@@ -248,6 +366,7 @@ declare class Phonic {
         error: {
             message: string;
             code?: string;
+            param_errors?: Record<string, string>;
         };
     } | {
         data: T;
@@ -258,6 +377,29 @@ declare class Phonic {
         error: {
             message: string;
             code?: string;
+            param_errors?: Record<string, string>;
+        };
+    } | {
+        data: T;
+        error: null;
+    }>;
+    patch<T>(path: string, body: Record<string, unknown>, headers?: Record<string, string>): Promise<{
+        data: null;
+        error: {
+            message: string;
+            code?: string;
+            param_errors?: Record<string, string>;
+        };
+    } | {
+        data: T;
+        error: null;
+    }>;
+    delete<T>(path: string, headers?: Record<string, string>): Promise<{
+        data: null;
+        error: {
+            message: string;
+            code?: string;
+            param_errors?: Record<string, string>;
         };
     } | {
         data: T;

package/dist/index.d.ts

@@ -12,6 +12,13 @@ type FetchOptions = {
     method: "POST";
     headers?: Record<string, string>;
     body: string;
+} | {
+    method: "PATCH";
+    headers?: Record<string, string>;
+    body: string;
+} | {
+    method: "DELETE";
+    headers?: Record<string, string>;
 };
 type DataOrError<T> = Promise<{
     data: T;
@@ -21,65 +28,12 @@ type DataOrError<T> = Promise<{
     error: {
         message: string;
         code?: string;
+        param_errors?: Record<string, string>;
     };
 }>;
 type ISODate = `${string}-${string}-${string}`;
 type ISODateTime$1 = `${string}Z`;
 
-type ISODateTime = `${string}Z`;
-type ConversationItem = {
-    role: "user";
-    item_idx: number;
-    text: string;
-    duration_ms: number;
-    started_at: string;
-} | {
-    role: "assistant";
-    item_idx: number;
-    text: string;
-    voice_id: string;
-    system_prompt: string;
-    output_audio_speed: number;
-    duration_ms: number;
-    started_at: string;
-};
-type Conversation = {
-    id: string;
-    external_id: string | null;
-    model: string;
-    welcome_message: string | null;
-    input_format: "pcm_44100" | "mulaw_8000";
-    output_format: "pcm_44100" | "mulaw_8000";
-    text: string;
-    duration_ms: number;
-    started_at: ISODateTime;
-    ended_at: ISODateTime;
-    items: Array<ConversationItem>;
-};
-type ConversationSuccessResponse = {
-    conversation: Conversation;
-};
-type ConversationsSuccessResponse = {
-    conversations: Array<Conversation>;
-};
-
-declare class Conversations {
-    private readonly phonic;
-    constructor(phonic: Phonic);
-    get(id: string): DataOrError<ConversationSuccessResponse>;
-    getByExternalId({ project, externalId, }: {
-        project?: string;
-        externalId: string;
-    }): DataOrError<ConversationSuccessResponse>;
-    list({ project, durationMin, durationMax, startedAtMin, startedAtMax, }: {
-        project?: string;
-        durationMin?: number;
-        durationMax?: number;
-        startedAtMin?: ISODate | ISODateTime$1;
-        startedAtMax?: ISODate | ISODateTime$1;
-    }): DataOrError<ConversationsSuccessResponse>;
-}
-
 type PhonicSTSTool = "keypad_input" | "natural_conversation_ending" | (string & {});
 interface PhonicSTSConfigBase {
     input_format: "pcm_44100" | "mulaw_8000";
@@ -162,6 +116,169 @@ type PhonicConfigurationEndpointResponsePayload = {
     boosted_keywords?: string[];
 };
 
+type Agent = {
+    id: string;
+    name: string;
+    org_id: string;
+    project: {
+        id: string;
+        name: string;
+    };
+    phone_number: string | null;
+    voice_id: string;
+    audio_format: "pcm_44100" | "mulaw_8000";
+    welcome_message: string | null;
+    system_prompt: string;
+    template_variables: Record<string, {
+        default_value: string | null;
+    }>;
+    tools: Array<PhonicSTSTool>;
+    no_input_poke_sec: number | null;
+    no_input_poke_text: string;
+    no_input_end_conversation_sec: number;
+    boosted_keywords: string[];
+    configuration_endpoint: {
+        url: string;
+        headers: Record<string, string>;
+        timeout_ms: number;
+    } | null;
+};
+type ListAgentParams = {
+    project?: string;
+};
+type ListAgentSuccessResponse = DataOrError<{
+    agents: Array<Agent>;
+}>;
+type GetAgentParams = {
+    project?: string;
+};
+type GetAgentSuccessResponse = DataOrError<{
+    agent: Agent;
+}>;
+interface AgentOptionalParams {
+    project?: string;
+    voiceId?: string;
+    welcomeMessage?: string;
+    systemPrompt?: string;
+    templateVariables?: Record<string, {
+        defaultValue: string | null;
+    }>;
+    tools?: Array<PhonicSTSTool>;
+    noInputPokeSec?: number | null;
+    noInputPokeText?: string;
+    noInputEndConversationSec?: number;
+    boostedKeywords?: string[];
+    configurationEndpoint?: {
+        url: string;
+        headers?: Record<string, string>;
+        timeoutMs?: number;
+    } | null;
+}
+interface CreateAgentBaseParams extends AgentOptionalParams {
+    name: string;
+}
+interface AgentPhoneNumberParams {
+    phoneNumber: "assign-automatically";
+    audioFormat?: "mulaw_8000";
+}
+interface AgentNoPhoneNumberParams {
+    phoneNumber?: null;
+    audioFormat?: "pcm_44100" | "mulaw_8000";
+}
+interface CreateAgentWithPhoneNumberParams extends CreateAgentBaseParams, AgentPhoneNumberParams {
+}
+interface CreateAgentWithoutPhoneNumberParams extends CreateAgentBaseParams, AgentNoPhoneNumberParams {
+}
+type CreateAgentParams = CreateAgentWithPhoneNumberParams | CreateAgentWithoutPhoneNumberParams;
+type CreateAgentSuccessResponse = {
+    id: string;
+    name: string;
+};
+interface UpdateAgentBaseParams extends AgentOptionalParams {
+    name?: string;
+}
+interface UpdateAgentWithPhoneNumberParams extends UpdateAgentBaseParams, AgentPhoneNumberParams {
+}
+interface UpdateAgentWithoutPhoneNumberParams extends UpdateAgentBaseParams, AgentNoPhoneNumberParams {
+}
+type UpdateAgentParams = UpdateAgentWithPhoneNumberParams | UpdateAgentWithoutPhoneNumberParams;
+type UpdateAgentSuccessResponse = {
+    success: true;
+};
+type DeleteAgentParams = {
+    project?: string;
+};
+type DeleteAgentSuccessResponse = {
+    success: true;
+};
+
+declare class Agents {
+    private readonly phonic;
+    constructor(phonic: Phonic);
+    private getQueryString;
+    private getTemplateVariablesForBody;
+    private getConfigurationEndpointForBody;
+    list(params?: ListAgentParams): DataOrError<ListAgentSuccessResponse>;
+    get(name: string, params?: GetAgentParams): DataOrError<GetAgentSuccessResponse>;
+    create(params: CreateAgentParams): DataOrError<CreateAgentSuccessResponse>;
+    update(name: string, params: UpdateAgentParams): DataOrError<UpdateAgentSuccessResponse>;
+    delete(name: string, params?: DeleteAgentParams): DataOrError<DeleteAgentSuccessResponse>;
+}
+
+type ISODateTime = `${string}Z`;
+type ConversationItem = {
+    role: "user";
+    item_idx: number;
+    text: string;
+    duration_ms: number;
+    started_at: string;
+} | {
+    role: "assistant";
+    item_idx: number;
+    text: string;
+    voice_id: string;
+    system_prompt: string;
+    output_audio_speed: number;
+    duration_ms: number;
+    started_at: string;
+};
+type Conversation = {
+    id: string;
+    external_id: string | null;
+    model: string;
+    welcome_message: string | null;
+    input_format: "pcm_44100" | "mulaw_8000";
+    output_format: "pcm_44100" | "mulaw_8000";
+    text: string;
+    duration_ms: number;
+    started_at: ISODateTime;
+    ended_at: ISODateTime;
+    items: Array<ConversationItem>;
+};
+type ConversationSuccessResponse = {
+    conversation: Conversation;
+};
+type ConversationsSuccessResponse = {
+    conversations: Array<Conversation>;
+};
+
+declare class Conversations {
+    private readonly phonic;
+    constructor(phonic: Phonic);
+    get(id: string): DataOrError<ConversationSuccessResponse>;
+    getByExternalId({ project, externalId, }: {
+        project?: string;
+        externalId: string;
+    }): DataOrError<ConversationSuccessResponse>;
+    list({ project, durationMin, durationMax, startedAtMin, startedAtMax, }: {
+        project?: string;
+        durationMin?: number;
+        durationMax?: number;
+        startedAtMin?: ISODate | ISODateTime$1;
+        startedAtMax?: ISODate | ISODateTime$1;
+    }): DataOrError<ConversationsSuccessResponse>;
+}
+
 type PhonicSTSTwilioOutboundCallParams = {
     account_sid: string;
     api_key_sid: string;
@@ -238,6 +355,7 @@ declare class Phonic {
     readonly baseUrl: string;
     readonly __downstreamWebSocketUrl: string | null;
     readonly headers: Record<string, string>;
+    readonly agents: Agents;
     readonly conversations: Conversations;
     readonly voices: Voices;
     readonly sts: SpeechToSpeech;
@@ -248,6 +366,7 @@ declare class Phonic {
         error: {
             message: string;
             code?: string;
+            param_errors?: Record<string, string>;
         };
     } | {
         data: T;
@@ -258,6 +377,29 @@ declare class Phonic {
         error: {
             message: string;
             code?: string;
+            param_errors?: Record<string, string>;
+        };
+    } | {
+        data: T;
+        error: null;
+    }>;
+    patch<T>(path: string, body: Record<string, unknown>, headers?: Record<string, string>): Promise<{
+        data: null;
+        error: {
+            message: string;
+            code?: string;
+            param_errors?: Record<string, string>;
+        };
+    } | {
+        data: T;
+        error: null;
+    }>;
+    delete<T>(path: string, headers?: Record<string, string>): Promise<{
+        data: null;
+        error: {
+            message: string;
+            code?: string;
+            param_errors?: Record<string, string>;
         };
     } | {
         data: T;

package/dist/index.js

@@ -35,7 +35,112 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // package.json
-var version = "0.20.0";
+var version = "0.21.0";
+
+// src/agents/index.ts
+var Agents = class {
+  constructor(phonic) {
+    this.phonic = phonic;
+  }
+  getQueryString(params) {
+    const project = params?.project;
+    const queryString = new URLSearchParams({
+      ...project !== void 0 && { project }
+    }).toString();
+    return queryString;
+  }
+  getTemplateVariablesForBody(templateVariables) {
+    if (templateVariables === void 0) {
+      return void 0;
+    }
+    return Object.fromEntries(
+      Object.entries(templateVariables).map(([key, value]) => [
+        key,
+        {
+          default_value: value.defaultValue
+        }
+      ])
+    );
+  }
+  getConfigurationEndpointForBody(configurationEndpoint) {
+    if (configurationEndpoint === void 0 || configurationEndpoint === null) {
+      return configurationEndpoint;
+    }
+    return {
+      url: configurationEndpoint.url,
+      headers: configurationEndpoint.headers,
+      timeout_ms: configurationEndpoint.timeoutMs
+    };
+  }
+  async list(params) {
+    const response = await this.phonic.get(
+      `/agents?${this.getQueryString(params)}`
+    );
+    return response;
+  }
+  async get(name, params) {
+    const response = await this.phonic.get(
+      `/agents/${name}?${this.getQueryString(params)}`
+    );
+    return response;
+  }
+  async create(params) {
+    const response = await this.phonic.post(
+      `/agents?${this.getQueryString(params)}`,
+      {
+        name: params.name,
+        phone_number: params.phoneNumber,
+        audio_format: params.phoneNumber === "assign-automatically" ? "mulaw_8000" : params.audioFormat,
+        voice_id: params.voiceId,
+        welcome_message: params.welcomeMessage,
+        system_prompt: params.systemPrompt,
+        template_variables: this.getTemplateVariablesForBody(
+          params.templateVariables
+        ),
+        tools: params.tools,
+        no_input_poke_sec: params.noInputPokeSec,
+        no_input_poke_text: params.noInputPokeText,
+        no_input_end_conversation_sec: params.noInputEndConversationSec,
+        boosted_keywords: params.boostedKeywords,
+        configuration_endpoint: this.getConfigurationEndpointForBody(
+          params.configurationEndpoint
+        )
+      }
+    );
+    return response;
+  }
+  async update(name, params) {
+    const response = await this.phonic.patch(
+      `/agents/${name}?${this.getQueryString(params)}`,
+      {
+        name: params.name,
+        phone_number: params.phoneNumber,
+        audio_format: params.phoneNumber === "assign-automatically" ? "mulaw_8000" : params.audioFormat,
+        voice_id: params.voiceId,
+        welcome_message: params.welcomeMessage,
+        system_prompt: params.systemPrompt,
+        template_variables: this.getTemplateVariablesForBody(
+          params.templateVariables
+        ),
+        tools: params.tools,
+        no_input_poke_sec: params.noInputPokeSec,
+        no_input_poke_text: params.noInputPokeText,
+        no_input_end_conversation_sec: params.noInputEndConversationSec,
+        boosted_keywords: params.boostedKeywords,
+        configuration_endpoint: this.getConfigurationEndpointForBody(
+          params.configurationEndpoint
+        )
+      }
+    );
+    return response;
+  }
+  async delete(name, params) {
+    const response = await this.phonic.delete(
+      `/agents/${name}?${this.getQueryString(params)}`
+    );
+    return response;
+  }
+};
 
 // src/conversations/index.ts
 var Conversations = class {
@@ -286,6 +391,7 @@ var Phonic = class {
   baseUrl;
   __downstreamWebSocketUrl;
   headers;
+  agents = new Agents(this);
   conversations = new Conversations(this);
   voices = new Voices(this);
   sts = new SpeechToSpeech(this);
@@ -305,11 +411,11 @@ var Phonic = class {
       }
       try {
         const data = await response.json();
-        const errorMessage = data.error.message || response.statusText;
         return {
           data: null,
           error: {
-            message: errorMessage
+            message: data.error.message || response.statusText,
+            param_errors: data.param_errors
           }
         };
       } catch (error) {
@@ -340,6 +446,19 @@ var Phonic = class {
       headers
     });
   }
+  async patch(path, body, headers) {
+    return this.fetchRequest(path, {
+      method: "PATCH",
+      body: JSON.stringify(body),
+      headers
+    });
+  }
+  async delete(path, headers) {
+    return this.fetchRequest(path, {
+      method: "DELETE",
+      headers
+    });
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -1,5 +1,110 @@
 // package.json
-var version = "0.20.0";
+var version = "0.21.0";
+
+// src/agents/index.ts
+var Agents = class {
+  constructor(phonic) {
+    this.phonic = phonic;
+  }
+  getQueryString(params) {
+    const project = params?.project;
+    const queryString = new URLSearchParams({
+      ...project !== void 0 && { project }
+    }).toString();
+    return queryString;
+  }
+  getTemplateVariablesForBody(templateVariables) {
+    if (templateVariables === void 0) {
+      return void 0;
+    }
+    return Object.fromEntries(
+      Object.entries(templateVariables).map(([key, value]) => [
+        key,
+        {
+          default_value: value.defaultValue
+        }
+      ])
+    );
+  }
+  getConfigurationEndpointForBody(configurationEndpoint) {
+    if (configurationEndpoint === void 0 || configurationEndpoint === null) {
+      return configurationEndpoint;
+    }
+    return {
+      url: configurationEndpoint.url,
+      headers: configurationEndpoint.headers,
+      timeout_ms: configurationEndpoint.timeoutMs
+    };
+  }
+  async list(params) {
+    const response = await this.phonic.get(
+      `/agents?${this.getQueryString(params)}`
+    );
+    return response;
+  }
+  async get(name, params) {
+    const response = await this.phonic.get(
+      `/agents/${name}?${this.getQueryString(params)}`
+    );
+    return response;
+  }
+  async create(params) {
+    const response = await this.phonic.post(
+      `/agents?${this.getQueryString(params)}`,
+      {
+        name: params.name,
+        phone_number: params.phoneNumber,
+        audio_format: params.phoneNumber === "assign-automatically" ? "mulaw_8000" : params.audioFormat,
+        voice_id: params.voiceId,
+        welcome_message: params.welcomeMessage,
+        system_prompt: params.systemPrompt,
+        template_variables: this.getTemplateVariablesForBody(
+          params.templateVariables
+        ),
+        tools: params.tools,
+        no_input_poke_sec: params.noInputPokeSec,
+        no_input_poke_text: params.noInputPokeText,
+        no_input_end_conversation_sec: params.noInputEndConversationSec,
+        boosted_keywords: params.boostedKeywords,
+        configuration_endpoint: this.getConfigurationEndpointForBody(
+          params.configurationEndpoint
+        )
+      }
+    );
+    return response;
+  }
+  async update(name, params) {
+    const response = await this.phonic.patch(
+      `/agents/${name}?${this.getQueryString(params)}`,
+      {
+        name: params.name,
+        phone_number: params.phoneNumber,
+        audio_format: params.phoneNumber === "assign-automatically" ? "mulaw_8000" : params.audioFormat,
+        voice_id: params.voiceId,
+        welcome_message: params.welcomeMessage,
+        system_prompt: params.systemPrompt,
+        template_variables: this.getTemplateVariablesForBody(
+          params.templateVariables
+        ),
+        tools: params.tools,
+        no_input_poke_sec: params.noInputPokeSec,
+        no_input_poke_text: params.noInputPokeText,
+        no_input_end_conversation_sec: params.noInputEndConversationSec,
+        boosted_keywords: params.boostedKeywords,
+        configuration_endpoint: this.getConfigurationEndpointForBody(
+          params.configurationEndpoint
+        )
+      }
+    );
+    return response;
+  }
+  async delete(name, params) {
+    const response = await this.phonic.delete(
+      `/agents/${name}?${this.getQueryString(params)}`
+    );
+    return response;
+  }
+};
 
 // src/conversations/index.ts
 var Conversations = class {
@@ -250,6 +355,7 @@ var Phonic = class {
   baseUrl;
   __downstreamWebSocketUrl;
   headers;
+  agents = new Agents(this);
   conversations = new Conversations(this);
   voices = new Voices(this);
   sts = new SpeechToSpeech(this);
@@ -269,11 +375,11 @@ var Phonic = class {
       }
       try {
         const data = await response.json();
-        const errorMessage = data.error.message || response.statusText;
         return {
           data: null,
           error: {
-            message: errorMessage
+            message: data.error.message || response.statusText,
+            param_errors: data.param_errors
           }
         };
       } catch (error) {
@@ -304,6 +410,19 @@ var Phonic = class {
       headers
     });
   }
+  async patch(path, body, headers) {
+    return this.fetchRequest(path, {
+      method: "PATCH",
+      body: JSON.stringify(body),
+      headers
+    });
+  }
+  async delete(path, headers) {
+    return this.fetchRequest(path, {
+      method: "DELETE",
+      headers
+    });
+  }
 };
 export {
   Phonic

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phonic",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Phonic Node.js SDK",
   "scripts": {
     "build": "tsup",