@operla-ai/sdk 1.0.0 → 1.1.0

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

@@ -5915,6 +5915,679 @@ export type Update3Responses = {
 };
 export type Update3Response = Update3Responses[keyof Update3Responses];
 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;
+        /**
+         * Filter by status. Defaults to `open`.
+         */
+        status?: 'open' | 'resolved' | 'dismissed';
+        /**
+         * Filter by severity.
+         */
+        severity?: 'high' | 'medium' | 'low';
+        /**
+         * Keep insights citing this review failure reason.
+         */
+        reason?: 'ai_error' | 'context_issue' | 'config_issue';
+    };
+    url: '/insights';
+};
+export type List5Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+};
+export type List5Error = List5Errors[keyof List5Errors];
+export type List5Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * This page of insights — at most `limit` items, starting at `offset`.
+         */
+        insights: Array<{
+            /**
+             * Insight ID (format: ins_xxxxxxxxxxxx).
+             */
+            id: string;
+            /**
+             * Short AI-written title.
+             */
+            title: string;
+            /**
+             * What the AI observed across the failures backing this insight.
+             */
+            summary: string;
+            /**
+             * What the AI suggests changing (prompt, KB, config, …).
+             */
+            recommendation: string;
+            /**
+             * Review failure reasons cited by the occurrences backing this insight.
+             */
+            failureReasons: Array<'ai_error' | 'context_issue' | 'config_issue'>;
+            /**
+             * How much this hurts, as judged by the AI.
+             */
+            severity: 'high' | 'medium' | 'low';
+            /**
+             * `open` until a human resolves (fixed) or dismisses (not worth acting on) it.
+             */
+            status: 'open' | 'resolved' | 'dismissed';
+            /**
+             * Perimeter the insight applies to.
+             */
+            scope: {
+                /**
+                 * Cascade level the insight was raised at — `global`, `organization` or `entity`.
+                 */
+                level: 'global' | 'organization' | 'entity';
+                /**
+                 * Organization the insight is scoped to; null at global scope.
+                 */
+                organization: {
+                    /**
+                     * Opaque id of the referenced doc.
+                     */
+                    id: string;
+                    /**
+                     * Display name of the referenced doc, denormalized so no extra fetch is needed.
+                     */
+                    name: string;
+                } | null;
+                /**
+                 * Entity the insight is scoped to; null unless `level` is `entity`.
+                 */
+                entity: {
+                    /**
+                     * Opaque id of the referenced doc.
+                     */
+                    id: string;
+                    /**
+                     * Display name of the referenced doc, denormalized so no extra fetch is needed.
+                     */
+                    name: string;
+                } | null;
+            };
+            /**
+             * Reviewed failures backing the insight, oldest first.
+             */
+            occurrences: Array<{
+                /**
+                 * Conversation the reviewed failure belongs to (format: `conv_xxxxxxxxxxxx`).
+                 */
+                conversationId: string;
+                /**
+                 * Zero-based index of the AI turn that was reviewed inside that conversation.
+                 */
+                analysisIndex: number;
+                /**
+                 * ISO timestamp of the human review.
+                 */
+                reviewedAt: string;
+            }>;
+            /**
+             * ISO timestamp of the most recent occurrence.
+             */
+            lastOccurrenceAt: string;
+            /**
+             * Derived at read time — `rising` (more occurrences in the last 14 days than the previous 14), `improving` (no new occurrence despite sustained review activity), `unknown` (quiet, but too little review activity to conclude), `stable` otherwise.
+             */
+            trend: 'rising' | 'stable' | 'improving' | 'unknown';
+            /**
+             * ISO timestamp when the insight was first raised.
+             */
+            createdAt: string;
+            /**
+             * ISO timestamp of the last update.
+             */
+            updatedAt: string;
+            /**
+             * Who resolved or dismissed it — null while open, and null when the change came from an API key (no operator identity).
+             */
+            resolvedBy: {
+                /**
+                 * Dashboard user who changed the status.
+                 */
+                userId: string;
+                /**
+                 * Their username.
+                 */
+                username: string;
+            } | null;
+        }>;
+        /**
+         * Total number of items matching the query.
+         */
+        total: number;
+        /**
+         * Page size applied to this response.
+         */
+        limit: number;
+        /**
+         * Offset applied to this response.
+         */
+        offset: number;
+    };
+};
+export type List5Response = List5Responses[keyof List5Responses];
+export type Get5Data = {
+    body?: never;
+    path: {
+        /**
+         * Insight ID (format: `ins_xxxxxxxxxxxx`).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/insights/{id}';
+};
+export type Get5Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Insight does not exist.
+     */
+    404: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'NOT-FOUND';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+};
+export type Get5Error = Get5Errors[keyof Get5Errors];
+export type Get5Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Insight ID (format: ins_xxxxxxxxxxxx).
+         */
+        id: string;
+        /**
+         * Short AI-written title.
+         */
+        title: string;
+        /**
+         * What the AI observed across the failures backing this insight.
+         */
+        summary: string;
+        /**
+         * What the AI suggests changing (prompt, KB, config, …).
+         */
+        recommendation: string;
+        /**
+         * Review failure reasons cited by the occurrences backing this insight.
+         */
+        failureReasons: Array<'ai_error' | 'context_issue' | 'config_issue'>;
+        /**
+         * How much this hurts, as judged by the AI.
+         */
+        severity: 'high' | 'medium' | 'low';
+        /**
+         * `open` until a human resolves (fixed) or dismisses (not worth acting on) it.
+         */
+        status: 'open' | 'resolved' | 'dismissed';
+        /**
+         * Perimeter the insight applies to.
+         */
+        scope: {
+            /**
+             * Cascade level the insight was raised at — `global`, `organization` or `entity`.
+             */
+            level: 'global' | 'organization' | 'entity';
+            /**
+             * Organization the insight is scoped to; null at global scope.
+             */
+            organization: {
+                /**
+                 * Opaque id of the referenced doc.
+                 */
+                id: string;
+                /**
+                 * Display name of the referenced doc, denormalized so no extra fetch is needed.
+                 */
+                name: string;
+            } | null;
+            /**
+             * Entity the insight is scoped to; null unless `level` is `entity`.
+             */
+            entity: {
+                /**
+                 * Opaque id of the referenced doc.
+                 */
+                id: string;
+                /**
+                 * Display name of the referenced doc, denormalized so no extra fetch is needed.
+                 */
+                name: string;
+            } | null;
+        };
+        /**
+         * Reviewed failures backing the insight, oldest first.
+         */
+        occurrences: Array<{
+            /**
+             * Conversation the reviewed failure belongs to (format: `conv_xxxxxxxxxxxx`).
+             */
+            conversationId: string;
+            /**
+             * Zero-based index of the AI turn that was reviewed inside that conversation.
+             */
+            analysisIndex: number;
+            /**
+             * ISO timestamp of the human review.
+             */
+            reviewedAt: string;
+        }>;
+        /**
+         * ISO timestamp of the most recent occurrence.
+         */
+        lastOccurrenceAt: string;
+        /**
+         * Derived at read time — `rising` (more occurrences in the last 14 days than the previous 14), `improving` (no new occurrence despite sustained review activity), `unknown` (quiet, but too little review activity to conclude), `stable` otherwise.
+         */
+        trend: 'rising' | 'stable' | 'improving' | 'unknown';
+        /**
+         * ISO timestamp when the insight was first raised.
+         */
+        createdAt: string;
+        /**
+         * ISO timestamp of the last update.
+         */
+        updatedAt: string;
+        /**
+         * Who resolved or dismissed it — null while open, and null when the change came from an API key (no operator identity).
+         */
+        resolvedBy: {
+            /**
+             * Dashboard user who changed the status.
+             */
+            userId: string;
+            /**
+             * Their username.
+             */
+            username: string;
+        } | null;
+    };
+};
+export type Get5Response = Get5Responses[keyof Get5Responses];
+export type UpdateStatusData = {
+    body?: {
+        /**
+         * `resolved` once you acted on it, `dismissed` when it isn't worth acting on, `open` to put it back in the queue.
+         */
+        status: 'open' | 'resolved' | 'dismissed';
+    };
+    path: {
+        /**
+         * Insight ID (format: `ins_xxxxxxxxxxxx`).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/insights/{id}/status';
+};
+export type UpdateStatusErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Insight does not exist.
+     */
+    404: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'NOT-FOUND';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+};
+export type UpdateStatusError = UpdateStatusErrors[keyof UpdateStatusErrors];
+export type UpdateStatusResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Insight ID (format: ins_xxxxxxxxxxxx).
+         */
+        id: string;
+        /**
+         * Short AI-written title.
+         */
+        title: string;
+        /**
+         * What the AI observed across the failures backing this insight.
+         */
+        summary: string;
+        /**
+         * What the AI suggests changing (prompt, KB, config, …).
+         */
+        recommendation: string;
+        /**
+         * Review failure reasons cited by the occurrences backing this insight.
+         */
+        failureReasons: Array<'ai_error' | 'context_issue' | 'config_issue'>;
+        /**
+         * How much this hurts, as judged by the AI.
+         */
+        severity: 'high' | 'medium' | 'low';
+        /**
+         * `open` until a human resolves (fixed) or dismisses (not worth acting on) it.
+         */
+        status: 'open' | 'resolved' | 'dismissed';
+        /**
+         * Perimeter the insight applies to.
+         */
+        scope: {
+            /**
+             * Cascade level the insight was raised at — `global`, `organization` or `entity`.
+             */
+            level: 'global' | 'organization' | 'entity';
+            /**
+             * Organization the insight is scoped to; null at global scope.
+             */
+            organization: {
+                /**
+                 * Opaque id of the referenced doc.
+                 */
+                id: string;
+                /**
+                 * Display name of the referenced doc, denormalized so no extra fetch is needed.
+                 */
+                name: string;
+            } | null;
+            /**
+             * Entity the insight is scoped to; null unless `level` is `entity`.
+             */
+            entity: {
+                /**
+                 * Opaque id of the referenced doc.
+                 */
+                id: string;
+                /**
+                 * Display name of the referenced doc, denormalized so no extra fetch is needed.
+                 */
+                name: string;
+            } | null;
+        };
+        /**
+         * Reviewed failures backing the insight, oldest first.
+         */
+        occurrences: Array<{
+            /**
+             * Conversation the reviewed failure belongs to (format: `conv_xxxxxxxxxxxx`).
+             */
+            conversationId: string;
+            /**
+             * Zero-based index of the AI turn that was reviewed inside that conversation.
+             */
+            analysisIndex: number;
+            /**
+             * ISO timestamp of the human review.
+             */
+            reviewedAt: string;
+        }>;
+        /**
+         * ISO timestamp of the most recent occurrence.
+         */
+        lastOccurrenceAt: string;
+        /**
+         * Derived at read time — `rising` (more occurrences in the last 14 days than the previous 14), `improving` (no new occurrence despite sustained review activity), `unknown` (quiet, but too little review activity to conclude), `stable` otherwise.
+         */
+        trend: 'rising' | 'stable' | 'improving' | 'unknown';
+        /**
+         * ISO timestamp when the insight was first raised.
+         */
+        createdAt: string;
+        /**
+         * ISO timestamp of the last update.
+         */
+        updatedAt: string;
+        /**
+         * Who resolved or dismissed it — null while open, and null when the change came from an API key (no operator identity).
+         */
+        resolvedBy: {
+            /**
+             * Dashboard user who changed the status.
+             */
+            userId: string;
+            /**
+             * Their username.
+             */
+            username: string;
+        } | null;
+    };
+};
+export type UpdateStatusResponse = UpdateStatusResponses[keyof UpdateStatusResponses];
+export type List6Data = {
     body?: never;
     path?: never;
     query?: {
@@ -5925,7 +6598,7 @@ export type List5Data = {
     };
     url: '/intents';
 };
-export type List5Errors = {
+export type List6Errors = {
     /**
      * Bad request
      */
@@ -5993,8 +6666,8 @@ export type List5Errors = {
         };
     };
 };
-export type List5Error = List5Errors[keyof List5Errors];
-export type List5Responses = {
+export type List6Error = List6Errors[keyof List6Errors];
+export type List6Responses = {
     /**
      * Successful response
      */
@@ -6060,7 +6733,7 @@ export type List5Responses = {
         }>;
     };
 };
-export type List5Response = List5Responses[keyof List5Responses];
+export type List6Response = List6Responses[keyof List6Responses];
 export type Create5Data = {
     body?: {
         /**
@@ -6324,7 +6997,7 @@ export type Delete5Responses = {
     };
 };
 export type Delete5Response = Delete5Responses[keyof Delete5Responses];
-export type Get5Data = {
+export type Get6Data = {
     body?: never;
     path: {
         /**
@@ -6340,7 +7013,7 @@ export type Get5Data = {
     };
     url: '/intents/{type}';
 };
-export type Get5Errors = {
+export type Get6Errors = {
     /**
      * Bad request
      */
@@ -6408,8 +7081,8 @@ export type Get5Errors = {
         };
     };
 };
-export type Get5Error = Get5Errors[keyof Get5Errors];
-export type Get5Responses = {
+export type Get6Error = Get6Errors[keyof Get6Errors];
+export type Get6Responses = {
     /**
      * Successful response
      */
@@ -6470,7 +7143,7 @@ export type Get5Responses = {
         };
     };
 };
-export type Get5Response = Get5Responses[keyof Get5Responses];
+export type Get6Response = Get6Responses[keyof Get6Responses];
 export type Update4Data = {
     body?: {
         /**
@@ -6745,7 +7418,7 @@ export type DeleteOverride3Responses = {
     };
 };
 export type DeleteOverride3Response = DeleteOverride3Responses[keyof DeleteOverride3Responses];
-export type List6Data = {
+export type List7Data = {
     body?: never;
     path?: never;
     query?: {
@@ -6764,7 +7437,7 @@ export type List6Data = {
     };
     url: '/kb';
 };
-export type List6Errors = {
+export type List7Errors = {
     /**
      * Bad request
      */
@@ -6832,8 +7505,8 @@ export type List6Errors = {
         };
     };
 };
-export type List6Error = List6Errors[keyof List6Errors];
-export type List6Responses = {
+export type List7Error = List7Errors[keyof List7Errors];
+export type List7Responses = {
     /**
      * Successful response
      */
@@ -6902,7 +7575,7 @@ export type List6Responses = {
         offset: number;
     };
 };
-export type List6Response = List6Responses[keyof List6Responses];
+export type List7Response = List7Responses[keyof List7Responses];
 export type Create6Data = {
     body?: {
         /**
@@ -7179,7 +7852,7 @@ export type Delete6Responses = {
     };
 };
 export type Delete6Response = Delete6Responses[keyof Delete6Responses];
-export type Get6Data = {
+export type Get7Data = {
     body?: never;
     path: {
         /**
@@ -7190,7 +7863,7 @@ export type Get6Data = {
     query?: never;
     url: '/kb/{id}';
 };
-export type Get6Errors = {
+export type Get7Errors = {
     /**
      * Bad request
      */
@@ -7258,8 +7931,8 @@ export type Get6Errors = {
         };
     };
 };
-export type Get6Error = Get6Errors[keyof Get6Errors];
-export type Get6Responses = {
+export type Get7Error = Get7Errors[keyof Get7Errors];
+export type Get7Responses = {
     /**
      * Successful response
      */
@@ -7349,7 +8022,7 @@ export type Get6Responses = {
         updatedAt: string;
     };
 };
-export type Get6Response = Get6Responses[keyof Get6Responses];
+export type Get7Response = Get7Responses[keyof Get7Responses];
 export type Update5Data = {
     body?: {
         /**
@@ -8240,7 +8913,7 @@ export type Rollback2Responses = {
     };
 };
 export type Rollback2Response = Rollback2Responses[keyof Rollback2Responses];
-export type List7Data = {
+export type List8Data = {
     body?: never;
     path?: never;
     query?: {
@@ -8259,7 +8932,7 @@ export type List7Data = {
     };
     url: '/organizations';
 };
-export type List7Errors = {
+export type List8Errors = {
     /**
      * Bad request
      */
@@ -8327,8 +9000,8 @@ export type List7Errors = {
         };
     };
 };
-export type List7Error = List7Errors[keyof List7Errors];
-export type List7Responses = {
+export type List8Error = List8Errors[keyof List8Errors];
+export type List8Responses = {
     /**
      * Successful response
      */
@@ -8368,7 +9041,7 @@ export type List7Responses = {
         offset: number;
     };
 };
-export type List7Response = List7Responses[keyof List7Responses];
+export type List8Response = List8Responses[keyof List8Responses];
 export type Create7Data = {
     body?: {
         /**
@@ -8590,7 +9263,7 @@ export type Delete7Responses = {
     };
 };
 export type Delete7Response = Delete7Responses[keyof Delete7Responses];
-export type Get7Data = {
+export type Get8Data = {
     body?: never;
     path: {
         /**
@@ -8601,7 +9274,7 @@ export type Get7Data = {
     query?: never;
     url: '/organizations/{id}';
 };
-export type Get7Errors = {
+export type Get8Errors = {
     /**
      * Bad request
      */
@@ -8669,8 +9342,8 @@ export type Get7Errors = {
         };
     };
 };
-export type Get7Error = Get7Errors[keyof Get7Errors];
-export type Get7Responses = {
+export type Get8Error = Get8Errors[keyof Get8Errors];
+export type Get8Responses = {
     /**
      * Successful response
      */
@@ -8699,7 +9372,7 @@ export type Get7Responses = {
         };
     };
 };
-export type Get7Response = Get7Responses[keyof Get7Responses];
+export type Get8Response = Get8Responses[keyof Get8Responses];
 export type Update6Data = {
     body?: {
         /**