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

package/dist/ai/providers/openai/openai-embeddings.mapper.js

@@ -1,81 +0,0 @@
-"use strict";
-// =============================================================================
-// OpenAI embeddings mapper (issue #440, epic #420)
-// =============================================================================
-//
-// AiEmbeddingRequest <-> `POST /v1/embeddings`. Pure functions; every failure
-// is an `AiError`, never an SDK error.
-//
-// FLOATS ON THE WIRE, ALWAYS. The SDK asks for `base64` when no
-// `encoding_format` is given and decodes it into `Float32Array`s, which are
-// not `number[]` (JSON.stringify turns one into an object keyed by index).
-// This mapper pins `encoding_format: 'float'` and forbids the escape hatch
-// from changing it, so a vector is a plain `number[]` end to end.
-//
-// `dimensions`. Only `text-embedding-3` and later accept it; `ada-002` is the
-// one family known NOT to, and is refused here rather than sent to a 400 the
-// caller would have to decode. An unknown id passes through — the provider
-// is the authority, and its 400 maps to `AI_INVALID_REQUEST` anyway.
-// =============================================================================
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.openAiEmbeddingSupportsDimensions = openAiEmbeddingSupportsDimensions;
-exports.toOpenAiEmbeddingRequest = toOpenAiEmbeddingRequest;
-exports.fromOpenAiEmbeddingResponse = fromOpenAiEmbeddingResponse;
-const ai_error_1 = require("../../core/ai-error");
-const openai_errors_1 = require("./openai-errors");
-/** Embedding families that do not accept `dimensions`. */
-const FIXED_DIMENSION_MODELS = /^text-embedding-ada-/;
-/** Whether OpenAI model `modelId` accepts the `dimensions` parameter. */
-function openAiEmbeddingSupportsDimensions(modelId) {
-    return !FIXED_DIMENSION_MODELS.test(modelId.trim().toLowerCase());
-}
-/** The `/v1/embeddings` body for `req`. `providerOptions.openai` merges first; the port's own fields win. */
-function toOpenAiEmbeddingRequest(req, family = openai_errors_1.OPENAI_FAMILY) {
-    if (req.dimensions !== undefined && !openAiEmbeddingSupportsDimensions(req.model)) {
-        throw new ai_error_1.AiError('AI_INVALID_REQUEST', `Model "${req.model}" does not support a custom embedding length (dimensions).`, { details: { provider: family.providerId, model: req.model, dimensions: req.dimensions } });
-    }
-    const escapeHatch = (req.providerOptions?.[family.providerId] ?? {});
-    return {
-        ...escapeHatch,
-        model: req.model,
-        input: req.input,
-        ...(req.dimensions !== undefined ? { dimensions: req.dimensions } : {}),
-        encoding_format: 'float',
-    };
-}
-/**
- * The neutral result. Vectors are ordered by OpenAI's `index` (never trusted
- * to already be in order), and the answer must hold exactly one vector per
- * input, all the same length — anything else is a provider fault
- * (`AI_PROVIDER_UNAVAILABLE`), not something to hand a caller who will store
- * it next to a row.
- */
-function fromOpenAiEmbeddingResponse(data, opts) {
-    const family = opts.family ?? openai_errors_1.OPENAI_FAMILY;
-    const expected = typeof opts.request.input === 'string' ? 1 : opts.request.input.length;
-    const items = [...(data.data ?? [])].sort((a, b) => a.index - b.index);
-    const vectors = items.map((item) => item.embedding);
-    const dimensions = vectors[0]?.length ?? 0;
-    const malformed = vectors.length !== expected ||
-        dimensions === 0 ||
-        vectors.some((vector) => !Array.isArray(vector) || vector.length !== dimensions);
-    if (malformed) {
-        throw new ai_error_1.AiError('AI_PROVIDER_UNAVAILABLE', `${family.label} returned a malformed embeddings response.`, {
-            details: {
-                provider: family.providerId,
-                expected,
-                received: vectors.length,
-                ...(opts.providerRequestId ? { providerRequestId: opts.providerRequestId } : {}),
-            },
-        });
-    }
-    return {
-        provider: family.providerId,
-        model: data.model || opts.request.model,
-        vectors,
-        dimensions,
-        usage: typeof data.usage?.prompt_tokens === 'number' ? { inputTokens: data.usage.prompt_tokens } : {},
-        ...(opts.providerRequestId ? { providerRequestId: opts.providerRequestId } : {}),
-    };
-}
-//# sourceMappingURL=openai-embeddings.mapper.js.map

