@openclaw/mistral-provider 0.0.0 → 2026.8.1-beta.2

package/README.md

@@ -1,3 +1,16 @@
-# @openclaw/mistral-provider
+# OpenClaw Mistral Provider
 
-Reserved placeholder for the official OpenClaw plugin package. Use a published release version instead.
+Official OpenClaw provider plugin for Mistral models, Voxtral transcription, and
+Mistral memory embeddings.
+
+Install from OpenClaw:
+
+```bash
+openclaw plugins install @openclaw/mistral-provider
+openclaw gateway restart
+```
+
+Set `MISTRAL_API_KEY`, then select a `mistral/*` model or configure Mistral for
+media transcription, realtime transcription, or memory embeddings.
+
+See <https://docs.openclaw.ai/providers/mistral> for setup and configuration.

package/dist/api.js

@@ -0,0 +1,48 @@
+import { buildMistralProvider } from "./provider-catalog.js";
+import { MISTRAL_BASE_URL, MISTRAL_DEFAULT_MODEL_ID, MISTRAL_DEFAULT_MODEL_REF, buildMistralModelDefinition } from "./model-definitions.js";
+import { applyMistralConfig, applyMistralProviderConfig } from "./onboard.js";
+const MISTRAL_MODEL_TRANSPORT_PATCH = {
+	supportsStore: false,
+	supportsPromptCacheKey: true,
+	supportsLongCacheRetention: false,
+	maxTokensField: "max_tokens"
+};
+const MISTRAL_SMALL_LATEST_REASONING_EFFORT_MAP = {
+	off: "none",
+	minimal: "none",
+	low: "high",
+	medium: "high",
+	high: "high",
+	xhigh: "high",
+	adaptive: "high",
+	max: "high"
+};
+const MISTRAL_SMALL_LATEST_ID = "mistral-small-latest";
+const MISTRAL_SMALL_4_ID = "mistral-small-2603";
+const MISTRAL_MEDIUM_3_5_ID = "mistral-medium-3-5";
+function resolveMistralCompatPatch(model) {
+	const reasoningEnabled = model.id === "mistral-small-latest" || model.id === "mistral-small-2603" || model.id === "mistral-medium-3-5";
+	return {
+		...MISTRAL_MODEL_TRANSPORT_PATCH,
+		supportsReasoningEffort: reasoningEnabled,
+		reasoningEffortMap: reasoningEnabled ? MISTRAL_SMALL_LATEST_REASONING_EFFORT_MAP : void 0
+	};
+}
+function compatMatchesResolved(compat, modelId) {
+	const expected = resolveMistralCompatPatch({ id: modelId });
+	return compat?.supportsStore === expected.supportsStore && compat?.supportsPromptCacheKey === expected.supportsPromptCacheKey && compat?.supportsLongCacheRetention === expected.supportsLongCacheRetention && compat?.supportsReasoningEffort === expected.supportsReasoningEffort && compat?.maxTokensField === expected.maxTokensField && compat?.reasoningEffortMap === expected.reasoningEffortMap;
+}
+function applyMistralModelCompat(model) {
+	const compat = model.compat && typeof model.compat === "object" ? model.compat : void 0;
+	if (compatMatchesResolved(compat, model.id)) return model;
+	const patch = resolveMistralCompatPatch(model);
+	return {
+		...model,
+		compat: {
+			...compat,
+			...patch
+		}
+	};
+}
+//#endregion
+export { MISTRAL_BASE_URL, MISTRAL_DEFAULT_MODEL_ID, MISTRAL_DEFAULT_MODEL_REF, MISTRAL_MEDIUM_3_5_ID, MISTRAL_MODEL_TRANSPORT_PATCH, MISTRAL_SMALL_4_ID, MISTRAL_SMALL_LATEST_ID, applyMistralConfig, applyMistralModelCompat, applyMistralProviderConfig, buildMistralModelDefinition, buildMistralProvider, resolveMistralCompatPatch };

package/dist/embedding-provider.js

