@marinoscar/platform-api 0.1.0-next.4 → 0.1.0-next.6

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @marinoscar/platform-api
 
+## 0.1.0-next.6
+
+### Minor Changes
+
+- e1ca08c: New package `@marinoscar/platform-ai-providers` (#991): the five AI provider adapters (OpenAI, OpenAI-compatible, Azure OpenAI, Anthropic, Gemini) and the provider-agnostic core they implement, runnable in a plain Node process (no Nest, no database, no OpenTelemetry SDK). Subpaths: `.` (core types, `AiProviderAdapter` and its ports, `AiError` and its codes, capabilities, structured output, tools, hosted tools, conversation helpers, media and file-input types, `parseRetryAfterMs`, and the structural `AiLogger` and `AiTracer` ports), `./openai`, `./anthropic`, `./gemini`, and `./<provider>/testing` (mock transports and fixtures). `zod` is a required peer; each SDK is an optional peer loaded only by its subpath. Each adapter is built with `create*Adapter({ clients?, logger?, tracer? })`; without a tracer no span is started. API: `@marinoscar/platform-api/ai` keeps every exported name and type: it re-exports the core, its provider classes are now Nest subclasses of the lean adapters and client factories (same constructors, injection tokens, logger names and `ai.provider.call` spans), and `AiError` is still an `HttpException` with `toRateLimitError()` (the platform splices `HttpException` into its prototype chain when `ai/core/ai-error` loads). `parseRetryAfterMs` moved to the new package and `@marinoscar/platform-api/jobs` re-exports it. The `ai-no-sdk-leak` suite gains `aiProvidersPackageSdkDirs` and accepts a list of `sdkOwner` manifests; the platform package's own provider folders now import no SDK. Back-compat: no route, shape, id or behaviour changes; the platform package still depends on the three SDKs so an app gets them installed.
+
+### Patch Changes
+
+- Updated dependencies [e1ca08c]
+  - @marinoscar/platform-ai-providers@0.1.0-next.6
+  - @marinoscar/platform-contract@0.1.0-next.6
+
+## 0.1.0-next.5
+
+### Patch Changes
+
+- @marinoscar/platform-contract@0.1.0-next.5
+
 ## 0.1.0-next.4
 
 ### Minor Changes

package/dist/ai/core/ai-error.d.ts

@@ -1,161 +1,18 @@
 import { HttpException } from '@nestjs/common';
-import { CLASSIFY_RATE_LIMIT, RateLimitError, type RateLimitClassification, type SelfClassifyingRateLimit } from '../../jobs/index';
-/**
- * Every AI error code and the HTTP status it answers with. The codes are
- * permanent API strings: clients switch on `details.reason`.
- *
- * @stability experimental
- */
-export declare const AI_ERROR_STATUS: {
-    /** AI is switched off (for the deployment, or for the caller's organization). */
-    readonly AI_DISABLED: 403;
-    /** The provider is switched off, or not registered. */
-    readonly AI_PROVIDER_DISABLED: 403;
-    /** No key may pay for this call (the policy needs the caller's own key). */
-    readonly AI_KEY_REQUIRED: 403;
-    /** The provider rejected the key. */
-    readonly AI_KEY_INVALID: 400;
-    /** An administrator has not enabled the model. */
-    readonly AI_MODEL_NOT_ENABLED: 403;
-    /** The key that would pay cannot reach the model. */
-    readonly AI_MODEL_NOT_REACHABLE: 403;
-    /** The request needs a capability the model or provider lacks. */
-    readonly AI_CAPABILITY_UNSUPPORTED: 400;
-    /** A hosted tool type an administrator has not switched on, or an MCP host outside the allowlist (#442). */
-    readonly AI_TOOL_DISABLED: 403;
-    /** Realtime voice sessions are switched off (`ai.defaults.allowRealtime`, #449). */
-    readonly AI_REALTIME_DISABLED: 403;
-    /** A deployment limit, or the provider's own rate limit, refused the call. */
-    readonly AI_RATE_LIMITED: 429;
-    /** The provider failed or could not be reached. */
-    readonly AI_PROVIDER_UNAVAILABLE: 503;
-    /** The provider's content filter refused the request or the output. */
-    readonly AI_CONTENT_FILTERED: 422;
-    /** The request itself is malformed. */
-    readonly AI_INVALID_REQUEST: 400;
-    /** The model's output did not match the requested schema. */
-    readonly AI_STRUCTURED_OUTPUT_INVALID: 502;
-    /** Object storage is not configured (or not usable) for this operation. */
-    readonly AI_STORAGE_UNAVAILABLE: 503;
-};
-/**
- * One AI error code (a key of {@link AI_ERROR_STATUS}).
- *
- * @stability experimental
- */
-export type AiErrorCode = keyof typeof AI_ERROR_STATUS;
-/**
- * Every code, in declaration order.
- *
- * @stability experimental
- */
-export declare const AI_ERROR_CODES: AiErrorCode[];
-/**
- * Type guard for a string that arrived from somewhere untyped.
- *
- * @stability experimental
- */
-export declare function isAiErrorCode(value: unknown): value is AiErrorCode;
-/**
- * What an {@link AiError} may carry besides its code and message.
- *
- * @stability experimental
- */
-export interface AiErrorOptions {
-    /** Provider-requested delay before retrying, when it named one. */
-    retryAfterMs?: number;
-    /** The underlying error. Kept for debugging, never serialised. */
-    cause?: unknown;
-    /** Extra machine-readable context. Must not contain secret material. */
-    details?: Record<string, unknown>;
+import { RateLimitError, type SelfClassifyingRateLimit } from '../../jobs/index';
+declare module '@marinoscar/platform-ai-providers' {
+    interface AiError extends HttpException, SelfClassifyingRateLimit {
+        /**
+         * The queue's rate-limit signal for this error, or `null` when this
+         * error is not a rate limit. A job handler does
+         * `throw err.toRateLimitError() ?? err;` so a provider throttle defers
+         * the job instead of charging an attempt.
+         *
+         * @returns a `RateLimitError` for `AI_RATE_LIMITED`, otherwise `null`.
+         */
+        toRateLimitError(): RateLimitError | null;
+    }
 }
-/**
- * The body an {@link AiError} throws (wrapped by the exception filter in the
- * standard envelope).
- *
- * @stability experimental
- */
-export interface AiErrorBody {
-    /** The AI error code. */
-    code: AiErrorCode;
-    /** A message safe to show. */
-    message: string;
-    /** Machine-readable context; `reason` is always the code. */
-    details: Record<string, unknown> & {
-        /** The AI error code, where clients read it. */
-        reason: AiErrorCode;
-        /** The provider-requested back-off, when it named one. */
-        retryAfterMs?: number;
-    };
-}
-/**
- * The one error the AI platform throws: an `HttpException` whose status
- * follows the code ({@link AI_ERROR_STATUS}) and whose body carries the code
- * in `details.reason`. Never carries key material; `cause` is never
- * serialised.
- *
- * @stability experimental
- */
-export declare class AiError extends HttpException implements SelfClassifyingRateLimit {
-    /** The AI error code. */
-    readonly code: AiErrorCode;
-    /** The provider-requested back-off, when it named one. */
-    readonly retryAfterMs?: number;
-    readonly cause: unknown;
-    constructor(code: AiErrorCode, message: string, opts?: AiErrorOptions);
-    /** The public body, and nothing else — no `cause`, no stack. */
-    toJSON(): AiErrorBody;
-    /**
-     * The queue's rate-limit signal for this error, or `null` when this error
-     * is not a rate limit. A job handler does
-     * `throw err.toRateLimitError() ?? err;` so a provider throttle defers the
-     * job instead of charging an attempt.
-     */
-    toRateLimitError(): RateLimitError | null;
-    /**
-     * How the job queue's `classifyRateLimit` reads this error (issue #509):
-     * a rate limit iff the CODE says so — `AI_RATE_LIMITED`, the same rule as
-     * `toRateLimitError()` — and never by `.status`. That status is the HTTP
-     * response status this platform assigned to the code (503 for
-     * `AI_STORAGE_UNAVAILABLE` and `AI_PROVIDER_UNAVAILABLE`), not a
-     * provider's capacity signal, so without this a thrown `AiError` 503 was
-     * deferred as a throttle instead of failing or charging an attempt.
-     *
-     * A symbol-keyed prototype method: non-enumerable, so it never reaches
-     * `toJSON()`, the exception filter's body, or a structured log line.
-     */
-    [CLASSIFY_RATE_LIMIT](): RateLimitClassification;
-    /**
-     * Type guard.
-     *
-     * @param value - anything caught.
-     * @returns whether it is an `AiError`.
-     */
-    static isAiError(value: unknown): value is AiError;
-    /**
-     * Returns `err` unchanged when it is already an `AiError`, otherwise a new
-     * `AiError(code)` with `err` as its (non-serialised) cause. The message is
-     * generic ON PURPOSE — an SDK's own message may echo request details.
-     */
-    static wrap(err: unknown, code?: AiErrorCode, message?: string): AiError;
-}
-/**
- * The provider metadata in an `AiError`'s `details` that is safe to log —
- * the HTTP status and the provider's own short error code, type, offending
- * parameter and request id — and nothing else: never a URL or
- * key material. For `AI_INVALID_REQUEST` only, the cause's message is appended
- * as `providerMessage` (log-only, never in `details`), with key-like tokens,
- * Bearer credentials and URLs redacted. Fields an error does not carry are
- * left out; string values are capped and quoted so no provider string can
- * forge a log line.
- *
- * @stability experimental
- */
-export declare const AI_ERROR_LOG_DETAIL_KEYS: readonly ["status", "providerCode", "providerType", "param", "providerRequestId"];
-/**
- * `status=400 providerCode="…" … providerMessage="…"` for `error`, or `''` when it carries none of the safe fields.
- *
- * @stability experimental
- */
-export declare function aiErrorLogDetails(error: AiError): string;
+export { AI_ERROR_CODES, AI_ERROR_LOG_DETAIL_KEYS, AI_ERROR_STATUS, AiError, aiErrorLogDetails, isAiErrorCode, } from '@marinoscar/platform-ai-providers';
+export type { AiErrorBody, AiErrorCode, AiErrorOptions } from '@marinoscar/platform-ai-providers';
 //# sourceMappingURL=ai-error.d.ts.map

package/dist/ai/core/ai-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-error.d.ts","sourceRoot":"","sources":["../../../src/ai/core/ai-error.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC9B,MAAM,kBAAkB,CAAC;AAE1B;;;;;GAKG;AACH,eAAO,MAAM,eAAe;IAC1B,iFAAiF;;IAEjF,uDAAuD;;IAEvD,4EAA4E;;IAE5E,qCAAqC;;IAErC,kDAAkD;;IAElD,qDAAqD;;IAErD,kEAAkE;;IAElE,4GAA4G;;IAE5G,oFAAoF;;IAEpF,8EAA8E;;IAE9E,mDAAmD;;IAEnD,uEAAuE;;IAEvE,uCAAuC;;IAEvC,6DAA6D;;IAE7D,2EAA2E;;CAMnE,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,eAAe,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAmC,WAAW,EAAE,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AA8BD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QACjC,gDAAgD;QAChD,MAAM,EAAE,WAAW,CAAC;QACpB,0DAA0D;QAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;;;;;;GAOG;AACH,qBAAa,OAAQ,SAAQ,aAAc,YAAW,wBAAwB;IAC5E,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAiB,KAAK,EAAE,OAAO,CAAC;gBAEpB,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB;IAoCzE,gEAAgE;IAChE,MAAM,IAAI,WAAW;IAIrB;;;;;OAKG;IACH,gBAAgB,IAAI,cAAc,GAAG,IAAI;IAQzC;;;;;;;;;;;OAWG;IACH,CAAC,mBAAmB,CAAC,IAAI,uBAAuB;IAMhD;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO;IAIlD;;;;OAIG;IACH,MAAM,CAAC,IAAI,CACT,GAAG,EAAE,OAAO,EACZ,IAAI,GAAE,WAAuC,EAC7C,OAAO,SAAoC,GAC1C,OAAO;CAOX;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,mFAAoF,CAAC;AAgC1H;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAuBxD"}
+{"version":3,"file":"ai-error.d.ts","sourceRoot":"","sources":["../../../src/ai/core/ai-error.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAuB,cAAc,EAAE,KAAK,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEtG,OAAO,QAAQ,mCAAmC,CAAC;IAIjD,UAAU,OAAQ,SAAQ,aAAa,EAAE,wBAAwB;QAC/D;;;;;;;WAOG;QACH,gBAAgB,IAAI,cAAc,GAAG,IAAI,CAAC;KAC3C;CACF;AAiCD,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,OAAO,EACP,iBAAiB,EACjB,aAAa,GACd,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/ai/core/ai-error.js

@@ -1,233 +1,70 @@
 "use strict";
 // =============================================================================
-// AI error taxonomy (issue #424, epic #419)
+// AiError: the platform integration (issue #991; taxonomy #424, epic #419)
 // =============================================================================
 //
-// Every failure an AI caller can see is one of these codes. Adapters map their
-// SDK's errors onto them (an SDK error never escapes an adapter), and the
-// runtime gates (#431) raise them directly.
+// The error taxonomy (`AI_ERROR_STATUS`, `AiError`, `aiErrorLogDetails`, ...)
+// moved to `@marinoscar/platform-ai-providers`, where `AiError` extends plain
+// `Error` so the adapters run without Nest. Inside the platform it must stay
+// what it always was: a Nest `HttpException` (the global
+// `HttpExceptionFilter` and Nest's own handlers test `instanceof
+// HttpException`) with `toRateLimitError()` for job handlers. This module
+// restores both, ONCE, when it is first loaded:
 //
-// The HTTP status is part of the code's definition rather than a choice made
-// at each throw site, so the same condition cannot surface as a 400 from one
-// endpoint and a 403 from another.
+//   1. `HttpException.prototype` is spliced into `AiError`'s prototype chain
+//      (and `HttpException` into the static side), so `new AiError(...)
+//      instanceof HttpException` holds. The lean class already carries every
+//      member `HttpException`'s constructor would have set (`response`,
+//      `status`, `options`, `message`, `name`, in that order) and its own
+//      `getResponse()`/`getStatus()`, so the filter reads the same body and
+//      status as before. Its `[CLASSIFY_RATE_LIMIT]` method is keyed by the
+//      registered `Symbol.for('jobs.classifyRateLimit')`, the very symbol
+//      `jobs/` exports, so `classifyRateLimit` already believes it.
+//   2. `toRateLimitError()` is added to the prototype, returning the queue's
+//      `RateLimitError` for `AI_RATE_LIMITED` and `null` otherwise.
+//   3. A module augmentation gives the type the same two facts, so
+//      platform code (and `@marinoscar/platform-api/ai` consumers) still see
+//      an `AiError` that extends `HttpException` and has
+//      `toRateLimitError(): RateLimitError | null`.
+//
+// Every platform file that uses `AiError` reaches it through this module:
+// the `ai/core/*` re-export shims import it for its side effect, and the
+// provider wrappers import it directly, so the patch has always run before
+// a platform code path can construct or catch an `AiError`.
 // =============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AI_ERROR_LOG_DETAIL_KEYS = exports.AiError = exports.AI_ERROR_CODES = exports.AI_ERROR_STATUS = void 0;
-exports.isAiErrorCode = isAiErrorCode;
-exports.aiErrorLogDetails = aiErrorLogDetails;
+exports.isAiErrorCode = exports.aiErrorLogDetails = exports.AiError = exports.AI_ERROR_STATUS = exports.AI_ERROR_LOG_DETAIL_KEYS = exports.AI_ERROR_CODES = void 0;
 const common_1 = require("@nestjs/common");
+const platform_ai_providers_1 = require("@marinoscar/platform-ai-providers");
 const index_1 = require("../../jobs/index");
-/**
- * Every AI error code and the HTTP status it answers with. The codes are
- * permanent API strings: clients switch on `details.reason`.
- *
- * @stability experimental
- */
-exports.AI_ERROR_STATUS = {
-    /** AI is switched off (for the deployment, or for the caller's organization). */
-    AI_DISABLED: 403,
-    /** The provider is switched off, or not registered. */
-    AI_PROVIDER_DISABLED: 403,
-    /** No key may pay for this call (the policy needs the caller's own key). */
-    AI_KEY_REQUIRED: 403,
-    /** The provider rejected the key. */
-    AI_KEY_INVALID: 400,
-    /** An administrator has not enabled the model. */
-    AI_MODEL_NOT_ENABLED: 403,
-    /** The key that would pay cannot reach the model. */
-    AI_MODEL_NOT_REACHABLE: 403,
-    /** The request needs a capability the model or provider lacks. */
-    AI_CAPABILITY_UNSUPPORTED: 400,
-    /** A hosted tool type an administrator has not switched on, or an MCP host outside the allowlist (#442). */
-    AI_TOOL_DISABLED: 403,
-    /** Realtime voice sessions are switched off (`ai.defaults.allowRealtime`, #449). */
-    AI_REALTIME_DISABLED: 403,
-    /** A deployment limit, or the provider's own rate limit, refused the call. */
-    AI_RATE_LIMITED: 429,
-    /** The provider failed or could not be reached. */
-    AI_PROVIDER_UNAVAILABLE: 503,
-    /** The provider's content filter refused the request or the output. */
-    AI_CONTENT_FILTERED: 422,
-    /** The request itself is malformed. */
-    AI_INVALID_REQUEST: 400,
-    /** The model's output did not match the requested schema. */
-    AI_STRUCTURED_OUTPUT_INVALID: 502,
-    /** Object storage is not configured (or not usable) for this operation. */
-    // Object storage is not configured (or not usable) for an operation whose
-    // inputs or outputs are storage objects — image generation (#437) and the
-    // media stories after it. An administrator fixes it at
-    // `/admin/settings/storage`; the request itself was fine.
-    AI_STORAGE_UNAVAILABLE: 503,
-};
-/**
- * Every code, in declaration order.
- *
- * @stability experimental
- */
-exports.AI_ERROR_CODES = Object.keys(exports.AI_ERROR_STATUS);
-/**
- * Type guard for a string that arrived from somewhere untyped.
- *
- * @stability experimental
- */
-function isAiErrorCode(value) {
-    return typeof value === 'string' && Object.prototype.hasOwnProperty.call(exports.AI_ERROR_STATUS, value);
-}
-/**
- * The one error the AI platform throws: an `HttpException` whose status
- * follows the code ({@link AI_ERROR_STATUS}) and whose body carries the code
- * in `details.reason`. Never carries key material; `cause` is never
- * serialised.
- *
- * @stability experimental
- */
-class AiError extends common_1.HttpException {
-    /** The AI error code. */
-    code;
-    /** The provider-requested back-off, when it named one. */
-    retryAfterMs;
-    constructor(code, message, opts = {}) {
-        const details = {
-            ...(opts.details ?? {}),
-            // `reason` is written LAST so a caller-supplied `details.reason` can
-            // never make the body disagree with `code`.
-            reason: code,
-        };
-        if (opts.retryAfterMs !== undefined) {
-            details.retryAfterMs = opts.retryAfterMs;
-        }
-        const body = { code, message, details };
-        // No `options` argument: HttpException would copy `cause` onto two
-        // enumerable properties (`options.cause` and `cause`). See header.
-        super(body, exports.AI_ERROR_STATUS[code]);
-        this.code = code;
-        if (opts.retryAfterMs !== undefined) {
-            this.retryAfterMs = opts.retryAfterMs;
-        }
-        Object.defineProperty(this, 'cause', {
-            value: opts.cause,
-            enumerable: false,
-            writable: false,
-            configurable: true,
-        });
-        // Keep `instanceof AiError` working however the class is downlevelled —
-        // see the same line in `jobs/rate-limit.error.ts` for why it matters.
-        Object.setPrototypeOf(this, AiError.prototype);
-    }
-    /** The public body, and nothing else — no `cause`, no stack. */
-    toJSON() {
-        return this.getResponse();
-    }
-    /**
-     * The queue's rate-limit signal for this error, or `null` when this error
-     * is not a rate limit. A job handler does
-     * `throw err.toRateLimitError() ?? err;` so a provider throttle defers the
-     * job instead of charging an attempt.
-     */
-    toRateLimitError() {
-        if (this.code !== 'AI_RATE_LIMITED') {
-            return null;
-        }
-        return new index_1.RateLimitError(this.message, this.retryAfterMs);
-    }
-    /**
-     * How the job queue's `classifyRateLimit` reads this error (issue #509):
-     * a rate limit iff the CODE says so — `AI_RATE_LIMITED`, the same rule as
-     * `toRateLimitError()` — and never by `.status`. That status is the HTTP
-     * response status this platform assigned to the code (503 for
-     * `AI_STORAGE_UNAVAILABLE` and `AI_PROVIDER_UNAVAILABLE`), not a
-     * provider's capacity signal, so without this a thrown `AiError` 503 was
-     * deferred as a throttle instead of failing or charging an attempt.
-     *
-     * A symbol-keyed prototype method: non-enumerable, so it never reaches
-     * `toJSON()`, the exception filter's body, or a structured log line.
-     */
-    [index_1.CLASSIFY_RATE_LIMIT]() {
-        return this.code === 'AI_RATE_LIMITED'
-            ? { rateLimited: true, retryAfterMs: this.retryAfterMs ?? null }
-            : { rateLimited: false, retryAfterMs: null };
-    }
-    /**
-     * Type guard.
-     *
-     * @param value - anything caught.
-     * @returns whether it is an `AiError`.
-     */
-    static isAiError(value) {
-        return value instanceof AiError;
-    }
-    /**
-     * Returns `err` unchanged when it is already an `AiError`, otherwise a new
-     * `AiError(code)` with `err` as its (non-serialised) cause. The message is
-     * generic ON PURPOSE — an SDK's own message may echo request details.
-     */
-    static wrap(err, code = 'AI_PROVIDER_UNAVAILABLE', message = 'The AI provider request failed.') {
-        if (err instanceof AiError) {
-            return err;
-        }
-        return new AiError(code, message, { cause: err });
-    }
-}
-exports.AiError = AiError;
-/**
- * The provider metadata in an `AiError`'s `details` that is safe to log —
- * the HTTP status and the provider's own short error code, type, offending
- * parameter and request id — and nothing else: never a URL or
- * key material. For `AI_INVALID_REQUEST` only, the cause's message is appended
- * as `providerMessage` (log-only, never in `details`), with key-like tokens,
- * Bearer credentials and URLs redacted. Fields an error does not carry are
- * left out; string values are capped and quoted so no provider string can
- * forge a log line.
- *
- * @stability experimental
- */
-exports.AI_ERROR_LOG_DETAIL_KEYS = ['status', 'providerCode', 'providerType', 'param', 'providerRequestId'];
-const AI_ERROR_LOG_VALUE_MAX = 120;
-const AI_ERROR_LOG_MESSAGE_MAX = 300;
-const AI_ERROR_LOG_REDACTIONS = [
-    /\b(sk|rk|pk|sess)-[A-Za-z0-9_\-*]{6,}/g,
-    /Bearer\s+\S+/gi,
-    /https?:\/\/\S+/gi,
-];
-/**
- * The provider's own message for a rejected request (the one field that says
- * WHY a 400 happened), redacted, whitespace-collapsed and capped; `null` when
- * the cause carries none.
- */
-function providerMessageForLog(cause) {
-    if (!(cause instanceof Error) || typeof cause.message !== 'string' || cause.message.length === 0) {
-        return null;
-    }
-    let message = cause.message;
-    for (const pattern of AI_ERROR_LOG_REDACTIONS) {
-        message = message.replace(pattern, '[redacted]');
-    }
-    message = message.replace(/\s+/g, ' ').trim().slice(0, AI_ERROR_LOG_MESSAGE_MAX);
-    return message.length > 0 ? message : null;
-}
-/**
- * `status=400 providerCode="…" … providerMessage="…"` for `error`, or `''` when it carries none of the safe fields.
- *
- * @stability experimental
- */
-function aiErrorLogDetails(error) {
-    const details = error.getResponse().details ?? {};
-    const parts = [];
-    for (const key of exports.AI_ERROR_LOG_DETAIL_KEYS) {
-        const value = details[key];
-        if (typeof value === 'number' && Number.isFinite(value)) {
-            parts.push(`${key}=${value}`);
-        }
-        else if (typeof value === 'string' && value.length > 0) {
-            parts.push(`${key}=${JSON.stringify(value.slice(0, AI_ERROR_LOG_VALUE_MAX))}`);
-        }
-    }
-    if (error.code === 'AI_INVALID_REQUEST') {
-        const providerMessage = providerMessageForLog(error.cause);
-        if (providerMessage !== null) {
-            parts.push(`providerMessage=${JSON.stringify(providerMessage)}`);
-        }
+/** True once this module has patched the class (it is evaluated once per module instance). */
+const PATCHED = Symbol.for('platform-api.ai.AiErrorHttpException');
+if (!platform_ai_providers_1.AiError[PATCHED]) {
+    Object.setPrototypeOf(platform_ai_providers_1.AiError.prototype, common_1.HttpException.prototype);
+    Object.setPrototypeOf(platform_ai_providers_1.AiError, common_1.HttpException);
+    Object.defineProperty(platform_ai_providers_1.AiError.prototype, 'toRateLimitError', {
+        value: function toRateLimitError() {
+            if (this.code !== 'AI_RATE_LIMITED') {
+                return null;
+            }
+            return new index_1.RateLimitError(this.message, this.retryAfterMs);
+        },
+        enumerable: false,
+        writable: true,
+        configurable: true,
+    });
+    // The lean class keys its classifier by `Symbol.for('jobs.classifyRateLimit')`;
+    // fail loudly at load time if the queue ever changes the symbol.
+    if (typeof platform_ai_providers_1.AiError.prototype[index_1.CLASSIFY_RATE_LIMIT] !== 'function') {
+        throw new Error('AiError does not implement the job queue CLASSIFY_RATE_LIMIT contract.');
     }
-    return parts.join(' ');
+    Object.defineProperty(platform_ai_providers_1.AiError, PATCHED, { value: true });
 }
+var platform_ai_providers_2 = require("@marinoscar/platform-ai-providers");
+Object.defineProperty(exports, "AI_ERROR_CODES", { enumerable: true, get: function () { return platform_ai_providers_2.AI_ERROR_CODES; } });
+Object.defineProperty(exports, "AI_ERROR_LOG_DETAIL_KEYS", { enumerable: true, get: function () { return platform_ai_providers_2.AI_ERROR_LOG_DETAIL_KEYS; } });
+Object.defineProperty(exports, "AI_ERROR_STATUS", { enumerable: true, get: function () { return platform_ai_providers_2.AI_ERROR_STATUS; } });
+Object.defineProperty(exports, "AiError", { enumerable: true, get: function () { return platform_ai_providers_2.AiError; } });
+Object.defineProperty(exports, "aiErrorLogDetails", { enumerable: true, get: function () { return platform_ai_providers_2.aiErrorLogDetails; } });
+Object.defineProperty(exports, "isAiErrorCode", { enumerable: true, get: function () { return platform_ai_providers_2.isAiErrorCode; } });
 //# sourceMappingURL=ai-error.js.map

package/dist/ai/core/ai-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-error.js","sourceRoot":"","sources":["../../../src/ai/core/ai-error.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ai-error.js","sourceRoot":"","sources":["../../../src/ai/core/ai-error.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,2EAA2E;AAC3E,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,iEAAiE;AACjE,0EAA0E;AAC1E,gDAAgD;AAChD,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,6EAA6E;AAC7E,wEAAwE;AACxE,0EAA0E;AAC1E,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,oEAAoE;AACpE,6EAA6E;AAC7E,oEAAoE;AACpE,mEAAmE;AACnE,6EAA6E;AAC7E,yDAAyD;AACzD,oDAAoD;AACpD,EAAE;AACF,0EAA0E;AAC1E,yEAAyE;AACzE,2EAA2E;AAC3E,4DAA4D;AAC5D,gFAAgF;;;AAEhF,2CAA+C;AAC/C,6EAA4D;AAE5D,4CAAsG;AAmBtG,8FAA8F;AAC9F,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;AAInE,IAAI,CAAE,+BAA4B,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5C,MAAM,CAAC,cAAc,CAAC,+BAAO,CAAC,SAAS,EAAE,sBAAa,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,CAAC,cAAc,CAAC,+BAAO,EAAE,sBAAa,CAAC,CAAC;IAE9C,MAAM,CAAC,cAAc,CAAC,+BAAO,CAAC,SAAS,EAAE,kBAAkB,EAAE;QAC3D,KAAK,EAAE,SAAS,gBAAgB;YAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACpC,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,IAAI,sBAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7D,CAAC;QACD,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IAEH,gFAAgF;IAChF,iEAAiE;IACjE,IAAI,OAAQ,+BAAO,CAAC,SAA+C,CAAC,2BAAmB,CAAC,KAAK,UAAU,EAAE,CAAC;QACxG,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,+BAAO,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,2EAO2C;AANzC,uHAAA,cAAc,OAAA;AACd,iIAAA,wBAAwB,OAAA;AACxB,wHAAA,eAAe,OAAA;AACf,gHAAA,OAAO,OAAA;AACP,0HAAA,iBAAiB,OAAA;AACjB,sHAAA,aAAa,OAAA"}