@dx-do/client 6.3.3 → 6.3.4

package/dist/index.esm.js

@@ -29300,12 +29300,15 @@ const QueryFilterPredicateSpecSchema = z.union([
 const QueryRangeSpecSchema = z.looseObject({
     endTime: z
         .number()
-        .describe('Absolute end time in ms since epoch; default `now`'),
+        .optional()
+        .describe('Absolute end time in ms since epoch; omit (or 0) for `now`'),
     rangeSize: z
         .number()
+        .optional()
         .describe('Window length in ms; `startTime = endTime - rangeSize`. Default 8 minutes'),
     frequency: z
         .number()
+        .optional()
         .describe('Initial NASS aggregation interval in ms; default 15s. Aggregator picked per metric type'),
 });
 /**
@@ -29956,6 +29959,41 @@ const QueryFromDataSpecSchema = z.looseObject({
     queryRange: QueryRangeSpecSchema.optional().describe('Time-window to fetch; defaults to pipeline range'),
     alias: z.string().optional().describe('Column namespace for output rows'),
 });
+/**
+ * `WQL` — source op that selects time-series via a single **WQL** expression
+ * instead of a Metrics Metadata `querySpecifier`. Like `FROM`, it produces
+ * data rows and is typically the first op in the pipeline.
+ *
+ * The `wql` string is parsed server-side (ANTLR `DXQueryCompiler`); we treat
+ * it as opaque here — no client-side grammar validation. Grammar:
+ *
+ *   `ts(<metric-name>[, <predicates>])`
+ *
+ * `<metric-name>` may be quoted or unquoted. `<predicates>` combine
+ * `attr=value` terms with `and` / `or` / `not`, grouping `( … )`, single- or
+ * double-quoted values, and `*` wildcards. Example:
+ *
+ *   `ts("CPU Time (ms)" and source="web-server-01" and not env="staging")`
+ *
+ * **Tenant gating**: requires the `DXDASHBOARDS_WQL_FEATURE` toggle; tenants
+ * without it return an error at run time.
+ */
+const QueryWqlSpecSchema = z.looseObject({
+    op: z.literal('WQL'),
+    wql: z
+        .string()
+        .min(1)
+        .describe('WQL expression selecting time-series. Grammar: `ts(<metric-name>[, <predicates>])` — name quoted or unquoted; predicates combine `attr=value` with `and`/`or`/`not`, grouping `( )`, quoted values, and `*` wildcards. E.g. `ts("CPU Time (ms)" and source="web-server-01")`. Server-parsed (ANTLR); required and non-empty.'),
+    clamp: z
+        .union([z.number(), z.string()])
+        .optional()
+        .describe('Cap on results; `0` = unlimited (default). Semantically an int, but the platform emits it on the wire as a numeric string (e.g. `"10000"`) — both forms accepted.'),
+    useAttributes: z
+        .boolean()
+        .optional()
+        .describe('When true, use metadata attributes in the WQL metadata query; omit to fall back to the tenant config default (`isMetadataQueryUsingAttributes`).'),
+    queryRange: QueryRangeSpecSchema.optional().describe('Time-window spec; defaults to the last 8 minutes ending now'),
+});
 /**
  * `JOIN_METADATA` — for each upstream row, look up zero or one
  * `MetricDescriptor` by the external ID in `externalIdColumn` and
@@ -30109,6 +30147,7 @@ const QueryFunctionSpecSchema = z.discriminatedUnion('op', [
     QueryFromMetadataSpecSchema,
     QueryFromTopologySpecSchema,
     QueryFromDataSpecSchema,
+    QueryWqlSpecSchema,
     QueryJoinMetadataSpecSchema,
     QueryJoinTopologySpecSchema,
     QueryLogSpecSchema,