faces-cli 1.5.4 → 1.5.6

package/oclif.manifest.json

@@ -495,6 +495,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "plan": {
+          "description": "Plan to subscribe to: \"free\" ($5 activation) or \"connect\" ($17/mo, no activation fee)",
+          "name": "plan",
+          "default": "free",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "free",
+            "connect"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -1837,10 +1849,10 @@
         "show.js"
       ]
     },
-    "face:create": {
+    "keys:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a new face",
+      "description": "Create a new API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1874,52 +1886,37 @@
           "type": "option"
         },
         "name": {
-          "description": "Display name",
+          "description": "Key name/label",
           "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "alias": {
-          "description": "Unique alias slug",
-          "name": "alias",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Description for local catalog",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "default-model": {
-          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
-          "name": "default-model",
+        "expires-days": {
+          "description": "Expiry in days (omit for no expiry)",
+          "name": "expires-days",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "formula": {
-          "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
-          "name": "formula",
+        "budget": {
+          "description": "Spend budget in USD",
+          "name": "budget",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "attr": {
-          "description": "Attribute KEY=VALUE (repeatable)",
-          "name": "attr",
+        "face": {
+          "description": "Allowed face alias (repeatable)",
+          "name": "face",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "tool": {
-          "description": "Tool name to enable (repeatable)",
-          "name": "tool",
+        "model": {
+          "description": "Allowed model name (repeatable)",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
@@ -1927,7 +1924,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:create",
+      "id": "keys:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1937,20 +1934,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
+        "keys",
         "create.js"
       ]
     },
-    "face:delete": {
+    "keys:list": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Delete a face permanently",
+      "args": {},
+      "description": "List all API keys (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1982,17 +1973,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:delete",
+      "id": "keys:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2002,14 +1987,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "delete.js"
+        "keys",
+        "list.js"
       ]
     },
-    "face:diff": {
+    "keys:revoke": {
       "aliases": [],
-      "args": {},
-      "description": "Compare owned faces pairwise across all centroid components",
+      "args": {
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
+          "required": true
+        }
+      },
+      "description": "Revoke an API key (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2042,18 +2033,16 @@
           "multiple": false,
           "type": "option"
         },
-        "face": {
-          "description": "Face alias to include (repeatable, min 2)",
-          "name": "face",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:diff",
+      "id": "keys:revoke",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2063,20 +2052,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "diff.js"
+        "keys",
+        "revoke.js"
       ]
     },
-    "face:get": {
+    "keys:update": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "key_id": {
+          "description": "Key ID",
+          "name": "key_id",
           "required": true
         }
       },
-      "description": "Get details for a face by alias",
+      "description": "Update API key metadata (JWT required)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2108,11 +2097,31 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "New key name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "budget": {
+          "description": "New spend budget in USD",
+          "name": "budget",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "reset-spent": {
+          "description": "Reset spent amount to zero",
+          "name": "reset-spent",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:get",
+      "id": "keys:update",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2122,14 +2131,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "face",
-        "get.js"
+        "keys",
+        "update.js"
       ]
     },
-    "face:list": {
+    "face:create": {
       "aliases": [],
       "args": {},
-      "description": "List all owned faces",
+      "description": "Create a new face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2161,11 +2170,62 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "Display name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "alias": {
+          "description": "Unique alias slug",
+          "name": "alias",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Description for local catalog",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "default-model": {
+          "description": "Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)",
+          "name": "default-model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "formula": {
+          "description": "Boolean formula over owned concrete face aliases (e.g. \"a | b\", \"(a | b) - c\"). Creates a composite face.",
+          "name": "formula",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "attr": {
+          "description": "Attribute KEY=VALUE (repeatable)",
+          "name": "attr",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "tool": {
+          "description": "Tool name to enable (repeatable)",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:list",
+      "id": "face:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2176,10 +2236,10 @@
         "dist",
         "commands",
         "face",
-        "list.js"
+        "create.js"
       ]
     },
-    "face:neighbors": {
+    "face:delete": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -2188,7 +2248,7 @@
           "required": true
         }
       },
-      "description": "Find the most similar or dissimilar owned faces to a given face",
+      "description": "Delete a face permanently",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2221,44 +2281,16 @@
           "multiple": false,
           "type": "option"
         },
-        "k": {
-          "description": "Number of results (1–20)",
-          "name": "k",
-          "default": 5,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "component": {
-          "description": "Centroid component to rank on (beta, delta, epsilon are the principal components of a face; face is their composite)",
-          "name": "component",
-          "default": "face",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "face",
-            "beta",
-            "delta",
-            "epsilon"
-          ],
-          "type": "option"
-        },
-        "direction": {
-          "description": "nearest (most similar) or furthest (most dissimilar)",
-          "name": "direction",
-          "default": "nearest",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "nearest",
-            "furthest"
-          ],
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "face:neighbors",
+      "id": "face:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2269,13 +2301,279 @@
         "dist",
         "commands",
         "face",
-        "neighbors.js"
+        "delete.js"
       ]
     },
-    "face:stats": {
+    "face:diff": {
       "aliases": [],
       "args": {},
-      "description": "Compile and chat stats for all owned faces",
+      "description": "Compare owned faces pairwise across all centroid components",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "face": {
+          "description": "Face alias to include (repeatable, min 2)",
+          "name": "face",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:diff",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "diff.js"
+      ]
+    },
+    "face:get": {
+      "aliases": [],
+      "args": {
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Get details for a face by alias",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:get",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "get.js"
+      ]
+    },
+    "face:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all owned faces",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:list",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "list.js"
+      ]
+    },
+    "face:neighbors": {
+      "aliases": [],
+      "args": {
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Find the most similar or dissimilar owned faces to a given face",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "k": {
+          "description": "Number of results (1–20)",
+          "name": "k",
+          "default": 5,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "component": {
+          "description": "Centroid component to rank on (beta, delta, epsilon are the principal components of a face; face is their composite)",
+          "name": "component",
+          "default": "face",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "face",
+            "beta",
+            "delta",
+            "epsilon"
+          ],
+          "type": "option"
+        },
+        "direction": {
+          "description": "nearest (most similar) or furthest (most dissimilar)",
+          "name": "direction",
+          "default": "nearest",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "nearest",
+            "furthest"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "face:neighbors",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "face",
+        "neighbors.js"
+      ]
+    },
+    "face:stats": {
+      "aliases": [],
+      "args": {},
+      "description": "Compile and chat stats for all owned faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2524,10 +2822,16 @@
         "upload.js"
       ]
     },
-    "keys:create": {
+    "compile:thread:create": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new API key (JWT required)",
+      "args": {
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "Start a new thread for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2560,46 +2864,83 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Key name/label",
-          "name": "name",
-          "required": true,
+        "label": {
+          "description": "Thread label",
+          "name": "label",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "compile:thread:create",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "thread",
+        "create.js"
+      ]
+    },
+    "compile:thread:delete": {
+      "aliases": [],
+      "args": {
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
+          "required": true
+        }
+      },
+      "description": "Delete a thread",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "expires-days": {
-          "description": "Expiry in days (omit for no expiry)",
-          "name": "expires-days",
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "budget": {
-          "description": "Spend budget in USD",
-          "name": "budget",
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "face": {
-          "description": "Allowed face alias (repeatable)",
-          "name": "face",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "model": {
-          "description": "Allowed model name (repeatable)",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:create",
+      "id": "compile:thread:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2609,14 +2950,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "create.js"
+        "compile",
+        "thread",
+        "delete.js"
       ]
     },
-    "keys:list": {
+    "compile:thread:edit": {
       "aliases": [],
-      "args": {},
-      "description": "List all API keys (JWT required)",
+      "args": {
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
+          "required": true
+        }
+      },
+      "description": "Edit a thread (label and/or reassign face speaker)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2648,11 +2996,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "label": {
+          "description": "New thread label",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "face-speaker": {
+          "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
+          "name": "face-speaker",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:list",
+      "id": "compile:thread:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2662,20 +3024,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "list.js"
+        "compile",
+        "thread",
+        "edit.js"
       ]
     },
-    "keys:revoke": {
+    "compile:thread:get": {
       "aliases": [],
       "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Revoke an API key (JWT required)",
+      "description": "Get a thread by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2707,17 +3070,71 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "compile:thread:get",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "thread",
+        "get.js"
+      ]
+    },
+    "compile:thread:list": {
+      "aliases": [],
+      "args": {
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
+          "required": true
+        }
+      },
+      "description": "List threads for a face",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:revoke",
+      "id": "compile:thread:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2727,20 +3144,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "revoke.js"
+        "compile",
+        "thread",
+        "list.js"
       ]
     },
-    "keys:update": {
+    "compile:thread:make": {
       "aliases": [],
       "args": {
-        "key_id": {
-          "description": "Key ID",
-          "name": "key_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Update API key metadata (JWT required)",
+      "description": "Compile an existing thread (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2773,30 +3191,24 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "New key name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "budget": {
-          "description": "New spend budget in USD",
-          "name": "budget",
+        "timeout": {
+          "description": "Compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "reset-spent": {
-          "description": "Reset spent amount to zero",
-          "name": "reset-spent",
+        "no-wait": {
+          "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
+          "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "keys:update",
+      "id": "compile:thread:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2806,20 +3218,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "keys",
-        "update.js"
+        "compile",
+        "thread",
+        "make.js"
       ]
     },
-    "compile:doc:create": {
+    "compile:thread:message": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Submit a document to a face",
+      "description": "Send a user message to a thread",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2852,43 +3265,19 @@
           "multiple": false,
           "type": "option"
         },
-        "label": {
-          "description": "Document label/title",
-          "name": "label",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "content": {
-          "description": "Inline text content",
-          "name": "content",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read content from file",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "perspective": {
-          "description": "Perspective (first-person or third-person)",
-          "name": "perspective",
-          "default": "first-person",
+        "message": {
+          "char": "m",
+          "description": "User message to append",
+          "name": "message",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:create",
+      "id": "compile:thread:message",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2899,20 +3288,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "create.js"
+        "thread",
+        "message.js"
       ]
     },
-    "compile:doc:delete": {
+    "compile:thread:pause": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Delete a document",
+      "description": "Pause a running thread compilation (preserves progress, resume with make)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2948,7 +3337,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:delete",
+      "id": "compile:thread:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2959,20 +3348,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "delete.js"
+        "thread",
+        "pause.js"
       ]
     },
-    "compile:doc:edit": {
+    "compile:thread:reset": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Edit a document (label, content, or perspective)",
+      "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3005,42 +3394,16 @@
           "multiple": false,
           "type": "option"
         },
-        "label": {
-          "description": "New label/title",
-          "name": "label",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "content": {
-          "description": "New inline text content",
-          "name": "content",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read new content from file",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "perspective": {
-          "description": "Perspective (first-person or third-person)",
-          "name": "perspective",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
-          "type": "option"
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:edit",
+      "id": "compile:thread:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3051,20 +3414,20 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "edit.js"
+        "thread",
+        "reset.js"
       ]
     },
-    "compile:doc:get": {
+    "compile:thread:sync": {
       "aliases": [],
       "args": {
-        "doc_id": {
-          "description": "Document ID",
-          "name": "doc_id",
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
           "required": true
         }
       },
-      "description": "Get a document by ID",
+      "description": "Archive and sync a thread into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3100,7 +3463,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:get",
+      "id": "compile:thread:sync",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3111,11 +3474,11 @@
         "dist",
         "commands",
         "compile",
-        "doc",
-        "get.js"
+        "thread",
+        "sync.js"
       ]
     },
-    "compile:doc": {
+    "compile:doc:create": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -3124,7 +3487,7 @@
           "required": true
         }
       },
-      "description": "Compile a document into a face (create → make in one step)",
+      "description": "Submit a document to a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3177,97 +3540,23 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "perspective": {
-          "description": "Perspective",
-          "name": "perspective",
-          "default": "first-person",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
-          "type": "option"
-        },
-        "timeout": {
-          "description": "Compile timeout in seconds (default: 600)",
-          "name": "timeout",
-          "default": 600,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-wait": {
-          "description": "Create and trigger compilation, then return immediately without polling.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "compile:doc",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "compile",
-        "doc",
-        "index.js"
-      ]
-    },
-    "compile:doc:list": {
-      "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "List documents for a face",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        },
+        "perspective": {
+          "description": "Perspective (first-person or third-person)",
+          "name": "perspective",
+          "default": "first-person",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:list",
+      "id": "compile:doc:create",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3279,10 +3568,10 @@
         "commands",
         "compile",
         "doc",
-        "list.js"
+        "create.js"
       ]
     },
-    "compile:doc:make": {
+    "compile:doc:delete": {
       "aliases": [],
       "args": {
         "doc_id": {
@@ -3291,7 +3580,7 @@
           "required": true
         }
       },
-      "description": "Compile an existing document (prepare + sync in one step)",
+      "description": "Delete a document",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3323,25 +3612,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "timeout": {
-          "description": "Compile timeout in seconds (default: 600)",
-          "name": "timeout",
-          "default": 600,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-wait": {
-          "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:doc:make",
+      "id": "compile:doc:delete",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3353,19 +3628,19 @@
         "commands",
         "compile",
         "doc",
-        "make.js"
+        "delete.js"
       ]
     },
-    "compile:thread:create": {
+    "compile:doc:edit": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Start a new thread for a face",
+      "description": "Edit a document (label, content, or perspective)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3399,16 +3674,41 @@
           "type": "option"
         },
         "label": {
-          "description": "Thread label",
+          "description": "New label/title",
           "name": "label",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "content": {
+          "description": "New inline text content",
+          "name": "content",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Read new content from file",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "perspective": {
+          "description": "Perspective (first-person or third-person)",
+          "name": "perspective",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:create",
+      "id": "compile:doc:edit",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3419,20 +3719,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "create.js"
+        "doc",
+        "edit.js"
       ]
     },
-    "compile:thread:delete": {
+    "compile:doc:get": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Delete a thread",
+      "description": "Get a document by ID",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3464,17 +3764,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:delete",
+      "id": "compile:doc:get",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3485,20 +3779,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "delete.js"
+        "doc",
+        "get.js"
       ]
     },
-    "compile:thread:edit": {
+    "compile:doc": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Edit a thread (label and/or reassign face speaker)",
+      "description": "Compile a document into a face (create → make in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3532,83 +3826,56 @@
           "type": "option"
         },
         "label": {
-          "description": "New thread label",
+          "description": "Document label/title",
           "name": "label",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "face-speaker": {
-          "description": "Reassign face speaker: set this speaker to role=user, all others to role=assistant",
-          "name": "face-speaker",
+        "content": {
+          "description": "Inline text content",
+          "name": "content",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "compile:thread:edit",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "compile",
-        "thread",
-        "edit.js"
-      ]
-    },
-    "compile:thread:get": {
-      "aliases": [],
-      "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
-          "required": true
-        }
-      },
-      "description": "Get a thread by ID",
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
         },
-        "base-url": {
-          "description": "API base URL",
-          "env": "FACES_BASE_URL",
-          "name": "base-url",
+        "file": {
+          "description": "Read content from file",
+          "name": "file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "perspective": {
+          "description": "Perspective",
+          "name": "perspective",
+          "default": "first-person",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "timeout": {
+          "description": "Compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "no-wait": {
+          "description": "Create and trigger compilation, then return immediately without polling.",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:get",
+      "id": "compile:doc",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3619,11 +3886,11 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "get.js"
+        "doc",
+        "index.js"
       ]
     },
-    "compile:thread:list": {
+    "compile:doc:list": {
       "aliases": [],
       "args": {
         "face_id": {
@@ -3632,7 +3899,7 @@
           "required": true
         }
       },
-      "description": "List threads for a face",
+      "description": "List documents for a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3668,7 +3935,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:list",
+      "id": "compile:doc:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3679,20 +3946,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "list.js"
       ]
     },
-    "compile:thread:make": {
+    "compile:doc:make": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Compile an existing thread (prepare + sync in one step)",
+      "description": "Compile an existing document (prepare + sync in one step)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3734,7 +4001,7 @@
           "type": "option"
         },
         "no-wait": {
-          "description": "Return immediately after triggering compilation. Prints the thread ID for manual polling.",
+          "description": "Return immediately after triggering compilation. Prints the document ID for manual polling.",
           "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
@@ -3742,7 +4009,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:make",
+      "id": "compile:doc:make",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3753,20 +4020,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
+        "doc",
         "make.js"
       ]
     },
-    "compile:thread:message": {
+    "compile:doc:pause": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Send a user message to a thread",
+      "description": "Pause a running document compilation (preserves progress, resume with make)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3798,20 +4065,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "message": {
-          "char": "m",
-          "description": "User message to append",
-          "name": "message",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:message",
+      "id": "compile:doc:pause",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3822,20 +4080,20 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "message.js"
+        "doc",
+        "pause.js"
       ]
     },
-    "compile:thread:sync": {
+    "compile:doc:reset": {
       "aliases": [],
       "args": {
-        "thread_id": {
-          "description": "Thread ID",
-          "name": "thread_id",
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
           "required": true
         }
       },
-      "description": "Archive and sync a thread into a face",
+      "description": "Reset document compilation progress (wipe extraction, keep content)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -3867,11 +4125,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:thread:sync",
+      "id": "compile:doc:reset",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -3882,10 +4146,10 @@
         "dist",
         "commands",
         "compile",
-        "thread",
-        "sync.js"
+        "doc",
+        "reset.js"
       ]
     }
   },
-  "version": "1.5.4"
+  "version": "1.5.6"
 }