@mistralai/mistralai 2.1.1 → 2.1.2

package/src/funcs/betaConnectorsListTools.ts

@@ -0,0 +1,188 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 76826e0ed19b
+ */
+
+import { MistralCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { MistralError } from "../models/errors/mistralerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * List tools for a connector.
+ *
+ * @remarks
+ * List all tools available for an MCP connector.
+ */
+export function betaConnectorsListTools(
+  client: MistralCore,
+  request: operations.ConnectorListToolsV1Request,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.ResponseConnectorListToolsV12,
+    | errors.HTTPValidationError
+    | MistralError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: MistralCore,
+  request: operations.ConnectorListToolsV1Request,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.ResponseConnectorListToolsV12,
+      | errors.HTTPValidationError
+      | MistralError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.ConnectorListToolsV1Request$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    connector_id_or_name: encodeSimple(
+      "connector_id_or_name",
+      payload.connector_id_or_name,
+      { explode: false, charEncoding: "percent" },
+    ),
+  };
+
+  const path = pathToFunc("/v1/connectors/{connector_id_or_name}/tools")(
+    pathParams,
+  );
+
+  const query = encodeFormQuery({
+    "page": payload.page,
+    "page_size": payload.page_size,
+    "pretty": payload.pretty,
+    "refresh": payload.refresh,
+  });
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "connector_list_tools_v1",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKey,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    query: query,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["422", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    operations.ResponseConnectorListToolsV12,
+    | errors.HTTPValidationError
+    | MistralError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.ResponseConnectorListToolsV12$inboundSchema),
+    M.jsonErr(422, errors.HTTPValidationError$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -60,8 +60,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "2.1.1",
+  sdkVersion: "2.1.2",
   genVersion: "2.859.0",
   userAgent:
-    "speakeasy-sdk/typescript 2.1.1 2.859.0 1.0.0 @mistralai/mistralai",
+    "speakeasy-sdk/typescript 2.1.2 2.859.0 1.0.0 @mistralai/mistralai",
 } as const;

package/src/models/components/index.ts

@@ -195,6 +195,9 @@ export * from "./listjudgesresponse.js";
 export * from "./listlibrariesresponse.js";
 export * from "./listsharingresponse.js";
 export * from "./mcpservericon.js";
+export * from "./mcptool.js";
+export * from "./mcptoolmeta.js";
+export * from "./mcpuitoolmeta.js";
 export * from "./messageentries.js";
 export * from "./messageinputcontentchunks.js";
 export * from "./messageinputentry.js";
@@ -288,11 +291,13 @@ export * from "./textresourcecontents.js";
 export * from "./thinkchunk.js";
 export * from "./timestampgranularity.js";
 export * from "./tool.js";
+export * from "./toolannotations.js";
 export * from "./toolcall.js";
 export * from "./toolcallconfirmation.js";
 export * from "./toolchoice.js";
 export * from "./toolchoiceenum.js";
 export * from "./toolconfiguration.js";
+export * from "./toolexecution.js";
 export * from "./toolexecutiondeltaevent.js";
 export * from "./toolexecutiondoneevent.js";
 export * from "./toolexecutionentry.js";
@@ -300,6 +305,7 @@ export * from "./toolexecutionstartedevent.js";
 export * from "./toolfilechunk.js";
 export * from "./toolmessage.js";
 export * from "./toolreferencechunk.js";
+export * from "./tooltype.js";
 export * from "./tooltypes.js";
 export * from "./trainingfile.js";
 export * from "./transcriptionresponse.js";
@@ -310,6 +316,8 @@ export * from "./transcriptionstreameventtypes.js";
 export * from "./transcriptionstreamlanguage.js";
 export * from "./transcriptionstreamsegmentdelta.js";
 export * from "./transcriptionstreamtextdelta.js";
+export * from "./turbinetoollocale.js";
+export * from "./turbinetoolmeta.js";
 export * from "./unarchivemodelresponse.js";
 export * from "./updateagentrequest.js";
 export * from "./updateconnectorrequest.js";

package/src/models/components/mcptool.ts

@@ -0,0 +1,57 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: eb9603e91876
+ */
+
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { MCPServerIcon, MCPServerIcon$inboundSchema } from "./mcpservericon.js";
+import { MCPToolMeta, MCPToolMeta$inboundSchema } from "./mcptoolmeta.js";
+import {
+  ToolAnnotations,
+  ToolAnnotations$inboundSchema,
+} from "./toolannotations.js";
+import { ToolExecution, ToolExecution$inboundSchema } from "./toolexecution.js";
+
+export type MCPTool = {
+  name: string;
+  title?: string | null | undefined;
+  description?: string | null | undefined;
+  inputSchema: { [k: string]: any };
+  outputSchema?: { [k: string]: any } | null | undefined;
+  icons?: Array<MCPServerIcon> | null | undefined;
+  annotations?: ToolAnnotations | null | undefined;
+  meta?: MCPToolMeta | null | undefined;
+  execution?: ToolExecution | null | undefined;
+  [additionalProperties: string]: unknown;
+};
+
+/** @internal */
+export const MCPTool$inboundSchema: z.ZodType<MCPTool, unknown> = z.object({
+  name: z.string(),
+  title: z.nullable(z.string()).optional(),
+  description: z.nullable(z.string()).optional(),
+  inputSchema: z.record(z.string(), z.any()),
+  outputSchema: z.nullable(z.record(z.string(), z.any())).optional(),
+  icons: z.nullable(z.array(MCPServerIcon$inboundSchema)).optional(),
+  annotations: z.nullable(ToolAnnotations$inboundSchema).optional(),
+  _meta: z.nullable(MCPToolMeta$inboundSchema).optional(),
+  execution: z.nullable(ToolExecution$inboundSchema).optional(),
+}).catchall(z.any()).transform((v) => {
+  return remap$(v, {
+    "_meta": "meta",
+  });
+});
+
+export function mcpToolFromJSON(
+  jsonString: string,
+): SafeParseResult<MCPTool, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => MCPTool$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'MCPTool' from JSON`,
+  );
+}

package/src/models/components/mcptoolmeta.ts

@@ -0,0 +1,49 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f3cdc62104da
+ */
+
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { MCPUIToolMeta, MCPUIToolMeta$inboundSchema } from "./mcpuitoolmeta.js";
+import {
+  TurbineToolMeta,
+  TurbineToolMeta$inboundSchema,
+} from "./turbinetoolmeta.js";
+
+/**
+ * Typed _meta for MCP tools.
+ *
+ * @remarks
+ *
+ * Only the 'ui' field is typed. Other fields are allowed via extra="allow".
+ */
+export type MCPToolMeta = {
+  ui?: MCPUIToolMeta | null | undefined;
+  aiMistralTurbine?: TurbineToolMeta | null | undefined;
+  [additionalProperties: string]: unknown;
+};
+
+/** @internal */
+export const MCPToolMeta$inboundSchema: z.ZodType<MCPToolMeta, unknown> = z
+  .object({
+    ui: z.nullable(MCPUIToolMeta$inboundSchema).optional(),
+    "ai.mistral/turbine": z.nullable(TurbineToolMeta$inboundSchema).optional(),
+  }).catchall(z.any()).transform((v) => {
+    return remap$(v, {
+      "ai.mistral/turbine": "aiMistralTurbine",
+    });
+  });
+
+export function mcpToolMetaFromJSON(
+  jsonString: string,
+): SafeParseResult<MCPToolMeta, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => MCPToolMeta$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'MCPToolMeta' from JSON`,
+  );
+}

