@mutagent/sdk 0.2.120 → 0.2.122

package/src/funcs/provider-configs-get-models-catalog.ts

@@ -0,0 +1,156 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { MutagentCore } from "../core.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.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/http-client-errors.js";
+import * as errors from "../models/errors/index.js";
+import { MutagentError } from "../models/errors/mutagent-error.js";
+import { ResponseValidationError } from "../models/errors/response-validation-error.js";
+import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get models catalog
+ *
+ * @remarks
+ * Returns the union of static known models and declared provider models for a workspace. Used by the optimizer dropdown.
+ */
+export function providerConfigsGetModelsCatalog(
+  client: MutagentCore,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.GetModelsCatalogResponse,
+    | errors.ErrorMessage
+    | errors.ErrorMessageStatusCode
+    | MutagentError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    options,
+  ));
+}
+
+async function $do(
+  client: MutagentCore,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.GetModelsCatalogResponse,
+      | errors.ErrorMessage
+      | errors.ErrorMessageStatusCode
+      | MutagentError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const path = pathToFunc("/api/providers/catalog")();
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const securityInput = await extractSecurity(client._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "getModelsCatalog",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.security,
+    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,
+    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,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["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.GetModelsCatalogResponse,
+    | errors.ErrorMessage
+    | errors.ErrorMessageStatusCode
+    | MutagentError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.GetModelsCatalogResponse$inboundSchema),
+    M.jsonErr([400, 401, 403, 404], errors.ErrorMessage$inboundSchema),
+    M.jsonErr(500, errors.ErrorMessageStatusCode$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

@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "2.0.0",
-  sdkVersion: "0.2.120",
+  sdkVersion: "0.2.122",
   genVersion: "2.881.0",
-  userAgent: "speakeasy-sdk/typescript 0.2.120 2.881.0 2.0.0 @mutagent/sdk",
+  userAgent: "speakeasy-sdk/typescript 0.2.122 2.881.0 2.0.0 @mutagent/sdk",
 } as const;

package/src/models/dataset-item-id-dataset-item-index-model-column-id.ts

@@ -3,16 +3,6 @@
  */
 
 import * as z from "zod/v4-mini";
-import {
-  SchemaanyOf,
-  SchemaanyOf$Outbound,
-  SchemaanyOf$outboundSchema,
-} from "./schemaany-of.js";
-import {
-  SchemaanyOf2,
-  SchemaanyOf2$Outbound,
-  SchemaanyOf2$outboundSchema,
-} from "./schemaany-of2.js";
 
 export type EvalCriterion = {
   /**
@@ -41,11 +31,11 @@ export type DatasetItemIdDatasetItemIndexModelColumnId = {
   /**
    * ID of the dataset item this result is for
    */
-  datasetItemId: SchemaanyOf;
+  datasetItemId?: number | undefined;
   /**
    * Position of dataset item at run time
    */
-  datasetItemIndex: SchemaanyOf2;
+  datasetItemIndex: number;
   /**
    * Model column ID matching config.models[].id
    */
@@ -65,7 +55,7 @@ export type DatasetItemIdDatasetItemIndexModelColumnId = {
   /**
    * Execution time in milliseconds
    */
-  latencyMs?: SchemaanyOf2 | undefined;
+  latencyMs?: number | undefined;
   /**
    * Error message if execution failed
    */
@@ -107,13 +97,13 @@ export function evalCriterionToJSON(evalCriterion: EvalCriterion): string {
 
 /** @internal */
 export type DatasetItemIdDatasetItemIndexModelColumnId$Outbound = {
-  datasetItemId: SchemaanyOf$Outbound;
-  datasetItemIndex: SchemaanyOf2$Outbound;
+  datasetItemId: number;
+  datasetItemIndex: number;
   modelColumnId: string;
   output: string;
   evalScore?: number | null | undefined;
   evalPassed?: boolean | null | undefined;
-  latencyMs?: SchemaanyOf2$Outbound | undefined;
+  latencyMs?: number | undefined;
   error?: string | undefined;
   traceId?: string | undefined;
   evalCriteria?: Array<EvalCriterion$Outbound> | null | undefined;
@@ -125,13 +115,13 @@ export const DatasetItemIdDatasetItemIndexModelColumnId$outboundSchema:
     DatasetItemIdDatasetItemIndexModelColumnId$Outbound,
     DatasetItemIdDatasetItemIndexModelColumnId
   > = z.object({
-    datasetItemId: SchemaanyOf$outboundSchema,
-    datasetItemIndex: SchemaanyOf2$outboundSchema,
+    datasetItemId: z._default(z.int(), 0),
+    datasetItemIndex: z.int(),
     modelColumnId: z.string(),
     output: z.string(),
     evalScore: z.optional(z.nullable(z.number())),
     evalPassed: z.optional(z.nullable(z.boolean())),
-    latencyMs: z.optional(SchemaanyOf2$outboundSchema),
+    latencyMs: z.optional(z.int()),
     error: z.optional(z.string()),
     traceId: z.optional(z.string()),
     evalCriteria: z.optional(

package/src/models/id-display-name-family.ts

@@ -0,0 +1,57 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+export type IdDisplayNameFamily = {
+  /**
+   * Model identifier
+   */
+  id: string;
+  /**
+   * Human-readable name
+   */
+  displayName?: string | undefined;
+  /**
+   * Adapter family (openai|anthropic|inference)
+   */
+  family?: string | undefined;
+  /**
+   * Role list: exec, eval, opt
+   */
+  roles?: Array<string> | undefined;
+  /**
+   * 'discovered' | 'manual'
+   */
+  source?: string | undefined;
+};
+
+/** @internal */
+export type IdDisplayNameFamily$Outbound = {
+  id: string;
+  displayName?: string | undefined;
+  family?: string | undefined;
+  roles?: Array<string> | undefined;
+  source?: string | undefined;
+};
+
+/** @internal */
+export const IdDisplayNameFamily$outboundSchema: z.ZodMiniType<
+  IdDisplayNameFamily$Outbound,
+  IdDisplayNameFamily
+> = z.object({
+  id: z.string(),
+  displayName: z.optional(z.string()),
+  family: z.optional(z.string()),
+  roles: z.optional(z.array(z.string())),
+  source: z.optional(z.string()),
+});
+
+export function idDisplayNameFamilyToJSON(
+  idDisplayNameFamily: IdDisplayNameFamily,
+): string {
+  return JSON.stringify(
+    IdDisplayNameFamily$outboundSchema.parse(idDisplayNameFamily),
+  );
+}

package/src/models/index.ts

@@ -21,6 +21,7 @@ export * from "./evaluation-list.js";
 export * from "./evaluation-result.js";
 export * from "./evaluation-run.js";
 export * from "./evaluation.js";
+export * from "./id-display-name-family.js";
 export * from "./id-name-email.js";
 export * from "./id-organization-id-email.js";
 export * from "./id-prompt-id-workspace-id.js";
@@ -72,8 +73,6 @@ export * from "./prompt.js";
 export * from "./provider-config.js";
 export * from "./provider-configs-list.js";
 export * from "./provider-success.js";
-export * from "./schemaany-of.js";
-export * from "./schemaany-of2.js";
 export * from "./schemadefaul6.js";
 export * from "./schemadefaul8.js";
 export * from "./schemaenum2.js";

package/src/models/name-api-key-base-url.ts

@@ -3,6 +3,11 @@
  */
 
 import * as z from "zod/v4-mini";
+import {
+  IdDisplayNameFamily,
+  IdDisplayNameFamily$Outbound,
+  IdDisplayNameFamily$outboundSchema,
+} from "./id-display-name-family.js";
 import {
   Schemanullab4,
   Schemanullab4$Outbound,
@@ -34,6 +39,18 @@ export type NameApiKeyBaseUrl = {
    * Set or unset as default provider
    */
   isDefault?: boolean | undefined;
+  /**
+   * Azure/custom wire-format family: 'openai' | 'anthropic' | 'inference'
+   */
+  family?: string | null | undefined;
+  /**
+   * Updated declared models (null to clear)
+   */
+  supportedModels?: Array<IdDisplayNameFamily> | null | undefined;
+  /**
+   * Updated API version (null to clear)
+   */
+  apiVersion?: string | null | undefined;
   /**
    * Updated metadata (null to clear)
    */
@@ -48,6 +65,9 @@ export type NameApiKeyBaseUrl$Outbound = {
   modelOverrides?: Schemanullab4$Outbound | null | undefined;
   isActive?: boolean | undefined;
   isDefault?: boolean | undefined;
+  family?: string | null | undefined;
+  supportedModels?: Array<IdDisplayNameFamily$Outbound> | null | undefined;
+  apiVersion?: string | null | undefined;
   metadata?: Schemanullab4$Outbound | null | undefined;
 };
 
@@ -62,6 +82,11 @@ export const NameApiKeyBaseUrl$outboundSchema: z.ZodMiniType<
   modelOverrides: z.optional(z.nullable(Schemanullab4$outboundSchema)),
   isActive: z.optional(z.boolean()),
   isDefault: z.optional(z.boolean()),
+  family: z.optional(z.nullable(z.string())),
+  supportedModels: z.optional(
+    z.nullable(z.array(IdDisplayNameFamily$outboundSchema)),
+  ),
+  apiVersion: z.optional(z.nullable(z.string())),
   metadata: z.optional(z.nullable(Schemanullab4$outboundSchema)),
 });
 

package/src/models/name-provider-api-key.ts

@@ -42,6 +42,29 @@ export type Scope = {
  */
 export type NameProviderApiKeyModelOverrides = {};
 
+export type NameProviderApiKeySupportedModel = {
+  /**
+   * Model identifier
+   */
+  id: string;
+  /**
+   * Human-readable name
+   */
+  displayName?: string | undefined;
+  /**
+   * Adapter family (openai|anthropic|inference)
+   */
+  family?: string | undefined;
+  /**
+   * Role list: exec, eval, opt
+   */
+  roles?: Array<string> | undefined;
+  /**
+   * 'discovered' | 'manual'
+   */
+  source?: string | undefined;
+};
+
 /**
  * Additional metadata
  */
@@ -76,6 +99,18 @@ export type NameProviderApiKey = {
    * Set as default provider for this scope
    */
   isDefault?: boolean | undefined;
+  /**
+   * Azure/custom wire-format family: 'openai' | 'anthropic' | 'inference'
+   */
+  family?: string | undefined;
+  /**
+   * Declared models this provider serves
+   */
+  supportedModels?: Array<NameProviderApiKeySupportedModel> | undefined;
+  /**
+   * API version string, e.g. '2024-08-01-preview'
+   */
+  apiVersion?: string | undefined;
   /**
    * Additional metadata
    */
@@ -125,6 +160,37 @@ export function nameProviderApiKeyModelOverridesToJSON(
   );
 }
 
+/** @internal */
+export type NameProviderApiKeySupportedModel$Outbound = {
+  id: string;
+  displayName?: string | undefined;
+  family?: string | undefined;
+  roles?: Array<string> | undefined;
+  source?: string | undefined;
+};
+
+/** @internal */
+export const NameProviderApiKeySupportedModel$outboundSchema: z.ZodMiniType<
+  NameProviderApiKeySupportedModel$Outbound,
+  NameProviderApiKeySupportedModel
+> = z.object({
+  id: z.string(),
+  displayName: z.optional(z.string()),
+  family: z.optional(z.string()),
+  roles: z.optional(z.array(z.string())),
+  source: z.optional(z.string()),
+});
+
+export function nameProviderApiKeySupportedModelToJSON(
+  nameProviderApiKeySupportedModel: NameProviderApiKeySupportedModel,
+): string {
+  return JSON.stringify(
+    NameProviderApiKeySupportedModel$outboundSchema.parse(
+      nameProviderApiKeySupportedModel,
+    ),
+  );
+}
+
 /** @internal */
 export type NameProviderApiKeyMetadata$Outbound = {};
 
@@ -151,6 +217,11 @@ export type NameProviderApiKey$Outbound = {
   baseUrl?: string | undefined;
   modelOverrides?: NameProviderApiKeyModelOverrides$Outbound | undefined;
   isDefault: boolean;
+  family?: string | undefined;
+  supportedModels?:
+    | Array<NameProviderApiKeySupportedModel$Outbound>
+    | undefined;
+  apiVersion?: string | undefined;
   metadata?: NameProviderApiKeyMetadata$Outbound | undefined;
 };
 
@@ -168,6 +239,11 @@ export const NameProviderApiKey$outboundSchema: z.ZodMiniType<
     z.lazy(() => NameProviderApiKeyModelOverrides$outboundSchema),
   ),
   isDefault: z._default(z.boolean(), false),
+  family: z.optional(z.string()),
+  supportedModels: z.optional(
+    z.array(z.lazy(() => NameProviderApiKeySupportedModel$outboundSchema)),
+  ),
+  apiVersion: z.optional(z.string()),
   metadata: z.optional(z.lazy(() => NameProviderApiKeyMetadata$outboundSchema)),
 });
 

package/src/models/operations/get-models-catalog.ts

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+
+/**
+ * Successful response
+ */
+export type GetModelsCatalogResponse = {};
+
+/** @internal */
+export const GetModelsCatalogResponse$inboundSchema: z.ZodMiniType<
+  GetModelsCatalogResponse,
+  unknown
+> = z.object({});
+
+export function getModelsCatalogResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetModelsCatalogResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetModelsCatalogResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetModelsCatalogResponse' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -45,6 +45,7 @@ export * from "./get-evaluation-results-aggregated.js";
 export * from "./get-evaluation.js";
 export * from "./get-experiment.js";
 export * from "./get-invitation.js";
+export * from "./get-models-catalog.js";
 export * from "./get-optimization-progress.js";
 export * from "./get-optimization-results.js";
 export * from "./get-optimization-states.js";

package/src/models/prompt-id-prompt-group-id-evaluation-id.ts

@@ -3,22 +3,6 @@
  */
 
 import * as z from "zod/v4-mini";
-import { smartUnion } from "../types/smart-union.js";
-
-/**
- * ID of the prompt to experiment with
- */
-export type PromptId = string | number;
-
-/**
- * ID of the evaluation criteria to use
- */
-export type EvaluationId = string | number;
-
-/**
- * ID of the dataset to use
- */
-export type DatasetId = string | number;
 
 export type Model = {
   /**
@@ -35,16 +19,11 @@ export type Model = {
   temperature: number;
 };
 
-/**
- * Snapshot of dataset size at run time
- */
-export type DatasetItemCount = string | number;
-
 export type PromptIdPromptGroupIdEvaluationId = {
   /**
    * ID of the prompt to experiment with
    */
-  promptId: string | number;
+  promptId?: number | undefined;
   /**
    * Prompt group UUID for filtering experiments by prompt family
    */
@@ -52,11 +31,11 @@ export type PromptIdPromptGroupIdEvaluationId = {
   /**
    * ID of the evaluation criteria to use
    */
-  evaluationId: string | number;
+  evaluationId?: number | undefined;
   /**
    * ID of the dataset to use
    */
-  datasetId: string | number;
+  datasetId?: number | undefined;
   /**
    * Array of model configurations (1-4 models)
    */
@@ -64,52 +43,13 @@ export type PromptIdPromptGroupIdEvaluationId = {
   /**
    * Snapshot of dataset size at run time
    */
-  datasetItemCount?: string | number | undefined;
+  datasetItemCount?: number | undefined;
   /**
    * Experiment name (auto-generated if not provided)
    */
   name?: string | undefined;
 };
 
-/** @internal */
-export type PromptId$Outbound = string | number;
-
-/** @internal */
-export const PromptId$outboundSchema: z.ZodMiniType<
-  PromptId$Outbound,
-  PromptId
-> = smartUnion([z.string(), z.int()]);
-
-export function promptIdToJSON(promptId: PromptId): string {
-  return JSON.stringify(PromptId$outboundSchema.parse(promptId));
-}
-
-/** @internal */
-export type EvaluationId$Outbound = string | number;
-
-/** @internal */
-export const EvaluationId$outboundSchema: z.ZodMiniType<
-  EvaluationId$Outbound,
-  EvaluationId
-> = smartUnion([z.string(), z.int()]);
-
-export function evaluationIdToJSON(evaluationId: EvaluationId): string {
-  return JSON.stringify(EvaluationId$outboundSchema.parse(evaluationId));
-}
-
-/** @internal */
-export type DatasetId$Outbound = string | number;
-
-/** @internal */
-export const DatasetId$outboundSchema: z.ZodMiniType<
-  DatasetId$Outbound,
-  DatasetId
-> = smartUnion([z.string(), z.int()]);
-
-export function datasetIdToJSON(datasetId: DatasetId): string {
-  return JSON.stringify(DatasetId$outboundSchema.parse(datasetId));
-}
-
 /** @internal */
 export type Model$Outbound = {
   id: string;
@@ -129,31 +69,14 @@ export function modelToJSON(model: Model): string {
   return JSON.stringify(Model$outboundSchema.parse(model));
 }
 
-/** @internal */
-export type DatasetItemCount$Outbound = string | number;
-
-/** @internal */
-export const DatasetItemCount$outboundSchema: z.ZodMiniType<
-  DatasetItemCount$Outbound,
-  DatasetItemCount
-> = smartUnion([z.string(), z.int()]);
-
-export function datasetItemCountToJSON(
-  datasetItemCount: DatasetItemCount,
-): string {
-  return JSON.stringify(
-    DatasetItemCount$outboundSchema.parse(datasetItemCount),
-  );
-}
-
 /** @internal */
 export type PromptIdPromptGroupIdEvaluationId$Outbound = {
-  promptId: string | number;
+  promptId: number;
   promptGroupId: string;
-  evaluationId: string | number;
-  datasetId: string | number;
+  evaluationId: number;
+  datasetId: number;
   models: Array<Model$Outbound>;
-  datasetItemCount?: string | number | undefined;
+  datasetItemCount: number;
   name?: string | undefined;
 };
 
@@ -162,12 +85,12 @@ export const PromptIdPromptGroupIdEvaluationId$outboundSchema: z.ZodMiniType<
   PromptIdPromptGroupIdEvaluationId$Outbound,
   PromptIdPromptGroupIdEvaluationId
 > = z.object({
-  promptId: smartUnion([z.string(), z.int()]),
+  promptId: z._default(z.int(), 0),
   promptGroupId: z.string(),
-  evaluationId: smartUnion([z.string(), z.int()]),
-  datasetId: smartUnion([z.string(), z.int()]),
+  evaluationId: z._default(z.int(), 0),
+  datasetId: z._default(z.int(), 0),
   models: z.array(z.lazy(() => Model$outboundSchema)),
-  datasetItemCount: z.optional(smartUnion([z.string(), z.int()])),
+  datasetItemCount: z._default(z.int(), 0),
   name: z.optional(z.string()),
 });