@launchdarkly/mcp-server 0.7.1 → 0.7.2

package/src/models/components/experimentcollectionrep.ts

@@ -0,0 +1,91 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+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 {
+  Experiment,
+  Experiment$inboundSchema,
+  Experiment$Outbound,
+  Experiment$outboundSchema,
+} from "./experiment.js";
+import {
+  Link,
+  Link$inboundSchema,
+  Link$Outbound,
+  Link$outboundSchema,
+} from "./link.js";
+
+export type ExperimentCollectionRep = {
+  /**
+   * An array of experiments
+   */
+  items: Array<Experiment>;
+  /**
+   * The total number of experiments in this project and environment. Does not include legacy experiments.
+   */
+  totalCount?: number | undefined;
+  /**
+   * The location and content type of related resources
+   */
+  links?: { [k: string]: Link } | undefined;
+};
+
+/** @internal */
+export const ExperimentCollectionRep$inboundSchema: z.ZodType<
+  ExperimentCollectionRep,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  items: z.array(Experiment$inboundSchema),
+  total_count: z.number().int().optional(),
+  _links: z.record(Link$inboundSchema).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "total_count": "totalCount",
+    "_links": "links",
+  });
+});
+/** @internal */
+export type ExperimentCollectionRep$Outbound = {
+  items: Array<Experiment$Outbound>;
+  total_count?: number | undefined;
+  _links?: { [k: string]: Link$Outbound } | undefined;
+};
+
+/** @internal */
+export const ExperimentCollectionRep$outboundSchema: z.ZodType<
+  ExperimentCollectionRep$Outbound,
+  z.ZodTypeDef,
+  ExperimentCollectionRep
+> = z.object({
+  items: z.array(Experiment$outboundSchema),
+  totalCount: z.number().int().optional(),
+  links: z.record(Link$outboundSchema).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    totalCount: "total_count",
+    links: "_links",
+  });
+});
+
+export function experimentCollectionRepToJSON(
+  experimentCollectionRep: ExperimentCollectionRep,
+): string {
+  return JSON.stringify(
+    ExperimentCollectionRep$outboundSchema.parse(experimentCollectionRep),
+  );
+}
+export function experimentCollectionRepFromJSON(
+  jsonString: string,
+): SafeParseResult<ExperimentCollectionRep, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ExperimentCollectionRep$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ExperimentCollectionRep' from JSON`,
+  );
+}

package/src/models/components/experimentpatchinput.ts

@@ -0,0 +1,58 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+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";
+
+export type ExperimentPatchInput = {
+  /**
+   * Optional comment describing the update
+   */
+  comment?: string | undefined;
+  instructions: Array<{ [k: string]: any }>;
+};
+
+/** @internal */
+export const ExperimentPatchInput$inboundSchema: z.ZodType<
+  ExperimentPatchInput,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  comment: z.string().optional(),
+  instructions: z.array(z.record(z.any())),
+});
+/** @internal */
+export type ExperimentPatchInput$Outbound = {
+  comment?: string | undefined;
+  instructions: Array<{ [k: string]: any }>;
+};
+
+/** @internal */
+export const ExperimentPatchInput$outboundSchema: z.ZodType<
+  ExperimentPatchInput$Outbound,
+  z.ZodTypeDef,
+  ExperimentPatchInput
+> = z.object({
+  comment: z.string().optional(),
+  instructions: z.array(z.record(z.any())),
+});
+
+export function experimentPatchInputToJSON(
+  experimentPatchInput: ExperimentPatchInput,
+): string {
+  return JSON.stringify(
+    ExperimentPatchInput$outboundSchema.parse(experimentPatchInput),
+  );
+}
+export function experimentPatchInputFromJSON(
+  jsonString: string,
+): SafeParseResult<ExperimentPatchInput, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ExperimentPatchInput$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ExperimentPatchInput' from JSON`,
+  );
+}

package/src/models/components/experimentpost.ts

