telnyx 5.25.0 → 5.26.0

package/src/resources/ai/missions/runs/telnyx-agents.ts

@@ -0,0 +1,139 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../core/resource';
+import { APIPromise } from '../../../../core/api-promise';
+import { buildHeaders } from '../../../../internal/headers';
+import { RequestOptions } from '../../../../internal/request-options';
+import { path } from '../../../../internal/utils/path';
+
+export class TelnyxAgents extends APIResource {
+  /**
+   * List all Telnyx agents linked to a run
+   *
+   * @example
+   * ```ts
+   * const telnyxAgents =
+   *   await client.ai.missions.runs.telnyxAgents.list(
+   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *     { mission_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+   *   );
+   * ```
+   */
+  list(
+    runID: string,
+    params: TelnyxAgentListParams,
+    options?: RequestOptions,
+  ): APIPromise<TelnyxAgentListResponse> {
+    const { mission_id } = params;
+    return this._client.get(path`/ai/missions/${mission_id}/runs/${runID}/telnyx-agents`, options);
+  }
+
+  /**
+   * Link a Telnyx AI agent (voice/messaging) to a run
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.ai.missions.runs.telnyxAgents.link(
+   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *     {
+   *       mission_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *       telnyx_agent_id: 'telnyx_agent_id',
+   *     },
+   *   );
+   * ```
+   */
+  link(
+    runID: string,
+    params: TelnyxAgentLinkParams,
+    options?: RequestOptions,
+  ): APIPromise<TelnyxAgentLinkResponse> {
+    const { mission_id, ...body } = params;
+    return this._client.post(path`/ai/missions/${mission_id}/runs/${runID}/telnyx-agents`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Unlink a Telnyx agent from a run
+   *
+   * @example
+   * ```ts
+   * await client.ai.missions.runs.telnyxAgents.unlink(
+   *   'telnyx_agent_id',
+   *   {
+   *     mission_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *     run_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   },
+   * );
+   * ```
+   */
+  unlink(telnyxAgentID: string, params: TelnyxAgentUnlinkParams, options?: RequestOptions): APIPromise<void> {
+    const { mission_id, run_id } = params;
+    return this._client.delete(
+      path`/ai/missions/${mission_id}/runs/${run_id}/telnyx-agents/${telnyxAgentID}`,
+      { ...options, headers: buildHeaders([{ Accept: '*/*' }, options?.headers]) },
+    );
+  }
+}
+
+export interface TelnyxAgentListResponse {
+  data: Array<TelnyxAgentListResponse.Data>;
+}
+
+export namespace TelnyxAgentListResponse {
+  export interface Data {
+    created_at: string;
+
+    run_id: string;
+
+    telnyx_agent_id: string;
+  }
+}
+
+export interface TelnyxAgentLinkResponse {
+  data: TelnyxAgentLinkResponse.Data;
+}
+
+export namespace TelnyxAgentLinkResponse {
+  export interface Data {
+    created_at: string;
+
+    run_id: string;
+
+    telnyx_agent_id: string;
+  }
+}
+
+export interface TelnyxAgentListParams {
+  mission_id: string;
+}
+
+export interface TelnyxAgentLinkParams {
+  /**
+   * Path param
+   */
+  mission_id: string;
+
+  /**
+   * Body param: The Telnyx AI agent ID to link
+   */
+  telnyx_agent_id: string;
+}
+
+export interface TelnyxAgentUnlinkParams {
+  mission_id: string;
+
+  run_id: string;
+}
+
+export declare namespace TelnyxAgents {
+  export {
+    type TelnyxAgentListResponse as TelnyxAgentListResponse,
+    type TelnyxAgentLinkResponse as TelnyxAgentLinkResponse,
+    type TelnyxAgentListParams as TelnyxAgentListParams,
+    type TelnyxAgentLinkParams as TelnyxAgentLinkParams,
+    type TelnyxAgentUnlinkParams as TelnyxAgentUnlinkParams,
+  };
+}

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

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './runs/index';

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

@@ -0,0 +1,119 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Tools extends APIResource {
+  /**
+   * Create a new tool for a mission
+   *
+   * @example
+   * ```ts
+   * const response = await client.ai.missions.tools.createTool(
+   *   'mission_id',
+   * );
+   * ```
+   */
+  createTool(missionID: string, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.post(path`/ai/missions/${missionID}/tools`, options);
+  }
+
+  /**
+   * Delete a tool from a mission
+   *
+   * @example
+   * ```ts
+   * await client.ai.missions.tools.deleteTool('tool_id', {
+   *   mission_id: 'mission_id',
+   * });
+   * ```
+   */
+  deleteTool(toolID: string, params: ToolDeleteToolParams, options?: RequestOptions): APIPromise<void> {
+    const { mission_id } = params;
+    return this._client.delete(path`/ai/missions/${mission_id}/tools/${toolID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get a specific tool by ID
+   *
+   * @example
+   * ```ts
+   * const response = await client.ai.missions.tools.getTool(
+   *   'tool_id',
+   *   { mission_id: 'mission_id' },
+   * );
+   * ```
+   */
+  getTool(toolID: string, params: ToolGetToolParams, options?: RequestOptions): APIPromise<unknown> {
+    const { mission_id } = params;
+    return this._client.get(path`/ai/missions/${mission_id}/tools/${toolID}`, options);
+  }
+
+  /**
+   * List all tools for a mission
+   *
+   * @example
+   * ```ts
+   * const response = await client.ai.missions.tools.listTools(
+   *   'mission_id',
+   * );
+   * ```
+   */
+  listTools(missionID: string, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.get(path`/ai/missions/${missionID}/tools`, options);
+  }
+
+  /**
+   * Update a tool definition
+   *
+   * @example
+   * ```ts
+   * const response = await client.ai.missions.tools.updateTool(
+   *   'tool_id',
+   *   { mission_id: 'mission_id' },
+   * );
+   * ```
+   */
+  updateTool(toolID: string, params: ToolUpdateToolParams, options?: RequestOptions): APIPromise<unknown> {
+    const { mission_id } = params;
+    return this._client.put(path`/ai/missions/${mission_id}/tools/${toolID}`, options);
+  }
+}
+
+export type ToolCreateToolResponse = unknown;
+
+export type ToolGetToolResponse = unknown;
+
+export type ToolListToolsResponse = unknown;
+
+export type ToolUpdateToolResponse = unknown;
+
+export interface ToolDeleteToolParams {
+  mission_id: string;
+}
+
+export interface ToolGetToolParams {
+  mission_id: string;
+}
+
+export interface ToolUpdateToolParams {
+  mission_id: string;
+}
+
+export declare namespace Tools {
+  export {
+    type ToolCreateToolResponse as ToolCreateToolResponse,
+    type ToolGetToolResponse as ToolGetToolResponse,
+    type ToolListToolsResponse as ToolListToolsResponse,
+    type ToolUpdateToolResponse as ToolUpdateToolResponse,
+    type ToolDeleteToolParams as ToolDeleteToolParams,
+    type ToolGetToolParams as ToolGetToolParams,
+    type ToolUpdateToolParams as ToolUpdateToolParams,
+  };
+}

package/src/resources/ai/missions.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './missions/index';

package/src/resources/ai/openai/embeddings.ts

@@ -0,0 +1,168 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Embeddings extends APIResource {
+  /**
+   * Creates an embedding vector representing the input text. This endpoint is
+   * compatible with the
+   * [OpenAI Embeddings API](https://platform.openai.com/docs/api-reference/embeddings)
+   * and may be used with the OpenAI JS or Python SDK by setting the base URL to
+   * `https://api.telnyx.com/v2/ai/openai`.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.ai.openai.embeddings.createEmbeddings({
+   *     input: 'The quick brown fox jumps over the lazy dog',
+   *     model: 'thenlper/gte-large',
+   *   });
+   * ```
+   */
+  createEmbeddings(
+    body: EmbeddingCreateEmbeddingsParams,
+    options?: RequestOptions,
+  ): APIPromise<EmbeddingCreateEmbeddingsResponse> {
+    return this._client.post('/ai/openai/embeddings', { body, ...options });
+  }
+
+  /**
+   * Returns a list of available embedding models. This endpoint is compatible with
+   * the OpenAI Models API format.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.ai.openai.embeddings.listEmbeddingModels();
+   * ```
+   */
+  listEmbeddingModels(options?: RequestOptions): APIPromise<EmbeddingListEmbeddingModelsResponse> {
+    return this._client.get('/ai/openai/embeddings/models', options);
+  }
+}
+
+export interface EmbeddingCreateEmbeddingsResponse {
+  /**
+   * List of embedding objects
+   */
+  data: Array<EmbeddingCreateEmbeddingsResponse.Data>;
+
+  /**
+   * The model used for embedding
+   */
+  model: string;
+
+  /**
+   * The object type, always 'list'
+   */
+  object: string;
+
+  usage: EmbeddingCreateEmbeddingsResponse.Usage;
+}
+
+export namespace EmbeddingCreateEmbeddingsResponse {
+  export interface Data {
+    /**
+     * The embedding vector
+     */
+    embedding: Array<number>;
+
+    /**
+     * The index of the embedding in the list of embeddings
+     */
+    index: number;
+
+    /**
+     * The object type, always 'embedding'
+     */
+    object: string;
+  }
+
+  export interface Usage {
+    /**
+     * Number of tokens in the input
+     */
+    prompt_tokens: number;
+
+    /**
+     * Total number of tokens used
+     */
+    total_tokens: number;
+  }
+}
+
+export interface EmbeddingListEmbeddingModelsResponse {
+  /**
+   * List of available embedding models
+   */
+  data: Array<EmbeddingListEmbeddingModelsResponse.Data>;
+
+  /**
+   * The object type, always 'list'
+   */
+  object: string;
+}
+
+export namespace EmbeddingListEmbeddingModelsResponse {
+  export interface Data {
+    /**
+     * The model identifier
+     */
+    id: string;
+
+    /**
+     * Unix timestamp of when the model was created
+     */
+    created: number;
+
+    /**
+     * The object type, always 'model'
+     */
+    object: string;
+
+    /**
+     * The organization that owns the model
+     */
+    owned_by: string;
+  }
+}
+
+export interface EmbeddingCreateEmbeddingsParams {
+  /**
+   * Input text to embed. Can be a string or array of strings.
+   */
+  input: string | Array<string>;
+
+  /**
+   * ID of the model to use. Use the List embedding models endpoint to see available
+   * models.
+   */
+  model: string;
+
+  /**
+   * The number of dimensions the resulting output embeddings should have. Only
+   * supported in some models.
+   */
+  dimensions?: number;
+
+  /**
+   * The format to return the embeddings in.
+   */
+  encoding_format?: 'float' | 'base64';
+
+  /**
+   * A unique identifier representing your end-user for monitoring and abuse
+   * detection.
+   */
+  user?: string;
+}
+
+export declare namespace Embeddings {
+  export {
+    type EmbeddingCreateEmbeddingsResponse as EmbeddingCreateEmbeddingsResponse,
+    type EmbeddingListEmbeddingModelsResponse as EmbeddingListEmbeddingModelsResponse,
+    type EmbeddingCreateEmbeddingsParams as EmbeddingCreateEmbeddingsParams,
+  };
+}

package/src/resources/ai/openai/index.ts

@@ -0,0 +1,9 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Embeddings,
+  type EmbeddingCreateEmbeddingsResponse,
+  type EmbeddingListEmbeddingModelsResponse,
+  type EmbeddingCreateEmbeddingsParams,
+} from './embeddings';
+export { OpenAI } from './openai';

package/src/resources/ai/openai/openai.ts

@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as EmbeddingsAPI from './embeddings';
+import {
+  EmbeddingCreateEmbeddingsParams,
+  EmbeddingCreateEmbeddingsResponse,
+  EmbeddingListEmbeddingModelsResponse,
+  Embeddings,
+} from './embeddings';
+
+export class OpenAI extends APIResource {
+  embeddings: EmbeddingsAPI.Embeddings = new EmbeddingsAPI.Embeddings(this._client);
+}
+
+OpenAI.Embeddings = Embeddings;
+
+export declare namespace OpenAI {
+  export {
+    Embeddings as Embeddings,
+    type EmbeddingCreateEmbeddingsResponse as EmbeddingCreateEmbeddingsResponse,
+    type EmbeddingListEmbeddingModelsResponse as EmbeddingListEmbeddingModelsResponse,
+    type EmbeddingCreateEmbeddingsParams as EmbeddingCreateEmbeddingsParams,
+  };
+}

package/src/resources/ai/openai.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './openai/index';

package/src/resources/shared.ts

@@ -74,7 +74,7 @@ export interface ConnectionNoiseSuppressionDetails {
    * The attenuation limit value for the selected engine. Default values vary by
    * engine: 0 for 'denoiser', 80 for 'deep_filter_net', 'deep_filter_net_large', and
    * all Krisp engines ('krisp_viva_tel', 'krisp_viva_tel_lite',
-   * 'krisp_viva_promodel', 'krisp_viva_ss').
+   * 'krisp_viva_promodel', 'krisp_viva_ss'), 100 for 'quail_voice_focus'.
    */
   attenuation_limit?: number;
 
@@ -83,7 +83,8 @@ export interface ConnectionNoiseSuppressionDetails {
    * 'deep_filter_net' and 'deep_filter_net_large' are alternative engines with
    * different performance characteristics. Krisp engines ('krisp_viva_tel',
    * 'krisp_viva_tel_lite', 'krisp_viva_promodel', 'krisp_viva_ss') provide advanced
-   * noise suppression capabilities.
+   * noise suppression capabilities. 'quail_voice_focus' provides Quail-based voice
+   * focus noise suppression.
    */
   engine?:
     | 'denoiser'
@@ -92,7 +93,8 @@ export interface ConnectionNoiseSuppressionDetails {
     | 'krisp_viva_tel'
     | 'krisp_viva_tel_lite'
     | 'krisp_viva_promodel'
-    | 'krisp_viva_ss';
+    | 'krisp_viva_ss'
+    | 'quail_voice_focus';
 }
 
 export interface ConnectionsPaginationMeta {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '5.25.0'; // x-release-please-version
+export const VERSION = '5.26.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.25.0";
+export declare const VERSION = "5.26.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.25.0";
+export declare const VERSION = "5.26.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '5.25.0'; // x-release-please-version
+exports.VERSION = '5.26.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '5.25.0'; // x-release-please-version
+export const VERSION = '5.26.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map