@formant/formant-cli 0.1.0 → 0.2.0

package/oclif.manifest.json

@@ -140,173 +140,6 @@
         "tables.js"
       ]
     },
-    "events:get": {
-      "aliases": [],
-      "args": {
-        "id": {
-          "description": "Event ID (UUID)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get detailed information about a specific event by its ID.",
-      "examples": [
-        "<%= config.bin %> events get <event-id>",
-        "<%= config.bin %> events get <event-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": "events:get",
-      "pluginAlias": "@formant/formant-cli",
-      "pluginName": "@formant/formant-cli",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Get an event by ID",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "events",
-        "get.js"
-      ]
-    },
-    "events:list": {
-      "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.",
-      "examples": [
-        "<%= config.bin %> events list",
-        "<%= config.bin %> events list --device <id> --severity critical",
-        "<%= config.bin %> events list --type device-offline --start 2026-01-01 --end 2026-01-02",
-        "<%= config.bin %> events list --limit 100 --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"
-        },
-        "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": "events:list",
-      "pluginAlias": "@formant/formant-cli",
-      "pluginName": "@formant/formant-cli",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "View events emitted by devices",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "events",
-        "list.js"
-      ]
-    },
     "event-triggers:get": {
       "aliases": [],
       "args": {
@@ -871,19 +704,19 @@
         "list.js"
       ]
     },
-    "kv:get": {
+    "devices:config": {
       "aliases": [],
       "args": {
-        "key": {
-          "description": "Key to retrieve",
-          "name": "key",
+        "id": {
+          "description": "Device ID (UUID)",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Get a value from the key-value store.\n\nThe key-value store allows devices and applications to store metadata.",
+      "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 %> kv get my-key",
-        "<%= config.bin %> kv get my-key --json"
+        "<%= config.bin %> devices config <device-id>",
+        "<%= config.bin %> devices config <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -916,30 +749,35 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "kv:get",
+      "id": "devices:config",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get key-value",
+      "summary": "Get device configuration",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "kv",
-        "get.js"
+        "devices",
+        "config.js"
       ]
     },
-    "kv:list": {
+    "devices:create": {
       "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": {
+        "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 %> 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 %> devices create my-robot",
+        "<%= config.bin %> devices create my-robot --tag location=warehouse --tag env=prod",
+        "<%= config.bin %> devices create my-robot --json"
       ],
       "flags": {
         "json": {
@@ -969,58 +807,45 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "keys": {
-          "char": "k",
-          "description": "Specific keys to query (can be specified multiple times)",
-          "name": "keys",
+        "tag": {
+          "char": "t",
+          "description": "Tag to apply (key=value), can be specified multiple times",
+          "name": "tag",
           "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": "devices:create",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List key-value keys",
+      "summary": "Create a new device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "kv",
-        "list.js"
+        "devices",
+        "create.js"
       ]
     },
-    "kv:set": {
+    "devices:delete": {
       "aliases": [],
       "args": {
-        "key": {
-          "description": "Key to set",
-          "name": "key",
-          "required": true
-        },
-        "value": {
-          "description": "Value to store (JSON string)",
-          "name": "value",
+        "id": {
+          "description": "Device ID (UUID)",
+          "name": "id",
           "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.",
+      "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 %> kv set my-key '{\"data\": \"value\"}'",
-        "<%= config.bin %> kv set config '{\"setting\": true}'"
+        "<%= config.bin %> devices delete <device-id>",
+        "<%= config.bin %> devices delete <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -1053,30 +878,34 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "kv:set",
+      "id": "devices:delete",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Set key-value",
+      "summary": "Delete (disable) a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "kv",
-        "set.js"
+        "devices",
+        "delete.js"
       ]
     },
-    "query": {
+    "devices:get": {
       "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.",
+      "args": {
+        "id": {
+          "description": "Device ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get detailed information about a specific device by its ID.",
       "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 temperature --type numeric --json"
+        "<%= config.bin %> devices get <device-id>",
+        "<%= config.bin %> devices get <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -1105,95 +934,38 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "aggregate": {
-          "char": "a",
-          "description": "Aggregation level for downsampling",
-          "name": "aggregate",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end": {
-          "description": "End time (ISO 8601)",
-          "name": "end",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "latest": {
-          "description": "Only return the most recent value per stream",
-          "name": "latest",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "limit": {
-          "char": "l",
-          "description": "Maximum number of datapoints",
-          "name": "limit",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start": {
-          "description": "Start time (ISO 8601)",
-          "name": "start",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "char": "s",
-          "description": "Stream name(s), can be specified multiple times",
-          "name": "stream",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "type": {
-          "description": "Filter by stream type",
-          "name": "type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "query",
+      "id": "devices:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Query telemetry stream data",
+      "summary": "Get a device by ID",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "query",
-        "index.js"
+        "devices",
+        "get.js"
       ]
     },
-    "query:latest-values": {
+    "devices:last-seen": {
       "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\nconfigured streams from the device configuration.",
+      "args": {
+        "id": {
+          "description": "Device ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get when a device was last seen online.\n\nShows the most recent timestamp when the device was detected as online.",
       "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"
+        "<%= config.bin %> devices last-seen <device-id>",
+        "<%= config.bin %> devices last-seen <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -1222,61 +994,35 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "all-streams": {
-          "description": "Query all configured streams for the device (requires single --device)",
-          "name": "all-streams",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "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",
+      "id": "devices:last-seen",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get latest stream values",
+      "summary": "Get device last seen timestamp",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "query",
-        "latest-values.js"
+        "devices",
+        "last-seen.js"
       ]
     },
-    "devices:config": {
+    "devices:list": {
       "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.",
+      "args": {},
+      "description": "List robots and sensors in your fleet. Shows only online devices by default.\n\nUse --all to include offline devices.",
       "examples": [
-        "<%= config.bin %> devices config <device-id>",
-        "<%= config.bin %> devices config <device-id> --json"
+        "<%= config.bin %> devices list",
+        "<%= config.bin %> devices list --all",
+        "<%= config.bin %> devices list --all --limit 100",
+        "<%= config.bin %> devices list --tag location=warehouse",
+        "<%= config.bin %> devices list --name robot --dev --json"
       ],
       "flags": {
         "json": {
@@ -1305,38 +1051,75 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "all": {
+          "char": "a",
+          "description": "Show all devices (online and offline)",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "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"
+        },
+        "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": "devices:config",
+      "id": "devices:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get device configuration",
+      "summary": "List robots and sensors in your fleet",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "devices",
-        "config.js"
+        "list.js"
       ]
     },
-    "devices:get": {
+    "devices:rename": {
       "aliases": [],
       "args": {
         "id": {
           "description": "Device ID (UUID)",
           "name": "id",
           "required": true
+        },
+        "name": {
+          "description": "New name for the device",
+          "name": "name",
+          "required": true
         }
       },
-      "description": "Get detailed information about a specific device by its ID.",
+      "description": "Rename a device by updating its name.",
       "examples": [
-        "<%= config.bin %> devices get <device-id>",
-        "<%= config.bin %> devices get <device-id> --json"
+        "<%= config.bin %> devices rename <device-id> new-robot-name",
+        "<%= config.bin %> devices rename <device-id> new-robot-name --json"
       ],
       "flags": {
         "json": {
@@ -1369,22 +1152,22 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:get",
+      "id": "devices:rename",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get a device by ID",
+      "summary": "Rename a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "devices",
-        "get.js"
+        "rename.js"
       ]
     },
-    "devices:last-seen": {
+    "devices:streams": {
       "aliases": [],
       "args": {
         "id": {
@@ -1393,10 +1176,10 @@
           "required": true
         }
       },
-      "description": "Get when a device was last seen online.\n\nShows the most recent timestamp when the device was detected as online.",
+      "description": "List telemetry streams configured on a device.\n\nShows a clean view of stream definitions parsed from the device configuration,\nincluding stream names, types, topics, and quality settings.",
       "examples": [
-        "<%= config.bin %> devices last-seen <device-id>",
-        "<%= config.bin %> devices last-seen <device-id> --json"
+        "<%= config.bin %> devices streams <device-id>",
+        "<%= config.bin %> devices streams <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -1429,31 +1212,35 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:last-seen",
+      "id": "devices:streams",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get device last seen timestamp",
+      "summary": "List device streams",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "devices",
-        "last-seen.js"
+        "streams.js"
       ]
     },
-    "devices:list": {
+    "devices:tag": {
       "aliases": [],
-      "args": {},
-      "description": "List robots and sensors in your fleet. Shows only online devices by default.\n\nUse --all to include offline devices.",
+      "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 %> devices list",
-        "<%= config.bin %> devices list --all",
-        "<%= config.bin %> devices list --all --limit 100",
-        "<%= config.bin %> devices list --tag location=warehouse",
-        "<%= config.bin %> devices list --name robot --dev --json"
+        "<%= config.bin %> devices tag <device-id> --tag location=warehouse",
+        "<%= config.bin %> devices tag <device-id> --tag env=prod --tag region=us-east",
+        "<%= config.bin %> devices tag <device-id> --tag location=factory --json"
       ],
       "flags": {
         "json": {
@@ -1483,34 +1270,11 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "all": {
-          "char": "a",
-          "description": "Show all devices (online and offline)",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "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"
-        },
         "tag": {
           "char": "t",
-          "description": "Filter by tag (key=value), can be specified multiple times",
+          "description": "Tag to add or update (key=value), can be specified multiple times",
           "name": "tag",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
@@ -1518,22 +1282,22 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:list",
+      "id": "devices:tag",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List robots and sensors in your fleet",
+      "summary": "Add or update tags on a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "devices",
-        "list.js"
+        "tag.js"
       ]
     },
-    "devices:streams": {
+    "devices:untag": {
       "aliases": [],
       "args": {
         "id": {
@@ -1542,10 +1306,11 @@
           "required": true
         }
       },
-      "description": "List telemetry streams configured on a device.\n\nShows a clean view of stream definitions parsed from the device configuration,\nincluding stream names, types, topics, and quality settings.",
+      "description": "Remove tags from a device.\n\nSpecify one or more tag keys to remove with --key.",
       "examples": [
-        "<%= config.bin %> devices streams <device-id>",
-        "<%= config.bin %> devices streams <device-id> --json"
+        "<%= config.bin %> devices untag <device-id> --key location",
+        "<%= config.bin %> devices untag <device-id> --key env --key region",
+        "<%= config.bin %> devices untag <device-id> --key location --json"
       ],
       "flags": {
         "json": {
@@ -1574,23 +1339,718 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "devices:streams",
+        },
+        "key": {
+          "char": "k",
+          "description": "Tag key to remove, can be specified multiple times",
+          "name": "key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "devices:untag",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List device streams",
+      "summary": "Remove tags from a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "devices",
-        "streams.js"
+        "untag.js"
+      ]
+    },
+    "kv:get": {
+      "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.",
+      "examples": [
+        "<%= config.bin %> kv get my-key",
+        "<%= config.bin %> kv get my-key --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": "kv:get",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Get key-value",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "kv",
+        "get.js"
+      ]
+    },
+    "kv:list": {
+      "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.",
+      "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"
+      ],
+      "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"
+        },
+        "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",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List key-value keys",
+      "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"
+      ]
+    },
+    "org:get": {
+      "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.",
+      "examples": [
+        "<%= config.bin %> org get",
+        "<%= config.bin %> org get --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": "org:get",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Get your organization",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "org",
+        "get.js"
+      ]
+    },
+    "org:update": {
+      "aliases": [],
+      "args": {},
+      "description": "Update your organization's details.\n\nAt least one of --name or --description must be provided.",
+      "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"
+      ],
+      "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"
+        },
+        "description": {
+          "char": "d",
+          "description": "New description for the organization",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "New name for the organization",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "org:update",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Update your organization",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "org",
+        "update.js"
+      ]
+    },
+    "events:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Event ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get detailed information about a specific event by its ID.",
+      "examples": [
+        "<%= config.bin %> events get <event-id>",
+        "<%= config.bin %> events get <event-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": "events:get",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Get an event by ID",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "events",
+        "get.js"
+      ]
+    },
+    "events:list": {
+      "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.",
+      "examples": [
+        "<%= config.bin %> events list",
+        "<%= config.bin %> events list --device <id> --severity critical",
+        "<%= config.bin %> events list --type device-offline --start 2026-01-01 --end 2026-01-02",
+        "<%= config.bin %> events list --limit 100 --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"
+        },
+        "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": "events:list",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "View events emitted by devices",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "events",
+        "list.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.",
+      "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 temperature --type numeric --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"
+        },
+        "aggregate": {
+          "char": "a",
+          "description": "Aggregation level for downsampling",
+          "name": "aggregate",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "device": {
+          "char": "d",
+          "description": "Device ID (UUID)",
+          "name": "device",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "end": {
+          "description": "End time (ISO 8601)",
+          "name": "end",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "latest": {
+          "description": "Only return the most recent value per stream",
+          "name": "latest",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of datapoints",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "start": {
+          "description": "Start time (ISO 8601)",
+          "name": "start",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "char": "s",
+          "description": "Stream name(s), can be specified multiple times",
+          "name": "stream",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "type": {
+          "description": "Filter by stream type",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "query",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Query telemetry stream data",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "query",
+        "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\nconfigured streams from the device configuration.",
+      "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 configured streams for the device (requires single --device)",
+          "name": "all-streams",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "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"
       ]
     },
     "investigations:analytics": {
@@ -2679,5 +3139,5 @@
       ]
     }
   },
-  "version": "0.1.0"
+  "version": "0.2.0"
 }