@groundcover/api-client 0.20.0 → 0.22.0

package/dist/_generated/types.gen.d.ts

@@ -53,6 +53,13 @@ export type AgentLlmProviderConfig = {
      * Provider-compatible endpoint base URL, if configured.
      */
     baseUrl?: string;
+    /**
+     * Static provider configured by LLM_PROVIDER. Null when dummy_provider marks
+     * a deployment without a managed default. This is response-only metadata and
+     * is not part of AgentLLMProviderConfigRequest.
+     * Nullable: true
+     */
+    defaultProvider?: string | null;
     /**
      * Whether an API key secret ref is configured.
      */
@@ -330,6 +337,24 @@ export type AssertionSeverity = string;
  * AssertionSource defines model for Assertion.Source.
  */
 export type AssertionSource = string;
+export type AssetExclusion = {
+    /**
+     * The type of the excluded asset.
+     */
+    asset_type: string;
+    /**
+     * When the asset was excluded.
+     */
+    excluded_at: string;
+    /**
+     * Email of the user who excluded the asset.
+     */
+    excluded_by: string;
+    /**
+     * The provider's asset identifier.
+     */
+    source_resource_id: string;
+};
 export type AssetFetchResult = {
     /**
      * Error code if the fetch failed (e.g., "RATE_LIMITED", "UNAUTHORIZED").
@@ -442,7 +467,7 @@ export type AssetInstallResult = {
     /**
      * The status of the installation.
      */
-    status: 'installed' | 'already_installed' | 'not_found' | 'not_convertible' | 'failed';
+    status: 'installed' | 'already_installed' | 'not_found' | 'not_convertible' | 'failed' | 'excluded';
 };
 export type AssetItem = {
     /**
@@ -502,6 +527,14 @@ export type AssetListItem = {
      * Format: date-time
      */
     discovered_at?: string;
+    /**
+     * When the asset was excluded. Absent when not excluded.
+     */
+    excluded_at?: string;
+    /**
+     * Email of the user who excluded this asset from the migration. Absent when not excluded.
+     */
+    excluded_by?: string;
     /**
      * The groundcover resource ID if installed.
      */
@@ -582,6 +615,14 @@ export type AssetMetadata = {
      * Monitor-specific: the beautified type of the monitor.
      */
     type?: string;
+    /**
+     * Dashboard-specific: Datadog-recorded views at fetch time.
+     */
+    viewCount?: number;
+    /**
+     * Dashboard-specific: new fetches use 1 (least viewed) through 5 (most viewed), based on log-scaled view counts.
+     */
+    viewRank?: number;
 };
 export type AssetSummaryResponseItem = {
     /**
@@ -773,6 +814,24 @@ export type BaseQuery = {
     rollup?: Rollup;
     sqlPipeline?: SqlPipeline;
 };
+export type BatchDashboardsError = {
+    /**
+     * Code mirrors the single-route ErrorResponse.code contract so the UI can
+     * branch the same way: set to VIEW_REVISION_CONFLICT when the item lost a
+     * write race (retry the item), empty for permanent per-item failures.
+     */
+    code?: string;
+    id?: string;
+    reason?: string;
+};
+export type BatchDashboardsRequest = {
+    dashboardUuids: Array<string>;
+};
+export type BatchDashboardsResponse = {
+    errors?: Array<BatchDashboardsError>;
+    failedCount?: number;
+    updatedCount?: number;
+};
 export type BatchGetMonitorsError = {
     message?: string;
     uuid?: string;
@@ -788,6 +847,36 @@ export type BatchGetMonitorsResponse = {
         [key: string]: string;
     };
 };
+/**
+ * BatchReadMonitorsV2Response is the v2 twin of BatchGetMonitorsResponse: the
+ * stored entity (envelope + spec) per uuid instead of YAML text, with the same
+ * per-uuid partial success — a miss lands in Errors and never fails the batch.
+ */
+export type BatchReadMonitorsV2Response = {
+    errors?: Array<BatchGetMonitorsError>;
+    failedCount?: number;
+    fetchedCount?: number;
+    monitors?: {
+        [key: string]: V2MonitorEntity;
+    };
+};
+export type BatchUpdateDashboardTagsRequest = {
+    dashboardUuids: Array<string>;
+    /**
+     * Tags to append to each dashboard. Entries are trimmed and exact-case
+     * deduplicated. At least one of tagsToAdd or tagsToRemove must be non-empty
+     * after normalization, and the two lists must not share a tag (400
+     * otherwise). 1000 is a resource-exhaustion bound, not a product tag limit:
+     * MAX_TAGS_PER_VIEW applies to each dashboard's resulting set
+     * (too_many_tags), not to the delta lists.
+     */
+    tagsToAdd?: Array<string>;
+    /**
+     * Tags to remove from each dashboard. Same normalization and disjointness
+     * rules as tagsToAdd; removing a tag a dashboard does not carry is a no-op.
+     */
+    tagsToRemove?: Array<string>;
+};
 export type BucketDurationSeconds = number;
 /**
  * CatalogInstallRequest is the optional body for a catalog install.
@@ -2253,6 +2342,57 @@ export type CustomRule = {
     name: string;
     retention: string;
 };
+/**
+ * DBMMeasurementsSearchRequest queries raw statement measurement intervals.
+ *
+ * A GCQL query is required. count() counts intervals;
+ * sum(calls) counts database executions.
+ */
+export type DbmMeasurementsSearchRequest = {
+    /**
+     * End time of the request range
+     */
+    end: string;
+    query: string;
+    sources?: Array<Condition>;
+    /**
+     * Start time of the request range
+     */
+    start: string;
+};
+export type DbmMeasurementsSearchTimeSeriesRequest = {
+    /**
+     * Positive interval used to group measurements into time buckets.
+     */
+    bucketDuration: string;
+    /**
+     * End time of the request range
+     */
+    end: string;
+    /**
+     * Empty buckets contain null unless fillValue is supplied.
+     */
+    fillValue?: number;
+    query: string;
+    sources?: Array<Condition>;
+    /**
+     * Start time of the request range
+     */
+    start: string;
+    valueField?: string;
+};
+/**
+ * DDMetricInactiveBucket counts units whose only unmet metric dependency is
+ * confirmed inactive/missing in Datadog itself, tagging every metric involved
+ * (a unit can mix a confirmed-inactive metric with a self-observability one;
+ * see unitMissingMetricsAreDDInactiveOnly). Datadog itself never had data for
+ * these metrics, so groundcover correctly has none either — a genuine,
+ * successful migration outcome, not a gap to fix.
+ */
+export type DdMetricInactiveBucket = {
+    count?: number;
+    metrics?: Array<TaggedMetric>;
+};
 /**
  * DashboardFiltersRequest is the POST /api/dashboards/filters request body.
  */
@@ -2678,14 +2818,21 @@ export type EventsSearchTimeSeriesRequest = {
 };
 /**
  * ExcludedBucket counts units held out of the funnel because their only unmet
- * dependency is Datadog's own telemetry: a self-observability metric, or one
- * already inactive in Datadog. Migration quality has no bearing on either —
- * they were never going to return data — so they are reported separately
- * rather than weighing on supported/unsupported like a real gap would.
+ * dependency is Datadog's own telemetry: a self-observability metric. Migration
+ * quality has no bearing on it — it was never going to return data — so it is
+ * reported separately rather than weighing on supported/unsupported like a
+ * real gap would.
+ *
+ * A unit confirmed inactive in Datadog (IssueDDInactiveOrMissing) no longer
+ * lands here — see StageDDMetricInactive and DDMetricInactiveBucket, its own
+ * green success bucket under SupportedConverted. The former InactiveInDatadog
+ * field here was removed rather than kept as an always-zero counter: nothing
+ * outside this package ever read it (the funnelviz decoder only reads Total,
+ * and the CLI summary printer never printed Excluded at all), so there was no
+ * reader to preserve compatibility for.
  */
 export type ExcludedBucket = {
     datadog_self_observability?: MetricListBucket;
-    inactive_in_datadog?: MetricListBucket;
     total?: number;
 };
 /**
@@ -2738,6 +2885,19 @@ export type ExportCapture = {
      */
     fullscreen?: boolean;
 };
+/**
+ * ExportMonitorsV2Request is the POST /api/v2/monitors/export body.
+ */
+export type ExportMonitorsV2Request = {
+    /**
+     * Format names the emitted resource.
+     */
+    format: 'terraform';
+    /**
+     * UUIDs of the monitors to export, rendered in this order.
+     */
+    uuids: Array<string>;
+};
 /**
  * ExportRequestBody represents the request body proxied to export-service.
  */
@@ -2870,6 +3030,13 @@ export type Finding = {
     integration?: string;
     issue_type?: IssueType;
     label_key?: string;
+    /**
+     * LabelKeyDD is the Datadog-side name of LabelKey, set only when a mapping
+     * rule renamed it. Callers that match a finding against manifest filters —
+     * which carry Datadog names — need both, because a rename makes the two
+     * namespaces diverge and a GC-only comparison silently stops matching.
+     */
+    label_key_dd?: string;
     label_value?: string;
     label_values?: Array<string>;
     labels_used?: {
@@ -2889,11 +3056,21 @@ export type Finding = {
  */
 export type FunnelAssetEntry = {
     asset_id?: string;
+    /**
+     * AssetKind names the unsupported widget/monitor type when the unit never
+     * reached conversion, e.g. "heatmap" or "slo".
+     */
+    asset_kind?: string;
     asset_name?: string;
     asset_type?: string;
     metrics?: Array<string>;
     missing_keys?: Array<string>;
     missing_values?: Array<string>;
+    /**
+     * PrimaryDataset is the one missing dataset the unit is counted under, when
+     * the terminal stage is a missing-dataset gap.
+     */
+    primary_dataset?: string;
     queries?: Array<ExecutedQuery>;
     reason?: string;
     stage?: string;
@@ -2997,7 +3174,7 @@ export type GetEventsOverTimeRequest = {
     /**
      * Field to sort events by.
      */
-    sortBy: 'timestamp' | 'namespace' | 'instance' | 'object_kind' | 'firstSeen' | 'lastSeen' | 'type' | 'reason' | 'count' | 'workload' | 'cluster';
+    sortBy: 'timestamp' | 'namespace' | 'instance' | 'object_kind' | 'firstSeen' | 'lastSeen' | 'type' | 'reason' | 'message' | 'count' | 'workload' | 'cluster';
     /**
      * Sort order.
      */
@@ -3203,6 +3380,10 @@ export type InstallAssetsResponse = {
      * The number of assets that were already installed.
      */
     alreadyInstalledCount?: number;
+    /**
+     * The number of assets that were not installed because they are excluded.
+     */
+    excludedCount?: number;
     /**
      * The number of assets that failed to install.
      */
@@ -3769,6 +3950,10 @@ export type ListAssetsByTypeResponse = {
      * List of assets.
      */
     items?: Array<AssetListItem>;
+    /**
+     * True when this router supports view-rank sorting for dashboards. Older routers omit it.
+     */
+    supports_view_rank_sort?: boolean;
     /**
      * Total number of assets.
      */
@@ -4080,6 +4265,13 @@ export type LogsRequestParams = {
     query?: string;
     selectors?: Array<Selector>;
     skip?: number;
+    /**
+     * SortBy is the column/attribute key to order by. Empty means order by
+     * timestamp (the historical behavior). Any root column or attribute is
+     * allowed; string columns are sorted best-effort numerically with a
+     * lexicographic fallback (see search.BuildOrderByColumn).
+     */
+    sortBy?: string;
     sortOrder?: string;
     sources?: Array<Condition>;
     /**
@@ -4326,6 +4518,11 @@ export type MemberView = {
     originId?: string;
     originType?: string;
     owner?: string;
+    /**
+     * PinOrder is the member's pin weight, higher sorts first; nil when not
+     * pinned. The client owns the numbering, so ties and gaps are possible.
+     */
+    pinOrder?: number;
     preset?: string;
     revisionNumber?: number;
     status?: string;
@@ -4672,7 +4869,8 @@ export type MigrationDataSourceItem = {
      * (AWS / GCP / Azure) this is prefixed with the cloud label and a
      * space, e.g. "AWS 123456789012", "GCP sa@my-prod.iam.gserviceaccount.com",
      * "Azure prod-azure-tenant". For non-cloud integrations it is the raw
-     * source-provider integration name (e.g. "redis", "kubelet").
+     * source-provider integration name (e.g. "redis", "kubelet"); ordinary
+     * unmapped customer metrics are grouped under "Custom Metrics".
      */
     datasourceName: string;
     /**
@@ -4692,7 +4890,8 @@ export type MigrationDataSourceItem = {
      */
     impactedMonitorsCount: number;
     /**
-     * The matching groundcover integration type, or null when unsupported or unmapped.
+     * The matching groundcover integration type. Ordinary unmapped customer
+     * metrics use "custom_metrics"; null is reserved for unsupported vendor telemetry.
      */
     integrationType?: string | null;
     /**
@@ -5092,6 +5291,11 @@ export type OpsGenieData = {
     severity_mapping?: {
         [key: string]: string;
     };
+    /**
+     * Tags added to every alert sent through this destination. Supports up to 20
+     * non-empty tags of at most 50 Unicode characters.
+     */
+    tags?: Array<string>;
 };
 export type OpsGenieDataResponse = {
     /**
@@ -5104,6 +5308,11 @@ export type OpsGenieDataResponse = {
     severity_mapping?: {
         [key: string]: string;
     };
+    /**
+     * Tags added to every alert sent through this destination. Supports up to 20
+     * non-empty tags of at most 50 Unicode characters.
+     */
+    tags?: Array<string>;
 };
 /**
  * OrderedReasons is a list of reason→count pairs that marshals as a JSON object
@@ -5212,6 +5421,32 @@ export type PatternParamDistributionValue = {
     patternParamValueCount?: number;
     patternParamValuePercentage?: number;
 };
+/**
+ * PinViewRequest is the body of POST /api/views/{id}/pin.
+ */
+export type PinViewRequest = {
+    /**
+     * Order is this view's weight in the member's pin list: higher sorts first,
+     * so send the highest order currently pinned + 1 to put the new pin on top.
+     * Do not send the length of the visible list — archiving clears pins
+     * without packing the numbers, so a length can collide with a live pin.
+     * The client owns the numbering, so the server stores it as sent. It is
+     * int32 to match the pin_order column: a wider value would decode fine here
+     * and then fail at encode time as a 500.
+     */
+    order: number;
+};
+/**
+ * PinnedResource is one entry of a member's ordered pin list. PinOrder is
+ * exposed so a client that only reads this endpoint can still compute the next
+ * pin's number without also fetching the dashboards list.
+ */
+export type PinnedResource = {
+    name?: string;
+    pinOrder?: number;
+    resourceType?: string;
+    resourceUuid?: string;
+};
 /**
  * Policy defines an access control policy.
  */
@@ -5283,9 +5518,13 @@ export type PositiveNoDataBucket = {
     pct?: number;
 };
 /**
- * PreflightReport is the top-level structured output of a preflight validation run.
+ * PreflightReportResponse is the preflight report plus backend-only counters.
  */
-export type PreflightReport = {
+export type PreflightReportResponse = {
+    /**
+     * AssetsReextracted counts assets converted before converted_queries was stored; a non-zero value means the tenant needs a reconvert.
+     */
+    assets_reextracted?: number;
     coverage_plan?: CoveragePlan;
     funnel_by_asset?: FunnelByAsset;
     /**
@@ -5315,6 +5554,47 @@ export type Processor = {
     args?: Array<unknown>;
     op?: string;
 };
+/**
+ * FlameNode contains inclusive and self weight in the selected sample unit.
+ */
+export type ProfilingFlameNode = {
+    children?: Array<ProfilingFlameNode>;
+    name?: string;
+    /**
+     * Omitted identifies a synthetic bucket, distinct from a real frame named other.
+     */
+    omitted?: boolean;
+    self?: number;
+    value?: number;
+};
+export type ProfilingFlamegraphResponse = {
+    filteredValue?: number;
+    period?: ProfilingPeriod;
+    profileType?: string;
+    root?: ProfilingFlameNode;
+    sampleType?: string;
+    stacks?: ProfilingStackCounts;
+    total?: number;
+    truncated?: boolean;
+    unit?: string;
+};
+export type ProfilingPeriod = {
+    end?: string;
+    start?: string;
+};
+/**
+ * StackCounts counts aggregated stacks, not samples or rendered tree nodes.
+ */
+export type ProfilingStackCounts = {
+    /**
+     * Stacks included in the tree before depth, node, and small-branch compaction.
+     */
+    returned?: number;
+    /**
+     * Matching aggregated stacks before the top-stack limit or result truncation.
+     */
+    total?: number;
+};
 /**
  * PromqlFunction represents a function call in a PromQL query.
  */
@@ -5870,7 +6150,7 @@ export type SearchValuesRequest = {
     /**
      * Type of the search values
      */
-    type: 'logs' | 'traces' | 'events' | 'issues' | 'entities' | 'apm' | 'ingestion_measurements' | 'monitors' | 'aws_cur' | 'dashboards';
+    type: 'logs' | 'traces' | 'events' | 'issues' | 'entities' | 'apm' | 'ingestion_measurements' | 'dbm_measurements_statement' | 'monitors' | 'aws_cur' | 'dashboards' | 'profiling_samples';
 };
 export type SearchValuesRequestV2 = {
     /**
@@ -6183,6 +6463,19 @@ export type SessionsSummaryResponse = {
     totalSessions?: number;
     uniqueUsers?: number;
 };
+/**
+ * SetMemberPinsOrderRequest is the body of PUT /api/views/member/pins/order.
+ */
+export type SetMemberPinsOrderRequest = {
+    /**
+     * Ids is the pinned resource UUIDs first-to-last, as the list should
+     * render. Send the member's whole pin list: pins left out keep their old
+     * number, and an id that is not pinned is dropped before numbering, so the
+     * survivors are numbered N..1 with no gaps. No length cap: pins are
+     * uncapped too, and the whole list must fit in one request to keep order.
+     */
+    ids: Array<string>;
+};
 /**
  * Severity represents the severity level for warnings, alerts, etc.
  */
@@ -6474,6 +6767,7 @@ export type SuggestionReason = {
  */
 export type SupportedConvertedBucket = {
     data_set_available?: DataSetAvailableBucket;
+    dd_metric_inactive?: DdMetricInactiveBucket;
     missing_underlying_data_set?: MissingDataSetBucket;
     no_data_needed?: NoDataNeededBucket;
     total?: number;
@@ -6674,6 +6968,10 @@ export type TenantResponse = {
     TenantName?: string;
     Used?: number;
 };
+/**
+ * TerraformDocument is one HCL document.
+ */
+export type TerraformDocument = string;
 export type TestConnectedAppRequest = {
     /**
      * The ID of an existing connected app (optional).
@@ -7813,6 +8111,13 @@ export type UsedByResponse = {
      */
     type?: string;
 };
+/**
+ * Channel identifies a Slack channel.
+ */
+export type V2Channel = {
+    id?: string;
+    name?: string;
+};
 export type V2CreateSilenceRequest = {
     /**
      * Optional comment
@@ -7854,6 +8159,206 @@ export type V2CreateSilenceRequest = {
      */
     type: 'one_time' | 'recurring';
 };
+/**
+ * DestinationApp carries at most one delivery-options block. The spec cannot
+ * check the block against the app id's integration type; the write service does.
+ */
+export type V2DestinationApp = {
+    id?: string;
+    linear?: V2LinearDeliveryOptions;
+    slack?: V2SlackDeliveryOptions;
+};
+/**
+ * Destinations is direct delivery. StatusFilters omitted = all.
+ */
+export type V2Destinations = {
+    apps?: Array<V2DestinationApp>;
+    statusFilters?: Array<IssueStatus>;
+};
+/**
+ * EvaluationInterval carries the evaluation cadence and pending window. The
+ * prom_duration tag param is the example in the error text, not a bound; the
+ * real bounds are struct-level rules.
+ */
+export type V2EvaluationInterval = {
+    /**
+     * Whole seconds, >= 1m (plus rollup floors — see the struct-level rules).
+     */
+    interval?: string;
+    /**
+     * nil = default applied on read. Whole seconds.
+     */
+    pendingFor?: string;
+};
+/**
+ * FiringThreshold is the static-threshold condition. Values cardinality is
+ * per-operator: 1 scalar, 2 ascending.
+ */
+export type V2FiringThreshold = {
+    operator?: string;
+    recovery?: V2RecoveryThreshold;
+    values?: Array<number>;
+};
+/**
+ * IssueDisplay controls how the resulting issue is rendered.
+ */
+export type V2IssueDisplay = {
+    contextLabels?: Array<string>;
+    description?: string;
+    templateLanguage?: string;
+    title?: string;
+};
+/**
+ * LinearDeliveryOptions requires TeamID when present. Delivery treats an
+ * omitted ResolveTicket as true, so ResolvedStatusID is required unless it is
+ * explicitly false.
+ */
+export type V2LinearDeliveryOptions = {
+    assigneeId?: string;
+    delegateId?: string;
+    labelIds?: Array<string>;
+    projectId?: string;
+    resolveTicket?: boolean;
+    resolvedStatusId?: string;
+    teamId?: string;
+};
+/**
+ * V2MonitorEntity is the wire shape of one monitor in the batch-read
+ * response: the envelope fields callers use, plus the spec. A type of its
+ * own, not model.Monitor — a column added to that storage row does not
+ * automatically reach this response.
+ */
+export type V2MonitorEntity = {
+    backendId?: string;
+    createdAt?: string;
+    createdByEmail?: string;
+    grafanaMonitorId?: string;
+    isProvisioned?: boolean;
+    originId?: string;
+    originType?: string;
+    spec?: V2MonitorSpec;
+    updatedAt?: string;
+    uuid?: string;
+};
+/**
+ * Model wraps the single query and the thresholds list, capped at one item.
+ */
+export type V2MonitorModel = {
+    query?: V2Query;
+    thresholds?: Array<V2ThresholdSpec>;
+};
+/**
+ * MonitorSpec is the v2 monitor document. Value = required outright.
+ * Pointer = optional: nil means the author omitted it, and that intent is
+ * PRESERVED in the stored document — defaults are applied on read, never
+ * baked in at write.
+ *
+ * The validate tags include custom ones registered only by this package.
+ * Validate through ValidateSpec — a bare validator panics.
+ */
+export type V2MonitorSpec = {
+    /**
+     * Deprecated: workflows-only. Reserved _gc_* keys are rejected.
+     */
+    annotations?: {
+        [key: string]: string;
+    };
+    /**
+     * nil = default (true) applied on read.
+     */
+    autoResolve?: boolean;
+    /**
+     * Category is free-form — the built-ins use Infrastructure|API|… but custom
+     * values exist in the fleet, so there is no enum. "" is omitted/no-data.
+     */
+    category?: string;
+    evaluationErrorState?: string;
+    evaluationInterval?: V2EvaluationInterval;
+    evaluationNoDataState?: string;
+    isPaused?: boolean;
+    issueDisplay?: V2IssueDisplay;
+    /**
+     * Reserved _gc_* keys are rejected.
+     */
+    labels?: {
+        [key: string]: string;
+    };
+    /**
+     * MeasurementType switches the timeline query builder; nil = derived on read.
+     */
+    measurementType?: string;
+    model?: V2MonitorModel;
+    name?: string;
+    notificationSettings?: V2NotificationSettings;
+    /**
+     * Severity is "" when omitted; that intent is preserved, defaults are
+     * applied on read.
+     */
+    severity?: string;
+    /**
+     * Tags are free-form; items must not be blank.
+     */
+    tags?: Array<string>;
+    team?: string;
+    /**
+     * Type is the dataType; query language and datasource are inferred from it.
+     * monitor_type defers to the registry — see registry.go for the set.
+     */
+    type?: string;
+};
+/**
+ * NoNotifications is the suppress-everything mode marker.
+ */
+export type V2NoNotifications = {
+    [key: string]: unknown;
+};
+/**
+ * NotificationRoutes is the route-based delivery mode marker.
+ */
+export type V2NotificationRoutes = {
+    [key: string]: unknown;
+};
+/**
+ * NotificationSettings requires exactly one mode block; there is no default.
+ *
+ * The renotification knobs apply to any mode.
+ */
+export type V2NotificationSettings = {
+    destinations?: V2Destinations;
+    disableRenotification?: boolean;
+    noNotifications?: V2NoNotifications;
+    notificationRoutes?: V2NotificationRoutes;
+    renotificationInterval?: string;
+};
+/**
+ * Query is the whole expression, in the language MonitorSpec.Type implies.
+ */
+export type V2Query = {
+    /**
+     * Shifts the eval window back, length unchanged. Whole seconds, at most 7d.
+     * Rejected where Rollup is.
+     */
+    evaluationDelay?: string;
+    expression?: string;
+    /**
+     * Lookback window: whole seconds, positive. Required when the type has a
+     * time axis, rejected otherwise (sql, timeless datasets).
+     */
+    rollup?: string;
+    /**
+     * Required iff metrics, rejected otherwise.
+     */
+    rollupFunction?: string;
+};
+/**
+ * RecoveryThreshold is the hysteresis condition; its region must not overlap
+ * the firing one. Operator is the author's choice from the recovery-capable
+ * set — required, never defaulted.
+ */
+export type V2RecoveryThreshold = {
+    operator?: string;
+    values?: Array<number>;
+};
 export type V2SilenceResponse = {
     active?: boolean;
     comment?: string;
@@ -7893,6 +8398,18 @@ export type V2SilencesListResponse = {
      */
     silences?: Array<V2SilenceResponse>;
 };
+/**
+ * SlackDeliveryOptions requires a non-empty Channels when present.
+ */
+export type V2SlackDeliveryOptions = {
+    channels?: Array<V2Channel>;
+};
+/**
+ * ThresholdSpec is one condition block; Firing is its only arm today.
+ */
+export type V2ThresholdSpec = {
+    firing?: V2FiringThreshold;
+};
 export type V2UpdateSilenceRequest = {
     comment?: string;
     /**
@@ -7938,6 +8455,7 @@ export type ValueItem = {
     value?: string;
 };
 export type ValueMapping = {
+    evidence?: MappingEvidence;
     /**
      * GroundcoverKey is derived from SourceKey and the applicable key mapping.
      * It is returned for display but is never applied as a separate key-mapping rule.
@@ -7952,6 +8470,10 @@ export type ValueMapping = {
      * It is not supported for logs, traces, or events.
      */
     metric_pattern?: string;
+    /**
+     * Origin is server-owned normalization provenance.
+     */
+    readonly origin?: string;
     /**
      * SourceKey is the exact Datadog key whose value should be mapped.
      */
@@ -8477,7 +8999,7 @@ export type MappingConfigWritable = {
     metric_name_char_replace?: {
         [key: string]: string;
     };
-    value_mappings?: Array<ValueMapping>;
+    value_mappings?: Array<ValueMappingWritable>;
 };
 export type MappingResponseWritable = {
     config?: MappingConfigWritable;
@@ -8552,6 +9074,31 @@ export type UpdateMappingsRequestWritable = {
      */
     version: number;
 };
+export type ValueMappingWritable = {
+    evidence?: MappingEvidence;
+    /**
+     * GroundcoverKey is derived from SourceKey and the applicable key mapping.
+     * It is returned for display but is never applied as a separate key-mapping rule.
+     */
+    groundcover_key?: string;
+    /**
+     * GroundcoverValue is the replacement value in the converted query.
+     */
+    groundcover_value: string;
+    /**
+     * MetricPattern optionally scopes this mapping to groundcover metric names (not source metric names).
+     * It is not supported for logs, traces, or events.
+     */
+    metric_pattern?: string;
+    /**
+     * SourceKey is the exact Datadog key whose value should be mapped.
+     */
+    source_key: string;
+    /**
+     * SourceValue is the exact Datadog value to replace.
+     */
+    source_value: string;
+};
 export type AgentSkillRequest2 = AgentSkillRequest;
 export type CreateUpdateLogsPipelineConfigRequest2 = CreateUpdateLogsPipelineConfigRequest;
 export type StorageManagementPolicyRequest2 = StorageManagementPolicyRequest;
@@ -11154,6 +11701,66 @@ export type UpdateMetricsPipelineConfigResponses = {
     200: MetricsPipelineConfigInfo;
 };
 export type UpdateMetricsPipelineConfigResponse = UpdateMetricsPipelineConfigResponses[keyof UpdateMetricsPipelineConfigResponses];
+export type GetProfilingFlamegraphData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Start time of the request range
+         */
+        start: string;
+        /**
+         * End time of the request range
+         */
+        end: string;
+        /**
+         * GCQL filter expression pinning workload, profile_type, and sample_type.
+         */
+        query: string;
+        /**
+         * Maximum distinct stacks. Defaults to 6000 and is capped at 50000.
+         */
+        limit?: number;
+    };
+    url: '/api/profiling/flamegraph';
+};
+export type GetProfilingFlamegraphErrors = {
+    /**
+     * ErrorResponse defines a common error response structure.
+     */
+    400: {
+        message?: string;
+    };
+    /**
+     * ErrorResponse defines a common error response structure.
+     */
+    404: {
+        message?: string;
+    };
+    /**
+     * ErrorResponse defines a common error response structure.
+     */
+    422: {
+        message?: string;
+    };
+    /**
+     * ErrorResponse defines a common error response structure.
+     */
+    500: {
+        message?: string;
+    };
+    /**
+     * ErrorResponse defines a common error response structure.
+     */
+    504: {
+        message?: string;
+    };
+};
+export type GetProfilingFlamegraphError = GetProfilingFlamegraphErrors[keyof GetProfilingFlamegraphErrors];
+export type GetProfilingFlamegraphResponses = {
+    200: ProfilingFlamegraphResponse;
+};
+export type GetProfilingFlamegraphResponse = GetProfilingFlamegraphResponses[keyof GetProfilingFlamegraphResponses];
 export type DeleteApiKeyData = {
     body?: never;
     path: {
@@ -12371,3 +12978,31 @@ export type SearchTracesError = SearchTracesErrors[keyof SearchTracesErrors];
 export type SearchTracesResponses = {
     200: unknown;
 };
+export type ExportMonitorsV2Data = {
+    body: ExportMonitorsV2Request;
+    path?: never;
+    query?: never;
+    url: '/api/v2/monitors/export';
+};
+export type ExportMonitorsV2Errors = {
+    /**
+     * ErrorResponse defines a common error response structure.
+     */
+    400: {
+        message?: string;
+    };
+    /**
+     * ErrorResponse defines a common error response structure.
+     */
+    500: {
+        message?: string;
+    };
+};
+export type ExportMonitorsV2Error = ExportMonitorsV2Errors[keyof ExportMonitorsV2Errors];
+export type ExportMonitorsV2Responses = {
+    /**
+     * ExportMonitorsV2ResponseWrapper is the HCL document, served as text/plain.
+     */
+    200: TerraformDocument;
+};
+export type ExportMonitorsV2Response = ExportMonitorsV2Responses[keyof ExportMonitorsV2Responses];