@@ -0,0 +1,32 @@
+import { createRemoteEmbeddingProvider, normalizeEmbeddingModelWithPrefixes, resolveRemoteEmbeddingClient } from "openclaw/plugin-sdk/memory-core-host-engine-embeddings";
+//#region extensions/mistral/embedding-provider.ts
+const DEFAULT_MISTRAL_EMBEDDING_MODEL = "mistral-embed";
+const DEFAULT_MISTRAL_BASE_URL = "https://api.mistral.ai/v1";
+function normalizeMistralModel(model) {
+	return normalizeEmbeddingModelWithPrefixes({
+		model,
+		defaultModel: DEFAULT_MISTRAL_EMBEDDING_MODEL,
+		prefixes: ["mistral/"]
+	});
+}
+async function createMistralEmbeddingProvider(options) {
+	const client = await resolveMistralEmbeddingClient(options);
+	return {
+		provider: createRemoteEmbeddingProvider({
+			id: "mistral",
+			client,
+			errorPrefix: "mistral embeddings failed"
+		}),
+		client
+	};
+}
+async function resolveMistralEmbeddingClient(options) {
+	return await resolveRemoteEmbeddingClient({
+		provider: "mistral",
+		options,
+		defaultBaseUrl: DEFAULT_MISTRAL_BASE_URL,
+		normalizeModel: normalizeMistralModel
+	});
+}
+//#endregion
+export { DEFAULT_MISTRAL_EMBEDDING_MODEL, createMistralEmbeddingProvider };

package/dist/index.js

@@ -0,0 +1,44 @@
+import { t as openclaw_plugin_default } from "./openclaw.plugin-CxIFdez7.js";
+import { applyMistralConfig } from "./onboard.js";
+import { applyMistralModelCompat } from "./api.js";
+import { mistralMediaUnderstandingProvider } from "./media-understanding-provider.js";
+import { mistralMemoryEmbeddingProviderAdapter } from "./memory-embedding-adapter.js";
+import { buildMistralRealtimeTranscriptionProvider } from "./realtime-transcription-provider.js";
+import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry";
+//#region extensions/mistral/index.ts
+const PROVIDER_ID = "mistral";
+function buildMistralReplayPolicy() {
+	return {
+		sanitizeToolCallIds: true,
+		toolCallIdMode: "strict9"
+	};
+}
+var mistral_default = defineSingleProviderPluginEntry({
+	id: PROVIDER_ID,
+	name: "Mistral Provider",
+	description: "Official Mistral provider plugin",
+	manifest: openclaw_plugin_default,
+	provider: {
+		label: "Mistral",
+		docsPath: "/providers/models",
+		manifestAuth: { applyConfig: applyMistralConfig },
+		catalog: {
+			allowExplicitBaseUrl: true,
+			liveModelDiscovery: true
+		},
+		matchesContextOverflowError: ({ errorMessage }) => /\bmistral\b.*(?:input.*too long|token limit.*exceeded)/i.test(errorMessage),
+		normalizeResolvedModel: ({ model }) => applyMistralModelCompat(model),
+		resolveThinkingProfile: ({ modelId }) => modelId === "mistral-small-latest" || modelId === "mistral-small-2603" || modelId === "mistral-medium-3-5" ? {
+			levels: [{ id: "off" }, { id: "high" }],
+			defaultLevel: "off"
+		} : void 0,
+		buildReplayPolicy: () => buildMistralReplayPolicy()
+	},
+	register(api) {
+		api.registerMemoryEmbeddingProvider(mistralMemoryEmbeddingProviderAdapter);
+		api.registerMediaUnderstandingProvider(mistralMediaUnderstandingProvider);
+		api.registerRealtimeTranscriptionProvider(buildMistralRealtimeTranscriptionProvider());
+	}
+});
+//#endregion
+export { mistral_default as default };

package/dist/media-understanding-provider.js

@@ -0,0 +1,18 @@
+import { transcribeOpenAiCompatibleAudio } from "openclaw/plugin-sdk/media-understanding";
+//#region extensions/mistral/media-understanding-provider.ts
+const DEFAULT_MISTRAL_AUDIO_BASE_URL = "https://api.mistral.ai/v1";
+const DEFAULT_MISTRAL_AUDIO_MODEL = "voxtral-mini-latest";
+const mistralMediaUnderstandingProvider = {
+	id: "mistral",
+	capabilities: ["audio"],
+	defaultModels: { audio: DEFAULT_MISTRAL_AUDIO_MODEL },
+	autoPriority: { audio: 50 },
+	transcribeAudio: async (req) => await transcribeOpenAiCompatibleAudio({
+		...req,
+		baseUrl: req.baseUrl ?? DEFAULT_MISTRAL_AUDIO_BASE_URL,
+		defaultBaseUrl: DEFAULT_MISTRAL_AUDIO_BASE_URL,
+		defaultModel: DEFAULT_MISTRAL_AUDIO_MODEL
+	})
+};
+//#endregion
+export { mistralMediaUnderstandingProvider };

