@dx-do/client 6.1.0 → 6.2.0

package/dist/index.cjs.js

@@ -27011,68 +27011,80 @@ exports.DashboardSearch = void 0;
 })(exports.DashboardSearch || (exports.DashboardSearch = {}));
 
 const VertexStateFilterLazy = v4.z.lazy(() => VertexStateFilterSchema);
+/** Matches every vertex state. */
 const VertexStateAllFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('ALL'),
+    op: v4.z.literal('ALL').describe('Match all vertex states'),
 });
+/** Logical AND of nested vertex-state filters. */
 const VertexStateAndFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('AND'),
-    input: v4.z.array(VertexStateFilterLazy).optional(),
+    op: v4.z.literal('AND').describe('Logical AND of nested filters'),
+    input: v4.z.array(VertexStateFilterLazy).optional().describe('Child filters to AND together'),
 });
+/** Logical OR of nested vertex-state filters. */
 const VertexStateOrFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('OR'),
-    input: v4.z.array(VertexStateFilterLazy).optional(),
+    op: v4.z.literal('OR').describe('Logical OR of nested filters'),
+    input: v4.z.array(VertexStateFilterLazy).optional().describe('Child filters to OR together'),
 });
+/** Restricts to states belonging to the given alerts. */
 const VertexStateAlertFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('ALERT'),
-    input: VertexStateFilterLazy.optional(),
-    not: v4.z.boolean().optional(),
-    alertId: v4.z.array(v4.z.number()).optional(),
-    alertExternalId: v4.z.array(v4.z.string()).optional(),
+    op: v4.z.literal('ALERT').describe('Match states by alert'),
+    input: VertexStateFilterLazy.optional().describe('Nested filter to apply before this predicate'),
+    not: v4.z.boolean().optional().describe('Negate the predicate when true'),
+    alertId: v4.z.array(v4.z.number()).optional().describe('Internal alert IDs to match'),
+    alertExternalId: v4.z.array(v4.z.string()).optional().describe('External alert IDs to match'),
 });
+/** Restricts to states belonging to the given metrics. */
 const VertexStateMetricFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('METRIC'),
-    input: VertexStateFilterLazy.optional(),
-    not: v4.z.boolean().optional(),
-    metricId: v4.z.array(v4.z.number()).optional(),
-    metricExternalId: v4.z.array(v4.z.string()).optional(),
+    op: v4.z.literal('METRIC').describe('Match states by metric'),
+    input: VertexStateFilterLazy.optional().describe('Nested filter to apply before this predicate'),
+    not: v4.z.boolean().optional().describe('Negate the predicate when true'),
+    metricId: v4.z.array(v4.z.number()).optional().describe('Internal metric IDs to match'),
+    metricExternalId: v4.z.array(v4.z.string()).optional().describe('External metric IDs to match'),
 });
+/** Restricts to the given state status values. */
 const VertexStateStateFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('STATE'),
-    input: VertexStateFilterLazy.optional(),
-    not: v4.z.boolean().optional(),
-    state: v4.z.array(v4.z.number()).optional(),
+    op: v4.z.literal('STATE').describe('Match by state status value'),
+    input: VertexStateFilterLazy.optional().describe('Nested filter to apply before this predicate'),
+    not: v4.z.boolean().optional().describe('Negate the predicate when true'),
+    state: v4.z.array(v4.z.number()).optional().describe('State status codes to match'),
 });
+/** Restricts to states on the given vertices. */
 const VertexStateVertexIdFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('VERTEX_ID'),
-    input: VertexStateFilterLazy.optional(),
-    not: v4.z.boolean().optional(),
-    vertexId: v4.z.array(v4.z.number()).optional(),
+    op: v4.z.literal('VERTEX_ID').describe('Match states by owning vertex ID'),
+    input: VertexStateFilterLazy.optional().describe('Nested filter to apply before this predicate'),
+    not: v4.z.boolean().optional().describe('Negate the predicate when true'),
+    vertexId: v4.z.array(v4.z.number()).optional().describe('Vertex IDs to match'),
 });
+/** Restricts to states in the given namespaces. */
 const VertexStateNamespaceFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('NAMESPACE'),
-    input: VertexStateFilterLazy.optional(),
-    not: v4.z.boolean().optional(),
-    namespaces: v4.z.array(v4.z.string()).optional(),
+    op: v4.z.literal('NAMESPACE').describe('Match states by namespace'),
+    input: VertexStateFilterLazy.optional().describe('Nested filter to apply before this predicate'),
+    not: v4.z.boolean().optional().describe('Negate the predicate when true'),
+    namespaces: v4.z.array(v4.z.string()).optional().describe('Namespaces to match'),
 });
+/** Restricts to states produced by the given management modules. */
 const VertexStateManagementModuleFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('MANAGEMENT_MODULE'),
-    input: VertexStateFilterLazy.optional(),
-    not: v4.z.boolean().optional(),
-    moduleNames: v4.z.array(v4.z.string()).optional(),
+    op: v4.z.literal('MANAGEMENT_MODULE').describe('Match states by management module'),
+    input: VertexStateFilterLazy.optional().describe('Nested filter to apply before this predicate'),
+    not: v4.z.boolean().optional().describe('Negate the predicate when true'),
+    moduleNames: v4.z.array(v4.z.string()).optional().describe('Management module names to match'),
 });
+/** Discards the matched set (keeps only side-effect analytics from the nested filter). */
 const VertexStateEmptyFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('EMPTY'),
-    input: VertexStateFilterLazy.optional(),
+    op: v4.z.literal('EMPTY').describe('Discard matched states, keeping only nested-filter analytics'),
+    input: VertexStateFilterLazy.optional().describe('Nested filter whose analytics to retain'),
 });
 const VertexGroupSchema = v4.z.looseObject({
-    groupName: v4.z.string(),
-    vertexIds: v4.z.array(v4.z.number()).optional(),
+    groupName: v4.z.string().describe('Name of the vertex group'),
+    vertexIds: v4.z.array(v4.z.number()).optional().describe('Vertex IDs belonging to the group'),
 });
+/** Rolls matched states up into per-group status counts. */
 const VertexStateCollectVertexGroupStatusFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('COLLECT_GROUPS'),
-    input: VertexStateFilterLazy.optional(),
-    groups: v4.z.array(VertexGroupSchema).optional(),
+    op: v4.z.literal('COLLECT_GROUPS').describe('Aggregate matched states into per-group status counts'),
+    input: VertexStateFilterLazy.optional().describe('Nested filter selecting the states to aggregate'),
+    groups: v4.z.array(VertexGroupSchema).optional().describe('Vertex groups to tally status for'),
 });
