@vibexp/api-client 0.92.0 → 0.93.0

package/dist/schema.d.ts

@@ -3616,6 +3616,140 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/admin/settings/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the instance search ranking settings
+         * @description Returns the instance search ranking defaults in effect, where they come from
+         *     (`instance` or `default`), the built-in defaults, the hard bounds for
+         *     form validation, how many teams store settings of their own and the
+         *     stored row's `version`. Always 200: with nothing stored, `source` is
+         *     `default` and `values` equal `built_in_defaults`.
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404.
+         */
+        get: operations["getAdminSearchSettings"];
+        /**
+         * Replace the instance search ranking settings
+         * @description Validates and stores a whole replacement of the instance search ranking
+         *     defaults, taking effect on the next request with no restart, and appends
+         *     one entry (`action: upsert`) to the `search` audit log in the same
+         *     transaction. Pass `expected_version` to reject the save with 409 when
+         *     someone else changed the settings since they were read. A body that
+         *     omits a value field, sends one as null, or carries an unknown field is
+         *     rejected with 400.
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404.
+         */
+        put: operations["updateAdminSearchSettings"];
+        post?: never;
+        /**
+         * Reset the instance search ranking settings to the built-in defaults
+         * @description Removes the stored instance search ranking defaults, so the built-in defaults
+         *     apply from the next request, and appends one entry (`action: delete`) to
+         *     the `search` audit log. Idempotent: with nothing stored it is still a
+         *     204 and writes no audit entry.
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404.
+         */
+        delete: operations["resetAdminSearchSettings"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/settings/search/audit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the instance search ranking settings audit log
+         * @description Returns one page of the instance search ranking settings' audit log (setting
+         *     `search`), newest first, with each actor's display name resolved.
+         *     Pass the previous page's `next_cursor` to continue.
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404.
+         */
+        get: operations["listAdminSearchSettingsAudit"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/settings/ai-summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the instance AI summary settings
+         * @description Returns the instance AI summary defaults and budgets in effect, where they come from
+         *     (`instance` or `default`), the built-in defaults, the hard bounds for
+         *     form validation, how many teams store settings of their own and the
+         *     stored row's `version`. Always 200: with nothing stored, `source` is
+         *     `default` and `values` equal `built_in_defaults`.
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404.
+         */
+        get: operations["getAdminAISummarySettings"];
+        /**
+         * Replace the instance AI summary settings
+         * @description Validates and stores a whole replacement of the instance AI summary
+         *     defaults and budgets, taking effect on the next request with no restart, and appends
+         *     one entry (`action: upsert`) to the `ai_summary` audit log in the same
+         *     transaction. Pass `expected_version` to reject the save with 409 when
+         *     someone else changed the settings since they were read. A body that
+         *     omits a value field, sends one as null, or carries an unknown field is
+         *     rejected with 400.
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404.
+         */
+        put: operations["updateAdminAISummarySettings"];
+        post?: never;
+        /**
+         * Reset the instance AI summary settings to the built-in defaults
+         * @description Removes the stored instance AI summary defaults and budgets, so the built-in defaults
+         *     apply from the next request, and appends one entry (`action: delete`) to
+         *     the `ai_summary` audit log. Idempotent: with nothing stored it is still a
+         *     204 and writes no audit entry.
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404.
+         */
+        delete: operations["resetAdminAISummarySettings"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/settings/ai-summary/audit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the instance AI summary settings audit log
+         * @description Returns one page of the instance AI summary settings' audit log (setting
+         *     `ai_summary`), newest first, with each actor's display name resolved.
+         *     Pass the previous page's `next_cursor` to continue.
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404.
+         */
+        get: operations["listAdminAISummarySettingsAudit"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/{team_id}/comments": {
         parameters: {
             query?: never;
@@ -12781,9 +12915,12 @@ export interface components {
         };
         /**
          * @description One append-only change to an instance setting. `before` and `after` are
-         *     REDACTED snapshots: they never contain a credential, only
-         *     `has_credential` and, on an upsert's `after`, a `secret` marker saying
-         *     whether the credential was `changed` or `unchanged`.
+         *     snapshots of the setting's values, filtered to that setting's allowlisted
+         *     keys, and never contain a credential. For `email_provider` they report
+         *     only `has_credential` and, on an upsert's `after`, a `secret` marker
+         *     saying whether the credential was `changed` or `unchanged`; the `search`
+         *     and `ai_summary` snapshots are the settings' values, which hold no
+         *     credential.
          */
         AdminInstanceSettingsAuditEntry: {
             /**
@@ -12794,8 +12931,9 @@ export interface components {
             /**
              * @description The instance setting the entry describes.
              * @example email_provider
+             * @enum {string}
              */
-            setting: string;
+            setting: "email_provider" | "search" | "ai_summary";
             /**
              * @description `upsert` (created or replaced by an admin), `delete` (removed by an
              *     admin) or `import` (the boot-time import from config.yaml, which has no
@@ -12835,6 +12973,253 @@ export interface components {
             /** @description Opaque cursor for the next page; null on the last page. */
             next_cursor: string | null;
         };
+        /**
+         * @description Where the instance values come from: `instance` when an instance admin (or
+         *     the boot-time config import) stored them, `default` when nothing is stored
+         *     and the built-in defaults apply.
+         * @example instance
+         * @enum {string}
+         */
+        AdminInstanceSettingsSource: "instance" | "default";
+        /**
+         * @description The instance search ranking defaults. Every team without its own search
+         *     settings ranks with these; `rank_candidate_cap` is instance-only and applies
+         *     to every team.
+         */
+        AdminInstanceSearchValues: {
+            /**
+             * @description Whether search results are re-ranked by recency.
+             * @example false
+             */
+            recency_ranking_enabled: boolean;
+            /**
+             * Format: double
+             * @description Weight of semantic relevance. The three weights must not all be zero.
+             * @example 0.5
+             */
+            rank_weight_relevance: number;
+            /**
+             * Format: double
+             * @description Weight of creation recency.
+             * @example 0.3
+             */
+            rank_weight_created: number;
+            /**
+             * Format: double
+             * @description Weight of update recency.
+             * @example 0.2
+             */
+            rank_weight_updated: number;
+            /**
+             * Format: double
+             * @description Recency half-life in days.
+             * @example 90
+             */
+            rank_half_life_days: number;
+            /**
+             * @description How many rows are pulled and re-ranked per search.
+             * @example 200
+             */
+            rank_candidate_cap: number;
+        };
+        /** @description The hard bounds the search values are validated against, for form validation. */
+        AdminInstanceSearchLimits: {
+            /**
+             * Format: double
+             * @description The smallest allowed weight. The three weights must also not all be zero.
+             * @example 0
+             */
+            rank_weight_min: number;
+            /**
+             * Format: double
+             * @description The largest allowed half-life, in days. The half-life must also be positive.
+             * @example 36500
+             */
+            rank_half_life_days_max: number;
+            /** @example 1 */
+            rank_candidate_cap_min: number;
+            /** @example 5000 */
+            rank_candidate_cap_max: number;
+        };
+        /**
+         * @description The instance search ranking defaults in effect, where they come from and
+         *     how many teams ignore them because they store search settings of their own.
+         */
+        AdminInstanceSearchSettings: {
+            values: components["schemas"]["AdminInstanceSearchValues"];
+            source: components["schemas"]["AdminInstanceSettingsSource"];
+            built_in_defaults: components["schemas"]["AdminInstanceSearchValues"];
+            limits: components["schemas"]["AdminInstanceSearchLimits"];
+            /**
+             * @description How many teams store search settings of their own, so a change here does not reach them.
+             * @example 3
+             */
+            teams_with_override: number;
+            /**
+             * Format: date-time
+             * @description When the values were last stored; null when `source` is `default`.
+             */
+            updated_at: string | null;
+            /**
+             * Format: uuid
+             * @description The admin who last stored the values. Null when `source` is `default`,
+             *     for the boot-time import, or once that user has been deleted.
+             */
+            updated_by_user_id: string | null;
+            /** @description That admin's display name (or email), when it could be resolved. */
+            updated_by_name: string | null;
+            /**
+             * Format: int64
+             * @description The stored row's optimistic-lock version; null when nothing is stored.
+             *     Send it back as `expected_version` to reject a save that would
+             *     overwrite someone else's change.
+             * @example 4
+             */
+            version: number | null;
+        };
+        /**
+         * @description A whole replacement of the instance search ranking defaults. Every value is
+         *     required. `expected_version` is optional: when present, the save is
+         *     rejected with 409 unless it equals the stored version (and when nothing is
+         *     stored, any `expected_version` other than null is a conflict). Omit it for
+         *     last-write-wins.
+         */
+        AdminInstanceSearchSettingsUpdate: {
+            recency_ranking_enabled: boolean;
+            /** Format: double */
+            rank_weight_relevance: number;
+            /** Format: double */
+            rank_weight_created: number;
+            /** Format: double */
+            rank_weight_updated: number;
+            /** Format: double */
+            rank_half_life_days: number;
+            rank_candidate_cap: number;
+            /**
+             * Format: int64
+             * @description The `version` the caller last read; omit or null for last-write-wins.
+             */
+            expected_version?: number | null;
+        };
+        /**
+         * @description How detailed a summary is.
+         * @example balanced
+         * @enum {string}
+         */
+        AdminInstanceAISummaryStyle: "concise" | "balanced" | "detailed";
+        /**
+         * @description The instance AI summary defaults and budgets. `enabled`, `top_n`, `style`
+         *     and `max_output_tokens` are the defaults every team without its own AI
+         *     summary settings uses; the character budgets and the request timeout are
+         *     instance-only and apply to every team.
+         */
+        AdminInstanceAISummaryValues: {
+            /** @example true */
+            enabled: boolean;
+            /**
+             * @description How many search results a summary reads.
+             * @example 5
+             */
+            top_n: number;
+            style: components["schemas"]["AdminInstanceAISummaryStyle"];
+            /** @example 800 */
+            max_output_tokens: number;
+            /**
+             * @description How many characters of each document a summary reads.
+             * @example 8000
+             */
+            per_document_chars: number;
+            /**
+             * @description The total character budget of one summary's context; at least `per_document_chars`.
+             * @example 32000
+             */
+            total_context_chars: number;
+            /**
+             * @description The summary request timeout, in milliseconds.
+             * @example 60000
+             */
+            request_timeout_ms: number;
+        };
+        /** @description The hard bounds the AI summary values are validated against, for form validation. */
+        AdminInstanceAISummaryLimits: {
+            /** @example 1 */
+            top_n_min: number;
+            /** @example 10 */
+            top_n_max: number;
+            /** @example 1 */
+            max_output_tokens_min: number;
+            /** @example 32768 */
+            max_output_tokens_max: number;
+            /**
+             * @description The smallest allowed character budget. `total_context_chars` must also be at least `per_document_chars`.
+             * @example 1
+             */
+            chars_min: number;
+            /** @example 2147483647 */
+            chars_max: number;
+            /** @example 1 */
+            request_timeout_ms_min: number;
+            /** @example 2147483647 */
+            request_timeout_ms_max: number;
+        };
+        /**
+         * @description The instance AI summary defaults in effect, where they come from and how
+         *     many teams ignore the defaults because they store AI summary settings of
+         *     their own. The instance-only budgets reach every team regardless.
+         */
+        AdminInstanceAISummarySettings: {
+            values: components["schemas"]["AdminInstanceAISummaryValues"];
+            source: components["schemas"]["AdminInstanceSettingsSource"];
+            built_in_defaults: components["schemas"]["AdminInstanceAISummaryValues"];
+            limits: components["schemas"]["AdminInstanceAISummaryLimits"];
+            /**
+             * @description How many teams store AI summary settings of their own, so a change to the team defaults does not reach them.
+             * @example 2
+             */
+            teams_with_override: number;
+            /**
+             * Format: date-time
+             * @description When the values were last stored; null when `source` is `default`.
+             */
+            updated_at: string | null;
+            /**
+             * Format: uuid
+             * @description The admin who last stored the values. Null when `source` is `default`,
+             *     for the boot-time import, or once that user has been deleted.
+             */
+            updated_by_user_id: string | null;
+            /** @description That admin's display name (or email), when it could be resolved. */
+            updated_by_name: string | null;
+            /**
+             * Format: int64
+             * @description The stored row's optimistic-lock version; null when nothing is stored.
+             *     Send it back as `expected_version` to reject a save that would
+             *     overwrite someone else's change.
+             * @example 4
+             */
+            version: number | null;
+        };
+        /**
+         * @description A whole replacement of the instance AI summary settings. Every value is
+         *     required. `expected_version` is optional: when present, the save is
+         *     rejected with 409 unless it equals the stored version (and when nothing is
+         *     stored, any `expected_version` other than null is a conflict). Omit it for
+         *     last-write-wins.
+         */
+        AdminInstanceAISummarySettingsUpdate: {
+            enabled: boolean;
+            top_n: number;
+            style: components["schemas"]["AdminInstanceAISummaryStyle"];
+            max_output_tokens: number;
+            per_document_chars: number;
+            total_context_chars: number;
+            request_timeout_ms: number;
+            /**
+             * Format: int64
+             * @description The `version` the caller last read; omit or null for last-write-wins.
+             */
+            expected_version?: number | null;
+        };
         ProjectResponse: components["schemas"]["Project"] & {
             /**
              * @description Whether the project's git URL matches a repository accessible via the team's GitHub App installation
@@ -24668,6 +25053,388 @@ export interface operations {
             };
         };
     };
+    getAdminSearchSettings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The instance search ranking settings */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminInstanceSearchSettings"];
+                };
+            };
+            /** @description Not found — the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    updateAdminSearchSettings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AdminInstanceSearchSettingsUpdate"];
+            };
+        };
+        responses: {
+            /** @description The stored settings (`source` is `instance`) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminInstanceSearchSettings"];
+                };
+            };
+            /**
+             * @description Bad request — a value is out of bounds (`INSTANCE_SETTINGS_VALIDATION_FAILED`,
+             *     with `validation_errors` naming each offending field), or the body is
+             *     malformed, omits or nulls a value field (every value is required), or
+             *     carries an unknown field
+             */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Conflict — `expected_version` does not match the stored version (`INSTANCE_SETTINGS_VERSION_CONFLICT`); nothing was changed */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    resetAdminSearchSettings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The built-in defaults now apply */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not found — the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    listAdminSearchSettingsAudit: {
+        parameters: {
+            query?: {
+                /** @description Opaque cursor from a previous page's `next_cursor`. */
+                cursor?: string;
+                /** @description Page size. */
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description One page of audit entries, newest first */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminInstanceSettingsAuditPage"];
+                };
+            };
+            /** @description Bad request — malformed cursor, or `limit` out of range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    getAdminAISummarySettings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The instance AI summary settings */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminInstanceAISummarySettings"];
+                };
+            };
+            /** @description Not found — the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    updateAdminAISummarySettings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AdminInstanceAISummarySettingsUpdate"];
+            };
+        };
+        responses: {
+            /** @description The stored settings (`source` is `instance`) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminInstanceAISummarySettings"];
+                };
+            };
+            /**
+             * @description Bad request — a value is out of bounds (`INSTANCE_SETTINGS_VALIDATION_FAILED`,
+             *     with `validation_errors` naming each offending field), or the body is
+             *     malformed, omits or nulls a value field (every value is required), or
+             *     carries an unknown field
+             */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Conflict — `expected_version` does not match the stored version (`INSTANCE_SETTINGS_VERSION_CONFLICT`); nothing was changed */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    resetAdminAISummarySettings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The built-in defaults now apply */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not found — the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    listAdminAISummarySettingsAudit: {
+        parameters: {
+            query?: {
+                /** @description Opaque cursor from a previous page's `next_cursor`. */
+                cursor?: string;
+                /** @description Page size. */
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description One page of audit entries, newest first */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminInstanceSettingsAuditPage"];
+                };
+            };
+            /** @description Bad request — malformed cursor, or `limit` out of range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     listComments: {
         parameters: {
             query: {