import {z} from 'zod' export type Function = {name: string, description?: string | undefined, strict?: boolean | undefined, parameters: {[key: string]: unknown}}; export type FunctionTool = {type?: 'function' | undefined, function: Function}; export type ToolConfiguration = {exclude?: (Array | null) | undefined, include?: (Array | null) | undefined, requires_confirmation?: (Array | null) | undefined}; export type WebSearchTool = {tool_configuration?: (ToolConfiguration | null) | undefined, type?: 'web_search' | undefined}; export type WebSearchPremiumTool = {tool_configuration?: (ToolConfiguration | null) | undefined, type?: 'web_search_premium' | undefined}; export type CodeInterpreterTool = {tool_configuration?: (ToolConfiguration | null) | undefined, type?: 'code_interpreter' | undefined}; export type ImageGenerationTool = {tool_configuration?: (ToolConfiguration | null) | undefined, type?: 'image_generation' | undefined}; export type DocumentLibraryTool = {tool_configuration?: (ToolConfiguration | null) | undefined, type?: 'document_library' | undefined, library_ids: Array}; export type OAuth2TokenAuth = {type?: 'oauth2-token' | undefined, value: string}; export type APIKeyAuth = {type?: 'api-key' | undefined, value: string}; export type CustomConnector = {type?: 'connector' | undefined, connector_id: string, authorization?: (OAuth2TokenAuth | APIKeyAuth | null) | undefined, tool_configuration?: (ToolConfiguration | null) | undefined}; export type CompletionArgsStop = string | Array | null; export type Prediction = {type?: 'content' | undefined, content?: string | undefined}; export type ResponseFormats = 'text' | 'json_object' | 'json_schema'; export type JsonSchema = {name: string, description?: (string | null) | undefined, schema: {[key: string]: unknown}, strict?: boolean | undefined}; export type ResponseFormat = {type?: ResponseFormats | undefined, json_schema?: (JsonSchema | null) | undefined}; export type ToolChoiceEnum = 'auto' | 'none' | 'any' | 'required'; export type ReasoningEffort = 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'; export type CompletionArgs = {stop?: CompletionArgsStop | undefined, presence_penalty?: (number | null) | undefined, frequency_penalty?: (number | null) | undefined, temperature?: (number | null) | undefined, top_p?: (number | null) | undefined, max_tokens?: (number | null) | undefined, random_seed?: (number | null) | undefined, prediction?: (Prediction | null) | undefined, response_format?: (ResponseFormat | null) | undefined, tool_choice?: ToolChoiceEnum | undefined, reasoning_effort?: (ReasoningEffort | null) | undefined}; export type ModerationLLMV1CategoryThresholds = {sexual?: (number | null) | undefined, hate_and_discrimination?: (number | null) | undefined, violence_and_threats?: (number | null) | undefined, dangerous_and_criminal_content?: (number | null) | undefined, selfharm?: (number | null) | undefined, health?: (number | null) | undefined, financial?: (number | null) | undefined, law?: (number | null) | undefined, pii?: (number | null) | undefined}; export type ModerationLLMAction = 'none' | 'block'; export type ModerationLLMV1Config = {model_name?: string | undefined, custom_category_thresholds?: (ModerationLLMV1CategoryThresholds | null) | undefined, ignore_other_categories?: boolean | undefined, action?: ModerationLLMAction | undefined}; export type ModerationLLMV2CategoryThresholds = {sexual?: (number | null) | undefined, hate_and_discrimination?: (number | null) | undefined, violence_and_threats?: (number | null) | undefined, dangerous?: (number | null) | undefined, criminal?: (number | null) | undefined, selfharm?: (number | null) | undefined, health?: (number | null) | undefined, financial?: (number | null) | undefined, law?: (number | null) | undefined, pii?: (number | null) | undefined, jailbreaking?: (number | null) | undefined}; export type ModerationLLMV2Config = {model_name?: string | undefined, custom_category_thresholds?: (ModerationLLMV2CategoryThresholds | null) | undefined, ignore_other_categories?: boolean | undefined, action?: ModerationLLMAction | undefined}; export type GuardrailConfig = {block_on_error?: boolean | undefined, moderation_llm_v1?: (ModerationLLMV1Config | null) | undefined, moderation_llm_v2?: (ModerationLLMV2Config | null) | undefined}; export type MetadataDict = {[key: string]: unknown}; export type CreateAgentRequest = {instructions?: (string | null) | undefined, tools?: (Array) | undefined, completion_args?: CompletionArgs | undefined, guardrails?: (Array | null) | undefined, model: string, name: string, description?: (string | null) | undefined, handoffs?: (Array | null) | undefined, metadata?: (MetadataDict | null) | undefined, version_message?: (string | null) | undefined}; export type CreateApiV1AgentsArgs = {body: CreateAgentRequest}; export type CreateApiV1AgentsOptions = {baseUrl?: string | undefined, ApiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const function = z.object({name: z.string(), description: z.string().optional(), strict: z.boolean().optional(), parameters: z.record(z.string(), z.unknown())}); export const functionTool = z.object({type: z.literal("function").optional(), function: function}); export const toolConfiguration = z.object({exclude: z.array(z.string()).nullable().optional(), include: z.array(z.string()).nullable().optional(), requires_confirmation: z.array(z.string()).nullable().optional()}); export const webSearchTool = z.object({tool_configuration: toolConfiguration.nullable().optional(), type: z.literal("web_search").optional()}); export const webSearchPremiumTool = z.object({tool_configuration: toolConfiguration.nullable().optional(), type: z.literal("web_search_premium").optional()}); export const codeInterpreterTool = z.object({tool_configuration: toolConfiguration.nullable().optional(), type: z.literal("code_interpreter").optional()}); export const imageGenerationTool = z.object({tool_configuration: toolConfiguration.nullable().optional(), type: z.literal("image_generation").optional()}); export const documentLibraryTool = z.object({tool_configuration: toolConfiguration.nullable().optional(), type: z.literal("document_library").optional(), library_ids: z.array(z.string())}); export const oAuth2TokenAuth = z.object({type: z.literal("oauth2-token").optional(), value: z.string()}); export const aPIKeyAuth = z.object({type: z.literal("api-key").optional(), value: z.string()}); export const customConnector = z.object({type: z.literal("connector").optional(), connector_id: z.string(), authorization: z.union([oAuth2TokenAuth, aPIKeyAuth]).nullable().optional(), tool_configuration: toolConfiguration.nullable().optional()}); export const completionArgsStop = z.union([z.string(), z.array(z.string())]).nullable(); export const prediction = z.object({type: z.literal("content").optional(), content: z.string().optional()}); export const responseFormats = z.enum(["text", "json_object", "json_schema"]); export const jsonSchema = z.object({name: z.string(), description: z.string().nullable().optional(), schema: z.record(z.string(), z.unknown()), strict: z.boolean().optional()}); export const responseFormat = z.object({type: responseFormats.optional(), json_schema: jsonSchema.nullable().optional()}); export const toolChoiceEnum = z.enum(["auto", "none", "any", "required"]); export const reasoningEffort = z.enum(["none", "minimal", "low", "medium", "high", "xhigh"]); export const completionArgs = z.object({stop: completionArgsStop.optional(), presence_penalty: z.number().gte(-2).lte(2).nullable().optional(), frequency_penalty: z.number().gte(-2).lte(2).nullable().optional(), temperature: z.number().gte(0).lte(1).nullable().optional(), top_p: z.number().gte(0).lte(1).nullable().optional(), max_tokens: z.number().int().gte(0).nullable().optional(), random_seed: z.number().int().gte(0).nullable().optional(), prediction: prediction.nullable().optional(), response_format: responseFormat.nullable().optional(), tool_choice: toolChoiceEnum.optional(), reasoning_effort: reasoningEffort.nullable().optional()}); export const moderationLLMV1CategoryThresholds = z.object({sexual: z.number().nullable().optional(), hate_and_discrimination: z.number().nullable().optional(), violence_and_threats: z.number().nullable().optional(), dangerous_and_criminal_content: z.number().nullable().optional(), selfharm: z.number().nullable().optional(), health: z.number().nullable().optional(), financial: z.number().nullable().optional(), law: z.number().nullable().optional(), pii: z.number().nullable().optional()}); export const moderationLLMAction = z.enum(["none", "block"]); export const moderationLLMV1Config = z.object({model_name: z.string().optional(), custom_category_thresholds: moderationLLMV1CategoryThresholds.nullable().optional(), ignore_other_categories: z.boolean().optional(), action: moderationLLMAction.optional()}); export const moderationLLMV2CategoryThresholds = z.object({sexual: z.number().nullable().optional(), hate_and_discrimination: z.number().nullable().optional(), violence_and_threats: z.number().nullable().optional(), dangerous: z.number().nullable().optional(), criminal: z.number().nullable().optional(), selfharm: z.number().nullable().optional(), health: z.number().nullable().optional(), financial: z.number().nullable().optional(), law: z.number().nullable().optional(), pii: z.number().nullable().optional(), jailbreaking: z.number().nullable().optional()}); export const moderationLLMV2Config = z.object({model_name: z.string().optional(), custom_category_thresholds: moderationLLMV2CategoryThresholds.nullable().optional(), ignore_other_categories: z.boolean().optional(), action: moderationLLMAction.optional()}); export const guardrailConfig = z.object({block_on_error: z.boolean().optional(), moderation_llm_v1: moderationLLMV1Config.nullable().optional(), moderation_llm_v2: moderationLLMV2Config.nullable().optional()}); export const metadataDict = z.record(z.string(), z.unknown()); export const agent = z.object({instructions: z.string().nullable().optional(), tools: z.array(z.discriminatedUnion("type", [functionTool, webSearchTool, webSearchPremiumTool, codeInterpreterTool, imageGenerationTool, documentLibraryTool, customConnector])).optional(), completion_args: completionArgs.optional(), guardrails: z.array(guardrailConfig).nullable().optional(), model: z.string(), name: z.string(), description: z.string().nullable().optional(), handoffs: z.array(z.string()).nullable().optional(), metadata: metadataDict.nullable().optional(), object: z.literal("agent").optional(), id: z.string(), version: z.number().int(), versions: z.array(z.number().int()), owner_id: z.string().nullable().optional(), created_at: z.string(), updated_at: z.string(), deployment_chat: z.boolean(), source: z.string(), version_message: z.string().nullable().optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Create a agent that can be used within a conversation. * * POST /v1/agents */ export const createApiV1Agents = async (args: CreateApiV1AgentsArgs, options?: CreateApiV1AgentsOptions) => { const {baseUrl = "https://api.mistral.ai", fetch: fetchFn = fetch, ApiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (ApiKey !== undefined) headers.set('authorization', `Bearer ${ApiKey}`) const url = `${baseUrl.replace(/\/+$/, '')}/v1/agents${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(agent, await res.json()) };