@particle-academy/prism 0.0.0

package/dist/providers/mistral/maps/tool-map.js

@@ -0,0 +1,26 @@
+/**
+ * Map tools onto Mistral's `tools` array.
+ *
+ * The chat-completions shape: a `function` object nested under a `type`, where
+ * the Responses API flattens the same fields to the top level. `parameters` is
+ * always sent, even empty — Mistral rejects a function declaration without one,
+ * unlike OpenAI which treats it as optional.
+ *
+ * Declaration order is preserved. Tool order reaches the model and influences
+ * which tool it picks.
+ */
+export function mapTools(tools) {
+    return tools.map((tool) => ({
+        type: 'function',
+        function: {
+            name: tool.name(),
+            description: tool.description(),
+            parameters: {
+                type: 'object',
+                properties: tool.hasParameters() ? tool.parametersAsObject() : {},
+                required: [...tool.requiredParameters()],
+            },
+        },
+    }));
+}
+//# sourceMappingURL=tool-map.js.map

package/dist/providers/mistral/maps/tool-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-map.js","sourceRoot":"","sources":["../../../../src/providers/mistral/maps/tool-map.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAsB;IAC7C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;YAC/B,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE;gBACjE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;aACzC;SACF;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/providers/mistral/mistral.d.ts

@@ -0,0 +1,90 @@
+import type { EmbeddingsRequest } from '../../embeddings/request.js';
+import type { EmbeddingsResponse } from '../../embeddings/response.js';
+import type { FimRequest } from '../../fim/request.js';
+import type { FimResponse } from '../../fim/response.js';
+import type { SpeechToTextRequest } from '../../audio/request.js';
+import type { AudioTextResponse } from '../../audio/response.js';
+import type { StructuredRequest } from '../../structured/request.js';
+import type { StructuredResponse } from '../../structured/response.js';
+import type { HttpBinaryTransport, HttpStreamTransport, HttpTransport } from '../../http/transport.js';
+import type { StreamEvent } from '../../streaming/events.js';
+import type { TextRequest } from '../../text/request.js';
+import type { TextResponse } from '../../text/response.js';
+import { Provider } from '../provider.js';
+export interface MistralConfig {
+    apiKey?: string;
+    url?: string;
+    transport?: HttpTransport;
+    streamTransport?: HttpStreamTransport;
+    binaryTransport?: HttpBinaryTransport;
+}
+/**
+ * The Mistral provider.
+ *
+ * The third provider in this port, and the first that is neither OpenAI's
+ * Responses API nor Anthropic's Messages API: Mistral speaks the OpenAI
+ * CHAT-COMPLETIONS shape. That is close enough to be worth stating plainly,
+ * because the temptation to share the OpenAI mapper is real and wrong — the two
+ * disagree on the request envelope (`messages` vs `input`), on where the finish
+ * reason lives (the choice vs the root), and on the tool-call argument encoding
+ * (a JSON string vs an object). Every one of those fails quietly.
+ *
+ * It exists because `fim` does. Fill-in-the-middle is a Mistral-only capability
+ * in the reference, so the twelfth capability could not land in this port
+ * without it — but a provider that served only `fim` would be a provider nobody
+ * could use for anything else, so the surface the reference gives Mistral is
+ * ported whole: text, structured, stream, embeddings, fim, speechToText.
+ */
+export declare class Mistral extends Provider {
+    #private;
+    readonly providerName = "Mistral";
+    readonly apiKey: string;
+    readonly url: string;
+    constructor(config?: MistralConfig);
+    text(request: TextRequest): Promise<TextResponse>;
+    /**
+     * Structured output through Mistral's OWN strict schema mode.
+     *
+     * So this is enforced, not requested — the same guarantee the OpenAI path
+     * gives and stronger than the Anthropic one, which can only ask. G-08 records
+     * that `structured` means different things per provider; Mistral lands on the
+     * strong side of it.
+     */
+    structured(request: StructuredRequest): Promise<StructuredResponse>;
+    /**
+     * Fill in the middle: a prefix, an optional suffix, and the gap between them.
+     *
+     * A DIFFERENT ENDPOINT from chat, not a mode of it — `fim/completions` takes
+     * a prompt and a suffix and has no messages at all. That is why the capability
+     * has its own builder rather than a flag on the text one.
+     */
+    fim(request: FimRequest): Promise<FimResponse>;
+    embeddings(request: EmbeddingsRequest): Promise<EmbeddingsResponse>;
+    /**
+     * Transcription, sharing the OpenAI multipart form.
+     *
+     * SHARED DELIBERATELY, unlike the chat mapping. Mistral's
+     * `audio/transcriptions` is the Whisper endpoint shape field for field — a
+     * `file` part plus `model`, `language`, `prompt`, `response_format` and
+     * `temperature` — so a second copy would be a copy, and the two would drift
+     * on whichever one someone edited. The chat endpoints are not shared for the
+     * opposite reason: they only look alike.
+     */
+    speechToText(request: SpeechToTextRequest): Promise<AudioTextResponse>;
+    /**
+     * The same generation, delivered as it arrives.
+     *
+     * The mapper is constructed PER CALL. It carries the message id, the
+     * accumulated text and half-assembled tool-call arguments for one stream; a
+     * shared instance would let two concurrent generations read each other's
+     * fragments.
+     *
+     * A chunk can produce SEVERAL events — the first carries both the stream
+     * start and the first token — so the mapper returns a list and this yields
+     * every member. Taking only the first would drop tokens silently.
+     */
+    stream(request: TextRequest): AsyncGenerator<StreamEvent>;
+    /** A bearer token, like OpenAI and unlike Anthropic's `x-api-key`. */
+    headers(): Record<string, string>;
+}
+//# sourceMappingURL=mistral.d.ts.map

