@launchdarkly/mcp-server 0.7.0 → 0.7.2

package/src/mcp-server/tools/experimentsGetExperimentsAnyEnv.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { experimentsGetExperimentsAnyEnv } from "../../funcs/experimentsGetExperimentsAnyEnv.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetExperimentsAnyEnvRequest$inboundSchema,
+};
+
+export const tool$experimentsGetExperimentsAnyEnv: ToolDefinition<typeof args> =
+  {
+    name: "list-experiments-any-environment",
+    description:
+      `Lists experiments in a project across all environments. Use to discover experiments before fetching one by environment.`,
+    scopes: ["read"],
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] = await experimentsGetExperimentsAnyEnv(
+        client,
+        args.request,
+        { fetchOptions: { signal: ctx.signal } },
+      ).$inspect();
+
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true,
+        };
+      }
+
+      const value = result.value;
+
+      return formatResult(value, apiCall);
+    },
+  };

package/src/mcp-server/tools/experimentsList.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { experimentsList } from "../../funcs/experimentsList.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetExperimentsRequest$inboundSchema,
+};
+
+export const tool$experimentsList: ToolDefinition<typeof args> = {
+  name: "list-experiments",
+  description:
+    `Lists experiments in a project environment, including their current iteration and status.`,
+  scopes: ["read"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await experimentsList(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/experimentsPatch.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { experimentsPatch } from "../../funcs/experimentsPatch.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.PatchExperimentRequest$inboundSchema,
+};
+
+export const tool$experimentsPatch: ToolDefinition<typeof args> = {
+  name: "update-experiment",
+  description:
+    `Updates an experiment using semantic patch instructions, such as starting or stopping an iteration, or changing its name or description.`,
+  scopes: ["write"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await experimentsPatch(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/metricsCreate.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { metricsCreate } from "../../funcs/metricsCreate.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.PostMetricRequest$inboundSchema,
+};
+
+export const tool$metricsCreate: ToolDefinition<typeof args> = {
+  name: "create-metric",
+  description:
+    `Creates a metric in a project, for use in experiments and guarded rollouts.`,
+  scopes: ["write"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await metricsCreate(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/metricsGet.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { metricsGet } from "../../funcs/metricsGet.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetMetricRequest$inboundSchema,
+};
+
+export const tool$metricsGet: ToolDefinition<typeof args> = {
+  name: "get-metric",
+  description: `Fetches one metric's configuration.`,
+  scopes: ["read"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await metricsGet(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/metricsList.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { metricsList } from "../../funcs/metricsList.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetMetricsRequest$inboundSchema,
+};
+
+export const tool$metricsList: ToolDefinition<typeof args> = {
+  name: "list-metrics",
+  description:
+    `Lists metrics in a project. Use to find metric keys to attach to an experiment.`,
+  scopes: ["read"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await metricsList(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/metricsPatch.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { metricsPatch } from "../../funcs/metricsPatch.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.PatchMetricRequest$inboundSchema,
+};
+
+export const tool$metricsPatch: ToolDefinition<typeof args> = {
+  name: "update-metric",
+  description: `Updates a metric using a JSON patch.`,
+  scopes: ["write"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await metricsPatch(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/models/components/aiconfig.ts

@@ -32,6 +32,12 @@ import {
   AIConfigVariation$Outbound,
   AIConfigVariation$outboundSchema,
 } from "./aiconfigvariation.js";
+import {
+  CoreLink,
+  CoreLink$inboundSchema,
+  CoreLink$Outbound,
+  CoreLink$outboundSchema,
+} from "./corelink.js";
 import {
   ParentAndSelfLinks,
   ParentAndSelfLinks$inboundSchema,
@@ -39,11 +45,17 @@ import {
   ParentAndSelfLinks$outboundSchema,
 } from "./parentandselflinks.js";
 
+/**
+ * The AI Config mode
+ */
 export const AIConfigMode = {
   Agent: "agent",
   Completion: "completion",
   Judge: "judge",
 } as const;
+/**
+ * The AI Config mode
+ */
 export type AIConfigMode = ClosedEnum<typeof AIConfigMode>;
 
 export type AIConfig = {
@@ -52,22 +64,47 @@ export type AIConfig = {
    * The location and content type of related resources
    */
   links?: ParentAndSelfLinks | undefined;
+  site?: CoreLink | undefined;
+  /**
+   * A description of the AI Config
+   */
   description: string;
+  /**
+   * The AI Config key
+   */
   key: string;
+  /**
+   * The member or team that maintains this resource
+   */
   maintainer?: AIConfigMaintainer | undefined;
+  /**
+   * The AI Config mode
+   */
   mode?: AIConfigMode | undefined;
+  /**
+   * The AI Config name
+   */
   name: string;
+  /**
+   * Tags for this resource
+   */
   tags: Array<string>;
+  /**
+   * The version number of this resource
+   */
   version: number;
+  /**
+   * The variations of this AI Config
+   */
   variations: Array<AIConfigVariation>;
   createdAt: number;
   updatedAt: number;
   /**
-   * Evaluation metric key for this AI Config
+   * Evaluation metric key for this config
    */
   evaluationMetricKey?: string | undefined;
   /**
-   * List of evaluation metric keys for this AI Config
+   * List of evaluation metric keys for this config
    *
    * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
@@ -77,7 +114,7 @@ export type AIConfig = {
    */
   isInverted?: boolean | undefined;
   /**
-   * Resources that depend on this AI Config, grouped by type
+   * Resources that depend on this config, grouped by type
    */
   dependencies?: Array<AIConfigDependency> | undefined;
 };
@@ -97,6 +134,7 @@ export const AIConfig$inboundSchema: z.ZodType<
 > = z.object({
   _access: AiConfigsAccess$inboundSchema.optional(),
   _links: ParentAndSelfLinks$inboundSchema.optional(),
+  _site: CoreLink$inboundSchema.optional(),
   description: z.string(),
   key: z.string(),
   _maintainer: AIConfigMaintainer$inboundSchema.optional(),
@@ -115,6 +153,7 @@ export const AIConfig$inboundSchema: z.ZodType<
   return remap$(v, {
     "_access": "access",
     "_links": "links",
+    "_site": "site",
     "_maintainer": "maintainer",
   });
 });
@@ -122,6 +161,7 @@ export const AIConfig$inboundSchema: z.ZodType<
 export type AIConfig$Outbound = {
   _access?: AiConfigsAccess$Outbound | undefined;
   _links?: ParentAndSelfLinks$Outbound | undefined;
+  _site?: CoreLink$Outbound | undefined;
   description: string;
   key: string;
   _maintainer?: AIConfigMaintainer$Outbound | undefined;
@@ -146,6 +186,7 @@ export const AIConfig$outboundSchema: z.ZodType<
 > = z.object({
   access: AiConfigsAccess$outboundSchema.optional(),
   links: ParentAndSelfLinks$outboundSchema.optional(),
+  site: CoreLink$outboundSchema.optional(),
   description: z.string(),
   key: z.string(),
   maintainer: AIConfigMaintainer$outboundSchema.optional(),
@@ -164,6 +205,7 @@ export const AIConfig$outboundSchema: z.ZodType<
   return remap$(v, {
     access: "_access",
     links: "_links",
+    site: "_site",
     maintainer: "_maintainer",
   });
 });

package/src/models/components/aiconfigdependency.ts

@@ -20,7 +20,7 @@ export const AIConfigDependencyType = {
 export type AIConfigDependencyType = ClosedEnum<typeof AIConfigDependencyType>;
 
 /**
- * A resource that depends on this AI Config
+ * A resource that depends on this config
  */
 export type AIConfigDependency = {
   /**

package/src/models/components/aiconfigmaintainer.ts

@@ -9,20 +9,44 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AiConfigsMaintainerTeam = {
+  /**
+   * The team key
+   */
   key: string;
+  /**
+   * The team name
+   */
   name: string;
   kind: string;
 };
 
 export type MaintainerMember = {
+  /**
+   * The member ID
+   */
   id: string;
+  /**
+   * The member email address
+   */
   email: string;
+  /**
+   * The member first name
+   */
   firstName?: string | undefined;
+  /**
+   * The member last name
+   */
   lastName?: string | undefined;
+  /**
+   * The member role
+   */
   role: string;
   kind: string;
 };
 
+/**
+ * The member or team that maintains this resource
+ */
 export type AIConfigMaintainer = MaintainerMember | AiConfigsMaintainerTeam;
 
 /** @internal */

package/src/models/components/aiconfigpatch.ts

@@ -8,13 +8,32 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AIConfigPatch = {
+  /**
+   * Key of the variation this config serves by default
+   */
+  defaultVariationKey?: string | undefined;
+  /**
+   * A description of the AI Config
+   */
   description?: string | undefined;
+  /**
+   * The ID of the member who maintains this resource
+   */
   maintainerId?: string | undefined;
+  /**
+   * The key of the team that maintains this resource
+   */
   maintainerTeamKey?: string | undefined;
+  /**
+   * A human-readable name for the AI Config
+   */
   name?: string | undefined;
+  /**
+   * Tags for this resource
+   */
   tags?: Array<string> | undefined;
   /**
-   * Evaluation metric key for this AI Config
+   * Evaluation metric key for this config
    */
   evaluationMetricKey?: string | undefined;
   /**
@@ -29,6 +48,7 @@ export const AIConfigPatch$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  defaultVariationKey: z.string().optional(),
   description: z.string().optional(),
   maintainerId: z.string().optional(),
   maintainerTeamKey: z.string().optional(),
@@ -39,6 +59,7 @@ export const AIConfigPatch$inboundSchema: z.ZodType<
 });
 /** @internal */
 export type AIConfigPatch$Outbound = {
+  defaultVariationKey?: string | undefined;
   description?: string | undefined;
   maintainerId?: string | undefined;
   maintainerTeamKey?: string | undefined;
@@ -54,6 +75,7 @@ export const AIConfigPatch$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   AIConfigPatch
 > = z.object({
+  defaultVariationKey: z.string().optional(),
   description: z.string().optional(),
   maintainerId: z.string().optional(),
   maintainerTeamKey: z.string().optional(),

package/src/models/components/aiconfigpost.ts

@@ -14,24 +14,55 @@ import {
   AIConfigVariationPost$outboundSchema,
 } from "./aiconfigvariationpost.js";
 
+/**
+ * The AI Config mode
+ */
 export const AIConfigPostMode = {
   Agent: "agent",
   Completion: "completion",
   Judge: "judge",
 } as const;
+/**
+ * The AI Config mode
+ */
 export type AIConfigPostMode = ClosedEnum<typeof AIConfigPostMode>;
 
 export type AIConfigPost = {
+  /**
+   * A description of the AI Config
+   */
   description?: string | undefined;
+  /**
+   * A unique key for the AI Config
+   */
   key: string;
+  /**
+   * The ID of the member who maintains this resource
+   */
   maintainerId?: string | undefined;
+  /**
+   * The key of the team that maintains this resource
+   */
   maintainerTeamKey?: string | undefined;
+  /**
+   * The AI Config mode
+   */
   mode?: AIConfigPostMode | undefined;
+  /**
+   * A human-readable name for the AI Config
+   */
   name: string;
+  /**
+   * Tags for this resource
+   */
   tags?: Array<string> | undefined;
+  /**
+   * Keys of the views to add the AI Config to
+   */
+  viewKeys?: Array<string> | undefined;
   defaultVariation?: AIConfigVariationPost | undefined;
   /**
-   * Evaluation metric key for this AI Config
+   * Evaluation metric key for this config
    */
   evaluationMetricKey?: string | undefined;
   /**
@@ -62,6 +93,7 @@ export const AIConfigPost$inboundSchema: z.ZodType<
   mode: AIConfigPostMode$inboundSchema.default("completion"),
   name: z.string(),
   tags: z.array(z.string()).optional(),
+  viewKeys: z.array(z.string()).optional(),
   defaultVariation: AIConfigVariationPost$inboundSchema.optional(),
   evaluationMetricKey: z.string().optional(),
   isInverted: z.boolean().optional(),
@@ -75,6 +107,7 @@ export type AIConfigPost$Outbound = {
   mode: string;
   name: string;
   tags?: Array<string> | undefined;
+  viewKeys?: Array<string> | undefined;
   defaultVariation?: AIConfigVariationPost$Outbound | undefined;
   evaluationMetricKey?: string | undefined;
   isInverted?: boolean | undefined;
@@ -93,6 +126,7 @@ export const AIConfigPost$outboundSchema: z.ZodType<
   mode: AIConfigPostMode$outboundSchema.default("completion"),
   name: z.string(),
   tags: z.array(z.string()).optional(),
+  viewKeys: z.array(z.string()).optional(),
   defaultVariation: AIConfigVariationPost$outboundSchema.optional(),
   evaluationMetricKey: z.string().optional(),
   isInverted: z.boolean().optional(),

package/src/models/components/aiconfigs.ts

@@ -22,7 +22,13 @@ import {
 
 export type AIConfigs = {
   links?: PaginatedLinks | undefined;
+  /**
+   * The items on this page
+   */
   items: Array<AIConfig>;
+  /**
+   * The total number of items
+   */
   totalCount: number;
 };