retell-sdk 4.27.0 → 4.29.0

package/resources/phone-number.mjs

@@ -3,30 +3,65 @@ import { APIResource } from "../resource.mjs";
 export class PhoneNumber extends APIResource {
     /**
      * Buy a new phone number & Bind agents
+     *
+     * @example
+     * ```ts
+     * const phoneNumberResponse =
+     *   await client.phoneNumber.create();
+     * ```
      */
     create(body, options) {
         return this._client.post('/create-phone-number', { body, ...options });
     }
     /**
      * Retrieve details of a specific phone number
+     *
+     * @example
+     * ```ts
+     * const phoneNumberResponse =
+     *   await client.phoneNumber.retrieve('+14157774444');
+     * ```
      */
     retrieve(phoneNumber, options) {
         return this._client.get(`/get-phone-number/${phoneNumber}`, options);
     }
     /**
      * Update agent bound to a purchased phone number
+     *
+     * @example
+     * ```ts
+     * const phoneNumberResponse = await client.phoneNumber.update(
+     *   '+14157774444',
+     *   {
+     *     inbound_agent_id: 'oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD',
+     *     nickname: 'Frontdesk Number',
+     *     outbound_agent_id: 'oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD',
+     *   },
+     * );
+     * ```
      */
     update(phoneNumber, body, options) {
         return this._client.patch(`/update-phone-number/${phoneNumber}`, { body, ...options });
     }
     /**
      * List all phone numbers
+     *
+     * @example
+     * ```ts
+     * const phoneNumberResponses =
+     *   await client.phoneNumber.list();
+     * ```
      */
     list(options) {
         return this._client.get('/list-phone-numbers', options);
     }
     /**
      * Delete an existing phone number
+     *
+     * @example
+     * ```ts
+     * await client.phoneNumber.delete('+14157774444');
+     * ```
      */
     delete(phoneNumber, options) {
         return this._client.delete(`/delete-phone-number/${phoneNumber}`, {
@@ -36,6 +71,16 @@ export class PhoneNumber extends APIResource {
     }
     /**
      * Import a phone number from custom telephony & Bind agents
+     *
+     * @example
+     * ```ts
+     * const phoneNumberResponse = await client.phoneNumber.import(
+     *   {
+     *     phone_number: '+14157774444',
+     *     termination_uri: 'someuri.pstn.twilio.com',
+     *   },
+     * );
+     * ```
      */
     import(body, options) {
         return this._client.post('/import-phone-number', { body, ...options });

package/resources/phone-number.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"phone-number.mjs","sourceRoot":"","sources":["../src/resources/phone-number.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAGtB,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;OAEG;IACH,MAAM,CAAC,IAA6B,EAAE,OAA6B;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,WAAmB,EAAE,OAA6B;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,WAAmB,EACnB,IAA6B,EAC7B,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,wBAAwB,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAA6B;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAmB,EAAE,OAA6B;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,wBAAwB,WAAW,EAAE,EAAE;YAChE,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAA6B,EAAE,OAA6B;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;CACF"}
+{"version":3,"file":"phone-number.mjs","sourceRoot":"","sources":["../src/resources/phone-number.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAGtB,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;OAQG;IACH,MAAM,CAAC,IAA6B,EAAE,OAA6B;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,WAAmB,EAAE,OAA6B;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CACJ,WAAmB,EACnB,IAA6B,EAC7B,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,wBAAwB,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,OAA6B;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,WAAmB,EAAE,OAA6B;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,wBAAwB,WAAW,EAAE,EAAE;YAChE,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAA6B,EAAE,OAA6B;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;CACF"}

package/src/resources/agent.ts

@@ -7,6 +7,17 @@ import * as Core from '../core';
 export class Agent extends APIResource {
   /**
    * Create a new agent
+   *
+   * @example
+   * ```ts
+   * const agentResponse = await client.agent.create({
+   *   response_engine: {
+   *     llm_id: 'llm_234sdertfsdsfsdf',
+   *     type: 'retell-llm',
+   *   },
+   *   voice_id: '11labs-Adrian',
+   * });
+   * ```
    */
   create(body: AgentCreateParams, options?: Core.RequestOptions): Core.APIPromise<AgentResponse> {
     return this._client.post('/create-agent', { body, ...options });
@@ -14,6 +25,13 @@ export class Agent extends APIResource {
 
   /**
    * Retrieve details of a specific agent
+   *
+   * @example
+   * ```ts
+   * const agentResponse = await client.agent.retrieve(
+   *   '16b980523634a6dc504898cda492e939',
+   * );
+   * ```
    */
   retrieve(
     agentId: string,
@@ -34,6 +52,14 @@ export class Agent extends APIResource {
 
   /**
    * Update an existing agent
+   *
+   * @example
+   * ```ts
+   * const agentResponse = await client.agent.update(
+   *   '16b980523634a6dc504898cda492e939',
+   *   { agent_name: 'Jarvis' },
+   * );
+   * ```
    */
   update(
     agentId: string,
@@ -50,6 +76,11 @@ export class Agent extends APIResource {
 
   /**
    * List all agents
+   *
+   * @example
+   * ```ts
+   * const agentResponses = await client.agent.list();
+   * ```
    */
   list(options?: Core.RequestOptions): Core.APIPromise<AgentListResponse> {
     return this._client.get('/list-agents', options);
@@ -57,6 +88,13 @@ export class Agent extends APIResource {
 
   /**
    * Delete an existing agent
+   *
+   * @example
+   * ```ts
+   * await client.agent.delete(
+   *   'oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD',
+   * );
+   * ```
    */
   delete(agentId: string, options?: Core.RequestOptions): Core.APIPromise<void> {
     return this._client.delete(`/delete-agent/${agentId}`, {
@@ -67,6 +105,13 @@ export class Agent extends APIResource {
 
   /**
    * Get all versions of an agent
+   *
+   * @example
+   * ```ts
+   * const agentResponses = await client.agent.getVersions(
+   *   '16b980523634a6dc504898cda492e939',
+   * );
+   * ```
    */
   getVersions(agentId: string, options?: Core.RequestOptions): Core.APIPromise<AgentGetVersionsResponse> {
     return this._client.get(`/get-agent-versions/${agentId}`, options);
@@ -106,6 +151,12 @@ export interface AgentResponse {
    */
   agent_name?: string | null;
 
+  /**
+   * If set to true, DTMF input will be accepted and processed. If false, any DTMF
+   * input will be ignored. Default to true.
+   */
+  allow_user_dtmf?: boolean;
+
   /**
    * If set, will add ambient environment sound to the call to make experience more
    * realistic. Currently supports the following options:
@@ -180,6 +231,11 @@ export interface AgentResponse {
    */
   boosted_keywords?: Array<string> | null;
 
+  /**
+   * If set, determines what denoising mode to use. Default to noise-cancellation.
+   */
+  denoising_mode?: 'noise-cancellation' | 'noise-and-background-speech-cancellation';
+
   /**
    * Controls whether the agent would backchannel (agent interjects the speaker with
    * phrases like "yeah", "uh-huh" to signify interest and engagement). Backchannel
@@ -225,6 +281,11 @@ export interface AgentResponse {
    */
   interruption_sensitivity?: number;
 
+  /**
+   * Whether the agent is published.
+   */
+  is_published?: boolean;
+
   /**
    * Specifies what language (and dialect) the speech recognition will operate in.
    * For instance, selecting `en-GB` optimizes speech recognition for British
@@ -285,6 +346,13 @@ export interface AgentResponse {
    */
   normalize_for_speech?: boolean;
 
+  /**
+   * Whether this agent opts in for signed URLs for public logs and recordings. When
+   * enabled, the generated URLs will include security signatures that restrict
+   * access and automatically expire after 24 hours.
+   */
+  opt_in_signed_url?: boolean;
+
   /**
    * Whether this agent opts out of sensitive data storage like transcript,
    * recording, logging, inbound/outbound phone numbers, etc. These data can still be
@@ -352,10 +420,12 @@ export interface AgentResponse {
    */
   stt_mode?: 'fast' | 'accurate';
 
+  user_dtmf_options?: AgentResponse.UserDtmfOptions | null;
+
   /**
    * Version of the agent.
    */
-  version?: number | null;
+  version?: unknown;
 
   /**
    * Optionally set the voice model used for the selected voice. Currently only
@@ -430,6 +500,11 @@ export namespace AgentResponse {
      * type of the Response Engine.
      */
     type: 'retell-llm';
+
+    /**
+     * Version of the Retell LLM Response Engine.
+     */
+    version?: number | null;
   }
 
   export interface ResponseEngineCustomLm {
@@ -454,6 +529,11 @@ export namespace AgentResponse {
      * type of the Response Engine.
      */
     type: 'conversation-flow';
+
+    /**
+     * Version of the Conversation Flow Response Engine.
+     */
+    version?: number | null;
   }
 
   export interface StringAnalysisData {
@@ -550,6 +630,27 @@ export namespace AgentResponse {
      */
     word: string;
   }
+
+  export interface UserDtmfOptions {
+    /**
+     * The maximum number of digits allowed in the user's DTMF (Dual-Tone
+     * Multi-Frequency) input per turn. Once this limit is reached, the input is
+     * considered complete and a response will be generated immediately.
+     */
+    digit_limit?: number | null;
+
+    /**
+     * A single key that signals the end of DTMF input. Acceptable values include any
+     * digit (0–9), the pound/hash symbol (#), or the asterisk (\*).
+     */
+    termination_key?: string | null;
+
+    /**
+     * The time (in milliseconds) to wait for user DTMF input before timing out. The
+     * timer resets with each digit received.
+     */
+    timeout_ms?: number;
+  }
 }
 
 export type AgentListResponse = Array<AgentResponse>;
@@ -578,6 +679,12 @@ export interface AgentCreateParams {
    */
   agent_name?: string | null;
 
+  /**
+   * If set to true, DTMF input will be accepted and processed. If false, any DTMF
+   * input will be ignored. Default to true.
+   */
+  allow_user_dtmf?: boolean;
+
   /**
    * If set, will add ambient environment sound to the call to make experience more
    * realistic. Currently supports the following options:
@@ -652,6 +759,11 @@ export interface AgentCreateParams {
    */
   boosted_keywords?: Array<string> | null;
 
+  /**
+   * If set, determines what denoising mode to use. Default to noise-cancellation.
+   */
+  denoising_mode?: 'noise-cancellation' | 'noise-and-background-speech-cancellation';
+
   /**
    * Controls whether the agent would backchannel (agent interjects the speaker with
    * phrases like "yeah", "uh-huh" to signify interest and engagement). Backchannel
@@ -757,6 +869,13 @@ export interface AgentCreateParams {
    */
   normalize_for_speech?: boolean;
 
+  /**
+   * Whether this agent opts in for signed URLs for public logs and recordings. When
+   * enabled, the generated URLs will include security signatures that restrict
+   * access and automatically expire after 24 hours.
+   */
+  opt_in_signed_url?: boolean;
+
   /**
    * Whether this agent opts out of sensitive data storage like transcript,
    * recording, logging, inbound/outbound phone numbers, etc. These data can still be
@@ -824,6 +943,8 @@ export interface AgentCreateParams {
    */
   stt_mode?: 'fast' | 'accurate';
 
+  user_dtmf_options?: AgentCreateParams.UserDtmfOptions | null;
+
   /**
    * Version of the agent.
    */
@@ -902,6 +1023,11 @@ export namespace AgentCreateParams {
      * type of the Response Engine.
      */
     type: 'retell-llm';
+
+    /**
+     * Version of the Retell LLM Response Engine.
+     */
+    version?: number | null;
   }
 
   export interface ResponseEngineCustomLm {
@@ -926,6 +1052,11 @@ export namespace AgentCreateParams {
      * type of the Response Engine.
      */
     type: 'conversation-flow';
+
+    /**
+     * Version of the Conversation Flow Response Engine.
+     */
+    version?: number | null;
   }
 
   export interface StringAnalysisData {
@@ -1022,18 +1153,40 @@ export namespace AgentCreateParams {
      */
     word: string;
   }
+
+  export interface UserDtmfOptions {
+    /**
+     * The maximum number of digits allowed in the user's DTMF (Dual-Tone
+     * Multi-Frequency) input per turn. Once this limit is reached, the input is
+     * considered complete and a response will be generated immediately.
+     */
+    digit_limit?: number | null;
+
+    /**
+     * A single key that signals the end of DTMF input. Acceptable values include any
+     * digit (0–9), the pound/hash symbol (#), or the asterisk (\*).
+     */
+    termination_key?: string | null;
+
+    /**
+     * The time (in milliseconds) to wait for user DTMF input before timing out. The
+     * timer resets with each digit received.
+     */
+    timeout_ms?: number;
+  }
 }
 
 export interface AgentRetrieveParams {
   /**
-   * Optional version of the API to use for this request. Default to 0.
+   * Optional version of the API to use for this request. Default to latest version.
    */
   version?: number;
 }
 
 export interface AgentUpdateParams {
   /**
-   * Query param: Optional version of the API to use for this request. Default to 0.
+   * Query param: Optional version of the API to use for this request. Default to
+   * latest version.
    */
   query_version?: number;
 
@@ -1042,6 +1195,12 @@ export interface AgentUpdateParams {
    */
   agent_name?: string | null;
 
+  /**
+   * Body param: If set to true, DTMF input will be accepted and processed. If false,
+   * any DTMF input will be ignored. Default to true.
+   */
+  allow_user_dtmf?: boolean;
+
   /**
    * Body param: If set, will add ambient environment sound to the call to make
    * experience more realistic. Currently supports the following options:
@@ -1116,6 +1275,12 @@ export interface AgentUpdateParams {
    */
   boosted_keywords?: Array<string> | null;
 
+  /**
+   * Body param: If set, determines what denoising mode to use. Default to
+   * noise-cancellation.
+   */
+  denoising_mode?: 'noise-cancellation' | 'noise-and-background-speech-cancellation';
+
   /**
    * Body param: Controls whether the agent would backchannel (agent interjects the
    * speaker with phrases like "yeah", "uh-huh" to signify interest and engagement).
@@ -1222,6 +1387,13 @@ export interface AgentUpdateParams {
    */
   normalize_for_speech?: boolean;
 
+  /**
+   * Body param: Whether this agent opts in for signed URLs for public logs and
+   * recordings. When enabled, the generated URLs will include security signatures
+   * that restrict access and automatically expire after 24 hours.
+   */
+  opt_in_signed_url?: boolean;
+
   /**
    * Body param: Whether this agent opts out of sensitive data storage like
    * transcript, recording, logging, inbound/outbound phone numbers, etc. These data
@@ -1302,6 +1474,11 @@ export interface AgentUpdateParams {
    */
   stt_mode?: 'fast' | 'accurate';
 
+  /**
+   * Body param:
+   */
+  user_dtmf_options?: AgentUpdateParams.UserDtmfOptions | null;
+
   /**
    * Body param: Version of the agent.
    */
@@ -1481,6 +1658,11 @@ export namespace AgentUpdateParams {
      * type of the Response Engine.
      */
     type: 'retell-llm';
+
+    /**
+     * Version of the Retell LLM Response Engine.
+     */
+    version?: number | null;
   }
 
   export interface ResponseEngineCustomLm {
@@ -1505,6 +1687,32 @@ export namespace AgentUpdateParams {
      * type of the Response Engine.
      */
     type: 'conversation-flow';
+
+    /**
+     * Version of the Conversation Flow Response Engine.
+     */
+    version?: number | null;
+  }
+
+  export interface UserDtmfOptions {
+    /**
+     * The maximum number of digits allowed in the user's DTMF (Dual-Tone
+     * Multi-Frequency) input per turn. Once this limit is reached, the input is
+     * considered complete and a response will be generated immediately.
+     */
+    digit_limit?: number | null;
+
+    /**
+     * A single key that signals the end of DTMF input. Acceptable values include any
+     * digit (0–9), the pound/hash symbol (#), or the asterisk (\*).
+     */
+    termination_key?: string | null;
+
+    /**
+     * The time (in milliseconds) to wait for user DTMF input before timing out. The
+     * timer resets with each digit received.
+     */
+    timeout_ms?: number;
   }
 }
 

package/src/resources/batch-call.ts

@@ -6,6 +6,15 @@ import * as Core from '../core';
 export class BatchCall extends APIResource {
   /**
    * Create a batch call
+   *
+   * @example
+   * ```ts
+   * const batchCallResponse =
+   *   await client.batchCall.createBatchCall({
+   *     from_number: '+14157774444',
+   *     tasks: [{ to_number: '+12137774445' }],
+   *   });
+   * ```
    */
   createBatchCall(
     body: BatchCallCreateBatchCallParams,

package/src/resources/call.ts

@@ -6,6 +6,13 @@ import * as Core from '../core';
 export class Call extends APIResource {
   /**
    * Retrieve details of a specific call
+   *
+   * @example
+   * ```ts
+   * const callResponse = await client.call.retrieve(
+   *   '119c3f8e47135a29e65947eeb34cf12d',
+   * );
+   * ```
    */
   retrieve(callId: string, options?: Core.RequestOptions): Core.APIPromise<CallResponse> {
     return this._client.get(`/v2/get-call/${callId}`, options);
@@ -13,6 +20,20 @@ export class Call extends APIResource {
 
   /**
    * Update metadata and sensitive data storage settings for an existing call
+   *
+   * @example
+   * ```ts
+   * const callResponse = await client.call.update(
+   *   'call_a4441234567890777c4a4a123e6',
+   *   {
+   *     metadata: {
+   *       customer_id: 'cust_123',
+   *       notes: 'Follow-up required',
+   *     },
+   *     opt_out_sensitive_data_storage: true,
+   *   },
+   * );
+   * ```
    */
   update(
     callId: string,
@@ -24,6 +45,11 @@ export class Call extends APIResource {
 
   /**
    * Retrieve call details
+   *
+   * @example
+   * ```ts
+   * const callResponses = await client.call.list();
+   * ```
    */
   list(body: CallListParams, options?: Core.RequestOptions): Core.APIPromise<CallListResponse> {
     return this._client.post('/v2/list-calls', { body, ...options });
@@ -31,6 +57,13 @@ export class Call extends APIResource {
 
   /**
    * Delete a specific call and its associated data
+   *
+   * @example
+   * ```ts
+   * await client.call.delete(
+   *   '119c3f8e47135a29e65947eeb34cf12d',
+   * );
+   * ```
    */
   delete(callId: string, options?: Core.RequestOptions): Core.APIPromise<void> {
     return this._client.delete(`/v2/delete-call/${callId}`, {
@@ -41,6 +74,16 @@ export class Call extends APIResource {
 
   /**
    * Create a new outbound phone call
+   *
+   * @example
+   * ```ts
+   * const phoneCallResponse = await client.call.createPhoneCall(
+   *   {
+   *     from_number: '+14157774444',
+   *     to_number: '+12137774445',
+   *   },
+   * );
+   * ```
    */
   createPhoneCall(
     body: CallCreatePhoneCallParams,
@@ -51,6 +94,13 @@ export class Call extends APIResource {
 
   /**
    * Create a new web call
+   *
+   * @example
+   * ```ts
+   * const webCallResponse = await client.call.createWebCall({
+   *   agent_id: 'oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD',
+   * });
+   * ```
    */
   createWebCall(
     body: CallCreateWebCallParams,
@@ -61,6 +111,14 @@ export class Call extends APIResource {
 
   /**
    * Register a new phone call for custom telephony
+   *
+   * @example
+   * ```ts
+   * const phoneCallResponse =
+   *   await client.call.registerPhoneCall({
+   *     agent_id: 'oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD',
+   *   });
+   * ```
    */
   registerPhoneCall(
     body: CallRegisterPhoneCallParams,
@@ -181,6 +239,13 @@ export interface PhoneCallResponse {
    */
   metadata?: unknown;
 
+  /**
+   * Whether this agent opts in for signed URLs for public logs and recordings. When
+   * enabled, the generated URLs will include security signatures that restrict
+   * access and automatically expire after 24 hours.
+   */
+  opt_in_signed_url?: boolean;
+
   /**
    * Whether this call opts out of sensitive data storage like transcript, recording,
    * logging.
@@ -905,6 +970,13 @@ export interface WebCallResponse {
    */
   metadata?: unknown;
 
+  /**
+   * Whether this agent opts in for signed URLs for public logs and recordings. When
+   * enabled, the generated URLs will include security signatures that restrict
+   * access and automatically expire after 24 hours.
+   */
+  opt_in_signed_url?: boolean;
+
   /**
    * Whether this call opts out of sensitive data storage like transcript, recording,
    * logging.