+/** Discriminated union of all vertex-state filter operators, keyed by `op`. */
 const VertexStateFilterSchema = v4.z.discriminatedUnion('op', [
     VertexStateAllFilterSchema,
     VertexStateAndFilterSchema,
@@ -29130,6 +29142,67 @@ function decodeMetricTypeBits(n) {
     return { matched, residual: working >>> 0 };
 }
 
+/**
+ * Wire format for `POST /nass/metricValue/store`.
+ *
+ * Each datapoint in `values` is a positional tuple. Two variants are supported,
+ * discriminated by the type of the **second** element:
+ *
+ * Regular / String metric (7 elements, `interval` optional):
+ *   `[id, time, min|null, max|null, value, count, interval?]`
+ *   - String metrics: set `min` and `max` to `null`.
+ *   - `interval` defaults to 15 seconds when omitted.
+ *
+ * Extension metric (variable length):
+ *   `[id, extensionId, time, interval, ...values]`
+ *   - `interval` is required for extensions.
+ *   - trailing values may be any mix of number, string, or null.
+ *
+ * The two tuple shapes are unambiguous because index `1` is a `number` (`time`)
+ * for regular datapoints and a `string` (`extensionId`) for extension ones.
+ */
+const NassRegularDatapointSchema = v4.z
+    .tuple([
+    v4.z.string().describe('Registered metric ID (from the metadata registration response)'),
+    v4.z.number().describe('Sample time in seconds since epoch'),
+    v4.z.number().nullable().describe('Minimum over the interval; `null` for string metrics'),
+    v4.z.number().nullable().describe('Maximum over the interval; `null` for string metrics'),
+    v4.z.union([v4.z.number(), v4.z.string()]).describe('Sample value — numeric, or string for string metrics'),
+    v4.z.number().describe('Number of raw samples aggregated into this datapoint'),
+    v4.z.number().optional().describe('Aggregation interval in seconds; defaults to 15 when omitted'),
+])
+    .describe('Regular/string metric datapoint: [id, time, min, max, value, count, interval?]');
+const NassExtensionDatapointSchema = v4.z
+    .tuple([
+    v4.z.string().describe('Registered metric ID'),
+    v4.z.string().describe('Extension ID identifying the extension metric variant'),
+    v4.z.number().describe('Sample time in seconds since epoch'),
+    v4.z.number().describe('Aggregation interval in seconds (required for extensions)'),
+], v4.z
+    .union([v4.z.number(), v4.z.string(), v4.z.null()])
+    .describe('Extension value element — number, string, or null'))
+    .describe('Extension metric datapoint: [id, extensionId, time, interval, ...values]');
+const NassDatapointSchema = v4.z
+    .union([NassRegularDatapointSchema, NassExtensionDatapointSchema])
+    .describe('A single metric datapoint — regular/string or extension variant');
+const NassStoreRequestSchema = v4.z.looseObject({
+    values: v4.z.array(NassDatapointSchema).describe('Datapoints to store, one tuple per sample'),
+});
+const NassStoreResponseSchema = v4.z.looseObject({
+    metricForwardFailures: v4.z
+        .number()
+        .optional()
+        .describe('Count of datapoints that failed downstream forwarding (present only when > 0)'),
+    metricStringsClamped: v4.z
+        .number()
+        .optional()
+        .describe('Count of string metric values clamped to the server-side length limit'),
+    metricExtensionsClamped: v4.z
+        .number()
+        .optional()
+        .describe('Count of extension metric values clamped to the server-side limit'),
+});
+
 /**
  * Numeric comparison operators for the `NUMERIC` predicate.
  * - `EQ` — equal
@@ -30093,6 +30166,178 @@ const QueryRequestSchema = v4.z.looseObject({
 
 const QueryResultSchema = v4.z.array(v4.z.unknown());
 
+/**
+ * Self-describing envelope stored as the blob body by `dx-do blob store`.
+ *
+ * Because `fetchBlob` returns only a blob's content (not its attributes) and
+ * blob queries cannot filter by id, the metadata required to restore a file
+ * travels inside the body itself. `dx-do blob fetch` keys off the `dxdoFile`
+ * marker to decide whether to write a file back to disk or print the content.
+ * The same metadata (minus `data`) is also mirrored into queryable blob
+ * attributes so `blob list-blobs` / `blob query` can find file-blobs.
+ */
+const BlobFileEnvelopeSchema = v4.z.looseObject({
+    dxdoFile: v4.z
+        .literal(1)
+        .describe('Envelope format marker identifying a blob stored from a local file'),
+    name: v4.z
+        .string()
+        .describe('Original file basename, used to restore the file with its name'),
+    md5: v4.z.string().describe('MD5 hex digest of the original file bytes'),
+    size: v4.z.number().describe('Original file size in bytes'),
+    mtime: v4.z.string().describe('Source file last-modified time, ISO 8601'),
+    sourcePath: v4.z
+        .string()
+        .describe('Absolute local path the file was stored from'),
+    mimeType: v4.z
+        .string()
+        .describe('MIME type guessed from the file extension (application/octet-stream fallback)'),
+    encoding: v4.z.literal('base64').describe('Encoding of the `data` field'),
+    data: v4.z.string().describe('Base64-encoded original file bytes'),
+});
+
+const BlobAttributeExpressionSchema = v4.z.looseObject({
+    name: v4.z.string().describe('Attribute name to match against'),
+    values: v4.z.array(v4.z.string()).optional().describe('Accepted values (set membership)'),
+});
+/** Matches every blob in the schema. */
+const BlobAllFilterSchema = v4.z.looseObject({
+    op: v4.z.literal('ALL').describe('Match all blobs in the schema'),
+});
+/** Matches blobs whose attributes satisfy the given expressions (AND-ed). */
+const BlobAttributeFilterSchema = v4.z.looseObject({
+    op: v4.z.literal('ATTRIBUTE').describe('Match blobs by attribute expressions'),
+    expressions: v4.z
+        .array(BlobAttributeExpressionSchema)
+        .optional()
+        .describe('Attribute predicates; all must match'),
+});
+/** Discriminated union of blob filter operators, keyed by `op`. */
+const BlobFilterSchema = v4.z.discriminatedUnion('op', [
+    BlobAllFilterSchema,
+    BlobAttributeFilterSchema,
+]);
+
+/** Indexed attributes attached to a blob (string→scalar map). */
+const BlobAttributesSchema = v4.z
+    .record(v4.z.string(), v4.z.union([v4.z.string(), v4.z.number(), v4.z.boolean()]))
+    .describe('Indexed, queryable attributes attached to the blob (scalar values)');
+/** Query params used by `POST /blobstorage/blob` and `DELETE /blobstorage/blob`. */
+const BlobStoreParamsSchema = v4.z.looseObject({
+    schema: v4.z.string().describe('Blob schema (collection) name'),
+    id: v4.z.string().describe('Blob ID, unique within the schema'),
+    ttl: v4.z
+        .union([v4.z.string(), v4.z.number()])
+        .optional()
+        .describe('Time-to-live: a relative duration in milliseconds (number), or an absolute ISO-8601 expiry timestamp (string)'),
+});
+const BlobBulkItemSchema = v4.z.looseObject({
+    schema: v4.z.string().describe('Blob schema (collection) name'),
+    id: v4.z.string().describe('Blob ID, unique within the schema'),
+    ttl: v4.z
+        .union([v4.z.string(), v4.z.number()])
+        .describe('Time-to-live: a relative duration in milliseconds (number), or an absolute ISO-8601 expiry timestamp (string)'),
+    data: v4.z.string().describe('Blob payload (string-encoded)'),
+    attributes: BlobAttributesSchema.optional().describe('Indexed attributes for querying'),
+});
+const BlobBulkStoreRequestSchema = v4.z.looseObject({
+    blobs: v4.z.array(BlobBulkItemSchema).describe('Blobs to store in one batch'),
+});
+const BlobFetchParamsSchema = v4.z.looseObject({
+    schema: v4.z.string().describe('Blob schema (collection) name'),
+    id: v4.z.string().describe('Blob ID to fetch'),
+    version: v4.z.number().optional().describe('Specific version to fetch; defaults to latest'),
+});
+const BlobQueryRequestSchema = v4.z.looseObject({
+    schema: v4.z.string().describe('Blob schema (collection) to query'),
+    filter: BlobFilterSchema.optional().describe('Attribute filter; omit to match all blobs'),
+    includeData: v4.z.boolean().optional().describe('Include each blob’s payload in the response'),
+    includeProfile: v4.z.boolean().optional().describe('Include profiling/diagnostic info in the response'),
+});
+const BlobDeleteParamsSchema = v4.z.looseObject({
+    schema: v4.z.string().describe('Blob schema (collection) name'),
+    id: v4.z.string().describe('Blob ID to delete'),
+});
+const BlobBulkDeleteEntrySchema = v4.z.looseObject({
+    schema: v4.z.string().describe('Blob schema (collection) name'),
+    id: v4.z.string().describe('Blob ID to delete'),
+});
+const BlobBulkDeleteRequestSchema = v4.z.looseObject({
+    blobs: v4.z.array(BlobBulkDeleteEntrySchema).describe('Blobs to delete in one batch'),
+});
+/** Schema-list request takes no parameters. */
+const BlobSchemaListRequestSchema = v4.z.looseObject({});
+/** Async command to delete an entire blob schema and all its blobs. */
+const BlobAsyncDeleteSchemaCommandSchema = v4.z.looseObject({
+    op: v4.z.literal('DELETE_SCHEMA').describe('Delete an entire blob schema'),
+    schema: v4.z.string().describe('Blob schema (collection) to delete'),
+});
+/** Discriminated union of async blob commands, keyed by `op`. */
+const BlobAsyncCommandSchema = v4.z.discriminatedUnion('op', [
+    BlobAsyncDeleteSchemaCommandSchema,
+]);
+const BlobExecuteAsyncRequestSchema = v4.z.looseObject({
+    commands: v4.z.array(BlobAsyncCommandSchema).describe('Async commands to enqueue'),
+});
+const BlobAsyncResultRequestSchema = v4.z.looseObject({
+    correlationKey: v4.z.string().describe('Correlation key returned by the execute-async call'),
+});
+
+const BlobMetadataSchema = v4.z.looseObject({
+    schema: v4.z.string().optional().describe('Blob schema (collection) name'),
+    id: v4.z.string().optional().describe('Blob ID'),
+    ttl: v4.z.string().optional().describe('Remaining time-to-live'),
+    attributes: BlobAttributesSchema.optional().describe('Indexed attributes attached to the blob'),
+    version: v4.z.number().optional().describe('Stored version number'),
+    data: v4.z.string().optional().describe('Blob payload (present only when data was requested)'),
+});
+/** Store response — metadata for the persisted blob. */
+const BlobStoreResponseSchema = BlobMetadataSchema;
+const BlobBulkStoreResponseSchema = v4.z.looseObject({
+    blobs: v4.z.array(BlobMetadataSchema).optional().describe('Successfully stored blobs'),
+    failed: v4.z.array(BlobMetadataSchema).optional().describe('Blobs that failed to store'),
+});
+const BlobQueryResponseSchema = v4.z.looseObject({
+    blobs: v4.z.array(BlobMetadataSchema).optional().describe('Blobs matching the query'),
+});
+const BlobDeleteResponseSchema = v4.z.looseObject({
+    blob: BlobMetadataSchema.optional().describe('Metadata of the deleted blob'),
+});
+const BlobBulkDeleteResponseSchema = v4.z.looseObject({
+    deletedBlobs: v4.z.array(BlobMetadataSchema).optional().describe('Blobs that were deleted'),
+});
+const BlobSchemaItemSchema = v4.z.looseObject({
+    name: v4.z.string().optional().describe('Blob schema (collection) name'),
+});
+const BlobSchemaListResponseSchema = v4.z.looseObject({
+    schemas: v4.z.array(BlobSchemaItemSchema).optional().describe('Available blob schemas'),
+});
+const BlobExecuteAsyncResponseSchema = v4.z.looseObject({
+    correlationKey: v4.z.string().optional().describe('Key to poll for the async operation result'),
+});
+/** Lifecycle state of an async blob operation. */
+const BlobAsyncResultStateSchema = v4.z
+    .enum(['PENDING', 'RUNNING', 'FINISHED', 'FAILED'])
+    .describe('Async operation state (PENDING, RUNNING, FINISHED, FAILED)');
+const BlobDeleteSchemaResultSchema = v4.z.looseObject({
+    schema: v4.z.string().optional().describe('Schema that was deleted'),
+    deletedBlobs: v4.z.number().optional().describe('Number of blobs removed with the schema'),
+});
+const BlobAsyncResultEntrySchema = v4.z.looseObject({
+    op: v4.z.string().optional().describe('The async command this result corresponds to'),
+    deletedSchema: BlobDeleteSchemaResultSchema.optional().describe('Result detail for a DELETE_SCHEMA command'),
+});
+const BlobAsyncResultResponseSchema = v4.z.looseObject({
+    correlationKey: v4.z.string().optional().describe('Correlation key being polled'),
+    state: v4.z.string().optional().describe('Overall operation state (see BlobAsyncResultState)'),
+    numberOfDone: v4.z.number().optional().describe('Count of commands completed so far'),
+    numberOfRemaining: v4.z.number().optional().describe('Count of commands still pending'),
+    results: v4.z
+        .record(v4.z.string(), BlobAsyncResultEntrySchema)
+        .optional()
+        .describe('Per-command results keyed by command identifier'),
+});
+
 const DATASTORE_SCHEMA_TYPES = [
     'tas',
     'nassql',
@@ -45537,6 +45782,49 @@ const inventorySearchRequestBodyExample = {
     refreshView: false,
 };
 
+exports.LogIngest = void 0;
+(function (LogIngest) {
+    LogIngest.LogIngestOptionsSchema = v4.z.looseObject({
+        logtype: v4.z
+            .string()
+            .optional()
+            .describe("Log type — matched against the tenant's configured log types (default: `\"generic\"`)"),
+        host: v4.z
+            .string()
+            .optional()
+            .describe('Host name (default: auto-detected via `os.hostname()`)'),
+        message: v4.z.string().describe('Log message text'),
+        timestamp: v4.z
+            .string()
+            .optional()
+            .describe('ISO 8601 timestamp (default: now)'),
+        agentName: v4.z
+            .string()
+            .optional()
+            .describe('Agent name sent as `__agent_name` (default: `"Logs Collector"`)'),
+        agentInstance: v4.z
+            .string()
+            .optional()
+            .describe('Agent instance identifier sent as `__agent_instance` (default: `"dx-do"`)'),
+        containerId: v4.z
+            .string()
+            .optional()
+            .describe('Container ID for the log entry (default: same as host)'),
+        containerName: v4.z
+            .string()
+            .optional()
+            .describe('Container name for the log entry (default: same as agentInstance)'),
+        file: v4.z
+            .string()
+            .optional()
+            .describe('Source file label (default: `"dx-do.cli"`)'),
+        ip: v4.z
+            .string()
+            .optional()
+            .describe('Source IP address (default: first non-loopback IPv4, falls back to `"127.0.0.1"`)'),
+    });
+})(exports.LogIngest || (exports.LogIngest = {}));
+
 exports.LogQuery = void 0;
 (function (LogQuery) {
     LogQuery.ValidFieldConditions = [
@@ -73446,55 +73734,70 @@ class LogsService {
     queryLogs(logQueryBody) {
         return this.dxSaasService.oiPost('oi/loganalytics/v1/api/logs/filter', logQueryBody);
     }
-    /** Ingests a single log entry into the log gateway. */
-    ingestLog(entry) {
-        return this.ingestLogs([entry]);
-    }
     /**
-     * Builds the enriched payload array that will be sent to the uim_logs endpoint.
-     * Exposed so callers can inspect the payload without sending (e.g. dry-run).
+     * Builds the enriched payload object for a single log entry.
+     *
+     * @remarks `options` is validated against
+     *   {@link LogIngest.LogIngestOptionsSchema} before the payload is assembled.
+     * @param options - Known log entry fields (`message` required; the rest
+     *   optional with sensible defaults).
+     * @param additionalFields - Arbitrary extra fields to include in the indexed document.
+     * @returns The payload object ready to POST to the uim_logs ingestion endpoint.
+     * @throws ZodError if `options` fails schema validation.
      */
-    buildLogPayload(entries) {
+    buildLogPayload(options, additionalFields) {
+        exports.LogIngest.LogIngestOptionsSchema.parse(options);
         const cohortId = this.dxSaasService.dxdoConfiguration.dxConfiguration.cohortId;
         const tenantIdUpper = cohortId.toUpperCase();
-        const now = new Date().toISOString();
-        return entries.map((e) => {
-            const host = e.host ?? require$$0$4.hostname();
-            const logtype = e.logtype;
-            const ip = e.ip ?? detectIPv4();
-            const agentInstance = e.agentInstance ?? 'dx-do';
-            const agentName = e.agentName ?? 'Logs Collector';
-            const containerId = e.containerId ?? host;
-            const containerName = e.containerName ?? agentInstance;
-            const file = e.file ?? 'dx-do.cli';
-            const tag = `${logtype} logs`;
-            // temp_fields must have exactly 9 space-separated components before the message
-            // is appended by the SaaS filter (agentbase_msg = temp_fields + " " + message).
-            // The Kafka consumer parses positionally: [0]=tenant [1]=logtype [2]=host
-            // [3]=container_id [4]=container_name [5]=ip [6-7]=tags [8]=source_file [9+]=message.
-            const temp_fields = `${tenantIdUpper} ${logtype} ${host} ${containerId} ${containerName} ${ip} ${tag} ${file}`;
-            return {
-                '@timestamp': now,
-                // logtype must be top-level: the SaaS filter does `update => ["type", "%{logtype}"]`
-                // which drives Kafka consumer index routing — without it type stays as "ingestionapi"
-                logtype,
-                message: e.message ?? '',
-                host: { name: host, hostname: host },
-                tenant_id: tenantIdUpper,
-                temp_fields,
-                tags: [tag],
-                __agent_name: agentName,
-                __agent_instance: agentInstance,
-                container_id: containerId,
-                container_name: containerName,
-                ...Object.fromEntries(Object.entries(e).filter(([k]) => !['logtype', 'message', 'host', 'timestamp', 'ip',
-                    'agentInstance', 'agentName', 'containerId', 'containerName', 'file'].includes(k))),
-            };
-        });
+        const logtype = options.logtype ?? 'generic';
+        const host = options.host ?? require$$0$4.hostname();
+        const ip = options.ip ?? detectIPv4();
+        const agentInstance = options.agentInstance ?? 'dx-do';
+        const agentName = options.agentName ?? 'Logs Collector';
+        const containerId = options.containerId ?? host;
+        const containerName = options.containerName ?? agentInstance;
+        const file = options.file ?? 'dx-do.cli';
+        const tag = `${logtype} logs`;
+        // temp_fields must have exactly 9 space-separated components before the message
+        // is appended by the SaaS filter (agentbase_msg = temp_fields + " " + message).
+        // The Kafka consumer parses positionally: [0]=tenant [1]=logtype [2]=host
+        // [3]=container_id [4]=container_name [5]=ip [6-7]=tags [8]=source_file [9+]=message.
+        const temp_fields = `${tenantIdUpper} ${logtype} ${host} ${containerId} ${containerName} ${ip} ${tag} ${file}`;
+        return {
+            '@timestamp': options.timestamp ?? new Date().toISOString(),
+            // logtype must be top-level: the SaaS filter does `update => ["type", "%{logtype}"]`
+            // which drives Kafka consumer index routing — without it type stays as "ingestionapi"
+            logtype,
+            message: options.message,
+            host: { name: host, hostname: host },
+            tenant_id: tenantIdUpper,
+            temp_fields,
+            tags: [tag],
+            __agent_name: agentName,
+            __agent_instance: agentInstance,
+            container_id: containerId,
+            container_name: containerName,
+            ...additionalFields,
+        };
+    }
+    /**
+     * Ingests a single log entry into the log gateway.
+     *
+     * @remarks The gateway returns an opaque ingestion acknowledgement with no
+     *   stable schema, so the response is intentionally typed `unknown` and not
+     *   validated. `options` is validated by {@link buildLogPayload}.
+     */
+    ingestLog(options, additionalFields) {
+        return this.dxSaasService.logPost('mdo/v2/aoanalytics/ingestion/uim_logs', [this.buildLogPayload(options, additionalFields)]);
     }
-    /** Ingests a batch of log entries into the log gateway. */
+    /**
+     * Ingests a batch of log entries into the log gateway.
+     *
+     * @remarks Each entry's `options` is validated by {@link buildLogPayload}.
+     *   The gateway response is an opaque ack (typed `unknown`, not validated).
+     */
     ingestLogs(entries) {
-        return this.dxSaasService.logPost('mdo/v2/aoanalytics/ingestion/uim_logs', this.buildLogPayload(entries));
+        return this.dxSaasService.logPost('mdo/v2/aoanalytics/ingestion/uim_logs', entries.map((e) => this.buildLogPayload(e.options, e.additionalFields)));
     }
 }
 
@@ -75421,70 +75724,107 @@ class SituationService {
     }
 }
 
+/**
+ * A single audit event as submitted to the audit store (`POST /audit/store`).
+ * `eventTime`, `serviceId`, `resource`, `action`, and `result` are the required
+ * core of an event; the remaining fields enrich it with actor and origin context.
+ */
 const AuditRecordSchema = v4.z.looseObject({
-    userName: v4.z.string().optional(),
-    userFirstName: v4.z.string().optional(),
-    userLastName: v4.z.string().optional(),
-    userEmailAddr: v4.z.string().optional(),
-    token: v4.z.string().optional(),
-    eventTime: v4.z.string(),
-    dsTenantId: v4.z.string().optional(),
-    dxiTenantId: v4.z.string().optional(),
-    cohortId: v4.z.string().optional(),
-    serviceId: v4.z.string(),
-    serviceInstanceId: v4.z.string().optional(),
-    componentName: v4.z.string().optional(),
-    clientIp: v4.z.string().optional(),
-    clientHostName: v4.z.string().optional(),
-    resource: v4.z.string(),
-    action: v4.z.string(),
-    result: v4.z.string(),
-    oldValue: v4.z.unknown().optional(),
-    newValue: v4.z.unknown().optional(),
-    eventId: v4.z.string().optional(),
-    additionalInfo: v4.z.unknown().optional(),
+    userName: v4.z.string().optional().describe('Login/user name of the actor who performed the action'),
+    userFirstName: v4.z.string().optional().describe('Actor first name'),
+    userLastName: v4.z.string().optional().describe('Actor last name'),
+    userEmailAddr: v4.z.string().optional().describe('Actor email address'),
+    token: v4.z
+        .string()
+        .optional()
+        .describe('Auth token associated with the actor, when the action was token-driven'),
+    eventTime: v4.z.string().describe('Time the audited event occurred (ISO 8601 or epoch string)'),
+    dsTenantId: v4.z.string().optional().describe('DataStore tenant ID the event belongs to'),
+    dxiTenantId: v4.z.string().optional().describe('DXI tenant ID the event belongs to'),
+    cohortId: v4.z.string().optional().describe('Cohort (tenant cohort) identifier'),
+    serviceId: v4.z.string().describe('ID of the service that emitted the audit event'),
+    serviceInstanceId: v4.z.string().optional().describe('Instance ID of the emitting service'),
+    componentName: v4.z.string().optional().describe('Component within the service that produced the event'),
+    clientIp: v4.z.string().optional().describe('Source IP address of the client that triggered the action'),
+    clientHostName: v4.z
+        .string()
+        .optional()
+        .describe('Source host name of the client that triggered the action'),
+    resource: v4.z.string().describe('The resource that was acted upon (e.g. entity, config key, path)'),
+    action: v4.z.string().describe('The action performed on the resource (e.g. CREATE, UPDATE, DELETE)'),
+    result: v4.z.string().describe('Outcome of the action (e.g. SUCCESS, FAILURE)'),
+    oldValue: v4.z.unknown().optional().describe('Prior value of the resource before the action (for changes)'),
+    newValue: v4.z.unknown().optional().describe('New value of the resource after the action (for changes)'),
+    eventId: v4.z.string().optional().describe('Unique identifier assigned to this audit event'),
+    additionalInfo: v4.z.unknown().optional().describe('Free-form supplementary context attached to the event'),
 });
 
 const DateTimeSchema = v4.z.custom((val) => DateTime.isDateTime(val));
+/**
+ * Request body for an audit-log query (`POST /audit/query`). The event-time
+ * window is required; the remaining fields narrow the result set and page it.
+ */
 const AuditQueryRequestSchema = v4.z.object({
-    fromEventTime: DateTimeSchema,
-    toEventTime: DateTimeSchema,
-    userName: v4.z.string().optional(),
-    serviceId: v4.z.string().optional(),
-    action: v4.z.string().optional(),
-    result: v4.z.string().optional(),
-    from: v4.z.number().int().optional(),
-    size: v4.z.number().int().optional(),
+    fromEventTime: DateTimeSchema.describe('Inclusive start of the event-time window to search'),
+    toEventTime: DateTimeSchema.describe('Inclusive end of the event-time window to search'),
+    userName: v4.z.string().optional().describe('Filter to audit events performed by this user name'),
+    serviceId: v4.z.string().optional().describe('Filter to audit events emitted by this service ID'),
+    action: v4.z
+        .string()
+        .optional()
+        .describe('Filter to a specific audited action (e.g. CREATE, UPDATE, DELETE)'),
+    result: v4.z
+        .string()
+        .optional()
+        .describe('Filter by outcome of the audited action (e.g. SUCCESS, FAILURE)'),
+    from: v4.z
+        .number()
+        .int()
+        .optional()
+        .describe('Zero-based offset of the first result to return (pagination)'),
+    size: v4.z.number().int().optional().describe('Maximum number of records to return (page size)'),
 });
+/** Cross-tenant variant of {@link AuditQueryRequestSchema} that adds a tenant filter. */
 AuditQueryRequestSchema.extend({
-    tenantId: v4.z.string().optional(),
+    tenantId: v4.z
+        .string()
+        .optional()
+        .describe('Restrict a cross-tenant (global) query to a single tenant ID'),
 });
 
+/** Store acknowledgement — the audit store returns an empty object on success. */
 const AuditStoreResponseSchema = v4.z.looseObject({}).optional();
+/**
+ * An audit record as returned from the query endpoint (Elasticsearch-shaped).
+ * Distinct from {@link AuditRecordSchema}: every field is optional and the
+ * actor email is keyed `userEmailAddress` (vs `userEmailAddr` on store).
+ */
 const AuditRecordEsSchema = v4.z.looseObject({
-    userName: v4.z.string().optional(),
-    eventTime: v4.z.string().optional(),
-    serverTime: v4.z.string().optional(),
-    dsTenantId: v4.z.string().optional(),
-    dxiTenantId: v4.z.string().optional(),
-    serviceId: v4.z.string().optional(),
-    serviceInstanceId: v4.z.string().optional(),
-    componentName: v4.z.string().optional(),
-    clientIp: v4.z.string().optional(),
-    clientHostName: v4.z.string().optional(),
-    resource: v4.z.string().optional(),
-    action: v4.z.string().optional(),
-    result: v4.z.string().optional(),
-    oldValue: v4.z.unknown().optional(),
-    newValue: v4.z.unknown().optional(),
-    additionalInfo: v4.z.unknown().optional(),
-    eventId: v4.z.string().optional(),
-    userFirstName: v4.z.string().optional(),
-    userMiddleName: v4.z.string().optional(),
-    userLastName: v4.z.string().optional(),
-    userEmailAddress: v4.z.string().optional(),
+    userName: v4.z.string().optional().describe('Login/user name of the actor'),
+    eventTime: v4.z.string().optional().describe('Time the event occurred'),
+    serverTime: v4.z.string().optional().describe('Time the event was recorded server-side'),
+    dsTenantId: v4.z.string().optional().describe('DataStore tenant ID'),
+    dxiTenantId: v4.z.string().optional().describe('DXI tenant ID'),
+    serviceId: v4.z.string().optional().describe('ID of the service that emitted the event'),
+    serviceInstanceId: v4.z.string().optional().describe('Instance ID of the emitting service'),
+    componentName: v4.z.string().optional().describe('Component within the service'),
+    clientIp: v4.z.string().optional().describe('Source IP of the client'),
+    clientHostName: v4.z.string().optional().describe('Source host name of the client'),
+    resource: v4.z.string().optional().describe('Resource that was acted upon'),
+    action: v4.z.string().optional().describe('Action performed on the resource'),
+    result: v4.z.string().optional().describe('Outcome of the action'),
+    oldValue: v4.z.unknown().optional().describe('Prior value before the action'),
+    newValue: v4.z.unknown().optional().describe('New value after the action'),
+    additionalInfo: v4.z.unknown().optional().describe('Free-form supplementary context'),
+    eventId: v4.z.string().optional().describe('Unique identifier of the audit event'),
+    userFirstName: v4.z.string().optional().describe('Actor first name'),
+    userMiddleName: v4.z.string().optional().describe('Actor middle name'),
+    userLastName: v4.z.string().optional().describe('Actor last name'),
+    userEmailAddress: v4.z.string().optional().describe('Actor email address'),
 });
-const AuditQueryResponseSchema = v4.z.array(AuditRecordEsSchema);
+const AuditQueryResponseSchema = v4.z
+    .array(AuditRecordEsSchema)
+    .describe('Audit records matching the query');
 
 /**
  * Service for the DX SaaS DataStore audit API (`/audit/...`).
@@ -75559,32 +75899,42 @@ class DataStoreAuditService {
 }
 
 const ViewFilterLazy = v4.z.lazy(() => ViewFilterSchema);
+/** Matches every view. */
 const ViewAllFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('ALL'),
+    op: v4.z.literal('ALL').describe('Match all views'),
 });
+/** Matches views by ID. */
 const ViewIdFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('ID'),
-    ids: v4.z.array(v4.z.string()).optional(),
+    op: v4.z.literal('ID').describe('Match views by ID'),
+    ids: v4.z.array(v4.z.string()).optional().describe('View IDs to match'),
 });
+/** Matches only active views. */
 const ViewActiveFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('ACTIVE'),
+    op: v4.z.literal('ACTIVE').describe('Match only active views'),
 });
 const ViewAttributeExpressionSchema = v4.z.looseObject({
-    name: v4.z.string().optional(),
-    values: v4.z.array(v4.z.string()).optional(),
+    name: v4.z.string().optional().describe('Attribute name to match against'),
+    values: v4.z.array(v4.z.string()).optional().describe('Accepted values (set membership)'),
 });