package/dist/memory-embedding-adapter.js

@@ -0,0 +1,31 @@
+import { DEFAULT_MISTRAL_EMBEDDING_MODEL, createMistralEmbeddingProvider } from "./embedding-provider.js";
+import { isMissingEmbeddingApiKeyError } from "openclaw/plugin-sdk/memory-core-host-engine-embeddings";
+//#region extensions/mistral/memory-embedding-adapter.ts
+const mistralMemoryEmbeddingProviderAdapter = {
+	id: "mistral",
+	defaultModel: DEFAULT_MISTRAL_EMBEDDING_MODEL,
+	transport: "remote",
+	authProviderId: "mistral",
+	autoSelectPriority: 50,
+	allowExplicitWhenConfiguredAuto: true,
+	shouldContinueAutoSelection: isMissingEmbeddingApiKeyError,
+	create: async (options) => {
+		const { provider, client } = await createMistralEmbeddingProvider({
+			...options,
+			provider: "mistral",
+			fallback: "none"
+		});
+		return {
+			provider,
+			runtime: {
+				id: "mistral",
+				cacheKeyData: {
+					provider: "mistral",
+					model: client.model
+				}
+			}
+		};
+	}
+};
+//#endregion
+export { mistralMemoryEmbeddingProviderAdapter };

package/dist/model-definitions.js

@@ -0,0 +1,20 @@
+import { t as openclaw_plugin_default } from "./openclaw.plugin-CxIFdez7.js";
+import { buildManifestModelProviderConfig, readManifestProviderDefaultModelRef } from "openclaw/plugin-sdk/provider-catalog-shared";
+//#region extensions/mistral/model-definitions.ts
+const MISTRAL_MANIFEST_CATALOG = openclaw_plugin_default.modelCatalog.providers.mistral;
+const MISTRAL_BASE_URL = MISTRAL_MANIFEST_CATALOG.baseUrl;
+const MISTRAL_DEFAULT_MODEL_REF = readManifestProviderDefaultModelRef(openclaw_plugin_default, "mistral");
+const MISTRAL_DEFAULT_MODEL_ID = MISTRAL_DEFAULT_MODEL_REF.slice(8);
+function buildMistralModelDefinition() {
+	const model = buildMistralCatalogModels().find((entry) => entry.id === MISTRAL_DEFAULT_MODEL_ID);
+	if (!model) throw new Error(`Missing Mistral provider model ${MISTRAL_DEFAULT_MODEL_ID}`);
+	return model;
+}
+function buildMistralCatalogModels() {
+	return buildManifestModelProviderConfig({
+		providerId: "mistral",
+		catalog: MISTRAL_MANIFEST_CATALOG
+	}).models;
+}
+//#endregion
+export { MISTRAL_BASE_URL, MISTRAL_DEFAULT_MODEL_ID, MISTRAL_DEFAULT_MODEL_REF, buildMistralModelDefinition };

package/dist/onboard.js

@@ -0,0 +1,19 @@
+import { MISTRAL_BASE_URL, MISTRAL_DEFAULT_MODEL_ID, MISTRAL_DEFAULT_MODEL_REF, buildMistralModelDefinition } from "./model-definitions.js";
+import { createDefaultModelPresetAppliers } from "openclaw/plugin-sdk/provider-onboard";
+//#region extensions/mistral/onboard.ts
+const { applyConfig: applyMistralConfig, applyProviderConfig: applyMistralProviderConfig } = createDefaultModelPresetAppliers({
+	primaryModelRef: MISTRAL_DEFAULT_MODEL_REF,
+	resolveParams: () => ({
+		providerId: "mistral",
+		api: "openai-completions",
+		baseUrl: MISTRAL_BASE_URL,
+		defaultModel: buildMistralModelDefinition(),
+		defaultModelId: MISTRAL_DEFAULT_MODEL_ID,
+		aliases: [{
+			modelRef: MISTRAL_DEFAULT_MODEL_REF,
+			alias: "Mistral"
+		}]
+	})
+});
+//#endregion
+export { applyMistralConfig, applyMistralProviderConfig };

package/dist/openclaw.plugin-CxIFdez7.js

