@formant/formant-cli 0.4.3 → 0.4.5

package/oclif.manifest.json

@@ -140,19 +140,19 @@
         "tables.js"
       ]
     },
-    "event-trigger:get": {
+    "event:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Event trigger ID (UUID)",
+          "description": "Event ID (UUID)",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get detailed information about an event trigger.\n\nShows the full trigger configuration including conditions, exit conditions, commands\nit executes, and device targeting filters.",
+      "description": "Get detailed information about a specific event by its ID.",
       "examples": [
-        "<%= config.bin %> event-trigger get <trigger-id>",
-        "<%= config.bin %> event-trigger get <trigger-id> --json"
+        "<%= config.bin %> event get <event-id>",
+        "<%= config.bin %> event get <event-id> --json"
       ],
       "flags": {
         "json": {
@@ -185,28 +185,30 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "event-trigger:get",
+      "id": "event:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get event trigger details",
+      "summary": "Get an event by ID",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "event-trigger",
+        "event",
         "get.js"
       ]
     },
-    "event-trigger:list": {
+    "event:list": {
       "aliases": [],
       "args": {},
-      "description": "List all event trigger rules in your organization.\n\nEvent triggers monitor device data and generate events/signals when conditions are met.\nThey can trigger investigations, send notifications, or execute commands.",
+      "description": "View important events emitted by devices with optional filters.\n\nEvents are significant occurrences from robots and sensors (e.g., device online/offline,\nerrors, state changes, commands). They can trigger signals for investigation.\n\nEvent types include: triggered-event, datapoint-event, device-online, device-offline,\nintervention-request, intervention-response, teleop-session-record, command-request,\ncommand-response, custom, comment, system, annotation, task-summary, stateful.\n\nSeverities: info, warning, error, critical.",
       "examples": [
-        "<%= config.bin %> event-trigger list",
-        "<%= config.bin %> event-trigger list --json"
+        "<%= config.bin %> event list",
+        "<%= config.bin %> event list --device <id> --severity critical",
+        "<%= config.bin %> event list --type device-offline --start 2026-01-01 --end 2026-01-02",
+        "<%= config.bin %> event list --limit 100 --json"
       ],
       "flags": {
         "json": {
@@ -235,22 +237,73 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "device": {
+          "char": "d",
+          "description": "Filter by device ID",
+          "name": "device",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "end": {
+          "description": "End time (ISO 8601)",
+          "name": "end",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of events to return",
+          "name": "limit",
+          "default": 25,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "severity": {
+          "description": "Filter by severity",
+          "name": "severity",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "info",
+            "warning",
+            "error",
+            "critical"
+          ],
+          "type": "option"
+        },
+        "start": {
+          "description": "Start time (ISO 8601)",
+          "name": "start",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "Filter by event type",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "event-trigger:list",
+      "id": "event:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List event trigger rules",
+      "summary": "View events emitted by devices",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "event-trigger",
+        "event",
         "list.js"
       ]
     },
@@ -368,6 +421,120 @@
         "list.js"
       ]
     },
+    "event-trigger:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Event trigger ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get detailed information about an event trigger.\n\nShows the full trigger configuration including conditions, exit conditions, commands\nit executes, and device targeting filters.",
+      "examples": [
+        "<%= config.bin %> event-trigger get <trigger-id>",
+        "<%= config.bin %> event-trigger get <trigger-id> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dev": {
+          "description": "Target the dev environment",
+          "exclusive": [
+            "stage"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "dev",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "stage": {
+          "description": "Target the stage environment",
+          "exclusive": [
+            "dev"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "stage",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "event-trigger:get",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Get event trigger details",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "event-trigger",
+        "get.js"
+      ]
+    },
+    "event-trigger:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all event trigger rules in your organization.\n\nEvent triggers monitor device data and generate events/signals when conditions are met.\nThey can trigger investigations, send notifications, or execute commands.",
+      "examples": [
+        "<%= config.bin %> event-trigger list",
+        "<%= config.bin %> event-trigger list --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dev": {
+          "description": "Target the dev environment",
+          "exclusive": [
+            "stage"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "dev",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "stage": {
+          "description": "Target the stage environment",
+          "exclusive": [
+            "dev"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "stage",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "event-trigger:list",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List event trigger rules",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "event-trigger",
+        "list.js"
+      ]
+    },
     "command:for-device": {
       "aliases": [],
       "args": {
@@ -704,19 +871,19 @@
         "send.js"
       ]
     },
-    "device:config": {
+    "kv:get": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
+        "key": {
+          "description": "Key to retrieve",
+          "name": "key",
           "required": true
         }
       },
-      "description": "Get the device configuration including stream definitions.\n\nShows the device's current configuration including telemetry streams, commands,\nand other settings.",
+      "description": "Get a value from the key-value store.\n\nThe key-value store allows devices and applications to store metadata.",
       "examples": [
-        "<%= config.bin %> device config <device-id>",
-        "<%= config.bin %> device config <device-id> --json"
+        "<%= config.bin %> kv get my-key",
+        "<%= config.bin %> kv get my-key --json"
       ],
       "flags": {
         "json": {
@@ -749,35 +916,30 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:config",
+      "id": "kv:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get device configuration",
+      "summary": "Get key-value",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "device",
-        "config.js"
+        "kv",
+        "get.js"
       ]
     },
-    "device:create": {
+    "kv:list": {
       "aliases": [],
-      "args": {
-        "name": {
-          "description": "Name for the new device",
-          "name": "name",
-          "required": true
-        }
-      },
-      "description": "Create a new device in your fleet.\n\nThe device is created as enabled by default. You can optionally specify tags.",
+      "args": {},
+      "description": "List all keys in the key-value store.\n\nShows all stored keys in the organization's key-value store. Use --prefix to filter\nkeys that start with a specific prefix, or --keys to query specific keys.",
       "examples": [
-        "<%= config.bin %> device create my-robot",
-        "<%= config.bin %> device create my-robot --tag location=warehouse --tag env=prod",
-        "<%= config.bin %> device create my-robot --json"
+        "<%= config.bin %> kv list",
+        "<%= config.bin %> kv list --prefix config",
+        "<%= config.bin %> kv list --keys key1 --keys key2 --keys key3",
+        "<%= config.bin %> kv list --json"
       ],
       "flags": {
         "json": {
@@ -807,45 +969,58 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "tag": {
-          "char": "t",
-          "description": "Tag to apply (key=value), can be specified multiple times",
-          "name": "tag",
+        "keys": {
+          "char": "k",
+          "description": "Specific keys to query (can be specified multiple times)",
+          "name": "keys",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
+        },
+        "prefix": {
+          "char": "p",
+          "description": "Filter keys by prefix",
+          "name": "prefix",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:create",
+      "id": "kv:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create a new device",
+      "summary": "List key-value keys",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "device",
-        "create.js"
+        "kv",
+        "list.js"
       ]
     },
-    "device:delete": {
+    "kv:set": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
+        "key": {
+          "description": "Key to set",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "Value to store (JSON string)",
+          "name": "value",
           "required": true
         }
       },
-      "description": "Delete (disable) a device from your fleet.\n\nThis performs a soft-delete by disabling the device. The device and its telemetry\nhistory are preserved but it will no longer appear in device listings.",
+      "description": "Set a value in the key-value store.\n\nStores a value associated with a key. The value should be a JSON string.",
       "examples": [
-        "<%= config.bin %> device delete <device-id>",
-        "<%= config.bin %> device delete <device-id> --json"
+        "<%= config.bin %> kv set my-key '{\"data\": \"value\"}'",
+        "<%= config.bin %> kv set config '{\"setting\": true}'"
       ],
       "flags": {
         "json": {
@@ -878,34 +1053,28 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:delete",
+      "id": "kv:set",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Delete (disable) a device",
+      "summary": "Set key-value",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "device",
-        "delete.js"
+        "kv",
+        "set.js"
       ]
     },
-    "device:get": {
+    "org:get": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get detailed information about a specific device by its ID.",
+      "args": {},
+      "description": "Get information about your organization.\n\nDisplays the organization associated with your authenticated account.\nNo ID is needed — it is resolved automatically from your credentials.",
       "examples": [
-        "<%= config.bin %> device get <device-id>",
-        "<%= config.bin %> device get <device-id> --json"
+        "<%= config.bin %> org get",
+        "<%= config.bin %> org get --json"
       ],
       "flags": {
         "json": {
@@ -938,33 +1107,30 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:get",
+      "id": "org:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get a device by ID",
+      "summary": "Get your organization",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "device",
+        "org",
         "get.js"
       ]
     },
-    "device:list": {
+    "org:update": {
       "aliases": [],
       "args": {},
-      "description": "List robots and sensors in your fleet. Shows only online devices by default.\n\nUse --include-offline to include offline devices. Use --with-data to show only\ndevices that have ingested data. Each device is enriched with data-based last\nseen timestamp and datapoint count from analytics.",
+      "description": "Update your organization's details.\n\nAt least one of --name or --description must be provided.",
       "examples": [
-        "<%= config.bin %> device list",
-        "<%= config.bin %> device list --include-offline",
-        "<%= config.bin %> device list --with-data",
-        "<%= config.bin %> device list --with-data --days 90",
-        "<%= config.bin %> device list --include-offline --limit 100",
-        "<%= config.bin %> device list --tag location=warehouse",
-        "<%= config.bin %> device list --name robot --dev --json"
+        "<%= config.bin %> org update --name \"My Fleet\"",
+        "<%= config.bin %> org update --description \"Production robot fleet\"",
+        "<%= config.bin %> org update --name \"My Fleet\" --description \"Production robot fleet\"",
+        "<%= config.bin %> org update --name \"My Fleet\" --json"
       ],
       "flags": {
         "json": {
@@ -994,89 +1160,49 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "include-offline": {
-          "char": "a",
-          "description": "Include offline devices",
-          "name": "include-offline",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "days": {
-          "description": "How many days back to search for last seen data",
-          "name": "days",
-          "default": 30,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "limit": {
-          "char": "l",
-          "description": "Maximum number of devices to return",
-          "name": "limit",
-          "default": 50,
+        "description": {
+          "char": "d",
+          "description": "New description for the organization",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "name": {
           "char": "n",
-          "description": "Filter devices by name (search)",
+          "description": "New name for the organization",
           "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "with-data": {
-          "char": "w",
-          "description": "Only show devices that have data in the last --days window",
-          "name": "with-data",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "tag": {
-          "char": "t",
-          "description": "Filter by tag (key=value), can be specified multiple times",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:list",
+      "id": "org:update",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List robots and sensors in your fleet",
+      "summary": "Update your organization",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "device",
-        "list.js"
+        "org",
+        "update.js"
       ]
     },
-    "device:rename": {
+    "ingest:batch": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
-          "required": true
-        },
-        "name": {
-          "description": "New name for the device",
-          "name": "name",
-          "required": true
-        }
-      },
-      "description": "Rename a device by updating its name.",
+      "args": {},
+      "description": "Ingest multiple data points in a single batch request.\n\nReads a JSON file (or stdin) containing a batch ingestion payload and sends all data points\nin a single API request. This is more efficient than sending individual data points when you\nhave multiple values to ingest.\n\nINPUT FORMAT:\nThe input JSON must have the following structure:\n{\n  \"items\": [\n    {\n      \"deviceId\": \"device-uuid\",        // Required: Device ID (UUID)\n      \"name\": \"stream-name\",             // Required: Stream name\n      \"type\": \"numeric|text|json|...\",   // Required: Data type (see below)\n      \"tags\": {\"key\": \"value\"},          // Optional: Tags object (string key-value pairs)\n      \"points\": [[timestamp_ms, value]]  // Required: Array of [timestamp, value] pairs\n    }\n  ]\n}\n\nSUPPORTED TYPES AND VALUE FORMATS:\n- numeric: Number value\n    Example: \"points\": [[1708272000000, 42.5]]\n\n- text: String value\n    Example: \"points\": [[1708272000000, \"hello world\"]]\n\n- json: JSON object encoded as string\n    Example: \"points\": [[1708272000000, \"{\\\"x\\\":10,\\\"y\\\":20}\"]]\n\n- image: Object with url (required), size and annotations (optional)\n    Example: \"points\": [[1708272000000, {\"url\": \"https://example.com/img.jpg\", \"size\": 102400}]]\n\n- video: Object with url, duration, mimeType (required), size (optional)\n    Example: \"points\": [[1708272000000, {\"url\": \"https://example.com/vid.mp4\", \"duration\": 30000, \"mimeType\": \"video/mp4\"}]]\n\n- bitset: Object with keys array and values array (1-1000 pairs)\n    Example: \"points\": [[1708272000000, {\"keys\": [\"door\", \"window\"], \"values\": [true, false]}]]\n\n- health: Object with status (required) and clockSkewMs (optional)\n    Example: \"points\": [[1708272000000, {\"status\": \"operational\", \"clockSkewMs\": 150}]]\n    Valid status values: \"unknown\", \"operational\", \"offline\", \"error\"\n\nEach item can have multiple points (timestamp/value pairs) for the same stream.\nTimestamps are Unix milliseconds (use Date.now() for current time).",
       "examples": [
-        "<%= config.bin %> device rename <device-id> new-robot-name",
-        "<%= config.bin %> device rename <device-id> new-robot-name --json"
+        "<%= config.bin %> ingest batch --file data.json",
+        "<%= config.bin %> ingest batch --stdin < data.json",
+        "cat payload.json | <%= config.bin %> ingest batch --stdin",
+        "# Example payload.json with multiple types:\n{\n  \"items\": [\n    {\n      \"deviceId\": \"abc-123\",\n      \"name\": \"battery_level\",\n      \"type\": \"numeric\",\n      \"tags\": {\"env\": \"prod\"},\n      \"points\": [[1708272000000, 42.5], [1708272060000, 41.8]]\n    },\n    {\n      \"deviceId\": \"abc-123\",\n      \"name\": \"status\",\n      \"type\": \"text\",\n      \"tags\": {\"env\": \"prod\"},\n      \"points\": [[1708272000000, \"operational\"]]\n    },\n    {\n      \"deviceId\": \"abc-123\",\n      \"name\": \"health\",\n      \"type\": \"health\",\n      \"tags\": {},\n      \"points\": [[1708272000000, {\"status\": \"operational\"}]]\n    }\n  ]\n}"
       ],
       "flags": {
         "json": {
@@ -1105,40 +1231,53 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "file": {
+          "char": "f",
+          "description": "Path to JSON file containing batch payload",
+          "exclusive": [
+            "stdin"
+          ],
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stdin": {
+          "description": "Read JSON payload from stdin",
+          "exclusive": [
+            "file"
+          ],
+          "name": "stdin",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:rename",
+      "id": "ingest:batch",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Rename a device",
+      "summary": "Ingest batch data from file or stdin",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "device",
-        "rename.js"
+        "ingest",
+        "batch.js"
       ]
     },
-    "device:streams": {
+    "ingest:bitset": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "List telemetry streams for a device with data presence.\n\nShows streams from the device configuration and any streams discovered from\ningested data. Each stream is enriched with presence info from the analytics\nbackend: data point count, last seen time, and a freshness indicator\n(active/recent/stale/dormant).\n\nUnconfigured streams (discovered from data only) are marked with SOURCE \"data\".",
+      "args": {},
+      "description": "Ingest a bitset data point to a device stream.\n\nSends a bitset (array of named boolean values) to the specified device stream. A bitset\nconsists of parallel arrays of keys (strings) and values (booleans).\n\nBitsets are useful for representing sets of binary states, flags, or boolean sensor readings\nwhere you have multiple named on/off states.\n\nConstraints:\n- Must have 1-1000 key/value pairs\n- Keys must be max 255 characters each\n- Keys and values arrays must have the same length",
       "examples": [
-        "<%= config.bin %> device streams <device-id>",
-        "<%= config.bin %> device streams <device-id> --with-data",
-        "<%= config.bin %> device streams <device-id> --with-data --days 30",
-        "<%= config.bin %> device streams <device-id> --json"
+        "<%= config.bin %> ingest bitset --device <device-id> --stream sensors --keys \"door,window,motion\" --values \"true,false,true\"",
+        "<%= config.bin %> ingest bitset --device <device-id> --stream flags --keys \"active,paused,error\" --values \"true,false,false\" --tag system=main",
+        "<%= config.bin %> ingest bitset --device <device-id> --stream states --keys \"a,b\" --values \"false,true\""
       ],
       "flags": {
         "json": {
@@ -1168,53 +1307,83 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "days": {
-          "description": "How many days back to look for stream data presence",
-          "name": "days",
-          "default": 7,
+        "device": {
+          "char": "d",
+          "description": "Device ID (UUID)",
+          "name": "device",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "with-data": {
-          "char": "w",
-          "description": "Only show streams that have data in the --days window",
-          "name": "with-data",
-          "allowNo": false,
-          "type": "boolean"
+        "stream": {
+          "char": "s",
+          "description": "Stream name",
+          "name": "stream",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "keys": {
+          "char": "k",
+          "description": "Comma-separated list of key names (1-1000 keys, max 255 chars each)",
+          "name": "keys",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "values": {
+          "char": "v",
+          "description": "Comma-separated list of boolean values (true/false, must match key count)",
+          "name": "values",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tag": {
+          "char": "t",
+          "description": "Tag as key=value where both are strings (can be specified multiple times)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "timestamp": {
+          "description": "Unix timestamp in milliseconds (defaults to now)",
+          "name": "timestamp",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:streams",
+      "id": "ingest:bitset",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List device streams with data presence",
+      "summary": "Ingest bitset data",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "device",
-        "streams.js"
+        "ingest",
+        "bitset.js"
       ]
     },
-    "device:tag": {
+    "ingest:health": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Add or update tags on a device.\n\nTags are key-value pairs. If a tag key already exists, its value will be updated.\nSpecify one or more tags with --tag key=value.",
+      "args": {},
+      "description": "Ingest a health status data point to a device stream.\n\nSends device health status information to the specified stream. Health data consists of:\n- status: One of \"unknown\", \"operational\", \"offline\", or \"error\"\n- clockSkewMs (optional): Clock skew in milliseconds between device and server\n\nHealth streams are used to track device operational state, system health, and time synchronization.",
       "examples": [
-        "<%= config.bin %> device tag <device-id> --tag location=warehouse",
-        "<%= config.bin %> device tag <device-id> --tag env=prod --tag region=us-east",
-        "<%= config.bin %> device tag <device-id> --tag location=factory --json"
+        "<%= config.bin %> ingest health --device <device-id> --stream system_health --status operational",
+        "<%= config.bin %> ingest health --device <device-id> --stream health --status error --tag component=motor",
+        "<%= config.bin %> ingest health --device <device-id> --stream sync --status operational --clock-skew 150"
       ],
       "flags": {
         "json": {
@@ -1244,47 +1413,86 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "device": {
+          "char": "d",
+          "description": "Device ID (UUID)",
+          "name": "device",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "char": "s",
+          "description": "Stream name",
+          "name": "stream",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "description": "Health status (unknown, operational, offline, or error)",
+          "name": "status",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "unknown",
+            "operational",
+            "offline",
+            "error"
+          ],
+          "type": "option"
+        },
+        "clock-skew": {
+          "description": "Clock skew in milliseconds (optional)",
+          "name": "clock-skew",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "tag": {
           "char": "t",
-          "description": "Tag to add or update (key=value), can be specified multiple times",
+          "description": "Tag as key=value where both are strings (can be specified multiple times)",
           "name": "tag",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
+        },
+        "timestamp": {
+          "description": "Unix timestamp in milliseconds (defaults to now)",
+          "name": "timestamp",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:tag",
+      "id": "ingest:health",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Add or update tags on a device",
+      "summary": "Ingest health status data",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "device",
-        "tag.js"
+        "ingest",
+        "health.js"
       ]
     },
-    "device:untag": {
+    "ingest:image": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Remove tags from a device.\n\nSpecify one or more tag keys to remove with --key.",
+      "args": {},
+      "description": "Ingest an image URL to a device stream.\n\nSends an image reference (by URL) to the specified device stream. The image must be accessible\nvia HTTP/HTTPS. Formant will fetch and store the image from the provided URL.\n\nImage streams are used for camera feeds, snapshots, diagnostic images, etc.",
       "examples": [
-        "<%= config.bin %> device untag <device-id> --key location",
-        "<%= config.bin %> device untag <device-id> --key env --key region",
-        "<%= config.bin %> device untag <device-id> --key location --json"
+        "<%= config.bin %> ingest image --device <device-id> --stream camera_front --url https://example.com/image.jpg",
+        "<%= config.bin %> ingest image --device <device-id> --stream snapshot --url https://example.com/snap.png --size 1024000",
+        "<%= config.bin %> ingest image --device <device-id> --stream detection --url https://example.com/detect.jpg --tag frame=123"
       ],
       "flags": {
         "json": {
@@ -1314,46 +1522,87 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "key": {
-          "char": "k",
-          "description": "Tag key to remove, can be specified multiple times",
-          "name": "key",
+        "device": {
+          "char": "d",
+          "description": "Device ID (UUID)",
+          "name": "device",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "char": "s",
+          "description": "Stream name",
+          "name": "stream",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "char": "u",
+          "description": "Image URL (must be http:// or https://)",
+          "name": "url",
           "required": true,
           "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "size": {
+          "description": "Image size in bytes (optional)",
+          "name": "size",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tag": {
+          "char": "t",
+          "description": "Tag as key=value where both are strings (can be specified multiple times)",
+          "name": "tag",
+          "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
+        },
+        "timestamp": {
+          "description": "Unix timestamp in milliseconds (defaults to now)",
+          "name": "timestamp",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:untag",
+      "id": "ingest:image",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Remove tags from a device",
+      "summary": "Ingest image data",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "device",
-        "untag.js"
+        "ingest",
+        "image.js"
       ]
     },
-    "event:get": {
+    "ingest:json": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Event ID (UUID)",
-          "name": "id",
+        "value": {
+          "description": "JSON value to ingest (as a JSON string)",
+          "name": "value",
           "required": true
         }
       },
-      "description": "Get detailed information about a specific event by its ID.",
+      "description": "Ingest a JSON data point to a device stream.\n\nSends structured JSON data to the specified device stream. The value must be valid JSON.\nJSON streams are used for complex structured data like configuration objects, state machines,\nnested telemetry, etc.\n\nNote: The JSON is sent as a JSON-encoded string to Formant.",
       "examples": [
-        "<%= config.bin %> event get <event-id>",
-        "<%= config.bin %> event get <event-id> --json"
+        "<%= config.bin %> ingest json '{\"x\":1,\"y\":2}' --device <device-id> --stream position",
+        "<%= config.bin %> ingest json '{\"status\":\"active\",\"mode\":\"auto\"}' --device <device-id> --stream config",
+        "<%= config.bin %> ingest json '[1,2,3,4,5]' --device <device-id> --stream array_data"
       ],
       "flags": {
         "json": {
@@ -1382,34 +1631,72 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "device": {
+          "char": "d",
+          "description": "Device ID (UUID)",
+          "name": "device",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "char": "s",
+          "description": "Stream name",
+          "name": "stream",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tag": {
+          "char": "t",
+          "description": "Tag as key=value where both are strings (can be specified multiple times)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "timestamp": {
+          "description": "Unix timestamp in milliseconds (defaults to now)",
+          "name": "timestamp",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "event:get",
+      "id": "ingest:json",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get an event by ID",
+      "summary": "Ingest JSON data",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "event",
-        "get.js"
+        "ingest",
+        "json.js"
       ]
     },
-    "event:list": {
+    "ingest:numeric": {
       "aliases": [],
-      "args": {},
-      "description": "View important events emitted by devices with optional filters.\n\nEvents are significant occurrences from robots and sensors (e.g., device online/offline,\nerrors, state changes, commands). They can trigger signals for investigation.\n\nEvent types include: triggered-event, datapoint-event, device-online, device-offline,\nintervention-request, intervention-response, teleop-session-record, command-request,\ncommand-response, custom, comment, system, annotation, task-summary, stateful.\n\nSeverities: info, warning, error, critical.",
+      "args": {
+        "value": {
+          "description": "Numeric value to ingest",
+          "name": "value",
+          "required": true
+        }
+      },
+      "description": "Ingest a numeric data point to a device stream.\n\nSends a single numeric value to the specified device stream. The value must be a valid number.\nNumeric streams are commonly used for sensor readings like battery level, temperature, speed, etc.",
       "examples": [
-        "<%= config.bin %> event list",
-        "<%= config.bin %> event list --device <id> --severity critical",
-        "<%= config.bin %> event list --type device-offline --start 2026-01-01 --end 2026-01-02",
-        "<%= config.bin %> event list --limit 100 --json"
+        "<%= config.bin %> ingest numeric 42.5 --device <device-id> --stream battery_level",
+        "<%= config.bin %> ingest numeric 98.6 --device <device-id> --stream temperature --tag unit=fahrenheit",
+        "<%= config.bin %> ingest numeric 1500 --device <device-id> --stream rpm --timestamp 1700000000000"
       ],
       "flags": {
         "json": {
@@ -1441,51 +1728,33 @@
         },
         "device": {
           "char": "d",
-          "description": "Filter by device ID",
+          "description": "Device ID (UUID)",
           "name": "device",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "end": {
-          "description": "End time (ISO 8601)",
-          "name": "end",
+        "stream": {
+          "char": "s",
+          "description": "Stream name",
+          "name": "stream",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "char": "l",
-          "description": "Maximum number of events to return",
-          "name": "limit",
-          "default": 25,
+        "tag": {
+          "char": "t",
+          "description": "Tag as key=value where both are strings (can be specified multiple times)",
+          "name": "tag",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "severity": {
-          "description": "Filter by severity",
-          "name": "severity",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "info",
-            "warning",
-            "error",
-            "critical"
-          ],
-          "type": "option"
-        },
-        "start": {
-          "description": "Start time (ISO 8601)",
-          "name": "start",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "type": {
-          "description": "Filter by event type",
-          "name": "type",
+        "timestamp": {
+          "description": "Unix timestamp in milliseconds (defaults to now)",
+          "name": "timestamp",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1493,28 +1762,35 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "event:list",
+      "id": "ingest:numeric",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "View events emitted by devices",
+      "summary": "Ingest numeric data",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "event",
-        "list.js"
+        "ingest",
+        "numeric.js"
       ]
     },
-    "org:get": {
+    "ingest:text": {
       "aliases": [],
-      "args": {},
-      "description": "Get information about your organization.\n\nDisplays the organization associated with your authenticated account.\nNo ID is needed — it is resolved automatically from your credentials.",
+      "args": {
+        "value": {
+          "description": "Text value to ingest",
+          "name": "value",
+          "required": true
+        }
+      },
+      "description": "Ingest a text data point to a device stream.\n\nSends a single text/string value to the specified device stream. Text streams are commonly\nused for logs, status messages, error messages, and other string data.",
       "examples": [
-        "<%= config.bin %> org get",
-        "<%= config.bin %> org get --json"
+        "<%= config.bin %> ingest text \"Robot started successfully\" --device <device-id> --stream status",
+        "<%= config.bin %> ingest text \"Error: sensor offline\" --device <device-id> --stream errors --tag severity=high",
+        "<%= config.bin %> ingest text \"Checkpoint A reached\" --device <device-id> --stream waypoints"
       ],
       "flags": {
         "json": {
@@ -1543,34 +1819,66 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "device": {
+          "char": "d",
+          "description": "Device ID (UUID)",
+          "name": "device",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "char": "s",
+          "description": "Stream name",
+          "name": "stream",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tag": {
+          "char": "t",
+          "description": "Tag as key=value where both are strings (can be specified multiple times)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "timestamp": {
+          "description": "Unix timestamp in milliseconds (defaults to now)",
+          "name": "timestamp",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "org:get",
+      "id": "ingest:text",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get your organization",
+      "summary": "Ingest text data",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "org",
-        "get.js"
+        "ingest",
+        "text.js"
       ]
     },
-    "org:update": {
+    "ingest:video": {
       "aliases": [],
       "args": {},
-      "description": "Update your organization's details.\n\nAt least one of --name or --description must be provided.",
+      "description": "Ingest a video URL to a device stream.\n\nSends a video reference (by URL) to the specified device stream. The video must be accessible\nvia HTTP/HTTPS. You must provide the video duration in milliseconds.\n\nVideo streams are used for recorded video clips, timelapse videos, event recordings, etc.\n\nThe MIME type is auto-detected from the file extension (.mp4, .webm, .mov).",
       "examples": [
-        "<%= config.bin %> org update --name \"My Fleet\"",
-        "<%= config.bin %> org update --description \"Production robot fleet\"",
-        "<%= config.bin %> org update --name \"My Fleet\" --description \"Production robot fleet\"",
-        "<%= config.bin %> org update --name \"My Fleet\" --json"
+        "<%= config.bin %> ingest video --device <device-id> --stream recordings --url https://example.com/video.mp4 --duration 5000",
+        "<%= config.bin %> ingest video --device <device-id> --stream clips --url https://example.com/clip.webm --duration 3500 --size 2048000",
+        "<%= config.bin %> ingest video --device <device-id> --stream event_video --url https://example.com/event.mov --duration 10000 --tag event=collision"
       ],
       "flags": {
         "json": {
@@ -1600,18 +1908,59 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "description": {
+        "device": {
           "char": "d",
-          "description": "New description for the organization",
-          "name": "description",
+          "description": "Device ID (UUID)",
+          "name": "device",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "char": "n",
-          "description": "New name for the organization",
-          "name": "name",
+        "stream": {
+          "char": "s",
+          "description": "Stream name",
+          "name": "stream",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "char": "u",
+          "description": "Video URL (must be http:// or https://)",
+          "name": "url",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "duration": {
+          "description": "Video duration in milliseconds (required)",
+          "name": "duration",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "size": {
+          "description": "Video size in bytes (optional)",
+          "name": "size",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tag": {
+          "char": "t",
+          "description": "Tag as key=value where both are strings (can be specified multiple times)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "timestamp": {
+          "description": "Unix timestamp in milliseconds (defaults to now)",
+          "name": "timestamp",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1619,34 +1968,29 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "org:update",
+      "id": "ingest:video",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Update your organization",
+      "summary": "Ingest video data",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "org",
-        "update.js"
+        "ingest",
+        "video.js"
       ]
     },
-    "kv:get": {
+    "investigation:analytics": {
       "aliases": [],
-      "args": {
-        "key": {
-          "description": "Key to retrieve",
-          "name": "key",
-          "required": true
-        }
-      },
-      "description": "Get a value from the key-value store.\n\nThe key-value store allows devices and applications to store metadata.",
+      "args": {},
+      "description": "Get investigation analytics with time-series data.\n\nReturns aggregated analytics about investigation runs over a time range,\noptionally grouped by result type or signal type.",
       "examples": [
-        "<%= config.bin %> kv get my-key",
-        "<%= config.bin %> kv get my-key --json"
+        "<%= config.bin %> investigation analytics --start 2026-01-01 --end 2026-02-01",
+        "<%= config.bin %> investigation analytics --start 2026-01-01 --end 2026-02-01 --interval hourly",
+        "<%= config.bin %> investigation analytics --start 2026-01-01 --end 2026-02-01 --group-by resultType --json"
       ],
       "flags": {
         "json": {
@@ -1675,34 +2019,77 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "end": {
+          "description": "End time (ISO 8601)",
+          "name": "end",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "group-by": {
+          "description": "Group results by",
+          "name": "group-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "resultType",
+            "signalType"
+          ],
+          "type": "option"
+        },
+        "interval": {
+          "description": "Time interval for aggregation",
+          "name": "interval",
+          "default": "daily",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "daily",
+            "hourly"
+          ],
+          "type": "option"
+        },
+        "start": {
+          "description": "Start time (ISO 8601)",
+          "name": "start",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "kv:get",
+      "id": "investigation:analytics",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get key-value",
+      "summary": "Get investigation analytics",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "kv",
-        "get.js"
+        "investigation",
+        "analytics.js"
       ]
     },
-    "kv:list": {
+    "investigation:get": {
       "aliases": [],
-      "args": {},
-      "description": "List all keys in the key-value store.\n\nShows all stored keys in the organization's key-value store. Use --prefix to filter\nkeys that start with a specific prefix, or --keys to query specific keys.",
+      "args": {
+        "id": {
+          "description": "Investigation (taskflow) ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get detailed information about a specific investigation by ID.",
       "examples": [
-        "<%= config.bin %> kv list",
-        "<%= config.bin %> kv list --prefix config",
-        "<%= config.bin %> kv list --keys key1 --keys key2 --keys key3",
-        "<%= config.bin %> kv list --json"
+        "<%= config.bin %> investigation get <id>",
+        "<%= config.bin %> investigation get <id> --json"
       ],
       "flags": {
         "json": {
@@ -1731,115 +2118,33 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "keys": {
-          "char": "k",
-          "description": "Specific keys to query (can be specified multiple times)",
-          "name": "keys",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "prefix": {
-          "char": "p",
-          "description": "Filter keys by prefix",
-          "name": "prefix",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "kv:list",
+      "id": "investigation:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List key-value keys",
+      "summary": "Get an investigation by ID",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "kv",
-        "list.js"
-      ]
-    },
-    "kv:set": {
-      "aliases": [],
-      "args": {
-        "key": {
-          "description": "Key to set",
-          "name": "key",
-          "required": true
-        },
-        "value": {
-          "description": "Value to store (JSON string)",
-          "name": "value",
-          "required": true
-        }
-      },
-      "description": "Set a value in the key-value store.\n\nStores a value associated with a key. The value should be a JSON string.",
-      "examples": [
-        "<%= config.bin %> kv set my-key '{\"data\": \"value\"}'",
-        "<%= config.bin %> kv set config '{\"setting\": true}'"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dev": {
-          "description": "Target the dev environment",
-          "exclusive": [
-            "stage"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "dev",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "stage": {
-          "description": "Target the stage environment",
-          "exclusive": [
-            "dev"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "stage",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "kv:set",
-      "pluginAlias": "@formant/formant-cli",
-      "pluginName": "@formant/formant-cli",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Set key-value",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "kv",
-        "set.js"
+        "investigation",
+        "get.js"
       ]
     },
-    "ingest:batch": {
+    "investigation:list": {
       "aliases": [],
       "args": {},
-      "description": "Ingest multiple data points in a single batch request.\n\nReads a JSON file (or stdin) containing a batch ingestion payload and sends all data points\nin a single API request. This is more efficient than sending individual data points when you\nhave multiple values to ingest.\n\nINPUT FORMAT:\nThe input JSON must have the following structure:\n{\n  \"items\": [\n    {\n      \"deviceId\": \"device-uuid\",        // Required: Device ID (UUID)\n      \"name\": \"stream-name\",             // Required: Stream name\n      \"type\": \"numeric|text|json|...\",   // Required: Data type (see below)\n      \"tags\": {\"key\": \"value\"},          // Optional: Tags object (string key-value pairs)\n      \"points\": [[timestamp_ms, value]]  // Required: Array of [timestamp, value] pairs\n    }\n  ]\n}\n\nSUPPORTED TYPES AND VALUE FORMATS:\n- numeric: Number value\n    Example: \"points\": [[1708272000000, 42.5]]\n\n- text: String value\n    Example: \"points\": [[1708272000000, \"hello world\"]]\n\n- json: JSON object encoded as string\n    Example: \"points\": [[1708272000000, \"{\\\"x\\\":10,\\\"y\\\":20}\"]]\n\n- image: Object with url (required), size and annotations (optional)\n    Example: \"points\": [[1708272000000, {\"url\": \"https://example.com/img.jpg\", \"size\": 102400}]]\n\n- video: Object with url, duration, mimeType (required), size (optional)\n    Example: \"points\": [[1708272000000, {\"url\": \"https://example.com/vid.mp4\", \"duration\": 30000, \"mimeType\": \"video/mp4\"}]]\n\n- bitset: Object with keys array and values array (1-1000 pairs)\n    Example: \"points\": [[1708272000000, {\"keys\": [\"door\", \"window\"], \"values\": [true, false]}]]\n\n- health: Object with status (required) and clockSkewMs (optional)\n    Example: \"points\": [[1708272000000, {\"status\": \"operational\", \"clockSkewMs\": 150}]]\n    Valid status values: \"unknown\", \"operational\", \"offline\", \"error\"\n\nEach item can have multiple points (timestamp/value pairs) for the same stream.\nTimestamps are Unix milliseconds (use Date.now() for current time).",
+      "description": "List investigations (AI-powered analysis workflows) in your organization.\n\nInvestigations are automated AI workflows that analyze signals, diagnose problems,\nand produce reports. Use --signal-handler to filter for investigations that are\ntriggered automatically by signals.",
       "examples": [
-        "<%= config.bin %> ingest batch --file data.json",
-        "<%= config.bin %> ingest batch --stdin < data.json",
-        "cat payload.json | <%= config.bin %> ingest batch --stdin",
-        "# Example payload.json with multiple types:\n{\n  \"items\": [\n    {\n      \"deviceId\": \"abc-123\",\n      \"name\": \"battery_level\",\n      \"type\": \"numeric\",\n      \"tags\": {\"env\": \"prod\"},\n      \"points\": [[1708272000000, 42.5], [1708272060000, 41.8]]\n    },\n    {\n      \"deviceId\": \"abc-123\",\n      \"name\": \"status\",\n      \"type\": \"text\",\n      \"tags\": {\"env\": \"prod\"},\n      \"points\": [[1708272000000, \"operational\"]]\n    },\n    {\n      \"deviceId\": \"abc-123\",\n      \"name\": \"health\",\n      \"type\": \"health\",\n      \"tags\": {},\n      \"points\": [[1708272000000, {\"status\": \"operational\"}]]\n    }\n  ]\n}"
+        "<%= config.bin %> investigation list",
+        "<%= config.bin %> investigation list --signal-handler",
+        "<%= config.bin %> investigation list --json"
       ],
       "flags": {
         "json": {
@@ -1869,158 +2174,49 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "file": {
-          "char": "f",
-          "description": "Path to JSON file containing batch payload",
-          "exclusive": [
-            "stdin"
-          ],
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stdin": {
-          "description": "Read JSON payload from stdin",
-          "exclusive": [
-            "file"
-          ],
-          "name": "stdin",
+        "signal-handler": {
+          "description": "Only show investigations that handle signals",
+          "name": "signal-handler",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ingest:batch",
+      "id": "investigation:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Ingest batch data from file or stdin",
+      "summary": "List investigations",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "ingest",
-        "batch.js"
+        "investigation",
+        "list.js"
       ]
     },
-    "ingest:bitset": {
+    "investigation:run": {
       "aliases": [],
-      "args": {},
-      "description": "Ingest a bitset data point to a device stream.\n\nSends a bitset (array of named boolean values) to the specified device stream. A bitset\nconsists of parallel arrays of keys (strings) and values (booleans).\n\nBitsets are useful for representing sets of binary states, flags, or boolean sensor readings\nwhere you have multiple named on/off states.\n\nConstraints:\n- Must have 1-1000 key/value pairs\n- Keys must be max 255 characters each\n- Keys and values arrays must have the same length",
-      "examples": [
-        "<%= config.bin %> ingest bitset --device <device-id> --stream sensors --keys \"door,window,motion\" --values \"true,false,true\"",
-        "<%= config.bin %> ingest bitset --device <device-id> --stream flags --keys \"active,paused,error\" --values \"true,false,false\" --tag system=main",
-        "<%= config.bin %> ingest bitset --device <device-id> --stream states --keys \"a,b\" --values \"false,true\""
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dev": {
-          "description": "Target the dev environment",
-          "exclusive": [
-            "stage"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "dev",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "stage": {
-          "description": "Target the stage environment",
-          "exclusive": [
-            "dev"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "stage",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "char": "s",
-          "description": "Stream name",
-          "name": "stream",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "keys": {
-          "char": "k",
-          "description": "Comma-separated list of key names (1-1000 keys, max 255 chars each)",
-          "name": "keys",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "values": {
-          "char": "v",
-          "description": "Comma-separated list of boolean values (true/false, must match key count)",
-          "name": "values",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tag": {
-          "char": "t",
-          "description": "Tag as key=value where both are strings (can be specified multiple times)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+      "args": {
+        "investigationId": {
+          "description": "Investigation (taskflow) ID",
+          "name": "investigationId",
+          "required": true
         },
-        "timestamp": {
-          "description": "Unix timestamp in milliseconds (defaults to now)",
-          "name": "timestamp",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "runId": {
+          "description": "Run ID",
+          "name": "runId",
+          "required": true
         }
       },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "ingest:bitset",
-      "pluginAlias": "@formant/formant-cli",
-      "pluginName": "@formant/formant-cli",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Ingest bitset data",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "ingest",
-        "bitset.js"
-      ]
-    },
-    "ingest:health": {
-      "aliases": [],
-      "args": {},
-      "description": "Ingest a health status data point to a device stream.\n\nSends device health status information to the specified stream. Health data consists of:\n- status: One of \"unknown\", \"operational\", \"offline\", or \"error\"\n- clockSkewMs (optional): Clock skew in milliseconds between device and server\n\nHealth streams are used to track device operational state, system health, and time synchronization.",
+      "description": "Get detailed information about a specific investigation run.\n\nShows run details including status, signal information, events, and the complete execution \nlog with node inputs/outputs, task messages, tool usage, and results.\n\nUse this to trace the investigation run back to its signal and triggering event.",
       "examples": [
-        "<%= config.bin %> ingest health --device <device-id> --stream system_health --status operational",
-        "<%= config.bin %> ingest health --device <device-id> --stream health --status error --tag component=motor",
-        "<%= config.bin %> ingest health --device <device-id> --stream sync --status operational --clock-skew 150"
+        "<%= config.bin %> investigation run <investigation-id> <run-id>",
+        "<%= config.bin %> investigation run <investigation-id> <run-id> --log-only",
+        "<%= config.bin %> investigation run <investigation-id> <run-id> --json"
       ],
       "flags": {
         "json": {
@@ -2050,196 +2246,50 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "char": "s",
-          "description": "Stream name",
-          "name": "stream",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "status": {
-          "description": "Health status (unknown, operational, offline, or error)",
-          "name": "status",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "unknown",
-            "operational",
-            "offline",
-            "error"
-          ],
-          "type": "option"
-        },
-        "clock-skew": {
-          "description": "Clock skew in milliseconds (optional)",
-          "name": "clock-skew",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tag": {
-          "char": "t",
-          "description": "Tag as key=value where both are strings (can be specified multiple times)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "timestamp": {
-          "description": "Unix timestamp in milliseconds (defaults to now)",
-          "name": "timestamp",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "ingest:health",
-      "pluginAlias": "@formant/formant-cli",
-      "pluginName": "@formant/formant-cli",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Ingest health status data",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "ingest",
-        "health.js"
-      ]
-    },
-    "ingest:image": {
-      "aliases": [],
-      "args": {},
-      "description": "Ingest an image URL to a device stream.\n\nSends an image reference (by URL) to the specified device stream. The image must be accessible\nvia HTTP/HTTPS. Formant will fetch and store the image from the provided URL.\n\nImage streams are used for camera feeds, snapshots, diagnostic images, etc.",
-      "examples": [
-        "<%= config.bin %> ingest image --device <device-id> --stream camera_front --url https://example.com/image.jpg",
-        "<%= config.bin %> ingest image --device <device-id> --stream snapshot --url https://example.com/snap.png --size 1024000",
-        "<%= config.bin %> ingest image --device <device-id> --stream detection --url https://example.com/detect.jpg --tag frame=123"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dev": {
-          "description": "Target the dev environment",
-          "exclusive": [
-            "stage"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "dev",
+        "log-only": {
+          "description": "Only show the execution log (skip run details)",
+          "name": "log-only",
           "allowNo": false,
           "type": "boolean"
         },
-        "stage": {
-          "description": "Target the stage environment",
-          "exclusive": [
-            "dev"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "stage",
+        "trace-signal": {
+          "description": "Fetch and display the signal and event information for this run",
+          "name": "trace-signal",
           "allowNo": false,
           "type": "boolean"
-        },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "char": "s",
-          "description": "Stream name",
-          "name": "stream",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "url": {
-          "char": "u",
-          "description": "Image URL (must be http:// or https://)",
-          "name": "url",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "size": {
-          "description": "Image size in bytes (optional)",
-          "name": "size",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tag": {
-          "char": "t",
-          "description": "Tag as key=value where both are strings (can be specified multiple times)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "timestamp": {
-          "description": "Unix timestamp in milliseconds (defaults to now)",
-          "name": "timestamp",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ingest:image",
+      "id": "investigation:run",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Ingest image data",
+      "summary": "Get investigation run details and execution log",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "ingest",
-        "image.js"
+        "investigation",
+        "run.js"
       ]
     },
-    "ingest:json": {
+    "investigation:runs-list": {
       "aliases": [],
       "args": {
-        "value": {
-          "description": "JSON value to ingest (as a JSON string)",
-          "name": "value",
+        "id": {
+          "description": "Investigation (taskflow) ID",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Ingest a JSON data point to a device stream.\n\nSends structured JSON data to the specified device stream. The value must be valid JSON.\nJSON streams are used for complex structured data like configuration objects, state machines,\nnested telemetry, etc.\n\nNote: The JSON is sent as a JSON-encoded string to Formant.",
+      "description": "List actual investigation runs (not evaluation runs) for a specific investigation.\n\nShows runs with their status, signal IDs, and timestamps. Use 'investigations run' to see\ndetailed execution logs for a specific run.",
       "examples": [
-        "<%= config.bin %> ingest json '{\"x\":1,\"y\":2}' --device <device-id> --stream position",
-        "<%= config.bin %> ingest json '{\"status\":\"active\",\"mode\":\"auto\"}' --device <device-id> --stream config",
-        "<%= config.bin %> ingest json '[1,2,3,4,5]' --device <device-id> --stream array_data"
+        "<%= config.bin %> investigation runs-list <id>",
+        "<%= config.bin %> investigation runs-list <id> --limit 50",
+        "<%= config.bin %> investigation runs-list <id> --details --json"
       ],
       "flags": {
         "json": {
@@ -2269,35 +2319,26 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "details": {
+          "description": "Include detailed information about each run",
+          "name": "details",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "stream": {
-          "char": "s",
-          "description": "Stream name",
-          "name": "stream",
-          "required": true,
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of runs to return",
+          "name": "limit",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "char": "t",
-          "description": "Tag as key=value where both are strings (can be specified multiple times)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "timestamp": {
-          "description": "Unix timestamp in milliseconds (defaults to now)",
-          "name": "timestamp",
+        "offset": {
+          "char": "o",
+          "description": "Offset for pagination",
+          "name": "offset",
+          "default": 0,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2305,35 +2346,34 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ingest:json",
+      "id": "investigation:runs-list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Ingest JSON data",
+      "summary": "List actual investigation runs",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "ingest",
-        "json.js"
+        "investigation",
+        "runs-list.js"
       ]
     },
-    "ingest:numeric": {
+    "investigation:runs": {
       "aliases": [],
       "args": {
-        "value": {
-          "description": "Numeric value to ingest",
-          "name": "value",
+        "id": {
+          "description": "Investigation (taskflow) ID",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Ingest a numeric data point to a device stream.\n\nSends a single numeric value to the specified device stream. The value must be a valid number.\nNumeric streams are commonly used for sensor readings like battery level, temperature, speed, etc.",
+      "description": "List evaluation runs for a specific investigation.",
       "examples": [
-        "<%= config.bin %> ingest numeric 42.5 --device <device-id> --stream battery_level",
-        "<%= config.bin %> ingest numeric 98.6 --device <device-id> --stream temperature --tag unit=fahrenheit",
-        "<%= config.bin %> ingest numeric 1500 --device <device-id> --stream rpm --timestamp 1700000000000"
+        "<%= config.bin %> investigation runs <id>",
+        "<%= config.bin %> investigation runs <id> --json"
       ],
       "flags": {
         "json": {
@@ -2362,72 +2402,32 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "char": "s",
-          "description": "Stream name",
-          "name": "stream",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tag": {
-          "char": "t",
-          "description": "Tag as key=value where both are strings (can be specified multiple times)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "timestamp": {
-          "description": "Unix timestamp in milliseconds (defaults to now)",
-          "name": "timestamp",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ingest:numeric",
+      "id": "investigation:runs",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Ingest numeric data",
+      "summary": "List runs for an investigation",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "ingest",
-        "numeric.js"
+        "investigation",
+        "runs.js"
       ]
     },
-    "ingest:text": {
+    "investigation:stats": {
       "aliases": [],
-      "args": {
-        "value": {
-          "description": "Text value to ingest",
-          "name": "value",
-          "required": true
-        }
-      },
-      "description": "Ingest a text data point to a device stream.\n\nSends a single text/string value to the specified device stream. Text streams are commonly\nused for logs, status messages, error messages, and other string data.",
+      "args": {},
+      "description": "Get investigation statistics for a time range.",
       "examples": [
-        "<%= config.bin %> ingest text \"Robot started successfully\" --device <device-id> --stream status",
-        "<%= config.bin %> ingest text \"Error: sensor offline\" --device <device-id> --stream errors --tag severity=high",
-        "<%= config.bin %> ingest text \"Checkpoint A reached\" --device <device-id> --stream waypoints"
+        "<%= config.bin %> investigation stats --start 2026-01-01 --end 2026-02-01",
+        "<%= config.bin %> investigation stats --start 2026-01-01 --end 2026-02-01 --json"
       ],
       "flags": {
         "json": {
@@ -2457,65 +2457,53 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
+        "end": {
+          "description": "End time (ISO 8601)",
+          "name": "end",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "stream": {
-          "char": "s",
-          "description": "Stream name",
-          "name": "stream",
+        "start": {
+          "description": "Start time (ISO 8601)",
+          "name": "start",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "tag": {
-          "char": "t",
-          "description": "Tag as key=value where both are strings (can be specified multiple times)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "timestamp": {
-          "description": "Unix timestamp in milliseconds (defaults to now)",
-          "name": "timestamp",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ingest:text",
+      "id": "investigation:stats",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Ingest text data",
+      "summary": "Get investigation stats",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "ingest",
-        "text.js"
+        "investigation",
+        "stats.js"
       ]
     },
-    "ingest:video": {
+    "investigation:trigger": {
       "aliases": [],
-      "args": {},
-      "description": "Ingest a video URL to a device stream.\n\nSends a video reference (by URL) to the specified device stream. The video must be accessible\nvia HTTP/HTTPS. You must provide the video duration in milliseconds.\n\nVideo streams are used for recorded video clips, timelapse videos, event recordings, etc.\n\nThe MIME type is auto-detected from the file extension (.mp4, .webm, .mov).",
+      "args": {
+        "id": {
+          "description": "Investigation (taskflow) ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Trigger an investigation to run. Provide input text describing the problem\nor context for the investigation. The investigation runs asynchronously and\nreturns a run ID you can use to check results.",
       "examples": [
-        "<%= config.bin %> ingest video --device <device-id> --stream recordings --url https://example.com/video.mp4 --duration 5000",
-        "<%= config.bin %> ingest video --device <device-id> --stream clips --url https://example.com/clip.webm --duration 3500 --size 2048000",
-        "<%= config.bin %> ingest video --device <device-id> --stream event_video --url https://example.com/event.mov --duration 10000 --tag event=collision"
+        "<%= config.bin %> investigation trigger <id> --input \"Robot stopped responding\"",
+        "<%= config.bin %> investigation trigger <id> --input \"Battery draining fast on device X\" --json"
       ],
       "flags": {
         "json": {
@@ -2545,89 +2533,114 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "char": "s",
-          "description": "Stream name",
-          "name": "stream",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "url": {
-          "char": "u",
-          "description": "Video URL (must be http:// or https://)",
-          "name": "url",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "duration": {
-          "description": "Video duration in milliseconds (required)",
-          "name": "duration",
+        "input": {
+          "char": "i",
+          "description": "Input text / problem description for the investigation",
+          "name": "input",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "size": {
-          "description": "Video size in bytes (optional)",
-          "name": "size",
+        "signal-id": {
+          "description": "Optional signal ID to associate with this run",
+          "name": "signal-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "investigation:trigger",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Trigger an investigation",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "investigation",
+        "trigger.js"
+      ]
+    },
+    "device:config": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Device ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get the device configuration including stream definitions.\n\nShows the device's current configuration including telemetry streams, commands,\nand other settings.",
+      "examples": [
+        "<%= config.bin %> device config <device-id>",
+        "<%= config.bin %> device config <device-id> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "tag": {
-          "char": "t",
-          "description": "Tag as key=value where both are strings (can be specified multiple times)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "dev": {
+          "description": "Target the dev environment",
+          "exclusive": [
+            "stage"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "dev",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "timestamp": {
-          "description": "Unix timestamp in milliseconds (defaults to now)",
-          "name": "timestamp",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "stage": {
+          "description": "Target the stage environment",
+          "exclusive": [
+            "dev"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "stage",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ingest:video",
+      "id": "device:config",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Ingest video data",
+      "summary": "Get device configuration",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "ingest",
-        "video.js"
+        "device",
+        "config.js"
       ]
     },
-    "investigation:analytics": {
+    "device:create": {
       "aliases": [],
-      "args": {},
-      "description": "Get investigation analytics with time-series data.\n\nReturns aggregated analytics about investigation runs over a time range,\noptionally grouped by result type or signal type.",
+      "args": {
+        "name": {
+          "description": "Name for the new device",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Create a new device in your fleet.\n\nThe device is created as enabled by default. You can optionally specify tags.",
       "examples": [
-        "<%= config.bin %> investigation analytics --start 2026-01-01 --end 2026-02-01",
-        "<%= config.bin %> investigation analytics --start 2026-01-01 --end 2026-02-01 --interval hourly",
-        "<%= config.bin %> investigation analytics --start 2026-01-01 --end 2026-02-01 --group-by resultType --json"
+        "<%= config.bin %> device create my-robot",
+        "<%= config.bin %> device create my-robot --tag location=warehouse --tag env=prod",
+        "<%= config.bin %> device create my-robot --json"
       ],
       "flags": {
         "json": {
@@ -2657,76 +2670,45 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "end": {
-          "description": "End time (ISO 8601)",
-          "name": "end",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "group-by": {
-          "description": "Group results by",
-          "name": "group-by",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "resultType",
-            "signalType"
-          ],
-          "type": "option"
-        },
-        "interval": {
-          "description": "Time interval for aggregation",
-          "name": "interval",
-          "default": "daily",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "daily",
-            "hourly"
-          ],
-          "type": "option"
-        },
-        "start": {
-          "description": "Start time (ISO 8601)",
-          "name": "start",
-          "required": true,
+        "tag": {
+          "char": "t",
+          "description": "Tag to apply (key=value), can be specified multiple times",
+          "name": "tag",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigation:analytics",
+      "id": "device:create",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get investigation analytics",
+      "summary": "Create a new device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "investigation",
-        "analytics.js"
+        "device",
+        "create.js"
       ]
     },
-    "investigation:get": {
+    "device:delete": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Investigation (taskflow) ID",
+          "description": "Device ID (UUID)",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get detailed information about a specific investigation by ID.",
+      "description": "Delete (disable) a device from your fleet.\n\nThis performs a soft-delete by disabling the device. The device and its telemetry\nhistory are preserved but it will no longer appear in device listings.",
       "examples": [
-        "<%= config.bin %> investigation get <id>",
-        "<%= config.bin %> investigation get <id> --json"
+        "<%= config.bin %> device delete <device-id>",
+        "<%= config.bin %> device delete <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -2759,29 +2741,34 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigation:get",
+      "id": "device:delete",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get an investigation by ID",
+      "summary": "Delete (disable) a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "investigation",
-        "get.js"
+        "device",
+        "delete.js"
       ]
     },
-    "investigation:list": {
+    "device:get": {
       "aliases": [],
-      "args": {},
-      "description": "List investigations (AI-powered analysis workflows) in your organization.\n\nInvestigations are automated AI workflows that analyze signals, diagnose problems,\nand produce reports. Use --signal-handler to filter for investigations that are\ntriggered automatically by signals.",
+      "args": {
+        "id": {
+          "description": "Device ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get detailed information about a specific device by its ID.",
       "examples": [
-        "<%= config.bin %> investigation list",
-        "<%= config.bin %> investigation list --signal-handler",
-        "<%= config.bin %> investigation list --json"
+        "<%= config.bin %> device get <device-id>",
+        "<%= config.bin %> device get <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -2810,50 +2797,37 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "signal-handler": {
-          "description": "Only show investigations that handle signals",
-          "name": "signal-handler",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigation:list",
+      "id": "device:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List investigations",
+      "summary": "Get a device by ID",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "investigation",
-        "list.js"
+        "device",
+        "get.js"
       ]
     },
-    "investigation:run": {
+    "device:list": {
       "aliases": [],
-      "args": {
-        "investigationId": {
-          "description": "Investigation (taskflow) ID",
-          "name": "investigationId",
-          "required": true
-        },
-        "runId": {
-          "description": "Run ID",
-          "name": "runId",
-          "required": true
-        }
-      },
-      "description": "Get detailed information about a specific investigation run.\n\nShows run details including status, signal information, events, and the complete execution \nlog with node inputs/outputs, task messages, tool usage, and results.\n\nUse this to trace the investigation run back to its signal and triggering event.",
+      "args": {},
+      "description": "List robots and sensors in your fleet. Shows only online devices by default.\n\nUse --include-offline to include offline devices. Use --with-data to show only\ndevices that have ingested data. Each device is enriched with data-based last\nseen timestamp and datapoint count from analytics.",
       "examples": [
-        "<%= config.bin %> investigation run <investigation-id> <run-id>",
-        "<%= config.bin %> investigation run <investigation-id> <run-id> --log-only",
-        "<%= config.bin %> investigation run <investigation-id> <run-id> --json"
+        "<%= config.bin %> device list",
+        "<%= config.bin %> device list --include-offline",
+        "<%= config.bin %> device list --with-data",
+        "<%= config.bin %> device list --with-data --days 90",
+        "<%= config.bin %> device list --include-offline --limit 100",
+        "<%= config.bin %> device list --tag location=warehouse",
+        "<%= config.bin %> device list --name robot --dev --json"
       ],
       "flags": {
         "json": {
@@ -2883,50 +2857,89 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "log-only": {
-          "description": "Only show the execution log (skip run details)",
-          "name": "log-only",
+        "include-offline": {
+          "char": "a",
+          "description": "Include offline devices",
+          "name": "include-offline",
           "allowNo": false,
           "type": "boolean"
         },
-        "trace-signal": {
-          "description": "Fetch and display the signal and event information for this run",
-          "name": "trace-signal",
+        "days": {
+          "description": "How many days back to search for last seen data",
+          "name": "days",
+          "default": 30,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of devices to return",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "Filter devices by name (search)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "with-data": {
+          "char": "w",
+          "description": "Only show devices that have data in the last --days window",
+          "name": "with-data",
           "allowNo": false,
           "type": "boolean"
+        },
+        "tag": {
+          "char": "t",
+          "description": "Filter by tag (key=value), can be specified multiple times",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigation:run",
+      "id": "device:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get investigation run details and execution log",
+      "summary": "List robots and sensors in your fleet",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "investigation",
-        "run.js"
+        "device",
+        "list.js"
       ]
     },
-    "investigation:runs-list": {
+    "device:rename": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Investigation (taskflow) ID",
+          "description": "Device ID (UUID)",
           "name": "id",
           "required": true
+        },
+        "name": {
+          "description": "New name for the device",
+          "name": "name",
+          "required": true
         }
       },
-      "description": "List actual investigation runs (not evaluation runs) for a specific investigation.\n\nShows runs with their status, signal IDs, and timestamps. Use 'investigations run' to see\ndetailed execution logs for a specific run.",
+      "description": "Rename a device by updating its name.",
       "examples": [
-        "<%= config.bin %> investigation runs-list <id>",
-        "<%= config.bin %> investigation runs-list <id> --limit 50",
-        "<%= config.bin %> investigation runs-list <id> --details --json"
+        "<%= config.bin %> device rename <device-id> new-robot-name",
+        "<%= config.bin %> device rename <device-id> new-robot-name --json"
       ],
       "flags": {
         "json": {
@@ -2955,62 +2968,40 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "details": {
-          "description": "Include detailed information about each run",
-          "name": "details",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "limit": {
-          "char": "l",
-          "description": "Maximum number of runs to return",
-          "name": "limit",
-          "default": 20,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "offset": {
-          "char": "o",
-          "description": "Offset for pagination",
-          "name": "offset",
-          "default": 0,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigation:runs-list",
+      "id": "device:rename",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List actual investigation runs",
+      "summary": "Rename a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "investigation",
-        "runs-list.js"
+        "device",
+        "rename.js"
       ]
     },
-    "investigation:runs": {
+    "device:streams": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Investigation (taskflow) ID",
+          "description": "Device ID (UUID)",
           "name": "id",
           "required": true
         }
       },
-      "description": "List evaluation runs for a specific investigation.",
+      "description": "List telemetry streams for a device with data presence.\n\nShows streams from the device configuration and any streams discovered from\ningested data. Each stream is enriched with presence info from the analytics\nbackend: data point count, last seen time, and a freshness indicator\n(active/recent/stale/dormant).\n\nUnconfigured streams (discovered from data only) are marked with SOURCE \"data\".",
       "examples": [
-        "<%= config.bin %> investigation runs <id>",
-        "<%= config.bin %> investigation runs <id> --json"
+        "<%= config.bin %> device streams <device-id>",
+        "<%= config.bin %> device streams <device-id> --with-data",
+        "<%= config.bin %> device streams <device-id> --with-data --days 30",
+        "<%= config.bin %> device streams <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -3039,32 +3030,54 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "days": {
+          "description": "How many days back to look for stream data presence",
+          "name": "days",
+          "default": 7,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "with-data": {
+          "char": "w",
+          "description": "Only show streams that have data in the --days window",
+          "name": "with-data",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigation:runs",
+      "id": "device:streams",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List runs for an investigation",
+      "summary": "List device streams with data presence",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "investigation",
-        "runs.js"
+        "device",
+        "streams.js"
       ]
     },
-    "investigation:stats": {
+    "device:tag": {
       "aliases": [],
-      "args": {},
-      "description": "Get investigation statistics for a time range.",
+      "args": {
+        "id": {
+          "description": "Device ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Add or update tags on a device.\n\nTags are key-value pairs. If a tag key already exists, its value will be updated.\nSpecify one or more tags with --tag key=value.",
       "examples": [
-        "<%= config.bin %> investigation stats --start 2026-01-01 --end 2026-02-01",
-        "<%= config.bin %> investigation stats --start 2026-01-01 --end 2026-02-01 --json"
+        "<%= config.bin %> device tag <device-id> --tag location=warehouse",
+        "<%= config.bin %> device tag <device-id> --tag env=prod --tag region=us-east",
+        "<%= config.bin %> device tag <device-id> --tag location=factory --json"
       ],
       "flags": {
         "json": {
@@ -3094,53 +3107,47 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "end": {
-          "description": "End time (ISO 8601)",
-          "name": "end",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start": {
-          "description": "Start time (ISO 8601)",
-          "name": "start",
+        "tag": {
+          "char": "t",
+          "description": "Tag to add or update (key=value), can be specified multiple times",
+          "name": "tag",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigation:stats",
+      "id": "device:tag",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get investigation stats",
+      "summary": "Add or update tags on a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "investigation",
-        "stats.js"
+        "device",
+        "tag.js"
       ]
     },
-    "investigation:trigger": {
+    "device:untag": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Investigation (taskflow) ID",
+          "description": "Device ID (UUID)",
           "name": "id",
           "required": true
         }
       },
-      "description": "Trigger an investigation to run. Provide input text describing the problem\nor context for the investigation. The investigation runs asynchronously and\nreturns a run ID you can use to check results.",
+      "description": "Remove tags from a device.\n\nSpecify one or more tag keys to remove with --key.",
       "examples": [
-        "<%= config.bin %> investigation trigger <id> --input \"Robot stopped responding\"",
-        "<%= config.bin %> investigation trigger <id> --input \"Battery draining fast on device X\" --json"
+        "<%= config.bin %> device untag <device-id> --key location",
+        "<%= config.bin %> device untag <device-id> --key env --key region",
+        "<%= config.bin %> device untag <device-id> --key location --json"
       ],
       "flags": {
         "json": {
@@ -3170,48 +3177,44 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "input": {
-          "char": "i",
-          "description": "Input text / problem description for the investigation",
-          "name": "input",
+        "key": {
+          "char": "k",
+          "description": "Tag key to remove, can be specified multiple times",
+          "name": "key",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "signal-id": {
-          "description": "Optional signal ID to associate with this run",
-          "name": "signal-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigation:trigger",
+      "id": "device:untag",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Trigger an investigation",
+      "summary": "Remove tags from a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "investigation",
-        "trigger.js"
+        "device",
+        "untag.js"
       ]
     },
     "query": {
       "aliases": [],
       "args": {},
-      "description": "Query telemetry stream data for a device over a time range.\n\nReturns time-series datapoints for the specified stream(s). Supports aggregation\nfor downsampling large datasets, and --latest to get only the most recent value.\n\nStream types: numeric, text, image, video, location, json, bitset, battery, health,\n\"numeric set\", \"point cloud\", localization, \"transform tree\", file.\n\nAggregate levels: second, 5 seconds, 30 seconds, minute, 5 minutes, 30 minutes,\nhour, 4 hours, 12 hours, day, week, month, year.",
+      "description": "Query telemetry stream data for a device over a time range.\n\nReturns time-series datapoints for the specified stream(s). Supports aggregation\nfor downsampling large datasets, and --latest-values-only to get only the most recent value.\n\nUse --all-streams with --latest-values-only to automatically discover and query all\nstreams — both from the device configuration and from actual ingested data\n(unconfigured streams included).\n\nStream types: numeric, text, image, video, location, json, bitset, battery, health,\n\"numeric set\", \"point cloud\", localization, \"transform tree\", file.\n\nAggregate levels: second, 5 seconds, 30 seconds, minute, 5 minutes, 30 minutes,\nhour, 4 hours, 12 hours, day, week, month, year.",
       "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"
       ],
       "flags": {
@@ -3250,25 +3253,40 @@
           "multiple": false,
           "type": "option"
         },
+        "all-streams": {
+          "description": "Query all streams for the device — from config and from ingested data (requires single --device and --latest-values-only)",
+          "name": "all-streams",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "days": {
+          "description": "How many days back to look for unconfigured streams when using --all-streams",
+          "name": "days",
+          "default": 14,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "device": {
           "char": "d",
-          "description": "Device ID (UUID)",
+          "description": "Device ID(s), can be specified multiple times",
           "name": "device",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "end": {
           "description": "End time (ISO 8601)",
           "name": "end",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "latest": {
+        "latest-values-only": {
           "description": "Only return the most recent value per stream",
-          "name": "latest",
+          "name": "latest-values-only",
           "allowNo": false,
           "type": "boolean"
         },
@@ -3283,6 +3301,7 @@
         "start": {
           "description": "Start time (ISO 8601)",
           "name": "start",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3291,7 +3310,6 @@
           "char": "s",
           "description": "Stream name(s), can be specified multiple times",
           "name": "stream",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
@@ -3321,93 +3339,6 @@
         "index.js"
       ]
     },
-    "query:latest-values": {
-      "aliases": [],
-      "args": {},
-      "description": "Get the latest values for streams across devices.\n\nReturns the most recent value for specified streams without needing to specify\na time range. Useful for checking current sensor readings.\n\nUse --all-streams with a single device to automatically discover and query all\nstreams — both from the device configuration and from actual ingested data\n(unconfigured streams included).",
-      "examples": [
-        "<%= config.bin %> query latest-values --device <id> --stream battery_level",
-        "<%= config.bin %> query latest-values --device <id> --stream temperature --stream humidity",
-        "<%= config.bin %> query latest-values --device <id> --all-streams",
-        "<%= config.bin %> query latest-values --device <id> --all-streams --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dev": {
-          "description": "Target the dev environment",
-          "exclusive": [
-            "stage"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "dev",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "stage": {
-          "description": "Target the stage environment",
-          "exclusive": [
-            "dev"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "stage",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "all-streams": {
-          "description": "Query all streams for the device — from config and from ingested data (requires single --device)",
-          "name": "all-streams",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "days": {
-          "description": "How many days back to look for unconfigured streams when using --all-streams",
-          "name": "days",
-          "default": 14,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "stream": {
-          "char": "s",
-          "description": "Stream name(s), can be specified multiple times",
-          "name": "stream",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "query:latest-values",
-      "pluginAlias": "@formant/formant-cli",
-      "pluginName": "@formant/formant-cli",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Get latest stream values",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "query",
-        "latest-values.js"
-      ]
-    },
     "persona:delegate-task": {
       "aliases": [],
       "args": {
@@ -4347,5 +4278,5 @@
       ]
     }
   },
-  "version": "0.4.3"
+  "version": "0.4.5"
 }