+/** Matches views whose attributes satisfy the given expressions (AND-ed). */
 const ViewAttributeFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('ATTRIBUTE'),
-    expressions: v4.z.array(ViewAttributeExpressionSchema).optional(),
+    op: v4.z.literal('ATTRIBUTE').describe('Match views by attribute expressions'),
+    expressions: v4.z
+        .array(ViewAttributeExpressionSchema)
+        .optional()
+        .describe('Attribute predicates; all must match'),
 });
+/** Logical AND of nested view filters. */
 const ViewAndFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('AND'),
-    input: v4.z.array(ViewFilterLazy).optional(),
+    op: v4.z.literal('AND').describe('Logical AND of nested filters'),
+    input: v4.z.array(ViewFilterLazy).optional().describe('Child filters to AND together'),
 });
+/** Logical OR of nested view filters. */
 const ViewOrFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('OR'),
-    input: v4.z.array(ViewFilterLazy).optional(),
+    op: v4.z.literal('OR').describe('Logical OR of nested filters'),
+    input: v4.z.array(ViewFilterLazy).optional().describe('Child filters to OR together'),
 });
+/** Discriminated union of all view filter operators, keyed by `op`. */
 const ViewFilterSchema = v4.z.discriminatedUnion('op', [
     ViewAllFilterSchema,
     ViewIdFilterSchema,
@@ -75594,65 +75944,77 @@ const ViewFilterSchema = v4.z.discriminatedUnion('op', [
     ViewOrFilterSchema,
 ]);
 
-const ViewAccessRoleSchema = v4.z.enum(['read-only', 'read-write']);
+/** Access role granted to a user or group on a view. */
+const ViewAccessRoleSchema = v4.z
+    .enum(['read-only', 'read-write'])
+    .describe('Access level granted on a view');
 const ViewAccessEntrySchema = v4.z.looseObject({
-    name: v4.z.string(),
-    role: ViewAccessRoleSchema.optional(),
+    name: v4.z.string().describe('User or group name being granted access'),
+    role: ViewAccessRoleSchema.optional().describe('Granted role; defaults to read-only'),
 });
 const ViewAccessSchema = v4.z.looseObject({
-    users: v4.z.array(ViewAccessEntrySchema).optional(),
-    groups: v4.z.array(ViewAccessEntrySchema).optional(),
+    users: v4.z.array(ViewAccessEntrySchema).optional().describe('Per-user access grants'),
+    groups: v4.z.array(ViewAccessEntrySchema).optional().describe('Per-group access grants'),
 });
 const ViewTasSpecSchema = v4.z.looseObject({
-    filter: TasFilterSchema.optional(),
+    filter: TasFilterSchema.optional().describe('TAS filter scoping the topology this view exposes'),
 });
 const ViewNassSpecSchema = v4.z.looseObject({
-    filter: v4.z.unknown().optional(),
+    filter: v4.z.unknown().optional().describe('NASS filter scoping the metrics this view exposes'),
 });
 const ViewSpecsSchema = v4.z.looseObject({
-    tas: ViewTasSpecSchema.optional(),
-    nass: ViewNassSpecSchema.optional(),
+    tas: ViewTasSpecSchema.optional().describe('Topology (TAS) scoping for the view'),
+    nass: ViewNassSpecSchema.optional().describe('Metrics (NASS) scoping for the view'),
 });
-const ViewOwnerSchema = v4.z.enum(['APM', 'DP', 'OI']);
+/** Product that owns the view. */
+const ViewOwnerSchema = v4.z
+    .enum(['APM', 'DP', 'OI'])
+    .describe('Owning product (APM, DP, OI)');
 const ViewAttributesSchema = v4.z.looseObject({
-    label: v4.z.string().optional(),
-    description: v4.z.string().optional(),
-    owner: ViewOwnerSchema.optional(),
+    label: v4.z.string().optional().describe('Human-readable view label'),
+    description: v4.z.string().optional().describe('View description'),
+    owner: ViewOwnerSchema.optional().describe('Owning product'),
 });
 const ViewBodySchema = v4.z.looseObject({
-    access: ViewAccessSchema.optional(),
-    views: ViewSpecsSchema.optional(),
-    attributes: ViewAttributesSchema.optional(),
+    access: ViewAccessSchema.optional().describe('Access grants for the view'),
+    views: ViewSpecsSchema.optional().describe('TAS/NASS scoping specs for the view'),
+    attributes: ViewAttributesSchema.optional().describe('View metadata (label, description, owner)'),
 });
 const SetDefaultViewRequestSchema = v4.z.looseObject({
-    userName: v4.z.string(),
-    defaultViews: v4.z.union([v4.z.string(), v4.z.array(v4.z.string())]).optional(),
+    userName: v4.z.string().describe('User whose default view(s) are being set'),
+    defaultViews: v4.z
+        .union([v4.z.string(), v4.z.array(v4.z.string())])
+        .optional()
+        .describe('View ID, or list of view IDs, to set as the user default'),
 });
 const ViewSearchRequestSchema = v4.z.looseObject({
-    user: v4.z.string(),
-    groups: v4.z.array(v4.z.string()).optional(),
-    minimalRules: v4.z.unknown().optional(),
-    viewId: v4.z.string().optional(),
+    user: v4.z.string().describe('User to resolve accessible views for'),
+    groups: v4.z.array(v4.z.string()).optional().describe('Groups the user belongs to (widen access resolution)'),
+    minimalRules: v4.z.unknown().optional().describe('Optional minimal-rules payload for access resolution'),
+    viewId: v4.z.string().optional().describe('Restrict the search to a single view ID'),
 });
 const ViewQueryRequestSchema = v4.z.looseObject({
-    filter: ViewFilterSchema.optional(),
+    filter: ViewFilterSchema.optional().describe('Filter selecting which views to return; omit for all'),
 });
 
 const ViewResponseSchema = v4.z.looseObject({
-    viewId: v4.z.string().optional(),
-    access: ViewAccessSchema.optional(),
-    views: ViewSpecsSchema.optional(),
-    attributes: ViewAttributesSchema.optional(),
+    viewId: v4.z.string().optional().describe('Server-assigned view identifier'),
+    access: ViewAccessSchema.optional().describe('Access grants on the view'),
+    views: ViewSpecsSchema.optional().describe('TAS/NASS scoping specs of the view'),
+    attributes: ViewAttributesSchema.optional().describe('View metadata (label, description, owner)'),
 });
-const ViewListResponseSchema = v4.z.array(ViewResponseSchema);
+const ViewListResponseSchema = v4.z
+    .array(ViewResponseSchema)
+    .describe('All views returned by a list call');
 const ViewQueryResponseSchema = v4.z.looseObject({
-    views: v4.z.array(ViewResponseSchema).optional(),
+    views: v4.z.array(ViewResponseSchema).optional().describe('Views matching the query filter'),
 });
 const DefaultViewsResponseSchema = v4.z.looseObject({
-    userName: v4.z.string().optional(),
+    userName: v4.z.string().optional().describe('User the defaults belong to'),
     defaultViews: v4.z
         .union([v4.z.string(), v4.z.array(v4.z.string())])
-        .optional(),
+        .optional()
+        .describe("The user's default view ID, or list of IDs"),
 });
 
 /**
@@ -75789,129 +76151,6 @@ class DataStoreAuthViewsService {
     }
 }
 
-const BlobAttributeExpressionSchema = v4.z.looseObject({
-    name: v4.z.string(),
-    values: v4.z.array(v4.z.string()).optional(),
-});
-const BlobAllFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('ALL'),
-});
-const BlobAttributeFilterSchema = v4.z.looseObject({
-    op: v4.z.literal('ATTRIBUTE'),
-    expressions: v4.z.array(BlobAttributeExpressionSchema).optional(),
-});
-const BlobFilterSchema = v4.z.discriminatedUnion('op', [
-    BlobAllFilterSchema,
-    BlobAttributeFilterSchema,
-]);
-
-const BlobAttributesSchema = v4.z.record(v4.z.string(), v4.z.union([v4.z.string(), v4.z.number(), v4.z.boolean()]));
-/** Query params used by `POST /blobstorage/blob` and `DELETE /blobstorage/blob`. */
-v4.z.looseObject({
-    schema: v4.z.string(),
-    id: v4.z.string(),
-    ttl: v4.z.union([v4.z.string(), v4.z.number()]).optional(),
-});
-const BlobBulkItemSchema = v4.z.looseObject({
-    schema: v4.z.string(),
-    id: v4.z.string(),
-    ttl: v4.z.union([v4.z.string(), v4.z.number()]),
-    data: v4.z.string(),
-    attributes: BlobAttributesSchema.optional(),
-});
-const BlobBulkStoreRequestSchema = v4.z.looseObject({
-    blobs: v4.z.array(BlobBulkItemSchema),
-});
-v4.z.looseObject({
-    schema: v4.z.string(),
-    id: v4.z.string(),
-    version: v4.z.number().optional(),
-});
-const BlobQueryRequestSchema = v4.z.looseObject({
-    schema: v4.z.string(),
-    filter: BlobFilterSchema.optional(),
-    includeData: v4.z.boolean().optional(),
-    includeProfile: v4.z.boolean().optional(),
-});
-v4.z.looseObject({
-    schema: v4.z.string(),
-    id: v4.z.string(),
-});
-const BlobBulkDeleteEntrySchema = v4.z.looseObject({
-    schema: v4.z.string(),
-    id: v4.z.string(),
-});
-const BlobBulkDeleteRequestSchema = v4.z.looseObject({
-    blobs: v4.z.array(BlobBulkDeleteEntrySchema),
-});
-v4.z.looseObject({});
-const BlobAsyncDeleteSchemaCommandSchema = v4.z.looseObject({
-    op: v4.z.literal('DELETE_SCHEMA'),
-    schema: v4.z.string(),
-});
-const BlobAsyncCommandSchema = v4.z.discriminatedUnion('op', [
-    BlobAsyncDeleteSchemaCommandSchema,
-]);
-const BlobExecuteAsyncRequestSchema = v4.z.looseObject({
-    commands: v4.z.array(BlobAsyncCommandSchema),
-});
-const BlobAsyncResultRequestSchema = v4.z.looseObject({
-    correlationKey: v4.z.string(),
-});
-
-const BlobMetadataSchema = v4.z.looseObject({
-    schema: v4.z.string().optional(),
-    id: v4.z.string().optional(),
-    ttl: v4.z.string().optional(),
-    attributes: BlobAttributesSchema.optional(),
-    version: v4.z.number().optional(),
-    data: v4.z.string().optional(),
-});
-const BlobStoreResponseSchema = BlobMetadataSchema;
-const BlobBulkStoreResponseSchema = v4.z.looseObject({
-    blobs: v4.z.array(BlobMetadataSchema).optional(),
-    failed: v4.z.array(BlobMetadataSchema).optional(),
-});
-const BlobQueryResponseSchema = v4.z.looseObject({
-    blobs: v4.z.array(BlobMetadataSchema).optional(),
-});
-const BlobDeleteResponseSchema = v4.z.looseObject({
-    blob: BlobMetadataSchema.optional(),
-});
-const BlobBulkDeleteResponseSchema = v4.z.looseObject({
-    deletedBlobs: v4.z.array(BlobMetadataSchema).optional(),
-});
-const BlobSchemaItemSchema = v4.z.looseObject({
-    name: v4.z.string().optional(),
-});
-const BlobSchemaListResponseSchema = v4.z.looseObject({
-    schemas: v4.z.array(BlobSchemaItemSchema).optional(),
-});
-const BlobExecuteAsyncResponseSchema = v4.z.looseObject({
-    correlationKey: v4.z.string().optional(),
-});
-v4.z.enum([
-    'PENDING',
-    'RUNNING',
-    'FINISHED',
-    'FAILED',
-]);
-const BlobDeleteSchemaResultSchema = v4.z.looseObject({
-    schema: v4.z.string().optional(),
-    deletedBlobs: v4.z.number().optional(),
-});
-const BlobAsyncResultEntrySchema = v4.z.looseObject({
-    op: v4.z.string().optional(),
-    deletedSchema: BlobDeleteSchemaResultSchema.optional(),
-});
-const BlobAsyncResultResponseSchema = v4.z.looseObject({
-    correlationKey: v4.z.string().optional(),
-    state: v4.z.string().optional(),
-    numberOfDone: v4.z.number().optional(),
-    numberOfRemaining: v4.z.number().optional(),
-    results: v4.z.record(v4.z.string(), BlobAsyncResultEntrySchema).optional(),
-});
-
 /**
  * Service for the DX SaaS DataStore blob storage API
  * (`/blobstorage/...`).
@@ -76071,87 +76310,95 @@ class DataStoreBlobStorageService {
     }
 }
 
-const FeatureFieldTypeSchema = v4.z.enum([
-    'TEXT',
-    'NUMBER',
-    'LOOKUP',
-    'DATETIME',
-]);
+/** Editor type for a feature field. */
+const FeatureFieldTypeSchema = v4.z
+    .enum(['TEXT', 'NUMBER', 'LOOKUP', 'DATETIME'])
+    .describe('Field value type / editor (TEXT, NUMBER, LOOKUP, DATETIME)');
 const FeatureFieldSchema = v4.z.looseObject({
-    id: v4.z.string(),
-    name: v4.z.string().optional(),
-    type: FeatureFieldTypeSchema.optional(),
+    id: v4.z.string().describe('Stable field identifier'),
+    name: v4.z.string().optional().describe('Human-readable field label'),
+    type: FeatureFieldTypeSchema.optional().describe('Field value type; defaults to TEXT'),
 });
-const FeatureFilterTemplateTypeSchema = v4.z.enum([
-    'TAS',
-    'NASS',
-    'ES',
-    'REST',
-]);
+/** Backing datasource type a feature filter template targets. */
+const FeatureFilterTemplateTypeSchema = v4.z
+    .enum(['TAS', 'NASS', 'ES', 'REST'])
+    .describe('Datasource the template queries (TAS, NASS, ES, REST)');
 const FeatureFilterTemplateSchema = v4.z.looseObject({
-    type: FeatureFilterTemplateTypeSchema.optional(),
-    filter: v4.z.unknown().optional(),
-    indexPattern: v4.z.string().optional(),
-    query: v4.z.unknown().optional(),
+    type: FeatureFilterTemplateTypeSchema.optional().describe('Datasource type this template targets'),
+    filter: v4.z.unknown().optional().describe('Datasource-specific filter payload'),
+    indexPattern: v4.z.string().optional().describe('ES index pattern, when type is ES'),
+    query: v4.z.unknown().optional().describe('Raw query payload passed through to the datasource'),
 });
 const FeatureDatascopeLazy = v4.z.lazy(() => FeatureDatascopeSchema);
 const FeatureDatascopeSchema = v4.z.looseObject({
-    id: v4.z.string(),
-    datascopeItemName: v4.z.string().optional(),
-    datasourceType: FeatureFilterTemplateTypeSchema.optional(),
-    url: v4.z.string().optional(),
-    fields: v4.z.array(FeatureFieldSchema).optional(),
-    filterTemplate: FeatureFilterTemplateSchema.optional(),
-    children: v4.z.array(FeatureDatascopeLazy).optional(),
+    id: v4.z.string().describe('Stable datascope identifier'),
+    datascopeItemName: v4.z.string().optional().describe('Human-readable datascope name'),
+    datasourceType: FeatureFilterTemplateTypeSchema.optional().describe('Datasource backing this datascope'),
+    url: v4.z.string().optional().describe('Endpoint URL for REST-backed datascopes'),
+    fields: v4.z.array(FeatureFieldSchema).optional().describe('Fields exposed by this datascope'),
+    filterTemplate: FeatureFilterTemplateSchema.optional().describe('Default filter template for this datascope'),
+    children: v4.z.array(FeatureDatascopeLazy).optional().describe('Nested child datascopes (recursive tree)'),
 });
 const FeatureAttributesSchema = v4.z
     .looseObject({
-    name: v4.z.string().optional(),
-    description: v4.z.string().optional(),
-    sort: v4.z.number().optional(),
-    global: v4.z.boolean().optional(),
-    path: v4.z.string().optional(),
-    _UPDATED_AT: v4.z.number().optional(),
-    _UPDATED_BY: v4.z.string().optional(),
+    name: v4.z.string().optional().describe('Feature display name'),
+    description: v4.z.string().optional().describe('Feature description'),
+    sort: v4.z.number().optional().describe('Sort order among sibling features'),
+    global: v4.z.boolean().optional().describe('Whether the feature is global (visible across the tenant)'),
+    path: v4.z.string().optional().describe('Materialized tree path of the feature node'),
+    _UPDATED_AT: v4.z.number().optional().describe('Last-modified timestamp (epoch ms)'),
+    _UPDATED_BY: v4.z.string().optional().describe('User who last modified the feature'),
 })
     .catchall(v4.z.unknown());
 const FeatureNodeLazy = v4.z.lazy(() => FeatureNodeSchema);
 const FeatureNodeSchema = v4.z.looseObject({
-    id: v4.z.string(),
-    disabled: v4.z.boolean().optional(),
-    lastModificationTimestamp: v4.z.number().optional(),
-    attributes: FeatureAttributesSchema.optional(),
-    apis: v4.z.array(v4.z.string()).optional(),
-    children: v4.z.array(FeatureNodeLazy).optional(),
-    datascopes: v4.z.array(FeatureDatascopeSchema).optional(),
+    id: v4.z.string().describe('Stable feature node identifier'),
+    disabled: v4.z.boolean().optional().describe('Whether the feature node is disabled'),
+    lastModificationTimestamp: v4.z.number().optional().describe('Last modification time (epoch ms)'),
+    attributes: FeatureAttributesSchema.optional().describe('Feature metadata attributes'),
+    apis: v4.z.array(v4.z.string()).optional().describe('API identifiers this feature exposes'),
+    children: v4.z.array(FeatureNodeLazy).optional().describe('Nested child feature nodes (recursive tree)'),
+    datascopes: v4.z.array(FeatureDatascopeSchema).optional().describe('Datascopes attached to this feature node'),
 });
 
+/** Store request — a full {@link FeatureNodeSchema} tree to upsert. */
 const FeatureStoreRequestSchema = FeatureNodeSchema;
 const FeatureDeleteRequestSchema = v4.z.looseObject({
-    ids: v4.z.array(v4.z.string()),
+    ids: v4.z.array(v4.z.string()).describe('Feature node IDs to delete'),
 });
 v4.z.looseObject({
-    op: v4.z.literal('ID'),
-    ids: v4.z.array(v4.z.string()).optional(),
+    op: v4.z.literal('ID').describe('Filter operator — selects feature nodes by ID'),
+    ids: v4.z.array(v4.z.string()).optional().describe('Feature node IDs to match'),
 });
+/**
+ * Feature query filter. `op` names the operator; the AND-ed second half carries
+ * the operands (`ids` for an ID filter, `input` for composite operators).
+ */
 const FeatureFilterSchema = v4.z
     .looseObject({
-    op: v4.z.string(),
+    op: v4.z.string().describe('Filter operator (e.g. ID, AND, OR)'),
 })
     .and(v4.z
     .looseObject({
-    ids: v4.z.array(v4.z.string()).optional(),
-    input: v4.z.array(v4.z.unknown()).optional(),
+    ids: v4.z.array(v4.z.string()).optional().describe('Feature node IDs (for ID filters)'),
+    input: v4.z.array(v4.z.unknown()).optional().describe('Nested operand filters (for composite operators)'),
 })
     .partial());
 const FeatureQueryRequestSchema = v4.z.looseObject({
-    filter: FeatureFilterSchema.optional(),
+    filter: FeatureFilterSchema.optional().describe('Filter selecting which feature nodes to return; omit for all'),
 });
-const FeatureToggleListSchema = v4.z.array(v4.z.string());
+const FeatureToggleListSchema = v4.z
+    .array(v4.z.string())
+    .describe('List of feature toggle identifiers');
 
+/** Store response — the persisted {@link FeatureNodeSchema} tree. */
 const FeatureStoreResponseSchema = FeatureNodeSchema;
-const FeatureListResponseSchema = v4.z.array(FeatureNodeSchema);
-const FeatureToggleListResponseSchema = v4.z.array(v4.z.string());
+const FeatureListResponseSchema = v4.z
+    .array(FeatureNodeSchema)
+    .describe('Feature nodes matching the query');
+const FeatureToggleListResponseSchema = v4.z
+    .array(v4.z.string())
+    .describe('Enabled feature toggle identifiers');
 
 /**
  * Service for the DX SaaS DataStore features API (`/features/...`).
@@ -76456,98 +76703,105 @@ class DataStoreNASSQLService {
     }
 }
 
-const VertexStateProjectionSchema = v4.z.enum([
-    'DETAILED',
-    'BRIEF',
-    'EXTRA_IDS',
-]);
+/** Projection level controlling how much detail each returned state carries. */
+const VertexStateProjectionSchema = v4.z
+    .enum(['DETAILED', 'BRIEF', 'EXTRA_IDS'])
+    .describe('Response detail level (DETAILED, BRIEF, EXTRA_IDS)');
+/** External-ID coordinates identifying a state by vertex/alert/metric. */
 const VertexStateExternalIdInputSchema = v4.z.looseObject({
-    vertexId: v4.z.number().optional(),
-    vertexExternalId: v4.z.string().optional(),
-    alert: v4.z.string().optional(),
-    alertExternalId: v4.z.string().optional(),
-    metric: v4.z.string().optional(),
-    metricExternalId: v4.z.string().optional(),
+    vertexId: v4.z.number().optional().describe('Internal vertex ID'),
+    vertexExternalId: v4.z.string().optional().describe('External vertex ID'),
+    alert: v4.z.string().optional().describe('Alert identifier'),
+    alertExternalId: v4.z.string().optional().describe('External alert identifier'),
+    metric: v4.z.string().optional().describe('Metric identifier'),
+    metricExternalId: v4.z.string().optional().describe('External metric identifier'),
 });
+/** A single state to store. Identify the target by internal IDs or external coordinates. */
 const VertexStateInputSchema = v4.z.looseObject({
-    stateExternalId: VertexStateExternalIdInputSchema.optional(),
-    vertexId: v4.z.number().optional(),
-    alertId: v4.z.number().optional(),
-    metricId: v4.z.number().optional(),
-    startTime: v4.z.number().optional(),
-    endTime: v4.z.number().optional(),
-    status: v4.z.number().optional(),
-    data: v4.z.unknown().optional(),
+    stateExternalId: VertexStateExternalIdInputSchema.optional().describe('External coordinates of the state'),
+    vertexId: v4.z.number().optional().describe('Internal vertex ID the state belongs to'),
+    alertId: v4.z.number().optional().describe('Internal alert ID the state belongs to'),
+    metricId: v4.z.number().optional().describe('Internal metric ID the state belongs to'),
+    startTime: v4.z.number().optional().describe('State start time (epoch ms)'),
+    endTime: v4.z.number().optional().describe('State end time (epoch ms)'),
+    status: v4.z.number().optional().describe('State status code'),
+    data: v4.z.unknown().optional().describe('Opaque state payload'),
 });
 const VertexStateStoreRequestSchema = v4.z.looseObject({
-    states: v4.z.array(VertexStateInputSchema),
+    states: v4.z.array(VertexStateInputSchema).describe('States to store'),
 });
 const VertexStateFetchRequestSchema = v4.z.looseObject({
-    filter: VertexStateFilterSchema.optional(),
-    time: v4.z.number().optional(),
-    projection: VertexStateProjectionSchema.optional(),
-    flushCacheBeforeQuery: v4.z.boolean().optional(),
-    version: v4.z.string().nullable().optional(),
-    includeAllTouchedVertexStates: v4.z.boolean().optional(),
+    filter: VertexStateFilterSchema.optional().describe('Filter selecting which states to fetch'),
+    time: v4.z.number().optional().describe('Point in time to evaluate state at (epoch ms); default now'),
+    projection: VertexStateProjectionSchema.optional().describe('Response detail level'),
+    flushCacheBeforeQuery: v4.z.boolean().optional().describe('Force a cache flush before evaluating (slower, freshest)'),
+    version: v4.z.string().nullable().optional().describe('Client-held version for delta fetches; null for a full fetch'),
+    includeAllTouchedVertexStates: v4.z
+        .boolean()
+        .optional()
+        .describe('Include states for every vertex touched, not just those matching the filter'),
 });
+/** Down-sampling settings for range queries that would otherwise return too many points. */
 const VertexStateClampSettingSchema = v4.z.looseObject({
-    clampThreshold: v4.z.number().optional(),
-    bucketCount: v4.z.number().optional(),
-    bucketSize: v4.z.number().optional(),
+    clampThreshold: v4.z.number().optional().describe('Point count above which clamping/bucketing kicks in'),
+    bucketCount: v4.z.number().optional().describe('Number of buckets to down-sample into'),
+    bucketSize: v4.z.number().optional().describe('Bucket width in ms (alternative to bucketCount)'),
 });
 const VertexStateRangeRequestSchema = v4.z.looseObject({
-    filter: VertexStateFilterSchema.optional(),
-    startTime: v4.z.number().optional(),
-    endTime: v4.z.number().optional(),
-    projection: VertexStateProjectionSchema.optional(),
-    viewPortStart: v4.z.number().optional(),
-    viewPortEnd: v4.z.number().optional(),
-    clampSetting: VertexStateClampSettingSchema.optional(),
-    flushCacheBeforeQuery: v4.z.boolean().optional(),
+    filter: VertexStateFilterSchema.optional().describe('Filter selecting which states to fetch'),
+    startTime: v4.z.number().optional().describe('Inclusive start of the time range (epoch ms)'),
+    endTime: v4.z.number().optional().describe('Inclusive end of the time range (epoch ms)'),
+    projection: VertexStateProjectionSchema.optional().describe('Response detail level'),
+    viewPortStart: v4.z.number().optional().describe('Visible viewport start (epoch ms), for clamp bucketing'),
+    viewPortEnd: v4.z.number().optional().describe('Visible viewport end (epoch ms), for clamp bucketing'),
+    clampSetting: VertexStateClampSettingSchema.optional().describe('Down-sampling settings for large ranges'),
+    flushCacheBeforeQuery: v4.z.boolean().optional().describe('Force a cache flush before evaluating'),
 });
+/** Republish reuses the fetch request shape — same filter/projection options. */
 const VertexStateRepublishRequestSchema = VertexStateFetchRequestSchema;
 
 const VertexStateExternalIdResponseSchema = v4.z.looseObject({
-    vertexId: v4.z.number().optional(),
-    vertexExternalId: v4.z.string().optional(),
-    alert: v4.z.string().optional(),
-    alertExternalId: v4.z.string().optional(),
-    metric: v4.z.string().optional(),
-    metricExternalId: v4.z.string().optional(),
+    vertexId: v4.z.number().optional().describe('Internal vertex ID'),
+    vertexExternalId: v4.z.string().optional().describe('External vertex ID'),
+    alert: v4.z.string().optional().describe('Alert identifier'),
+    alertExternalId: v4.z.string().optional().describe('External alert identifier'),
+    metric: v4.z.string().optional().describe('Metric identifier'),
+    metricExternalId: v4.z.string().optional().describe('External metric identifier'),
 });
 const VertexStateResponseItemSchema = v4.z.looseObject({
-    vertexId: v4.z.number().optional(),
-    alertId: v4.z.number().optional(),
-    metricId: v4.z.number().optional(),
-    stateExternalId: VertexStateExternalIdResponseSchema.optional(),
-    status: v4.z.number().optional(),
-    data: v4.z.unknown().optional(),
-    startTime: v4.z.number().optional(),
-    endTime: v4.z.number().optional(),
+    vertexId: v4.z.number().optional().describe('Internal vertex ID the state belongs to'),
+    alertId: v4.z.number().optional().describe('Internal alert ID the state belongs to'),
+    metricId: v4.z.number().optional().describe('Internal metric ID the state belongs to'),
+    stateExternalId: VertexStateExternalIdResponseSchema.optional().describe('External coordinates of the state'),
+    status: v4.z.number().optional().describe('State status code'),
+    data: v4.z.unknown().optional().describe('Opaque state payload'),
+    startTime: v4.z.number().optional().describe('State start time (epoch ms)'),
+    endTime: v4.z.number().optional().describe('State end time (epoch ms)'),
 });
+/** Per-group alert rollup produced by a COLLECT_GROUPS filter. */
 const VertexStateGroupResultSchema = v4.z.looseObject({
-    groupName: v4.z.string().optional(),
-    alerts: v4.z.number().optional(),
-    cautionAlerts: v4.z.number().optional(),
-    dangerAlert: v4.z.number().optional(),
+    groupName: v4.z.string().optional().describe('Name of the vertex group'),
+    alerts: v4.z.number().optional().describe('Total alerting states in the group'),
+    cautionAlerts: v4.z.number().optional().describe('States at caution severity'),
+    dangerAlert: v4.z.number().optional().describe('States at danger severity'),
 });
 const VertexStateAnalyticResultSchema = v4.z.looseObject({
-    t: v4.z.string().optional(),
-    groups: v4.z.array(VertexStateGroupResultSchema).optional(),
+    t: v4.z.string().optional().describe('Analytic type/tag identifier'),
+    groups: v4.z.array(VertexStateGroupResultSchema).optional().describe('Per-group status rollups'),
 });
 const VertexStateStoreResponseSchema = v4.z.looseObject({
-    updated: v4.z.number().optional(),
-    errors: v4.z.number().optional(),
-    mappingErrors: v4.z.number().optional(),
+    updated: v4.z.number().optional().describe('Number of states successfully stored/updated'),
+    errors: v4.z.number().optional().describe('Number of states that failed to store'),
+    mappingErrors: v4.z.number().optional().describe('Number of states whose external IDs could not be resolved'),
 });
 const VertexStateFetchResponseSchema = v4.z.looseObject({
-    states: v4.z.array(VertexStateResponseItemSchema).optional(),
-    analyticResult: v4.z.array(VertexStateAnalyticResultSchema).optional(),
-    version: v4.z.string().optional(),
+    states: v4.z.array(VertexStateResponseItemSchema).optional().describe('Matched states'),
+    analyticResult: v4.z.array(VertexStateAnalyticResultSchema).optional().describe('Group/status analytics, if requested'),
+    version: v4.z.string().optional().describe('Server version token to pass back for the next delta fetch'),
 });
 const VertexStateRangeResponseSchema = v4.z.looseObject({
-    states: v4.z.array(VertexStateResponseItemSchema).optional(),
-    analyticResult: v4.z.array(VertexStateAnalyticResultSchema).optional(),
+    states: v4.z.array(VertexStateResponseItemSchema).optional().describe('Matched states across the time range'),
+    analyticResult: v4.z.array(VertexStateAnalyticResultSchema).optional().describe('Group/status analytics, if requested'),
 });
 
 /**
@@ -76851,33 +77105,51 @@ class DataStoreTASService {
     }
 }
 
+/** Free-form string→string metadata attached to a token (values may be null). */
 const TokenMetadataSchema = v4.z
     .record(v4.z.string(), v4.z.union([v4.z.string(), v4.z.null()]))
-    .optional();
+    .optional()
+    .describe('Arbitrary string metadata stored with the token (values may be null)');
+/** Session validation takes no body — the session cookie/header carries identity. */
 const SessionValidateRequestSchema = v4.z.looseObject({});
+/** Token verification takes no body — the token is supplied via header. */
 const TokenVerifyRequestSchema = v4.z.looseObject({});
 const TokenGetAndVerifyRequestSchema = v4.z.looseObject({
-    tokenId: v4.z.string(),
+    tokenId: v4.z.string().describe('ID of the token to fetch and verify'),
 });
+/**
+ * Paged token listing. `query` (free-text) and `filter` (structured) are
+ * mutually exclusive — supplying both is rejected by the refinement.
+ */
 const TokenQueryRequestSchema = v4.z
     .looseObject({
-    pageSize: v4.z.number().optional(),
-    seekTokenId: v4.z.string().optional(),
-    query: v4.z.string().optional(),
-    filter: v4.z.unknown().optional(),
+    pageSize: v4.z.number().optional().describe('Maximum number of tokens per page'),
+    seekTokenId: v4.z.string().optional().describe('Cursor — return tokens after this token ID'),
+    query: v4.z.string().optional().describe('Free-text search (mutually exclusive with `filter`)'),
+    filter: v4.z.unknown().optional().describe('Structured filter (mutually exclusive with `query`)'),
 })
     .refine((value) => !(value.query !== undefined && value.filter !== undefined), {
     message: '`query` and `filter` are mutually exclusive on /tenants/token/query',
 });
-const ttlField = v4.z.number().optional();
+const ttlField = v4.z
+    .number()
+    .optional()
+    .describe('Token lifetime in seconds; omit for the server default');
 const CreateUserTokenRequestSchema = v4.z.looseObject({
     ttl: ttlField,
-    dynamicExpire: v4.z.boolean().optional(),
+    dynamicExpire: v4.z
+        .boolean()
+        .optional()
+        .describe('When true, sliding expiry — each use extends the token lifetime'),
     metadata: TokenMetadataSchema,
 });
 const UpdateUserTokenRequestSchema = v4.z.looseObject({
-    tokenId: v4.z.string(),
-    dynamicExpireTime: v4.z.number().nullable().optional(),
+    tokenId: v4.z.string().describe('ID of the token to update'),
+    dynamicExpireTime: v4.z
+        .number()
+        .nullable()
+        .optional()
+        .describe('New sliding-expiry window in seconds; null clears it'),
     metadata: TokenMetadataSchema,
 });
 const CreateAgentTokenRequestSchema = v4.z.looseObject({
@@ -76885,73 +77157,82 @@ const CreateAgentTokenRequestSchema = v4.z.looseObject({
     metadata: TokenMetadataSchema,
 });
 const UpdateAgentTokenRequestSchema = v4.z.looseObject({
-    tokenId: v4.z.string(),
+    tokenId: v4.z.string().describe('ID of the agent token to update'),
     metadata: TokenMetadataSchema,
 });
 const CreateTenantTokenRequestSchema = v4.z.looseObject({
-    tenantId: v4.z.number().optional(),
+    tenantId: v4.z.number().optional().describe('Numeric tenant ID the token is scoped to'),
     ttl: ttlField,
     metadata: TokenMetadataSchema,
 });
 const UpdateTenantTokenRequestSchema = v4.z.looseObject({
-    tokenId: v4.z.string(),
-    dynamicExpireTime: v4.z.number().nullable().optional(),
+    tokenId: v4.z.string().describe('ID of the tenant token to update'),
+    dynamicExpireTime: v4.z
+        .number()
+        .nullable()
+        .optional()
+        .describe('New sliding-expiry window in seconds; null clears it'),
     metadata: TokenMetadataSchema,
 });
 const CreateInternalTokenRequestSchema = v4.z.looseObject({
-    product: v4.z.string(),
+    product: v4.z.string().describe('Product the internal token is issued for'),
     ttl: ttlField,
     metadata: TokenMetadataSchema,
 });
 const RevokeTokenRequestSchema = v4.z.looseObject({
-    revokeToken: v4.z.string(),
-    delete: v4.z.boolean().optional(),
+    revokeToken: v4.z.string().describe('The token (or token ID) to revoke'),
+    delete: v4.z.boolean().optional().describe('When true, also delete the token rather than only revoking it'),
 });
 const CancelRevokeRequestSchema = v4.z.looseObject({
-    revokeToken: v4.z.string(),
+    revokeToken: v4.z.string().describe('The token (or token ID) whose pending revocation to cancel'),
 });
 const DeleteTokenRequestSchema = v4.z.looseObject({
-    tokenId: v4.z.string(),
+    tokenId: v4.z.string().describe('ID of the token to delete'),
 });
 const ImportTokenRequestSchema = v4.z.looseObject({
-    token: v4.z.string(),
+    token: v4.z.string().describe('Raw token string to import into the store'),
 });
 
 const SessionValidateResponseSchema = v4.z.looseObject({
-    tenantId: v4.z.number().optional(),
-    userId: v4.z.string().optional(),
-    externalTenantId: v4.z.string().optional(),
-    cohort: v4.z.string().optional(),
-    role: v4.z.string().optional(),
-    authToken: v4.z.string().optional(),
-    groups: v4.z.array(v4.z.string()).nullable().optional(),
+    tenantId: v4.z.number().optional().describe('Numeric tenant ID resolved from the session'),
+    userId: v4.z.string().optional().describe('User ID resolved from the session'),
+    externalTenantId: v4.z.string().optional().describe('External (customer-facing) tenant identifier'),
+    cohort: v4.z.string().optional().describe('Cohort the tenant belongs to'),
+    role: v4.z.string().optional().describe("User's role within the tenant"),
+    authToken: v4.z.string().optional().describe('Auth token minted for the validated session'),
+    groups: v4.z.array(v4.z.string()).nullable().optional().describe('Groups the user belongs to'),
 });
 const TokenDetailsSchema = v4.z.looseObject({
-    id: v4.z.string().optional(),
-    prefix: v4.z.string().optional(),
-    revoked: v4.z.boolean().optional(),
-    internal: v4.z.boolean().optional(),
-    agent: v4.z.boolean().optional(),
-    createdAt: v4.z.number().optional(),
-    expireAt: v4.z.number().optional(),
-    tenantId: v4.z.number().optional(),
-    user: v4.z.string().nullable().optional(),
-    dynamicExpire: v4.z.boolean().optional(),
-    metadata: v4.z.record(v4.z.string(), v4.z.unknown()).nullable().optional(),
+    id: v4.z.string().optional().describe('Token ID'),
+    prefix: v4.z.string().optional().describe('Non-secret token prefix (safe to display)'),
+    revoked: v4.z.boolean().optional().describe('Whether the token has been revoked'),
+    internal: v4.z.boolean().optional().describe('Whether this is an internal (product) token'),
+    agent: v4.z.boolean().optional().describe('Whether this is an agent token'),
+    createdAt: v4.z.number().optional().describe('Creation time (epoch ms)'),
+    expireAt: v4.z.number().optional().describe('Expiry time (epoch ms)'),
+    tenantId: v4.z.number().optional().describe('Numeric tenant ID the token is scoped to'),
+    user: v4.z.string().nullable().optional().describe('User the token belongs to, if any'),
+    dynamicExpire: v4.z.boolean().optional().describe('Whether the token uses sliding expiry'),
+    metadata: v4.z
+        .record(v4.z.string(), v4.z.unknown())
+        .nullable()
+        .optional()
+        .describe('Arbitrary metadata stored with the token'),
 });
 const TokenQueryResponseSchema = v4.z.looseObject({
-    items: v4.z.array(TokenDetailsSchema).optional(),
-    nextPage: v4.z.boolean().optional(),
+    items: v4.z.array(TokenDetailsSchema).optional().describe('Tokens on this page'),
+    nextPage: v4.z.boolean().optional().describe('Whether more pages remain (seek with the last token ID)'),
 });
 const TokenCreateResponseSchema = v4.z.looseObject({
-    token: v4.z.string().optional(),
+    token: v4.z.string().optional().describe('The newly minted token string'),
 });
+/** Public-key response — an opaque JWK-style object; fields vary by key type. */
 const PublicKeyJsonResponseSchema = v4.z.looseObject({});
 const RevokeTokensResponseSchema = v4.z.looseObject({
-    revokedTokens: v4.z.array(v4.z.string()).optional(),
+    revokedTokens: v4.z.array(v4.z.string()).optional().describe('IDs of the tokens that were revoked'),
 });
 const DeleteTokensResponseSchema = v4.z.looseObject({
-    deletedTokens: v4.z.array(v4.z.string()).optional(),
+    deletedTokens: v4.z.array(v4.z.string()).optional().describe('IDs of the tokens that were deleted'),
 });
 
 /**
@@ -77211,10 +77492,22 @@ class DataStoreNASSService {
      * @param values - Array of {@link NassDatapoint} tuples. Each tuple must
      *   begin with a registered metric ID obtained from
      *   {@link DataStoreMetricsMetadataService.registerMetric}.
+     *
+     * @remarks The request is validated against {@link NassStoreRequestSchema}.
+     *   If the response fails schema validation, a warning is logged but the raw
+     *   API response is still returned.
+     *
+     * @throws ZodError if any datapoint fails schema validation.
      */
     async storeMetricValues(values) {
         const body = { values };
-        return this.dxSaasService.tenantPost('nass/metricValue/store', body);
+        NassStoreRequestSchema.parse(body);
+        const raw = await this.dxSaasService.tenantPost('nass/metricValue/store', body);
+        const result = NassStoreResponseSchema.safeParse(raw);
+        if (!result.success) {
+            this.log.warn('NassStoreResponse validation warning:', result.error.message);
+        }
+        return raw;
     }
 }
 
@@ -77311,7 +77604,39 @@ exports.AttributeService = AttributeService;
 exports.AttributeValueAsFieldSchema = AttributeValueAsFieldSchema;
 exports.AuthorizationService = AuthorizationService;
 exports.AxaService = AxaService;
+exports.BlobAllFilterSchema = BlobAllFilterSchema;
+exports.BlobAsyncCommandSchema = BlobAsyncCommandSchema;
+exports.BlobAsyncDeleteSchemaCommandSchema = BlobAsyncDeleteSchemaCommandSchema;
+exports.BlobAsyncResultEntrySchema = BlobAsyncResultEntrySchema;
+exports.BlobAsyncResultRequestSchema = BlobAsyncResultRequestSchema;
+exports.BlobAsyncResultResponseSchema = BlobAsyncResultResponseSchema;
+exports.BlobAsyncResultStateSchema = BlobAsyncResultStateSchema;
+exports.BlobAttributeExpressionSchema = BlobAttributeExpressionSchema;
+exports.BlobAttributeFilterSchema = BlobAttributeFilterSchema;
+exports.BlobAttributesSchema = BlobAttributesSchema;
+exports.BlobBulkDeleteEntrySchema = BlobBulkDeleteEntrySchema;
+exports.BlobBulkDeleteRequestSchema = BlobBulkDeleteRequestSchema;
+exports.BlobBulkDeleteResponseSchema = BlobBulkDeleteResponseSchema;
+exports.BlobBulkItemSchema = BlobBulkItemSchema;
+exports.BlobBulkStoreRequestSchema = BlobBulkStoreRequestSchema;
+exports.BlobBulkStoreResponseSchema = BlobBulkStoreResponseSchema;
+exports.BlobDeleteParamsSchema = BlobDeleteParamsSchema;
+exports.BlobDeleteResponseSchema = BlobDeleteResponseSchema;
+exports.BlobDeleteSchemaResultSchema = BlobDeleteSchemaResultSchema;
+exports.BlobExecuteAsyncRequestSchema = BlobExecuteAsyncRequestSchema;
+exports.BlobExecuteAsyncResponseSchema = BlobExecuteAsyncResponseSchema;
+exports.BlobFetchParamsSchema = BlobFetchParamsSchema;
+exports.BlobFileEnvelopeSchema = BlobFileEnvelopeSchema;
+exports.BlobFilterSchema = BlobFilterSchema;
+exports.BlobMetadataSchema = BlobMetadataSchema;
+exports.BlobQueryRequestSchema = BlobQueryRequestSchema;
+exports.BlobQueryResponseSchema = BlobQueryResponseSchema;
+exports.BlobSchemaItemSchema = BlobSchemaItemSchema;
+exports.BlobSchemaListRequestSchema = BlobSchemaListRequestSchema;
+exports.BlobSchemaListResponseSchema = BlobSchemaListResponseSchema;
 exports.BlobService = BlobService;
+exports.BlobStoreParamsSchema = BlobStoreParamsSchema;
+exports.BlobStoreResponseSchema = BlobStoreResponseSchema;
 exports.CalendarIntervalSchema = CalendarIntervalSchema;
 exports.ChannelService = ChannelService;
 exports.DEFAULT_EXPERIENCE_REQUEST_BODY = DEFAULT_EXPERIENCE_REQUEST_BODY;
@@ -77363,6 +77688,11 @@ exports.MetricRegisterSchema = MetricRegisterSchema;
 exports.MetricRegisterSourceSchema = MetricRegisterSourceSchema;
 exports.MetricTypeEnumNameSchema = MetricTypeEnumNameSchema;
 exports.NASSService = NASSService;
+exports.NassDatapointSchema = NassDatapointSchema;
+exports.NassExtensionDatapointSchema = NassExtensionDatapointSchema;
+exports.NassRegularDatapointSchema = NassRegularDatapointSchema;
+exports.NassStoreRequestSchema = NassStoreRequestSchema;
+exports.NassStoreResponseSchema = NassStoreResponseSchema;
 exports.NassValueTypeSchema = NassValueTypeSchema;
 exports.NotificationService = NotificationService;
 exports.NumericOperatorSchema = NumericOperatorSchema;