@@ -0,0 +1,156 @@
+//#region extensions/mistral/openclaw.plugin.json
+var openclaw_plugin_default = {
+	id: "mistral",
+	icon: "https://cdn.simpleicons.org/mistralai",
+	activation: { "onStartup": false },
+	enabledByDefault: true,
+	providers: ["mistral"],
+	providerEndpoints: [{
+		"endpointClass": "mistral-public",
+		"hosts": ["api.mistral.ai"]
+	}],
+	providerRequest: { "providers": { "mistral": { "family": "mistral" } } },
+	modelCatalog: {
+		"providers": { "mistral": {
+			"baseUrl": "https://api.mistral.ai/v1",
+			"api": "openai-completions",
+			"defaultModel": "mistral-large-latest",
+			"models": [
+				{
+					"id": "codestral-latest",
+					"name": "Codestral (latest)",
+					"input": ["text"],
+					"contextWindow": 128e3,
+					"maxTokens": 4096,
+					"cost": {
+						"input": .3,
+						"output": .9,
+						"cacheRead": .03,
+						"cacheWrite": 0
+					}
+				},
+				{
+					"id": "devstral-medium-latest",
+					"name": "Devstral 2 (latest)",
+					"status": "deprecated",
+					"replacedBy": "mistral-medium-3-5",
+					"input": ["text"],
+					"contextWindow": 262144,
+					"maxTokens": 32768,
+					"cost": {
+						"input": .4,
+						"output": 2,
+						"cacheRead": .04,
+						"cacheWrite": 0
+					}
+				},
+				{
+					"id": "mistral-large-latest",
+					"name": "Mistral Large 3 (latest)",
+					"input": ["text", "image"],
+					"contextWindow": 262144,
+					"maxTokens": 16384,
+					"cost": {
+						"input": .5,
+						"output": 1.5,
+						"cacheRead": .05,
+						"cacheWrite": 0
+					}
+				},
+				{
+					"id": "mistral-medium-2508",
+					"name": "Mistral Medium 3.1",
+					"status": "deprecated",
+					"replacedBy": "mistral-medium-3-5",
+					"input": ["text", "image"],
+					"contextWindow": 128e3,
+					"maxTokens": 8192,
+					"cost": {
+						"input": .4,
+						"output": 2,
+						"cacheRead": .04,
+						"cacheWrite": 0
+					}
+				},
+				{
+					"id": "mistral-medium-3-5",
+					"name": "Mistral Medium 3.5",
+					"input": ["text", "image"],
+					"reasoning": true,
+					"contextWindow": 262144,
+					"maxTokens": 8192,
+					"cost": {
+						"input": 1.5,
+						"output": 7.5,
+						"cacheRead": .15,
+						"cacheWrite": 0
+					}
+				},
+				{
+					"id": "mistral-small-latest",
+					"name": "Mistral Small 4 (latest)",
+					"input": ["text", "image"],
+					"reasoning": true,
+					"contextWindow": 262144,
+					"maxTokens": 16384,
+					"cost": {
+						"input": .15,
+						"output": .6,
+						"cacheRead": .015,
+						"cacheWrite": 0
+					}
+				},
+				{
+					"id": "mistral-small-2603",
+					"name": "Mistral Small 4 (26.03)",
+					"input": ["text", "image"],
+					"reasoning": true,
+					"contextWindow": 262144,
+					"maxTokens": 16384,
+					"cost": {
+						"input": .15,
+						"output": .6,
+						"cacheRead": .015,
+						"cacheWrite": 0
+					}
+				}
+			]
+		} },
+		"discovery": { "mistral": "refreshable" }
+	},
+	setup: { "providers": [{
+		"id": "mistral",
+		"envVars": ["MISTRAL_API_KEY"]
+	}] },
+	providerAuthChoices: [{
+		"provider": "mistral",
+		"method": "api-key",
+		"choiceId": "mistral-api-key",
+		"appGuidedSecret": true,
+		"choiceLabel": "Mistral API key",
+		"groupId": "mistral",
+		"groupLabel": "Mistral AI",
+		"groupHint": "API key",
+		"optionKey": "mistralApiKey",
+		"cliFlag": "--mistral-api-key",
+		"cliOption": "--mistral-api-key <key>",
+		"cliDescription": "Mistral API key"
+	}],
+	contracts: {
+		"memoryEmbeddingProviders": ["mistral"],
+		"mediaUnderstandingProviders": ["mistral"],
+		"realtimeTranscriptionProviders": ["mistral"]
+	},
+	mediaUnderstandingProviderMetadata: { "mistral": {
+		"capabilities": ["audio"],
+		"defaultModels": { "audio": "voxtral-mini-latest" },
+		"autoPriority": { "audio": 50 }
+	} },
+	configSchema: {
+		"type": "object",
+		"additionalProperties": false,
+		"properties": {}
+	}
+};
+//#endregion
+export { openclaw_plugin_default as t };

