@runlot/api 0.1.0-rc.199 → 0.1.0-rc.200

package/dist/schema.d.ts

@@ -3453,6 +3453,164 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/orgs/{orgSlug}/projects/{projectName}/ai/calls": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        /**
+         * AI calls this project's app made (docs/ai-observability.md §6.1)
+         * @description One row per `env.ai` call from the deployed app, newest first: the lane that served it,
+         *     whether a lent subscription was asked and why it did not serve, status, latency, tokens and
+         *     price. Rows live as long as the plan's log retention (`retentionDays`). `userId` is
+         *     returned only to a reader with `observability:pii`. Without an event store the answer is
+         *     `{available: false}`. Requires `observability:read`.
+         */
+        get: operations["listAICalls"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orgs/{orgSlug}/projects/{projectName}/ai/calls/{callId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+                callId: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * One AI call, with its captured input and output when allowed
+         * @description The call's row, and — when the project captured it and the reader holds
+         *     `observability:pii` — the input and output (each at most 64 KiB, scrubbed by the
+         *     project's scanner rules). A captured body the reader may not see is `bodyHidden: true`.
+         *     A read that returns a body or a user id is audited. Requires `observability:read`.
+         */
+        get: operations["getAICall"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orgs/{orgSlug}/projects/{projectName}/ai/summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        /**
+         * AI calls over time, by model, and why lending did not serve
+         * @description Totals, a series and a per-model table from the hourly rollup (kept 456 days), and the
+         *     most frequent reasons a lent subscription did not serve a call (from the raw rows inside
+         *     retention). The step is 1 h up to 3 days, 6 h up to 14 days, 1 day beyond. Requires
+         *     `observability:read`.
+         */
+        get: operations["getAISummary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orgs/{orgSlug}/projects/{projectName}/ai/sessions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        /**
+         * AI calls grouped by the app's metadata.sessionId
+         * @description Newest `lastAt` first. A session's calls are `GET …/ai/calls?sessionId=…`. `userId` only
+         *     with `observability:pii`. Requires `observability:read`.
+         */
+        get: operations["listAISessions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orgs/{orgSlug}/projects/{projectName}/ai/lenders": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        /**
+         * Desktops of the org's members that can lend to this project right now
+         * @description Each desktop lending to apps, with the models it lends and whether its Runlot Studio is
+         *     too old to carry `reasoning` or `responseFormat` (`outdated`). `reachable` is false when
+         *     the lending service could not be asked. Requires `observability:read`.
+         */
+        get: operations["getAILenders"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orgs/{orgSlug}/projects/{projectName}/ai/capture": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        /**
+         * Whether this project records prompts and answers
+         * @description Prompt capture is off by default. With it on, each call's input and output (each cut to
+         *     64 KiB and scrubbed by the project's scanner rules) are kept with its row for the plan's
+         *     log retention. Requires `observability:read`.
+         */
+        get: operations["getAICapture"];
+        /**
+         * Turn prompt capture on or off
+         * @description Requires `observability:admin`. Audited. Takes effect on the next calls without a redeploy.
+         */
+        put: operations["setAICapture"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/orgs/{orgSlug}/ai/ledger": {
         parameters: {
             query?: never;
@@ -12758,6 +12916,207 @@ export interface components {
             /** @description Pass it back to get the next page. Absent means the end. */
             cursor?: string;
         };
+        /** @description One env.ai call (docs/ai-observability.md §3). */
+        AICallRow: {
+            callId: string;
+            /** @description The request (and trace) that made the call */
+            requestId?: string;
+            /** Format: date-time */
+            ts: string;
+            /** @enum {string} */
+            op: "run" | "embed" | "judge";
+            model: string;
+            /** @enum {string} */
+            lane: "credit" | "byos" | "none";
+            /** @enum {string} */
+            byos?: "served" | "fellBack" | "refused";
+            byosCode?: string;
+            byosReason?: string;
+            status: number;
+            error: boolean;
+            errorCode?: string;
+            errorMessage?: string;
+            durationMs: number;
+            ttftMs?: number;
+            stream: boolean;
+            stopReason?: string;
+            /** Format: int64 */
+            tokensIn: number;
+            /** Format: int64 */
+            tokensOut: number;
+            /** Format: int64 */
+            tokensCached: number;
+            /** Format: int64 */
+            tokensCacheWrite: number;
+            /**
+             * Format: int64
+             * @description List price of the call; on a lent call, what lending saved
+             */
+            costMicroCents: number;
+            /**
+             * Format: int64
+             * @description Taken from credit
+             */
+            chargedMicroCents: number;
+            effort?: string;
+            responseFormat: boolean;
+            tools: number;
+            toolRounds: number;
+            inputs?: number;
+            dimensions?: number;
+            sessionId?: string;
+            /** @description Only with observability:pii */
+            userId?: string;
+            tags: string[];
+            hasBody: boolean;
+            deploymentVersion: number;
+        };
+        AICallDetail: components["schemas"]["AICallRow"] & {
+            input?: string;
+            output?: string;
+            inputTruncated: boolean;
+            outputTruncated: boolean;
+            redacted: boolean;
+            bodyHidden?: boolean;
+        };
+        AICallList: {
+            available: boolean;
+            retentionDays?: number;
+            calls?: components["schemas"]["AICallRow"][];
+            nextBefore?: string;
+        };
+        AISummary: {
+            available: boolean;
+            /** Format: date-time */
+            from?: string;
+            /** Format: date-time */
+            to?: string;
+            stepSeconds?: number;
+            totals?: {
+                /** Format: int64 */
+                calls: number;
+                /** Format: int64 */
+                errors: number;
+                /** Format: int64 */
+                tokensIn: number;
+                /** Format: int64 */
+                tokensOut: number;
+                /** Format: int64 */
+                tokensCached: number;
+                /** Format: int64 */
+                costMicroCents: number;
+                /** Format: int64 */
+                chargedMicroCents: number;
+                /** Format: int64 */
+                byosServed: number;
+                /** Format: int64 */
+                byosFellBack: number;
+                /** Format: int64 */
+                byosRefused: number;
+                /** Format: int64 */
+                byosSavedMicroCents: number;
+                p50Ms: number;
+                p95Ms: number;
+                ttftP50Ms: number;
+            };
+            series?: {
+                /** Format: date-time */
+                t: string;
+                /** Format: int64 */
+                calls: number;
+                /** Format: int64 */
+                errors: number;
+                /** Format: int64 */
+                chargedMicroCents: number;
+                /** Format: int64 */
+                byosServed: number;
+                /** Format: int64 */
+                byosFellBack: number;
+                /** Format: int64 */
+                byosRefused: number;
+                p95Ms: number;
+            }[];
+            models?: {
+                model: string;
+                /** Format: int64 */
+                calls: number;
+                /** Format: int64 */
+                errors: number;
+                /** Format: int64 */
+                tokensIn: number;
+                /** Format: int64 */
+                tokensOut: number;
+                /** Format: int64 */
+                costMicroCents: number;
+                /** Format: int64 */
+                chargedMicroCents: number;
+                /** Format: int64 */
+                byosServed: number;
+                p50Ms: number;
+                p95Ms: number;
+            }[];
+            byosReasons?: {
+                code: string;
+                reason: string;
+                /** Format: int64 */
+                calls: number;
+                /** Format: date-time */
+                lastAt: string;
+            }[];
+        };
+        AISession: {
+            sessionId: string;
+            /** Format: int64 */
+            calls: number;
+            /** Format: int64 */
+            errors: number;
+            /** Format: date-time */
+            firstAt: string;
+            /** Format: date-time */
+            lastAt: string;
+            /** Format: int64 */
+            tokensIn: number;
+            /** Format: int64 */
+            tokensOut: number;
+            /** Format: int64 */
+            costMicroCents: number;
+            /** Format: int64 */
+            chargedMicroCents: number;
+            models: string[];
+            /** @description Only with observability:pii */
+            userId?: string;
+        };
+        AISessionList: {
+            available: boolean;
+            sessions?: components["schemas"]["AISession"][];
+            nextBefore?: string;
+        };
+        AILenders: {
+            byos: boolean;
+            byosCreditFallback: boolean;
+            reachable: boolean;
+            lenders: {
+                member: {
+                    name?: string;
+                    email: string;
+                };
+                device: string;
+                models: string[];
+                options: string[];
+                outdated: boolean;
+                engines: {
+                    vendor: string;
+                    connected: boolean;
+                    version?: string;
+                }[];
+                inflight: number;
+            }[];
+        };
+        AICapture: {
+            captureBodies: boolean;
+            retentionDays: number;
+            canEdit: boolean;
+        };
         AILedgerRow: {
             /** @enum {string} */
             kind: "call" | "topup" | "adjust";
@@ -19996,6 +20355,219 @@ export interface operations {
             403: components["responses"]["Forbidden"];
         };
     };
+    listAICalls: {
+        parameters: {
+            query?: {
+                from?: string;
+                to?: string;
+                model?: string;
+                op?: "run" | "embed" | "judge";
+                lane?: "credit" | "byos" | "none";
+                byos?: "served" | "fellBack" | "refused" | "attempted";
+                status?: "ok" | "error";
+                sessionId?: string;
+                /** @description Needs observability:pii */
+                userId?: string;
+                requestId?: string;
+                tag?: string;
+                /** @description The previous page's nextBefore (opaque) */
+                before?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Calls */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AICallList"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    getAICall: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+                callId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The call */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        available: boolean;
+                        call?: components["schemas"]["AICallDetail"];
+                    };
+                };
+            };
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    getAISummary: {
+        parameters: {
+            query?: {
+                from?: string;
+                to?: string;
+            };
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Summary */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AISummary"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    listAISessions: {
+        parameters: {
+            query?: {
+                from?: string;
+                to?: string;
+                before?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Sessions */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AISessionList"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    getAILenders: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Lenders */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AILenders"];
+                };
+            };
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    getAICapture: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Capture setting */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AICapture"];
+                };
+            };
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    setAICapture: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    captureBodies: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Capture setting */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AICapture"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
     listAILedger: {
         parameters: {
             query?: {