@launchdarkly/mcp-server 0.7.0 → 0.7.2

package/src/models/components/aiconfigvariation.ts

@@ -5,8 +5,15 @@
 import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  Classifier,
+  Classifier$inboundSchema,
+  Classifier$Outbound,
+  Classifier$outboundSchema,
+} from "./classifier.js";
 import {
   JudgeConfiguration,
   JudgeConfiguration$inboundSchema,
@@ -25,6 +32,12 @@ import {
   ParentLink$Outbound,
   ParentLink$outboundSchema,
 } from "./parentlink.js";
+import {
+  VariationSkill,
+  VariationSkill$inboundSchema,
+  VariationSkill$Outbound,
+  VariationSkill$outboundSchema,
+} from "./variationskill.js";
 import {
   VariationTool,
   VariationTool$inboundSchema,
@@ -32,11 +45,46 @@ import {
   VariationTool$outboundSchema,
 } from "./variationtool.js";
 
+/**
+ * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider's API accepts, for example `{"temperature": 0.7, "maxTokens": 4096}`.
+ */
 export type AIConfigVariationModel = {};
 
+/**
+ * The state of the variation.
+ *
+ * @remarks
+ * - `archived`: The variation is archived. To restore it, update the variation with `state` set to `published`.
+ * - `published`: The variation is active.
+ */
+export const AIConfigVariationState = {
+  Archived: "archived",
+  Published: "published",
+} as const;
+/**
+ * The state of the variation.
+ *
+ * @remarks
+ * - `archived`: The variation is archived. To restore it, update the variation with `state` set to `published`.
+ * - `published`: The variation is active.
+ */
+export type AIConfigVariationState = ClosedEnum<typeof AIConfigVariationState>;
+
 export type AIConfigVariation = {
   links?: ParentLink | undefined;
+  /**
+   * The color used for this variation in the UI
+   */
   color?: string | undefined;
+  /**
+   * Classifier rules for a judge variation. When this array is non-empty, messages must be empty.
+   *
+   * @remarks
+   */
+  classifiers?: Array<Classifier> | undefined;
+  /**
+   * A comment describing this version of the variation
+   */
   comment?: string | undefined;
   /**
    * Returns the description for the agent. This is only returned for agent variations.
@@ -46,19 +94,73 @@ export type AIConfigVariation = {
    * Returns the instructions for the agent. This is only returned for agent variations.
    */
   instructions?: string | undefined;
+  /**
+   * The variation key
+   */
   key: string;
+  /**
+   * The variation ID
+   */
   id: string;
+  /**
+   * The prompt messages for this variation
+   */
   messages?: Array<Message> | undefined;
+  /**
+   * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider's API accepts, for example `{"temperature": 0.7, "maxTokens": 4096}`.
+   */
   model: AIConfigVariationModel;
+  /**
+   * The key of the model config that this variation uses, not the provider model ID. Absent
+   *
+   * @remarks
+   * when the variation does not use a model config.
+   */
   modelConfigKey?: string | undefined;
+  /**
+   * The version of the model config that this variation is pinned to, when it references a
+   *
+   * @remarks
+   * custom model config. Absent when the variation does not reference a model config, when
+   * the variation is not pinned to a specific version, or when custom model config versioning
+   * is not enabled for the project.
+   */
+  modelConfigVersion?: number | undefined;
+  /**
+   * The variation name
+   */
   name: string;
+  /**
+   * JSON Schema defining the structured output format for the variation.
+   */
+  outputFormat?: { [k: string]: any } | undefined;
   createdAt: number;
+  /**
+   * The version number of this resource
+   */
   version: number;
-  state?: string | undefined;
+  /**
+   * The state of the variation.
+   *
+   * @remarks
+   * - `archived`: The variation is archived. To restore it, update the variation with `state` set to `published`.
+   * - `published`: The variation is active.
+   */
+  state?: AIConfigVariationState | undefined;
   archivedAt?: number | undefined;
   publishedAt?: number | undefined;
+  /**
+   * The tools this variation can use
+   */
   tools?: Array<VariationTool> | undefined;
+  /**
+   * The agent skills this variation can use
+   */
+  skills?: Array<VariationSkill> | undefined;
   judgeConfiguration?: JudgeConfiguration | undefined;
+  /**
+   * Keys of the judge AI Configs attached to this variation
+   */
   judgingConfigKeys?: Array<string> | undefined;
 };
 
@@ -95,6 +197,15 @@ export function aiConfigVariationModelFromJSON(
   );
 }
 
+/** @internal */
+export const AIConfigVariationState$inboundSchema: z.ZodNativeEnum<
+  typeof AIConfigVariationState
+> = z.nativeEnum(AIConfigVariationState);
+/** @internal */
+export const AIConfigVariationState$outboundSchema: z.ZodNativeEnum<
+  typeof AIConfigVariationState
+> = AIConfigVariationState$inboundSchema;
+
 /** @internal */
 export const AIConfigVariation$inboundSchema: z.ZodType<
   AIConfigVariation,
@@ -103,6 +214,7 @@ export const AIConfigVariation$inboundSchema: z.ZodType<
 > = z.object({
   _links: ParentLink$inboundSchema.optional(),
   color: z.string().optional(),
+  classifiers: z.array(Classifier$inboundSchema).optional(),
   comment: z.string().optional(),
   description: z.string().optional(),
   instructions: z.string().optional(),
@@ -111,13 +223,16 @@ export const AIConfigVariation$inboundSchema: z.ZodType<
   messages: z.array(Message$inboundSchema).optional(),
   model: z.lazy(() => AIConfigVariationModel$inboundSchema),
   modelConfigKey: z.string().optional(),
+  modelConfigVersion: z.number().int().optional(),
   name: z.string(),
+  outputFormat: z.record(z.any()).optional(),
   createdAt: z.number().int(),
   version: z.number().int(),
-  state: z.string().optional(),
+  state: AIConfigVariationState$inboundSchema.optional(),
   _archivedAt: z.number().int().optional(),
   _publishedAt: z.number().int().optional(),
   tools: z.array(VariationTool$inboundSchema).optional(),
+  skills: z.array(VariationSkill$inboundSchema).optional(),
   judgeConfiguration: JudgeConfiguration$inboundSchema.optional(),
   judgingConfigKeys: z.array(z.string()).optional(),
 }).transform((v) => {
@@ -132,6 +247,7 @@ export const AIConfigVariation$inboundSchema: z.ZodType<
 export type AIConfigVariation$Outbound = {
   _links?: ParentLink$Outbound | undefined;
   color?: string | undefined;
+  classifiers?: Array<Classifier$Outbound> | undefined;
   comment?: string | undefined;
   description?: string | undefined;
   instructions?: string | undefined;
@@ -140,13 +256,16 @@ export type AIConfigVariation$Outbound = {
   messages?: Array<Message$Outbound> | undefined;
   model: AIConfigVariationModel$Outbound;
   modelConfigKey?: string | undefined;
+  modelConfigVersion?: number | undefined;
   name: string;
+  outputFormat?: { [k: string]: any } | undefined;
   createdAt: number;
   version: number;
   state?: string | undefined;
   _archivedAt?: number | undefined;
   _publishedAt?: number | undefined;
   tools?: Array<VariationTool$Outbound> | undefined;
+  skills?: Array<VariationSkill$Outbound> | undefined;
   judgeConfiguration?: JudgeConfiguration$Outbound | undefined;
   judgingConfigKeys?: Array<string> | undefined;
 };
@@ -159,6 +278,7 @@ export const AIConfigVariation$outboundSchema: z.ZodType<
 > = z.object({
   links: ParentLink$outboundSchema.optional(),
   color: z.string().optional(),
+  classifiers: z.array(Classifier$outboundSchema).optional(),
   comment: z.string().optional(),
   description: z.string().optional(),
   instructions: z.string().optional(),
@@ -167,13 +287,16 @@ export const AIConfigVariation$outboundSchema: z.ZodType<
   messages: z.array(Message$outboundSchema).optional(),
   model: z.lazy(() => AIConfigVariationModel$outboundSchema),
   modelConfigKey: z.string().optional(),
+  modelConfigVersion: z.number().int().optional(),
   name: z.string(),
+  outputFormat: z.record(z.any()).optional(),
   createdAt: z.number().int(),
   version: z.number().int(),
-  state: z.string().optional(),
+  state: AIConfigVariationState$outboundSchema.optional(),
   archivedAt: z.number().int().optional(),
   publishedAt: z.number().int().optional(),
   tools: z.array(VariationTool$outboundSchema).optional(),
+  skills: z.array(VariationSkill$outboundSchema).optional(),
   judgeConfiguration: JudgeConfiguration$outboundSchema.optional(),
   judgingConfigKeys: z.array(z.string()).optional(),
 }).transform((v) => {

package/src/models/components/aiconfigvariationpatch.ts

@@ -4,8 +4,15 @@
 
 import * as z from "zod/v3";
 import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  Classifier,
+  Classifier$inboundSchema,
+  Classifier$Outbound,
+  Classifier$outboundSchema,
+} from "./classifier.js";
 import {
   JudgeConfiguration,
   JudgeConfiguration$inboundSchema,
@@ -18,6 +25,12 @@ import {
   Message$Outbound,
   Message$outboundSchema,
 } from "./message.js";
+import {
+  VariationSkillPost,
+  VariationSkillPost$inboundSchema,
+  VariationSkillPost$Outbound,
+  VariationSkillPost$outboundSchema,
+} from "./variationskillpost.js";
 import {
   VariationToolPost,
   VariationToolPost$inboundSchema,
@@ -25,30 +38,98 @@ import {
   VariationToolPost$outboundSchema,
 } from "./variationtoolpost.js";
 
+/**
+ * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider's API accepts, for example `{"temperature": 0.7, "maxTokens": 4096}`.
+ */
 export type AIConfigVariationPatchModel = {};
 
+/**
+ * The state to move the variation to. Omit this field to keep the current state.
+ *
+ * @remarks
+ * - `archived`: Archive a published variation. You cannot archive a variation that is already archived. You also cannot archive the only variation of an AI Config. An AI Config itself cannot be archived.
+ * - `published`: Restore an archived variation. You cannot publish a variation that is already published.
+ */
+export const AIConfigVariationPatchState = {
+  Archived: "archived",
+  Published: "published",
+} as const;
+/**
+ * The state to move the variation to. Omit this field to keep the current state.
+ *
+ * @remarks
+ * - `archived`: Archive a published variation. You cannot archive a variation that is already archived. You also cannot archive the only variation of an AI Config. An AI Config itself cannot be archived.
+ * - `published`: Restore an archived variation. You cannot publish a variation that is already published.
+ */
+export type AIConfigVariationPatchState = ClosedEnum<
+  typeof AIConfigVariationPatchState
+>;
+
 export type AIConfigVariationPatch = {
+  /**
+   * Replaces classifier rules on a judge variation. An empty array clears them. When this array is
+   *
+   * @remarks
+   * non-empty, messages must be empty.
+   */
+  classifiers?: Array<Classifier> | undefined;
   /**
    * Human-readable description of what this patch changes
    */
   comment?: string | undefined;
   /**
-   * Description for agent when AI Config is in agent mode.
+   * Description for agent when the config is in agent mode.
    */
   description?: string | undefined;
   /**
-   * Instructions for agent when AI Config is in agent mode.
+   * Instructions for agent when the config is in agent mode.
    */
   instructions?: string | undefined;
+  /**
+   * The prompt messages for this variation
+   */
   messages?: Array<Message> | undefined;
+  /**
+   * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider's API accepts, for example `{"temperature": 0.7, "maxTokens": 4096}`.
+   */
   model?: AIConfigVariationPatchModel | undefined;
+  /**
+   * The key that GET /api/v2/projects/{projectKey}/ai-configs/model-configs returns for the
+   *
+   * @remarks
+   * model config. Do not use a custom model config's ID, which is the provider model ID.
+   */
   modelConfigKey?: string | undefined;
+  /**
+   * The exact model config version to set this variation to. Requires modelConfigKey to be
+   *
+   * @remarks
+   * set (either in this patch or already on the variation), and the version must exist for
+   * that model config. When omitted, the variation keeps the version it is currently set to,
+   * unless the patch changes modelConfigKey, in which case the variation records the new
+   * model config's current (latest) version.
+   */
+  modelConfigVersion?: number | undefined;
+  /**
+   * A human-readable name for the variation
+   */
   name?: string | undefined;
+  /**
+   * JSON Schema defining the structured output format for the variation.
+   */
+  outputFormat?: { [k: string]: any } | undefined;
+  /**
+   * Whether to publish this version of the variation
+   */
   published?: boolean | undefined;
   /**
-   * One of 'archived', 'published'
+   * The state to move the variation to. Omit this field to keep the current state.
+   *
+   * @remarks
+   * - `archived`: Archive a published variation. You cannot archive a variation that is already archived. You also cannot archive the only variation of an AI Config. An AI Config itself cannot be archived.
+   * - `published`: Restore an archived variation. You cannot publish a variation that is already published.
    */
-  state?: string | undefined;
+  state?: AIConfigVariationPatchState | undefined;
   /**
    * List of tools to use for this variation. The latest version of the tool will be used.
    */
@@ -57,6 +138,10 @@ export type AIConfigVariationPatch = {
    * List of tool keys to use for this variation. The latest version of the tool will be used.
    */
   toolKeys?: Array<string> | undefined;
+  /**
+   * List of agent skills to attach to this variation. Replaces the current attachments.
+   */
+  skills?: Array<VariationSkillPost> | undefined;
   judgeConfiguration?: JudgeConfiguration | undefined;
 };
 
@@ -95,38 +180,55 @@ export function aiConfigVariationPatchModelFromJSON(
   );
 }
 
+/** @internal */
+export const AIConfigVariationPatchState$inboundSchema: z.ZodNativeEnum<
+  typeof AIConfigVariationPatchState
+> = z.nativeEnum(AIConfigVariationPatchState);
+/** @internal */
+export const AIConfigVariationPatchState$outboundSchema: z.ZodNativeEnum<
+  typeof AIConfigVariationPatchState
+> = AIConfigVariationPatchState$inboundSchema;
+
 /** @internal */
 export const AIConfigVariationPatch$inboundSchema: z.ZodType<
   AIConfigVariationPatch,
   z.ZodTypeDef,
   unknown
 > = z.object({
+  classifiers: z.array(Classifier$inboundSchema).optional(),
   comment: z.string().optional(),
   description: z.string().optional(),
   instructions: z.string().optional(),
   messages: z.array(Message$inboundSchema).optional(),
   model: z.lazy(() => AIConfigVariationPatchModel$inboundSchema).optional(),
   modelConfigKey: z.string().optional(),
+  modelConfigVersion: z.number().int().optional(),
   name: z.string().optional(),
+  outputFormat: z.record(z.any()).optional(),
   published: z.boolean().optional(),
-  state: z.string().optional(),
+  state: AIConfigVariationPatchState$inboundSchema.optional(),
   tools: z.array(VariationToolPost$inboundSchema).optional(),
   toolKeys: z.array(z.string()).optional(),
+  skills: z.array(VariationSkillPost$inboundSchema).optional(),
   judgeConfiguration: JudgeConfiguration$inboundSchema.optional(),
 });
 /** @internal */
 export type AIConfigVariationPatch$Outbound = {
+  classifiers?: Array<Classifier$Outbound> | undefined;
   comment?: string | undefined;
   description?: string | undefined;
   instructions?: string | undefined;
   messages?: Array<Message$Outbound> | undefined;
   model?: AIConfigVariationPatchModel$Outbound | undefined;
   modelConfigKey?: string | undefined;
+  modelConfigVersion?: number | undefined;
   name?: string | undefined;
+  outputFormat?: { [k: string]: any } | undefined;
   published?: boolean | undefined;
   state?: string | undefined;
   tools?: Array<VariationToolPost$Outbound> | undefined;
   toolKeys?: Array<string> | undefined;
+  skills?: Array<VariationSkillPost$Outbound> | undefined;
   judgeConfiguration?: JudgeConfiguration$Outbound | undefined;
 };
 
@@ -136,17 +238,21 @@ export const AIConfigVariationPatch$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   AIConfigVariationPatch
 > = z.object({
+  classifiers: z.array(Classifier$outboundSchema).optional(),
   comment: z.string().optional(),
   description: z.string().optional(),
   instructions: z.string().optional(),
   messages: z.array(Message$outboundSchema).optional(),
   model: z.lazy(() => AIConfigVariationPatchModel$outboundSchema).optional(),
   modelConfigKey: z.string().optional(),
+  modelConfigVersion: z.number().int().optional(),
   name: z.string().optional(),
+  outputFormat: z.record(z.any()).optional(),
   published: z.boolean().optional(),
-  state: z.string().optional(),
+  state: AIConfigVariationPatchState$outboundSchema.optional(),
   tools: z.array(VariationToolPost$outboundSchema).optional(),
   toolKeys: z.array(z.string()).optional(),
+  skills: z.array(VariationSkillPost$outboundSchema).optional(),
   judgeConfiguration: JudgeConfiguration$outboundSchema.optional(),
 });
 

package/src/models/components/aiconfigvariationpost.ts

@@ -6,6 +6,12 @@ import * as z from "zod/v3";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  Classifier,
+  Classifier$inboundSchema,
+  Classifier$Outbound,
+  Classifier$outboundSchema,
+} from "./classifier.js";
 import {
   JudgeConfiguration,
   JudgeConfiguration$inboundSchema,
@@ -18,6 +24,12 @@ import {
   Message$Outbound,
   Message$outboundSchema,
 } from "./message.js";
+import {
+  VariationSkillPost,
+  VariationSkillPost$inboundSchema,
+  VariationSkillPost$Outbound,
+  VariationSkillPost$outboundSchema,
+} from "./variationskillpost.js";
 import {
   VariationToolPost,
   VariationToolPost$inboundSchema,
@@ -25,9 +37,18 @@ import {
   VariationToolPost$outboundSchema,
 } from "./variationtoolpost.js";
 
+/**
+ * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider's API accepts, for example `{"temperature": 0.7, "maxTokens": 4096}`.
+ */
 export type AIConfigVariationPostModel = {};
 
 export type AIConfigVariationPost = {
+  /**
+   * Classifier rules for a judge variation. When this array is non-empty, messages must be empty.
+   *
+   * @remarks
+   */
+  classifiers?: Array<Classifier> | undefined;
   /**
    * Human-readable description of this variation
    */
@@ -40,11 +61,41 @@ export type AIConfigVariationPost = {
    * Returns the instructions for the agent. This is only returned for agent variations.
    */
   instructions?: string | undefined;
+  /**
+   * A unique key for the variation
+   */
   key: string;
+  /**
+   * The prompt messages for this variation
+   */
   messages?: Array<Message> | undefined;
+  /**
+   * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider's API accepts, for example `{"temperature": 0.7, "maxTokens": 4096}`.
+   */
   model?: AIConfigVariationPostModel | undefined;
+  /**
+   * A human-readable name for the variation
+   */
   name: string;
+  /**
+   * The key that GET /api/v2/projects/{projectKey}/ai-configs/model-configs returns for the
+   *
+   * @remarks
+   * model config. Do not use a custom model config's ID, which is the provider model ID.
+   */
   modelConfigKey?: string | undefined;
+  /**
+   * The exact model config version to set this variation to. Requires modelConfigKey to be
+   *
+   * @remarks
+   * set, and the version must exist for that model config. When omitted, the variation
+   * records the model config's current (latest) version.
+   */
+  modelConfigVersion?: number | undefined;
+  /**
+   * JSON Schema defining the structured output format for the variation.
+   */
+  outputFormat?: { [k: string]: any } | undefined;
   /**
    * List of tools to use for this variation. The latest version of the tool will be used.
    */
@@ -53,6 +104,10 @@ export type AIConfigVariationPost = {
    * List of tool keys to use for this variation. The latest version of the tool will be used.
    */
   toolKeys?: Array<string> | undefined;
+  /**
+   * List of agent skills to attach to this variation.
+   */
+  skills?: Array<VariationSkillPost> | undefined;
   judgeConfiguration?: JudgeConfiguration | undefined;
 };
 
@@ -95,6 +150,7 @@ export const AIConfigVariationPost$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  classifiers: z.array(Classifier$inboundSchema).optional(),
   comment: z.string().optional(),
   description: z.string().optional(),
   instructions: z.string().optional(),
@@ -103,12 +159,16 @@ export const AIConfigVariationPost$inboundSchema: z.ZodType<
   model: z.lazy(() => AIConfigVariationPostModel$inboundSchema).optional(),
   name: z.string(),
   modelConfigKey: z.string().optional(),
+  modelConfigVersion: z.number().int().optional(),
+  outputFormat: z.record(z.any()).optional(),
   tools: z.array(VariationToolPost$inboundSchema).optional(),
   toolKeys: z.array(z.string()).optional(),
+  skills: z.array(VariationSkillPost$inboundSchema).optional(),
   judgeConfiguration: JudgeConfiguration$inboundSchema.optional(),
 });
 /** @internal */
 export type AIConfigVariationPost$Outbound = {
+  classifiers?: Array<Classifier$Outbound> | undefined;
   comment?: string | undefined;
   description?: string | undefined;
   instructions?: string | undefined;
@@ -117,8 +177,11 @@ export type AIConfigVariationPost$Outbound = {
   model?: AIConfigVariationPostModel$Outbound | undefined;
   name: string;
   modelConfigKey?: string | undefined;
+  modelConfigVersion?: number | undefined;
+  outputFormat?: { [k: string]: any } | undefined;
   tools?: Array<VariationToolPost$Outbound> | undefined;
   toolKeys?: Array<string> | undefined;
+  skills?: Array<VariationSkillPost$Outbound> | undefined;
   judgeConfiguration?: JudgeConfiguration$Outbound | undefined;
 };
 
@@ -128,6 +191,7 @@ export const AIConfigVariationPost$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   AIConfigVariationPost
 > = z.object({
+  classifiers: z.array(Classifier$outboundSchema).optional(),
   comment: z.string().optional(),
   description: z.string().optional(),
   instructions: z.string().optional(),
@@ -136,8 +200,11 @@ export const AIConfigVariationPost$outboundSchema: z.ZodType<
   model: z.lazy(() => AIConfigVariationPostModel$outboundSchema).optional(),
   name: z.string(),
   modelConfigKey: z.string().optional(),
+  modelConfigVersion: z.number().int().optional(),
+  outputFormat: z.record(z.any()).optional(),
   tools: z.array(VariationToolPost$outboundSchema).optional(),
   toolKeys: z.array(z.string()).optional(),
+  skills: z.array(VariationSkillPost$outboundSchema).optional(),
   judgeConfiguration: JudgeConfiguration$outboundSchema.optional(),
 });
 

package/src/models/components/aiconfigvariationsresponse.ts

@@ -14,7 +14,13 @@ import {
 } from "./aiconfigvariation.js";
 
 export type AIConfigVariationsResponse = {
+  /**
+   * The items on this page
+   */
   items: Array<AIConfigVariation>;
+  /**
+   * The total number of items
+   */
   totalCount: number;
 };