package/dist/provider-catalog.js

@@ -0,0 +1,11 @@
+import { t as openclaw_plugin_default } from "./openclaw.plugin-CxIFdez7.js";
+import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared";
+//#region extensions/mistral/provider-catalog.ts
+function buildMistralProvider() {
+	return buildManifestModelProviderConfig({
+		providerId: "mistral",
+		catalog: openclaw_plugin_default.modelCatalog.providers.mistral
+	});
+}
+//#endregion
+export { buildMistralProvider };

package/dist/realtime-transcription-provider.js

@@ -0,0 +1,217 @@
+import { createRealtimeTranscriptionWebSocketSession } from "openclaw/plugin-sdk/realtime-transcription";
+import { normalizeResolvedSecretInputString, normalizeSecretInput } from "openclaw/plugin-sdk/secret-input";
+import { asOptionalRecord, normalizeOptionalString, parseFiniteNumber } from "openclaw/plugin-sdk/string-coerce-runtime";
+//#region extensions/mistral/realtime-transcription-provider.ts
+const MISTRAL_REALTIME_DEFAULT_BASE_URL = "wss://api.mistral.ai";
+const MISTRAL_REALTIME_DEFAULT_MODEL = "voxtral-mini-transcribe-realtime-2602";
+const MISTRAL_REALTIME_DEFAULT_SAMPLE_RATE = 8e3;
+const MISTRAL_REALTIME_DEFAULT_ENCODING = "pcm_mulaw";
+const MISTRAL_REALTIME_DEFAULT_DELAY_MS = 800;
+const MISTRAL_REALTIME_CONNECT_TIMEOUT_MS = 1e4;
+const MISTRAL_REALTIME_CLOSE_TIMEOUT_MS = 5e3;
+const MISTRAL_REALTIME_MAX_RECONNECT_ATTEMPTS = 5;
+const MISTRAL_REALTIME_RECONNECT_DELAY_MS = 1e3;
+const MISTRAL_REALTIME_MAX_QUEUED_BYTES = 2 * 1024 * 1024;
+const MISTRAL_REALTIME_SPEECH_CONTENT = /[\p{L}\p{N}]/u;
+const MISTRAL_REALTIME_MAX_PARTIAL_TRANSCRIPT_BYTES = 256 * 1024;
+const MISTRAL_REALTIME_PARTIAL_TRANSCRIPT_OVERFLOW_MESSAGE = "Mistral realtime transcription exceeded the 256 KiB in-progress transcript limit";
+function readNestedMistralConfig(rawConfig) {
+	const raw = asOptionalRecord(rawConfig);
+	return asOptionalRecord(asOptionalRecord(raw?.providers)?.mistral ?? raw?.mistral ?? raw) ?? {};
+}
+function normalizeMistralEncoding(value) {
+	const normalized = normalizeOptionalString(value)?.toLowerCase();
+	if (!normalized) return;
+	switch (normalized) {
+		case "pcm":
+		case "linear16":
+		case "pcm_s16le": return "pcm_s16le";
+		case "pcm_s32le":
+		case "pcm_f16le":
+		case "pcm_f32le": return normalized;
+		case "mulaw":
+		case "ulaw":
+		case "g711_ulaw":
+		case "g711-mulaw":
+		case "pcm_mulaw": return "pcm_mulaw";
+		case "alaw":
+		case "g711_alaw":
+		case "g711-alaw":
+		case "pcm_alaw": return "pcm_alaw";
+		default: throw new Error(`Invalid Mistral realtime transcription encoding: ${normalized}`);
+	}
+}
+function normalizeMistralRealtimeBaseUrl(value) {
+	const raw = normalizeOptionalString(value ?? process.env.MISTRAL_REALTIME_BASE_URL);
+	if (!raw) return MISTRAL_REALTIME_DEFAULT_BASE_URL;
+	const url = new URL(raw);
+	url.protocol = url.protocol === "http:" ? "ws:" : url.protocol === "https:" ? "wss:" : url.protocol;
+	url.pathname = url.pathname.replace(/\/v1\/?$/, "").replace(/\/+$/, "");
+	return url.toString().replace(/\/+$/, "");
+}
+function toMistralRealtimeWsUrl(config) {
+	const base = new URL(`${normalizeMistralRealtimeBaseUrl(config.baseUrl)}/`);
+	const url = new URL("v1/audio/transcriptions/realtime", base);
+	url.searchParams.set("model", config.model);
+	if (config.targetStreamingDelayMs != null) url.searchParams.set("target_streaming_delay_ms", String(config.targetStreamingDelayMs));
+	return url.toString();
+}
+function normalizeProviderConfig(config) {
+	const raw = readNestedMistralConfig(config);
+	return {
+		apiKey: normalizeMistralApiKey(raw.apiKey),
+		baseUrl: normalizeOptionalString(raw.baseUrl),
+		model: normalizeOptionalString(raw.model ?? raw.sttModel),
+		sampleRate: parseFiniteNumber(raw.sampleRate ?? raw.sample_rate),
+		encoding: normalizeMistralEncoding(raw.encoding),
+		targetStreamingDelayMs: parseFiniteNumber(raw.targetStreamingDelayMs ?? raw.target_streaming_delay_ms ?? raw.delayMs)
+	};
+}
+function normalizeMistralApiKey(value) {
+	return normalizeSecretInput(normalizeResolvedSecretInputString({
+		value,
+		path: "plugins.entries.voice-call.config.streaming.providers.mistral.apiKey"
+	})) || void 0;
+}
+function readErrorDetail(event) {
+	const message = event.error?.message;
+	if (typeof message === "string") return message;
+	if (message && typeof message === "object") return JSON.stringify(message);
+	if (typeof event.error?.code === "number") return `Mistral realtime transcription error (${event.error.code})`;
+	return "Mistral realtime transcription error";
+}
+function measureTranscriptDeltaBytes(partialText, delta) {
+	const previousCodeUnit = partialText.charCodeAt(partialText.length - 1);
+	const nextCodeUnit = delta.charCodeAt(0);
+	const completesSplitSurrogatePair = previousCodeUnit >= 55296 && previousCodeUnit <= 56319 && nextCodeUnit >= 56320 && nextCodeUnit <= 57343;
+	return Buffer.byteLength(delta, "utf8") - (completesSplitSurrogatePair ? 2 : 0);
+}
+function createMistralRealtimeTranscriptionSession(config) {
+	let partialText = "";
+	let partialBytes = 0;
+	let hasFinalSegment = false;
+	let terminal = false;
+	const clearPartial = () => {
+		partialText = "";
+		partialBytes = 0;
+	};
+	const emitFinalTranscript = (text, source) => {
+		if (!text.trim() || source === "pending" && !MISTRAL_REALTIME_SPEECH_CONTENT.test(text)) return;
+		hasFinalSegment ||= source === "segment";
+		config.onTranscript?.(text);
+	};
+	const failTerminal = (error, transport) => {
+		if (terminal) return;
+		terminal = true;
+		clearPartial();
+		transport.closeNow();
+		try {
+			config.onError?.(error);
+		} catch {}
+	};
+	const handleEvent = (event, transport) => {
+		if (terminal) return;
+		if (event.type === "session.created") {
+			clearPartial();
+			hasFinalSegment = false;
+			transport.sendJson({
+				type: "session.update",
+				session: { audio_format: {
+					encoding: config.encoding,
+					sample_rate: config.sampleRate
+				} }
+			});
+			transport.markReady();
+			return;
+		}
+		if (!transport.isReady() && event.type === "error") {
+			transport.failConnect(new Error(readErrorDetail(event)));
+			return;
+		}
+		switch (event.type) {
+			case "transcription.text.delta":
+				if (event.text) {
+					const deltaBytes = measureTranscriptDeltaBytes(partialText, event.text);
+					if (deltaBytes > MISTRAL_REALTIME_MAX_PARTIAL_TRANSCRIPT_BYTES - partialBytes) {
+						failTerminal(/* @__PURE__ */ new Error(MISTRAL_REALTIME_PARTIAL_TRANSCRIPT_OVERFLOW_MESSAGE), transport);
+						return;
+					}
+					partialText += event.text;
+					partialBytes += deltaBytes;
+					config.onPartial?.(partialText);
+				}
+				return;
+			case "transcription.segment":
+				if (event.text?.trim()) {
+					emitFinalTranscript(event.text, "segment");
+					clearPartial();
+				}
+				return;
+			case "transcription.done": {
+				terminal = true;
+				const source = hasFinalSegment ? "pending" : "terminal";
+				const terminalText = source === "pending" ? partialText : event.text?.trim() ? event.text : partialText;
+				clearPartial();
+				try {
+					emitFinalTranscript(terminalText, source);
+				} finally {
+					transport.closeNow();
+				}
+				return;
+			}
+			case "error": failTerminal(new Error(readErrorDetail(event)), transport);
+			default:
+		}
+	};
+	return createRealtimeTranscriptionWebSocketSession({
+		providerId: "mistral",
+		callbacks: config,
+		url: () => toMistralRealtimeWsUrl(config),
+		headers: { Authorization: `Bearer ${config.apiKey}` },
+		connectTimeoutMs: MISTRAL_REALTIME_CONNECT_TIMEOUT_MS,
+		closeTimeoutMs: MISTRAL_REALTIME_CLOSE_TIMEOUT_MS,
+		maxReconnectAttempts: MISTRAL_REALTIME_MAX_RECONNECT_ATTEMPTS,
+		reconnectDelayMs: MISTRAL_REALTIME_RECONNECT_DELAY_MS,
+		maxQueuedBytes: MISTRAL_REALTIME_MAX_QUEUED_BYTES,
+		connectTimeoutMessage: "Mistral realtime transcription connection timeout",
+		reconnectLimitMessage: "Mistral realtime transcription reconnect limit reached",
+		sendAudio: (audio, transport) => {
+			transport.sendJson({
+				type: "input_audio.append",
+				audio: audio.toString("base64")
+			});
+		},
+		onClose: (transport) => {
+			transport.sendJson({ type: "input_audio.flush" });
+			transport.sendJson({ type: "input_audio.end" });
+		},
+		onMessage: handleEvent
+	});
+}
+function buildMistralRealtimeTranscriptionProvider() {
+	return {
+		id: "mistral",
+		label: "Mistral Realtime Transcription",
+		aliases: ["mistral-realtime", "voxtral-realtime"],
+		defaultModel: MISTRAL_REALTIME_DEFAULT_MODEL,
+		autoSelectOrder: 45,
+		resolveConfig: ({ rawConfig }) => normalizeProviderConfig(rawConfig),
+		isConfigured: ({ providerConfig }) => Boolean(normalizeProviderConfig(providerConfig).apiKey || normalizeMistralApiKey(process.env.MISTRAL_API_KEY)),
+		createSession: (req) => {
+			const config = normalizeProviderConfig(req.providerConfig);
+			const apiKey = config.apiKey || normalizeMistralApiKey(process.env.MISTRAL_API_KEY);
+			if (!apiKey) throw new Error("Mistral API key missing");
+			return createMistralRealtimeTranscriptionSession({
+				...req,
+				apiKey,
+				baseUrl: normalizeMistralRealtimeBaseUrl(config.baseUrl),
+				model: config.model ?? MISTRAL_REALTIME_DEFAULT_MODEL,
+				sampleRate: config.sampleRate ?? MISTRAL_REALTIME_DEFAULT_SAMPLE_RATE,
+				encoding: config.encoding ?? MISTRAL_REALTIME_DEFAULT_ENCODING,
+				targetStreamingDelayMs: config.targetStreamingDelayMs ?? MISTRAL_REALTIME_DEFAULT_DELAY_MS
+			});
+		}
+	};
+}
+//#endregion
+export { buildMistralRealtimeTranscriptionProvider };

