@dx-do/client 6.3.1 → 6.3.3

package/dist/index.cjs.js

@@ -45894,6 +45894,308 @@ exports.LogQuery = void 0;
     LogQuery.createLogQueryRequestBody = createLogQueryRequestBody;
 })(exports.LogQuery || (exports.LogQuery = {}));
 
+/**
+ * One leaf match condition inside a maintenance target filter, e.g.
+ * `{ field: "alarm_name", condition: "starts_with", value: "Rabbit" }`.
+ */
+const MaintenanceFilterLeafSchema = v4.z.looseObject({
+    field: v4.z.string().describe('Wire field to match, e.g. "agent", "type", "alarm_name", "name"'),
+    fieldDescription: v4.z
+        .string()
+        .optional()
+        .describe('Human label for the field, e.g. "Agent", "Type", "Alert Name"'),
+    condition: v4.z
+        .string()
+        .describe('Match operator: "regex", "equals", "contains", "starts_with", "ends_with"'),
+    value: v4.z.string().describe('Value to match against the field'),
+});
+/**
+ * A maintenance target filter — the nested `and(or(leaf…))` tree shared by
+ * every `*Filter` field on a maintenance schedule (serviceFilter, agentFilter,
+ * deviceFilter, groupFilter, metricPathFilter). Outer AND of inner ORs of leaves.
+ */
+const MaintenanceFilterSchema = v4.z.looseObject({
+    and: v4.z.looseObject({
+        expressions: v4.z
+            .array(v4.z.looseObject({
+            or: v4.z.looseObject({
+                expressions: v4.z.array(MaintenanceFilterLeafSchema),
+            }),
+        }))
+            .describe('AND-ed groups; each group is an OR of leaf conditions'),
+    }),
+});
+/**
+ * Builds a single-leaf {@link MaintenanceFilter} (the common case: one match
+ * condition wrapped in the required `and(or(…))` envelope). Pass more leaves to
+ * OR them together within the single AND group.
+ */
+function maintenanceFilter(...leaves) {
+    return { and: { expressions: [{ or: { expressions: leaves } }] } };
+}
+
+/** CI type of a maintenance target member. */
+const MaintenanceMemberTypeSchema = v4.z
+    .enum(['SERVICE', 'Agent', 'Device', 'Group', 'Interface', 'Application'])
+    .describe('Configuration-item type of the member');
+/** Source product a maintenance member originates from. */
+const MaintenanceMemberSourceSchema = v4.z
+    .enum(['OI', 'APM', 'UIM', 'SPECTRUM', 'CAPM', 'CUSTOM', 'NFA', 'ADA'])
+    .describe('Source product of the member');
+/**
+ * An explicit maintenance target member (as opposed to a `*Filter`). For a
+ * service this is `{ id: <service externalId>, name, type: "SERVICE",
+ * source: "OI", parent: "Y" }`.
+ */
+const MaintenanceMemberSchema = v4.z.looseObject({
+    id: v4.z
+        .string()
+        .describe('Resource identifier; for services this is the externalId (SA:<cohort>:<uuid>)'),
+    name: v4.z.string().describe('Display name of the member'),
+    type: MaintenanceMemberTypeSchema,
+    source: MaintenanceMemberSourceSchema.optional(),
+    parent: v4.z
+        .string()
+        .optional()
+        .describe('"Y" when this member is a parent/root (services)'),
+    ciUniqueId: v4.z.string().optional().describe('CI unique id, when applicable'),
+});
+/** A member to exclude from an otherwise-matched maintenance target set. */
+const MaintenanceExcludedMemberSchema = v4.z.looseObject({
+    id: v4.z.string().describe('Excluded member id'),
+    name: v4.z.string().optional().describe('Excluded member name'),
+    type: v4.z.string().optional().describe('CI type of the excluded member'),
+});
+
+/** Recurrence pattern code used in the **create** schedule body. */
+const RecurrencePattern = {
+    Once: 1,
+    Daily: 2,
+    Weekly: 3,
+    Monthly: 4,
+    Yearly: 5,
+};
+/**
+ * The `schedule` object of a maintenance create/preview request.
+ *
+ * Note the create-side encoding (differs from search/detail responses):
+ * `recurrencePattern` is numeric (1–5), `startTime`/`endTime` are wall-clock
+ * strings `"YYYY-M-D H:M:S"` interpreted in `timeZone`, and `duration` is minutes.
+ */
+const MaintenanceScheduleSchema = v4.z.looseObject({
+    startTime: v4.z
+        .string()
+        .describe('Wall-clock start "YYYY-M-D H:M:S" interpreted in timeZone, e.g. "2026-6-27 6:47:0"'),
+    duration: v4.z.number().describe('Window length in minutes'),
+    endTime: v4.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Wall-clock end; null/absent = run forever'),
+    timeZone: v4.z.string().describe('IANA timezone, e.g. "America/Los_Angeles"'),
+    recurrencePattern: v4.z
+        .number()
+        .int()
+        .describe('1 Once · 2 Daily · 3 Weekly · 4 Monthly · 5 Yearly'),
+    recurrencePeriod: v4.z
+        .number()
+        .int()
+        .optional()
+        .describe('Repeat every N (daily: N days; monthly: N months)'),
+    recurrenceDaysOfTheWeek: v4.z
+        .string()
+        .optional()
+        .describe('Weekly days, comma-separated 1..7 where 1=Sun..7=Sat, e.g. "2,3"'),
+    recurrenceDayOfTheMonth: v4.z
+        .string()
+        .optional()
+        .describe('Monthly day-of-month (1..31) as a string'),
+    recurrenceInstance: v4.z
+        .number()
+        .int()
+        .optional()
+        .describe('Monthly ordinal week 1..5 (first..last) for "4th Tuesday" style'),
+});
+
+/**
+ * Unified request body for `POST /oi/v2/api/maintenance` (create). A single
+ * endpoint covers all target types — the per-target CLI commands each populate
+ * exactly one targeting mechanism (members, or one of the `*Filter`s).
+ */
+const MaintenanceCreateRequestSchema = v4.z.looseObject({
+    name: v4.z.string().describe('Schedule name; must be unique per tenant'),
+    description: v4.z.string().optional().describe('Free-text description'),
+    schedule: MaintenanceScheduleSchema,
+    // ----- targeting (combine as needed; commands set one) -----
+    members: v4.z
+        .array(MaintenanceMemberSchema)
+        .optional()
+        .describe('Explicit target CIs (services use this, with externalId ids)'),
+    excludedMembers: v4.z
+        .array(MaintenanceExcludedMemberSchema)
+        .optional()
+        .describe('CIs to exclude from an otherwise-matched set'),
+    serviceFilter: MaintenanceFilterSchema.optional().describe('Filter-based service targeting'),
+    agentFilter: MaintenanceFilterSchema.optional().describe('Agent targeting (regex on field "agent")'),
+    deviceFilter: MaintenanceFilterSchema.optional().describe('Device/entity targeting'),
+    groupFilter: MaintenanceFilterSchema.optional().describe('Group targeting'),
+    metricPathFilter: MaintenanceFilterSchema.optional().describe('Raw-alarm targeting (on field "alarm_name")'),
+    includeSubservices: v4.z
+        .boolean()
+        .optional()
+        .describe('Include child services of targeted services'),
+    selectAllServices: v4.z.boolean().optional(),
+    selectAllAgents: v4.z.boolean().optional(),
+    selectAllGroups: v4.z.boolean().optional(),
+    selectAllDevices: v4.z.boolean().optional(),
+    // ----- behavior -----
+    muteOldAlarms: v4.z
+        .boolean()
+        .optional()
+        .describe('Mute alarms that were already open when the window starts'),
+    alarmsExitOnEnd: v4.z
+        .boolean()
+        .optional()
+        .describe('Clear alarm state when the window ends'),
+    restrictSLOOnMaintenance: v4.z
+        .boolean()
+        .optional()
+        .describe('Exclude the window from SLO calculations'),
+    forceStop: v4.z.boolean().optional(),
+});
+/** Response from `POST /oi/v2/api/maintenance`. */
+const MaintenanceCreateResponseSchema = v4.z.looseObject({
+    message: v4.z.string().describe('Confirmation message'),
+    scheduleId: v4.z.string().describe('UUID of the created schedule'),
+});
+
+/** Request body for `POST /oi/v2/api/maintenance/delete?forceStop=…` (bulk). */
+const MaintenanceDeleteRequestSchema = v4.z.looseObject({
+    scheduleIds: v4.z
+        .array(v4.z.string())
+        .describe('Schedule ids to delete (bulk-capable)'),
+});
+/**
+ * Response from the bulk delete endpoint (modeled loosely). Named with a
+ * `BulkDelete` prefix to avoid clashing with the ASM client's generated
+ * `MaintenanceDeleteResponse` in the flattened `@dx-do/client` barrel.
+ */
+const MaintenanceBulkDeleteResponseSchema = v4.z.looseObject({
+    message: v4.z.union([v4.z.string(), v4.z.array(v4.z.string())]).optional(),
+    status: v4.z.string().optional(),
+});
+
+/**
+ * A single schedule from `GET /oi/v2/api/maintenance/{id}` (detail). Read-side
+ * encoding: `recurrencePattern` numeric, `startTime` a wall-clock string with
+ * `startTimeInMillis`/`endTimeInMillis` epoch companions, plus whichever
+ * `*Filter`/`members` targeting it was created with.
+ */
+const MaintenanceDetailSchema = v4.z.looseObject({
+    scheduleId: v4.z.string(),
+    name: v4.z.string().nullable().optional().describe('null for a non-existent id (the GET echoes the id with null fields)'),
+    description: v4.z.string().nullable().optional(),
+    status: v4.z.string().optional().describe('e.g. "SCHEDULED"'),
+    startTime: v4.z.string().optional().describe('Wall-clock start, e.g. "2026-12-25 00:00:00.0"'),
+    startTimeInMillis: v4.z.number().optional(),
+    endTimeInMillis: v4.z.number().nullable().optional(),
+    duration: v4.z.number().optional().describe('Minutes'),
+    timeZone: v4.z.string().optional(),
+    recurrencePattern: v4.z
+        .union([v4.z.number(), v4.z.string()])
+        .optional()
+        .describe('Numeric recurrence code on detail (1..5)'),
+    recurrencePeriod: v4.z.number().optional(),
+    recurrenceDaysOfTheWeek: v4.z.string().optional(),
+    recurrenceDayOfTheMonth: v4.z.string().optional(),
+    recurrenceInstance: v4.z.number().optional(),
+    members: v4.z.array(MaintenanceMemberSchema).optional(),
+    excludedMembers: v4.z.array(MaintenanceExcludedMemberSchema).optional(),
+    serviceFilter: MaintenanceFilterSchema.nullable().optional(),
+    agentFilter: MaintenanceFilterSchema.nullable().optional(),
+    deviceFilter: MaintenanceFilterSchema.nullable().optional(),
+    groupFilter: MaintenanceFilterSchema.nullable().optional(),
+    metricPathFilter: MaintenanceFilterSchema.nullable().optional(),
+    includeSubservices: v4.z.boolean().optional(),
+    muteOldAlarms: v4.z.boolean().optional(),
+    alarmsExitOnEnd: v4.z.boolean().optional(),
+    restrictSLOOnMaintenance: v4.z.boolean().optional(),
+});
+
+/**
+ * Request body for `POST /oi/v2/api/maintenance/get-next-windows-preview` —
+ * a (proposed or existing) schedule; the server returns its upcoming windows.
+ */
+const MaintenancePreviewRequestSchema = v4.z.looseObject({
+    name: v4.z.string().optional(),
+    description: v4.z.string().optional(),
+    schedule: MaintenanceScheduleSchema,
+});
+/**
+ * Response from `get-next-windows-preview`: `startTime` is an array of upcoming
+ * window-start wall-clock strings ("yyyy-MM-dd HH:mm:ss.S") in the schedule's
+ * timezone; each window runs for `schedule.duration` minutes.
+ */
+const MaintenancePreviewResponseSchema = v4.z.looseObject({
+    scheduleId: v4.z.string().nullable().optional(),
+    startTime: v4.z
+        .array(v4.z.string())
+        .optional()
+        .describe('Upcoming window start times (wall-clock, in the schedule timezone)'),
+});
+
+/** Request body for `POST /oi/v2/api/maintenance/_search` (list). */
+const MaintenanceSearchRequestSchema = v4.z.looseObject({
+    pageNumber: v4.z.number().int().describe('Zero-based page index'),
+    pageSize: v4.z.number().int().describe('Page size'),
+    sortColDir: v4.z
+        .array(v4.z.string())
+        .optional()
+        .describe('Sort spec, e.g. ["creationDate;desc"]'),
+    includeCompletedSchedules: v4.z
+        .boolean()
+        .optional()
+        .describe('Include schedules whose windows have all passed'),
+    customFilter: v4.z.array(v4.z.unknown()).optional().describe('Optional server-side filters'),
+});
+/**
+ * One schedule as summarized by `_search`. Note the response-side encoding:
+ * `recurrencePattern` is a label string ("Daily"), `recurrencePattern_1` the
+ * numeric code, and times are epoch ms (contrast the create body).
+ */
+const MaintenanceSummarySchema = v4.z.looseObject({
+    scheduleId: v4.z.string(),
+    scheduleName: v4.z.string().describe('Schedule name (may be padded with spaces)'),
+    description: v4.z.string().nullable().optional(),
+    startTime: v4.z.number().optional().describe('Start, epoch ms'),
+    duration: v4.z.number().optional().describe('Window length, minutes'),
+    recurrencePattern: v4.z.string().optional().describe('Recurrence label, e.g. "Daily"'),
+    recurrencePattern_1: v4.z.number().optional().describe('Numeric recurrence code (1..5)'),
+    recurrencePeriod: v4.z.number().optional(),
+    timezone: v4.z.string().optional(),
+    status: v4.z.string().optional().describe('e.g. "SCHEDULED"'),
+    createdBy: v4.z.string().nullable().optional(),
+    creationDate: v4.z.number().optional(),
+    lastUpdatedBy: v4.z.string().nullable().optional(),
+    lastUpdateDate: v4.z.number().optional(),
+    windowTime: v4.z
+        .looseObject({
+        startTime: v4.z.number().optional(),
+        endTime: v4.z.number().optional(),
+    })
+        .optional()
+        .describe('Next/active window bounds, epoch ms'),
+    deleted: v4.z.string().optional().describe('"Y"/"N"'),
+});
+/** Response from `POST /oi/v2/api/maintenance/_search`. */
+const MaintenanceSearchResponseSchema = v4.z.looseObject({
+    schedules: v4.z.array(MaintenanceSummarySchema).describe('The matched schedules'),
+    totalCount: v4.z.number().optional(),
+    scheduleCount: v4.z.number().optional(),
+    pageNumber: v4.z.number().optional(),
+    pageSize: v4.z.number().optional(),
+});
+
 exports.NASS = void 0;
 (function (NASS) {
     function getAgentMetricCountQueryBody(agent) {
@@ -48650,6 +48952,182 @@ exports.Situations = void 0;
 (function (Situations) {
 })(exports.Situations || (exports.Situations = {}));
 
+/**
+ * One row of an SLI's match criteria. SLIs select the metrics they watch by a
+ * list of these AND-ed filters (e.g. "Source contains bd605" AND "Metric ends
+ * with Web Agent Status").
+ */
+const SliFilterSchema = v4.z.looseObject({
+    fieldDescription: v4.z
+        .string()
+        .describe('Human label for the field, e.g. "Source" or "Metric"'),
+    field: v4.z
+        .string()
+        .describe('Wire field the filter matches on, e.g. "sourceName" or "attributeName"'),
+    value: v4.z.string().describe('Value to match against the field'),
+    condition: v4.z
+        .string()
+        .describe('Match operator, e.g. "contains", "ends_with", "regex"'),
+});
+/**
+ * A full SLI "group" as returned by `groups/search` (per `sliGroups[]` entry)
+ * and `groups?groupId=<id>` (single object). This is the **raw** shape that
+ * `sli export` writes to disk and `sli import` reads back.
+ *
+ * The wire terms are `groupName` / `groupId`; the CLI surfaces these to users
+ * as `sliName` / `sliId`. The deeply-nested `sliDefinition` / `sloDefinition` /
+ * `alertDefinition` blocks are kept **opaque** (loose passthrough) so they
+ * round-trip untouched — we model the envelope, not the SLI/SLO math.
+ */
+const SliGroupSchema = v4.z.looseObject({
+    groupName: v4.z.string().describe('SLI name (surfaced to users as `sliName`)'),
+    groupId: v4.z
+        .number()
+        .describe('Server-assigned SLI id (surfaced to users as `sliId`)'),
+    type: v4.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Group type; "sli" for SLIs. Save bodies set it; the GET-by-id response returns null'),
+    description: v4.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Free-text description; may be null or empty'),
+    mgId: v4.z
+        .unknown()
+        .nullable()
+        .optional()
+        .describe('Management-group id; null for SLIs'),
+    filters: v4.z
+        .array(SliFilterSchema)
+        .describe('AND-ed metric match criteria selecting the SLI source metrics'),
+    serviceNames: v4.z
+        .array(v4.z.string())
+        .describe('Service names this SLI is bound to. `sli import` overwrites this with the passed serviceName'),
+    sliDefinition: v4.z
+        .looseObject({ functions: v4.z.array(v4.z.unknown()).optional() })
+        .optional()
+        .describe('Opaque SLI computation spec ({ functions: [...] }); round-tripped verbatim'),
+    sloDefinition: v4.z
+        .looseObject({ functions: v4.z.array(v4.z.unknown()).optional() })
+        .optional()
+        .describe('Opaque SLO computation spec ({ functions: [...] }); round-tripped verbatim'),
+    alertDefinition: v4.z
+        .unknown()
+        .optional()
+        .describe('Opaque alert spec; null or an array. Normalized to [] on import when null'),
+    // Read-only server-managed fields (present on reads, ignored on save).
+    creationTime: v4.z.number().optional().describe('Epoch seconds the SLI was created'),
+    lastModifiedTime: v4.z.number().optional().describe('Epoch seconds the SLI was last modified'),
+    createdBy: v4.z.string().nullable().optional().describe('User that created the SLI'),
+    lastUpdatedBy: v4.z.string().nullable().optional().describe('User that last updated the SLI'),
+    totalMetrics: v4.z.number().optional().describe('Count of metrics currently matched by the SLI'),
+    breached: v4.z.boolean().optional().describe('Whether the SLO is currently breached'),
+    product: v4.z.unknown().nullable().optional().describe('Owning product; usually null'),
+    enabled: v4.z.boolean().optional().describe('Whether the SLI is active'),
+    sliStatusCode: v4.z.number().optional().describe('Registration status code; 0 = healthy'),
+    sliStatusMessage: v4.z.string().optional().describe('Human-readable registration status'),
+    fixRequired: v4.z.boolean().optional().describe('Whether the SLI needs attention to register'),
+    pipelineErrors: v4.z.array(v4.z.unknown()).optional().describe('Per-pipeline error details, if any'),
+    defaultGroup: v4.z.boolean().optional().describe('Whether this is a system default group'),
+});
+
+/**
+ * Request body for `POST oi/v2/metricconfig/groups/save`. Mirrors the writable
+ * subset of {@link SliGroupSchema} — read-only server fields (creationTime,
+ * createdBy, totalMetrics, …) are not sent.
+ *
+ * `groupId` is the create/update discriminator: present → update that group;
+ * absent → create a new one. `sli import` always omits it so import is
+ * create-only and can never overwrite an existing SLI.
+ */
+const SliSaveRequestSchema = v4.z.looseObject({
+    type: v4.z.string().describe('Always "sli" for SLIs'),
+    groupName: v4.z.string().describe('SLI name'),
+    description: v4.z.string().nullable().optional().describe('Free-text description'),
+    mgId: v4.z.unknown().nullable().optional().describe('Management-group id; null for SLIs'),
+    filters: v4.z.array(SliFilterSchema).describe('AND-ed metric match criteria'),
+    serviceNames: v4.z.array(v4.z.string()).describe('Service names the SLI binds to'),
+    sliDefinition: v4.z.unknown().describe('Opaque SLI computation spec, round-tripped from the export'),
+    sloDefinition: v4.z.unknown().describe('Opaque SLO computation spec, round-tripped from the export'),
+    alertDefinition: v4.z.unknown().optional().describe('Opaque alert spec; [] when none'),
+    groupId: v4.z
+        .number()
+        .optional()
+        .describe('Omit to create a new SLI; include to update an existing one'),
+});
+/**
+ * Response from `POST oi/v2/metricconfig/groups/save`.
+ */
+const SliSaveResponseSchema = v4.z.looseObject({
+    groupId: v4.z.number().describe('Id of the created/updated SLI'),
+    message: v4.z.array(v4.z.string()).describe('Server status messages'),
+    status: v4.z.string().describe('"Success" on success'),
+});
+/**
+ * Projects a read-model {@link SliGroup} onto the writable {@link SliSaveRequest}
+ * subset — dropping the read-only server fields (creationTime, createdBy,
+ * totalMetrics, …) and normalizing `type` (default `'sli'`) and
+ * `alertDefinition` (`null` → `[]`).
+ *
+ * @param group - The source SLI (e.g. from `getSli` or a raw export file).
+ * @param opts.serviceNames - Override the bound services; defaults to the group's.
+ * @param opts.create - When true, omit `groupId` so the save *creates* a new SLI;
+ *   otherwise `groupId` is carried through and the save *updates* in place.
+ */
+function toSliSaveRequest(group, opts = {}) {
+    const body = {
+        type: group.type ?? 'sli',
+        groupName: group.groupName,
+        description: group.description ?? '',
+        mgId: group.mgId ?? null,
+        filters: group.filters,
+        serviceNames: opts.serviceNames ?? group.serviceNames,
+        sliDefinition: group.sliDefinition,
+        sloDefinition: group.sloDefinition,
+        alertDefinition: group.alertDefinition ?? [],
+    };
+    if (!opts.create) {
+        body.groupId = group.groupId;
+    }
+    return body;
+}
+
+/**
+ * Request body for `POST oi/v2/metricconfig/groups/search`. Listing SLIs is a
+ * search scoped to `type: "sli"` with a large `pageSize` (the server returns
+ * all matching groups up to that cap).
+ */
+const SliSearchRequestSchema = v4.z.looseObject({
+    pageSize: v4.z
+        .number()
+        .describe('Max groups to return. Use a large value (e.g. 5000) to list all SLIs'),
+    type: v4.z
+        .string()
+        .describe('Group type to search; "sli" for SLIs'),
+});
+/**
+ * Response from `POST oi/v2/metricconfig/groups/search`. The SLIs are in
+ * `sliGroups`; the surrounding fields are tenant-wide metric-config limits.
+ */
+const SliSearchResponseSchema = v4.z.looseObject({
+    totalGroups: v4.z.number().optional().describe('Number of groups returned in `sliGroups`'),
+    pageSize: v4.z.number().optional().describe('Effective page size applied by the server'),
+    enabledMetrics: v4.z.number().optional().describe('Total metrics enabled across all SLIs'),
+    allowedMetricGroupsPerService: v4.z
+        .number()
+        .optional()
+        .describe('Tenant cap on SLI groups per service'),
+    allowedMetricsPerGroup: v4.z
+        .number()
+        .optional()
+        .describe('Tenant cap on metrics per SLI group'),
+    sliGroups: v4.z
+        .array(SliGroupSchema)
+        .describe('The SLI groups matching the search'),
+});
+
 exports.TAS = void 0;
 (function (TAS) {
     /** @internal */
@@ -74168,6 +74646,97 @@ class LogsService {
     }
 }
 
+/**
+ * Service for DXO2 maintenance windows (schedules) under
+ * `oi/v2/api/maintenance/*`. A maintenance window suppresses alarms/SLOs for
+ * its targets (services, agents, devices/entities, or raw alarms) over a fixed
+ * or recurring schedule. Backs the `maintenance` CLI command group.
+ *
+ * Uses `oiPost`/`oiGet` (OI namespace). Requests are validated with `parse`
+ * (throws); responses with `safeParse` (warn + return raw on mismatch).
+ */
+class MaintenanceService {
+    dxSaasService;
+    log;
+    constructor(dxSaasService, log) {
+        this.dxSaasService = dxSaasService;
+        this.log = log;
+    }
+    /** Lists maintenance schedules via `POST …/_search`. Defaults to one large page, newest first. */
+    async search(request) {
+        const body = {
+            pageNumber: 0,
+            pageSize: 1000,
+            sortColDir: ['creationDate;desc'],
+            includeCompletedSchedules: false,
+            customFilter: [],
+            ...request,
+        };
+        const raw = await this.dxSaasService.oiPost('oi/v2/api/maintenance/_search', body);
+        const result = MaintenanceSearchResponseSchema.safeParse(raw);
+        if (!result.success) {
+            this.log.warn('MaintenanceSearchResponse validation warning:', result.error.message);
+        }
+        return raw;
+    }
+    /** Retrieves a single schedule via `GET …/{id}`. */
+    async get(scheduleId) {
+        const raw = await this.dxSaasService.oiGet(`oi/v2/api/maintenance/${scheduleId}`);
+        const result = MaintenanceDetailSchema.safeParse(raw);
+        if (!result.success) {
+            this.log.warn('MaintenanceDetail validation warning:', result.error.message);
+        }
+        return raw;
+    }
+    /**
+     * Previews the upcoming windows for a (proposed or existing) schedule via
+     * `POST …/get-next-windows-preview`.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    async getNextWindows(request) {
+        MaintenancePreviewRequestSchema.parse(request);
+        return this.dxSaasService.oiPost('oi/v2/api/maintenance/get-next-windows-preview', request);
+    }
+    /**
+     * Checks a schedule name via `GET …/validateScheduleName`. Returns the
+     * server's bare boolean (semantics confirmed empirically by the caller).
+     */
+    async validateName(name) {
+        const raw = await this.dxSaasService.oiGet('oi/v2/api/maintenance/validateScheduleName', { scheduleName: name });
+        const result = v4.z.boolean().safeParse(raw);
+        if (!result.success) {
+            this.log.warn('validateScheduleName returned a non-boolean:', JSON.stringify(raw));
+        }
+        return Boolean(raw);
+    }
+    /**
+     * Creates a maintenance schedule via `POST …`.
+     *
+     * @throws ZodError if the request fails schema validation.
+     */
+    async create(body) {
+        MaintenanceCreateRequestSchema.parse(body);
+        const raw = await this.dxSaasService.oiPost('oi/v2/api/maintenance', body);
+        const result = MaintenanceCreateResponseSchema.safeParse(raw);
+        if (!result.success) {
+            this.log.warn('MaintenanceCreateResponse validation warning:', result.error.message);
+        }
+        return raw;
+    }
+    /**
+     * Deletes one or more schedules via `POST …/delete?forceStop=…` (bulk).
+     */
+    async delete(scheduleIds, options = {}) {
+        const raw = await this.dxSaasService.oiPost('oi/v2/api/maintenance/delete', { scheduleIds }, { forceStop: options.forceStop ?? true });
+        const result = MaintenanceBulkDeleteResponseSchema.safeParse(raw);
+        if (!result.success) {
+            this.log.warn('MaintenanceBulkDeleteResponse validation warning:', result.error.message);
+        }
+        return raw;
+    }
+}
+
 /**
  * Service for management modules (and their calculators): list, create, update,
  * copy, import, delete, and query by ID.
@@ -76119,6 +76688,80 @@ class ServiceService {
     }
 }
 
+/**
+ * Service for SLIs (Service Level Indicators), modeled by the OI metricconfig
+ * API as metric "groups" of `type: "sli"` under `oi/v2/metricconfig/groups/*`.
+ *
+ * These endpoints require the `x-authorizationview: VIEWALL` header, so this
+ * service uses {@link DxSaasService.oiPost} / {@link DxSaasService.oiGet}
+ * (which inject it) rather than the plain `tenant*` methods.
+ *
+ * Requests are validated against their input schema (throws `ZodError`);
+ * responses are `safeParse`-validated (warn-on-mismatch, raw still returned).
+ * Backs the `sli list` / `sli export` / `sli import` CLI commands.
+ */
+class SLIService {
+    dxSaasService;
+    log;
+    /**
+     * @param dxSaasService - An authenticated {@link DxSaasService} for the target tenant.
+     * @param log - Logger conforming to {@link SimpleLog} from `@dx-do/util`.
+     */
+    constructor(dxSaasService, log) {
+        this.dxSaasService = dxSaasService;
+        this.log = log;
+    }
+    /**
+     * Lists SLIs via `POST oi/v2/metricconfig/groups/search`.
+     *
+     * @remarks Defaults to `{ pageSize: 5000, type: 'sli' }`; pass a partial
+     *   override to change the cap. Response is validated but returned raw on
+     *   mismatch.
+     * @throws ZodError if the (merged) request fails schema validation.
+     */
+    async searchSlis(request) {
+        const body = { pageSize: 5000, type: 'sli', ...request };
+        SliSearchRequestSchema.parse(body);
+        const raw = await this.dxSaasService.oiPost('oi/v2/metricconfig/groups/search', body);
+        const result = SliSearchResponseSchema.safeParse(raw);
+        if (!result.success) {
+            this.log.warn('SliSearchResponse validation warning:', result.error.message);
+        }
+        return raw;
+    }
+    /**
+     * Retrieves a single SLI by id via `GET oi/v2/metricconfig/groups?groupId=<id>`.
+     * The returned object is the **raw** group `sli export` writes to disk.
+     *
+     * @remarks Response is validated but returned raw on mismatch.
+     */
+    async getSli(sliId) {
+        const raw = await this.dxSaasService.oiGet('oi/v2/metricconfig/groups', { groupId: sliId });
+        const result = SliGroupSchema.safeParse(raw);
+        if (!result.success) {
+            this.log.warn('SliGroup validation warning:', result.error.message);
+        }
+        return raw;
+    }
+    /**
+     * Creates or updates an SLI via `POST oi/v2/metricconfig/groups/save`. Omit
+     * `groupId` on the body to create; include it to update.
+     *
+     * @remarks Request is validated against {@link SliSaveRequestSchema}
+     *   (throws on bad input); response validated but returned raw on mismatch.
+     * @throws ZodError if the request fails schema validation.
+     */
+    async saveSli(body) {
+        SliSaveRequestSchema.parse(body);
+        const raw = await this.dxSaasService.oiPost('oi/v2/metricconfig/groups/save', body);
+        const result = SliSaveResponseSchema.safeParse(raw);
+        if (!result.success) {
+            this.log.warn('SliSaveResponse validation warning:', result.error.message);
+        }
+        return raw;
+    }
+}
+
 /**
  * Service for cluster/situation alarms: search, overview, lifecycle, inspection,
  * and triggering notifications for situations.
@@ -78087,6 +78730,7 @@ function createServiceMonolith(dxDoConfiguration, log = new NullSimpleLog()) {
         dxInventoryService: new InventoryService(dxSaaSService, dxNASSService, dxTASService, log),
         dxJSExtensionService: new JsExtensionService(dxSaaSService),
         dxLogsService: new LogsService(dxSaaSService),
+        dxMaintenanceService: new MaintenanceService(dxSaaSService, log),
         dxManagementModuleService: dxManagementModuleService,
         dxMetricBatchService: new MetricBatchService(dxSaaSService),
         dxMetricGroupingService: new MetricGroupingService(dxSaaSService, dxManagementModuleService),
@@ -78103,6 +78747,7 @@ function createServiceMonolith(dxDoConfiguration, log = new NullSimpleLog()) {
         dxServiceService: new ServiceService(dxSaaSService, log),
         dxSessionService: new SessionService(dxSaaSService),
         dxSituationService: new SituationService(dxSaaSService, log),
+        dxSLIService: new SLIService(dxSaaSService, log),
         dxSQLService: new SQLService(dxSaaSService),
         dxStatesService: new DataStoreStatesService(dxSaaSService, log),
         dxTASService,
@@ -78209,6 +78854,24 @@ exports.LogsService = LogsService;
 exports.METRIC_TYPE_ENUM = METRIC_TYPE_ENUM;
 exports.METRIC_TYPE_ENUM_NAMES = METRIC_TYPE_ENUM_NAMES;
 exports.METRIC_TYPE_REGION = METRIC_TYPE_REGION;
+exports.MaintenanceBulkDeleteResponseSchema = MaintenanceBulkDeleteResponseSchema;
+exports.MaintenanceCreateRequestSchema = MaintenanceCreateRequestSchema;
+exports.MaintenanceCreateResponseSchema = MaintenanceCreateResponseSchema;
+exports.MaintenanceDeleteRequestSchema = MaintenanceDeleteRequestSchema;
+exports.MaintenanceDetailSchema = MaintenanceDetailSchema;
+exports.MaintenanceExcludedMemberSchema = MaintenanceExcludedMemberSchema;
+exports.MaintenanceFilterLeafSchema = MaintenanceFilterLeafSchema;
+exports.MaintenanceFilterSchema = MaintenanceFilterSchema;
+exports.MaintenanceMemberSchema = MaintenanceMemberSchema;
+exports.MaintenanceMemberSourceSchema = MaintenanceMemberSourceSchema;
+exports.MaintenanceMemberTypeSchema = MaintenanceMemberTypeSchema;
+exports.MaintenancePreviewRequestSchema = MaintenancePreviewRequestSchema;
+exports.MaintenancePreviewResponseSchema = MaintenancePreviewResponseSchema;
+exports.MaintenanceScheduleSchema = MaintenanceScheduleSchema;
+exports.MaintenanceSearchRequestSchema = MaintenanceSearchRequestSchema;
+exports.MaintenanceSearchResponseSchema = MaintenanceSearchResponseSchema;
+exports.MaintenanceService = MaintenanceService;
+exports.MaintenanceSummarySchema = MaintenanceSummarySchema;
 exports.ManagementModuleIdSchema = ManagementModuleIdSchema;
 exports.ManagementModuleService = ManagementModuleService;
 exports.MetadataMetricQueryResponseV2Schema = MetadataMetricQueryResponseV2Schema;
@@ -78259,12 +78922,20 @@ exports.QueryRequestSchema = QueryRequestSchema;
 exports.QueryResultSchema = QueryResultSchema;
 exports.QuerySpecSpecifierSchema = QuerySpecSpecifierSchema;
 exports.QuerySpecifierSchema = QuerySpecifierSchema;
+exports.RecurrencePattern = RecurrencePattern;
+exports.SLIService = SLIService;
 exports.SQLService = SQLService;
 exports.ServiceFilterSpecifierSchema = ServiceFilterSpecifierSchema;
 exports.ServiceService = ServiceService;
 exports.SessionService = SessionService;
 exports.SimpleHTTPError = SimpleHTTPError;
 exports.SituationService = SituationService;
+exports.SliFilterSchema = SliFilterSchema;
+exports.SliGroupSchema = SliGroupSchema;
+exports.SliSaveRequestSchema = SliSaveRequestSchema;
+exports.SliSaveResponseSchema = SliSaveResponseSchema;
+exports.SliSearchRequestSchema = SliSearchRequestSchema;
+exports.SliSearchResponseSchema = SliSearchResponseSchema;
 exports.SourceNameAllSpecifierSchema = SourceNameAllSpecifierSchema;
 exports.SourceNameAndSpecifierSchema = SourceNameAndSpecifierSchema;
 exports.SourceNameExactSpecifierSchema = SourceNameExactSpecifierSchema;
@@ -78406,6 +79077,7 @@ exports.logGet = logGet;
 exports.logGetEvent = logGetEvent;
 exports.maintenanceDelete = maintenanceDelete;
 exports.maintenanceDeleteWindows = maintenanceDeleteWindows;
+exports.maintenanceFilter = maintenanceFilter;
 exports.maintenanceGet = maintenanceGet;
 exports.maintenanceGetDetail = maintenanceGetDetail;
 exports.maintenanceGetWindows = maintenanceGetWindows;
@@ -78462,6 +79134,7 @@ exports.statistic = statistic;
 exports.summarizeDataStoreSchema = summarizeDataStoreSchema;
 exports.tagsGetAll = tagsGetAll;
 exports.timezonesList = timezonesList;
+exports.toSliSaveRequest = toSliSaveRequest;
 exports.userBlockDelete = userBlockDelete;
 exports.userBlockPut = userBlockPut;
 exports.userDelete = userDelete;