@operla-ai/sdk 0.3.6 → 0.4.0

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

@@ -3268,6 +3268,629 @@ export type Update2Responses = {
 };
 export type Update2Response = Update2Responses[keyof Update2Responses];
 export type List4Data = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
+    };
+    url: '/intents';
+};
+export type List4Errors = {
+    /**
+     * 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 List4Error = List4Errors[keyof List4Errors];
+export type List4Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Intents visible at the caller's scope.
+         */
+        intents: Array<{
+            /**
+             * 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 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?: {
@@ -3286,7 +3909,7 @@ export type List4Data = {
     };
     url: '/kb';
 };
-export type List4Errors = {
+export type List5Errors = {
     /**
      * Bad request
      */
@@ -3318,8 +3941,8 @@ export type List4Errors = {
         };
     };
 };
-export type List4Error = List4Errors[keyof List4Errors];
-export type List4Responses = {
+export type List5Error = List5Errors[keyof List5Errors];
+export type List5Responses = {
     /**
      * Successful response
      */
@@ -3385,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.
@@ -3410,7 +4033,7 @@ export type Create3Data = {
     };
     url: '/kb';
 };
-export type Create3Errors = {
+export type Create4Errors = {
     /**
      * Bad request
      */
@@ -3442,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
      */
@@ -3533,8 +4156,8 @@ export type Create3Responses = {
         updatedAt: string;
     };
 };
-export type Create3Response = Create3Responses[keyof Create3Responses];
-export type Delete3Data = {
+export type Create4Response = Create4Responses[keyof Create4Responses];
+export type Delete4Data = {
     body?: never;
     path: {
         /**
@@ -3545,7 +4168,7 @@ export type Delete3Data = {
     query?: never;
     url: '/kb/{id}';
 };
-export type Delete3Errors = {
+export type Delete4Errors = {
     /**
      * Bad request
      */
@@ -3577,8 +4200,8 @@ export type Delete3Errors = {
         };
     };
 };
-export type Delete3Error = Delete3Errors[keyof Delete3Errors];
-export type Delete3Responses = {
+export type Delete4Error = Delete4Errors[keyof Delete4Errors];
+export type Delete4Responses = {
     /**
      * Successful response
      */
@@ -3589,8 +4212,8 @@ export type Delete3Responses = {
         message: string;
     };
 };
-export type Delete3Response = Delete3Responses[keyof Delete3Responses];
-export type Get4Data = {
+export type Delete4Response = Delete4Responses[keyof Delete4Responses];
+export type Get5Data = {
     body?: never;
     path: {
         /**
@@ -3601,7 +4224,7 @@ export type Get4Data = {
     query?: never;
     url: '/kb/{id}';
 };
-export type Get4Errors = {
+export type Get5Errors = {
     /**
      * Bad request
      */
@@ -3633,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
      */
@@ -3724,8 +4347,8 @@ export type Get4Responses = {
         updatedAt: string;
     };
 };
-export type Get4Response = Get4Responses[keyof Get4Responses];
-export type Update3Data = {
+export type Get5Response = Get5Responses[keyof Get5Responses];
+export type Update4Data = {
     body?: {
         /**
          * New article title.
@@ -3753,7 +4376,7 @@ export type Update3Data = {
     query?: never;
     url: '/kb/{id}';
 };
-export type Update3Errors = {
+export type Update4Errors = {
     /**
      * Bad request
      */
@@ -3785,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
      */
@@ -3876,7 +4499,7 @@ export type Update3Responses = {
         updatedAt: string;
     };
 };
-export type Update3Response = Update3Responses[keyof Update3Responses];
+export type Update4Response = Update4Responses[keyof Update4Responses];
 export type Publish2Data = {
     body?: never;
     path: {
@@ -4152,7 +4775,7 @@ export type Rollback2Responses = {
     };
 };
 export type Rollback2Response = Rollback2Responses[keyof Rollback2Responses];
-export type List5Data = {
+export type List6Data = {
     body?: never;
     path?: never;
     query?: {
@@ -4171,7 +4794,7 @@ export type List5Data = {
     };
     url: '/organizations';
 };
-export type List5Errors = {
+export type List6Errors = {
     /**
      * Bad request
      */
@@ -4203,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
      */
@@ -4241,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).
@@ -4263,7 +4886,7 @@ export type Create4Data = {
     query?: never;
     url: '/organizations';
 };
-export type Create4Errors = {
+export type Create5Errors = {
     /**
      * Bad request
      */
@@ -4295,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
      */
@@ -4334,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: {
         /**
@@ -4346,7 +4969,7 @@ export type Delete4Data = {
     query?: never;
     url: '/organizations/{id}';
 };
-export type Delete4Errors = {
+export type Delete5Errors = {
     /**
      * Bad request
      */
@@ -4378,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
      */
@@ -4390,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: {
         /**
@@ -4402,7 +5025,7 @@ export type Get5Data = {
     query?: never;
     url: '/organizations/{id}';
 };
-export type Get5Errors = {
+export type Get6Errors = {
     /**
      * Bad request
      */
@@ -4434,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
      */
@@ -4464,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.
@@ -4487,7 +5110,7 @@ export type Update4Data = {
     query?: never;
     url: '/organizations/{id}';
 };
-export type Update4Errors = {
+export type Update5Errors = {
     /**
      * Bad request
      */
@@ -4519,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
      */
@@ -4549,5 +5172,5 @@ export type Update4Responses = {
         };
     };
 };
-export type Update4Response = Update4Responses[keyof Update4Responses];
+export type Update5Response = Update5Responses[keyof Update5Responses];
 //# sourceMappingURL=types.gen.d.ts.map