package/dist/ai/providers/openai/openai-embeddings.mapper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai-embeddings.mapper.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-embeddings.mapper.ts"],"names":[],"mappings":"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"}

package/dist/ai/providers/openai/openai-errors.d.ts

@@ -1,45 +0,0 @@
-import { AiError, AiErrorCode } from '../../core/ai-error';
-export declare const OPENAI_PROVIDER_ID = "openai";
-/**
- * Which member of the OpenAI wire family an error or a response belongs to
- * (#448). The OpenAI adapter, the Azure OpenAI adapter and the generic
- * OpenAI-compatible adapter all speak the same wire protocol through the same
- * SDK, so they share this file's mapping and the mappers beside it; the
- * family only changes the provider id stamped on `details` /
- * `AiResponse.provider` and the name in the generic, secret-free messages. Every
- * function taking one defaults to {@link OPENAI_FAMILY}, so the OpenAI
- * adapter's behaviour is exactly what it was before the extraction.
- */
-export interface OpenAiFamily {
-    /** The adapter's permanent provider id (`'openai'`, `'azure-openai'`, ...). */
-    providerId: string;
-    /** How the generic error messages name the provider (`'OpenAI'`). */
-    label: string;
-}
-/** OpenAI itself. */
-export declare const OPENAI_FAMILY: OpenAiFamily;
-/** The generic, secret-free message this adapter family uses for `code`. */
-export declare function openAiErrorMessage(code: AiErrorCode, family?: OpenAiFamily): string;
-/** Classifies an OpenAI error `code` that arrived without a usable HTTP status. */
-export declare function classifyOpenAiErrorCode(code: string | null | undefined): AiErrorCode;
-/**
- * The provider's requested back-off: OpenAI's own millisecond header first
- * (more precise), then the standard `Retry-After` (seconds or HTTP-date).
- */
-export declare function retryAfterFromHeaders(headers: Headers | undefined): number | undefined;
-/** Which `AiErrorCode` an SDK `APIError` means. Pure — exported for the table spec. */
-export declare function openAiErrorCode(err: unknown): AiErrorCode;
-/**
- * Turns anything an OpenAI call threw into an `AiError`. An `AiError` is
- * returned unchanged (the mapper's own `AI_CAPABILITY_UNSUPPORTED`, for one).
- */
-export declare function mapOpenAiError(err: unknown, family?: OpenAiFamily): AiError;
-/**
- * The `AiError` for a response OpenAI returned with `status: 'failed'` (or a
- * `response.failed` stream event): the failure is in the body, not an HTTP
- * status, so only its `code` can be classified.
- */
-export declare function mapOpenAiResponseFailure(error: {
-    code?: string | null;
-} | null | undefined, providerRequestId?: string, family?: OpenAiFamily): AiError;
-//# sourceMappingURL=openai-errors.d.ts.map

package/dist/ai/providers/openai/openai-errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai-errors.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-errors.ts"],"names":[],"mappings":"AA0CA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAG3D,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAqB;AACrB,eAAO,MAAM,aAAa,EAAE,YAAiF,CAAC;AA8D9G,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,GAAE,YAA4B,GAAG,MAAM,CASlG;AAMD,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CASpF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUtF;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CA6CzD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,YAA4B,GAAG,OAAO,CA8B1F;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,EAClD,iBAAiB,CAAC,EAAE,MAAM,EAC1B,MAAM,GAAE,YAA4B,GACnC,OAAO,CAST"}

package/dist/ai/providers/openai/openai-errors.js

