@amplitude/ai 0.1.0

package/dist/providers/gemini.d.ts

@@ -0,0 +1,34 @@
+import { PrivacyConfig } from "../core/privacy.js";
+import { AmplitudeOrAI } from "../types.js";
+import { BaseAIProvider } from "./base.js";
+
+//#region src/providers/gemini.d.ts
+
+declare const GEMINI_AVAILABLE: boolean;
+declare const _GeminiModule: Record<string, unknown> | null;
+interface GeminiOptions {
+  amplitude: AmplitudeOrAI;
+  apiKey?: string;
+  privacyConfig?: PrivacyConfig | null;
+  /** Pass the `@google/generative-ai` module directly to bypass `tryRequire` (required in bundler environments). */
+  geminiModule?: unknown;
+}
+declare class Gemini extends BaseAIProvider {
+  private _client;
+  constructor(options: GeminiOptions);
+  generateContent(model: string, params: Record<string, unknown>): Promise<unknown>;
+  generateContentStream(model: string, params: Record<string, unknown>): Promise<unknown>;
+  get client(): unknown;
+  private _wrapStream;
+}
+declare function extractGeminiResponse(response: unknown): {
+  text: string;
+  inputTokens?: number;
+  outputTokens?: number;
+  totalTokens?: number;
+  finishReason?: string;
+  functionCalls?: Array<Record<string, unknown>>;
+};
+//#endregion
+export { GEMINI_AVAILABLE, Gemini, GeminiOptions, _GeminiModule, extractGeminiResponse };
+//# sourceMappingURL=gemini.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","names":[],"sources":["../../src/providers/gemini.ts"],"sourcesContent":[],"mappings":";;;;;;AAaM,cADO,gBACQ,EAAA,OAAM;AAI3B,cAJM,aAIwB,EAJT,MAKR,CAAA,MAAA,EAAA,OAEK,CAAA,GAAA,IAAA;AAQK,UAXN,aAAA,CAWM;EAuBX,SAAA,EAjCC,aAiCD;EACP,MAAA,CAAA,EAAA,MAAA;EAkFO,aAAA,CAAA,EAlHM,aAkHN,GAAA,IAAA;EACP;EA9GuB,YAAA,CAAA,EAAA,OAAA;;AAuQZ,cAvQH,MAAA,SAAe,cAAA,CA6QV;;uBA1QK;yCAuBX,0BACP;+CAkFO,0BACP;;;;iBAyJW,qBAAA;;;;;;kBAME,MAAM"}

package/dist/providers/gemini.js

