phonic 0.28.1 → 0.29.1

package/README.md

@@ -193,7 +193,9 @@ const result = await phonic.agents.delete("chris", {
 ### List tools
 
 ```ts
-const result = await phonic.tools.list();
+const result = await phonic.tools.list({ 
+  project: "customer-support" // Optional. Defaults to "main".
+});
 ```
 
 ### Get tool
@@ -201,7 +203,9 @@ const result = await phonic.tools.list();
 Returns a tool by name or ID.
 
 ```ts
-const result = await phonic.tools.get("next_invoice");
+const result = await phonic.tools.get("next_invoice", { 
+  project: "customer-support" // Optional. Defaults to "main".
+});
 ```
 
 ### Create tool
@@ -210,6 +214,7 @@ const result = await phonic.tools.get("next_invoice");
 
 ```ts
 const result = await phonic.tools.create({
+  project: "customer-support", // Optional. Defaults to "main".
   name: "next_invoice",
   description: "Returns the next invoice of the given user",
   type: "custom_webhook",
@@ -250,6 +255,7 @@ WebSocket tools allow you to handle tool execution through the WebSocket connect
 
 ```ts
 const result = await phonic.tools.create({
+  project: "customer-support", // Optional. Defaults to "main".
   name: "get_product_recommendations",
   description: "Gets personalized product recommendations",
   type: "custom_websocket",
@@ -309,6 +315,7 @@ Updates a tool by ID or name. All fields are optional - only provided fields wil
 
 ```ts
 const result = await phonic.tools.update("next_invoice", {
+  project: "customer-support", // Optional. Defaults to "main".
   name: "next_invoice_updated",
   description: "Updated description.",
   type: "custom_webhook",
@@ -357,10 +364,11 @@ const result = await phonic.tools.update("get_product_recommendations", {
 Deletes a tool by ID or name.
 
 ```ts
-const result = await phonic.tools.delete("next_invoice");
+const result = await phonic.tools.delete("next_invoice", { 
+  project: "customer-support" // Optional. Defaults to "main".
+});
 ```
 
-
 ## Voices
 
 ### List voices

package/dist/index.d.mts

@@ -36,7 +36,79 @@ type DataOrError<T> = Promise<{
     };
 }>;
 type ISODate = `${string}-${string}-${string}`;
-type ISODateTime$1 = `${string}Z`;
+type ISODateTime = `${string}Z`;
+type TaskStatus = "pending" | "completed" | "failed";
+type TaskResult = {
+    name: string;
+    description: string;
+    status: TaskStatus;
+    commentary: string | null;
+};
+type TaskResults = {
+    results: Array<TaskResult>;
+};
+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;
+    audio_speed: number;
+    duration_ms: number;
+    started_at: string;
+};
+type Conversation = {
+    id: string;
+    external_id: string | null;
+    workspace: string;
+    agent: {
+        id: string;
+        name: string;
+    } | null;
+    model: string;
+    welcome_message: string | null;
+    input_format: "pcm_44100" | "mulaw_8000";
+    output_format: "pcm_44100" | "mulaw_8000";
+    live_transcript: string;
+    post_call_transcript: string | null;
+    audio_url: string | null;
+    duration_ms: number;
+    task_results: TaskResults;
+    started_at: ISODateTime;
+    ended_at: ISODateTime | null;
+    items: Array<ConversationItem>;
+};
+type ConversationEndedWebhookPayload = {
+    event_type: "conversation.ended";
+    created_at: ISODateTime;
+    data: {
+        conversation: Conversation;
+        call_info: {
+            from_phone_number: string;
+            to_phone_number: string;
+        } | null;
+    };
+};
+type ConversationAnalysisWebhookPayload = {
+    event_type: "conversation.analysis";
+    created_at: ISODateTime;
+    data: {
+        conversation: {
+            latencies_ms: number[];
+            interruptions_count: number;
+        };
+        call_info: {
+            from_phone_number: string;
+            to_phone_number: string;
+        } | null;
+    };
+};
 
 type PhonicSTSTool = "keypad_input" | "natural_conversation_ending" | (string & {});
 interface PhonicSTSConfigBase {
@@ -291,36 +363,6 @@ declare class Agents {
     delete(nameOrId: 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;
-    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;
 };
@@ -358,8 +400,8 @@ declare class Conversations {
         project?: string;
         durationMin?: number;
         durationMax?: number;
-        startedAtMin?: ISODate | ISODateTime$1;
-        startedAtMax?: ISODate | ISODateTime$1;
+        startedAtMin?: ISODate | ISODateTime;
+        startedAtMax?: ISODate | ISODateTime;
     }): DataOrError<ConversationsSuccessResponse>;
     get(id: string): DataOrError<ConversationSuccessResponse>;
     getByExternalId({ project, externalId, }: {
@@ -479,13 +521,20 @@ interface WebSocketTool extends ToolBase {
     tool_call_output_timeout_ms: number;
 }
 type Tool = WebhookTool | WebSocketTool;
+type ListToolsParams = {
+    project?: string;
+};
 type ListToolsSuccessResponse = DataOrError<{
     tools: Array<Tool>;
 }>;
+type GetToolParams = {
+    project?: string;
+};
 type GetToolSuccessResponse = DataOrError<{
     tool: Tool;
 }>;
 interface CreateToolParamsBase {
+    project?: string;
     name: string;
     description: string;
     executionMode: ExecutionMode;
@@ -508,6 +557,7 @@ type CreateToolSuccessResponse = {
     name: string;
 };
 type UpdateToolParams = {
+    project?: string;
     name?: string;
     description?: string;
     type?: "custom_webhook" | "custom_websocket";
@@ -522,6 +572,9 @@ type UpdateToolParams = {
 type UpdateToolSuccessResponse = {
     success: true;
 };
+type DeleteToolParams = {
+    project?: string;
+};
 type DeleteToolSuccessResponse = {
     success: true;
 };
@@ -529,12 +582,13 @@ type DeleteToolSuccessResponse = {
 declare class Tools {
     private readonly phonic;
     constructor(phonic: Phonic);
+    private getQueryString;
     private getParametersForBody;
-    list(): DataOrError<ListToolsSuccessResponse>;
-    get(nameOrId: string): DataOrError<GetToolSuccessResponse>;
+    list(params?: ListToolsParams): DataOrError<ListToolsSuccessResponse>;
+    get(nameOrId: string, params?: GetToolParams): DataOrError<GetToolSuccessResponse>;
     create(params: CreateToolParams): DataOrError<CreateToolSuccessResponse>;
     update(nameOrId: string, params: UpdateToolParams): DataOrError<UpdateToolSuccessResponse>;
-    delete(nameOrId: string): DataOrError<DeleteToolSuccessResponse>;
+    delete(nameOrId: string, params?: DeleteToolParams): DataOrError<DeleteToolSuccessResponse>;
 }
 
 type Voice = {
@@ -627,4 +681,4 @@ declare class Phonic {
     }>;
 }
 
-export { Phonic, type PhonicConfigurationEndpointRequestPayload, type PhonicConfigurationEndpointResponsePayload, type PhonicSTSConfig, PhonicSTSWebSocket, type PhonicSTSWebSocketResponseMessage };
+export { type ConversationAnalysisWebhookPayload, type ConversationEndedWebhookPayload, Phonic, type PhonicConfigurationEndpointRequestPayload, type PhonicConfigurationEndpointResponsePayload, type PhonicSTSConfig, PhonicSTSWebSocket, type PhonicSTSWebSocketResponseMessage };

package/dist/index.d.ts

@@ -36,7 +36,79 @@ type DataOrError<T> = Promise<{
     };
 }>;
 type ISODate = `${string}-${string}-${string}`;
-type ISODateTime$1 = `${string}Z`;
+type ISODateTime = `${string}Z`;
+type TaskStatus = "pending" | "completed" | "failed";
+type TaskResult = {
+    name: string;
+    description: string;
+    status: TaskStatus;
+    commentary: string | null;
+};
+type TaskResults = {
+    results: Array<TaskResult>;
+};
+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;
+    audio_speed: number;
+    duration_ms: number;
+    started_at: string;
+};
+type Conversation = {
+    id: string;
+    external_id: string | null;
+    workspace: string;
+    agent: {
+        id: string;
+        name: string;
+    } | null;
+    model: string;
+    welcome_message: string | null;
+    input_format: "pcm_44100" | "mulaw_8000";
+    output_format: "pcm_44100" | "mulaw_8000";
+    live_transcript: string;
+    post_call_transcript: string | null;
+    audio_url: string | null;
+    duration_ms: number;
+    task_results: TaskResults;
+    started_at: ISODateTime;
+    ended_at: ISODateTime | null;
+    items: Array<ConversationItem>;
+};
+type ConversationEndedWebhookPayload = {
+    event_type: "conversation.ended";
+    created_at: ISODateTime;
+    data: {
+        conversation: Conversation;
+        call_info: {
+            from_phone_number: string;
+            to_phone_number: string;
+        } | null;
+    };
+};
+type ConversationAnalysisWebhookPayload = {
+    event_type: "conversation.analysis";
+    created_at: ISODateTime;
+    data: {
+        conversation: {
+            latencies_ms: number[];
+            interruptions_count: number;
+        };
+        call_info: {
+            from_phone_number: string;
+            to_phone_number: string;
+        } | null;
+    };
+};
 
 type PhonicSTSTool = "keypad_input" | "natural_conversation_ending" | (string & {});
 interface PhonicSTSConfigBase {
@@ -291,36 +363,6 @@ declare class Agents {
     delete(nameOrId: 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;
-    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;
 };
@@ -358,8 +400,8 @@ declare class Conversations {
         project?: string;
         durationMin?: number;
         durationMax?: number;
-        startedAtMin?: ISODate | ISODateTime$1;
-        startedAtMax?: ISODate | ISODateTime$1;
+        startedAtMin?: ISODate | ISODateTime;
+        startedAtMax?: ISODate | ISODateTime;
     }): DataOrError<ConversationsSuccessResponse>;
     get(id: string): DataOrError<ConversationSuccessResponse>;
     getByExternalId({ project, externalId, }: {
@@ -479,13 +521,20 @@ interface WebSocketTool extends ToolBase {
     tool_call_output_timeout_ms: number;
 }
 type Tool = WebhookTool | WebSocketTool;
+type ListToolsParams = {
+    project?: string;
+};
 type ListToolsSuccessResponse = DataOrError<{
     tools: Array<Tool>;
 }>;
+type GetToolParams = {
+    project?: string;
+};
 type GetToolSuccessResponse = DataOrError<{
     tool: Tool;
 }>;
 interface CreateToolParamsBase {
+    project?: string;
     name: string;
     description: string;
     executionMode: ExecutionMode;
@@ -508,6 +557,7 @@ type CreateToolSuccessResponse = {
     name: string;
 };
 type UpdateToolParams = {
+    project?: string;
     name?: string;
     description?: string;
     type?: "custom_webhook" | "custom_websocket";
@@ -522,6 +572,9 @@ type UpdateToolParams = {
 type UpdateToolSuccessResponse = {
     success: true;
 };
+type DeleteToolParams = {
+    project?: string;
+};
 type DeleteToolSuccessResponse = {
     success: true;
 };
@@ -529,12 +582,13 @@ type DeleteToolSuccessResponse = {
 declare class Tools {
     private readonly phonic;
     constructor(phonic: Phonic);
+    private getQueryString;
     private getParametersForBody;
-    list(): DataOrError<ListToolsSuccessResponse>;
-    get(nameOrId: string): DataOrError<GetToolSuccessResponse>;
+    list(params?: ListToolsParams): DataOrError<ListToolsSuccessResponse>;
+    get(nameOrId: string, params?: GetToolParams): DataOrError<GetToolSuccessResponse>;
     create(params: CreateToolParams): DataOrError<CreateToolSuccessResponse>;
     update(nameOrId: string, params: UpdateToolParams): DataOrError<UpdateToolSuccessResponse>;
-    delete(nameOrId: string): DataOrError<DeleteToolSuccessResponse>;
+    delete(nameOrId: string, params?: DeleteToolParams): DataOrError<DeleteToolSuccessResponse>;
 }
 
 type Voice = {
@@ -627,4 +681,4 @@ declare class Phonic {
     }>;
 }
 
-export { Phonic, type PhonicConfigurationEndpointRequestPayload, type PhonicConfigurationEndpointResponsePayload, type PhonicSTSConfig, PhonicSTSWebSocket, type PhonicSTSWebSocketResponseMessage };
+export { type ConversationAnalysisWebhookPayload, type ConversationEndedWebhookPayload, Phonic, type PhonicConfigurationEndpointRequestPayload, type PhonicConfigurationEndpointResponsePayload, type PhonicSTSConfig, PhonicSTSWebSocket, type PhonicSTSWebSocketResponseMessage };

package/dist/index.js

@@ -35,7 +35,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // package.json
-var version = "0.28.1";
+var version = "0.29.1";
 
 // src/agents/index.ts
 var Agents = class {
@@ -425,6 +425,13 @@ var Tools = class {
   constructor(phonic) {
     this.phonic = phonic;
   }
+  getQueryString(params) {
+    const project = params?.project;
+    const queryString = new URLSearchParams({
+      ...project !== void 0 && { project }
+    }).toString();
+    return queryString;
+  }
   getParametersForBody(parameters) {
     if (parameters === void 0) {
       return void 0;
@@ -441,13 +448,15 @@ var Tools = class {
       };
     });
   }
-  async list() {
-    const response = await this.phonic.get("/tools");
+  async list(params) {
+    const response = await this.phonic.get(
+      `/tools?${this.getQueryString(params)}`
+    );
     return response;
   }
-  async get(nameOrId) {
+  async get(nameOrId, params) {
     const response = await this.phonic.get(
-      `/tools/${nameOrId}`
+      `/tools/${nameOrId}?${this.getQueryString(params)}`
     );
     return response;
   }
@@ -469,14 +478,14 @@ var Tools = class {
       body.tool_call_output_timeout_ms = params.toolCallOutputTimeoutMs;
     }
     const response = await this.phonic.post(
-      "/tools",
+      `/tools?${this.getQueryString(params)}`,
       body
     );
     return response;
   }
   async update(nameOrId, params) {
     const response = await this.phonic.patch(
-      `/tools/${nameOrId}`,
+      `/tools/${nameOrId}?${this.getQueryString(params)}`,
       {
         name: params.name,
         description: params.description,
@@ -492,9 +501,9 @@ var Tools = class {
     );
     return response;
   }
-  async delete(nameOrId) {
+  async delete(nameOrId, params) {
     const response = await this.phonic.delete(
-      `/tools/${nameOrId}`
+      `/tools/${nameOrId}?${this.getQueryString(params)}`
     );
     return response;
   }

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.28.1";
+var version = "0.29.1";
 
 // src/agents/index.ts
 var Agents = class {
@@ -389,6 +389,13 @@ var Tools = class {
   constructor(phonic) {
     this.phonic = phonic;
   }
+  getQueryString(params) {
+    const project = params?.project;
+    const queryString = new URLSearchParams({
+      ...project !== void 0 && { project }
+    }).toString();
+    return queryString;
+  }
   getParametersForBody(parameters) {
     if (parameters === void 0) {
       return void 0;
@@ -405,13 +412,15 @@ var Tools = class {
       };
     });
   }
-  async list() {
-    const response = await this.phonic.get("/tools");
+  async list(params) {
+    const response = await this.phonic.get(
+      `/tools?${this.getQueryString(params)}`
+    );
     return response;
   }
-  async get(nameOrId) {
+  async get(nameOrId, params) {
     const response = await this.phonic.get(
-      `/tools/${nameOrId}`
+      `/tools/${nameOrId}?${this.getQueryString(params)}`
     );
     return response;
   }
@@ -433,14 +442,14 @@ var Tools = class {
       body.tool_call_output_timeout_ms = params.toolCallOutputTimeoutMs;
     }
     const response = await this.phonic.post(
-      "/tools",
+      `/tools?${this.getQueryString(params)}`,
       body
     );
     return response;
   }
   async update(nameOrId, params) {
     const response = await this.phonic.patch(
-      `/tools/${nameOrId}`,
+      `/tools/${nameOrId}?${this.getQueryString(params)}`,
       {
         name: params.name,
         description: params.description,
@@ -456,9 +465,9 @@ var Tools = class {
     );
     return response;
   }
-  async delete(nameOrId) {
+  async delete(nameOrId, params) {
     const response = await this.phonic.delete(
-      `/tools/${nameOrId}`
+      `/tools/${nameOrId}?${this.getQueryString(params)}`
     );
     return response;
   }

package/package.json

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