@particle-academy/prism 0.0.0

package/dist/providers/mistral/stream-events.js

@@ -0,0 +1,142 @@
+import { isJsonObject } from '../../json.js';
+import { FinishReason } from '../../enums.js';
+import { readArray, readNumber, readObject, readString } from '../../internal/filters.js';
+import { StreamEndEvent, StreamStartEvent, TextCompleteEvent, TextDeltaEvent, TextStartEvent, ToolCallEvent, } from '../../streaming/events.js';
+import { ToolCall } from '../../value-objects/tool-call.js';
+import { Usage } from '../../value-objects/usage.js';
+/**
+ * Mistral's chat-completions stream, which needs MEMORY.
+ *
+ * Every chunk is a `chat.completion.chunk` carrying a `delta` and nothing else
+ * — no message id after the first chunk, no accumulated text, and tool-call
+ * arguments arrive SPLIT ACROSS CHUNKS keyed only by an index. So a chunk
+ * cannot be mapped in isolation, the way an OpenAI Responses event can.
+ *
+ * That puts this closer to the Anthropic mapper than to the OpenAI one, for a
+ * different provider-side reason, and it carries the same consequence: one
+ * instance per stream. A shared mapper would let two concurrent generations
+ * read each other's accumulated text, which surfaces under load and looks like
+ * the model hallucinating.
+ */
+export class MistralStreamMapper {
+    #messageId = '';
+    #model = '';
+    #started = false;
+    #textStarted = false;
+    #text = '';
+    #usage = null;
+    /** Tool-call fragments being assembled, keyed by the index Mistral sends. */
+    #toolCalls = new Map();
+    /**
+     * The events for one chunk — zero, one, or several.
+     *
+     * SEVERAL, unlike the other mappers' one-or-none, because a single Mistral
+     * chunk can both start the stream and carry the first token, and the final
+     * chunk can complete the text, flush a tool call and end the stream at once.
+     * Returning only the first would drop the rest silently.
+     */
+    map(payload) {
+        const events = [];
+        if (!this.#started) {
+            this.#started = true;
+            this.#messageId = readString(payload.id, '');
+            this.#model = readString(payload.model, '');
+            events.push(new StreamStartEvent(this.#model));
+        }
+        const usage = readObject(payload.usage);
+        if (usage !== null) {
+            // Usage arrives on the LAST chunk on Mistral, not alongside the deltas,
+            // so it is stored rather than emitted and read again at stream end.
+            this.#usage = new Usage(readNumber(usage.prompt_tokens, 0), readNumber(usage.completion_tokens, 0));
+        }
+        const choice = readArray(payload.choices)[0];
+        if (!isJsonObject(choice)) {
+            return events;
+        }
+        const delta = readObject(choice.delta) ?? {};
+        const text = deltaText(delta);
+        if (text !== '') {
+            if (!this.#textStarted) {
+                this.#textStarted = true;
+                events.push(new TextStartEvent(this.#messageId));
+            }
+            this.#text += text;
+            events.push(new TextDeltaEvent(text, this.#messageId));
+        }
+        this.#accumulateToolCalls(delta);
+        const finishReason = readString(choice.finish_reason, '');
+        if (finishReason !== '') {
+            if (this.#textStarted) {
+                events.push(new TextCompleteEvent(this.#text, this.#messageId));
+            }
+            for (const call of this.#toolCalls.values()) {
+                // Flushed at the END, once the arguments are whole. Emitting a tool
+                // call while its JSON is still arriving hands a consumer a fragment
+                // that will not parse.
+                events.push(new ToolCallEvent(new ToolCall(call.id, call.name, call.args === '' ? '{}' : call.args), this.#messageId));
+            }
+            // Usage stays NULL when Mistral reported none, rather than becoming a
+            // zeroed Usage — zero tokens claims the generation was free. The event's
+            // third parameter is the event's own id, not the message id; passing the
+            // message id there compiles fine and quietly renames every end event.
+            events.push(new StreamEndEvent(mapStreamFinishReason(finishReason), this.#usage));
+        }
+        return events;
+    }
+    /**
+     * Tool-call fragments, merged by index.
+     *
+     * The id and name arrive on the FIRST fragment only and the arguments arrive
+     * a few characters at a time, so each field is written only when the chunk
+     * actually carries it — overwriting the name with an empty string on the
+     * second fragment is how a tool call ends up nameless.
+     */
+    #accumulateToolCalls(delta) {
+        for (const raw of readArray(delta.tool_calls)) {
+            if (!isJsonObject(raw)) {
+                continue;
+            }
+            const index = readNumber(raw.index, 0);
+            const fn = readObject(raw.function) ?? {};
+            const existing = this.#toolCalls.get(index) ?? { id: '', name: '', args: '' };
+            this.#toolCalls.set(index, {
+                id: readString(raw.id, '') || existing.id,
+                name: readString(fn.name, '') || existing.name,
+                args: existing.args + readString(fn.arguments, ''),
+            });
+        }
+    }
+}
+/**
+ * A delta's text, from either shape.
+ *
+ * `content` is a string on ordinary models and an array of typed chunks on
+ * reasoning ones. An array stringified is `[object Object]`, which reaches the
+ * consumer as tokens the model never produced.
+ */
+function deltaText(delta) {
+    if (typeof delta.content === 'string') {
+        return delta.content;
+    }
+    return readArray(delta.content)
+        .filter(isJsonObject)
+        .filter((chunk) => chunk.type === 'text')
+        .map((chunk) => readString(chunk.text, ''))
+        .join('');
+}
+function mapStreamFinishReason(reason) {
+    switch (reason) {
+        case 'stop':
+            return FinishReason.Stop;
+        case 'tool_calls':
+            return FinishReason.ToolCalls;
+        case 'length':
+        case 'model_length':
+            return FinishReason.Length;
+        case 'content_filter':
+            return FinishReason.ContentFilter;
+        default:
+            return FinishReason.Unknown;
+    }
+}
+//# sourceMappingURL=stream-events.js.map

package/dist/providers/mistral/stream-events.js.map

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

package/dist/providers/openai/audio.d.ts

@@ -0,0 +1,16 @@
+import { type JsonObject } from '../../json.js';
+import type { SpeechToTextRequest, TextToSpeechRequest } from '../../audio/request.js';
+import { AudioResponse, AudioTextResponse } from '../../audio/response.js';
+import type { MultipartBody } from '../../http/transport.js';
+export declare function buildSpeechBody(request: TextToSpeechRequest): JsonObject;
+/**
+ * Speech comes back as BYTES, not JSON.
+ *
+ * So the format has to come from the request or the content type — the payload
+ * itself carries no field naming it, and guessing `mp3` would mislabel every
+ * caller who asked for `wav`.
+ */
+export declare function parseSpeechResponse(bytes: Uint8Array, contentType: string | null, request: TextToSpeechRequest): AudioResponse;
+export declare function buildTranscriptionForm(request: SpeechToTextRequest): MultipartBody;
+export declare function parseTranscriptionResponse(rawBody: unknown): AudioTextResponse;
+//# sourceMappingURL=audio.d.ts.map

package/dist/providers/openai/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,UAAU,CAcxE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,EAAE,mBAAmB,GAC3B,aAAa,CAOf;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAoClF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAgB9E"}

package/dist/providers/openai/audio.js

@@ -0,0 +1,105 @@
+import { isJsonObject } from '../../json.js';
+import { PrismError } from '../../errors.js';
+import { AudioResponse, AudioTextResponse } from '../../audio/response.js';
+import { GeneratedAudio } from '../../value-objects/generated-audio.js';
+import { Usage } from '../../value-objects/usage.js';
+import { whereNotNull } from '../../internal/filters.js';
+export function buildSpeechBody(request) {
+    return {
+        model: request.model(),
+        input: request.input(),
+        // `alloy` is OpenAI's own default and the endpoint REQUIRES a voice, so
+        // omitting it fails the call. Defaulted here rather than in the builder, so
+        // a provider that has different voices can choose its own.
+        voice: request.voice() ?? 'alloy',
+        ...whereNotNull({
+            response_format: request.providerOptions('response_format'),
+            speed: request.providerOptions('speed'),
+            instructions: request.providerOptions('instructions'),
+        }),
+    };
+}
+/**
+ * Speech comes back as BYTES, not JSON.
+ *
+ * So the format has to come from the request or the content type — the payload
+ * itself carries no field naming it, and guessing `mp3` would mislabel every
+ * caller who asked for `wav`.
+ */
+export function parseSpeechResponse(bytes, contentType, request) {
+    const format = request.providerOptions('response_format');
+    const type = typeof format === 'string' ? format : 'mp3';
+    return new AudioResponse(new GeneratedAudio(Buffer.from(bytes).toString('base64'), type, contentType ?? `audio/${type}`));
+}
+export function buildTranscriptionForm(request) {
+    const audio = request.input();
+    const bytes = audio.rawContent();
+    if (bytes === null) {
+        // The payload holds only a url, and this port does not fetch implicitly.
+        throw PrismError.noAudioContent();
+    }
+    const mimeType = audio.mimeType();
+    return {
+        fields: {
+            model: request.model(),
+            ...stringFields({
+                language: request.providerOptions('language'),
+                prompt: request.providerOptions('prompt'),
+                response_format: request.providerOptions('response_format'),
+                temperature: request.providerOptions('temperature'),
+            }),
+        },
+        files: [
+            {
+                field: 'file',
+                // A filename is REQUIRED: OpenAI infers the audio format from the
+                // extension, and an unnamed part is rejected as an unsupported format
+                // rather than as a missing name.
+                filename: audio.filename() ?? `audio.${extensionFor(mimeType)}`,
+                bytes,
+                // The key is OMITTED rather than set to undefined: this tsconfig runs
+                // exactOptionalPropertyTypes, where an explicit undefined is a
+                // different thing from an absent key — and the transport reads absence.
+                ...(mimeType === null ? {} : { contentType: mimeType }),
+            },
+        ],
+    };
+}
+export function parseTranscriptionResponse(rawBody) {
+    if (!isJsonObject(rawBody)) {
+        throw PrismError.providerResponseError('OpenAI returned an empty or non-object transcription response.');
+    }
+    const usage = isJsonObject(rawBody.usage) ? rawBody.usage : null;
+    return new AudioTextResponse(typeof rawBody.text === 'string' ? rawBody.text : '', 
+    // Null, not zero. Transcription is billed by audio duration on most
+    // providers and they report no tokens at all; zero would claim it was free.
+    usage === null
+        ? null
+        : new Usage(readNumber(usage.input_tokens ?? usage.prompt_tokens), readNumber(usage.output_tokens)), rawBody);
+}
+function stringFields(source) {
+    const fields = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (value !== null && value !== undefined) {
+            // Multipart carries strings; a number field has to be spelled out rather
+            // than left for the form encoder to stringify however it likes.
+            fields[key] = String(value);
+        }
+    }
+    return fields;
+}
+const EXTENSIONS = {
+    'audio/mpeg': 'mp3',
+    'audio/mp4': 'm4a',
+    'audio/wav': 'wav',
+    'audio/webm': 'webm',
+    'audio/ogg': 'ogg',
+    'audio/flac': 'flac',
+};
+function extensionFor(mimeType) {
+    return mimeType === null ? 'mp3' : (EXTENSIONS[mimeType] ?? 'mp3');
+}
+function readNumber(value) {
+    return typeof value === 'number' ? value : 0;
+}
+//# sourceMappingURL=audio.js.map

package/dist/providers/openai/audio.js.map

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

package/dist/providers/openai/batch.d.ts

@@ -0,0 +1,29 @@
+import { type JsonObject } from '../../json.js';
+import { BatchJob, BatchListResult, BatchResultItem, BatchStatus } from '../../batch/batch-job.js';
+import type { BatchRequestItem, ListBatchesRequest } from '../../batch/request.js';
+/** The JSONL body OpenAI's batch endpoint expects, one request per line. */
+export declare function buildBatchInputFile(items: readonly BatchRequestItem[]): string;
+export declare function buildBatchBody(inputFileId: string, completionWindow: unknown): JsonObject;
+export declare function buildBatchListQuery(request: ListBatchesRequest): Record<string, string>;
+/**
+ * A wire status, or a refusal.
+ *
+ * Matching the reference, an unrecognised status THROWS rather than mapping to
+ * a plausible member. It reads harsh for a polling loop, and it is still right:
+ * a new status means the provider changed something about the lifecycle, and
+ * quietly calling it `InProgress` would leave a caller waiting forever on a
+ * batch that had already stopped.
+ */
+export declare function batchStatusFromValue(value: unknown): BatchStatus;
+export declare function parseBatchJob(rawBody: unknown): BatchJob;
+export declare function parseBatchListResponse(rawBody: unknown): BatchListResult;
+/**
+ * The results file, one JSON object per line.
+ *
+ * A line that will not parse is SKIPPED rather than fatal. The file is written
+ * by the provider a request at a time, and one malformed record should not cost
+ * a caller the other nine hundred.
+ */
+export declare function parseBatchResults(body: string): BatchResultItem[];
+export declare function parseBatchResultItem(data: JsonObject): BatchResultItem;
+//# sourceMappingURL=batch.d.ts.map

package/dist/providers/openai/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EACL,QAAQ,EAER,eAAe,EACf,eAAe,EAEf,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAInF,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,CAW9E;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,UAAU,CASzF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYvF;AAID;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAQhE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAqCxD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAYxE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAwBjE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CA+BtE"}

package/dist/providers/openai/batch.js

@@ -0,0 +1,181 @@
+import { canonicalJson, isJsonObject } from '../../json.js';
+import { PrismError } from '../../errors.js';
+import { BatchJob, BatchJobRequestCounts, BatchListResult, BatchResultItem, BatchResultStatus, BatchStatus, } from '../../batch/batch-job.js';
+import { Usage } from '../../value-objects/usage.js';
+import { buildRequestBody } from './build-request-body.js';
+/** The JSONL body OpenAI's batch endpoint expects, one request per line. */
+export function buildBatchInputFile(items) {
+    return items
+        .map((item) => canonicalJson({
+        custom_id: item.customId,
+        method: 'POST',
+        url: '/v1/responses',
+        body: buildRequestBody(item.request),
+    }))
+        .join('\n');
+}
+export function buildBatchBody(inputFileId, completionWindow) {
+    return {
+        input_file_id: inputFileId,
+        endpoint: '/v1/responses',
+        // Required by the endpoint, and `24h` is OpenAI's only supported window
+        // today — so a default here beats an error naming a field the caller never
+        // knew existed.
+        completion_window: typeof completionWindow === 'string' ? completionWindow : '24h',
+    };
+}
+export function buildBatchListQuery(request) {
+    const query = {};
+    if (request.limit !== null) {
+        query.limit = String(request.limit);
+    }
+    if (request.afterId !== null) {
+        query.after = request.afterId;
+    }
+    return query;
+}
+const STATUSES = Object.values(BatchStatus);
+/**
+ * A wire status, or a refusal.
+ *
+ * Matching the reference, an unrecognised status THROWS rather than mapping to
+ * a plausible member. It reads harsh for a polling loop, and it is still right:
+ * a new status means the provider changed something about the lifecycle, and
+ * quietly calling it `InProgress` would leave a caller waiting forever on a
+ * batch that had already stopped.
+ */
+export function batchStatusFromValue(value) {
+    const status = STATUSES.find((known) => known === value);
+    if (status === undefined) {
+        throw PrismError.providerResponseError(`Unknown OpenAI batch status: ${String(value)}`);
+    }
+    return status;
+}
+export function parseBatchJob(rawBody) {
+    if (!isJsonObject(rawBody)) {
+        throw PrismError.providerResponseError('OpenAI returned an empty or non-object batch response.');
+    }
+    const counts = isJsonObject(rawBody.request_counts) ? rawBody.request_counts : {};
+    const total = readNumber(counts.total);
+    const succeeded = readNumber(counts.completed);
+    const failed = readNumber(counts.failed);
+    return new BatchJob(readString(rawBody.id) ?? '', batchStatusFromValue(rawBody.status), new BatchJobRequestCounts(
+    // OpenAI does not report an in-flight count, so it is derived. Clamped at
+    // zero: a partial response — total missing while completed is not —
+    // produces a negative, and a negative number of in-flight requests is not
+    // a state anything can be in.
+    Math.max(0, total - succeeded - failed), succeeded, failed, 
+    // OpenAI reports neither, so they stay zero rather than being guessed.
+    0, 0, total), readTimestamp(rawBody.created_at), readTimestamp(rawBody.expires_at), 
+    // OpenAI's field is `completed_at`; the port's is `endedAt`, matching the
+    // reference, because a cancelled batch also ends.
+    readTimestamp(rawBody.completed_at), readString(rawBody.results_url), readString(rawBody.input_file_id), readString(rawBody.output_file_id), readString(rawBody.error_file_id), readErrors(rawBody.errors));
+}
+export function parseBatchListResponse(rawBody) {
+    if (!isJsonObject(rawBody)) {
+        return new BatchListResult([]);
+    }
+    const data = Array.isArray(rawBody.data) ? rawBody.data : [];
+    return new BatchListResult(data.map((entry) => parseBatchJob(entry)), rawBody.has_more === true, readString(rawBody.last_id));
+}
+/**
+ * The results file, one JSON object per line.
+ *
+ * A line that will not parse is SKIPPED rather than fatal. The file is written
+ * by the provider a request at a time, and one malformed record should not cost
+ * a caller the other nine hundred.
+ */
+export function parseBatchResults(body) {
+    const items = [];
+    for (const line of body.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed === '') {
+            continue;
+        }
+        let decoded;
+        try {
+            decoded = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        if (isJsonObject(decoded)) {
+            items.push(parseBatchResultItem(decoded));
+        }
+    }
+    return items;
+}
+export function parseBatchResultItem(data) {
+    const customId = readString(data.custom_id) ?? '';
+    const error = isJsonObject(data.error) ? data.error : null;
+    if (error !== null) {
+        const code = readString(error.code) ?? '';
+        return new BatchResultItem(customId, 
+        // `batch_expired` is its own outcome, not an error: the request was never
+        // run, so reporting it as a failure would blame the request.
+        code === 'batch_expired' ? BatchResultStatus.Expired : BatchResultStatus.Errored, null, null, null, null, code, readString(error.message));
+    }
+    const body = isJsonObject(data.response) && isJsonObject(data.response.body) ? data.response.body : {};
+    return new BatchResultItem(customId, BatchResultStatus.Succeeded, extractText(body), extractUsage(body), readString(body.id), readString(body.model));
+}
+/**
+ * The assistant's text, from either API shape.
+ *
+ * Responses output is searched from the END: a turn that used tools has the
+ * message last, and taking the first would return whatever preceded the tool
+ * call.
+ */
+function extractText(body) {
+    const output = Array.isArray(body.output) ? body.output : [];
+    for (const item of [...output].reverse()) {
+        if (!isJsonObject(item) || item.type !== 'message') {
+            continue;
+        }
+        const content = Array.isArray(item.content) ? item.content : [];
+        for (const part of content) {
+            if (isJsonObject(part) && part.type === 'output_text' && typeof part.text === 'string') {
+                return part.text;
+            }
+        }
+    }
+    // The chat-completions shape, for a batch submitted against that endpoint.
+    const choices = Array.isArray(body.choices) ? body.choices : [];
+    const first = choices[0];
+    if (isJsonObject(first) && isJsonObject(first.message) && typeof first.message.content === 'string') {
+        return first.message.content;
+    }
+    return '';
+}
+function extractUsage(body) {
+    const usage = isJsonObject(body.usage) ? body.usage : {};
+    const inputDetails = isJsonObject(usage.input_tokens_details) ? usage.input_tokens_details : {};
+    const outputDetails = isJsonObject(usage.output_tokens_details) ? usage.output_tokens_details : {};
+    return new Usage(readNumber(usage.input_tokens ?? usage.prompt_tokens), readNumber(usage.output_tokens ?? usage.completion_tokens), 
+    // Cache WRITE is not reported here. `cached_tokens` is what was READ from
+    // the cache — the two are billed differently, and putting one in the
+    // other's slot misreports the cost in the direction that flatters it.
+    null, typeof inputDetails.cached_tokens === 'number' ? inputDetails.cached_tokens : null, typeof outputDetails.reasoning_tokens === 'number' ? outputDetails.reasoning_tokens : null);
+}
+function readErrors(value) {
+    const data = isJsonObject(value) && Array.isArray(value.data) ? value.data : [];
+    return data.filter(isJsonObject).map((entry) => ({
+        code: readString(entry.code) ?? '',
+        message: readString(entry.message) ?? '',
+        line: typeof entry.line === 'number' ? entry.line : null,
+        param: readString(entry.param),
+    }));
+}
+/** Unix seconds to ISO 8601 in UTC. Same reasoning as `files`. */
+function readTimestamp(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        return null;
+    }
+    return new Date(value * 1000).toISOString();
+}
+function readString(value) {
+    return typeof value === 'string' && value !== '' ? value : null;
+}
+function readNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+}
+//# sourceMappingURL=batch.js.map

package/dist/providers/openai/batch.js.map

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

package/dist/providers/openai/build-request-body.d.ts

@@ -0,0 +1,25 @@
+import type { JsonObject, JsonValue } from '../../json.js';
+import type { TextRequest } from '../../text/request.js';
+/**
+ * Build the OpenAI Responses API request body.
+ *
+ * Two rules decide every key in here:
+ *
+ *   `model`, `input` and `max_output_tokens` are merged UNCONDITIONALLY. That
+ *   is why `max_output_tokens` is present as an explicit `null` on a request
+ *   that never set it — and why modelling "unset" as `undefined` would drop the
+ *   key and change the bytes.
+ *
+ *   Everything else goes through a NOT-NULL filter. `false` and `0` survive it,
+ *   so `usingTemperature(0)` is sent and a provider option of `store: false` is
+ *   sent. Only `null` is dropped.
+ *
+ * The one place those two rules meet is `tools`: an empty tool list collapses to
+ * `null` BEFORE the filter runs, so the key vanishes entirely. An empty array is
+ * truthy in JavaScript, so a direct port sends `"tools":[]` — which some models
+ * reject outright and which silently changes `tool_choice` defaults on others.
+ */
+export declare function buildRequestBody(request: TextRequest): JsonObject;
+/** Provider-native tools are merged in FRONT of the caller's tools. */
+export declare function buildTools(request: TextRequest): JsonValue[];
+//# sourceMappingURL=build-request-body.d.ts.map

package/dist/providers/openai/build-request-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-request-body.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/build-request-body.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAiCjE;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,CAY5D"}

package/dist/providers/openai/build-request-body.js

@@ -0,0 +1,66 @@
+import { isTruthyByReferenceRules, whereNotNull } from '../../internal/filters.js';
+import { mapMessages } from './maps/message-map.js';
+import { mapToolChoice } from './maps/tool-choice-map.js';
+import { mapTools } from './maps/tool-map.js';
+/**
+ * Build the OpenAI Responses API request body.
+ *
+ * Two rules decide every key in here:
+ *
+ *   `model`, `input` and `max_output_tokens` are merged UNCONDITIONALLY. That
+ *   is why `max_output_tokens` is present as an explicit `null` on a request
+ *   that never set it — and why modelling "unset" as `undefined` would drop the
+ *   key and change the bytes.
+ *
+ *   Everything else goes through a NOT-NULL filter. `false` and `0` survive it,
+ *   so `usingTemperature(0)` is sent and a provider option of `store: false` is
+ *   sent. Only `null` is dropped.
+ *
+ * The one place those two rules meet is `tools`: an empty tool list collapses to
+ * `null` BEFORE the filter runs, so the key vanishes entirely. An empty array is
+ * truthy in JavaScript, so a direct port sends `"tools":[]` — which some models
+ * reject outright and which silently changes `tool_choice` defaults on others.
+ */
+export function buildRequestBody(request) {
+    const body = {
+        model: request.model(),
+        input: mapMessages(request.messages(), request.systemPrompts()),
+        max_output_tokens: request.maxTokens(),
+    };
+    const tools = buildTools(request);
+    const textVerbosity = request.providerOptions('text_verbosity');
+    const optional = {
+        temperature: request.temperature(),
+        top_p: request.topP(),
+        metadata: request.providerOptions('metadata'),
+        tools: tools.length > 0 ? tools : null,
+        tool_choice: mapToolChoice(request.toolChoice()),
+        parallel_tool_calls: request.providerOptions('parallel_tool_calls'),
+        previous_response_id: request.providerOptions('previous_response_id'),
+        service_tier: request.providerOptions('service_tier'),
+        store: request.providerOptions('store'),
+        // Gated on truthiness rather than on null, unlike its neighbours: an empty
+        // verbosity is not a verbosity.
+        text: isTruthyByReferenceRules(textVerbosity) ? { verbosity: textVerbosity } : null,
+        truncation: request.providerOptions('truncation'),
+        // Asymmetric on purpose. `withReasoning(false)` asks OpenAI for minimal
+        // effort; `withReasoning(true)` emits NOTHING, because enabling reasoning is
+        // a per-provider setting and the toggle must not override it. An explicit
+        // `reasoning` provider option wins over both.
+        reasoning: request.providerOptions('reasoning') ?? (request.reasoningEnabled() === false ? { effort: 'minimal' } : null),
+    };
+    return { ...body, ...whereNotNull(optional) };
+}
+/** Provider-native tools are merged in FRONT of the caller's tools. */
+export function buildTools(request) {
+    const tools = mapTools(request.tools());
+    const providerTools = request.providerTools();
+    if (providerTools.length === 0) {
+        return tools;
+    }
+    return [
+        ...providerTools.map((providerTool) => ({ type: providerTool.type, ...providerTool.options })),
+        ...tools,
+    ];
+}
+//# sourceMappingURL=build-request-body.js.map

package/dist/providers/openai/build-request-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-request-body.js","sourceRoot":"","sources":["../../../src/providers/openai/build-request-body.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAoB;IACnD,MAAM,IAAI,GAAe;QACvB,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;QACtB,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;QAC/D,iBAAiB,EAAE,OAAO,CAAC,SAAS,EAAE;KACvC,CAAC;IAEF,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAEhE,MAAM,QAAQ,GAAiD;QAC7D,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;QAClC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE;QACrB,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC;QAC7C,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACtC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAChD,mBAAmB,EAAE,OAAO,CAAC,eAAe,CAAC,qBAAqB,CAAC;QACnE,oBAAoB,EAAE,OAAO,CAAC,eAAe,CAAC,sBAAsB,CAAC;QACrE,YAAY,EAAE,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC;QACrD,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC;QACvC,2EAA2E;QAC3E,gCAAgC;QAChC,IAAI,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI;QACnF,UAAU,EAAE,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC;QACjD,wEAAwE;QACxE,6EAA6E;QAC7E,0EAA0E;QAC1E,8CAA8C;QAC9C,SAAS,EACP,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;KAChH,CAAC;IAEF,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,UAAU,CAAC,OAAoB;IAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACxC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAE9C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAc,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1G,GAAG,KAAK;KACT,CAAC;AACJ,CAAC"}

package/dist/providers/openai/build-structured-body.d.ts

@@ -0,0 +1,16 @@
+import type { JsonObject } from '../../json.js';
+import type { StructuredRequest } from '../../structured/request.js';
+/**
+ * The text body, plus the instruction that makes it structured.
+ *
+ * Built ON TOP of `buildRequestBody` rather than beside it, so every rule that
+ * decides the text body — the unconditional keys, the not-null filter, the
+ * empty-tools collapse — applies identically here. A second builder would drift
+ * from the first the moment either changed.
+ *
+ * `Auto` is resolved to a concrete mode against the MODEL, because "auto" is not
+ * something OpenAI accepts; somebody has to decide, and doing it here means the
+ * decision is inspectable in one place rather than implied by the wire format.
+ */
+export declare function buildStructuredBody(request: StructuredRequest): JsonObject;
+//# sourceMappingURL=build-structured-body.d.ts.map

package/dist/providers/openai/build-structured-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-structured-body.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/build-structured-body.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIrE;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAa1E"}