@operla-ai/sdk 0.3.5 → 0.4.0

package/dist/generated/types.gen.d.ts

@@ -50,12 +50,33 @@ export type ListResponses = {
      * Successful response
      */
     200: {
+        /**
+         * Agents visible at the caller's scope.
+         */
         agents: Array<{
+            /**
+             * Machine name of the agent (e.g. `orchestrator`, `response`, `specialist_billing`).
+             */
             name: string;
+            /**
+             * Human-readable label shown in the dashboard.
+             */
             label: string;
+            /**
+             * Cascade level of this view (global / organization / entity).
+             */
             scope: {
+                /**
+                 * Cascade level this config lives at — `global` (whole tenant), `organization` (per-org override), or `entity` (per-entity override).
+                 */
                 level: 'global' | 'organization' | 'entity';
+                /**
+                 * ID of the organization when `level` is `organization` or `entity`.
+                 */
                 organizationId?: string;
+                /**
+                 * ID of the entity when `level` is `entity`.
+                 */
                 entityId?: string;
             };
             /**
@@ -84,12 +105,58 @@ export type CreateData = {
          * Hard rules to attach to the agent at creation.
          */
         hardRules?: Array<{
+            /**
+             * Stable identifier for the rule. Also used as the merge key when this rule is overridden at a deeper scope (organization/entity).
+             */
             name: string;
+            /**
+             * Plain-text instruction injected into the agent's prompt. The agent must always respect it.
+             */
             instruction: string;
-            triggers?: {
-                intents?: Array<string>;
-            };
+            /**
+             * Restrict the rule to specific intents. Empty array = the rule applies on every turn regardless of intent.
+             */
+            intents?: Array<string>;
+            /**
+             * Relative priority within the agent's rule set (0–100, higher first). Use it to order conflicting rules; values are not absolute.
+             */
             priority?: number;
+            /**
+             * Set on an override doc to filter out an inherited rule of the same name at runtime. The rule shape is kept so toggling back works.
+             */
+            disabled?: boolean;
+        }>;
+        /**
+         * Few-shot examples to attach to the agent at creation.
+         */
+        examples?: Array<{
+            /**
+             * Stable identifier for the example. Also used as the merge key when this example is overridden at a deeper scope (organization/entity).
+             */
+            name?: string;
+            /**
+             * Short human-readable description of the scenario this example illustrates.
+             */
+            description: string;
+            /**
+             * User message used as the example input.
+             */
+            input: string;
+            /**
+             * Expected agent output. Shape depends on the agent type (structured JSON for orchestrator/specialist, plain text for response). Write outputs in English — the runtime LLM transposes them into the user's language.
+             */
+            output?: unknown;
+            /**
+             * Optional scenario context (user data, KB facts, previous decisions) attached to this example for the agent to read alongside the input.
+             */
+            context?: unknown;
+            /**
+             * Restrict the example to specific intents. Applied at runtime by specialist and response agents — the orchestrator ignores it since it runs before intent detection. Empty array = the example applies regardless of intent.
+             */
+            intents?: Array<string>;
+            /**
+             * Set on an override doc to filter out an inherited example of the same name at runtime.
+             */
             disabled?: boolean;
         }>;
     };
@@ -135,87 +202,317 @@ export type CreateResponses = {
      * Successful response
      */
     200: {
+        /**
+         * Machine name of the agent (e.g. `orchestrator`, `response`, `specialist_billing`).
+         */
         name: string;
+        /**
+         * Human-readable label shown in the dashboard.
+         */
         label: string;
+        /**
+         * Cascade level of this view (global / organization / entity).
+         */
         scope: {
+            /**
+             * Cascade level this config lives at — `global` (whole tenant), `organization` (per-org override), or `entity` (per-entity override).
+             */
             level: 'global' | 'organization' | 'entity';
+            /**
+             * ID of the organization when `level` is `organization` or `entity`.
+             */
             organizationId?: string;
+            /**
+             * ID of the entity when `level` is `entity`.
+             */
             entityId?: string;
         };
         /**
          * The agent config the runtime sees at the request scope, after cascade resolution.
          */
         resolved: {
+            /**
+             * Monotonic version number of this snapshot at its scope.
+             */
             version: number;
+            /**
+             * System prompt active in this snapshot. Omitted on override snapshots that inherit the prompt from the cascade.
+             */
             prompt?: string;
+            /**
+             * Resolved list of hard rules. On override snapshots, may be omitted when the override doesn't customise rules.
+             */
             hardRules?: Array<{
+                /**
+                 * Stable identifier for the rule. Also used as the merge key when this rule is overridden at a deeper scope (organization/entity).
+                 */
                 name: string;
+                /**
+                 * Plain-text instruction injected into the agent's prompt. The agent must always respect it.
+                 */
                 instruction: string;
-                triggers?: {
-                    intents?: Array<string>;
-                };
+                /**
+                 * Restrict the rule to specific intents. Empty array = the rule applies on every turn regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Relative priority within the agent's rule set (0–100, higher first). Use it to order conflicting rules; values are not absolute.
+                 */
                 priority?: number;
+                /**
+                 * Set on an override doc to filter out an inherited rule of the same name at runtime. The rule shape is kept so toggling back works.
+                 */
+                disabled?: boolean;
+            }>;
+            /**
+             * Resolved list of few-shot examples. On override snapshots, may be omitted when the override doesn't customise examples.
+             */
+            examples?: Array<{
+                /**
+                 * Stable identifier for the example. Also used as the merge key when this example is overridden at a deeper scope (organization/entity).
+                 */
+                name?: string;
+                /**
+                 * Short human-readable description of the scenario this example illustrates.
+                 */
+                description: string;
+                /**
+                 * User message used as the example input.
+                 */
+                input: string;
+                /**
+                 * Expected agent output. Shape depends on the agent type (structured JSON for orchestrator/specialist, plain text for response). Write outputs in English — the runtime LLM transposes them into the user's language.
+                 */
+                output?: unknown;
+                /**
+                 * Optional scenario context (user data, KB facts, previous decisions) attached to this example for the agent to read alongside the input.
+                 */
+                context?: unknown;
+                /**
+                 * Restrict the example to specific intents. Applied at runtime by specialist and response agents — the orchestrator ignores it since it runs before intent detection. Empty array = the example applies regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Set on an override doc to filter out an inherited example of the same name at runtime.
+                 */
                 disabled?: boolean;
             }>;
+            /**
+             * Toggled user-context fields exposed to the agent.
+             */
             userContextConfig?: {
                 [key: string]: boolean;
             };
+            /**
+             * Per-channel writing style (response agent only).
+             */
             responseConfig?: {
+                /**
+                 * Writing style applied when the conversation channel is email.
+                 */
                 email?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
+                /**
+                 * Writing style applied when the conversation channel is chat.
+                 */
                 chat?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
             };
+            /**
+             * Optional release note attached when this version was published.
+             */
             message?: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
         /**
          * Override draft at this scope, when one exists.
          */
         draft?: {
+            /**
+             * Monotonic version number of this snapshot at its scope.
+             */
             version: number;
+            /**
+             * System prompt active in this snapshot. Omitted on override snapshots that inherit the prompt from the cascade.
+             */
             prompt?: string;
+            /**
+             * Resolved list of hard rules. On override snapshots, may be omitted when the override doesn't customise rules.
+             */
             hardRules?: Array<{
+                /**
+                 * Stable identifier for the rule. Also used as the merge key when this rule is overridden at a deeper scope (organization/entity).
+                 */
                 name: string;
+                /**
+                 * Plain-text instruction injected into the agent's prompt. The agent must always respect it.
+                 */
                 instruction: string;
-                triggers?: {
-                    intents?: Array<string>;
-                };
+                /**
+                 * Restrict the rule to specific intents. Empty array = the rule applies on every turn regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Relative priority within the agent's rule set (0–100, higher first). Use it to order conflicting rules; values are not absolute.
+                 */
                 priority?: number;
+                /**
+                 * Set on an override doc to filter out an inherited rule of the same name at runtime. The rule shape is kept so toggling back works.
+                 */
+                disabled?: boolean;
+            }>;
+            /**
+             * Resolved list of few-shot examples. On override snapshots, may be omitted when the override doesn't customise examples.
+             */
+            examples?: Array<{
+                /**
+                 * Stable identifier for the example. Also used as the merge key when this example is overridden at a deeper scope (organization/entity).
+                 */
+                name?: string;
+                /**
+                 * Short human-readable description of the scenario this example illustrates.
+                 */
+                description: string;
+                /**
+                 * User message used as the example input.
+                 */
+                input: string;
+                /**
+                 * Expected agent output. Shape depends on the agent type (structured JSON for orchestrator/specialist, plain text for response). Write outputs in English — the runtime LLM transposes them into the user's language.
+                 */
+                output?: unknown;
+                /**
+                 * Optional scenario context (user data, KB facts, previous decisions) attached to this example for the agent to read alongside the input.
+                 */
+                context?: unknown;
+                /**
+                 * Restrict the example to specific intents. Applied at runtime by specialist and response agents — the orchestrator ignores it since it runs before intent detection. Empty array = the example applies regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Set on an override doc to filter out an inherited example of the same name at runtime.
+                 */
                 disabled?: boolean;
             }>;
+            /**
+             * Toggled user-context fields exposed to the agent.
+             */
             userContextConfig?: {
                 [key: string]: boolean;
             };
+            /**
+             * Per-channel writing style (response agent only).
+             */
             responseConfig?: {
+                /**
+                 * Writing style applied when the conversation channel is email.
+                 */
                 email?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
+                /**
+                 * Writing style applied when the conversation channel is chat.
+                 */
                 chat?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
             };
+            /**
+             * Optional release note attached when this version was published.
+             */
             message?: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
     };
@@ -270,6 +567,9 @@ export type DeleteResponses = {
      * Successful response
      */
     200: {
+        /**
+         * Confirmation message describing the deletion outcome.
+         */
         message: string;
     };
 };
@@ -328,87 +628,317 @@ export type GetResponses = {
      * Successful response
      */
     200: {
+        /**
+         * Machine name of the agent (e.g. `orchestrator`, `response`, `specialist_billing`).
+         */
         name: string;
+        /**
+         * Human-readable label shown in the dashboard.
+         */
         label: string;
+        /**
+         * Cascade level of this view (global / organization / entity).
+         */
         scope: {
+            /**
+             * Cascade level this config lives at — `global` (whole tenant), `organization` (per-org override), or `entity` (per-entity override).
+             */
             level: 'global' | 'organization' | 'entity';
+            /**
+             * ID of the organization when `level` is `organization` or `entity`.
+             */
             organizationId?: string;
+            /**
+             * ID of the entity when `level` is `entity`.
+             */
             entityId?: string;
         };
         /**
          * The agent config the runtime sees at the request scope, after cascade resolution.
          */
         resolved: {
+            /**
+             * Monotonic version number of this snapshot at its scope.
+             */
             version: number;
+            /**
+             * System prompt active in this snapshot. Omitted on override snapshots that inherit the prompt from the cascade.
+             */
             prompt?: string;
+            /**
+             * Resolved list of hard rules. On override snapshots, may be omitted when the override doesn't customise rules.
+             */
             hardRules?: Array<{
+                /**
+                 * Stable identifier for the rule. Also used as the merge key when this rule is overridden at a deeper scope (organization/entity).
+                 */
                 name: string;
+                /**
+                 * Plain-text instruction injected into the agent's prompt. The agent must always respect it.
+                 */
                 instruction: string;
-                triggers?: {
-                    intents?: Array<string>;
-                };
+                /**
+                 * Restrict the rule to specific intents. Empty array = the rule applies on every turn regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Relative priority within the agent's rule set (0–100, higher first). Use it to order conflicting rules; values are not absolute.
+                 */
                 priority?: number;
+                /**
+                 * Set on an override doc to filter out an inherited rule of the same name at runtime. The rule shape is kept so toggling back works.
+                 */
                 disabled?: boolean;
             }>;
+            /**
+             * Resolved list of few-shot examples. On override snapshots, may be omitted when the override doesn't customise examples.
+             */
+            examples?: Array<{
+                /**
+                 * Stable identifier for the example. Also used as the merge key when this example is overridden at a deeper scope (organization/entity).
+                 */
+                name?: string;
+                /**
+                 * Short human-readable description of the scenario this example illustrates.
+                 */
+                description: string;
+                /**
+                 * User message used as the example input.
+                 */
+                input: string;
+                /**
+                 * Expected agent output. Shape depends on the agent type (structured JSON for orchestrator/specialist, plain text for response). Write outputs in English — the runtime LLM transposes them into the user's language.
+                 */
+                output?: unknown;
+                /**
+                 * Optional scenario context (user data, KB facts, previous decisions) attached to this example for the agent to read alongside the input.
+                 */
+                context?: unknown;
+                /**
+                 * Restrict the example to specific intents. Applied at runtime by specialist and response agents — the orchestrator ignores it since it runs before intent detection. Empty array = the example applies regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Set on an override doc to filter out an inherited example of the same name at runtime.
+                 */
+                disabled?: boolean;
+            }>;
+            /**
+             * Toggled user-context fields exposed to the agent.
+             */
             userContextConfig?: {
                 [key: string]: boolean;
             };
+            /**
+             * Per-channel writing style (response agent only).
+             */
             responseConfig?: {
+                /**
+                 * Writing style applied when the conversation channel is email.
+                 */
                 email?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
+                /**
+                 * Writing style applied when the conversation channel is chat.
+                 */
                 chat?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
             };
+            /**
+             * Optional release note attached when this version was published.
+             */
             message?: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
         /**
          * Override draft at this scope, when one exists.
          */
         draft?: {
+            /**
+             * Monotonic version number of this snapshot at its scope.
+             */
             version: number;
+            /**
+             * System prompt active in this snapshot. Omitted on override snapshots that inherit the prompt from the cascade.
+             */
             prompt?: string;
+            /**
+             * Resolved list of hard rules. On override snapshots, may be omitted when the override doesn't customise rules.
+             */
             hardRules?: Array<{
+                /**
+                 * Stable identifier for the rule. Also used as the merge key when this rule is overridden at a deeper scope (organization/entity).
+                 */
                 name: string;
+                /**
+                 * Plain-text instruction injected into the agent's prompt. The agent must always respect it.
+                 */
                 instruction: string;
-                triggers?: {
-                    intents?: Array<string>;
-                };
+                /**
+                 * Restrict the rule to specific intents. Empty array = the rule applies on every turn regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Relative priority within the agent's rule set (0–100, higher first). Use it to order conflicting rules; values are not absolute.
+                 */
                 priority?: number;
+                /**
+                 * Set on an override doc to filter out an inherited rule of the same name at runtime. The rule shape is kept so toggling back works.
+                 */
                 disabled?: boolean;
             }>;
-            userContextConfig?: {
-                [key: string]: boolean;
-            };
-            responseConfig?: {
-                email?: {
-                    greeting?: string;
-                    signature?: string;
-                    tone?: 'empathetic' | 'formal' | 'friendly';
-                    addressForm?: 'formal' | 'informal';
-                    allowEmojis?: boolean;
-                };
-                chat?: {
-                    greeting?: string;
+            /**
+             * Resolved list of few-shot examples. On override snapshots, may be omitted when the override doesn't customise examples.
+             */
+            examples?: Array<{
+                /**
+                 * Stable identifier for the example. Also used as the merge key when this example is overridden at a deeper scope (organization/entity).
+                 */
+                name?: string;
+                /**
+                 * Short human-readable description of the scenario this example illustrates.
+                 */
+                description: string;
+                /**
+                 * User message used as the example input.
+                 */
+                input: string;
+                /**
+                 * Expected agent output. Shape depends on the agent type (structured JSON for orchestrator/specialist, plain text for response). Write outputs in English — the runtime LLM transposes them into the user's language.
+                 */
+                output?: unknown;
+                /**
+                 * Optional scenario context (user data, KB facts, previous decisions) attached to this example for the agent to read alongside the input.
+                 */
+                context?: unknown;
+                /**
+                 * Restrict the example to specific intents. Applied at runtime by specialist and response agents — the orchestrator ignores it since it runs before intent detection. Empty array = the example applies regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Set on an override doc to filter out an inherited example of the same name at runtime.
+                 */
+                disabled?: boolean;
+            }>;
+            /**
+             * Toggled user-context fields exposed to the agent.
+             */
+            userContextConfig?: {
+                [key: string]: boolean;
+            };
+            /**
+             * Per-channel writing style (response agent only).
+             */
+            responseConfig?: {
+                /**
+                 * Writing style applied when the conversation channel is email.
+                 */
+                email?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
+                    greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
+                    signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
+                    addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
+                    allowEmojis?: boolean;
+                };
+                /**
+                 * Writing style applied when the conversation channel is chat.
+                 */
+                chat?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
+                    greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
             };
+            /**
+             * Optional release note attached when this version was published.
+             */
             message?: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
     };
@@ -424,12 +954,58 @@ export type UpdateData = {
          * Constraints the agent must follow, injected into its prompt.
          */
         hardRules?: Array<{
+            /**
+             * Stable identifier for the rule. Also used as the merge key when this rule is overridden at a deeper scope (organization/entity).
+             */
             name: string;
+            /**
+             * Plain-text instruction injected into the agent's prompt. The agent must always respect it.
+             */
             instruction: string;
-            triggers?: {
-                intents?: Array<string>;
-            };
+            /**
+             * Restrict the rule to specific intents. Empty array = the rule applies on every turn regardless of intent.
+             */
+            intents?: Array<string>;
+            /**
+             * Relative priority within the agent's rule set (0–100, higher first). Use it to order conflicting rules; values are not absolute.
+             */
             priority?: number;
+            /**
+             * Set on an override doc to filter out an inherited rule of the same name at runtime. The rule shape is kept so toggling back works.
+             */
+            disabled?: boolean;
+        }>;
+        /**
+         * Few-shot examples shown to the agent in its prompt. Use them to demonstrate input → output patterns.
+         */
+        examples?: Array<{
+            /**
+             * Stable identifier for the example. Also used as the merge key when this example is overridden at a deeper scope (organization/entity).
+             */
+            name?: string;
+            /**
+             * Short human-readable description of the scenario this example illustrates.
+             */
+            description: string;
+            /**
+             * User message used as the example input.
+             */
+            input: string;
+            /**
+             * Expected agent output. Shape depends on the agent type (structured JSON for orchestrator/specialist, plain text for response). Write outputs in English — the runtime LLM transposes them into the user's language.
+             */
+            output?: unknown;
+            /**
+             * Optional scenario context (user data, KB facts, previous decisions) attached to this example for the agent to read alongside the input.
+             */
+            context?: unknown;
+            /**
+             * Restrict the example to specific intents. Applied at runtime by specialist and response agents — the orchestrator ignores it since it runs before intent detection. Empty array = the example applies regardless of intent.
+             */
+            intents?: Array<string>;
+            /**
+             * Set on an override doc to filter out an inherited example of the same name at runtime.
+             */
             disabled?: boolean;
         }>;
         /**
@@ -442,18 +1018,54 @@ export type UpdateData = {
          * Per-channel writing style. Editable on the response agent only.
          */
         responseConfig?: {
+            /**
+             * Writing style applied when the conversation channel is email.
+             */
             email?: {
+                /**
+                 * Greeting text to start the agent's response. The agent translates it into the user's language.
+                 */
                 greeting?: string;
+                /**
+                 * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                 */
                 signature?: string;
+                /**
+                 * Writing tone for this channel.
+                 */
                 tone?: 'empathetic' | 'formal' | 'friendly';
+                /**
+                 * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                 */
                 addressForm?: 'formal' | 'informal';
+                /**
+                 * Allow the agent to use one emoji per message. Defaults to `false`.
+                 */
                 allowEmojis?: boolean;
             };
+            /**
+             * Writing style applied when the conversation channel is chat.
+             */
             chat?: {
+                /**
+                 * Greeting text to start the agent's response. The agent translates it into the user's language.
+                 */
                 greeting?: string;
+                /**
+                 * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                 */
                 signature?: string;
+                /**
+                 * Writing tone for this channel.
+                 */
                 tone?: 'empathetic' | 'formal' | 'friendly';
+                /**
+                 * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                 */
                 addressForm?: 'formal' | 'informal';
+                /**
+                 * Allow the agent to use one emoji per message. Defaults to `false`.
+                 */
                 allowEmojis?: boolean;
             };
         };
@@ -514,87 +1126,317 @@ export type UpdateResponses = {
      * Successful response
      */
     200: {
+        /**
+         * Machine name of the agent (e.g. `orchestrator`, `response`, `specialist_billing`).
+         */
         name: string;
+        /**
+         * Human-readable label shown in the dashboard.
+         */
         label: string;
+        /**
+         * Cascade level of this view (global / organization / entity).
+         */
         scope: {
+            /**
+             * Cascade level this config lives at — `global` (whole tenant), `organization` (per-org override), or `entity` (per-entity override).
+             */
             level: 'global' | 'organization' | 'entity';
+            /**
+             * ID of the organization when `level` is `organization` or `entity`.
+             */
             organizationId?: string;
+            /**
+             * ID of the entity when `level` is `entity`.
+             */
             entityId?: string;
         };
         /**
          * The agent config the runtime sees at the request scope, after cascade resolution.
          */
         resolved: {
+            /**
+             * Monotonic version number of this snapshot at its scope.
+             */
             version: number;
+            /**
+             * System prompt active in this snapshot. Omitted on override snapshots that inherit the prompt from the cascade.
+             */
             prompt?: string;
+            /**
+             * Resolved list of hard rules. On override snapshots, may be omitted when the override doesn't customise rules.
+             */
             hardRules?: Array<{
+                /**
+                 * Stable identifier for the rule. Also used as the merge key when this rule is overridden at a deeper scope (organization/entity).
+                 */
                 name: string;
+                /**
+                 * Plain-text instruction injected into the agent's prompt. The agent must always respect it.
+                 */
                 instruction: string;
-                triggers?: {
-                    intents?: Array<string>;
-                };
+                /**
+                 * Restrict the rule to specific intents. Empty array = the rule applies on every turn regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Relative priority within the agent's rule set (0–100, higher first). Use it to order conflicting rules; values are not absolute.
+                 */
                 priority?: number;
+                /**
+                 * Set on an override doc to filter out an inherited rule of the same name at runtime. The rule shape is kept so toggling back works.
+                 */
+                disabled?: boolean;
+            }>;
+            /**
+             * Resolved list of few-shot examples. On override snapshots, may be omitted when the override doesn't customise examples.
+             */
+            examples?: Array<{
+                /**
+                 * Stable identifier for the example. Also used as the merge key when this example is overridden at a deeper scope (organization/entity).
+                 */
+                name?: string;
+                /**
+                 * Short human-readable description of the scenario this example illustrates.
+                 */
+                description: string;
+                /**
+                 * User message used as the example input.
+                 */
+                input: string;
+                /**
+                 * Expected agent output. Shape depends on the agent type (structured JSON for orchestrator/specialist, plain text for response). Write outputs in English — the runtime LLM transposes them into the user's language.
+                 */
+                output?: unknown;
+                /**
+                 * Optional scenario context (user data, KB facts, previous decisions) attached to this example for the agent to read alongside the input.
+                 */
+                context?: unknown;
+                /**
+                 * Restrict the example to specific intents. Applied at runtime by specialist and response agents — the orchestrator ignores it since it runs before intent detection. Empty array = the example applies regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Set on an override doc to filter out an inherited example of the same name at runtime.
+                 */
                 disabled?: boolean;
             }>;
+            /**
+             * Toggled user-context fields exposed to the agent.
+             */
             userContextConfig?: {
                 [key: string]: boolean;
             };
+            /**
+             * Per-channel writing style (response agent only).
+             */
             responseConfig?: {
+                /**
+                 * Writing style applied when the conversation channel is email.
+                 */
                 email?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
+                /**
+                 * Writing style applied when the conversation channel is chat.
+                 */
                 chat?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
             };
+            /**
+             * Optional release note attached when this version was published.
+             */
             message?: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
         /**
          * Override draft at this scope, when one exists.
          */
         draft?: {
+            /**
+             * Monotonic version number of this snapshot at its scope.
+             */
             version: number;
+            /**
+             * System prompt active in this snapshot. Omitted on override snapshots that inherit the prompt from the cascade.
+             */
             prompt?: string;
+            /**
+             * Resolved list of hard rules. On override snapshots, may be omitted when the override doesn't customise rules.
+             */
             hardRules?: Array<{
+                /**
+                 * Stable identifier for the rule. Also used as the merge key when this rule is overridden at a deeper scope (organization/entity).
+                 */
                 name: string;
+                /**
+                 * Plain-text instruction injected into the agent's prompt. The agent must always respect it.
+                 */
                 instruction: string;
-                triggers?: {
-                    intents?: Array<string>;
-                };
+                /**
+                 * Restrict the rule to specific intents. Empty array = the rule applies on every turn regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Relative priority within the agent's rule set (0–100, higher first). Use it to order conflicting rules; values are not absolute.
+                 */
                 priority?: number;
+                /**
+                 * Set on an override doc to filter out an inherited rule of the same name at runtime. The rule shape is kept so toggling back works.
+                 */
+                disabled?: boolean;
+            }>;
+            /**
+             * Resolved list of few-shot examples. On override snapshots, may be omitted when the override doesn't customise examples.
+             */
+            examples?: Array<{
+                /**
+                 * Stable identifier for the example. Also used as the merge key when this example is overridden at a deeper scope (organization/entity).
+                 */
+                name?: string;
+                /**
+                 * Short human-readable description of the scenario this example illustrates.
+                 */
+                description: string;
+                /**
+                 * User message used as the example input.
+                 */
+                input: string;
+                /**
+                 * Expected agent output. Shape depends on the agent type (structured JSON for orchestrator/specialist, plain text for response). Write outputs in English — the runtime LLM transposes them into the user's language.
+                 */
+                output?: unknown;
+                /**
+                 * Optional scenario context (user data, KB facts, previous decisions) attached to this example for the agent to read alongside the input.
+                 */
+                context?: unknown;
+                /**
+                 * Restrict the example to specific intents. Applied at runtime by specialist and response agents — the orchestrator ignores it since it runs before intent detection. Empty array = the example applies regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Set on an override doc to filter out an inherited example of the same name at runtime.
+                 */
                 disabled?: boolean;
             }>;
+            /**
+             * Toggled user-context fields exposed to the agent.
+             */
             userContextConfig?: {
                 [key: string]: boolean;
             };
+            /**
+             * Per-channel writing style (response agent only).
+             */
             responseConfig?: {
+                /**
+                 * Writing style applied when the conversation channel is email.
+                 */
                 email?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
+                /**
+                 * Writing style applied when the conversation channel is chat.
+                 */
                 chat?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
             };
+            /**
+             * Optional release note attached when this version was published.
+             */
             message?: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
     };
@@ -654,6 +1496,9 @@ export type DeleteOverrideResponses = {
      * Successful response
      */
     200: {
+        /**
+         * Confirmation message describing the deletion outcome.
+         */
         message: string;
     };
 };
@@ -717,87 +1562,317 @@ export type PublishResponses = {
      * Successful response
      */
     200: {
+        /**
+         * Machine name of the agent (e.g. `orchestrator`, `response`, `specialist_billing`).
+         */
         name: string;
+        /**
+         * Human-readable label shown in the dashboard.
+         */
         label: string;
+        /**
+         * Cascade level of this view (global / organization / entity).
+         */
         scope: {
+            /**
+             * Cascade level this config lives at — `global` (whole tenant), `organization` (per-org override), or `entity` (per-entity override).
+             */
             level: 'global' | 'organization' | 'entity';
+            /**
+             * ID of the organization when `level` is `organization` or `entity`.
+             */
             organizationId?: string;
+            /**
+             * ID of the entity when `level` is `entity`.
+             */
             entityId?: string;
         };
         /**
          * The agent config the runtime sees at the request scope, after cascade resolution.
          */
         resolved: {
+            /**
+             * Monotonic version number of this snapshot at its scope.
+             */
             version: number;
+            /**
+             * System prompt active in this snapshot. Omitted on override snapshots that inherit the prompt from the cascade.
+             */
             prompt?: string;
+            /**
+             * Resolved list of hard rules. On override snapshots, may be omitted when the override doesn't customise rules.
+             */
             hardRules?: Array<{
+                /**
+                 * Stable identifier for the rule. Also used as the merge key when this rule is overridden at a deeper scope (organization/entity).
+                 */
                 name: string;
+                /**
+                 * Plain-text instruction injected into the agent's prompt. The agent must always respect it.
+                 */
                 instruction: string;
-                triggers?: {
-                    intents?: Array<string>;
-                };
+                /**
+                 * Restrict the rule to specific intents. Empty array = the rule applies on every turn regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Relative priority within the agent's rule set (0–100, higher first). Use it to order conflicting rules; values are not absolute.
+                 */
                 priority?: number;
+                /**
+                 * Set on an override doc to filter out an inherited rule of the same name at runtime. The rule shape is kept so toggling back works.
+                 */
                 disabled?: boolean;
             }>;
-            userContextConfig?: {
-                [key: string]: boolean;
-            };
-            responseConfig?: {
-                email?: {
-                    greeting?: string;
-                    signature?: string;
-                    tone?: 'empathetic' | 'formal' | 'friendly';
+            /**
+             * Resolved list of few-shot examples. On override snapshots, may be omitted when the override doesn't customise examples.
+             */
+            examples?: Array<{
+                /**
+                 * Stable identifier for the example. Also used as the merge key when this example is overridden at a deeper scope (organization/entity).
+                 */
+                name?: string;
+                /**
+                 * Short human-readable description of the scenario this example illustrates.
+                 */
+                description: string;
+                /**
+                 * User message used as the example input.
+                 */
+                input: string;
+                /**
+                 * Expected agent output. Shape depends on the agent type (structured JSON for orchestrator/specialist, plain text for response). Write outputs in English — the runtime LLM transposes them into the user's language.
+                 */
+                output?: unknown;
+                /**
+                 * Optional scenario context (user data, KB facts, previous decisions) attached to this example for the agent to read alongside the input.
+                 */
+                context?: unknown;
+                /**
+                 * Restrict the example to specific intents. Applied at runtime by specialist and response agents — the orchestrator ignores it since it runs before intent detection. Empty array = the example applies regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Set on an override doc to filter out an inherited example of the same name at runtime.
+                 */
+                disabled?: boolean;
+            }>;
+            /**
+             * Toggled user-context fields exposed to the agent.
+             */
+            userContextConfig?: {
+                [key: string]: boolean;
+            };
+            /**
+             * Per-channel writing style (response agent only).
+             */
+            responseConfig?: {
+                /**
+                 * Writing style applied when the conversation channel is email.
+                 */
+                email?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
+                    greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
+                    signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
+                /**
+                 * Writing style applied when the conversation channel is chat.
+                 */
                 chat?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
             };
+            /**
+             * Optional release note attached when this version was published.
+             */
             message?: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
         /**
          * Override draft at this scope, when one exists.
          */
         draft?: {
+            /**
+             * Monotonic version number of this snapshot at its scope.
+             */
             version: number;
+            /**
+             * System prompt active in this snapshot. Omitted on override snapshots that inherit the prompt from the cascade.
+             */
             prompt?: string;
+            /**
+             * Resolved list of hard rules. On override snapshots, may be omitted when the override doesn't customise rules.
+             */
             hardRules?: Array<{
+                /**
+                 * Stable identifier for the rule. Also used as the merge key when this rule is overridden at a deeper scope (organization/entity).
+                 */
                 name: string;
+                /**
+                 * Plain-text instruction injected into the agent's prompt. The agent must always respect it.
+                 */
                 instruction: string;
-                triggers?: {
-                    intents?: Array<string>;
-                };
+                /**
+                 * Restrict the rule to specific intents. Empty array = the rule applies on every turn regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Relative priority within the agent's rule set (0–100, higher first). Use it to order conflicting rules; values are not absolute.
+                 */
                 priority?: number;
+                /**
+                 * Set on an override doc to filter out an inherited rule of the same name at runtime. The rule shape is kept so toggling back works.
+                 */
+                disabled?: boolean;
+            }>;
+            /**
+             * Resolved list of few-shot examples. On override snapshots, may be omitted when the override doesn't customise examples.
+             */
+            examples?: Array<{
+                /**
+                 * Stable identifier for the example. Also used as the merge key when this example is overridden at a deeper scope (organization/entity).
+                 */
+                name?: string;
+                /**
+                 * Short human-readable description of the scenario this example illustrates.
+                 */
+                description: string;
+                /**
+                 * User message used as the example input.
+                 */
+                input: string;
+                /**
+                 * Expected agent output. Shape depends on the agent type (structured JSON for orchestrator/specialist, plain text for response). Write outputs in English — the runtime LLM transposes them into the user's language.
+                 */
+                output?: unknown;
+                /**
+                 * Optional scenario context (user data, KB facts, previous decisions) attached to this example for the agent to read alongside the input.
+                 */
+                context?: unknown;
+                /**
+                 * Restrict the example to specific intents. Applied at runtime by specialist and response agents — the orchestrator ignores it since it runs before intent detection. Empty array = the example applies regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Set on an override doc to filter out an inherited example of the same name at runtime.
+                 */
                 disabled?: boolean;
             }>;
+            /**
+             * Toggled user-context fields exposed to the agent.
+             */
             userContextConfig?: {
                 [key: string]: boolean;
             };
+            /**
+             * Per-channel writing style (response agent only).
+             */
             responseConfig?: {
+                /**
+                 * Writing style applied when the conversation channel is email.
+                 */
                 email?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
+                /**
+                 * Writing style applied when the conversation channel is chat.
+                 */
                 chat?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
             };
+            /**
+             * Optional release note attached when this version was published.
+             */
             message?: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
     };
@@ -862,87 +1937,317 @@ export type RollbackResponses = {
      * Successful response
      */
     200: {
+        /**
+         * Machine name of the agent (e.g. `orchestrator`, `response`, `specialist_billing`).
+         */
         name: string;
+        /**
+         * Human-readable label shown in the dashboard.
+         */
         label: string;
+        /**
+         * Cascade level of this view (global / organization / entity).
+         */
         scope: {
+            /**
+             * Cascade level this config lives at — `global` (whole tenant), `organization` (per-org override), or `entity` (per-entity override).
+             */
             level: 'global' | 'organization' | 'entity';
+            /**
+             * ID of the organization when `level` is `organization` or `entity`.
+             */
             organizationId?: string;
+            /**
+             * ID of the entity when `level` is `entity`.
+             */
             entityId?: string;
         };
         /**
          * The agent config the runtime sees at the request scope, after cascade resolution.
          */
         resolved: {
+            /**
+             * Monotonic version number of this snapshot at its scope.
+             */
             version: number;
+            /**
+             * System prompt active in this snapshot. Omitted on override snapshots that inherit the prompt from the cascade.
+             */
             prompt?: string;
+            /**
+             * Resolved list of hard rules. On override snapshots, may be omitted when the override doesn't customise rules.
+             */
             hardRules?: Array<{
+                /**
+                 * Stable identifier for the rule. Also used as the merge key when this rule is overridden at a deeper scope (organization/entity).
+                 */
                 name: string;
+                /**
+                 * Plain-text instruction injected into the agent's prompt. The agent must always respect it.
+                 */
                 instruction: string;
-                triggers?: {
-                    intents?: Array<string>;
-                };
+                /**
+                 * Restrict the rule to specific intents. Empty array = the rule applies on every turn regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Relative priority within the agent's rule set (0–100, higher first). Use it to order conflicting rules; values are not absolute.
+                 */
                 priority?: number;
+                /**
+                 * Set on an override doc to filter out an inherited rule of the same name at runtime. The rule shape is kept so toggling back works.
+                 */
+                disabled?: boolean;
+            }>;
+            /**
+             * Resolved list of few-shot examples. On override snapshots, may be omitted when the override doesn't customise examples.
+             */
+            examples?: Array<{
+                /**
+                 * Stable identifier for the example. Also used as the merge key when this example is overridden at a deeper scope (organization/entity).
+                 */
+                name?: string;
+                /**
+                 * Short human-readable description of the scenario this example illustrates.
+                 */
+                description: string;
+                /**
+                 * User message used as the example input.
+                 */
+                input: string;
+                /**
+                 * Expected agent output. Shape depends on the agent type (structured JSON for orchestrator/specialist, plain text for response). Write outputs in English — the runtime LLM transposes them into the user's language.
+                 */
+                output?: unknown;
+                /**
+                 * Optional scenario context (user data, KB facts, previous decisions) attached to this example for the agent to read alongside the input.
+                 */
+                context?: unknown;
+                /**
+                 * Restrict the example to specific intents. Applied at runtime by specialist and response agents — the orchestrator ignores it since it runs before intent detection. Empty array = the example applies regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Set on an override doc to filter out an inherited example of the same name at runtime.
+                 */
                 disabled?: boolean;
             }>;
+            /**
+             * Toggled user-context fields exposed to the agent.
+             */
             userContextConfig?: {
                 [key: string]: boolean;
             };
+            /**
+             * Per-channel writing style (response agent only).
+             */
             responseConfig?: {
+                /**
+                 * Writing style applied when the conversation channel is email.
+                 */
                 email?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
+                /**
+                 * Writing style applied when the conversation channel is chat.
+                 */
                 chat?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
             };
+            /**
+             * Optional release note attached when this version was published.
+             */
             message?: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
         /**
          * Override draft at this scope, when one exists.
          */
         draft?: {
+            /**
+             * Monotonic version number of this snapshot at its scope.
+             */
             version: number;
+            /**
+             * System prompt active in this snapshot. Omitted on override snapshots that inherit the prompt from the cascade.
+             */
             prompt?: string;
+            /**
+             * Resolved list of hard rules. On override snapshots, may be omitted when the override doesn't customise rules.
+             */
             hardRules?: Array<{
+                /**
+                 * Stable identifier for the rule. Also used as the merge key when this rule is overridden at a deeper scope (organization/entity).
+                 */
                 name: string;
+                /**
+                 * Plain-text instruction injected into the agent's prompt. The agent must always respect it.
+                 */
                 instruction: string;
-                triggers?: {
-                    intents?: Array<string>;
-                };
+                /**
+                 * Restrict the rule to specific intents. Empty array = the rule applies on every turn regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Relative priority within the agent's rule set (0–100, higher first). Use it to order conflicting rules; values are not absolute.
+                 */
                 priority?: number;
+                /**
+                 * Set on an override doc to filter out an inherited rule of the same name at runtime. The rule shape is kept so toggling back works.
+                 */
+                disabled?: boolean;
+            }>;
+            /**
+             * Resolved list of few-shot examples. On override snapshots, may be omitted when the override doesn't customise examples.
+             */
+            examples?: Array<{
+                /**
+                 * Stable identifier for the example. Also used as the merge key when this example is overridden at a deeper scope (organization/entity).
+                 */
+                name?: string;
+                /**
+                 * Short human-readable description of the scenario this example illustrates.
+                 */
+                description: string;
+                /**
+                 * User message used as the example input.
+                 */
+                input: string;
+                /**
+                 * Expected agent output. Shape depends on the agent type (structured JSON for orchestrator/specialist, plain text for response). Write outputs in English — the runtime LLM transposes them into the user's language.
+                 */
+                output?: unknown;
+                /**
+                 * Optional scenario context (user data, KB facts, previous decisions) attached to this example for the agent to read alongside the input.
+                 */
+                context?: unknown;
+                /**
+                 * Restrict the example to specific intents. Applied at runtime by specialist and response agents — the orchestrator ignores it since it runs before intent detection. Empty array = the example applies regardless of intent.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Set on an override doc to filter out an inherited example of the same name at runtime.
+                 */
                 disabled?: boolean;
             }>;
+            /**
+             * Toggled user-context fields exposed to the agent.
+             */
             userContextConfig?: {
                 [key: string]: boolean;
             };
+            /**
+             * Per-channel writing style (response agent only).
+             */
             responseConfig?: {
+                /**
+                 * Writing style applied when the conversation channel is email.
+                 */
                 email?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
+                /**
+                 * Writing style applied when the conversation channel is chat.
+                 */
                 chat?: {
+                    /**
+                     * Greeting text to start the agent's response. The agent translates it into the user's language.
+                     */
                     greeting?: string;
+                    /**
+                     * Sign-off text appended to the agent's response. The agent translates it into the user's language.
+                     */
                     signature?: string;
+                    /**
+                     * Writing tone for this channel.
+                     */
                     tone?: 'empathetic' | 'formal' | 'friendly';
+                    /**
+                     * `formal` uses the polite pronoun in T-V languages (e.g. French "vous"); `informal` uses the familiar one. Defaults to `formal`.
+                     */
                     addressForm?: 'formal' | 'informal';
+                    /**
+                     * Allow the agent to use one emoji per message. Defaults to `false`.
+                     */
                     allowEmojis?: boolean;
                 };
             };
+            /**
+             * Optional release note attached when this version was published.
+             */
             message?: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
     };
@@ -1966,20 +3271,12 @@ export type List4Data = {
     body?: never;
     path?: never;
     query?: {
-        /**
-         * Max number of items to return per page (1-100).
-         */
-        limit?: number;
-        /**
-         * Number of items to skip for pagination.
-         */
-        offset?: number | null;
         /**
          * Target a specific entity (under the caller's organization).
          */
         entityId?: string;
     };
-    url: '/kb';
+    url: '/intents';
 };
 export type List4Errors = {
     /**
@@ -2019,22 +3316,686 @@ export type List4Responses = {
      * Successful response
      */
     200: {
-        articles: Array<{
+        /**
+         * Intents visible at the caller's scope.
+         */
+        intents: Array<{
+            /**
+             * Opaque intent id (prefixed `int_`).
+             */
             id: string;
-            title: string;
-            intents: Array<string>;
+            /**
+             * Machine name — stable identifier used across the API.
+             */
+            intent: string;
+            /**
+             * Human-readable label.
+             */
+            label: string;
+            /**
+             * Description the orchestrator uses to classify user messages.
+             */
+            description: string;
+            /**
+             * Where the intent is routed once detected — response agent, human escalation, or a specialist.
+             */
+            route: {
+                /**
+                 * Routing target — `response` (straight to the response agent), `human` (escalation), or `specialist`.
+                 */
+                type: 'response' | 'human' | 'specialist';
+                /**
+                 * Machine name of the specialist agent — required when `type` is `specialist`, ignored otherwise.
+                 */
+                agentName?: string;
+            };
+            /**
+             * Effective processing mode at the request scope.
+             */
+            mode: 'disabled' | 'copilot' | 'autopilot';
+            /**
+             * Whether the user must be identified before processing.
+             */
+            requiresUserInfo: boolean;
+            /**
+             * Display order in the intent list.
+             */
+            order: number;
+            /**
+             * Cascade level this view was resolved at.
+             */
             scope: {
+                /**
+                 * Cascade level of this view — `global` (applies everywhere), `organization`, or `entity`.
+                 */
                 level: 'global' | 'organization' | 'entity';
+                /**
+                 * Organization id when `level` is `organization` or `entity`.
+                 */
                 organizationId?: string;
+                /**
+                 * Entity id when `level` is `entity`.
+                 */
                 entityId?: string;
             };
-            version: number;
-            hasDraft: boolean;
-            publishedAt?: string;
-            updatedAt: string;
         }>;
-        /**
-         * Total number of items matching the query.
+    };
+};
+export type List4Response = List4Responses[keyof List4Responses];
+export type Create3Data = {
+    body?: {
+        /**
+         * Human-readable label. The intent's machine name is derived from it (lower-cased, words joined by `_`).
+         */
+        label: string;
+        /**
+         * Description the orchestrator uses to classify user messages.
+         */
+        description: string;
+        /**
+         * Where the intent is routed once detected — response agent, human escalation, or a specialist. Defaults to direct response.
+         */
+        route?: {
+            /**
+             * Routing target — `response` (straight to the response agent), `human` (escalation), or `specialist`.
+             */
+            type: 'response' | 'human' | 'specialist';
+            /**
+             * Machine name of the specialist agent — required when `type` is `specialist`, ignored otherwise.
+             */
+            agentName?: string;
+        };
+        /**
+         * Processing mode (`disabled` / `copilot` / `autopilot`). Defaults to `copilot`.
+         */
+        mode?: 'disabled' | 'copilot' | 'autopilot';
+        /**
+         * Whether the user must be identified before the intent is processed. Defaults to `true`.
+         */
+        requiresUserInfo?: boolean;
+        /**
+         * Display order in the intent list (lower first). Defaults to 0.
+         */
+        order?: number;
+    };
+    path?: never;
+    query?: never;
+    url: '/intents';
+};
+export type Create3Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type Create3Error = Create3Errors[keyof Create3Errors];
+export type Create3Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Opaque intent id (prefixed `int_`).
+         */
+        id: string;
+        /**
+         * Machine name — stable identifier used across the API.
+         */
+        intent: string;
+        /**
+         * Human-readable label.
+         */
+        label: string;
+        /**
+         * Description the orchestrator uses to classify user messages.
+         */
+        description: string;
+        /**
+         * Where the intent is routed once detected — response agent, human escalation, or a specialist.
+         */
+        route: {
+            /**
+             * Routing target — `response` (straight to the response agent), `human` (escalation), or `specialist`.
+             */
+            type: 'response' | 'human' | 'specialist';
+            /**
+             * Machine name of the specialist agent — required when `type` is `specialist`, ignored otherwise.
+             */
+            agentName?: string;
+        };
+        /**
+         * Effective processing mode at the request scope.
+         */
+        mode: 'disabled' | 'copilot' | 'autopilot';
+        /**
+         * Whether the user must be identified before processing.
+         */
+        requiresUserInfo: boolean;
+        /**
+         * Display order in the intent list.
+         */
+        order: number;
+        /**
+         * Cascade level this view was resolved at.
+         */
+        scope: {
+            /**
+             * Cascade level of this view — `global` (applies everywhere), `organization`, or `entity`.
+             */
+            level: 'global' | 'organization' | 'entity';
+            /**
+             * Organization id when `level` is `organization` or `entity`.
+             */
+            organizationId?: string;
+            /**
+             * Entity id when `level` is `entity`.
+             */
+            entityId?: string;
+        };
+    };
+};
+export type Create3Response = Create3Responses[keyof Create3Responses];
+export type Delete3Data = {
+    body?: never;
+    path: {
+        id: string;
+    };
+    query?: never;
+    url: '/intents/{id}';
+};
+export type Delete3Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type Delete3Error = Delete3Errors[keyof Delete3Errors];
+export type Delete3Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Confirmation message describing the outcome.
+         */
+        message: string;
+    };
+};
+export type Delete3Response = Delete3Responses[keyof Delete3Responses];
+export type Get4Data = {
+    body?: never;
+    path: {
+        id: string;
+    };
+    query?: {
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
+    };
+    url: '/intents/{id}';
+};
+export type Get4Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type Get4Error = Get4Errors[keyof Get4Errors];
+export type Get4Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Opaque intent id (prefixed `int_`).
+         */
+        id: string;
+        /**
+         * Machine name — stable identifier used across the API.
+         */
+        intent: string;
+        /**
+         * Human-readable label.
+         */
+        label: string;
+        /**
+         * Description the orchestrator uses to classify user messages.
+         */
+        description: string;
+        /**
+         * Where the intent is routed once detected — response agent, human escalation, or a specialist.
+         */
+        route: {
+            /**
+             * Routing target — `response` (straight to the response agent), `human` (escalation), or `specialist`.
+             */
+            type: 'response' | 'human' | 'specialist';
+            /**
+             * Machine name of the specialist agent — required when `type` is `specialist`, ignored otherwise.
+             */
+            agentName?: string;
+        };
+        /**
+         * Effective processing mode at the request scope.
+         */
+        mode: 'disabled' | 'copilot' | 'autopilot';
+        /**
+         * Whether the user must be identified before processing.
+         */
+        requiresUserInfo: boolean;
+        /**
+         * Display order in the intent list.
+         */
+        order: number;
+        /**
+         * Cascade level this view was resolved at.
+         */
+        scope: {
+            /**
+             * Cascade level of this view — `global` (applies everywhere), `organization`, or `entity`.
+             */
+            level: 'global' | 'organization' | 'entity';
+            /**
+             * Organization id when `level` is `organization` or `entity`.
+             */
+            organizationId?: string;
+            /**
+             * Entity id when `level` is `entity`.
+             */
+            entityId?: string;
+        };
+    };
+};
+export type Get4Response = Get4Responses[keyof Get4Responses];
+export type Update3Data = {
+    body?: {
+        /**
+         * Human-readable label.
+         */
+        label?: string;
+        /**
+         * Description the orchestrator uses to classify user messages.
+         */
+        description?: string;
+        /**
+         * Where the intent is routed once detected. Editable at global scope only.
+         */
+        route?: {
+            /**
+             * Routing target — `response` (straight to the response agent), `human` (escalation), or `specialist`.
+             */
+            type: 'response' | 'human' | 'specialist';
+            /**
+             * Machine name of the specialist agent — required when `type` is `specialist`, ignored otherwise.
+             */
+            agentName?: string;
+        };
+        /**
+         * Processing mode (`disabled` / `copilot` / `autopilot`) — the only field accepted at organization/entity scope.
+         */
+        mode?: 'disabled' | 'copilot' | 'autopilot';
+        /**
+         * Whether the user must be identified before processing.
+         */
+        requiresUserInfo?: boolean;
+        /**
+         * Display order in the intent list (lower first).
+         */
+        order?: number;
+    };
+    path: {
+        id: string;
+    };
+    query?: {
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
+    };
+    url: '/intents/{id}';
+};
+export type Update3Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type Update3Error = Update3Errors[keyof Update3Errors];
+export type Update3Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Opaque intent id (prefixed `int_`).
+         */
+        id: string;
+        /**
+         * Machine name — stable identifier used across the API.
+         */
+        intent: string;
+        /**
+         * Human-readable label.
+         */
+        label: string;
+        /**
+         * Description the orchestrator uses to classify user messages.
+         */
+        description: string;
+        /**
+         * Where the intent is routed once detected — response agent, human escalation, or a specialist.
+         */
+        route: {
+            /**
+             * Routing target — `response` (straight to the response agent), `human` (escalation), or `specialist`.
+             */
+            type: 'response' | 'human' | 'specialist';
+            /**
+             * Machine name of the specialist agent — required when `type` is `specialist`, ignored otherwise.
+             */
+            agentName?: string;
+        };
+        /**
+         * Effective processing mode at the request scope.
+         */
+        mode: 'disabled' | 'copilot' | 'autopilot';
+        /**
+         * Whether the user must be identified before processing.
+         */
+        requiresUserInfo: boolean;
+        /**
+         * Display order in the intent list.
+         */
+        order: number;
+        /**
+         * Cascade level this view was resolved at.
+         */
+        scope: {
+            /**
+             * Cascade level of this view — `global` (applies everywhere), `organization`, or `entity`.
+             */
+            level: 'global' | 'organization' | 'entity';
+            /**
+             * Organization id when `level` is `organization` or `entity`.
+             */
+            organizationId?: string;
+            /**
+             * Entity id when `level` is `entity`.
+             */
+            entityId?: string;
+        };
+    };
+};
+export type Update3Response = Update3Responses[keyof Update3Responses];
+export type DeleteOverride2Data = {
+    body?: never;
+    path: {
+        id: string;
+    };
+    query?: {
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
+    };
+    url: '/intents/{id}/override';
+};
+export type DeleteOverride2Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type DeleteOverride2Error = DeleteOverride2Errors[keyof DeleteOverride2Errors];
+export type DeleteOverride2Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Confirmation message describing the outcome.
+         */
+        message: string;
+    };
+};
+export type DeleteOverride2Response = DeleteOverride2Responses[keyof DeleteOverride2Responses];
+export type List5Data = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Max number of items to return per page (1-100).
+         */
+        limit?: number;
+        /**
+         * Number of items to skip for pagination.
+         */
+        offset?: number | null;
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
+    };
+    url: '/kb';
+};
+export type List5Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type List5Error = List5Errors[keyof List5Errors];
+export type List5Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        articles: Array<{
+            /**
+             * KB article ID (format: kb_xxxxxxxxxxxx).
+             */
+            id: string;
+            /**
+             * Current published title of the article.
+             */
+            title: string;
+            /**
+             * Intent IDs this article serves. Empty array = always-on within its scope.
+             */
+            intents: Array<string>;
+            /**
+             * Cascade level at which this article was created.
+             */
+            scope: {
+                /**
+                 * Cascade level this article lives at — `global` (whole tenant), `organization` (per-org), or `entity` (per-entity).
+                 */
+                level: 'global' | 'organization' | 'entity';
+                /**
+                 * ID of the organization when `level` is `organization` or `entity`.
+                 */
+                organizationId?: string;
+                /**
+                 * ID of the entity when `level` is `entity`.
+                 */
+                entityId?: string;
+            };
+            /**
+             * Version number of the published content.
+             */
+            version: number;
+            /**
+             * True when an unpublished draft exists on this article.
+             */
+            hasDraft: boolean;
+            /**
+             * ISO timestamp of the last publication.
+             */
+            publishedAt?: string;
+            /**
+             * ISO timestamp of the last modification.
+             */
+            updatedAt: string;
+        }>;
+        /**
+         * Total number of items matching the query.
          */
         total: number;
         /**
@@ -2047,8 +4008,8 @@ export type List4Responses = {
         offset: number;
     };
 };
-export type List4Response = List4Responses[keyof List4Responses];
-export type Create3Data = {
+export type List5Response = List5Responses[keyof List5Responses];
+export type Create4Data = {
     body?: {
         /**
          * Article title.
@@ -2072,7 +4033,7 @@ export type Create3Data = {
     };
     url: '/kb';
 };
-export type Create3Errors = {
+export type Create4Errors = {
     /**
      * Bad request
      */
@@ -2104,8 +4065,8 @@ export type Create3Errors = {
         };
     };
 };
-export type Create3Error = Create3Errors[keyof Create3Errors];
-export type Create3Responses = {
+export type Create4Error = Create4Errors[keyof Create4Errors];
+export type Create4Responses = {
     /**
      * Successful response
      */
@@ -2114,32 +4075,89 @@ export type Create3Responses = {
          * KB article ID (format: kb_xxxxxxxxxxxx).
          */
         id: string;
+        /**
+         * Cascade level at which this article was created.
+         */
         scope: {
+            /**
+             * Cascade level this article lives at — `global` (whole tenant), `organization` (per-org), or `entity` (per-entity).
+             */
             level: 'global' | 'organization' | 'entity';
+            /**
+             * ID of the organization when `level` is `organization` or `entity`.
+             */
             organizationId?: string;
+            /**
+             * ID of the entity when `level` is `entity`.
+             */
             entityId?: string;
         };
+        /**
+         * Intent IDs this article serves. Empty array = always-on within its scope.
+         */
         intents: Array<string>;
+        /**
+         * Currently published content of the article.
+         */
         published: {
+            /**
+             * Monotonic version number of this snapshot.
+             */
             version: number;
+            /**
+             * Article title at this version.
+             */
             title: string;
+            /**
+             * Article body (Markdown) at this version.
+             */
             content: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
+        /**
+         * Pending draft content, when one exists. Promote it via `publish: true` on update.
+         */
         draft?: {
+            /**
+             * Monotonic version number of this snapshot.
+             */
             version: number;
+            /**
+             * Article title at this version.
+             */
             title: string;
+            /**
+             * Article body (Markdown) at this version.
+             */
             content: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
+        /**
+         * ISO timestamp when the article was created.
+         */
         createdAt: string;
+        /**
+         * ISO timestamp of the last modification (publish, draft edit, intents change).
+         */
         updatedAt: string;
     };
 };
-export type Create3Response = Create3Responses[keyof Create3Responses];
-export type Delete3Data = {
+export type Create4Response = Create4Responses[keyof Create4Responses];
+export type Delete4Data = {
     body?: never;
     path: {
         /**
@@ -2150,7 +4168,7 @@ export type Delete3Data = {
     query?: never;
     url: '/kb/{id}';
 };
-export type Delete3Errors = {
+export type Delete4Errors = {
     /**
      * Bad request
      */
@@ -2182,17 +4200,20 @@ export type Delete3Errors = {
         };
     };
 };
-export type Delete3Error = Delete3Errors[keyof Delete3Errors];
-export type Delete3Responses = {
+export type Delete4Error = Delete4Errors[keyof Delete4Errors];
+export type Delete4Responses = {
     /**
      * Successful response
      */
     200: {
+        /**
+         * Confirmation message describing the deletion outcome.
+         */
         message: string;
     };
 };
-export type Delete3Response = Delete3Responses[keyof Delete3Responses];
-export type Get4Data = {
+export type Delete4Response = Delete4Responses[keyof Delete4Responses];
+export type Get5Data = {
     body?: never;
     path: {
         /**
@@ -2203,7 +4224,7 @@ export type Get4Data = {
     query?: never;
     url: '/kb/{id}';
 };
-export type Get4Errors = {
+export type Get5Errors = {
     /**
      * Bad request
      */
@@ -2235,8 +4256,8 @@ export type Get4Errors = {
         };
     };
 };
-export type Get4Error = Get4Errors[keyof Get4Errors];
-export type Get4Responses = {
+export type Get5Error = Get5Errors[keyof Get5Errors];
+export type Get5Responses = {
     /**
      * Successful response
      */
@@ -2245,32 +4266,89 @@ export type Get4Responses = {
          * KB article ID (format: kb_xxxxxxxxxxxx).
          */
         id: string;
+        /**
+         * Cascade level at which this article was created.
+         */
         scope: {
+            /**
+             * Cascade level this article lives at — `global` (whole tenant), `organization` (per-org), or `entity` (per-entity).
+             */
             level: 'global' | 'organization' | 'entity';
+            /**
+             * ID of the organization when `level` is `organization` or `entity`.
+             */
             organizationId?: string;
+            /**
+             * ID of the entity when `level` is `entity`.
+             */
             entityId?: string;
         };
+        /**
+         * Intent IDs this article serves. Empty array = always-on within its scope.
+         */
         intents: Array<string>;
+        /**
+         * Currently published content of the article.
+         */
         published: {
+            /**
+             * Monotonic version number of this snapshot.
+             */
             version: number;
+            /**
+             * Article title at this version.
+             */
             title: string;
+            /**
+             * Article body (Markdown) at this version.
+             */
             content: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
+        /**
+         * Pending draft content, when one exists. Promote it via `publish: true` on update.
+         */
         draft?: {
+            /**
+             * Monotonic version number of this snapshot.
+             */
             version: number;
+            /**
+             * Article title at this version.
+             */
             title: string;
+            /**
+             * Article body (Markdown) at this version.
+             */
             content: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
+        /**
+         * ISO timestamp when the article was created.
+         */
         createdAt: string;
+        /**
+         * ISO timestamp of the last modification (publish, draft edit, intents change).
+         */
         updatedAt: string;
     };
 };
-export type Get4Response = Get4Responses[keyof Get4Responses];
-export type Update3Data = {
+export type Get5Response = Get5Responses[keyof Get5Responses];
+export type Update4Data = {
     body?: {
         /**
          * New article title.
@@ -2298,7 +4376,7 @@ export type Update3Data = {
     query?: never;
     url: '/kb/{id}';
 };
-export type Update3Errors = {
+export type Update4Errors = {
     /**
      * Bad request
      */
@@ -2330,8 +4408,8 @@ export type Update3Errors = {
         };
     };
 };
-export type Update3Error = Update3Errors[keyof Update3Errors];
-export type Update3Responses = {
+export type Update4Error = Update4Errors[keyof Update4Errors];
+export type Update4Responses = {
     /**
      * Successful response
      */
@@ -2340,31 +4418,88 @@ export type Update3Responses = {
          * KB article ID (format: kb_xxxxxxxxxxxx).
          */
         id: string;
+        /**
+         * Cascade level at which this article was created.
+         */
         scope: {
+            /**
+             * Cascade level this article lives at — `global` (whole tenant), `organization` (per-org), or `entity` (per-entity).
+             */
             level: 'global' | 'organization' | 'entity';
+            /**
+             * ID of the organization when `level` is `organization` or `entity`.
+             */
             organizationId?: string;
+            /**
+             * ID of the entity when `level` is `entity`.
+             */
             entityId?: string;
         };
+        /**
+         * Intent IDs this article serves. Empty array = always-on within its scope.
+         */
         intents: Array<string>;
+        /**
+         * Currently published content of the article.
+         */
         published: {
+            /**
+             * Monotonic version number of this snapshot.
+             */
             version: number;
+            /**
+             * Article title at this version.
+             */
             title: string;
+            /**
+             * Article body (Markdown) at this version.
+             */
             content: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
+        /**
+         * Pending draft content, when one exists. Promote it via `publish: true` on update.
+         */
         draft?: {
+            /**
+             * Monotonic version number of this snapshot.
+             */
             version: number;
+            /**
+             * Article title at this version.
+             */
             title: string;
+            /**
+             * Article body (Markdown) at this version.
+             */
             content: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
+        /**
+         * ISO timestamp when the article was created.
+         */
         createdAt: string;
+        /**
+         * ISO timestamp of the last modification (publish, draft edit, intents change).
+         */
         updatedAt: string;
     };
 };
-export type Update3Response = Update3Responses[keyof Update3Responses];
+export type Update4Response = Update4Responses[keyof Update4Responses];
 export type Publish2Data = {
     body?: never;
     path: {
@@ -2418,27 +4553,84 @@ export type Publish2Responses = {
          * KB article ID (format: kb_xxxxxxxxxxxx).
          */
         id: string;
+        /**
+         * Cascade level at which this article was created.
+         */
         scope: {
+            /**
+             * Cascade level this article lives at — `global` (whole tenant), `organization` (per-org), or `entity` (per-entity).
+             */
             level: 'global' | 'organization' | 'entity';
+            /**
+             * ID of the organization when `level` is `organization` or `entity`.
+             */
             organizationId?: string;
+            /**
+             * ID of the entity when `level` is `entity`.
+             */
             entityId?: string;
         };
+        /**
+         * Intent IDs this article serves. Empty array = always-on within its scope.
+         */
         intents: Array<string>;
+        /**
+         * Currently published content of the article.
+         */
         published: {
+            /**
+             * Monotonic version number of this snapshot.
+             */
             version: number;
+            /**
+             * Article title at this version.
+             */
             title: string;
+            /**
+             * Article body (Markdown) at this version.
+             */
             content: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
+        /**
+         * Pending draft content, when one exists. Promote it via `publish: true` on update.
+         */
         draft?: {
+            /**
+             * Monotonic version number of this snapshot.
+             */
             version: number;
+            /**
+             * Article title at this version.
+             */
             title: string;
+            /**
+             * Article body (Markdown) at this version.
+             */
             content: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
+        /**
+         * ISO timestamp when the article was created.
+         */
         createdAt: string;
+        /**
+         * ISO timestamp of the last modification (publish, draft edit, intents change).
+         */
         updatedAt: string;
     };
 };
@@ -2501,32 +4693,89 @@ export type Rollback2Responses = {
          * KB article ID (format: kb_xxxxxxxxxxxx).
          */
         id: string;
+        /**
+         * Cascade level at which this article was created.
+         */
         scope: {
+            /**
+             * Cascade level this article lives at — `global` (whole tenant), `organization` (per-org), or `entity` (per-entity).
+             */
             level: 'global' | 'organization' | 'entity';
+            /**
+             * ID of the organization when `level` is `organization` or `entity`.
+             */
             organizationId?: string;
+            /**
+             * ID of the entity when `level` is `entity`.
+             */
             entityId?: string;
         };
+        /**
+         * Intent IDs this article serves. Empty array = always-on within its scope.
+         */
         intents: Array<string>;
+        /**
+         * Currently published content of the article.
+         */
         published: {
+            /**
+             * Monotonic version number of this snapshot.
+             */
             version: number;
+            /**
+             * Article title at this version.
+             */
             title: string;
+            /**
+             * Article body (Markdown) at this version.
+             */
             content: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
+        /**
+         * Pending draft content, when one exists. Promote it via `publish: true` on update.
+         */
         draft?: {
+            /**
+             * Monotonic version number of this snapshot.
+             */
             version: number;
+            /**
+             * Article title at this version.
+             */
             title: string;
+            /**
+             * Article body (Markdown) at this version.
+             */
             content: string;
+            /**
+             * ISO timestamp of the publication that produced this snapshot.
+             */
             publishedAt?: string;
+            /**
+             * ISO timestamp of the last draft edit (drafts only).
+             */
             updatedAt?: string;
         };
+        /**
+         * ISO timestamp when the article was created.
+         */
         createdAt: string;
+        /**
+         * ISO timestamp of the last modification (publish, draft edit, intents change).
+         */
         updatedAt: string;
     };
 };
 export type Rollback2Response = Rollback2Responses[keyof Rollback2Responses];
-export type List5Data = {
+export type List6Data = {
     body?: never;
     path?: never;
     query?: {
@@ -2545,7 +4794,7 @@ export type List5Data = {
     };
     url: '/organizations';
 };
-export type List5Errors = {
+export type List6Errors = {
     /**
      * Bad request
      */
@@ -2577,8 +4826,8 @@ export type List5Errors = {
         };
     };
 };
-export type List5Error = List5Errors[keyof List5Errors];
-export type List5Responses = {
+export type List6Error = List6Errors[keyof List6Errors];
+export type List6Responses = {
     /**
      * Successful response
      */
@@ -2615,8 +4864,8 @@ export type List5Responses = {
         offset: number;
     };
 };
-export type List5Response = List5Responses[keyof List5Responses];
-export type Create4Data = {
+export type List6Response = List6Responses[keyof List6Responses];
+export type Create5Data = {
     body?: {
         /**
          * Human-readable name of the organization (must be unique).
@@ -2637,7 +4886,7 @@ export type Create4Data = {
     query?: never;
     url: '/organizations';
 };
-export type Create4Errors = {
+export type Create5Errors = {
     /**
      * Bad request
      */
@@ -2669,8 +4918,8 @@ export type Create4Errors = {
         };
     };
 };
-export type Create4Error = Create4Errors[keyof Create4Errors];
-export type Create4Responses = {
+export type Create5Error = Create5Errors[keyof Create5Errors];
+export type Create5Responses = {
     /**
      * Successful response
      */
@@ -2708,8 +4957,8 @@ export type Create4Responses = {
         apiKey?: string;
     };
 };
-export type Create4Response = Create4Responses[keyof Create4Responses];
-export type Delete4Data = {
+export type Create5Response = Create5Responses[keyof Create5Responses];
+export type Delete5Data = {
     body?: never;
     path: {
         /**
@@ -2720,7 +4969,7 @@ export type Delete4Data = {
     query?: never;
     url: '/organizations/{id}';
 };
-export type Delete4Errors = {
+export type Delete5Errors = {
     /**
      * Bad request
      */
@@ -2752,8 +5001,8 @@ export type Delete4Errors = {
         };
     };
 };
-export type Delete4Error = Delete4Errors[keyof Delete4Errors];
-export type Delete4Responses = {
+export type Delete5Error = Delete5Errors[keyof Delete5Errors];
+export type Delete5Responses = {
     /**
      * Successful response
      */
@@ -2764,8 +5013,8 @@ export type Delete4Responses = {
         message: string;
     };
 };
-export type Delete4Response = Delete4Responses[keyof Delete4Responses];
-export type Get5Data = {
+export type Delete5Response = Delete5Responses[keyof Delete5Responses];
+export type Get6Data = {
     body?: never;
     path: {
         /**
@@ -2776,7 +5025,7 @@ export type Get5Data = {
     query?: never;
     url: '/organizations/{id}';
 };
-export type Get5Errors = {
+export type Get6Errors = {
     /**
      * Bad request
      */
@@ -2808,8 +5057,8 @@ export type Get5Errors = {
         };
     };
 };
-export type Get5Error = Get5Errors[keyof Get5Errors];
-export type Get5Responses = {
+export type Get6Error = Get6Errors[keyof Get6Errors];
+export type Get6Responses = {
     /**
      * Successful response
      */
@@ -2838,8 +5087,8 @@ export type Get5Responses = {
         };
     };
 };
-export type Get5Response = Get5Responses[keyof Get5Responses];
-export type Update4Data = {
+export type Get6Response = Get6Responses[keyof Get6Responses];
+export type Update5Data = {
     body?: {
         /**
          * New name for the organization.
@@ -2861,7 +5110,7 @@ export type Update4Data = {
     query?: never;
     url: '/organizations/{id}';
 };
-export type Update4Errors = {
+export type Update5Errors = {
     /**
      * Bad request
      */
@@ -2893,8 +5142,8 @@ export type Update4Errors = {
         };
     };
 };
-export type Update4Error = Update4Errors[keyof Update4Errors];
-export type Update4Responses = {
+export type Update5Error = Update5Errors[keyof Update5Errors];
+export type Update5Responses = {
     /**
      * Successful response
      */
@@ -2923,5 +5172,5 @@ export type Update4Responses = {
         };
     };
 };
-export type Update4Response = Update4Responses[keyof Update4Responses];
+export type Update5Response = Update5Responses[keyof Update5Responses];
 //# sourceMappingURL=types.gen.d.ts.map