@dx-do/client 5.2.36 → 5.2.38

package/dist/index.esm.js

@@ -15,6 +15,7 @@ import require$$1$2 from 'tty';
 import require$$0$4 from 'os';
 import zlib from 'zlib';
 import require$$0$5, { EventEmitter as EventEmitter$1 } from 'events';
+import { z } from 'zod/v4';
 import require$$0$7 from 'node:stream';
 import require$$0$6 from 'net';
 import require$$1$3 from 'tls';
@@ -38,6 +39,7 @@ function _mergeNamespaces(n, m) {
     return Object.freeze(n);
 }
 
+/** @internal */
 const ags = {
     "specifier": {
         "op": "OR",
@@ -53,6 +55,7 @@ const ags = {
     },
     "authorizationView": null,
 };
+/** @internal */
 const agsresponse = {
     "items": [
         { "name": "SuperDomain|lvnkprod010236|Spectrum|SpectrumWeb" },
@@ -157,6 +160,7 @@ var AlarmEnrichmentFilter;
         throw new Error(':unknown alarm filter type');
     }
     AlarmEnrichmentFilter.getAlarmFilterType = getAlarmFilterType;
+    /** @internal */
     class FilterNode {
         data;
         children = new Array();
@@ -171,6 +175,7 @@ var AlarmEnrichmentFilter;
         }
     }
     AlarmEnrichmentFilter.FilterNode = FilterNode;
+    /** @internal */
     function convertAnd(andFilter, parent) {
         if (andFilter.and.expressions.length == 1) {
             return convertFilterToNode(andFilter.and.expressions[0], parent);
@@ -187,6 +192,7 @@ var AlarmEnrichmentFilter;
         }
     }
     AlarmEnrichmentFilter.convertAnd = convertAnd;
+    /** @internal */
     function convertOr(orFilter, parent) {
         if (orFilter.or.expressions.length == 1) {
             return convertFilterToNode(orFilter.or.expressions[0], parent);
@@ -214,6 +220,7 @@ var AlarmEnrichmentFilter;
         }
     }
     AlarmEnrichmentFilter.conditionReadable = conditionReadable;
+    /** @internal */
     function convertAttribute(alarmAttributeFilter, parent) {
         const node = new FilterNode({
             filterType: 'attribute',
@@ -222,6 +229,7 @@ var AlarmEnrichmentFilter;
         return node;
     }
     AlarmEnrichmentFilter.convertAttribute = convertAttribute;
+    /** @internal */
     function convertFilterToNode(alarmFilter, parent) {
         switch (getAlarmFilterType(alarmFilter)) {
             case 'and':
@@ -239,6 +247,7 @@ var AlarmEnrichmentFilter;
 
 var AlarmEnrichment;
 (function (AlarmEnrichment) {
+    /** @internal */
     AlarmEnrichment.SAMPLE_RULES_RESPONSE = [
         {
             tenant_id: 'AA0725E0-0402-4320-A2B7-407025E9D673',
@@ -526,6 +535,9 @@ var AlertDefinitionResponse;
 
 var AlertResponse;
 (function (AlertResponse) {
+    /**
+     * @deprecated Use {@link AlertResponseV2.AllAlertsRequestBody} instead.
+     */
     AlertResponse.AllAlertsRequestBody = {
         mgmtModuleExtIds: [],
         alertType: 'all',
@@ -25329,8 +25341,1074 @@ var DashboardSearch;
     })(DashboardSearch.SearchType || (DashboardSearch.SearchType = {}));
 })(DashboardSearch || (DashboardSearch = {}));
 
+const AttributeExpressionOperatorSchema = z.enum([
+    'IN',
+    'NOT_IN',
+    'MATCHES',
+    'NOT_MATCHES',
+    'GE',
+    'GT',
+    'LE',
+    'LT',
+]);
+const AttributeExpressionComparatorSchema = z.enum([
+    'LEXICAL',
+    'NUMBER',
+    'DATETIME',
+]);
+const AttributeExpressionSchema = z.looseObject({
+    name: z.string().optional(),
+    pointer: z.string().optional(),
+    values: z.array(z.string()).optional(),
+    operator: AttributeExpressionOperatorSchema.optional(),
+    layer: z.string().optional(),
+    comparator: AttributeExpressionComparatorSchema.optional(),
+    caseInsensitive: z.boolean().optional(),
+});
+const AttributeValueAsFieldSchema = z.looseObject({
+    name: z.string().optional(),
+    pointer: z.string().optional(),
+    as: z.string().optional(),
+});
+const TraversalVertexFilterSchema = z.looseObject({
+    op: z.string().optional(),
+    input: z.lazy(() => z.array(TraversalVertexFilterSchema)).optional(),
+    expressions: z.array(AttributeExpressionSchema).optional(),
+    layer: z.string().optional(),
+    values: z.array(z.string()).optional(),
+    vertexId: z.array(z.number()).optional(),
+});
+const TraversalEdgeFilterSchema = z.looseObject({
+    op: z.string().optional(),
+    input: z.lazy(() => z.array(TraversalEdgeFilterSchema)).optional(),
+    expressions: z.array(AttributeExpressionSchema).optional(),
+    flowFilter: z.array(z.string()).optional(),
+});
+const TraverseDirectionSchema = z.enum(['FORWARD', 'BACKWARD', 'ANY']);
+const TraverseCollectSchema = z.enum(['ALL', 'EDGE', 'VERTEX', 'NONE']);
+const TraverseSchema = z.looseObject({
+    edgeFilter: TraversalEdgeFilterSchema.optional(),
+    vertexFilter: TraversalVertexFilterSchema.optional(),
+    collect: TraverseCollectSchema.optional(),
+    direction: TraverseDirectionSchema.optional(),
+    repeatMin: z.number().optional(),
+    repeat: z.number().optional(),
+    optional: z.boolean().optional(),
+    next: z.lazy(() => z.array(TraverseSchema)).optional(),
+});
+const VertexStateFilterSchema = z.looseObject({
+    op: z.string().optional(),
+});
+const TasGroupingItemSchema = z.looseObject({
+    name: z.string().optional(),
+    layer: z.string().optional(),
+});
+const TasAttributeFilterModeSchema = z.enum([
+    'VERTEX_AND_RELATED_EDGES',
+    'EDGE_AND_RELATED_VERTICES',
+    'VERTEX_ONLY',
+    'EDGE_ONLY',
+]);
+const TasFollowPathTypeSchema = z.enum([
+    'BOTH',
+    'DOWN',
+    'UP',
+    'UP_THEN_DOWN',
+    'DOWN_THEN_UP',
+    'FULL',
+    'COVERAGE',
+]);
+const TasFollowPathFlowFilterSchema = z.enum([
+    'UNDEFINED_FLOW',
+    'DEFINED_FLOW',
+    'FLOW_FROM_INPUT',
+]);
+const TasJoinTypeSchema = z.enum(['LEFT', 'INNER', 'RIGHT', 'NOT']);
+const TasCollectCardInfoTierSchema = z.enum([
+    'EXPERIENCE',
+    'FRONTEND',
+    'DATABASE',
+    'BACKEND',
+    'ANY_ATC',
+    'AGENT',
+]);
+const TasCollectExperienceSelectorSchema = z.enum(['EXPERIENCE', 'BT']);
+const TasFilterLazy = z.lazy(() => TasFilterSchema);
+const TasAllFilterSchema = z.looseObject({
+    op: z.literal('ALL'),
+});
+const TasEmptyFilterSchema = z.looseObject({
+    op: z.literal('EMPTY'),
+    input: TasFilterLazy.optional(),
+});
+const TasAndFilterSchema = z.looseObject({
+    op: z.literal('AND'),
+    input: z.array(TasFilterLazy).optional(),
+});
+const TasOrFilterSchema = z.looseObject({
+    op: z.literal('OR'),
+    input: z.array(TasFilterLazy).optional(),
+});
+const TasNotFilterSchema = z.looseObject({
+    op: z.literal('NOT'),
+    input: TasFilterLazy.optional(),
+});
+const TasAttributeFilterSchema = z.looseObject({
+    op: z.literal('ATTRIBUTE'),
+    input: TasFilterLazy.optional(),
+    expressions: z.array(AttributeExpressionSchema).optional(),
+    layer: z.string().optional(),
+    mode: TasAttributeFilterModeSchema.optional(),
+});
+const TasTraverseFilterSchema = z.looseObject({
+    op: z.literal('TRAVERSE'),
+    input: TasFilterLazy.optional(),
+    traverse: z.array(TraverseSchema).optional(),
+    collectStart: z.boolean().optional(),
+    includeInput: z.boolean().optional(),
+});
+const TasVertexIdFilterSchema = z.looseObject({
+    op: z.literal('VERTEX'),
+    input: TasFilterLazy.optional(),
+    vertexId: z.array(z.number()).optional(),
+    externalId: z.array(z.string()).optional(),
+    not: z.boolean().optional(),
+});
+const TasServiceFilterSchema = z.looseObject({
+    op: z.literal('SERVICE'),
+    input: TasFilterLazy.optional(),
+    values: z.array(z.string()).optional(),
+    includeServiceHierarchy: z.boolean().optional(),
+    excludeSubServices: z.boolean().optional(),
+});
+const TasLuceneFilterSchema = z.looseObject({
+    op: z.literal('LUCENE'),
+    input: TasFilterLazy.optional(),
+    query: z.string().optional(),
+});
+const TasLayerFilterSchema = z.looseObject({
+    op: z.literal('LAYER'),
+    input: TasFilterLazy.optional(),
+    value: z.string().optional(),
+    values: z.array(z.string()).optional(),
+});
+const TasJoinFilterSchema = z.looseObject({
+    op: z.literal('JOIN'),
+    input: TasFilterLazy.optional(),
+    type: TasJoinTypeSchema.optional(),
+    rightInput: TasFilterLazy.optional(),
+});
+const TasFollowPathFilterSchema = z.looseObject({
+    op: z.literal('FOLLOW_PATH'),
+    input: TasFilterLazy.optional(),
+    type: TasFollowPathTypeSchema.optional(),
+    upHops: z.number().optional(),
+    downHops: z.number().optional(),
+    flowFilter: z.array(TasFollowPathFlowFilterSchema).optional(),
+    followToLayers: z.array(z.string()).optional(),
+});
+const TasCoverageFilterSchema = z.looseObject({
+    op: z.literal('COVERAGE'),
+    input: TasFilterLazy.optional(),
+});
+const TasStatusFilterSchema = z.looseObject({
+    op: z.literal('STATUS'),
+    input: TasFilterLazy.optional(),
+    statusFilter: VertexStateFilterSchema.optional(),
+});
+const TasVariableFilterSchema = z.looseObject({
+    op: z.literal('VARIABLE'),
+    name: z.string().optional(),
+});
+const TasLegacyFilterSchema = z.looseObject({
+    op: z.literal('LEGACY'),
+    legacy: z.unknown().optional(),
+});
+const TasAddFlowsFilterSchema = z.looseObject({
+    op: z.literal('ADD_FLOWS'),
+    input: TasFilterLazy.optional(),
+    includeJoined: z.boolean().optional(),
+});
+const TasAddWiresFilterSchema = z.looseObject({
+    op: z.literal('ADD_WIRES'),
+    input: TasFilterLazy.optional(),
+    considerIncompleteEdges: z.boolean().optional(),
+});
+const TasAddWireContextFilterSchema = z.looseObject({
+    op: z.literal('ADD_WIRE_CONTEXT'),
+    input: TasFilterLazy.optional(),
+    addEdges: z.boolean().optional(),
+    addSourceVertices: z.boolean().optional(),
+    addTargetVertices: z.boolean().optional(),
+});
+const TasAddTransitioningEdgesFilterSchema = z.looseObject({
+    op: z.literal('ADD_TRANSITIONING_EDGES'),
+    input: TasFilterLazy.optional(),
+});
+const TasTakeVerticesFilterSchema = z.looseObject({
+    op: z.literal('TAKE_VERTICES'),
+    input: TasFilterLazy.optional(),
+});
+const TasTakeEdgesFilterSchema = z.looseObject({
+    op: z.literal('TAKE_EDGES'),
+    input: TasFilterLazy.optional(),
+});
+const TasTakeFlowsFilterSchema = z.looseObject({
+    op: z.literal('TAKE_FLOWS'),
+    input: TasFilterLazy.optional(),
+});
+const TasCollectAttributesFilterSchema = z.looseObject({
+    op: z.literal('COLLECT_ATTRIBUTES'),
+    input: TasFilterLazy.optional(),
+    id: z.string().optional(),
+    attributeName: z.string().optional(),
+    layer: z.string().optional(),
+    includeIds: z.boolean().optional(),
+    caseInsensitive: z.boolean().optional(),
+    skipBackends: z.boolean().optional(),
+});
+const TasCollectAttributeNamesFilterSchema = z.looseObject({
+    op: z.literal('COLLECT_ATTRIBUTE_NAMES'),
+    input: TasFilterLazy.optional(),
+    id: z.string().optional(),
+    layer: z.string().optional(),
+});
+const TasCollectCountsFilterSchema = z.looseObject({
+    op: z.literal('COLLECT_COUNTS'),
+    input: TasFilterLazy.optional(),
+    id: z.string().optional(),
+});
+const TasCollectVertexIdFilterSchema = z.looseObject({
+    op: z.literal('COLLECT_VERTEX_ID'),
+    input: TasFilterLazy.optional(),
+    id: z.string().optional(),
+    layer: z.string().optional(),
+    skipBackends: z.boolean().optional(),
+});
+const TasCollectGroupingInfoFilterSchema = z.looseObject({
+    op: z.literal('COLLECT_GROUPING_INFO'),
+    input: TasFilterLazy.optional(),
+    id: z.string().optional(),
+    layer: z.string().optional(),
+    grouping: z.array(TasGroupingItemSchema).optional(),
+});
+const TasCollectCardInfoFilterSchema = z.looseObject({
+    op: z.literal('COLLECT_CARD_INFO'),
+    input: TasFilterLazy.optional(),
+    tier: TasCollectCardInfoTierSchema.optional(),
+    grouping: TasGroupingItemSchema.optional(),
+    includeVertexInfo: z.boolean().optional(),
+});
+const TasCollectExperienceAttributesFilterSchema = z.looseObject({
+    op: z.literal('COLLECT_EXPERIENCE_ATTRIBUTES'),
+    input: TasFilterLazy.optional(),
+    id: z.string().optional(),
+    attributeName: z.string().optional(),
+    layer: z.string().optional(),
+    caseInsensitive: z.boolean().optional(),
+    selector: TasCollectExperienceSelectorSchema.optional(),
+});
+const TasFilterSchema = z.discriminatedUnion('op', [
+    TasAddFlowsFilterSchema,
+    TasAddTransitioningEdgesFilterSchema,
+    TasAddWiresFilterSchema,
+    TasAddWireContextFilterSchema,
+    TasAllFilterSchema,
+    TasAndFilterSchema,
+    TasAttributeFilterSchema,
+    TasEmptyFilterSchema,
+    TasFollowPathFilterSchema,
+    TasJoinFilterSchema,
+    TasLayerFilterSchema,
+    TasNotFilterSchema,
+    TasOrFilterSchema,
+    TasCoverageFilterSchema,
+    TasTakeEdgesFilterSchema,
+    TasTakeFlowsFilterSchema,
+    TasTakeVerticesFilterSchema,
+    TasTraverseFilterSchema,
+    TasVertexIdFilterSchema,
+    TasLegacyFilterSchema,
+    TasVariableFilterSchema,
+    TasCollectAttributesFilterSchema,
+    TasCollectAttributeNamesFilterSchema,
+    TasCollectExperienceAttributesFilterSchema,
+    TasCollectGroupingInfoFilterSchema,
+    TasCollectCardInfoFilterSchema,
+    TasLuceneFilterSchema,
+    TasCollectVertexIdFilterSchema,
+    TasCollectCountsFilterSchema,
+    TasStatusFilterSchema,
+    TasServiceFilterSchema,
+]);
+const TasVariableSchema = z.looseObject({
+    name: z.string().optional(),
+    input: TasFilterLazy.optional(),
+});
+const TasProjectionFilterSchema = z.looseObject({
+    attributes: z.array(z.string()).optional(),
+    attributeValueAsFields: z.array(AttributeValueAsFieldSchema).optional(),
+});
+
+const TasViewSchema = z.enum(['DETAILED', 'BRIEF', 'NO_TYPE']);
+const TasOrderSchema = z.looseObject({
+    name: z.string().optional(),
+    comparator: AttributeExpressionComparatorSchema.optional(),
+    caseInsensitive: z.boolean().optional(),
+    desc: z.boolean().optional(),
+});
+const TasQuerySchema = z.looseObject({
+    version: z.string().optional(),
+    time: z.number().optional(),
+    schema: z.string().optional(),
+    offset: z.number().optional(),
+    limit: z.number().optional(),
+    order: z.array(TasOrderSchema).optional(),
+    variables: z.array(TasVariableSchema).optional(),
+    filter: TasFilterSchema.optional(),
+    universe: TasFilterSchema.optional(),
+    authorizationView: z.string().optional(),
+    postFilter: TasFilterSchema.optional(),
+    stateFilter: VertexStateFilterSchema.optional(),
+    includeStatus: z.boolean().optional(),
+    includeServices: z.boolean().optional(),
+    includeProfile: z.boolean().optional(),
+    flushCacheBeforeQuery: z.boolean().optional(),
+    projection: TasViewSchema.optional(),
+    projectionFilter: TasProjectionFilterSchema.optional(),
+});
+
+const TasExternalIdSchema = z.string();
+const TasAttributeTypeSchema = z.enum([
+    'GATHERED',
+    'CUSTOM',
+    'DECORATED',
+    'HIDDEN',
+]);
+const TasVertexSchema = z.looseObject({
+    id: z.number(),
+    externalId: TasExternalIdSchema.optional(),
+    startTime: z.number().optional(),
+    endTime: z.number().optional(),
+    attributes: z.record(z.string(), z.unknown()).optional(),
+    attributesType: z.record(z.string(), TasAttributeTypeSchema).optional(),
+});
+const EdgeNumericIdSchema = z.looseObject({
+    sourceId: z.number(),
+    targetId: z.number(),
+    flowId: z.number(),
+    wireId: z.number(),
+});
+const TasEdgeSchema = z.looseObject({
+    sourceId: z.number(),
+    targetId: z.number(),
+    flowId: z.number(),
+    wireId: z.number(),
+    sourceExternalId: TasExternalIdSchema.optional(),
+    targetExternalId: TasExternalIdSchema.optional(),
+    flowExternalId: TasExternalIdSchema.optional(),
+    wireExternalId: TasExternalIdSchema.optional(),
+    startTime: z.number().optional(),
+    endTime: z.number().optional(),
+    attributes: z.record(z.string(), z.unknown()).optional(),
+    attributesType: z.record(z.string(), TasAttributeTypeSchema).optional(),
+});
+const VertexStateExternalIdSchema = z.looseObject({
+    vertexExternalId: TasExternalIdSchema.optional(),
+    alertExternalId: z.string().optional(),
+    metricExternalId: z.string().optional(),
+});
+const VertexStateNumericIdSchema = z.looseObject({
+    vertexId: z.number(),
+    alertId: z.number(),
+    metricId: z.number(),
+});
+const VertexStateSchema = z.looseObject({
+    vertexId: z.number(),
+    alertId: z.number(),
+    metricId: z.number(),
+    stateExternalId: VertexStateExternalIdSchema.optional(),
+    status: z.number(),
+    data: z.unknown().optional(),
+    startTime: z.number().optional(),
+    endTime: z.number().optional(),
+});
+const TasAnalyticResultSchema = z.looseObject({
+    t: z.string().optional(),
+});
+const TasGraphSchema = z.looseObject({
+    vertices: z.array(TasVertexSchema).optional(),
+    edges: z.array(TasEdgeSchema).optional(),
+    states: z.array(VertexStateSchema).optional(),
+    expiredVertices: z.array(z.number()).optional(),
+    expiredEdges: z.array(EdgeNumericIdSchema).optional(),
+    expiredStates: z.array(VertexStateNumericIdSchema).optional(),
+    version: z.string().optional(),
+    analytics: z.array(TasAnalyticResultSchema).optional(),
+    nextOffset: z.number().optional(),
+    totalVertices: z.number().optional(),
+    totalEdges: z.number().optional(),
+});
+
+const OperatorSchema = z.enum(['EQ', 'GE', 'GT', 'LE', 'LT', 'NE']);
+const SourceNameAllSpecifierSchema = z.looseObject({
+    op: z.literal('ALL'),
+});
+const SourceNameNoneSpecifierSchema = z.looseObject({
+    op: z.literal('NONE'),
+});
+const SourceNameAndSpecifierSchema = z.looseObject({
+    op: z.literal('AND'),
+    specifiers: z.array(z.lazy(() => SourceNameSpecifierSchema)),
+});
+const SourceNameOrSpecifierSchema = z.looseObject({
+    op: z.literal('OR'),
+    specifiers: z.array(z.lazy(() => SourceNameSpecifierSchema)),
+});
+const SourceNameNotSpecifierSchema = z.looseObject({
+    op: z.literal('NOT'),
+    specifier: z.lazy(() => SourceNameSpecifierSchema),
+});
+const SourceNameExactSpecifierSchema = z.looseObject({
+    op: z.literal('EXACT'),
+    names: z.array(z.string()).optional(),
+    ignoreCase: z.boolean().optional(),
+});
+const SourceNameRegExSpecifierSchema = z.looseObject({
+    op: z.literal('REGEX'),
+    pattern: z.string().optional(),
+    ignoreCase: z.boolean().optional(),
+});
+const SourceNamePartOperatorSpecifierSchema = z.looseObject({
+    op: z.literal('PART'),
+    operator: OperatorSchema.optional(),
+    part: z.number(),
+    partValue: z.string().optional(),
+});
+const SourceNameSpecifierSchema = z.discriminatedUnion('op', [
+    SourceNameAllSpecifierSchema,
+    SourceNameNoneSpecifierSchema,
+    SourceNameAndSpecifierSchema,
+    SourceNameOrSpecifierSchema,
+    SourceNameNotSpecifierSchema,
+    SourceNameExactSpecifierSchema,
+    SourceNameRegExSpecifierSchema,
+    SourceNamePartOperatorSpecifierSchema,
+]);
+
+const FolderNameAllSpecifierSchema = z.looseObject({
+    op: z.literal('ALL'),
+});
+const FolderNameNoneSpecifierSchema = z.looseObject({
+    op: z.literal('NONE'),
+});
+const FolderNameAndSpecifierSchema = z.looseObject({
+    op: z.literal('AND'),
+    specifiers: z.array(z.lazy(() => FolderNameSpecifierSchema)),
+});
+const FolderNameOrSpecifierSchema = z.looseObject({
+    op: z.literal('OR'),
+    specifiers: z.array(z.lazy(() => FolderNameSpecifierSchema)),
+});
+const FolderNameNotSpecifierSchema = z.looseObject({
+    op: z.literal('NOT'),
+    specifier: z.lazy(() => FolderNameSpecifierSchema),
+});
+const FolderNameExactSpecifierSchema = z.looseObject({
+    op: z.literal('EXACT'),
+    names: z.array(z.string()).optional(),
+    ignoreCase: z.boolean().optional(),
+});
+const FolderNameRegExSpecifierSchema = z.looseObject({
+    op: z.literal('REGEX'),
+    pattern: z.string().optional(),
+    ignoreCase: z.boolean().optional(),
+});
+const FolderNameChildrenSpecifierSchema = z.looseObject({
+    op: z.literal('CHILDREN'),
+    prefix: z.string().optional(),
+    recursive: z.boolean().optional(),
+});
+const FolderNameSpecifierSchema = z.discriminatedUnion('op', [
+    FolderNameAllSpecifierSchema,
+    FolderNameNoneSpecifierSchema,
+    FolderNameAndSpecifierSchema,
+    FolderNameOrSpecifierSchema,
+    FolderNameNotSpecifierSchema,
+    FolderNameExactSpecifierSchema,
+    FolderNameRegExSpecifierSchema,
+    FolderNameChildrenSpecifierSchema,
+]);
+
+const QueryAttributeExpressionSchema = z.looseObject({
+    name: z.string().optional(),
+    values: z.array(z.string()).optional(),
+    operator: z.enum(['IN', 'NOT_IN', 'MATCHES', 'NOT_MATCHES', 'GE', 'GT', 'LE', 'LT']).optional(),
+    comparator: z.enum(['LEXICAL', 'NUMBER', 'DATETIME']).optional(),
+    caseInsensitive: z.boolean().optional(),
+});
+const AttributeNameAllSpecifierSchema = z.looseObject({
+    op: z.literal('ALL'),
+});
+const AttributeNameNoneSpecifierSchema = z.looseObject({
+    op: z.literal('NONE'),
+});
+const AttributeNameAndSpecifierSchema = z.looseObject({
+    op: z.literal('AND'),
+    specifiers: z.array(z.lazy(() => AttributeNameSpecifierSchema)),
+});
+const AttributeNameOrSpecifierSchema = z.looseObject({
+    op: z.literal('OR'),
+    specifiers: z.array(z.lazy(() => AttributeNameSpecifierSchema)),
+});
+const AttributeNameNotSpecifierSchema = z.looseObject({
+    op: z.literal('NOT'),
+    specifier: z.lazy(() => AttributeNameSpecifierSchema),
+});
+const AttributeNameExactSpecifierSchema = z.looseObject({
+    op: z.literal('EXACT'),
+    names: z.array(z.string()).optional(),
+    type: z.number().optional(),
+    ignoreCase: z.boolean().optional(),
+});
+const AttributeNameRegExSpecifierSchema = z.looseObject({
+    op: z.literal('REGEX'),
+    pattern: z.string().optional(),
+    ignoreCase: z.boolean().optional(),
+});
+const AttributeNameFolderSpecifierSchema = z.looseObject({
+    op: z.literal('FOLDER'),
+    specifier: FolderNameSpecifierSchema.optional(),
+});
+const AttributeNameChildrenSpecifierSchema = z.looseObject({
+    op: z.literal('CHILDREN'),
+    prefix: z.string().optional(),
+    recursive: z.boolean().optional(),
+});
+const AttributeNameTypeSpecifierSchema = z.looseObject({
+    op: z.literal('TYPE'),
+    specifier: z.lazy(() => AttributeNameSpecifierSchema).optional(),
+    bitMask: z.number().optional(),
+    bitMatch: z.number().optional(),
+    operator: OperatorSchema.optional(),
+});
+const AttributeNameOperatorSpecifierSchema = z.looseObject({
+    op: z.literal('OPERATOR'),
+    name: z.string().optional(),
+    fullPath: z.boolean().optional(),
+    operator: OperatorSchema.optional(),
+});
+const AttributeNameAnyNumericSpecifierSchema = z.looseObject({
+    op: z.literal('NUMERIC'),
+});
+const AttributeNameAttributeSpecifierSchema = z.looseObject({
+    op: z.literal('ATTRIBUTE'),
+    expressions: z.array(QueryAttributeExpressionSchema).optional(),
+});
+const AttributeNameSpecifierSchema = z.discriminatedUnion('op', [
+    AttributeNameAllSpecifierSchema,
+    AttributeNameNoneSpecifierSchema,
+    AttributeNameAndSpecifierSchema,
+    AttributeNameOrSpecifierSchema,
+    AttributeNameNotSpecifierSchema,
+    AttributeNameExactSpecifierSchema,
+    AttributeNameRegExSpecifierSchema,
+    AttributeNameFolderSpecifierSchema,
+    AttributeNameChildrenSpecifierSchema,
+    AttributeNameTypeSpecifierSchema,
+    AttributeNameOperatorSpecifierSchema,
+    AttributeNameAnyNumericSpecifierSchema,
+    AttributeNameAttributeSpecifierSchema,
+]);
+
+const ManagementModuleIdSchema = z.looseObject({
+    name: z.string().optional(),
+});
+const QueryAllSpecifierSchema = z.looseObject({
+    op: z.literal('ALL'),
+    includeFolders: z.boolean().optional(),
+    includeMetrics: z.boolean().optional(),
+});
+const QueryNoneSpecifierSchema = z.looseObject({
+    op: z.literal('NONE'),
+});
+const QueryAndSpecifierSchema = z.looseObject({
+    op: z.literal('AND'),
+    specifiers: z.array(z.lazy(() => QuerySpecifierSchema)),
+});
+const QueryOrSpecifierSchema = z.looseObject({
+    op: z.literal('OR'),
+    specifiers: z.array(z.lazy(() => QuerySpecifierSchema)),
+});
+const QueryNotSpecifierSchema = z.looseObject({
+    op: z.literal('NOT'),
+    specifier: z.lazy(() => QuerySpecifierSchema),
+});
+const QuerySpecSpecifierSchema = z.looseObject({
+    op: z.literal('SPEC'),
+    sourceNameSpecifier: SourceNameSpecifierSchema.optional(),
+    folderNameSpecifier: FolderNameSpecifierSchema.optional(),
+    attributeNameSpecifier: AttributeNameSpecifierSchema.optional(),
+});
+const QueryIdSpecifierSchema = z.looseObject({
+    op: z.literal('ID'),
+    ids: z.array(z.string()).optional(),
+});
+const QueryAttributeSpecifierSchema = z.looseObject({
+    op: z.literal('ATTRIBUTE'),
+    expressions: z.array(QueryAttributeExpressionSchema).optional(),
+});
+const QueryMetricGroupSpecifierSchema = z.looseObject({
+    op: z.literal('GROUP'),
+    id: z.string().optional(),
+    managementModuleId: ManagementModuleIdSchema.optional(),
+});
+const ServiceFilterSpecifierSchema = z.looseObject({
+    op: z.literal('SERVICE'),
+    values: z.array(z.string()).optional(),
+});
+const QuerySpecifierSchema = z.discriminatedUnion('op', [
+    QueryAllSpecifierSchema,
+    QueryNoneSpecifierSchema,
+    QueryAndSpecifierSchema,
+    QueryOrSpecifierSchema,
+    QueryNotSpecifierSchema,
+    QuerySpecSpecifierSchema,
+    QueryIdSpecifierSchema,
+    QueryAttributeSpecifierSchema,
+    QueryMetricGroupSpecifierSchema,
+    ServiceFilterSpecifierSchema,
+]);
+
+const QueryHintForceRangeSchema = z.looseObject({
+    hint: z.literal('ForceRange'),
+});
+const QueryHintSchema = z.discriminatedUnion('hint', [
+    QueryHintForceRangeSchema,
+]);
+const MetadataMetricQuerySchema = z.looseObject({
+    specifier: QuerySpecifierSchema.optional(),
+    clamp: z.number().optional(),
+    time: z.number().optional(),
+    range: z.number().optional(),
+    includeLive: z.boolean().optional(),
+    authorizationView: z.string().optional(),
+    includeProfile: z.boolean().optional(),
+    profileLevel: z.string().optional(),
+    queryHints: z.array(QueryHintSchema).optional(),
+});
+
+const MetricAttributeSchema = z.looseObject({
+    id: z.string().optional(),
+    sourceName: z.string().optional(),
+    type: z.number(),
+    attributeName: z.string().optional(),
+    attributes: z.record(z.string(), z.unknown()).optional(),
+    firstSeen: z.number().optional(),
+    lastSeen: z.number().optional(),
+    live: z.boolean().optional(),
+});
+const MetricFolderSchema = z.looseObject({
+    sourceId: z.string().optional(),
+    sourceName: z.string().optional(),
+    folderName: z.string().optional(),
+    firstSeen: z.number().optional(),
+    lastSeen: z.number().optional(),
+    live: z.boolean().optional(),
+});
+const MetadataMetricQueryResponseV2Schema = z.looseObject({
+    metrics: z.array(MetricAttributeSchema).optional(),
+    folders: z.array(MetricFolderSchema).optional(),
+    analytics: z.record(z.string(), z.unknown()).optional(),
+});
+
+const NumericOperatorSchema = z.enum(['EQ', 'LT', 'LE', 'GT', 'GE', 'NE']);
+const QueryFilterAndSpecSchema = z.looseObject({
+    op: z.literal('AND'),
+    spec: z.lazy(() => z.array(QueryFilterPredicateSpecSchema)),
+});
+const QueryFilterOrSpecSchema = z.looseObject({
+    op: z.literal('OR'),
+    spec: z.lazy(() => z.array(QueryFilterPredicateSpecSchema)),
+});
+const QueryFilterNotSpecSchema = z.looseObject({
+    op: z.literal('NOT'),
+    spec: z.lazy(() => QueryFilterPredicateSpecSchema),
+});
+const QueryFilterExprSpecSchema = z.looseObject({
+    op: z.literal('EXPR'),
+    spec: z.string(),
+});
+const QueryFilterInSpecSchema = z.looseObject({
+    op: z.literal('IN'),
+    column: z.string(),
+    values: z.array(z.unknown()),
+});
+const QueryFilterRegexSpecSchema = z.looseObject({
+    op: z.literal('REGEX'),
+    column: z.string(),
+    pattern: z.string(),
+    ignoreCase: z.boolean(),
+});
+const QueryFilterNumericSpecSchema = z.looseObject({
+    op: z.literal('NUMERIC'),
+    column: z.string(),
+    operator: NumericOperatorSchema,
+    value: z.number().optional(),
+});
+const QueryFilterPredicateSpecSchema = z.union([
+    QueryFilterAndSpecSchema,
+    QueryFilterOrSpecSchema,
+    QueryFilterNotSpecSchema,
+    QueryFilterExprSpecSchema,
+    QueryFilterInSpecSchema,
+    QueryFilterRegexSpecSchema,
+    QueryFilterNumericSpecSchema,
+]);
+
+const QueryRangeSpecSchema = z.looseObject({
+    endTime: z.number(),
+    rangeSize: z.number(),
+    frequency: z.number(),
+});
+const QueryMetricIdSchema = z.looseObject({
+    metrics: z.array(z.string()),
+});
+const JoinTypeSchema = z.enum(['INNER_JOIN', 'LEFT_OUTER_JOIN']);
+const FillModeSchema = z.enum(['MARK', 'INNER', 'ALL']);
+const AlignmentSchema = z.enum(['ABSOLUTE', 'LEFT', 'RIGHT']);
+const CalendarIntervalSchema = z.enum([
+    'MINUTE', 'HOUR', 'DAY', 'WEEK', 'MONTH', 'QUARTER', 'YEAR',
+]);
+const QuantileMethodSchema = z.enum(['EXACT_INTERPOLATION', 'EXACT_SELECTOR']);
+const NassValueTypeSchema = z.enum(['DOUBLE', 'LONG', 'STRING']);
+const QueryColumnTypeSpecSchema = z.enum(['LONG', 'DOUBLE', 'STRING']);
+const aggregationFields = {
+    fillGaps: z.boolean().optional(),
+    fillValue: z.union([z.string(), z.number(), z.boolean(), z.null()]).optional(),
+    fillMode: FillModeSchema.optional(),
+};
+const OrderItemSchema = z.looseObject({
+    column: z.string(),
+    sortDescending: z.boolean(),
+});
+const QueryFromSpecSchema = z.looseObject({
+    op: z.literal('FROM'),
+    querySpecifier: QuerySpecifierSchema,
+    queryRange: QueryRangeSpecSchema.optional(),
+    queryHints: z.array(QueryHintSchema).optional(),
+    alias: z.string().optional(),
+    clampSize: z.number().optional(),
+    rowsClampSize: z.number().optional(),
+    metadataOnly: z.boolean().optional(),
+});
+const QueryFromTableSpecSchema = z.looseObject({
+    op: z.literal('FROM_TABLE'),
+    tableName: z.string(),
+    alias: z.string().optional(),
+    limit: z.number().optional(),
+    lowerBoundKey: z.array(z.unknown()).optional(),
+    upperBoundKey: z.array(z.unknown()).optional(),
+});
+const QueryShowTablesSpecSchema = z.looseObject({
+    op: z.literal('SHOW_TABLES'),
+});
+const QueryWindowSpecSchema = z.looseObject({
+    op: z.literal('WINDOW'),
+    every: z.number(),
+    align: AlignmentSchema.optional(),
+    incomplete: z.boolean().optional(),
+    useFrequency: z.boolean().optional(),
+});
+const QueryCalendarWindowSpecSchema = z.looseObject({
+    op: z.literal('WINDOW_CALENDAR'),
+    calendarInterval: CalendarIntervalSchema,
+    timeZone: z.string().optional(),
+});
+const QueryGroupSpecSchema = z.looseObject({
+    op: z.literal('GROUP'),
+    columns: z.array(z.string()),
+});
+const QueryOrderSpecSchema = z.looseObject({
+    op: z.literal('ORDER'),
+    columns: z.array(OrderItemSchema),
+    topN: z.number().optional(),
+});
+const QueryKeepSpecSchema = z.looseObject({
+    op: z.literal('KEEP'),
+    columns: z.array(z.string()),
+    as: z.array(z.string()).optional(),
+});
+const QueryCountSpecSchema = z.looseObject({
+    op: z.literal('COUNT'),
+    ...aggregationFields,
+    column: z.string().optional(),
+    as: z.string().optional(),
+});
+const QuerySumSpecSchema = z.looseObject({
+    op: z.literal('SUM'),
+    ...aggregationFields,
+    column: z.string(),
+    as: z.string().optional(),
+});
+const QueryMinSpecSchema = z.looseObject({
+    op: z.literal('MIN'),
+    ...aggregationFields,
+    column: z.string(),
+    as: z.string().optional(),
+});
+const QueryMaxSpecSchema = z.looseObject({
+    op: z.literal('MAX'),
+    ...aggregationFields,
+    column: z.string(),
+    as: z.string().optional(),
+});
+const QueryMeanSpecSchema = z.looseObject({
+    op: z.literal('MEAN'),
+    ...aggregationFields,
+    column: z.string(),
+    as: z.string().optional(),
+    weightColumn: z.string().optional(),
+});
+const QueryMultiAggregationSpecSchema = z.looseObject({
+    op: z.literal('AGG'),
+    ...aggregationFields,
+    spec: z.array(z.looseObject({
+        ...aggregationFields,
+        op: z.string().optional(),
+        column: z.string().optional(),
+        as: z.string().optional(),
+        fromAlias: z.string().optional(),
+        weightColumn: z.string().optional(),
+        orderSrc: z.string().optional(),
+        index: z.number().optional(),
+        scale: z.number().optional(),
+        method: QuantileMethodSchema.optional(),
+    })),
+});
+const QueryNassAggregationSpecSchema = z.looseObject({
+    op: z.literal('NASS_AGG'),
+    ...aggregationFields,
+    fromAlias: z.string().optional(),
+    as: z.string().optional(),
+});
+const QueryDerivativeSpecSchema = z.looseObject({
+    op: z.literal('DERIVATIVE'),
+    column: z.string(),
+    unit: z.number().optional(),
+    negative: z.boolean().optional(),
+    as: z.string().optional(),
+    timeSrc: z.string().optional(),
+});
+const QueryDifferenceSpecSchema = z.looseObject({
+    op: z.literal('DIFFERENCE'),
+    column: z.string(),
+    negative: z.boolean().optional(),
+    as: z.string().optional(),
+    timeSrc: z.string().optional(),
+});
+const QueryFirstSpecSchema = z.looseObject({
+    op: z.literal('FIRST'),
+    ...aggregationFields,
+    column: z.string(),
+    as: z.string().optional(),
+    orderSrc: z.string().optional(),
+});
+const QueryLastSpecSchema = z.looseObject({
+    op: z.literal('LAST'),
+    ...aggregationFields,
+    column: z.string(),
+    as: z.string().optional(),
+    orderSrc: z.string().optional(),
+});
+const QueryQuantileSpecSchema = z.looseObject({
+    op: z.literal('QUANTILE'),
+    ...aggregationFields,
+    column: z.string(),
+    as: z.string().optional(),
+    method: QuantileMethodSchema.optional(),
+    index: z.number(),
+    scale: z.number().optional(),
+});
+const QueryDistinctSpecSchema = z.looseObject({
+    op: z.literal('DISTINCT'),
+    ...aggregationFields,
+});
+const QueryDescribeSpecSchema = z.looseObject({
+    op: z.literal('DESCRIBE'),
+});
+const QueryTopSpecSchema = z.looseObject({
+    op: z.literal('TOP'),
+    column: z.string(),
+    n: z.number(),
+    sortAscending: z.boolean().optional(),
+});
+const QueryBottomSpecSchema = z.looseObject({
+    op: z.literal('BOTTOM'),
+    column: z.string(),
+    n: z.number(),
+    sortAscending: z.boolean().optional(),
+});
+const QueryMapSpecSchema = z.looseObject({
+    op: z.literal('MAP'),
+    fn: z.string(),
+    as: z.string(),
+});
+const QueryMapStringSpecSchema = z.looseObject({
+    op: z.literal('MAP_STRING'),
+    column: z.string(),
+    pattern: z.string(),
+    as: z.array(z.string()).optional(),
+    asType: z.array(QueryColumnTypeSpecSchema).optional(),
+    fillValues: z.array(z.string()).optional(),
+    filterNotMatching: z.boolean().optional(),
+});
+const QueryNassMapSpecSchema = z.looseObject({
+    op: z.literal('NASS_MAP'),
+    type: NassValueTypeSchema.optional(),
+    time: z.string().optional(),
+    interval: z.unknown().optional(),
+    min: z.unknown().optional(),
+    max: z.unknown().optional(),
+    value: z.string().optional(),
+    count: z.unknown().optional(),
+    frequency: z.number().optional(),
+});
+const QueryFilterSpecSchema = z.looseObject({
+    op: z.literal('FILTER'),
+    spec: QueryFilterPredicateSpecSchema,
+});
+const QueryFilterExprFnSpecSchema = z.looseObject({
+    op: z.literal('FILTER_EXPR'),
+    spec: z.string(),
+});
+const QueryJoinDataSpecSchema = z.looseObject({
+    op: z.literal('JOIN_DATA'),
+    queryRange: QueryRangeSpecSchema.optional(),
+    metricIdColumn: z.string(),
+    alias: z.string().optional(),
+    joinFirstOnly: z.boolean().optional(),
+    rowsClampSize: z.number().optional(),
+});
+const QueryFromMetadataSpecSchema = z.looseObject({
+    op: z.literal('FROM_METADATA'),
+    querySpecifier: QuerySpecifierSchema,
+    queryRange: QueryRangeSpecSchema.optional(),
+    queryHints: z.array(QueryHintSchema).optional(),
+    alias: z.string().optional(),
+    rowsClampSize: z.number().optional(),
+});
+const QueryFromTopologySpecSchema = z.looseObject({
+    op: z.literal('FROM_TOPOLOGY'),
+    querySpecifier: TasQuerySchema,
+    alias: z.string().optional(),
+    rowsClampSize: z.number().optional(),
+});
+const QueryFromDataSpecSchema = z.looseObject({
+    op: z.literal('FROM_DATA'),
+    querySpecifier: QueryMetricIdSchema,
+    queryRange: QueryRangeSpecSchema.optional(),
+    alias: z.string().optional(),
+});
+const QueryJoinMetadataSpecSchema = z.looseObject({
+    op: z.literal('JOIN_METADATA'),
+    querySpecifier: QuerySpecifierSchema.optional(),
+    queryRange: QueryRangeSpecSchema.optional(),
+    queryHints: z.array(QueryHintSchema).optional(),
+    alias: z.string().optional(),
+    rowsClampSize: z.number().optional(),
+    externalIdColumn: z.string().optional(),
+    joinType: JoinTypeSchema.optional(),
+});
+const QueryJoinTopologySpecSchema = z.looseObject({
+    op: z.literal('JOIN_TOPOLOGY'),
+    rowsClampSize: z.number().optional(),
+    externalIdColumn: z.string().optional(),
+    joinType: JoinTypeSchema.optional(),
+});
+const QueryFormatTimeSpecSchema = z.looseObject({
+    op: z.literal('FORMAT_TIME'),
+    column: z.string(),
+    as: z.string().optional(),
+    duration: z.boolean().optional(),
+    pattern: z.string().optional(),
+    timezone: z.string().optional(),
+});
+const QueryFormatSpecSchema = z.looseObject({
+    op: z.literal('FORMAT'),
+    format: z.string(),
+    columns: z.array(z.string()).optional(),
+    as: z.string().optional(),
+    languageTag: z.string().optional(),
+    fillFormatError: z.boolean().optional(),
+    fillValue: z.string().optional(),
+});
+const QueryLogSpecSchema = z.looseObject({
+    op: z.literal('LOG'),
+    name: z.string().optional(),
+    limit: z.number().optional(),
+    countRecords: z.boolean().optional(),
+    excludeFinalResult: z.boolean().optional(),
+});
+const QueryScriptSpecSchema = z.looseObject({
+    op: z.literal('SCRIPT'),
+    script: z.string(),
+    inputColumns: z.array(z.string()).optional(),
+    outputColumns: z.array(z.string()).optional(),
+});
+const QueryFunctionSpecSchema = z.discriminatedUnion('op', [
+    QueryFromSpecSchema,
+    QueryFromTableSpecSchema,
+    QueryShowTablesSpecSchema,
+    QueryWindowSpecSchema,
+    QueryCalendarWindowSpecSchema,
+    QueryGroupSpecSchema,
+    QueryOrderSpecSchema,
+    QueryKeepSpecSchema,
+    QueryCountSpecSchema,
+    QuerySumSpecSchema,
+    QueryMinSpecSchema,
+    QueryMaxSpecSchema,
+    QueryMeanSpecSchema,
+    QueryMultiAggregationSpecSchema,
+    QueryDerivativeSpecSchema,
+    QueryDifferenceSpecSchema,
+    QueryFirstSpecSchema,
+    QueryLastSpecSchema,
+    QueryQuantileSpecSchema,
+    QueryDistinctSpecSchema,
+    QueryDescribeSpecSchema,
+    QueryTopSpecSchema,
+    QueryBottomSpecSchema,
+    QueryNassAggregationSpecSchema,
+    QueryFilterSpecSchema,
+    QueryFilterExprFnSpecSchema,
+    QueryJoinDataSpecSchema,
+    QueryFormatTimeSpecSchema,
+    QueryFromMetadataSpecSchema,
+    QueryFromTopologySpecSchema,
+    QueryFromDataSpecSchema,
+    QueryJoinMetadataSpecSchema,
+    QueryJoinTopologySpecSchema,
+    QueryLogSpecSchema,
+    QueryNassMapSpecSchema,
+    QueryMapStringSpecSchema,
+    QueryMapSpecSchema,
+    QueryFormatSpecSchema,
+    QueryScriptSpecSchema,
+]);
+
+const QueryRequestSchema = z.looseObject({
+    query: z.array(QueryFunctionSpecSchema),
+    authorizationView: z.string().optional(),
+    limit: z.number().optional(),
+});
+
+const QueryResultSchema = z.array(z.unknown());
+
 var DXChannel;
 (function (DXChannel) {
+    /** @internal */
     DXChannel.DX_CHANNEL_RESPONSE_EXAMPLE_WEBHOOK = {
         id: 32498,
         orgId: 'ITOM-DX-DEMO-PROD',
@@ -25543,6 +26621,7 @@ var DXChannel;
         ],
         enableProxy: false,
     };
+    /** @internal */
     DXChannel.DX_CHANNEL_RESPONSE_EXAMPLE_SMTP = {
         id: 32393,
         orgId: 'ITOM-DX-DEMO-PROD',
@@ -25596,6 +26675,7 @@ var DXChannel;
         ],
         enableProxy: false,
     };
+    /** @internal */
     DXChannel.DX_CHANNEL_RESPONSE_EXAMPLE_ITSM = {
         id: 32182,
         orgId: 'ITOM-DX-DEMO-PROD',
@@ -40717,6 +41797,7 @@ var OIAlarm;
 
 var OIService;
 (function (OIService) {
+    /** @internal */
     OIService.DEFAULT_SERVICE_INVENTORY_FILTER = {
         "and": {
             "expressions": [{
@@ -40731,6 +41812,7 @@ var OIService;
                 }],
         },
     };
+    /** @internal */
     OIService.DEFAULT_SERVICE_INVENTORY_REQUEST_BODY = {
         "pageSize": 1000,
         "customFilter": OIService.DEFAULT_SERVICE_INVENTORY_FILTER,
@@ -40740,6 +41822,7 @@ var OIService;
         "projectionFields": ["product", "name", "ipAddresses", "serviceNames", "type", "maintenance"],
         "groupByField": "type",
     };
+    /** @internal */
     OIService.SAMPLE_SERVICE_INVENTORY_RESPONSE = {
         "totalCount": 11,
         "pageSize": 100,
@@ -40948,6 +42031,7 @@ var OIService;
     OIService.TYPICAL_SERVICE_REQUEST_PROJECTION_FILTER = ["rollupFilteredAlarmCount", "situationCount", "availability", "filteredParent", "availability_lastday",
         "immediateFilteredChildren", "immediateFilterChildrenCount", "health", "extId", "location", "maintenance",
         "name", "risk", "status", "tags", "serviceMetricGroups", "healthBucket"];
+    /** @internal */
     OIService.DEFAULT_SERVICE_REQUEST_BODY = {
         "time": DateTime.now().toMillis(),
         "filters": [],
@@ -40959,6 +42043,7 @@ var OIService;
         "projectionFilter": OIService.DEFAULT_SERVICE_REQUEST_PROJECTION_FILTER,
         "showAlarms": true,
     };
+    /** @internal */
     OIService.PARENT_SERVICE_REQUEST_BODY = {
         "time": DateTime.now().toMillis(),
         "filters": [],
@@ -40970,6 +42055,7 @@ var OIService;
         "projectionFilter": OIService.TYPICAL_SERVICE_REQUEST_PROJECTION_FILTER,
         "showSituations": true,
     };
+    /** @internal */
     OIService.sampleServices = {
         "services": [{
                 "name": "ACME NetOps Salisbury DC - NetOps-O2",
@@ -41180,6 +42266,7 @@ var OIService;
     };
 })(OIService || (OIService = {}));
 
+/** @internal */
 function createPostmanRequest(request) {
     function createPostmanHeaders(request) {
         const headersToReturn = new Array();
@@ -41285,6 +42372,7 @@ class SimpleHTTPError extends Error {
     }
 }
 
+/** @internal */
 const sampleServiceDetailRequestBody = {
     timeFrom: 1772843076673,
     timeTo: 1772929476673,
@@ -41293,6 +42381,7 @@ const sampleServiceDetailRequestBody = {
     userTimeZone: 'America/Los_Angeles',
     metrics: ['x6d-CE-H9B-1nQf0I0B', 'd_b-AE-H9B-3azifJ0B'],
 };
+/** @internal */
 const serviceDetailResponseBody = {
     service_name: 'SiteMinder PROD',
     id: 'SA:AA0725E0-0402-4320-A2B7-407025E9D673:41669409-e352-4ae5-af58-ba0da8989cd6',
@@ -43055,9 +44144,11 @@ var Situations;
 
 var TAS;
 (function (TAS) {
+    /** @internal */
     TAS.ALL_QUERY = {
         filter: { op: 'ALL' },
     };
+    /** @internal */
     TAS.GUENTER_AGENT_EDGE_QUERY = {
         filter: {
             op: 'TAKE_EDGES',
@@ -43074,6 +44165,7 @@ var TAS;
             ],
         },
     };
+    /** @internal */
     TAS.AGENT_QUERY = {
         filter: {
             op: 'ATTRIBUTE',
@@ -43304,6 +44396,7 @@ var MatchType;
     MatchType["ATTRIBUTE_PREFIX_IGNORE_CASE"] = "ATTRIBUTE_PREFIX_IGNORE_CASE";
     MatchType["ATTRIBUTE_CONTAINS"] = "ATTRIBUTE_CONTAINS";
 })(MatchType || (MatchType = {}));
+/** @internal */
 const excludedAttributes = [
     "agent",
     "product",
@@ -55658,6 +56751,7 @@ class AgentService {
         this.dxSaaSService = dxSaaSService;
         this.log = log ?? new Logging.NullSimpleLog();
     }
+    /** Queries agent sources whose name matches the given regex pattern. */
     queryAgentsByRegex(pattern) {
         const requestBody = {
             authorizationView: null,
@@ -55673,6 +56767,7 @@ class AgentService {
         };
         return this.dxSaaSService.tenantPost('/atc/views/querySource', requestBody);
     }
+    /** Queries agent sources by exact full name (prepends `SuperDomain|` if missing). */
     queryAgentsByExactName(name) {
         const sName = name.startsWith('SuperDomain|')
             ? name
@@ -55691,12 +56786,14 @@ class AgentService {
         };
         return this.dxSaaSService.tenantPost('/atc/views/querySource', requestBody);
     }
+    /** Retrieves all agent names, retrying once on failure. */
     retrieveAgentsWithRetry() {
         return this.retrieveAgents().catch((reason) => {
             this.log.warn('Error on first attempt (expected): ' + reason);
             return this.retrieveAgents();
         });
     }
+    /** Generates a configurable license report grouping agents by the provided licensing configuration rules. */
     async configurableLicenseReport(licenseConfiguration) {
         const agentNames = await this.retrieveAgentsWithRetry();
         this.log.debug(`AgentNames: ${agentNames.length}`);
@@ -55817,6 +56914,7 @@ class AgentService {
     regexMatches(agentNameRegex, agentName) {
         return new RegExp(agentNameRegex, 'i').test(agentName);
     }
+    /** Generates a default license report categorizing agents into Java, Node, Python, .NET, Infra, etc. */
     licenseReport() {
         return this.retrieveAgents().then((agentNames) => {
             const agentDescriptors = new Array();
@@ -55934,12 +57032,14 @@ class AgentService {
         return agentDescriptor.agentName.startsWith('Kubernetes Agent');
     }
     // /apm/atc/api/private/trace/detail
+    /** Returns the full trace detail for a given trace ID. */
     getTrace(traceId) {
         const traceRequestBody = {
             traceIds: [traceId],
         };
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/trace/detail', traceRequestBody);
     }
+    /** Returns trace summaries for a specific agent within a time range. */
     getTraceSummaries(startTime, endTime, agentName, index, limit, errorsOnly) {
         const traceSummaryRequestBody = {
             endTime: endTime.toISO(),
@@ -55952,6 +57052,7 @@ class AgentService {
         };
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/trace/summary', traceSummaryRequestBody);
     }
+    /** Starts a trace session on one or more agents with optional filters. */
     startAgentTrace(agents, minTXDuration, sessionDuration, parameterName, operationType, parameterNotSign, parameterValue, errorFilterValue) {
         let body = {
             agentList: agents,
@@ -55972,6 +57073,7 @@ class AgentService {
         }
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/agentlist/starttrace', body);
     }
+    /** Returns all agent statuses (deduped by processURL), optionally scoped to a universe or query. */
     async retrieveAllAgentStatuses(universeId, query) {
         const params = {
             page: 0,
@@ -55995,6 +57097,7 @@ class AgentService {
         this.log.debug(`retrieved ${statuses.items.length ?? 0} statuses`);
         return Array.from(statusMap.values());
     }
+    /** Returns a single page of agent statuses with explicit page/size control. */
     retrieveAgentStatuses(page, size, universeId, query) {
         return this.dxSaaSService
             .tenantGet('/apm/atc/api/private/agentlist', { page, size, universeId, q: query ?? 'latest:true' })
@@ -56002,6 +57105,7 @@ class AgentService {
             return agentStatusList.items;
         });
     }
+    /** Returns agent names active within a time window (defaults to last 12 hours). */
     retrieveAgents(startTime, endTime) {
         if (!endTime) {
             endTime = Date.now();
@@ -56018,12 +57122,14 @@ class AgentService {
             return agentNameList.items ?? [];
         });
     }
+    /** Returns agents matching a universe's NASS filter specifier. */
     retrieveAgentsForUniverseNASSFilter(universeNASSFilter) {
         return this.dxSaaSService.tenantPost('/atc/views/querySource', {
             authorizationView: null,
             specifier: universeNASSFilter,
         });
     }
+    /** Returns agent names active within a time window for a specific universe. */
     retrieveUniverseAgents(universeId, startTime, endTime) {
         if (!endTime) {
             endTime = Date.now();
@@ -56072,6 +57178,7 @@ class AgentService {
             }
         }
     }
+    /** Returns the previously collected thread dump data for a given thread dump ID. */
     async getThreadDump(threadDumpId) {
         const threadDumpBody = {
             id: threadDumpId,
@@ -56082,6 +57189,7 @@ class AgentService {
             return response;
         });
     }
+    /** Triggers a thread dump collection for the specified agent. */
     async collectThreadDump(fullAgentName) {
         if (!fullAgentName.startsWith('SuperDomain|')) {
             fullAgentName = 'SuperDomain|' + fullAgentName;
@@ -56097,6 +57205,7 @@ class AgentService {
             return response;
         });
     }
+    /** Returns existing thread dump records for the specified agent. */
     async queryThreadDumps(fullAgentName) {
         if (!fullAgentName.startsWith('SuperDomain|')) {
             fullAgentName = 'SuperDomain|' + fullAgentName;
@@ -56110,6 +57219,7 @@ class AgentService {
             return response;
         });
     }
+    /** Returns whether the specified agent supports thread dump collection. */
     async threadDumpCapable(fullAgentName) {
         if (!fullAgentName.startsWith('SuperDomain|')) {
             fullAgentName = 'SuperDomain|' + fullAgentName;
@@ -56141,11 +57251,13 @@ class AlarmService {
         this.dxSaaSService = dxSaaSService;
         this.simpleLog = simpleLog;
     }
+    /** Returns a single alarm by its ID using the GET endpoint. */
     async getAlarm(alarmId) {
         return this.dxSaaSService.oiGet('oi/v2/api/alarms/_search', {
             alarmId: alarmId,
         });
     }
+    /** Returns the overview (first alarm in a custom-filter search) for an alarm ID. */
     async getAlarmOverview(alarmId) {
         const singleAlarmQuery = await this.dxSaaSService.oiPost('oi/v2/api/alarms/_search', {
             deviceNames: [],
@@ -56192,6 +57304,7 @@ class AlarmService {
             throw new Error('Bad Alarm Query');
         }
     }
+    /** Sends a notification for an alarm to the specified channel with optional template/locale. */
     async triggerNotification(alarmId, notificationChannelName, template = '', locale = 'en-US') {
         const alarm = await this.getAlarmOverview(alarmId);
         const triggerBody = {
@@ -56206,6 +57319,7 @@ class AlarmService {
         this.simpleLog.debug(JSON.stringify(triggerBody, null, 2));
         return this.dxSaaSService.oiPost('oi/v2/api/alarmactions/channel', triggerBody);
     }
+    /** Assigns an alarm to a user by their user ID. */
     async assign(alarmId, userId) {
         const alarm = await this.getAlarm(alarmId);
         this.simpleLog.debug('original alarm:', JSON.stringify(alarm, null, 2));
@@ -56226,6 +57340,7 @@ class AlarmService {
         };
         return this.dxSaaSService.tenantPost('oi/v2/api/alarmactions/assign', body);
     }
+    /** Clears (closes) an alarm. */
     async clear(alarmId) {
         const alarm = await this.getAlarm(alarmId);
         this.simpleLog.debug('original alarm:', JSON.stringify(alarm, null, 2));
@@ -56246,6 +57361,7 @@ class AlarmService {
         };
         return this.dxSaaSService.tenantPost('oi/v2/api/alarmactions/clear', body);
     }
+    /** Acknowledges or unacknowledges an alarm. */
     async acknowledge(alarmId, unacknowledge = false) {
         const alarm = await this.getAlarm(alarmId);
         this.simpleLog.debug('original alarm:', JSON.stringify(alarm, null, 2));
@@ -56266,6 +57382,7 @@ class AlarmService {
         };
         return this.dxSaaSService.tenantPost('oi/v2/api/alarmactions/ack', body);
     }
+    /** Updates a single field on an alarm document via the Jarvis ingestion API. */
     async updateAlarmField(alarmId, field, value) {
         const alarm = await this.getAlarm(alarmId);
         this.simpleLog.debug('original alarm:', JSON.stringify(alarm, null, 2));
@@ -56302,6 +57419,7 @@ class AlarmService {
         this.simpleLog.debug('update request body', JSON.stringify(body, null, 2));
         return this.dxSaaSService.tenantPost('jarvis/v2/ingestion', body, {}, headers);
     }
+    /** Returns the lifecycle event history for a given alarm ID. */
     async getAlarmLifeCycle(alarmId) {
         const alarmLifeCycleRequestBody = {
             alarmId: alarmId,
@@ -56317,6 +57435,7 @@ class AlarmService {
         };
         return this.dxSaaSService.oiPost('oi/v2/api/alarms/lifecycle/_search', alarmLifeCycleRequestBody);
     }
+    /** Returns all alarms within a time range, with optional type/closed/filter params. */
     async getAlarms(startTime, endTime, includedAlarmTypes = [], includeClosed = false, pageSize = 100, alarmFilter) {
         const alarmRequestBody = DEFAULT_ALARMS_REQUEST_BODY$1;
         alarmRequestBody.timeFrom = startTime.toMillis();
@@ -56344,9 +57463,11 @@ class AlarmService {
         mapAlarms(alarmAllPage.alarms);
         return alarmIdMap;
     }
+    /** Returns all alarm enrichment rules configured for the tenant. */
     async getEnrichmentRules() {
         return this.dxSaaSService.oiGet('oi/v2/alarm/enrichment/rules');
     }
+    /** Lists all alarm queue (filter) configurations. */
     async getAlarmQueues() {
         //https://apmgw.dxi-na1.saas.broadcom.com/aa0725e004024320a2b7407025e9d673/oi/v2/api/alarmfilters/_search
         // ?sortBy=filterName&alarmCategory=rawAlarm&userRoles=TA
@@ -56354,6 +57475,7 @@ class AlarmService {
             sortBy: 'filterName',
         });
     }
+    /** Returns the detail of a single alarm queue by its ID. */
     async getAlarmQueueDetail(queueId) {
         //https://apmgw.dxi-na1.saas.broadcom.com/aa0725e004024320a2b7407025e9d673/oi/v2/api/alarmfilters/_search
         // ?id=0d8b6f6c-184e-4bba-b610-dfb07c275264&alarmCategory=rawAlarm
@@ -56369,6 +57491,7 @@ class AlarmService {
         showClosedAlarms: true,
         frequency: -1,
     };
+    /** Returns historically related alarms for a given alarm ID. */
     async getRelatedAlarms(alarmId) {
         const alarm = await this.getAlarm(alarmId);
         return this.dxSaaSService.oiPost('oi/v2/api/inspect/historicalRef', {
@@ -57988,6 +59111,7 @@ class AlertService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Returns all alerts using the v2 internal API (up to the API limit). */
     async retrieveAllAlertsV2() {
         return this.dxSaaSService
             .tenantPost('atc/private/internal/alert/query', AllAlertsRequestBody)
@@ -57998,6 +59122,7 @@ class AlertService {
             return alertList;
         });
     }
+    /** Returns up to the first 1000 alerts using the legacy alert API. */
     async retrieveFirst1000Alerts() {
         return this.dxSaaSService
             .tenantPost('/apm/atc/api/private/alert/query', AllAlertsRequestBody)
@@ -58008,6 +59133,7 @@ class AlertService {
             return alertList;
         });
     }
+    /** Retrieves all alerts across multiple cursor-paginated requests (increments of 500). */
     async reallyRetrieveAllAlerts() {
         const increment = 500;
         const alertList = await this.dxSaaSService.tenantPost('/apm/atc/api/private/alert/query', AlertService.createAlertRequestCursorRequestBody(0, increment));
@@ -58037,6 +59163,7 @@ class AlertService {
             throw new Error('Alert list contained no data.');
         }
     }
+    /** Returns all alerts for a management module using the v2 internal API. */
     async retrieveManagementModuleAlertsV2(managementModuleId) {
         return this.dxSaaSService
             .tenantPost('atc/private/internal/alert/query', {
@@ -58052,6 +59179,7 @@ class AlertService {
             return alertList;
         });
     }
+    /** Returns alerts belonging to a management module using the legacy alert API. */
     async retrieveManagementModuleAlerts(managementModuleId) {
         return this.dxSaaSService
             .tenantPost('/apm/atc/api/private/alert/query', AlertService.createManagementModuleAlertRequestBody(managementModuleId))
@@ -58062,6 +59190,7 @@ class AlertService {
             return alertList;
         });
     }
+    /** Returns all alerts (normal + summary) for a management module using the legacy API. */
     async retrieveAllManagementModuleAlerts(managementModuleId) {
         return this.dxSaaSService
             .tenantPost('/apm/atc/api/private/alert/query', AlertService.createManagementModuleAllAlertRequestBody(managementModuleId))
@@ -58072,14 +59201,17 @@ class AlertService {
             return alertList;
         });
     }
+    /** Returns a single alert definition by ID using the v2 internal API. */
     async retrieveAlertDefinitionV2(alertId, managementModuleId) {
         return this.dxSaaSService.tenantPost(`atc/private/internal/alert/get`, { itemId: alertId, mmId: managementModuleId });
     }
+    /** Returns a single alert definition by external ID using the legacy alert API. */
     async retrieveAlertDefinition(alertId) {
         const params = { externalId: alertId };
         const paramEncoded = lib$1.stringify(params);
         return this.dxSaaSService.tenantGet(`/apm/atc/api/private/alert/query?${paramEncoded}`);
     }
+    /** Copies an alert (v2) to a target management module with a new name, optionally changing active state/description. */
     async copyAlertV2(originalAlertId, originalManagementModuleId, newAlertName, targetManagementModuleId, active, description) {
         return this.retrieveAlertDefinitionV2(originalAlertId, originalManagementModuleId).then((alert) => {
             alert.managementModuleId = targetManagementModuleId;
@@ -58092,6 +59224,7 @@ class AlertService {
             return this.createAlertV2(alert);
         });
     }
+    /** Copies an alert (legacy) to a target management module with a new name. */
     async copyAlert(originalAlertId, newAlertName, targetManagementModuleName, active, description) {
         return this.retrieveAlertDefinition(originalAlertId).then((alert) => {
             alert.managementModuleName = targetManagementModuleName;
@@ -58104,6 +59237,7 @@ class AlertService {
             return this.createAlert(alert);
         });
     }
+    /** Copies an alert (legacy) to a new management module and assigns a different metric grouping. */
     async copyAlertWithNewMetricGrouping(originalAlertId, newAlertName, targetManagementModuleName, active, description, mgId) {
         return this.retrieveAlertDefinition(originalAlertId).then((alert) => {
             alert.managementModuleName = targetManagementModuleName;
@@ -58117,17 +59251,21 @@ class AlertService {
             return this.createAlert(alert);
         });
     }
+    /** Creates a new alert using the v2 internal API (strips ID before sending). */
     createAlertV2(alert) {
         delete alert.id;
         return this.dxSaaSService.tenantPost('atc/private/internal/alert', alert);
     }
+    /** Creates a new alert using the legacy alert API (strips ID before sending). */
     createAlert(alert) {
         delete alert.id;
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/alert/', alert);
     }
+    /** Updates an existing alert using the v2 internal API. */
     updateAlertV2(alert) {
         return this.dxSaaSService.tenantPost('atc/private/internal/alert', alert);
     }
+    /** Updates an existing alert using the legacy alert API. */
     updateAlert(alert) {
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/alert/', alert);
     }
@@ -58165,19 +59303,24 @@ class ApmUniverseService {
     constructor(dxSaaSService) {
         this.dxSaaSService = dxSaaSService;
     }
+    /** Returns all APM universes (views) for the tenant. */
     async retrieveAllUniverses() {
         let universeList = await this.dxSaaSService.tenantGet('/atc/views/view', { skipCount: 'true' });
         return universeList.items;
     }
+    /** Returns a single APM universe by its view ID. */
     retrieveUniverse(universeId) {
         return this.dxSaaSService.tenantGet(`/atc/views/view/${universeId}`);
     }
+    /** Creates a new APM universe from the given request body. */
     createUniverse(universe) {
         return this.dxSaaSService.tenantPost('/atc/views/view', universe);
     }
+    /** Deletes an APM universe by its view ID. */
     deleteUniverse(viewId) {
         return this.dxSaaSService.tenantDelete('/atc/views/view/' + viewId);
     }
+    /** Updates an existing APM universe. */
     updateUniverse(universe) {
         return this.dxSaaSService.tenantPut('/atc/views/view/' + universe.viewId, universe);
     }
@@ -58199,6 +59342,7 @@ class AsmService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Lazily creates and returns the ASM API client, using token and base URL from configuration. */
     getClient() {
         if (!this.localClient) {
             if (!this.dxSaaSService.dxdoConfiguration.dxConfiguration.dxASMToken) {
@@ -58221,6 +59365,7 @@ class AsmService {
         }
         return this.localClient;
     }
+    /** Lists all ASM scan folders accessible with the configured token. */
     async listFolders() {
         return foldersList({
             client: this.getClient(),
@@ -58251,9 +59396,11 @@ class AttributeService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Returns all intellisense attributes, optionally including gathered attributes. */
     async getAttributes(includeGathered) {
         return this.dxSaaSService.tenantGet('/apm/atc/api/private/intellisense/attribute', { includeGathered: includeGathered });
     }
+    /** Returns a `ListMap` of layer → attribute names for all gathered attributes. */
     async getAttributesAsListMap() {
         const newAttributesListMap = new ListMap();
         const attributesResponse = await this.getAttributes(true);
@@ -58263,6 +59410,7 @@ class AttributeService {
         }
         return newAttributesListMap;
     }
+    /** Returns `true` if an attribute with the given layer and name exists (uses cache). */
     async attributeExists(layer, name) {
         if (this.cachedAttributes.getMap().size == 0) {
             this.cachedAttributes = await this.getAttributesAsListMap();
@@ -58287,9 +59435,11 @@ class AuthorizationService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Returns all ACA groups, up to `maxResults` entries. */
     getGroups(maxResults = 200) {
         return this.dxSaaSService.tenantGet('/apm/atc/api/private/aca/group', { size: maxResults - 1, groupId: '*' });
     }
+    /** Finds ACA users matching a username, up to `maxResults` entries. */
     findUser(userName, maxResults = 200) {
         this.log.debug('Getting user');
         return this.dxSaaSService.tenantGet('/apm/atc/api/private/aca/user', {
@@ -58297,6 +59447,7 @@ class AuthorizationService {
             userId: userName,
         });
     }
+    /** Returns all OI users for the tenant. */
     getUsers() {
         return this.dxSaaSService.tenantGet('oi/v2/api/users');
     }
@@ -58317,6 +59468,7 @@ class AxaService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Returns a paginated list of user sessions for an application within a time range. */
     getSessions(applicationName, onlyWithScreenshots, startDateTime, endDateTime, cursor) {
         const params = {
             app_id: applicationName,
@@ -58334,6 +59486,7 @@ class AxaService {
         }
         return this.dxSaaSService.axaRequest('GET', 'mdo/v4/sessions/list', false, false, undefined, params);
     }
+    /** Returns the BA extension snippet (custom or default) for a given application. */
     getApplicationBAExtSnippet(applicationName, baJSType, profileId, tenantId) {
         return this.dxSaaSService.axaRequest('GET', 'mdo/v4/custombajs', false, false, undefined, {
             app_id: applicationName,
@@ -58342,9 +59495,11 @@ class AxaService {
             tenantId,
         });
     }
+    /** Uploads a custom BA extension snippet for an application. */
     setApplicationBAExtSnippet(applicationName, tenantId, formData) {
         return this.dxSaaSService.axaRequest('POST', `mdo/v4/custombajs/${tenantId}/${applicationName}`, false, false, formData, undefined, formData.getHeaders());
     }
+    /** Returns aggregated crash summary data for an application over a time range. */
     getCrashSummary(applicationName, startTime, endTime, aggregation) {
         return this.dxSaaSService.axaRequest('GET', 'mdo/v4/crashes/data', false, false, null, {
             app_id: applicationName,
@@ -58353,6 +59508,7 @@ class AxaService {
             start_date: startTime.toISO(),
         });
     }
+    /** Returns total crash summary (count/rate) for an application over a time range. */
     getCrashTotalSummary(applicationName, startTime, endTime, aggregation) {
         return this.dxSaaSService.axaRequest('GET', 'mdo/v4/crashes/total_summary', false, false, null, {
             app_id: applicationName,
@@ -58361,6 +59517,7 @@ class AxaService {
             start_date: startTime.toISO(),
         });
     }
+    /** Returns crash groups for an application within a time range. */
     getCrashGroups(applicationName, startTime, endTime, aggregation) {
         return this.dxSaaSService.axaRequest('GET', 'mdo/v4/crashes/crash_groups', false, false, null, {
             app_id: applicationName,
@@ -58369,6 +59526,7 @@ class AxaService {
             start_date: startTime.toISO(),
         });
     }
+    /** Returns all crash groups for an application within a time range (alias of getCrashGroups). */
     async getAllCrashGroups(applicationName, startTime, endTime, aggregation) {
         return this.dxSaaSService.axaRequest('GET', 'mdo/v4/crashes/crash_groups', false, false, null, {
             app_id: applicationName,
@@ -58377,6 +59535,7 @@ class AxaService {
             start_date: startTime.toISO(),
         });
     }
+    /** Returns individual crash records within a specific crash group. */
     getCrashesInGroup(applicationName, groupId, startTime, endTime, aggregation) {
         return this.dxSaaSService.axaRequest('GET', `mdo/v4/crashes/crashlist/${groupId}`, false, false, null, {
             app_id: applicationName,
@@ -58385,40 +59544,51 @@ class AxaService {
             start_date: startTime.toISO(),
         });
     }
+    /** Returns the detail payload for a single crash by its ID. */
     getCrashDetails(crashId) {
         return this.dxSaaSService.axaRequest('GET', `mdo/v4/crashes/crashes/${crashId}`, false, false, null);
     }
+    /** Creates a new AXA application. */
     createApplication(application) {
         this.log.debug('creating application using mda/v4');
         return this.dxSaaSService.axaRequest('POST', 'mdo/v4/apps', false, false, application);
     }
+    /** Returns all AXA applications for the tenant. */
     getApplications() {
         this.log.debug('getting applications using mda/v4');
         return this.dxSaaSService.axaRequest('GET', 'mdo/v4/apps', false, false);
     }
+    /** Returns a single AXA application by name. */
     getApplication(applicationName) {
         return this.dxSaaSService.axaRequest('GET', `mdo/v4/apps/${applicationName}`, false, false);
     }
+    /** Deletes an AXA application by name. */
     deleteApplication(applicationName) {
         return this.dxSaaSService.axaRequest('DELETE', `mdo/v4/apps/${applicationName}`, false, false);
     }
+    /** Returns all data collection profiles for the tenant. */
     getDataCollectionProfiles() {
         return this.dxSaaSService.axaRequest('GET', 'mdo/v4/profiles/tenant', false, false);
     }
+    /** Updates an existing data collection profile by its numeric ID. */
     async updateDataCollectionProfile(profileId, updatedProfile) {
         return this.dxSaaSService.axaRequest('PUT', `mdo/v4/profiles/${profileId}`, false, false, updatedProfile);
     }
+    /** Creates (imports) a data collection profile for a given cohort and application. */
     async importDataCollectionProfile(cohortId, applicationName, updatedProfile) {
         return this.dxSaaSService.axaRequest('POST', `mdo/v4/profiles/create/${cohortId}/${applicationName}`, false, false, updatedProfile);
     }
+    /** Returns the currently assigned data collection profile for an application. */
     async getApplicationProfile(applicationName) {
         return this.dxSaaSService.axaRequest('GET', `mdo/v4/profiles/${applicationName}`, false, false);
     }
+    /** Assigns a data collection profile to an application by profile ID. */
     async setApplicationProfile(applicationName, profileId) {
         return this.dxSaaSService.axaRequest('PUT', `mdo/v4/profiles/app/${applicationName}`, false, false, {}, {
             profile_id: profileId,
         });
     }
+    /** Returns user activity data for an application (last 24 hours). */
     async getActivities(appName) {
         return this.dxSaaSService.axaRequest('GET', 'mdo/v4/user_activity/activities/', false, false, {}, {
             start_date: DateTime.now().minus({ days: 1 }).toISO(),
@@ -58428,6 +59598,7 @@ class AxaService {
             cachebuster: DateTime.now().toMillis(),
         });
     }
+    /** Returns screen-level activity data for an application (last 30 days). */
     async getScreens(appName) {
         return this.dxSaaSService.axaRequest('GET', 'mdo/v4/user_activity/screens/', false, false, {}, {
             start_date: DateTime.now().minus({ days: 30 }).toISO(),
@@ -58438,6 +59609,7 @@ class AxaService {
             num_of_results: 100,
         });
     }
+    /** Creates a new user activity record. */
     async createActivity(activityCreateRequest) {
         return this.dxSaaSService.axaRequest('POST', 'mdo/v4/user_activity', false, false, activityCreateRequest);
     }
@@ -58458,9 +59630,11 @@ class BlobService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Returns the list of available blob schemas. */
     async listSchemas() {
         return this.dxSaaSService.tenantPost('/blobstorage/schema/list', {});
     }
+    /** Fetches a blob by schema, ID, and optional version; returns the raw data string. */
     async fetchBlob(schema, id, version) {
         return this.dxSaaSService
             .tenantPost('/blobstorage/blob/fetch', {}, {
@@ -58472,6 +59646,7 @@ class BlobService {
             return response.data;
         });
     }
+    /** Returns all blobs (without content) registered under a given schema. */
     async listBlobsForSchema(schema) {
         this.log.debug(`requesting all blobs for schema '${schema}'`);
         return this.dxSaaSService.tenantPost('/blobstorage/blob/query', {
@@ -58496,6 +59671,7 @@ class ChannelService {
     constructor(dxSaaSService) {
         this.dxSaaSService = dxSaaSService;
     }
+    /** Returns all notification channels using the new DXChannelConfiguration model. */
     retrieveAllChannelsNew() {
         return this.dxSaaSService
             .axaRequest('get', 'dxinotify/notify/v1/channels', true, false)
@@ -58503,6 +59679,7 @@ class ChannelService {
             return channelResponseBody.channels;
         });
     }
+    /** Returns all notification channels using the legacy Channel model. */
     retrieveAllChannels() {
         return this.dxSaaSService
             .axaRequest('get', 'dxinotify/notify/v1/channels', true, false)
@@ -58510,30 +59687,35 @@ class ChannelService {
             return channelResponseBody.channels;
         });
     }
+    /** Creates a new notification channel using the new DXChannelConfiguration model. */
     async createChannelNew(channelToCreate) {
         delete channelToCreate.id;
         channelToCreate.orgId = await this.dxSaaSService.getTenantCN();
         channelToCreate.author = 'dx-do';
         return this.dxSaaSService.axaRequest('put', 'dxinotify/notify/v1/channels', false, false, channelToCreate);
     }
+    /** Creates a new notification channel using the legacy Channel model. */
     async createChannel(channelToCreate) {
         delete channelToCreate.id;
         channelToCreate.orgId = await this.dxSaaSService.getTenantCN();
         channelToCreate.author = 'dx-do';
         return this.dxSaaSService.axaRequest('put', 'dxinotify/notify/v1/channels', false, false, channelToCreate);
     }
+    /** Updates an existing channel by ID using the new DXChannelConfiguration model. */
     async updateChannelNew(existingChannelId, channelUpdate) {
         channelUpdate.orgId = await this.dxSaaSService.getTenantCN();
         channelUpdate.id = existingChannelId;
         channelUpdate.author = 'dx-do';
         return this.dxSaaSService.axaRequest('put', 'dxinotify/notify/v1/channels', false, false, channelUpdate);
     }
+    /** Updates an existing channel by ID using the legacy Channel model. */
     async updateChannel(existingChannelId, channelUpdate) {
         channelUpdate.orgId = await this.dxSaaSService.getTenantCN();
         channelUpdate.id = existingChannelId;
         channelUpdate.author = 'dx-do';
         return this.dxSaaSService.axaRequest('put', 'dxinotify/notify/v1/channels', false, false, channelUpdate);
     }
+    /** Returns all notification templates. */
     retrieveAllTemplates() {
         return this.dxSaaSService
             .axaRequest('get', 'dxinotify/notify/v1/templates', false, true)
@@ -58541,6 +59723,7 @@ class ChannelService {
             return templatesResponseBody.templates;
         });
     }
+    /** Returns all notification filter policies. */
     retrieveAllPolicies() {
         return this.dxSaaSService
             .axaRequest('get', 'dxinotify/notify/v1/filters', true, false)
@@ -58548,12 +59731,15 @@ class ChannelService {
             return policyResponse.filters;
         });
     }
+    /** Updates an existing notification filter policy. */
     updatePolicy(policy) {
         return this.dxSaaSService.axaRequest('put', 'dxinotify/notify/v1/filters', false, false, policy);
     }
+    /** Creates a new notification filter policy. */
     createPolicy(policy) {
         return this.dxSaaSService.axaRequest('put', 'dxinotify/notify/v1/filters', false, false, policy);
     }
+    /** Creates a new notification template with text (base64-encoded) and optional metadata. */
     createTemplate(templateName, templateSubject, templateText, senderNameTemplate, locale, makeDefault, author) {
         return this.dxSaaSService.axaRequest('put', 'dxinotify/notify/v1/templates', false, false, {
             orgId: this.dxSaaSService.getTenantCN(),
@@ -58572,6 +59758,7 @@ class ChannelService {
             templateText: Buffer.from(templateText).toString('base64'),
         });
     }
+    /** Updates fields on an existing template; any omitted fields keep their current values. */
     updateTemplate(currentTemplate, newTemplateName, newTemplateSubject, newTemplateText, senderNameTemplate, locale, makeDefault, author) {
         currentTemplate.oldTemplateName = currentTemplate.templateName;
         currentTemplate.templateName =
@@ -58595,11 +59782,13 @@ class DashboardService {
     constructor(dxSaaSService) {
         this.dxSaaSService = dxSaaSService;
     }
+    /** Returns the current org theme setting (e.g. "light" or "dark"). */
     getTheme() {
         return this.dxSaaSService
             .dashboardGet('api/org/preferences')
             .then((preferences) => preferences.theme);
     }
+    /** Sets the org theme preference. */
     setTheme(themeString) {
         return this.dxSaaSService
             .dashboardPut('api/org/preferences', {
@@ -58611,9 +59800,11 @@ class DashboardService {
             return undefined;
         });
     }
+    /** Lists all API keys for the org. */
     listApiKeys() {
         return this.dxSaaSService.dashboardGet('api/auth/keys');
     }
+    /** Creates a new dashboard in the specified folder (clears the ID before sending). */
     createDashboard(folderId, dashboard, updateCommitMessage) {
         dashboard.id = undefined;
         return this.dxSaaSService.dashboardPost('api/dashboards/db', {
@@ -58623,6 +59814,7 @@ class DashboardService {
             message: updateCommitMessage,
         });
     }
+    /** Updates an existing dashboard by ID, optionally overwriting the current version. */
     updateDashboard(id, folderId, dashboard, updateCommitMessage, overwrite) {
         if (!dashboard.id || dashboard.id != id) {
             dashboard.id = id;
@@ -58634,23 +59826,28 @@ class DashboardService {
             message: updateCommitMessage,
         });
     }
+    /** Returns all dashboard tags used across the org. */
     getAllDashboardTags() {
         return this.dxSaaSService.dashboardGet('api/dashboards/tags');
     }
+    /** Appends new tags to a dashboard (skips tags already present). */
     async addDashboardTags(uid, tags) {
         const currentDashboard = await this.getDashboard(uid);
         const actualNewTags = tags.filter((newTag) => !currentDashboard.dashboard.tags.includes(newTag));
         currentDashboard.dashboard.tags.push(...actualNewTags);
         return this.updateDashboard(currentDashboard.dashboard.id, currentDashboard.meta.folderId, currentDashboard.dashboard, `Added Tags: [${actualNewTags.join(',')}]`);
     }
+    /** Replaces all existing tags on a dashboard with the provided set. */
     async replaceDashboardTags(uid, newTags) {
         const currentDashboard = await this.getDashboard(uid);
         currentDashboard.dashboard.tags = newTags;
         return this.updateDashboard(currentDashboard.dashboard.id, currentDashboard.meta.folderId, currentDashboard.dashboard, `Replaced Tags: [${newTags.join(',')}]`);
     }
+    /** Returns the full dashboard (model + meta) for a given UID. */
     getDashboard(uid) {
         return this.dxSaaSService.dashboardGet(`api/dashboards/uid/${uid}`);
     }
+    /** Returns all dashboards within a specific folder. */
     getDashboardsInFolder(folderId) {
         return this.dxSaaSService.dashboardGet('api/search', {
             type: DashboardSearch.SearchType.DASHBOARD,
@@ -58658,23 +59855,28 @@ class DashboardService {
             folderIds: folderId,
         });
     }
+    /** Searches dashboards or folders by type and query string. */
     search(searchType, query) {
         return this.dxSaaSService.dashboardGet('api/search', {
             type: searchType,
             query: query,
         });
     }
+    /** Returns folder metadata by numeric folder ID. */
     getFolderById(folderId) {
         return this.dxSaaSService.dashboardGet(`api/folders/id/${folderId}`);
     }
+    /** Returns folder metadata by UID string. */
     getFolderByUid(folderUid) {
         return this.dxSaaSService.dashboardGet(`api/folders/${folderUid}`);
     }
+    /** Returns the UID for a folder with the given title, or `undefined` if not found. */
     getFolderUid(folderTitle) {
         return this.getFoldersMapByTitle().then((folderMap) => {
             return folderMap.get(folderTitle)?.uid ?? undefined;
         });
     }
+    /** Returns a map of folder title → folder item for all folders. */
     getFoldersMapByTitle() {
         return this.getFolders().then((folders) => {
             return folders.reduce(function (map, folder) {
@@ -58683,9 +59885,11 @@ class DashboardService {
             }, new Map());
         });
     }
+    /** Returns all folders for the org. */
     getFolders() {
         return this.dxSaaSService.dashboardGet('api/folders');
     }
+    /** Creates a new folder with the given title and optional UID. */
     createFolder(folderTitle, folderUid) {
         const body = {
             title: folderTitle,
@@ -58695,9 +59899,11 @@ class DashboardService {
         }
         return this.dxSaaSService.dashboardPost('api/folders', body);
     }
+    /** Returns the permission list for a folder by UID. */
     getFolderPermissions(folderUid) {
         return this.dxSaaSService.dashboardGet(`api/folders/${folderUid}/permissions`);
     }
+    /** Adds a permission entry for a user to a folder, preserving existing permissions. */
     async addFolderPermission(folderUid, userId, permissionType) {
         const existingPermissions = await this.getFolderPermissions(folderUid);
         const updatePermissions = new Array();
@@ -58731,6 +59937,7 @@ class DashboardService {
         });
         return this.setFolderPermissions(folderUid, updatePermissions);
     }
+    /** Issues a multi-search against the audit log datasource using a session cookie. */
     mSearch(validSessionCookie, startTime, endTime) {
         const body1 = {
             search_type: 'query_then_fetch',
@@ -58767,13 +59974,16 @@ class DashboardService {
         const body = JSON.stringify(body1) + '\n' + JSON.stringify(body2);
         return this.dxSaaSService.dashboardCookiePost('api/datasources/proxy/29484/_msearch', body, {}, { Cookie: validSessionCookie });
     }
+    /** Replaces all permissions on a folder with the provided list. */
     setFolderPermissions(folderUid, permissions) {
         return this.dxSaaSService.dashboardPost(`api/folders/${folderUid}/permissions`, { items: permissions });
     }
+    /** Searches org users by a query term (useful for permission assignment). */
     searchUsers(searchTerm) {
         // /api/users/search?perpage=10&page=1&query=mygraf
         return this.dxSaaSService.dashboardGet('api/org/users/lookup', { query: searchTerm });
     }
+    /** Looks up a single org user by email or login name. */
     lookupUser(userEmail) {
         return this.dxSaaSService.dashboardGet('api/org/users/lookup', {
             loginOrEmail: userEmail,
@@ -64316,10 +65526,12 @@ class DxSaasService {
     getTokenUser() {
         return getUserTokenSub(this.dxdoConfiguration.dxConfiguration.userToken);
     }
+    /** Verify connectivity by fetching the ATC view list. */
     ping() {
         this.log.debug('Pinging DX Tenant');
         return this.tenantGet('/atc/views/view', { skipCount: 'true' });
     }
+    /** Authenticate and return the current user's profile from the AXA security endpoint. */
     auth() {
         return this.axaRequest('GET', 'ess/security/v1/me', false, false);
     }
@@ -64353,6 +65565,14 @@ class DxSaasService {
         this.log.debug(`debug: prepared axa session host as ${gwURL.toString()}`);
         return gwURL.toString();
     }
+    /**
+     * Fetch AXA session events (APM Synthetic / AXA user sessions) from the Elasticsearch exporter.
+     * @param startTimestamp - Start of the time window (epoch ms).
+     * @param endTimestamp - End of the time window (epoch ms).
+     * @param maxSessions - Maximum number of session records to return.
+     * @param appId - AXA application ID to filter by.
+     * @param query - Optional Lucene query string override. Defaults to `app.id:"<appId>"`.
+     */
     async axaSessionRequest(startTimestamp, endTimestamp, maxSessions, appId, query) {
         if (!query) {
             query = `app.id:"${appId}"`;
@@ -64404,6 +65624,16 @@ class DxSaasService {
     async getConnectorConfig() {
         return this.axaRequest('GET', 'ess/udsconfig/v1/connectorconfig', false, false);
     }
+    /**
+     * Issue an arbitrary HTTP request to the AXA sub-domain (Elasticsearch exporter or UDS config).
+     * @param method - HTTP method.
+     * @param path - Path relative to the AXA host, optionally suffixed with tenant CN.
+     * @param appendTenantToPath - When `true`, the tenant common name is appended to `path`.
+     * @param appendOrgIdToParams - When `true`, `orgid` query param is added automatically.
+     * @param body - Request body (non-GET only).
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async axaRequest(method, path, appendTenantToPath, appendOrgIdToParams, body, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/${path}${appendTenantToPath ? '/' + (await this.getTenantCN()) : ''}`;
         this.log.debug('retrieving axa:', url);
@@ -64440,6 +65670,11 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * Issue an HTTP PATCH to a tenant-scoped path under the DX gateway.
+     * @param path - Relative path after the cohort segment.
+     * @param body - Partial update payload.
+     */
     async tenantPatch(path, body) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/${path}`;
         return this._httpClient
@@ -64456,6 +65691,13 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * Issue an HTTP POST to a tenant-scoped path under the DX gateway.
+     * @param path - Relative path after the cohort segment (e.g. `"atc/views/view"`).
+     * @param body - Request body (JSON-serializable). Defaults to `{}`.
+     * @param params - Query-string parameters.
+     * @param headers - Additional request headers merged over the auth header.
+     */
     async tenantPost(path, body, params, headers = {}) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/${path}`;
         const requestConfig = this.createSimpleUserAuthorizedRequestConfig(params ?? {});
@@ -64475,6 +65717,12 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * Issue an HTTP PUT to a tenant-scoped path under the DX gateway.
+     * @param path - Relative path after the cohort segment.
+     * @param body - Request body.
+     * @param params - Query-string parameters.
+     */
     async tenantPut(path, body, params) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/${path}`;
         return this._httpClient
@@ -64491,6 +65739,10 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * Issue an HTTP POST to a tenant path and return the response as a Node.js stream.
+     * Useful for large binary downloads (e.g. metric data exports).
+     */
     async tenantPostForStream(path, body, params) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/${path}`;
         const config = this.createSimpleUserAuthorizedRequestConfig(params ?? {});
@@ -64509,6 +65761,15 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * Issue an arbitrary HTTP method to a tenant-scoped path.
+     * Prefer the typed helpers (`tenantGet`, `tenantPost`, etc.) when the method is known.
+     * @param method - HTTP method (GET, POST, PUT, DELETE, …).
+     * @param path - Relative path after the cohort segment.
+     * @param body - Request body (non-GET methods only).
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async tenantRequest(method, path, body, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/${path}`;
         if (!params) {
@@ -64540,6 +65801,12 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * Issue an HTTP GET to a tenant-scoped path under the DX gateway.
+     * @param path - Relative path after the cohort segment.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async tenantGet(path, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/${path}`;
         const config = this.createSimpleUserAuthorizedRequestConfig(params ?? {});
@@ -64565,6 +65832,12 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * Issue an HTTP DELETE to a tenant-scoped path under the DX gateway.
+     * @param path - Relative path after the cohort segment.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async tenantDelete(path, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/${path}`;
         const config = this.createSimpleUserAuthorizedRequestConfig(params ?? {});
@@ -64607,6 +65880,13 @@ class DxSaasService {
             params: params,
         };
     }
+    /**
+     * POST to an OI (Operational Intelligence) path with `x-authorizationview: VIEWALL` header.
+     * @param path - Relative path after the cohort segment.
+     * @param body - Request body.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async oiPost(path, body, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/${path}`;
         const config = this.createUserAuthorizedRequestConfig(params ?? {});
@@ -64632,6 +65912,12 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * GET from an OI (Operational Intelligence) path with `x-authorizationview: VIEWALL` header.
+     * @param path - Relative path after the cohort segment.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async oiGet(path, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/${path}`;
         const config = this.createUserAuthorizedRequestConfig(params ?? {});
@@ -64657,6 +65943,12 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * GET from an ACC path, returning the response as a Node.js readable stream.
+     * @param path - Path segment appended after `.../acc/`.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async accStream(path, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/acc/${path}`;
         const aheaders = this.createUserAuthorizedRequestConfig(params);
@@ -64687,6 +65979,12 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * GET from an ACC path.
+     * @param path - Path segment appended after `.../acc/`.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async accGet(path, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/acc/${path}`;
         const aheaders = this.createUserAuthorizedRequestConfig({});
@@ -64716,6 +66014,13 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * PATCH to an ACC path.
+     * @param path - Path segment appended after `.../acc/`.
+     * @param body - Partial update payload.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async accPatch(path, body, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/acc/${path}`;
         const headers = this.createUserAuthorizedRequestConfig({}).headers;
@@ -64745,6 +66050,13 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * POST a file to an ACC path using `multipart/form-data`.
+     * @param urlpath - Path segment appended after `.../acc/`.
+     * @param filepath - Absolute path on disk to the file to upload.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async accPostFile(urlpath, filepath, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/acc/${path$1}`;
         const headers = this.createUserAuthorizedRequestConfig({}).headers;
@@ -64784,6 +66096,13 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * POST to an ACC path.
+     * @param path - Path segment appended after `.../acc/`.
+     * @param body - Request body.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async accPost(path, body, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/acc/${path}`;
         const headers = this.createUserAuthorizedRequestConfig({}).headers;
@@ -64823,6 +66142,12 @@ class DxSaasService {
             return {};
         }
     }
+    /**
+     * GET from a Dashboard (Grafana) path under `.../dxd/`.
+     * @param path - Path segment appended after `.../dxd/`.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async dashboardGet(path, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/dxd/${path}`;
         const headers = this.createDashboardAuthorizedRequestHeaders();
@@ -64852,6 +66177,12 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * DELETE from a Dashboard (Grafana) path under `.../dxd/`.
+     * @param path - Path segment appended after `.../dxd/`.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async dashboardDelete(path, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/dxd/${path}`;
         const headers = this.createDashboardAuthorizedRequestHeaders();
@@ -64881,6 +66212,10 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * POST to a Dashboard path using cookie-based (anonymous) auth instead of the bearer token.
+     * Used for Grafana endpoints that authenticate via session cookies.
+     */
     async dashboardCookiePost(path, body, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/dxd/${path}`;
         const headers = {};
@@ -64912,6 +66247,13 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * POST to a Dashboard (Grafana) path under `.../dxd/`.
+     * @param path - Path segment appended after `.../dxd/`.
+     * @param body - Request body.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async dashboardPost(path, body, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/dxd/${path}`;
         const headers = this.createDashboardAuthorizedRequestHeaders();
@@ -64942,6 +66284,13 @@ class DxSaasService {
             }
         });
     }
+    /**
+     * PUT to a Dashboard (Grafana) path under `.../dxd/`.
+     * @param path - Path segment appended after `.../dxd/`.
+     * @param body - Request body.
+     * @param params - Query-string parameters.
+     * @param extraHeaders - Additional request headers.
+     */
     async dashboardPut(path, body, params, extraHeaders) {
         const url = `${this.dxdoConfiguration.dxConfiguration.dxGatewayHost}${this.getCohortIDForURL()}/dxd/${path}`;
         const headers = this.createDashboardAuthorizedRequestHeaders();
@@ -65056,26 +66405,31 @@ class DxoiService {
     constructor(dxSaaSService) {
         this.dxSaaSService = dxSaaSService;
     }
+    /** Returns top-level OI services using the default service request body. */
     getServices() {
         const filterBody = OIService.DEFAULT_SERVICE_REQUEST_BODY;
         return this.dxSaaSService.oiPost('oi/v2/servicerepo/services', filterBody);
     }
+    /** Returns cluster alarms (situations) within the given time range. */
     async getSituations(startTime, endTime) {
         const alarmRequestBody = DEFAULT_SITUATIONS_REQUEST_BODY;
         alarmRequestBody.timeFrom = startTime.toMillis();
         alarmRequestBody.timeTo = endTime.toMillis();
         return this.dxSaaSService.oiPost('oi/v2/api/clusteralarms/_search', alarmRequestBody);
     }
+    /** Returns the entity-detail attributes for a given entity external ID. */
     async getEntityAttributes(entityExternalId) {
         return this.dxSaaSService.oiPost('oi/v3/api/inventory/entity-details', {
             externalId: entityExternalId,
         });
     }
+    /** Returns a single alarm by its ID. */
     async getAlarm(alarmId) {
         return this.dxSaaSService.oiGet('oi/v2/api/alarms/_search', {
             alarmId: alarmId,
         });
     }
+    /** Returns the lifecycle event history for a given alarm ID. */
     async getAlarmLifeCycle(alarmId) {
         const alarmLifeCycleRequestBody = {
             alarmId: alarmId,
@@ -65091,6 +66445,7 @@ class DxoiService {
         };
         return this.dxSaaSService.oiPost('oi/v2/api/alarms/lifecycle/_search', alarmLifeCycleRequestBody);
     }
+    /** Returns all alarms in a time range, paginating until the full count is fetched. */
     async getAlarms(startTime, endTime) {
         const alarmRequestBody = DEFAULT_ALARMS_REQUEST_BODY;
         alarmRequestBody.timeFrom = startTime.toMillis();
@@ -65132,6 +66487,7 @@ class EventService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Ingests a custom alarm event via the Jarvis ingestion API. */
     createAlarm(alarmEvent) {
         const ingestionBody = {
             documents: [
@@ -65152,6 +66508,7 @@ class EventService {
             index_name: 'ao_itoa_alarms_custom_1',
         });
     }
+    /** Ingests a custom event (non-change) via the Jarvis ingestion API. */
     createEvent(changeEvent) {
         const ingestionBody = {
             documents: [
@@ -65172,6 +66529,7 @@ class EventService {
             index_name: 'ao_itoa_events_custom_1',
         });
     }
+    /** Ingests a custom change event via the Jarvis ingestion API. */
     createChangeEvent(changeEvent) {
         const ingestionBody = {
             documents: [
@@ -65192,6 +66550,7 @@ class EventService {
             index_name: 'ao_itoa_events_change_custom_1',
         });
     }
+    /** Queries change events using a Lucene query string within a time range. */
     queryChangeEvents(luceneQuery, startTime, endTime, from = 0, size = 100) {
         return this.dxSaaSService.oiGet('oi/v2/aoanalytics/events/events_change_custom/_search', {
             q: luceneQuery,
@@ -65218,6 +66577,7 @@ class ExperienceService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Returns a map of experience name → latest experience settings (one entry per name). */
     async getLatestExperienceSettings() {
         const experienceSettings = await this.getExperienceSettings();
         const nameExperienceSettingsMap = new Map();
@@ -65228,6 +66588,7 @@ class ExperienceService {
         });
         return nameExperienceSettingsMap;
     }
+    /** Returns a map of experience ID → latest experience settings (one entry per ID). */
     async getLatestExperienceSettingsById() {
         const experienceSettings = await this.getExperienceSettings();
         const idExperienceSettingsMap = new Map();
@@ -65238,9 +66599,11 @@ class ExperienceService {
         });
         return idExperienceSettingsMap;
     }
+    /** Returns all raw experience settings items from the API. */
     async getExperienceSettings() {
         return this.dxSaaSService.tenantGet('/apm/atc/api/private/settings/experience');
     }
+    /** Returns a single experience settings record by its ID; throws if not found. */
     async getExperienceSettingsById(experienceId) {
         const experiencesById = await this.getLatestExperienceSettingsById();
         if (experiencesById.has(experienceId)) {
@@ -65250,6 +66613,7 @@ class ExperienceService {
             throw new Error(`Experience ${experienceId} not found.`);
         }
     }
+    /** Returns top-level experience data for all configured experiences in a time range. */
     async getTopLevelExperiences(startTime, endTime) {
         const latestExperienceSettings = await this.getLatestExperienceSettings();
         const dashboardExperienceRequestItems = new Array();
@@ -65270,10 +66634,12 @@ class ExperienceService {
         };
         return this.dxSaaSService.tenantPost('/atc/dashboard/experience', request);
     }
+    /** Returns drilldown experience data filtered by the given attribute values. */
     async getDrilldownExperiences(experienceId, drilldown, startTime, endTime) {
         const experienceSettings = await this.getExperienceSettingsById(experienceId);
         return this.dxSaaSService.tenantPost('/atc/dashboard/application', this.createDrilldownExperienceRequestBody(experienceSettings, drilldown, startTime, endTime));
     }
+    /** Returns experience data for a single experience ID in a time range. */
     async getExperiences(experienceId, startTime, endTime) {
         const experienceSettings = await this.getExperienceSettingsById(experienceId);
         return this.dxSaaSService.tenantPost('/atc/dashboard/application', this.createExperienceRequestBody(experienceSettings, startTime, endTime));
@@ -65313,9 +66679,11 @@ class ExperienceService {
             throw new Error('drilldown has more layers than experience has groupings');
         }
     }
+    /** Imports (creates) an experience settings record from a partial payload. */
     async importExperience(experience) {
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/settings/experience', experience);
     }
+    /** Creates a new experience settings definition with the given name, universe, and group attributes. */
     async createExperience(experienceName, universeId, groupAttributes, graphType, owner) {
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/settings/experience', {
             type: 'experience',
@@ -65329,6 +66697,7 @@ class ExperienceService {
             },
         });
     }
+    /** Deletes an experience settings definition by its ID. */
     async deleteExperience(experienceId) {
         return this.dxSaaSService.tenantDelete(`/apm/atc/api/private/settings/experience/${experienceId}`);
     }
@@ -67985,9 +69354,11 @@ class GraphService {
     constructor(dxSaaSService) {
         this.dxSaaSService = dxSaaSService;
     }
+    /** Stores a graph (vertices and edges) using the appmap ATS graph store endpoint. */
     async storeGraph(graphBody) {
         return this.dxSaaSService.tenantPost('/apm/appmap/ats/graph/store', graphBody);
     }
+    /** Returns an HTTP stream of the graph range (diff between two times) for a universe. */
     retrieveGraphRangeStream(universeId, startDateTime, endDateTime, layer = GraphLayer$1.INFRASTRUCTURE) {
         const graphRangeRequestParams = {
             endTime: endDateTime.toISO(),
@@ -68004,6 +69375,7 @@ class GraphService {
         };
         return this.dxSaaSService.tenantPostForStream('/apm/atc/api/private/graph/range', graphRangeRequestBody, graphRangeRequestParams);
     }
+    /** Returns an HTTP stream of the full graph for a universe and layer. */
     retrieveGraphStream(universeId, layer = GraphLayer$1.ATC) {
         const graphRequestBody = {
             includedVertices: [],
@@ -68014,6 +69386,7 @@ class GraphService {
         };
         return this.dxSaaSService.tenantPostForStream('/apm/atc/api/private/graph/', graphRequestBody, { universeId: universeId, layer: 'ATC' });
     }
+    /** Collects all edges and vertices from a graph stream into a `GraphElements` result. */
     async getGraphElementsFromStream(graphStream) {
         const graphElementMaps = await this.getGraphElementMapsFromStream(graphStream);
         return {
@@ -68021,6 +69394,7 @@ class GraphService {
             vertices: Array.from(graphElementMaps.vertices.values()),
         };
     }
+    /** Collects all edges and vertices from a graph stream into keyed maps. */
     async getGraphElementMapsFromStream(graphStream) {
         const edges = new Map();
         const nodes = new Map();
@@ -68033,6 +69407,7 @@ class GraphService {
         await this.processGraphStreamWithHandlers(graphStream, r1EdgeHandler, r1NodeHandler);
         return { edges: edges, vertices: nodes };
     }
+    /** Processes a graph stream, dispatching each edge/vertex to the provided handler callbacks. */
     processGraphStreamWithHandlers(graphStream, edgeHandler, vertexHandler) {
         const edgePipeline = chain$1([
             graphStream,
@@ -68068,6 +69443,7 @@ class GraphService {
             edgePipeline.on('error', (error) => reject(error));
         });
     }
+    /** Processes a graph stream, emitting each edge/vertex to the provided RxJS subjects. */
     processGraphStream(graphStream, edgeSubject, vertexSubject, layer = GraphLayer$1.ATC) {
         const edgePipeline = chain$1([
             graphStream,
@@ -68096,8 +69472,8 @@ class GraphService {
 }
 
 /**
- * Service for OI services: dependency graph, top-level/all services, inventory,
- * create, delete, and helpers for service content and vertex payloads.
+ * Service for entity inventory: search, lookup, inventorize configuration
+ * management, and related metric retrieval across the OI topology.
  */
 class InventoryService {
     dxSaaSService;
@@ -68115,16 +69491,19 @@ class InventoryService {
         this.dxTASService = dxTASService;
         this.log = log;
     }
+    /** Lists all inventorize (topology creator) rule configurations. */
     async listInventorizeConfigurations() {
         return this.dxSaaSService
             .oiGet('oi/v2/topologycreator/rules/list')
             .then((response) => response.config);
     }
+    /** Creates (saves) a new inventorize rule configuration. */
     async createInventorizeConfiguration(inventorizeConfiguration) {
         return this.dxSaaSService.oiPost('oi/v2/topologycreator/rules/save', {
             config: [inventorizeConfiguration],
         });
     }
+    /** Previews the entities that would be created by an inventorize configuration. */
     async previewInventorizeConfiguration(inventorizeConfiguration) {
         const body = {
             config: [inventorizeConfiguration],
@@ -68132,14 +69511,17 @@ class InventoryService {
         console.log(JSON.stringify(body, null, 2));
         return this.dxSaaSService.oiPost('oi/v2/topologycreator/rules/preview', body);
     }
+    /** Deletes an existing inventorize rule configuration. */
     async deleteInventorizeConfiguration(inventorizeConfiguration) {
         return this.dxSaaSService.oiPost('oi/v2/topologycreator/rules/delete', {
             config: [inventorizeConfiguration],
         });
     }
+    /** Performs an inventory lookup using a structured lookup request. */
     async lookupInventory(lookupRequest) {
         return this.dxSaaSService.oiPost('oi/v2/api/maintenance/inventory/_search', lookupRequest);
     }
+    /** Returns the distinct list of `product` attribute values present in the topology. */
     async listInventorySources() {
         const productAttributeTASQuery = {
             filter: {
@@ -68158,13 +69540,16 @@ class InventoryService {
         const tasQueryResult = await this.dxTASService.executeQuery(productAttributeTASQuery);
         return tasQueryResult.analytics[0].values.map((value) => value.attribValue);
     }
+    /** Searches the OI v3 inventory using a structured search request body. */
     async searchInventory(inventorySearchRequestBody) {
         this.log.debug('searching inventory');
         return this.dxSaaSService.oiPost('oi/v3/api/inventory/_search', inventorySearchRequestBody);
     }
+    /** Returns available attribute names for a given inventory attribute request. */
     async getAttributes(attributeRequest) {
         return this.dxSaaSService.oiPost('oi/v3/queryTas/attributeNames', attributeRequest);
     }
+    /** Returns a map of externalId → registered metrics for the given entity IDs. */
     async getRelatedMetrics(externalIds) {
         const topoMetadataResults = (await this.dxNASSService.query({
             query: [
@@ -68236,9 +69621,11 @@ class JsExtensionService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Returns all JavaScript extensions registered for the tenant. */
     getJSExtensions() {
         return this.dxSaaSService.tenantGet('/apm/atc/api/private/em/extensions');
     }
+    /** Disables a JavaScript extension by name and file size. */
     disableJSExtension(name, size) {
         const base64name = Buffer.from(name).toString('base64');
         const disableBody = {
@@ -68251,6 +69638,7 @@ class JsExtensionService {
         this.log.debug(`disabling js extension ${name}`);
         return this.dxSaaSService.tenantPut(`/apm/atc/api/private/em/extensions/${base64name}`, disableBody);
     }
+    /** Enables a previously disabled JavaScript extension by name and file size. */
     enableJSExtension(name, size) {
         const base64name = Buffer.from(name).toString('base64');
         const enableBody = {
@@ -68262,12 +69650,14 @@ class JsExtensionService {
         };
         return this.dxSaaSService.tenantPut(`/apm/atc/api/private/em/extensions/${base64name}`, enableBody);
     }
+    /** Deletes a JavaScript extension by name. */
     deleteJSExtension(name) {
         const base64name = Buffer.from(name).toString('base64');
         return (this.dxSaaSService.tenantDelete(`/apm/atc/api/private/em/extensions/${base64name}`, {
                 extensionDisabled: false,
             }));
     }
+    /** Uploads and creates a new JavaScript extension from a local source file. */
     createJSExtension(scriptName, sourcefile) {
         const fsize = fs$1.statSync(sourcefile).size;
         const jsStream = fs$1.createReadStream(sourcefile);
@@ -68290,6 +69680,7 @@ class LogsService {
     constructor(dxSaasService) {
         this.dxSaasService = dxSaasService;
     }
+    /** Executes a log query against the OI log analytics filter API. */
     queryLogs(logQueryBody) {
         return this.dxSaasService.oiPost('oi/loganalytics/v1/api/logs/filter', logQueryBody);
     }
@@ -68305,6 +69696,7 @@ class ManagementModuleService {
     constructor(dxSaaSService) {
         this.dxSaaSService = dxSaaSService;
     }
+    /** Returns all management modules for the tenant (up to 500). */
     retrieveManagementModules() {
         return this.dxSaaSService.tenantPost('atc/private/internal/module/query', ManagementModuleService.createManagementModuleListRequestBody());
     }
@@ -68314,6 +69706,7 @@ class ManagementModuleService {
             offset: offset ?? 0,
         };
     }
+    /** Returns all calculators associated with a management module. */
     getManagementModuleCalculators(managementModuleId) {
         return this.dxSaaSService
             .tenantPost('atc/private/internal/calculator/query', {
@@ -68325,25 +69718,30 @@ class ManagementModuleService {
             return response.items || [];
         });
     }
+    /** Creates a new calculator (strips ID if present before sending). */
     createCalculator(calculator) {
         if (calculator.id) {
             delete calculator.id;
         }
         return this.dxSaaSService.tenantPost('atc/private/internal/calculator', calculator);
     }
+    /** Finds a management module by its exact ID; returns `undefined` if not found. */
     getManagementModuleById(id) {
         return this.retrieveManagementModules().then((managementModulesList) => {
             return managementModulesList.items.find((mgmtModule) => mgmtModule.id === id);
         });
     }
+    /** Imports an existing management module object (creates it on the target tenant). */
     importManagementModule(managementModule) {
         return this.dxSaaSService.tenantPost('atc/private/internal/module', managementModule);
     }
+    /** Deletes a management module by its ID. */
     deleteManagementModule(managementModuleId) {
         return this.dxSaaSService.tenantPost('atc/private/internal/module/delete', {
             itemId: managementModuleId,
         });
     }
+    /** Creates a new management module with the given name, description, active flag, and agent expressions. */
     createManagementModule(name, description, active, agentExpressions) {
         return this.dxSaaSService.tenantPost('atc/private/internal/module', ManagementModuleService.createManagementModuleCreateRequestBody(name, description, active, agentExpressions));
     }
@@ -68355,6 +69753,7 @@ class ManagementModuleService {
             agentExpressions: agentExpressions,
         };
     }
+    /** Copies an existing management module to a new one with an optional new name/description/active state. */
     copyManagementModule(targetManagementModuleId, newManagementModuleName, description, active) {
         return this.getManagementModuleById(targetManagementModuleId).then((mgmtModule) => {
             if (!mgmtModule) {
@@ -68363,6 +69762,7 @@ class ManagementModuleService {
             return this.createManagementModule(newManagementModuleName, description ? description : mgmtModule.description, active == null ? mgmtModule.active : active, mgmtModule.agentExpressions);
         });
     }
+    /** Updates fields on an existing management module; `null` values leave the field unchanged. */
     updateManagementModule(id, managementModuleName, description, active, agentExpressions) {
         return this.getManagementModuleById(id).then((mgmtModule) => {
             if (!mgmtModule) {
@@ -68371,6 +69771,7 @@ class ManagementModuleService {
             return this.dxSaaSService.tenantPost('/apm/atc/api/private/module', this.createManagementModuleUpdateRequestBody(mgmtModule, id, managementModuleName, description, active, agentExpressions));
         });
     }
+    /** Builds an update request body by applying changed fields to the existing module. */
     createManagementModuleUpdateRequestBody(originalMgmtModule, id, name, description, active, agentExpressions) {
         if (active !== null) {
             originalMgmtModule['active'] = active;
@@ -68406,12 +69807,15 @@ class MetricBatchService {
         this.log = log;
         MetricBatchService.staticLog = this.log;
     }
+    /** Retrieves a metric batch using a metric grouping and management module agent expressions. */
     retrieveMetricsBatch(metricGrouping, managementModule) {
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/metric/batch', MetricBatchService.createMetricBatchRequestRequestBody(metricGrouping, managementModule));
     }
+    /** Retrieves a metric batch using explicit time range and frequency parameters. */
     retrieveSimpleMetricsBatch(metricGrouping, endTime, range, frequency) {
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/metric/batch', MetricBatchService.createSimpleMetricBatchRequestRequestBody(metricGrouping, endTime, range, frequency));
     }
+    /** Returns the metric attributes for a full metric path (must start with `SuperDomain` and include `:metricName`). */
     getMetricAttributesForFullMetricPath(fullMetricPath, metricUniverse) {
         if (fullMetricPath.indexOf(':') < 0 ||
             !fullMetricPath.startsWith('SuperDomain')) {
@@ -68439,16 +69843,20 @@ class MetricBatchService {
             }
         });
     }
+    /** Executes a vertex metric query for a given time range. */
     async executeVertexMetricQuery(metricQueryReq, startTime, endTime) {
         // metricQueryReq.queryRange = InputTimeParsing.getVertexMetricQueryTimeParameters(startTime.toMillis(), endTime.toMillis());
         return this.dxSaaSService.tenantPost('/atc/private/internal/metrics/queryMetric', metricQueryReq, { ignoreUniverse: true });
     }
+    /** @deprecated No-op placeholder; returns `this`. */
     getMetricIdForPathNew() {
         return this;
     }
+    /** Returns the metric tree for a given metric resource path and universe. */
     getMetricIdForPath(metricResourcePath, universeId) {
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/metrictree/query', MetricBatchService.createMetricTreeRequestBody(metricResourcePath, universeId));
     }
+    /** Returns metric attributes and their values for a metric tree ID over a time window. */
     getMetricAttributesAndValues(metricTreeId, endTime, frequency, rangeSize) {
         return this.dxSaaSService
             .tenantPost('/metrics/queryMetric', MetricBatchService.getMetricAttributeQueryBody(metricTreeId, endTime, frequency, rangeSize))
@@ -68462,6 +69870,7 @@ class MetricBatchService {
             }
         });
     }
+    /** Returns only the metric attribute keys (no values) for a metric tree ID. */
     getMetricAttributes(metricTreeId) {
         return this.dxSaaSService
             .tenantPost('/metrics/queryMetric', MetricBatchService.getMetricAttributeQueryBody(metricTreeId))
@@ -68619,9 +70028,11 @@ class MetricGroupingService {
         this.log = log;
         MetricGroupingService.staticLog = this.log;
     }
+    /** Creates a new metric grouping using the v2 internal API. */
     async createMetricGroupingV2(metricGrouping) {
         return await this.dxSaaSService.tenantPost('atc/private/internal/grouping', metricGrouping);
     }
+    /** Creates a new metric grouping using the legacy API, resolving the management module first. */
     async createMetricGrouping(managementModuleId, metricGroupingName, metricGroupingExpressions, description, useManagementModuleAgentExpression, active, editable) {
         const managementModule = await this.managementModuleService.getManagementModuleById(managementModuleId);
         if (!managementModule) {
@@ -68637,6 +70048,7 @@ class MetricGroupingService {
             editable: editable,
         });
     }
+    /** Returns a single metric grouping by full ID (resolves management module from ID prefix). */
     retrieveMetricGrouping(metricGroupingId) {
         const mgParts = metricGroupingId.split(':');
         const mgmtModuleId = mgParts[0] + ':' + mgParts[1];
@@ -68653,12 +70065,14 @@ class MetricGroupingService {
             }
         });
     }
+    /** Returns a single metric grouping (v2) by ID with usage info. */
     async getMetricGroupingV2(metricGroupingId, managementModuleId) {
         return this.dxSaaSService.tenantPost('atc/private/internal/grouping/get', {
             mmId: managementModuleId,
             itemId: metricGroupingId,
         }, { includeUsage: true });
     }
+    /** Returns all metric groupings (v2) for a management module with usage info. */
     async retrieveMetricGroupingsV2(managementModuleId) {
         const managementModule = await this.managementModuleService.getManagementModuleById(managementModuleId);
         if (!managementModule) {
@@ -68671,6 +70085,7 @@ class MetricGroupingService {
             includeUsage: true,
         });
     }
+    /** Returns all metric groupings for a management module using the legacy API. */
     retrieveMetricGroupings(managementModuleId, offset) {
         return this.managementModuleService
             .getManagementModuleById(managementModuleId)
@@ -68714,6 +70129,7 @@ class NASSService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Registers one or more metrics in the NASS metadata store. */
     async registerMetrics(metricRegistrations) {
         const metricRegistrationBody = {
             metrics: metricRegistrations,
@@ -68734,6 +70150,7 @@ class NASSService {
             };
         }
     }
+    /** Returns metric metadata for a list of metric IDs. */
     async queryMetadataByIDs(ids) {
         const metadataQuery = {
             specifier: {
@@ -68743,6 +70160,7 @@ class NASSService {
         };
         return this.dxSaaSService.tenantPost('/metadata/queryMetric', metadataQuery);
     }
+    /** Queries metric time-series data for a source/attribute specifier over a time range. */
     async queryMetricData(sourceName, sourceOpType, attributeName, attributeOpType, endTimeEpochSeconds, rangeInSeconds, frequency, clampSize = 500) {
         const metricDataQuery = {
             querySpecifier: {
@@ -68760,6 +70178,7 @@ class NASSService {
         this.log.debug(JSON.stringify(metricDataQuery, null, 2));
         return this.dxSaaSService.tenantPost('/metrics/queryMetric', metricDataQuery);
     }
+    /** Queries metric metadata by source and attribute name specifiers. */
     async queryMetadata(sourceName, sourceOpType, attributeName, attributeOpType) {
         const metadataQuery = {
             specifier: {
@@ -68770,6 +70189,7 @@ class NASSService {
         };
         return this.dxSaaSService.tenantPost('/metadata/queryMetric', metadataQuery);
     }
+    /** Registers a single metric with the given source/attribute name, type, and custom attributes. */
     async registerMetric(sourceName, attributeName, metricType, attributes) {
         const metricRegistrationBody = {
             metrics: [
@@ -68783,6 +70203,7 @@ class NASSService {
         };
         return this.dxSaaSService.tenantPost('/metadata/registerMetric', metricRegistrationBody);
     }
+    /** Stores one or more metric values in the NASS metric value store. */
     async storeMetricValue(metricValues) {
         const metricStoreBody = { values: new Array() };
         metricValues.forEach((metricValue) => metricStoreBody.values.push([
@@ -68796,6 +70217,7 @@ class NASSService {
         ]));
         return this.dxSaaSService.tenantPost('/nass/metricValue/store', metricStoreBody);
     }
+    /** Executes a raw NASS pipeline query (e.g. FROM_TOPOLOGY + JOIN_METADATA). */
     async query(nassQuery) {
         return this.dxSaaSService.tenantPost('/atc/private/internal/metrics/nassQuery', nassQuery);
     }
@@ -68810,6 +70232,7 @@ class NotificationService {
     constructor(dxSaaSService) {
         this.dxSaaSService = dxSaaSService;
     }
+    /** Returns all configured event notification services for the tenant. */
     retrieveNotificationServices() {
         return this.dxSaaSService.tenantGet('/apm/atc/api/private/eventnotification', {}, {});
     }
@@ -68824,6 +70247,7 @@ class O2NotificationService {
     constructor(dxSaaSService) {
         this.dxSaaSService = dxSaaSService;
     }
+    /** Fetches all configured notification channels from the O2 notify API. */
     retrieveNotificationChannels() {
         return this.dxSaaSService.axaRequest('GET', 'notify/notify/v1/channels', true, false, {}, {});
     }
@@ -68847,6 +70271,7 @@ class O2UniverseService {
         this.dxTASService = dxTASService;
         this.simpleLog = simpleLog;
     }
+    /** Returns all O2 universes (views owned by OI), including inactive ones. */
     retrieveAllUniverses() {
         return this.dxSaaSService
             .tenantPost('views/queryView', {
@@ -68861,6 +70286,7 @@ class O2UniverseService {
             return universeList.views;
         });
     }
+    /** Returns a map of service name → universe labels it belongs to. */
     async getServiceNameToUniverseLabelMap() {
         const serviceUniverseNameMap = new SetMap();
         const universeNameServiceMap = await this.getUniverseLabelToServiceNameMap();
@@ -68871,6 +70297,7 @@ class O2UniverseService {
         });
         return serviceUniverseNameMap;
     }
+    /** Returns a map of universe label → set of service names via TAS queries on each universe's TAS views. */
     async getUniverseLabelToServiceNameMap() {
         const universeServiceNameMap = new SetMap();
         const allUniverses = await this.retrieveAllUniverses();
@@ -68911,6 +70338,7 @@ class O2UniverseService {
         });
         return universeServiceNameMap;
     }
+    /** Returns a single O2 universe by its view ID; throws if not exactly one result. */
     retrieveUniverseByViewId(viewId) {
         return this.dxSaaSService
             .tenantPost('views/queryView', {
@@ -68924,9 +70352,11 @@ class O2UniverseService {
             return universeList.views[0];
         });
     }
+    /** Creates a new O2 universe from the given request body. */
     createUniverse(universe) {
         return this.dxSaaSService.tenantPost('/views/view', universe);
     }
+    /** Builds a group access permission object for use in universe creation. */
     createGroupAccessBody(groupName, canManage) {
         return {
             name: groupName,
@@ -68936,6 +70366,7 @@ class O2UniverseService {
             attributeInclude: [],
         };
     }
+    /** Builds a user access permission object for use in universe creation. */
     createUserAccessBody(userName, canManage) {
         return {
             name: userName,
@@ -68945,6 +70376,7 @@ class O2UniverseService {
             attributeInclude: [],
         };
     }
+    /** Generates a full create-universe request body with TAS and NASS filters for the given services. */
     generateCreateUniverseRequestBody(name, description, serviceNames) {
         const tasAllFilter = {
             op: 'ALL',
@@ -69002,19 +70434,122 @@ class PerspectiveService {
         this.log = log;
         this.log = log ?? new NullSimpleLog$1();
     }
+    /** Returns all perspectives (groupings) for the tenant. */
     getPerspectives() {
         this.log.debug('getting perspectives');
         return this.dxSaaSService.tenantGet('/apm/atc/api/private/grouping');
     }
+    /** Creates a new perspective (grouping). */
     createPerspective(perspective) {
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/grouping', perspective);
     }
+    /** Deletes a perspective by its ID. */
     async deletePerspective(id) {
         const result = await this.dxSaaSService.tenantDelete(`/apm/atc/api/private/grouping/${id}`);
         this.log.debug('deletion result', result);
     }
 }
 
+/**
+ * Service for platform (o2/v2) alert specs: search, save, and retrieve
+ * available message template fields.
+ *
+ * These operate against the `/oi/v2/alert/spec/` endpoints and are distinct
+ * from the legacy ATC alert API. The UI refers to these as "alarms" but they
+ * are modeled here as "alerts" for consistency; `alarmType` is preserved as-is
+ * since it refers to the type of alarm generated when a threshold is crossed.
+ */
+class PlatformAlertService {
+    dxSaaSService;
+    constructor(dxSaaSService) {
+        this.dxSaaSService = dxSaaSService;
+    }
+    /** Searches for alert specs, optionally filtered by management module ID. */
+    async search(mmId) {
+        const body = mmId ? { mmId } : {};
+        return this.dxSaaSService.tenantPost('oi/v2/alert/spec/search', body);
+    }
+    /** Creates or updates a platform alert spec. */
+    async save(request) {
+        return this.dxSaaSService.tenantPost('oi/v2/alert/spec/save', request);
+    }
+    /** Deletes an alert spec by its specId (component, id, managementModuleId). */
+    async delete(specId) {
+        return this.dxSaaSService.tenantPost('oi/v2/alert/spec/delete', specId);
+    }
+    /** Returns the set of available message template field names (e.g. alertName, severity, hostname). */
+    async getMessageFields() {
+        return this.dxSaaSService.tenantGet('oi/v2/alert/spec/message/fields');
+    }
+}
+
+/**
+ * Service for platform (o2/v2) management modules: query, export, save, and delete.
+ *
+ * These operate against the `/oi/v2/managementmodule/` endpoints and are distinct
+ * from the legacy ATC management module API.
+ */
+class PlatformManagementModuleService {
+    dxSaaSService;
+    constructor(dxSaaSService) {
+        this.dxSaaSService = dxSaaSService;
+    }
+    /** Lists all platform management modules. */
+    async query() {
+        return this.dxSaaSService.tenantPost('oi/v2/managementmodule/query', {});
+    }
+    /** Exports a single management module with its full detail (metricGroups, metricSpecs). */
+    async exportModule(name) {
+        return this.dxSaaSService.tenantPost('oi/v2/managementmodule/export', { id: { name } });
+    }
+    /** Creates or updates a platform management module. */
+    async save(request) {
+        return this.dxSaaSService.tenantPost('oi/v2/managementmodule/save', request);
+    }
+    /** Deletes a platform management module and its associated entities. */
+    async delete(name) {
+        return this.dxSaaSService.tenantPost('oi/v2/managementmodule/delete', { name });
+    }
+}
+
+/**
+ * Service for platform (o2/v2) metric groupings: search, save, preview metrics,
+ * and retrieve available metric filter fields.
+ *
+ * These operate against the `/oi/v2/alert/metricgroup/` and `/oi/v2/alert/metric/`
+ * endpoints and are distinct from the legacy ATC metric grouping API.
+ */
+class PlatformMetricGroupingService {
+    dxSaaSService;
+    constructor(dxSaaSService) {
+        this.dxSaaSService = dxSaaSService;
+    }
+    /** Searches for metric groupings, optionally filtered by management module ID. */
+    async search(mmId) {
+        const body = mmId ? { mmId } : {};
+        return this.dxSaaSService.tenantPost('oi/v2/alert/metricgroup/search', body);
+    }
+    /** Creates or updates a platform metric grouping. */
+    async save(request) {
+        return this.dxSaaSService.tenantPost('oi/v2/alert/metricgroup/save', request);
+    }
+    /** Retrieves live metrics matching a metric grouping and/or custom filter. */
+    async getMetrics(request) {
+        return this.dxSaaSService.tenantPost('oi/v2/alert/metricgroup/metrics', request);
+    }
+    /** Deletes a metric grouping by ID (and optionally management module ID). */
+    async delete(id, managementModuleId) {
+        const body = managementModuleId
+            ? { id, managementModuleId: { name: managementModuleId } }
+            : { id };
+        return this.dxSaaSService.tenantPost('oi/v2/alert/metricgroup/delete', body);
+    }
+    /** Returns the set of available metric filter fields (source, metric, metadata). */
+    async getMetricFields() {
+        return this.dxSaaSService.tenantPost('oi/v2/alert/metric/fields', {});
+    }
+}
+
 var FilterOperation;
 (function (FilterOperation) {
     FilterOperation["EQUALS"] = "eq";
@@ -69159,6 +70694,7 @@ class VertexService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Returns attribute value groups for a given attribute name in a universe, optionally filtered by layer. */
     async getAttributeValues(universeId, attributeName, layer) {
         const fq = {
             filter: {
@@ -69191,6 +70727,7 @@ class VertexService {
             return attributeValuesResponse.items;
         });
     }
+    /** Returns all intellisense attributes (including gathered) from the ATC API. */
     async listAllAttributes() {
         return this.dxSaaSService
             .tenantGet('/apm/atc/api/private/intellisense/attribute', { includeGathered: true })
@@ -69198,6 +70735,7 @@ class VertexService {
             return attributeResponseBody.items;
         });
     }
+    /** Returns the state (attributes) of a vertex by its ID. */
     retrieveVertexState(vertexId) {
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/attributes/retrieve', { vertexIds: [vertexId] });
     }
@@ -69208,9 +70746,11 @@ class VertexService {
     //   throw new Error("Unimplemented.")
     // }
     // public retrieveUniverseStatusChanges(universeId: string, startTime: number, endTime: number ) {}
+    /** Returns a vertex by its ID from the ATC vertex REST endpoint. */
     retrieveVertex(vertexId) {
         return this.dxSaaSService.tenantGet('/apm/atc/api/vertex/' + vertexId);
     }
+    /** Returns a flat key→value map of attributes for the single agent vertex matching `fullAgentName`. */
     async retrieveFlattenedAgentVertexAttributes(fullAgentName) {
         return this.retrieveAgentVertex(fullAgentName).then((vertexResponse) => {
             if (vertexResponse._embedded.vertex.length == 1) {
@@ -69224,6 +70764,7 @@ class VertexService {
             }
         });
     }
+    /** Returns all vertices that have an `agent` attribute matching `fullAgentName`. */
     async retrieveAllVerticesForAgent(fullAgentName) {
         return this.dxSaaSService
             .tenantPost('/apm/atc/api/graph/vertex', VertexService.getAllVerticesForHostnameRequestBody(fullAgentName))
@@ -69231,6 +70772,7 @@ class VertexService {
             return response._embedded.vertex;
         });
     }
+    /** Returns the AGENT-type vertex for the given fully-qualified agent name. */
     retrieveAgentVertex(fullAgentName) {
         return this.dxSaaSService.tenantPost('/apm/atc/api/graph/vertex', VertexService.getAgentVertexRequestBody(fullAgentName));
     }
@@ -69245,6 +70787,7 @@ class VertexService {
         });
         return r;
     }
+    /** Patches a vertex's attributes; pass `null` values to delete an attribute. */
     patchVertex(vertexId, attributes) {
         const patchAttributes = {};
         Object.entries(attributes).forEach(([key, value]) => {
@@ -69257,21 +70800,26 @@ class VertexService {
         });
         return this.dxSaaSService.tenantPatch('/apm/atc/api/graph/vertex/' + vertexId, { attributes: patchAttributes });
     }
+    /** Returns vertices matching a set of AND attribute filter items. */
     getVertices(andItems) {
         return this.dxSaaSService.tenantPost('/apm/atc/api/graph/vertex', VertexService.getBulkVertexRequestBody(andItems));
     }
     vertexMappingConfigurationCached = null;
+    /** Saves a vertex definition extension configuration. */
     async setVertexDefinition(vertexDefinition) {
         return this.dxSaaSService.tenantPost('/apm/appmap/ats/extension/configure', vertexDefinition);
     }
+    /** Returns all vertex type definitions for the tenant. */
     async getVertexDefinitions() {
         return this.dxSaaSService.tenantGet('/atc/vertexdefinition');
     }
+    /** Returns vertex definitions filtered to a specific vertex type. */
     async getVertexDefinition(vertexType) {
         return this.dxSaaSService.tenantGet('/atc/vertexdefinition', {
             vertexType: vertexType,
         });
     }
+    /** Returns the vertex metric mapping configuration (parsed from static config), optionally cached. */
     async getVertexMappingConfiguration(useCache = true, allowOverride = true) {
         if (useCache && this.vertexMappingConfigurationCached != null) {
             return this.vertexMappingConfigurationCached;
@@ -69372,6 +70920,7 @@ class VertexService {
             ],
         };
     }
+    /** Returns trace summaries for a set of vertex IDs within a time window. */
     async getTraceSummaries(startTime, endTime, vertexIds, index, limit, errorsOnly) {
         const traceSummaryRequestBody = {
             endTime: endTime.toISO(),
@@ -69383,6 +70932,7 @@ class VertexService {
         };
         return this.dxSaaSService.tenantPost('/apm/atc/api/private/trace/summary', traceSummaryRequestBody);
     }
+    /** Builds metric query request bodies for a vertex ID using its mapped performance specifiers. */
     async getVertexMappedMetricQueryRequestBody(vertexId) {
         const vertexMapping = await this.getVertexMappingConfiguration();
         vertexMapping.vertexMetricMap.forEach((specArray, key) => {
@@ -69458,6 +71008,7 @@ class VertexService {
         });
         return metricQueryBodyArray;
     }
+    /** Returns true if the vertex matches all filter conditions in the specifier. */
     matchesFilter(spec, vertex) {
         if (!spec.filter) {
             return true;
@@ -69475,6 +71026,7 @@ class VertexService {
             return filterMatches.every((match) => match);
         }
     }
+    /** Replaces `<attributeName>` placeholders in a specifier format string with vertex attribute values. */
     materializeSpecifier(specifier, vertex, escapeAttributeValue = false) {
         this.getAllReplacementAttributes(specifier).forEach((attribute) => {
             const vaValue = getVertexAttributeValue(vertex, attribute);
@@ -69484,6 +71036,7 @@ class VertexService {
         });
         return specifier;
     }
+    /** Extracts all `<attributeName>` placeholder names from a specifier format string. */
     getAllReplacementAttributes(specifierFormat) {
         const replacementAttributes = new Array();
         let index = 0;
@@ -69500,12 +71053,14 @@ class VertexService {
         this.log.debug(`found replacement attributes: ${replacementAttributes} in ${specifierFormat}`);
         return replacementAttributes;
     }
+    /** Returns true if the vertex has all attributes required by the specifier's format strings. */
     hasAllAttributes(specifier, vertex) {
         const hasASReplacementAttributes = this.getAllReplacementAttributes(specifier.agentSpecifier.format).every((attribute) => hasVertexAttribute(vertex, attribute));
         const hasMSReplacementAttributes = this.getAllReplacementAttributes(specifier.metricSpecifier.format).every((attribute) => hasVertexAttribute(vertex, attribute));
         this.log.debug(`has replacements: ${hasASReplacementAttributes}/${hasMSReplacementAttributes}`);
         return hasASReplacementAttributes && hasMSReplacementAttributes;
     }
+    /** Returns an empty metric query body skeleton with default range/frequency values. */
     getEmptyMetricQueryBody() {
         return {
             querySpecifier: {
@@ -69523,6 +71078,7 @@ class VertexService {
             authorizationView: null,
         };
     }
+    /** Returns the directory path where vertex mapping override JSON files are stored. */
     getVertexMappingOverrideLocation() {
         let overrideLocation = null;
         if (process.env.DXDO_VERTEX_MAPPING_OVERRIDE_LOCATION) {
@@ -69564,14 +71120,17 @@ class VertexService {
             return overrideLocation;
         }
     }
+    /** Returns true if an override file exists for the given vertex type and mapping type. */
     vertexMappingOverrideFileExists(type, mappingType) {
         return fs$1.existsSync(this.getVertexMappingLocation(type, mappingType));
     }
+    /** Parses and returns the contents of a vertex mapping override JSON file. */
     getVertexMappingOverrideContents(type, mappingType) {
         return JSON.parse(fs$1
             .readFileSync(this.getVertexMappingLocation(type, mappingType))
             .toString());
     }
+    /** Returns the `.original` backup path for a vertex mapping override; throws if it already exists. */
     getTemporaryVertexMappingOverrideLocation(type, mappingType) {
         const tempPath = path$1.join(this.getVertexMappingOverrideLocation(), `${type}.${mappingType}.json.original`);
         if (fs$1.existsSync(tempPath)) {
@@ -69580,6 +71139,7 @@ class VertexService {
         else
             return tempPath;
     }
+    /** Returns the file path for a vertex mapping override JSON file. */
     getVertexMappingLocation(type, mappingType) {
         return path$1.join(this.getVertexMappingOverrideLocation(), `${type}.${mappingType}.json`);
     }
@@ -69594,6 +71154,7 @@ class SQLService {
     constructor(dxSaaSService) {
         this.dxSaaSService = dxSaaSService;
     }
+    /** Executes a SQL-style APM data query and returns the response body. */
     executeQuery(query) {
         return this.dxSaaSService
             .tenantPost('/apm/atc/api/apmData/query', { query: query })
@@ -69617,6 +71178,7 @@ class SessionService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Placeholder session verification; currently logs a warning and resolves immediately. */
     test() {
         this.log.warn(`Not able to verify session for ${this.dxSaaSService.getTenantCN()}`);
         return Promise.resolve();
@@ -69637,10 +71199,12 @@ class TASService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Stores a graph (vertices and edges) in the TAS topology store. */
     async storeGraph(graphBody) {
         this.log.debug('storing');
         return this.dxSaaSService.tenantPost('/tas/graph/store', graphBody);
     }
+    /** Executes a TAS graph query and returns the result body. */
     async executeQuery(query) {
         return this.dxSaaSService.tenantPost('/tas/graph/query', query);
     }
@@ -69662,9 +71226,11 @@ class ServiceService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Returns the TAS topology dependency graph for a named service. */
     async getServiceDependencyGraph(serviceName) {
         return this.dxSaaSService.oiPost('oi/v2/sa/saTopologyGraph', { serviceName: serviceName, startTime: Date.now(), endTime: Date.now() });
     }
+    /** Returns metric time-series for each metric ID associated with a service. */
     async getServiceDetailMetrics(serviceName, startTime, endTime, ianaTimeZone = 'Europe/London') {
         const serviceOverview = await this.getServiceOverview(serviceName);
         const serviceDetailRequest = {
@@ -69684,11 +71250,13 @@ class ServiceService {
             };
         });
     }
+    /** Searches services using a structured search request body. */
     async searchServices(searchRequest) {
         return this.dxSaaSService.oiPost('oi/v2/api/maintenance/inventory/_search', searchRequest, {
             services: true,
         });
     }
+    /** Returns SLI metrics for a specific service within a time range. */
     async getServiceSLIs(serviceId, serviceName, startTime, endTime) {
         const requestBody = {
             serviceId,
@@ -69699,6 +71267,7 @@ class ServiceService {
         };
         return this.dxSaaSService.oiPost('oi/v2/servicerepo/slis', requestBody);
     }
+    /** Returns the full service detail (metrics with values) for a named service. */
     async getServiceDetail(serviceName, startTime, endTime, ianaTimeZone = 'Europe/London') {
         const serviceOverview = await this.getServiceOverview(serviceName);
         const serviceDetailRequest = {
@@ -69711,6 +71280,7 @@ class ServiceService {
         };
         return this.dxSaaSService.oiPost('oi/v2/sa/serviceDetails', serviceDetailRequest);
     }
+    /** Returns the overview vertex for a named service; throws if not found. */
     async getServiceOverview(serviceName) {
         return this.dxSaaSService
             .oiGet(`oi/v2/sa/services/${serviceName}`, {
@@ -69724,6 +71294,7 @@ class ServiceService {
                 throw new Error(`No Service with name '${serviceName}' Found`);
         });
     }
+    /** Returns paginated top-level (grouped) services up to `maxRequests` pages. */
     async getTopLevelServices(pageSize = 100, maxRequests = 20) {
         const returnServices = new Array();
         let totalRequests = 0;
@@ -69748,6 +71319,7 @@ class ServiceService {
             return returnServices;
         });
     }
+    /** Returns all services (ungrouped) paginating up to `maxRequests` pages. */
     async getAllServices(pageSize = 100, maxRequests = 10) {
         const returnServices = new Array();
         let totalRequests = 0;
@@ -69772,6 +71344,7 @@ class ServiceService {
             return returnServices;
         });
     }
+    /** Builds a services request body scoped to parent (top-level) services. */
     createParentServiceRequestBody(pageSize) {
         return {
             ...OIService.PARENT_SERVICE_REQUEST_BODY,
@@ -69779,6 +71352,7 @@ class ServiceService {
             pageSize: pageSize,
         };
     }
+    /** Builds a services request body that includes all services (no grouping). */
     createAllServiceRequestBody(pageSize) {
         return {
             ...OIService.PARENT_SERVICE_REQUEST_BODY,
@@ -69787,6 +71361,7 @@ class ServiceService {
             groupServices: false,
         };
     }
+    /** Returns inventory records for entities belonging to the named service. */
     async getServiceInventory(serviceName) {
         const initialRequestBody = this.createServiceInventoryRequestBody(serviceName);
         return this.dxSaaSService
@@ -69807,14 +71382,17 @@ class ServiceService {
         sirb.customFilter.and.expressions[0].or.expressions[0].value = serviceName;
         return sirb;
     }
+    /** Creates a new service from the given body; replaces any existing service with the same name. */
     async createService(createServiceBody) {
         return this.dxSaaSService.tenantPost('/oi/v2/sa/save', createServiceBody, {
             replace: true,
         });
     }
+    /** Deletes a service by name; optionally deletes child services recursively. */
     async deleteService(serviceName, recursive = false) {
         return this.dxSaaSService.tenantPost('/oi/v2/sa/service/status', { name: serviceName, action: 'delete' }, { recursive });
     }
+    /** Builds a `ServiceContent` query fragment for a single attribute filter. */
     generateServiceContent(attributeName, attributeValue, operator = 'IN', followTransactions = false) {
         return {
             query: [
@@ -69829,6 +71407,7 @@ class ServiceService {
             },
         };
     }
+    /** Builds an empty (no-content) service vertex payload ready to be populated. */
     generateEmptyServiceVertex(serviceName, serviceDescription, situationsIncludeChildServices, tags = [], customProperties = []) {
         return {
             attributes: {
@@ -69849,6 +71428,7 @@ class ServiceService {
             externalId: `SERVICE:${serviceName}`,
         };
     }
+    /** Returns an empty `CreateSimpleServiceBody` with no vertices or edges. */
     generateCreateServiceBody() {
         return {
             edges: [],
@@ -69872,6 +71452,7 @@ class SituationService {
         this.dxSaaSService = dxSaaSService;
         this.log = log;
     }
+    /** Sends a notification for a situation to the specified channel with optional template/locale. */
     async triggerNotification(alarmId, notificationChannelName, template = '', locale = 'en-US') {
         const situationDetail = JSON.parse((await this.getSituationOverview(alarmId)).alarmData);
         situationDetail.alarmType = 'situation';
@@ -69886,6 +71467,7 @@ class SituationService {
         };
         return this.dxSaaSService.oiPost('oi/v2/api/alarmactions/channel', body);
     }
+    /** Searches cluster alarms (situations) within a time range using a filter operation. */
     async getSituations(searchOperation, startTime, endTime, includeClosed = false, pageSize = 50) {
         return this.dxSaaSService.oiPost('oi/v2/api/clusteralarms/_search', this.getSituationRequestBody(searchOperation, startTime, endTime, includeClosed, pageSize));
     }
@@ -69911,9 +71493,11 @@ class SituationService {
             customFilter: searchOperation,
         };
     }
+    /** Returns the overview record for a situation by its alarm ID. */
     async getSituationOverview(situationId) {
         return this.dxSaaSService.oiGet(`oi/v2/api/groupalarms/_search/${situationId}/overview`, { type: 'cluster' });
     }
+    /** Returns lifecycle (state change) events for a situation. */
     async getSituationLifecycleEvents(situationId) {
         return this.dxSaaSService.oiPost('oi/v2/api/alarms/lifecycle/_search', {
             alarmId: situationId,
@@ -69923,6 +71507,7 @@ class SituationService {
             lifeCycleType: 'SITUATION',
         });
     }
+    /** Returns the inspector inspection result for a situation (related alarms, topology). */
     async getSituationInspection(situationId) {
         return this.dxSaaSService.oiPost('oi/v2/api/inspect/situation', {
             backwardHopCount: 1,
@@ -69931,6 +71516,7 @@ class SituationService {
             tenantId: this.dxSaaSService.dxdoConfiguration.dxConfiguration.cohortId,
         });
     }
+    /** Returns all alarms belonging to a situation in a time window. */
     async getSituationAlarms(situationId, startTime, endTime, pageSize = 50) {
         this.log.debug(`getting situations with pagesize ${pageSize}`);
         return this.dxSaaSService.oiPost('oi/v2/api/clusteralarms/_search', {
@@ -69955,6 +71541,7 @@ class SituationService {
             clusterAlarmId: situationId,
         });
     }
+    /** Generates a GenAI inspector summary for a situation in the given timezone. */
     async getSituationSummary(situationId, timezoneTimeZoneIANA) {
         const situationInspection = await this.getSituationInspection(situationId);
         const relatedAlarms = Object.values(situationInspection.relatedAlarmsDetails.relatedAlarms).map((relatedAlarm) => {
@@ -70032,6 +71619,9 @@ function createServiceMonolith(dxDoConfiguration, log = new NullSimpleLog()) {
         dxO2UniverseService: new O2UniverseService(dxSaaSService, dxTASService, log),
         dxOIService: new DxoiService(dxSaaSService),
         dxPerspectiveService: new PerspectiveService(dxSaaSService),
+        dxPlatformAlertService: new PlatformAlertService(dxSaaSService),
+        dxPlatformManagementModuleService: new PlatformManagementModuleService(dxSaaSService),
+        dxPlatformMetricGroupingService: new PlatformMetricGroupingService(dxSaaSService),
         dxSaaSService,
         dxServiceService: new ServiceService(dxSaaSService, log),
         dxSessionService: new SessionService(dxSaaSService),
@@ -70042,5 +71632,133 @@ function createServiceMonolith(dxDoConfiguration, log = new NullSimpleLog()) {
     };
 }
 
-export { AXAActivities, AccService, AgentService, AgentTrace, AlarmEnrichment, AlarmEnrichmentFilter, AlarmService, AlertDefinitionResponse, AlertResponse, AlertResponseV2, AlertService, ApmUniverseService, AsmService, AttributeFilterOperator, AttributeService, AuthorizationService, AxaService, BlobService, ChannelService, DEFAULT_EXPERIENCE_REQUEST_BODY, DXChannel, DashboardPermissionsUpdateRequest, DashboardSearch, DashboardService, DxSaasService, DxoiService, EventService, ExperienceService, FilterOperation, GraphResponse, GraphService, Inventory, InventoryAttributes, InventoryService, JsExtensionService, LogQuery, LogsService, MServe, ManagementModuleService, MatchType, MetricBatchService, MetricGroupingService, NASS, NASSService, NotificationService, O2NotificationService, O2UniverseService, OIAlarm, OIService, PerspectiveService, PlatformFilters, SQLService, ServiceService, SessionService, SimpleHTTPError, SituationLifecycle, SituationService, Situations, TAS, TASGraph, TASService, Trace, VertexMappingConfigurationModule, VertexService, VertexStatusChanges, ags, agsresponse, apiTokenCreate, apiTokenDelete, apiTokenGet, apiTokenList, apiTokenUpdate, checkGet, contactActivate, contactDelete, contactTestSend, contactsBlockDelete, contactsBlockPut, contactsConfirm, contactsCreate, contactsGet, contactsGetDetail, contactsReplaceNotificationsWith, contactsRequestConfirmationCode, contactsUpdate, convertLegacyConfiguration, createPostmanRequest, createServiceMonolith, escapeRegExp, example, excludedAttributes, folderAccessGet, folderDelete, folderGet, folderPost, folderUpdate, foldersList, getUserTokenSub, getUserTokenTid, getVertexAttributeValue, getVertexAttributeValueOrNull, hasVertexAttribute, inventorizePreview, inventorizeResponse, inventorySearchRequestBodyExample, inventorySearchResponseBody, isTenantToken, isUserToken, locationsCreate, locationsDelete, locationsGet, locationsGetAll, locationsGetByType, locationsLeafGetFilter, locationsPost, logGet, logGetEvent, maintenanceDelete, maintenanceDeleteWindows, maintenanceGet, maintenanceGetDetail, maintenanceGetWindows, maintenanceGetWindowsDetail, maintenanceUpdateWindowsDetail, maintenancesCreate, maintenancesImmediateDelete, maintenancesImmediatePut, maintenancesPostWindows, maintenancesUpdate, messageGet, messagesList, monitorActivate, monitorCreate, monitorDeactivate, monitorDelete, monitorGet, monitorGetAll, monitorUpdate, oauthClientTokensCreate, oauthClientTokensDelete, oauthClientTokensGet, oauthClientTokensList, oauthClientTokensUpdate, oauthCreateToken, oauthGetRefreshTokenList, oauthGetTokenList, oauthRefreshTokenDeleteId, oauthTokenCognateDelete, oauthTokenCognateDeleteCurrent, oauthTokenDelete, oauthTokenDeleteCurrent, parseFilter, sampleServiceDetailRequestBody, searchUniverse, serviceDetailResponseBody, settingsGet, settingsGetDetail, settingsUpdate, stationDelete, stationsAgentType, stationsCreate, stationsDeleteMaintenance, stationsGet, stationsGetAgents, stationsLatest, stationsList, stationsOnpremiseConnected, stationsOnpremiseConnectedAll, stationsOnpremiseList, stationsPutMaintenance, stationsUpdate, statistic, tagsGetAll, timezonesList, userBlockDelete, userBlockPut, userDelete, userGet, userLockDelete, userPut, userSubaccountsGet, userSubaccountsPost, verifyAndDumpLegacyConfiguration, verifyAndDumpVersion3Configuration, verifyAndDumpVersion4Configuration, vertexMatchesFilters };
+/**
+ * Service for issuing metric metadata queries against the DX SaaS DataStore
+ * API (`/metadata/queryMetric`).
+ *
+ * Requests are validated against {@link MetadataMetricQuerySchema}; responses
+ * are validated against {@link MetadataMetricQueryResponseV2Schema}.
+ * Validation failures on the response side are logged as warnings, not thrown.
+ */
+class DataStoreMetricsMetadataService {
+    dxSaasService;
+    log;
+    constructor(dxSaasService, log) {
+        this.dxSaasService = dxSaasService;
+        this.log = log;
+    }
+    /**
+     * POSTs a metadata query to `/metadata/queryMetric` and returns the matching
+     * metric / folder records.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    async queryMetric(query) {
+        MetadataMetricQuerySchema.parse(query);
+        const raw = await this.dxSaasService.tenantPost('metadata/queryMetric', query);
+        const result = MetadataMetricQueryResponseV2Schema.safeParse(raw);
+        if (!result.success) {
+            this.log.warn('MetadataMetricQueryResponseV2 validation warning:', result.error.message);
+        }
+        return raw;
+    }
+}
+
+/**
+ * Service for issuing NASSQL queries against the DX SaaS DataStore API
+ * (`/metrics/nassQuery`).
+ *
+ * NASSQL is a pipeline query language that composes operations across
+ * topology, metric metadata, and metric data sources. The response is a
+ * tabular array where the first row is the column header and subsequent
+ * rows are data; use {@link splitResult} or {@link resultAsRecords} to
+ * work with the data conveniently.
+ *
+ * Requests are validated against {@link QueryRequestSchema}; responses are
+ * validated against {@link QueryResultSchema}. Validation failures on the
+ * response side are logged as warnings, not thrown.
+ */
+class DataStoreNASSQLService {
+    dxSaasService;
+    log;
+    constructor(dxSaasService, log) {
+        this.dxSaasService = dxSaasService;
+        this.log = log;
+    }
+    /**
+     * POSTs a NASSQL query to `/metrics/nassQuery` and returns the raw tabular
+     * result (header row followed by data rows).
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    async query(request) {
+        QueryRequestSchema.parse(request);
+        const raw = await this.dxSaasService.tenantPost('metrics/nassQuery', request);
+        const result = QueryResultSchema.safeParse(raw);
+        if (!result.success) {
+            this.log.warn('QueryResult validation warning:', result.error.message);
+        }
+        return raw;
+    }
+    /**
+     * Splits a NASSQL query result into its header row and data rows.
+     * Assumes the first row is always the header.
+     */
+    splitResult(result) {
+        if (result.length === 0) {
+            return { header: [], data: [] };
+        }
+        const header = result[0];
+        const data = result.slice(1);
+        return { header, data };
+    }
+    /**
+     * Converts a NASSQL query result into an array of objects (Records),
+     * where each object's keys are the column names from the header row.
+     */
+    resultAsRecords(result) {
+        const { header, data } = this.splitResult(result);
+        return data.map((row) => {
+            const record = {};
+            header.forEach((colName, index) => {
+                record[colName] = row[index];
+            });
+            return record;
+        });
+    }
+}
+
+/**
+ * Service for issuing Topological Attribute Store (TAS) graph queries
+ * against the DX SaaS DataStore API (`/tas/graph/query`).
+ *
+ * Requests are validated against {@link TasQuerySchema}; responses are
+ * validated against {@link TasGraphSchema}. Validation failures on the
+ * response side are logged as warnings, not thrown.
+ */
+class DataStoreTASService {
+    dxSaasService;
+    log;
+    constructor(dxSaasService, log) {
+        this.dxSaasService = dxSaasService;
+        this.log = log;
+    }
+    /**
+     * POSTs a TAS graph query to `/tas/graph/query` and returns the resulting
+     * graph (vertices, edges, states).
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    async executeQuery(query) {
+        TasQuerySchema.parse(query);
+        const raw = await this.dxSaasService.tenantPost('tas/graph/query', query);
+        const result = TasGraphSchema.safeParse(raw);
+        if (!result.success) {
+            this.log.warn('TasGraph response validation warning:', result.error.message);
+        }
+        return raw;
+    }
+}
+
+export { AXAActivities, AccService, AgentService, AgentTrace, AlarmEnrichment, AlarmEnrichmentFilter, AlarmService, AlertDefinitionResponse, AlertResponse, AlertResponseV2, AlertService, AlignmentSchema, ApmUniverseService, AsmService, AttributeExpressionComparatorSchema, AttributeExpressionOperatorSchema, AttributeExpressionSchema, AttributeFilterOperator, AttributeNameAllSpecifierSchema, AttributeNameAndSpecifierSchema, AttributeNameAnyNumericSpecifierSchema, AttributeNameAttributeSpecifierSchema, AttributeNameChildrenSpecifierSchema, AttributeNameExactSpecifierSchema, AttributeNameFolderSpecifierSchema, AttributeNameNoneSpecifierSchema, AttributeNameNotSpecifierSchema, AttributeNameOperatorSpecifierSchema, AttributeNameOrSpecifierSchema, AttributeNameRegExSpecifierSchema, AttributeNameSpecifierSchema, AttributeNameTypeSpecifierSchema, AttributeService, AttributeValueAsFieldSchema, AuthorizationService, AxaService, BlobService, CalendarIntervalSchema, ChannelService, DEFAULT_EXPERIENCE_REQUEST_BODY, DXChannel, DashboardPermissionsUpdateRequest, DashboardSearch, DashboardService, DataStoreMetricsMetadataService, DataStoreNASSQLService, DataStoreTASService, DxSaasService, DxoiService, EdgeNumericIdSchema, EventService, ExperienceService, FillModeSchema, FilterOperation, FolderNameAllSpecifierSchema, FolderNameAndSpecifierSchema, FolderNameChildrenSpecifierSchema, FolderNameExactSpecifierSchema, FolderNameNoneSpecifierSchema, FolderNameNotSpecifierSchema, FolderNameOrSpecifierSchema, FolderNameRegExSpecifierSchema, FolderNameSpecifierSchema, GraphResponse, GraphService, Inventory, InventoryAttributes, InventoryService, JoinTypeSchema, JsExtensionService, LogQuery, LogsService, MServe, ManagementModuleIdSchema, ManagementModuleService, MatchType, MetadataMetricQueryResponseV2Schema, MetadataMetricQuerySchema, MetricAttributeSchema, MetricBatchService, MetricFolderSchema, MetricGroupingService, NASS, NASSService, NassValueTypeSchema, NotificationService, NumericOperatorSchema, O2NotificationService, O2UniverseService, OIAlarm, OIService, OperatorSchema, PerspectiveService, PlatformAlertService, PlatformFilters, PlatformManagementModuleService, PlatformMetricGroupingService, QuantileMethodSchema, QueryAllSpecifierSchema, QueryAndSpecifierSchema, QueryAttributeExpressionSchema, QueryAttributeSpecifierSchema, QueryColumnTypeSpecSchema, QueryFilterPredicateSpecSchema, QueryFunctionSpecSchema, QueryHintForceRangeSchema, QueryHintSchema, QueryIdSpecifierSchema, QueryMetricGroupSpecifierSchema, QueryMetricIdSchema, QueryNoneSpecifierSchema, QueryNotSpecifierSchema, QueryOrSpecifierSchema, QueryRangeSpecSchema, QueryRequestSchema, QueryResultSchema, QuerySpecSpecifierSchema, QuerySpecifierSchema, SQLService, ServiceFilterSpecifierSchema, ServiceService, SessionService, SimpleHTTPError, SituationLifecycle, SituationService, Situations, SourceNameAllSpecifierSchema, SourceNameAndSpecifierSchema, SourceNameExactSpecifierSchema, SourceNameNoneSpecifierSchema, SourceNameNotSpecifierSchema, SourceNameOrSpecifierSchema, SourceNamePartOperatorSpecifierSchema, SourceNameRegExSpecifierSchema, SourceNameSpecifierSchema, TAS, TASGraph, TASService, TasAddFlowsFilterSchema, TasAddTransitioningEdgesFilterSchema, TasAddWireContextFilterSchema, TasAddWiresFilterSchema, TasAllFilterSchema, TasAnalyticResultSchema, TasAndFilterSchema, TasAttributeFilterModeSchema, TasAttributeFilterSchema, TasAttributeTypeSchema, TasCollectAttributeNamesFilterSchema, TasCollectAttributesFilterSchema, TasCollectCardInfoFilterSchema, TasCollectCardInfoTierSchema, TasCollectCountsFilterSchema, TasCollectExperienceAttributesFilterSchema, TasCollectExperienceSelectorSchema, TasCollectGroupingInfoFilterSchema, TasCollectVertexIdFilterSchema, TasCoverageFilterSchema, TasEdgeSchema, TasEmptyFilterSchema, TasExternalIdSchema, TasFilterSchema, TasFollowPathFilterSchema, TasFollowPathFlowFilterSchema, TasFollowPathTypeSchema, TasGraphSchema, TasGroupingItemSchema, TasJoinFilterSchema, TasJoinTypeSchema, TasLayerFilterSchema, TasLegacyFilterSchema, TasLuceneFilterSchema, TasNotFilterSchema, TasOrFilterSchema, TasOrderSchema, TasProjectionFilterSchema, TasQuerySchema, TasServiceFilterSchema, TasStatusFilterSchema, TasTakeEdgesFilterSchema, TasTakeFlowsFilterSchema, TasTakeVerticesFilterSchema, TasTraverseFilterSchema, TasVariableFilterSchema, TasVariableSchema, TasVertexIdFilterSchema, TasVertexSchema, TasViewSchema, Trace, TraversalEdgeFilterSchema, TraversalVertexFilterSchema, TraverseCollectSchema, TraverseDirectionSchema, TraverseSchema, VertexMappingConfigurationModule, VertexService, VertexStateExternalIdSchema, VertexStateFilterSchema, VertexStateNumericIdSchema, VertexStateSchema, VertexStatusChanges, ags, agsresponse, apiTokenCreate, apiTokenDelete, apiTokenGet, apiTokenList, apiTokenUpdate, checkGet, contactActivate, contactDelete, contactTestSend, contactsBlockDelete, contactsBlockPut, contactsConfirm, contactsCreate, contactsGet, contactsGetDetail, contactsReplaceNotificationsWith, contactsRequestConfirmationCode, contactsUpdate, convertLegacyConfiguration, createPostmanRequest, createServiceMonolith, escapeRegExp, example, excludedAttributes, folderAccessGet, folderDelete, folderGet, folderPost, folderUpdate, foldersList, getUserTokenSub, getUserTokenTid, getVertexAttributeValue, getVertexAttributeValueOrNull, hasVertexAttribute, inventorizePreview, inventorizeResponse, inventorySearchRequestBodyExample, inventorySearchResponseBody, isTenantToken, isUserToken, locationsCreate, locationsDelete, locationsGet, locationsGetAll, locationsGetByType, locationsLeafGetFilter, locationsPost, logGet, logGetEvent, maintenanceDelete, maintenanceDeleteWindows, maintenanceGet, maintenanceGetDetail, maintenanceGetWindows, maintenanceGetWindowsDetail, maintenanceUpdateWindowsDetail, maintenancesCreate, maintenancesImmediateDelete, maintenancesImmediatePut, maintenancesPostWindows, maintenancesUpdate, messageGet, messagesList, monitorActivate, monitorCreate, monitorDeactivate, monitorDelete, monitorGet, monitorGetAll, monitorUpdate, oauthClientTokensCreate, oauthClientTokensDelete, oauthClientTokensGet, oauthClientTokensList, oauthClientTokensUpdate, oauthCreateToken, oauthGetRefreshTokenList, oauthGetTokenList, oauthRefreshTokenDeleteId, oauthTokenCognateDelete, oauthTokenCognateDeleteCurrent, oauthTokenDelete, oauthTokenDeleteCurrent, parseFilter, sampleServiceDetailRequestBody, searchUniverse, serviceDetailResponseBody, settingsGet, settingsGetDetail, settingsUpdate, stationDelete, stationsAgentType, stationsCreate, stationsDeleteMaintenance, stationsGet, stationsGetAgents, stationsLatest, stationsList, stationsOnpremiseConnected, stationsOnpremiseConnectedAll, stationsOnpremiseList, stationsPutMaintenance, stationsUpdate, statistic, tagsGetAll, timezonesList, userBlockDelete, userBlockPut, userDelete, userGet, userLockDelete, userPut, userSubaccountsGet, userSubaccountsPost, verifyAndDumpLegacyConfiguration, verifyAndDumpVersion3Configuration, verifyAndDumpVersion4Configuration, vertexMatchesFilters };
 //# sourceMappingURL=index.esm.js.map