@marinoscar/platform-api 0.0.0-stage → 0.1.0-next.4

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

@@ -0,0 +1,266 @@
+"use strict";
+// =============================================================================
+// OpenAI audio mapper (issue #438, epic #420)
+// =============================================================================
+//
+// AiTranscriptionRequest <-> `POST /v1/audio/transcriptions`, and (#439)
+// AiSpeechRequest <-> `POST /v1/audio/speech`. Pure functions
+// (plus the SDK's `toFile`/`toStreamingFile`, which only wrap bytes); every
+// failure is an `AiError`, never an SDK error.
+//
+// STREAMED, NOT BUFFERED. A streamed input (`AiStreamedPayload`) becomes the
+// SDK's `toStreamingFile`: the multipart body is encoded lazily as the
+// request is sent, so the recording is read from storage once and never held
+// in memory whole. Bytes already in hand go through `toFile`.
+//
+// 25 MiB. OpenAI refuses a larger upload; `OPENAI_TRANSCRIPTION_MAX_BYTES` is
+// declared on the port so the runtime refuses it FIRST (`AI_INVALID_REQUEST`,
+// no provider call), and this mapper refuses one whose size it can see too.
+//
+// THE FILE NAME CARRIES THE FORMAT. OpenAI decides how to decode an upload
+// from its file extension, so a storage object named `memo` (no extension)
+// is sent as `memo.m4a` when its MIME type is `audio/mp4`.
+//
+// TWO FAMILIES. `whisper-1` answers `verbose_json` (language, duration,
+// segments, word timestamps) and is asked for it by default; the GPT-4o
+// transcribe family answers `json`/`text` only and does not take
+// `timestamp_granularities`, so for it that field is left out rather than
+// sent to a 400 — the same "what the family cannot honour is dropped" rule
+// the images mapper follows.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPENAI_TRANSCRIPTION_MAX_BYTES = void 0;
+exports.isOpenAiWhisper = isOpenAiWhisper;
+exports.openAiAudioFileName = openAiAudioFileName;
+exports.toOpenAiTranscriptionRequest = toOpenAiTranscriptionRequest;
+exports.fromOpenAiTranscriptionResponse = fromOpenAiTranscriptionResponse;
+exports.isOpenAiTts1 = isOpenAiTts1;
+exports.toOpenAiSpeechRequest = toOpenAiSpeechRequest;
+exports.fromOpenAiSpeechResponse = fromOpenAiSpeechResponse;
+const openai_1 = require("openai");
+const ai_error_1 = require("../../core/ai-error");
+const media_types_1 = require("../../core/types/media.types");
+const openai_errors_1 = require("./openai-errors");
+/** OpenAI's upload limit for `/v1/audio/transcriptions` (25 MiB). */
+exports.OPENAI_TRANSCRIPTION_MAX_BYTES = 25 * 1024 * 1024;
+const WHISPER = /^whisper-/;
+/** The extension OpenAI needs to see for each MIME type it can decode. */
+const AUDIO_EXTENSIONS = {
+    'audio/mpeg': 'mp3',
+    'audio/mp3': 'mp3',
+    'audio/mpga': 'mpga',
+    'audio/mp4': 'm4a',
+    'audio/m4a': 'm4a',
+    'audio/x-m4a': 'm4a',
+    'audio/aac': 'm4a',
+    'audio/wav': 'wav',
+    'audio/wave': 'wav',
+    'audio/x-wav': 'wav',
+    'audio/vnd.wave': 'wav',
+    'audio/webm': 'webm',
+    'audio/ogg': 'ogg',
+    'audio/opus': 'ogg',
+    'audio/flac': 'flac',
+    'audio/x-flac': 'flac',
+    'video/mp4': 'mp4',
+    'video/webm': 'webm',
+};
+const KNOWN_EXTENSIONS = new Set(['flac', 'mp3', 'mp4', 'mpeg', 'mpga', 'm4a', 'ogg', 'oga', 'wav', 'webm']);
+/** Whether OpenAI model `modelId` is a Whisper model (verbose_json, timestamps). */
+function isOpenAiWhisper(modelId) {
+    return WHISPER.test(modelId.trim().toLowerCase());
+}
+/**
+ * The name the upload is sent under: the caller's own base name (no path),
+ * with an extension OpenAI can decode — appended from the MIME type when the
+ * name has none it recognises.
+ */
+function openAiAudioFileName(input) {
+    const base = (input.filename ?? '').split(/[\\/]/).pop()?.trim() || 'audio';
+    const dot = base.lastIndexOf('.');
+    const ext = dot > 0 ? base.slice(dot + 1).toLowerCase() : '';
+    if (KNOWN_EXTENSIONS.has(ext))
+        return base;
+    const mime = input.mimeType.split(';')[0].trim().toLowerCase();
+    return `${base}.${AUDIO_EXTENSIONS[mime] ?? 'mp3'}`;
+}
+function tooLarge(size) {
+    return new ai_error_1.AiError('AI_INVALID_REQUEST', `The audio is larger than ${exports.OPENAI_TRANSCRIPTION_MAX_BYTES} bytes.`, {
+        details: { provider: openai_errors_1.OPENAI_PROVIDER_ID, size, maxBytes: exports.OPENAI_TRANSCRIPTION_MAX_BYTES },
+    });
+}
+/**
+ * The `/v1/audio/transcriptions` multipart body. A streamed input stays a
+ * stream (`toStreamingFile`); bytes become a `File`.
+ */
+async function toOpenAiTranscriptionRequest(req) {
+    const { audio } = req;
+    const name = openAiAudioFileName(audio);
+    const type = audio.mimeType;
+    let file;
+    if ((0, media_types_1.isStreamedPayload)(audio)) {
+        if (audio.size !== undefined && audio.size > exports.OPENAI_TRANSCRIPTION_MAX_BYTES)
+            throw tooLarge(audio.size);
+        file = (0, openai_1.toStreamingFile)(audio.stream, name, { type });
+    }
+    else {
+        if (audio.data.byteLength === 0) {
+            throw new ai_error_1.AiError('AI_INVALID_REQUEST', 'The audio is empty.', { details: { provider: openai_errors_1.OPENAI_PROVIDER_ID } });
+        }
+        if (audio.data.byteLength > exports.OPENAI_TRANSCRIPTION_MAX_BYTES)
+            throw tooLarge(audio.data.byteLength);
+        file = await (0, openai_1.toFile)(audio.data, name, { type });
+    }
+    const whisper = isOpenAiWhisper(req.model);
+    const format = req.responseFormat ?? (whisper ? 'verbose_json' : 'json');
+    const escapeHatch = (req.providerOptions?.[openai_errors_1.OPENAI_PROVIDER_ID] ?? {});
+    const body = {
+        ...escapeHatch,
+        file,
+        model: req.model,
+        response_format: format,
+        stream: false,
+    };
+    if (req.language !== undefined)
+        body.language = req.language;
+    if (req.prompt !== undefined)
+        body.prompt = req.prompt;
+    if (whisper && format === 'verbose_json' && req.timestampGranularities?.length) {
+        body.timestamp_granularities = [...new Set(req.timestampGranularities)];
+    }
+    return body;
+}
+function malformed(reason, opts) {
+    return new ai_error_1.AiError('AI_PROVIDER_UNAVAILABLE', 'OpenAI returned a malformed transcription response.', {
+        details: {
+            provider: openai_errors_1.OPENAI_PROVIDER_ID,
+            // Not `reason`: the error body's `details.reason` is always the AiErrorCode.
+            problem: reason,
+            ...(opts.providerRequestId ? { providerRequestId: opts.providerRequestId } : {}),
+        },
+    });
+}
+function finite(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+}
+/** Token usage (the GPT-4o family) and, separately, a billed duration (Whisper). */
+function transcriptionUsage(usage) {
+    if (!usage)
+        return { usage: {} };
+    if (usage.type === 'duration') {
+        return { usage: {}, ...(finite(usage.seconds) ? { seconds: usage.seconds } : {}) };
+    }
+    const out = {};
+    if (finite(usage.input_tokens))
+        out.inputTokens = usage.input_tokens;
+    if (finite(usage.output_tokens))
+        out.outputTokens = usage.output_tokens;
+    return { usage: out };
+}
+/**
+ * The neutral result, from whichever shape the requested `response_format`
+ * produced: a bare string (`text`), `{ text, usage? }` (`json`), or the
+ * verbose object with language, duration, segments and words.
+ */
+function fromOpenAiTranscriptionResponse(data, opts) {
+    const base = {
+        provider: openai_errors_1.OPENAI_PROVIDER_ID,
+        model: opts.request.model,
+        ...(opts.providerRequestId ? { providerRequestId: opts.providerRequestId } : {}),
+    };
+    if (typeof data === 'string') {
+        return { ...base, text: data.trim(), usage: {} };
+    }
+    if (!data || typeof data !== 'object' || typeof data.text !== 'string') {
+        throw malformed('missing_text', opts);
+    }
+    const body = data;
+    const { usage, seconds } = transcriptionUsage(body.usage);
+    const result = { ...base, text: body.text, usage };
+    const language = typeof body.language === 'string' && body.language ? body.language : body.languages?.[0]?.code;
+    if (language)
+        result.language = language;
+    const duration = finite(body.duration) ? body.duration : seconds;
+    if (duration !== undefined)
+        result.durationSeconds = duration;
+    if (Array.isArray(body.segments)) {
+        result.segments = body.segments
+            .filter((s) => finite(s.start) && finite(s.end) && typeof s.text === 'string')
+            .map((s) => ({ startSeconds: s.start, endSeconds: s.end, text: s.text.trim() }));
+    }
+    if (Array.isArray(body.words)) {
+        result.words = body.words
+            .filter((w) => finite(w.start) && finite(w.end) && typeof w.word === 'string')
+            .map((w) => ({ startSeconds: w.start, endSeconds: w.end, word: w.word }));
+    }
+    return result;
+}
+// ---- Speech (#439) ------------------------------------------------------------
+//
+// The answer is the audio itself (a binary body), never a URL. `tts-1` and
+// `tts-1-hd` do not take `instructions`; it is left out for them rather than
+// sent to a 400. `stream_format` is never sent: the endpoint's default for a
+// non-streamed call is the whole file.
+const TTS1 = /^tts-1(?:-|$)/;
+/** Whether OpenAI model `modelId` is `tts-1`/`tts-1-hd` (no `instructions`). */
+function isOpenAiTts1(modelId) {
+    return TTS1.test(modelId.trim().toLowerCase());
+}
+function invalidSpeech(message, details = {}) {
+    return new ai_error_1.AiError('AI_INVALID_REQUEST', message, { details: { provider: openai_errors_1.OPENAI_PROVIDER_ID, ...details } });
+}
+/** The `/v1/audio/speech` JSON body. Refuses what OpenAI would refuse, before calling. */
+function toOpenAiSpeechRequest(req) {
+    if (typeof req.input !== 'string' || req.input.trim().length === 0) {
+        throw invalidSpeech('Speech needs non-empty input text.');
+    }
+    if (req.input.length > media_types_1.AI_SPEECH_INPUT_MAX_CHARS) {
+        throw invalidSpeech(`Speech input is longer than ${media_types_1.AI_SPEECH_INPUT_MAX_CHARS} characters.`, {
+            length: req.input.length,
+            max: media_types_1.AI_SPEECH_INPUT_MAX_CHARS,
+        });
+    }
+    if (typeof req.voice !== 'string' || req.voice.trim().length === 0) {
+        throw invalidSpeech('Speech needs a voice.');
+    }
+    if (req.speed !== undefined && !(req.speed >= media_types_1.AI_SPEECH_SPEED_MIN && req.speed <= media_types_1.AI_SPEECH_SPEED_MAX)) {
+        throw invalidSpeech(`speed must be from ${media_types_1.AI_SPEECH_SPEED_MIN} to ${media_types_1.AI_SPEECH_SPEED_MAX}.`, { speed: req.speed });
+    }
+    const escapeHatch = (req.providerOptions?.[openai_errors_1.OPENAI_PROVIDER_ID] ?? {});
+    const body = {
+        ...escapeHatch,
+        model: req.model,
+        input: req.input,
+        voice: req.voice,
+        response_format: req.format ?? 'mp3',
+    };
+    if (req.speed !== undefined)
+        body.speed = req.speed;
+    if (req.instructions !== undefined && !isOpenAiTts1(req.model))
+        body.instructions = req.instructions;
+    return body;
+}
+/**
+ * The neutral result: the bytes, typed by the format that was asked for
+ * (the one OpenAI produces). No bytes is a provider fault.
+ */
+function fromOpenAiSpeechResponse(bytes, opts) {
+    if (bytes.byteLength === 0) {
+        throw new ai_error_1.AiError('AI_PROVIDER_UNAVAILABLE', 'OpenAI returned an empty speech response.', {
+            details: {
+                provider: openai_errors_1.OPENAI_PROVIDER_ID,
+                problem: 'empty_audio',
+                ...(opts.providerRequestId ? { providerRequestId: opts.providerRequestId } : {}),
+            },
+        });
+    }
+    const format = opts.request.format ?? 'mp3';
+    return {
+        provider: openai_errors_1.OPENAI_PROVIDER_ID,
+        model: opts.request.model,
+        audio: { data: bytes, mimeType: media_types_1.AI_SPEECH_FORMAT_MIME[format] },
+        usage: {},
+        ...(opts.providerRequestId ? { providerRequestId: opts.providerRequestId } : {}),
+    };
+}
+//# sourceMappingURL=openai-audio.mapper.js.map

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

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

