@opencx/mcp 1.11.83 → 1.11.85

package/dist/schema.d.ts

@@ -819,6 +819,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/knowledgebase-items": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List knowledge base items
+         * @description List knowledge base items synced from external data sources (website, Confluence, Notion, etc.). Use this to find item ids and inspect their contact-segment restrictions.
+         */
+        get: operations["listKnowledgebaseItems"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/knowledgebase-items/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Update a knowledge base item
+         * @description Update a knowledge base item. Primarily used to set `restricted_to_segments` so the AI only uses the item for contacts in the given segments (empty = all contacts).
+         */
+        put: operations["updateKnowledgebaseItem"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/csat/scores": {
         parameters: {
             query?: never;
@@ -1240,6 +1280,58 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/macros": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List macros
+         * @description List all saved-reply macros for the organization.
+         */
+        get: operations["listMacros"];
+        put?: never;
+        /**
+         * Create a macro
+         * @description Create a new saved-reply macro. Use {{variable}} syntax in content to reference system or custom variables.
+         */
+        post: operations["createMacro"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/macros/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a macro
+         * @description Get a single saved-reply macro by ID.
+         */
+        get: operations["getMacro"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete a macro
+         * @description Permanently delete a saved-reply macro.
+         */
+        delete: operations["deleteMacro"];
+        options?: never;
+        head?: never;
+        /**
+         * Update a macro
+         * @description Partially update a saved-reply macro.
+         */
+        patch: operations["updateMacro"];
+        trace?: never;
+    };
     "/handoff-analytics/events": {
         parameters: {
             query?: never;
@@ -1519,7 +1611,7 @@ export interface paths {
         put?: never;
         /**
          * [Beta] Validate a workflow definition
-         * @description Validate workflow blocks without creating a workflow. Returns validation issues and the list of action types used. Use this before creating or updating a workflow to catch errors early.
+         * @description Validate workflow blocks without creating a workflow. Runs both the structural check and the deep semantic validation the dashboard editor runs on Save (action inputs against each action's input schema, trigger configuration against the trigger's configuration_def). Returns validation issues and the list of action types used. Use this before creating or updating a workflow to catch errors early.
          */
         post: operations["validateWorkflow"];
         delete?: never;
@@ -1543,7 +1635,7 @@ export interface paths {
         put?: never;
         /**
          * [Beta] Create a workflow
-         * @description Create a new workflow. The workflow is created as an inactive draft (version 1). Use the activate endpoint to make it live. Use GET /workflows/definitions to discover available action and trigger types.
+         * @description Create a new workflow. The workflow is created as an inactive draft (version 1). Use the activate endpoint to make it live. Use GET /workflows/definitions to discover available action and trigger types. Rejects definitions that fail deep validation (missing required action inputs or trigger configuration) with a 400 carrying structured issues.
          */
         post: operations["createWorkflow"];
         delete?: never;
@@ -1561,7 +1653,7 @@ export interface paths {
         };
         /**
          * [Beta] Get a workflow
-         * @description Get a specific workflow by its UUID, including its blocks, trigger configuration, and active status.
+         * @description Get a specific workflow by its UUID, including its blocks, trigger configuration, and active status. In companion context (acting user), the user’s unsaved draft — when one exists — is returned as the working copy in place of the latest saved version.
          */
         get: operations["getWorkflow"];
         put?: never;
@@ -1575,7 +1667,7 @@ export interface paths {
         head?: never;
         /**
          * [Beta] Update a workflow (creates a new version)
-         * @description Update a workflow by creating a new version. The new version is created as an inactive draft. Only the provided fields are changed; omitted fields carry over from the current version. Use the activate endpoint to make the new version live.
+         * @description Update a workflow by creating a new version. The new version is created as an inactive draft. Only the provided fields are changed; omitted fields carry over from the current version. Use the activate endpoint to make the new version live. When blocks or trigger fields are provided, the resulting definition must pass deep validation — failures return a 400 with structured issues.
          */
         patch: operations["updateWorkflow"];
         trace?: never;
@@ -1595,7 +1687,7 @@ export interface paths {
         head?: never;
         /**
          * [Beta] Update a workflow draft in place when possible
-         * @description Updates the latest workflow version in place when it is already a draft. If the latest version is active, a new inactive draft version is created instead.
+         * @description Updates the latest workflow version in place when it is a pristine draft (inactive and without recorded non-test runs). If the latest version is active or has real run history, a new inactive draft version is created instead. In companion context (acting user), the edit applies on top of the user’s unsaved editor draft — snapshotting their work-in-progress into the version — and consumes that draft. The resulting definition must pass deep validation when it changes; failures return a 400 with structured issues. Only versions can be activated.
          */
         patch: operations["updateWorkflowDraftAware"];
         trace?: never;
@@ -2004,6 +2096,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/resource-usage/{resource_type}/{resource_id}/conversations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List conversations that used a resource
+         * @description Reverse lookup: list the conversations where a given action, instruction, or KB item was used, newest first. Returns one row per conversation with the reply count, ticket number, last message, and first/last-used timestamps. Defaults to `applied` usage (the resource actually fired); pass `usageKind=available` to see where an instruction was in context but may not have fired.
+         */
+        get: operations["listResourceConversations"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/resource-usage/{resource_type}/{resource_id}/usage-summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get usage counts for a resource
+         * @description Aggregate usage for a given action, instruction, or KB item: distinct sessions and total replies where it was applied, the available counterpart (for instructions, to compute apply-rate), and first/last-used timestamps. Optionally bound by a date range.
+         */
+        get: operations["getResourceUsageSummary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/sequences": {
         parameters: {
             query?: never;
@@ -2458,6 +2590,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/training/{id}/restrictions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Update instruction restrictions
+         * @description Set the contact-segment and/or channel restrictions for an instruction without changing its content. An empty array clears that restriction (available everywhere).
+         */
+        put: operations["updateTrainingRestrictions"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/training/{id}/diff": {
         parameters: {
             query?: never;
@@ -3741,6 +3893,67 @@ export interface components {
             /** Format: date-time */
             before?: string;
         };
+        CreateGroupDto: {
+            name: string;
+            description?: string;
+            is_support_enabled?: boolean;
+            support_office_hours_id?: string | null;
+            /** @enum {string} */
+            support_assignment_strategy?: "least-busy" | "round-robin" | "unassigned";
+        };
+        CreateVocCategoryDto: {
+            name: string;
+            description?: string | null;
+        };
+        UpdateCategoryDto: {
+            name?: string;
+            description?: string | null;
+        };
+        GetVocQueryDto: {
+            /** @description Filter by category name */
+            category?: string | null;
+            status?: ("all" | "unresolved" | "resolved" | "archived") | null;
+            sentiment?: ("angry" | "happy" | "neutral") | null;
+            sortBy?: ("occurrence_count" | "last_seen_at" | "first_seen_at" | "created_at") | null;
+            sortOrder?: ("asc" | "desc") | null;
+            minSessions?: number | null;
+            /** @description Search in insight content */
+            search?: string | null;
+            /** @description Filter by specific team ID or none for unassigned insights */
+            teamId?: (string | "not_assigned" | null) | null;
+            /** @description Filter by insight number */
+            insightNumber?: number | null;
+            /** @description Filter by language */
+            sessionLanguage?: ("az" | "el" | "de" | "fr" | "it" | "es" | "pt" | "nl" | "da" | "sv" | "no" | "fi" | "et" | "is" | "pl" | "cs" | "sk" | "hu" | "ro" | "bg" | "hr" | "sr" | "uk" | "ru" | "tr" | "en" | "zh" | "ja" | "ko" | "hi" | "bn" | "id" | "ms" | "th" | "vi" | "tl" | "ar" | "he" | "fa" | "ur" | "af" | "sw" | "ku" | "ckb" | "kmr") | null;
+            ticketSentiment?: ("angry" | "happy" | "neutral") | null;
+            /** @description Filter by session channel */
+            channel?: components["schemas"]["SessionChannel"] | null;
+            sessionFromDate?: string | null;
+            sessionToDate?: string | null;
+            /** @description Filter by session status */
+            sessionStatus?: ("closed_resolved" | "closed_unresolved" | "open") | null;
+            sessionContactId?: string | null;
+            /** @description A list of objects with key-value pairs to filter by. Relationship is OR between objects, and AND between the values in each object */
+            ticketCustomData?: {
+                [key: string]: string;
+            }[] | null;
+            /** @description Filter by contact custom data key-value pairs */
+            contactCustomData?: {
+                [key: string]: string;
+            }[] | null;
+            /** @default 1 */
+            page: number;
+        };
+        ArchiveInsightDto: {
+            /**
+             * @description When the insight should resurface after archiving
+             * @default until_escalating
+             * @enum {string}
+             */
+            policy: "forever" | "until_count" | "until_escalating";
+            /** @description Reason for archiving */
+            reason?: string;
+        };
         MakeOutboundCallDto: {
             phoneAgentId: string;
             contact: {
@@ -3848,67 +4061,6 @@ export interface components {
                 }[];
             }[];
         };
-        CreateGroupDto: {
-            name: string;
-            description?: string;
-            is_support_enabled?: boolean;
-            support_office_hours_id?: string | null;
-            /** @enum {string} */
-            support_assignment_strategy?: "least-busy" | "round-robin" | "unassigned";
-        };
-        CreateVocCategoryDto: {
-            name: string;
-            description?: string | null;
-        };
-        UpdateCategoryDto: {
-            name?: string;
-            description?: string | null;
-        };
-        GetVocQueryDto: {
-            /** @description Filter by category name */
-            category?: string | null;
-            status?: ("all" | "unresolved" | "resolved" | "archived") | null;
-            sentiment?: ("angry" | "happy" | "neutral") | null;
-            sortBy?: ("occurrence_count" | "last_seen_at" | "first_seen_at" | "created_at") | null;
-            sortOrder?: ("asc" | "desc") | null;
-            minSessions?: number | null;
-            /** @description Search in insight content */
-            search?: string | null;
-            /** @description Filter by specific team ID or none for unassigned insights */
-            teamId?: (string | "not_assigned" | null) | null;
-            /** @description Filter by insight number */
-            insightNumber?: number | null;
-            /** @description Filter by language */
-            sessionLanguage?: ("az" | "el" | "de" | "fr" | "it" | "es" | "pt" | "nl" | "da" | "sv" | "no" | "fi" | "et" | "is" | "pl" | "cs" | "sk" | "hu" | "ro" | "bg" | "hr" | "sr" | "uk" | "ru" | "tr" | "en" | "zh" | "ja" | "ko" | "hi" | "bn" | "id" | "ms" | "th" | "vi" | "tl" | "ar" | "he" | "fa" | "ur" | "af" | "sw" | "ku" | "ckb" | "kmr") | null;
-            ticketSentiment?: ("angry" | "happy" | "neutral") | null;
-            /** @description Filter by session channel */
-            channel?: components["schemas"]["SessionChannel"] | null;
-            sessionFromDate?: string | null;
-            sessionToDate?: string | null;
-            /** @description Filter by session status */
-            sessionStatus?: ("closed_resolved" | "closed_unresolved" | "open") | null;
-            sessionContactId?: string | null;
-            /** @description A list of objects with key-value pairs to filter by. Relationship is OR between objects, and AND between the values in each object */
-            ticketCustomData?: {
-                [key: string]: string;
-            }[] | null;
-            /** @description Filter by contact custom data key-value pairs */
-            contactCustomData?: {
-                [key: string]: string;
-            }[] | null;
-            /** @default 1 */
-            page: number;
-        };
-        ArchiveInsightDto: {
-            /**
-             * @description When the insight should resurface after archiving
-             * @default until_escalating
-             * @enum {string}
-             */
-            policy: "forever" | "until_count" | "until_escalating";
-            /** @description Reason for archiving */
-            reason?: string;
-        };
         FileUploadDto: {
             /**
              * Format: binary
@@ -3940,6 +4092,16 @@ export interface components {
             /** @description Optional reason for redaction */
             reason?: string;
         };
+        CreateSavedReplyDto: {
+            category: string;
+            title: string;
+            content: string;
+        };
+        UpdateSavedReplyDto: {
+            category?: string;
+            title?: string;
+            content?: string;
+        };
         SalesforceMiawWebhookBody: {
             /** @enum {string} */
             event: "message:new";
@@ -3959,6 +4121,8 @@ export interface components {
             crawl_interval_hours: number | null;
             /** @default true */
             auto_start_crawl: boolean;
+            /** @default [] */
+            restricted_to_channels: components["schemas"]["SessionChannel"][];
         };
         UpdateWebsiteDatasourceDto: {
             display_name?: string;
@@ -3968,6 +4132,7 @@ export interface components {
             crawl_interval_hours?: number | null;
             /** @enum {string} */
             status?: "active" | "paused";
+            restricted_to_channels?: components["schemas"]["SessionChannel"][];
         };
         BulkPageActionDto: {
             page_ids: string[];
@@ -4429,6 +4594,19 @@ export interface components {
              */
             limit: number;
         };
+        UpdatePublicKnowledgebaseItem: {
+            /** @description Contact segment ids this item should be restricted to. Pass [] to make it available to all contacts. */
+            restricted_to_segments?: string[];
+            /** @description Channels this item should be restricted to. Pass [] to make it available on all channels. */
+            restricted_to_channels?: components["schemas"]["SessionChannel"][];
+            /** @description ISO 8601 instant (UTC) when the AI may start using this item. Null clears it. */
+            start_time?: string | null;
+            /** @description ISO 8601 instant (UTC) when the AI stops using this item. Null clears it. */
+            end_time?: string | null;
+            /** @enum {string} */
+            visibility?: "internal" | "public";
+            title?: string;
+        };
         EmailRecipient: {
             /** Format: email */
             to_email: string;
@@ -4624,6 +4802,12 @@ export interface components {
             /** @description ISO 8601 instant (UTC) when the AI stops using this instruction. Null clears the end bound. */
             end_time?: string | null;
         };
+        UpdateTrainingRestrictionsDto: {
+            /** @description Channels this instruction applies to. Pass [] to make it available on all channels. */
+            restricted_to_channels?: components["schemas"]["SessionChannel"][];
+            /** @description Contact segment ids this instruction applies to. Pass [] to make it available to all contacts. */
+            restricted_to_segments?: string[];
+        };
         ApplyTrainingDiffDto: {
             /** @description Pre-rendered TipTap diff HTML */
             diff_html: string;
@@ -4680,7 +4864,7 @@ export interface components {
              * @description What starts the workflow. Use "manual-trigger" for on-demand execution, "ai-trigger" for AI-initiated, "webhook" for external HTTP triggers, "cron-trigger" for scheduled runs, or event-based triggers like "ticket-created", "contact-created", etc.
              * @enum {string}
              */
-            trigger_type: "manual-trigger" | "ai-trigger" | "cron-trigger" | "form-trigger" | "webhook" | "contact-created" | "phone-call-started" | "phone-call-finished" | "ticket-created" | "ticket-reassigned" | "ticket-resolved" | "ticket-handoff" | "pre-ticket-handoff" | "ticket-tag-added" | "ticket-inactive" | "agent-inactive" | "sequence-completed" | "csat-score-submit" | "prohibited-topic-detected" | "sla-first-reply-breached" | "sla-next-reply-breached" | "sla-resolution-breached" | "voice-call-transferred" | "pre-voice-call-transfer" | "pre-phone-call-finished" | "manual-ticket-trigger" | "contact-message-received" | "macro-called" | "agent-availability-changed" | "agent-avail-in-team-changed";
+            trigger_type: "manual-trigger" | "ai-trigger" | "cron-trigger" | "form-trigger" | "webhook" | "contact-created" | "phone-call-started" | "phone-call-finished" | "ticket-created" | "ticket-reassigned" | "ticket-resolved" | "ticket-handoff" | "pre-ticket-handoff" | "ticket-tag-added" | "ticket-inactive" | "agent-inactive" | "sequence-completed" | "csat-score-submit" | "prohibited-topic-detected" | "sla-first-reply-breached" | "sla-next-reply-breached" | "sla-resolution-breached" | "voice-call-transferred" | "pre-voice-call-transfer" | "pre-phone-call-finished" | "manual-ticket-trigger" | "contact-message-received" | "first-contact-message-received" | "macro-called" | "agent-availability-changed" | "agent-avail-in-team-changed";
             /** @description Trigger-specific configuration (e.g. cron expression for cron-trigger) */
             trigger_configuration?: unknown | null;
             /** @description Array of workflow steps and control-flow blocks. Each step is an object with { "$kind": "Action", "id": "<unique-step-id>", "type": "<action-type>", "name": "<display-name>", "input": { ... } }. Control-flow blocks use { "$kind": "Block", "type": "if-else", "id": "<unique-id>", "inputs": { "condition": { "operatorName": "equals", "left": "{{step_id.field}}", "right": "value" } }, "branches": { "then": [...steps], "else": [...steps] } }. Use {{step_id.field}} to reference outputs from previous steps (no `.output.` segment — the field sits directly under the step id). */
@@ -4697,7 +4881,7 @@ export interface components {
              * @description New trigger type
              * @enum {string}
              */
-            trigger_type?: "manual-trigger" | "ai-trigger" | "cron-trigger" | "form-trigger" | "webhook" | "contact-created" | "phone-call-started" | "phone-call-finished" | "ticket-created" | "ticket-reassigned" | "ticket-resolved" | "ticket-handoff" | "pre-ticket-handoff" | "ticket-tag-added" | "ticket-inactive" | "agent-inactive" | "sequence-completed" | "csat-score-submit" | "prohibited-topic-detected" | "sla-first-reply-breached" | "sla-next-reply-breached" | "sla-resolution-breached" | "voice-call-transferred" | "pre-voice-call-transfer" | "pre-phone-call-finished" | "manual-ticket-trigger" | "contact-message-received" | "macro-called" | "agent-availability-changed" | "agent-avail-in-team-changed";
+            trigger_type?: "manual-trigger" | "ai-trigger" | "cron-trigger" | "form-trigger" | "webhook" | "contact-created" | "phone-call-started" | "phone-call-finished" | "ticket-created" | "ticket-reassigned" | "ticket-resolved" | "ticket-handoff" | "pre-ticket-handoff" | "ticket-tag-added" | "ticket-inactive" | "agent-inactive" | "sequence-completed" | "csat-score-submit" | "prohibited-topic-detected" | "sla-first-reply-breached" | "sla-next-reply-breached" | "sla-resolution-breached" | "voice-call-transferred" | "pre-voice-call-transfer" | "pre-phone-call-finished" | "manual-ticket-trigger" | "contact-message-received" | "first-contact-message-received" | "macro-called" | "agent-availability-changed" | "agent-avail-in-team-changed";
             /** @description New trigger configuration */
             trigger_configuration?: unknown | null;
             /** @description New workflow step/block definitions (replaces existing blocks) */
@@ -4710,7 +4894,9 @@ export interface components {
              * @description Trigger type to validate against
              * @enum {string}
              */
-            trigger_type: "manual-trigger" | "ai-trigger" | "cron-trigger" | "form-trigger" | "webhook" | "contact-created" | "phone-call-started" | "phone-call-finished" | "ticket-created" | "ticket-reassigned" | "ticket-resolved" | "ticket-handoff" | "pre-ticket-handoff" | "ticket-tag-added" | "ticket-inactive" | "agent-inactive" | "sequence-completed" | "csat-score-submit" | "prohibited-topic-detected" | "sla-first-reply-breached" | "sla-next-reply-breached" | "sla-resolution-breached" | "voice-call-transferred" | "pre-voice-call-transfer" | "pre-phone-call-finished" | "manual-ticket-trigger" | "contact-message-received" | "macro-called" | "agent-availability-changed" | "agent-avail-in-team-changed";
+            trigger_type: "manual-trigger" | "ai-trigger" | "cron-trigger" | "form-trigger" | "webhook" | "contact-created" | "phone-call-started" | "phone-call-finished" | "ticket-created" | "ticket-reassigned" | "ticket-resolved" | "ticket-handoff" | "pre-ticket-handoff" | "ticket-tag-added" | "ticket-inactive" | "agent-inactive" | "sequence-completed" | "csat-score-submit" | "prohibited-topic-detected" | "sla-first-reply-breached" | "sla-next-reply-breached" | "sla-resolution-breached" | "voice-call-transferred" | "pre-voice-call-transfer" | "pre-phone-call-finished" | "manual-ticket-trigger" | "contact-message-received" | "first-contact-message-received" | "macro-called" | "agent-availability-changed" | "agent-avail-in-team-changed";
+            /** @description Trigger configuration to validate against the trigger's configuration_def. When omitted, the trigger is validated as if unconfigured — triggers with required configuration (e.g. cron-trigger, ai-trigger) will report errors. */
+            trigger_configuration?: unknown | null;
             /** @description Workflow blocks to validate */
             workflow_blocks: unknown[];
         };
@@ -4721,7 +4907,7 @@ export interface components {
                  * @description Trigger type whose payload shape this synthetic payload should match
                  * @enum {string}
                  */
-                type: "manual-trigger" | "ai-trigger" | "cron-trigger" | "form-trigger" | "webhook" | "contact-created" | "phone-call-started" | "phone-call-finished" | "ticket-created" | "ticket-reassigned" | "ticket-resolved" | "ticket-handoff" | "pre-ticket-handoff" | "ticket-tag-added" | "ticket-inactive" | "agent-inactive" | "sequence-completed" | "csat-score-submit" | "prohibited-topic-detected" | "sla-first-reply-breached" | "sla-next-reply-breached" | "sla-resolution-breached" | "voice-call-transferred" | "pre-voice-call-transfer" | "pre-phone-call-finished" | "manual-ticket-trigger" | "contact-message-received" | "macro-called" | "agent-availability-changed" | "agent-avail-in-team-changed";
+                type: "manual-trigger" | "ai-trigger" | "cron-trigger" | "form-trigger" | "webhook" | "contact-created" | "phone-call-started" | "phone-call-finished" | "ticket-created" | "ticket-reassigned" | "ticket-resolved" | "ticket-handoff" | "pre-ticket-handoff" | "ticket-tag-added" | "ticket-inactive" | "agent-inactive" | "sequence-completed" | "csat-score-submit" | "prohibited-topic-detected" | "sla-first-reply-breached" | "sla-next-reply-breached" | "sla-resolution-breached" | "voice-call-transferred" | "pre-voice-call-transfer" | "pre-phone-call-finished" | "manual-ticket-trigger" | "contact-message-received" | "first-contact-message-received" | "macro-called" | "agent-availability-changed" | "agent-avail-in-team-changed";
                 payload: unknown;
             };
         };
@@ -4872,6 +5058,8 @@ export interface components {
         };
         CreateEmailTemplatePublicInput: components["schemas"]["CreateEmailTemplateBodyDto"];
         UpdateEmailTemplatePublicInput: components["schemas"]["CreateEmailTemplateBodyDto"];
+        CreateMacroInput: components["schemas"]["CreateSavedReplyDto"];
+        UpdateMacroInput: components["schemas"]["UpdateSavedReplyDto"];
         UpsertTagInputDto: {
             /** @description Tag name (e.g. "billing", "refund", "feature-request") */
             tag_name: string;
@@ -4904,12 +5092,14 @@ export interface components {
             limit: number;
             visibility?: ("internal" | "public")[];
             sourceTypes?: ("custom_training" | "help_center" | "integration" | "website")[];
-            dataSources?: ("confluence" | "notion" | "zendesk_support" | "shopify" | "gitbook" | "intercom" | "front" | "freshdesk" | "ai_instructions" | "custom_training" | "website")[];
+            dataSources?: ("confluence" | "notion" | "zendesk_support" | "shopify" | "gitbook" | "intercom" | "front" | "freshdesk" | "hubspot_kb" | "ai_instructions" | "custom_training" | "website")[];
             /**
              * @default relevance
              * @enum {string}
              */
-            sortBy: "relevance" | "handoffs";
+            sortBy: "relevance" | "handoffs" | "citations";
+            dateFrom?: unknown;
+            dateTo?: unknown;
             /**
              * @description Include the full content field in results. Set to false to reduce response size.
              * @default true
@@ -5041,7 +5231,7 @@ export interface components {
                         /** @constant */
                         type: "response_skipped";
                         /** @enum {string} */
-                        reason?: "empty_response" | "potential_answers_dead_end";
+                        reason?: "empty_response" | "potential_answers_dead_end" | "silent_handoff" | "superseded_by_newer_run";
                         reasoning?: ({
                             /** @constant */
                             type: "reasoning";
@@ -5144,7 +5334,24 @@ export interface components {
                         language: "en" | "fr" | "de" | "nl" | "pl" | "pt" | "es" | "it" | "ru" | "ja" | "ko" | "zh" | "ar" | "tr" | "sv" | "da" | "no" | "fi" | "el" | "cs" | "hu" | "th" | "vi" | "id" | "he" | "hi" | "uk" | "ro" | "bg" | "hr" | "sk" | "sl" | "sr" | "et" | "lv" | "lt" | "is" | "ga" | "ms" | "tl" | "fa" | "bn" | "ta" | "te" | "ur" | "sw" | "zu" | "af" | "sq" | "hy" | "az" | "eu" | "be" | "bs" | "ca" | "cy" | "ku" | "ckb" | "kmr";
                     };
                 };
-                /** @default null */
+                actionCalls?: {
+                    action: {
+                        name: string;
+                        id: string;
+                        openapi?: {
+                            openapi_spec_id?: string;
+                            operation_spec: unknown;
+                            operation_id?: string;
+                            operation_method?: string;
+                        };
+                        metadata: unknown;
+                        required_form_submission?: boolean;
+                        is_handoff_like?: boolean;
+                    };
+                    arguments: unknown;
+                    result: unknown;
+                }[];
+                /** @default null */
                 assignment_choice_summary: {
                     /** @constant */
                     strategy: "least-busy";
@@ -5159,6 +5366,11 @@ export interface components {
                         max_capacity_in_group: number | null;
                         is_available_globally: boolean;
                         is_available_in_group: boolean;
+                        /** @default [] */
+                        missing_required_skills: {
+                            id: string;
+                            name: string;
+                        }[];
                     } | null;
                     peers: {
                         agent_id: number;
@@ -5171,6 +5383,16 @@ export interface components {
                         max_capacity_in_group: number | null;
                         is_available_globally: boolean;
                         is_available_in_group: boolean;
+                        /** @default [] */
+                        missing_required_skills: {
+                            id: string;
+                            name: string;
+                        }[];
+                    }[];
+                    /** @default [] */
+                    required_skills: {
+                        id: string;
+                        name: string;
                     }[];
                 } | null;
             } | {
@@ -5237,6 +5459,11 @@ export interface components {
                         max_capacity_in_group: number | null;
                         is_available_globally: boolean;
                         is_available_in_group: boolean;
+                        /** @default [] */
+                        missing_required_skills: {
+                            id: string;
+                            name: string;
+                        }[];
                     } | null;
                     peers: {
                         agent_id: number;
@@ -5249,6 +5476,16 @@ export interface components {
                         max_capacity_in_group: number | null;
                         is_available_globally: boolean;
                         is_available_in_group: boolean;
+                        /** @default [] */
+                        missing_required_skills: {
+                            id: string;
+                            name: string;
+                        }[];
+                    }[];
+                    /** @default [] */
+                    required_skills: {
+                        id: string;
+                        name: string;
                     }[];
                 } | null;
                 destination_id?: string;
@@ -5268,7 +5505,7 @@ export interface components {
             }) | null;
             knowledgebase_called?: boolean | null;
             /** @enum {string} */
-            type: "agent_assigned_by_system" | "agent_assigned_by_user" | "agent_changed" | "agent_comment" | "agent_initiated_session" | "agent_joined" | "agent_message" | "agent_reopened_session" | "agent_took_session_from_ai" | "agent_unassigned_by_system" | "agent_unassigned_by_user" | "ai_assumed_the_session_resolved" | "ai_decided_to_not_reply" | "ai_decided_to_resolve_the_issue" | "ai_reopened_session" | "ai_response_cancelled" | "call_history" | "call_transferred" | "closed_resolved_by_agent" | "closed_resolved_by_api" | "closed_resolved_by_contact" | "closed_resolved_by_integration" | "closed_resolved_by_system" | "closed_unresolved_by_agent" | "closed_unresolved_by_api" | "closed_unresolved_by_system" | "contact_data_updated" | "csat_requested" | "csat_submitted" | "email_draft_message" | "handoff" | "handoff_to_salesforce_miaw" | "handoff_to_zendesk" | "message" | "prohibited_topic_detected" | "sequence_message" | "sla_applied_by_agent" | "sla_applied_by_system" | "sla_first_reply_breached" | "sla_first_reply_completed_after_breach" | "sla_first_reply_fulfilled" | "sla_first_reply_metric_started" | "sla_freezed_office_hours_ended" | "sla_freezed_snoozed" | "sla_next_reply_breached" | "sla_next_reply_completed_after_breach" | "sla_next_reply_fulfilled" | "sla_next_reply_metric_started" | "sla_removed_by_agent" | "sla_removed_by_system" | "sla_resolution_breached" | "sla_resolution_completed_after_breach" | "sla_resolution_fulfilled" | "sla_resolution_metric_started" | "sla_resolution_paused_resolved" | "sla_resolution_paused_waiting_on_customer" | "sla_resolution_resumed_customer_replied" | "sla_resolution_resumed_reopened" | "sla_resumed_office_hours_started" | "sla_resumed_snooze_cancelled" | "sla_resumed_snooze_expired" | "state_checkpoint" | "sub_status_removed_by_agent" | "sub_status_removed_by_api" | "sub_status_removed_by_system" | "sub_status_set_by_agent" | "sub_status_set_by_api" | "sub_status_set_by_system" | "system_reopened_session" | "team_assigned_by_system" | "team_assigned_by_user" | "team_unassigned_by_system" | "team_unassigned_by_user" | "user_confirmed_the_session_resolved" | "workflow_message" | "workflow_note" | "workflow_triggered";
+            type: "agent_assigned_by_integration" | "agent_assigned_by_system" | "agent_assigned_by_user" | "agent_changed" | "agent_comment" | "agent_initiated_session" | "agent_joined" | "agent_message" | "agent_reopened_session" | "agent_took_session_from_ai" | "agent_unassigned_by_integration" | "agent_unassigned_by_system" | "agent_unassigned_by_user" | "ai_assumed_the_session_resolved" | "ai_decided_to_not_reply" | "ai_decided_to_resolve_the_issue" | "ai_reopened_session" | "ai_response_cancelled" | "ai_resumed_by_system" | "call_history" | "call_transferred" | "closed_resolved_by_agent" | "closed_resolved_by_api" | "closed_resolved_by_contact" | "closed_resolved_by_integration" | "closed_resolved_by_system" | "closed_unresolved_by_agent" | "closed_unresolved_by_api" | "closed_unresolved_by_system" | "contact_data_updated" | "csat_requested" | "csat_submitted" | "email_draft_message" | "handoff" | "handoff_to_salesforce_miaw" | "handoff_to_zendesk" | "integration_reopened_session" | "message" | "prohibited_topic_detected" | "sequence_message" | "skills_added_by_system" | "sla_applied_by_agent" | "sla_applied_by_system" | "sla_first_reply_breached" | "sla_first_reply_completed_after_breach" | "sla_first_reply_fulfilled" | "sla_first_reply_metric_started" | "sla_freezed_office_hours_ended" | "sla_freezed_snoozed" | "sla_next_reply_breached" | "sla_next_reply_completed_after_breach" | "sla_next_reply_fulfilled" | "sla_next_reply_metric_started" | "sla_removed_by_agent" | "sla_removed_by_system" | "sla_resolution_breached" | "sla_resolution_completed_after_breach" | "sla_resolution_fulfilled" | "sla_resolution_metric_started" | "sla_resolution_paused_resolved" | "sla_resolution_paused_waiting_on_customer" | "sla_resolution_resumed_customer_replied" | "sla_resolution_resumed_reopened" | "sla_resumed_office_hours_started" | "sla_resumed_snooze_cancelled" | "sla_resumed_snooze_expired" | "state_checkpoint" | "sub_status_removed_by_agent" | "sub_status_removed_by_api" | "sub_status_removed_by_system" | "sub_status_set_by_agent" | "sub_status_set_by_api" | "sub_status_set_by_system" | "system_reopened_session" | "tag_added_by_agent" | "tag_added_by_api" | "tag_added_by_integration" | "tag_added_by_system" | "tag_removed_by_agent" | "tag_removed_by_api" | "tag_removed_by_integration" | "tag_removed_by_system" | "team_assigned_by_system" | "team_assigned_by_user" | "team_unassigned_by_system" | "team_unassigned_by_user" | "user_confirmed_the_session_resolved" | "workflow_message" | "workflow_note" | "workflow_triggered";
             extra_params?: {
                 [key: string]: unknown;
             } | null;
@@ -5285,6 +5522,8 @@ export interface components {
             contact_slack_data?: string | null;
             attachments?: components["schemas"]["ChatAttachmentDto"][] | null;
             email_rfc_message_id?: string | null;
+            email_to?: string[] | null;
+            email_cc?: string[] | null;
             external_message_id?: string | null;
             csat_score?: number | null;
             csat_feedback?: string | null;
@@ -5310,6 +5549,50 @@ export interface components {
             edited_at?: string | null;
             deleted_at?: string | null;
         };
+        GroupUsersDto: {
+            id: number;
+            name: string;
+            email: string;
+            is_available: boolean;
+            group_capacity: number | null;
+            global_capacity: number;
+        };
+        GroupDto: {
+            id: string;
+            organization_id: string;
+            name: string;
+            description: string | null;
+            is_support_enabled: boolean;
+            support_office_hours_id: string | null;
+            /** @enum {string} */
+            support_assignment_strategy: "least-busy" | "round-robin" | "unassigned";
+            created_at: string | null;
+            updated_at: string | null;
+            deleted_at: string | null;
+        };
+        VersionHistoryItemDto: {
+            /** Format: uuid */
+            id: string;
+            instruction_id: string;
+            version_number: number;
+            question: string;
+            answer: string;
+            /** @enum {string} */
+            type: "BEHAVIORAL" | "SCENARIO_SPECIFIC";
+            /** Format: date-time */
+            published_at: string;
+            published_by: number | null;
+            published_by_name: string | null;
+            /** Format: date-time */
+            created_at: string;
+            start_time: string | null;
+            end_time: string | null;
+        };
+        CustomTrainingDirectoriesDto: {
+            id: string;
+            name: string;
+            org_id: string;
+        };
         PhoneAgentDto: {
             id: string;
             org_id: string;
@@ -5343,6 +5626,7 @@ export interface components {
             recording_enabled: boolean;
             stt_keyterms: string[];
             stt_model: ("deepgram/flux-general" | "deepgram/nova-3" | "deepgram/nova-3-medical" | "cartesia/ink-whisper" | "elevenlabs/scribe_v2_realtime" | "xai/stt-1") | null;
+            tts_speed_pct: number | null;
             failover_transfer_destination_id: string | null;
         };
         PhoneAgentVoiceDto: {
@@ -5465,50 +5749,6 @@ export interface components {
             ended_at: string | null;
             status: components["schemas"]["SequenceStatus"] | null;
         };
-        GroupUsersDto: {
-            id: number;
-            name: string;
-            email: string;
-            is_available: boolean;
-            group_capacity: number | null;
-            global_capacity: number;
-        };
-        GroupDto: {
-            id: string;
-            organization_id: string;
-            name: string;
-            description: string | null;
-            is_support_enabled: boolean;
-            support_office_hours_id: string | null;
-            /** @enum {string} */
-            support_assignment_strategy: "least-busy" | "round-robin" | "unassigned";
-            created_at: string | null;
-            updated_at: string | null;
-            deleted_at: string | null;
-        };
-        VersionHistoryItemDto: {
-            /** Format: uuid */
-            id: string;
-            instruction_id: string;
-            version_number: number;
-            question: string;
-            answer: string;
-            /** @enum {string} */
-            type: "BEHAVIORAL" | "SCENARIO_SPECIFIC";
-            /** Format: date-time */
-            published_at: string;
-            published_by: number | null;
-            published_by_name: string | null;
-            /** Format: date-time */
-            created_at: string;
-            start_time: string | null;
-            end_time: string | null;
-        };
-        CustomTrainingDirectoriesDto: {
-            id: string;
-            name: string;
-            org_id: string;
-        };
         EmailTemplateActivityItemDto: {
             id: string;
             from_email: string;
@@ -5732,6 +5972,17 @@ export interface components {
                 breaches: number;
             }[];
         };
+        SavedReplyDto: {
+            id: string;
+            org_id: string;
+            category: string;
+            title: string;
+            content: string;
+            /** Format: date-time */
+            created_at: string;
+            /** Format: date-time */
+            updated_at: string;
+        };
         StartOneOffSequenceOutputDto: {
             data?: {
                 success: boolean;
@@ -6117,7 +6368,7 @@ export interface components {
             summary: string;
             explanation: string | null;
             sentiment: ("angry" | "happy" | "neutral") | null;
-            reasons: ("based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance")[];
+            reasons: ("ai_implied_handoff" | "based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance")[];
             references: components["schemas"]["InvestigationReferenceItem"][];
             referenced_documents: components["schemas"]["InvestigationReferenceBuckets"];
         } | null;
@@ -6324,6 +6575,11 @@ export interface components {
                                 max_capacity_in_group: number | null;
                                 is_available_globally: boolean;
                                 is_available_in_group: boolean;
+                                /** @default [] */
+                                missing_required_skills: {
+                                    id: string;
+                                    name: string;
+                                }[];
                             } | null;
                             peers: {
                                 agent_id: number;
@@ -6336,6 +6592,16 @@ export interface components {
                                 max_capacity_in_group: number | null;
                                 is_available_globally: boolean;
                                 is_available_in_group: boolean;
+                                /** @default [] */
+                                missing_required_skills: {
+                                    id: string;
+                                    name: string;
+                                }[];
+                            }[];
+                            /** @default [] */
+                            required_skills: {
+                                id: string;
+                                name: string;
                             }[];
                         } | null;
                         destination_id?: string;
@@ -6504,6 +6770,12 @@ export interface components {
                 /** @constant */
                 type: "sub_status_removed_by_api";
                 sub_status_id: string | null;
+            } | {
+                /** @enum {string} */
+                type: "tag_added_by_system" | "tag_added_by_agent" | "tag_added_by_api" | "tag_added_by_integration" | "tag_removed_by_system" | "tag_removed_by_agent" | "tag_removed_by_api" | "tag_removed_by_integration";
+                tags: {
+                    name: string;
+                }[];
             } | {
                 /** @constant */
                 type: "ai_resolved_issue";
@@ -6540,6 +6812,9 @@ export interface components {
                 type: "system_reopened_session";
                 workflow_id: string | null;
                 workflow_run_id: string | null;
+            } | {
+                /** @constant */
+                type: "integration_reopened_session";
             } | {
                 /** @constant */
                 type: "ai_reopened_session";
@@ -6568,6 +6843,10 @@ export interface components {
                 /** @constant */
                 type: "agent_assigned_by_system";
                 assigned_agent_id?: number;
+            } | {
+                /** @constant */
+                type: "agent_assigned_by_integration";
+                assigned_agent_id?: number;
             } | {
                 /** @constant */
                 type: "agent_assigned_by_user";
@@ -6577,6 +6856,10 @@ export interface components {
                 /** @constant */
                 type: "agent_unassigned_by_system";
                 unassigned_agent_id?: number;
+            } | {
+                /** @constant */
+                type: "agent_unassigned_by_integration";
+                unassigned_agent_id?: number;
             } | {
                 /** @constant */
                 type: "agent_unassigned_by_user";
@@ -6641,6 +6924,8 @@ export interface components {
             exclude_paths: string[];
             include_paths: string[];
             crawl_interval_hours: number | null;
+            /** @description Channels this datasource is restricted to. Empty = available on all channels. */
+            restricted_to_channels: components["schemas"]["SessionChannel"][];
             last_crawl_started_at: string | null;
             last_crawl_completed_at: string | null;
             error_message: string | null;
@@ -6659,6 +6944,8 @@ export interface components {
             exclude_paths: string[];
             include_paths: string[];
             crawl_interval_hours: number | null;
+            /** @description Channels this datasource is restricted to. Empty = available on all channels. */
+            restricted_to_channels: components["schemas"]["SessionChannel"][];
             last_crawl_started_at: string | null;
             last_crawl_completed_at: string | null;
             error_message: string | null;
@@ -6678,6 +6965,8 @@ export interface components {
             exclude_paths: string[];
             include_paths: string[];
             crawl_interval_hours: number | null;
+            /** @description Channels this datasource is restricted to. Empty = available on all channels. */
+            restricted_to_channels: components["schemas"]["SessionChannel"][];
             last_crawl_started_at: string | null;
             last_crawl_completed_at: string | null;
             error_message: string | null;
@@ -6767,6 +7056,39 @@ export interface components {
             has_prev_page: boolean;
             data: components["schemas"]["CrawlPage"][];
         };
+        PublicKnowledgebaseItem: {
+            id: string;
+            title: string;
+            /** @enum {string} */
+            visibility: "internal" | "public";
+            /** @enum {string} */
+            source_type: "custom_training" | "help_center" | "integration" | "website";
+            /** @description External source the item was synced from (present when listing). */
+            data_source?: ("confluence" | "notion" | "zendesk_support" | "shopify" | "gitbook" | "intercom" | "front" | "freshdesk" | "hubspot_kb" | "ai_instructions" | "custom_training" | "website") | null;
+            stream?: string | null;
+            source_url: string | null;
+            /** @description Contact segment ids this item is restricted to. Empty = available to all contacts. */
+            restricted_to_segments: string[];
+            /** @description Channels this item is restricted to. Empty = available on all channels. */
+            restricted_to_channels: components["schemas"]["SessionChannel"][];
+            /** @description Active window start (UTC). Null = no start bound. */
+            start_time: string | null;
+            /** @description Active window end (UTC). Null = no end bound. */
+            end_time: string | null;
+            /** Format: date-time */
+            updated_at: string;
+        };
+        ListPublicKnowledgebaseItemsOutput: {
+            items: components["schemas"]["PublicKnowledgebaseItem"][];
+            pagination: {
+                current_page: number;
+                total_pages: number;
+                total_items: number;
+                items_per_page: number;
+                has_next_page: boolean;
+                has_previous_page: boolean;
+            };
+        };
         CsatScorePublic: {
             id: string;
             organization_id: string;
@@ -6800,12 +7122,12 @@ export interface components {
             end_date: string;
             reasons: {
                 /** @enum {string} */
-                reason: "based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance";
+                reason: "ai_implied_handoff" | "based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance";
                 count: number;
                 percentage: number;
             }[];
             reason_combinations: {
-                reasons: ("based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance")[];
+                reasons: ("ai_implied_handoff" | "based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance")[];
                 session_count: number;
                 percentage: number;
             }[];
@@ -6890,6 +7212,38 @@ export interface components {
             /** @description When the organization was last updated. */
             updated_at: string | null;
         };
+        PublicResourceUsageConversationsDto: {
+            conversations: {
+                session_id: string;
+                /** @description Inbox ticket number, if assigned */
+                ticket_number: number | null;
+                /** @description The conversation’s most recent message */
+                last_message: string | null;
+                /** @description AI replies in this conversation that used the resource */
+                reply_count: number;
+                /** @description ISO 8601 timestamp of first use in this conversation */
+                first_used_at: string;
+                /** @description ISO 8601 timestamp of most recent use */
+                last_used_at: string;
+            }[];
+            /** @description Distinct conversations matching the lookup */
+            total_sessions: number;
+        };
+        PublicResourceUsageSummaryDto: {
+            /** @description Distinct conversations that used this resource */
+            session_count: number;
+            /** @description Distinct conversations where the resource was applied */
+            applied_sessions: number;
+            /** @description Total applications/invocations */
+            applied_replies: number;
+            /** @description Distinct conversations where an instruction was in context (instructions only) */
+            available_sessions: number;
+            available_replies: number;
+            /** @description ISO 8601 timestamp of first use */
+            first_used_at: string | null;
+            /** @description ISO 8601 timestamp of most recent use */
+            last_used_at: string | null;
+        };
         AddContactsToSequenceOutput: {
             run_id: string;
         };
@@ -7145,7 +7499,7 @@ export interface components {
             created_at: string;
         };
         ValidateWorkflowPublicOutput: {
-            /** @description Whether the workflow definition is valid */
+            /** @description Whether the workflow definition is valid (no error-severity issues) */
             valid: boolean;
             /** @description List of validation issues found */
             issues: {
@@ -7153,10 +7507,34 @@ export interface components {
                 step_id: string | null;
                 /** @description Description of the validation issue */
                 message: string;
+                /**
+                 * @description "error" blocks create/update/activate; "warning" is advisory only
+                 * @enum {string}
+                 */
+                severity: "error" | "warning";
             }[];
             /** @description List of action types referenced in the workflow */
             action_types_used: string[];
         };
+        WorkflowValidationErrorResponse: {
+            /** @constant */
+            statusCode: 400;
+            /** @description Human-readable summary of the validation failure */
+            message: string;
+            error: string;
+            /** @description Structured validation issues — fix each step_id and retry */
+            issues: {
+                /** @description The step ID where the issue was found, if applicable */
+                step_id: string | null;
+                /** @description Description of the validation issue */
+                message: string;
+                /**
+                 * @description "error" blocks create/update/activate; "warning" is advisory only
+                 * @enum {string}
+                 */
+                severity: "error" | "warning";
+            }[];
+        };
         FieldSchemaPublicDto: {
             /** @description Field name (use as key in input object) */
             name: string;
@@ -7218,7 +7596,7 @@ export interface components {
              */
             type: "Unary" | "Binary" | "Logical";
             /** @description Field types this operator can be applied to */
-            applies_to: ("String" | "Number" | "Boolean" | "Array" | "Object" | "DateTime" | "LongText" | "Url" | "Email" | "Select" | "LazySelect" | "Code" | "MultiSelect" | "JsonSchema" | "Any" | "AnyObject" | "RichText" | "File")[];
+            applies_to: ("String" | "Number" | "Boolean" | "Array" | "Object" | "DateTime" | "LongText" | "Url" | "Email" | "Select" | "LazySelect" | "Code" | "MultiSelect" | "LazyMultiSelect" | "JsonSchema" | "Any" | "AnyObject" | "RichText" | "File" | "PhoneNumber" | "DateOnly" | "CronExpression" | "Integer")[];
         };
         WorkflowDefinitionsPublicDto: {
             /** @description Available action types with their input/output schemas */
@@ -7233,7 +7611,7 @@ export interface components {
             }[];
             /** @description Condition operators for if-else blocks, from the engine registry. This is the complete set the runtime evaluates — always pick "operatorName" from this list. */
             operators: components["schemas"]["OperatorPublicDto"][];
-            /** @description Field schemas for the extra reference scopes available in every run, beyond the trigger payload and step outputs. Each entry's "name" is the scope root and its "properties" are the referenceable fields: {{metadata.<field>}} (date/time of the run), {{run.<field>}}, {{workflow.<field>}}, {{organization.<field>}}, and {{variables.<key>}} for the organization's global variables. */
+            /** @description Field schemas for the extra reference scopes available in every run, beyond the trigger payload and step outputs. Each entry's "name" is the scope root and its "properties" are the referenceable fields: {{metadata.<field>}} (date/time of the run), {{run.<field>}}, {{workflow.<field>}}, {{organization.<field>}}, and {{variables.<key>}} for the organization's global variables. Leaf scopes have no "properties" and are referenced directly, e.g. {{routingSkills}} — a JSON string of every org skill (name + description). */
             extra_variables: unknown[];
         };
         TestWorkflowPublicOutput: {
@@ -7332,7 +7710,7 @@ export interface components {
             summary: string;
             explanation: string | null;
             sentiment: string | null;
-            reasons: ("based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance")[];
+            reasons: ("ai_implied_handoff" | "based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance")[];
             references: {
                 /** @enum {string} */
                 reference_type: "ai_profile" | "instruction" | "knowledge" | "prohibited_topic" | "tool";
@@ -7422,12 +7800,13 @@ export interface components {
             records: unknown | null;
         }[];
         ListEmailTemplatesOutput: components["schemas"]["EmailTemplateDto"][];
+        ListMacrosOutput: components["schemas"]["SavedReplyDto"][];
         ListHandoffEventsOutput: {
             items: {
                 session_id: string;
                 summary: string;
                 explanation: string | null;
-                reasons: ("based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance")[];
+                reasons: ("ai_implied_handoff" | "based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance")[];
                 sentiment: ("angry" | "happy" | "neutral") | null;
                 created_at: string;
             }[];
@@ -7504,7 +7883,7 @@ export interface components {
                 updated_at: string;
                 content?: string;
                 /** @enum {string} */
-                data_source: "confluence" | "notion" | "zendesk_support" | "shopify" | "gitbook" | "intercom" | "front" | "freshdesk" | "ai_instructions" | "custom_training" | "website";
+                data_source: "confluence" | "notion" | "zendesk_support" | "shopify" | "gitbook" | "intercom" | "front" | "freshdesk" | "hubspot_kb" | "ai_instructions" | "custom_training" | "website";
                 stream: string | null;
                 relevance_score: number;
                 directory_id: string | null;
@@ -7512,6 +7891,10 @@ export interface components {
                 is_draft?: boolean;
                 /** @default 0 */
                 usage_count: number;
+                restricted_to_segments?: string[];
+                restricted_to_channels?: string[];
+                start_time?: string | null;
+                end_time?: string | null;
                 /** @description First 500 characters of content */
                 content_preview: string;
             }[];
@@ -9280,6 +9663,79 @@ export interface operations {
             };
         };
     };
+    listKnowledgebaseItems: {
+        parameters: {
+            query?: {
+                /** @description Full-text search over item titles/content */
+                search?: string;
+                /** @description Filter to a specific external data source (e.g. website, confluence, notion) */
+                data_source?: "confluence" | "notion" | "zendesk_support" | "shopify" | "gitbook" | "intercom" | "front" | "freshdesk" | "hubspot_kb" | "ai_instructions" | "custom_training" | "website";
+                visibility?: "internal" | "public";
+                page?: number;
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListPublicKnowledgebaseItemsOutput"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    updateKnowledgebaseItem: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The knowledge base item id */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdatePublicKnowledgebaseItem"];
+            };
+        };
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PublicKnowledgebaseItem"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     getCsatScores: {
         parameters: {
             query?: {
@@ -10105,13 +10561,173 @@ export interface operations {
             };
         };
     };
+    listMacros: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListMacrosOutput"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    createMacro: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateMacroInput"];
+            };
+        };
+        responses: {
+            /** @description Default Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SavedReplyDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    getMacro: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Macro ID */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SavedReplyDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    deleteMacro: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Macro ID */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    updateMacro: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Macro ID */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateMacroInput"];
+            };
+        };
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SavedReplyDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     listHandoffEvents: {
         parameters: {
             query?: {
                 /** @description Pagination cursor from a previous response */
                 cursor?: string;
                 /** @description Only return handoffs that include this reason */
-                reason?: "based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance";
+                reason?: "ai_implied_handoff" | "based_on_instructions" | "instructions_not_clear" | "insufficient_knowledge" | "insufficient_tools" | "prohibited_topic" | "user_requested_human_assistance";
                 /** @description Start date in ISO 8601 format (defaults to 30 days ago) */
                 start_date?: string;
                 /** @description End date in ISO 8601 format (defaults to now) */
@@ -10783,6 +11399,15 @@ export interface operations {
                     "application/json": components["schemas"]["WorkflowDetailPublicResponseDto"];
                 };
             };
+            /** @description Default Response */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkflowValidationErrorResponse"];
+                };
+            };
             /** @description Internal Server Error */
             500: {
                 headers: {
@@ -10880,6 +11505,15 @@ export interface operations {
                     "application/json": components["schemas"]["WorkflowDetailPublicResponseDto"];
                 };
             };
+            /** @description Default Response */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkflowValidationErrorResponse"];
+                };
+            };
             /** @description Internal Server Error */
             500: {
                 headers: {
@@ -10915,6 +11549,15 @@ export interface operations {
                     "application/json": components["schemas"]["WorkflowDetailPublicResponseDto"];
                 };
             };
+            /** @description Default Response */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkflowValidationErrorResponse"];
+                };
+            };
             /** @description Internal Server Error */
             500: {
                 headers: {
@@ -11761,6 +12404,79 @@ export interface operations {
             };
         };
     };
+    listResourceConversations: {
+        parameters: {
+            query?: {
+                usageKind?: "applied" | "available";
+                from?: unknown;
+                to?: unknown;
+                limit?: number;
+                offset?: number;
+            };
+            header?: never;
+            path: {
+                resource_type: "action" | "instruction" | "knowledge";
+                resource_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PublicResourceUsageConversationsDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
+    getResourceUsageSummary: {
+        parameters: {
+            query?: {
+                from?: unknown;
+                to?: unknown;
+            };
+            header?: never;
+            path: {
+                resource_type: "action" | "instruction" | "knowledge";
+                resource_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PublicResourceUsageSummaryDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     createSequence: {
         parameters: {
             query?: never;
@@ -12847,6 +13563,41 @@ export interface operations {
             };
         };
     };
+    updateTrainingRestrictions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateTrainingRestrictionsDto"];
+            };
+        };
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TrainingPublicResponseDto"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorDto"];
+                };
+            };
+        };
+    };
     applyTrainingDiff: {
         parameters: {
             query?: never;