@@ -0,0 +1,225 @@
+import { tryRequire } from "../utils/resolve-module.js";
+import { calculateCost } from "../utils/costs.js";
+import { StreamingAccumulator } from "../utils/streaming.js";
+import { BaseAIProvider, applySessionContext } from "./base.js";
+
+//#region src/providers/gemini.ts
+const _resolved = tryRequire("@google/generative-ai");
+const GEMINI_AVAILABLE = _resolved != null;
+const _GeminiModule = _resolved;
+var Gemini = class extends BaseAIProvider {
+	_client;
+	constructor(options) {
+		super({
+			amplitude: options.amplitude,
+			privacyConfig: options.privacyConfig,
+			providerName: "gemini"
+		});
+		const mod = options.geminiModule ?? _GeminiModule;
+		if (mod == null) throw new Error("@google/generative-ai package is required. Install it with: npm install @google/generative-ai — or pass the module directly via the geminiModule option.");
+		const GoogleGenAI = mod.GoogleGenerativeAI;
+		this._client = new GoogleGenAI(options.apiKey ?? "");
+	}
+	async generateContent(model, params) {
+		const genModel = this._client.getGenerativeModel.call(this._client, { model });
+		const generateFn = genModel.generateContent;
+		const startTime = performance.now();
+		try {
+			const response = await generateFn.call(genModel, params);
+			const latencyMs = performance.now() - startTime;
+			const extracted = extractGeminiResponse(response);
+			let costUsd = null;
+			if (extracted.inputTokens != null && extracted.outputTokens != null) try {
+				costUsd = calculateCost({
+					modelName: model,
+					inputTokens: extracted.inputTokens,
+					outputTokens: extracted.outputTokens
+				});
+			} catch {}
+			const ctx = applySessionContext();
+			this._track({
+				userId: ctx.userId ?? "unknown",
+				modelName: model,
+				provider: "gemini",
+				responseContent: extracted.text,
+				latencyMs,
+				sessionId: ctx.sessionId,
+				traceId: ctx.traceId,
+				turnId: ctx.turnId ?? void 0,
+				agentId: ctx.agentId,
+				env: ctx.env,
+				inputTokens: extracted.inputTokens,
+				outputTokens: extracted.outputTokens,
+				totalTokens: extracted.totalTokens,
+				totalCostUsd: costUsd,
+				finishReason: extracted.finishReason,
+				toolCalls: extracted.functionCalls?.length ? extracted.functionCalls : void 0,
+				systemPrompt: extractGeminiSystemPrompt(params),
+				temperature: extractGeminiTemperature(params),
+				topP: extractGeminiTopP(params),
+				maxOutputTokens: extractGeminiMaxOutputTokens(params),
+				isStreaming: false
+			});
+			return response;
+		} catch (error) {
+			const latencyMs = performance.now() - startTime;
+			const ctx = applySessionContext();
+			this._track({
+				userId: ctx.userId ?? "unknown",
+				modelName: model,
+				provider: "gemini",
+				responseContent: "",
+				latencyMs,
+				sessionId: ctx.sessionId,
+				traceId: ctx.traceId,
+				agentId: ctx.agentId,
+				env: ctx.env,
+				isError: true,
+				errorMessage: error instanceof Error ? error.message : String(error)
+			});
+			throw error;
+		}
+	}
+	async generateContentStream(model, params) {
+		const ctx = applySessionContext();
+		const startTime = performance.now();
+		try {
+			const genModel = this._client.getGenerativeModel.call(this._client, { model });
+			const streamFn = genModel.generateContentStream;
+			if (typeof streamFn !== "function") throw new Error("Gemini SDK does not expose generateContentStream");
+			const streamResponse = await streamFn.call(genModel, params);
+			const stream = streamResponse.stream;
+			const finalResponse = streamResponse.response;
+			if (!_isAsyncIterable(stream)) throw new Error("Gemini stream response is not AsyncIterable");
+			return {
+				...streamResponse,
+				stream: this._wrapStream(model, params, stream, finalResponse)
+			};
+		} catch (error) {
+			this._track({
+				userId: ctx.userId ?? "unknown",
+				modelName: model,
+				provider: "gemini",
+				responseContent: "",
+				latencyMs: performance.now() - startTime,
+				sessionId: ctx.sessionId,
+				traceId: ctx.traceId,
+				agentId: ctx.agentId,
+				env: ctx.env,
+				isError: true,
+				errorMessage: error instanceof Error ? error.message : String(error),
+				isStreaming: true
+			});
+			throw error;
+		}
+	}
+	get client() {
+		return this._client;
+	}
+	async *_wrapStream(model, params, stream, finalResponse) {
+		const accumulator = new StreamingAccumulator();
+		const ctx = applySessionContext();
+		try {
+			for await (const chunk of stream) {
+				const extracted = extractGeminiResponse(chunk);
+				if (extracted.text) accumulator.addContent(extracted.text);
+				if (Array.isArray(extracted.functionCalls)) for (const fc of extracted.functionCalls) accumulator.addToolCall(fc);
+				if (extracted.finishReason != null) accumulator.finishReason = String(extracted.finishReason);
+				accumulator.setUsage({
+					inputTokens: extracted.inputTokens,
+					outputTokens: extracted.outputTokens,
+					totalTokens: extracted.totalTokens
+				});
+				yield chunk;
+			}
+		} catch (error) {
+			accumulator.setError(error instanceof Error ? error.message : String(error));
+			throw error;
+		} finally {
+			if (finalResponse != null) try {
+				const extractedFinal = extractGeminiResponse(await finalResponse);
+				accumulator.setUsage({
+					inputTokens: extractedFinal.inputTokens,
+					outputTokens: extractedFinal.outputTokens,
+					totalTokens: extractedFinal.totalTokens
+				});
+				if (extractedFinal.finishReason != null) accumulator.finishReason = String(extractedFinal.finishReason);
+				if (Array.isArray(extractedFinal.functionCalls)) for (const fc of extractedFinal.functionCalls) accumulator.addToolCall(fc);
+			} catch {}
+			const state = accumulator.getState();
+			let costUsd = null;
+			if (state.inputTokens != null && state.outputTokens != null) try {
+				costUsd = calculateCost({
+					modelName: model,
+					inputTokens: state.inputTokens,
+					outputTokens: state.outputTokens
+				});
+			} catch {}
+			this._track({
+				userId: ctx.userId ?? "unknown",
+				modelName: model,
+				provider: "gemini",
+				responseContent: state.content,
+				latencyMs: accumulator.elapsedMs,
+				sessionId: ctx.sessionId,
+				traceId: ctx.traceId,
+				turnId: ctx.turnId ?? void 0,
+				agentId: ctx.agentId,
+				env: ctx.env,
+				inputTokens: state.inputTokens,
+				outputTokens: state.outputTokens,
+				totalTokens: state.totalTokens,
+				totalCostUsd: costUsd,
+				finishReason: state.finishReason,
+				toolCalls: state.toolCalls.length > 0 ? state.toolCalls : void 0,
+				systemPrompt: extractGeminiSystemPrompt(params),
+				temperature: extractGeminiTemperature(params),
+				topP: extractGeminiTopP(params),
+				maxOutputTokens: extractGeminiMaxOutputTokens(params),
+				providerTtfbMs: state.ttfbMs,
+				isStreaming: true,
+				isError: state.isError,
+				errorMessage: state.errorMessage
+			});
+		}
+	}
+};
+function extractGeminiResponse(response) {
+	const resp = response;
+	const respObj = resp.response ?? resp;
+	let text = "";
+	if (typeof respObj.text === "function") try {
+		text = String(respObj.text());
+	} catch {}
+	const usage = respObj.usageMetadata;
+	const candidate = respObj.candidates?.[0];
+	const finishReason = candidate?.finishReason;
+	const functionCalls = (candidate?.content?.parts)?.filter((p) => p.functionCall != null).map((p) => p.functionCall);
+	return {
+		text,
+		inputTokens: usage?.promptTokenCount,
+		outputTokens: usage?.candidatesTokenCount,
+		totalTokens: usage?.totalTokenCount,
+		finishReason,
+		functionCalls: functionCalls?.length ? functionCalls : void 0
+	};
+}
+function extractGeminiSystemPrompt(params) {
+	return params.systemInstruction ?? params.generationConfig?.systemInstruction;
+}
+function extractGeminiTemperature(params) {
+	return params.generationConfig?.temperature;
+}
+function extractGeminiTopP(params) {
+	return params.generationConfig?.topP;
+}
+function extractGeminiMaxOutputTokens(params) {
+	return params.generationConfig?.maxOutputTokens;
+}
+function _isAsyncIterable(value) {
+	return value != null && typeof value[Symbol.asyncIterator] === "function";
+}
+
+//#endregion
+export { GEMINI_AVAILABLE, Gemini, _GeminiModule, extractGeminiResponse };
+//# sourceMappingURL=gemini.js.map