package/dist/ai/providers/openai/openai-call-telemetry.d.ts

@@ -0,0 +1,25 @@
+import type { Logger } from '@nestjs/common';
+import { Span } from '@opentelemetry/api';
+import type { AiError } from '../../core/ai-error';
+import type { AiCallContext } from '../../core/provider-adapter.interface';
+import { type OpenAiFamily } from './openai-errors';
+export declare const AI_PROVIDER_CALL_SPAN = "ai.provider.call";
+export declare class OpenAiCallTelemetry {
+    private readonly family;
+    private readonly logger;
+    /** Maps a thrown error; the family's own `mapOpenAiError` by default. */
+    private readonly mapError;
+    constructor(family: OpenAiFamily, logger: Logger, 
+    /** Maps a thrown error; the family's own `mapOpenAiError` by default. */
+    mapError?: (err: unknown) => AiError);
+    startSpan(operation: string, model: string | undefined): Span;
+    endSpan(span: Span, status: string): void;
+    /**
+     * ⚠ Only ids, the model, the operation, the outcome and a duration. Never
+     * `ctx.apiKey`, never the request or response body.
+     */
+    logCall(operation: string, model: string | undefined, ctx: AiCallContext, status: string, started: number, providerRequestId?: string | null): void;
+    /** Runs `fn` inside an `ai.provider.call` span, mapping any failure to `AiError`. */
+    call<T>(operation: string, model: string | undefined, ctx: AiCallContext, fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=openai-call-telemetry.d.ts.map

package/dist/ai/providers/openai/openai-call-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-call-telemetry.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-call-telemetry.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAmC,MAAM,oBAAoB,CAAC;AAE3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAE3E,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpE,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAIxD,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAHR,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM;IAC/B,yEAAyE;IACxD,QAAQ,GAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAA8C;IAG7F,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAW7D,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMzC;;;OAGG;IACH,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,GAChC,IAAI;IAaP,qFAAqF;IAC/E,IAAI,CAAC,CAAC,EACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;CA0Bd"}

package/dist/ai/providers/openai/openai-call-telemetry.js

@@ -0,0 +1,93 @@
+"use strict";
+// =============================================================================
+// Provider-call telemetry for the OpenAI wire family (issue #426, extracted #448)
+// =============================================================================
+//
+// Every provider call an OpenAI-family adapter (OpenAI, Azure OpenAI, a
+// generic OpenAI-compatible server) makes runs inside one `ai.provider.call`
+// span carrying `ai.provider`, `ai.model`, `ai.operation` and `ai.status`
+// (`ok` or the AiErrorCode) — never prompt text, output text or the key. The
+// debug log line carries the same four facts plus the request ids and a
+// duration. No exception is recorded on the span: an SDK error's message can
+// echo a masked key.
+//
+// Extracted from `openai.adapter.ts` unchanged so the two #448 adapters share
+// it rather than copy it; the OpenAI adapter's spans and log lines are
+// byte-for-byte what they were.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiCallTelemetry = exports.AI_PROVIDER_CALL_SPAN = void 0;
+const api_1 = require("@opentelemetry/api");
+const index_1 = require("../../../otel-core/index");
+const openai_errors_1 = require("./openai-errors");
+exports.AI_PROVIDER_CALL_SPAN = 'ai.provider.call';
+const tracer = api_1.trace.getTracer((0, index_1.resolveServiceName)());
+class OpenAiCallTelemetry {
+    family;
+    logger;
+    mapError;
+    constructor(family, logger, 
+    /** Maps a thrown error; the family's own `mapOpenAiError` by default. */
+    mapError = (err) => (0, openai_errors_1.mapOpenAiError)(err, family)) {
+        this.family = family;
+        this.logger = logger;
+        this.mapError = mapError;
+    }
+    startSpan(operation, model) {
+        return tracer.startSpan(exports.AI_PROVIDER_CALL_SPAN, {
+            kind: api_1.SpanKind.CLIENT,
+            attributes: {
+                'ai.provider': this.family.providerId,
+                'ai.operation': operation,
+                ...(model ? { 'ai.model': model } : {}),
+            },
+        });
+    }
+    endSpan(span, status) {
+        span.setAttribute('ai.status', status);
+        span.setStatus(status === 'ok' ? { code: api_1.SpanStatusCode.OK } : { code: api_1.SpanStatusCode.ERROR, message: status });
+        span.end();
+    }
+    /**
+     * ⚠ Only ids, the model, the operation, the outcome and a duration. Never
+     * `ctx.apiKey`, never the request or response body.
+     */
+    logCall(operation, model, ctx, status, started, providerRequestId) {
+        this.logger.debug({
+            msg: 'AI provider call',
+            provider: this.family.providerId,
+            operation,
+            model,
+            status,
+            requestId: ctx.requestId,
+            providerRequestId: providerRequestId ?? undefined,
+            durationMs: Date.now() - started,
+        });
+    }
+    /** Runs `fn` inside an `ai.provider.call` span, mapping any failure to `AiError`. */
+    async call(operation, model, ctx, fn) {
+        const started = Date.now();
+        const span = this.startSpan(operation, model);
+        let status = 'ok';
+        let providerRequestId;
+        try {
+            const result = await fn();
+            if (result && typeof result === 'object' && 'providerRequestId' in result) {
+                providerRequestId = result.providerRequestId;
+            }
+            return result;
+        }
+        catch (err) {
+            const mapped = this.mapError(err);
+            status = mapped.code;
+            providerRequestId = mapped.toJSON().details.providerRequestId;
+            throw mapped;
+        }
+        finally {
+            this.endSpan(span, status);
+            this.logCall(operation, model, ctx, status, started, providerRequestId);
+        }
+    }
+}
+exports.OpenAiCallTelemetry = OpenAiCallTelemetry;
+//# sourceMappingURL=openai-call-telemetry.js.map

package/dist/ai/providers/openai/openai-call-telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-call-telemetry.js","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-call-telemetry.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,kFAAkF;AAClF,gFAAgF;AAChF,EAAE;AACF,wEAAwE;AACxE,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,wEAAwE;AACxE,6EAA6E;AAC7E,qBAAqB;AACrB,EAAE;AACF,8EAA8E;AAC9E,uEAAuE;AACvE,gCAAgC;AAChC,gFAAgF;;;AAGhF,4CAA2E;AAI3E,oDAA8D;AAC9D,mDAAoE;AAEvD,QAAA,qBAAqB,GAAG,kBAAkB,CAAC;AAExD,MAAM,MAAM,GAAG,WAAK,CAAC,SAAS,CAAC,IAAA,0BAAkB,GAAE,CAAC,CAAC;AAErD,MAAa,mBAAmB;IAEX;IACA;IAEA;IAJnB,YACmB,MAAoB,EACpB,MAAc;IAC/B,yEAAyE;IACxD,WAAsC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,8BAAc,EAAC,GAAG,EAAE,MAAM,CAAC;QAH1E,WAAM,GAAN,MAAM,CAAc;QACpB,WAAM,GAAN,MAAM,CAAQ;QAEd,aAAQ,GAAR,QAAQ,CAAkE;IAC1F,CAAC;IAEJ,SAAS,CAAC,SAAiB,EAAE,KAAyB;QACpD,OAAO,MAAM,CAAC,SAAS,CAAC,6BAAqB,EAAE;YAC7C,IAAI,EAAE,cAAQ,CAAC,MAAM;YACrB,UAAU,EAAE;gBACV,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;gBACrC,cAAc,EAAE,SAAS;gBACzB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,IAAU,EAAE,MAAc;QAChC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAc,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAChH,IAAI,CAAC,GAAG,EAAE,CAAC;IACb,CAAC;IAED;;;OAGG;IACH,OAAO,CACL,SAAiB,EACjB,KAAyB,EACzB,GAAkB,EAClB,MAAc,EACd,OAAe,EACf,iBAAiC;QAEjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAChB,GAAG,EAAE,kBAAkB;YACvB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAChC,SAAS;YACT,KAAK;YACL,MAAM;YACN,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,iBAAiB,EAAE,iBAAiB,IAAI,SAAS;YACjD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;SACjC,CAAC,CAAC;IACL,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,IAAI,CACR,SAAiB,EACjB,KAAyB,EACzB,GAAkB,EAClB,EAAoB;QAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC9C,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,iBAAqC,CAAC;QAE1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAE1B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,mBAAmB,IAAI,MAAM,EAAE,CAAC;gBAC1E,iBAAiB,GAAI,MAAyC,CAAC,iBAAiB,CAAC;YACnF,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAElC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;YACrB,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,iBAAuC,CAAC;YAEpF,MAAM,MAAM,CAAC;QACf,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;CACF;AAjFD,kDAiFC"}

package/dist/ai/providers/openai/openai-chat-completions-stream.mapper.d.ts

@@ -0,0 +1,41 @@
+import type { ChatCompletionChunk } from 'openai/resources/chat/completions/completions';
+import { AiError } from '../../core/ai-error';
+import type { AiResponseRequest, AiStreamEvent } from '../../core/types/responses.types';
+import { type OpenAiFamily } from './openai-errors';
+export interface ChatCompletionsStreamMapperOptions {
+    request: AiResponseRequest;
+    providerRequestId?: string | null;
+    family?: OpenAiFamily;
+}
+export declare class ChatCompletionsStreamMapper {
+    private readonly opts;
+    private id;
+    private model;
+    private created;
+    private text;
+    private refusal;
+    private readonly calls;
+    private finishReason;
+    private usage;
+    private startedFlag;
+    private terminalFlag;
+    constructor(opts: ChatCompletionsStreamMapperOptions);
+    private get family();
+    /** Whether `response.created` has been emitted. */
+    get started(): boolean;
+    /** Whether a terminal event (`response.completed` or `error`) has been emitted. */
+    get terminated(): boolean;
+    /** Whether the server has said why the turn ended — i.e. whether `finish()` can complete. */
+    get finished(): boolean;
+    /** Maps one SDK chunk to zero or more of ours. Nothing is emitted after a terminal event. */
+    map(chunk: ChatCompletionChunk): AiStreamEvent[];
+    /**
+     * The closing events, once the SDK stream is exhausted: each output item's
+     * `output_item.done`, then `response.completed` — or nothing when the
+     * server never gave a finish reason (see the file header).
+     */
+    finish(): AiStreamEvent[];
+    /** Ends the stream with an `error` event for `err` (idempotent). */
+    fail(err: AiError): AiStreamEvent[];
+}
+//# sourceMappingURL=openai-chat-completions-stream.mapper.d.ts.map

package/dist/ai/providers/openai/openai-chat-completions-stream.mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-chat-completions-stream.mapper.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/openai/openai-chat-completions-stream.mapper.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAEzG,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEzF,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnE,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAQD,qBAAa,2BAA2B;IAY1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAXjC,OAAO,CAAC,EAAE,CAAuB;IACjC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,YAAY,CAAuD;IAC3E,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;gBAEA,IAAI,EAAE,kCAAkC;IAErE,OAAO,KAAK,MAAM,GAEjB;IAED,mDAAmD;IACnD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,mFAAmF;IACnF,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,6FAA6F;IAC7F,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,6FAA6F;IAC7F,GAAG,CAAC,KAAK,EAAE,mBAAmB,GAAG,aAAa,EAAE;IAoDhD;;;;OAIG;IACH,MAAM,IAAI,aAAa,EAAE;IAsDzB,oEAAoE;IACpE,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,EAAE;CAMpC"}

package/dist/ai/providers/openai/openai-chat-completions-stream.mapper.js

@@ -0,0 +1,173 @@
+"use strict";
+// =============================================================================
+// Chat Completions stream chunks -> AiStreamEvent (issue #448, epic #421)
+// =============================================================================
+//
+// One mapper per stream. Chat Completions streams DELTAS only — there is no
+// `response.created`, no per-item `done`, and no final object — so this
+// mapper accumulates what the Responses API would have announced:
+//
+//   first chunk                      -> response.created (the chunk's id)
+//   choices[0].delta.content         -> output_text.delta
+//   choices[0].delta.tool_calls[i]   -> function_call.arguments.delta, keyed by
+//                                       the call id the i-th call announced in
+//                                       its first fragment
+//   choices[0].finish_reason         -> remembered
+//   a usage-only chunk (no choices)  -> remembered (stream_options.include_usage)
+//
+// `finish()`, called once the SDK stream is exhausted, emits the
+// `output_item.done` events (the message, then each function call) and the
+// terminal `response.completed`, built by handing a synthetic `ChatCompletion`
+// to `fromChatCompletion` — the same function `create` uses, so structured
+// output is validated identically; if that fails the stream ends with an
+// `error` event instead. A stream that ends WITHOUT a finish reason was cut
+// short: `finish()` returns nothing and the engine fails it as truncated.
+//
+// Error events carry OUR generic message for the code, never the server's.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatCompletionsStreamMapper = void 0;
+const node_crypto_1 = require("node:crypto");
+const ai_error_1 = require("../../core/ai-error");
+const openai_chat_completions_mapper_1 = require("./openai-chat-completions.mapper");
+const openai_errors_1 = require("./openai-errors");
+class ChatCompletionsStreamMapper {
+    opts;
+    id = null;
+    model = null;
+    created = 0;
+    text = '';
+    refusal = '';
+    calls = new Map();
+    finishReason = null;
+    usage;
+    startedFlag = false;
+    terminalFlag = false;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    get family() {
+        return this.opts.family ?? openai_errors_1.OPENAI_FAMILY;
+    }
+    /** Whether `response.created` has been emitted. */
+    get started() {
+        return this.startedFlag;
+    }
+    /** Whether a terminal event (`response.completed` or `error`) has been emitted. */
+    get terminated() {
+        return this.terminalFlag;
+    }
+    /** Whether the server has said why the turn ended — i.e. whether `finish()` can complete. */
+    get finished() {
+        return this.finishReason !== null;
+    }
+    /** Maps one SDK chunk to zero or more of ours. Nothing is emitted after a terminal event. */
+    map(chunk) {
+        if (this.terminalFlag)
+            return [];
+        const events = [];
+        if (!this.startedFlag) {
+            this.startedFlag = true;
+            // Some compatible servers omit the id; the neutral contract needs one.
+            this.id = chunk.id || `chatcmpl-${(0, node_crypto_1.randomUUID)()}`;
+            events.push({ type: 'response.created', id: this.id });
+        }
+        if (chunk.model)
+            this.model = chunk.model;
+        if (typeof chunk.created === 'number')
+            this.created = chunk.created;
+        if (chunk.usage)
+            this.usage = chunk.usage;
+        const choice = chunk.choices?.[0];
+        if (!choice)
+            return events;
+        const delta = choice.delta ?? {};
+        if (typeof delta.content === 'string' && delta.content.length > 0) {
+            this.text += delta.content;
+            events.push({ type: 'output_text.delta', delta: delta.content });
+        }
+        if (typeof delta.refusal === 'string')
+            this.refusal += delta.refusal;
+        for (const fragment of delta.tool_calls ?? []) {
+            let call = this.calls.get(fragment.index);
+            if (!call) {
+                call = { id: fragment.id || `call_${(0, node_crypto_1.randomUUID)()}`, name: '', arguments: '' };
+                this.calls.set(fragment.index, call);
+            }
+            if (fragment.function?.name)
+                call.name += fragment.function.name;
+            const args = fragment.function?.arguments;
+            if (args) {
+                call.arguments += args;
+                events.push({ type: 'function_call.arguments.delta', callId: call.id, delta: args });
+            }
+        }
+        if (choice.finish_reason)
+            this.finishReason = choice.finish_reason;
+        return events;
+    }
+    /**
+     * The closing events, once the SDK stream is exhausted: each output item's
+     * `output_item.done`, then `response.completed` — or nothing when the
+     * server never gave a finish reason (see the file header).
+     */
+    finish() {
+        if (this.terminalFlag || !this.startedFlag || this.finishReason === null)
+            return [];
+        const completion = {
+            id: this.id ?? '',
+            object: 'chat.completion',
+            created: this.created,
+            model: this.model ?? this.opts.request.model,
+            choices: [
+                {
+                    index: 0,
+                    finish_reason: this.finishReason,
+                    logprobs: null,
+                    message: {
+                        role: 'assistant',
+                        content: this.text.length > 0 ? this.text : null,
+                        refusal: this.refusal.length > 0 ? this.refusal : null,
+                        ...(this.calls.size > 0
+                            ? {
+                                tool_calls: [...this.calls.entries()]
+                                    .sort(([a], [b]) => a - b)
+                                    .map(([, call]) => ({
+                                    id: call.id,
+                                    type: 'function',
+                                    function: { name: call.name, arguments: call.arguments },
+                                })),
+                            }
+                            : {}),
+                    },
+                },
+            ],
+            ...(this.usage ? { usage: this.usage } : {}),
+        };
+        let response;
+        try {
+            response = (0, openai_chat_completions_mapper_1.fromChatCompletion)(completion, {
+                request: this.opts.request,
+                providerRequestId: this.opts.providerRequestId,
+                family: this.family,
+            });
+        }
+        catch (err) {
+            return this.fail(ai_error_1.AiError.wrap(err));
+        }
+        this.terminalFlag = true;
+        return [
+            ...response.output.map((item) => ({ type: 'output_item.done', item })),
+            { type: 'response.completed', response },
+        ];
+    }
+    /** Ends the stream with an `error` event for `err` (idempotent). */
+    fail(err) {
+        if (this.terminalFlag)
+            return [];
+        this.terminalFlag = true;
+        return [{ type: 'error', code: err.code, message: err.message }];
+    }
+}
+exports.ChatCompletionsStreamMapper = ChatCompletionsStreamMapper;
+//# sourceMappingURL=openai-chat-completions-stream.mapper.js.map

package/dist/ai/providers/openai/openai-chat-completions-stream.mapper.js.map

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