faces-cli 1.5.12 → 1.5.13

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 (7) hide show
  1. package/dist/client.js +6 -1
  2. package/dist/commands/face/attributes.d.ts +10 -0
  3. package/dist/commands/face/attributes.js +30 -0
  4. package/dist/commands/face/create.js +4 -0
  5. package/dist/commands/face/update.js +4 -0
  6. package/oclif.manifest.json +980 -927
  7. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -1,9 +1,22 @@
1
1
  {
2
2
  "commands": {
3
- "account:state": {
3
+ "auth:connect": {
4
4
  "aliases": [],
5
- "args": {},
6
- "description": "Full account routing state (plan, balance, onboarding)",
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
+ ],
7
20
  "flags": {
8
21
  "json": {
9
22
  "description": "Format output as json.",
@@ -35,11 +48,17 @@
35
48
  "hasDynamicHelp": false,
36
49
  "multiple": false,
37
50
  "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"
38
57
  }
39
58
  },
40
59
  "hasDynamicHelp": false,
41
60
  "hiddenAliases": [],
42
- "id": "account:state",
61
+ "id": "auth:connect",
43
62
  "pluginAlias": "faces-cli",
44
63
  "pluginName": "faces-cli",
45
64
  "pluginType": "core",
@@ -49,14 +68,18 @@
49
68
  "relativePath": [
50
69
  "dist",
51
70
  "commands",
52
- "account",
53
- "state.js"
71
+ "auth",
72
+ "connect.js"
54
73
  ]
55
74
  },
56
- "billing:balance": {
75
+ "auth:connections": {
57
76
  "aliases": [],
58
77
  "args": {},
59
- "description": "Show credit balance and payment method status",
78
+ "description": "List connected OAuth provider accounts",
79
+ "examples": [
80
+ "<%= config.bin %> auth connections",
81
+ "<%= config.bin %> auth connections --json"
82
+ ],
60
83
  "flags": {
61
84
  "json": {
62
85
  "description": "Format output as json.",
@@ -92,7 +115,7 @@
92
115
  },
93
116
  "hasDynamicHelp": false,
94
117
  "hiddenAliases": [],
95
- "id": "billing:balance",
118
+ "id": "auth:connections",
96
119
  "pluginAlias": "faces-cli",
97
120
  "pluginName": "faces-cli",
98
121
  "pluginType": "core",
@@ -102,14 +125,26 @@
102
125
  "relativePath": [
103
126
  "dist",
104
127
  "commands",
105
- "billing",
106
- "balance.js"
128
+ "auth",
129
+ "connections.js"
107
130
  ]
108
131
  },
109
- "billing:card-setup": {
132
+ "auth:disconnect": {
110
133
  "aliases": [],
111
- "args": {},
112
- "description": "Get a Stripe card setup URL to save a payment method",
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
+ ],
113
148
  "flags": {
114
149
  "json": {
115
150
  "description": "Format output as json.",
@@ -145,7 +180,7 @@
145
180
  },
146
181
  "hasDynamicHelp": false,
147
182
  "hiddenAliases": [],
148
- "id": "billing:card-setup",
183
+ "id": "auth:disconnect",
149
184
  "pluginAlias": "faces-cli",
150
185
  "pluginName": "faces-cli",
151
186
  "pluginType": "core",
@@ -155,14 +190,14 @@
155
190
  "relativePath": [
156
191
  "dist",
157
192
  "commands",
158
- "billing",
159
- "card-setup.js"
193
+ "auth",
194
+ "disconnect.js"
160
195
  ]
161
196
  },
162
- "billing:checkout": {
197
+ "auth:login": {
163
198
  "aliases": [],
164
199
  "args": {},
165
- "description": "Get a Stripe checkout URL to upgrade your subscription plan",
200
+ "description": "Login and save JWT credentials",
166
201
  "flags": {
167
202
  "json": {
168
203
  "description": "Format output as json.",
@@ -195,21 +230,26 @@
195
230
  "multiple": false,
196
231
  "type": "option"
197
232
  },
198
- "plan": {
199
- "description": "Plan to subscribe to",
200
- "name": "plan",
201
- "default": "connect",
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,
202
245
  "hasDynamicHelp": false,
203
246
  "multiple": false,
204
- "options": [
205
- "connect"
206
- ],
207
247
  "type": "option"
208
248
  }
209
249
  },
210
250
  "hasDynamicHelp": false,
211
251
  "hiddenAliases": [],
212
- "id": "billing:checkout",
252
+ "id": "auth:login",
213
253
  "pluginAlias": "faces-cli",
214
254
  "pluginName": "faces-cli",
215
255
  "pluginType": "core",
@@ -219,14 +259,14 @@
219
259
  "relativePath": [
220
260
  "dist",
221
261
  "commands",
222
- "billing",
223
- "checkout.js"
262
+ "auth",
263
+ "login.js"
224
264
  ]
225
265
  },
226
- "billing:llm-costs": {
266
+ "auth:logout": {
227
267
  "aliases": [],
228
268
  "args": {},
229
- "description": "List available LLMs and their per-token costs",
269
+ "description": "Clear saved credentials",
230
270
  "flags": {
231
271
  "json": {
232
272
  "description": "Format output as json.",
@@ -258,18 +298,11 @@
258
298
  "hasDynamicHelp": false,
259
299
  "multiple": false,
260
300
  "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"
268
301
  }
269
302
  },
270
303
  "hasDynamicHelp": false,
271
304
  "hiddenAliases": [],
272
- "id": "billing:llm-costs",
305
+ "id": "auth:logout",
273
306
  "pluginAlias": "faces-cli",
274
307
  "pluginName": "faces-cli",
275
308
  "pluginType": "core",
@@ -279,14 +312,14 @@
279
312
  "relativePath": [
280
313
  "dist",
281
314
  "commands",
282
- "billing",
283
- "llm-costs.js"
315
+ "auth",
316
+ "logout.js"
284
317
  ]
285
318
  },
286
- "billing:quota": {
319
+ "auth:refresh": {
287
320
  "aliases": [],
288
321
  "args": {},
289
- "description": "Show compile token quota and per-face stats",
322
+ "description": "Exchange current JWT for a fresh one",
290
323
  "flags": {
291
324
  "json": {
292
325
  "description": "Format output as json.",
@@ -322,7 +355,7 @@
322
355
  },
323
356
  "hasDynamicHelp": false,
324
357
  "hiddenAliases": [],
325
- "id": "billing:quota",
358
+ "id": "auth:refresh",
326
359
  "pluginAlias": "faces-cli",
327
360
  "pluginName": "faces-cli",
328
361
  "pluginType": "core",
@@ -332,14 +365,14 @@
332
365
  "relativePath": [
333
366
  "dist",
334
367
  "commands",
335
- "billing",
336
- "quota.js"
368
+ "auth",
369
+ "refresh.js"
337
370
  ]
338
371
  },
339
- "billing:subscription": {
372
+ "auth:register": {
340
373
  "aliases": [],
341
374
  "args": {},
342
- "description": "Show current plan, face count, and renewal date",
375
+ "description": "Create a new Faces account",
343
376
  "flags": {
344
377
  "json": {
345
378
  "description": "Format output as json.",
@@ -371,11 +404,61 @@
371
404
  "hasDynamicHelp": false,
372
405
  "multiple": false,
373
406
  "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"
374
457
  }
375
458
  },
376
459
  "hasDynamicHelp": false,
377
460
  "hiddenAliases": [],
378
- "id": "billing:subscription",
461
+ "id": "auth:register",
379
462
  "pluginAlias": "faces-cli",
380
463
  "pluginName": "faces-cli",
381
464
  "pluginType": "core",
@@ -385,14 +468,14 @@
385
468
  "relativePath": [
386
469
  "dist",
387
470
  "commands",
388
- "billing",
389
- "subscription.js"
471
+ "auth",
472
+ "register.js"
390
473
  ]
391
474
  },
392
- "billing:topup": {
475
+ "auth:whoami": {
393
476
  "aliases": [],
394
477
  "args": {},
395
- "description": "Top up credit balance using saved payment method",
478
+ "description": "Print current user profile and auth diagnostic",
396
479
  "flags": {
397
480
  "json": {
398
481
  "description": "Format output as json.",
@@ -424,26 +507,11 @@
424
507
  "hasDynamicHelp": false,
425
508
  "multiple": false,
426
509
  "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"
442
510
  }
443
511
  },
444
512
  "hasDynamicHelp": false,
445
513
  "hiddenAliases": [],
446
- "id": "billing:topup",
514
+ "id": "auth:whoami",
447
515
  "pluginAlias": "faces-cli",
448
516
  "pluginName": "faces-cli",
449
517
  "pluginType": "core",
@@ -453,14 +521,14 @@
453
521
  "relativePath": [
454
522
  "dist",
455
523
  "commands",
456
- "billing",
457
- "topup.js"
524
+ "auth",
525
+ "whoami.js"
458
526
  ]
459
527
  },
460
- "billing:usage": {
528
+ "billing:balance": {
461
529
  "aliases": [],
462
530
  "args": {},
463
- "description": "Aggregated usage analytics",
531
+ "description": "Show credit balance and payment method status",
464
532
  "flags": {
465
533
  "json": {
466
534
  "description": "Format output as json.",
@@ -492,38 +560,11 @@
492
560
  "hasDynamicHelp": false,
493
561
  "multiple": false,
494
562
  "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"
522
563
  }
523
564
  },
524
565
  "hasDynamicHelp": false,
525
566
  "hiddenAliases": [],
526
- "id": "billing:usage",
567
+ "id": "billing:balance",
527
568
  "pluginAlias": "faces-cli",
528
569
  "pluginName": "faces-cli",
529
570
  "pluginType": "core",
@@ -534,13 +575,13 @@
534
575
  "dist",
535
576
  "commands",
536
577
  "billing",
537
- "usage.js"
578
+ "balance.js"
538
579
  ]
539
580
  },
540
- "catalog:doctor": {
581
+ "billing:card-setup": {
541
582
  "aliases": [],
542
583
  "args": {},
543
- "description": "Diagnose and repair the local face catalog",
584
+ "description": "Get a Stripe card setup URL to save a payment method",
544
585
  "flags": {
545
586
  "json": {
546
587
  "description": "Format output as json.",
@@ -572,23 +613,11 @@
572
613
  "hasDynamicHelp": false,
573
614
  "multiple": false,
574
615
  "type": "option"
575
- },
576
- "fix": {
577
- "description": "Rebuild missing or stale catalog entries from API",
578
- "name": "fix",
579
- "allowNo": false,
580
- "type": "boolean"
581
- },
582
- "generate": {
583
- "description": "Fix + generate missing descriptions via LLM",
584
- "name": "generate",
585
- "allowNo": false,
586
- "type": "boolean"
587
616
  }
588
617
  },
589
618
  "hasDynamicHelp": false,
590
619
  "hiddenAliases": [],
591
- "id": "catalog:doctor",
620
+ "id": "billing:card-setup",
592
621
  "pluginAlias": "faces-cli",
593
622
  "pluginName": "faces-cli",
594
623
  "pluginType": "core",
@@ -598,14 +627,14 @@
598
627
  "relativePath": [
599
628
  "dist",
600
629
  "commands",
601
- "catalog",
602
- "doctor.js"
630
+ "billing",
631
+ "card-setup.js"
603
632
  ]
604
633
  },
605
- "catalog:list": {
634
+ "billing:checkout": {
606
635
  "aliases": [],
607
636
  "args": {},
608
- "description": "List all faces in the local catalog",
637
+ "description": "Get a Stripe checkout URL to upgrade your subscription plan",
609
638
  "flags": {
610
639
  "json": {
611
640
  "description": "Format output as json.",
@@ -637,11 +666,22 @@
637
666
  "hasDynamicHelp": false,
638
667
  "multiple": false,
639
668
  "type": "option"
669
+ },
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"
640
680
  }
641
681
  },
642
682
  "hasDynamicHelp": false,
643
683
  "hiddenAliases": [],
644
- "id": "catalog:list",
684
+ "id": "billing:checkout",
645
685
  "pluginAlias": "faces-cli",
646
686
  "pluginName": "faces-cli",
647
687
  "pluginType": "core",
@@ -651,14 +691,14 @@
651
691
  "relativePath": [
652
692
  "dist",
653
693
  "commands",
654
- "catalog",
655
- "list.js"
694
+ "billing",
695
+ "checkout.js"
656
696
  ]
657
697
  },
658
- "catalog:manyfaced": {
698
+ "billing:llm-costs": {
659
699
  "aliases": [],
660
700
  "args": {},
661
- "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
701
+ "description": "List available LLMs and their per-token costs",
662
702
  "flags": {
663
703
  "json": {
664
704
  "description": "Format output as json.",
@@ -691,37 +731,17 @@
691
731
  "multiple": false,
692
732
  "type": "option"
693
733
  },
694
- "skill": {
695
- "description": "Show details for a specific skill",
696
- "name": "skill",
697
- "hasDynamicHelp": false,
698
- "multiple": false,
699
- "type": "option"
700
- },
701
- "install": {
702
- "description": "Install a skill by name",
703
- "name": "install",
704
- "hasDynamicHelp": false,
705
- "multiple": false,
706
- "type": "option"
707
- },
708
- "skills-dir": {
709
- "description": "Directory to install skills into (required for --install)",
710
- "name": "skills-dir",
734
+ "provider": {
735
+ "description": "Filter by provider (e.g. openai, anthropic)",
736
+ "name": "provider",
711
737
  "hasDynamicHelp": false,
712
738
  "multiple": false,
713
739
  "type": "option"
714
- },
715
- "refresh": {
716
- "description": "Force refresh the skill index (ignore cache)",
717
- "name": "refresh",
718
- "allowNo": false,
719
- "type": "boolean"
720
740
  }
721
741
  },
722
742
  "hasDynamicHelp": false,
723
743
  "hiddenAliases": [],
724
- "id": "catalog:manyfaced",
744
+ "id": "billing:llm-costs",
725
745
  "pluginAlias": "faces-cli",
726
746
  "pluginName": "faces-cli",
727
747
  "pluginType": "core",
@@ -731,27 +751,14 @@
731
751
  "relativePath": [
732
752
  "dist",
733
753
  "commands",
734
- "catalog",
735
- "manyfaced.js"
754
+ "billing",
755
+ "llm-costs.js"
736
756
  ]
737
757
  },
738
- "auth:connect": {
758
+ "billing:quota": {
739
759
  "aliases": [],
740
- "args": {
741
- "provider": {
742
- "description": "OAuth provider to connect",
743
- "name": "provider",
744
- "options": [
745
- "openai"
746
- ],
747
- "required": true
748
- }
749
- },
750
- "description": "Connect an OAuth provider account to Faces (e.g. ChatGPT Plus/Pro)",
751
- "examples": [
752
- "<%= config.bin %> auth connect openai",
753
- "<%= config.bin %> auth connect openai --manual"
754
- ],
760
+ "args": {},
761
+ "description": "Show compile token quota and per-face stats",
755
762
  "flags": {
756
763
  "json": {
757
764
  "description": "Format output as json.",
@@ -783,17 +790,11 @@
783
790
  "hasDynamicHelp": false,
784
791
  "multiple": false,
785
792
  "type": "option"
786
- },
787
- "manual": {
788
- "description": "Manual mode for headless environments: prints the authorize URL and prompts you to paste the callback URL after approving in any browser.",
789
- "name": "manual",
790
- "allowNo": false,
791
- "type": "boolean"
792
793
  }
793
794
  },
794
795
  "hasDynamicHelp": false,
795
796
  "hiddenAliases": [],
796
- "id": "auth:connect",
797
+ "id": "billing:quota",
797
798
  "pluginAlias": "faces-cli",
798
799
  "pluginName": "faces-cli",
799
800
  "pluginType": "core",
@@ -803,18 +804,14 @@
803
804
  "relativePath": [
804
805
  "dist",
805
806
  "commands",
806
- "auth",
807
- "connect.js"
807
+ "billing",
808
+ "quota.js"
808
809
  ]
809
810
  },
810
- "auth:connections": {
811
+ "billing:subscription": {
811
812
  "aliases": [],
812
813
  "args": {},
813
- "description": "List connected OAuth provider accounts",
814
- "examples": [
815
- "<%= config.bin %> auth connections",
816
- "<%= config.bin %> auth connections --json"
817
- ],
814
+ "description": "Show current plan, face count, and renewal date",
818
815
  "flags": {
819
816
  "json": {
820
817
  "description": "Format output as json.",
@@ -850,7 +847,7 @@
850
847
  },
851
848
  "hasDynamicHelp": false,
852
849
  "hiddenAliases": [],
853
- "id": "auth:connections",
850
+ "id": "billing:subscription",
854
851
  "pluginAlias": "faces-cli",
855
852
  "pluginName": "faces-cli",
856
853
  "pluginType": "core",
@@ -860,26 +857,14 @@
860
857
  "relativePath": [
861
858
  "dist",
862
859
  "commands",
863
- "auth",
864
- "connections.js"
860
+ "billing",
861
+ "subscription.js"
865
862
  ]
866
863
  },
867
- "auth:disconnect": {
864
+ "billing:topup": {
868
865
  "aliases": [],
869
- "args": {
870
- "provider": {
871
- "description": "OAuth provider to disconnect",
872
- "name": "provider",
873
- "options": [
874
- "openai"
875
- ],
876
- "required": true
877
- }
878
- },
879
- "description": "Disconnect a linked OAuth provider account",
880
- "examples": [
881
- "<%= config.bin %> auth disconnect openai"
882
- ],
866
+ "args": {},
867
+ "description": "Top up credit balance using saved payment method",
883
868
  "flags": {
884
869
  "json": {
885
870
  "description": "Format output as json.",
@@ -911,11 +896,26 @@
911
896
  "hasDynamicHelp": false,
912
897
  "multiple": false,
913
898
  "type": "option"
899
+ },
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"
914
914
  }
915
915
  },
916
916
  "hasDynamicHelp": false,
917
917
  "hiddenAliases": [],
918
- "id": "auth:disconnect",
918
+ "id": "billing:topup",
919
919
  "pluginAlias": "faces-cli",
920
920
  "pluginName": "faces-cli",
921
921
  "pluginType": "core",
@@ -925,14 +925,14 @@
925
925
  "relativePath": [
926
926
  "dist",
927
927
  "commands",
928
- "auth",
929
- "disconnect.js"
928
+ "billing",
929
+ "topup.js"
930
930
  ]
931
931
  },
932
- "auth:login": {
932
+ "billing:usage": {
933
933
  "aliases": [],
934
934
  "args": {},
935
- "description": "Login and save JWT credentials",
935
+ "description": "Aggregated usage analytics",
936
936
  "flags": {
937
937
  "json": {
938
938
  "description": "Format output as json.",
@@ -965,18 +965,29 @@
965
965
  "multiple": false,
966
966
  "type": "option"
967
967
  },
968
- "email": {
969
- "description": "Account email",
970
- "name": "email",
971
- "required": true,
968
+ "group-by": {
969
+ "description": "Group results",
970
+ "name": "group-by",
972
971
  "hasDynamicHelp": false,
973
972
  "multiple": false,
973
+ "options": [
974
+ "api_key",
975
+ "model",
976
+ "llm",
977
+ "date"
978
+ ],
974
979
  "type": "option"
975
980
  },
976
- "password": {
977
- "description": "Account password",
978
- "name": "password",
979
- "required": true,
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",
980
991
  "hasDynamicHelp": false,
981
992
  "multiple": false,
982
993
  "type": "option"
@@ -984,7 +995,7 @@
984
995
  },
985
996
  "hasDynamicHelp": false,
986
997
  "hiddenAliases": [],
987
- "id": "auth:login",
998
+ "id": "billing:usage",
988
999
  "pluginAlias": "faces-cli",
989
1000
  "pluginName": "faces-cli",
990
1001
  "pluginType": "core",
@@ -994,14 +1005,14 @@
994
1005
  "relativePath": [
995
1006
  "dist",
996
1007
  "commands",
997
- "auth",
998
- "login.js"
1008
+ "billing",
1009
+ "usage.js"
999
1010
  ]
1000
1011
  },
1001
- "auth:logout": {
1012
+ "catalog:doctor": {
1002
1013
  "aliases": [],
1003
1014
  "args": {},
1004
- "description": "Clear saved credentials",
1015
+ "description": "Diagnose and repair the local face catalog",
1005
1016
  "flags": {
1006
1017
  "json": {
1007
1018
  "description": "Format output as json.",
@@ -1033,11 +1044,23 @@
1033
1044
  "hasDynamicHelp": false,
1034
1045
  "multiple": false,
1035
1046
  "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"
1036
1059
  }
1037
1060
  },
1038
1061
  "hasDynamicHelp": false,
1039
1062
  "hiddenAliases": [],
1040
- "id": "auth:logout",
1063
+ "id": "catalog:doctor",
1041
1064
  "pluginAlias": "faces-cli",
1042
1065
  "pluginName": "faces-cli",
1043
1066
  "pluginType": "core",
@@ -1047,14 +1070,14 @@
1047
1070
  "relativePath": [
1048
1071
  "dist",
1049
1072
  "commands",
1050
- "auth",
1051
- "logout.js"
1073
+ "catalog",
1074
+ "doctor.js"
1052
1075
  ]
1053
1076
  },
1054
- "auth:refresh": {
1077
+ "catalog:list": {
1055
1078
  "aliases": [],
1056
1079
  "args": {},
1057
- "description": "Exchange current JWT for a fresh one",
1080
+ "description": "List all faces in the local catalog",
1058
1081
  "flags": {
1059
1082
  "json": {
1060
1083
  "description": "Format output as json.",
@@ -1090,7 +1113,7 @@
1090
1113
  },
1091
1114
  "hasDynamicHelp": false,
1092
1115
  "hiddenAliases": [],
1093
- "id": "auth:refresh",
1116
+ "id": "catalog:list",
1094
1117
  "pluginAlias": "faces-cli",
1095
1118
  "pluginName": "faces-cli",
1096
1119
  "pluginType": "core",
@@ -1100,14 +1123,14 @@
1100
1123
  "relativePath": [
1101
1124
  "dist",
1102
1125
  "commands",
1103
- "auth",
1104
- "refresh.js"
1126
+ "catalog",
1127
+ "list.js"
1105
1128
  ]
1106
1129
  },
1107
- "auth:register": {
1130
+ "catalog:manyfaced": {
1108
1131
  "aliases": [],
1109
1132
  "args": {},
1110
- "description": "Create a new Faces account",
1133
+ "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
1111
1134
  "flags": {
1112
1135
  "json": {
1113
1136
  "description": "Format output as json.",
@@ -1140,113 +1163,37 @@
1140
1163
  "multiple": false,
1141
1164
  "type": "option"
1142
1165
  },
1143
- "email": {
1144
- "description": "Email address",
1145
- "name": "email",
1146
- "required": true,
1147
- "hasDynamicHelp": false,
1148
- "multiple": false,
1149
- "type": "option"
1150
- },
1151
- "password": {
1152
- "description": "Password",
1153
- "name": "password",
1154
- "required": true,
1166
+ "skill": {
1167
+ "description": "Show details for a specific skill",
1168
+ "name": "skill",
1155
1169
  "hasDynamicHelp": false,
1156
1170
  "multiple": false,
1157
1171
  "type": "option"
1158
1172
  },
1159
- "name": {
1160
- "description": "Display name (defaults to username)",
1161
- "name": "name",
1173
+ "install": {
1174
+ "description": "Install a skill by name",
1175
+ "name": "install",
1162
1176
  "hasDynamicHelp": false,
1163
1177
  "multiple": false,
1164
1178
  "type": "option"
1165
1179
  },
1166
- "username": {
1167
- "description": "Username (lowercase, dashes, numbers)",
1168
- "name": "username",
1169
- "required": true,
1180
+ "skills-dir": {
1181
+ "description": "Directory to install skills into (required for --install)",
1182
+ "name": "skills-dir",
1170
1183
  "hasDynamicHelp": false,
1171
1184
  "multiple": false,
1172
1185
  "type": "option"
1173
1186
  },
1174
- "invite-key": {
1175
- "description": "Invite key (if required)",
1176
- "name": "invite-key",
1177
- "hasDynamicHelp": false,
1178
- "multiple": false,
1179
- "type": "option"
1180
- },
1181
- "plan": {
1182
- "description": "Plan to subscribe to: \"free\" ($5 activation) or \"connect\" ($17/mo, no activation fee)",
1183
- "name": "plan",
1184
- "default": "free",
1185
- "hasDynamicHelp": false,
1186
- "multiple": false,
1187
- "options": [
1188
- "free",
1189
- "connect"
1190
- ],
1191
- "type": "option"
1192
- }
1193
- },
1194
- "hasDynamicHelp": false,
1195
- "hiddenAliases": [],
1196
- "id": "auth:register",
1197
- "pluginAlias": "faces-cli",
1198
- "pluginName": "faces-cli",
1199
- "pluginType": "core",
1200
- "strict": true,
1201
- "enableJsonFlag": true,
1202
- "isESM": true,
1203
- "relativePath": [
1204
- "dist",
1205
- "commands",
1206
- "auth",
1207
- "register.js"
1208
- ]
1209
- },
1210
- "auth:whoami": {
1211
- "aliases": [],
1212
- "args": {},
1213
- "description": "Print current user profile and auth diagnostic",
1214
- "flags": {
1215
- "json": {
1216
- "description": "Format output as json.",
1217
- "helpGroup": "GLOBAL",
1218
- "name": "json",
1187
+ "refresh": {
1188
+ "description": "Force refresh the skill index (ignore cache)",
1189
+ "name": "refresh",
1219
1190
  "allowNo": false,
1220
1191
  "type": "boolean"
1221
- },
1222
- "base-url": {
1223
- "description": "API base URL",
1224
- "env": "FACES_BASE_URL",
1225
- "name": "base-url",
1226
- "hasDynamicHelp": false,
1227
- "multiple": false,
1228
- "type": "option"
1229
- },
1230
- "token": {
1231
- "description": "JWT bearer token",
1232
- "env": "FACES_TOKEN",
1233
- "name": "token",
1234
- "hasDynamicHelp": false,
1235
- "multiple": false,
1236
- "type": "option"
1237
- },
1238
- "api-key": {
1239
- "description": "API key",
1240
- "env": "FACES_API_KEY",
1241
- "name": "api-key",
1242
- "hasDynamicHelp": false,
1243
- "multiple": false,
1244
- "type": "option"
1245
1192
  }
1246
1193
  },
1247
1194
  "hasDynamicHelp": false,
1248
1195
  "hiddenAliases": [],
1249
- "id": "auth:whoami",
1196
+ "id": "catalog:manyfaced",
1250
1197
  "pluginAlias": "faces-cli",
1251
1198
  "pluginName": "faces-cli",
1252
1199
  "pluginType": "core",
@@ -1256,8 +1203,8 @@
1256
1203
  "relativePath": [
1257
1204
  "dist",
1258
1205
  "commands",
1259
- "auth",
1260
- "whoami.js"
1206
+ "catalog",
1207
+ "manyfaced.js"
1261
1208
  ]
1262
1209
  },
1263
1210
  "chat:chat": {
@@ -1929,10 +1876,10 @@
1929
1876
  "show.js"
1930
1877
  ]
1931
1878
  },
1932
- "face:create": {
1879
+ "keys:create": {
1933
1880
  "aliases": [],
1934
1881
  "args": {},
1935
- "description": "Create a new face",
1882
+ "description": "Create a new API key (JWT required)",
1936
1883
  "flags": {
1937
1884
  "json": {
1938
1885
  "description": "Format output as json.",
@@ -1966,52 +1913,37 @@
1966
1913
  "type": "option"
1967
1914
  },
1968
1915
  "name": {
1969
- "description": "Display name",
1916
+ "description": "Key name/label",
1970
1917
  "name": "name",
1971
1918
  "required": true,
1972
1919
  "hasDynamicHelp": false,
1973
1920
  "multiple": false,
1974
1921
  "type": "option"
1975
1922
  },
1976
- "alias": {
1977
- "description": "Unique alias slug",
1978
- "name": "alias",
1979
- "required": true,
1980
- "hasDynamicHelp": false,
1981
- "multiple": false,
1982
- "type": "option"
1983
- },
1984
- "description": {
1985
- "description": "Description for local catalog",
1986
- "name": "description",
1987
- "hasDynamicHelp": false,
1988
- "multiple": false,
1989
- "type": "option"
1990
- },
1991
- "default-model": {
1992
- "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
1993
- "name": "default-model",
1923
+ "expires-days": {
1924
+ "description": "Expiry in days (omit for no expiry)",
1925
+ "name": "expires-days",
1994
1926
  "hasDynamicHelp": false,
1995
1927
  "multiple": false,
1996
1928
  "type": "option"
1997
1929
  },
1998
- "formula": {
1999
- "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
2000
- "name": "formula",
1930
+ "budget": {
1931
+ "description": "Spend budget in USD",
1932
+ "name": "budget",
2001
1933
  "hasDynamicHelp": false,
2002
1934
  "multiple": false,
2003
1935
  "type": "option"
2004
1936
  },
2005
- "attr": {
2006
- "description": "Attribute KEY=VALUE (repeatable)",
2007
- "name": "attr",
1937
+ "face": {
1938
+ "description": "Allowed face alias (repeatable)",
1939
+ "name": "face",
2008
1940
  "hasDynamicHelp": false,
2009
1941
  "multiple": true,
2010
1942
  "type": "option"
2011
1943
  },
2012
- "tool": {
2013
- "description": "Tool name to enable (repeatable)",
2014
- "name": "tool",
1944
+ "model": {
1945
+ "description": "Allowed model name (repeatable)",
1946
+ "name": "model",
2015
1947
  "hasDynamicHelp": false,
2016
1948
  "multiple": true,
2017
1949
  "type": "option"
@@ -2019,7 +1951,7 @@
2019
1951
  },
2020
1952
  "hasDynamicHelp": false,
2021
1953
  "hiddenAliases": [],
2022
- "id": "face:create",
1954
+ "id": "keys:create",
2023
1955
  "pluginAlias": "faces-cli",
2024
1956
  "pluginName": "faces-cli",
2025
1957
  "pluginType": "core",
@@ -2029,20 +1961,14 @@
2029
1961
  "relativePath": [
2030
1962
  "dist",
2031
1963
  "commands",
2032
- "face",
1964
+ "keys",
2033
1965
  "create.js"
2034
1966
  ]
2035
1967
  },
2036
- "face:delete": {
1968
+ "keys:list": {
2037
1969
  "aliases": [],
2038
- "args": {
2039
- "face_id": {
2040
- "description": "Face alias",
2041
- "name": "face_id",
2042
- "required": true
2043
- }
2044
- },
2045
- "description": "Delete a face permanently",
1970
+ "args": {},
1971
+ "description": "List all API keys (JWT required)",
2046
1972
  "flags": {
2047
1973
  "json": {
2048
1974
  "description": "Format output as json.",
@@ -2074,17 +2000,11 @@
2074
2000
  "hasDynamicHelp": false,
2075
2001
  "multiple": false,
2076
2002
  "type": "option"
2077
- },
2078
- "yes": {
2079
- "description": "Skip confirmation",
2080
- "name": "yes",
2081
- "allowNo": false,
2082
- "type": "boolean"
2083
2003
  }
2084
2004
  },
2085
2005
  "hasDynamicHelp": false,
2086
2006
  "hiddenAliases": [],
2087
- "id": "face:delete",
2007
+ "id": "keys:list",
2088
2008
  "pluginAlias": "faces-cli",
2089
2009
  "pluginName": "faces-cli",
2090
2010
  "pluginType": "core",
@@ -2094,14 +2014,20 @@
2094
2014
  "relativePath": [
2095
2015
  "dist",
2096
2016
  "commands",
2097
- "face",
2098
- "delete.js"
2017
+ "keys",
2018
+ "list.js"
2099
2019
  ]
2100
2020
  },
2101
- "face:diff": {
2021
+ "keys:revoke": {
2102
2022
  "aliases": [],
2103
- "args": {},
2104
- "description": "Compare owned faces pairwise across all centroid components",
2023
+ "args": {
2024
+ "key_id": {
2025
+ "description": "Key ID",
2026
+ "name": "key_id",
2027
+ "required": true
2028
+ }
2029
+ },
2030
+ "description": "Revoke an API key (JWT required)",
2105
2031
  "flags": {
2106
2032
  "json": {
2107
2033
  "description": "Format output as json.",
@@ -2134,18 +2060,16 @@
2134
2060
  "multiple": false,
2135
2061
  "type": "option"
2136
2062
  },
2137
- "face": {
2138
- "description": "Face alias to include (repeatable, min 2)",
2139
- "name": "face",
2140
- "required": true,
2141
- "hasDynamicHelp": false,
2142
- "multiple": true,
2143
- "type": "option"
2063
+ "yes": {
2064
+ "description": "Skip confirmation",
2065
+ "name": "yes",
2066
+ "allowNo": false,
2067
+ "type": "boolean"
2144
2068
  }
2145
2069
  },
2146
2070
  "hasDynamicHelp": false,
2147
2071
  "hiddenAliases": [],
2148
- "id": "face:diff",
2072
+ "id": "keys:revoke",
2149
2073
  "pluginAlias": "faces-cli",
2150
2074
  "pluginName": "faces-cli",
2151
2075
  "pluginType": "core",
@@ -2155,20 +2079,20 @@
2155
2079
  "relativePath": [
2156
2080
  "dist",
2157
2081
  "commands",
2158
- "face",
2159
- "diff.js"
2082
+ "keys",
2083
+ "revoke.js"
2160
2084
  ]
2161
2085
  },
2162
- "face:get": {
2086
+ "keys:update": {
2163
2087
  "aliases": [],
2164
2088
  "args": {
2165
- "face_id": {
2166
- "description": "Face alias",
2167
- "name": "face_id",
2089
+ "key_id": {
2090
+ "description": "Key ID",
2091
+ "name": "key_id",
2168
2092
  "required": true
2169
2093
  }
2170
2094
  },
2171
- "description": "Get details for a face by alias",
2095
+ "description": "Update API key metadata (JWT required)",
2172
2096
  "flags": {
2173
2097
  "json": {
2174
2098
  "description": "Format output as json.",
@@ -2200,11 +2124,31 @@
2200
2124
  "hasDynamicHelp": false,
2201
2125
  "multiple": false,
2202
2126
  "type": "option"
2127
+ },
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",
2138
+ "hasDynamicHelp": false,
2139
+ "multiple": false,
2140
+ "type": "option"
2141
+ },
2142
+ "reset-spent": {
2143
+ "description": "Reset spent amount to zero",
2144
+ "name": "reset-spent",
2145
+ "allowNo": false,
2146
+ "type": "boolean"
2203
2147
  }
2204
2148
  },
2205
2149
  "hasDynamicHelp": false,
2206
2150
  "hiddenAliases": [],
2207
- "id": "face:get",
2151
+ "id": "keys:update",
2208
2152
  "pluginAlias": "faces-cli",
2209
2153
  "pluginName": "faces-cli",
2210
2154
  "pluginType": "core",
@@ -2214,14 +2158,14 @@
2214
2158
  "relativePath": [
2215
2159
  "dist",
2216
2160
  "commands",
2217
- "face",
2218
- "get.js"
2161
+ "keys",
2162
+ "update.js"
2219
2163
  ]
2220
2164
  },
2221
- "face:list": {
2165
+ "account:state": {
2222
2166
  "aliases": [],
2223
2167
  "args": {},
2224
- "description": "List all owned faces",
2168
+ "description": "Full account routing state (plan, balance, onboarding)",
2225
2169
  "flags": {
2226
2170
  "json": {
2227
2171
  "description": "Format output as json.",
@@ -2257,7 +2201,7 @@
2257
2201
  },
2258
2202
  "hasDynamicHelp": false,
2259
2203
  "hiddenAliases": [],
2260
- "id": "face:list",
2204
+ "id": "account:state",
2261
2205
  "pluginAlias": "faces-cli",
2262
2206
  "pluginName": "faces-cli",
2263
2207
  "pluginType": "core",
@@ -2267,20 +2211,14 @@
2267
2211
  "relativePath": [
2268
2212
  "dist",
2269
2213
  "commands",
2270
- "face",
2271
- "list.js"
2214
+ "account",
2215
+ "state.js"
2272
2216
  ]
2273
2217
  },
2274
- "face:neighbors": {
2218
+ "face:attributes": {
2275
2219
  "aliases": [],
2276
- "args": {
2277
- "face_id": {
2278
- "description": "Face alias",
2279
- "name": "face_id",
2280
- "required": true
2281
- }
2282
- },
2283
- "description": "Find the most similar or dissimilar owned faces to a given face",
2220
+ "args": {},
2221
+ "description": "List all supported attribute keys",
2284
2222
  "flags": {
2285
2223
  "json": {
2286
2224
  "description": "Format output as json.",
@@ -2312,45 +2250,11 @@
2312
2250
  "hasDynamicHelp": false,
2313
2251
  "multiple": false,
2314
2252
  "type": "option"
2315
- },
2316
- "k": {
2317
- "description": "Number of results (1–20)",
2318
- "name": "k",
2319
- "default": 5,
2320
- "hasDynamicHelp": false,
2321
- "multiple": false,
2322
- "type": "option"
2323
- },
2324
- "component": {
2325
- "description": "Centroid component to rank on (beta, delta, epsilon are the principal components of a face; face is their composite)",
2326
- "name": "component",
2327
- "default": "face",
2328
- "hasDynamicHelp": false,
2329
- "multiple": false,
2330
- "options": [
2331
- "face",
2332
- "beta",
2333
- "delta",
2334
- "epsilon"
2335
- ],
2336
- "type": "option"
2337
- },
2338
- "direction": {
2339
- "description": "nearest (most similar) or furthest (most dissimilar)",
2340
- "name": "direction",
2341
- "default": "nearest",
2342
- "hasDynamicHelp": false,
2343
- "multiple": false,
2344
- "options": [
2345
- "nearest",
2346
- "furthest"
2347
- ],
2348
- "type": "option"
2349
2253
  }
2350
2254
  },
2351
2255
  "hasDynamicHelp": false,
2352
2256
  "hiddenAliases": [],
2353
- "id": "face:neighbors",
2257
+ "id": "face:attributes",
2354
2258
  "pluginAlias": "faces-cli",
2355
2259
  "pluginName": "faces-cli",
2356
2260
  "pluginType": "core",
@@ -2361,13 +2265,13 @@
2361
2265
  "dist",
2362
2266
  "commands",
2363
2267
  "face",
2364
- "neighbors.js"
2268
+ "attributes.js"
2365
2269
  ]
2366
2270
  },
2367
- "face:stats": {
2271
+ "face:create": {
2368
2272
  "aliases": [],
2369
2273
  "args": {},
2370
- "description": "Compile and chat stats for all owned faces",
2274
+ "description": "Create a new face",
2371
2275
  "flags": {
2372
2276
  "json": {
2373
2277
  "description": "Format output as json.",
@@ -2399,69 +2303,19 @@
2399
2303
  "hasDynamicHelp": false,
2400
2304
  "multiple": false,
2401
2305
  "type": "option"
2402
- }
2403
- },
2404
- "hasDynamicHelp": false,
2405
- "hiddenAliases": [],
2406
- "id": "face:stats",
2407
- "pluginAlias": "faces-cli",
2408
- "pluginName": "faces-cli",
2409
- "pluginType": "core",
2410
- "strict": true,
2411
- "enableJsonFlag": true,
2412
- "isESM": true,
2413
- "relativePath": [
2414
- "dist",
2415
- "commands",
2416
- "face",
2417
- "stats.js"
2418
- ]
2419
- },
2420
- "face:update": {
2421
- "aliases": [],
2422
- "args": {
2423
- "face_id": {
2424
- "description": "Face alias",
2425
- "name": "face_id",
2426
- "required": true
2427
- }
2428
- },
2429
- "description": "Update a face's metadata",
2430
- "flags": {
2431
- "json": {
2432
- "description": "Format output as json.",
2433
- "helpGroup": "GLOBAL",
2434
- "name": "json",
2435
- "allowNo": false,
2436
- "type": "boolean"
2437
- },
2438
- "base-url": {
2439
- "description": "API base URL",
2440
- "env": "FACES_BASE_URL",
2441
- "name": "base-url",
2442
- "hasDynamicHelp": false,
2443
- "multiple": false,
2444
- "type": "option"
2445
- },
2446
- "token": {
2447
- "description": "JWT bearer token",
2448
- "env": "FACES_TOKEN",
2449
- "name": "token",
2450
- "hasDynamicHelp": false,
2451
- "multiple": false,
2452
- "type": "option"
2453
2306
  },
2454
- "api-key": {
2455
- "description": "API key",
2456
- "env": "FACES_API_KEY",
2457
- "name": "api-key",
2307
+ "name": {
2308
+ "description": "Display name",
2309
+ "name": "name",
2310
+ "required": true,
2458
2311
  "hasDynamicHelp": false,
2459
2312
  "multiple": false,
2460
2313
  "type": "option"
2461
2314
  },
2462
- "name": {
2463
- "description": "New display name",
2464
- "name": "name",
2315
+ "alias": {
2316
+ "description": "Unique alias slug",
2317
+ "name": "alias",
2318
+ "required": true,
2465
2319
  "hasDynamicHelp": false,
2466
2320
  "multiple": false,
2467
2321
  "type": "option"
@@ -2481,21 +2335,21 @@
2481
2335
  "type": "option"
2482
2336
  },
2483
2337
  "formula": {
2484
- "description": "New boolean formula (synthetic faces only)",
2338
+ "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
2485
2339
  "name": "formula",
2486
2340
  "hasDynamicHelp": false,
2487
2341
  "multiple": false,
2488
2342
  "type": "option"
2489
2343
  },
2490
2344
  "attr": {
2491
- "description": "Update attribute KEY=VALUE (repeatable)",
2345
+ "description": "Attribute KEY=VALUE (repeatable)",
2492
2346
  "name": "attr",
2493
2347
  "hasDynamicHelp": false,
2494
2348
  "multiple": true,
2495
2349
  "type": "option"
2496
2350
  },
2497
2351
  "tool": {
2498
- "description": "Tool names to set (replaces list, repeatable)",
2352
+ "description": "Tool name to enable (repeatable)",
2499
2353
  "name": "tool",
2500
2354
  "hasDynamicHelp": false,
2501
2355
  "multiple": true,
@@ -2504,7 +2358,7 @@
2504
2358
  },
2505
2359
  "hasDynamicHelp": false,
2506
2360
  "hiddenAliases": [],
2507
- "id": "face:update",
2361
+ "id": "face:create",
2508
2362
  "pluginAlias": "faces-cli",
2509
2363
  "pluginName": "faces-cli",
2510
2364
  "pluginType": "core",
@@ -2515,10 +2369,10 @@
2515
2369
  "dist",
2516
2370
  "commands",
2517
2371
  "face",
2518
- "update.js"
2372
+ "create.js"
2519
2373
  ]
2520
2374
  },
2521
- "face:upload": {
2375
+ "face:delete": {
2522
2376
  "aliases": [],
2523
2377
  "args": {
2524
2378
  "face_id": {
@@ -2527,7 +2381,7 @@
2527
2381
  "required": true
2528
2382
  }
2529
2383
  },
2530
- "description": "Upload a file (text/PDF/audio/video) to a face",
2384
+ "description": "Delete a face permanently",
2531
2385
  "flags": {
2532
2386
  "json": {
2533
2387
  "description": "Format output as json.",
@@ -2560,49 +2414,16 @@
2560
2414
  "multiple": false,
2561
2415
  "type": "option"
2562
2416
  },
2563
- "file": {
2564
- "description": "File to upload",
2565
- "name": "file",
2566
- "required": true,
2567
- "hasDynamicHelp": false,
2568
- "multiple": false,
2569
- "type": "option"
2570
- },
2571
- "kind": {
2572
- "description": "Upload kind: document or thread",
2573
- "name": "kind",
2574
- "default": "document",
2575
- "hasDynamicHelp": false,
2576
- "multiple": false,
2577
- "options": [
2578
- "document",
2579
- "thread"
2580
- ],
2581
- "type": "option"
2582
- },
2583
- "perspective": {
2584
- "description": "Perspective (document only)",
2585
- "name": "perspective",
2586
- "default": "third-person",
2587
- "hasDynamicHelp": false,
2588
- "multiple": false,
2589
- "options": [
2590
- "first-person",
2591
- "third-person"
2592
- ],
2593
- "type": "option"
2594
- },
2595
- "face-speaker": {
2596
- "description": "Speaker name to map to the face (thread only). If omitted, first speaker is used.",
2597
- "name": "face-speaker",
2598
- "hasDynamicHelp": false,
2599
- "multiple": false,
2600
- "type": "option"
2417
+ "yes": {
2418
+ "description": "Skip confirmation",
2419
+ "name": "yes",
2420
+ "allowNo": false,
2421
+ "type": "boolean"
2601
2422
  }
2602
2423
  },
2603
2424
  "hasDynamicHelp": false,
2604
2425
  "hiddenAliases": [],
2605
- "id": "face:upload",
2426
+ "id": "face:delete",
2606
2427
  "pluginAlias": "faces-cli",
2607
2428
  "pluginName": "faces-cli",
2608
2429
  "pluginType": "core",
@@ -2613,13 +2434,13 @@
2613
2434
  "dist",
2614
2435
  "commands",
2615
2436
  "face",
2616
- "upload.js"
2437
+ "delete.js"
2617
2438
  ]
2618
2439
  },
2619
- "keys:create": {
2440
+ "face:diff": {
2620
2441
  "aliases": [],
2621
2442
  "args": {},
2622
- "description": "Create a new API key (JWT required)",
2443
+ "description": "Compare owned faces pairwise across all centroid components",
2623
2444
  "flags": {
2624
2445
  "json": {
2625
2446
  "description": "Format output as json.",
@@ -2652,38 +2473,10 @@
2652
2473
  "multiple": false,
2653
2474
  "type": "option"
2654
2475
  },
2655
- "name": {
2656
- "description": "Key name/label",
2657
- "name": "name",
2658
- "required": true,
2659
- "hasDynamicHelp": false,
2660
- "multiple": false,
2661
- "type": "option"
2662
- },
2663
- "expires-days": {
2664
- "description": "Expiry in days (omit for no expiry)",
2665
- "name": "expires-days",
2666
- "hasDynamicHelp": false,
2667
- "multiple": false,
2668
- "type": "option"
2669
- },
2670
- "budget": {
2671
- "description": "Spend budget in USD",
2672
- "name": "budget",
2673
- "hasDynamicHelp": false,
2674
- "multiple": false,
2675
- "type": "option"
2676
- },
2677
2476
  "face": {
2678
- "description": "Allowed face alias (repeatable)",
2477
+ "description": "Face alias to include (repeatable, min 2)",
2679
2478
  "name": "face",
2680
- "hasDynamicHelp": false,
2681
- "multiple": true,
2682
- "type": "option"
2683
- },
2684
- "model": {
2685
- "description": "Allowed model name (repeatable)",
2686
- "name": "model",
2479
+ "required": true,
2687
2480
  "hasDynamicHelp": false,
2688
2481
  "multiple": true,
2689
2482
  "type": "option"
@@ -2691,7 +2484,7 @@
2691
2484
  },
2692
2485
  "hasDynamicHelp": false,
2693
2486
  "hiddenAliases": [],
2694
- "id": "keys:create",
2487
+ "id": "face:diff",
2695
2488
  "pluginAlias": "faces-cli",
2696
2489
  "pluginName": "faces-cli",
2697
2490
  "pluginType": "core",
@@ -2701,14 +2494,20 @@
2701
2494
  "relativePath": [
2702
2495
  "dist",
2703
2496
  "commands",
2704
- "keys",
2705
- "create.js"
2497
+ "face",
2498
+ "diff.js"
2706
2499
  ]
2707
2500
  },
2708
- "keys:list": {
2501
+ "face:get": {
2709
2502
  "aliases": [],
2710
- "args": {},
2711
- "description": "List all API keys (JWT required)",
2503
+ "args": {
2504
+ "face_id": {
2505
+ "description": "Face alias",
2506
+ "name": "face_id",
2507
+ "required": true
2508
+ }
2509
+ },
2510
+ "description": "Get details for a face by alias",
2712
2511
  "flags": {
2713
2512
  "json": {
2714
2513
  "description": "Format output as json.",
@@ -2744,7 +2543,7 @@
2744
2543
  },
2745
2544
  "hasDynamicHelp": false,
2746
2545
  "hiddenAliases": [],
2747
- "id": "keys:list",
2546
+ "id": "face:get",
2748
2547
  "pluginAlias": "faces-cli",
2749
2548
  "pluginName": "faces-cli",
2750
2549
  "pluginType": "core",
@@ -2754,20 +2553,14 @@
2754
2553
  "relativePath": [
2755
2554
  "dist",
2756
2555
  "commands",
2757
- "keys",
2758
- "list.js"
2556
+ "face",
2557
+ "get.js"
2759
2558
  ]
2760
2559
  },
2761
- "keys:revoke": {
2560
+ "face:list": {
2762
2561
  "aliases": [],
2763
- "args": {
2764
- "key_id": {
2765
- "description": "Key ID",
2766
- "name": "key_id",
2767
- "required": true
2768
- }
2769
- },
2770
- "description": "Revoke an API key (JWT required)",
2562
+ "args": {},
2563
+ "description": "List all owned faces",
2771
2564
  "flags": {
2772
2565
  "json": {
2773
2566
  "description": "Format output as json.",
@@ -2799,17 +2592,11 @@
2799
2592
  "hasDynamicHelp": false,
2800
2593
  "multiple": false,
2801
2594
  "type": "option"
2802
- },
2803
- "yes": {
2804
- "description": "Skip confirmation",
2805
- "name": "yes",
2806
- "allowNo": false,
2807
- "type": "boolean"
2808
2595
  }
2809
2596
  },
2810
2597
  "hasDynamicHelp": false,
2811
2598
  "hiddenAliases": [],
2812
- "id": "keys:revoke",
2599
+ "id": "face:list",
2813
2600
  "pluginAlias": "faces-cli",
2814
2601
  "pluginName": "faces-cli",
2815
2602
  "pluginType": "core",
@@ -2819,20 +2606,20 @@
2819
2606
  "relativePath": [
2820
2607
  "dist",
2821
2608
  "commands",
2822
- "keys",
2823
- "revoke.js"
2609
+ "face",
2610
+ "list.js"
2824
2611
  ]
2825
2612
  },
2826
- "keys:update": {
2613
+ "face:neighbors": {
2827
2614
  "aliases": [],
2828
2615
  "args": {
2829
- "key_id": {
2830
- "description": "Key ID",
2831
- "name": "key_id",
2616
+ "face_id": {
2617
+ "description": "Face alias",
2618
+ "name": "face_id",
2832
2619
  "required": true
2833
2620
  }
2834
2621
  },
2835
- "description": "Update API key metadata (JWT required)",
2622
+ "description": "Find the most similar or dissimilar owned faces to a given face",
2836
2623
  "flags": {
2837
2624
  "json": {
2838
2625
  "description": "Format output as json.",
@@ -2865,30 +2652,97 @@
2865
2652
  "multiple": false,
2866
2653
  "type": "option"
2867
2654
  },
2868
- "name": {
2869
- "description": "New key name",
2870
- "name": "name",
2655
+ "k": {
2656
+ "description": "Number of results (1–20)",
2657
+ "name": "k",
2658
+ "default": 5,
2871
2659
  "hasDynamicHelp": false,
2872
2660
  "multiple": false,
2873
2661
  "type": "option"
2874
2662
  },
2875
- "budget": {
2876
- "description": "New spend budget in USD",
2877
- "name": "budget",
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",
2878
2667
  "hasDynamicHelp": false,
2879
2668
  "multiple": false,
2880
- "type": "option"
2881
- },
2882
- "reset-spent": {
2883
- "description": "Reset spent amount to zero",
2884
- "name": "reset-spent",
2669
+ "options": [
2670
+ "face",
2671
+ "beta",
2672
+ "delta",
2673
+ "epsilon"
2674
+ ],
2675
+ "type": "option"
2676
+ },
2677
+ "direction": {
2678
+ "description": "nearest (most similar) or furthest (most dissimilar)",
2679
+ "name": "direction",
2680
+ "default": "nearest",
2681
+ "hasDynamicHelp": false,
2682
+ "multiple": false,
2683
+ "options": [
2684
+ "nearest",
2685
+ "furthest"
2686
+ ],
2687
+ "type": "option"
2688
+ }
2689
+ },
2690
+ "hasDynamicHelp": false,
2691
+ "hiddenAliases": [],
2692
+ "id": "face:neighbors",
2693
+ "pluginAlias": "faces-cli",
2694
+ "pluginName": "faces-cli",
2695
+ "pluginType": "core",
2696
+ "strict": true,
2697
+ "enableJsonFlag": true,
2698
+ "isESM": true,
2699
+ "relativePath": [
2700
+ "dist",
2701
+ "commands",
2702
+ "face",
2703
+ "neighbors.js"
2704
+ ]
2705
+ },
2706
+ "face:stats": {
2707
+ "aliases": [],
2708
+ "args": {},
2709
+ "description": "Compile and chat stats for all owned faces",
2710
+ "flags": {
2711
+ "json": {
2712
+ "description": "Format output as json.",
2713
+ "helpGroup": "GLOBAL",
2714
+ "name": "json",
2885
2715
  "allowNo": false,
2886
2716
  "type": "boolean"
2717
+ },
2718
+ "base-url": {
2719
+ "description": "API base URL",
2720
+ "env": "FACES_BASE_URL",
2721
+ "name": "base-url",
2722
+ "hasDynamicHelp": false,
2723
+ "multiple": false,
2724
+ "type": "option"
2725
+ },
2726
+ "token": {
2727
+ "description": "JWT bearer token",
2728
+ "env": "FACES_TOKEN",
2729
+ "name": "token",
2730
+ "hasDynamicHelp": false,
2731
+ "multiple": false,
2732
+ "type": "option"
2733
+ },
2734
+ "api-key": {
2735
+ "description": "API key",
2736
+ "env": "FACES_API_KEY",
2737
+ "name": "api-key",
2738
+ "hasDynamicHelp": false,
2739
+ "multiple": false,
2740
+ "type": "option"
2887
2741
  }
2888
2742
  },
2889
2743
  "hasDynamicHelp": false,
2890
2744
  "hiddenAliases": [],
2891
- "id": "keys:update",
2745
+ "id": "face:stats",
2892
2746
  "pluginAlias": "faces-cli",
2893
2747
  "pluginName": "faces-cli",
2894
2748
  "pluginType": "core",
@@ -2898,11 +2752,11 @@
2898
2752
  "relativePath": [
2899
2753
  "dist",
2900
2754
  "commands",
2901
- "keys",
2902
- "update.js"
2755
+ "face",
2756
+ "stats.js"
2903
2757
  ]
2904
2758
  },
2905
- "compile:doc:create": {
2759
+ "face:update": {
2906
2760
  "aliases": [],
2907
2761
  "args": {
2908
2762
  "face_id": {
@@ -2911,7 +2765,7 @@
2911
2765
  "required": true
2912
2766
  }
2913
2767
  },
2914
- "description": "Submit a document to a face",
2768
+ "description": "Update a face's metadata",
2915
2769
  "flags": {
2916
2770
  "json": {
2917
2771
  "description": "Format output as json.",
@@ -2944,31 +2798,131 @@
2944
2798
  "multiple": false,
2945
2799
  "type": "option"
2946
2800
  },
2947
- "label": {
2948
- "description": "Document label/title",
2949
- "name": "label",
2801
+ "name": {
2802
+ "description": "New display name",
2803
+ "name": "name",
2950
2804
  "hasDynamicHelp": false,
2951
2805
  "multiple": false,
2952
2806
  "type": "option"
2953
2807
  },
2954
- "content": {
2955
- "description": "Inline text content",
2956
- "name": "content",
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"
2842
+ }
2843
+ },
2844
+ "hasDynamicHelp": false,
2845
+ "hiddenAliases": [],
2846
+ "id": "face:update",
2847
+ "pluginAlias": "faces-cli",
2848
+ "pluginName": "faces-cli",
2849
+ "pluginType": "core",
2850
+ "strict": true,
2851
+ "enableJsonFlag": true,
2852
+ "isESM": true,
2853
+ "relativePath": [
2854
+ "dist",
2855
+ "commands",
2856
+ "face",
2857
+ "update.js"
2858
+ ]
2859
+ },
2860
+ "face:upload": {
2861
+ "aliases": [],
2862
+ "args": {
2863
+ "face_id": {
2864
+ "description": "Face alias",
2865
+ "name": "face_id",
2866
+ "required": true
2867
+ }
2868
+ },
2869
+ "description": "Upload a file (text/PDF/audio/video) to a face",
2870
+ "flags": {
2871
+ "json": {
2872
+ "description": "Format output as json.",
2873
+ "helpGroup": "GLOBAL",
2874
+ "name": "json",
2875
+ "allowNo": false,
2876
+ "type": "boolean"
2877
+ },
2878
+ "base-url": {
2879
+ "description": "API base URL",
2880
+ "env": "FACES_BASE_URL",
2881
+ "name": "base-url",
2882
+ "hasDynamicHelp": false,
2883
+ "multiple": false,
2884
+ "type": "option"
2885
+ },
2886
+ "token": {
2887
+ "description": "JWT bearer token",
2888
+ "env": "FACES_TOKEN",
2889
+ "name": "token",
2890
+ "hasDynamicHelp": false,
2891
+ "multiple": false,
2892
+ "type": "option"
2893
+ },
2894
+ "api-key": {
2895
+ "description": "API key",
2896
+ "env": "FACES_API_KEY",
2897
+ "name": "api-key",
2957
2898
  "hasDynamicHelp": false,
2958
2899
  "multiple": false,
2959
2900
  "type": "option"
2960
2901
  },
2961
2902
  "file": {
2962
- "description": "Read content from file",
2903
+ "description": "File to upload",
2963
2904
  "name": "file",
2905
+ "required": true,
2964
2906
  "hasDynamicHelp": false,
2965
2907
  "multiple": false,
2966
2908
  "type": "option"
2967
2909
  },
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
+ },
2968
2922
  "perspective": {
2969
- "description": "Perspective (first-person or third-person)",
2923
+ "description": "Perspective (document only)",
2970
2924
  "name": "perspective",
2971
- "default": "first-person",
2925
+ "default": "third-person",
2972
2926
  "hasDynamicHelp": false,
2973
2927
  "multiple": false,
2974
2928
  "options": [
@@ -2976,11 +2930,84 @@
2976
2930
  "third-person"
2977
2931
  ],
2978
2932
  "type": "option"
2933
+ },
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"
2979
2940
  }
2980
2941
  },
2981
2942
  "hasDynamicHelp": false,
2982
2943
  "hiddenAliases": [],
2983
- "id": "compile:doc:create",
2944
+ "id": "face:upload",
2945
+ "pluginAlias": "faces-cli",
2946
+ "pluginName": "faces-cli",
2947
+ "pluginType": "core",
2948
+ "strict": true,
2949
+ "enableJsonFlag": true,
2950
+ "isESM": true,
2951
+ "relativePath": [
2952
+ "dist",
2953
+ "commands",
2954
+ "face",
2955
+ "upload.js"
2956
+ ]
2957
+ },
2958
+ "compile:thread:create": {
2959
+ "aliases": [],
2960
+ "args": {
2961
+ "face_id": {
2962
+ "description": "Face alias",
2963
+ "name": "face_id",
2964
+ "required": true
2965
+ }
2966
+ },
2967
+ "description": "Start a new thread for a face",
2968
+ "flags": {
2969
+ "json": {
2970
+ "description": "Format output as json.",
2971
+ "helpGroup": "GLOBAL",
2972
+ "name": "json",
2973
+ "allowNo": false,
2974
+ "type": "boolean"
2975
+ },
2976
+ "base-url": {
2977
+ "description": "API base URL",
2978
+ "env": "FACES_BASE_URL",
2979
+ "name": "base-url",
2980
+ "hasDynamicHelp": false,
2981
+ "multiple": false,
2982
+ "type": "option"
2983
+ },
2984
+ "token": {
2985
+ "description": "JWT bearer token",
2986
+ "env": "FACES_TOKEN",
2987
+ "name": "token",
2988
+ "hasDynamicHelp": false,
2989
+ "multiple": false,
2990
+ "type": "option"
2991
+ },
2992
+ "api-key": {
2993
+ "description": "API key",
2994
+ "env": "FACES_API_KEY",
2995
+ "name": "api-key",
2996
+ "hasDynamicHelp": false,
2997
+ "multiple": false,
2998
+ "type": "option"
2999
+ },
3000
+ "label": {
3001
+ "description": "Thread label",
3002
+ "name": "label",
3003
+ "hasDynamicHelp": false,
3004
+ "multiple": false,
3005
+ "type": "option"
3006
+ }
3007
+ },
3008
+ "hasDynamicHelp": false,
3009
+ "hiddenAliases": [],
3010
+ "id": "compile:thread:create",
2984
3011
  "pluginAlias": "faces-cli",
2985
3012
  "pluginName": "faces-cli",
2986
3013
  "pluginType": "core",
@@ -2991,20 +3018,20 @@
2991
3018
  "dist",
2992
3019
  "commands",
2993
3020
  "compile",
2994
- "doc",
3021
+ "thread",
2995
3022
  "create.js"
2996
3023
  ]
2997
3024
  },
2998
- "compile:doc:delete": {
3025
+ "compile:thread:delete": {
2999
3026
  "aliases": [],
3000
3027
  "args": {
3001
- "doc_id": {
3002
- "description": "Document ID",
3003
- "name": "doc_id",
3028
+ "thread_id": {
3029
+ "description": "Thread ID",
3030
+ "name": "thread_id",
3004
3031
  "required": true
3005
3032
  }
3006
3033
  },
3007
- "description": "Delete a document",
3034
+ "description": "Delete a thread",
3008
3035
  "flags": {
3009
3036
  "json": {
3010
3037
  "description": "Format output as json.",
@@ -3036,11 +3063,91 @@
3036
3063
  "hasDynamicHelp": false,
3037
3064
  "multiple": false,
3038
3065
  "type": "option"
3066
+ },
3067
+ "yes": {
3068
+ "description": "Skip confirmation",
3069
+ "name": "yes",
3070
+ "allowNo": false,
3071
+ "type": "boolean"
3072
+ }
3073
+ },
3074
+ "hasDynamicHelp": false,
3075
+ "hiddenAliases": [],
3076
+ "id": "compile:thread:delete",
3077
+ "pluginAlias": "faces-cli",
3078
+ "pluginName": "faces-cli",
3079
+ "pluginType": "core",
3080
+ "strict": true,
3081
+ "enableJsonFlag": true,
3082
+ "isESM": true,
3083
+ "relativePath": [
3084
+ "dist",
3085
+ "commands",
3086
+ "compile",
3087
+ "thread",
3088
+ "delete.js"
3089
+ ]
3090
+ },
3091
+ "compile:thread:edit": {
3092
+ "aliases": [],
3093
+ "args": {
3094
+ "thread_id": {
3095
+ "description": "Thread ID",
3096
+ "name": "thread_id",
3097
+ "required": true
3098
+ }
3099
+ },
3100
+ "description": "Edit a thread (label and/or reassign face speaker)",
3101
+ "flags": {
3102
+ "json": {
3103
+ "description": "Format output as json.",
3104
+ "helpGroup": "GLOBAL",
3105
+ "name": "json",
3106
+ "allowNo": false,
3107
+ "type": "boolean"
3108
+ },
3109
+ "base-url": {
3110
+ "description": "API base URL",
3111
+ "env": "FACES_BASE_URL",
3112
+ "name": "base-url",
3113
+ "hasDynamicHelp": false,
3114
+ "multiple": false,
3115
+ "type": "option"
3116
+ },
3117
+ "token": {
3118
+ "description": "JWT bearer token",
3119
+ "env": "FACES_TOKEN",
3120
+ "name": "token",
3121
+ "hasDynamicHelp": false,
3122
+ "multiple": false,
3123
+ "type": "option"
3124
+ },
3125
+ "api-key": {
3126
+ "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",
3143
+ "hasDynamicHelp": false,
3144
+ "multiple": false,
3145
+ "type": "option"
3039
3146
  }
3040
3147
  },
3041
3148
  "hasDynamicHelp": false,
3042
3149
  "hiddenAliases": [],
3043
- "id": "compile:doc:delete",
3150
+ "id": "compile:thread:edit",
3044
3151
  "pluginAlias": "faces-cli",
3045
3152
  "pluginName": "faces-cli",
3046
3153
  "pluginType": "core",
@@ -3051,20 +3158,20 @@
3051
3158
  "dist",
3052
3159
  "commands",
3053
3160
  "compile",
3054
- "doc",
3055
- "delete.js"
3161
+ "thread",
3162
+ "edit.js"
3056
3163
  ]
3057
3164
  },
3058
- "compile:doc:edit": {
3165
+ "compile:thread:get": {
3059
3166
  "aliases": [],
3060
3167
  "args": {
3061
- "doc_id": {
3062
- "description": "Document ID",
3063
- "name": "doc_id",
3168
+ "thread_id": {
3169
+ "description": "Thread ID",
3170
+ "name": "thread_id",
3064
3171
  "required": true
3065
3172
  }
3066
3173
  },
3067
- "description": "Edit a document (label, content, or perspective)",
3174
+ "description": "Get a thread by ID",
3068
3175
  "flags": {
3069
3176
  "json": {
3070
3177
  "description": "Format output as json.",
@@ -3096,43 +3203,11 @@
3096
3203
  "hasDynamicHelp": false,
3097
3204
  "multiple": false,
3098
3205
  "type": "option"
3099
- },
3100
- "label": {
3101
- "description": "New label/title",
3102
- "name": "label",
3103
- "hasDynamicHelp": false,
3104
- "multiple": false,
3105
- "type": "option"
3106
- },
3107
- "content": {
3108
- "description": "New inline text content",
3109
- "name": "content",
3110
- "hasDynamicHelp": false,
3111
- "multiple": false,
3112
- "type": "option"
3113
- },
3114
- "file": {
3115
- "description": "Read new content from file",
3116
- "name": "file",
3117
- "hasDynamicHelp": false,
3118
- "multiple": false,
3119
- "type": "option"
3120
- },
3121
- "perspective": {
3122
- "description": "Perspective (first-person or third-person)",
3123
- "name": "perspective",
3124
- "hasDynamicHelp": false,
3125
- "multiple": false,
3126
- "options": [
3127
- "first-person",
3128
- "third-person"
3129
- ],
3130
- "type": "option"
3131
3206
  }
3132
3207
  },
3133
3208
  "hasDynamicHelp": false,
3134
3209
  "hiddenAliases": [],
3135
- "id": "compile:doc:edit",
3210
+ "id": "compile:thread:get",
3136
3211
  "pluginAlias": "faces-cli",
3137
3212
  "pluginName": "faces-cli",
3138
3213
  "pluginType": "core",
@@ -3143,20 +3218,20 @@
3143
3218
  "dist",
3144
3219
  "commands",
3145
3220
  "compile",
3146
- "doc",
3147
- "edit.js"
3221
+ "thread",
3222
+ "get.js"
3148
3223
  ]
3149
3224
  },
3150
- "compile:doc:get": {
3225
+ "compile:thread:list": {
3151
3226
  "aliases": [],
3152
3227
  "args": {
3153
- "doc_id": {
3154
- "description": "Document ID",
3155
- "name": "doc_id",
3228
+ "face_id": {
3229
+ "description": "Face alias",
3230
+ "name": "face_id",
3156
3231
  "required": true
3157
3232
  }
3158
3233
  },
3159
- "description": "Get a document by ID",
3234
+ "description": "List threads for a face",
3160
3235
  "flags": {
3161
3236
  "json": {
3162
3237
  "description": "Format output as json.",
@@ -3192,7 +3267,7 @@
3192
3267
  },
3193
3268
  "hasDynamicHelp": false,
3194
3269
  "hiddenAliases": [],
3195
- "id": "compile:doc:get",
3270
+ "id": "compile:thread:list",
3196
3271
  "pluginAlias": "faces-cli",
3197
3272
  "pluginName": "faces-cli",
3198
3273
  "pluginType": "core",
@@ -3203,20 +3278,20 @@
3203
3278
  "dist",
3204
3279
  "commands",
3205
3280
  "compile",
3206
- "doc",
3207
- "get.js"
3281
+ "thread",
3282
+ "list.js"
3208
3283
  ]
3209
3284
  },
3210
- "compile:doc": {
3285
+ "compile:thread:make": {
3211
3286
  "aliases": [],
3212
3287
  "args": {
3213
- "face_id": {
3214
- "description": "Face alias",
3215
- "name": "face_id",
3288
+ "thread_id": {
3289
+ "description": "Thread ID",
3290
+ "name": "thread_id",
3216
3291
  "required": true
3217
3292
  }
3218
3293
  },
3219
- "description": "Compile a document into a face (create → make in one step)",
3294
+ "description": "Compile an existing thread (prepare + sync in one step)",
3220
3295
  "flags": {
3221
3296
  "json": {
3222
3297
  "description": "Format output as json.",
@@ -3249,39 +3324,6 @@
3249
3324
  "multiple": false,
3250
3325
  "type": "option"
3251
3326
  },
3252
- "label": {
3253
- "description": "Document label/title",
3254
- "name": "label",
3255
- "hasDynamicHelp": false,
3256
- "multiple": false,
3257
- "type": "option"
3258
- },
3259
- "content": {
3260
- "description": "Inline text content",
3261
- "name": "content",
3262
- "hasDynamicHelp": false,
3263
- "multiple": false,
3264
- "type": "option"
3265
- },
3266
- "file": {
3267
- "description": "Read content from file",
3268
- "name": "file",
3269
- "hasDynamicHelp": false,
3270
- "multiple": false,
3271
- "type": "option"
3272
- },
3273
- "perspective": {
3274
- "description": "Perspective",
3275
- "name": "perspective",
3276
- "default": "first-person",
3277
- "hasDynamicHelp": false,
3278
- "multiple": false,
3279
- "options": [
3280
- "first-person",
3281
- "third-person"
3282
- ],
3283
- "type": "option"
3284
- },
3285
3327
  "timeout": {
3286
3328
  "description": "Compile timeout in seconds (default: 600)",
3287
3329
  "name": "timeout",
@@ -3291,7 +3333,7 @@
3291
3333
  "type": "option"
3292
3334
  },
3293
3335
  "no-wait": {
3294
- "description": "Create and trigger compilation, then return immediately without polling.",
3336
+ "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
3295
3337
  "name": "no-wait",
3296
3338
  "allowNo": false,
3297
3339
  "type": "boolean"
@@ -3299,7 +3341,7 @@
3299
3341
  },
3300
3342
  "hasDynamicHelp": false,
3301
3343
  "hiddenAliases": [],
3302
- "id": "compile:doc",
3344
+ "id": "compile:thread:make",
3303
3345
  "pluginAlias": "faces-cli",
3304
3346
  "pluginName": "faces-cli",
3305
3347
  "pluginType": "core",
@@ -3310,20 +3352,20 @@
3310
3352
  "dist",
3311
3353
  "commands",
3312
3354
  "compile",
3313
- "doc",
3314
- "index.js"
3355
+ "thread",
3356
+ "make.js"
3315
3357
  ]
3316
3358
  },
3317
- "compile:doc:list": {
3359
+ "compile:thread:message": {
3318
3360
  "aliases": [],
3319
3361
  "args": {
3320
- "face_id": {
3321
- "description": "Face alias",
3322
- "name": "face_id",
3362
+ "thread_id": {
3363
+ "description": "Thread ID",
3364
+ "name": "thread_id",
3323
3365
  "required": true
3324
3366
  }
3325
3367
  },
3326
- "description": "List documents for a face",
3368
+ "description": "Send a user message to a thread",
3327
3369
  "flags": {
3328
3370
  "json": {
3329
3371
  "description": "Format output as json.",
@@ -3355,11 +3397,20 @@
3355
3397
  "hasDynamicHelp": false,
3356
3398
  "multiple": false,
3357
3399
  "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"
3358
3409
  }
3359
3410
  },
3360
3411
  "hasDynamicHelp": false,
3361
3412
  "hiddenAliases": [],
3362
- "id": "compile:doc:list",
3413
+ "id": "compile:thread:message",
3363
3414
  "pluginAlias": "faces-cli",
3364
3415
  "pluginName": "faces-cli",
3365
3416
  "pluginType": "core",
@@ -3370,20 +3421,20 @@
3370
3421
  "dist",
3371
3422
  "commands",
3372
3423
  "compile",
3373
- "doc",
3374
- "list.js"
3424
+ "thread",
3425
+ "message.js"
3375
3426
  ]
3376
3427
  },
3377
- "compile:doc:make": {
3428
+ "compile:thread:pause": {
3378
3429
  "aliases": [],
3379
3430
  "args": {
3380
- "doc_id": {
3381
- "description": "Document ID",
3382
- "name": "doc_id",
3431
+ "thread_id": {
3432
+ "description": "Thread ID",
3433
+ "name": "thread_id",
3383
3434
  "required": true
3384
3435
  }
3385
3436
  },
3386
- "description": "Compile an existing document (prepare + sync in one step)",
3437
+ "description": "Pause a running thread compilation (preserves progress, resume with make)",
3387
3438
  "flags": {
3388
3439
  "json": {
3389
3440
  "description": "Format output as json.",
@@ -3415,25 +3466,11 @@
3415
3466
  "hasDynamicHelp": false,
3416
3467
  "multiple": false,
3417
3468
  "type": "option"
3418
- },
3419
- "timeout": {
3420
- "description": "Compile timeout in seconds (default: 600)",
3421
- "name": "timeout",
3422
- "default": 600,
3423
- "hasDynamicHelp": false,
3424
- "multiple": false,
3425
- "type": "option"
3426
- },
3427
- "no-wait": {
3428
- "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
3429
- "name": "no-wait",
3430
- "allowNo": false,
3431
- "type": "boolean"
3432
3469
  }
3433
3470
  },
3434
3471
  "hasDynamicHelp": false,
3435
3472
  "hiddenAliases": [],
3436
- "id": "compile:doc:make",
3473
+ "id": "compile:thread:pause",
3437
3474
  "pluginAlias": "faces-cli",
3438
3475
  "pluginName": "faces-cli",
3439
3476
  "pluginType": "core",
@@ -3444,20 +3481,20 @@
3444
3481
  "dist",
3445
3482
  "commands",
3446
3483
  "compile",
3447
- "doc",
3448
- "make.js"
3484
+ "thread",
3485
+ "pause.js"
3449
3486
  ]
3450
3487
  },
3451
- "compile:doc:pause": {
3488
+ "compile:thread:reset": {
3452
3489
  "aliases": [],
3453
3490
  "args": {
3454
- "doc_id": {
3455
- "description": "Document ID",
3456
- "name": "doc_id",
3491
+ "thread_id": {
3492
+ "description": "Thread ID",
3493
+ "name": "thread_id",
3457
3494
  "required": true
3458
3495
  }
3459
3496
  },
3460
- "description": "Pause a running document compilation (preserves progress, resume with make)",
3497
+ "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
3461
3498
  "flags": {
3462
3499
  "json": {
3463
3500
  "description": "Format output as json.",
@@ -3489,11 +3526,17 @@
3489
3526
  "hasDynamicHelp": false,
3490
3527
  "multiple": false,
3491
3528
  "type": "option"
3529
+ },
3530
+ "yes": {
3531
+ "description": "Skip confirmation",
3532
+ "name": "yes",
3533
+ "allowNo": false,
3534
+ "type": "boolean"
3492
3535
  }
3493
3536
  },
3494
3537
  "hasDynamicHelp": false,
3495
3538
  "hiddenAliases": [],
3496
- "id": "compile:doc:pause",
3539
+ "id": "compile:thread:reset",
3497
3540
  "pluginAlias": "faces-cli",
3498
3541
  "pluginName": "faces-cli",
3499
3542
  "pluginType": "core",
@@ -3504,20 +3547,20 @@
3504
3547
  "dist",
3505
3548
  "commands",
3506
3549
  "compile",
3507
- "doc",
3508
- "pause.js"
3550
+ "thread",
3551
+ "reset.js"
3509
3552
  ]
3510
3553
  },
3511
- "compile:doc:reset": {
3554
+ "compile:thread:sync": {
3512
3555
  "aliases": [],
3513
3556
  "args": {
3514
- "doc_id": {
3515
- "description": "Document ID",
3516
- "name": "doc_id",
3557
+ "thread_id": {
3558
+ "description": "Thread ID",
3559
+ "name": "thread_id",
3517
3560
  "required": true
3518
3561
  }
3519
3562
  },
3520
- "description": "Reset document compilation progress (wipe extraction, keep content)",
3563
+ "description": "Archive and sync a thread into a face",
3521
3564
  "flags": {
3522
3565
  "json": {
3523
3566
  "description": "Format output as json.",
@@ -3549,17 +3592,11 @@
3549
3592
  "hasDynamicHelp": false,
3550
3593
  "multiple": false,
3551
3594
  "type": "option"
3552
- },
3553
- "yes": {
3554
- "description": "Skip confirmation",
3555
- "name": "yes",
3556
- "allowNo": false,
3557
- "type": "boolean"
3558
3595
  }
3559
3596
  },
3560
3597
  "hasDynamicHelp": false,
3561
3598
  "hiddenAliases": [],
3562
- "id": "compile:doc:reset",
3599
+ "id": "compile:thread:sync",
3563
3600
  "pluginAlias": "faces-cli",
3564
3601
  "pluginName": "faces-cli",
3565
3602
  "pluginType": "core",
@@ -3570,11 +3607,11 @@
3570
3607
  "dist",
3571
3608
  "commands",
3572
3609
  "compile",
3573
- "doc",
3574
- "reset.js"
3610
+ "thread",
3611
+ "sync.js"
3575
3612
  ]
3576
3613
  },
3577
- "compile:thread:create": {
3614
+ "compile:doc:create": {
3578
3615
  "aliases": [],
3579
3616
  "args": {
3580
3617
  "face_id": {
@@ -3583,7 +3620,7 @@
3583
3620
  "required": true
3584
3621
  }
3585
3622
  },
3586
- "description": "Start a new thread for a face",
3623
+ "description": "Submit a document to a face",
3587
3624
  "flags": {
3588
3625
  "json": {
3589
3626
  "description": "Format output as json.",
@@ -3617,16 +3654,42 @@
3617
3654
  "type": "option"
3618
3655
  },
3619
3656
  "label": {
3620
- "description": "Thread label",
3657
+ "description": "Document label/title",
3621
3658
  "name": "label",
3622
3659
  "hasDynamicHelp": false,
3623
3660
  "multiple": false,
3624
3661
  "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"
3625
3688
  }
3626
3689
  },
3627
3690
  "hasDynamicHelp": false,
3628
3691
  "hiddenAliases": [],
3629
- "id": "compile:thread:create",
3692
+ "id": "compile:doc:create",
3630
3693
  "pluginAlias": "faces-cli",
3631
3694
  "pluginName": "faces-cli",
3632
3695
  "pluginType": "core",
@@ -3637,20 +3700,20 @@
3637
3700
  "dist",
3638
3701
  "commands",
3639
3702
  "compile",
3640
- "thread",
3703
+ "doc",
3641
3704
  "create.js"
3642
3705
  ]
3643
3706
  },
3644
- "compile:thread:delete": {
3707
+ "compile:doc:delete": {
3645
3708
  "aliases": [],
3646
3709
  "args": {
3647
- "thread_id": {
3648
- "description": "Thread ID",
3649
- "name": "thread_id",
3710
+ "doc_id": {
3711
+ "description": "Document ID",
3712
+ "name": "doc_id",
3650
3713
  "required": true
3651
3714
  }
3652
3715
  },
3653
- "description": "Delete a thread",
3716
+ "description": "Delete a document",
3654
3717
  "flags": {
3655
3718
  "json": {
3656
3719
  "description": "Format output as json.",
@@ -3682,17 +3745,11 @@
3682
3745
  "hasDynamicHelp": false,
3683
3746
  "multiple": false,
3684
3747
  "type": "option"
3685
- },
3686
- "yes": {
3687
- "description": "Skip confirmation",
3688
- "name": "yes",
3689
- "allowNo": false,
3690
- "type": "boolean"
3691
3748
  }
3692
3749
  },
3693
3750
  "hasDynamicHelp": false,
3694
3751
  "hiddenAliases": [],
3695
- "id": "compile:thread:delete",
3752
+ "id": "compile:doc:delete",
3696
3753
  "pluginAlias": "faces-cli",
3697
3754
  "pluginName": "faces-cli",
3698
3755
  "pluginType": "core",
@@ -3703,20 +3760,20 @@
3703
3760
  "dist",
3704
3761
  "commands",
3705
3762
  "compile",
3706
- "thread",
3763
+ "doc",
3707
3764
  "delete.js"
3708
3765
  ]
3709
3766
  },
3710
- "compile:thread:edit": {
3767
+ "compile:doc:edit": {
3711
3768
  "aliases": [],
3712
3769
  "args": {
3713
- "thread_id": {
3714
- "description": "Thread ID",
3715
- "name": "thread_id",
3770
+ "doc_id": {
3771
+ "description": "Document ID",
3772
+ "name": "doc_id",
3716
3773
  "required": true
3717
3774
  }
3718
3775
  },
3719
- "description": "Edit a thread (label and/or reassign face speaker)",
3776
+ "description": "Edit a document (label, content, or perspective)",
3720
3777
  "flags": {
3721
3778
  "json": {
3722
3779
  "description": "Format output as json.",
@@ -3750,23 +3807,41 @@
3750
3807
  "type": "option"
3751
3808
  },
3752
3809
  "label": {
3753
- "description": "New thread label",
3810
+ "description": "New label/title",
3754
3811
  "name": "label",
3755
3812
  "hasDynamicHelp": false,
3756
3813
  "multiple": false,
3757
3814
  "type": "option"
3758
3815
  },
3759
- "face-speaker": {
3760
- "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
3761
- "name": "face-speaker",
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",
3762
3833
  "hasDynamicHelp": false,
3763
3834
  "multiple": false,
3835
+ "options": [
3836
+ "first-person",
3837
+ "third-person"
3838
+ ],
3764
3839
  "type": "option"
3765
3840
  }
3766
3841
  },
3767
3842
  "hasDynamicHelp": false,
3768
3843
  "hiddenAliases": [],
3769
- "id": "compile:thread:edit",
3844
+ "id": "compile:doc:edit",
3770
3845
  "pluginAlias": "faces-cli",
3771
3846
  "pluginName": "faces-cli",
3772
3847
  "pluginType": "core",
@@ -3777,20 +3852,20 @@
3777
3852
  "dist",
3778
3853
  "commands",
3779
3854
  "compile",
3780
- "thread",
3855
+ "doc",
3781
3856
  "edit.js"
3782
3857
  ]
3783
3858
  },
3784
- "compile:thread:get": {
3859
+ "compile:doc:get": {
3785
3860
  "aliases": [],
3786
3861
  "args": {
3787
- "thread_id": {
3788
- "description": "Thread ID",
3789
- "name": "thread_id",
3862
+ "doc_id": {
3863
+ "description": "Document ID",
3864
+ "name": "doc_id",
3790
3865
  "required": true
3791
3866
  }
3792
3867
  },
3793
- "description": "Get a thread by ID",
3868
+ "description": "Get a document by ID",
3794
3869
  "flags": {
3795
3870
  "json": {
3796
3871
  "description": "Format output as json.",
@@ -3826,7 +3901,7 @@
3826
3901
  },
3827
3902
  "hasDynamicHelp": false,
3828
3903
  "hiddenAliases": [],
3829
- "id": "compile:thread:get",
3904
+ "id": "compile:doc:get",
3830
3905
  "pluginAlias": "faces-cli",
3831
3906
  "pluginName": "faces-cli",
3832
3907
  "pluginType": "core",
@@ -3837,11 +3912,11 @@
3837
3912
  "dist",
3838
3913
  "commands",
3839
3914
  "compile",
3840
- "thread",
3915
+ "doc",
3841
3916
  "get.js"
3842
3917
  ]
3843
3918
  },
3844
- "compile:thread:list": {
3919
+ "compile:doc": {
3845
3920
  "aliases": [],
3846
3921
  "args": {
3847
3922
  "face_id": {
@@ -3850,7 +3925,7 @@
3850
3925
  "required": true
3851
3926
  }
3852
3927
  },
3853
- "description": "List threads for a face",
3928
+ "description": "Compile a document into a face (create → make in one step)",
3854
3929
  "flags": {
3855
3930
  "json": {
3856
3931
  "description": "Format output as json.",
@@ -3882,65 +3957,38 @@
3882
3957
  "hasDynamicHelp": false,
3883
3958
  "multiple": false,
3884
3959
  "type": "option"
3885
- }
3886
- },
3887
- "hasDynamicHelp": false,
3888
- "hiddenAliases": [],
3889
- "id": "compile:thread:list",
3890
- "pluginAlias": "faces-cli",
3891
- "pluginName": "faces-cli",
3892
- "pluginType": "core",
3893
- "strict": true,
3894
- "enableJsonFlag": true,
3895
- "isESM": true,
3896
- "relativePath": [
3897
- "dist",
3898
- "commands",
3899
- "compile",
3900
- "thread",
3901
- "list.js"
3902
- ]
3903
- },
3904
- "compile:thread:make": {
3905
- "aliases": [],
3906
- "args": {
3907
- "thread_id": {
3908
- "description": "Thread ID",
3909
- "name": "thread_id",
3910
- "required": true
3911
- }
3912
- },
3913
- "description": "Compile an existing thread (prepare + sync in one step)",
3914
- "flags": {
3915
- "json": {
3916
- "description": "Format output as json.",
3917
- "helpGroup": "GLOBAL",
3918
- "name": "json",
3919
- "allowNo": false,
3920
- "type": "boolean"
3921
3960
  },
3922
- "base-url": {
3923
- "description": "API base URL",
3924
- "env": "FACES_BASE_URL",
3925
- "name": "base-url",
3961
+ "label": {
3962
+ "description": "Document label/title",
3963
+ "name": "label",
3926
3964
  "hasDynamicHelp": false,
3927
3965
  "multiple": false,
3928
3966
  "type": "option"
3929
3967
  },
3930
- "token": {
3931
- "description": "JWT bearer token",
3932
- "env": "FACES_TOKEN",
3933
- "name": "token",
3968
+ "content": {
3969
+ "description": "Inline text content",
3970
+ "name": "content",
3934
3971
  "hasDynamicHelp": false,
3935
3972
  "multiple": false,
3936
3973
  "type": "option"
3937
3974
  },
3938
- "api-key": {
3939
- "description": "API key",
3940
- "env": "FACES_API_KEY",
3941
- "name": "api-key",
3975
+ "file": {
3976
+ "description": "Read content from file",
3977
+ "name": "file",
3978
+ "hasDynamicHelp": false,
3979
+ "multiple": false,
3980
+ "type": "option"
3981
+ },
3982
+ "perspective": {
3983
+ "description": "Perspective",
3984
+ "name": "perspective",
3985
+ "default": "first-person",
3942
3986
  "hasDynamicHelp": false,
3943
3987
  "multiple": false,
3988
+ "options": [
3989
+ "first-person",
3990
+ "third-person"
3991
+ ],
3944
3992
  "type": "option"
3945
3993
  },
3946
3994
  "timeout": {
@@ -3952,7 +4000,7 @@
3952
4000
  "type": "option"
3953
4001
  },
3954
4002
  "no-wait": {
3955
- "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
4003
+ "description": "Create and trigger compilation, then return immediately without polling.",
3956
4004
  "name": "no-wait",
3957
4005
  "allowNo": false,
3958
4006
  "type": "boolean"
@@ -3960,7 +4008,7 @@
3960
4008
  },
3961
4009
  "hasDynamicHelp": false,
3962
4010
  "hiddenAliases": [],
3963
- "id": "compile:thread:make",
4011
+ "id": "compile:doc",
3964
4012
  "pluginAlias": "faces-cli",
3965
4013
  "pluginName": "faces-cli",
3966
4014
  "pluginType": "core",
@@ -3971,20 +4019,20 @@
3971
4019
  "dist",
3972
4020
  "commands",
3973
4021
  "compile",
3974
- "thread",
3975
- "make.js"
4022
+ "doc",
4023
+ "index.js"
3976
4024
  ]
3977
4025
  },
3978
- "compile:thread:message": {
4026
+ "compile:doc:list": {
3979
4027
  "aliases": [],
3980
4028
  "args": {
3981
- "thread_id": {
3982
- "description": "Thread ID",
3983
- "name": "thread_id",
4029
+ "face_id": {
4030
+ "description": "Face alias",
4031
+ "name": "face_id",
3984
4032
  "required": true
3985
4033
  }
3986
4034
  },
3987
- "description": "Send a user message to a thread",
4035
+ "description": "List documents for a face",
3988
4036
  "flags": {
3989
4037
  "json": {
3990
4038
  "description": "Format output as json.",
@@ -4016,20 +4064,11 @@
4016
4064
  "hasDynamicHelp": false,
4017
4065
  "multiple": false,
4018
4066
  "type": "option"
4019
- },
4020
- "message": {
4021
- "char": "m",
4022
- "description": "User message to append",
4023
- "name": "message",
4024
- "required": true,
4025
- "hasDynamicHelp": false,
4026
- "multiple": false,
4027
- "type": "option"
4028
4067
  }
4029
4068
  },
4030
4069
  "hasDynamicHelp": false,
4031
4070
  "hiddenAliases": [],
4032
- "id": "compile:thread:message",
4071
+ "id": "compile:doc:list",
4033
4072
  "pluginAlias": "faces-cli",
4034
4073
  "pluginName": "faces-cli",
4035
4074
  "pluginType": "core",
@@ -4040,20 +4079,20 @@
4040
4079
  "dist",
4041
4080
  "commands",
4042
4081
  "compile",
4043
- "thread",
4044
- "message.js"
4082
+ "doc",
4083
+ "list.js"
4045
4084
  ]
4046
4085
  },
4047
- "compile:thread:pause": {
4086
+ "compile:doc:make": {
4048
4087
  "aliases": [],
4049
4088
  "args": {
4050
- "thread_id": {
4051
- "description": "Thread ID",
4052
- "name": "thread_id",
4089
+ "doc_id": {
4090
+ "description": "Document ID",
4091
+ "name": "doc_id",
4053
4092
  "required": true
4054
4093
  }
4055
4094
  },
4056
- "description": "Pause a running thread compilation (preserves progress, resume with make)",
4095
+ "description": "Compile an existing document (prepare + sync in one step)",
4057
4096
  "flags": {
4058
4097
  "json": {
4059
4098
  "description": "Format output as json.",
@@ -4085,11 +4124,25 @@
4085
4124
  "hasDynamicHelp": false,
4086
4125
  "multiple": false,
4087
4126
  "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"
4088
4141
  }
4089
4142
  },
4090
4143
  "hasDynamicHelp": false,
4091
4144
  "hiddenAliases": [],
4092
- "id": "compile:thread:pause",
4145
+ "id": "compile:doc:make",
4093
4146
  "pluginAlias": "faces-cli",
4094
4147
  "pluginName": "faces-cli",
4095
4148
  "pluginType": "core",
@@ -4100,20 +4153,20 @@
4100
4153
  "dist",
4101
4154
  "commands",
4102
4155
  "compile",
4103
- "thread",
4104
- "pause.js"
4156
+ "doc",
4157
+ "make.js"
4105
4158
  ]
4106
4159
  },
4107
- "compile:thread:reset": {
4160
+ "compile:doc:pause": {
4108
4161
  "aliases": [],
4109
4162
  "args": {
4110
- "thread_id": {
4111
- "description": "Thread ID",
4112
- "name": "thread_id",
4163
+ "doc_id": {
4164
+ "description": "Document ID",
4165
+ "name": "doc_id",
4113
4166
  "required": true
4114
4167
  }
4115
4168
  },
4116
- "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
4169
+ "description": "Pause a running document compilation (preserves progress, resume with make)",
4117
4170
  "flags": {
4118
4171
  "json": {
4119
4172
  "description": "Format output as json.",
@@ -4145,17 +4198,11 @@
4145
4198
  "hasDynamicHelp": false,
4146
4199
  "multiple": false,
4147
4200
  "type": "option"
4148
- },
4149
- "yes": {
4150
- "description": "Skip confirmation",
4151
- "name": "yes",
4152
- "allowNo": false,
4153
- "type": "boolean"
4154
4201
  }
4155
4202
  },
4156
4203
  "hasDynamicHelp": false,
4157
4204
  "hiddenAliases": [],
4158
- "id": "compile:thread:reset",
4205
+ "id": "compile:doc:pause",
4159
4206
  "pluginAlias": "faces-cli",
4160
4207
  "pluginName": "faces-cli",
4161
4208
  "pluginType": "core",
@@ -4166,20 +4213,20 @@
4166
4213
  "dist",
4167
4214
  "commands",
4168
4215
  "compile",
4169
- "thread",
4170
- "reset.js"
4216
+ "doc",
4217
+ "pause.js"
4171
4218
  ]
4172
4219
  },
4173
- "compile:thread:sync": {
4220
+ "compile:doc:reset": {
4174
4221
  "aliases": [],
4175
4222
  "args": {
4176
- "thread_id": {
4177
- "description": "Thread ID",
4178
- "name": "thread_id",
4223
+ "doc_id": {
4224
+ "description": "Document ID",
4225
+ "name": "doc_id",
4179
4226
  "required": true
4180
4227
  }
4181
4228
  },
4182
- "description": "Archive and sync a thread into a face",
4229
+ "description": "Reset document compilation progress (wipe extraction, keep content)",
4183
4230
  "flags": {
4184
4231
  "json": {
4185
4232
  "description": "Format output as json.",
@@ -4211,11 +4258,17 @@
4211
4258
  "hasDynamicHelp": false,
4212
4259
  "multiple": false,
4213
4260
  "type": "option"
4261
+ },
4262
+ "yes": {
4263
+ "description": "Skip confirmation",
4264
+ "name": "yes",
4265
+ "allowNo": false,
4266
+ "type": "boolean"
4214
4267
  }
4215
4268
  },
4216
4269
  "hasDynamicHelp": false,
4217
4270
  "hiddenAliases": [],
4218
- "id": "compile:thread:sync",
4271
+ "id": "compile:doc:reset",
4219
4272
  "pluginAlias": "faces-cli",
4220
4273
  "pluginName": "faces-cli",
4221
4274
  "pluginType": "core",
@@ -4226,10 +4279,10 @@
4226
4279
  "dist",
4227
4280
  "commands",
4228
4281
  "compile",
4229
- "thread",
4230
- "sync.js"
4282
+ "doc",
4283
+ "reset.js"
4231
4284
  ]
4232
4285
  }
4233
4286
  },
4234
- "version": "1.5.12"
4287
+ "version": "1.5.13"
4235
4288
  }