package/openclaw.plugin.json

@@ -0,0 +1,179 @@
+{
+  "id": "mistral",
+  "icon": "https://cdn.simpleicons.org/mistralai",
+  "activation": {
+    "onStartup": false
+  },
+  "enabledByDefault": true,
+  "providers": ["mistral"],
+  "providerEndpoints": [
+    {
+      "endpointClass": "mistral-public",
+      "hosts": ["api.mistral.ai"]
+    }
+  ],
+  "providerRequest": {
+    "providers": {
+      "mistral": {
+        "family": "mistral"
+      }
+    }
+  },
+  "modelCatalog": {
+    "providers": {
+      "mistral": {
+        "baseUrl": "https://api.mistral.ai/v1",
+        "api": "openai-completions",
+        "defaultModel": "mistral-large-latest",
+        "models": [
+          {
+            "id": "codestral-latest",
+            "name": "Codestral (latest)",
+            "input": ["text"],
+            "contextWindow": 128000,
+            "maxTokens": 4096,
+            "cost": {
+              "input": 0.3,
+              "output": 0.9,
+              "cacheRead": 0.03,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "devstral-medium-latest",
+            "name": "Devstral 2 (latest)",
+            "status": "deprecated",
+            "replacedBy": "mistral-medium-3-5",
+            "input": ["text"],
+            "contextWindow": 262144,
+            "maxTokens": 32768,
+            "cost": {
+              "input": 0.4,
+              "output": 2,
+              "cacheRead": 0.04,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "mistral-large-latest",
+            "name": "Mistral Large 3 (latest)",
+            "input": ["text", "image"],
+            "contextWindow": 262144,
+            "maxTokens": 16384,
+            "cost": {
+              "input": 0.5,
+              "output": 1.5,
+              "cacheRead": 0.05,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "mistral-medium-2508",
+            "name": "Mistral Medium 3.1",
+            "status": "deprecated",
+            "replacedBy": "mistral-medium-3-5",
+            "input": ["text", "image"],
+            "contextWindow": 128000,
+            "maxTokens": 8192,
+            "cost": {
+              "input": 0.4,
+              "output": 2,
+              "cacheRead": 0.04,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "mistral-medium-3-5",
+            "name": "Mistral Medium 3.5",
+            "input": ["text", "image"],
+            "reasoning": true,
+            "contextWindow": 262144,
+            "maxTokens": 8192,
+            "cost": {
+              "input": 1.5,
+              "output": 7.5,
+              "cacheRead": 0.15,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "mistral-small-latest",
+            "name": "Mistral Small 4 (latest)",
+            "input": ["text", "image"],
+            "reasoning": true,
+            "contextWindow": 262144,
+            "maxTokens": 16384,
+            "cost": {
+              "input": 0.15,
+              "output": 0.6,
+              "cacheRead": 0.015,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "mistral-small-2603",
+            "name": "Mistral Small 4 (26.03)",
+            "input": ["text", "image"],
+            "reasoning": true,
+            "contextWindow": 262144,
+            "maxTokens": 16384,
+            "cost": {
+              "input": 0.15,
+              "output": 0.6,
+              "cacheRead": 0.015,
+              "cacheWrite": 0
+            }
+          }
+        ]
+      }
+    },
+    "discovery": {
+      "mistral": "refreshable"
+    }
+  },
+  "setup": {
+    "providers": [
+      {
+        "id": "mistral",
+        "envVars": ["MISTRAL_API_KEY"]
+      }
+    ]
+  },
+  "providerAuthChoices": [
+    {
+      "provider": "mistral",
+      "method": "api-key",
+      "choiceId": "mistral-api-key",
+      "appGuidedSecret": true,
+      "choiceLabel": "Mistral API key",
+      "groupId": "mistral",
+      "groupLabel": "Mistral AI",
+      "groupHint": "API key",
+      "optionKey": "mistralApiKey",
+      "cliFlag": "--mistral-api-key",
+      "cliOption": "--mistral-api-key <key>",
+      "cliDescription": "Mistral API key"
+    }
+  ],
+  "contracts": {
+    "memoryEmbeddingProviders": ["mistral"],
+    "mediaUnderstandingProviders": ["mistral"],
+    "realtimeTranscriptionProviders": ["mistral"]
+  },
+  "mediaUnderstandingProviderMetadata": {
+    "mistral": {
+      "capabilities": ["audio"],
+      "defaultModels": {
+        "audio": "voxtral-mini-latest"
+      },
+      "autoPriority": {
+        "audio": 50
+      }
+    }
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -1,14 +1,49 @@
 {
   "name": "@openclaw/mistral-provider",
-  "version": "0.0.0",
-  "description": "Reserved package name for an official OpenClaw plugin.",
-  "license": "MIT",
+  "version": "2026.8.1-beta.2",
+  "description": "OpenClaw Mistral provider plugin",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/openclaw/openclaw.git"
+    "url": "https://github.com/openclaw/openclaw"
   },
-  "publishConfig": {
-    "access": "public",
-    "tag": "placeholder"
-  }
+  "type": "module",
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "install": {
+      "clawhubSpec": "clawhub:@openclaw/mistral-provider",
+      "npmSpec": "@openclaw/mistral-provider",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.7.2"
+    },
+    "compat": {
+      "pluginApi": ">=2026.8.1-beta.2"
+    },
+    "build": {
+      "openclawVersion": "2026.8.1-beta.2",
+      "bundledDist": false
+    },
+    "release": {
+      "publishToClawHub": true,
+      "publishToNpm": true
+    },
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ]
+  },
+  "files": [
+    "dist/**",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "openclaw": ">=2026.8.1-beta.2"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "bundledDependencies": []
 }