telnyx 7.3.0 → 7.5.0

package/src/resources/ai/missions/missions.ts

@@ -70,34 +70,6 @@ export class Missions extends APIResource {
   mcpServers: McpServersAPI.McpServers = new McpServersAPI.McpServers(this._client);
   tools: ToolsAPI.Tools = new ToolsAPI.Tools(this._client);
 
-  /**
-   * Create a new mission definition
-   *
-   * @example
-   * ```ts
-   * const missionResponse = await client.ai.missions.create({
-   *   name: 'name',
-   * });
-   * ```
-   */
-  create(body: MissionCreateParams, options?: RequestOptions): APIPromise<MissionResponse> {
-    return this._client.post('/ai/missions', { body, ...options });
-  }
-
-  /**
-   * Get a mission by ID (includes tools, knowledge_bases, mcp_servers)
-   *
-   * @example
-   * ```ts
-   * const missionResponse = await client.ai.missions.retrieve(
-   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   * );
-   * ```
-   */
-  retrieve(missionID: string, options?: RequestOptions): APIPromise<MissionResponse> {
-    return this._client.get(path`/ai/missions/${missionID}`, options);
-  }
-
   /**
    * List all missions for the organization
    *
@@ -117,34 +89,31 @@ export class Missions extends APIResource {
   }
 
   /**
-   * Clone an existing mission
+   * Create a new mission definition
    *
    * @example
    * ```ts
-   * const response = await client.ai.missions.cloneMission(
-   *   'mission_id',
-   * );
+   * const missionResponse = await client.ai.missions.create({
+   *   name: 'name',
+   * });
    * ```
    */
-  cloneMission(missionID: string, options?: RequestOptions): APIPromise<unknown> {
-    return this._client.post(path`/ai/missions/${missionID}/clone`, options);
+  create(body: MissionCreateParams, options?: RequestOptions): APIPromise<MissionResponse> {
+    return this._client.post('/ai/missions', { body, ...options });
   }
 
   /**
-   * Delete a mission
+   * Get a mission by ID (includes tools, knowledge_bases, mcp_servers)
    *
    * @example
    * ```ts
-   * await client.ai.missions.deleteMission(
+   * const missionResponse = await client.ai.missions.retrieve(
    *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
    * );
    * ```
    */
-  deleteMission(missionID: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.delete(path`/ai/missions/${missionID}`, {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
+  retrieve(missionID: string, options?: RequestOptions): APIPromise<MissionResponse> {
+    return this._client.get(path`/ai/missions/${missionID}`, options);
   }
 
   /**
@@ -168,6 +137,23 @@ export class Missions extends APIResource {
     });
   }
 
+  /**
+   * Delete a mission
+   *
+   * @example
+   * ```ts
+   * await client.ai.missions.deleteMission(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
+   */
+  deleteMission(missionID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/ai/missions/${missionID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
   /**
    * Update a mission definition
    *
@@ -186,6 +172,20 @@ export class Missions extends APIResource {
   ): APIPromise<MissionResponse> {
     return this._client.put(path`/ai/missions/${missionID}`, { body, ...options });
   }
+
+  /**
+   * Clone an existing mission
+   *
+   * @example
+   * ```ts
+   * const response = await client.ai.missions.cloneMission(
+   *   'mission_id',
+   * );
+   * ```
+   */
+  cloneMission(missionID: string, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.post(path`/ai/missions/${missionID}/clone`, options);
+  }
 }
 
 export type MissionDataDefaultFlatPagination = DefaultFlatPagination<MissionData>;
@@ -224,6 +224,8 @@ export interface MissionResponse {
 
 export type MissionCloneMissionResponse = unknown;
 
+export interface MissionListParams extends DefaultFlatPaginationParams {}
+
 export interface MissionCreateParams {
   name: string;
 
@@ -238,8 +240,6 @@ export interface MissionCreateParams {
   model?: string;
 }
 
-export interface MissionListParams extends DefaultFlatPaginationParams {}
-
 export interface MissionListEventsParams extends DefaultFlatPaginationParams {
   /**
    * Filter results by type.
@@ -274,8 +274,8 @@ export declare namespace Missions {
     type MissionResponse as MissionResponse,
     type MissionCloneMissionResponse as MissionCloneMissionResponse,
     type MissionDataDefaultFlatPagination as MissionDataDefaultFlatPagination,
-    type MissionCreateParams as MissionCreateParams,
     type MissionListParams as MissionListParams,
+    type MissionCreateParams as MissionCreateParams,
     type MissionListEventsParams as MissionListEventsParams,
     type MissionUpdateMissionParams as MissionUpdateMissionParams,
   };
@@ -287,12 +287,12 @@ export declare namespace Missions {
     type MissionRunsListResponse as MissionRunsListResponse,
     type RunStatus as RunStatus,
     type MissionRunDataDefaultFlatPagination as MissionRunDataDefaultFlatPagination,
+    type RunListParams as RunListParams,
     type RunCreateParams as RunCreateParams,
     type RunRetrieveParams as RunRetrieveParams,
     type RunUpdateParams as RunUpdateParams,
-    type RunListParams as RunListParams,
-    type RunCancelRunParams as RunCancelRunParams,
     type RunListRunsParams as RunListRunsParams,
+    type RunCancelRunParams as RunCancelRunParams,
     type RunPauseRunParams as RunPauseRunParams,
     type RunResumeRunParams as RunResumeRunParams,
   };

package/src/resources/ai/missions/runs/events.ts

@@ -39,48 +39,48 @@ export class Events extends APIResource {
   }
 
   /**
-   * Get details of a specific event
+   * Log an event for a run
    *
    * @example
    * ```ts
    * const eventResponse =
-   *   await client.ai.missions.runs.events.getEventDetails(
-   *     'event_id',
+   *   await client.ai.missions.runs.events.log(
+   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
    *     {
    *       mission_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *       run_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *       summary: 'summary',
+   *       type: 'status_change',
    *     },
    *   );
    * ```
    */
-  getEventDetails(
-    eventID: string,
-    params: EventGetEventDetailsParams,
-    options?: RequestOptions,
-  ): APIPromise<EventResponse> {
-    const { mission_id, run_id } = params;
-    return this._client.get(path`/ai/missions/${mission_id}/runs/${run_id}/events/${eventID}`, options);
+  log(runID: string, params: EventLogParams, options?: RequestOptions): APIPromise<EventResponse> {
+    const { mission_id, ...body } = params;
+    return this._client.post(path`/ai/missions/${mission_id}/runs/${runID}/events`, { body, ...options });
   }
 
   /**
-   * Log an event for a run
+   * Get details of a specific event
    *
    * @example
    * ```ts
    * const eventResponse =
-   *   await client.ai.missions.runs.events.log(
-   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   await client.ai.missions.runs.events.getEventDetails(
+   *     'event_id',
    *     {
    *       mission_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *       summary: 'summary',
-   *       type: 'status_change',
+   *       run_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
    *     },
    *   );
    * ```
    */
-  log(runID: string, params: EventLogParams, options?: RequestOptions): APIPromise<EventResponse> {
-    const { mission_id, ...body } = params;
-    return this._client.post(path`/ai/missions/${mission_id}/runs/${runID}/events`, { body, ...options });
+  getEventDetails(
+    eventID: string,
+    params: EventGetEventDetailsParams,
+    options?: RequestOptions,
+  ): APIPromise<EventResponse> {
+    const { mission_id, run_id } = params;
+    return this._client.get(path`/ai/missions/${mission_id}/runs/${run_id}/events/${eventID}`, options);
   }
 }
 
@@ -143,18 +143,6 @@ export interface EventListParams extends DefaultFlatPaginationParams {
   type?: string;
 }
 
-export interface EventGetEventDetailsParams {
-  /**
-   * Unique identifier of the mission.
-   */
-  mission_id: string;
-
-  /**
-   * Unique identifier of the run.
-   */
-  run_id: string;
-}
-
 export interface EventLogParams {
   /**
    * Path param: Unique identifier of the mission.
@@ -192,6 +180,18 @@ export interface EventLogParams {
   step_id?: string;
 }
 
+export interface EventGetEventDetailsParams {
+  /**
+   * Unique identifier of the mission.
+   */
+  mission_id: string;
+
+  /**
+   * Unique identifier of the run.
+   */
+  run_id: string;
+}
+
 export declare namespace Events {
   export {
     type EventData as EventData,
@@ -199,7 +199,7 @@ export declare namespace Events {
     type EventType as EventType,
     type EventDataDefaultFlatPagination as EventDataDefaultFlatPagination,
     type EventListParams as EventListParams,
-    type EventGetEventDetailsParams as EventGetEventDetailsParams,
     type EventLogParams as EventLogParams,
+    type EventGetEventDetailsParams as EventGetEventDetailsParams,
   };
 }

package/src/resources/ai/missions/runs/index.ts

@@ -6,8 +6,8 @@ export {
   type EventResponse,
   type EventType,
   type EventListParams,
-  type EventGetEventDetailsParams,
   type EventLogParams,
+  type EventGetEventDetailsParams,
   type EventDataDefaultFlatPagination,
 } from './events';
 export {
@@ -18,11 +18,11 @@ export {
   type PlanStepsCreatedResponse,
   type StepStatus,
   type PlanRetrieveResponse,
-  type PlanCreateParams,
   type PlanRetrieveParams,
+  type PlanCreateParams,
+  type PlanUpdateStepParams,
   type PlanAddStepsToPlanParams,
   type PlanGetStepDetailsParams,
-  type PlanUpdateStepParams,
 } from './plan';
 export {
   Runs,
@@ -30,12 +30,12 @@ export {
   type MissionRunResponse,
   type MissionRunsListResponse,
   type RunStatus,
+  type RunListParams,
   type RunCreateParams,
   type RunRetrieveParams,
   type RunUpdateParams,
-  type RunListParams,
-  type RunCancelRunParams,
   type RunListRunsParams,
+  type RunCancelRunParams,
   type RunPauseRunParams,
   type RunResumeRunParams,
   type MissionRunDataDefaultFlatPagination,

package/src/resources/ai/missions/runs/plan.ts

@@ -6,6 +6,26 @@ import { RequestOptions } from '../../../../internal/request-options';
 import { path } from '../../../../internal/utils/path';
 
 export class Plan extends APIResource {
+  /**
+   * Get the plan (all steps) for a run
+   *
+   * @example
+   * ```ts
+   * const plan = await client.ai.missions.runs.plan.retrieve(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   { mission_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+   * );
+   * ```
+   */
+  retrieve(
+    runID: string,
+    params: PlanRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<PlanRetrieveResponse> {
+    const { mission_id } = params;
+    return this._client.get(path`/ai/missions/${mission_id}/runs/${runID}/plan`, options);
+  }
+
   /**
    * Create the initial plan for a run
    *
@@ -37,23 +57,27 @@ export class Plan extends APIResource {
   }
 
   /**
-   * Get the plan (all steps) for a run
+   * Update the status of a plan step
    *
    * @example
    * ```ts
-   * const plan = await client.ai.missions.runs.plan.retrieve(
-   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *   { mission_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
-   * );
+   * const planStepResponse =
+   *   await client.ai.missions.runs.plan.updateStep('step_id', {
+   *     mission_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *     run_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   });
    * ```
    */
-  retrieve(
-    runID: string,
-    params: PlanRetrieveParams,
+  updateStep(
+    stepID: string,
+    params: PlanUpdateStepParams,
     options?: RequestOptions,
-  ): APIPromise<PlanRetrieveResponse> {
-    const { mission_id } = params;
-    return this._client.get(path`/ai/missions/${mission_id}/runs/${runID}/plan`, options);
+  ): APIPromise<PlanStepResponse> {
+    const { mission_id, run_id, ...body } = params;
+    return this._client.patch(path`/ai/missions/${mission_id}/runs/${run_id}/plan/steps/${stepID}`, {
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -109,30 +133,6 @@ export class Plan extends APIResource {
     const { mission_id, run_id } = params;
     return this._client.get(path`/ai/missions/${mission_id}/runs/${run_id}/plan/steps/${stepID}`, options);
   }
-
-  /**
-   * Update the status of a plan step
-   *
-   * @example
-   * ```ts
-   * const planStepResponse =
-   *   await client.ai.missions.runs.plan.updateStep('step_id', {
-   *     mission_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *     run_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *   });
-   * ```
-   */
-  updateStep(
-    stepID: string,
-    params: PlanUpdateStepParams,
-    options?: RequestOptions,
-  ): APIPromise<PlanStepResponse> {
-    const { mission_id, run_id, ...body } = params;
-    return this._client.patch(path`/ai/missions/${mission_id}/runs/${run_id}/plan/steps/${stepID}`, {
-      body,
-      ...options,
-    });
-  }
 }
 
 export interface CreatePlanStepRequest {
@@ -181,18 +181,6 @@ export interface PlanRetrieveResponse {
   data: Array<PlanStepData>;
 }
 
-export interface PlanCreateParams {
-  /**
-   * Path param: Unique identifier of the mission.
-   */
-  mission_id: string;
-
-  /**
-   * Body param
-   */
-  steps: Array<CreatePlanStepRequest>;
-}
-
 export interface PlanRetrieveParams {
   /**
    * Unique identifier of the mission.
@@ -200,7 +188,7 @@ export interface PlanRetrieveParams {
   mission_id: string;
 }
 
-export interface PlanAddStepsToPlanParams {
+export interface PlanCreateParams {
   /**
    * Path param: Unique identifier of the mission.
    */
@@ -212,38 +200,50 @@ export interface PlanAddStepsToPlanParams {
   steps: Array<CreatePlanStepRequest>;
 }
 
-export interface PlanGetStepDetailsParams {
+export interface PlanUpdateStepParams {
   /**
-   * Unique identifier of the mission.
+   * Path param: Unique identifier of the mission.
    */
   mission_id: string;
 
   /**
-   * Unique identifier of the run.
+   * Path param: Unique identifier of the run.
    */
   run_id: string;
+
+  /**
+   * Body param
+   */
+  metadata?: { [key: string]: unknown };
+
+  /**
+   * Body param
+   */
+  status?: StepStatus;
 }
 
-export interface PlanUpdateStepParams {
+export interface PlanAddStepsToPlanParams {
   /**
    * Path param: Unique identifier of the mission.
    */
   mission_id: string;
 
   /**
-   * Path param: Unique identifier of the run.
+   * Body param
    */
-  run_id: string;
+  steps: Array<CreatePlanStepRequest>;
+}
 
+export interface PlanGetStepDetailsParams {
   /**
-   * Body param
+   * Unique identifier of the mission.
    */
-  metadata?: { [key: string]: unknown };
+  mission_id: string;
 
   /**
-   * Body param
+   * Unique identifier of the run.
    */
-  status?: StepStatus;
+  run_id: string;
 }
 
 export declare namespace Plan {
@@ -254,10 +254,10 @@ export declare namespace Plan {
     type PlanStepsCreatedResponse as PlanStepsCreatedResponse,
     type StepStatus as StepStatus,
     type PlanRetrieveResponse as PlanRetrieveResponse,
-    type PlanCreateParams as PlanCreateParams,
     type PlanRetrieveParams as PlanRetrieveParams,
+    type PlanCreateParams as PlanCreateParams,
+    type PlanUpdateStepParams as PlanUpdateStepParams,
     type PlanAddStepsToPlanParams as PlanAddStepsToPlanParams,
     type PlanGetStepDetailsParams as PlanGetStepDetailsParams,
-    type PlanUpdateStepParams as PlanUpdateStepParams,
   };
 }

package/src/resources/ai/missions/runs/runs.ts

@@ -52,6 +52,31 @@ export class Runs extends APIResource {
   plan: PlanAPI.Plan = new PlanAPI.Plan(this._client);
   telnyxAgents: TelnyxAgentsAPI.TelnyxAgents = new TelnyxAgentsAPI.TelnyxAgents(this._client);
 
+  /**
+   * List all runs for a specific mission
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const missionRunData of client.ai.missions.runs.list(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    missionID: string,
+    query: RunListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<MissionRunDataDefaultFlatPagination, MissionRunData> {
+    return this._client.getAPIList(
+      path`/ai/missions/${missionID}/runs`,
+      DefaultFlatPagination<MissionRunData>,
+      { query, ...options },
+    );
+  }
+
   /**
    * Start a new run for a mission
    *
@@ -110,28 +135,24 @@ export class Runs extends APIResource {
   }
 
   /**
-   * List all runs for a specific mission
+   * List recent runs across all missions
    *
    * @example
    * ```ts
    * // Automatically fetches more pages as needed.
-   * for await (const missionRunData of client.ai.missions.runs.list(
-   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   * )) {
+   * for await (const missionRunData of client.ai.missions.runs.listRuns()) {
    *   // ...
    * }
    * ```
    */
-  list(
-    missionID: string,
-    query: RunListParams | null | undefined = {},
+  listRuns(
+    query: RunListRunsParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<MissionRunDataDefaultFlatPagination, MissionRunData> {
-    return this._client.getAPIList(
-      path`/ai/missions/${missionID}/runs`,
-      DefaultFlatPagination<MissionRunData>,
-      { query, ...options },
-    );
+    return this._client.getAPIList('/ai/missions/runs', DefaultFlatPagination<MissionRunData>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -155,27 +176,6 @@ export class Runs extends APIResource {
     return this._client.post(path`/ai/missions/${mission_id}/runs/${runID}/cancel`, options);
   }
 
-  /**
-   * List recent runs across all missions
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const missionRunData of client.ai.missions.runs.listRuns()) {
-   *   // ...
-   * }
-   * ```
-   */
-  listRuns(
-    query: RunListRunsParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<MissionRunDataDefaultFlatPagination, MissionRunData> {
-    return this._client.getAPIList('/ai/missions/runs', DefaultFlatPagination<MissionRunData>, {
-      query,
-      ...options,
-    });
-  }
-
   /**
    * Pause a running run
    *
@@ -257,6 +257,13 @@ export interface MissionRunsListResponse {
 
 export type RunStatus = 'pending' | 'running' | 'paused' | 'succeeded' | 'failed' | 'cancelled';
 
+export interface RunListParams extends DefaultFlatPaginationParams {
+  /**
+   * Filter results by status.
+   */
+  status?: string;
+}
+
 export interface RunCreateParams {
   input?: { [key: string]: unknown };
 
@@ -302,7 +309,7 @@ export interface RunUpdateParams {
   status?: RunStatus;
 }
 
-export interface RunListParams extends DefaultFlatPaginationParams {
+export interface RunListRunsParams extends DefaultFlatPaginationParams {
   /**
    * Filter results by status.
    */
@@ -316,13 +323,6 @@ export interface RunCancelRunParams {
   mission_id: string;
 }
 
-export interface RunListRunsParams extends DefaultFlatPaginationParams {
-  /**
-   * Filter results by status.
-   */
-  status?: string;
-}
-
 export interface RunPauseRunParams {
   /**
    * Unique identifier of the mission.
@@ -348,12 +348,12 @@ export declare namespace Runs {
     type MissionRunsListResponse as MissionRunsListResponse,
     type RunStatus as RunStatus,
     type MissionRunDataDefaultFlatPagination as MissionRunDataDefaultFlatPagination,
+    type RunListParams as RunListParams,
     type RunCreateParams as RunCreateParams,
     type RunRetrieveParams as RunRetrieveParams,
     type RunUpdateParams as RunUpdateParams,
-    type RunListParams as RunListParams,
-    type RunCancelRunParams as RunCancelRunParams,
     type RunListRunsParams as RunListRunsParams,
+    type RunCancelRunParams as RunCancelRunParams,
     type RunPauseRunParams as RunPauseRunParams,
     type RunResumeRunParams as RunResumeRunParams,
   };
@@ -365,8 +365,8 @@ export declare namespace Runs {
     type EventType as EventType,
     type EventDataDefaultFlatPagination as EventDataDefaultFlatPagination,
     type EventListParams as EventListParams,
-    type EventGetEventDetailsParams as EventGetEventDetailsParams,
     type EventLogParams as EventLogParams,
+    type EventGetEventDetailsParams as EventGetEventDetailsParams,
   };
 
   export {
@@ -377,11 +377,11 @@ export declare namespace Runs {
     type PlanStepsCreatedResponse as PlanStepsCreatedResponse,
     type StepStatus as StepStatus,
     type PlanRetrieveResponse as PlanRetrieveResponse,
-    type PlanCreateParams as PlanCreateParams,
     type PlanRetrieveParams as PlanRetrieveParams,
+    type PlanCreateParams as PlanCreateParams,
+    type PlanUpdateStepParams as PlanUpdateStepParams,
     type PlanAddStepsToPlanParams as PlanAddStepsToPlanParams,
     type PlanGetStepDetailsParams as PlanGetStepDetailsParams,
-    type PlanUpdateStepParams as PlanUpdateStepParams,
   };
 
   export {