@@ -1,247 +0,0 @@
-"use strict";
-// =============================================================================
-// OpenAI SDK error -> AiError (issue #426, epic #419)
-// =============================================================================
-//
-// The one place an OpenAI SDK failure becomes an `AiError`. Every other file
-// in this adapter funnels its `catch` through `mapOpenAiError`, so a raw SDK
-// exception never crosses the `AiProviderAdapter` boundary (the conformance
-// kit asserts it) and the same provider condition cannot surface as two
-// different codes from two call sites.
-//
-// ⚠ SECRETS. The SDK's own `message` can echo request details — an invalid
-// key comes back as "Incorrect API key provided: sk-abc***…" — so it is NEVER
-// copied into the `AiError`'s message or details. What does travel, in
-// `details`, is only short machine-readable metadata the provider assigned:
-// the HTTP status, OpenAI's error `code`/`type`/`param`, and its request id.
-// The SDK error itself is kept as the (non-enumerable, never serialised)
-// `cause`, for a debugger.
-//
-// The mapping is data-driven by SDK class first (the SDK already turns a
-// status into a class), then refined by OpenAI's own `code` where one class
-// covers two meanings (a 400 that is a content-policy refusal, a 404 that is
-// an unknown model). The table in `openai-errors.spec.ts` pins every class.
-// =============================================================================
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OPENAI_FAMILY = exports.OPENAI_PROVIDER_ID = void 0;
-exports.openAiErrorMessage = openAiErrorMessage;
-exports.classifyOpenAiErrorCode = classifyOpenAiErrorCode;
-exports.retryAfterFromHeaders = retryAfterFromHeaders;
-exports.openAiErrorCode = openAiErrorCode;
-exports.mapOpenAiError = mapOpenAiError;
-exports.mapOpenAiResponseFailure = mapOpenAiResponseFailure;
-const openai_1 = require("openai");
-const error_1 = require("openai/core/error");
-const ai_error_1 = require("../../core/ai-error");
-const index_1 = require("../../../jobs/index");
-exports.OPENAI_PROVIDER_ID = 'openai';
-/** OpenAI itself. */
-exports.OPENAI_FAMILY = Object.freeze({ providerId: exports.OPENAI_PROVIDER_ID, label: 'OpenAI' });
-/**
- * OpenAI error codes that mean "the provider refused this content", whatever
- * HTTP status (or none, mid-stream) carried them. `invalid_prompt` is what a
- * reasoning model answers when a prompt is flagged under the usage policy.
- */
-const CONTENT_FILTER_CODES = new Set([
-    'content_filter',
-    'content_policy_violation',
-    'image_content_policy_violation',
-    'invalid_prompt',
-    'bio_policy',
-    'misalignment_policy_violation',
-    // The images API's refusal (`/v1/images/*` answers 400 with this code).
-    'moderation_blocked',
-]);
-/** Codes that name the model as the problem — the key cannot reach it. */
-const MODEL_UNREACHABLE_CODES = new Set(['model_not_found', 'model_not_available']);
-/** Codes a streamed (status-less) failure carries that are the caller's fault. */
-const CALLER_FAULT_CODES = new Set([
-    'invalid_image',
-    'invalid_image_format',
-    'invalid_base64_image',
-    'invalid_image_url',
-    'image_too_large',
-    'image_too_small',
-    'image_parse_error',
-    'invalid_image_mode',
-    'image_file_too_large',
-    'unsupported_image_media_type',
-    'empty_image_file',
-    'failed_to_download_image',
-    'image_file_not_found',
-    'data_residency_mismatch',
-    'context_length_exceeded',
-]);
-function messagesFor(label) {
-    return {
-        AI_DISABLED: 'AI is disabled.',
-        AI_PROVIDER_DISABLED: 'The AI provider is disabled.',
-        AI_KEY_REQUIRED: 'An API key is required for this AI provider.',
-        AI_KEY_INVALID: `The ${label} API key was rejected.`,
-        AI_MODEL_NOT_ENABLED: 'The model is not enabled.',
-        AI_MODEL_NOT_REACHABLE: `The ${label} model is not reachable with this API key.`,
-        AI_CAPABILITY_UNSUPPORTED: `The request uses a capability ${label} does not support here.`,
-        AI_TOOL_DISABLED: 'The requested tool is not enabled in this deployment.',
-        AI_REALTIME_DISABLED: 'Realtime sessions are not enabled in this deployment.',
-        AI_RATE_LIMITED: `${label} rate-limited the request.`,
-        AI_PROVIDER_UNAVAILABLE: `${label} is unavailable or the request failed.`,
-        AI_CONTENT_FILTERED: `${label} refused the request under its content policy.`,
-        AI_INVALID_REQUEST: `${label} rejected the request as invalid.`,
-        AI_STRUCTURED_OUTPUT_INVALID: 'The model output does not match the requested schema.',
-        AI_STORAGE_UNAVAILABLE: 'Object storage is unavailable.',
-    };
-}
-const MESSAGES_BY_LABEL = new Map();
-/** The generic, secret-free message this adapter family uses for `code`. */
-function openAiErrorMessage(code, family = exports.OPENAI_FAMILY) {
-    let messages = MESSAGES_BY_LABEL.get(family.label);
-    if (!messages) {
-        messages = messagesFor(family.label);
-        MESSAGES_BY_LABEL.set(family.label, messages);
-    }
-    return messages[code];
-}
-function stringOrUndefined(value) {
-    return typeof value === 'string' && value.length > 0 ? value : undefined;
-}
-/** Classifies an OpenAI error `code` that arrived without a usable HTTP status. */
-function classifyOpenAiErrorCode(code) {
-    if (!code)
-        return 'AI_PROVIDER_UNAVAILABLE';
-    if (CONTENT_FILTER_CODES.has(code))
-        return 'AI_CONTENT_FILTERED';
-    if (MODEL_UNREACHABLE_CODES.has(code))
-        return 'AI_MODEL_NOT_REACHABLE';
-    if (code === 'rate_limit_exceeded' || code === 'insufficient_quota')
-        return 'AI_RATE_LIMITED';
-    if (code === 'invalid_api_key')
-        return 'AI_KEY_INVALID';
-    if (CALLER_FAULT_CODES.has(code))
-        return 'AI_INVALID_REQUEST';
-    return 'AI_PROVIDER_UNAVAILABLE';
-}
-/**
- * The provider's requested back-off: OpenAI's own millisecond header first
- * (more precise), then the standard `Retry-After` (seconds or HTTP-date).
- */
-function retryAfterFromHeaders(headers) {
-    if (!headers)
-        return undefined;
-    const ms = headers.get('retry-after-ms');
-    if (ms !== null && /^\d+(\.\d+)?$/.test(ms.trim())) {
-        return Math.ceil(Number(ms));
-    }
-    return (0, index_1.parseRetryAfterMs)(headers.get('retry-after')) ?? undefined;
-}
-/** Which `AiErrorCode` an SDK `APIError` means. Pure — exported for the table spec. */
-function openAiErrorCode(err) {
-    if (err instanceof ai_error_1.AiError)
-        return err.code;
-    // Order matters: subclasses before their parents.
-    if (err instanceof openai_1.APIUserAbortError)
-        return 'AI_PROVIDER_UNAVAILABLE';
-    if (err instanceof openai_1.APIConnectionError)
-        return 'AI_PROVIDER_UNAVAILABLE';
-    if (err instanceof openai_1.OAuthError)
-        return 'AI_KEY_INVALID';
-    if (err instanceof openai_1.AuthenticationError)
-        return 'AI_KEY_INVALID';
-    if (err instanceof openai_1.APIError) {
-        const code = err.code ?? undefined;
-        if (code && MODEL_UNREACHABLE_CODES.has(code))
-            return 'AI_MODEL_NOT_REACHABLE';
-        if (code && CONTENT_FILTER_CODES.has(code))
-            return 'AI_CONTENT_FILTERED';
-    }
-    if (err instanceof openai_1.PermissionDeniedError)
-        return 'AI_MODEL_NOT_REACHABLE';
-    if (err instanceof openai_1.NotFoundError) {
-        return err.param === 'model' ? 'AI_MODEL_NOT_REACHABLE' : 'AI_INVALID_REQUEST';
-    }
-    if (err instanceof openai_1.RateLimitError)
-        return 'AI_RATE_LIMITED';
-    if (err instanceof openai_1.BadRequestError)
-        return 'AI_INVALID_REQUEST';
-    if (err instanceof openai_1.UnprocessableEntityError)
-        return 'AI_INVALID_REQUEST';
-    if (err instanceof openai_1.ConflictError)
-        return 'AI_INVALID_REQUEST';
-    if (err instanceof openai_1.InternalServerError)
-        return 'AI_PROVIDER_UNAVAILABLE';
-    if (err instanceof openai_1.APIError) {
-        // A status the SDK has no class for, or none at all (a mid-stream
-        // `error` event, which the SDK raises as a status-less APIError).
-        if (typeof err.status === 'number') {
-            if (err.status === 401)
-                return 'AI_KEY_INVALID';
-            if (err.status === 429)
-                return 'AI_RATE_LIMITED';
-            if (err.status >= 500 || err.status === 408)
-                return 'AI_PROVIDER_UNAVAILABLE';
-            if (err.status >= 400)
-                return 'AI_INVALID_REQUEST';
-        }
-        return classifyOpenAiErrorCode(err.code);
-    }
-    if (err instanceof error_1.ContentFilterFinishReasonError)
-        return 'AI_CONTENT_FILTERED';
-    if (err instanceof error_1.LengthFinishReasonError)
-        return 'AI_INVALID_REQUEST';
-    if (err instanceof openai_1.OpenAIError)
-        return 'AI_PROVIDER_UNAVAILABLE';
-    // A fetch/socket failure, a malformed SSE frame, anything else.
-    return 'AI_PROVIDER_UNAVAILABLE';
-}
-/**
- * Turns anything an OpenAI call threw into an `AiError`. An `AiError` is
- * returned unchanged (the mapper's own `AI_CAPABILITY_UNSUPPORTED`, for one).
- */
-function mapOpenAiError(err, family = exports.OPENAI_FAMILY) {
-    if (err instanceof ai_error_1.AiError)
-        return err;
-    const code = openAiErrorCode(err);
-    const details = { provider: family.providerId };
-    let retryAfterMs;
-    if (err instanceof openai_1.APIUserAbortError) {
-        details.aborted = true;
-    }
-    else if (err instanceof openai_1.APIConnectionError) {
-        details.transport = err instanceof openai_1.APIConnectionTimeoutError ? 'timeout' : 'connection';
-    }
-    else if (err instanceof openai_1.APIError) {
-        if (typeof err.status === 'number')
-            details.status = err.status;
-        const providerCode = stringOrUndefined(err.code);
-        const providerType = stringOrUndefined(err.type);
-        const param = stringOrUndefined(err.param);
-        const providerRequestId = stringOrUndefined(err.requestID);
-        if (providerCode)
-            details.providerCode = providerCode;
-        if (providerType)
-            details.providerType = providerType;
-        if (param)
-            details.param = param;
-        if (providerRequestId)
-            details.providerRequestId = providerRequestId;
-        if (code === 'AI_RATE_LIMITED') {
-            retryAfterMs = retryAfterFromHeaders(err.headers);
-        }
-    }
-    return new ai_error_1.AiError(code, openAiErrorMessage(code, family), { cause: err, details, retryAfterMs });
-}
-/**
- * The `AiError` for a response OpenAI returned with `status: 'failed'` (or a
- * `response.failed` stream event): the failure is in the body, not an HTTP
- * status, so only its `code` can be classified.
- */
-function mapOpenAiResponseFailure(error, providerRequestId, family = exports.OPENAI_FAMILY) {
-    const code = classifyOpenAiErrorCode(error?.code ?? undefined);
-    const details = { provider: family.providerId };
-    const providerCode = stringOrUndefined(error?.code);
-    if (providerCode)
-        details.providerCode = providerCode;
-    if (providerRequestId)
-        details.providerRequestId = providerRequestId;
-    return new ai_error_1.AiError(code, openAiErrorMessage(code, family), { details });
-}
-//# sourceMappingURL=openai-errors.js.map

