@formant/formant-cli 0.4.3 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -140,19 +140,19 @@
140
140
  "tables.js"
141
141
  ]
142
142
  },
143
- "event-trigger:get": {
143
+ "event:get": {
144
144
  "aliases": [],
145
145
  "args": {
146
146
  "id": {
147
- "description": "Event trigger ID (UUID)",
147
+ "description": "Event ID (UUID)",
148
148
  "name": "id",
149
149
  "required": true
150
150
  }
151
151
  },
152
- "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.",
152
+ "description": "Get detailed information about a specific event by its ID.",
153
153
  "examples": [
154
- "<%= config.bin %> event-trigger get <trigger-id>",
155
- "<%= config.bin %> event-trigger get <trigger-id> --json"
154
+ "<%= config.bin %> event get <event-id>",
155
+ "<%= config.bin %> event get <event-id> --json"
156
156
  ],
157
157
  "flags": {
158
158
  "json": {
@@ -185,28 +185,30 @@
185
185
  },
186
186
  "hasDynamicHelp": false,
187
187
  "hiddenAliases": [],
188
- "id": "event-trigger:get",
188
+ "id": "event:get",
189
189
  "pluginAlias": "@formant/formant-cli",
190
190
  "pluginName": "@formant/formant-cli",
191
191
  "pluginType": "core",
192
192
  "strict": true,
193
- "summary": "Get event trigger details",
193
+ "summary": "Get an event by ID",
194
194
  "enableJsonFlag": true,
195
195
  "isESM": true,
196
196
  "relativePath": [
197
197
  "dist",
198
198
  "commands",
199
- "event-trigger",
199
+ "event",
200
200
  "get.js"
201
201
  ]
202
202
  },
203
- "event-trigger:list": {
203
+ "event:list": {
204
204
  "aliases": [],
205
205
  "args": {},
206
- "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.",
206
+ "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.",
207
207
  "examples": [
208
- "<%= config.bin %> event-trigger list",
209
- "<%= config.bin %> event-trigger list --json"
208
+ "<%= config.bin %> event list",
209
+ "<%= config.bin %> event list --device <id> --severity critical",
210
+ "<%= config.bin %> event list --type device-offline --start 2026-01-01 --end 2026-01-02",
211
+ "<%= config.bin %> event list --limit 100 --json"
210
212
  ],
211
213
  "flags": {
212
214
  "json": {
@@ -235,38 +237,89 @@
235
237
  "name": "stage",
236
238
  "allowNo": false,
237
239
  "type": "boolean"
240
+ },
241
+ "device": {
242
+ "char": "d",
243
+ "description": "Filter by device ID",
244
+ "name": "device",
245
+ "hasDynamicHelp": false,
246
+ "multiple": false,
247
+ "type": "option"
248
+ },
249
+ "end": {
250
+ "description": "End time (ISO 8601)",
251
+ "name": "end",
252
+ "hasDynamicHelp": false,
253
+ "multiple": false,
254
+ "type": "option"
255
+ },
256
+ "limit": {
257
+ "char": "l",
258
+ "description": "Maximum number of events to return",
259
+ "name": "limit",
260
+ "default": 25,
261
+ "hasDynamicHelp": false,
262
+ "multiple": false,
263
+ "type": "option"
264
+ },
265
+ "severity": {
266
+ "description": "Filter by severity",
267
+ "name": "severity",
268
+ "hasDynamicHelp": false,
269
+ "multiple": false,
270
+ "options": [
271
+ "info",
272
+ "warning",
273
+ "error",
274
+ "critical"
275
+ ],
276
+ "type": "option"
277
+ },
278
+ "start": {
279
+ "description": "Start time (ISO 8601)",
280
+ "name": "start",
281
+ "hasDynamicHelp": false,
282
+ "multiple": false,
283
+ "type": "option"
284
+ },
285
+ "type": {
286
+ "description": "Filter by event type",
287
+ "name": "type",
288
+ "hasDynamicHelp": false,
289
+ "multiple": false,
290
+ "type": "option"
238
291
  }
239
292
  },
240
293
  "hasDynamicHelp": false,
241
294
  "hiddenAliases": [],
242
- "id": "event-trigger:list",
295
+ "id": "event:list",
243
296
  "pluginAlias": "@formant/formant-cli",
244
297
  "pluginName": "@formant/formant-cli",
245
298
  "pluginType": "core",
246
299
  "strict": true,
247
- "summary": "List event trigger rules",
300
+ "summary": "View events emitted by devices",
248
301
  "enableJsonFlag": true,
249
302
  "isESM": true,
250
303
  "relativePath": [
251
304
  "dist",
252
305
  "commands",
253
- "event-trigger",
306
+ "event",
254
307
  "list.js"
255
308
  ]
256
309
  },
257
- "fleet:get": {
310
+ "event-trigger:get": {
258
311
  "aliases": [],
259
312
  "args": {
260
313
  "id": {
261
- "description": "Fleet (group) ID (UUID)",
314
+ "description": "Event trigger ID (UUID)",
262
315
  "name": "id",
263
316
  "required": true
264
317
  }
265
318
  },
266
- "description": "Get detailed information about a device group (fleet).\n\nShows the full fleet configuration including member devices and settings.",
319
+ "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.",
267
320
  "examples": [
268
- "<%= config.bin %> fleet get <fleet-id>",
269
- "<%= config.bin %> fleet get <fleet-id> --json"
321
+ "<%= config.bin %> event-trigger get <trigger-id>",
322
+ "<%= config.bin %> event-trigger get <trigger-id> --json"
270
323
  ],
271
324
  "flags": {
272
325
  "json": {
@@ -299,28 +352,28 @@
299
352
  },
300
353
  "hasDynamicHelp": false,
301
354
  "hiddenAliases": [],
302
- "id": "fleet:get",
355
+ "id": "event-trigger:get",
303
356
  "pluginAlias": "@formant/formant-cli",
304
357
  "pluginName": "@formant/formant-cli",
305
358
  "pluginType": "core",
306
359
  "strict": true,
307
- "summary": "Get fleet details",
360
+ "summary": "Get event trigger details",
308
361
  "enableJsonFlag": true,
309
362
  "isESM": true,
310
363
  "relativePath": [
311
364
  "dist",
312
365
  "commands",
313
- "fleet",
366
+ "event-trigger",
314
367
  "get.js"
315
368
  ]
316
369
  },
317
- "fleet:list": {
370
+ "event-trigger:list": {
318
371
  "aliases": [],
319
372
  "args": {},
320
- "description": "List all device groups (fleets) in your organization.\n\nDevice groups allow you to organize and manage sets of devices together.",
373
+ "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.",
321
374
  "examples": [
322
- "<%= config.bin %> fleet list",
323
- "<%= config.bin %> fleet list --json"
375
+ "<%= config.bin %> event-trigger list",
376
+ "<%= config.bin %> event-trigger list --json"
324
377
  ],
325
378
  "flags": {
326
379
  "json": {
@@ -353,18 +406,18 @@
353
406
  },
354
407
  "hasDynamicHelp": false,
355
408
  "hiddenAliases": [],
356
- "id": "fleet:list",
409
+ "id": "event-trigger:list",
357
410
  "pluginAlias": "@formant/formant-cli",
358
411
  "pluginName": "@formant/formant-cli",
359
412
  "pluginType": "core",
360
413
  "strict": true,
361
- "summary": "List device groups",
414
+ "summary": "List event trigger rules",
362
415
  "enableJsonFlag": true,
363
416
  "isESM": true,
364
417
  "relativePath": [
365
418
  "dist",
366
419
  "commands",
367
- "fleet",
420
+ "event-trigger",
368
421
  "list.js"
369
422
  ]
370
423
  },
@@ -704,6 +757,120 @@
704
757
  "send.js"
705
758
  ]
706
759
  },
760
+ "fleet:get": {
761
+ "aliases": [],
762
+ "args": {
763
+ "id": {
764
+ "description": "Fleet (group) ID (UUID)",
765
+ "name": "id",
766
+ "required": true
767
+ }
768
+ },
769
+ "description": "Get detailed information about a device group (fleet).\n\nShows the full fleet configuration including member devices and settings.",
770
+ "examples": [
771
+ "<%= config.bin %> fleet get <fleet-id>",
772
+ "<%= config.bin %> fleet get <fleet-id> --json"
773
+ ],
774
+ "flags": {
775
+ "json": {
776
+ "description": "Format output as json.",
777
+ "helpGroup": "GLOBAL",
778
+ "name": "json",
779
+ "allowNo": false,
780
+ "type": "boolean"
781
+ },
782
+ "dev": {
783
+ "description": "Target the dev environment",
784
+ "exclusive": [
785
+ "stage"
786
+ ],
787
+ "helpGroup": "GLOBAL",
788
+ "name": "dev",
789
+ "allowNo": false,
790
+ "type": "boolean"
791
+ },
792
+ "stage": {
793
+ "description": "Target the stage environment",
794
+ "exclusive": [
795
+ "dev"
796
+ ],
797
+ "helpGroup": "GLOBAL",
798
+ "name": "stage",
799
+ "allowNo": false,
800
+ "type": "boolean"
801
+ }
802
+ },
803
+ "hasDynamicHelp": false,
804
+ "hiddenAliases": [],
805
+ "id": "fleet:get",
806
+ "pluginAlias": "@formant/formant-cli",
807
+ "pluginName": "@formant/formant-cli",
808
+ "pluginType": "core",
809
+ "strict": true,
810
+ "summary": "Get fleet details",
811
+ "enableJsonFlag": true,
812
+ "isESM": true,
813
+ "relativePath": [
814
+ "dist",
815
+ "commands",
816
+ "fleet",
817
+ "get.js"
818
+ ]
819
+ },
820
+ "fleet:list": {
821
+ "aliases": [],
822
+ "args": {},
823
+ "description": "List all device groups (fleets) in your organization.\n\nDevice groups allow you to organize and manage sets of devices together.",
824
+ "examples": [
825
+ "<%= config.bin %> fleet list",
826
+ "<%= config.bin %> fleet list --json"
827
+ ],
828
+ "flags": {
829
+ "json": {
830
+ "description": "Format output as json.",
831
+ "helpGroup": "GLOBAL",
832
+ "name": "json",
833
+ "allowNo": false,
834
+ "type": "boolean"
835
+ },
836
+ "dev": {
837
+ "description": "Target the dev environment",
838
+ "exclusive": [
839
+ "stage"
840
+ ],
841
+ "helpGroup": "GLOBAL",
842
+ "name": "dev",
843
+ "allowNo": false,
844
+ "type": "boolean"
845
+ },
846
+ "stage": {
847
+ "description": "Target the stage environment",
848
+ "exclusive": [
849
+ "dev"
850
+ ],
851
+ "helpGroup": "GLOBAL",
852
+ "name": "stage",
853
+ "allowNo": false,
854
+ "type": "boolean"
855
+ }
856
+ },
857
+ "hasDynamicHelp": false,
858
+ "hiddenAliases": [],
859
+ "id": "fleet:list",
860
+ "pluginAlias": "@formant/formant-cli",
861
+ "pluginName": "@formant/formant-cli",
862
+ "pluginType": "core",
863
+ "strict": true,
864
+ "summary": "List device groups",
865
+ "enableJsonFlag": true,
866
+ "isESM": true,
867
+ "relativePath": [
868
+ "dist",
869
+ "commands",
870
+ "fleet",
871
+ "list.js"
872
+ ]
873
+ },
707
874
  "device:config": {
708
875
  "aliases": [],
709
876
  "args": {
@@ -1341,19 +1508,19 @@
1341
1508
  "untag.js"
1342
1509
  ]
1343
1510
  },
1344
- "event:get": {
1511
+ "kv:get": {
1345
1512
  "aliases": [],
1346
1513
  "args": {
1347
- "id": {
1348
- "description": "Event ID (UUID)",
1349
- "name": "id",
1514
+ "key": {
1515
+ "description": "Key to retrieve",
1516
+ "name": "key",
1350
1517
  "required": true
1351
1518
  }
1352
1519
  },
1353
- "description": "Get detailed information about a specific event by its ID.",
1520
+ "description": "Get a value from the key-value store.\n\nThe key-value store allows devices and applications to store metadata.",
1354
1521
  "examples": [
1355
- "<%= config.bin %> event get <event-id>",
1356
- "<%= config.bin %> event get <event-id> --json"
1522
+ "<%= config.bin %> kv get my-key",
1523
+ "<%= config.bin %> kv get my-key --json"
1357
1524
  ],
1358
1525
  "flags": {
1359
1526
  "json": {
@@ -1386,318 +1553,25 @@
1386
1553
  },
1387
1554
  "hasDynamicHelp": false,
1388
1555
  "hiddenAliases": [],
1389
- "id": "event:get",
1556
+ "id": "kv:get",
1390
1557
  "pluginAlias": "@formant/formant-cli",
1391
1558
  "pluginName": "@formant/formant-cli",
1392
1559
  "pluginType": "core",
1393
1560
  "strict": true,
1394
- "summary": "Get an event by ID",
1561
+ "summary": "Get key-value",
1395
1562
  "enableJsonFlag": true,
1396
1563
  "isESM": true,
1397
1564
  "relativePath": [
1398
1565
  "dist",
1399
1566
  "commands",
1400
- "event",
1567
+ "kv",
1401
1568
  "get.js"
1402
1569
  ]
1403
1570
  },
1404
- "event:list": {
1571
+ "kv:list": {
1405
1572
  "aliases": [],
1406
1573
  "args": {},
1407
- "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.",
1408
- "examples": [
1409
- "<%= config.bin %> event list",
1410
- "<%= config.bin %> event list --device <id> --severity critical",
1411
- "<%= config.bin %> event list --type device-offline --start 2026-01-01 --end 2026-01-02",
1412
- "<%= config.bin %> event list --limit 100 --json"
1413
- ],
1414
- "flags": {
1415
- "json": {
1416
- "description": "Format output as json.",
1417
- "helpGroup": "GLOBAL",
1418
- "name": "json",
1419
- "allowNo": false,
1420
- "type": "boolean"
1421
- },
1422
- "dev": {
1423
- "description": "Target the dev environment",
1424
- "exclusive": [
1425
- "stage"
1426
- ],
1427
- "helpGroup": "GLOBAL",
1428
- "name": "dev",
1429
- "allowNo": false,
1430
- "type": "boolean"
1431
- },
1432
- "stage": {
1433
- "description": "Target the stage environment",
1434
- "exclusive": [
1435
- "dev"
1436
- ],
1437
- "helpGroup": "GLOBAL",
1438
- "name": "stage",
1439
- "allowNo": false,
1440
- "type": "boolean"
1441
- },
1442
- "device": {
1443
- "char": "d",
1444
- "description": "Filter by device ID",
1445
- "name": "device",
1446
- "hasDynamicHelp": false,
1447
- "multiple": false,
1448
- "type": "option"
1449
- },
1450
- "end": {
1451
- "description": "End time (ISO 8601)",
1452
- "name": "end",
1453
- "hasDynamicHelp": false,
1454
- "multiple": false,
1455
- "type": "option"
1456
- },
1457
- "limit": {
1458
- "char": "l",
1459
- "description": "Maximum number of events to return",
1460
- "name": "limit",
1461
- "default": 25,
1462
- "hasDynamicHelp": false,
1463
- "multiple": false,
1464
- "type": "option"
1465
- },
1466
- "severity": {
1467
- "description": "Filter by severity",
1468
- "name": "severity",
1469
- "hasDynamicHelp": false,
1470
- "multiple": false,
1471
- "options": [
1472
- "info",
1473
- "warning",
1474
- "error",
1475
- "critical"
1476
- ],
1477
- "type": "option"
1478
- },
1479
- "start": {
1480
- "description": "Start time (ISO 8601)",
1481
- "name": "start",
1482
- "hasDynamicHelp": false,
1483
- "multiple": false,
1484
- "type": "option"
1485
- },
1486
- "type": {
1487
- "description": "Filter by event type",
1488
- "name": "type",
1489
- "hasDynamicHelp": false,
1490
- "multiple": false,
1491
- "type": "option"
1492
- }
1493
- },
1494
- "hasDynamicHelp": false,
1495
- "hiddenAliases": [],
1496
- "id": "event:list",
1497
- "pluginAlias": "@formant/formant-cli",
1498
- "pluginName": "@formant/formant-cli",
1499
- "pluginType": "core",
1500
- "strict": true,
1501
- "summary": "View events emitted by devices",
1502
- "enableJsonFlag": true,
1503
- "isESM": true,
1504
- "relativePath": [
1505
- "dist",
1506
- "commands",
1507
- "event",
1508
- "list.js"
1509
- ]
1510
- },
1511
- "org:get": {
1512
- "aliases": [],
1513
- "args": {},
1514
- "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.",
1515
- "examples": [
1516
- "<%= config.bin %> org get",
1517
- "<%= config.bin %> org get --json"
1518
- ],
1519
- "flags": {
1520
- "json": {
1521
- "description": "Format output as json.",
1522
- "helpGroup": "GLOBAL",
1523
- "name": "json",
1524
- "allowNo": false,
1525
- "type": "boolean"
1526
- },
1527
- "dev": {
1528
- "description": "Target the dev environment",
1529
- "exclusive": [
1530
- "stage"
1531
- ],
1532
- "helpGroup": "GLOBAL",
1533
- "name": "dev",
1534
- "allowNo": false,
1535
- "type": "boolean"
1536
- },
1537
- "stage": {
1538
- "description": "Target the stage environment",
1539
- "exclusive": [
1540
- "dev"
1541
- ],
1542
- "helpGroup": "GLOBAL",
1543
- "name": "stage",
1544
- "allowNo": false,
1545
- "type": "boolean"
1546
- }
1547
- },
1548
- "hasDynamicHelp": false,
1549
- "hiddenAliases": [],
1550
- "id": "org:get",
1551
- "pluginAlias": "@formant/formant-cli",
1552
- "pluginName": "@formant/formant-cli",
1553
- "pluginType": "core",
1554
- "strict": true,
1555
- "summary": "Get your organization",
1556
- "enableJsonFlag": true,
1557
- "isESM": true,
1558
- "relativePath": [
1559
- "dist",
1560
- "commands",
1561
- "org",
1562
- "get.js"
1563
- ]
1564
- },
1565
- "org:update": {
1566
- "aliases": [],
1567
- "args": {},
1568
- "description": "Update your organization's details.\n\nAt least one of --name or --description must be provided.",
1569
- "examples": [
1570
- "<%= config.bin %> org update --name \"My Fleet\"",
1571
- "<%= config.bin %> org update --description \"Production robot fleet\"",
1572
- "<%= config.bin %> org update --name \"My Fleet\" --description \"Production robot fleet\"",
1573
- "<%= config.bin %> org update --name \"My Fleet\" --json"
1574
- ],
1575
- "flags": {
1576
- "json": {
1577
- "description": "Format output as json.",
1578
- "helpGroup": "GLOBAL",
1579
- "name": "json",
1580
- "allowNo": false,
1581
- "type": "boolean"
1582
- },
1583
- "dev": {
1584
- "description": "Target the dev environment",
1585
- "exclusive": [
1586
- "stage"
1587
- ],
1588
- "helpGroup": "GLOBAL",
1589
- "name": "dev",
1590
- "allowNo": false,
1591
- "type": "boolean"
1592
- },
1593
- "stage": {
1594
- "description": "Target the stage environment",
1595
- "exclusive": [
1596
- "dev"
1597
- ],
1598
- "helpGroup": "GLOBAL",
1599
- "name": "stage",
1600
- "allowNo": false,
1601
- "type": "boolean"
1602
- },
1603
- "description": {
1604
- "char": "d",
1605
- "description": "New description for the organization",
1606
- "name": "description",
1607
- "hasDynamicHelp": false,
1608
- "multiple": false,
1609
- "type": "option"
1610
- },
1611
- "name": {
1612
- "char": "n",
1613
- "description": "New name for the organization",
1614
- "name": "name",
1615
- "hasDynamicHelp": false,
1616
- "multiple": false,
1617
- "type": "option"
1618
- }
1619
- },
1620
- "hasDynamicHelp": false,
1621
- "hiddenAliases": [],
1622
- "id": "org:update",
1623
- "pluginAlias": "@formant/formant-cli",
1624
- "pluginName": "@formant/formant-cli",
1625
- "pluginType": "core",
1626
- "strict": true,
1627
- "summary": "Update your organization",
1628
- "enableJsonFlag": true,
1629
- "isESM": true,
1630
- "relativePath": [
1631
- "dist",
1632
- "commands",
1633
- "org",
1634
- "update.js"
1635
- ]
1636
- },
1637
- "kv:get": {
1638
- "aliases": [],
1639
- "args": {
1640
- "key": {
1641
- "description": "Key to retrieve",
1642
- "name": "key",
1643
- "required": true
1644
- }
1645
- },
1646
- "description": "Get a value from the key-value store.\n\nThe key-value store allows devices and applications to store metadata.",
1647
- "examples": [
1648
- "<%= config.bin %> kv get my-key",
1649
- "<%= config.bin %> kv get my-key --json"
1650
- ],
1651
- "flags": {
1652
- "json": {
1653
- "description": "Format output as json.",
1654
- "helpGroup": "GLOBAL",
1655
- "name": "json",
1656
- "allowNo": false,
1657
- "type": "boolean"
1658
- },
1659
- "dev": {
1660
- "description": "Target the dev environment",
1661
- "exclusive": [
1662
- "stage"
1663
- ],
1664
- "helpGroup": "GLOBAL",
1665
- "name": "dev",
1666
- "allowNo": false,
1667
- "type": "boolean"
1668
- },
1669
- "stage": {
1670
- "description": "Target the stage environment",
1671
- "exclusive": [
1672
- "dev"
1673
- ],
1674
- "helpGroup": "GLOBAL",
1675
- "name": "stage",
1676
- "allowNo": false,
1677
- "type": "boolean"
1678
- }
1679
- },
1680
- "hasDynamicHelp": false,
1681
- "hiddenAliases": [],
1682
- "id": "kv:get",
1683
- "pluginAlias": "@formant/formant-cli",
1684
- "pluginName": "@formant/formant-cli",
1685
- "pluginType": "core",
1686
- "strict": true,
1687
- "summary": "Get key-value",
1688
- "enableJsonFlag": true,
1689
- "isESM": true,
1690
- "relativePath": [
1691
- "dist",
1692
- "commands",
1693
- "kv",
1694
- "get.js"
1695
- ]
1696
- },
1697
- "kv:list": {
1698
- "aliases": [],
1699
- "args": {},
1700
- "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.",
1574
+ "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.",
1701
1575
  "examples": [
1702
1576
  "<%= config.bin %> kv list",
1703
1577
  "<%= config.bin %> kv list --prefix config",
@@ -3189,19 +3063,270 @@
3189
3063
  },
3190
3064
  "hasDynamicHelp": false,
3191
3065
  "hiddenAliases": [],
3192
- "id": "investigation:trigger",
3066
+ "id": "investigation:trigger",
3067
+ "pluginAlias": "@formant/formant-cli",
3068
+ "pluginName": "@formant/formant-cli",
3069
+ "pluginType": "core",
3070
+ "strict": true,
3071
+ "summary": "Trigger an investigation",
3072
+ "enableJsonFlag": true,
3073
+ "isESM": true,
3074
+ "relativePath": [
3075
+ "dist",
3076
+ "commands",
3077
+ "investigation",
3078
+ "trigger.js"
3079
+ ]
3080
+ },
3081
+ "persona:delegate-task": {
3082
+ "aliases": [],
3083
+ "args": {
3084
+ "id": {
3085
+ "description": "Persona ID (UUID)",
3086
+ "name": "id",
3087
+ "required": true
3088
+ },
3089
+ "goal": {
3090
+ "description": "The task goal / instruction for the persona",
3091
+ "name": "goal",
3092
+ "required": true
3093
+ }
3094
+ },
3095
+ "description": "Delegate a task to a persona for async execution.\n\nCreates a task with the given goal, assigns it to the persona, and queues it to run in the background. Returns immediately with a task ID you can use to check status later via \"persona task-status\".",
3096
+ "examples": [
3097
+ "<%= config.bin %> persona delegate-task <persona-id> \"Analyze recent device failures and summarize findings\"",
3098
+ "<%= config.bin %> persona delegate-task <persona-id> \"Generate a daily report of fleet health\" --name \"Daily Fleet Report\"",
3099
+ "<%= config.bin %> persona delegate-task <persona-id> \"Check all offline devices\" --dev"
3100
+ ],
3101
+ "flags": {
3102
+ "json": {
3103
+ "description": "Format output as json.",
3104
+ "helpGroup": "GLOBAL",
3105
+ "name": "json",
3106
+ "allowNo": false,
3107
+ "type": "boolean"
3108
+ },
3109
+ "dev": {
3110
+ "description": "Target the dev environment",
3111
+ "exclusive": [
3112
+ "stage"
3113
+ ],
3114
+ "helpGroup": "GLOBAL",
3115
+ "name": "dev",
3116
+ "allowNo": false,
3117
+ "type": "boolean"
3118
+ },
3119
+ "stage": {
3120
+ "description": "Target the stage environment",
3121
+ "exclusive": [
3122
+ "dev"
3123
+ ],
3124
+ "helpGroup": "GLOBAL",
3125
+ "name": "stage",
3126
+ "allowNo": false,
3127
+ "type": "boolean"
3128
+ },
3129
+ "name": {
3130
+ "char": "n",
3131
+ "description": "Task name (defaults to first 50 chars of goal)",
3132
+ "name": "name",
3133
+ "hasDynamicHelp": false,
3134
+ "multiple": false,
3135
+ "type": "option"
3136
+ }
3137
+ },
3138
+ "hasDynamicHelp": false,
3139
+ "hiddenAliases": [],
3140
+ "id": "persona:delegate-task",
3141
+ "pluginAlias": "@formant/formant-cli",
3142
+ "pluginName": "@formant/formant-cli",
3143
+ "pluginType": "core",
3144
+ "strict": true,
3145
+ "summary": "Delegate an async task to a persona",
3146
+ "enableJsonFlag": true,
3147
+ "isESM": true,
3148
+ "relativePath": [
3149
+ "dist",
3150
+ "commands",
3151
+ "persona",
3152
+ "delegate-task.js"
3153
+ ]
3154
+ },
3155
+ "persona:get": {
3156
+ "aliases": [],
3157
+ "args": {
3158
+ "id": {
3159
+ "description": "Persona ID (UUID)",
3160
+ "name": "id",
3161
+ "required": true
3162
+ }
3163
+ },
3164
+ "description": "Get detailed information about a persona including its integrations and available tools.\n\nUses the user-level persona endpoint which merges org, persona, and user configurations.",
3165
+ "examples": [
3166
+ "<%= config.bin %> personas get <persona-id>",
3167
+ "<%= config.bin %> personas get <persona-id> --json",
3168
+ "<%= config.bin %> personas get <persona-id> --dev"
3169
+ ],
3170
+ "flags": {
3171
+ "json": {
3172
+ "description": "Format output as json.",
3173
+ "helpGroup": "GLOBAL",
3174
+ "name": "json",
3175
+ "allowNo": false,
3176
+ "type": "boolean"
3177
+ },
3178
+ "dev": {
3179
+ "description": "Target the dev environment",
3180
+ "exclusive": [
3181
+ "stage"
3182
+ ],
3183
+ "helpGroup": "GLOBAL",
3184
+ "name": "dev",
3185
+ "allowNo": false,
3186
+ "type": "boolean"
3187
+ },
3188
+ "stage": {
3189
+ "description": "Target the stage environment",
3190
+ "exclusive": [
3191
+ "dev"
3192
+ ],
3193
+ "helpGroup": "GLOBAL",
3194
+ "name": "stage",
3195
+ "allowNo": false,
3196
+ "type": "boolean"
3197
+ }
3198
+ },
3199
+ "hasDynamicHelp": false,
3200
+ "hiddenAliases": [],
3201
+ "id": "persona:get",
3202
+ "pluginAlias": "@formant/formant-cli",
3203
+ "pluginName": "@formant/formant-cli",
3204
+ "pluginType": "core",
3205
+ "strict": true,
3206
+ "summary": "Get persona details and tools",
3207
+ "enableJsonFlag": true,
3208
+ "isESM": true,
3209
+ "relativePath": [
3210
+ "dist",
3211
+ "commands",
3212
+ "persona",
3213
+ "get.js"
3214
+ ]
3215
+ },
3216
+ "persona:list": {
3217
+ "aliases": [],
3218
+ "args": {},
3219
+ "description": "List AI personas available in your organization.\n\nShows both built-in and custom personas with their ID, name, and description.",
3220
+ "examples": [
3221
+ "<%= config.bin %> personas list",
3222
+ "<%= config.bin %> personas list --json",
3223
+ "<%= config.bin %> personas list --dev"
3224
+ ],
3225
+ "flags": {
3226
+ "json": {
3227
+ "description": "Format output as json.",
3228
+ "helpGroup": "GLOBAL",
3229
+ "name": "json",
3230
+ "allowNo": false,
3231
+ "type": "boolean"
3232
+ },
3233
+ "dev": {
3234
+ "description": "Target the dev environment",
3235
+ "exclusive": [
3236
+ "stage"
3237
+ ],
3238
+ "helpGroup": "GLOBAL",
3239
+ "name": "dev",
3240
+ "allowNo": false,
3241
+ "type": "boolean"
3242
+ },
3243
+ "stage": {
3244
+ "description": "Target the stage environment",
3245
+ "exclusive": [
3246
+ "dev"
3247
+ ],
3248
+ "helpGroup": "GLOBAL",
3249
+ "name": "stage",
3250
+ "allowNo": false,
3251
+ "type": "boolean"
3252
+ }
3253
+ },
3254
+ "hasDynamicHelp": false,
3255
+ "hiddenAliases": [],
3256
+ "id": "persona:list",
3257
+ "pluginAlias": "@formant/formant-cli",
3258
+ "pluginName": "@formant/formant-cli",
3259
+ "pluginType": "core",
3260
+ "strict": true,
3261
+ "summary": "List AI personas",
3262
+ "enableJsonFlag": true,
3263
+ "isESM": true,
3264
+ "relativePath": [
3265
+ "dist",
3266
+ "commands",
3267
+ "persona",
3268
+ "list.js"
3269
+ ]
3270
+ },
3271
+ "persona:task-status": {
3272
+ "aliases": [],
3273
+ "args": {
3274
+ "taskId": {
3275
+ "description": "Task ID (from delegate-task output)",
3276
+ "name": "taskId",
3277
+ "required": true
3278
+ }
3279
+ },
3280
+ "description": "Check the status and results of a delegated task.\n\nShows all runs for a task including their status, result summary, and timestamps.",
3281
+ "examples": [
3282
+ "<%= config.bin %> persona task-status <task-id>",
3283
+ "<%= config.bin %> persona task-status <task-id> --json",
3284
+ "<%= config.bin %> persona task-status <task-id> --dev"
3285
+ ],
3286
+ "flags": {
3287
+ "json": {
3288
+ "description": "Format output as json.",
3289
+ "helpGroup": "GLOBAL",
3290
+ "name": "json",
3291
+ "allowNo": false,
3292
+ "type": "boolean"
3293
+ },
3294
+ "dev": {
3295
+ "description": "Target the dev environment",
3296
+ "exclusive": [
3297
+ "stage"
3298
+ ],
3299
+ "helpGroup": "GLOBAL",
3300
+ "name": "dev",
3301
+ "allowNo": false,
3302
+ "type": "boolean"
3303
+ },
3304
+ "stage": {
3305
+ "description": "Target the stage environment",
3306
+ "exclusive": [
3307
+ "dev"
3308
+ ],
3309
+ "helpGroup": "GLOBAL",
3310
+ "name": "stage",
3311
+ "allowNo": false,
3312
+ "type": "boolean"
3313
+ }
3314
+ },
3315
+ "hasDynamicHelp": false,
3316
+ "hiddenAliases": [],
3317
+ "id": "persona:task-status",
3193
3318
  "pluginAlias": "@formant/formant-cli",
3194
3319
  "pluginName": "@formant/formant-cli",
3195
3320
  "pluginType": "core",
3196
3321
  "strict": true,
3197
- "summary": "Trigger an investigation",
3322
+ "summary": "Check status of a delegated task",
3198
3323
  "enableJsonFlag": true,
3199
3324
  "isESM": true,
3200
3325
  "relativePath": [
3201
3326
  "dist",
3202
3327
  "commands",
3203
- "investigation",
3204
- "trigger.js"
3328
+ "persona",
3329
+ "task-status.js"
3205
3330
  ]
3206
3331
  },
3207
3332
  "query": {
@@ -3211,6 +3336,8 @@
3211
3336
  "examples": [
3212
3337
  "<%= config.bin %> query --device <id> --stream battery_level --start 2026-01-01 --end 2026-01-02",
3213
3338
  "<%= config.bin %> query --device <id> --stream speed --aggregate hour --start 2026-01-01 --end 2026-02-01",
3339
+ "<%= config.bin %> query --device <id> --stream battery_level --stream temperature --start 2026-01-01 --end 2026-01-02",
3340
+ "<%= config.bin %> query --device <id1> --device <id2> --stream battery_level --start 2026-01-01 --end 2026-01-02",
3214
3341
  "<%= config.bin %> query --device <id> --stream battery_level --latest",
3215
3342
  "<%= config.bin %> query --device <id> --stream temperature --type numeric --json"
3216
3343
  ],
@@ -3252,11 +3379,11 @@
3252
3379
  },
3253
3380
  "device": {
3254
3381
  "char": "d",
3255
- "description": "Device ID (UUID)",
3382
+ "description": "Device ID(s), can be specified multiple times",
3256
3383
  "name": "device",
3257
3384
  "required": true,
3258
3385
  "hasDynamicHelp": false,
3259
- "multiple": false,
3386
+ "multiple": true,
3260
3387
  "type": "option"
3261
3388
  },
3262
3389
  "end": {
@@ -3408,25 +3535,13 @@
3408
3535
  "latest-values.js"
3409
3536
  ]
3410
3537
  },
3411
- "persona:delegate-task": {
3538
+ "org:get": {
3412
3539
  "aliases": [],
3413
- "args": {
3414
- "id": {
3415
- "description": "Persona ID (UUID)",
3416
- "name": "id",
3417
- "required": true
3418
- },
3419
- "goal": {
3420
- "description": "The task goal / instruction for the persona",
3421
- "name": "goal",
3422
- "required": true
3423
- }
3424
- },
3425
- "description": "Delegate a task to a persona for async execution.\n\nCreates a task with the given goal, assigns it to the persona, and queues it to run in the background. Returns immediately with a task ID you can use to check status later via \"persona task-status\".",
3540
+ "args": {},
3541
+ "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.",
3426
3542
  "examples": [
3427
- "<%= config.bin %> persona delegate-task <persona-id> \"Analyze recent device failures and summarize findings\"",
3428
- "<%= config.bin %> persona delegate-task <persona-id> \"Generate a daily report of fleet health\" --name \"Daily Fleet Report\"",
3429
- "<%= config.bin %> persona delegate-task <persona-id> \"Check all offline devices\" --dev"
3543
+ "<%= config.bin %> org get",
3544
+ "<%= config.bin %> org get --json"
3430
3545
  ],
3431
3546
  "flags": {
3432
3547
  "json": {
@@ -3455,47 +3570,34 @@
3455
3570
  "name": "stage",
3456
3571
  "allowNo": false,
3457
3572
  "type": "boolean"
3458
- },
3459
- "name": {
3460
- "char": "n",
3461
- "description": "Task name (defaults to first 50 chars of goal)",
3462
- "name": "name",
3463
- "hasDynamicHelp": false,
3464
- "multiple": false,
3465
- "type": "option"
3466
3573
  }
3467
3574
  },
3468
3575
  "hasDynamicHelp": false,
3469
3576
  "hiddenAliases": [],
3470
- "id": "persona:delegate-task",
3577
+ "id": "org:get",
3471
3578
  "pluginAlias": "@formant/formant-cli",
3472
3579
  "pluginName": "@formant/formant-cli",
3473
3580
  "pluginType": "core",
3474
3581
  "strict": true,
3475
- "summary": "Delegate an async task to a persona",
3582
+ "summary": "Get your organization",
3476
3583
  "enableJsonFlag": true,
3477
3584
  "isESM": true,
3478
3585
  "relativePath": [
3479
3586
  "dist",
3480
3587
  "commands",
3481
- "persona",
3482
- "delegate-task.js"
3588
+ "org",
3589
+ "get.js"
3483
3590
  ]
3484
3591
  },
3485
- "persona:get": {
3592
+ "org:update": {
3486
3593
  "aliases": [],
3487
- "args": {
3488
- "id": {
3489
- "description": "Persona ID (UUID)",
3490
- "name": "id",
3491
- "required": true
3492
- }
3493
- },
3494
- "description": "Get detailed information about a persona including its integrations and available tools.\n\nUses the user-level persona endpoint which merges org, persona, and user configurations.",
3594
+ "args": {},
3595
+ "description": "Update your organization's details.\n\nAt least one of --name or --description must be provided.",
3495
3596
  "examples": [
3496
- "<%= config.bin %> personas get <persona-id>",
3497
- "<%= config.bin %> personas get <persona-id> --json",
3498
- "<%= config.bin %> personas get <persona-id> --dev"
3597
+ "<%= config.bin %> org update --name \"My Fleet\"",
3598
+ "<%= config.bin %> org update --description \"Production robot fleet\"",
3599
+ "<%= config.bin %> org update --name \"My Fleet\" --description \"Production robot fleet\"",
3600
+ "<%= config.bin %> org update --name \"My Fleet\" --json"
3499
3601
  ],
3500
3602
  "flags": {
3501
3603
  "json": {
@@ -3524,33 +3626,54 @@
3524
3626
  "name": "stage",
3525
3627
  "allowNo": false,
3526
3628
  "type": "boolean"
3629
+ },
3630
+ "description": {
3631
+ "char": "d",
3632
+ "description": "New description for the organization",
3633
+ "name": "description",
3634
+ "hasDynamicHelp": false,
3635
+ "multiple": false,
3636
+ "type": "option"
3637
+ },
3638
+ "name": {
3639
+ "char": "n",
3640
+ "description": "New name for the organization",
3641
+ "name": "name",
3642
+ "hasDynamicHelp": false,
3643
+ "multiple": false,
3644
+ "type": "option"
3527
3645
  }
3528
3646
  },
3529
3647
  "hasDynamicHelp": false,
3530
3648
  "hiddenAliases": [],
3531
- "id": "persona:get",
3649
+ "id": "org:update",
3532
3650
  "pluginAlias": "@formant/formant-cli",
3533
3651
  "pluginName": "@formant/formant-cli",
3534
3652
  "pluginType": "core",
3535
3653
  "strict": true,
3536
- "summary": "Get persona details and tools",
3654
+ "summary": "Update your organization",
3537
3655
  "enableJsonFlag": true,
3538
3656
  "isESM": true,
3539
3657
  "relativePath": [
3540
3658
  "dist",
3541
3659
  "commands",
3542
- "persona",
3543
- "get.js"
3660
+ "org",
3661
+ "update.js"
3544
3662
  ]
3545
3663
  },
3546
- "persona:list": {
3664
+ "user:get": {
3547
3665
  "aliases": [],
3548
- "args": {},
3549
- "description": "List AI personas available in your organization.\n\nShows both built-in and custom personas with their ID, name, and description.",
3666
+ "args": {
3667
+ "id": {
3668
+ "description": "User ID (UUID)",
3669
+ "name": "id",
3670
+ "required": true
3671
+ }
3672
+ },
3673
+ "description": "Get detailed information about a user.\n\nShows user details including email, name, roles, and account settings.",
3550
3674
  "examples": [
3551
- "<%= config.bin %> personas list",
3552
- "<%= config.bin %> personas list --json",
3553
- "<%= config.bin %> personas list --dev"
3675
+ "<%= config.bin %> user get <user-id>",
3676
+ "<%= config.bin %> user get <user-id> --json"
3554
3677
  ],
3555
3678
  "flags": {
3556
3679
  "json": {
@@ -3583,35 +3706,28 @@
3583
3706
  },
3584
3707
  "hasDynamicHelp": false,
3585
3708
  "hiddenAliases": [],
3586
- "id": "persona:list",
3709
+ "id": "user:get",
3587
3710
  "pluginAlias": "@formant/formant-cli",
3588
3711
  "pluginName": "@formant/formant-cli",
3589
3712
  "pluginType": "core",
3590
3713
  "strict": true,
3591
- "summary": "List AI personas",
3714
+ "summary": "Get user details",
3592
3715
  "enableJsonFlag": true,
3593
3716
  "isESM": true,
3594
3717
  "relativePath": [
3595
3718
  "dist",
3596
3719
  "commands",
3597
- "persona",
3598
- "list.js"
3720
+ "user",
3721
+ "get.js"
3599
3722
  ]
3600
3723
  },
3601
- "persona:task-status": {
3724
+ "user:list": {
3602
3725
  "aliases": [],
3603
- "args": {
3604
- "taskId": {
3605
- "description": "Task ID (from delegate-task output)",
3606
- "name": "taskId",
3607
- "required": true
3608
- }
3609
- },
3610
- "description": "Check the status and results of a delegated task.\n\nShows all runs for a task including their status, result summary, and timestamps.",
3726
+ "args": {},
3727
+ "description": "List all users in your organization.\n\nShows user accounts, their email addresses, and account status.",
3611
3728
  "examples": [
3612
- "<%= config.bin %> persona task-status <task-id>",
3613
- "<%= config.bin %> persona task-status <task-id> --json",
3614
- "<%= config.bin %> persona task-status <task-id> --dev"
3729
+ "<%= config.bin %> user list",
3730
+ "<%= config.bin %> user list --json"
3615
3731
  ],
3616
3732
  "flags": {
3617
3733
  "json": {
@@ -3644,19 +3760,19 @@
3644
3760
  },
3645
3761
  "hasDynamicHelp": false,
3646
3762
  "hiddenAliases": [],
3647
- "id": "persona:task-status",
3763
+ "id": "user:list",
3648
3764
  "pluginAlias": "@formant/formant-cli",
3649
3765
  "pluginName": "@formant/formant-cli",
3650
3766
  "pluginType": "core",
3651
3767
  "strict": true,
3652
- "summary": "Check status of a delegated task",
3768
+ "summary": "List users",
3653
3769
  "enableJsonFlag": true,
3654
3770
  "isESM": true,
3655
3771
  "relativePath": [
3656
3772
  "dist",
3657
3773
  "commands",
3658
- "persona",
3659
- "task-status.js"
3774
+ "user",
3775
+ "list.js"
3660
3776
  ]
3661
3777
  },
3662
3778
  "schedule:get": {
@@ -3773,120 +3889,6 @@
3773
3889
  "list.js"
3774
3890
  ]
3775
3891
  },
3776
- "user:get": {
3777
- "aliases": [],
3778
- "args": {
3779
- "id": {
3780
- "description": "User ID (UUID)",
3781
- "name": "id",
3782
- "required": true
3783
- }
3784
- },
3785
- "description": "Get detailed information about a user.\n\nShows user details including email, name, roles, and account settings.",
3786
- "examples": [
3787
- "<%= config.bin %> user get <user-id>",
3788
- "<%= config.bin %> user get <user-id> --json"
3789
- ],
3790
- "flags": {
3791
- "json": {
3792
- "description": "Format output as json.",
3793
- "helpGroup": "GLOBAL",
3794
- "name": "json",
3795
- "allowNo": false,
3796
- "type": "boolean"
3797
- },
3798
- "dev": {
3799
- "description": "Target the dev environment",
3800
- "exclusive": [
3801
- "stage"
3802
- ],
3803
- "helpGroup": "GLOBAL",
3804
- "name": "dev",
3805
- "allowNo": false,
3806
- "type": "boolean"
3807
- },
3808
- "stage": {
3809
- "description": "Target the stage environment",
3810
- "exclusive": [
3811
- "dev"
3812
- ],
3813
- "helpGroup": "GLOBAL",
3814
- "name": "stage",
3815
- "allowNo": false,
3816
- "type": "boolean"
3817
- }
3818
- },
3819
- "hasDynamicHelp": false,
3820
- "hiddenAliases": [],
3821
- "id": "user:get",
3822
- "pluginAlias": "@formant/formant-cli",
3823
- "pluginName": "@formant/formant-cli",
3824
- "pluginType": "core",
3825
- "strict": true,
3826
- "summary": "Get user details",
3827
- "enableJsonFlag": true,
3828
- "isESM": true,
3829
- "relativePath": [
3830
- "dist",
3831
- "commands",
3832
- "user",
3833
- "get.js"
3834
- ]
3835
- },
3836
- "user:list": {
3837
- "aliases": [],
3838
- "args": {},
3839
- "description": "List all users in your organization.\n\nShows user accounts, their email addresses, and account status.",
3840
- "examples": [
3841
- "<%= config.bin %> user list",
3842
- "<%= config.bin %> user list --json"
3843
- ],
3844
- "flags": {
3845
- "json": {
3846
- "description": "Format output as json.",
3847
- "helpGroup": "GLOBAL",
3848
- "name": "json",
3849
- "allowNo": false,
3850
- "type": "boolean"
3851
- },
3852
- "dev": {
3853
- "description": "Target the dev environment",
3854
- "exclusive": [
3855
- "stage"
3856
- ],
3857
- "helpGroup": "GLOBAL",
3858
- "name": "dev",
3859
- "allowNo": false,
3860
- "type": "boolean"
3861
- },
3862
- "stage": {
3863
- "description": "Target the stage environment",
3864
- "exclusive": [
3865
- "dev"
3866
- ],
3867
- "helpGroup": "GLOBAL",
3868
- "name": "stage",
3869
- "allowNo": false,
3870
- "type": "boolean"
3871
- }
3872
- },
3873
- "hasDynamicHelp": false,
3874
- "hiddenAliases": [],
3875
- "id": "user:list",
3876
- "pluginAlias": "@formant/formant-cli",
3877
- "pluginName": "@formant/formant-cli",
3878
- "pluginType": "core",
3879
- "strict": true,
3880
- "summary": "List users",
3881
- "enableJsonFlag": true,
3882
- "isESM": true,
3883
- "relativePath": [
3884
- "dist",
3885
- "commands",
3886
- "user",
3887
- "list.js"
3888
- ]
3889
- },
3890
3892
  "signal:count": {
3891
3893
  "aliases": [],
3892
3894
  "args": {},
@@ -4347,5 +4349,5 @@
4347
4349
  ]
4348
4350
  }
4349
4351
  },
4350
- "version": "0.4.3"
4352
+ "version": "0.4.4"
4351
4353
  }