@launchdarkly/mcp-server 0.7.0 → 0.7.2

package/src/models/components/aiconfigsmetricdenominatorrep.ts

@@ -0,0 +1,139 @@
+/*
+ * 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";
+import {
+  AiConfigsFilter,
+  AiConfigsFilter$inboundSchema,
+  AiConfigsFilter$Outbound,
+  AiConfigsFilter$outboundSchema,
+} from "./aiconfigsfilter.js";
+import {
+  AiConfigsMetricDataSourceRefRep,
+  AiConfigsMetricDataSourceRefRep$inboundSchema,
+  AiConfigsMetricDataSourceRefRep$Outbound,
+  AiConfigsMetricDataSourceRefRep$outboundSchema,
+} from "./aiconfigsmetricdatasourcerefrep.js";
+
+export type AiConfigsMetricDenominatorRep = {
+  /**
+   * The warehouse event column for the denominator
+   */
+  eventName?: string | undefined;
+  /**
+   * Whether the denominator aggregates a numeric value
+   */
+  isNumeric?: boolean | undefined;
+  /**
+   * How individual unit values are aggregated for the denominator
+   */
+  unitAggregationType?: string | undefined;
+  /**
+   * The column to count distinct values of; required when unitAggregationType is count_distinct
+   */
+  unitAggregationField?: string | undefined;
+  /**
+   * For a numeric denominator, the column holding the numeric value
+   */
+  valueColumn?: string | undefined;
+  dataSource?: AiConfigsMetricDataSourceRefRep | undefined;
+  filters?: AiConfigsFilter | undefined;
+  /**
+   * Start of the measurement window in milliseconds
+   */
+  windowStartOffset?: number | undefined;
+  /**
+   * End of the measurement window in milliseconds
+   */
+  windowEndOffset?: number | undefined;
+  /**
+   * Lower winsorization percentile in the open interval (0, 100)
+   */
+  winsorLowerPercentile?: number | undefined;
+  /**
+   * Upper winsorization percentile in the open interval (0, 100)
+   */
+  winsorUpperPercentile?: number | undefined;
+  /**
+   * When true, the percentile bound calculation includes imputed zeros
+   */
+  winsorIncludeImputed?: boolean | undefined;
+};
+
+/** @internal */
+export const AiConfigsMetricDenominatorRep$inboundSchema: z.ZodType<
+  AiConfigsMetricDenominatorRep,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  eventName: z.string().optional(),
+  isNumeric: z.boolean().optional(),
+  unitAggregationType: z.string().optional(),
+  unitAggregationField: z.string().optional(),
+  valueColumn: z.string().optional(),
+  dataSource: AiConfigsMetricDataSourceRefRep$inboundSchema.optional(),
+  filters: AiConfigsFilter$inboundSchema.optional(),
+  windowStartOffset: z.number().int().optional(),
+  windowEndOffset: z.number().int().optional(),
+  winsorLowerPercentile: z.number().optional(),
+  winsorUpperPercentile: z.number().optional(),
+  winsorIncludeImputed: z.boolean().optional(),
+});
+/** @internal */
+export type AiConfigsMetricDenominatorRep$Outbound = {
+  eventName?: string | undefined;
+  isNumeric?: boolean | undefined;
+  unitAggregationType?: string | undefined;
+  unitAggregationField?: string | undefined;
+  valueColumn?: string | undefined;
+  dataSource?: AiConfigsMetricDataSourceRefRep$Outbound | undefined;
+  filters?: AiConfigsFilter$Outbound | undefined;
+  windowStartOffset?: number | undefined;
+  windowEndOffset?: number | undefined;
+  winsorLowerPercentile?: number | undefined;
+  winsorUpperPercentile?: number | undefined;
+  winsorIncludeImputed?: boolean | undefined;
+};
+
+/** @internal */
+export const AiConfigsMetricDenominatorRep$outboundSchema: z.ZodType<
+  AiConfigsMetricDenominatorRep$Outbound,
+  z.ZodTypeDef,
+  AiConfigsMetricDenominatorRep
+> = z.object({
+  eventName: z.string().optional(),
+  isNumeric: z.boolean().optional(),
+  unitAggregationType: z.string().optional(),
+  unitAggregationField: z.string().optional(),
+  valueColumn: z.string().optional(),
+  dataSource: AiConfigsMetricDataSourceRefRep$outboundSchema.optional(),
+  filters: AiConfigsFilter$outboundSchema.optional(),
+  windowStartOffset: z.number().int().optional(),
+  windowEndOffset: z.number().int().optional(),
+  winsorLowerPercentile: z.number().optional(),
+  winsorUpperPercentile: z.number().optional(),
+  winsorIncludeImputed: z.boolean().optional(),
+});
+
+export function aiConfigsMetricDenominatorRepToJSON(
+  aiConfigsMetricDenominatorRep: AiConfigsMetricDenominatorRep,
+): string {
+  return JSON.stringify(
+    AiConfigsMetricDenominatorRep$outboundSchema.parse(
+      aiConfigsMetricDenominatorRep,
+    ),
+  );
+}
+export function aiConfigsMetricDenominatorRepFromJSON(
+  jsonString: string,
+): SafeParseResult<AiConfigsMetricDenominatorRep, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AiConfigsMetricDenominatorRep$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AiConfigsMetricDenominatorRep' from JSON`,
+  );
+}

