@veruna/api-contracts 19.1.0 → 20.1.0

package/build/v1/ai/ai.errors.d.ts

@@ -1,5 +1,7 @@
 import { ErrorMetadata } from '../../shared';
 export declare enum AIErrorCode {
+    AI_CALL_TRANSITION_INVALID = "AI_CALL_TRANSITION_INVALID",
+    /** An attached document could not be read by the provider — retrying elsewhere cannot help. */
     ATTACHMENT_UNREADABLE = "ATTACHMENT_UNREADABLE",
     GENERATION_FAILED = "GENERATION_FAILED",
     GENERATION_TIMEOUT = "GENERATION_TIMEOUT",
@@ -8,16 +10,45 @@ export declare enum AIErrorCode {
     MODEL_NOT_FOUND = "MODEL_NOT_FOUND",
     MODEL_UNAVAILABLE = "MODEL_UNAVAILABLE",
     NO_SUITABLE_MODEL = "NO_SUITABLE_MODEL",
+    /**
+     * В запросе больше входных картинок, чем принимает любой роут модели
+     * (`runtimeOverrides.limits.maxInputImages`). Для этой модели исход
+     * детерминирован: повтор с тем же набором не поможет, другая модель — может.
+     */
     TOO_MANY_INPUT_IMAGES = "TOO_MANY_INPUT_IMAGES",
+    PROVIDER_INSUFFICIENT_BALANCE = "PROVIDER_INSUFFICIENT_BALANCE",
+    /** @deprecated Use PROVIDER_INSUFFICIENT_BALANCE for vendor funds; wallet errors own user funds. */
     INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
     COST_LIMIT_EXCEEDED = "COST_LIMIT_EXCEEDED",
     PROVIDER_ERROR = "PROVIDER_ERROR",
     PROVIDER_RATE_LIMIT = "PROVIDER_RATE_LIMIT",
+    /**
+     * The vendor rejected this one request (HTTP 400, 413, 422): too long, a tool schema it dislikes.
+     * The route is healthy. The pool fails over to the next route and never strikes this one.
+     */
+    PROVIDER_BAD_REQUEST = "PROVIDER_BAD_REQUEST",
     PROVIDER_TIMEOUT = "PROVIDER_TIMEOUT",
+    /** Provider stream/response completed "successfully" but carried zero content. */
     EMPTY_COMPLETION = "EMPTY_COMPLETION",
+    /** The caller aborted the request mid-flight — never a route/provider fault. */
     REQUEST_CANCELLED = "REQUEST_CANCELLED",
+    /**
+     * Все провайдеры пула отказали по политике или модерации (пользователь заблокирован у
+     * upstream или запрос отмодерирован). Не сбой инфраструктуры: отказ виден в шаге сообщения
+     * и в warn-логе каждой попытки маршрута (вид отказа, провайдер, его ответ).
+     */
     PROVIDER_POLICY_REFUSAL = "PROVIDER_POLICY_REFUSAL",
+    /**
+     * Платная задача отправлена, но провайдер не подтвердил ни приём, ни отказ (таймаут, обрыв, 5xx). Задачу не
+     * отправляют повторно: она может ещё выполниться и прийти позже. Пул переходит на маршруты без платных задач.
+     */
+    PROVIDER_OUTCOME_UNKNOWN = "PROVIDER_OUTCOME_UNKNOWN",
+    /**
+     * Новая платная задача не отправлена: у этого сообщения уже есть платная задача с неизвестным исходом
+     * (PROVIDER_OUTCOME_UNKNOWN), и её результат может ещё прийти. Не сбой провайдера: без страйка.
+     */
+    PAID_TASK_PENDING = "PAID_TASK_PENDING",
     PROMPT_GENERATION_FAILED = "PROMPT_GENERATION_FAILED",
     PROMPT_GENERATOR_MODEL_NOT_FOUND = "PROMPT_GENERATOR_MODEL_NOT_FOUND"
 }
-export declare const AI_ERRORS: Record<AIErrorCode, ErrorMetadata>;
+export declare const AI_ERRORS: Record<Exclude<AIErrorCode, AIErrorCode.INSUFFICIENT_BALANCE>, ErrorMetadata>;

package/build/v1/ai/ai.errors.js

@@ -3,27 +3,72 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AI_ERRORS = exports.AIErrorCode = void 0;
 var AIErrorCode;
 (function (AIErrorCode) {
+    AIErrorCode["AI_CALL_TRANSITION_INVALID"] = "AI_CALL_TRANSITION_INVALID";
+    /** An attached document could not be read by the provider — retrying elsewhere cannot help. */
     AIErrorCode["ATTACHMENT_UNREADABLE"] = "ATTACHMENT_UNREADABLE";
+    // Generation
     AIErrorCode["GENERATION_FAILED"] = "GENERATION_FAILED";
     AIErrorCode["GENERATION_TIMEOUT"] = "GENERATION_TIMEOUT";
     AIErrorCode["CONTENT_FILTERED"] = "CONTENT_FILTERED";
     AIErrorCode["CONTEXT_TOO_LONG"] = "CONTEXT_TOO_LONG";
+    // Model
     AIErrorCode["MODEL_NOT_FOUND"] = "MODEL_NOT_FOUND";
     AIErrorCode["MODEL_UNAVAILABLE"] = "MODEL_UNAVAILABLE";
     AIErrorCode["NO_SUITABLE_MODEL"] = "NO_SUITABLE_MODEL";
+    /**
+     * В запросе больше входных картинок, чем принимает любой роут модели
+     * (`runtimeOverrides.limits.maxInputImages`). Для этой модели исход
+     * детерминирован: повтор с тем же набором не поможет, другая модель — может.
+     */
     AIErrorCode["TOO_MANY_INPUT_IMAGES"] = "TOO_MANY_INPUT_IMAGES";
+    // Billing
+    AIErrorCode["PROVIDER_INSUFFICIENT_BALANCE"] = "PROVIDER_INSUFFICIENT_BALANCE";
+    /** @deprecated Use PROVIDER_INSUFFICIENT_BALANCE for vendor funds; wallet errors own user funds. */
     AIErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
     AIErrorCode["COST_LIMIT_EXCEEDED"] = "COST_LIMIT_EXCEEDED";
+    // Provider
     AIErrorCode["PROVIDER_ERROR"] = "PROVIDER_ERROR";
     AIErrorCode["PROVIDER_RATE_LIMIT"] = "PROVIDER_RATE_LIMIT";
+    /**
+     * The vendor rejected this one request (HTTP 400, 413, 422): too long, a tool schema it dislikes.
+     * The route is healthy. The pool fails over to the next route and never strikes this one.
+     */
+    AIErrorCode["PROVIDER_BAD_REQUEST"] = "PROVIDER_BAD_REQUEST";
     AIErrorCode["PROVIDER_TIMEOUT"] = "PROVIDER_TIMEOUT";
+    /** Provider stream/response completed "successfully" but carried zero content. */
     AIErrorCode["EMPTY_COMPLETION"] = "EMPTY_COMPLETION";
+    /** The caller aborted the request mid-flight — never a route/provider fault. */
     AIErrorCode["REQUEST_CANCELLED"] = "REQUEST_CANCELLED";
+    /**
+     * Все провайдеры пула отказали по политике или модерации (пользователь заблокирован у
+     * upstream или запрос отмодерирован). Не сбой инфраструктуры: отказ виден в шаге сообщения
+     * и в warn-логе каждой попытки маршрута (вид отказа, провайдер, его ответ).
+     */
     AIErrorCode["PROVIDER_POLICY_REFUSAL"] = "PROVIDER_POLICY_REFUSAL";
+    /**
+     * Платная задача отправлена, но провайдер не подтвердил ни приём, ни отказ (таймаут, обрыв, 5xx). Задачу не
+     * отправляют повторно: она может ещё выполниться и прийти позже. Пул переходит на маршруты без платных задач.
+     */
+    AIErrorCode["PROVIDER_OUTCOME_UNKNOWN"] = "PROVIDER_OUTCOME_UNKNOWN";
+    /**
+     * Новая платная задача не отправлена: у этого сообщения уже есть платная задача с неизвестным исходом
+     * (PROVIDER_OUTCOME_UNKNOWN), и её результат может ещё прийти. Не сбой провайдера: без страйка.
+     */
+    AIErrorCode["PAID_TASK_PENDING"] = "PAID_TASK_PENDING";
+    // Prompt Generation
     AIErrorCode["PROMPT_GENERATION_FAILED"] = "PROMPT_GENERATION_FAILED";
     AIErrorCode["PROMPT_GENERATOR_MODEL_NOT_FOUND"] = "PROMPT_GENERATOR_MODEL_NOT_FOUND";
 })(AIErrorCode || (exports.AIErrorCode = AIErrorCode = {}));
+// The deprecated INSUFFICIENT_BALANCE code shares the wallet's public metadata.
 exports.AI_ERRORS = {
+    [AIErrorCode.PROVIDER_INSUFFICIENT_BALANCE]: {
+        code: AIErrorCode.PROVIDER_INSUFFICIENT_BALANCE,
+        statusCode: 503,
+    },
+    [AIErrorCode.AI_CALL_TRANSITION_INVALID]: {
+        code: AIErrorCode.AI_CALL_TRANSITION_INVALID,
+        statusCode: 500,
+    },
     [AIErrorCode.ATTACHMENT_UNREADABLE]: {
         code: AIErrorCode.ATTACHMENT_UNREADABLE,
         statusCode: 422,
@@ -60,10 +105,6 @@ exports.AI_ERRORS = {
         code: AIErrorCode.TOO_MANY_INPUT_IMAGES,
         statusCode: 422,
     },
-    [AIErrorCode.INSUFFICIENT_BALANCE]: {
-        code: AIErrorCode.INSUFFICIENT_BALANCE,
-        statusCode: 402,
-    },
     [AIErrorCode.COST_LIMIT_EXCEEDED]: {
         code: AIErrorCode.COST_LIMIT_EXCEEDED,
         statusCode: 402,
@@ -76,6 +117,10 @@ exports.AI_ERRORS = {
         code: AIErrorCode.PROVIDER_RATE_LIMIT,
         statusCode: 429,
     },
+    [AIErrorCode.PROVIDER_BAD_REQUEST]: {
+        code: AIErrorCode.PROVIDER_BAD_REQUEST,
+        statusCode: 502,
+    },
     [AIErrorCode.PROVIDER_TIMEOUT]: {
         code: AIErrorCode.PROVIDER_TIMEOUT,
         statusCode: 504,
@@ -84,14 +129,25 @@ exports.AI_ERRORS = {
         code: AIErrorCode.EMPTY_COMPLETION,
         statusCode: 502,
     },
+    // 499 Client Closed Request — the caller went away; not a server/provider fault.
     [AIErrorCode.REQUEST_CANCELLED]: {
         code: AIErrorCode.REQUEST_CANCELLED,
         statusCode: 499,
     },
+    // 422: запрос понятен, но провайдер не станет его выполнять для этого пользователя/контента.
     [AIErrorCode.PROVIDER_POLICY_REFUSAL]: {
         code: AIErrorCode.PROVIDER_POLICY_REFUSAL,
         statusCode: 422,
     },
+    // 502: провайдер не ответил определённо; повторять нельзя, результат может прийти позже.
+    [AIErrorCode.PROVIDER_OUTCOME_UNKNOWN]: {
+        code: AIErrorCode.PROVIDER_OUTCOME_UNKNOWN,
+        statusCode: 502,
+    },
+    [AIErrorCode.PAID_TASK_PENDING]: {
+        code: AIErrorCode.PAID_TASK_PENDING,
+        statusCode: 409,
+    },
     [AIErrorCode.PROMPT_GENERATION_FAILED]: {
         code: AIErrorCode.PROMPT_GENERATION_FAILED,
         statusCode: 500,

package/build/v1/ai/ai.errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.errors.js","sourceRoot":"","sources":["../../../v1/ai/ai.errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ai.errors.js","sourceRoot":"","sources":["../../../v1/ai/ai.errors.ts"],"names":[],"mappings":"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"}

package/build/v1/ai/plugin-id.enum.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Available plugin IDs
+ */
 export declare enum PluginId {
     WEB = "WEB",
     REASONING = "REASONING"

package/build/v1/ai/plugin-id.enum.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PluginId = void 0;
+/**
+ * Available plugin IDs
+ */
 var PluginId;
 (function (PluginId) {
     PluginId["WEB"] = "WEB";

package/build/v1/ai/plugin-id.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-id.enum.js","sourceRoot":"","sources":["../../../v1/ai/plugin-id.enum.ts"],"names":[],"mappings":";;;AAGA,IAAY,QAGX;AAHD,WAAY,QAAQ;IAChB,uBAAW,CAAA;IACX,mCAAuB,CAAA;AAC3B,CAAC,EAHW,QAAQ,wBAAR,QAAQ,QAGnB"}
+{"version":3,"file":"plugin-id.enum.js","sourceRoot":"","sources":["../../../v1/ai/plugin-id.enum.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,QAGX;AAHD,WAAY,QAAQ;IAChB,uBAAW,CAAA;IACX,mCAAuB,CAAA;AAC3B,CAAC,EAHW,QAAQ,wBAAR,QAAQ,QAGnB"}

package/build/v1/ai/plugins.types.d.ts

@@ -2,17 +2,38 @@ import { z } from 'zod';
 import { PluginId } from './plugin-id.enum';
 import { ReasoningEffort } from './reasoning-effort.enum';
 export declare const ReasoningEffortSchema: z.ZodEnum<typeof ReasoningEffort>;
+/**
+ * Upper bound on plugin/setting priceDelta values (tokens). 100M tokens =
+ * 1 000 000 RUB — caps any single-option markup well below downstream Int32
+ * overflow risk while still being far above any realistic delta.
+ */
 export declare const PRICE_DELTA_MAX = 100000000;
+/**
+ * Web search plugin config stored in DB.
+ *
+ * `priceDelta` — kopek delta applied to AiModel.price when the plugin is
+ * enabled. Used by the billing system: hold = AiModel.price + Σ selected
+ * option priceDeltas. Capped at PRICE_DELTA_MAX.
+ */
 export declare const WebPluginConfigSchema: z.ZodObject<{
     id: z.ZodLiteral<PluginId.WEB>;
     priceDelta: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type WebPluginConfig = z.infer<typeof WebPluginConfigSchema>;
+/**
+ * Single reasoning effort option.
+ *
+ * `priceDelta` is the kopek delta added to AiModel.price when this effort
+ * is selected — used by the billing hold computation.
+ */
 export declare const ReasoningEffortOptionSchema: z.ZodObject<{
     value: z.ZodEnum<typeof ReasoningEffort>;
     priceDelta: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type ReasoningEffortOption = z.infer<typeof ReasoningEffortOptionSchema>;
+/**
+ * Reasoning plugin config stored in DB
+ */
 export declare const ReasoningPluginConfigSchema: z.ZodObject<{
     id: z.ZodLiteral<PluginId.REASONING>;
     default: z.ZodEnum<typeof ReasoningEffort>;
@@ -22,6 +43,10 @@ export declare const ReasoningPluginConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ReasoningPluginConfig = z.infer<typeof ReasoningPluginConfigSchema>;
+/**
+ * Plugin config stored in DB (model's available plugins)
+ * Discriminated union by 'id' field
+ */
 export declare const PluginConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     id: z.ZodLiteral<PluginId.WEB>;
     priceDelta: z.ZodDefault<z.ZodNumber>;
@@ -46,16 +71,25 @@ export declare const PluginsConfigArraySchema: z.ZodArray<z.ZodDiscriminatedUnio
     }, z.core.$strip>>;
 }, z.core.$strip>], "id">>;
 export type PluginsConfigArray = z.infer<typeof PluginsConfigArraySchema>;
+/**
+ * Web plugin request from client
+ */
 export declare const WebPluginRequestSchema: z.ZodObject<{
     id: z.ZodLiteral<PluginId.WEB>;
     maxResults: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type WebPluginRequest = z.infer<typeof WebPluginRequestSchema>;
+/**
+ * Reasoning plugin request from client
+ */
 export declare const ReasoningPluginRequestSchema: z.ZodObject<{
     id: z.ZodLiteral<PluginId.REASONING>;
     effort: z.ZodEnum<typeof ReasoningEffort>;
 }, z.core.$strip>;
 export type ReasoningPluginRequest = z.infer<typeof ReasoningPluginRequestSchema>;
+/**
+ * Plugin request from client (discriminated union)
+ */
 export declare const PluginRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     id: z.ZodLiteral<PluginId.WEB>;
     maxResults: z.ZodOptional<z.ZodNumber>;

package/build/v1/ai/plugins.types.js

@@ -11,7 +11,22 @@ const reasoning_effort_enum_1 = require("./reasoning-effort.enum");
 exports.ReasoningEffortSchema = zod_1.z.enum(reasoning_effort_enum_1.ReasoningEffort, {
     error: 'ReasoningConfig.effort.invalid',
 });
+// ============================================================================
+// Model Plugin Configs (stored in DB)
+// ============================================================================
+/**
+ * Upper bound on plugin/setting priceDelta values (tokens). 100M tokens =
+ * 1 000 000 RUB — caps any single-option markup well below downstream Int32
+ * overflow risk while still being far above any realistic delta.
+ */
 exports.PRICE_DELTA_MAX = 100_000_000;
+/**
+ * Web search plugin config stored in DB.
+ *
+ * `priceDelta` — kopek delta applied to AiModel.price when the plugin is
+ * enabled. Used by the billing system: hold = AiModel.price + Σ selected
+ * option priceDeltas. Capped at PRICE_DELTA_MAX.
+ */
 exports.WebPluginConfigSchema = zod_1.z.object({
     id: zod_1.z.literal(plugin_id_enum_1.PluginId.WEB),
     priceDelta: zod_1.z
@@ -21,6 +36,12 @@ exports.WebPluginConfigSchema = zod_1.z.object({
         .max(exports.PRICE_DELTA_MAX, { message: 'PluginConfig.priceDelta.max' })
         .default(0),
 });
+/**
+ * Single reasoning effort option.
+ *
+ * `priceDelta` is the kopek delta added to AiModel.price when this effort
+ * is selected — used by the billing hold computation.
+ */
 exports.ReasoningEffortOptionSchema = zod_1.z.object({
     value: exports.ReasoningEffortSchema,
     priceDelta: zod_1.z
@@ -30,6 +51,9 @@ exports.ReasoningEffortOptionSchema = zod_1.z.object({
         .max(exports.PRICE_DELTA_MAX, { message: 'ReasoningConfig.priceDelta.max' })
         .default(0),
 });
+/**
+ * Reasoning plugin config stored in DB
+ */
 exports.ReasoningPluginConfigSchema = zod_1.z.object({
     id: zod_1.z.literal(plugin_id_enum_1.PluginId.REASONING),
     default: exports.ReasoningEffortSchema,
@@ -37,24 +61,44 @@ exports.ReasoningPluginConfigSchema = zod_1.z.object({
         .array(exports.ReasoningEffortOptionSchema)
         .min(1, { message: 'ReasoningConfig.supportedValues.min' }),
 });
+/**
+ * Plugin config stored in DB (model's available plugins)
+ * Discriminated union by 'id' field
+ */
 exports.PluginConfigSchema = zod_1.z.discriminatedUnion('id', [
     exports.WebPluginConfigSchema,
     exports.ReasoningPluginConfigSchema,
 ]);
 exports.PluginsConfigArraySchema = zod_1.z.array(exports.PluginConfigSchema);
+// ============================================================================
+// Client Request Types (what client sends when creating message)
+// ============================================================================
+/**
+ * Web plugin request from client
+ */
 exports.WebPluginRequestSchema = zod_1.z.object({
     id: zod_1.z.literal(plugin_id_enum_1.PluginId.WEB),
+    /** Optional max results limit (from model settings) */
     maxResults: zod_1.z.number().int().min(1).max(20).optional(),
 });
+/**
+ * Reasoning plugin request from client
+ */
 exports.ReasoningPluginRequestSchema = zod_1.z.object({
     id: zod_1.z.literal(plugin_id_enum_1.PluginId.REASONING),
     effort: exports.ReasoningEffortSchema,
 });
+/**
+ * Plugin request from client (discriminated union)
+ */
 exports.PluginRequestSchema = zod_1.z.discriminatedUnion('id', [
     exports.WebPluginRequestSchema,
     exports.ReasoningPluginRequestSchema,
 ]);
 exports.PluginRequestArraySchema = zod_1.z.array(exports.PluginRequestSchema);
+// ============================================================================
+// Type Guards
+// ============================================================================
 function isWebPluginConfig(config) {
     return config.id === plugin_id_enum_1.PluginId.WEB;
 }

package/build/v1/ai/plugins.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.types.js","sourceRoot":"","sources":["../../../v1/ai/plugins.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugins.types.js","sourceRoot":"","sources":["../../../v1/ai/plugins.types.ts"],"names":[],"mappings":"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"}

package/build/v1/ai/reasoning-effort.enum.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Reasoning effort levels (matches OpenRouter API)
+ * - none: reasoning disabled
+ * - minimal: minimal reasoning
+ * - low: light reasoning, faster responses
+ * - medium: balanced reasoning (recommended)
+ * - high: deep reasoning, slower but more thorough
+ */
 export declare enum ReasoningEffort {
     NONE = "NONE",
     MINIMAL = "MINIMAL",

package/build/v1/ai/reasoning-effort.enum.js

@@ -1,6 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReasoningEffort = void 0;
+/**
+ * Reasoning effort levels (matches OpenRouter API)
+ * - none: reasoning disabled
+ * - minimal: minimal reasoning
+ * - low: light reasoning, faster responses
+ * - medium: balanced reasoning (recommended)
+ * - high: deep reasoning, slower but more thorough
+ */
 var ReasoningEffort;
 (function (ReasoningEffort) {
     ReasoningEffort["NONE"] = "NONE";

package/build/v1/ai/reasoning-effort.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"reasoning-effort.enum.js","sourceRoot":"","sources":["../../../v1/ai/reasoning-effort.enum.ts"],"names":[],"mappings":";;;AAQA,IAAY,eAMX;AAND,WAAY,eAAe;IACvB,gCAAa,CAAA;IACb,sCAAmB,CAAA;IACnB,8BAAW,CAAA;IACX,oCAAiB,CAAA;IACjB,gCAAa,CAAA;AACjB,CAAC,EANW,eAAe,+BAAf,eAAe,QAM1B"}
+{"version":3,"file":"reasoning-effort.enum.js","sourceRoot":"","sources":["../../../v1/ai/reasoning-effort.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,IAAY,eAMX;AAND,WAAY,eAAe;IACvB,gCAAa,CAAA;IACb,sCAAmB,CAAA;IACnB,8BAAW,CAAA;IACX,oCAAiB,CAAA;IACjB,gCAAa,CAAA;AACjB,CAAC,EANW,eAAe,+BAAf,eAAe,QAM1B"}

package/build/v1/ai/retryable-ai-error-codes.d.ts

@@ -1,2 +1,13 @@
+/**
+ * AI error codes that warrant a pool retry — the failure is plausibly a
+ * provider-specific transient (rate limit, timeout, model flake), so the
+ * SAME logical request might succeed on a different provider/model.
+ *
+ * Excluded on purpose:
+ *   - CONTENT_FILTERED      — same prompt likely trips the next model too.
+ *   - INVALID_TOOL_ARGUMENTS / VALIDATION_ERROR — caller bug, not provider.
+ *   - STREAM_CANCELLED / UPLOAD_FAILED — owned by us, not the provider.
+ *   - INSUFFICIENT_BALANCE / NO_SUITABLE_MODEL — bookkeeping, not flake.
+ */
 export declare const RETRYABLE_AI_ERROR_CODES: ReadonlySet<string>;
 export declare function isRetryableAiErrorCode(code: string): boolean;

package/build/v1/ai/retryable-ai-error-codes.js

@@ -3,6 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RETRYABLE_AI_ERROR_CODES = void 0;
 exports.isRetryableAiErrorCode = isRetryableAiErrorCode;
 const ai_errors_1 = require("./ai.errors");
+/**
+ * AI error codes that warrant a pool retry — the failure is plausibly a
+ * provider-specific transient (rate limit, timeout, model flake), so the
+ * SAME logical request might succeed on a different provider/model.
+ *
+ * Excluded on purpose:
+ *   - CONTENT_FILTERED      — same prompt likely trips the next model too.
+ *   - INVALID_TOOL_ARGUMENTS / VALIDATION_ERROR — caller bug, not provider.
+ *   - STREAM_CANCELLED / UPLOAD_FAILED — owned by us, not the provider.
+ *   - INSUFFICIENT_BALANCE / NO_SUITABLE_MODEL — bookkeeping, not flake.
+ */
 exports.RETRYABLE_AI_ERROR_CODES = new Set([
     ai_errors_1.AIErrorCode.PROVIDER_ERROR,
     ai_errors_1.AIErrorCode.PROVIDER_RATE_LIMIT,
@@ -10,6 +21,8 @@ exports.RETRYABLE_AI_ERROR_CODES = new Set([
     ai_errors_1.AIErrorCode.GENERATION_FAILED,
     ai_errors_1.AIErrorCode.GENERATION_TIMEOUT,
     ai_errors_1.AIErrorCode.MODEL_UNAVAILABLE,
+    // Zero-content "success" (dead upstream converts a failure into an empty
+    // stream) — a different route can serve the same request normally.
     ai_errors_1.AIErrorCode.EMPTY_COMPLETION,
 ]);
 function isRetryableAiErrorCode(code) {

package/build/v1/ai/retryable-ai-error-codes.js.map

@@ -1 +1 @@
-{"version":3,"file":"retryable-ai-error-codes.js","sourceRoot":"","sources":["../../../v1/ai/retryable-ai-error-codes.ts"],"names":[],"mappings":";;;AAyBA,wDAEC;AA3BD,2CAA0C;AAa7B,QAAA,wBAAwB,GAAwB,IAAI,GAAG,CAAS;IACzE,uBAAW,CAAC,cAAc;IAC1B,uBAAW,CAAC,mBAAmB;IAC/B,uBAAW,CAAC,gBAAgB;IAC5B,uBAAW,CAAC,iBAAiB;IAC7B,uBAAW,CAAC,kBAAkB;IAC9B,uBAAW,CAAC,iBAAiB;IAG7B,uBAAW,CAAC,gBAAgB;CAC/B,CAAC,CAAC;AAEH,SAAgB,sBAAsB,CAAC,IAAY;IAC/C,OAAO,gCAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"retryable-ai-error-codes.js","sourceRoot":"","sources":["../../../v1/ai/retryable-ai-error-codes.ts"],"names":[],"mappings":";;;AAyBA,wDAEC;AA3BD,2CAA0C;AAE1C;;;;;;;;;;GAUG;AACU,QAAA,wBAAwB,GAAwB,IAAI,GAAG,CAAS;IACzE,uBAAW,CAAC,cAAc;IAC1B,uBAAW,CAAC,mBAAmB;IAC/B,uBAAW,CAAC,gBAAgB;IAC5B,uBAAW,CAAC,iBAAiB;IAC7B,uBAAW,CAAC,kBAAkB;IAC9B,uBAAW,CAAC,iBAAiB;IAC7B,yEAAyE;IACzE,mEAAmE;IACnE,uBAAW,CAAC,gBAAgB;CAC/B,CAAC,CAAC;AAEH,SAAgB,sBAAsB,CAAC,IAAY;IAC/C,OAAO,gCAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC"}

package/build/v1/ai/tool-id.enum.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Canonical native tool identifiers. Mirrors NATIVE_TOOL_KEYS on the
+ * backend 1:1 — keep both lists in sync when adding a new native tool.
+ *
+ * User-facing tools (visibility: REGISTERED) and SYSTEM-only tools are
+ * both included: the FE may receive a SYSTEM tool key via stream events
+ * (e.g. image_edit routing internally to IMAGE_UPSCALE / IMAGE_REMOVE_BG,
+ * or sandbox primitives like BASH appearing in tool-call traces) and
+ * still needs to identify them by key.
+ */
 export declare enum ToolId {
     IMAGE_GEN = "IMAGE_GEN",
     IMAGE_EDIT = "IMAGE_EDIT",

package/build/v1/ai/tool-id.enum.js

@@ -1,23 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToolId = void 0;
+/**
+ * Canonical native tool identifiers. Mirrors NATIVE_TOOL_KEYS on the
+ * backend 1:1 — keep both lists in sync when adding a new native tool.
+ *
+ * User-facing tools (visibility: REGISTERED) and SYSTEM-only tools are
+ * both included: the FE may receive a SYSTEM tool key via stream events
+ * (e.g. image_edit routing internally to IMAGE_UPSCALE / IMAGE_REMOVE_BG,
+ * or sandbox primitives like BASH appearing in tool-call traces) and
+ * still needs to identify them by key.
+ */
 var ToolId;
 (function (ToolId) {
+    // User-facing tools — surfaced via /tools/availability
     ToolId["IMAGE_GEN"] = "IMAGE_GEN";
     ToolId["IMAGE_EDIT"] = "IMAGE_EDIT";
     ToolId["WEB_SEARCH"] = "WEB_SEARCH";
     ToolId["YOUTUBE_VIDEO_ANALYSIS"] = "YOUTUBE_VIDEO_ANALYSIS";
     ToolId["HTML_VISUALIZATION"] = "HTML_VISUALIZATION";
+    // SYSTEM tools — routed internally, may surface in stream events
     ToolId["IMAGE_UPSCALE"] = "IMAGE_UPSCALE";
     ToolId["IMAGE_REMOVE_BG"] = "IMAGE_REMOVE_BG";
     ToolId["FIND_IN_CHAT"] = "FIND_IN_CHAT";
     ToolId["VIEW_FILE"] = "VIEW_FILE";
     ToolId["SEND_FILE"] = "SEND_FILE";
+    // Sandbox primitive tools
     ToolId["BASH"] = "BASH";
     ToolId["CREATE_FILE"] = "CREATE_FILE";
     ToolId["STR_REPLACE"] = "STR_REPLACE";
     ToolId["SANDBOX_VIEW"] = "SANDBOX_VIEW";
+    // Memory management
     ToolId["MEMORY"] = "MEMORY";
+    // Cross-chat recall tools
     ToolId["CONVERSATION_SEARCH"] = "CONVERSATION_SEARCH";
     ToolId["RECENT_CHATS"] = "RECENT_CHATS";
 })(ToolId || (exports.ToolId = ToolId = {}));

package/build/v1/ai/tool-id.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-id.enum.js","sourceRoot":"","sources":["../../../v1/ai/tool-id.enum.ts"],"names":[],"mappings":";;;AAUA,IAAY,MAuBX;AAvBD,WAAY,MAAM;IAEd,iCAAuB,CAAA;IACvB,mCAAyB,CAAA;IACzB,mCAAyB,CAAA;IACzB,2DAAiD,CAAA;IACjD,mDAAyC,CAAA;IAEzC,yCAA+B,CAAA;IAC/B,6CAAmC,CAAA;IACnC,uCAA6B,CAAA;IAC7B,iCAAuB,CAAA;IACvB,iCAAuB,CAAA;IAEvB,uBAAa,CAAA;IACb,qCAA2B,CAAA;IAC3B,qCAA2B,CAAA;IAC3B,uCAA6B,CAAA;IAE7B,2BAAiB,CAAA;IAEjB,qDAA2C,CAAA;IAC3C,uCAA6B,CAAA;AACjC,CAAC,EAvBW,MAAM,sBAAN,MAAM,QAuBjB"}
+{"version":3,"file":"tool-id.enum.js","sourceRoot":"","sources":["../../../v1/ai/tool-id.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,IAAY,MAuBX;AAvBD,WAAY,MAAM;IACd,uDAAuD;IACvD,iCAAuB,CAAA;IACvB,mCAAyB,CAAA;IACzB,mCAAyB,CAAA;IACzB,2DAAiD,CAAA;IACjD,mDAAyC,CAAA;IACzC,iEAAiE;IACjE,yCAA+B,CAAA;IAC/B,6CAAmC,CAAA;IACnC,uCAA6B,CAAA;IAC7B,iCAAuB,CAAA;IACvB,iCAAuB,CAAA;IACvB,0BAA0B;IAC1B,uBAAa,CAAA;IACb,qCAA2B,CAAA;IAC3B,qCAA2B,CAAA;IAC3B,uCAA6B,CAAA;IAC7B,oBAAoB;IACpB,2BAAiB,CAAA;IACjB,0BAA0B;IAC1B,qDAA2C,CAAA;IAC3C,uCAA6B,CAAA;AACjC,CAAC,EAvBW,MAAM,sBAAN,MAAM,QAuBjB"}

package/build/v1/ai/tool.types.d.ts

@@ -1,4 +1,7 @@
 import { z } from 'zod';
+/**
+ * Tool selection from client (installed tool + model to use)
+ */
 export declare const ToolSelectionSchema: z.ZodObject<{
     toolUuid: z.ZodString;
     modelId: z.ZodString;

package/build/v1/ai/tool.types.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToolSelectionArraySchema = exports.ToolSelectionSchema = void 0;
 const zod_1 = require("zod");
+/**
+ * Tool selection from client (installed tool + model to use)
+ */
 exports.ToolSelectionSchema = zod_1.z.object({
     toolUuid: zod_1.z
         .string({ error: 'ToolSelection.toolUuid.required' })

package/build/v1/ai/tool.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.types.js","sourceRoot":"","sources":["../../../v1/ai/tool.types.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAKX,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,OAAC;SACN,MAAM,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;SACpD,IAAI,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;IACxD,OAAO,EAAE,OAAC;SACL,MAAM,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;SACnD,IAAI,CAAC,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;CAC1D,CAAC,CAAC;AAIU,QAAA,wBAAwB,GAAG,OAAC,CAAC,KAAK,CAAC,2BAAmB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEvC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,QAAQ,CAAC;gBACb,IAAI,EAAE,OAAC,CAAC,YAAY,CAAC,MAAM;gBAC3B,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC;gBACzB,OAAO,EAAE,uCAAuC;aACnD,CAAC,CAAC;YACH,SAAS;QACb,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"tool.types.js","sourceRoot":"","sources":["../../../v1/ai/tool.types.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;GAEG;AACU,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,OAAC;SACN,MAAM,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;SACpD,IAAI,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;IACxD,OAAO,EAAE,OAAC;SACL,MAAM,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;SACnD,IAAI,CAAC,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;CAC1D,CAAC,CAAC;AAIU,QAAA,wBAAwB,GAAG,OAAC,CAAC,KAAK,CAAC,2BAAmB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEvC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,QAAQ,CAAC;gBACb,IAAI,EAAE,OAAC,CAAC,YAAY,CAAC,MAAM;gBAC3B,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC;gBACzB,OAAO,EAAE,uCAAuC;aACnD,CAAC,CAAC;YACH,SAAS;QACb,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/v1/ai-call/ai-attempt-end-code.enum.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `ai_calls.error_code` values that are not an `AIErrorCode`. Together with the pool's own error
+ * codes they make the stored code sufficient to decide "circuit strike or not" with a pure function:
+ * a strike is `isRetryableAiErrorCode(code)` or `UNEXPECTED_ERROR`.
+ */
+export declare enum AiAttemptEndCode {
+    /** The route's endpoint cannot take the request's parameters. Failover, never a strike. */
+    ROUTE_CAPABILITY_MISMATCH = "ROUTE_CAPABILITY_MISMATCH",
+    /** The served stream was closed by its consumer without a client abort. Never a strike. */
+    STREAM_CLOSED_EARLY = "STREAM_CLOSED_EARLY",
+    /** The attempt threw instead of returning a Result: an infrastructure fault, a strike. */
+    UNEXPECTED_ERROR = "UNEXPECTED_ERROR",
+    /** A search vendor rejected our request or credentials (client, auth, unknown). Never a strike. */
+    SEARCH_REJECTED = "SEARCH_REJECTED"
+}

package/build/v1/ai-call/ai-attempt-end-code.enum.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiAttemptEndCode = void 0;
+/**
+ * `ai_calls.error_code` values that are not an `AIErrorCode`. Together with the pool's own error
+ * codes they make the stored code sufficient to decide "circuit strike or not" with a pure function:
+ * a strike is `isRetryableAiErrorCode(code)` or `UNEXPECTED_ERROR`.
+ */
+var AiAttemptEndCode;
+(function (AiAttemptEndCode) {
+    /** The route's endpoint cannot take the request's parameters. Failover, never a strike. */
+    AiAttemptEndCode["ROUTE_CAPABILITY_MISMATCH"] = "ROUTE_CAPABILITY_MISMATCH";
+    /** The served stream was closed by its consumer without a client abort. Never a strike. */
+    AiAttemptEndCode["STREAM_CLOSED_EARLY"] = "STREAM_CLOSED_EARLY";
+    /** The attempt threw instead of returning a Result: an infrastructure fault, a strike. */
+    AiAttemptEndCode["UNEXPECTED_ERROR"] = "UNEXPECTED_ERROR";
+    /** A search vendor rejected our request or credentials (client, auth, unknown). Never a strike. */
+    AiAttemptEndCode["SEARCH_REJECTED"] = "SEARCH_REJECTED";
+})(AiAttemptEndCode || (exports.AiAttemptEndCode = AiAttemptEndCode = {}));
+//# sourceMappingURL=ai-attempt-end-code.enum.js.map

package/build/v1/ai-call/ai-attempt-end-code.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-attempt-end-code.enum.js","sourceRoot":"","sources":["../../../v1/ai-call/ai-attempt-end-code.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,gBASX;AATD,WAAY,gBAAgB;IACxB,2FAA2F;IAC3F,2EAAuD,CAAA;IACvD,2FAA2F;IAC3F,+DAA2C,CAAA;IAC3C,0FAA0F;IAC1F,yDAAqC,CAAA;IACrC,mGAAmG;IACnG,uDAAmC,CAAA;AACvC,CAAC,EATW,gBAAgB,gCAAhB,gBAAgB,QAS3B"}