@formant/formant-cli 0.2.0 → 0.3.1

package/dist/commands/query/latest-values.js

@@ -8,7 +8,8 @@ Returns the most recent value for specified streams without needing to specify
 a time range. Useful for checking current sensor readings.
 
 Use --all-streams with a single device to automatically discover and query all
-configured streams from the device configuration.`;
+streams — both from the device configuration and from actual ingested data
+(unconfigured streams included).`;
     static examples = [
         '<%= config.bin %> query latest-values --device <id> --stream battery_level',
         '<%= config.bin %> query latest-values --device <id> --stream temperature --stream humidity',
@@ -17,7 +18,11 @@ configured streams from the device configuration.`;
     ];
     static flags = {
         'all-streams': Flags.boolean({
-            description: 'Query all configured streams for the device (requires single --device)',
+            description: 'Query all streams for the device — from config and from ingested data (requires single --device)',
+        }),
+        days: Flags.integer({
+            default: 14,
+            description: 'How many days back to look for unconfigured streams when using --all-streams',
         }),
         device: Flags.string({
             char: 'd',
@@ -34,32 +39,53 @@ configured streams from the device configuration.`;
     static summary = 'Get latest stream values';
     async run() {
         let streamNames = this.flags.stream ?? [];
-        // If --all-streams, discover streams from device config
+        // If --all-streams, discover streams from both config and ingested data
         if (this.flags['all-streams']) {
             if (this.flags.device.length !== 1) {
                 this.error('--all-streams requires exactly one --device');
             }
             const deviceId = this.flags.device[0];
-            // Fetch device to get config version
+            const discovered = new Set();
+            // ── Config-based discovery ──────────────────────────────────────────────
             const device = await this.api('admin', `devices/${deviceId}`, {
                 method: 'GET',
             });
             const configVersion = device.desiredConfigurationVersion;
-            if (!configVersion) {
-                this.error('Device has no configuration version set');
+            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
             }
-            // Fetch config
-            const config = await this.api('admin', `devices/${deviceId}/configurations/${configVersion}`, { method: 'GET' });
-            // Parse stream names from config
-            const doc = config.document;
-            const telemetry = doc?.telemetry;
-            const streams = telemetry?.streams || [];
-            streamNames = streams.map((s) => s.name).filter(Boolean);
+            streamNames = [...discovered];
             if (streamNames.length === 0) {
-                this.error('No streams configured on this device');
+                this.error('No streams found for this device (neither configured nor in ingested data)');
             }
             if (!this.jsonEnabled()) {
-                this.log(`\nDiscovered ${streamNames.length} streams from device config.\n`);
+                this.log(`\nDiscovered ${streamNames.length} streams (config + data, last ${this.flags.days}d).\n`);
             }
         }
         if (streamNames.length === 0) {

package/dist/commands/query/latest-values.js.map

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

package/dist/help.js

@@ -9,81 +9,131 @@ export default class FcliHelp extends Help {
    ██║     ╚██████╗███████╗██║
    ╚═╝      ╚═════╝╚══════╝╚═╝
 
+ABOUT
+  Formant is a cloud platform for monitoring, operating, and analyzing robot fleets.
+  This CLI lets you interact with your robots, query telemetry data, trigger AI-powered
+  investigations, manage users and permissions, and automate fleet operations — all from
+  your terminal.
+
 USAGE
   $ fcli <command> [flags]
 
-CONCEPTS
-  Device         A robot or sensor in your fleet
-  Event          Important occurrence emitted by a device
-  Signal         Point of interest from an event, schedule, or manual trigger
-  Investigation  AI-powered analysis workflow triggered by a signal
-  Query          Retrieve telemetry and sensor data from devices
+KEY CONCEPTS
+  Organization   Your Formant account with users, devices, and settings
+  Device         A robot, sensor, or IoT device in your fleet that sends telemetry
+  Event          An important occurrence (alert, warning, error) emitted by a device
+  Signal         A point of interest that triggers investigation or analysis
+  Investigation  AI-powered workflow that analyzes device data and diagnoses issues
+  Stream         Real-time telemetry data (battery, temperature, location, sensors)
+  Command        Remote instruction sent to a device to perform an action
+  Fleet          A logical group of devices (by location, type, or tags)
 
 COMMANDS
-  devices          List and inspect robots/sensors in your fleet
-  events           View important events emitted by devices
-  query            Retrieve telemetry data (battery, temperature, etc.)
-  signals          Manage signals (points of interest that trigger analysis)
-  investigations   Run and monitor AI-powered analysis workflows
-  commands         Manage command templates and send commands to devices
-  event-triggers   Manage event trigger rules
-  users            Manage users in your organization
-  schedules        Manage scheduled tasks
-  fleets           Manage device groups
-  analytics        Execute SQL queries against analytics data
-  kv               Manage key-value store
+  org              View and update your Formant organization
+  devices          Create, list, tag, and manage robots/sensors in your fleet
+  events           View and filter important events emitted by devices
+  query            Retrieve historical telemetry data and latest sensor values
+  ingest           Send telemetry data to devices via the Formant ingestion API
+  signals          List, query, and analyze signals that trigger investigations
+  investigations   Trigger, monitor, and analyze AI-powered diagnostic workflows
+  commands         Send remote commands to devices and view command history
+  event-triggers   Configure rules that automatically generate events and signals
+  users            List and inspect users in your organization
+  fleets           Manage device groups and organize your fleet
+  schedules        Set up recurring tasks and one-time scheduled jobs
+  analytics        Execute custom SQL queries against your analytics database
+  kv               Store and retrieve metadata in the key-value store
   help             Display help for fcli
 
 GLOBAL FLAGS
-  --dev            Target the dev environment
-  --stage          Target the stage environment
-  --json           Format output as JSON
-  -h, --help       Show help for a command
+  --dev            Target the dev environment (for testing)
+  --stage          Target the stage environment (for staging)
+  --json           Output raw JSON instead of formatted tables
+  -h, --help       Show help for any command
 
 AUTHENTICATION
-  Set these environment variables (or use a .env file):
-    FORMANT_USER       Service account email
-    FORMANT_PASSWORD   Service account password
+  Formant CLI uses service account credentials. Set these environment variables:
+
+    FORMANT_USER       Your service account email (e.g., bot@org.iam.formant.io)
+    FORMANT_PASSWORD   Your service account password
+
+  You can also create a .env file in your project directory with these values.
 
 EXAMPLES
-  # List online robots and sensors
-  $ fcli devices list --dev
-  $ fcli devices list --tag location=warehouse --online
-  $ fcli devices config <device-id> --dev
+  # Organization management
+  $ fcli org get                                        # View your org details
+  $ fcli org update --name "Acme Robotics"              # Update org name
 
-  # View critical events from a device
-  $ fcli events list --device <id> --severity critical --limit 20
-  $ fcli events get <event-id> --dev
+  # Device management
+  $ fcli devices list --online                          # List all online devices
+  $ fcli devices list --tag location=warehouse          # Filter by tags
+  $ fcli devices create --name "robot-001"              # Create a new device
+  $ fcli devices tag <device-id> --key env --value prod # Add tags
+  $ fcli devices rename <device-id> --name "robot-new"  # Rename a device
 
-  # Query battery telemetry over time
+  # 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 devices streams <device-id>                    # List available streams
+
+  # Ingest telemetry data
+  $ fcli ingest numeric 42.5 --device <id> --stream battery_level
+  $ fcli ingest text "hello" --device <id> --stream status --tag env=prod
+  $ fcli ingest health operational --device <id> --stream health_status
+  $ fcli ingest batch --file payload.json               # Batch ingest from file
+
+  # Events and monitoring
+  $ fcli events list --severity critical --limit 50     # View critical events
+  $ fcli events list --device <id> --start 2026-01-01  # Events for one device
+  $ fcli events get <event-id>                          # Get event details
+
+  # AI investigations
+  $ fcli investigations list                            # List all investigations
+  $ fcli investigations trigger <inv-id> <device-id>    # Trigger an investigation
+  $ fcli investigations runs <inv-id>                   # View investigation runs
+  $ fcli investigations stats --start 2026-01-01        # Get investigation metrics
+
+  # Signals (investigation triggers)
+  $ fcli signals list --start 2026-01-01 --end 2026-02-01
+  $ fcli signals query --start 2026-01-01              # Query by time range
+  $ fcli signals count                                  # Count signals by type
+  $ fcli signals get <signal-id>                        # Get signal details
+
+  # Remote commands
+  $ fcli commands list                                  # List command templates
+  $ fcli commands for-device <device-id>                # Commands for one device
+  $ fcli commands send <device-id> <template-id> --param speed=10
+  $ fcli commands history <device-id>                   # View command history
 
-  # Trace investigation runs back to their origin
-  $ fcli investigations runs-list <investigation-id> --dev
-  $ fcli investigations run <investigation-id> <run-id> --trace-signal --dev
-  $ fcli signals get <signal-id> --trace --dev
+  # Event triggers (automation)
+  $ fcli event-triggers list                            # List all trigger rules
+  $ fcli event-triggers get <trigger-id>                # View trigger details
 
-  # View signals and investigations
-  $ fcli signals query --start 2026-01-01 --end 2026-02-01
-  $ fcli investigations list
-  $ fcli investigations stats --start 2026-01-01 --end 2026-02-10
+  # User and fleet management
+  $ fcli users list                                     # List all users
+  $ fcli users get <user-id>                            # View user details
+  $ fcli fleets list                                    # List device groups
+  $ fcli fleets get <fleet-id>                          # View fleet details
 
-  # Send commands to devices
-  $ fcli commands list --dev
-  $ fcli commands for-device <device-id> --dev
-  $ fcli commands send <device-id> <template-id> --param speed=5 --dev
+  # Analytics and data queries
+  $ fcli analytics tables                               # List available tables
+  $ fcli analytics query --sql "SELECT * FROM events LIMIT 10"
 
-  # Manage event triggers and schedules
-  $ fcli event-triggers list --dev
-  $ fcli schedules list --dev
+  # Metadata storage
+  $ fcli kv list <device-id>                            # List all keys for device
+  $ fcli kv get <device-id> <key>                       # Get a value
+  $ fcli kv set <device-id> <key> <value>               # Store a value
 
-  # Query analytics and latest values
-  $ fcli analytics query --sql "SELECT * FROM events LIMIT 10" --dev
-  $ fcli query latest-values --device <id> --stream battery_level --dev
+TIPS
+  • Use --json with any command to get machine-readable output for scripting
+  • Pipe output to jq for advanced JSON processing: fcli devices list --json | jq
+  • Set --dev or --stage to target non-production environments
+  • Use fcli <command> --help to see detailed help for any command
 
 LEARN MORE
-  Use 'fcli <command> --help' for detailed help on any command.
-  Use 'fcli <command> <subcommand> --help' for subcommand details.
+  Documentation:  https://formant.io/docs
+  Support:        support@formant.io
+  GitHub:         https://github.com/FormantIO/formant-cli
 `;
         this.log(output);
     }

package/dist/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,IAAI;IACrB,KAAK,CAAC,YAAY;QACnC,MAAM,MAAM,GAAG;;qDAEkC,IAAI,CAAC,MAAM,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFvE,CAAA;QAEG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,CAAC;CACF"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,IAAI;IACrB,KAAK,CAAC,YAAY;QACnC,MAAM,MAAM,GAAG;;qDAEkC,IAAI,CAAC,MAAM,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmIvE,CAAA;QAEG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,CAAC;CACF"}

package/dist/lib/api.d.ts

@@ -1,5 +1,5 @@
 import { type Environment } from './config.js';
-export type ApiTarget = 'admin' | 'query' | 'theopolis';
+export type ApiTarget = 'admin' | 'ingest' | 'query' | 'theopolis';
 interface RequestOptions {
     body?: unknown;
     method?: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';

package/dist/lib/api.js

@@ -6,6 +6,9 @@ function buildBaseUrl(env, target) {
         case 'admin': {
             return `${urls.adminApi}/v1/admin`;
         }
+        case 'ingest': {
+            return `${urls.adminApi}/v1/ingest`;
+        }
         case 'query': {
             return `${urls.queryApi}/v1/queries`;
         }

package/dist/lib/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,OAAO,EAAC,MAAM,aAAa,CAAA;AACrD,OAAO,EAAC,KAAK,EAAC,MAAM,WAAW,CAAA;AAU/B,SAAS,YAAY,CAAC,GAAgB,EAAE,MAAiB;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACzB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,QAAQ,WAAW,CAAA;QACpC,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,QAAQ,aAAa,CAAA;QACtC,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,OAAO,GAAG,IAAI,CAAC,SAAS,MAAM,CAAA;QAChC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAgB,EAChB,MAAiB,EACjB,IAAY,EACZ,UAA0B,EAAE;IAE5B,MAAM,EAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAC,GAAG,OAAO,CAAA;IAC7D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAE7B,IAAI,GAAG,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAA;IAChD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAA;QACzC,GAAG,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAA;IAChC,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;QAC3C,cAAc,EAAE,kBAAkB;KACnC,CAAA;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7C,OAAO;QACP,MAAM;KACP,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,MAAM,IAAI,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC,CAAA;IACtE,CAAC;IAED,wBAAwB;IACxB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,SAAc,CAAA;IAE7C,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAA;AAChC,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,OAAO,EAAC,MAAM,aAAa,CAAA;AACrD,OAAO,EAAC,KAAK,EAAC,MAAM,WAAW,CAAA;AAU/B,SAAS,YAAY,CAAC,GAAgB,EAAE,MAAiB;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACzB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,QAAQ,WAAW,CAAA;QACpC,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO,GAAG,IAAI,CAAC,QAAQ,YAAY,CAAA;QACrC,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,QAAQ,aAAa,CAAA;QACtC,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,OAAO,GAAG,IAAI,CAAC,SAAS,MAAM,CAAA;QAChC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAgB,EAChB,MAAiB,EACjB,IAAY,EACZ,UAA0B,EAAE;IAE5B,MAAM,EAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAC,GAAG,OAAO,CAAA;IAC7D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAE7B,IAAI,GAAG,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAA;IAChD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAA;QACzC,GAAG,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAA;IAChC,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;QAC3C,cAAc,EAAE,kBAAkB;KACnC,CAAA;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7C,OAAO;QACP,MAAM;KACP,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,MAAM,IAAI,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC,CAAA;IACtE,CAAC;IAED,wBAAwB;IACxB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,SAAc,CAAA;IAE7C,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAA;AAChC,CAAC"}