@wildix/wilma-copilot-client 1.0.19 → 1.0.20

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
@@ -910,57 +910,27 @@ export interface AttachProfileResourceInput {
     resource: ProfileResource;
 }
 /**
- * A user or group access is granted to.
+ * 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 type CopilotGrantPrincipal = CopilotGrantPrincipal.GroupIdMember | CopilotGrantPrincipal.UserIdMember | CopilotGrantPrincipal.$UnknownMember;
-/**
- * @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.
@@ -970,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;
     /**
-     * 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
@@ -1646,7 +1630,6 @@ export interface CreateEvaluationOutput {
  * @public
  */
 export interface IntentAiMatch {
-    enabled: boolean;
     /**
      * Prompt describing when this intent applies.
      * @public
@@ -1679,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 {
@@ -1691,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.
@@ -1711,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;
@@ -1734,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;
@@ -1787,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
@@ -2141,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;
@@ -2159,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;
     /**
-     * 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 at publish time, including their type-specific configuration.
      * @public
@@ -2274,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;
@@ -2422,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
@@ -2467,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
+     */
+    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
      */
-    channel: CopilotChannel;
+    channels?: CopilotChannel[] | undefined;
     status: ProfileStatus;
     live: boolean;
     /**
@@ -2817,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;
@@ -2851,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
      */
-    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;
     company?: string | undefined;
     profileId: string;
     /**

package/dist-types/schemas/schemas_0.d.ts

@@ -34,7 +34,7 @@ export declare var CardStaticContent$: StaticStructureSchema;
 export declare var CompareProfileVersionsInput$: StaticStructureSchema;
 export declare var CompareProfileVersionsOutput$: StaticStructureSchema;
 export declare var ContextualKnowledgeAnswersFeatureConfiguration$: StaticStructureSchema;
-export declare var CopilotAccess$: StaticStructureSchema;
+export declare var CopilotAudienceEntry$: StaticStructureSchema;
 export declare var CopilotField$: StaticStructureSchema;
 export declare var CopilotMultilineParameter$: StaticStructureSchema;
 export declare var CopilotNumberParameter$: StaticStructureSchema;
@@ -138,7 +138,6 @@ export declare var AutomationHandler$: StaticUnionSchema;
 export declare var CardContent$: StaticUnionSchema;
 export declare var CopilotFeature$: StaticUnionSchema;
 export declare var CopilotFieldParameter$: StaticUnionSchema;
-export declare var CopilotGrantPrincipal$: StaticUnionSchema;
 export declare var PlaybookCompletionCriteria$: StaticUnionSchema;
 export declare var ProfileResource$: StaticUnionSchema;
 export declare var SmartAction$: StaticUnionSchema;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@wildix/wilma-copilot-client",
     "description": "@wildix/wilma-copilot-client client",
-    "version": "1.0.19",
+    "version": "1.0.20",
     "scripts": {
         "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
         "build:cjs": "tsc -p tsconfig.cjs.json",