package/src/models/components/mcpuitoolmeta.ts

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 214688641f30
+ */
+
+import * as z from "zod/v4";
+import { safeParse } from "../../lib/schemas.js";
+import * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export const Visibility = {
+  Model: "model",
+  App: "app",
+} as const;
+export type Visibility = OpenEnum<typeof Visibility>;
+
+/**
+ * UI metadata for tools that reference UI resources.
+ */
+export type MCPUIToolMeta = {
+  resourceUri?: string | null | undefined;
+  visibility?: Array<Visibility> | null | undefined;
+  [additionalProperties: string]: unknown;
+};
+
+/** @internal */
+export const Visibility$inboundSchema: z.ZodType<Visibility, unknown> =
+  openEnums.inboundSchema(Visibility);
+
+/** @internal */
+export const MCPUIToolMeta$inboundSchema: z.ZodType<MCPUIToolMeta, unknown> = z
+  .object({
+    resourceUri: z.nullable(z.string()).optional(),
+    visibility: z.nullable(z.array(Visibility$inboundSchema)).optional(),
+  }).catchall(z.any());
+
+export function mcpuiToolMetaFromJSON(
+  jsonString: string,
+): SafeParseResult<MCPUIToolMeta, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => MCPUIToolMeta$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'MCPUIToolMeta' from JSON`,
+  );
+}

package/src/models/components/toolannotations.ts

@@ -0,0 +1,52 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d537caae3348
+ */
+
+import * as z from "zod/v4";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Additional properties describing a Tool to clients.
+ *
+ * @remarks
+ *
+ * NOTE: all properties in ToolAnnotations are **hints**.
+ * They are not guaranteed to provide a faithful description of
+ * tool behavior (including descriptive properties like `title`).
+ *
+ * Clients should never make tool use decisions based on ToolAnnotations
+ * received from untrusted servers.
+ */
+export type ToolAnnotations = {
+  title?: string | null | undefined;
+  readOnlyHint?: boolean | null | undefined;
+  destructiveHint?: boolean | null | undefined;
+  idempotentHint?: boolean | null | undefined;
+  openWorldHint?: boolean | null | undefined;
+  [additionalProperties: string]: unknown;
+};
+
+/** @internal */
+export const ToolAnnotations$inboundSchema: z.ZodType<
+  ToolAnnotations,
+  unknown
+> = z.object({
+  title: z.nullable(z.string()).optional(),
+  readOnlyHint: z.nullable(z.boolean()).optional(),
+  destructiveHint: z.nullable(z.boolean()).optional(),
+  idempotentHint: z.nullable(z.boolean()).optional(),
+  openWorldHint: z.nullable(z.boolean()).optional(),
+}).catchall(z.any());
+
+export function toolAnnotationsFromJSON(
+  jsonString: string,
+): SafeParseResult<ToolAnnotations, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ToolAnnotations$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ToolAnnotations' from JSON`,
+  );
+}

