faces-cli 1.5.13 → 1.5.15

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.
Files changed (15) hide show
  1. package/dist/commands/auth/refresh.js +1 -1
  2. package/dist/commands/billing/usage.js +7 -1
  3. package/dist/commands/catalog/backup.d.ts +10 -0
  4. package/dist/commands/catalog/backup.js +101 -0
  5. package/dist/commands/catalog/restore.d.ts +16 -0
  6. package/dist/commands/catalog/restore.js +147 -0
  7. package/dist/commands/compile/all.d.ts +11 -0
  8. package/dist/commands/compile/all.js +116 -0
  9. package/dist/commands/face/create.js +2 -0
  10. package/dist/commands/keys/create.js +1 -1
  11. package/dist/commands/keys/list.js +1 -1
  12. package/dist/commands/keys/revoke.js +1 -1
  13. package/dist/commands/keys/update.js +1 -1
  14. package/oclif.manifest.json +1151 -973
  15. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -1,22 +1,9 @@
1
1
  {
2
2
  "commands": {
3
- "auth:connect": {
3
+ "account:state": {
4
4
  "aliases": [],
5
- "args": {
6
- "provider": {
7
- "description": "OAuth provider to connect",
8
- "name": "provider",
9
- "options": [
10
- "openai"
11
- ],
12
- "required": true
13
- }
14
- },
15
- "description": "Connect an OAuth provider account to Faces (e.g. ChatGPT Plus/Pro)",
16
- "examples": [
17
- "<%= config.bin %> auth connect openai",
18
- "<%= config.bin %> auth connect openai --manual"
19
- ],
5
+ "args": {},
6
+ "description": "Full account routing state (plan, balance, onboarding)",
20
7
  "flags": {
21
8
  "json": {
22
9
  "description": "Format output as json.",
@@ -48,17 +35,11 @@
48
35
  "hasDynamicHelp": false,
49
36
  "multiple": false,
50
37
  "type": "option"
51
- },
52
- "manual": {
53
- "description": "Manual mode for headless environments: prints the authorize URL and prompts you to paste the callback URL after approving in any browser.",
54
- "name": "manual",
55
- "allowNo": false,
56
- "type": "boolean"
57
38
  }
58
39
  },
59
40
  "hasDynamicHelp": false,
60
41
  "hiddenAliases": [],
61
- "id": "auth:connect",
42
+ "id": "account:state",
62
43
  "pluginAlias": "faces-cli",
63
44
  "pluginName": "faces-cli",
64
45
  "pluginType": "core",
@@ -68,18 +49,14 @@
68
49
  "relativePath": [
69
50
  "dist",
70
51
  "commands",
71
- "auth",
72
- "connect.js"
52
+ "account",
53
+ "state.js"
73
54
  ]
74
55
  },
75
- "auth:connections": {
56
+ "billing:balance": {
76
57
  "aliases": [],
77
58
  "args": {},
78
- "description": "List connected OAuth provider accounts",
79
- "examples": [
80
- "<%= config.bin %> auth connections",
81
- "<%= config.bin %> auth connections --json"
82
- ],
59
+ "description": "Show credit balance and payment method status",
83
60
  "flags": {
84
61
  "json": {
85
62
  "description": "Format output as json.",
@@ -115,7 +92,7 @@
115
92
  },
116
93
  "hasDynamicHelp": false,
117
94
  "hiddenAliases": [],
118
- "id": "auth:connections",
95
+ "id": "billing:balance",
119
96
  "pluginAlias": "faces-cli",
120
97
  "pluginName": "faces-cli",
121
98
  "pluginType": "core",
@@ -125,26 +102,14 @@
125
102
  "relativePath": [
126
103
  "dist",
127
104
  "commands",
128
- "auth",
129
- "connections.js"
105
+ "billing",
106
+ "balance.js"
130
107
  ]
131
108
  },
132
- "auth:disconnect": {
109
+ "billing:card-setup": {
133
110
  "aliases": [],
134
- "args": {
135
- "provider": {
136
- "description": "OAuth provider to disconnect",
137
- "name": "provider",
138
- "options": [
139
- "openai"
140
- ],
141
- "required": true
142
- }
143
- },
144
- "description": "Disconnect a linked OAuth provider account",
145
- "examples": [
146
- "<%= config.bin %> auth disconnect openai"
147
- ],
111
+ "args": {},
112
+ "description": "Get a Stripe card setup URL to save a payment method",
148
113
  "flags": {
149
114
  "json": {
150
115
  "description": "Format output as json.",
@@ -180,7 +145,7 @@
180
145
  },
181
146
  "hasDynamicHelp": false,
182
147
  "hiddenAliases": [],
183
- "id": "auth:disconnect",
148
+ "id": "billing:card-setup",
184
149
  "pluginAlias": "faces-cli",
185
150
  "pluginName": "faces-cli",
186
151
  "pluginType": "core",
@@ -190,14 +155,14 @@
190
155
  "relativePath": [
191
156
  "dist",
192
157
  "commands",
193
- "auth",
194
- "disconnect.js"
158
+ "billing",
159
+ "card-setup.js"
195
160
  ]
196
161
  },
197
- "auth:login": {
162
+ "billing:checkout": {
198
163
  "aliases": [],
199
164
  "args": {},
200
- "description": "Login and save JWT credentials",
165
+ "description": "Get a Stripe checkout URL to upgrade your subscription plan",
201
166
  "flags": {
202
167
  "json": {
203
168
  "description": "Format output as json.",
@@ -230,26 +195,21 @@
230
195
  "multiple": false,
231
196
  "type": "option"
232
197
  },
233
- "email": {
234
- "description": "Account email",
235
- "name": "email",
236
- "required": true,
237
- "hasDynamicHelp": false,
238
- "multiple": false,
239
- "type": "option"
240
- },
241
- "password": {
242
- "description": "Account password",
243
- "name": "password",
244
- "required": true,
198
+ "plan": {
199
+ "description": "Plan to subscribe to",
200
+ "name": "plan",
201
+ "default": "connect",
245
202
  "hasDynamicHelp": false,
246
203
  "multiple": false,
204
+ "options": [
205
+ "connect"
206
+ ],
247
207
  "type": "option"
248
208
  }
249
209
  },
250
210
  "hasDynamicHelp": false,
251
211
  "hiddenAliases": [],
252
- "id": "auth:login",
212
+ "id": "billing:checkout",
253
213
  "pluginAlias": "faces-cli",
254
214
  "pluginName": "faces-cli",
255
215
  "pluginType": "core",
@@ -259,14 +219,14 @@
259
219
  "relativePath": [
260
220
  "dist",
261
221
  "commands",
262
- "auth",
263
- "login.js"
222
+ "billing",
223
+ "checkout.js"
264
224
  ]
265
225
  },
266
- "auth:logout": {
226
+ "billing:llm-costs": {
267
227
  "aliases": [],
268
228
  "args": {},
269
- "description": "Clear saved credentials",
229
+ "description": "List available LLMs and their per-token costs",
270
230
  "flags": {
271
231
  "json": {
272
232
  "description": "Format output as json.",
@@ -298,11 +258,18 @@
298
258
  "hasDynamicHelp": false,
299
259
  "multiple": false,
300
260
  "type": "option"
261
+ },
262
+ "provider": {
263
+ "description": "Filter by provider (e.g. openai, anthropic)",
264
+ "name": "provider",
265
+ "hasDynamicHelp": false,
266
+ "multiple": false,
267
+ "type": "option"
301
268
  }
302
269
  },
303
270
  "hasDynamicHelp": false,
304
271
  "hiddenAliases": [],
305
- "id": "auth:logout",
272
+ "id": "billing:llm-costs",
306
273
  "pluginAlias": "faces-cli",
307
274
  "pluginName": "faces-cli",
308
275
  "pluginType": "core",
@@ -312,14 +279,14 @@
312
279
  "relativePath": [
313
280
  "dist",
314
281
  "commands",
315
- "auth",
316
- "logout.js"
282
+ "billing",
283
+ "llm-costs.js"
317
284
  ]
318
285
  },
319
- "auth:refresh": {
286
+ "billing:quota": {
320
287
  "aliases": [],
321
288
  "args": {},
322
- "description": "Exchange current JWT for a fresh one",
289
+ "description": "Show compile token quota and per-face stats",
323
290
  "flags": {
324
291
  "json": {
325
292
  "description": "Format output as json.",
@@ -355,7 +322,7 @@
355
322
  },
356
323
  "hasDynamicHelp": false,
357
324
  "hiddenAliases": [],
358
- "id": "auth:refresh",
325
+ "id": "billing:quota",
359
326
  "pluginAlias": "faces-cli",
360
327
  "pluginName": "faces-cli",
361
328
  "pluginType": "core",
@@ -365,14 +332,14 @@
365
332
  "relativePath": [
366
333
  "dist",
367
334
  "commands",
368
- "auth",
369
- "refresh.js"
335
+ "billing",
336
+ "quota.js"
370
337
  ]
371
338
  },
372
- "auth:register": {
339
+ "billing:subscription": {
373
340
  "aliases": [],
374
341
  "args": {},
375
- "description": "Create a new Faces account",
342
+ "description": "Show current plan, face count, and renewal date",
376
343
  "flags": {
377
344
  "json": {
378
345
  "description": "Format output as json.",
@@ -404,61 +371,11 @@
404
371
  "hasDynamicHelp": false,
405
372
  "multiple": false,
406
373
  "type": "option"
407
- },
408
- "email": {
409
- "description": "Email address",
410
- "name": "email",
411
- "required": true,
412
- "hasDynamicHelp": false,
413
- "multiple": false,
414
- "type": "option"
415
- },
416
- "password": {
417
- "description": "Password",
418
- "name": "password",
419
- "required": true,
420
- "hasDynamicHelp": false,
421
- "multiple": false,
422
- "type": "option"
423
- },
424
- "name": {
425
- "description": "Display name (defaults to username)",
426
- "name": "name",
427
- "hasDynamicHelp": false,
428
- "multiple": false,
429
- "type": "option"
430
- },
431
- "username": {
432
- "description": "Username (lowercase, dashes, numbers)",
433
- "name": "username",
434
- "required": true,
435
- "hasDynamicHelp": false,
436
- "multiple": false,
437
- "type": "option"
438
- },
439
- "invite-key": {
440
- "description": "Invite key (if required)",
441
- "name": "invite-key",
442
- "hasDynamicHelp": false,
443
- "multiple": false,
444
- "type": "option"
445
- },
446
- "plan": {
447
- "description": "Plan to subscribe to: \"free\" ($5 activation) or \"connect\" ($17/mo, no activation fee)",
448
- "name": "plan",
449
- "default": "free",
450
- "hasDynamicHelp": false,
451
- "multiple": false,
452
- "options": [
453
- "free",
454
- "connect"
455
- ],
456
- "type": "option"
457
374
  }
458
375
  },
459
376
  "hasDynamicHelp": false,
460
377
  "hiddenAliases": [],
461
- "id": "auth:register",
378
+ "id": "billing:subscription",
462
379
  "pluginAlias": "faces-cli",
463
380
  "pluginName": "faces-cli",
464
381
  "pluginType": "core",
@@ -468,14 +385,14 @@
468
385
  "relativePath": [
469
386
  "dist",
470
387
  "commands",
471
- "auth",
472
- "register.js"
388
+ "billing",
389
+ "subscription.js"
473
390
  ]
474
391
  },
475
- "auth:whoami": {
392
+ "billing:topup": {
476
393
  "aliases": [],
477
394
  "args": {},
478
- "description": "Print current user profile and auth diagnostic",
395
+ "description": "Top up credit balance using saved payment method",
479
396
  "flags": {
480
397
  "json": {
481
398
  "description": "Format output as json.",
@@ -507,11 +424,26 @@
507
424
  "hasDynamicHelp": false,
508
425
  "multiple": false,
509
426
  "type": "option"
427
+ },
428
+ "amount": {
429
+ "description": "Top-up amount in USD (min $1)",
430
+ "name": "amount",
431
+ "required": true,
432
+ "hasDynamicHelp": false,
433
+ "multiple": false,
434
+ "type": "option"
435
+ },
436
+ "payment-ref": {
437
+ "description": "Payment reference (admin/test path)",
438
+ "name": "payment-ref",
439
+ "hasDynamicHelp": false,
440
+ "multiple": false,
441
+ "type": "option"
510
442
  }
511
443
  },
512
444
  "hasDynamicHelp": false,
513
445
  "hiddenAliases": [],
514
- "id": "auth:whoami",
446
+ "id": "billing:topup",
515
447
  "pluginAlias": "faces-cli",
516
448
  "pluginName": "faces-cli",
517
449
  "pluginType": "core",
@@ -521,14 +453,14 @@
521
453
  "relativePath": [
522
454
  "dist",
523
455
  "commands",
524
- "auth",
525
- "whoami.js"
456
+ "billing",
457
+ "topup.js"
526
458
  ]
527
459
  },
528
- "billing:balance": {
460
+ "billing:usage": {
529
461
  "aliases": [],
530
462
  "args": {},
531
- "description": "Show credit balance and payment method status",
463
+ "description": "Aggregated usage analytics",
532
464
  "flags": {
533
465
  "json": {
534
466
  "description": "Format output as json.",
@@ -560,11 +492,38 @@
560
492
  "hasDynamicHelp": false,
561
493
  "multiple": false,
562
494
  "type": "option"
495
+ },
496
+ "group-by": {
497
+ "description": "Group results",
498
+ "name": "group-by",
499
+ "hasDynamicHelp": false,
500
+ "multiple": false,
501
+ "options": [
502
+ "api_key",
503
+ "model",
504
+ "llm",
505
+ "date"
506
+ ],
507
+ "type": "option"
508
+ },
509
+ "from": {
510
+ "description": "Start date (YYYY-MM-DD)",
511
+ "name": "from",
512
+ "hasDynamicHelp": false,
513
+ "multiple": false,
514
+ "type": "option"
515
+ },
516
+ "to": {
517
+ "description": "End date (YYYY-MM-DD)",
518
+ "name": "to",
519
+ "hasDynamicHelp": false,
520
+ "multiple": false,
521
+ "type": "option"
563
522
  }
564
523
  },
565
524
  "hasDynamicHelp": false,
566
525
  "hiddenAliases": [],
567
- "id": "billing:balance",
526
+ "id": "billing:usage",
568
527
  "pluginAlias": "faces-cli",
569
528
  "pluginName": "faces-cli",
570
529
  "pluginType": "core",
@@ -575,13 +534,13 @@
575
534
  "dist",
576
535
  "commands",
577
536
  "billing",
578
- "balance.js"
537
+ "usage.js"
579
538
  ]
580
539
  },
581
- "billing:card-setup": {
540
+ "catalog:backup": {
582
541
  "aliases": [],
583
542
  "args": {},
584
- "description": "Get a Stripe card setup URL to save a payment method",
543
+ "description": "Snapshot all faces and source material for migration",
585
544
  "flags": {
586
545
  "json": {
587
546
  "description": "Format output as json.",
@@ -617,7 +576,7 @@
617
576
  },
618
577
  "hasDynamicHelp": false,
619
578
  "hiddenAliases": [],
620
- "id": "billing:card-setup",
579
+ "id": "catalog:backup",
621
580
  "pluginAlias": "faces-cli",
622
581
  "pluginName": "faces-cli",
623
582
  "pluginType": "core",
@@ -627,14 +586,14 @@
627
586
  "relativePath": [
628
587
  "dist",
629
588
  "commands",
630
- "billing",
631
- "card-setup.js"
589
+ "catalog",
590
+ "backup.js"
632
591
  ]
633
592
  },
634
- "billing:checkout": {
593
+ "catalog:doctor": {
635
594
  "aliases": [],
636
595
  "args": {},
637
- "description": "Get a Stripe checkout URL to upgrade your subscription plan",
596
+ "description": "Diagnose and repair the local face catalog",
638
597
  "flags": {
639
598
  "json": {
640
599
  "description": "Format output as json.",
@@ -667,21 +626,22 @@
667
626
  "multiple": false,
668
627
  "type": "option"
669
628
  },
670
- "plan": {
671
- "description": "Plan to subscribe to",
672
- "name": "plan",
673
- "default": "connect",
674
- "hasDynamicHelp": false,
675
- "multiple": false,
676
- "options": [
677
- "connect"
678
- ],
679
- "type": "option"
629
+ "fix": {
630
+ "description": "Rebuild missing or stale catalog entries from API",
631
+ "name": "fix",
632
+ "allowNo": false,
633
+ "type": "boolean"
634
+ },
635
+ "generate": {
636
+ "description": "Fix + generate missing descriptions via LLM",
637
+ "name": "generate",
638
+ "allowNo": false,
639
+ "type": "boolean"
680
640
  }
681
641
  },
682
642
  "hasDynamicHelp": false,
683
643
  "hiddenAliases": [],
684
- "id": "billing:checkout",
644
+ "id": "catalog:doctor",
685
645
  "pluginAlias": "faces-cli",
686
646
  "pluginName": "faces-cli",
687
647
  "pluginType": "core",
@@ -691,14 +651,14 @@
691
651
  "relativePath": [
692
652
  "dist",
693
653
  "commands",
694
- "billing",
695
- "checkout.js"
654
+ "catalog",
655
+ "doctor.js"
696
656
  ]
697
657
  },
698
- "billing:llm-costs": {
658
+ "catalog:list": {
699
659
  "aliases": [],
700
660
  "args": {},
701
- "description": "List available LLMs and their per-token costs",
661
+ "description": "List all faces in the local catalog",
702
662
  "flags": {
703
663
  "json": {
704
664
  "description": "Format output as json.",
@@ -730,18 +690,11 @@
730
690
  "hasDynamicHelp": false,
731
691
  "multiple": false,
732
692
  "type": "option"
733
- },
734
- "provider": {
735
- "description": "Filter by provider (e.g. openai, anthropic)",
736
- "name": "provider",
737
- "hasDynamicHelp": false,
738
- "multiple": false,
739
- "type": "option"
740
693
  }
741
694
  },
742
695
  "hasDynamicHelp": false,
743
696
  "hiddenAliases": [],
744
- "id": "billing:llm-costs",
697
+ "id": "catalog:list",
745
698
  "pluginAlias": "faces-cli",
746
699
  "pluginName": "faces-cli",
747
700
  "pluginType": "core",
@@ -751,14 +704,14 @@
751
704
  "relativePath": [
752
705
  "dist",
753
706
  "commands",
754
- "billing",
755
- "llm-costs.js"
707
+ "catalog",
708
+ "list.js"
756
709
  ]
757
710
  },
758
- "billing:quota": {
711
+ "catalog:manyfaced": {
759
712
  "aliases": [],
760
713
  "args": {},
761
- "description": "Show compile token quota and per-face stats",
714
+ "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
762
715
  "flags": {
763
716
  "json": {
764
717
  "description": "Format output as json.",
@@ -790,11 +743,38 @@
790
743
  "hasDynamicHelp": false,
791
744
  "multiple": false,
792
745
  "type": "option"
746
+ },
747
+ "skill": {
748
+ "description": "Show details for a specific skill",
749
+ "name": "skill",
750
+ "hasDynamicHelp": false,
751
+ "multiple": false,
752
+ "type": "option"
753
+ },
754
+ "install": {
755
+ "description": "Install a skill by name",
756
+ "name": "install",
757
+ "hasDynamicHelp": false,
758
+ "multiple": false,
759
+ "type": "option"
760
+ },
761
+ "skills-dir": {
762
+ "description": "Directory to install skills into (required for --install)",
763
+ "name": "skills-dir",
764
+ "hasDynamicHelp": false,
765
+ "multiple": false,
766
+ "type": "option"
767
+ },
768
+ "refresh": {
769
+ "description": "Force refresh the skill index (ignore cache)",
770
+ "name": "refresh",
771
+ "allowNo": false,
772
+ "type": "boolean"
793
773
  }
794
774
  },
795
775
  "hasDynamicHelp": false,
796
776
  "hiddenAliases": [],
797
- "id": "billing:quota",
777
+ "id": "catalog:manyfaced",
798
778
  "pluginAlias": "faces-cli",
799
779
  "pluginName": "faces-cli",
800
780
  "pluginType": "core",
@@ -804,14 +784,19 @@
804
784
  "relativePath": [
805
785
  "dist",
806
786
  "commands",
807
- "billing",
808
- "quota.js"
787
+ "catalog",
788
+ "manyfaced.js"
809
789
  ]
810
790
  },
811
- "billing:subscription": {
791
+ "catalog:restore": {
812
792
  "aliases": [],
813
- "args": {},
814
- "description": "Show current plan, face count, and renewal date",
793
+ "args": {
794
+ "file": {
795
+ "description": "Backup file path (default: most recent in ~/.faces/backups/)",
796
+ "name": "file"
797
+ }
798
+ },
799
+ "description": "Restore faces and source material from a backup snapshot",
815
800
  "flags": {
816
801
  "json": {
817
802
  "description": "Format output as json.",
@@ -843,11 +828,17 @@
843
828
  "hasDynamicHelp": false,
844
829
  "multiple": false,
845
830
  "type": "option"
831
+ },
832
+ "compile": {
833
+ "description": "Run compile:all after restoring",
834
+ "name": "compile",
835
+ "allowNo": false,
836
+ "type": "boolean"
846
837
  }
847
838
  },
848
839
  "hasDynamicHelp": false,
849
840
  "hiddenAliases": [],
850
- "id": "billing:subscription",
841
+ "id": "catalog:restore",
851
842
  "pluginAlias": "faces-cli",
852
843
  "pluginName": "faces-cli",
853
844
  "pluginType": "core",
@@ -857,14 +848,27 @@
857
848
  "relativePath": [
858
849
  "dist",
859
850
  "commands",
860
- "billing",
861
- "subscription.js"
851
+ "catalog",
852
+ "restore.js"
862
853
  ]
863
854
  },
864
- "billing:topup": {
855
+ "auth:connect": {
865
856
  "aliases": [],
866
- "args": {},
867
- "description": "Top up credit balance using saved payment method",
857
+ "args": {
858
+ "provider": {
859
+ "description": "OAuth provider to connect",
860
+ "name": "provider",
861
+ "options": [
862
+ "openai"
863
+ ],
864
+ "required": true
865
+ }
866
+ },
867
+ "description": "Connect an OAuth provider account to Faces (e.g. ChatGPT Plus/Pro)",
868
+ "examples": [
869
+ "<%= config.bin %> auth connect openai",
870
+ "<%= config.bin %> auth connect openai --manual"
871
+ ],
868
872
  "flags": {
869
873
  "json": {
870
874
  "description": "Format output as json.",
@@ -897,25 +901,16 @@
897
901
  "multiple": false,
898
902
  "type": "option"
899
903
  },
900
- "amount": {
901
- "description": "Top-up amount in USD (min $1)",
902
- "name": "amount",
903
- "required": true,
904
- "hasDynamicHelp": false,
905
- "multiple": false,
906
- "type": "option"
907
- },
908
- "payment-ref": {
909
- "description": "Payment reference (admin/test path)",
910
- "name": "payment-ref",
911
- "hasDynamicHelp": false,
912
- "multiple": false,
913
- "type": "option"
904
+ "manual": {
905
+ "description": "Manual mode for headless environments: prints the authorize URL and prompts you to paste the callback URL after approving in any browser.",
906
+ "name": "manual",
907
+ "allowNo": false,
908
+ "type": "boolean"
914
909
  }
915
910
  },
916
911
  "hasDynamicHelp": false,
917
912
  "hiddenAliases": [],
918
- "id": "billing:topup",
913
+ "id": "auth:connect",
919
914
  "pluginAlias": "faces-cli",
920
915
  "pluginName": "faces-cli",
921
916
  "pluginType": "core",
@@ -925,14 +920,18 @@
925
920
  "relativePath": [
926
921
  "dist",
927
922
  "commands",
928
- "billing",
929
- "topup.js"
923
+ "auth",
924
+ "connect.js"
930
925
  ]
931
926
  },
932
- "billing:usage": {
927
+ "auth:connections": {
933
928
  "aliases": [],
934
929
  "args": {},
935
- "description": "Aggregated usage analytics",
930
+ "description": "List connected OAuth provider accounts",
931
+ "examples": [
932
+ "<%= config.bin %> auth connections",
933
+ "<%= config.bin %> auth connections --json"
934
+ ],
936
935
  "flags": {
937
936
  "json": {
938
937
  "description": "Format output as json.",
@@ -964,38 +963,11 @@
964
963
  "hasDynamicHelp": false,
965
964
  "multiple": false,
966
965
  "type": "option"
967
- },
968
- "group-by": {
969
- "description": "Group results",
970
- "name": "group-by",
971
- "hasDynamicHelp": false,
972
- "multiple": false,
973
- "options": [
974
- "api_key",
975
- "model",
976
- "llm",
977
- "date"
978
- ],
979
- "type": "option"
980
- },
981
- "from": {
982
- "description": "Start date (YYYY-MM-DD)",
983
- "name": "from",
984
- "hasDynamicHelp": false,
985
- "multiple": false,
986
- "type": "option"
987
- },
988
- "to": {
989
- "description": "End date (YYYY-MM-DD)",
990
- "name": "to",
991
- "hasDynamicHelp": false,
992
- "multiple": false,
993
- "type": "option"
994
966
  }
995
967
  },
996
968
  "hasDynamicHelp": false,
997
969
  "hiddenAliases": [],
998
- "id": "billing:usage",
970
+ "id": "auth:connections",
999
971
  "pluginAlias": "faces-cli",
1000
972
  "pluginName": "faces-cli",
1001
973
  "pluginType": "core",
@@ -1005,14 +977,26 @@
1005
977
  "relativePath": [
1006
978
  "dist",
1007
979
  "commands",
1008
- "billing",
1009
- "usage.js"
980
+ "auth",
981
+ "connections.js"
1010
982
  ]
1011
983
  },
1012
- "catalog:doctor": {
984
+ "auth:disconnect": {
1013
985
  "aliases": [],
1014
- "args": {},
1015
- "description": "Diagnose and repair the local face catalog",
986
+ "args": {
987
+ "provider": {
988
+ "description": "OAuth provider to disconnect",
989
+ "name": "provider",
990
+ "options": [
991
+ "openai"
992
+ ],
993
+ "required": true
994
+ }
995
+ },
996
+ "description": "Disconnect a linked OAuth provider account",
997
+ "examples": [
998
+ "<%= config.bin %> auth disconnect openai"
999
+ ],
1016
1000
  "flags": {
1017
1001
  "json": {
1018
1002
  "description": "Format output as json.",
@@ -1044,23 +1028,11 @@
1044
1028
  "hasDynamicHelp": false,
1045
1029
  "multiple": false,
1046
1030
  "type": "option"
1047
- },
1048
- "fix": {
1049
- "description": "Rebuild missing or stale catalog entries from API",
1050
- "name": "fix",
1051
- "allowNo": false,
1052
- "type": "boolean"
1053
- },
1054
- "generate": {
1055
- "description": "Fix + generate missing descriptions via LLM",
1056
- "name": "generate",
1057
- "allowNo": false,
1058
- "type": "boolean"
1059
1031
  }
1060
1032
  },
1061
1033
  "hasDynamicHelp": false,
1062
1034
  "hiddenAliases": [],
1063
- "id": "catalog:doctor",
1035
+ "id": "auth:disconnect",
1064
1036
  "pluginAlias": "faces-cli",
1065
1037
  "pluginName": "faces-cli",
1066
1038
  "pluginType": "core",
@@ -1070,14 +1042,14 @@
1070
1042
  "relativePath": [
1071
1043
  "dist",
1072
1044
  "commands",
1073
- "catalog",
1074
- "doctor.js"
1045
+ "auth",
1046
+ "disconnect.js"
1075
1047
  ]
1076
1048
  },
1077
- "catalog:list": {
1049
+ "auth:login": {
1078
1050
  "aliases": [],
1079
1051
  "args": {},
1080
- "description": "List all faces in the local catalog",
1052
+ "description": "Login and save JWT credentials",
1081
1053
  "flags": {
1082
1054
  "json": {
1083
1055
  "description": "Format output as json.",
@@ -1109,11 +1081,27 @@
1109
1081
  "hasDynamicHelp": false,
1110
1082
  "multiple": false,
1111
1083
  "type": "option"
1084
+ },
1085
+ "email": {
1086
+ "description": "Account email",
1087
+ "name": "email",
1088
+ "required": true,
1089
+ "hasDynamicHelp": false,
1090
+ "multiple": false,
1091
+ "type": "option"
1092
+ },
1093
+ "password": {
1094
+ "description": "Account password",
1095
+ "name": "password",
1096
+ "required": true,
1097
+ "hasDynamicHelp": false,
1098
+ "multiple": false,
1099
+ "type": "option"
1112
1100
  }
1113
1101
  },
1114
1102
  "hasDynamicHelp": false,
1115
1103
  "hiddenAliases": [],
1116
- "id": "catalog:list",
1104
+ "id": "auth:login",
1117
1105
  "pluginAlias": "faces-cli",
1118
1106
  "pluginName": "faces-cli",
1119
1107
  "pluginType": "core",
@@ -1123,14 +1111,14 @@
1123
1111
  "relativePath": [
1124
1112
  "dist",
1125
1113
  "commands",
1126
- "catalog",
1127
- "list.js"
1114
+ "auth",
1115
+ "login.js"
1128
1116
  ]
1129
1117
  },
1130
- "catalog:manyfaced": {
1118
+ "auth:logout": {
1131
1119
  "aliases": [],
1132
1120
  "args": {},
1133
- "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
1121
+ "description": "Clear saved credentials",
1134
1122
  "flags": {
1135
1123
  "json": {
1136
1124
  "description": "Format output as json.",
@@ -1162,38 +1150,220 @@
1162
1150
  "hasDynamicHelp": false,
1163
1151
  "multiple": false,
1164
1152
  "type": "option"
1165
- },
1166
- "skill": {
1167
- "description": "Show details for a specific skill",
1168
- "name": "skill",
1169
- "hasDynamicHelp": false,
1170
- "multiple": false,
1171
- "type": "option"
1172
- },
1173
- "install": {
1174
- "description": "Install a skill by name",
1175
- "name": "install",
1153
+ }
1154
+ },
1155
+ "hasDynamicHelp": false,
1156
+ "hiddenAliases": [],
1157
+ "id": "auth:logout",
1158
+ "pluginAlias": "faces-cli",
1159
+ "pluginName": "faces-cli",
1160
+ "pluginType": "core",
1161
+ "strict": true,
1162
+ "enableJsonFlag": true,
1163
+ "isESM": true,
1164
+ "relativePath": [
1165
+ "dist",
1166
+ "commands",
1167
+ "auth",
1168
+ "logout.js"
1169
+ ]
1170
+ },
1171
+ "auth:refresh": {
1172
+ "aliases": [],
1173
+ "args": {},
1174
+ "description": "Exchange current JWT for a fresh one",
1175
+ "flags": {
1176
+ "json": {
1177
+ "description": "Format output as json.",
1178
+ "helpGroup": "GLOBAL",
1179
+ "name": "json",
1180
+ "allowNo": false,
1181
+ "type": "boolean"
1182
+ },
1183
+ "base-url": {
1184
+ "description": "API base URL",
1185
+ "env": "FACES_BASE_URL",
1186
+ "name": "base-url",
1176
1187
  "hasDynamicHelp": false,
1177
1188
  "multiple": false,
1178
1189
  "type": "option"
1179
1190
  },
1180
- "skills-dir": {
1181
- "description": "Directory to install skills into (required for --install)",
1182
- "name": "skills-dir",
1191
+ "token": {
1192
+ "description": "JWT bearer token",
1193
+ "env": "FACES_TOKEN",
1194
+ "name": "token",
1183
1195
  "hasDynamicHelp": false,
1184
1196
  "multiple": false,
1185
1197
  "type": "option"
1186
1198
  },
1187
- "refresh": {
1188
- "description": "Force refresh the skill index (ignore cache)",
1189
- "name": "refresh",
1199
+ "api-key": {
1200
+ "description": "API key",
1201
+ "env": "FACES_API_KEY",
1202
+ "name": "api-key",
1203
+ "hasDynamicHelp": false,
1204
+ "multiple": false,
1205
+ "type": "option"
1206
+ }
1207
+ },
1208
+ "hasDynamicHelp": false,
1209
+ "hiddenAliases": [],
1210
+ "id": "auth:refresh",
1211
+ "pluginAlias": "faces-cli",
1212
+ "pluginName": "faces-cli",
1213
+ "pluginType": "core",
1214
+ "strict": true,
1215
+ "enableJsonFlag": true,
1216
+ "isESM": true,
1217
+ "relativePath": [
1218
+ "dist",
1219
+ "commands",
1220
+ "auth",
1221
+ "refresh.js"
1222
+ ]
1223
+ },
1224
+ "auth:register": {
1225
+ "aliases": [],
1226
+ "args": {},
1227
+ "description": "Create a new Faces account",
1228
+ "flags": {
1229
+ "json": {
1230
+ "description": "Format output as json.",
1231
+ "helpGroup": "GLOBAL",
1232
+ "name": "json",
1233
+ "allowNo": false,
1234
+ "type": "boolean"
1235
+ },
1236
+ "base-url": {
1237
+ "description": "API base URL",
1238
+ "env": "FACES_BASE_URL",
1239
+ "name": "base-url",
1240
+ "hasDynamicHelp": false,
1241
+ "multiple": false,
1242
+ "type": "option"
1243
+ },
1244
+ "token": {
1245
+ "description": "JWT bearer token",
1246
+ "env": "FACES_TOKEN",
1247
+ "name": "token",
1248
+ "hasDynamicHelp": false,
1249
+ "multiple": false,
1250
+ "type": "option"
1251
+ },
1252
+ "api-key": {
1253
+ "description": "API key",
1254
+ "env": "FACES_API_KEY",
1255
+ "name": "api-key",
1256
+ "hasDynamicHelp": false,
1257
+ "multiple": false,
1258
+ "type": "option"
1259
+ },
1260
+ "email": {
1261
+ "description": "Email address",
1262
+ "name": "email",
1263
+ "required": true,
1264
+ "hasDynamicHelp": false,
1265
+ "multiple": false,
1266
+ "type": "option"
1267
+ },
1268
+ "password": {
1269
+ "description": "Password",
1270
+ "name": "password",
1271
+ "required": true,
1272
+ "hasDynamicHelp": false,
1273
+ "multiple": false,
1274
+ "type": "option"
1275
+ },
1276
+ "name": {
1277
+ "description": "Display name (defaults to username)",
1278
+ "name": "name",
1279
+ "hasDynamicHelp": false,
1280
+ "multiple": false,
1281
+ "type": "option"
1282
+ },
1283
+ "username": {
1284
+ "description": "Username (lowercase, dashes, numbers)",
1285
+ "name": "username",
1286
+ "required": true,
1287
+ "hasDynamicHelp": false,
1288
+ "multiple": false,
1289
+ "type": "option"
1290
+ },
1291
+ "invite-key": {
1292
+ "description": "Invite key (if required)",
1293
+ "name": "invite-key",
1294
+ "hasDynamicHelp": false,
1295
+ "multiple": false,
1296
+ "type": "option"
1297
+ },
1298
+ "plan": {
1299
+ "description": "Plan to subscribe to: \"free\" ($5 activation) or \"connect\" ($17/mo, no activation fee)",
1300
+ "name": "plan",
1301
+ "default": "free",
1302
+ "hasDynamicHelp": false,
1303
+ "multiple": false,
1304
+ "options": [
1305
+ "free",
1306
+ "connect"
1307
+ ],
1308
+ "type": "option"
1309
+ }
1310
+ },
1311
+ "hasDynamicHelp": false,
1312
+ "hiddenAliases": [],
1313
+ "id": "auth:register",
1314
+ "pluginAlias": "faces-cli",
1315
+ "pluginName": "faces-cli",
1316
+ "pluginType": "core",
1317
+ "strict": true,
1318
+ "enableJsonFlag": true,
1319
+ "isESM": true,
1320
+ "relativePath": [
1321
+ "dist",
1322
+ "commands",
1323
+ "auth",
1324
+ "register.js"
1325
+ ]
1326
+ },
1327
+ "auth:whoami": {
1328
+ "aliases": [],
1329
+ "args": {},
1330
+ "description": "Print current user profile and auth diagnostic",
1331
+ "flags": {
1332
+ "json": {
1333
+ "description": "Format output as json.",
1334
+ "helpGroup": "GLOBAL",
1335
+ "name": "json",
1190
1336
  "allowNo": false,
1191
1337
  "type": "boolean"
1338
+ },
1339
+ "base-url": {
1340
+ "description": "API base URL",
1341
+ "env": "FACES_BASE_URL",
1342
+ "name": "base-url",
1343
+ "hasDynamicHelp": false,
1344
+ "multiple": false,
1345
+ "type": "option"
1346
+ },
1347
+ "token": {
1348
+ "description": "JWT bearer token",
1349
+ "env": "FACES_TOKEN",
1350
+ "name": "token",
1351
+ "hasDynamicHelp": false,
1352
+ "multiple": false,
1353
+ "type": "option"
1354
+ },
1355
+ "api-key": {
1356
+ "description": "API key",
1357
+ "env": "FACES_API_KEY",
1358
+ "name": "api-key",
1359
+ "hasDynamicHelp": false,
1360
+ "multiple": false,
1361
+ "type": "option"
1192
1362
  }
1193
1363
  },
1194
1364
  "hasDynamicHelp": false,
1195
1365
  "hiddenAliases": [],
1196
- "id": "catalog:manyfaced",
1366
+ "id": "auth:whoami",
1197
1367
  "pluginAlias": "faces-cli",
1198
1368
  "pluginName": "faces-cli",
1199
1369
  "pluginType": "core",
@@ -1203,8 +1373,8 @@
1203
1373
  "relativePath": [
1204
1374
  "dist",
1205
1375
  "commands",
1206
- "catalog",
1207
- "manyfaced.js"
1376
+ "auth",
1377
+ "whoami.js"
1208
1378
  ]
1209
1379
  },
1210
1380
  "chat:chat": {
@@ -1492,16 +1662,10 @@
1492
1662
  "responses.js"
1493
1663
  ]
1494
1664
  },
1495
- "compile:import": {
1665
+ "compile:all": {
1496
1666
  "aliases": [],
1497
- "args": {
1498
- "face_id": {
1499
- "description": "Face alias",
1500
- "name": "face_id",
1501
- "required": true
1502
- }
1503
- },
1504
- "description": "Import a YouTube video into a face via server-side download and transcription",
1667
+ "args": {},
1668
+ "description": "Compile all uncompiled documents and threads across all faces",
1505
1669
  "flags": {
1506
1670
  "json": {
1507
1671
  "description": "Format output as json.",
@@ -1534,41 +1698,108 @@
1534
1698
  "multiple": false,
1535
1699
  "type": "option"
1536
1700
  },
1537
- "url": {
1538
- "description": "YouTube URL (youtube.com/watch?v=... or youtu.be/...)",
1539
- "name": "url",
1540
- "required": true,
1541
- "hasDynamicHelp": false,
1542
- "multiple": false,
1543
- "type": "option"
1544
- },
1545
- "type": {
1546
- "description": "\"document\" for solo talks, lectures, monologues; \"thread\" for interviews or multi-speaker conversations",
1547
- "name": "type",
1548
- "default": "document",
1549
- "hasDynamicHelp": false,
1550
- "multiple": false,
1551
- "options": [
1552
- "document",
1553
- "thread"
1554
- ],
1555
- "type": "option"
1556
- },
1557
- "perspective": {
1558
- "description": "\"first-person\" if the face is the speaker; \"third-person\" if the video is about the face",
1559
- "name": "perspective",
1560
- "default": "third-person",
1701
+ "timeout": {
1702
+ "description": "Per-item compile timeout in seconds (default: 600)",
1703
+ "name": "timeout",
1704
+ "default": 600,
1561
1705
  "hasDynamicHelp": false,
1562
1706
  "multiple": false,
1563
- "options": [
1564
- "first-person",
1565
- "third-person"
1566
- ],
1567
1707
  "type": "option"
1568
- },
1569
- "face-speaker": {
1570
- "description": "For --type thread: AssemblyAI speaker label (e.g. \"A\") that corresponds to the face. Defaults to first detected speaker.",
1571
- "name": "face-speaker",
1708
+ }
1709
+ },
1710
+ "hasDynamicHelp": false,
1711
+ "hiddenAliases": [],
1712
+ "id": "compile:all",
1713
+ "pluginAlias": "faces-cli",
1714
+ "pluginName": "faces-cli",
1715
+ "pluginType": "core",
1716
+ "strict": true,
1717
+ "enableJsonFlag": true,
1718
+ "isESM": true,
1719
+ "relativePath": [
1720
+ "dist",
1721
+ "commands",
1722
+ "compile",
1723
+ "all.js"
1724
+ ]
1725
+ },
1726
+ "compile:import": {
1727
+ "aliases": [],
1728
+ "args": {
1729
+ "face_id": {
1730
+ "description": "Face alias",
1731
+ "name": "face_id",
1732
+ "required": true
1733
+ }
1734
+ },
1735
+ "description": "Import a YouTube video into a face via server-side download and transcription",
1736
+ "flags": {
1737
+ "json": {
1738
+ "description": "Format output as json.",
1739
+ "helpGroup": "GLOBAL",
1740
+ "name": "json",
1741
+ "allowNo": false,
1742
+ "type": "boolean"
1743
+ },
1744
+ "base-url": {
1745
+ "description": "API base URL",
1746
+ "env": "FACES_BASE_URL",
1747
+ "name": "base-url",
1748
+ "hasDynamicHelp": false,
1749
+ "multiple": false,
1750
+ "type": "option"
1751
+ },
1752
+ "token": {
1753
+ "description": "JWT bearer token",
1754
+ "env": "FACES_TOKEN",
1755
+ "name": "token",
1756
+ "hasDynamicHelp": false,
1757
+ "multiple": false,
1758
+ "type": "option"
1759
+ },
1760
+ "api-key": {
1761
+ "description": "API key",
1762
+ "env": "FACES_API_KEY",
1763
+ "name": "api-key",
1764
+ "hasDynamicHelp": false,
1765
+ "multiple": false,
1766
+ "type": "option"
1767
+ },
1768
+ "url": {
1769
+ "description": "YouTube URL (youtube.com/watch?v=... or youtu.be/...)",
1770
+ "name": "url",
1771
+ "required": true,
1772
+ "hasDynamicHelp": false,
1773
+ "multiple": false,
1774
+ "type": "option"
1775
+ },
1776
+ "type": {
1777
+ "description": "\"document\" for solo talks, lectures, monologues; \"thread\" for interviews or multi-speaker conversations",
1778
+ "name": "type",
1779
+ "default": "document",
1780
+ "hasDynamicHelp": false,
1781
+ "multiple": false,
1782
+ "options": [
1783
+ "document",
1784
+ "thread"
1785
+ ],
1786
+ "type": "option"
1787
+ },
1788
+ "perspective": {
1789
+ "description": "\"first-person\" if the face is the speaker; \"third-person\" if the video is about the face",
1790
+ "name": "perspective",
1791
+ "default": "third-person",
1792
+ "hasDynamicHelp": false,
1793
+ "multiple": false,
1794
+ "options": [
1795
+ "first-person",
1796
+ "third-person"
1797
+ ],
1798
+ "type": "option"
1799
+ },
1800
+ "face-speaker": {
1801
+ "description": "For --type thread: AssemblyAI speaker label (e.g. \"A\") that corresponds to the face. Defaults to first detected speaker.",
1802
+ "name": "face-speaker",
1572
1803
  "hasDynamicHelp": false,
1573
1804
  "multiple": false,
1574
1805
  "type": "option"
@@ -1876,10 +2107,10 @@
1876
2107
  "show.js"
1877
2108
  ]
1878
2109
  },
1879
- "keys:create": {
2110
+ "face:attributes": {
1880
2111
  "aliases": [],
1881
2112
  "args": {},
1882
- "description": "Create a new API key (JWT required)",
2113
+ "description": "List all supported attribute keys",
1883
2114
  "flags": {
1884
2115
  "json": {
1885
2116
  "description": "Format output as json.",
@@ -1911,47 +2142,11 @@
1911
2142
  "hasDynamicHelp": false,
1912
2143
  "multiple": false,
1913
2144
  "type": "option"
1914
- },
1915
- "name": {
1916
- "description": "Key name/label",
1917
- "name": "name",
1918
- "required": true,
1919
- "hasDynamicHelp": false,
1920
- "multiple": false,
1921
- "type": "option"
1922
- },
1923
- "expires-days": {
1924
- "description": "Expiry in days (omit for no expiry)",
1925
- "name": "expires-days",
1926
- "hasDynamicHelp": false,
1927
- "multiple": false,
1928
- "type": "option"
1929
- },
1930
- "budget": {
1931
- "description": "Spend budget in USD",
1932
- "name": "budget",
1933
- "hasDynamicHelp": false,
1934
- "multiple": false,
1935
- "type": "option"
1936
- },
1937
- "face": {
1938
- "description": "Allowed face alias (repeatable)",
1939
- "name": "face",
1940
- "hasDynamicHelp": false,
1941
- "multiple": true,
1942
- "type": "option"
1943
- },
1944
- "model": {
1945
- "description": "Allowed model name (repeatable)",
1946
- "name": "model",
1947
- "hasDynamicHelp": false,
1948
- "multiple": true,
1949
- "type": "option"
1950
2145
  }
1951
2146
  },
1952
2147
  "hasDynamicHelp": false,
1953
2148
  "hiddenAliases": [],
1954
- "id": "keys:create",
2149
+ "id": "face:attributes",
1955
2150
  "pluginAlias": "faces-cli",
1956
2151
  "pluginName": "faces-cli",
1957
2152
  "pluginType": "core",
@@ -1961,14 +2156,14 @@
1961
2156
  "relativePath": [
1962
2157
  "dist",
1963
2158
  "commands",
1964
- "keys",
1965
- "create.js"
2159
+ "face",
2160
+ "attributes.js"
1966
2161
  ]
1967
2162
  },
1968
- "keys:list": {
2163
+ "face:create": {
1969
2164
  "aliases": [],
1970
2165
  "args": {},
1971
- "description": "List all API keys (JWT required)",
2166
+ "description": "Create a new face",
1972
2167
  "flags": {
1973
2168
  "json": {
1974
2169
  "description": "Format output as json.",
@@ -2000,11 +2195,62 @@
2000
2195
  "hasDynamicHelp": false,
2001
2196
  "multiple": false,
2002
2197
  "type": "option"
2198
+ },
2199
+ "name": {
2200
+ "description": "Display name",
2201
+ "name": "name",
2202
+ "required": true,
2203
+ "hasDynamicHelp": false,
2204
+ "multiple": false,
2205
+ "type": "option"
2206
+ },
2207
+ "alias": {
2208
+ "description": "Unique alias slug",
2209
+ "name": "alias",
2210
+ "required": true,
2211
+ "hasDynamicHelp": false,
2212
+ "multiple": false,
2213
+ "type": "option"
2214
+ },
2215
+ "description": {
2216
+ "description": "Description for local catalog",
2217
+ "name": "description",
2218
+ "hasDynamicHelp": false,
2219
+ "multiple": false,
2220
+ "type": "option"
2221
+ },
2222
+ "default-model": {
2223
+ "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
2224
+ "name": "default-model",
2225
+ "hasDynamicHelp": false,
2226
+ "multiple": false,
2227
+ "type": "option"
2228
+ },
2229
+ "formula": {
2230
+ "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
2231
+ "name": "formula",
2232
+ "hasDynamicHelp": false,
2233
+ "multiple": false,
2234
+ "type": "option"
2235
+ },
2236
+ "attr": {
2237
+ "description": "Attribute KEY=VALUE (repeatable)",
2238
+ "name": "attr",
2239
+ "hasDynamicHelp": false,
2240
+ "multiple": true,
2241
+ "type": "option"
2242
+ },
2243
+ "tool": {
2244
+ "description": "Tool name to enable (repeatable)",
2245
+ "name": "tool",
2246
+ "hasDynamicHelp": false,
2247
+ "multiple": true,
2248
+ "type": "option"
2003
2249
  }
2004
2250
  },
2005
2251
  "hasDynamicHelp": false,
2006
2252
  "hiddenAliases": [],
2007
- "id": "keys:list",
2253
+ "id": "face:create",
2008
2254
  "pluginAlias": "faces-cli",
2009
2255
  "pluginName": "faces-cli",
2010
2256
  "pluginType": "core",
@@ -2014,20 +2260,20 @@
2014
2260
  "relativePath": [
2015
2261
  "dist",
2016
2262
  "commands",
2017
- "keys",
2018
- "list.js"
2263
+ "face",
2264
+ "create.js"
2019
2265
  ]
2020
2266
  },
2021
- "keys:revoke": {
2267
+ "face:delete": {
2022
2268
  "aliases": [],
2023
2269
  "args": {
2024
- "key_id": {
2025
- "description": "Key ID",
2026
- "name": "key_id",
2270
+ "face_id": {
2271
+ "description": "Face alias",
2272
+ "name": "face_id",
2027
2273
  "required": true
2028
2274
  }
2029
2275
  },
2030
- "description": "Revoke an API key (JWT required)",
2276
+ "description": "Delete a face permanently",
2031
2277
  "flags": {
2032
2278
  "json": {
2033
2279
  "description": "Format output as json.",
@@ -2069,7 +2315,7 @@
2069
2315
  },
2070
2316
  "hasDynamicHelp": false,
2071
2317
  "hiddenAliases": [],
2072
- "id": "keys:revoke",
2318
+ "id": "face:delete",
2073
2319
  "pluginAlias": "faces-cli",
2074
2320
  "pluginName": "faces-cli",
2075
2321
  "pluginType": "core",
@@ -2079,20 +2325,14 @@
2079
2325
  "relativePath": [
2080
2326
  "dist",
2081
2327
  "commands",
2082
- "keys",
2083
- "revoke.js"
2328
+ "face",
2329
+ "delete.js"
2084
2330
  ]
2085
2331
  },
2086
- "keys:update": {
2332
+ "face:diff": {
2087
2333
  "aliases": [],
2088
- "args": {
2089
- "key_id": {
2090
- "description": "Key ID",
2091
- "name": "key_id",
2092
- "required": true
2093
- }
2094
- },
2095
- "description": "Update API key metadata (JWT required)",
2334
+ "args": {},
2335
+ "description": "Compare owned faces pairwise across all centroid components",
2096
2336
  "flags": {
2097
2337
  "json": {
2098
2338
  "description": "Format output as json.",
@@ -2125,30 +2365,18 @@
2125
2365
  "multiple": false,
2126
2366
  "type": "option"
2127
2367
  },
2128
- "name": {
2129
- "description": "New key name",
2130
- "name": "name",
2131
- "hasDynamicHelp": false,
2132
- "multiple": false,
2133
- "type": "option"
2134
- },
2135
- "budget": {
2136
- "description": "New spend budget in USD",
2137
- "name": "budget",
2368
+ "face": {
2369
+ "description": "Face alias to include (repeatable, min 2)",
2370
+ "name": "face",
2371
+ "required": true,
2138
2372
  "hasDynamicHelp": false,
2139
- "multiple": false,
2373
+ "multiple": true,
2140
2374
  "type": "option"
2141
- },
2142
- "reset-spent": {
2143
- "description": "Reset spent amount to zero",
2144
- "name": "reset-spent",
2145
- "allowNo": false,
2146
- "type": "boolean"
2147
2375
  }
2148
2376
  },
2149
2377
  "hasDynamicHelp": false,
2150
2378
  "hiddenAliases": [],
2151
- "id": "keys:update",
2379
+ "id": "face:diff",
2152
2380
  "pluginAlias": "faces-cli",
2153
2381
  "pluginName": "faces-cli",
2154
2382
  "pluginType": "core",
@@ -2158,14 +2386,20 @@
2158
2386
  "relativePath": [
2159
2387
  "dist",
2160
2388
  "commands",
2161
- "keys",
2162
- "update.js"
2389
+ "face",
2390
+ "diff.js"
2163
2391
  ]
2164
2392
  },
2165
- "account:state": {
2393
+ "face:get": {
2166
2394
  "aliases": [],
2167
- "args": {},
2168
- "description": "Full account routing state (plan, balance, onboarding)",
2395
+ "args": {
2396
+ "face_id": {
2397
+ "description": "Face alias",
2398
+ "name": "face_id",
2399
+ "required": true
2400
+ }
2401
+ },
2402
+ "description": "Get details for a face by alias",
2169
2403
  "flags": {
2170
2404
  "json": {
2171
2405
  "description": "Format output as json.",
@@ -2201,7 +2435,7 @@
2201
2435
  },
2202
2436
  "hasDynamicHelp": false,
2203
2437
  "hiddenAliases": [],
2204
- "id": "account:state",
2438
+ "id": "face:get",
2205
2439
  "pluginAlias": "faces-cli",
2206
2440
  "pluginName": "faces-cli",
2207
2441
  "pluginType": "core",
@@ -2211,14 +2445,14 @@
2211
2445
  "relativePath": [
2212
2446
  "dist",
2213
2447
  "commands",
2214
- "account",
2215
- "state.js"
2448
+ "face",
2449
+ "get.js"
2216
2450
  ]
2217
2451
  },
2218
- "face:attributes": {
2452
+ "face:list": {
2219
2453
  "aliases": [],
2220
2454
  "args": {},
2221
- "description": "List all supported attribute keys",
2455
+ "description": "List all owned faces",
2222
2456
  "flags": {
2223
2457
  "json": {
2224
2458
  "description": "Format output as json.",
@@ -2254,7 +2488,7 @@
2254
2488
  },
2255
2489
  "hasDynamicHelp": false,
2256
2490
  "hiddenAliases": [],
2257
- "id": "face:attributes",
2491
+ "id": "face:list",
2258
2492
  "pluginAlias": "faces-cli",
2259
2493
  "pluginName": "faces-cli",
2260
2494
  "pluginType": "core",
@@ -2265,13 +2499,19 @@
2265
2499
  "dist",
2266
2500
  "commands",
2267
2501
  "face",
2268
- "attributes.js"
2502
+ "list.js"
2269
2503
  ]
2270
2504
  },
2271
- "face:create": {
2505
+ "face:neighbors": {
2272
2506
  "aliases": [],
2273
- "args": {},
2274
- "description": "Create a new face",
2507
+ "args": {
2508
+ "face_id": {
2509
+ "description": "Face alias",
2510
+ "name": "face_id",
2511
+ "required": true
2512
+ }
2513
+ },
2514
+ "description": "Find the most similar or dissimilar owned faces to a given face",
2275
2515
  "flags": {
2276
2516
  "json": {
2277
2517
  "description": "Format output as json.",
@@ -2304,61 +2544,44 @@
2304
2544
  "multiple": false,
2305
2545
  "type": "option"
2306
2546
  },
2307
- "name": {
2308
- "description": "Display name",
2309
- "name": "name",
2310
- "required": true,
2311
- "hasDynamicHelp": false,
2312
- "multiple": false,
2313
- "type": "option"
2314
- },
2315
- "alias": {
2316
- "description": "Unique alias slug",
2317
- "name": "alias",
2318
- "required": true,
2319
- "hasDynamicHelp": false,
2320
- "multiple": false,
2321
- "type": "option"
2322
- },
2323
- "description": {
2324
- "description": "Description for local catalog",
2325
- "name": "description",
2547
+ "k": {
2548
+ "description": "Number of results (1–20)",
2549
+ "name": "k",
2550
+ "default": 5,
2326
2551
  "hasDynamicHelp": false,
2327
2552
  "multiple": false,
2328
2553
  "type": "option"
2329
2554
  },
2330
- "default-model": {
2331
- "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
2332
- "name": "default-model",
2555
+ "component": {
2556
+ "description": "Centroid component to rank on (beta, delta, epsilon are the principal components of a face; face is their composite)",
2557
+ "name": "component",
2558
+ "default": "face",
2333
2559
  "hasDynamicHelp": false,
2334
2560
  "multiple": false,
2561
+ "options": [
2562
+ "face",
2563
+ "beta",
2564
+ "delta",
2565
+ "epsilon"
2566
+ ],
2335
2567
  "type": "option"
2336
2568
  },
2337
- "formula": {
2338
- "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
2339
- "name": "formula",
2569
+ "direction": {
2570
+ "description": "nearest (most similar) or furthest (most dissimilar)",
2571
+ "name": "direction",
2572
+ "default": "nearest",
2340
2573
  "hasDynamicHelp": false,
2341
2574
  "multiple": false,
2342
- "type": "option"
2343
- },
2344
- "attr": {
2345
- "description": "Attribute KEY=VALUE (repeatable)",
2346
- "name": "attr",
2347
- "hasDynamicHelp": false,
2348
- "multiple": true,
2349
- "type": "option"
2350
- },
2351
- "tool": {
2352
- "description": "Tool name to enable (repeatable)",
2353
- "name": "tool",
2354
- "hasDynamicHelp": false,
2355
- "multiple": true,
2575
+ "options": [
2576
+ "nearest",
2577
+ "furthest"
2578
+ ],
2356
2579
  "type": "option"
2357
2580
  }
2358
2581
  },
2359
2582
  "hasDynamicHelp": false,
2360
2583
  "hiddenAliases": [],
2361
- "id": "face:create",
2584
+ "id": "face:neighbors",
2362
2585
  "pluginAlias": "faces-cli",
2363
2586
  "pluginName": "faces-cli",
2364
2587
  "pluginType": "core",
@@ -2369,19 +2592,13 @@
2369
2592
  "dist",
2370
2593
  "commands",
2371
2594
  "face",
2372
- "create.js"
2595
+ "neighbors.js"
2373
2596
  ]
2374
2597
  },
2375
- "face:delete": {
2598
+ "face:stats": {
2376
2599
  "aliases": [],
2377
- "args": {
2378
- "face_id": {
2379
- "description": "Face alias",
2380
- "name": "face_id",
2381
- "required": true
2382
- }
2383
- },
2384
- "description": "Delete a face permanently",
2600
+ "args": {},
2601
+ "description": "Compile and chat stats for all owned faces",
2385
2602
  "flags": {
2386
2603
  "json": {
2387
2604
  "description": "Format output as json.",
@@ -2413,17 +2630,11 @@
2413
2630
  "hasDynamicHelp": false,
2414
2631
  "multiple": false,
2415
2632
  "type": "option"
2416
- },
2417
- "yes": {
2418
- "description": "Skip confirmation",
2419
- "name": "yes",
2420
- "allowNo": false,
2421
- "type": "boolean"
2422
2633
  }
2423
2634
  },
2424
2635
  "hasDynamicHelp": false,
2425
2636
  "hiddenAliases": [],
2426
- "id": "face:delete",
2637
+ "id": "face:stats",
2427
2638
  "pluginAlias": "faces-cli",
2428
2639
  "pluginName": "faces-cli",
2429
2640
  "pluginType": "core",
@@ -2434,13 +2645,19 @@
2434
2645
  "dist",
2435
2646
  "commands",
2436
2647
  "face",
2437
- "delete.js"
2648
+ "stats.js"
2438
2649
  ]
2439
2650
  },
2440
- "face:diff": {
2651
+ "face:update": {
2441
2652
  "aliases": [],
2442
- "args": {},
2443
- "description": "Compare owned faces pairwise across all centroid components",
2653
+ "args": {
2654
+ "face_id": {
2655
+ "description": "Face alias",
2656
+ "name": "face_id",
2657
+ "required": true
2658
+ }
2659
+ },
2660
+ "description": "Update a face's metadata",
2444
2661
  "flags": {
2445
2662
  "json": {
2446
2663
  "description": "Format output as json.",
@@ -2473,10 +2690,44 @@
2473
2690
  "multiple": false,
2474
2691
  "type": "option"
2475
2692
  },
2476
- "face": {
2477
- "description": "Face alias to include (repeatable, min 2)",
2478
- "name": "face",
2479
- "required": true,
2693
+ "name": {
2694
+ "description": "New display name",
2695
+ "name": "name",
2696
+ "hasDynamicHelp": false,
2697
+ "multiple": false,
2698
+ "type": "option"
2699
+ },
2700
+ "description": {
2701
+ "description": "Description for local catalog",
2702
+ "name": "description",
2703
+ "hasDynamicHelp": false,
2704
+ "multiple": false,
2705
+ "type": "option"
2706
+ },
2707
+ "default-model": {
2708
+ "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
2709
+ "name": "default-model",
2710
+ "hasDynamicHelp": false,
2711
+ "multiple": false,
2712
+ "type": "option"
2713
+ },
2714
+ "formula": {
2715
+ "description": "New boolean formula (synthetic faces only)",
2716
+ "name": "formula",
2717
+ "hasDynamicHelp": false,
2718
+ "multiple": false,
2719
+ "type": "option"
2720
+ },
2721
+ "attr": {
2722
+ "description": "Update attribute KEY=VALUE (repeatable)",
2723
+ "name": "attr",
2724
+ "hasDynamicHelp": false,
2725
+ "multiple": true,
2726
+ "type": "option"
2727
+ },
2728
+ "tool": {
2729
+ "description": "Tool names to set (replaces list, repeatable)",
2730
+ "name": "tool",
2480
2731
  "hasDynamicHelp": false,
2481
2732
  "multiple": true,
2482
2733
  "type": "option"
@@ -2484,7 +2735,7 @@
2484
2735
  },
2485
2736
  "hasDynamicHelp": false,
2486
2737
  "hiddenAliases": [],
2487
- "id": "face:diff",
2738
+ "id": "face:update",
2488
2739
  "pluginAlias": "faces-cli",
2489
2740
  "pluginName": "faces-cli",
2490
2741
  "pluginType": "core",
@@ -2495,10 +2746,10 @@
2495
2746
  "dist",
2496
2747
  "commands",
2497
2748
  "face",
2498
- "diff.js"
2749
+ "update.js"
2499
2750
  ]
2500
2751
  },
2501
- "face:get": {
2752
+ "face:upload": {
2502
2753
  "aliases": [],
2503
2754
  "args": {
2504
2755
  "face_id": {
@@ -2507,7 +2758,7 @@
2507
2758
  "required": true
2508
2759
  }
2509
2760
  },
2510
- "description": "Get details for a face by alias",
2761
+ "description": "Upload a file (text/PDF/audio/video) to a face",
2511
2762
  "flags": {
2512
2763
  "json": {
2513
2764
  "description": "Format output as json.",
@@ -2539,11 +2790,50 @@
2539
2790
  "hasDynamicHelp": false,
2540
2791
  "multiple": false,
2541
2792
  "type": "option"
2793
+ },
2794
+ "file": {
2795
+ "description": "File to upload",
2796
+ "name": "file",
2797
+ "required": true,
2798
+ "hasDynamicHelp": false,
2799
+ "multiple": false,
2800
+ "type": "option"
2801
+ },
2802
+ "kind": {
2803
+ "description": "Upload kind: document or thread",
2804
+ "name": "kind",
2805
+ "default": "document",
2806
+ "hasDynamicHelp": false,
2807
+ "multiple": false,
2808
+ "options": [
2809
+ "document",
2810
+ "thread"
2811
+ ],
2812
+ "type": "option"
2813
+ },
2814
+ "perspective": {
2815
+ "description": "Perspective (document only)",
2816
+ "name": "perspective",
2817
+ "default": "third-person",
2818
+ "hasDynamicHelp": false,
2819
+ "multiple": false,
2820
+ "options": [
2821
+ "first-person",
2822
+ "third-person"
2823
+ ],
2824
+ "type": "option"
2825
+ },
2826
+ "face-speaker": {
2827
+ "description": "Speaker name to map to the face (thread only). If omitted, first speaker is used.",
2828
+ "name": "face-speaker",
2829
+ "hasDynamicHelp": false,
2830
+ "multiple": false,
2831
+ "type": "option"
2542
2832
  }
2543
2833
  },
2544
2834
  "hasDynamicHelp": false,
2545
2835
  "hiddenAliases": [],
2546
- "id": "face:get",
2836
+ "id": "face:upload",
2547
2837
  "pluginAlias": "faces-cli",
2548
2838
  "pluginName": "faces-cli",
2549
2839
  "pluginType": "core",
@@ -2554,13 +2844,13 @@
2554
2844
  "dist",
2555
2845
  "commands",
2556
2846
  "face",
2557
- "get.js"
2847
+ "upload.js"
2558
2848
  ]
2559
2849
  },
2560
- "face:list": {
2850
+ "keys:create": {
2561
2851
  "aliases": [],
2562
2852
  "args": {},
2563
- "description": "List all owned faces",
2853
+ "description": "Create a new API key (JWT required)",
2564
2854
  "flags": {
2565
2855
  "json": {
2566
2856
  "description": "Format output as json.",
@@ -2592,104 +2882,47 @@
2592
2882
  "hasDynamicHelp": false,
2593
2883
  "multiple": false,
2594
2884
  "type": "option"
2595
- }
2596
- },
2597
- "hasDynamicHelp": false,
2598
- "hiddenAliases": [],
2599
- "id": "face:list",
2600
- "pluginAlias": "faces-cli",
2601
- "pluginName": "faces-cli",
2602
- "pluginType": "core",
2603
- "strict": true,
2604
- "enableJsonFlag": true,
2605
- "isESM": true,
2606
- "relativePath": [
2607
- "dist",
2608
- "commands",
2609
- "face",
2610
- "list.js"
2611
- ]
2612
- },
2613
- "face:neighbors": {
2614
- "aliases": [],
2615
- "args": {
2616
- "face_id": {
2617
- "description": "Face alias",
2618
- "name": "face_id",
2619
- "required": true
2620
- }
2621
- },
2622
- "description": "Find the most similar or dissimilar owned faces to a given face",
2623
- "flags": {
2624
- "json": {
2625
- "description": "Format output as json.",
2626
- "helpGroup": "GLOBAL",
2627
- "name": "json",
2628
- "allowNo": false,
2629
- "type": "boolean"
2630
2885
  },
2631
- "base-url": {
2632
- "description": "API base URL",
2633
- "env": "FACES_BASE_URL",
2634
- "name": "base-url",
2635
- "hasDynamicHelp": false,
2636
- "multiple": false,
2637
- "type": "option"
2638
- },
2639
- "token": {
2640
- "description": "JWT bearer token",
2641
- "env": "FACES_TOKEN",
2642
- "name": "token",
2886
+ "name": {
2887
+ "description": "Key name/label",
2888
+ "name": "name",
2889
+ "required": true,
2643
2890
  "hasDynamicHelp": false,
2644
2891
  "multiple": false,
2645
2892
  "type": "option"
2646
2893
  },
2647
- "api-key": {
2648
- "description": "API key",
2649
- "env": "FACES_API_KEY",
2650
- "name": "api-key",
2894
+ "expires-days": {
2895
+ "description": "Expiry in days (omit for no expiry)",
2896
+ "name": "expires-days",
2651
2897
  "hasDynamicHelp": false,
2652
2898
  "multiple": false,
2653
2899
  "type": "option"
2654
2900
  },
2655
- "k": {
2656
- "description": "Number of results (1–20)",
2657
- "name": "k",
2658
- "default": 5,
2901
+ "budget": {
2902
+ "description": "Spend budget in USD",
2903
+ "name": "budget",
2659
2904
  "hasDynamicHelp": false,
2660
2905
  "multiple": false,
2661
2906
  "type": "option"
2662
2907
  },
2663
- "component": {
2664
- "description": "Centroid component to rank on (beta, delta, epsilon are the principal components of a face; face is their composite)",
2665
- "name": "component",
2666
- "default": "face",
2908
+ "face": {
2909
+ "description": "Allowed face alias (repeatable)",
2910
+ "name": "face",
2667
2911
  "hasDynamicHelp": false,
2668
- "multiple": false,
2669
- "options": [
2670
- "face",
2671
- "beta",
2672
- "delta",
2673
- "epsilon"
2674
- ],
2912
+ "multiple": true,
2675
2913
  "type": "option"
2676
2914
  },
2677
- "direction": {
2678
- "description": "nearest (most similar) or furthest (most dissimilar)",
2679
- "name": "direction",
2680
- "default": "nearest",
2915
+ "model": {
2916
+ "description": "Allowed model name (repeatable)",
2917
+ "name": "model",
2681
2918
  "hasDynamicHelp": false,
2682
- "multiple": false,
2683
- "options": [
2684
- "nearest",
2685
- "furthest"
2686
- ],
2919
+ "multiple": true,
2687
2920
  "type": "option"
2688
2921
  }
2689
2922
  },
2690
2923
  "hasDynamicHelp": false,
2691
2924
  "hiddenAliases": [],
2692
- "id": "face:neighbors",
2925
+ "id": "keys:create",
2693
2926
  "pluginAlias": "faces-cli",
2694
2927
  "pluginName": "faces-cli",
2695
2928
  "pluginType": "core",
@@ -2699,14 +2932,14 @@
2699
2932
  "relativePath": [
2700
2933
  "dist",
2701
2934
  "commands",
2702
- "face",
2703
- "neighbors.js"
2935
+ "keys",
2936
+ "create.js"
2704
2937
  ]
2705
2938
  },
2706
- "face:stats": {
2939
+ "keys:list": {
2707
2940
  "aliases": [],
2708
2941
  "args": {},
2709
- "description": "Compile and chat stats for all owned faces",
2942
+ "description": "List all API keys (JWT required)",
2710
2943
  "flags": {
2711
2944
  "json": {
2712
2945
  "description": "Format output as json.",
@@ -2742,7 +2975,7 @@
2742
2975
  },
2743
2976
  "hasDynamicHelp": false,
2744
2977
  "hiddenAliases": [],
2745
- "id": "face:stats",
2978
+ "id": "keys:list",
2746
2979
  "pluginAlias": "faces-cli",
2747
2980
  "pluginName": "faces-cli",
2748
2981
  "pluginType": "core",
@@ -2752,20 +2985,20 @@
2752
2985
  "relativePath": [
2753
2986
  "dist",
2754
2987
  "commands",
2755
- "face",
2756
- "stats.js"
2988
+ "keys",
2989
+ "list.js"
2757
2990
  ]
2758
2991
  },
2759
- "face:update": {
2992
+ "keys:revoke": {
2760
2993
  "aliases": [],
2761
2994
  "args": {
2762
- "face_id": {
2763
- "description": "Face alias",
2764
- "name": "face_id",
2995
+ "key_id": {
2996
+ "description": "Key ID",
2997
+ "name": "key_id",
2765
2998
  "required": true
2766
2999
  }
2767
3000
  },
2768
- "description": "Update a face's metadata",
3001
+ "description": "Revoke an API key (JWT required)",
2769
3002
  "flags": {
2770
3003
  "json": {
2771
3004
  "description": "Format output as json.",
@@ -2798,52 +3031,16 @@
2798
3031
  "multiple": false,
2799
3032
  "type": "option"
2800
3033
  },
2801
- "name": {
2802
- "description": "New display name",
2803
- "name": "name",
2804
- "hasDynamicHelp": false,
2805
- "multiple": false,
2806
- "type": "option"
2807
- },
2808
- "description": {
2809
- "description": "Description for local catalog",
2810
- "name": "description",
2811
- "hasDynamicHelp": false,
2812
- "multiple": false,
2813
- "type": "option"
2814
- },
2815
- "default-model": {
2816
- "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
2817
- "name": "default-model",
2818
- "hasDynamicHelp": false,
2819
- "multiple": false,
2820
- "type": "option"
2821
- },
2822
- "formula": {
2823
- "description": "New boolean formula (synthetic faces only)",
2824
- "name": "formula",
2825
- "hasDynamicHelp": false,
2826
- "multiple": false,
2827
- "type": "option"
2828
- },
2829
- "attr": {
2830
- "description": "Update attribute KEY=VALUE (repeatable)",
2831
- "name": "attr",
2832
- "hasDynamicHelp": false,
2833
- "multiple": true,
2834
- "type": "option"
2835
- },
2836
- "tool": {
2837
- "description": "Tool names to set (replaces list, repeatable)",
2838
- "name": "tool",
2839
- "hasDynamicHelp": false,
2840
- "multiple": true,
2841
- "type": "option"
3034
+ "yes": {
3035
+ "description": "Skip confirmation",
3036
+ "name": "yes",
3037
+ "allowNo": false,
3038
+ "type": "boolean"
2842
3039
  }
2843
3040
  },
2844
3041
  "hasDynamicHelp": false,
2845
3042
  "hiddenAliases": [],
2846
- "id": "face:update",
3043
+ "id": "keys:revoke",
2847
3044
  "pluginAlias": "faces-cli",
2848
3045
  "pluginName": "faces-cli",
2849
3046
  "pluginType": "core",
@@ -2853,20 +3050,20 @@
2853
3050
  "relativePath": [
2854
3051
  "dist",
2855
3052
  "commands",
2856
- "face",
2857
- "update.js"
3053
+ "keys",
3054
+ "revoke.js"
2858
3055
  ]
2859
3056
  },
2860
- "face:upload": {
3057
+ "keys:update": {
2861
3058
  "aliases": [],
2862
3059
  "args": {
2863
- "face_id": {
2864
- "description": "Face alias",
2865
- "name": "face_id",
3060
+ "key_id": {
3061
+ "description": "Key ID",
3062
+ "name": "key_id",
2866
3063
  "required": true
2867
3064
  }
2868
3065
  },
2869
- "description": "Upload a file (text/PDF/audio/video) to a face",
3066
+ "description": "Update API key metadata (JWT required)",
2870
3067
  "flags": {
2871
3068
  "json": {
2872
3069
  "description": "Format output as json.",
@@ -2899,49 +3096,30 @@
2899
3096
  "multiple": false,
2900
3097
  "type": "option"
2901
3098
  },
2902
- "file": {
2903
- "description": "File to upload",
2904
- "name": "file",
2905
- "required": true,
3099
+ "name": {
3100
+ "description": "New key name",
3101
+ "name": "name",
2906
3102
  "hasDynamicHelp": false,
2907
3103
  "multiple": false,
2908
3104
  "type": "option"
2909
3105
  },
2910
- "kind": {
2911
- "description": "Upload kind: document or thread",
2912
- "name": "kind",
2913
- "default": "document",
2914
- "hasDynamicHelp": false,
2915
- "multiple": false,
2916
- "options": [
2917
- "document",
2918
- "thread"
2919
- ],
2920
- "type": "option"
2921
- },
2922
- "perspective": {
2923
- "description": "Perspective (document only)",
2924
- "name": "perspective",
2925
- "default": "third-person",
3106
+ "budget": {
3107
+ "description": "New spend budget in USD",
3108
+ "name": "budget",
2926
3109
  "hasDynamicHelp": false,
2927
3110
  "multiple": false,
2928
- "options": [
2929
- "first-person",
2930
- "third-person"
2931
- ],
2932
3111
  "type": "option"
2933
3112
  },
2934
- "face-speaker": {
2935
- "description": "Speaker name to map to the face (thread only). If omitted, first speaker is used.",
2936
- "name": "face-speaker",
2937
- "hasDynamicHelp": false,
2938
- "multiple": false,
2939
- "type": "option"
3113
+ "reset-spent": {
3114
+ "description": "Reset spent amount to zero",
3115
+ "name": "reset-spent",
3116
+ "allowNo": false,
3117
+ "type": "boolean"
2940
3118
  }
2941
3119
  },
2942
3120
  "hasDynamicHelp": false,
2943
3121
  "hiddenAliases": [],
2944
- "id": "face:upload",
3122
+ "id": "keys:update",
2945
3123
  "pluginAlias": "faces-cli",
2946
3124
  "pluginName": "faces-cli",
2947
3125
  "pluginType": "core",
@@ -2951,11 +3129,11 @@
2951
3129
  "relativePath": [
2952
3130
  "dist",
2953
3131
  "commands",
2954
- "face",
2955
- "upload.js"
3132
+ "keys",
3133
+ "update.js"
2956
3134
  ]
2957
3135
  },
2958
- "compile:thread:create": {
3136
+ "compile:doc:create": {
2959
3137
  "aliases": [],
2960
3138
  "args": {
2961
3139
  "face_id": {
@@ -2964,7 +3142,7 @@
2964
3142
  "required": true
2965
3143
  }
2966
3144
  },
2967
- "description": "Start a new thread for a face",
3145
+ "description": "Submit a document to a face",
2968
3146
  "flags": {
2969
3147
  "json": {
2970
3148
  "description": "Format output as json.",
@@ -2998,82 +3176,42 @@
2998
3176
  "type": "option"
2999
3177
  },
3000
3178
  "label": {
3001
- "description": "Thread label",
3179
+ "description": "Document label/title",
3002
3180
  "name": "label",
3003
3181
  "hasDynamicHelp": false,
3004
3182
  "multiple": false,
3005
3183
  "type": "option"
3006
- }
3007
- },
3008
- "hasDynamicHelp": false,
3009
- "hiddenAliases": [],
3010
- "id": "compile:thread:create",
3011
- "pluginAlias": "faces-cli",
3012
- "pluginName": "faces-cli",
3013
- "pluginType": "core",
3014
- "strict": true,
3015
- "enableJsonFlag": true,
3016
- "isESM": true,
3017
- "relativePath": [
3018
- "dist",
3019
- "commands",
3020
- "compile",
3021
- "thread",
3022
- "create.js"
3023
- ]
3024
- },
3025
- "compile:thread:delete": {
3026
- "aliases": [],
3027
- "args": {
3028
- "thread_id": {
3029
- "description": "Thread ID",
3030
- "name": "thread_id",
3031
- "required": true
3032
- }
3033
- },
3034
- "description": "Delete a thread",
3035
- "flags": {
3036
- "json": {
3037
- "description": "Format output as json.",
3038
- "helpGroup": "GLOBAL",
3039
- "name": "json",
3040
- "allowNo": false,
3041
- "type": "boolean"
3042
3184
  },
3043
- "base-url": {
3044
- "description": "API base URL",
3045
- "env": "FACES_BASE_URL",
3046
- "name": "base-url",
3185
+ "content": {
3186
+ "description": "Inline text content",
3187
+ "name": "content",
3047
3188
  "hasDynamicHelp": false,
3048
3189
  "multiple": false,
3049
3190
  "type": "option"
3050
3191
  },
3051
- "token": {
3052
- "description": "JWT bearer token",
3053
- "env": "FACES_TOKEN",
3054
- "name": "token",
3192
+ "file": {
3193
+ "description": "Read content from file",
3194
+ "name": "file",
3055
3195
  "hasDynamicHelp": false,
3056
3196
  "multiple": false,
3057
3197
  "type": "option"
3058
3198
  },
3059
- "api-key": {
3060
- "description": "API key",
3061
- "env": "FACES_API_KEY",
3062
- "name": "api-key",
3199
+ "perspective": {
3200
+ "description": "Perspective (first-person or third-person)",
3201
+ "name": "perspective",
3202
+ "default": "first-person",
3063
3203
  "hasDynamicHelp": false,
3064
3204
  "multiple": false,
3205
+ "options": [
3206
+ "first-person",
3207
+ "third-person"
3208
+ ],
3065
3209
  "type": "option"
3066
- },
3067
- "yes": {
3068
- "description": "Skip confirmation",
3069
- "name": "yes",
3070
- "allowNo": false,
3071
- "type": "boolean"
3072
3210
  }
3073
3211
  },
3074
3212
  "hasDynamicHelp": false,
3075
3213
  "hiddenAliases": [],
3076
- "id": "compile:thread:delete",
3214
+ "id": "compile:doc:create",
3077
3215
  "pluginAlias": "faces-cli",
3078
3216
  "pluginName": "faces-cli",
3079
3217
  "pluginType": "core",
@@ -3084,20 +3222,20 @@
3084
3222
  "dist",
3085
3223
  "commands",
3086
3224
  "compile",
3087
- "thread",
3088
- "delete.js"
3225
+ "doc",
3226
+ "create.js"
3089
3227
  ]
3090
3228
  },
3091
- "compile:thread:edit": {
3229
+ "compile:doc:delete": {
3092
3230
  "aliases": [],
3093
3231
  "args": {
3094
- "thread_id": {
3095
- "description": "Thread ID",
3096
- "name": "thread_id",
3232
+ "doc_id": {
3233
+ "description": "Document ID",
3234
+ "name": "doc_id",
3097
3235
  "required": true
3098
3236
  }
3099
3237
  },
3100
- "description": "Edit a thread (label and/or reassign face speaker)",
3238
+ "description": "Delete a document",
3101
3239
  "flags": {
3102
3240
  "json": {
3103
3241
  "description": "Format output as json.",
@@ -3124,22 +3262,8 @@
3124
3262
  },
3125
3263
  "api-key": {
3126
3264
  "description": "API key",
3127
- "env": "FACES_API_KEY",
3128
- "name": "api-key",
3129
- "hasDynamicHelp": false,
3130
- "multiple": false,
3131
- "type": "option"
3132
- },
3133
- "label": {
3134
- "description": "New thread label",
3135
- "name": "label",
3136
- "hasDynamicHelp": false,
3137
- "multiple": false,
3138
- "type": "option"
3139
- },
3140
- "face-speaker": {
3141
- "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
3142
- "name": "face-speaker",
3265
+ "env": "FACES_API_KEY",
3266
+ "name": "api-key",
3143
3267
  "hasDynamicHelp": false,
3144
3268
  "multiple": false,
3145
3269
  "type": "option"
@@ -3147,7 +3271,7 @@
3147
3271
  },
3148
3272
  "hasDynamicHelp": false,
3149
3273
  "hiddenAliases": [],
3150
- "id": "compile:thread:edit",
3274
+ "id": "compile:doc:delete",
3151
3275
  "pluginAlias": "faces-cli",
3152
3276
  "pluginName": "faces-cli",
3153
3277
  "pluginType": "core",
@@ -3158,20 +3282,20 @@
3158
3282
  "dist",
3159
3283
  "commands",
3160
3284
  "compile",
3161
- "thread",
3162
- "edit.js"
3285
+ "doc",
3286
+ "delete.js"
3163
3287
  ]
3164
3288
  },
3165
- "compile:thread:get": {
3289
+ "compile:doc:edit": {
3166
3290
  "aliases": [],
3167
3291
  "args": {
3168
- "thread_id": {
3169
- "description": "Thread ID",
3170
- "name": "thread_id",
3292
+ "doc_id": {
3293
+ "description": "Document ID",
3294
+ "name": "doc_id",
3171
3295
  "required": true
3172
3296
  }
3173
3297
  },
3174
- "description": "Get a thread by ID",
3298
+ "description": "Edit a document (label, content, or perspective)",
3175
3299
  "flags": {
3176
3300
  "json": {
3177
3301
  "description": "Format output as json.",
@@ -3203,11 +3327,43 @@
3203
3327
  "hasDynamicHelp": false,
3204
3328
  "multiple": false,
3205
3329
  "type": "option"
3330
+ },
3331
+ "label": {
3332
+ "description": "New label/title",
3333
+ "name": "label",
3334
+ "hasDynamicHelp": false,
3335
+ "multiple": false,
3336
+ "type": "option"
3337
+ },
3338
+ "content": {
3339
+ "description": "New inline text content",
3340
+ "name": "content",
3341
+ "hasDynamicHelp": false,
3342
+ "multiple": false,
3343
+ "type": "option"
3344
+ },
3345
+ "file": {
3346
+ "description": "Read new content from file",
3347
+ "name": "file",
3348
+ "hasDynamicHelp": false,
3349
+ "multiple": false,
3350
+ "type": "option"
3351
+ },
3352
+ "perspective": {
3353
+ "description": "Perspective (first-person or third-person)",
3354
+ "name": "perspective",
3355
+ "hasDynamicHelp": false,
3356
+ "multiple": false,
3357
+ "options": [
3358
+ "first-person",
3359
+ "third-person"
3360
+ ],
3361
+ "type": "option"
3206
3362
  }
3207
3363
  },
3208
3364
  "hasDynamicHelp": false,
3209
3365
  "hiddenAliases": [],
3210
- "id": "compile:thread:get",
3366
+ "id": "compile:doc:edit",
3211
3367
  "pluginAlias": "faces-cli",
3212
3368
  "pluginName": "faces-cli",
3213
3369
  "pluginType": "core",
@@ -3218,20 +3374,20 @@
3218
3374
  "dist",
3219
3375
  "commands",
3220
3376
  "compile",
3221
- "thread",
3222
- "get.js"
3377
+ "doc",
3378
+ "edit.js"
3223
3379
  ]
3224
3380
  },
3225
- "compile:thread:list": {
3381
+ "compile:doc:get": {
3226
3382
  "aliases": [],
3227
3383
  "args": {
3228
- "face_id": {
3229
- "description": "Face alias",
3230
- "name": "face_id",
3384
+ "doc_id": {
3385
+ "description": "Document ID",
3386
+ "name": "doc_id",
3231
3387
  "required": true
3232
3388
  }
3233
3389
  },
3234
- "description": "List threads for a face",
3390
+ "description": "Get a document by ID",
3235
3391
  "flags": {
3236
3392
  "json": {
3237
3393
  "description": "Format output as json.",
@@ -3267,7 +3423,7 @@
3267
3423
  },
3268
3424
  "hasDynamicHelp": false,
3269
3425
  "hiddenAliases": [],
3270
- "id": "compile:thread:list",
3426
+ "id": "compile:doc:get",
3271
3427
  "pluginAlias": "faces-cli",
3272
3428
  "pluginName": "faces-cli",
3273
3429
  "pluginType": "core",
@@ -3278,20 +3434,20 @@
3278
3434
  "dist",
3279
3435
  "commands",
3280
3436
  "compile",
3281
- "thread",
3282
- "list.js"
3437
+ "doc",
3438
+ "get.js"
3283
3439
  ]
3284
3440
  },
3285
- "compile:thread:make": {
3441
+ "compile:doc": {
3286
3442
  "aliases": [],
3287
3443
  "args": {
3288
- "thread_id": {
3289
- "description": "Thread ID",
3290
- "name": "thread_id",
3444
+ "face_id": {
3445
+ "description": "Face alias",
3446
+ "name": "face_id",
3291
3447
  "required": true
3292
3448
  }
3293
3449
  },
3294
- "description": "Compile an existing thread (prepare + sync in one step)",
3450
+ "description": "Compile a document into a face (create → make in one step)",
3295
3451
  "flags": {
3296
3452
  "json": {
3297
3453
  "description": "Format output as json.",
@@ -3324,6 +3480,39 @@
3324
3480
  "multiple": false,
3325
3481
  "type": "option"
3326
3482
  },
3483
+ "label": {
3484
+ "description": "Document label/title",
3485
+ "name": "label",
3486
+ "hasDynamicHelp": false,
3487
+ "multiple": false,
3488
+ "type": "option"
3489
+ },
3490
+ "content": {
3491
+ "description": "Inline text content",
3492
+ "name": "content",
3493
+ "hasDynamicHelp": false,
3494
+ "multiple": false,
3495
+ "type": "option"
3496
+ },
3497
+ "file": {
3498
+ "description": "Read content from file",
3499
+ "name": "file",
3500
+ "hasDynamicHelp": false,
3501
+ "multiple": false,
3502
+ "type": "option"
3503
+ },
3504
+ "perspective": {
3505
+ "description": "Perspective",
3506
+ "name": "perspective",
3507
+ "default": "first-person",
3508
+ "hasDynamicHelp": false,
3509
+ "multiple": false,
3510
+ "options": [
3511
+ "first-person",
3512
+ "third-person"
3513
+ ],
3514
+ "type": "option"
3515
+ },
3327
3516
  "timeout": {
3328
3517
  "description": "Compile timeout in seconds (default: 600)",
3329
3518
  "name": "timeout",
@@ -3333,7 +3522,7 @@
3333
3522
  "type": "option"
3334
3523
  },
3335
3524
  "no-wait": {
3336
- "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
3525
+ "description": "Create and trigger compilation, then return immediately without polling.",
3337
3526
  "name": "no-wait",
3338
3527
  "allowNo": false,
3339
3528
  "type": "boolean"
@@ -3341,7 +3530,7 @@
3341
3530
  },
3342
3531
  "hasDynamicHelp": false,
3343
3532
  "hiddenAliases": [],
3344
- "id": "compile:thread:make",
3533
+ "id": "compile:doc",
3345
3534
  "pluginAlias": "faces-cli",
3346
3535
  "pluginName": "faces-cli",
3347
3536
  "pluginType": "core",
@@ -3352,20 +3541,20 @@
3352
3541
  "dist",
3353
3542
  "commands",
3354
3543
  "compile",
3355
- "thread",
3356
- "make.js"
3544
+ "doc",
3545
+ "index.js"
3357
3546
  ]
3358
3547
  },
3359
- "compile:thread:message": {
3548
+ "compile:doc:list": {
3360
3549
  "aliases": [],
3361
3550
  "args": {
3362
- "thread_id": {
3363
- "description": "Thread ID",
3364
- "name": "thread_id",
3551
+ "face_id": {
3552
+ "description": "Face alias",
3553
+ "name": "face_id",
3365
3554
  "required": true
3366
3555
  }
3367
3556
  },
3368
- "description": "Send a user message to a thread",
3557
+ "description": "List documents for a face",
3369
3558
  "flags": {
3370
3559
  "json": {
3371
3560
  "description": "Format output as json.",
@@ -3397,20 +3586,11 @@
3397
3586
  "hasDynamicHelp": false,
3398
3587
  "multiple": false,
3399
3588
  "type": "option"
3400
- },
3401
- "message": {
3402
- "char": "m",
3403
- "description": "User message to append",
3404
- "name": "message",
3405
- "required": true,
3406
- "hasDynamicHelp": false,
3407
- "multiple": false,
3408
- "type": "option"
3409
3589
  }
3410
3590
  },
3411
3591
  "hasDynamicHelp": false,
3412
3592
  "hiddenAliases": [],
3413
- "id": "compile:thread:message",
3593
+ "id": "compile:doc:list",
3414
3594
  "pluginAlias": "faces-cli",
3415
3595
  "pluginName": "faces-cli",
3416
3596
  "pluginType": "core",
@@ -3421,20 +3601,20 @@
3421
3601
  "dist",
3422
3602
  "commands",
3423
3603
  "compile",
3424
- "thread",
3425
- "message.js"
3604
+ "doc",
3605
+ "list.js"
3426
3606
  ]
3427
3607
  },
3428
- "compile:thread:pause": {
3608
+ "compile:doc:make": {
3429
3609
  "aliases": [],
3430
3610
  "args": {
3431
- "thread_id": {
3432
- "description": "Thread ID",
3433
- "name": "thread_id",
3611
+ "doc_id": {
3612
+ "description": "Document ID",
3613
+ "name": "doc_id",
3434
3614
  "required": true
3435
3615
  }
3436
3616
  },
3437
- "description": "Pause a running thread compilation (preserves progress, resume with make)",
3617
+ "description": "Compile an existing document (prepare + sync in one step)",
3438
3618
  "flags": {
3439
3619
  "json": {
3440
3620
  "description": "Format output as json.",
@@ -3466,11 +3646,25 @@
3466
3646
  "hasDynamicHelp": false,
3467
3647
  "multiple": false,
3468
3648
  "type": "option"
3649
+ },
3650
+ "timeout": {
3651
+ "description": "Compile timeout in seconds (default: 600)",
3652
+ "name": "timeout",
3653
+ "default": 600,
3654
+ "hasDynamicHelp": false,
3655
+ "multiple": false,
3656
+ "type": "option"
3657
+ },
3658
+ "no-wait": {
3659
+ "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
3660
+ "name": "no-wait",
3661
+ "allowNo": false,
3662
+ "type": "boolean"
3469
3663
  }
3470
3664
  },
3471
3665
  "hasDynamicHelp": false,
3472
3666
  "hiddenAliases": [],
3473
- "id": "compile:thread:pause",
3667
+ "id": "compile:doc:make",
3474
3668
  "pluginAlias": "faces-cli",
3475
3669
  "pluginName": "faces-cli",
3476
3670
  "pluginType": "core",
@@ -3481,20 +3675,20 @@
3481
3675
  "dist",
3482
3676
  "commands",
3483
3677
  "compile",
3484
- "thread",
3485
- "pause.js"
3678
+ "doc",
3679
+ "make.js"
3486
3680
  ]
3487
3681
  },
3488
- "compile:thread:reset": {
3682
+ "compile:doc:pause": {
3489
3683
  "aliases": [],
3490
3684
  "args": {
3491
- "thread_id": {
3492
- "description": "Thread ID",
3493
- "name": "thread_id",
3685
+ "doc_id": {
3686
+ "description": "Document ID",
3687
+ "name": "doc_id",
3494
3688
  "required": true
3495
3689
  }
3496
3690
  },
3497
- "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
3691
+ "description": "Pause a running document compilation (preserves progress, resume with make)",
3498
3692
  "flags": {
3499
3693
  "json": {
3500
3694
  "description": "Format output as json.",
@@ -3526,17 +3720,11 @@
3526
3720
  "hasDynamicHelp": false,
3527
3721
  "multiple": false,
3528
3722
  "type": "option"
3529
- },
3530
- "yes": {
3531
- "description": "Skip confirmation",
3532
- "name": "yes",
3533
- "allowNo": false,
3534
- "type": "boolean"
3535
3723
  }
3536
3724
  },
3537
3725
  "hasDynamicHelp": false,
3538
3726
  "hiddenAliases": [],
3539
- "id": "compile:thread:reset",
3727
+ "id": "compile:doc:pause",
3540
3728
  "pluginAlias": "faces-cli",
3541
3729
  "pluginName": "faces-cli",
3542
3730
  "pluginType": "core",
@@ -3547,20 +3735,20 @@
3547
3735
  "dist",
3548
3736
  "commands",
3549
3737
  "compile",
3550
- "thread",
3551
- "reset.js"
3738
+ "doc",
3739
+ "pause.js"
3552
3740
  ]
3553
3741
  },
3554
- "compile:thread:sync": {
3742
+ "compile:doc:reset": {
3555
3743
  "aliases": [],
3556
3744
  "args": {
3557
- "thread_id": {
3558
- "description": "Thread ID",
3559
- "name": "thread_id",
3745
+ "doc_id": {
3746
+ "description": "Document ID",
3747
+ "name": "doc_id",
3560
3748
  "required": true
3561
3749
  }
3562
3750
  },
3563
- "description": "Archive and sync a thread into a face",
3751
+ "description": "Reset document compilation progress (wipe extraction, keep content)",
3564
3752
  "flags": {
3565
3753
  "json": {
3566
3754
  "description": "Format output as json.",
@@ -3592,11 +3780,17 @@
3592
3780
  "hasDynamicHelp": false,
3593
3781
  "multiple": false,
3594
3782
  "type": "option"
3783
+ },
3784
+ "yes": {
3785
+ "description": "Skip confirmation",
3786
+ "name": "yes",
3787
+ "allowNo": false,
3788
+ "type": "boolean"
3595
3789
  }
3596
3790
  },
3597
3791
  "hasDynamicHelp": false,
3598
3792
  "hiddenAliases": [],
3599
- "id": "compile:thread:sync",
3793
+ "id": "compile:doc:reset",
3600
3794
  "pluginAlias": "faces-cli",
3601
3795
  "pluginName": "faces-cli",
3602
3796
  "pluginType": "core",
@@ -3607,11 +3801,11 @@
3607
3801
  "dist",
3608
3802
  "commands",
3609
3803
  "compile",
3610
- "thread",
3611
- "sync.js"
3804
+ "doc",
3805
+ "reset.js"
3612
3806
  ]
3613
3807
  },
3614
- "compile:doc:create": {
3808
+ "compile:thread:create": {
3615
3809
  "aliases": [],
3616
3810
  "args": {
3617
3811
  "face_id": {
@@ -3620,7 +3814,7 @@
3620
3814
  "required": true
3621
3815
  }
3622
3816
  },
3623
- "description": "Submit a document to a face",
3817
+ "description": "Start a new thread for a face",
3624
3818
  "flags": {
3625
3819
  "json": {
3626
3820
  "description": "Format output as json.",
@@ -3654,42 +3848,16 @@
3654
3848
  "type": "option"
3655
3849
  },
3656
3850
  "label": {
3657
- "description": "Document label/title",
3851
+ "description": "Thread label",
3658
3852
  "name": "label",
3659
3853
  "hasDynamicHelp": false,
3660
3854
  "multiple": false,
3661
3855
  "type": "option"
3662
- },
3663
- "content": {
3664
- "description": "Inline text content",
3665
- "name": "content",
3666
- "hasDynamicHelp": false,
3667
- "multiple": false,
3668
- "type": "option"
3669
- },
3670
- "file": {
3671
- "description": "Read content from file",
3672
- "name": "file",
3673
- "hasDynamicHelp": false,
3674
- "multiple": false,
3675
- "type": "option"
3676
- },
3677
- "perspective": {
3678
- "description": "Perspective (first-person or third-person)",
3679
- "name": "perspective",
3680
- "default": "first-person",
3681
- "hasDynamicHelp": false,
3682
- "multiple": false,
3683
- "options": [
3684
- "first-person",
3685
- "third-person"
3686
- ],
3687
- "type": "option"
3688
3856
  }
3689
3857
  },
3690
3858
  "hasDynamicHelp": false,
3691
3859
  "hiddenAliases": [],
3692
- "id": "compile:doc:create",
3860
+ "id": "compile:thread:create",
3693
3861
  "pluginAlias": "faces-cli",
3694
3862
  "pluginName": "faces-cli",
3695
3863
  "pluginType": "core",
@@ -3700,20 +3868,20 @@
3700
3868
  "dist",
3701
3869
  "commands",
3702
3870
  "compile",
3703
- "doc",
3871
+ "thread",
3704
3872
  "create.js"
3705
3873
  ]
3706
3874
  },
3707
- "compile:doc:delete": {
3875
+ "compile:thread:delete": {
3708
3876
  "aliases": [],
3709
3877
  "args": {
3710
- "doc_id": {
3711
- "description": "Document ID",
3712
- "name": "doc_id",
3878
+ "thread_id": {
3879
+ "description": "Thread ID",
3880
+ "name": "thread_id",
3713
3881
  "required": true
3714
3882
  }
3715
3883
  },
3716
- "description": "Delete a document",
3884
+ "description": "Delete a thread",
3717
3885
  "flags": {
3718
3886
  "json": {
3719
3887
  "description": "Format output as json.",
@@ -3745,11 +3913,17 @@
3745
3913
  "hasDynamicHelp": false,
3746
3914
  "multiple": false,
3747
3915
  "type": "option"
3916
+ },
3917
+ "yes": {
3918
+ "description": "Skip confirmation",
3919
+ "name": "yes",
3920
+ "allowNo": false,
3921
+ "type": "boolean"
3748
3922
  }
3749
3923
  },
3750
3924
  "hasDynamicHelp": false,
3751
3925
  "hiddenAliases": [],
3752
- "id": "compile:doc:delete",
3926
+ "id": "compile:thread:delete",
3753
3927
  "pluginAlias": "faces-cli",
3754
3928
  "pluginName": "faces-cli",
3755
3929
  "pluginType": "core",
@@ -3760,20 +3934,20 @@
3760
3934
  "dist",
3761
3935
  "commands",
3762
3936
  "compile",
3763
- "doc",
3937
+ "thread",
3764
3938
  "delete.js"
3765
3939
  ]
3766
3940
  },
3767
- "compile:doc:edit": {
3941
+ "compile:thread:edit": {
3768
3942
  "aliases": [],
3769
3943
  "args": {
3770
- "doc_id": {
3771
- "description": "Document ID",
3772
- "name": "doc_id",
3944
+ "thread_id": {
3945
+ "description": "Thread ID",
3946
+ "name": "thread_id",
3773
3947
  "required": true
3774
3948
  }
3775
3949
  },
3776
- "description": "Edit a document (label, content, or perspective)",
3950
+ "description": "Edit a thread (label and/or reassign face speaker)",
3777
3951
  "flags": {
3778
3952
  "json": {
3779
3953
  "description": "Format output as json.",
@@ -3807,41 +3981,23 @@
3807
3981
  "type": "option"
3808
3982
  },
3809
3983
  "label": {
3810
- "description": "New label/title",
3984
+ "description": "New thread label",
3811
3985
  "name": "label",
3812
3986
  "hasDynamicHelp": false,
3813
3987
  "multiple": false,
3814
3988
  "type": "option"
3815
3989
  },
3816
- "content": {
3817
- "description": "New inline text content",
3818
- "name": "content",
3819
- "hasDynamicHelp": false,
3820
- "multiple": false,
3821
- "type": "option"
3822
- },
3823
- "file": {
3824
- "description": "Read new content from file",
3825
- "name": "file",
3826
- "hasDynamicHelp": false,
3827
- "multiple": false,
3828
- "type": "option"
3829
- },
3830
- "perspective": {
3831
- "description": "Perspective (first-person or third-person)",
3832
- "name": "perspective",
3990
+ "face-speaker": {
3991
+ "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
3992
+ "name": "face-speaker",
3833
3993
  "hasDynamicHelp": false,
3834
3994
  "multiple": false,
3835
- "options": [
3836
- "first-person",
3837
- "third-person"
3838
- ],
3839
3995
  "type": "option"
3840
3996
  }
3841
3997
  },
3842
3998
  "hasDynamicHelp": false,
3843
3999
  "hiddenAliases": [],
3844
- "id": "compile:doc:edit",
4000
+ "id": "compile:thread:edit",
3845
4001
  "pluginAlias": "faces-cli",
3846
4002
  "pluginName": "faces-cli",
3847
4003
  "pluginType": "core",
@@ -3852,20 +4008,20 @@
3852
4008
  "dist",
3853
4009
  "commands",
3854
4010
  "compile",
3855
- "doc",
4011
+ "thread",
3856
4012
  "edit.js"
3857
4013
  ]
3858
4014
  },
3859
- "compile:doc:get": {
4015
+ "compile:thread:get": {
3860
4016
  "aliases": [],
3861
4017
  "args": {
3862
- "doc_id": {
3863
- "description": "Document ID",
3864
- "name": "doc_id",
4018
+ "thread_id": {
4019
+ "description": "Thread ID",
4020
+ "name": "thread_id",
3865
4021
  "required": true
3866
4022
  }
3867
4023
  },
3868
- "description": "Get a document by ID",
4024
+ "description": "Get a thread by ID",
3869
4025
  "flags": {
3870
4026
  "json": {
3871
4027
  "description": "Format output as json.",
@@ -3901,7 +4057,7 @@
3901
4057
  },
3902
4058
  "hasDynamicHelp": false,
3903
4059
  "hiddenAliases": [],
3904
- "id": "compile:doc:get",
4060
+ "id": "compile:thread:get",
3905
4061
  "pluginAlias": "faces-cli",
3906
4062
  "pluginName": "faces-cli",
3907
4063
  "pluginType": "core",
@@ -3912,11 +4068,11 @@
3912
4068
  "dist",
3913
4069
  "commands",
3914
4070
  "compile",
3915
- "doc",
4071
+ "thread",
3916
4072
  "get.js"
3917
4073
  ]
3918
4074
  },
3919
- "compile:doc": {
4075
+ "compile:thread:list": {
3920
4076
  "aliases": [],
3921
4077
  "args": {
3922
4078
  "face_id": {
@@ -3925,7 +4081,7 @@
3925
4081
  "required": true
3926
4082
  }
3927
4083
  },
3928
- "description": "Compile a document into a face (create → make in one step)",
4084
+ "description": "List threads for a face",
3929
4085
  "flags": {
3930
4086
  "json": {
3931
4087
  "description": "Format output as json.",
@@ -3957,38 +4113,65 @@
3957
4113
  "hasDynamicHelp": false,
3958
4114
  "multiple": false,
3959
4115
  "type": "option"
4116
+ }
4117
+ },
4118
+ "hasDynamicHelp": false,
4119
+ "hiddenAliases": [],
4120
+ "id": "compile:thread:list",
4121
+ "pluginAlias": "faces-cli",
4122
+ "pluginName": "faces-cli",
4123
+ "pluginType": "core",
4124
+ "strict": true,
4125
+ "enableJsonFlag": true,
4126
+ "isESM": true,
4127
+ "relativePath": [
4128
+ "dist",
4129
+ "commands",
4130
+ "compile",
4131
+ "thread",
4132
+ "list.js"
4133
+ ]
4134
+ },
4135
+ "compile:thread:make": {
4136
+ "aliases": [],
4137
+ "args": {
4138
+ "thread_id": {
4139
+ "description": "Thread ID",
4140
+ "name": "thread_id",
4141
+ "required": true
4142
+ }
4143
+ },
4144
+ "description": "Compile an existing thread (prepare + sync in one step)",
4145
+ "flags": {
4146
+ "json": {
4147
+ "description": "Format output as json.",
4148
+ "helpGroup": "GLOBAL",
4149
+ "name": "json",
4150
+ "allowNo": false,
4151
+ "type": "boolean"
3960
4152
  },
3961
- "label": {
3962
- "description": "Document label/title",
3963
- "name": "label",
3964
- "hasDynamicHelp": false,
3965
- "multiple": false,
3966
- "type": "option"
3967
- },
3968
- "content": {
3969
- "description": "Inline text content",
3970
- "name": "content",
4153
+ "base-url": {
4154
+ "description": "API base URL",
4155
+ "env": "FACES_BASE_URL",
4156
+ "name": "base-url",
3971
4157
  "hasDynamicHelp": false,
3972
4158
  "multiple": false,
3973
4159
  "type": "option"
3974
4160
  },
3975
- "file": {
3976
- "description": "Read content from file",
3977
- "name": "file",
4161
+ "token": {
4162
+ "description": "JWT bearer token",
4163
+ "env": "FACES_TOKEN",
4164
+ "name": "token",
3978
4165
  "hasDynamicHelp": false,
3979
4166
  "multiple": false,
3980
4167
  "type": "option"
3981
4168
  },
3982
- "perspective": {
3983
- "description": "Perspective",
3984
- "name": "perspective",
3985
- "default": "first-person",
4169
+ "api-key": {
4170
+ "description": "API key",
4171
+ "env": "FACES_API_KEY",
4172
+ "name": "api-key",
3986
4173
  "hasDynamicHelp": false,
3987
4174
  "multiple": false,
3988
- "options": [
3989
- "first-person",
3990
- "third-person"
3991
- ],
3992
4175
  "type": "option"
3993
4176
  },
3994
4177
  "timeout": {
@@ -4000,7 +4183,7 @@
4000
4183
  "type": "option"
4001
4184
  },
4002
4185
  "no-wait": {
4003
- "description": "Create and trigger compilation, then return immediately without polling.",
4186
+ "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
4004
4187
  "name": "no-wait",
4005
4188
  "allowNo": false,
4006
4189
  "type": "boolean"
@@ -4008,7 +4191,7 @@
4008
4191
  },
4009
4192
  "hasDynamicHelp": false,
4010
4193
  "hiddenAliases": [],
4011
- "id": "compile:doc",
4194
+ "id": "compile:thread:make",
4012
4195
  "pluginAlias": "faces-cli",
4013
4196
  "pluginName": "faces-cli",
4014
4197
  "pluginType": "core",
@@ -4019,20 +4202,20 @@
4019
4202
  "dist",
4020
4203
  "commands",
4021
4204
  "compile",
4022
- "doc",
4023
- "index.js"
4205
+ "thread",
4206
+ "make.js"
4024
4207
  ]
4025
4208
  },
4026
- "compile:doc:list": {
4209
+ "compile:thread:message": {
4027
4210
  "aliases": [],
4028
4211
  "args": {
4029
- "face_id": {
4030
- "description": "Face alias",
4031
- "name": "face_id",
4212
+ "thread_id": {
4213
+ "description": "Thread ID",
4214
+ "name": "thread_id",
4032
4215
  "required": true
4033
4216
  }
4034
4217
  },
4035
- "description": "List documents for a face",
4218
+ "description": "Send a user message to a thread",
4036
4219
  "flags": {
4037
4220
  "json": {
4038
4221
  "description": "Format output as json.",
@@ -4064,11 +4247,20 @@
4064
4247
  "hasDynamicHelp": false,
4065
4248
  "multiple": false,
4066
4249
  "type": "option"
4250
+ },
4251
+ "message": {
4252
+ "char": "m",
4253
+ "description": "User message to append",
4254
+ "name": "message",
4255
+ "required": true,
4256
+ "hasDynamicHelp": false,
4257
+ "multiple": false,
4258
+ "type": "option"
4067
4259
  }
4068
4260
  },
4069
4261
  "hasDynamicHelp": false,
4070
4262
  "hiddenAliases": [],
4071
- "id": "compile:doc:list",
4263
+ "id": "compile:thread:message",
4072
4264
  "pluginAlias": "faces-cli",
4073
4265
  "pluginName": "faces-cli",
4074
4266
  "pluginType": "core",
@@ -4079,20 +4271,20 @@
4079
4271
  "dist",
4080
4272
  "commands",
4081
4273
  "compile",
4082
- "doc",
4083
- "list.js"
4274
+ "thread",
4275
+ "message.js"
4084
4276
  ]
4085
4277
  },
4086
- "compile:doc:make": {
4278
+ "compile:thread:pause": {
4087
4279
  "aliases": [],
4088
4280
  "args": {
4089
- "doc_id": {
4090
- "description": "Document ID",
4091
- "name": "doc_id",
4281
+ "thread_id": {
4282
+ "description": "Thread ID",
4283
+ "name": "thread_id",
4092
4284
  "required": true
4093
4285
  }
4094
4286
  },
4095
- "description": "Compile an existing document (prepare + sync in one step)",
4287
+ "description": "Pause a running thread compilation (preserves progress, resume with make)",
4096
4288
  "flags": {
4097
4289
  "json": {
4098
4290
  "description": "Format output as json.",
@@ -4124,25 +4316,11 @@
4124
4316
  "hasDynamicHelp": false,
4125
4317
  "multiple": false,
4126
4318
  "type": "option"
4127
- },
4128
- "timeout": {
4129
- "description": "Compile timeout in seconds (default: 600)",
4130
- "name": "timeout",
4131
- "default": 600,
4132
- "hasDynamicHelp": false,
4133
- "multiple": false,
4134
- "type": "option"
4135
- },
4136
- "no-wait": {
4137
- "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
4138
- "name": "no-wait",
4139
- "allowNo": false,
4140
- "type": "boolean"
4141
4319
  }
4142
4320
  },
4143
4321
  "hasDynamicHelp": false,
4144
4322
  "hiddenAliases": [],
4145
- "id": "compile:doc:make",
4323
+ "id": "compile:thread:pause",
4146
4324
  "pluginAlias": "faces-cli",
4147
4325
  "pluginName": "faces-cli",
4148
4326
  "pluginType": "core",
@@ -4153,20 +4331,20 @@
4153
4331
  "dist",
4154
4332
  "commands",
4155
4333
  "compile",
4156
- "doc",
4157
- "make.js"
4334
+ "thread",
4335
+ "pause.js"
4158
4336
  ]
4159
4337
  },
4160
- "compile:doc:pause": {
4338
+ "compile:thread:reset": {
4161
4339
  "aliases": [],
4162
4340
  "args": {
4163
- "doc_id": {
4164
- "description": "Document ID",
4165
- "name": "doc_id",
4341
+ "thread_id": {
4342
+ "description": "Thread ID",
4343
+ "name": "thread_id",
4166
4344
  "required": true
4167
4345
  }
4168
4346
  },
4169
- "description": "Pause a running document compilation (preserves progress, resume with make)",
4347
+ "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
4170
4348
  "flags": {
4171
4349
  "json": {
4172
4350
  "description": "Format output as json.",
@@ -4198,11 +4376,17 @@
4198
4376
  "hasDynamicHelp": false,
4199
4377
  "multiple": false,
4200
4378
  "type": "option"
4379
+ },
4380
+ "yes": {
4381
+ "description": "Skip confirmation",
4382
+ "name": "yes",
4383
+ "allowNo": false,
4384
+ "type": "boolean"
4201
4385
  }
4202
4386
  },
4203
4387
  "hasDynamicHelp": false,
4204
4388
  "hiddenAliases": [],
4205
- "id": "compile:doc:pause",
4389
+ "id": "compile:thread:reset",
4206
4390
  "pluginAlias": "faces-cli",
4207
4391
  "pluginName": "faces-cli",
4208
4392
  "pluginType": "core",
@@ -4213,20 +4397,20 @@
4213
4397
  "dist",
4214
4398
  "commands",
4215
4399
  "compile",
4216
- "doc",
4217
- "pause.js"
4400
+ "thread",
4401
+ "reset.js"
4218
4402
  ]
4219
4403
  },
4220
- "compile:doc:reset": {
4404
+ "compile:thread:sync": {
4221
4405
  "aliases": [],
4222
4406
  "args": {
4223
- "doc_id": {
4224
- "description": "Document ID",
4225
- "name": "doc_id",
4407
+ "thread_id": {
4408
+ "description": "Thread ID",
4409
+ "name": "thread_id",
4226
4410
  "required": true
4227
4411
  }
4228
4412
  },
4229
- "description": "Reset document compilation progress (wipe extraction, keep content)",
4413
+ "description": "Archive and sync a thread into a face",
4230
4414
  "flags": {
4231
4415
  "json": {
4232
4416
  "description": "Format output as json.",
@@ -4258,17 +4442,11 @@
4258
4442
  "hasDynamicHelp": false,
4259
4443
  "multiple": false,
4260
4444
  "type": "option"
4261
- },
4262
- "yes": {
4263
- "description": "Skip confirmation",
4264
- "name": "yes",
4265
- "allowNo": false,
4266
- "type": "boolean"
4267
4445
  }
4268
4446
  },
4269
4447
  "hasDynamicHelp": false,
4270
4448
  "hiddenAliases": [],
4271
- "id": "compile:doc:reset",
4449
+ "id": "compile:thread:sync",
4272
4450
  "pluginAlias": "faces-cli",
4273
4451
  "pluginName": "faces-cli",
4274
4452
  "pluginType": "core",
@@ -4279,10 +4457,10 @@
4279
4457
  "dist",
4280
4458
  "commands",
4281
4459
  "compile",
4282
- "doc",
4283
- "reset.js"
4460
+ "thread",
4461
+ "sync.js"
4284
4462
  ]
4285
4463
  }
4286
4464
  },
4287
- "version": "1.5.13"
4465
+ "version": "1.5.15"
4288
4466
  }