package/src/models/components/aiconfigsmetriclistingrep.ts

@@ -38,6 +38,12 @@ import {
   AiConfigsMetricDataSourceRefRep$Outbound,
   AiConfigsMetricDataSourceRefRep$outboundSchema,
 } from "./aiconfigsmetricdatasourcerefrep.js";
+import {
+  AiConfigsMetricDenominatorRep,
+  AiConfigsMetricDenominatorRep$inboundSchema,
+  AiConfigsMetricDenominatorRep$Outbound,
+  AiConfigsMetricDenominatorRep$outboundSchema,
+} from "./aiconfigsmetricdenominatorrep.js";
 import {
   AiConfigsMetricEventDefaultRep,
   AiConfigsMetricEventDefaultRep$inboundSchema,
@@ -58,6 +64,7 @@ export const AiConfigsMetricListingRepKind = {
   Pageview: "pageview",
   Click: "click",
   Custom: "custom",
+  Trace: "trace",
 } as const;
 /**
  * The kind of event the metric tracks
@@ -67,14 +74,14 @@ export type AiConfigsMetricListingRepKind = ClosedEnum<
 >;
 
 /**
- * For custom metrics, the success criteria
+ * For custom and trace metrics, the success criteria
  */
 export const AiConfigsMetricListingRepSuccessCriteria = {
   HigherThanBaseline: "HigherThanBaseline",
   LowerThanBaseline: "LowerThanBaseline",
 } as const;
 /**
- * For custom metrics, the success criteria
+ * For custom and trace metrics, the success criteria
  */
 export type AiConfigsMetricListingRepSuccessCriteria = ClosedEnum<
   typeof AiConfigsMetricListingRepSuccessCriteria
@@ -86,6 +93,7 @@ export type AiConfigsMetricListingRepSuccessCriteria = ClosedEnum<
 export const AiConfigsMetricListingRepUnitAggregationType = {
   Average: "average",
   Sum: "sum",
+  CountDistinct: "count_distinct",
 } as const;
 /**
  * The method by which multiple unit event values are aggregated
@@ -187,15 +195,15 @@ export type AiConfigsMetricListingRep = {
    */
   category?: string | undefined;
   /**
-   * For custom metrics, whether to track numeric changes in value against a baseline (<code>true</code>) or to track a conversion when an end user takes an action (<code>false</code>).
+   * For custom and trace metrics, whether to track numeric changes in value against a baseline (<code>true</code>) or to track a conversion when an end user takes an action (<code>false</code>).
    */
   isNumeric?: boolean | undefined;
   /**
-   * For custom metrics, the success criteria
+   * For custom and trace metrics, the success criteria
    */
   successCriteria?: AiConfigsMetricListingRepSuccessCriteria | undefined;
   /**
-   * For numeric custom metrics, the unit of measure
+   * For numeric custom and trace metrics, the unit of measure
    */
   unit?: string | undefined;
   /**
@@ -203,9 +211,15 @@ export type AiConfigsMetricListingRep = {
    */
   eventKey?: string | undefined;
   /**
-   * An array of randomization units allowed for this metric
+   * Deprecated, use <code>analysisUnits</code> instead.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   randomizationUnits?: Array<string> | undefined;
+  /**
+   * An array of analysis units allowed for this metric.
+   */
+  analysisUnits?: Array<string> | undefined;
   filters?: AiConfigsFilter | undefined;
   /**
    * The method by which multiple unit event values are aggregated
@@ -234,6 +248,39 @@ export type AiConfigsMetricListingRep = {
    */
   selector?: string | undefined;
   urls?: Array<{ [k: string]: any }> | undefined;
+  /**
+   * Not yet implemented - The start of the measurement window, in milliseconds relative to the unit's first exposure to a flag variation
+   */
+  windowStartOffset?: number | undefined;
+  /**
+   * Not yet implemented - The end of the measurement window, in milliseconds relative to the unit's first exposure to a flag variation
+   */
+  windowEndOffset?: number | undefined;
+  /**
+   * Lower winsorization percentile, expressed as a percent in the open interval (0, 100). When both bounds are set, defines a two-sided clamp range. Otherwise lower-only winsorization.
+   */
+  winsorLowerPercentile?: number | undefined;
+  /**
+   * Upper winsorization percentile, expressed as a percent in the open interval (0, 100). When both bounds are set, must be greater than winsorLowerPercentile.
+   */
+  winsorUpperPercentile?: number | undefined;
+  /**
+   * When true, the percentile bound calculation includes imputed zeros. Only meaningful when at least one bound is set and the metric includes units that didn't send events.
+   */
+  winsorIncludeImputed?: boolean | undefined;
+  /**
+   * For trace metrics, the trace query to use for the metric.
+   */
+  traceQuery?: string | undefined;
+  /**
+   * For trace metrics, the location in the trace to use for numeric values.
+   */
+  traceValueLocation?: string | undefined;
+  /**
+   * For count_distinct metrics, the column to count distinct values of
+   */
+  unitAggregationField?: string | undefined;
+  denominator?: AiConfigsMetricDenominatorRep | undefined;
 };
 
 /** @internal */