package/dist/ai/providers/openai/openai-errors.js.map

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

package/dist/ai/providers/openai/openai-family-guards.d.ts

@@ -1,4 +0,0 @@
-import type { AiResponseRequest } from '../../core/types/responses.types';
-/** Refuses a hosted tool with `AI_CAPABILITY_UNSUPPORTED` before any call. */
-export declare function assertNoHostedTools(req: AiResponseRequest, providerId: string): void;
-//# sourceMappingURL=openai-family-guards.d.ts.map

package/dist/ai/providers/openai/openai-family-guards.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai-family-guards.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-family-guards.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAQpF"}

package/dist/ai/providers/openai/openai-family-guards.js

@@ -1,19 +0,0 @@
-"use strict";
-// Request guards shared by the #448 adapters (Azure OpenAI, OpenAI-compatible),
-// which declare `supportsHostedTools: false`: the runtime already refuses a
-// hosted tool for them before resolving a key (the registry derives no
-// `hosted_tools` capability), and this is the same refusal for a DIRECT port
-// caller — the defence in depth the Anthropic mapper gives `previousResponseId`.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertNoHostedTools = assertNoHostedTools;
-const ai_error_1 = require("../../core/ai-error");
-/** Refuses a hosted tool with `AI_CAPABILITY_UNSUPPORTED` before any call. */
-function assertNoHostedTools(req, providerId) {
-    const hosted = req.tools?.find((tool) => tool.type !== 'function');
-    if (hosted) {
-        throw new ai_error_1.AiError('AI_CAPABILITY_UNSUPPORTED', `Hosted tool "${hosted.type}" is not supported by this provider.`, {
-            details: { provider: providerId, tool: hosted.type, capability: 'hosted_tools' },
-        });
-    }
-}
-//# sourceMappingURL=openai-family-guards.js.map