package/dist/providers/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","names":["_GeminiModule: Record<string, unknown> | null","costUsd: number | null"],"sources":["../../src/providers/gemini.ts"],"sourcesContent":["/**\n * Google Gemini provider wrapper with automatic tracking.\n */\n\nimport type { PrivacyConfig } from '../core/privacy.js';\nimport type { AmplitudeOrAI, GeminiResponse } from '../types.js';\nimport { calculateCost } from '../utils/costs.js';\nimport { tryRequire } from '../utils/resolve-module.js';\nimport { StreamingAccumulator } from '../utils/streaming.js';\nimport { applySessionContext, BaseAIProvider } from './base.js';\n\nconst _resolved = tryRequire('@google/generative-ai');\nexport const GEMINI_AVAILABLE = _resolved != null;\nconst _GeminiModule: Record<string, unknown> | null = _resolved;\n\nexport { _GeminiModule };\n\nexport interface GeminiOptions {\n  amplitude: AmplitudeOrAI;\n  apiKey?: string;\n  privacyConfig?: PrivacyConfig | null;\n  /** Pass the `@google/generative-ai` module directly to bypass `tryRequire` (required in bundler environments). */\n  geminiModule?: unknown;\n}\n\nexport class Gemini extends BaseAIProvider {\n  private _client: unknown;\n\n  constructor(options: GeminiOptions) {\n    super({\n      amplitude: options.amplitude,\n      privacyConfig: options.privacyConfig,\n      providerName: 'gemini',\n    });\n\n    const mod =\n      (options.geminiModule as Record<string, unknown> | null) ?? _GeminiModule;\n    if (mod == null) {\n      throw new Error(\n        '@google/generative-ai package is required. Install it with: npm install @google/generative-ai — or pass the module directly via the geminiModule option.',\n      );\n    }\n\n    const GoogleGenAI = mod.GoogleGenerativeAI as new (\n      apiKey: string,\n    ) => unknown;\n    this._client = new GoogleGenAI(options.apiKey ?? '');\n  }\n\n  async generateContent(\n    model: string,\n    params: Record<string, unknown>,\n  ): Promise<unknown> {\n    const clientObj = this._client as Record<string, unknown>;\n    const getModel = clientObj.getGenerativeModel as (\n      opts: Record<string, unknown>,\n    ) => Record<string, unknown>;\n    const genModel = getModel.call(this._client, { model });\n    const generateFn = genModel.generateContent as (\n      ...args: unknown[]\n    ) => Promise<unknown>;\n\n    const startTime = performance.now();\n\n    try {\n      const response = await generateFn.call(genModel, params);\n      const latencyMs = performance.now() - startTime;\n\n      const extracted = extractGeminiResponse(response);\n      let costUsd: number | null = null;\n      if (extracted.inputTokens != null && extracted.outputTokens != null) {\n        try {\n          costUsd = calculateCost({\n            modelName: model,\n            inputTokens: extracted.inputTokens,\n            outputTokens: extracted.outputTokens,\n          });\n        } catch {\n          // cost calculation is best-effort\n        }\n      }\n\n      const ctx = applySessionContext();\n      this._track({\n        userId: ctx.userId ?? 'unknown',\n        modelName: model,\n        provider: 'gemini',\n        responseContent: extracted.text,\n        latencyMs,\n        sessionId: ctx.sessionId,\n        traceId: ctx.traceId,\n        turnId: ctx.turnId ?? undefined,\n        agentId: ctx.agentId,\n        env: ctx.env,\n        inputTokens: extracted.inputTokens,\n        outputTokens: extracted.outputTokens,\n        totalTokens: extracted.totalTokens,\n        totalCostUsd: costUsd,\n        finishReason: extracted.finishReason,\n        toolCalls: extracted.functionCalls?.length\n          ? extracted.functionCalls\n          : undefined,\n        systemPrompt: extractGeminiSystemPrompt(params),\n        temperature: extractGeminiTemperature(params),\n        topP: extractGeminiTopP(params),\n        maxOutputTokens: extractGeminiMaxOutputTokens(params),\n        isStreaming: false,\n      });\n\n      return response;\n    } catch (error) {\n      const latencyMs = performance.now() - startTime;\n      const ctx = applySessionContext();\n\n      this._track({\n        userId: ctx.userId ?? 'unknown',\n        modelName: model,\n        provider: 'gemini',\n        responseContent: '',\n        latencyMs,\n        sessionId: ctx.sessionId,\n        traceId: ctx.traceId,\n        agentId: ctx.agentId,\n        env: ctx.env,\n        isError: true,\n        errorMessage: error instanceof Error ? error.message : String(error),\n      });\n\n      throw error;\n    }\n  }\n\n  async generateContentStream(\n    model: string,\n    params: Record<string, unknown>,\n  ): Promise<unknown> {\n    const ctx = applySessionContext();\n    const startTime = performance.now();\n    try {\n      const clientObj = this._client as Record<string, unknown>;\n      const getModel = clientObj.getGenerativeModel as (\n        opts: Record<string, unknown>,\n      ) => Record<string, unknown>;\n      const genModel = getModel.call(this._client, { model });\n      const streamFn = genModel.generateContentStream as\n        | ((...args: unknown[]) => Promise<unknown>)\n        | undefined;\n      if (typeof streamFn !== 'function') {\n        throw new Error('Gemini SDK does not expose generateContentStream');\n      }\n\n      const response = await streamFn.call(genModel, params);\n      const streamResponse = response as Record<string, unknown>;\n      const stream = streamResponse.stream as\n        | AsyncIterable<unknown>\n        | undefined;\n      const finalResponse = streamResponse.response as\n        | Promise<unknown>\n        | undefined;\n\n      if (!_isAsyncIterable(stream)) {\n        throw new Error('Gemini stream response is not AsyncIterable');\n      }\n\n      return {\n        ...streamResponse,\n        stream: this._wrapStream(model, params, stream, finalResponse),\n      };\n    } catch (error) {\n      this._track({\n        userId: ctx.userId ?? 'unknown',\n        modelName: model,\n        provider: 'gemini',\n        responseContent: '',\n        latencyMs: performance.now() - startTime,\n        sessionId: ctx.sessionId,\n        traceId: ctx.traceId,\n        agentId: ctx.agentId,\n        env: ctx.env,\n        isError: true,\n        errorMessage: error instanceof Error ? error.message : String(error),\n        isStreaming: true,\n      });\n      throw error;\n    }\n  }\n\n  get client(): unknown {\n    return this._client;\n  }\n\n  private async *_wrapStream(\n    model: string,\n    params: Record<string, unknown>,\n    stream: AsyncIterable<unknown>,\n    finalResponse?: Promise<unknown>,\n  ): AsyncGenerator<unknown> {\n    const accumulator = new StreamingAccumulator();\n    const ctx = applySessionContext();\n\n    try {\n      for await (const chunk of stream) {\n        const extracted = extractGeminiResponse(chunk);\n        if (extracted.text) accumulator.addContent(extracted.text);\n        if (Array.isArray(extracted.functionCalls)) {\n          for (const fc of extracted.functionCalls) accumulator.addToolCall(fc);\n        }\n        if (extracted.finishReason != null) {\n          accumulator.finishReason = String(extracted.finishReason);\n        }\n        accumulator.setUsage({\n          inputTokens: extracted.inputTokens,\n          outputTokens: extracted.outputTokens,\n          totalTokens: extracted.totalTokens,\n        });\n        yield chunk;\n      }\n    } catch (error) {\n      accumulator.setError(\n        error instanceof Error ? error.message : String(error),\n      );\n      throw error;\n    } finally {\n      if (finalResponse != null) {\n        try {\n          const extractedFinal = extractGeminiResponse(await finalResponse);\n          accumulator.setUsage({\n            inputTokens: extractedFinal.inputTokens,\n            outputTokens: extractedFinal.outputTokens,\n            totalTokens: extractedFinal.totalTokens,\n          });\n          if (extractedFinal.finishReason != null) {\n            accumulator.finishReason = String(extractedFinal.finishReason);\n          }\n          if (Array.isArray(extractedFinal.functionCalls)) {\n            for (const fc of extractedFinal.functionCalls) {\n              accumulator.addToolCall(fc);\n            }\n          }\n        } catch {\n          // best-effort final response extraction\n        }\n      }\n\n      const state = accumulator.getState();\n      let costUsd: number | null = null;\n      if (state.inputTokens != null && state.outputTokens != null) {\n        try {\n          costUsd = calculateCost({\n            modelName: model,\n            inputTokens: state.inputTokens,\n            outputTokens: state.outputTokens,\n          });\n        } catch {\n          // cost calculation is best-effort\n        }\n      }\n\n      this._track({\n        userId: ctx.userId ?? 'unknown',\n        modelName: model,\n        provider: 'gemini',\n        responseContent: state.content,\n        latencyMs: accumulator.elapsedMs,\n        sessionId: ctx.sessionId,\n        traceId: ctx.traceId,\n        turnId: ctx.turnId ?? undefined,\n        agentId: ctx.agentId,\n        env: ctx.env,\n        inputTokens: state.inputTokens,\n        outputTokens: state.outputTokens,\n        totalTokens: state.totalTokens,\n        totalCostUsd: costUsd,\n        finishReason: state.finishReason,\n        toolCalls: state.toolCalls.length > 0 ? state.toolCalls : undefined,\n        systemPrompt: extractGeminiSystemPrompt(params),\n        temperature: extractGeminiTemperature(params),\n        topP: extractGeminiTopP(params),\n        maxOutputTokens: extractGeminiMaxOutputTokens(params),\n        providerTtfbMs: state.ttfbMs,\n        isStreaming: true,\n        isError: state.isError,\n        errorMessage: state.errorMessage,\n      });\n    }\n  }\n}\n\nexport function extractGeminiResponse(response: unknown): {\n  text: string;\n  inputTokens?: number;\n  outputTokens?: number;\n  totalTokens?: number;\n  finishReason?: string;\n  functionCalls?: Array<Record<string, unknown>>;\n} {\n  const resp = response as GeminiResponse;\n  const respObj = resp.response ?? resp;\n  let text = '';\n  if (typeof respObj.text === 'function') {\n    try {\n      text = String(respObj.text());\n    } catch {\n      // text() throws when the response has no candidates (e.g. safety block)\n    }\n  }\n  const usage = respObj.usageMetadata;\n\n  const candidate = respObj.candidates?.[0];\n  const finishReason = candidate?.finishReason;\n\n  const parts = candidate?.content?.parts;\n  const functionCalls = parts\n    ?.filter((p) => p.functionCall != null)\n    .map((p) => p.functionCall as Record<string, unknown>);\n\n  return {\n    text,\n    inputTokens: usage?.promptTokenCount,\n    outputTokens: usage?.candidatesTokenCount,\n    totalTokens: usage?.totalTokenCount,\n    finishReason,\n    functionCalls: functionCalls?.length ? functionCalls : undefined,\n  };\n}\n\nfunction extractGeminiSystemPrompt(\n  params: Record<string, unknown>,\n): string | undefined {\n  const systemInstruction =\n    (params.systemInstruction as string | undefined) ??\n    ((params.generationConfig as Record<string, unknown> | undefined)\n      ?.systemInstruction as string | undefined);\n  return systemInstruction;\n}\n\nfunction extractGeminiTemperature(\n  params: Record<string, unknown>,\n): number | undefined {\n  return (params.generationConfig as Record<string, unknown> | undefined)\n    ?.temperature as number | undefined;\n}\n\nfunction extractGeminiTopP(\n  params: Record<string, unknown>,\n): number | undefined {\n  return (params.generationConfig as Record<string, unknown> | undefined)\n    ?.topP as number | undefined;\n}\n\nfunction extractGeminiMaxOutputTokens(\n  params: Record<string, unknown>,\n): number | undefined {\n  return (params.generationConfig as Record<string, unknown> | undefined)\n    ?.maxOutputTokens as number | undefined;\n}\n\nfunction _isAsyncIterable(value: unknown): value is AsyncIterable<unknown> {\n  return (\n    value != null &&\n    typeof (value as Record<symbol, unknown>)[Symbol.asyncIterator] ===\n      'function'\n  );\n}\n"],"mappings":"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"}

package/dist/providers/mistral.d.ts

@@ -0,0 +1,32 @@
+import { PrivacyConfig } from "../core/privacy.js";
+import { AmplitudeOrAI, TrackFn } from "../types.js";
+import { BaseAIProvider } from "./base.js";
+
+//#region src/providers/mistral.d.ts
+
+declare const MISTRAL_AVAILABLE: boolean;
+declare const _MistralModule: Record<string, unknown> | null;
+interface MistralOptions {
+  amplitude: AmplitudeOrAI;
+  apiKey?: string;
+  privacyConfig?: PrivacyConfig | null;
+  /** Pass the `@mistralai/mistralai` module directly to bypass `tryRequire` (required in bundler environments). */
+  mistralModule?: unknown;
+}
+declare class Mistral extends BaseAIProvider {
+  private _client;
+  readonly chat: WrappedChat;
+  constructor(options: MistralOptions);
+  get client(): unknown;
+}
+declare class WrappedChat {
+  private _client;
+  private _trackFn;
+  constructor(client: unknown, trackFn: TrackFn);
+  complete(params: Record<string, unknown>): Promise<unknown>;
+  stream(params: Record<string, unknown>): Promise<unknown>;
+  private _wrapStream;
+}
+//#endregion
+export { MISTRAL_AVAILABLE, Mistral, MistralOptions, WrappedChat, _MistralModule };
+//# sourceMappingURL=mistral.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mistral.d.ts","names":[],"sources":["../../src/providers/mistral.ts"],"sourcesContent":[],"mappings":";;;;;;AAaM,cADO,iBACS,EAAM,OAAA;AAI5B,cAJM,cAIyB,EAJT,MAKT,CAAA,MAAA,EAAA,OAEK,CAAA,GAAA,IAAA;AAOD,UAVA,cAAA,CAUA;EAEM,SAAA,EAXV,aAWU;EAJM,MAAA,CAAA,EAAA,MAAA;EAAc,aAAA,CAAA,EALzB,aAKyB,GAAA,IAAA;EAoC9B;EAI2B,aAAA,CAAA,EAAA,OAAA;;AAQW,cAhDtC,OAAA,SAAgB,cAAA,CAgDsB;EA2F5B,QAAA,OAAA;EAA0B,SAAA,IAAA,EAzIhC,WAyIgC;EAAO,WAAA,CAAA,OAAA,EAvIjC,cAuIiC;;;cAvG3C,WAAA;;;wCAI2B;mBAQf,0BAA0B;iBA2F5B,0BAA0B"}

package/dist/providers/mistral.js

@@ -0,0 +1,218 @@
+import { tryRequire } from "../utils/resolve-module.js";
+import { calculateCost } from "../utils/costs.js";
+import { StreamingAccumulator } from "../utils/streaming.js";
+import { BaseAIProvider, applySessionContext } from "./base.js";
+
+//#region src/providers/mistral.ts
+const _resolved = tryRequire("@mistralai/mistralai");
+const MISTRAL_AVAILABLE = _resolved != null;
+const _MistralModule = _resolved;
+var Mistral = class extends BaseAIProvider {
+	_client;
+	chat;
+	constructor(options) {
+		super({
+			amplitude: options.amplitude,
+			privacyConfig: options.privacyConfig,
+			providerName: "mistral"
+		});
+		const mod = options.mistralModule ?? _MistralModule;
+		if (mod == null) throw new Error("@mistralai/mistralai package is required. Install it with: npm install @mistralai/mistralai — or pass the module directly via the mistralModule option.");
+		const MistralSDK = mod.Mistral ?? mod.MistralClient ?? mod.default;
+		const clientOpts = {};
+		if (options.apiKey) clientOpts.apiKey = options.apiKey;
+		this._client = new MistralSDK(clientOpts);
+		this.chat = new WrappedChat(this._client, this.trackFn());
+	}
+	get client() {
+		return this._client;
+	}
+};
+var WrappedChat = class {
+	_client;
+	_trackFn;
+	constructor(client, trackFn) {
+		this._client = client;
+		this._trackFn = typeof trackFn === "function" ? trackFn : trackFn.trackFn();
+	}
+	async complete(params) {
+		const chat = this._client.chat;
+		const completeFn = chat.complete;
+		const startTime = performance.now();
+		const ctx = applySessionContext();
+		try {
+			const response = await completeFn.call(chat, params);
+			if ((params.stream === true || chat.stream != null) && _isAsyncIterable(response)) return this._wrapStream(response, params, ctx);
+			const latencyMs = performance.now() - startTime;
+			const resp = response;
+			const choice = resp.choices?.[0];
+			const usage = resp.usage;
+			const modelName = String(resp.model ?? params.model ?? "unknown");
+			const toolCalls = (choice?.message)?.tool_calls;
+			let costUsd = null;
+			if (usage?.prompt_tokens != null && usage?.completion_tokens != null) try {
+				costUsd = calculateCost({
+					modelName,
+					inputTokens: usage.prompt_tokens,
+					outputTokens: usage.completion_tokens
+				});
+			} catch {}
+			this._trackFn({
+				userId: ctx.userId ?? "unknown",
+				modelName,
+				provider: "mistral",
+				responseContent: extractMistralContent(choice?.message?.content),
+				latencyMs,
+				sessionId: ctx.sessionId,
+				traceId: ctx.traceId,
+				turnId: ctx.turnId ?? void 0,
+				agentId: ctx.agentId,
+				env: ctx.env,
+				inputTokens: usage?.prompt_tokens,
+				outputTokens: usage?.completion_tokens,
+				totalTokens: usage?.total_tokens,
+				totalCostUsd: costUsd,
+				finishReason: choice?.finish_reason,
+				toolCalls: toolCalls ?? void 0,
+				systemPrompt: extractMistralSystemPrompt(params),
+				temperature: params.temperature,
+				topP: params.top_p,
+				maxOutputTokens: params.max_tokens,
+				isStreaming: false
+			});
+			return response;
+		} catch (error) {
+			const latencyMs = performance.now() - startTime;
+			this._trackFn({
+				userId: ctx.userId ?? "unknown",
+				modelName: String(params.model ?? "unknown"),
+				provider: "mistral",
+				responseContent: "",
+				latencyMs,
+				sessionId: ctx.sessionId,
+				traceId: ctx.traceId,
+				agentId: ctx.agentId,
+				env: ctx.env,
+				isError: true,
+				errorMessage: error instanceof Error ? error.message : String(error)
+			});
+			throw error;
+		}
+	}
+	async stream(params) {
+		const ctx = applySessionContext();
+		const startTime = performance.now();
+		try {
+			const chat = this._client.chat;
+			const streamFn = chat.stream;
+			if (typeof streamFn !== "function") throw new Error("Mistral SDK does not expose chat.stream");
+			const response = await streamFn.call(chat, params);
+			if (!_isAsyncIterable(response)) throw new Error("Mistral stream response is not AsyncIterable");
+			return this._wrapStream(response, params, ctx);
+		} catch (error) {
+			this._trackFn({
+				userId: ctx.userId ?? "unknown",
+				modelName: String(params.model ?? "unknown"),
+				provider: "mistral",
+				responseContent: "",
+				latencyMs: performance.now() - startTime,
+				sessionId: ctx.sessionId,
+				traceId: ctx.traceId,
+				agentId: ctx.agentId,
+				env: ctx.env,
+				isError: true,
+				errorMessage: error instanceof Error ? error.message : String(error),
+				isStreaming: true
+			});
+			throw error;
+		}
+	}
+	async *_wrapStream(stream, params, sessionCtx) {
+		const accumulator = new StreamingAccumulator();
+		accumulator.model = String(params.model ?? "unknown");
+		try {
+			for await (const chunk of stream) {
+				const c = chunk;
+				const choices = c.choices;
+				const delta = choices?.[0]?.delta;
+				const message = choices?.[0]?.message;
+				const content = delta?.content ?? message?.content;
+				if (typeof content === "string" && content.length > 0) accumulator.addContent(content);
+				const toolCalls = delta?.tool_calls ?? message?.tool_calls;
+				if (Array.isArray(toolCalls)) for (const call of toolCalls) accumulator.addToolCall(call);
+				const finishReason = choices?.[0]?.finish_reason;
+				if (finishReason != null) accumulator.finishReason = String(finishReason);
+				const usage = c.usage;
+				accumulator.setUsage({
+					inputTokens: usage?.prompt_tokens,
+					outputTokens: usage?.completion_tokens,
+					totalTokens: usage?.total_tokens
+				});
+				yield chunk;
+			}
+		} catch (error) {
+			accumulator.setError(error instanceof Error ? error.message : String(error));
+			throw error;
+		} finally {
+			const state = accumulator.getState();
+			const modelName = String(accumulator.model ?? params.model ?? "unknown");
+			let costUsd = null;
+			if (state.inputTokens != null && state.outputTokens != null) try {
+				costUsd = calculateCost({
+					modelName,
+					inputTokens: state.inputTokens,
+					outputTokens: state.outputTokens
+				});
+			} catch {}
+			this._trackFn({
+				userId: sessionCtx.userId ?? "unknown",
+				modelName,
+				provider: "mistral",
+				responseContent: state.content,
+				latencyMs: accumulator.elapsedMs,
+				sessionId: sessionCtx.sessionId,
+				traceId: sessionCtx.traceId,
+				turnId: sessionCtx.turnId ?? void 0,
+				agentId: sessionCtx.agentId,
+				env: sessionCtx.env,
+				inputTokens: state.inputTokens,
+				outputTokens: state.outputTokens,
+				totalTokens: state.totalTokens,
+				totalCostUsd: costUsd,
+				finishReason: state.finishReason,
+				toolCalls: state.toolCalls.length > 0 ? state.toolCalls : void 0,
+				systemPrompt: extractMistralSystemPrompt(params),
+				temperature: params.temperature,
+				topP: params.top_p,
+				maxOutputTokens: params.max_tokens,
+				providerTtfbMs: state.ttfbMs,
+				isStreaming: true,
+				isError: state.isError,
+				errorMessage: state.errorMessage
+			});
+		}
+	}
+};
+function extractMistralContent(content) {
+	if (typeof content === "string") return content;
+	if (content == null) return "";
+	if (Array.isArray(content)) return content.map((chunk) => {
+		if (typeof chunk === "string") return chunk;
+		if (typeof chunk === "object" && chunk != null) return String(chunk.text ?? "");
+		return "";
+	}).filter(Boolean).join("");
+	return String(content);
+}
+function extractMistralSystemPrompt(params) {
+	const messages = params.messages;
+	if (!Array.isArray(messages)) return void 0;
+	const systemMessage = messages.find((m) => m.role === "system");
+	return typeof systemMessage?.content === "string" ? systemMessage.content : void 0;
+}
+function _isAsyncIterable(value) {
+	return value != null && typeof value[Symbol.asyncIterator] === "function";
+}
+
+//#endregion
+export { MISTRAL_AVAILABLE, Mistral, WrappedChat, _MistralModule };
+//# sourceMappingURL=mistral.js.map

package/dist/providers/mistral.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mistral.js","names":["_MistralModule: Record<string, unknown> | null","clientOpts: Record<string, unknown>","costUsd: number | null"],"sources":["../../src/providers/mistral.ts"],"sourcesContent":["/**\n * Mistral AI provider wrapper with automatic tracking.\n */\n\nimport type { PrivacyConfig } from '../core/privacy.js';\nimport type { AmplitudeOrAI, MistralChatResponse, TrackFn } from '../types.js';\nimport { calculateCost } from '../utils/costs.js';\nimport { tryRequire } from '../utils/resolve-module.js';\nimport { StreamingAccumulator } from '../utils/streaming.js';\nimport { applySessionContext, BaseAIProvider } from './base.js';\n\nconst _resolved = tryRequire('@mistralai/mistralai');\nexport const MISTRAL_AVAILABLE = _resolved != null;\nconst _MistralModule: Record<string, unknown> | null = _resolved;\n\nexport { _MistralModule };\n\nexport interface MistralOptions {\n  amplitude: AmplitudeOrAI;\n  apiKey?: string;\n  privacyConfig?: PrivacyConfig | null;\n  /** Pass the `@mistralai/mistralai` module directly to bypass `tryRequire` (required in bundler environments). */\n  mistralModule?: unknown;\n}\n\nexport class Mistral extends BaseAIProvider {\n  private _client: unknown;\n  readonly chat: WrappedChat;\n\n  constructor(options: MistralOptions) {\n    super({\n      amplitude: options.amplitude,\n      privacyConfig: options.privacyConfig,\n      providerName: 'mistral',\n    });\n\n    const mod =\n      (options.mistralModule as Record<string, unknown> | null) ??\n      _MistralModule;\n    if (mod == null) {\n      throw new Error(\n        '@mistralai/mistralai package is required. Install it with: npm install @mistralai/mistralai — or pass the module directly via the mistralModule option.',\n      );\n    }\n\n    const MistralSDK = (mod.Mistral ??\n      mod.MistralClient ??\n      mod.default) as new (opts: Record<string, unknown>) => unknown;\n\n    const clientOpts: Record<string, unknown> = {};\n    if (options.apiKey) clientOpts.apiKey = options.apiKey;\n\n    this._client = new MistralSDK(clientOpts);\n    this.chat = new WrappedChat(this._client, this.trackFn());\n  }\n\n  get client(): unknown {\n    return this._client;\n  }\n}\n\nexport class WrappedChat {\n  private _client: unknown;\n  private _trackFn: TrackFn;\n\n  constructor(client: unknown, trackFn: TrackFn) {\n    this._client = client;\n    this._trackFn =\n      typeof trackFn === 'function'\n        ? trackFn\n        : (trackFn as unknown as { trackFn(): TrackFn }).trackFn();\n  }\n\n  async complete(params: Record<string, unknown>): Promise<unknown> {\n    const clientObj = this._client as Record<string, unknown>;\n    const chat = clientObj.chat as Record<string, unknown>;\n    const completeFn = chat.complete as (\n      ...args: unknown[]\n    ) => Promise<unknown>;\n\n    const startTime = performance.now();\n    const ctx = applySessionContext();\n\n    try {\n      const response = await completeFn.call(chat, params);\n      if (\n        (params.stream === true || chat.stream != null) &&\n        _isAsyncIterable(response)\n      ) {\n        return this._wrapStream(\n          response as AsyncIterable<unknown>,\n          params,\n          ctx,\n        );\n      }\n      const latencyMs = performance.now() - startTime;\n\n      const resp = response as MistralChatResponse;\n      const choice = resp.choices?.[0];\n      const usage = resp.usage;\n      const modelName = String(resp.model ?? params.model ?? 'unknown');\n      const toolCalls = (\n        choice?.message as { tool_calls?: Array<Record<string, unknown>> }\n      )?.tool_calls;\n\n      let costUsd: number | null = null;\n      if (usage?.prompt_tokens != null && usage?.completion_tokens != null) {\n        try {\n          costUsd = calculateCost({\n            modelName,\n            inputTokens: usage.prompt_tokens,\n            outputTokens: usage.completion_tokens,\n          });\n        } catch {\n          // cost calculation is best-effort\n        }\n      }\n\n      this._trackFn({\n        userId: ctx.userId ?? 'unknown',\n        modelName,\n        provider: 'mistral',\n        responseContent: extractMistralContent(choice?.message?.content),\n        latencyMs,\n        sessionId: ctx.sessionId,\n        traceId: ctx.traceId,\n        turnId: ctx.turnId ?? undefined,\n        agentId: ctx.agentId,\n        env: ctx.env,\n        inputTokens: usage?.prompt_tokens,\n        outputTokens: usage?.completion_tokens,\n        totalTokens: usage?.total_tokens,\n        totalCostUsd: costUsd,\n        finishReason: choice?.finish_reason,\n        toolCalls: toolCalls ?? undefined,\n        systemPrompt: extractMistralSystemPrompt(params),\n        temperature: params.temperature as number | undefined,\n        topP: params.top_p as number | undefined,\n        maxOutputTokens: params.max_tokens as number | undefined,\n        isStreaming: false,\n      });\n\n      return response;\n    } catch (error) {\n      const latencyMs = performance.now() - startTime;\n\n      this._trackFn({\n        userId: ctx.userId ?? 'unknown',\n        modelName: String(params.model ?? 'unknown'),\n        provider: 'mistral',\n        responseContent: '',\n        latencyMs,\n        sessionId: ctx.sessionId,\n        traceId: ctx.traceId,\n        agentId: ctx.agentId,\n        env: ctx.env,\n        isError: true,\n        errorMessage: error instanceof Error ? error.message : String(error),\n      });\n\n      throw error;\n    }\n  }\n\n  async stream(params: Record<string, unknown>): Promise<unknown> {\n    const ctx = applySessionContext();\n    const startTime = performance.now();\n    try {\n      const clientObj = this._client as Record<string, unknown>;\n      const chat = clientObj.chat as Record<string, unknown>;\n      const streamFn = chat.stream as\n        | ((...args: unknown[]) => Promise<unknown>)\n        | undefined;\n      if (typeof streamFn !== 'function') {\n        throw new Error('Mistral SDK does not expose chat.stream');\n      }\n\n      const response = await streamFn.call(chat, params);\n      if (!_isAsyncIterable(response)) {\n        throw new Error('Mistral stream response is not AsyncIterable');\n      }\n      return this._wrapStream(response as AsyncIterable<unknown>, params, ctx);\n    } catch (error) {\n      this._trackFn({\n        userId: ctx.userId ?? 'unknown',\n        modelName: String(params.model ?? 'unknown'),\n        provider: 'mistral',\n        responseContent: '',\n        latencyMs: performance.now() - startTime,\n        sessionId: ctx.sessionId,\n        traceId: ctx.traceId,\n        agentId: ctx.agentId,\n        env: ctx.env,\n        isError: true,\n        errorMessage: error instanceof Error ? error.message : String(error),\n        isStreaming: true,\n      });\n      throw error;\n    }\n  }\n\n  private async *_wrapStream(\n    stream: AsyncIterable<unknown>,\n    params: Record<string, unknown>,\n    sessionCtx: ReturnType<typeof applySessionContext>,\n  ): AsyncGenerator<unknown> {\n    const accumulator = new StreamingAccumulator();\n    accumulator.model = String(params.model ?? 'unknown');\n\n    try {\n      for await (const chunk of stream) {\n        const c = chunk as Record<string, unknown>;\n        const choices = c.choices as Array<Record<string, unknown>> | undefined;\n        const delta = choices?.[0]?.delta as\n          | Record<string, unknown>\n          | undefined;\n        const message = choices?.[0]?.message as\n          | Record<string, unknown>\n          | undefined;\n\n        const content =\n          (delta?.content as string | undefined) ??\n          (message?.content as string | undefined);\n        if (typeof content === 'string' && content.length > 0) {\n          accumulator.addContent(content);\n        }\n\n        const toolCalls =\n          (delta?.tool_calls as Array<Record<string, unknown>> | undefined) ??\n          (message?.tool_calls as Array<Record<string, unknown>> | undefined);\n        if (Array.isArray(toolCalls)) {\n          for (const call of toolCalls) accumulator.addToolCall(call);\n        }\n\n        const finishReason = choices?.[0]?.finish_reason;\n        if (finishReason != null)\n          accumulator.finishReason = String(finishReason);\n\n        const usage = c.usage as Record<string, unknown> | undefined;\n        accumulator.setUsage({\n          inputTokens: usage?.prompt_tokens as number | undefined,\n          outputTokens: usage?.completion_tokens as number | undefined,\n          totalTokens: usage?.total_tokens as number | undefined,\n        });\n\n        yield chunk;\n      }\n    } catch (error) {\n      accumulator.setError(\n        error instanceof Error ? error.message : String(error),\n      );\n      throw error;\n    } finally {\n      const state = accumulator.getState();\n      const modelName = String(accumulator.model ?? params.model ?? 'unknown');\n      let costUsd: number | null = null;\n      if (state.inputTokens != null && state.outputTokens != null) {\n        try {\n          costUsd = calculateCost({\n            modelName,\n            inputTokens: state.inputTokens,\n            outputTokens: state.outputTokens,\n          });\n        } catch {\n          // cost calculation is best-effort\n        }\n      }\n\n      this._trackFn({\n        userId: sessionCtx.userId ?? 'unknown',\n        modelName,\n        provider: 'mistral',\n        responseContent: state.content,\n        latencyMs: accumulator.elapsedMs,\n        sessionId: sessionCtx.sessionId,\n        traceId: sessionCtx.traceId,\n        turnId: sessionCtx.turnId ?? undefined,\n        agentId: sessionCtx.agentId,\n        env: sessionCtx.env,\n        inputTokens: state.inputTokens,\n        outputTokens: state.outputTokens,\n        totalTokens: state.totalTokens,\n        totalCostUsd: costUsd,\n        finishReason: state.finishReason,\n        toolCalls: state.toolCalls.length > 0 ? state.toolCalls : undefined,\n        systemPrompt: extractMistralSystemPrompt(params),\n        temperature: params.temperature as number | undefined,\n        topP: params.top_p as number | undefined,\n        maxOutputTokens: params.max_tokens as number | undefined,\n        providerTtfbMs: state.ttfbMs,\n        isStreaming: true,\n        isError: state.isError,\n        errorMessage: state.errorMessage,\n      });\n    }\n  }\n}\n\nfunction extractMistralContent(content: unknown): string {\n  if (typeof content === 'string') return content;\n  if (content == null) return '';\n  if (Array.isArray(content)) {\n    return content\n      .map((chunk) => {\n        if (typeof chunk === 'string') return chunk;\n        if (typeof chunk === 'object' && chunk != null) {\n          return String((chunk as Record<string, unknown>).text ?? '');\n        }\n        return '';\n      })\n      .filter(Boolean)\n      .join('');\n  }\n  return String(content);\n}\n\nfunction extractMistralSystemPrompt(\n  params: Record<string, unknown>,\n): string | undefined {\n  const messages = params.messages as\n    | Array<Record<string, unknown>>\n    | undefined;\n  if (!Array.isArray(messages)) return undefined;\n  const systemMessage = messages.find((m) => m.role === 'system');\n  return typeof systemMessage?.content === 'string'\n    ? systemMessage.content\n    : undefined;\n}\n\nfunction _isAsyncIterable(value: unknown): value is AsyncIterable<unknown> {\n  return (\n    value != null &&\n    typeof (value as Record<symbol, unknown>)[Symbol.asyncIterator] ===\n      'function'\n  );\n}\n"],"mappings":"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"}

package/dist/providers/openai.d.ts

@@ -0,0 +1,61 @@
+import { PrivacyConfig } from "../core/privacy.js";
+import { AmplitudeLike, AmplitudeOrAI, ChatCompletionResponse, OpenAIResponse, TrackFn } from "../types.js";
+import { BaseAIProvider, ProviderTrackOptions } from "./base.js";
+
+//#region src/providers/openai.d.ts
+
+declare const OPENAI_AVAILABLE: boolean;
+declare const _OpenAIModule: Record<string, unknown> | null;
+interface OpenAIOptions {
+  amplitude: AmplitudeOrAI;
+  apiKey?: string;
+  baseUrl?: string;
+  privacyConfig?: PrivacyConfig | null;
+  propagateContext?: boolean;
+  /** Pass the `openai` module directly to bypass `tryRequire` (required in bundler environments). */
+  openaiModule?: unknown;
+}
+declare class OpenAI<TClient extends Record<string, unknown> = Record<string, unknown>> extends BaseAIProvider {
+  private _client;
+  readonly chat: WrappedChat;
+  readonly responses: WrappedResponses;
+  private _propagateContext;
+  constructor(options: OpenAIOptions);
+  get client(): TClient;
+}
+declare class WrappedChat {
+  readonly completions: WrappedCompletions;
+  constructor(client: unknown, trackFn: TrackFn, amplitude: AmplitudeLike, privacyConfig: PrivacyConfig | null, propagateContext: boolean);
+}
+declare class WrappedCompletions {
+  _original: Record<string, unknown>;
+  private _trackFn;
+  private _amplitude;
+  private _privacyConfig;
+  private _propagateContext;
+  private _providerName;
+  constructor(completions: Record<string, unknown>, trackFn: TrackFn, amplitude: AmplitudeLike, privacyConfig: PrivacyConfig | null, propagateContext: boolean, providerName?: string);
+  create(params: Record<string, unknown>, amplitudeOverrides?: ProviderTrackOptions): Promise<ChatCompletionResponse | AsyncIterable<unknown>>;
+  parse(params: Record<string, unknown>, amplitudeOverrides?: ProviderTrackOptions): Promise<ChatCompletionResponse | AsyncIterable<unknown>>;
+  private _wrapStream;
+  private _withContextHeaders;
+  private _trackInputMessages;
+}
+declare class WrappedResponses {
+  _original: Record<string, unknown>;
+  private _trackFn;
+  private _amplitude;
+  private _privacyConfig;
+  private _propagateContext;
+  private _providerName;
+  constructor(client: unknown, trackFn: TrackFn, amplitude: AmplitudeLike, privacyConfig: PrivacyConfig | null, propagateContext: boolean, providerName?: string);
+  create(params: Record<string, unknown>, amplitudeOverrides?: ProviderTrackOptions): Promise<OpenAIResponse | AsyncIterable<unknown>>;
+  stream(params: Record<string, unknown>, amplitudeOverrides?: ProviderTrackOptions): Promise<AsyncIterable<unknown>>;
+  private _wrapStream;
+  private _withContextHeaders;
+  private _trackInputMessages;
+}
+declare function extractSystemPrompt(params: Record<string, unknown>): string | undefined;
+//#endregion
+export { OPENAI_AVAILABLE, OpenAI, OpenAIOptions, WrappedChat, WrappedCompletions, WrappedResponses, _OpenAIModule, extractSystemPrompt };
+//# sourceMappingURL=openai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","names":[],"sources":["../../src/providers/openai.ts"],"sourcesContent":[],"mappings":";;;;;;AAmDiB,cAnBJ,gBAmBI,EAAA,OAAA;cAlBX,aAmBgB,EAnBD,MAmBC,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,IAAA;AA6CN,UA5DC,aAAA,CA4DD;EAhDN,SAAA,EAXG,aAWH;EAAc,MAAA,CAAA,EAAA,MAAA;EAqDX,OAAA,CAAA,EAAA,MAAW;EACA,aAAA,CAAA,EA9DN,aA8DM,GAAA,IAAA;EAIX,gBAAA,CAAA,EAAA,OAAA;EACE;EACI,YAAA,CAAA,EAAA,OAAA;;AAeN,cA7EA,MA6EkB,CAAA,gBA5Eb,MA4Ea,CAAA,MAAA,EAAA,OAAA,CAAA,GA5Ea,MA4Eb,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,SA3ErB,cAAA,CA2EqB;EAClB,QAAA,OAAA;EAQI,SAAA,IAAA,EAlFA,WAkFA;EACJ,SAAA,SAAA,EAlFS,gBAkFT;EACE,QAAA,iBAAA;EACI,WAAA,CAAA,OAAA,EAjFI,aAiFJ;EAgBP,IAAA,MAAA,CAAA,CAAA,EAvDI,OAuDJ;;AAEC,cApDA,WAAA,CAoDA;EAAyB,SAAA,WAAA,EAnDd,kBAmDc;EAAjC,WAAA,CAAA,MAAA,EAAA,OAAA,EAAA,OAAA,EA/CQ,OA+CR,EAAA,SAAA,EA9CU,aA8CV,EAAA,aAAA,EA7Cc,aA6Cd,GAAA,IAAA,EAAA,gBAAA,EAAA,OAAA;;AAkHoB,cAhJZ,kBAAA,CAgJY;EACZ,SAAA,EAhJA,MAgJA,CAAA,MAAA,EAAA,OAAA,CAAA;EAAyB,QAAA,QAAA;EAAjC,QAAA,UAAA;EAAO,QAAA,cAAA;EAgLC,QAAA,iBAAgB;EAChB,QAAA,aAAA;EASA,WAAA,CAAA,WAAA,EAlUI,MAkUJ,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,OAAA,EAjUA,OAiUA,EAAA,SAAA,EAhUE,aAgUF,EAAA,aAAA,EA/TM,aA+TN,GAAA,IAAA,EAAA,gBAAA,EAAA,OAAA,EAAA,YAAA,CAAA,EAAA,MAAA;EACE,MAAA,CAAA,MAAA,EAhTH,MAgTG,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,kBAAA,CAAA,EA/SU,oBA+SV,CAAA,EA9SV,OA8SU,CA9SF,sBA8SE,GA9SuB,aA8SvB,CAAA,OAAA,CAAA,CAAA;EACI,KAAA,CAAA,MAAA,EA9LP,MA8LO,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,kBAAA,CAAA,EA7LM,oBA6LN,CAAA,EA5Ld,OA4Lc,CA5LN,sBA4LM,GA5LmB,aA4LnB,CAAA,OAAA,CAAA,CAAA;EAkBP,QAAA,WAAA;EACa,QAAA,mBAAA;EACZ,QAAA,mBAAA;;AAAR,cAhCQ,gBAAA,CAgCR;EA2FO,SAAA,EA1HC,MA0HD,CAAA,MAAA,EAAA,OAAA,CAAA;EACa,QAAA,QAAA;EACZ,QAAA,UAAA;EAAR,QAAA,cAAA;EAAO,QAAA,iBAAA;EAoLI,QAAA,aAAA;wCAvSH,oBACE,8BACI;iBAkBP,8CACa,uBACpB,QAAQ,iBAAiB;iBA2FlB,8CACa,uBACpB,QAAQ;;;;;iBAoLG,mBAAA,SACN"}