@@ -0,0 +1,196 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+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 {
+  AnalysisConfigInput,
+  AnalysisConfigInput$inboundSchema,
+  AnalysisConfigInput$Outbound,
+  AnalysisConfigInput$outboundSchema,
+} from "./analysisconfiginput.js";
+import {
+  IterationInput,
+  IterationInput$inboundSchema,
+  IterationInput$Outbound,
+  IterationInput$outboundSchema,
+} from "./iterationinput.js";
+
+/**
+ * The results analysis approach. Defaults to "frequentist" when not provided, or "bayesian" for multi-armed bandit experiments.
+ */
+export const ExperimentPostMethodology = {
+  Bayesian: "bayesian",
+  Frequentist: "frequentist",
+  ExportOnly: "export_only",
+} as const;
+/**
+ * The results analysis approach. Defaults to "frequentist" when not provided, or "bayesian" for multi-armed bandit experiments.
+ */
+export type ExperimentPostMethodology = ClosedEnum<
+  typeof ExperimentPostMethodology
+>;
+
+/**
+ * The source of metric data in order to analyze results. Defaults to "launchdarkly" when not provided.
+ */
+export const ExperimentPostDataSource = {
+  Launchdarkly: "launchdarkly",
+  Snowflake: "snowflake",
+} as const;
+/**
+ * The source of metric data in order to analyze results. Defaults to "launchdarkly" when not provided.
+ */
+export type ExperimentPostDataSource = ClosedEnum<
+  typeof ExperimentPostDataSource
+>;
+
+/**
+ * The type of experiment.
+ */
+export const ExperimentPostType = {
+  Experiment: "experiment",
+  Mab: "mab",
+  Holdout: "holdout",
+} as const;
+/**
+ * The type of experiment.
+ */
+export type ExperimentPostType = ClosedEnum<typeof ExperimentPostType>;
+
+export type ExperimentPost = {
+  /**
+   * The experiment name
+   */
+  name: string;
+  /**
+   * The experiment description
+   */
+  description?: string | undefined;
+  /**
+   * The ID of the member who maintains this experiment
+   */
+  maintainerId?: string | undefined;
+  /**
+   * The experiment key
+   */
+  key: string;
+  iteration: IterationInput;
+  /**
+   * The ID of the holdout
+   */
+  holdoutId?: string | undefined;
+  /**
+   * Tags for the experiment
+   */
+  tags?: Array<string> | undefined;
+  /**
+   * The results analysis approach. Defaults to "frequentist" when not provided, or "bayesian" for multi-armed bandit experiments.
+   */
+  methodology?: ExperimentPostMethodology | undefined;
+  analysisConfig?: AnalysisConfigInput | undefined;
+  /**
+   * The source of metric data in order to analyze results. Defaults to "launchdarkly" when not provided.
+   */
+  dataSource?: ExperimentPostDataSource | undefined;
+  /**
+   * The type of experiment.
+   */
+  type?: ExperimentPostType | undefined;
+};
+
+/** @internal */
+export const ExperimentPostMethodology$inboundSchema: z.ZodNativeEnum<
+  typeof ExperimentPostMethodology
+> = z.nativeEnum(ExperimentPostMethodology);
+/** @internal */
+export const ExperimentPostMethodology$outboundSchema: z.ZodNativeEnum<
+  typeof ExperimentPostMethodology
+> = ExperimentPostMethodology$inboundSchema;
+
+/** @internal */
+export const ExperimentPostDataSource$inboundSchema: z.ZodNativeEnum<
+  typeof ExperimentPostDataSource
+> = z.nativeEnum(ExperimentPostDataSource);
+/** @internal */
+export const ExperimentPostDataSource$outboundSchema: z.ZodNativeEnum<
+  typeof ExperimentPostDataSource
+> = ExperimentPostDataSource$inboundSchema;
+
+/** @internal */
+export const ExperimentPostType$inboundSchema: z.ZodNativeEnum<
+  typeof ExperimentPostType
+> = z.nativeEnum(ExperimentPostType);
+/** @internal */
+export const ExperimentPostType$outboundSchema: z.ZodNativeEnum<
+  typeof ExperimentPostType
+> = ExperimentPostType$inboundSchema;
+
+/** @internal */
+export const ExperimentPost$inboundSchema: z.ZodType<
+  ExperimentPost,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string(),
+  description: z.string().optional(),
+  maintainerId: z.string().optional(),
+  key: z.string(),
+  iteration: IterationInput$inboundSchema,
+  holdoutId: z.string().optional(),
+  tags: z.array(z.string()).optional(),
+  methodology: ExperimentPostMethodology$inboundSchema.optional(),
+  analysisConfig: AnalysisConfigInput$inboundSchema.optional(),
+  dataSource: ExperimentPostDataSource$inboundSchema.optional(),
+  type: ExperimentPostType$inboundSchema.optional(),
+});
+/** @internal */
+export type ExperimentPost$Outbound = {
+  name: string;
+  description?: string | undefined;
+  maintainerId?: string | undefined;
+  key: string;
+  iteration: IterationInput$Outbound;
+  holdoutId?: string | undefined;
+  tags?: Array<string> | undefined;
+  methodology?: string | undefined;
+  analysisConfig?: AnalysisConfigInput$Outbound | undefined;
+  dataSource?: string | undefined;
+  type?: string | undefined;
+};
+
+/** @internal */
+export const ExperimentPost$outboundSchema: z.ZodType<
+  ExperimentPost$Outbound,
+  z.ZodTypeDef,
+  ExperimentPost
+> = z.object({
+  name: z.string(),
+  description: z.string().optional(),
+  maintainerId: z.string().optional(),
+  key: z.string(),
+  iteration: IterationInput$outboundSchema,
+  holdoutId: z.string().optional(),
+  tags: z.array(z.string()).optional(),
+  methodology: ExperimentPostMethodology$outboundSchema.optional(),
+  analysisConfig: AnalysisConfigInput$outboundSchema.optional(),
+  dataSource: ExperimentPostDataSource$outboundSchema.optional(),
+  type: ExperimentPostType$outboundSchema.optional(),
+});
+
+export function experimentPostToJSON(experimentPost: ExperimentPost): string {
+  return JSON.stringify(ExperimentPost$outboundSchema.parse(experimentPost));
+}
+export function experimentPostFromJSON(
+  jsonString: string,
+): SafeParseResult<ExperimentPost, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ExperimentPost$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ExperimentPost' from JSON`,
+  );
+}