package/dist/ai/providers/openai/openai-family-guards.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai-family-guards.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-family-guards.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,4EAA4E;AAC5E,uEAAuE;AACvE,6EAA6E;AAC7E,iFAAiF;;AAMjF,kDAQC;AAZD,kDAA8C;AAG9C,8EAA8E;AAC9E,SAAgB,mBAAmB,CAAC,GAAsB,EAAE,UAAkB;IAC5E,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAEnE,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,kBAAO,CAAC,2BAA2B,EAAE,gBAAgB,MAAM,CAAC,IAAI,sCAAsC,EAAE;YAChH,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE;SACjF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/ai/providers/openai/openai-images.mapper.d.ts

@@ -1,23 +0,0 @@
-import type { ImageEditParamsNonStreaming, ImageGenerateParamsNonStreaming, ImagesResponse } from 'openai/resources/images';
-import type { AiImageEditRequest, AiImageGenerationRequest, AiImageResult } from '../../core/types/media.types';
-/** Whether OpenAI model `modelId` is a DALL·E model (URL-by-default, no output_format). */
-export declare function isOpenAiDallE(modelId: string): boolean;
-/** The `/v1/images/generations` body. `providerOptions.openai` merges first; the port's own fields win. */
-export declare function toOpenAiImageGenerateRequest(req: AiImageGenerationRequest): ImageGenerateParamsNonStreaming;
-/**
- * The `/v1/images/edits` multipart body. The images (and mask) become SDK
- * uploads carrying their MIME type, so OpenAI can tell a PNG from a JPEG.
- */
-export declare function toOpenAiImageEditRequest(req: AiImageEditRequest): Promise<ImageEditParamsNonStreaming>;
-export interface FromOpenAiImagesOptions {
-    request: AiImageGenerationRequest;
-    providerRequestId?: string | null;
-}
-/**
- * The neutral result: one decoded image per `data` entry, each with the MIME
- * type of the format the provider says it produced (the request's
- * `outputFormat` when it does not say, PNG when neither does). No images, or
- * an entry with no `b64_json` (a URL-only answer), is a provider fault.
- */
-export declare function fromOpenAiImagesResponse(data: ImagesResponse, opts: FromOpenAiImagesOptions): AiImageResult;
-//# sourceMappingURL=openai-images.mapper.d.ts.map