package/dist/providers/mistral/mistral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mistral.d.ts","sourceRoot":"","sources":["../../../src/providers/mistral/mistral.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEvG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAS1C,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,OAAQ,SAAQ,QAAQ;;IACnC,SAAkB,YAAY,aAAa;IAE3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAQT,MAAM,GAAE,aAAkB;IAUvB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAMhE;;;;;;;OAOG;IACY,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAYlF;;;;;;OAMG;IACY,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAM9C,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAMlF;;;;;;;;;OASG;IACY,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqBrF;;;;;;;;;;;OAWG;IACa,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC;IAqCzE,sEAAsE;IACtE,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAmClC"}

package/dist/providers/mistral/mistral.js

@@ -0,0 +1,210 @@
+import { canonicalJson, isJsonObject } from '../../json.js';
+import { PrismError } from '../../errors.js';
+import { structuredFromTextResponse } from '../../structured/from-text.js';
+import { fetchBinaryTransport, fetchStreamTransport, fetchTransport } from '../../http/transport.js';
+import { sseData } from '../../streaming/sse.js';
+import { Provider } from '../provider.js';
+import { buildRequestBody, buildStructuredBody } from './build-request-body.js';
+import { buildEmbeddingsBody, parseEmbeddingsResponse } from './embeddings.js';
+import { buildFimBody, parseFimResponse } from './fim.js';
+import { parseTextResponse } from './parse-response.js';
+import { parseRateLimits } from './rate-limits.js';
+import { MistralStreamMapper } from './stream-events.js';
+import { buildTranscriptionForm, parseTranscriptionResponse } from '../openai/audio.js';
+const DEFAULT_URL = 'https://api.mistral.ai/v1';
+/**
+ * The Mistral provider.
+ *
+ * The third provider in this port, and the first that is neither OpenAI's
+ * Responses API nor Anthropic's Messages API: Mistral speaks the OpenAI
+ * CHAT-COMPLETIONS shape. That is close enough to be worth stating plainly,
+ * because the temptation to share the OpenAI mapper is real and wrong — the two
+ * disagree on the request envelope (`messages` vs `input`), on where the finish
+ * reason lives (the choice vs the root), and on the tool-call argument encoding
+ * (a JSON string vs an object). Every one of those fails quietly.
+ *
+ * It exists because `fim` does. Fill-in-the-middle is a Mistral-only capability
+ * in the reference, so the twelfth capability could not land in this port
+ * without it — but a provider that served only `fim` would be a provider nobody
+ * could use for anything else, so the surface the reference gives Mistral is
+ * ported whole: text, structured, stream, embeddings, fim, speechToText.
+ */
+export class Mistral extends Provider {
+    providerName = 'Mistral';
+    apiKey;
+    url;
+    #transport;
+    #streamTransport;
+    #binaryTransport;
+    constructor(config = {}) {
+        super();
+        this.apiKey = config.apiKey ?? readEnv('MISTRAL_API_KEY') ?? '';
+        this.url = (config.url ?? readEnv('MISTRAL_URL') ?? DEFAULT_URL).replace(/\/+$/, '');
+        this.#transport = config.transport ?? fetchTransport;
+        this.#streamTransport = config.streamTransport ?? fetchStreamTransport;
+        this.#binaryTransport = config.binaryTransport ?? fetchBinaryTransport;
+    }
+    async text(request) {
+        const response = await this.#post('chat/completions', canonicalJson(buildRequestBody(request)), request.clientOptions());
+        return parseTextResponse(request, response.body, { rateLimits: parseRateLimits(response.headers) });
+    }
+    /**
+     * Structured output through Mistral's OWN strict schema mode.
+     *
+     * So this is enforced, not requested — the same guarantee the OpenAI path
+     * gives and stronger than the Anthropic one, which can only ask. G-08 records
+     * that `structured` means different things per provider; Mistral lands on the
+     * strong side of it.
+     */
+    async structured(request) {
+        const response = await this.#post('chat/completions', canonicalJson(buildStructuredBody(request)), request.clientOptions());
+        return structuredFromTextResponse(parseTextResponse(request, response.body, { rateLimits: parseRateLimits(response.headers) }));
+    }
+    /**
+     * Fill in the middle: a prefix, an optional suffix, and the gap between them.
+     *
+     * A DIFFERENT ENDPOINT from chat, not a mode of it — `fim/completions` takes
+     * a prompt and a suffix and has no messages at all. That is why the capability
+     * has its own builder rather than a flag on the text one.
+     */
+    async fim(request) {
+        const response = await this.#post('fim/completions', canonicalJson(buildFimBody(request)), request.clientOptions());
+        return parseFimResponse(response.body, request, parseRateLimits(response.headers));
+    }
+    async embeddings(request) {
+        const response = await this.#post('embeddings', canonicalJson(buildEmbeddingsBody(request)), request.clientOptions());
+        return parseEmbeddingsResponse(response.body);
+    }
+    /**
+     * Transcription, sharing the OpenAI multipart form.
+     *
+     * SHARED DELIBERATELY, unlike the chat mapping. Mistral's
+     * `audio/transcriptions` is the Whisper endpoint shape field for field — a
+     * `file` part plus `model`, `language`, `prompt`, `response_format` and
+     * `temperature` — so a second copy would be a copy, and the two would drift
+     * on whichever one someone edited. The chat endpoints are not shared for the
+     * opposite reason: they only look alike.
+     */
+    async speechToText(request) {
+        const response = await this.#binaryTransport({
+            url: `${this.url}/audio/transcriptions`,
+            method: 'POST',
+            headers: this.headers(),
+            body: '',
+            multipart: buildTranscriptionForm(request),
+            clientOptions: request.clientOptions(),
+        });
+        const decoded = decodeJson(response.bytes);
+        if (response.status >= 400) {
+            throw PrismError.providerResponseError(describeHttpFailure(this.providerName, response.status, decoded), {
+                httpStatus: response.status,
+            });
+        }
+        return parseTranscriptionResponse(decoded);
+    }
+    /**
+     * The same generation, delivered as it arrives.
+     *
+     * The mapper is constructed PER CALL. It carries the message id, the
+     * accumulated text and half-assembled tool-call arguments for one stream; a
+     * shared instance would let two concurrent generations read each other's
+     * fragments.
+     *
+     * A chunk can produce SEVERAL events — the first carries both the stream
+     * start and the first token — so the mapper returns a list and this yields
+     * every member. Taking only the first would drop tokens silently.
+     */
+    async *stream(request) {
+        const response = await this.#streamTransport({
+            url: `${this.url}/chat/completions`,
+            method: 'POST',
+            headers: { ...this.headers(), Accept: 'text/event-stream' },
+            body: canonicalJson({ ...buildRequestBody(request), stream: true }),
+            clientOptions: request.clientOptions(),
+        });
+        if (response.status >= 400) {
+            let raw = '';
+            for await (const chunk of response.chunks) {
+                raw += chunk;
+            }
+            throw PrismError.providerResponseError(describeHttpFailure(this.providerName, response.status, parsePayload(raw)), { httpStatus: response.status });
+        }
+        const mapper = new MistralStreamMapper();
+        for await (const payload of sseData(response.chunks)) {
+            // Mistral closes with a literal `[DONE]`, which is not JSON. Parsing it
+            // yields null and the mapper would read an empty payload as a chunk.
+            if (payload === '[DONE]') {
+                return;
+            }
+            for (const event of mapper.map(parsePayload(payload))) {
+                yield event;
+            }
+        }
+    }
+    /** A bearer token, like OpenAI and unlike Anthropic's `x-api-key`. */
+    headers() {
+        const headers = {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        };
+        if (this.apiKey !== '') {
+            headers.Authorization = `Bearer ${this.apiKey}`;
+        }
+        return headers;
+    }
+    async #post(path, body, clientOptions) {
+        const response = await this.#transport({
+            url: `${this.url}/${path}`,
+            method: 'POST',
+            headers: this.headers(),
+            body,
+            clientOptions,
+        });
+        if (response.status >= 400) {
+            throw PrismError.providerResponseError(describeHttpFailure(this.providerName, response.status, response.body), {
+                httpStatus: response.status,
+                responseBody: response.rawBody,
+            });
+        }
+        return { body: response.body, headers: response.headers };
+    }
+}
+function readEnv(name) {
+    const value = process.env[name];
+    return value === undefined || value === '' ? undefined : value;
+}
+/**
+ * A message out of either error shape Mistral uses.
+ *
+ * A nested `error.message` on most failures, and a BARE `message` on validation
+ * errors — the second is what a malformed request actually gets, so reading
+ * only the first reports "Unknown error" for the most common mistake.
+ */
+function describeHttpFailure(provider, status, body) {
+    if (!isJsonObject(body)) {
+        return `${provider} error [${status}]: Unknown error`;
+    }
+    const error = isJsonObject(body.error) ? body.error : null;
+    const detail = (error !== null && typeof error.message === 'string' ? error.message : null) ??
+        (typeof body.message === 'string' ? body.message : null) ??
+        'Unknown error';
+    return `${provider} error [${status}]: ${detail}`;
+}
+function parsePayload(payload) {
+    try {
+        const parsed = JSON.parse(payload);
+        return isJsonObject(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function decodeJson(bytes) {
+    try {
+        return JSON.parse(new TextDecoder().decode(bytes));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=mistral.js.map

package/dist/providers/mistral/mistral.js.map

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

package/dist/providers/mistral/parse-response.d.ts

@@ -0,0 +1,35 @@
+import type { JsonObject } from '../../json.js';
+import type { TextRequest } from '../../text/request.js';
+import type { TextResponse } from '../../text/response.js';
+import type { ProviderRateLimit } from '../../value-objects/provider-rate-limit.js';
+export interface ParseTextResponseOptions {
+    rateLimits?: readonly ProviderRateLimit[];
+}
+/**
+ * Turn a raw Mistral chat-completions payload into a `TextResponse`.
+ *
+ * No HTTP happens here, so a stored payload replays through exactly the code
+ * path a live call takes.
+ *
+ * @throws PrismError code `provider_response_error` when the payload is
+ *   missing, empty, or carries a `message` under an error shape.
+ * @throws PrismError code `max_tokens_exceeded` when generation was cut short.
+ * @throws PrismError code `tool_loop_not_supported` when the response stopped
+ *   on tool calls. Running tools is outside this port's slice, and returning a
+ *   half-formed response would be worse than saying so.
+ */
+export declare function parseTextResponse(request: TextRequest, rawBody: unknown, options?: ParseTextResponseOptions): TextResponse;
+export declare function validateResponse(rawBody: unknown): JsonObject;
+/** The first choice, or an empty object. Mistral returns one unless `n` was set. */
+export declare function firstChoiceMessage(data: JsonObject): JsonObject;
+/**
+ * The reply text, from either shape Mistral uses.
+ *
+ * `content` is usually a string, but reasoning models return an ARRAY of typed
+ * chunks — and taking the array's `toString()` yields `[object Object]`, which
+ * looks like a model that answered nonsense rather than a parser that failed.
+ */
+export declare function extractText(message: JsonObject): string;
+/** Reasoning chunks joined, or null when the model did not think. */
+export declare function extractThinking(message: JsonObject): string | null;
+//# sourceMappingURL=parse-response.d.ts.map

package/dist/providers/mistral/parse-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-response.d.ts","sourceRoot":"","sources":["../../../src/providers/mistral/parse-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAKhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAKpF,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,wBAA6B,GACrC,YAAY,CAiBd;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAwB7D;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAI/D;AA8BD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAUvD;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAUlE"}

package/dist/providers/mistral/parse-response.js

@@ -0,0 +1,114 @@
+import { isJsonObject } from '../../json.js';
+import { PrismError } from '../../errors.js';
+import { FinishReason } from '../../enums.js';
+import { readArray, readNullableNumber, readNumber, readObject, readString, whereNotNull } from '../../internal/filters.js';
+import { ResponseBuilder } from '../../text/response-builder.js';
+import { TextStep } from '../../text/step.js';
+import { Meta } from '../../value-objects/meta.js';
+import { ToolCall } from '../../value-objects/tool-call.js';
+import { Usage } from '../../value-objects/usage.js';
+import { mapFinishReason } from './maps/finish-reason-map.js';
+/**
+ * Turn a raw Mistral chat-completions payload into a `TextResponse`.
+ *
+ * No HTTP happens here, so a stored payload replays through exactly the code
+ * path a live call takes.
+ *
+ * @throws PrismError code `provider_response_error` when the payload is
+ *   missing, empty, or carries a `message` under an error shape.
+ * @throws PrismError code `max_tokens_exceeded` when generation was cut short.
+ * @throws PrismError code `tool_loop_not_supported` when the response stopped
+ *   on tool calls. Running tools is outside this port's slice, and returning a
+ *   half-formed response would be worse than saying so.
+ */
+export function parseTextResponse(request, rawBody, options = {}) {
+    const data = validateResponse(rawBody);
+    const finishReason = mapFinishReason(data);
+    if (finishReason === FinishReason.ToolCalls) {
+        throw PrismError.toolLoopNotSupported();
+    }
+    if (finishReason === FinishReason.Length) {
+        throw PrismError.maxTokensExceeded('length', 'chat.completion');
+    }
+    const builder = new ResponseBuilder();
+    builder.addStep(buildStep(data, request, finishReason, options.rateLimits ?? []));
+    return builder.toResponse();
+}
+export function validateResponse(rawBody) {
+    if (!isJsonObject(rawBody) || Object.keys(rawBody).length === 0) {
+        throw PrismError.providerResponseError('Mistral returned an empty or non-object response body.');
+    }
+    // Mistral reports failures two ways: an `object: "error"` envelope, and a
+    // bare `{ message, type }` on validation errors. Both are checked, because
+    // only the first carries a recognisable marker and the second is what a
+    // malformed request actually gets back.
+    const error = readObject(rawBody.error);
+    if (error !== null) {
+        throw PrismError.providerResponseError(`Mistral error [${readString(error.type, 'unknown')}]: ${readString(error.message, 'unknown')}`);
+    }
+    if (rawBody.object === 'error' || (typeof rawBody.message === 'string' && rawBody.choices === undefined)) {
+        throw PrismError.providerResponseError(`Mistral error [${readString(rawBody.type, 'unknown')}]: ${readString(rawBody.message, 'unknown')}`);
+    }
+    return rawBody;
+}
+/** The first choice, or an empty object. Mistral returns one unless `n` was set. */
+export function firstChoiceMessage(data) {
+    const choice = readArray(data.choices)[0];
+    return isJsonObject(choice) ? (readObject(choice.message) ?? {}) : {};
+}
+function buildStep(data, request, finishReason, rateLimits) {
+    const message = firstChoiceMessage(data);
+    const usage = readObject(data.usage) ?? {};
+    return new TextStep({
+        text: extractText(message),
+        finishReason,
+        toolCalls: mapToolCalls(message),
+        usage: new Usage(readNumber(usage.prompt_tokens, 0), readNumber(usage.completion_tokens, 0), null, null, readNullableNumber(usage.reasoning_tokens)),
+        meta: new Meta(readString(data.id, ''), readString(data.model, ''), rateLimits, null),
+        messages: request.messages(),
+        systemPrompts: request.systemPrompts(),
+        additionalContent: whereNotNull({ thinking: extractThinking(message) }),
+        raw: data,
+    });
+}
+/**
+ * The reply text, from either shape Mistral uses.
+ *
+ * `content` is usually a string, but reasoning models return an ARRAY of typed
+ * chunks — and taking the array's `toString()` yields `[object Object]`, which
+ * looks like a model that answered nonsense rather than a parser that failed.
+ */
+export function extractText(message) {
+    if (typeof message.content === 'string') {
+        return message.content;
+    }
+    return readArray(message.content)
+        .filter(isJsonObject)
+        .filter((chunk) => chunk.type === 'text')
+        .map((chunk) => readString(chunk.text, ''))
+        .join('');
+}
+/** Reasoning chunks joined, or null when the model did not think. */
+export function extractThinking(message) {
+    const parts = readArray(message.content)
+        .filter(isJsonObject)
+        .filter((chunk) => chunk.type === 'thinking')
+        .flatMap((chunk) => readArray(chunk.thinking))
+        .filter(isJsonObject)
+        .map((part) => readString(part.text, ''))
+        .filter((text) => text !== '');
+    return parts.length > 0 ? parts.join('') : null;
+}
+function mapToolCalls(message) {
+    return readArray(message.tool_calls)
+        .filter(isJsonObject)
+        .map((call) => {
+        const fn = readObject(call.function) ?? {};
+        return new ToolCall(readString(call.id, ''), readString(fn.name, ''), 
+        // A JSON STRING on the wire, like OpenAI's chat completions and unlike
+        // Anthropic's decoded object. Kept as the string; `parsedArguments()`
+        // is the one place it is decoded.
+        typeof fn.arguments === 'string' ? fn.arguments : isJsonObject(fn.arguments) ? fn.arguments : '{}', null);
+    });
+}
+//# sourceMappingURL=parse-response.js.map

package/dist/providers/mistral/parse-response.js.map

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

package/dist/providers/mistral/rate-limits.d.ts

@@ -0,0 +1,24 @@
+import { ProviderRateLimit } from '../../value-objects/provider-rate-limit.js';
+/**
+ * Read Mistral's rate-limit headers.
+ *
+ * Mistral uses the `ratelimitbysize-*` family — one word, no separators, which
+ * is neither OpenAI's `x-ratelimit-*` nor Anthropic's `anthropic-ratelimit-*`.
+ *
+ * **And NO BUCKET SEGMENT.** The service sends `ratelimitbysize-limit`, not
+ * `ratelimitbysize-limit-tokens`. This reader used to expect the per-bucket
+ * suffix for `requests` and `tokens`, so a real Mistral response produced an
+ * empty array — indistinguishable from a provider that sent no quota headers at
+ * all, and silent for every call. It was caught by `prism-parity`'s
+ * `provider-rate-limits` corpus (`prl-0014`), not by this port's own tests,
+ * which fed the parser the names the parser expected; register entry G-41.
+ *
+ * Mistral meters by SIZE, so the single bucket it reports is named `tokens` —
+ * which is what the reference names it, what the reference's own `MistralTextTest`
+ * asserts against, and what `prism-py` reads.
+ *
+ * The reset is a DURATION IN SECONDS, not a timestamp and not OpenAI's `1m30s`
+ * string, so it is added to now rather than parsed as a date.
+ */
+export declare function parseRateLimits(headers: Readonly<Record<string, string>>): ProviderRateLimit[];
+//# sourceMappingURL=rate-limits.d.ts.map

package/dist/providers/mistral/rate-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limits.d.ts","sourceRoot":"","sources":["../../../src/providers/mistral/rate-limits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAG/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,iBAAiB,EAAE,CA0B9F"}

package/dist/providers/mistral/rate-limits.js

@@ -0,0 +1,55 @@
+import { ProviderRateLimit } from '../../value-objects/provider-rate-limit.js';
+import { foldHeaderNames } from '../../http/header-names.js';
+/**
+ * Read Mistral's rate-limit headers.
+ *
+ * Mistral uses the `ratelimitbysize-*` family — one word, no separators, which
+ * is neither OpenAI's `x-ratelimit-*` nor Anthropic's `anthropic-ratelimit-*`.
+ *
+ * **And NO BUCKET SEGMENT.** The service sends `ratelimitbysize-limit`, not
+ * `ratelimitbysize-limit-tokens`. This reader used to expect the per-bucket
+ * suffix for `requests` and `tokens`, so a real Mistral response produced an
+ * empty array — indistinguishable from a provider that sent no quota headers at
+ * all, and silent for every call. It was caught by `prism-parity`'s
+ * `provider-rate-limits` corpus (`prl-0014`), not by this port's own tests,
+ * which fed the parser the names the parser expected; register entry G-41.
+ *
+ * Mistral meters by SIZE, so the single bucket it reports is named `tokens` —
+ * which is what the reference names it, what the reference's own `MistralTextTest`
+ * asserts against, and what `prism-py` reads.
+ *
+ * The reset is a DURATION IN SECONDS, not a timestamp and not OpenAI's `1m30s`
+ * string, so it is added to now rather than parsed as a date.
+ */
+export function parseRateLimits(headers) {
+    // Folded first: HTTP field names are case-insensitive (RFC 9110 §5.1) and
+    // these are exact key lookups, so a title-casing gateway used to erase every
+    // rate limit here without a word.
+    const found = foldHeaderNames(headers);
+    const limit = found['ratelimitbysize-limit'];
+    const remaining = found['ratelimitbysize-remaining'];
+    // Only when the provider actually reported one. The reference emits this
+    // bucket unconditionally, so a response carrying no rate-limit headers comes
+    // back from it saying limit 0, remaining 0, resets now — a provider that said
+    // nothing, reported as exhausted. A caller cannot tell that apart from real
+    // exhaustion, and both readings of it are wrong.
+    if (limit === undefined || remaining === undefined) {
+        return [];
+    }
+    return [
+        new ProviderRateLimit('tokens', toInteger(limit), toInteger(remaining), resetAt(found['ratelimitbysize-reset'])),
+    ];
+}
+function toInteger(value) {
+    const parsed = Number.parseInt(value, 10);
+    return Number.isNaN(parsed) ? 0 : parsed;
+}
+/** Seconds from now, or null when the header is absent or not a number. */
+function resetAt(value) {
+    if (value === undefined) {
+        return null;
+    }
+    const seconds = Number.parseInt(value, 10);
+    return Number.isNaN(seconds) ? null : new Date(Date.now() + seconds * 1000);
+}
+//# sourceMappingURL=rate-limits.js.map

package/dist/providers/mistral/rate-limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limits.js","sourceRoot":"","sources":["../../../src/providers/mistral/rate-limits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyC;IACvE,0EAA0E;IAC1E,6EAA6E;IAC7E,kCAAkC;IAClC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAG,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAErD,yEAAyE;IACzE,6EAA6E;IAC7E,8EAA8E;IAC9E,4EAA4E;IAC5E,iDAAiD;IACjD,IAAI,KAAK,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACnD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,IAAI,iBAAiB,CACnB,QAAQ,EACR,SAAS,CAAC,KAAK,CAAC,EAChB,SAAS,CAAC,SAAS,CAAC,EACpB,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CACxC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAE1C,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3C,CAAC;AAED,2EAA2E;AAC3E,SAAS,OAAO,CAAC,KAAyB;IACxC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAE3C,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;AAC9E,CAAC"}

package/dist/providers/mistral/stream-events.d.ts

@@ -0,0 +1,29 @@
+import { type JsonObject } from '../../json.js';
+import { type StreamEvent } from '../../streaming/events.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 declare class MistralStreamMapper {
+    #private;
+    /**
+     * 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: JsonObject): StreamEvent[];
+}
+//# sourceMappingURL=stream-events.d.ts.map

package/dist/providers/mistral/stream-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-events.d.ts","sourceRoot":"","sources":["../../../src/providers/mistral/stream-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAG9D,OAAO,EAEL,KAAK,WAAW,EAMjB,MAAM,2BAA2B,CAAC;AAInC;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAmB;;IAgB9B;;;;;;;OAOG;IACH,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,WAAW,EAAE;CAwFxC"}