telnyx 7.14.0 → 7.16.0

package/src/resources/meeting-sessions/actions.ts

@@ -0,0 +1,108 @@
+// 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';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Send real-time speech and chat actions to an active meeting session.
+ */
+export class Actions extends APIResource {
+  /**
+   * Sends a chat message into a meeting session.
+   *
+   * @example
+   * ```ts
+   * const actionAcceptedResponse =
+   *   await client.meetingSessions.actions.sendChat(
+   *     'mtgsess_a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+   *     { text: 'I will send the summary after this call.' },
+   *   );
+   * ```
+   */
+  sendChat(
+    id: string,
+    body: ActionSendChatParams,
+    options?: RequestOptions,
+  ): APIPromise<ActionAcceptedResponse> {
+    return this._client.post(path`/meeting_sessions/${id}/actions/send_chat`, { body, ...options });
+  }
+
+  /**
+   * Sends audio / text-to-speech into a meeting session.
+   *
+   * @example
+   * ```ts
+   * const actionAcceptedResponse =
+   *   await client.meetingSessions.actions.speak(
+   *     'mtgsess_a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+   *     {
+   *       text: 'Here are the three decisions from this call.',
+   *     },
+   *   );
+   * ```
+   */
+  speak(id: string, body: ActionSpeakParams, options?: RequestOptions): APIPromise<ActionAcceptedResponse> {
+    return this._client.post(path`/meeting_sessions/${id}/actions/speak`, { body, ...options });
+  }
+
+  /**
+   * Stops any active text-to-speech playback in a meeting session.
+   *
+   * @example
+   * ```ts
+   * const actionAcceptedResponse =
+   *   await client.meetingSessions.actions.stopSpeaking(
+   *     'mtgsess_a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+   *   );
+   * ```
+   */
+  stopSpeaking(id: string, options?: RequestOptions): APIPromise<ActionAcceptedResponse> {
+    return this._client.post(path`/meeting_sessions/${id}/actions/stop_speaking`, options);
+  }
+}
+
+export interface ActionAcceptedResponse {
+  data: ActionAcceptedResponse.Data;
+}
+
+export namespace ActionAcceptedResponse {
+  export interface Data {
+    accepted: true;
+  }
+}
+
+export interface ActionSendChatParams {
+  /**
+   * Chat message text to send in the meeting.
+   */
+  text: string;
+}
+
+export interface ActionSpeakParams {
+  /**
+   * Text for the bot to speak.
+   */
+  text: string;
+
+  /**
+   * If true, interrupt any currently playing audio to speak this text immediately.
+   */
+  interrupt?: boolean;
+
+  /**
+   * Voice identifier to use for this utterance. When supplied, it overrides the
+   * session-default voice configured at creation; otherwise the speak action uses
+   * that session default.
+   */
+  voice?: string;
+}
+
+export declare namespace Actions {
+  export {
+    type ActionAcceptedResponse as ActionAcceptedResponse,
+    type ActionSendChatParams as ActionSendChatParams,
+    type ActionSpeakParams as ActionSpeakParams,
+  };
+}

package/src/resources/meeting-sessions/artifacts.ts

