@formant/formant-cli 0.4.3 → 0.4.5

package/README.md

@@ -39,8 +39,9 @@ This CLI provides programmatic access to all Formant capabilities:
 
 ### Telemetry Queries
 - Query historical sensor data (battery, temperature, position, custom metrics)
-- Retrieve latest values for any stream
-- Filter by time range and device
+- Retrieve latest values with `--latest-values-only`
+- Auto-discover all streams with `--all-streams`
+- Filter by time range, device, and stream type
 - Export data as JSON for analysis
 
 ### Telemetry Ingestion
@@ -258,15 +259,32 @@ fcli event get <event-id>                      # Get event details
 
 ### Query
 
-Retrieve historical telemetry and sensor data.
+Retrieve historical telemetry and sensor data. `--start` and `--end` are always required.
 
 ```bash
 # Historical data
 fcli query --device <device-id> --stream battery_level \
   --start 2026-01-01 --end 2026-01-02
 
-# Latest values
-fcli query latest-values --device <device-id> --stream battery_level
+# Multiple streams in one query
+fcli query --device <device-id> --stream heat.current --stream power.available \
+  --start 2026-02-01 --end 2026-02-20
+
+# Multiple devices in one query
+fcli query --device <id1> --device <id2> --stream battery_level \
+  --start 2026-02-01 --end 2026-02-20
+
+# Aggregated data (downsample to hourly)
+fcli query --device <device-id> --stream temperature \
+  --start 2026-01-01 --end 2026-02-01 --aggregate hour
+
+# Latest value per stream (within the time range)
+fcli query --device <device-id> --stream battery_level \
+  --start 2026-01-01 --end 2026-02-01 --latest-values-only
+
+# Auto-discover and query all streams on a device
+fcli query --device <device-id> --all-streams \
+  --start 2026-01-01 --end 2026-02-01 --latest-values-only
 
 # Common streams: battery_level, temperature, cpu_usage, memory_usage, location
 ```
@@ -486,6 +504,27 @@ spot.localization                 text          data    16962       2026-02-19T2
 spot.hand.image                   custom        config  —           —                         —
 ```
 
+```bash
+$ fcli query --device <device-id> --stream heat.current --stream power.available \
+    --start 2026-02-01 --end 2026-02-20 --dev
+
+Telemetry Data (dev environment):
+
+  Stream: heat.current (numeric)  Device: 01397354-d17a-4b53-ac27-61753de7918c
+  Points: 1
+
+TIME                        VALUE
+──────────────────────────────────────────────────────────────────────────────
+2026-02-18T21:15:38.491Z    47
+
+  Stream: power.available (numeric)  Device: 01397354-d17a-4b53-ac27-61753de7918c
+  Points: 1
+
+TIME                        VALUE
+──────────────────────────────────────────────────────────────────────────────
+2026-02-18T21:15:38.520Z    72
+```
+
 ### JSON
 
 Machine-readable JSON for scripting and automation:
@@ -557,8 +596,8 @@ fcli investigation trigger <investigation-id> --input "Device stopped responding
 # 3. Check investigation runs
 fcli investigation runs <investigation-id>
 
-# 4. Query relevant telemetry
-fcli query --device <device-id> --stream temperature \
+# 4. Query relevant telemetry (multiple streams and/or devices at once)
+fcli query --device <device-id> --stream temperature --stream battery_level \
   --start 2026-02-17T10:00:00Z --end 2026-02-17T12:00:00Z
 ```
 

package/dist/commands/query/index.d.ts