@@ -308,6 +355,7 @@ export const AiConfigsMetricListingRep$inboundSchema: z.ZodType<
   unit: z.string().optional(),
   eventKey: z.string().optional(),
   randomizationUnits: z.array(z.string()).optional(),
+  analysisUnits: z.array(z.string()).optional(),
   filters: AiConfigsFilter$inboundSchema.optional(),
   unitAggregationType:
     AiConfigsMetricListingRepUnitAggregationType$inboundSchema.optional(),
@@ -320,6 +368,15 @@ export const AiConfigsMetricListingRep$inboundSchema: z.ZodType<
   archivedAt: z.number().int().optional(),
   selector: z.string().optional(),
   urls: z.array(z.record(z.any())).optional(),
+  windowStartOffset: z.number().int().optional(),
+  windowEndOffset: z.number().int().optional(),
+  winsorLowerPercentile: z.number().optional(),
+  winsorUpperPercentile: z.number().optional(),
+  winsorIncludeImputed: z.boolean().optional(),
+  traceQuery: z.string().optional(),
+  traceValueLocation: z.string().optional(),
+  unitAggregationField: z.string().optional(),
+  denominator: AiConfigsMetricDenominatorRep$inboundSchema.optional(),
 }).transform((v) => {
   return remap$(v, {
     "_id": "id",
@@ -363,6 +420,7 @@ export type AiConfigsMetricListingRep$Outbound = {
   unit?: string | undefined;
   eventKey?: string | undefined;
   randomizationUnits?: Array<string> | undefined;
+  analysisUnits?: Array<string> | undefined;
   filters?: AiConfigsFilter$Outbound | undefined;
   unitAggregationType?: string | undefined;
   analysisType?: string | undefined;
@@ -374,6 +432,15 @@ export type AiConfigsMetricListingRep$Outbound = {
   archivedAt?: number | undefined;
   selector?: string | undefined;
   urls?: Array<{ [k: string]: any }> | undefined;
+  windowStartOffset?: number | undefined;
+  windowEndOffset?: number | undefined;
+  winsorLowerPercentile?: number | undefined;
+  winsorUpperPercentile?: number | undefined;
+  winsorIncludeImputed?: boolean | undefined;
+  traceQuery?: string | undefined;
+  traceValueLocation?: string | undefined;
+  unitAggregationField?: string | undefined;
+  denominator?: AiConfigsMetricDenominatorRep$Outbound | undefined;
 };
 
 /** @internal */
@@ -411,6 +478,7 @@ export const AiConfigsMetricListingRep$outboundSchema: z.ZodType<
   unit: z.string().optional(),
   eventKey: z.string().optional(),
   randomizationUnits: z.array(z.string()).optional(),
+  analysisUnits: z.array(z.string()).optional(),
   filters: AiConfigsFilter$outboundSchema.optional(),
   unitAggregationType:
     AiConfigsMetricListingRepUnitAggregationType$outboundSchema.optional(),
@@ -423,6 +491,15 @@ export const AiConfigsMetricListingRep$outboundSchema: z.ZodType<
   archivedAt: z.number().int().optional(),
   selector: z.string().optional(),
   urls: z.array(z.record(z.any())).optional(),
+  windowStartOffset: z.number().int().optional(),
+  windowEndOffset: z.number().int().optional(),
+  winsorLowerPercentile: z.number().optional(),
+  winsorUpperPercentile: z.number().optional(),
+  winsorIncludeImputed: z.boolean().optional(),
+  traceQuery: z.string().optional(),
+  traceValueLocation: z.string().optional(),
+  unitAggregationField: z.string().optional(),
+  denominator: AiConfigsMetricDenominatorRep$outboundSchema.optional(),
 }).transform((v) => {
   return remap$(v, {
     id: "_id",

package/src/models/components/aiconfigtargeting.ts

@@ -38,12 +38,30 @@ export type AIConfigTargeting = {
    */
   createdAt: number;
   defaults?: AIConfigTargetingDefaults | undefined;
+  /**
+   * Targeting for each environment, keyed by environment key
+   */
   environments: { [k: string]: AIConfigTargetingEnvironment };
   experiments: AiConfigsExperimentInfoRep;
+  /**
+   * The AI Config key
+   */
   key: string;
+  /**
+   * The AI Config name
+   */
   name: string;
+  /**
+   * Tags for this resource
+   */
   tags: Array<string>;
+  /**
+   * The variations of this AI Config
+   */
   variations: Array<AIConfigTargetingVariation>;
+  /**
+   * The version number of this resource
+   */
   version: number;
 };
 

package/src/models/components/aiconfigtargetingdefaults.ts

@@ -8,7 +8,13 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AIConfigTargetingDefaults = {
+  /**
+   * Index of the variation served when targeting is on
+   */
   onVariation: number;
+  /**
+   * Index of the variation served when targeting is off
+   */
   offVariation: number;
 };
 

package/src/models/components/aiconfigtargetingenvironment.ts

@@ -27,16 +27,43 @@ import {
 } from "./aiconfigtargetingenvironmenttarget.js";
 
 export type AIConfigTargetingEnvironment = {
+  /**
+   * Individual context targets for non-user context kinds
+   */
   contextTargets: Array<AIConfigTargetingEnvironmentTarget>;
+  /**
+   * Whether targeting is on in this environment
+   */
   enabled: boolean;
   fallthrough: AIConfigTargetingEnvironmentFallthrough;
   lastModified: number;
+  /**
+   * Index of the variation served when targeting is off
+   */
   offVariation?: number | undefined;
+  /**
+   * The targeting rules
+   */
   rules: Array<AIConfigTargetingEnvironmentRule>;
+  /**
+   * Individual user targets
+   */
   targets: Array<AIConfigTargetingEnvironmentTarget>;
+  /**
+   * Whether to send detailed events for all evaluations
+   */
   trackEvents: boolean;
+  /**
+   * Whether to send detailed events for evaluations that fall through to the default rule
+   */
   trackEventsFallthrough: boolean;
+  /**
+   * The environment name
+   */
   environmentName: string;
+  /**
+   * The version of the targeting in this environment
+   */
   version: number;
 };
 

package/src/models/components/aiconfigtargetingenvironmentfallthrough.ts

@@ -14,6 +14,9 @@ import {
 } from "./aiconfigtargetingenvironmentfallthroughrollout.js";
 
 export type AIConfigTargetingEnvironmentFallthrough = {
+  /**
+   * Index of the variation served by the default rule
+   */
   variation?: number | undefined;
   rollout?: AIConfigTargetingEnvironmentFallthroughRollout | undefined;
 };

package/src/models/components/aiconfigtargetingenvironmentfallthroughrollout.ts

@@ -20,12 +20,24 @@ import {
 } from "./aiconfigtargetingenvironmentfallthroughrolloutvariation.js";
 
 export type AIConfigTargetingEnvironmentFallthroughRollout = {
+  /**
+   * The context attribute used to bucket contexts
+   */
   bucketBy?: string | undefined;
+  /**
+   * The context kind used to bucket contexts
+   */
   contextKind: string;
   experimentAllocation?:
     | AIConfigTargetingEnvironmentFallthroughRolloutExperimentationAllocation
     | undefined;
+  /**
+   * The seed used for bucketing
+   */
   seed?: number | undefined;
+  /**
+   * The variations and their weights
+   */
   variations: Array<AIConfigTargetingEnvironmentFallthroughRolloutVariation>;
 };
 

package/src/models/components/aiconfigtargetingenvironmentfallthroughrolloutexperimentationallocation.ts

@@ -9,8 +9,17 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AIConfigTargetingEnvironmentFallthroughRolloutExperimentationAllocation =
   {
+    /**
+     * Whether contexts can be reassigned to new buckets
+     */
     canReshuffle: boolean;
+    /**
+     * Index of the default variation
+     */
     defaultVariation: number;
+    /**
+     * The allocation type
+     */
     type: string;
   };
 

package/src/models/components/aiconfigtargetingenvironmentfallthroughrolloutvariation.ts

@@ -9,8 +9,17 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AIConfigTargetingEnvironmentFallthroughRolloutVariation = {
+  /**
+   * Whether this variation is excluded from experiment tracking
+   */
   untracked?: boolean | undefined;
+  /**
+   * Index of the variation
+   */
   variation: number;
+  /**
+   * The weight of this variation, in thousandths of a percent
+   */
   weight: number;
 };
 

package/src/models/components/aiconfigtargetingenvironmentrule.ts

@@ -14,7 +14,13 @@ import {
 } from "./aiconfigtargetingenvironmentruleclause.js";
 
 export type AIConfigTargetingEnvironmentRule = {
+  /**
+   * The clauses a context must match
+   */
   clauses: Array<AIConfigTargetingEnvironmentRuleClause>;
+  /**
+   * Whether to send detailed events for evaluations that match this rule
+   */
   trackEvents: boolean;
 };
 

package/src/models/components/aiconfigtargetingenvironmentruleclause.ts

@@ -8,10 +8,25 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AIConfigTargetingEnvironmentRuleClause = {
+  /**
+   * The context attribute to match
+   */
   attribute: string;
+  /**
+   * The clause ID
+   */
   id: string;
+  /**
+   * Whether to negate the match
+   */
   negate: boolean;
+  /**
+   * The operator to use
+   */
   op: string;
+  /**
+   * The values to match against
+   */
   values: Array<any>;
 };
 

package/src/models/components/aiconfigtargetingenvironmenttarget.ts

@@ -8,8 +8,17 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AIConfigTargetingEnvironmentTarget = {
+  /**
+   * The context kind
+   */
   contextKind: string;
+  /**
+   * The context keys to target
+   */
   values: Array<string>;
+  /**
+   * Index of the variation to serve
+   */
   variation: number;
 };
 

package/src/models/components/aiconfigtargetingpatch.ts

@@ -8,8 +8,17 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AIConfigTargetingPatch = {
+  /**
+   * A comment describing the change
+   */
   comment?: string | undefined;
+  /**
+   * The environment key
+   */
   environmentKey: string;
+  /**
+   * The semantic patch instructions to apply
+   */
   instructions: Array<{ [k: string]: any }>;
 };
 

package/src/models/components/aiconfigtargetingvariation.ts

@@ -15,9 +15,21 @@ import {
 } from "./aiconfigtargetingvariationvalue.js";
 
 export type AIConfigTargetingVariation = {
+  /**
+   * The variation ID
+   */
   id: string;
+  /**
+   * A description of the variation
+   */
   description: string;
+  /**
+   * The variation name
+   */
   name: string;
+  /**
+   * The variation value
+   */
   value: AIConfigTargetingVariationValue;
 };
 

package/src/models/components/aiconfigtargetingvariationvalue.ts

@@ -13,6 +13,9 @@ import {
   AIConfigTargetingVariationJSON$outboundSchema,
 } from "./aiconfigtargetingvariationjson.js";
 
+/**
+ * The variation value
+ */
 export type AIConfigTargetingVariationValue =
   | boolean
   | AIConfigTargetingVariationJSON