package/dist/ai/providers/openai/openai-images.mapper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai-images.mapper.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-images.mapper.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,2BAA2B,EAC3B,+BAA+B,EAC/B,cAAc,EACf,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAGV,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACd,MAAM,8BAA8B,CAAC;AAoBtC,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAiCD,2GAA2G;AAC3G,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,wBAAwB,GAAG,+BAA+B,CAE3G;AAQD;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CA8B5G;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,wBAAwB,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAwBD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,uBAAuB,GAAG,aAAa,CAmC3G"}

package/dist/ai/providers/openai/openai-images.mapper.js

@@ -1,164 +0,0 @@
-"use strict";
-// =============================================================================
-// OpenAI images mapper (issue #437, epic #420)
-// =============================================================================
-//
-// AiImageGenerationRequest / AiImageEditRequest <-> `POST /v1/images/generations`
-// and `POST /v1/images/edits`. Pure functions (plus `toFile`, which only wraps
-// bytes); every failure is an `AiError`, never an SDK error.
-//
-// BYTES, NEVER URLS. The port's contract (`media.types.ts`) is bytes + MIME
-// type: a provider-hosted URL expires and is not ours to authorize. The GPT
-// image family always answers `b64_json`; the DALL·E family defaults to a
-// URL, so the mapper pins `response_format: 'b64_json'` for it — and refuses
-// an answer that carries only a URL rather than fetching it.
-//
-// TWO FAMILIES, TWO PARAMETER SETS. `gpt-image-*` (and `chatgpt-image-*`)
-// take `output_format`, `background` and `quality: low|medium|high|auto`, and
-// reject `response_format`. `dall-e-*` take `response_format` and reject the
-// other three (DALL·E 3 names its quality `standard|hd`), so for DALL·E the
-// neutral `quality: 'high'` becomes `hd` and everything the family cannot
-// honour is left out rather than sent to a 400. DALL·E always returns PNG.
-// =============================================================================
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isOpenAiDallE = isOpenAiDallE;
-exports.toOpenAiImageGenerateRequest = toOpenAiImageGenerateRequest;
-exports.toOpenAiImageEditRequest = toOpenAiImageEditRequest;
-exports.fromOpenAiImagesResponse = fromOpenAiImagesResponse;
-const openai_1 = require("openai");
-const ai_error_1 = require("../../core/ai-error");
-const openai_errors_1 = require("./openai-errors");
-const DALL_E = /^dall-e-/;
-const DALL_E_3 = /^dall-e-3(?:-|$)/;
-const FORMAT_MIME = {
-    png: 'image/png',
-    jpeg: 'image/jpeg',
-    webp: 'image/webp',
-};
-const MIME_EXTENSION = {
-    'image/png': 'png',
-    'image/jpeg': 'jpg',
-    'image/webp': 'webp',
-    'image/gif': 'gif',
-};
-/** Whether OpenAI model `modelId` is a DALL·E model (URL-by-default, no output_format). */
-function isOpenAiDallE(modelId) {
-    return DALL_E.test(modelId.trim().toLowerCase());
-}
-/** The fields generate and edit share, shaped for the model's family. */
-function sharedParams(req) {
-    const params = { model: req.model, prompt: req.prompt };
-    if (req.n !== undefined)
-        params.n = req.n;
-    if (req.size !== undefined)
-        params.size = req.size;
-    if (isOpenAiDallE(req.model)) {
-        params.response_format = 'b64_json';
-        if (req.quality === 'high' && DALL_E_3.test(req.model.trim().toLowerCase())) {
-            params.quality = 'hd';
-        }
-    }
-    else {
-        if (req.quality !== undefined)
-            params.quality = req.quality;
-        if (req.background !== undefined)
-            params.background = req.background;
-        if (req.outputFormat !== undefined)
-            params.output_format = req.outputFormat;
-    }
-    return params;
-}
-function escapeHatch(req) {
-    return (req.providerOptions?.[openai_errors_1.OPENAI_PROVIDER_ID] ?? {});
-}
-/** The `/v1/images/generations` body. `providerOptions.openai` merges first; the port's own fields win. */
-function toOpenAiImageGenerateRequest(req) {
-    return { ...escapeHatch(req), ...sharedParams(req), stream: false };
-}
-function fileName(payload, fallback) {
-    if (payload.filename && payload.filename.trim().length > 0)
-        return payload.filename;
-    return `${fallback}.${MIME_EXTENSION[payload.mimeType] ?? 'png'}`;
-}
-/**
- * The `/v1/images/edits` multipart body. The images (and mask) become SDK
- * uploads carrying their MIME type, so OpenAI can tell a PNG from a JPEG.
- */
-async function toOpenAiImageEditRequest(req) {
-    if (!Array.isArray(req.images) || req.images.length === 0) {
-        throw new ai_error_1.AiError('AI_INVALID_REQUEST', 'An image edit needs at least one source image.', {
-            details: { provider: openai_errors_1.OPENAI_PROVIDER_ID },
-        });
-    }
-    const images = await Promise.all(req.images.map((image, index) => (0, openai_1.toFile)(image.data, fileName(image, `image-${index + 1}`), { type: image.mimeType })));
-    // `hd` is DALL·E 3's word, and DALL·E 3 cannot edit: never send it here.
-    const { quality, ...shared } = sharedParams(req);
-    const body = {
-        ...escapeHatch(req),
-        ...shared,
-        ...(quality !== undefined && quality !== 'hd' ? { quality } : {}),
-        // DALL·E 2 edits exactly one image and rejects the array form.
-        image: images.length === 1 && isOpenAiDallE(req.model) ? images[0] : images,
-        stream: false,
-    };
-    if (req.mask) {
-        body.mask = await (0, openai_1.toFile)(req.mask.data, fileName(req.mask, 'mask'), { type: req.mask.mimeType });
-    }
-    return body;
-}
-function malformed(reason, opts) {
-    return new ai_error_1.AiError('AI_PROVIDER_UNAVAILABLE', 'OpenAI returned a malformed images response.', {
-        details: {
-            provider: openai_errors_1.OPENAI_PROVIDER_ID,
-            reason,
-            ...(opts.providerRequestId ? { providerRequestId: opts.providerRequestId } : {}),
-        },
-    });
-}
-/** Token usage, where the GPT image family reports it (DALL·E does not). */
-function imageUsage(usage) {
-    if (!usage)
-        return {};
-    const out = {};
-    if (typeof usage.input_tokens === 'number')
-        out.inputTokens = usage.input_tokens;
-    if (typeof usage.output_tokens === 'number')
-        out.outputTokens = usage.output_tokens;
-    return out;
-}
-/**
- * The neutral result: one decoded image per `data` entry, each with the MIME
- * type of the format the provider says it produced (the request's
- * `outputFormat` when it does not say, PNG when neither does). No images, or
- * an entry with no `b64_json` (a URL-only answer), is a provider fault.
- */
-function fromOpenAiImagesResponse(data, opts) {
-    const items = data.data ?? [];
-    if (items.length === 0) {
-        throw malformed('no_images', opts);
-    }
-    const format = data.output_format ?? (isOpenAiDallE(opts.request.model) ? 'png' : opts.request.outputFormat) ?? 'png';
-    const mimeType = FORMAT_MIME[format] ?? 'image/png';
-    const images = items.map((item) => {
-        if (typeof item.b64_json !== 'string' || item.b64_json.length === 0) {
-            throw malformed('missing_b64_json', opts);
-        }
-        const bytes = Buffer.from(item.b64_json, 'base64');
-        if (bytes.length === 0) {
-            throw malformed('empty_image', opts);
-        }
-        return {
-            data: bytes,
-            mimeType,
-            ...(item.revised_prompt ? { revisedPrompt: item.revised_prompt } : {}),
-        };
-    });
-    return {
-        provider: openai_errors_1.OPENAI_PROVIDER_ID,
-        model: opts.request.model,
-        images,
-        usage: imageUsage(data.usage),
-        ...(opts.providerRequestId ? { providerRequestId: opts.providerRequestId } : {}),
-    };
-}
-//# sourceMappingURL=openai-images.mapper.js.map

package/dist/ai/providers/openai/openai-images.mapper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai-images.mapper.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-images.mapper.ts"],"names":[],"mappings":"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"}