@scout9/admin 1.0.0-alpha.0.0.67 → 1.0.0-alpha.0.0.69

package/src/api.ts

@@ -621,12 +621,30 @@ export interface ContextualizerResponse {
  * @interface Conversation
  */
 export interface Conversation {
+    /**
+     * Conversation document id. Public/admin clients may receive this field; middleware does not store it inside the Firestore document body.
+     * @type {string}
+     * @memberof Conversation
+     */
+    '$id'?: string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof Conversation
+     */
+    '$business': string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof Conversation
      */
     '$agent': string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof Conversation
+     */
+    '$customer': string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -635,71 +653,125 @@ export interface Conversation {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
+     * @memberof Conversation
+     */
+    'channel': ConversationChannel;
+    /**
+     * 
+     * @type {ConversationChannelProps}
+     * @memberof Conversation
+     */
+    'channelProps'?: ConversationChannelProps;
+    /**
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
      * @memberof Conversation
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'locked'?: boolean | null;
     /**
-     * User for this conversation
+     * Machine-readable lock reason.
      * @type {string}
      * @memberof Conversation
      */
-    '$user': string;
+    'lockCode'?: ConversationLockCodeEnum;
     /**
-     * Customer this conversation is with (use $user instead)
+     * Human-readable locked reason.
      * @type {string}
      * @memberof Conversation
-     * @deprecated
      */
-    '$customer'?: string;
+    'lockedReason'?: string | null;
     /**
-     * 
-     * @type {ConversationEnvironment}
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
      * @memberof Conversation
      */
-    'environment': ConversationEnvironment;
+    'lockAttempts'?: number | null;
     /**
-     * Whether this conversation is a test or not
-     * @type {boolean}
+     * Contact that received a forward handoff.
+     * @type {string}
      * @memberof Conversation
      */
-    'test'?: boolean;
-}
-
-
-/**
- * 
- * @export
- * @interface ConversationAllOf
- */
-export interface ConversationAllOf {
+    'forwardedTo'?: string | null;
     /**
-     * User for this conversation
+     * ISO 8601 datetime string for when the conversation was forwarded.
      * @type {string}
-     * @memberof ConversationAllOf
+     * @memberof Conversation
      */
-    '$user': string;
+    'forwarded'?: string | null;
     /**
-     * Customer this conversation is with (use $user instead)
+     * Operator or workflow note attached to the forward.
      * @type {string}
-     * @memberof ConversationAllOf
-     * @deprecated
+     * @memberof Conversation
      */
-    '$customer'?: string;
+    'forwardNote'?: string | null;
     /**
-     * 
-     * @type {ConversationEnvironment}
-     * @memberof ConversationAllOf
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof Conversation
      */
-    'environment': ConversationEnvironment;
+    'initiated'?: string;
     /**
-     * Whether this conversation is a test or not
-     * @type {boolean}
-     * @memberof ConversationAllOf
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
+     * @memberof Conversation
+     */
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof Conversation
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof Conversation
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof Conversation
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof Conversation
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof Conversation
      */
-    'test'?: boolean;
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
+     * @memberof Conversation
+     */
+    'ingress'?: ConversationIngressEnum;
 }
 
+export const ConversationLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ConversationLockCodeEnum = typeof ConversationLockCodeEnum[keyof typeof ConversationLockCodeEnum];
+export const ConversationIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ConversationIngressEnum = typeof ConversationIngressEnum[keyof typeof ConversationIngressEnum];
 
 /**
  * Base props all conversation types will have
@@ -707,12 +779,30 @@ export interface ConversationAllOf {
  * @interface ConversationBase
  */
 export interface ConversationBase {
+    /**
+     * Conversation document id. Public/admin clients may receive this field; middleware does not store it inside the Firestore document body.
+     * @type {string}
+     * @memberof ConversationBase
+     */
+    '$id'?: string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ConversationBase
+     */
+    '$business'?: string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ConversationBase
      */
     '$agent'?: string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ConversationBase
+     */
+    '$customer'?: string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -721,30 +811,190 @@ export interface ConversationBase {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
+     * @memberof ConversationBase
+     */
+    'channel'?: ConversationChannel;
+    /**
+     * 
+     * @type {ConversationChannelProps}
+     * @memberof ConversationBase
+     */
+    'channelProps'?: ConversationChannelProps;
+    /**
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
+     * @memberof ConversationBase
+     */
+    'locked'?: boolean | null;
+    /**
+     * Machine-readable lock reason.
+     * @type {string}
+     * @memberof ConversationBase
+     */
+    'lockCode'?: ConversationBaseLockCodeEnum;
+    /**
+     * Human-readable locked reason.
+     * @type {string}
+     * @memberof ConversationBase
+     */
+    'lockedReason'?: string | null;
+    /**
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
+     * @memberof ConversationBase
+     */
+    'lockAttempts'?: number | null;
+    /**
+     * Contact that received a forward handoff.
+     * @type {string}
+     * @memberof ConversationBase
+     */
+    'forwardedTo'?: string | null;
+    /**
+     * ISO 8601 datetime string for when the conversation was forwarded.
+     * @type {string}
+     * @memberof ConversationBase
+     */
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
+     * @memberof ConversationBase
+     */
+    'forwardNote'?: string | null;
+    /**
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof ConversationBase
+     */
+    'initiated'?: string;
+    /**
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
+     * @memberof ConversationBase
+     */
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ConversationBase
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ConversationBase
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationBase
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
      * @memberof ConversationBase
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationBase
+     */
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
+     * @memberof ConversationBase
+     */
+    'ingress'?: ConversationBaseIngressEnum;
 }
+
+export const ConversationBaseLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ConversationBaseLockCodeEnum = typeof ConversationBaseLockCodeEnum[keyof typeof ConversationBaseLockCodeEnum];
+export const ConversationBaseIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ConversationBaseIngressEnum = typeof ConversationBaseIngressEnum[keyof typeof ConversationBaseIngressEnum];
+
+/**
+ * Canonical channel that initiated and should continue the customer conversation.
+ * @export
+ * @enum {string}
+ */
+
+export const ConversationChannel = {
+    Web: 'web',
+    DemoPhoneTest: 'demo_phone_test',
+    SmsPhone: 'sms_phone',
+    Outlook: 'outlook',
+    Gmail: 'gmail',
+    Iphone: 'iphone',
+    Android: 'android',
+    Teams: 'teams',
+    Discord: 'discord',
+    Whatsapp: 'whatsapp'
+} as const;
+
+export type ConversationChannel = typeof ConversationChannel[keyof typeof ConversationChannel];
+
+
 /**
- * Environment properties for the conversation
+ * Channel-specific properties needed to continue a conversation on its canonical channel.
  * @export
- * @interface ConversationBaseEnvironmentProps
+ * @interface ConversationChannelProps
  */
-export interface ConversationBaseEnvironmentProps {
+export interface ConversationChannelProps {
+    [key: string]: any;
+
     /**
-     * HTML subject line
+     * Subject line for email-style channels such as Gmail and Outlook.
      * @type {string}
-     * @memberof ConversationBaseEnvironmentProps
+     * @memberof ConversationChannelProps
      */
     'subject'?: string;
     /**
-     * Used to sync email messages with the conversation
+     * Provider thread id used to sync Gmail/Outlook channel messages with this conversation.
      * @type {string}
-     * @memberof ConversationBaseEnvironmentProps
+     * @memberof ConversationChannelProps
      */
     'platformEmailThreadId'?: string;
+    /**
+     * Twilio message sid that initiated this conversation.
+     * @type {string}
+     * @memberof ConversationChannelProps
+     */
+    'smsMessageSid'?: string;
+    /**
+     * Persisted channel-resolution path used for the current conversation.
+     * @type {string}
+     * @memberof ConversationChannelProps
+     */
+    'channelResolutionPath'?: ConversationChannelPropsChannelResolutionPathEnum;
 }
+
+export const ConversationChannelPropsChannelResolutionPathEnum = {
+    Production: 'twilio_production',
+    LegacyPmt: 'twilio_legacy_pmt',
+    FreeBridge: 'twilio_free_bridge'
+} as const;
+
+export type ConversationChannelPropsChannelResolutionPathEnum = typeof ConversationChannelPropsChannelResolutionPathEnum[keyof typeof ConversationChannelPropsChannelResolutionPathEnum];
+
 /**
  * 
  * @export
@@ -787,13 +1037,6 @@ export interface ConversationContextField {
      * @memberof ConversationContextField
      */
     'logic'?: Logic;
-    /**
-     * The conditions of the conversation
-     * @type {Array<ConversationContextGroup>}
-     * @memberof ConversationContextField
-     * @deprecated
-     */
-    'conditions'?: Array<ConversationContextGroup>;
     /**
      * The triggers of the conversation
      * @type {Array<string>}
@@ -910,12 +1153,30 @@ export type ConversationContextValueOneOfInner = boolean | number | string;
  * @interface ConversationCreateRequest
  */
 export interface ConversationCreateRequest {
+    /**
+     * Conversation document id. Public/admin clients may receive this field; middleware does not store it inside the Firestore document body.
+     * @type {string}
+     * @memberof ConversationCreateRequest
+     */
+    '$id'?: string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ConversationCreateRequest
+     */
+    '$business': string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ConversationCreateRequest
      */
     '$agent': string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ConversationCreateRequest
+     */
+    '$customer': string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -924,35 +1185,106 @@ export interface ConversationCreateRequest {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
+     * @memberof ConversationCreateRequest
+     */
+    'channel': ConversationChannel;
+    /**
+     * 
+     * @type {ConversationChannelProps}
+     * @memberof ConversationCreateRequest
+     */
+    'channelProps'?: ConversationChannelProps;
+    /**
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
      * @memberof ConversationCreateRequest
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'locked'?: boolean | null;
     /**
-     * User for this conversation
+     * Machine-readable lock reason.
      * @type {string}
      * @memberof ConversationCreateRequest
      */
-    '$user': string;
+    'lockCode'?: ConversationCreateRequestLockCodeEnum;
     /**
-     * Customer this conversation is with (use $user instead)
+     * Human-readable locked reason.
      * @type {string}
      * @memberof ConversationCreateRequest
-     * @deprecated
      */
-    '$customer'?: string;
+    'lockedReason'?: string | null;
     /**
-     * 
-     * @type {ConversationEnvironment}
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
      * @memberof ConversationCreateRequest
      */
-    'environment': ConversationEnvironment;
+    'lockAttempts'?: number | null;
     /**
-     * Whether this conversation is a test or not
-     * @type {boolean}
+     * Contact that received a forward handoff.
+     * @type {string}
+     * @memberof ConversationCreateRequest
+     */
+    'forwardedTo'?: string | null;
+    /**
+     * ISO 8601 datetime string for when the conversation was forwarded.
+     * @type {string}
+     * @memberof ConversationCreateRequest
+     */
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
+     * @memberof ConversationCreateRequest
+     */
+    'forwardNote'?: string | null;
+    /**
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof ConversationCreateRequest
+     */
+    'initiated'?: string;
+    /**
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
+     * @memberof ConversationCreateRequest
+     */
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ConversationCreateRequest
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ConversationCreateRequest
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationCreateRequest
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationCreateRequest
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationCreateRequest
+     */
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
      * @memberof ConversationCreateRequest
      */
-    'test'?: boolean;
+    'ingress'?: ConversationCreateRequestIngressEnum;
     /**
      * Appends a prefix to the conversation id, if a conversation id is prefixed with test, or dev, it will mute text messages
      * @type {string}
@@ -961,6 +1293,23 @@ export interface ConversationCreateRequest {
     'idPrefix'?: string;
 }
 
+export const ConversationCreateRequestLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ConversationCreateRequestLockCodeEnum = typeof ConversationCreateRequestLockCodeEnum[keyof typeof ConversationCreateRequestLockCodeEnum];
+export const ConversationCreateRequestIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ConversationCreateRequestIngressEnum = typeof ConversationCreateRequestIngressEnum[keyof typeof ConversationCreateRequestIngressEnum];
 
 /**
  * 
@@ -1038,32 +1387,35 @@ export interface ConversationCreateResponseAllOf {
     'initiated': string;
 }
 /**
- * Environment this conversation is in (phone, web, or email) - this determines which device to send messages to
- * @export
- * @enum {string}
- */
-
-export const ConversationEnvironment = {
-    Phone: 'phone',
-    Web: 'web',
-    Email: 'email'
-} as const;
-
-export type ConversationEnvironment = typeof ConversationEnvironment[keyof typeof ConversationEnvironment];
-
-
-/**
- * 
+ * 
  * @export
  * @interface ConversationGetResponse
  */
 export interface ConversationGetResponse {
+    /**
+     * The ID of the conversation
+     * @type {string}
+     * @memberof ConversationGetResponse
+     */
+    '$id': string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ConversationGetResponse
+     */
+    '$business': string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ConversationGetResponse
      */
     '$agent': string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ConversationGetResponse
+     */
+    '$customer': string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -1072,53 +1424,58 @@ export interface ConversationGetResponse {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
      * @memberof ConversationGetResponse
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'channel': ConversationChannel;
     /**
-     * User for this conversation
-     * @type {string}
+     * 
+     * @type {ConversationChannelProps}
+     * @memberof ConversationGetResponse
+     */
+    'channelProps'?: ConversationChannelProps;
+    /**
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
      * @memberof ConversationGetResponse
      */
-    '$user': string;
+    'locked'?: boolean | null;
     /**
-     * Customer this conversation is with (use $user instead)
+     * Machine-readable lock reason.
      * @type {string}
      * @memberof ConversationGetResponse
-     * @deprecated
      */
-    '$customer'?: string;
+    'lockCode'?: ConversationGetResponseLockCodeEnum;
     /**
-     * 
-     * @type {ConversationEnvironment}
+     * Human-readable locked reason.
+     * @type {string}
      * @memberof ConversationGetResponse
      */
-    'environment': ConversationEnvironment;
+    'lockedReason'?: string | null;
     /**
-     * Whether this conversation is a test or not
-     * @type {boolean}
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
      * @memberof ConversationGetResponse
      */
-    'test'?: boolean;
+    'lockAttempts'?: number | null;
     /**
-     * The client web url of the conversation
+     * Contact that received a forward handoff.
      * @type {string}
      * @memberof ConversationGetResponse
      */
-    'clientWebUrl'?: string;
+    'forwardedTo'?: string | null;
     /**
-     * The agent web url of the conversation (requires phone two-factor authentication)
+     * ISO 8601 datetime string for when the conversation was forwarded.
      * @type {string}
      * @memberof ConversationGetResponse
      */
-    'agentWebUrl'?: string;
+    'forwarded'?: string | null;
     /**
-     * The agent test web url of the conversation, used for testing the conversation without notifying the customer
+     * Operator or workflow note attached to the forward.
      * @type {string}
      * @memberof ConversationGetResponse
      */
-    'agentTestWebUrl'?: string;
+    'forwardNote'?: string | null;
     /**
      * ISO 8601 date string of when the conversation was initiated
      * @type {string}
@@ -1126,13 +1483,84 @@ export interface ConversationGetResponse {
      */
     'initiated': string;
     /**
-     * The ID of the conversation
+     * Detected intent attached at conversation start or first customer message.
      * @type {string}
      * @memberof ConversationGetResponse
      */
-    '$id': string;
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ConversationGetResponse
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ConversationGetResponse
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationGetResponse
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationGetResponse
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationGetResponse
+     */
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
+     * @memberof ConversationGetResponse
+     */
+    'ingress'?: ConversationGetResponseIngressEnum;
+    /**
+     * The client web url of the conversation
+     * @type {string}
+     * @memberof ConversationGetResponse
+     */
+    'clientWebUrl'?: string;
+    /**
+     * The agent web url of the conversation (requires phone two-factor authentication)
+     * @type {string}
+     * @memberof ConversationGetResponse
+     */
+    'agentWebUrl'?: string;
+    /**
+     * The agent test web url of the conversation, used for testing the conversation without notifying the customer
+     * @type {string}
+     * @memberof ConversationGetResponse
+     */
+    'agentTestWebUrl'?: string;
 }
 
+export const ConversationGetResponseLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ConversationGetResponseLockCodeEnum = typeof ConversationGetResponseLockCodeEnum[keyof typeof ConversationGetResponseLockCodeEnum];
+export const ConversationGetResponseIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ConversationGetResponseIngressEnum = typeof ConversationGetResponseIngressEnum[keyof typeof ConversationGetResponseIngressEnum];
 
 /**
  * 
@@ -1209,12 +1637,30 @@ export interface ConversationScheduleParams {
  * @interface ConversationUpdateRequest
  */
 export interface ConversationUpdateRequest {
+    /**
+     * The ID of the conversation to update
+     * @type {string}
+     * @memberof ConversationUpdateRequest
+     */
+    '$id': string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ConversationUpdateRequest
+     */
+    '$business'?: string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ConversationUpdateRequest
      */
     '$agent'?: string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ConversationUpdateRequest
+     */
+    '$customer'?: string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -1223,17 +1669,126 @@ export interface ConversationUpdateRequest {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
      * @memberof ConversationUpdateRequest
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'channel'?: ConversationChannel;
     /**
-     * The ID of the conversation to update
+     * 
+     * @type {ConversationChannelProps}
+     * @memberof ConversationUpdateRequest
+     */
+    'channelProps'?: ConversationChannelProps;
+    /**
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
+     * @memberof ConversationUpdateRequest
+     */
+    'locked'?: boolean | null;
+    /**
+     * Machine-readable lock reason.
      * @type {string}
      * @memberof ConversationUpdateRequest
      */
-    '$id': string;
+    'lockCode'?: ConversationUpdateRequestLockCodeEnum;
+    /**
+     * Human-readable locked reason.
+     * @type {string}
+     * @memberof ConversationUpdateRequest
+     */
+    'lockedReason'?: string | null;
+    /**
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
+     * @memberof ConversationUpdateRequest
+     */
+    'lockAttempts'?: number | null;
+    /**
+     * Contact that received a forward handoff.
+     * @type {string}
+     * @memberof ConversationUpdateRequest
+     */
+    'forwardedTo'?: string | null;
+    /**
+     * ISO 8601 datetime string for when the conversation was forwarded.
+     * @type {string}
+     * @memberof ConversationUpdateRequest
+     */
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
+     * @memberof ConversationUpdateRequest
+     */
+    'forwardNote'?: string | null;
+    /**
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof ConversationUpdateRequest
+     */
+    'initiated'?: string;
+    /**
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
+     * @memberof ConversationUpdateRequest
+     */
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ConversationUpdateRequest
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ConversationUpdateRequest
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationUpdateRequest
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationUpdateRequest
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationUpdateRequest
+     */
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
+     * @memberof ConversationUpdateRequest
+     */
+    'ingress'?: ConversationUpdateRequestIngressEnum;
 }
+
+export const ConversationUpdateRequestLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ConversationUpdateRequestLockCodeEnum = typeof ConversationUpdateRequestLockCodeEnum[keyof typeof ConversationUpdateRequestLockCodeEnum];
+export const ConversationUpdateRequestIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ConversationUpdateRequestIngressEnum = typeof ConversationUpdateRequestIngressEnum[keyof typeof ConversationUpdateRequestIngressEnum];
+
 /**
  * 
  * @export
@@ -1303,12 +1858,30 @@ export interface ConversationUrls {
  * @interface ConversationWithId
  */
 export interface ConversationWithId {
+    /**
+     * The ID of the conversation
+     * @type {string}
+     * @memberof ConversationWithId
+     */
+    '$id': string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ConversationWithId
+     */
+    '$business': string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ConversationWithId
      */
     '$agent': string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ConversationWithId
+     */
+    '$customer': string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -1317,43 +1890,125 @@ export interface ConversationWithId {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
      * @memberof ConversationWithId
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'channel': ConversationChannel;
     /**
-     * User for this conversation
+     * 
+     * @type {ConversationChannelProps}
+     * @memberof ConversationWithId
+     */
+    'channelProps'?: ConversationChannelProps;
+    /**
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
+     * @memberof ConversationWithId
+     */
+    'locked'?: boolean | null;
+    /**
+     * Machine-readable lock reason.
      * @type {string}
      * @memberof ConversationWithId
      */
-    '$user': string;
+    'lockCode'?: ConversationWithIdLockCodeEnum;
     /**
-     * Customer this conversation is with (use $user instead)
+     * Human-readable locked reason.
      * @type {string}
      * @memberof ConversationWithId
-     * @deprecated
      */
-    '$customer'?: string;
+    'lockedReason'?: string | null;
     /**
-     * 
-     * @type {ConversationEnvironment}
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
      * @memberof ConversationWithId
      */
-    'environment': ConversationEnvironment;
+    'lockAttempts'?: number | null;
     /**
-     * Whether this conversation is a test or not
-     * @type {boolean}
+     * Contact that received a forward handoff.
+     * @type {string}
      * @memberof ConversationWithId
      */
-    'test'?: boolean;
+    'forwardedTo'?: string | null;
     /**
-     * The ID of the conversation
+     * ISO 8601 datetime string for when the conversation was forwarded.
      * @type {string}
      * @memberof ConversationWithId
      */
-    '$id': string;
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
+     * @memberof ConversationWithId
+     */
+    'forwardNote'?: string | null;
+    /**
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof ConversationWithId
+     */
+    'initiated'?: string;
+    /**
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
+     * @memberof ConversationWithId
+     */
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ConversationWithId
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ConversationWithId
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationWithId
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationWithId
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof ConversationWithId
+     */
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
+     * @memberof ConversationWithId
+     */
+    'ingress'?: ConversationWithIdIngressEnum;
 }
 
+export const ConversationWithIdLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ConversationWithIdLockCodeEnum = typeof ConversationWithIdLockCodeEnum[keyof typeof ConversationWithIdLockCodeEnum];
+export const ConversationWithIdIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ConversationWithIdIngressEnum = typeof ConversationWithIdIngressEnum[keyof typeof ConversationWithIdIngressEnum];
 
 /**
  * 
@@ -1928,10 +2583,10 @@ export interface CustomerGroupRecord {
     'id': string;
     /**
      * 
-     * @type {ConversationEnvironment}
+     * @type {ConversationChannel}
      * @memberof CustomerGroupRecord
      */
-    'environment': ConversationEnvironment;
+    'channel': ConversationChannel;
     /**
      * Overrides the default $agent for this customer
      * @type {string}
@@ -3332,66 +3987,89 @@ export interface ListApiOperationsResponseInnerAllOf {
  */
 export interface ListConversationsResponseInner {
     /**
-     * Default agent persona id assigned to the conversation(s)
+     * The ID of the conversation
      * @type {string}
      * @memberof ListConversationsResponseInner
      */
-    '$agent': string;
+    '$id': string;
     /**
-     * Initial contexts to load when starting the conversation
-     * @type {Array<string>}
+     * Business/organization this conversation belongs to
+     * @type {string}
      * @memberof ListConversationsResponseInner
      */
-    'initialContexts'?: Array<string>;
+    '$business': string;
     /**
-     * 
-     * @type {ConversationBaseEnvironmentProps}
+     * Default agent persona id assigned to the conversation(s)
+     * @type {string}
      * @memberof ListConversationsResponseInner
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    '$agent': string;
     /**
-     * User for this conversation
+     * Customer this conversation is with
      * @type {string}
      * @memberof ListConversationsResponseInner
      */
-    '$user': string;
+    '$customer': string;
     /**
-     * Customer this conversation is with (use $user instead)
-     * @type {string}
+     * Initial contexts to load when starting the conversation
+     * @type {Array<string>}
      * @memberof ListConversationsResponseInner
-     * @deprecated
      */
-    '$customer'?: string;
+    'initialContexts'?: Array<string>;
+    /**
+     * 
+     * @type {ConversationChannel}
+     * @memberof ListConversationsResponseInner
+     */
+    'channel': ConversationChannel;
     /**
      * 
-     * @type {ConversationEnvironment}
+     * @type {ConversationChannelProps}
      * @memberof ListConversationsResponseInner
      */
-    'environment': ConversationEnvironment;
+    'channelProps'?: ConversationChannelProps;
     /**
-     * Whether this conversation is a test or not
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
      * @type {boolean}
      * @memberof ListConversationsResponseInner
      */
-    'test'?: boolean;
+    'locked'?: boolean | null;
     /**
-     * The client web url of the conversation
+     * Machine-readable lock reason.
      * @type {string}
      * @memberof ListConversationsResponseInner
      */
-    'clientWebUrl'?: string;
+    'lockCode'?: ListConversationsResponseInnerLockCodeEnum;
     /**
-     * The agent web url of the conversation (requires phone two-factor authentication)
+     * Human-readable locked reason.
      * @type {string}
      * @memberof ListConversationsResponseInner
      */
-    'agentWebUrl'?: string;
+    'lockedReason'?: string | null;
     /**
-     * The agent test web url of the conversation, used for testing the conversation without notifying the customer
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
+     * @memberof ListConversationsResponseInner
+     */
+    'lockAttempts'?: number | null;
+    /**
+     * Contact that received a forward handoff.
      * @type {string}
      * @memberof ListConversationsResponseInner
      */
-    'agentTestWebUrl'?: string;
+    'forwardedTo'?: string | null;
+    /**
+     * ISO 8601 datetime string for when the conversation was forwarded.
+     * @type {string}
+     * @memberof ListConversationsResponseInner
+     */
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
+     * @memberof ListConversationsResponseInner
+     */
+    'forwardNote'?: string | null;
     /**
      * ISO 8601 date string of when the conversation was initiated
      * @type {string}
@@ -3399,13 +4077,84 @@ export interface ListConversationsResponseInner {
      */
     'initiated': string;
     /**
-     * The ID of the conversation
+     * Detected intent attached at conversation start or first customer message.
      * @type {string}
      * @memberof ListConversationsResponseInner
      */
-    '$id': string;
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ListConversationsResponseInner
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ListConversationsResponseInner
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ListConversationsResponseInner
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ListConversationsResponseInner
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof ListConversationsResponseInner
+     */
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
+     * @memberof ListConversationsResponseInner
+     */
+    'ingress'?: ListConversationsResponseInnerIngressEnum;
+    /**
+     * The client web url of the conversation
+     * @type {string}
+     * @memberof ListConversationsResponseInner
+     */
+    'clientWebUrl'?: string;
+    /**
+     * The agent web url of the conversation (requires phone two-factor authentication)
+     * @type {string}
+     * @memberof ListConversationsResponseInner
+     */
+    'agentWebUrl'?: string;
+    /**
+     * The agent test web url of the conversation, used for testing the conversation without notifying the customer
+     * @type {string}
+     * @memberof ListConversationsResponseInner
+     */
+    'agentTestWebUrl'?: string;
 }
 
+export const ListConversationsResponseInnerLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ListConversationsResponseInnerLockCodeEnum = typeof ListConversationsResponseInnerLockCodeEnum[keyof typeof ListConversationsResponseInnerLockCodeEnum];
+export const ListConversationsResponseInnerIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ListConversationsResponseInnerIngressEnum = typeof ListConversationsResponseInnerIngressEnum[keyof typeof ListConversationsResponseInnerIngressEnum];
 
 /**
  * 
@@ -5412,10 +6161,10 @@ export interface MessageCreateRequestConvoOneOf {
     'agentIdOrPhoneOrEmail'?: string;
     /**
      * 
-     * @type {ConversationEnvironment}
+     * @type {ConversationChannel}
      * @memberof MessageCreateRequestConvoOneOf
      */
-    'environment'?: ConversationEnvironment;
+    'channel'?: ConversationChannel;
 }
 
 
@@ -5962,7 +6711,13 @@ export interface PmtTransformResponse {
      * @type {string}
      * @memberof PmtTransformResponse
      */
-    'message': string;
+    'message'?: string;
+    /**
+     * Formatted persona responses
+     * @type {Array<Message>}
+     * @memberof PmtTransformResponse
+     */
+    'messages'?: Array<Message>;
     /**
      * How confident this message meets the persona\'s own words
      * @type {number}
@@ -6107,12 +6862,30 @@ export interface RegexCondition {
  * @interface ScheduleCreateRequest
  */
 export interface ScheduleCreateRequest {
+    /**
+     * Conversation document id. Public/admin clients may receive this field; middleware does not store it inside the Firestore document body.
+     * @type {string}
+     * @memberof ScheduleCreateRequest
+     */
+    '$id'?: string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ScheduleCreateRequest
+     */
+    '$business': string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ScheduleCreateRequest
      */
     '$agent': string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ScheduleCreateRequest
+     */
+    '$customer': string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -6121,35 +6894,106 @@ export interface ScheduleCreateRequest {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
+     * @memberof ScheduleCreateRequest
+     */
+    'channel': ConversationChannel;
+    /**
+     * 
+     * @type {ConversationChannelProps}
+     * @memberof ScheduleCreateRequest
+     */
+    'channelProps'?: ConversationChannelProps;
+    /**
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
      * @memberof ScheduleCreateRequest
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'locked'?: boolean | null;
     /**
-     * User for this conversation
+     * Machine-readable lock reason.
      * @type {string}
      * @memberof ScheduleCreateRequest
      */
-    '$user': string;
+    'lockCode'?: ScheduleCreateRequestLockCodeEnum;
     /**
-     * Customer this conversation is with (use $user instead)
+     * Human-readable locked reason.
      * @type {string}
      * @memberof ScheduleCreateRequest
-     * @deprecated
      */
-    '$customer'?: string;
+    'lockedReason'?: string | null;
     /**
-     * 
-     * @type {ConversationEnvironment}
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
      * @memberof ScheduleCreateRequest
      */
-    'environment': ConversationEnvironment;
+    'lockAttempts'?: number | null;
     /**
-     * Whether this conversation is a test or not
-     * @type {boolean}
+     * Contact that received a forward handoff.
+     * @type {string}
+     * @memberof ScheduleCreateRequest
+     */
+    'forwardedTo'?: string | null;
+    /**
+     * ISO 8601 datetime string for when the conversation was forwarded.
+     * @type {string}
+     * @memberof ScheduleCreateRequest
+     */
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
+     * @memberof ScheduleCreateRequest
+     */
+    'forwardNote'?: string | null;
+    /**
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof ScheduleCreateRequest
+     */
+    'initiated'?: string;
+    /**
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
+     * @memberof ScheduleCreateRequest
+     */
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ScheduleCreateRequest
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ScheduleCreateRequest
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleCreateRequest
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleCreateRequest
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
      * @memberof ScheduleCreateRequest
      */
-    'test'?: boolean;
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
+     * @memberof ScheduleCreateRequest
+     */
+    'ingress'?: ScheduleCreateRequestIngressEnum;
     /**
      * ISO 8601 datetime string
      * @type {string}
@@ -6176,6 +7020,23 @@ export interface ScheduleCreateRequest {
     '$group'?: string;
 }
 
+export const ScheduleCreateRequestLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ScheduleCreateRequestLockCodeEnum = typeof ScheduleCreateRequestLockCodeEnum[keyof typeof ScheduleCreateRequestLockCodeEnum];
+export const ScheduleCreateRequestIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ScheduleCreateRequestIngressEnum = typeof ScheduleCreateRequestIngressEnum[keyof typeof ScheduleCreateRequestIngressEnum];
 
 /**
  * 
@@ -6227,12 +7088,30 @@ export interface ScheduleCreateResponseAllOf {
  * @interface ScheduleGetResponse
  */
 export interface ScheduleGetResponse {
+    /**
+     * Conversation document id. Public/admin clients may receive this field; middleware does not store it inside the Firestore document body.
+     * @type {string}
+     * @memberof ScheduleGetResponse
+     */
+    '$id'?: string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ScheduleGetResponse
+     */
+    '$business': string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ScheduleGetResponse
      */
     '$agent': string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ScheduleGetResponse
+     */
+    '$customer': string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -6241,35 +7120,106 @@ export interface ScheduleGetResponse {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
+     * @memberof ScheduleGetResponse
+     */
+    'channel': ConversationChannel;
+    /**
+     * 
+     * @type {ConversationChannelProps}
+     * @memberof ScheduleGetResponse
+     */
+    'channelProps'?: ConversationChannelProps;
+    /**
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
      * @memberof ScheduleGetResponse
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'locked'?: boolean | null;
     /**
-     * User for this conversation
+     * Machine-readable lock reason.
      * @type {string}
      * @memberof ScheduleGetResponse
      */
-    '$user': string;
+    'lockCode'?: ScheduleGetResponseLockCodeEnum;
     /**
-     * Customer this conversation is with (use $user instead)
+     * Human-readable locked reason.
      * @type {string}
      * @memberof ScheduleGetResponse
-     * @deprecated
      */
-    '$customer'?: string;
+    'lockedReason'?: string | null;
     /**
-     * 
-     * @type {ConversationEnvironment}
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
      * @memberof ScheduleGetResponse
      */
-    'environment': ConversationEnvironment;
+    'lockAttempts'?: number | null;
     /**
-     * Whether this conversation is a test or not
-     * @type {boolean}
+     * Contact that received a forward handoff.
+     * @type {string}
+     * @memberof ScheduleGetResponse
+     */
+    'forwardedTo'?: string | null;
+    /**
+     * ISO 8601 datetime string for when the conversation was forwarded.
+     * @type {string}
+     * @memberof ScheduleGetResponse
+     */
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
+     * @memberof ScheduleGetResponse
+     */
+    'forwardNote'?: string | null;
+    /**
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof ScheduleGetResponse
+     */
+    'initiated'?: string;
+    /**
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
+     * @memberof ScheduleGetResponse
+     */
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ScheduleGetResponse
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ScheduleGetResponse
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleGetResponse
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleGetResponse
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
      * @memberof ScheduleGetResponse
      */
-    'test'?: boolean;
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
+     * @memberof ScheduleGetResponse
+     */
+    'ingress'?: ScheduleGetResponseIngressEnum;
     /**
      * ISO 8601 datetime string
      * @type {string}
@@ -6314,6 +7264,23 @@ export interface ScheduleGetResponse {
     'agentTestWebUrl'?: string;
 }
 
+export const ScheduleGetResponseLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ScheduleGetResponseLockCodeEnum = typeof ScheduleGetResponseLockCodeEnum[keyof typeof ScheduleGetResponseLockCodeEnum];
+export const ScheduleGetResponseIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ScheduleGetResponseIngressEnum = typeof ScheduleGetResponseIngressEnum[keyof typeof ScheduleGetResponseIngressEnum];
 
 /**
  * 
@@ -6321,12 +7288,30 @@ export interface ScheduleGetResponse {
  * @interface ScheduleGroupCreateRequest
  */
 export interface ScheduleGroupCreateRequest {
+    /**
+     * Conversation document id. Public/admin clients may receive this field; middleware does not store it inside the Firestore document body.
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    '$id'?: string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    '$business'?: string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ScheduleGroupCreateRequest
      */
     '$agent'?: string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    '$customer'?: string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -6335,24 +7320,120 @@ export interface ScheduleGroupCreateRequest {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
      * @memberof ScheduleGroupCreateRequest
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'channel'?: ConversationChannel;
     /**
-     * ISO 8601 datetime string
-     * @type {string}
+     * 
+     * @type {ConversationChannelProps}
      * @memberof ScheduleGroupCreateRequest
      */
-    'scheduled': string;
+    'channelProps'?: ConversationChannelProps;
     /**
-     * The initial message to send to the customer
-     * @type {string}
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
      * @memberof ScheduleGroupCreateRequest
      */
-    'initialMessage': string;
+    'locked'?: boolean | null;
     /**
-     * The initial message to send to the customer in HTML
+     * Machine-readable lock reason.
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'lockCode'?: ScheduleGroupCreateRequestLockCodeEnum;
+    /**
+     * Human-readable locked reason.
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'lockedReason'?: string | null;
+    /**
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'lockAttempts'?: number | null;
+    /**
+     * Contact that received a forward handoff.
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'forwardedTo'?: string | null;
+    /**
+     * ISO 8601 datetime string for when the conversation was forwarded.
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'forwardNote'?: string | null;
+    /**
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'initiated'?: string;
+    /**
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'ingress'?: ScheduleGroupCreateRequestIngressEnum;
+    /**
+     * ISO 8601 datetime string
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'scheduled': string;
+    /**
+     * The initial message to send to the customer
+     * @type {string}
+     * @memberof ScheduleGroupCreateRequest
+     */
+    'initialMessage': string;
+    /**
+     * The initial message to send to the customer in HTML
      * @type {string}
      * @memberof ScheduleGroupCreateRequest
      */
@@ -6370,6 +7451,25 @@ export interface ScheduleGroupCreateRequest {
      */
     '$cGroup': ScheduleGroupCreateRequestAllOfCGroup;
 }
+
+export const ScheduleGroupCreateRequestLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ScheduleGroupCreateRequestLockCodeEnum = typeof ScheduleGroupCreateRequestLockCodeEnum[keyof typeof ScheduleGroupCreateRequestLockCodeEnum];
+export const ScheduleGroupCreateRequestIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ScheduleGroupCreateRequestIngressEnum = typeof ScheduleGroupCreateRequestIngressEnum[keyof typeof ScheduleGroupCreateRequestIngressEnum];
+
 /**
  * 
  * @export
@@ -6420,12 +7520,30 @@ export interface ScheduleGroupCreateResponse {
  * @interface ScheduleGroupGetResponse
  */
 export interface ScheduleGroupGetResponse {
+    /**
+     * The ID of the scheduled conversation group
+     * @type {string}
+     * @memberof ScheduleGroupGetResponse
+     */
+    '$id': string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ScheduleGroupGetResponse
+     */
+    '$business'?: string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ScheduleGroupGetResponse
      */
     '$agent'?: string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ScheduleGroupGetResponse
+     */
+    '$customer'?: string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -6434,10 +7552,106 @@ export interface ScheduleGroupGetResponse {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'channel'?: ConversationChannel;
+    /**
+     * 
+     * @type {ConversationChannelProps}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'channelProps'?: ConversationChannelProps;
+    /**
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'locked'?: boolean | null;
+    /**
+     * Machine-readable lock reason.
+     * @type {string}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'lockCode'?: ScheduleGroupGetResponseLockCodeEnum;
+    /**
+     * Human-readable locked reason.
+     * @type {string}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'lockedReason'?: string | null;
+    /**
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'lockAttempts'?: number | null;
+    /**
+     * Contact that received a forward handoff.
+     * @type {string}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'forwardedTo'?: string | null;
+    /**
+     * ISO 8601 datetime string for when the conversation was forwarded.
+     * @type {string}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'forwardNote'?: string | null;
+    /**
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'initiated'?: string;
+    /**
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleGroupGetResponse
+     */
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
      * @memberof ScheduleGroupGetResponse
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'ingress'?: ScheduleGroupGetResponseIngressEnum;
     /**
      * ISO 8601 datetime string
      * @type {string}
@@ -6462,12 +7676,6 @@ export interface ScheduleGroupGetResponse {
      * @memberof ScheduleGroupGetResponse
      */
     'delay'?: number;
-    /**
-     * The ID of the scheduled conversation group
-     * @type {string}
-     * @memberof ScheduleGroupGetResponse
-     */
-    '$id': string;
     /**
      * ISO Time the initial message has been sent
      * @type {boolean}
@@ -6481,6 +7689,25 @@ export interface ScheduleGroupGetResponse {
      */
     '$cGroup'?: string;
 }
+
+export const ScheduleGroupGetResponseLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ScheduleGroupGetResponseLockCodeEnum = typeof ScheduleGroupGetResponseLockCodeEnum[keyof typeof ScheduleGroupGetResponseLockCodeEnum];
+export const ScheduleGroupGetResponseIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ScheduleGroupGetResponseIngressEnum = typeof ScheduleGroupGetResponseIngressEnum[keyof typeof ScheduleGroupGetResponseIngressEnum];
+
 /**
  * 
  * @export
@@ -6537,12 +7764,30 @@ export interface ScheduleGroupRemoveResponse {
  * @interface ScheduleGroupUpdateRequest
  */
 export interface ScheduleGroupUpdateRequest {
+    /**
+     * The ID of the scheduled conversation group to update
+     * @type {string}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    '$id': string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    '$business'?: string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ScheduleGroupUpdateRequest
      */
     '$agent'?: string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    '$customer'?: string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -6551,10 +7796,106 @@ export interface ScheduleGroupUpdateRequest {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'channel'?: ConversationChannel;
+    /**
+     * 
+     * @type {ConversationChannelProps}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'channelProps'?: ConversationChannelProps;
+    /**
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'locked'?: boolean | null;
+    /**
+     * Machine-readable lock reason.
+     * @type {string}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'lockCode'?: ScheduleGroupUpdateRequestLockCodeEnum;
+    /**
+     * Human-readable locked reason.
+     * @type {string}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'lockedReason'?: string | null;
+    /**
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'lockAttempts'?: number | null;
+    /**
+     * Contact that received a forward handoff.
+     * @type {string}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'forwardedTo'?: string | null;
+    /**
+     * ISO 8601 datetime string for when the conversation was forwarded.
+     * @type {string}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'forwardNote'?: string | null;
+    /**
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'initiated'?: string;
+    /**
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleGroupUpdateRequest
+     */
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
      * @memberof ScheduleGroupUpdateRequest
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'ingress'?: ScheduleGroupUpdateRequestIngressEnum;
     /**
      * ISO 8601 datetime string
      * @type {string}
@@ -6585,13 +7926,26 @@ export interface ScheduleGroupUpdateRequest {
      * @memberof ScheduleGroupUpdateRequest
      */
     '$cGroup'?: ScheduleGroupCreateRequestAllOfCGroup;
-    /**
-     * The ID of the scheduled conversation group to update
-     * @type {string}
-     * @memberof ScheduleGroupUpdateRequest
-     */
-    '$id': string;
 }
+
+export const ScheduleGroupUpdateRequestLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ScheduleGroupUpdateRequestLockCodeEnum = typeof ScheduleGroupUpdateRequestLockCodeEnum[keyof typeof ScheduleGroupUpdateRequestLockCodeEnum];
+export const ScheduleGroupUpdateRequestIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ScheduleGroupUpdateRequestIngressEnum = typeof ScheduleGroupUpdateRequestIngressEnum[keyof typeof ScheduleGroupUpdateRequestIngressEnum];
+
 /**
  * 
  * @export
@@ -6667,12 +8021,30 @@ export interface ScheduleRemoveResponse {
  * @interface ScheduleUpdateRequest
  */
 export interface ScheduleUpdateRequest {
+    /**
+     * The ID of the scheduled conversation to update
+     * @type {string}
+     * @memberof ScheduleUpdateRequest
+     */
+    '$id'?: string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ScheduleUpdateRequest
+     */
+    '$business': string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ScheduleUpdateRequest
      */
     '$agent': string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ScheduleUpdateRequest
+     */
+    '$customer': string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -6681,35 +8053,106 @@ export interface ScheduleUpdateRequest {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
+     * @memberof ScheduleUpdateRequest
+     */
+    'channel': ConversationChannel;
+    /**
+     * 
+     * @type {ConversationChannelProps}
      * @memberof ScheduleUpdateRequest
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'channelProps'?: ConversationChannelProps;
     /**
-     * User for this conversation
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
+     * @memberof ScheduleUpdateRequest
+     */
+    'locked'?: boolean | null;
+    /**
+     * Machine-readable lock reason.
      * @type {string}
      * @memberof ScheduleUpdateRequest
      */
-    '$user': string;
+    'lockCode'?: ScheduleUpdateRequestLockCodeEnum;
     /**
-     * Customer this conversation is with (use $user instead)
+     * Human-readable locked reason.
      * @type {string}
      * @memberof ScheduleUpdateRequest
-     * @deprecated
      */
-    '$customer'?: string;
+    'lockedReason'?: string | null;
     /**
-     * 
-     * @type {ConversationEnvironment}
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
      * @memberof ScheduleUpdateRequest
      */
-    'environment': ConversationEnvironment;
+    'lockAttempts'?: number | null;
     /**
-     * Whether this conversation is a test or not
-     * @type {boolean}
+     * Contact that received a forward handoff.
+     * @type {string}
+     * @memberof ScheduleUpdateRequest
+     */
+    'forwardedTo'?: string | null;
+    /**
+     * ISO 8601 datetime string for when the conversation was forwarded.
+     * @type {string}
+     * @memberof ScheduleUpdateRequest
+     */
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
      * @memberof ScheduleUpdateRequest
      */
-    'test'?: boolean;
+    'forwardNote'?: string | null;
+    /**
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof ScheduleUpdateRequest
+     */
+    'initiated'?: string;
+    /**
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
+     * @memberof ScheduleUpdateRequest
+     */
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ScheduleUpdateRequest
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ScheduleUpdateRequest
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleUpdateRequest
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleUpdateRequest
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduleUpdateRequest
+     */
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
+     * @memberof ScheduleUpdateRequest
+     */
+    'ingress'?: ScheduleUpdateRequestIngressEnum;
     /**
      * ISO 8601 datetime string
      * @type {string}
@@ -6734,14 +8177,25 @@ export interface ScheduleUpdateRequest {
      * @memberof ScheduleUpdateRequest
      */
     '$group'?: string;
-    /**
-     * The ID of the scheduled conversation to update
-     * @type {string}
-     * @memberof ScheduleUpdateRequest
-     */
-    '$id'?: string;
 }
 
+export const ScheduleUpdateRequestLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ScheduleUpdateRequestLockCodeEnum = typeof ScheduleUpdateRequestLockCodeEnum[keyof typeof ScheduleUpdateRequestLockCodeEnum];
+export const ScheduleUpdateRequestIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ScheduleUpdateRequestIngressEnum = typeof ScheduleUpdateRequestIngressEnum[keyof typeof ScheduleUpdateRequestIngressEnum];
 
 /**
  * 
@@ -6787,12 +8241,30 @@ export interface ScheduleUpdateResponse {
  * @interface ScheduledConversation
  */
 export interface ScheduledConversation {
+    /**
+     * Conversation document id. Public/admin clients may receive this field; middleware does not store it inside the Firestore document body.
+     * @type {string}
+     * @memberof ScheduledConversation
+     */
+    '$id'?: string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ScheduledConversation
+     */
+    '$business': string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ScheduledConversation
      */
     '$agent': string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ScheduledConversation
+     */
+    '$customer': string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -6801,35 +8273,106 @@ export interface ScheduledConversation {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
+     * @memberof ScheduledConversation
+     */
+    'channel': ConversationChannel;
+    /**
+     * 
+     * @type {ConversationChannelProps}
      * @memberof ScheduledConversation
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'channelProps'?: ConversationChannelProps;
     /**
-     * User for this conversation
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
+     * @memberof ScheduledConversation
+     */
+    'locked'?: boolean | null;
+    /**
+     * Machine-readable lock reason.
      * @type {string}
      * @memberof ScheduledConversation
      */
-    '$user': string;
+    'lockCode'?: ScheduledConversationLockCodeEnum;
     /**
-     * Customer this conversation is with (use $user instead)
+     * Human-readable locked reason.
      * @type {string}
      * @memberof ScheduledConversation
-     * @deprecated
      */
-    '$customer'?: string;
+    'lockedReason'?: string | null;
     /**
-     * 
-     * @type {ConversationEnvironment}
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
      * @memberof ScheduledConversation
      */
-    'environment': ConversationEnvironment;
+    'lockAttempts'?: number | null;
     /**
-     * Whether this conversation is a test or not
-     * @type {boolean}
+     * Contact that received a forward handoff.
+     * @type {string}
      * @memberof ScheduledConversation
      */
-    'test'?: boolean;
+    'forwardedTo'?: string | null;
+    /**
+     * ISO 8601 datetime string for when the conversation was forwarded.
+     * @type {string}
+     * @memberof ScheduledConversation
+     */
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
+     * @memberof ScheduledConversation
+     */
+    'forwardNote'?: string | null;
+    /**
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof ScheduledConversation
+     */
+    'initiated'?: string;
+    /**
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
+     * @memberof ScheduledConversation
+     */
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ScheduledConversation
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ScheduledConversation
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduledConversation
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduledConversation
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduledConversation
+     */
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
+     * @memberof ScheduledConversation
+     */
+    'ingress'?: ScheduledConversationIngressEnum;
     /**
      * ISO 8601 datetime string
      * @type {string}
@@ -6856,6 +8399,23 @@ export interface ScheduledConversation {
     '$group'?: string;
 }
 
+export const ScheduledConversationLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ScheduledConversationLockCodeEnum = typeof ScheduledConversationLockCodeEnum[keyof typeof ScheduledConversationLockCodeEnum];
+export const ScheduledConversationIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ScheduledConversationIngressEnum = typeof ScheduledConversationIngressEnum[keyof typeof ScheduledConversationIngressEnum];
 
 /**
  * 
@@ -6876,12 +8436,30 @@ export interface ScheduledConversationAllOf {
  * @interface ScheduledConversationGroup
  */
 export interface ScheduledConversationGroup {
+    /**
+     * Conversation document id. Public/admin clients may receive this field; middleware does not store it inside the Firestore document body.
+     * @type {string}
+     * @memberof ScheduledConversationGroup
+     */
+    '$id'?: string;
+    /**
+     * Business/organization this conversation belongs to
+     * @type {string}
+     * @memberof ScheduledConversationGroup
+     */
+    '$business'?: string;
     /**
      * Default agent persona id assigned to the conversation(s)
      * @type {string}
      * @memberof ScheduledConversationGroup
      */
     '$agent'?: string;
+    /**
+     * Customer this conversation is with
+     * @type {string}
+     * @memberof ScheduledConversationGroup
+     */
+    '$customer'?: string;
     /**
      * Initial contexts to load when starting the conversation
      * @type {Array<string>}
@@ -6890,10 +8468,106 @@ export interface ScheduledConversationGroup {
     'initialContexts'?: Array<string>;
     /**
      * 
-     * @type {ConversationBaseEnvironmentProps}
+     * @type {ConversationChannel}
+     * @memberof ScheduledConversationGroup
+     */
+    'channel'?: ConversationChannel;
+    /**
+     * 
+     * @type {ConversationChannelProps}
+     * @memberof ScheduledConversationGroup
+     */
+    'channelProps'?: ConversationChannelProps;
+    /**
+     * Whether automated replies are locked and the conversation requires a policy outcome or manual intervention.
+     * @type {boolean}
+     * @memberof ScheduledConversationGroup
+     */
+    'locked'?: boolean | null;
+    /**
+     * Machine-readable lock reason.
+     * @type {string}
+     * @memberof ScheduledConversationGroup
+     */
+    'lockCode'?: ScheduledConversationGroupLockCodeEnum;
+    /**
+     * Human-readable locked reason.
+     * @type {string}
+     * @memberof ScheduledConversationGroup
+     */
+    'lockedReason'?: string | null;
+    /**
+     * Number of consecutive workflow/context no-progress attempts.
+     * @type {number}
+     * @memberof ScheduledConversationGroup
+     */
+    'lockAttempts'?: number | null;
+    /**
+     * Contact that received a forward handoff.
+     * @type {string}
+     * @memberof ScheduledConversationGroup
+     */
+    'forwardedTo'?: string | null;
+    /**
+     * ISO 8601 datetime string for when the conversation was forwarded.
+     * @type {string}
+     * @memberof ScheduledConversationGroup
+     */
+    'forwarded'?: string | null;
+    /**
+     * Operator or workflow note attached to the forward.
+     * @type {string}
+     * @memberof ScheduledConversationGroup
+     */
+    'forwardNote'?: string | null;
+    /**
+     * ISO 8601 datetime string for when this conversation was initiated.
+     * @type {string}
+     * @memberof ScheduledConversationGroup
+     */
+    'initiated'?: string;
+    /**
+     * Detected intent attached at conversation start or first customer message.
+     * @type {string}
      * @memberof ScheduledConversationGroup
      */
-    'environmentProps'?: ConversationBaseEnvironmentProps;
+    'intent'?: string | null;
+    /**
+     * Confidence score for the detected intent.
+     * @type {number}
+     * @memberof ScheduledConversationGroup
+     */
+    'intentScore'?: number | null;
+    /**
+     * ISO 8601 datetime string for when the account user read this conversation in the app.
+     * @type {string}
+     * @memberof ScheduledConversationGroup
+     */
+    'read'?: string;
+    /**
+     * Server-assigned conversation metadata.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduledConversationGroup
+     */
+    'metadata'?: { [key: string]: any; };
+    /**
+     * Metadata for anticipating a preflight response.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduledConversationGroup
+     */
+    'anticipate'?: { [key: string]: any; };
+    /**
+     * Command-flow configuration attached to this conversation.
+     * @type {{ [key: string]: any; }}
+     * @memberof ScheduledConversationGroup
+     */
+    'command'?: { [key: string]: any; };
+    /**
+     * Overrides the Persona Model ingress mode for this conversation.
+     * @type {string}
+     * @memberof ScheduledConversationGroup
+     */
+    'ingress'?: ScheduledConversationGroupIngressEnum;
     /**
      * ISO 8601 datetime string
      * @type {string}
@@ -6919,6 +8593,25 @@ export interface ScheduledConversationGroup {
      */
     'delay'?: number;
 }
+
+export const ScheduledConversationGroupLockCodeEnum = {
+    WorkflowStagnation: 'workflow_stagnation',
+    MaxLockAttempts: 'max_lock_attempts',
+    RuntimeError: 'runtime_error',
+    ManualMode: 'manual_mode',
+    PolicyBlock: 'policy_block'
+} as const;
+
+export type ScheduledConversationGroupLockCodeEnum = typeof ScheduledConversationGroupLockCodeEnum[keyof typeof ScheduledConversationGroupLockCodeEnum];
+export const ScheduledConversationGroupIngressEnum = {
+    Auto: 'auto',
+    Manual: 'manual',
+    App: 'app',
+    Webhook: 'webhook'
+} as const;
+
+export type ScheduledConversationGroupIngressEnum = typeof ScheduledConversationGroupIngressEnum[keyof typeof ScheduledConversationGroupIngressEnum];
+
 /**
  * 
  * @export