package/src/models/components/featureflag.ts

@@ -62,6 +62,12 @@ import {
   MemberSummary$Outbound,
   MemberSummary$outboundSchema,
 } from "./membersummary.js";
+import {
+  StaleFlagData,
+  StaleFlagData$inboundSchema,
+  StaleFlagData$Outbound,
+  StaleFlagData$outboundSchema,
+} from "./staleflagdata.js";
 import {
   Variation,
   Variation$inboundSchema,
@@ -157,6 +163,7 @@ export type FeatureFlag = {
   defaults?: Defaults | undefined;
   purpose?: string | undefined;
   migrationSettings?: FlagMigrationSettingsRep | undefined;
+  stale?: StaleFlagData | undefined;
   /**
    * Details on the environments for this flag. Only returned if the request is filtered by environment, using the <code>filterEnv</code> query parameter.
    */
@@ -204,6 +211,7 @@ export const FeatureFlag$inboundSchema: z.ZodType<
   defaults: Defaults$inboundSchema.optional(),
   _purpose: z.string().optional(),
   migrationSettings: FlagMigrationSettingsRep$inboundSchema.optional(),
+  stale: StaleFlagData$inboundSchema.optional(),
   environments: z.record(FeatureFlagConfig$inboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {
@@ -242,6 +250,7 @@ export type FeatureFlag$Outbound = {
   defaults?: Defaults$Outbound | undefined;
   _purpose?: string | undefined;
   migrationSettings?: FlagMigrationSettingsRep$Outbound | undefined;
+  stale?: StaleFlagData$Outbound | undefined;
   environments?: { [k: string]: FeatureFlagConfig$Outbound } | undefined;
 };
 
@@ -277,6 +286,7 @@ export const FeatureFlag$outboundSchema: z.ZodType<
   defaults: Defaults$outboundSchema.optional(),
   purpose: z.string().optional(),
   migrationSettings: FlagMigrationSettingsRep$outboundSchema.optional(),
+  stale: StaleFlagData$outboundSchema.optional(),
   environments: z.record(FeatureFlagConfig$outboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {

package/src/models/components/featureflagconfig.ts

@@ -106,11 +106,11 @@ export type FeatureFlagConfig = {
    */
   environmentName: string;
   /**
-   * Whether LaunchDarkly tracks events for the feature flag, for all rules
+   * Whether the SDK sends a detailed event for every evaluation of this flag, across all rules, instead of only summary counts. Required for Data Export, but doesn't enable Data Export on its own.
    */
   trackEvents: boolean;
   /**
-   * Whether LaunchDarkly tracks events for the feature flag, for the default rule
+   * Whether the SDK sends a detailed event for every evaluation of this flag's default rule, instead of only summary counts. Required for Data Export, but doesn't enable Data Export on its own.
    */
   trackEventsFallthrough: boolean;
   debugEventsUntilDate?: number | undefined;

package/src/models/components/flaginput.ts

@@ -0,0 +1,64 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+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";
+
+export type FlagInput = {
+  /**
+   * The ID of the variation or rollout of the flag to use. Use "fallthrough" for the default targeting behavior when the flag is on.
+   */
+  ruleId: string;
+  /**
+   * The flag version
+   */
+  flagConfigVersion: number;
+  /**
+   * The ID of the variation to route traffic not part of the experiment analysis to. Defaults to variation ID of baseline treatment, if set.
+   */
+  notInExperimentVariationId?: string | undefined;
+};
+
+/** @internal */
+export const FlagInput$inboundSchema: z.ZodType<
+  FlagInput,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  ruleId: z.string(),
+  flagConfigVersion: z.number().int(),
+  notInExperimentVariationId: z.string().optional(),
+});
+/** @internal */
+export type FlagInput$Outbound = {
+  ruleId: string;
+  flagConfigVersion: number;
+  notInExperimentVariationId?: string | undefined;
+};
+
+/** @internal */
+export const FlagInput$outboundSchema: z.ZodType<
+  FlagInput$Outbound,
+  z.ZodTypeDef,
+  FlagInput
+> = z.object({
+  ruleId: z.string(),
+  flagConfigVersion: z.number().int(),
+  notInExperimentVariationId: z.string().optional(),
+});
+
+export function flagInputToJSON(flagInput: FlagInput): string {
+  return JSON.stringify(FlagInput$outboundSchema.parse(flagInput));
+}
+export function flagInputFromJSON(
+  jsonString: string,
+): SafeParseResult<FlagInput, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => FlagInput$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'FlagInput' from JSON`,
+  );
+}

package/src/models/components/flaglistingrep.ts

@@ -0,0 +1,82 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+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 {
+  Link,
+  Link$inboundSchema,
+  Link$Outbound,
+  Link$outboundSchema,
+} from "./link.js";
+
+export type FlagListingRep = {
+  /**
+   * The flag name
+   */
+  name: string;
+  /**
+   * The flag key
+   */
+  key: string;
+  links?: { [k: string]: Link } | undefined;
+  site?: Link | undefined;
+};
+
+/** @internal */
+export const FlagListingRep$inboundSchema: z.ZodType<
+  FlagListingRep,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string(),
+  key: z.string(),
+  _links: z.record(Link$inboundSchema).optional(),
+  _site: Link$inboundSchema.optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "_links": "links",
+    "_site": "site",
+  });
+});
+/** @internal */
+export type FlagListingRep$Outbound = {
+  name: string;
+  key: string;
+  _links?: { [k: string]: Link$Outbound } | undefined;
+  _site?: Link$Outbound | undefined;
+};
+
+/** @internal */
+export const FlagListingRep$outboundSchema: z.ZodType<
+  FlagListingRep$Outbound,
+  z.ZodTypeDef,
+  FlagListingRep
+> = z.object({
+  name: z.string(),
+  key: z.string(),
+  links: z.record(Link$outboundSchema).optional(),
+  site: Link$outboundSchema.optional(),
+}).transform((v) => {
+  return remap$(v, {
+    links: "_links",
+    site: "_site",
+  });
+});
+
+export function flagListingRepToJSON(flagListingRep: FlagListingRep): string {
+  return JSON.stringify(FlagListingRep$outboundSchema.parse(flagListingRep));
+}
+export function flagListingRepFromJSON(
+  jsonString: string,
+): SafeParseResult<FlagListingRep, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => FlagListingRep$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'FlagListingRep' from JSON`,
+  );
+}

package/src/models/components/flagrep.ts

@@ -0,0 +1,97 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+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 {
+  Link,
+  Link$inboundSchema,
+  Link$Outbound,
+  Link$outboundSchema,
+} from "./link.js";
+
+export type FlagRep = {
+  /**
+   * The targeting rule
+   */
+  targetingRule?: string | undefined;
+  /**
+   * The rule description
+   */
+  targetingRuleDescription?: string | undefined;
+  /**
+   * An array of clauses used for individual targeting based on attributes
+   */
+  targetingRuleClauses?: Array<any> | undefined;
+  /**
+   * The flag version
+   */
+  flagConfigVersion?: number | undefined;
+  /**
+   * The ID of the variation to route traffic not part of the experiment analysis to
+   */
+  notInExperimentVariationId?: string | undefined;
+  /**
+   * The location and content type of related resources
+   */
+  links: { [k: string]: Link };
+};
+
+/** @internal */
+export const FlagRep$inboundSchema: z.ZodType<FlagRep, z.ZodTypeDef, unknown> =
+  z.object({
+    targetingRule: z.string().optional(),
+    targetingRuleDescription: z.string().optional(),
+    targetingRuleClauses: z.array(z.any()).optional(),
+    flagConfigVersion: z.number().int().optional(),
+    notInExperimentVariationId: z.string().optional(),
+    _links: z.record(Link$inboundSchema),
+  }).transform((v) => {
+    return remap$(v, {
+      "_links": "links",
+    });
+  });
+/** @internal */
+export type FlagRep$Outbound = {
+  targetingRule?: string | undefined;
+  targetingRuleDescription?: string | undefined;
+  targetingRuleClauses?: Array<any> | undefined;
+  flagConfigVersion?: number | undefined;
+  notInExperimentVariationId?: string | undefined;
+  _links: { [k: string]: Link$Outbound };
+};
+
+/** @internal */
+export const FlagRep$outboundSchema: z.ZodType<
+  FlagRep$Outbound,
+  z.ZodTypeDef,
+  FlagRep
+> = z.object({
+  targetingRule: z.string().optional(),
+  targetingRuleDescription: z.string().optional(),
+  targetingRuleClauses: z.array(z.any()).optional(),
+  flagConfigVersion: z.number().int().optional(),
+  notInExperimentVariationId: z.string().optional(),
+  links: z.record(Link$outboundSchema),
+}).transform((v) => {
+  return remap$(v, {
+    links: "_links",
+  });
+});
+
+export function flagRepToJSON(flagRep: FlagRep): string {
+  return JSON.stringify(FlagRep$outboundSchema.parse(flagRep));
+}
+export function flagRepFromJSON(
+  jsonString: string,
+): SafeParseResult<FlagRep, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => FlagRep$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'FlagRep' from JSON`,
+  );
+}