@wildix/wilma-copilot-client 1.0.18 → 1.0.20

package/dist-types/commands/UpdateIntentCommand.d.ts

@@ -41,7 +41,6 @@ declare const UpdateIntentCommand_base: {
  *   description: "STRING_VALUE",
  *   handlers: { // IntentHandlers
  *     textMatch: { // IntentTextMatch
- *       enabled: true || false, // required
  *       options: [ // IntentTextMatchOptionsList
  *         { // IntentTextMatchOption
  *           id: "STRING_VALUE", // required
@@ -51,7 +50,6 @@ declare const UpdateIntentCommand_base: {
  *       ],
  *     },
  *     aiMatch: { // IntentAiMatch
- *       enabled: true || false, // required
  *       instructions: "STRING_VALUE",
  *       fields: [ // CopilotFieldsList
  *         { // CopilotField
@@ -88,6 +86,7 @@ declare const UpdateIntentCommand_base: {
  *         },
  *       ],
  *     },
+ *     saidBy: "anyone" || "agent" || "customer",
  *   },
  *   conditions: "DOCUMENT_VALUE",
  *   company: "STRING_VALUE",
@@ -102,7 +101,6 @@ declare const UpdateIntentCommand_base: {
  * //     description: "STRING_VALUE",
  * //     handlers: { // IntentHandlers
  * //       textMatch: { // IntentTextMatch
- * //         enabled: true || false, // required
  * //         options: [ // IntentTextMatchOptionsList
  * //           { // IntentTextMatchOption
  * //             id: "STRING_VALUE", // required
@@ -112,7 +110,6 @@ declare const UpdateIntentCommand_base: {
  * //         ],
  * //       },
  * //       aiMatch: { // IntentAiMatch
- * //         enabled: true || false, // required
  * //         instructions: "STRING_VALUE",
  * //         fields: [ // CopilotFieldsList
  * //           { // CopilotField
@@ -149,6 +146,7 @@ declare const UpdateIntentCommand_base: {
  * //           },
  * //         ],
  * //       },
+ * //       saidBy: "anyone" || "agent" || "customer",
  * //     },
  * //     conditions: "DOCUMENT_VALUE",
  * //     createdAt: "STRING_VALUE", // required

package/dist-types/commands/UpdateProfileCommand.d.ts

@@ -39,17 +39,21 @@ declare const UpdateProfileCommand_base: {
  * const input = { // UpdateProfileInput
  *   name: "STRING_VALUE", // required
  *   description: "STRING_VALUE",
- *   channel: "calls" || "chats" || "any", // required
+ *   audience: [ // CopilotAudienceList
+ *     { // CopilotAudienceEntry
+ *       kind: "user" || "group" || "department" || "agent" || "queue" || "service" || "trunk", // required
+ *       values: [ // StringList // required
+ *         "STRING_VALUE",
+ *       ],
+ *     },
+ *   ],
+ *   stages: [ // CopilotStageList
+ *     "before" || "during" || "after",
+ *   ],
+ *   channels: [ // CopilotChannelList
+ *     "call" || "conference" || "chat",
+ *   ],
  *   conditions: "DOCUMENT_VALUE",
- *   access: { // CopilotAccess
- *     visibility: "explicit" || "organization",
- *     grants: [ // CopilotGrantPrincipalList
- *       { // CopilotGrantPrincipal Union: only one key present
- *         userId: "STRING_VALUE",
- *         groupId: "STRING_VALUE",
- *       },
- *     ],
- *   },
  *   company: "STRING_VALUE",
  *   profileId: "STRING_VALUE", // required
  *   revision: Number("int"), // required
@@ -60,17 +64,21 @@ declare const UpdateProfileCommand_base: {
  * //   profile: { // Profile
  * //     name: "STRING_VALUE", // required
  * //     description: "STRING_VALUE",
- * //     channel: "calls" || "chats" || "any", // required
+ * //     audience: [ // CopilotAudienceList
+ * //       { // CopilotAudienceEntry
+ * //         kind: "user" || "group" || "department" || "agent" || "queue" || "service" || "trunk", // required
+ * //         values: [ // StringList // required
+ * //           "STRING_VALUE",
+ * //         ],
+ * //       },
+ * //     ],
+ * //     stages: [ // CopilotStageList
+ * //       "before" || "during" || "after",
+ * //     ],
+ * //     channels: [ // CopilotChannelList
+ * //       "call" || "conference" || "chat",
+ * //     ],
  * //     conditions: "DOCUMENT_VALUE",
- * //     access: { // CopilotAccess
- * //       visibility: "explicit" || "organization",
- * //       grants: [ // CopilotGrantPrincipalList
- * //         { // CopilotGrantPrincipal Union: only one key present
- * //           userId: "STRING_VALUE",
- * //           groupId: "STRING_VALUE",
- * //         },
- * //       ],
- * //     },
  * //     features: [ // CopilotFeaturesList
  * //       { // CopilotFeature Union: only one key present
  * //         csat: {},

package/dist-types/commands/index.d.ts

@@ -23,6 +23,7 @@ export * from "./ListEvaluationsCommand";
 export * from "./ListIntentsCommand";
 export * from "./ListProfileVersionsCommand";
 export * from "./ListProfilesCommand";
+export * from "./ListSubscriptionsCommand";
 export * from "./PublishProfileVersionCommand";
 export * from "./RestoreProfileVersionToDraftCommand";
 export * from "./UpdateAssetCommand";

package/dist-types/models/enums.d.ts

@@ -153,33 +153,51 @@ export type ContextualKnowledgeSource = (typeof ContextualKnowledgeSource)[keyof
  * @public
  * @enum
  */
-export declare const CopilotVisibility: {
+export declare const CopilotAudienceKind: {
     /**
-     * Only the users and groups listed in `grants` are assisted by the profile.
+     * A Wilma AI agent handling the conversation itself, by `wildix.wilma.agents#AgentId`.
      */
-    readonly EXPLICIT: "explicit";
+    readonly AGENT: "agent";
+    readonly DEPARTMENT: "department";
+    readonly GROUP: "group";
+    readonly QUEUE: "queue";
+    readonly SERVICE: "service";
+    readonly TRUNK: "trunk";
     /**
-     * Everyone in the organization is assisted by the profile.
+     * A person, by email.
      */
-    readonly ORGANIZATION: "organization";
+    readonly USER: "user";
 };
 /**
  * @public
  */
-export type CopilotVisibility = (typeof CopilotVisibility)[keyof typeof CopilotVisibility];
+export type CopilotAudienceKind = (typeof CopilotAudienceKind)[keyof typeof CopilotAudienceKind];
 /**
  * @public
  * @enum
  */
 export declare const CopilotChannel: {
-    readonly ANY: "any";
-    readonly CALLS: "calls";
-    readonly CHATS: "chats";
+    readonly CALL: "call";
+    readonly CHAT: "chat";
+    readonly CONFERENCE: "conference";
 };
 /**
  * @public
  */
 export type CopilotChannel = (typeof CopilotChannel)[keyof typeof CopilotChannel];
+/**
+ * @public
+ * @enum
+ */
+export declare const CopilotStage: {
+    readonly AFTER: "after";
+    readonly BEFORE: "before";
+    readonly DURING: "during";
+};
+/**
+ * @public
+ */
+export type CopilotStage = (typeof CopilotStage)[keyof typeof CopilotStage];
 /**
  * @public
  * @enum
@@ -198,6 +216,19 @@ export declare const ProfileStatus: {
  * @public
  */
 export type ProfileStatus = (typeof ProfileStatus)[keyof typeof ProfileStatus];
+/**
+ * @public
+ * @enum
+ */
+export declare const CopilotSpeaker: {
+    readonly AGENT: "agent";
+    readonly ANYONE: "anyone";
+    readonly CUSTOMER: "customer";
+};
+/**
+ * @public
+ */
+export type CopilotSpeaker = (typeof CopilotSpeaker)[keyof typeof CopilotSpeaker];
 /**
  * @public
  * @enum

package/dist-types/models/models_0.d.ts

@@ -1,5 +1,5 @@
 import type { DocumentType as __DocumentType } from "@smithy/types";
-import type { ActorType, AssetContentType, AssetIcon, AssetSeverity, AutomationOutputMode, ContextualKnowledgeMode, ContextualKnowledgeSource, CopilotChannel, CopilotVariableMode, CopilotVisibility, EvaluationWindow, IntentTextMatchMode, ProfileResourceType, ProfileStatus, SmartActionHandoverVariant, SmartActionResultMode } from "./enums";
+import type { ActorType, AssetContentType, AssetIcon, AssetSeverity, AutomationOutputMode, ContextualKnowledgeMode, ContextualKnowledgeSource, CopilotAudienceKind, CopilotChannel, CopilotSpeaker, CopilotStage, CopilotVariableMode, EvaluationWindow, IntentTextMatchMode, ProfileResourceType, ProfileStatus, SmartActionHandoverVariant, SmartActionResultMode } from "./enums";
 /**
  * Who performed an action: an interactive user, an API key or an internal service.
  * @public
@@ -17,6 +17,39 @@ export interface Actor {
      */
     name?: string | undefined;
 }
+/**
+ * One event type a tenant needs delivered, and the optional prefilter that narrows it.
+ * @public
+ */
+export interface SubscriptionSelector {
+    /**
+     * A wda-stream event type, as the webhook envelope names it, e.g. 'call:live:progress',
+     *     'call:live:transcription', 'call:completed', 'call:summary:completed', 'chat:live:progress',
+     *     'conference:live:transcription'. Open-ended: a new wda-stream type needs no model change here.
+     * @public
+     */
+    event: string;
+    /**
+     * Producer-side prefilter over the event payload. Omitted means send every occurrence. See SubscriptionConditions.
+     * @public
+     */
+    conditions?: __DocumentType | undefined;
+}
+/**
+ * What one tenant needs delivered to the service's queue.
+ * @public
+ */
+export interface Subscription {
+    company: string;
+    /**
+     * Event types one tenant needs, deduplicated across everything that asked for them. Two
+     *     selectors never name the same event type: a type wanted both unconditionally and under
+     *     conditions is returned once, unconditional — the union of what the tenant's configuration
+     *     requires.
+     * @public
+     */
+    selectors: SubscriptionSelector[];
+}
 /**
  * Binds an input variable of an agent or tool invocation to a value or a fill strategy.
  * @public
@@ -877,57 +910,27 @@ export interface AttachProfileResourceInput {
     resource: ProfileResource;
 }
 /**
- * A user or group access is granted to.
- * @public
- */
-export type CopilotGrantPrincipal = CopilotGrantPrincipal.GroupIdMember | CopilotGrantPrincipal.UserIdMember | CopilotGrantPrincipal.$UnknownMember;
-/**
+ * One audience entry: a kind, and the values of that kind the profile assists. An entry with no values does not narrow anything.
  * @public
  */
-export declare namespace CopilotGrantPrincipal {
-    interface UserIdMember {
-        userId: string;
-        groupId?: never;
-        $unknown?: never;
-    }
-    interface GroupIdMember {
-        userId?: never;
-        groupId: string;
-        $unknown?: never;
-    }
+export interface CopilotAudienceEntry {
     /**
-     * @public
-     */
-    interface $UnknownMember {
-        userId?: never;
-        groupId?: never;
-        $unknown: [string, any];
-    }
-    /**
-     * @deprecated unused in schema-serde mode.
+     * The kind of thing a profile is aimed at.
      *
-     */
-    interface Visitor<T> {
-        userId: (value: string) => T;
-        groupId: (value: string) => T;
-        _: (name: string, value: any) => T;
-    }
-}
-/**
- * Who the profile assists. There is no view/edit dimension — editing is gated by API auth scopes.
- * @public
- */
-export interface CopilotAccess {
-    /**
-     * Usage scope. Defaults to `organization`.
-     * @public
-     */
-    visibility?: CopilotVisibility | undefined;
-    /**
-     * Users and groups assisted by the profile. Applies when visibility is `explicit`.
+     *     Two families, and the difference decides which stages the entry can constrain.
+     *     `user`, `group`, `department` and `agent` name **who is assisted** - a person for the first
+     *     three, a Wilma AI agent for the last - and in the `before` stage the assisted party is
+     *     whoever opened copilot, so they constrain every stage. `queue`, `service` and `trunk`
+     *     describe a **live conversation**, which does not exist in `before` - so an entry of those
+     *     kinds says nothing there.
+     *
+     *     Values are the tenant's own routing objects: user emails for `user`, Wilma agent ids for
+     *     `agent`, PBX group and department ids, queue and trunk names as `wda-stream` reports them,
+     *     and x-bees service uris for `service`.
      * @public
      */
-    grants?: CopilotGrantPrincipal[] | undefined;
+    kind: CopilotAudienceKind;
+    values: string[];
 }
 /**
  * The complete configuration of a profile, including draft lifecycle state. Referenced library resources are listed by id; a published version resolves them into an immutable snapshot.
@@ -937,20 +940,34 @@ export interface Profile {
     name: string;
     description?: string | undefined;
     /**
-     * The conversation surface a copilot resource applies to. `calls` targets voice calls, `chats` targets chat conversations, `any` targets both.
+     * Who this profile assists - queues, groups, departments, users, AI agents, chat services
+     *         and trunks. Empty or absent means everyone in the company. This is the profile's primary
+     *         scope: an administrator reaches for "my refunds team", not for a conversation medium,
+     *         and a queue already carries the medium, the skill and the line of business.
      * @public
      */
-    channel: CopilotChannel;
+    audience?: CopilotAudienceEntry[] | undefined;
     /**
-     * Conditions under which the profile matches a conversation. An empty tree always matches.
+     * Stages of a conversation this profile applies in. Empty or absent means every stage.
      * @public
      */
-    conditions?: __DocumentType | undefined;
+    stages?: CopilotStage[] | undefined;
+    /**
+     * Conversation channels this profile applies to. Empty or absent means every channel.
+     *
+     *         Only constrains the `during` and `after` stages - nothing is a call, a conference or a
+     *         chat before it starts - so a profile whose `stages` are `before` alone applies whatever
+     *         this says.
+     * @public
+     */
+    channels?: CopilotChannel[] | undefined;
     /**
-     * Who the profile assists. Defaults to organization-wide.
+     * Conditions under which the profile matches a conversation. An empty tree always matches. Deprecated - see the deprecation note.
+     *
+     * @deprecated (since 2026-08) Profile conditions are resolved once, on the session's first event, so a rule over anything copilot has yet to detect never activates the profile. Use `audience` / `stages` / `channels` for what is known at that moment, and put everything conditional on the assets, intents and automations the profile carries, where conditions are re-evaluated as state changes. Still read for profiles authored before those members existed.
      * @public
      */
-    access?: CopilotAccess | undefined;
+    conditions?: __DocumentType | undefined;
     /**
      * Copilot features enabled for this profile. Each list item is a typed feature and its configuration.
      * @public
@@ -1613,7 +1630,6 @@ export interface CreateEvaluationOutput {
  * @public
  */
 export interface IntentAiMatch {
-    enabled: boolean;
     /**
      * Prompt describing when this intent applies.
      * @public
@@ -1646,11 +1662,13 @@ export interface IntentTextMatchOption {
  * @public
  */
 export interface IntentTextMatch {
-    enabled: boolean;
     options?: IntentTextMatchOption[] | undefined;
 }
 /**
  * The detection handlers for an intent. Text matching is attempted first, then AI matching.
+ *
+ *     An absent handler is a matcher that is off - which is what the `enabled` flag on each
+ *     handler used to say. An intent with neither handler set is never detected.
  * @public
  */
 export interface IntentHandlers {
@@ -1658,12 +1676,19 @@ export interface IntentHandlers {
      * Literal-text matching. Checked before AI matching; a text hit short-circuits semantic evaluation.
      * @public
      */
-    textMatch: IntentTextMatch;
+    textMatch?: IntentTextMatch | undefined;
     /**
      * Semantic (AI) matching. Detects the intent from meaning and extracts structured fields into `intent.<name>.<field>`.
      * @public
      */
-    aiMatch: IntentAiMatch;
+    aiMatch?: IntentAiMatch | undefined;
+    /**
+     * Whose lines both matchers read. Absent means `anyone`, which is how every intent
+     *         behaved before this member existed - matching over the whole transcript, so an intent
+     *         written about the customer also fires on the agent's own paraphrase of it.
+     * @public
+     */
+    saidBy?: CopilotSpeaker | undefined;
 }
 /**
  * The editable definition of an intent.
@@ -1678,6 +1703,9 @@ export interface CreateIntentInput {
     description?: string | undefined;
     /**
      * The detection handlers for an intent. Text matching is attempted first, then AI matching.
+     *
+     *     An absent handler is a matcher that is off - which is what the `enabled` flag on each
+     *     handler used to say. An intent with neither handler set is never detected.
      * @public
      */
     handlers: IntentHandlers;
@@ -1701,6 +1729,9 @@ export interface Intent {
     description?: string | undefined;
     /**
      * The detection handlers for an intent. Text matching is attempted first, then AI matching.
+     *
+     *     An absent handler is a matcher that is off - which is what the `enabled` flag on each
+     *     handler used to say. An intent with neither handler set is never detected.
      * @public
      */
     handlers: IntentHandlers;
@@ -1754,20 +1785,34 @@ export interface CreateProfileInput {
     name: string;
     description?: string | undefined;
     /**
-     * The conversation surface a copilot resource applies to. `calls` targets voice calls, `chats` targets chat conversations, `any` targets both.
+     * Who this profile assists - queues, groups, departments, users, AI agents, chat services
+     *         and trunks. Empty or absent means everyone in the company. This is the profile's primary
+     *         scope: an administrator reaches for "my refunds team", not for a conversation medium,
+     *         and a queue already carries the medium, the skill and the line of business.
      * @public
      */
-    channel: CopilotChannel;
+    audience?: CopilotAudienceEntry[] | undefined;
     /**
-     * Conditions under which the profile matches a conversation. An empty tree always matches.
+     * Stages of a conversation this profile applies in. Empty or absent means every stage.
      * @public
      */
-    conditions?: __DocumentType | undefined;
+    stages?: CopilotStage[] | undefined;
     /**
-     * Who the profile assists. Defaults to organization-wide.
+     * Conversation channels this profile applies to. Empty or absent means every channel.
+     *
+     *         Only constrains the `during` and `after` stages - nothing is a call, a conference or a
+     *         chat before it starts - so a profile whose `stages` are `before` alone applies whatever
+     *         this says.
      * @public
      */
-    access?: CopilotAccess | undefined;
+    channels?: CopilotChannel[] | undefined;
+    /**
+     * Conditions under which the profile matches a conversation. An empty tree always matches. Deprecated - see the deprecation note.
+     *
+     * @deprecated (since 2026-08) Profile conditions are resolved once, on the session's first event, so a rule over anything copilot has yet to detect never activates the profile. Use `audience` / `stages` / `channels` for what is known at that moment, and put everything conditional on the assets, intents and automations the profile carries, where conditions are re-evaluated as state changes. Still read for profiles authored before those members existed.
+     * @public
+     */
+    conditions?: __DocumentType | undefined;
     /**
      * Copilot features enabled for this profile. Each list item is a typed feature and its configuration.
      * @public
@@ -2108,6 +2153,9 @@ export interface IntentSnapshot {
     description?: string | undefined;
     /**
      * The detection handlers for an intent. Text matching is attempted first, then AI matching.
+     *
+     *     An absent handler is a matcher that is off - which is what the `enabled` flag on each
+     *     handler used to say. An intent with neither handler set is never detected.
      * @public
      */
     handlers: IntentHandlers;
@@ -2126,20 +2174,34 @@ export interface ProfileDefinitionSnapshot {
     name: string;
     description?: string | undefined;
     /**
-     * The conversation surface a copilot resource applies to. `calls` targets voice calls, `chats` targets chat conversations, `any` targets both.
+     * Who this profile assists - queues, groups, departments, users, AI agents, chat services
+     *         and trunks. Empty or absent means everyone in the company. This is the profile's primary
+     *         scope: an administrator reaches for "my refunds team", not for a conversation medium,
+     *         and a queue already carries the medium, the skill and the line of business.
      * @public
      */
-    channel: CopilotChannel;
+    audience?: CopilotAudienceEntry[] | undefined;
     /**
-     * Conditions under which the profile matches a conversation. An empty tree always matches.
+     * Stages of a conversation this profile applies in. Empty or absent means every stage.
      * @public
      */
-    conditions?: __DocumentType | undefined;
+    stages?: CopilotStage[] | undefined;
+    /**
+     * Conversation channels this profile applies to. Empty or absent means every channel.
+     *
+     *         Only constrains the `during` and `after` stages - nothing is a call, a conference or a
+     *         chat before it starts - so a profile whose `stages` are `before` alone applies whatever
+     *         this says.
+     * @public
+     */
+    channels?: CopilotChannel[] | undefined;
     /**
-     * Who the profile assists. Defaults to organization-wide.
+     * Conditions under which the profile matches a conversation. An empty tree always matches. Deprecated - see the deprecation note.
+     *
+     * @deprecated (since 2026-08) Profile conditions are resolved once, on the session's first event, so a rule over anything copilot has yet to detect never activates the profile. Use `audience` / `stages` / `channels` for what is known at that moment, and put everything conditional on the assets, intents and automations the profile carries, where conditions are re-evaluated as state changes. Still read for profiles authored before those members existed.
      * @public
      */
-    access?: CopilotAccess | undefined;
+    conditions?: __DocumentType | undefined;
     /**
      * Copilot features enabled for this profile at publish time, including their type-specific configuration.
      * @public
@@ -2241,12 +2303,12 @@ export interface IntentInfo {
     name: string;
     description?: string | undefined;
     /**
-     * Whether literal text matching is enabled.
+     * Whether literal text matching is enabled, i.e. whether `handlers.textMatch` is set.
      * @public
      */
     textMatchEnabled: boolean;
     /**
-     * Whether semantic AI matching is enabled.
+     * Whether semantic AI matching is enabled, i.e. whether `handlers.aiMatch` is set.
      * @public
      */
     aiMatchEnabled: boolean;
@@ -2389,10 +2451,15 @@ export interface ListProfilesInput {
      */
     status?: ProfileStatus | undefined;
     /**
-     * Filter by the conversation surface the profile applies to.
+     * Filter by a conversation channel the profile applies to. A profile with no channels applies to every one, so it matches whatever is asked for here.
      * @public
      */
     channel?: CopilotChannel | undefined;
+    /**
+     * Filter by a stage the profile applies in. A profile with no stages applies in every one, so it matches whatever is asked for here.
+     * @public
+     */
+    stage?: CopilotStage | undefined;
     /**
      * Filter by name or description.
      * @public
@@ -2434,10 +2501,24 @@ export interface ProfileInfo {
     name: string;
     description?: string | undefined;
     /**
-     * The conversation surface a copilot resource applies to. `calls` targets voice calls, `chats` targets chat conversations, `any` targets both.
+     * The profile's targeting, so a list row can say what it applies to without reading the definition.
      * @public
      */
-    channel: CopilotChannel;
+    audience?: CopilotAudienceEntry[] | undefined;
+    /**
+     * Stages a resource applies in. An empty or absent list means every stage.
+     * @public
+     */
+    stages?: CopilotStage[] | undefined;
+    /**
+     * Conversation channels a resource applies to. An empty or absent list means every channel.
+     *
+     *     A channel filter only constrains the `during` and `after` stages: in `before` there is
+     *     nothing to be a call, a conference or a chat, so a resource covering only `before` applies
+     *     whatever this list says.
+     * @public
+     */
+    channels?: CopilotChannel[] | undefined;
     status: ProfileStatus;
     live: boolean;
     /**
@@ -2533,6 +2614,24 @@ export interface ListProfileVersionsOutput {
      */
     nextCursor?: string | undefined;
 }
+/**
+ * @public
+ */
+export interface ListSubscriptionsInput {
+}
+/**
+ * The answer to 'what should I send you': one entry per tenant that needs anything at all, and
+ *     every tenant in one response — the producer holds a single routing table, and a listing it has
+ *     to assemble from several requests is one that can be applied half-built, which is
+ *     indistinguishable from a set of tenants that unsubscribed.
+ *
+ *     A tenant absent from the listing needs nothing, and the producer sends it nothing. Ordering is
+ *     unspecified.
+ * @public
+ */
+export interface ListSubscriptionsOutput {
+    subscriptions: Subscription[];
+}
 /**
  * @public
  */
@@ -2766,6 +2865,9 @@ export interface UpdateIntentInput {
     description?: string | undefined;
     /**
      * The detection handlers for an intent. Text matching is attempted first, then AI matching.
+     *
+     *     An absent handler is a matcher that is off - which is what the `enabled` flag on each
+     *     handler used to say. An intent with neither handler set is never detected.
      * @public
      */
     handlers: IntentHandlers;
@@ -2800,20 +2902,34 @@ export interface UpdateProfileInput {
     name: string;
     description?: string | undefined;
     /**
-     * The conversation surface a copilot resource applies to. `calls` targets voice calls, `chats` targets chat conversations, `any` targets both.
+     * Who this profile assists - queues, groups, departments, users, AI agents, chat services
+     *         and trunks. Empty or absent means everyone in the company. This is the profile's primary
+     *         scope: an administrator reaches for "my refunds team", not for a conversation medium,
+     *         and a queue already carries the medium, the skill and the line of business.
      * @public
      */
-    channel: CopilotChannel;
+    audience?: CopilotAudienceEntry[] | undefined;
     /**
-     * Conditions under which the profile matches a conversation. An empty tree always matches.
+     * Stages of a conversation this profile applies in. Empty or absent means every stage.
      * @public
      */
-    conditions?: __DocumentType | undefined;
+    stages?: CopilotStage[] | undefined;
     /**
-     * Who the profile assists. Defaults to organization-wide.
+     * Conversation channels this profile applies to. Empty or absent means every channel.
+     *
+     *         Only constrains the `during` and `after` stages - nothing is a call, a conference or a
+     *         chat before it starts - so a profile whose `stages` are `before` alone applies whatever
+     *         this says.
+     * @public
+     */
+    channels?: CopilotChannel[] | undefined;
+    /**
+     * Conditions under which the profile matches a conversation. An empty tree always matches. Deprecated - see the deprecation note.
+     *
+     * @deprecated (since 2026-08) Profile conditions are resolved once, on the session's first event, so a rule over anything copilot has yet to detect never activates the profile. Use `audience` / `stages` / `channels` for what is known at that moment, and put everything conditional on the assets, intents and automations the profile carries, where conditions are re-evaluated as state changes. Still read for profiles authored before those members existed.
      * @public
      */
-    access?: CopilotAccess | undefined;
+    conditions?: __DocumentType | undefined;
     company?: string | undefined;
     profileId: string;
     /**