@@ -0,0 +1,135 @@
+// 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';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Create and retrieve asynchronous summaries and action-item artifacts.
+ */
+export class Artifacts extends APIResource {
+  /**
+   * Returns a list of artifacts for a meeting session.
+   *
+   * @example
+   * ```ts
+   * const artifacts =
+   *   await client.meetingSessions.artifacts.list(
+   *     'mtgsess_a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+   *   );
+   * ```
+   */
+  list(id: string, options?: RequestOptions): APIPromise<ArtifactListResponse> {
+    return this._client.get(path`/meeting_sessions/${id}/artifacts`, options);
+  }
+
+  /**
+   * Requests asynchronous generation of one `summary` or `action_items` artifact.
+   * Each type requires its own request. Generation requires transcript content and
+   * configured inference and currently reads at most the first 10,000 segments, so
+   * exceptionally long transcripts may produce incomplete artifacts or fail model
+   * limits.
+   *
+   * @example
+   * ```ts
+   * const meetingSessionArtifactResponse =
+   *   await client.meetingSessions.artifacts.create(
+   *     'mtgsess_a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+   *     { type: 'summary' },
+   *   );
+   * ```
+   */
+  create(
+    id: string,
+    body: ArtifactCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<MeetingSessionArtifactResponse> {
+    return this._client.post(path`/meeting_sessions/${id}/artifacts`, { body, ...options });
+  }
+
+  /**
+   * Retrieves a single meeting session artifact by ID.
+   *
+   * @example
+   * ```ts
+   * const meetingSessionArtifactResponse =
+   *   await client.meetingSessions.artifacts.retrieve(
+   *     'mtgart_b2c3d4e5-f6a7-8901-bcde-f23456789012',
+   *     { id: 'mtgsess_a1b2c3d4-e5f6-7890-abcd-ef1234567890' },
+   *   );
+   * ```
+   */
+  retrieve(
+    artifactID: string,
+    params: ArtifactRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<MeetingSessionArtifactResponse> {
+    const { id } = params;
+    return this._client.get(path`/meeting_sessions/${id}/artifacts/${artifactID}`, options);
+  }
+}
+
+export interface MeetingSessionArtifact {
+  id: string;
+
+  content: MeetingSessionArtifact.Content | null;
+
+  created_at: string;
+
+  failure_reason: string | null;
+
+  model_provenance: MeetingSessionArtifact.ModelProvenance | null;
+
+  session_id: string;
+
+  status: 'pending' | 'completed' | 'failed';
+
+  type: 'summary' | 'action_items';
+
+  updated_at: string;
+}
+
+export namespace MeetingSessionArtifact {
+  export interface Content {
+    text: string;
+  }
+
+  export interface ModelProvenance {
+    model: string;
+
+    provider: string;
+  }
+}
+
+export interface MeetingSessionArtifactResponse {
+  data: MeetingSessionArtifact;
+}
+
+export interface ArtifactListResponse {
+  data: Array<MeetingSessionArtifact>;
+}
+
+export interface ArtifactCreateParams {
+  /**
+   * Type of artifact to generate from the session.
+   */
+  type: 'summary' | 'action_items';
+}
+
+export interface ArtifactRetrieveParams {
+  /**
+   * Unique identifier for the meeting session.
+   */
+  id: string;
+}
+
+export declare namespace Artifacts {
+  export {
+    type MeetingSessionArtifact as MeetingSessionArtifact,
+    type MeetingSessionArtifactResponse as MeetingSessionArtifactResponse,
+    type ArtifactListResponse as ArtifactListResponse,
+    type ArtifactCreateParams as ArtifactCreateParams,
+    type ArtifactRetrieveParams as ArtifactRetrieveParams,
+  };
+}

package/src/resources/meeting-sessions/index.ts

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Actions,
+  type ActionAcceptedResponse,
+  type ActionSendChatParams,
+  type ActionSpeakParams,
+} from './actions';
+export {
+  Artifacts,
+  type MeetingSessionArtifact,
+  type MeetingSessionArtifactResponse,
+  type ArtifactListResponse,
+  type ArtifactCreateParams,
+  type ArtifactRetrieveParams,
+} from './artifacts';
+export {
+  MeetingSessions,
+  type MeetingSession,
+  type MeetingSessionResponse,
+  type MeetingSessionListResponse,
+  type MeetingSessionDeleteRecordingMediaResponse,
+  type MeetingSessionRetrieveEventsResponse,
+  type MeetingSessionRetrieveRecordingsResponse,
+  type MeetingSessionRetrieveTranscriptResponse,
+  type MeetingSessionListParams,
+  type MeetingSessionCreateParams,
+  type MeetingSessionUpdateParams,
+  type MeetingSessionRetrieveEventsParams,
+  type MeetingSessionRetrieveTranscriptParams,
+} from './meeting-sessions';