@@ -4,12 +4,14 @@ export default class Query extends BaseCommand<typeof Query> {
     static examples: string[];
     static flags: {
         aggregate: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        device: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        end: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        latest: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'all-streams': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        days: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        device: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        end: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'latest-values-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        start: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        stream: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        start: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        stream: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     static summary: string;

package/dist/commands/query/index.js

@@ -5,7 +5,11 @@ export default class Query extends BaseCommand {
     static description = `Query telemetry stream data for a device over a time range.
 
 Returns time-series datapoints for the specified stream(s). Supports aggregation
-for downsampling large datasets, and --latest to get only the most recent value.
+for downsampling large datasets, and --latest-values-only to get only the most recent value.
+
+Use --all-streams with --latest-values-only to automatically discover and query all
+streams — both from the device configuration and from actual ingested data
+(unconfigured streams included).
 
 Stream types: numeric, text, image, video, location, json, bitset, battery, health,
 "numeric set", "point cloud", localization, "transform tree", file.
@@ -15,7 +19,10 @@ hour, 4 hours, 12 hours, day, week, month, year.`;
     static examples = [
         '<%= config.bin %> query --device <id> --stream battery_level --start 2026-01-01 --end 2026-01-02',
         '<%= config.bin %> query --device <id> --stream speed --aggregate hour --start 2026-01-01 --end 2026-02-01',
-        '<%= config.bin %> query --device <id> --stream battery_level --latest',
+        '<%= config.bin %> query --device <id> --stream battery_level --stream temperature --start 2026-01-01 --end 2026-01-02',
+        '<%= config.bin %> query --device <id1> --device <id2> --stream battery_level --start 2026-01-01 --end 2026-01-02',
+        '<%= config.bin %> query --device <id> --stream battery_level --start 2026-01-01 --end 2026-02-01 --latest-values-only',
+        '<%= config.bin %> query --device <id> --all-streams --start 2026-01-01 --end 2026-02-01 --latest-values-only',
         '<%= config.bin %> query --device <id> --stream temperature --type numeric --json',
     ];
     static flags = {
@@ -23,15 +30,24 @@ hour, 4 hours, 12 hours, day, week, month, year.`;
             char: 'a',
             description: 'Aggregation level for downsampling',
         }),
+        'all-streams': Flags.boolean({
+            description: 'Query all streams for the device — from config and from ingested data (requires single --device and --latest-values-only)',
+        }),
+        days: Flags.integer({
+            default: 14,
+            description: 'How many days back to look for unconfigured streams when using --all-streams',
+        }),
         device: Flags.string({
             char: 'd',
-            description: 'Device ID (UUID)',
+            description: 'Device ID(s), can be specified multiple times',
+            multiple: true,
             required: true,
         }),
         end: Flags.string({
             description: 'End time (ISO 8601)',
+            required: true,
         }),
-        latest: Flags.boolean({
+        'latest-values-only': Flags.boolean({
             description: 'Only return the most recent value per stream',
         }),
         limit: Flags.integer({
@@ -40,12 +56,12 @@ hour, 4 hours, 12 hours, day, week, month, year.`;
         }),
         start: Flags.string({
             description: 'Start time (ISO 8601)',
+            required: true,
         }),
         stream: Flags.string({
             char: 's',
             description: 'Stream name(s), can be specified multiple times',
             multiple: true,
-            required: true,
         }),
         type: Flags.string({
             description: 'Filter by stream type',
@@ -53,31 +69,76 @@ hour, 4 hours, 12 hours, day, week, month, year.`;
     };
     static summary = 'Query telemetry stream data';
     async run() {
-        // --start and --end are required unless --latest
-        if (!this.flags.latest && (!this.flags.start || !this.flags.end)) {
-            this.error('--start and --end are required (unless using --latest).');
+        let streamNames = this.flags.stream ?? [];
+        // --all-streams validation
+        if (this.flags['all-streams']) {
+            if (!this.flags['latest-values-only']) {
+                this.error('--all-streams requires --latest-values-only');
+            }
+            if (this.flags.device.length !== 1) {
+                this.error('--all-streams requires exactly one --device');
+            }
+            const deviceId = this.flags.device[0];
+            const discovered = new Set();
+            // ── Config-based discovery ──────────────────────────────────────────────
+            const device = await this.api('admin', `devices/${deviceId}`, {
+                method: 'GET',
+            });
+            const configVersion = device.desiredConfigurationVersion;
+            if (configVersion) {
+                const config = await this.api('admin', `devices/${deviceId}/configurations/${configVersion}`, { method: 'GET' });
+                const doc = config.document;
+                const telemetry = doc?.telemetry;
+                const configStreams = telemetry?.streams || [];
+                for (const s of configStreams) {
+                    const name = s.name;
+                    if (name)
+                        discovered.add(name);
+                }
+            }
+            // ── Data-based discovery (metadata endpoint) ───────────────────────────
+            const since = new Date();
+            since.setDate(since.getDate() - this.flags.days);
+            try {
+                const metaResult = await this.api('query', 'metadata', {
+                    body: {
+                        deviceIds: [deviceId],
+                        start: since.toISOString(),
+                    },
+                });
+                for (const item of metaResult?.items ?? []) {
+                    if (item.name)
+                        discovered.add(item.name);
+                }
+            }
+            catch {
+                // metadata endpoint failure is non-fatal
+            }
+            streamNames = [...discovered];
+            if (streamNames.length === 0) {
+                this.error('No streams found for this device (neither configured nor in ingested data)');
+            }
+            if (!this.jsonEnabled()) {
+                this.log(`\nDiscovered ${streamNames.length} streams (config + data, last ${this.flags.days}d).\n`);
+            }
+        }
+        if (streamNames.length === 0) {
+            this.error('Specify --stream names or use --all-streams with --latest-values-only');
         }
         const body = {
-            deviceIds: [this.flags.device],
-            names: this.flags.stream,
+            deviceIds: this.flags.device,
+            names: streamNames,
+            start: this.normalizeDateTime(this.flags.start),
+            end: this.normalizeDateTime(this.flags.end),
         };
-        if (this.flags.start)
-            body.start = this.normalizeDateTime(this.flags.start);
-        if (this.flags.end)
-            body.end = this.normalizeDateTime(this.flags.end);
         if (this.flags.type)
             body.types = [this.flags.type];
         if (this.flags.aggregate)
             body.aggregate = this.flags.aggregate;
-        if (this.flags.latest)
+        if (this.flags['latest-values-only'])
             body.latestOnly = true;
         if (this.flags.limit)
             body.limit = this.flags.limit;
-        // If using --latest and no time range given, use a reasonable default
-        if (this.flags.latest && !this.flags.start) {
-            body.start = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
-            body.end = new Date().toISOString();
-        }
         const result = await this.api('query', 'queries', { body });
         if (!this.jsonEnabled()) {
             this.log(`\nTelemetry Data (${this.env} environment):\n`);
@@ -90,10 +151,21 @@ hour, 4 hours, 12 hours, day, week, month, year.`;
                         { key: 'time', label: 'TIME', width: 28 },
                         { key: 'value', label: 'VALUE', width: 50 },
                     ];
-                    const rows = points.map((p) => ({
-                        time: p.time,
-                        value: typeof p.value === 'object' ? JSON.stringify(p.value) : p.value,
-                    }));
+                    const rows = points.map((p) => {
+                        // Points can be [timestamp_ms, value] tuples or {time, value} objects
+                        if (Array.isArray(p)) {
+                            const [ts, val] = p;
+                            return {
+                                time: new Date(ts).toISOString(),
+                                value: typeof val === 'object' ? JSON.stringify(val) : val,
+                            };
+                        }
+                        const obj = p;
+                        return {
+                            time: obj.time,
+                            value: typeof obj.value === 'object' ? JSON.stringify(obj.value) : obj.value,
+                        };
+                    });
                     this.log(formatTable(rows, columns));
                     this.log('');
                 }

package/dist/commands/query/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/query/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/query/index.ts"],"names":[],"mappings":"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"}

package/dist/help.js

@@ -75,7 +75,7 @@ EXAMPLES
 
   # Telemetry queries
   $ fcli query --device <id> --stream battery_level --start 2026-01-01 --end 2026-01-02
-  $ fcli query latest-values --device <id> --stream battery_level
+  $ fcli query --device <id> --stream battery_level --latest-values-only
   $ fcli device streams <device-id>                     # List available streams
 
   # Ingest telemetry data