package/src/models/components/toolexecution.ts

@@ -0,0 +1,46 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e4afdeb4b779
+ */
+
+import * as z from "zod/v4";
+import { safeParse } from "../../lib/schemas.js";
+import * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export const TaskSupport = {
+  Forbidden: "forbidden",
+  Optional: "optional",
+  Required: "required",
+} as const;
+export type TaskSupport = OpenEnum<typeof TaskSupport>;
+
+/**
+ * Execution-related properties for a tool.
+ */
+export type ToolExecution = {
+  taskSupport?: TaskSupport | null | undefined;
+  [additionalProperties: string]: unknown;
+};
+
+/** @internal */
+export const TaskSupport$inboundSchema: z.ZodType<TaskSupport, unknown> =
+  openEnums.inboundSchema(TaskSupport);
+
+/** @internal */
+export const ToolExecution$inboundSchema: z.ZodType<ToolExecution, unknown> = z
+  .object({
+    taskSupport: z.nullable(TaskSupport$inboundSchema).optional(),
+  }).catchall(z.any());
+
+export function toolExecutionFromJSON(
+  jsonString: string,
+): SafeParseResult<ToolExecution, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ToolExecution$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ToolExecution' from JSON`,
+  );
+}

package/src/models/components/tooltype.ts

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2d3fa4dcb1a1
+ */
+
+import * as z from "zod/v4";
+import * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
+
+export const ToolType = {
+  Rag: "rag",
+  Image: "image",
+  Code: "code",
+  Event: "event",
+} as const;
+export type ToolType = OpenEnum<typeof ToolType>;
+
+/** @internal */
+export const ToolType$inboundSchema: z.ZodType<ToolType, unknown> = openEnums
+  .inboundSchema(ToolType);

package/src/models/components/turbinetoollocale.ts

@@ -0,0 +1,46 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4a2e89dd045a
+ */
+
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type TurbineToolLocale = {
+  name?: { [k: string]: string } | null | undefined;
+  description?: { [k: string]: string } | null | undefined;
+  usageSentence?: { [k: string]: string } | null | undefined;
+  workingDescription?: { [k: string]: string } | null | undefined;
+  doneDescription?: { [k: string]: string } | null | undefined;
+};
+
+/** @internal */
+export const TurbineToolLocale$inboundSchema: z.ZodType<
+  TurbineToolLocale,
+  unknown
+> = z.object({
+  name: z.nullable(z.record(z.string(), z.string())).optional(),
+  description: z.nullable(z.record(z.string(), z.string())).optional(),
+  usage_sentence: z.nullable(z.record(z.string(), z.string())).optional(),
+  working_description: z.nullable(z.record(z.string(), z.string())).optional(),
+  done_description: z.nullable(z.record(z.string(), z.string())).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "usage_sentence": "usageSentence",
+    "working_description": "workingDescription",
+    "done_description": "doneDescription",
+  });
+});
+
+export function turbineToolLocaleFromJSON(
+  jsonString: string,
+): SafeParseResult<TurbineToolLocale, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TurbineToolLocale$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TurbineToolLocale' from JSON`,
+  );
+}

package/src/models/components/turbinetoolmeta.ts

@@ -0,0 +1,48 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 044cdb287e1c
+ */
+
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { ToolType, ToolType$inboundSchema } from "./tooltype.js";
+import {
+  TurbineToolLocale,
+  TurbineToolLocale$inboundSchema,
+} from "./turbinetoollocale.js";
+
+export type TurbineToolMeta = {
+  locale?: TurbineToolLocale | null | undefined;
+  toolType?: ToolType | null | undefined;
+  timeout?: number | null | undefined;
+  privateExecution?: boolean | null | undefined;
+};
+
+/** @internal */
+export const TurbineToolMeta$inboundSchema: z.ZodType<
+  TurbineToolMeta,
+  unknown
+> = z.object({
+  locale: z.nullable(TurbineToolLocale$inboundSchema).optional(),
+  tool_type: z.nullable(ToolType$inboundSchema).optional(),
+  timeout: z.nullable(z.number()).optional(),
+  private_execution: z.nullable(z.boolean()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "tool_type": "toolType",
+    "private_execution": "privateExecution",
+  });
+});
+
+export function turbineToolMetaFromJSON(
+  jsonString: string,
+): SafeParseResult<TurbineToolMeta, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TurbineToolMeta$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TurbineToolMeta' from JSON`,
+  );
+}