faces-cli 1.6.18 → 1.7.0

package/oclif.manifest.json

@@ -120,23 +120,10 @@
         "state.js"
       ]
     },
-    "auth:connect": {
+    "catalog:backup": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "OAuth provider to connect",
-          "name": "provider",
-          "options": [
-            "openai"
-          ],
-          "required": true
-        }
-      },
-      "description": "Connect your ChatGPT account to Faces via device-code authorization (Subscription Connect plan)",
-      "examples": [
-        "<%= config.bin %> auth connect openai",
-        "<%= config.bin %> auth connect openai --json"
-      ],
+      "args": {},
+      "description": "Snapshot all faces, teams, and source material for migration",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -172,7 +159,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:connect",
+      "id": "catalog:backup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -182,18 +169,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "connect.js"
+        "catalog",
+        "backup.js"
       ]
     },
-    "auth:connections": {
+    "catalog:doctor": {
       "aliases": [],
       "args": {},
-      "description": "List connected OAuth provider accounts",
-      "examples": [
-        "<%= config.bin %> auth connections",
-        "<%= config.bin %> auth connections --json"
-      ],
+      "description": "Diagnose and repair the local face and team catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -225,11 +208,23 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "fix": {
+          "description": "Rebuild missing or stale catalog entries from API",
+          "name": "fix",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "generate": {
+          "description": "Fix + generate missing descriptions via LLM",
+          "name": "generate",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:connections",
+      "id": "catalog:doctor",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -239,26 +234,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "connections.js"
+        "catalog",
+        "doctor.js"
       ]
     },
-    "auth:disconnect": {
+    "catalog:list": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "OAuth provider to disconnect",
-          "name": "provider",
-          "options": [
-            "openai"
-          ],
-          "required": true
-        }
-      },
-      "description": "Disconnect a linked OAuth provider account",
-      "examples": [
-        "<%= config.bin %> auth disconnect openai"
-      ],
+      "args": {},
+      "description": "List all faces in the local catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -294,7 +277,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:disconnect",
+      "id": "catalog:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -304,14 +287,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "disconnect.js"
+        "catalog",
+        "list.js"
       ]
     },
-    "auth:login": {
+    "catalog:manyfaced": {
       "aliases": [],
       "args": {},
-      "description": "Login and save JWT credentials",
+      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -344,26 +327,37 @@
           "multiple": false,
           "type": "option"
         },
-        "email": {
-          "description": "Account email",
-          "name": "email",
-          "required": true,
+        "skill": {
+          "description": "Show details for a specific skill",
+          "name": "skill",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "password": {
-          "description": "Account password",
-          "name": "password",
-          "required": true,
+        "install": {
+          "description": "Install a skill by name",
+          "name": "install",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skills-dir": {
+          "description": "Directory to install skills into (required for --install)",
+          "name": "skills-dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "refresh": {
+          "description": "Force refresh the skill index (ignore cache)",
+          "name": "refresh",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:login",
+      "id": "catalog:manyfaced",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -373,14 +367,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "login.js"
+        "catalog",
+        "manyfaced.js"
       ]
     },
-    "auth:logout": {
+    "catalog:restore": {
       "aliases": [],
-      "args": {},
-      "description": "Clear saved credentials",
+      "args": {
+        "file": {
+          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
+          "name": "file"
+        }
+      },
+      "description": "Restore faces, teams, and source material from a backup snapshot",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -412,11 +411,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "compile": {
+          "description": "Run compile:all after restoring",
+          "name": "compile",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:logout",
+      "id": "catalog:restore",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -426,14 +431,27 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "logout.js"
+        "catalog",
+        "restore.js"
       ]
     },
-    "auth:refresh": {
+    "auth:connect": {
       "aliases": [],
-      "args": {},
-      "description": "Exchange current JWT for a fresh one",
+      "args": {
+        "provider": {
+          "description": "OAuth provider to connect",
+          "name": "provider",
+          "options": [
+            "openai"
+          ],
+          "required": true
+        }
+      },
+      "description": "Connect your ChatGPT account to Faces via device-code authorization (Subscription Connect plan)",
+      "examples": [
+        "<%= config.bin %> auth connect openai",
+        "<%= config.bin %> auth connect openai --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -469,7 +487,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:refresh",
+      "id": "auth:connect",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -480,13 +498,17 @@
         "dist",
         "commands",
         "auth",
-        "refresh.js"
+        "connect.js"
       ]
     },
-    "auth:register": {
+    "auth:connections": {
       "aliases": [],
       "args": {},
-      "description": "Create a new Faces account",
+      "description": "List connected OAuth provider accounts",
+      "examples": [
+        "<%= config.bin %> auth connections",
+        "<%= config.bin %> auth connections --json"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -518,54 +540,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "email": {
-          "description": "Email address",
-          "name": "email",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "password": {
-          "description": "Password",
-          "name": "password",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "username": {
-          "description": "Username (lowercase, dashes, numbers)",
-          "name": "username",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "invite-key": {
-          "description": "Invite key (if required)",
-          "name": "invite-key",
-          "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,
       "hiddenAliases": [],
-      "id": "auth:register",
+      "id": "auth:connections",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -576,13 +555,25 @@
         "dist",
         "commands",
         "auth",
-        "register.js"
+        "connections.js"
       ]
     },
-    "auth:whoami": {
+    "auth:disconnect": {
       "aliases": [],
-      "args": {},
-      "description": "Print current user profile and auth diagnostic",
+      "args": {
+        "provider": {
+          "description": "OAuth provider to disconnect",
+          "name": "provider",
+          "options": [
+            "openai"
+          ],
+          "required": true
+        }
+      },
+      "description": "Disconnect a linked OAuth provider account",
+      "examples": [
+        "<%= config.bin %> auth disconnect openai"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -618,7 +609,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:whoami",
+      "id": "auth:disconnect",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -629,13 +620,13 @@
         "dist",
         "commands",
         "auth",
-        "whoami.js"
+        "disconnect.js"
       ]
     },
-    "catalog:backup": {
+    "auth:login": {
       "aliases": [],
       "args": {},
-      "description": "Snapshot all faces, teams, and source material for migration",
+      "description": "Login and save JWT credentials",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -667,11 +658,27 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "email": {
+          "description": "Account email",
+          "name": "email",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "password": {
+          "description": "Account password",
+          "name": "password",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:backup",
+      "id": "auth:login",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -681,14 +688,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "backup.js"
+        "auth",
+        "login.js"
       ]
     },
-    "catalog:doctor": {
+    "auth:logout": {
       "aliases": [],
       "args": {},
-      "description": "Diagnose and repair the local face and team catalog",
+      "description": "Clear saved credentials",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -720,23 +727,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "fix": {
-          "description": "Rebuild missing or stale catalog entries from API",
-          "name": "fix",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "generate": {
-          "description": "Fix + generate missing descriptions via LLM",
-          "name": "generate",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:doctor",
+      "id": "auth:logout",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -746,14 +741,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "doctor.js"
+        "auth",
+        "logout.js"
       ]
     },
-    "catalog:list": {
+    "auth:refresh": {
       "aliases": [],
       "args": {},
-      "description": "List all faces in the local catalog",
+      "description": "Exchange current JWT for a fresh one",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -789,7 +784,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:list",
+      "id": "auth:refresh",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -799,14 +794,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "list.js"
+        "auth",
+        "refresh.js"
       ]
     },
-    "catalog:manyfaced": {
+    "auth:register": {
       "aliases": [],
       "args": {},
-      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
+      "description": "Create a new Faces account",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -839,37 +834,53 @@
           "multiple": false,
           "type": "option"
         },
-        "skill": {
-          "description": "Show details for a specific skill",
-          "name": "skill",
+        "email": {
+          "description": "Email address",
+          "name": "email",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "install": {
-          "description": "Install a skill by name",
-          "name": "install",
+        "password": {
+          "description": "Password",
+          "name": "password",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "skills-dir": {
-          "description": "Directory to install skills into (required for --install)",
-          "name": "skills-dir",
+        "username": {
+          "description": "Username (lowercase, dashes, numbers)",
+          "name": "username",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "refresh": {
-          "description": "Force refresh the skill index (ignore cache)",
-          "name": "refresh",
-          "allowNo": false,
-          "type": "boolean"
+        "invite-key": {
+          "description": "Invite key (if required)",
+          "name": "invite-key",
+          "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,
       "hiddenAliases": [],
-      "id": "catalog:manyfaced",
+      "id": "auth:register",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -879,19 +890,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "manyfaced.js"
+        "auth",
+        "register.js"
       ]
     },
-    "catalog:restore": {
+    "auth:whoami": {
       "aliases": [],
-      "args": {
-        "file": {
-          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
-          "name": "file"
-        }
-      },
-      "description": "Restore faces, teams, and source material from a backup snapshot",
+      "args": {},
+      "description": "Print current user profile and auth diagnostic",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -923,17 +929,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "compile": {
-          "description": "Run compile:all after restoring",
-          "name": "compile",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:restore",
+      "id": "auth:whoami",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -943,8 +943,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "restore.js"
+        "auth",
+        "whoami.js"
       ]
     },
     "billing:balance": {
@@ -1367,16 +1367,10 @@
         "usage.js"
       ]
     },
-    "chat:chat": {
+    "compile:all": {
       "aliases": [],
-      "args": {
-        "face_username": {
-          "description": "Face alias (or alias@model)",
-          "name": "face_username",
-          "required": true
-        }
-      },
-      "description": "Chat via a face. Auto-routes to the correct API endpoint based on model provider.",
+      "args": {},
+      "description": "Compile all uncompiled documents and threads across all faces",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1409,72 +1403,18 @@
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "User message (repeatable)",
-          "name": "message",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "llm": {
-          "description": "LLM override (e.g. gpt-4o-mini, claude-sonnet-4-6)",
-          "name": "llm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "system": {
-          "description": "System prompt / instructions",
-          "name": "system",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "temperature": {
-          "description": "Temperature (0.0-2.0)",
-          "name": "temperature",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read message from file",
-          "name": "file",
+        "timeout": {
+          "description": "Per-item compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "responses": {
-          "description": "Use OpenAI Responses API instead of Chat Completions",
-          "name": "responses",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:chat",
+      "id": "compile:all",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1484,20 +1424,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "chat.js"
+        "compile",
+        "all.js"
       ]
     },
-    "chat:messages": {
+    "compile:import": {
       "aliases": [],
       "args": {
-        "face_model": {
-          "description": "Face model (e.g. myface or myface@claude-sonnet-4-6)",
-          "name": "face_model",
+        "face_id": {
+          "description": "Face alias",
+          "name": "face_id",
           "required": true
         }
       },
-      "description": "Anthropic Messages API proxy via a face (alias: chat:chat auto-routes Anthropic models here)",
+      "description": "Import a YouTube video into a face via server-side download and transcription",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1530,46 +1470,55 @@
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "User message (repeatable)",
-          "name": "message",
+        "url": {
+          "description": "YouTube URL (youtube.com/watch?v=... or youtu.be/...)",
+          "name": "url",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "system": {
-          "description": "System prompt",
-          "name": "system",
+        "type": {
+          "description": "\"document\" for solo talks, lectures, monologues; \"thread\" for interviews or multi-speaker conversations",
+          "name": "type",
+          "default": "document",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "document",
+            "thread"
+          ],
           "type": "option"
         },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
-          "allowNo": false,
-          "type": "boolean"
+        "perspective": {
+          "description": "\"first-person\" if the face is the speaker; \"third-person\" if the video is about the face",
+          "name": "perspective",
+          "default": "third-person",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
+          "type": "option"
         },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
-          "default": 1024,
+        "face-speaker": {
+          "description": "For --type thread: AssemblyAI speaker label (e.g. \"A\") that corresponds to the face. Defaults to first detected speaker.",
+          "name": "face-speaker",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
+        "no-wait": {
+          "description": "Return immediately after import starts (do not poll for transcription). Prints the ID for manual polling.",
+          "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:messages",
+      "id": "compile:import",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1579,20 +1528,73 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "messages.js"
-      ]
+        "compile",
+        "import.js"
+      ]
     },
-    "chat:responses": {
+    "compile:stats": {
+      "aliases": [],
+      "args": {},
+      "description": "Show compilation stats per 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": "compile:stats",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "stats.js"
+      ]
+    },
+    "compile:upload": {
       "aliases": [],
       "args": {
-        "face_model": {
-          "description": "Face model (e.g. myface or myface@gpt-4o)",
-          "name": "face_model",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "OpenAI Responses API proxy via a face (alias: chat:chat --responses)",
+      "description": "Upload a file (text/PDF/audio/video) to compile into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1625,38 +1627,55 @@
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "User input message",
-          "name": "message",
+        "file": {
+          "description": "File to upload",
+          "name": "file",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "instructions": {
-          "description": "System instructions",
-          "name": "instructions",
+        "kind": {
+          "description": "Upload kind: document or thread",
+          "name": "kind",
+          "default": "document",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "document",
+            "thread"
+          ],
           "type": "option"
         },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
-          "allowNo": false,
-          "type": "boolean"
+        "perspective": {
+          "description": "Perspective (document only)",
+          "name": "perspective",
+          "default": "third-person",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "first-person",
+            "third-person"
+          ],
+          "type": "option"
         },
-        "oauth-only": {
-          "description": "Prevent fallback to paid system key (use OAuth only)",
-          "name": "oauth-only",
+        "face-speaker": {
+          "description": "Speaker name to map to the face (thread only). If omitted, auto-detected from face name.",
+          "name": "face-speaker",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-wait": {
+          "description": "Return immediately after upload (do not poll for transcription). Prints the ID for manual polling.",
+          "name": "no-wait",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:responses",
+      "id": "compile:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1666,27 +1685,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "chat",
-        "responses.js"
+        "compile",
+        "upload.js"
       ]
     },
-    "chat:thread": {
+    "chat:chat": {
       "aliases": [],
       "args": {
         "face_username": {
-          "description": "Face alias (or alias@model) — required when starting a new thread",
+          "description": "Face alias (or alias@model)",
           "name": "face_username",
-          "required": false
+          "required": true
         }
       },
-      "description": "Multi-turn chat thread. Conversation history is stored under ~/.faces/threads/<id>.json — resume any thread later with --id.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> socrates -m \"What is justice?\"",
-        "<%= config.bin %> <%= command.id %> --id t_abc123 -m \"Say more about that\"",
-        "<%= config.bin %> <%= command.id %> --list",
-        "<%= config.bin %> <%= command.id %> --id t_abc123 --show",
-        "<%= config.bin %> <%= command.id %> --id t_abc123 --delete"
-      ],
+      "description": "Chat via a face. Auto-routes to the correct API endpoint based on the model catalog.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1719,42 +1731,35 @@
           "multiple": false,
           "type": "option"
         },
-        "id": {
-          "description": "Resume an existing thread by id",
-          "name": "id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "message": {
           "char": "m",
-          "description": "User message",
+          "description": "User message (repeatable)",
           "name": "message",
+          "required": false,
           "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Read message from file",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "llm": {
-          "description": "LLM override (only honored when starting a new thread)",
+          "description": "LLM override (e.g. gpt-4o-mini, claude-sonnet-4-6)",
           "name": "llm",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "system": {
-          "description": "System prompt (only honored when starting a new thread)",
+          "description": "System prompt / instructions",
           "name": "system",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "max-tokens": {
           "description": "Max tokens",
           "name": "max-tokens",
@@ -1763,46 +1768,35 @@
           "type": "option"
         },
         "temperature": {
-          "description": "Temperature (0.0-2.0, OpenAI/Chat Completions only)",
+          "description": "Temperature (0.0-2.0)",
           "name": "temperature",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "stream": {
-          "description": "Stream the response",
-          "name": "stream",
+        "file": {
+          "description": "Read message from file",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "responses": {
+          "description": "Force the OpenAI Responses API endpoint (escape hatch; routing is automatic otherwise)",
+          "name": "responses",
           "allowNo": false,
           "type": "boolean"
         },
         "oauth-only": {
-          "description": "Prevent fallback to paid system key",
+          "description": "Prevent fallback to paid system key (use OAuth only)",
           "name": "oauth-only",
           "allowNo": false,
           "type": "boolean"
-        },
-        "list": {
-          "description": "List saved threads",
-          "name": "list",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "show": {
-          "description": "Show the thread transcript (requires --id)",
-          "name": "show",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "delete": {
-          "description": "Delete the thread (requires --id)",
-          "name": "delete",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "chat:thread",
+      "id": "chat:chat",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1813,13 +1807,19 @@
         "dist",
         "commands",
         "chat",
-        "thread.js"
+        "chat.js"
       ]
     },
-    "config:clear": {
+    "chat:messages": {
       "aliases": [],
-      "args": {},
-      "description": "Delete all saved credentials and config",
+      "args": {
+        "face_model": {
+          "description": "Face model (e.g. myface or myface@claude-sonnet-4-6)",
+          "name": "face_model",
+          "required": true
+        }
+      },
+      "description": "Anthropic Messages API proxy via a face (alias: chat:chat auto-routes Anthropic models here)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1852,16 +1852,46 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "message": {
+          "char": "m",
+          "description": "User message (repeatable)",
+          "name": "message",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "system": {
+          "description": "System prompt",
+          "name": "system",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
+          "default": 1024,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key (use OAuth only)",
+          "name": "oauth-only",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:clear",
+      "id": "chat:messages",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1871,25 +1901,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "clear.js"
+        "chat",
+        "messages.js"
       ]
     },
-    "config:set": {
+    "chat:responses": {
       "aliases": [],
       "args": {
-        "key": {
-          "description": "Config key",
-          "name": "key",
-          "required": true
-        },
-        "value": {
-          "description": "Config value",
-          "name": "value",
+        "face_model": {
+          "description": "Face model (e.g. myface or myface@gpt-4o)",
+          "name": "face_model",
           "required": true
         }
       },
-      "description": "Set a config value (e.g. base_url, api_key, token)",
+      "description": "OpenAI Responses API proxy via a face (alias: chat:chat --responses)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1921,11 +1946,39 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "message": {
+          "char": "m",
+          "description": "User input message",
+          "name": "message",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "instructions": {
+          "description": "System instructions",
+          "name": "instructions",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key (use OAuth only)",
+          "name": "oauth-only",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:set",
+      "id": "chat:responses",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1935,14 +1988,27 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "set.js"
+        "chat",
+        "responses.js"
       ]
     },
-    "config:show": {
+    "chat:thread": {
       "aliases": [],
-      "args": {},
-      "description": "Print current config (credentials are masked)",
+      "args": {
+        "face_username": {
+          "description": "Face alias (or alias@model) — required when starting a new thread",
+          "name": "face_username",
+          "required": false
+        }
+      },
+      "description": "Multi-turn chat thread. Conversation history is stored under ~/.faces/threads/<id>.json — resume any thread later with --id.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> socrates -m \"What is justice?\"",
+        "<%= config.bin %> <%= command.id %> --id t_abc123 -m \"Say more about that\"",
+        "<%= config.bin %> <%= command.id %> --list",
+        "<%= config.bin %> <%= command.id %> --id t_abc123 --show",
+        "<%= config.bin %> <%= command.id %> --id t_abc123 --delete"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1974,72 +2040,91 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "config:show",
-      "pluginAlias": "faces-cli",
-      "pluginName": "faces-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "config",
-        "show.js"
-      ]
-    },
-    "compile:all": {
-      "aliases": [],
-      "args": {},
-      "description": "Compile all uncompiled documents and threads across all 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",
+        "id": {
+          "description": "Resume an existing thread by id",
+          "name": "id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "JWT bearer token",
-          "env": "FACES_TOKEN",
-          "name": "token",
+        "message": {
+          "char": "m",
+          "description": "User message",
+          "name": "message",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "api-key": {
-          "description": "API key",
-          "env": "FACES_API_KEY",
-          "name": "api-key",
+        "file": {
+          "description": "Read message from file",
+          "name": "file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "timeout": {
-          "description": "Per-item compile timeout in seconds (default: 600)",
-          "name": "timeout",
-          "default": 600,
+        "llm": {
+          "description": "LLM override (only honored when starting a new thread)",
+          "name": "llm",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "system": {
+          "description": "System prompt (only honored when starting a new thread)",
+          "name": "system",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "temperature": {
+          "description": "Temperature (0.0-2.0, OpenAI/Chat Completions only)",
+          "name": "temperature",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "description": "Stream the response",
+          "name": "stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "oauth-only": {
+          "description": "Prevent fallback to paid system key",
+          "name": "oauth-only",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "list": {
+          "description": "List saved threads",
+          "name": "list",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "show": {
+          "description": "Show the thread transcript (requires --id)",
+          "name": "show",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "delete": {
+          "description": "Delete the thread (requires --id)",
+          "name": "delete",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:all",
+      "id": "chat:thread",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2049,20 +2134,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "all.js"
+        "chat",
+        "thread.js"
       ]
     },
-    "compile:import": {
+    "config:clear": {
       "aliases": [],
-      "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
-          "required": true
-        }
-      },
-      "description": "Import a YouTube video into a face via server-side download and transcription",
+      "args": {},
+      "description": "Delete all saved credentials and config",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2095,55 +2174,16 @@
           "multiple": false,
           "type": "option"
         },
-        "url": {
-          "description": "YouTube URL (youtube.com/watch?v=... or youtu.be/...)",
-          "name": "url",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "type": {
-          "description": "\"document\" for solo talks, lectures, monologues; \"thread\" for interviews or multi-speaker conversations",
-          "name": "type",
-          "default": "document",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "document",
-            "thread"
-          ],
-          "type": "option"
-        },
-        "perspective": {
-          "description": "\"first-person\" if the face is the speaker; \"third-person\" if the video is about the face",
-          "name": "perspective",
-          "default": "third-person",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
-          "type": "option"
-        },
-        "face-speaker": {
-          "description": "For --type thread: AssemblyAI speaker label (e.g. \"A\") that corresponds to the face. Defaults to first detected speaker.",
-          "name": "face-speaker",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-wait": {
-          "description": "Return immediately after import starts (do not poll for transcription). Prints the ID for manual polling.",
-          "name": "no-wait",
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:import",
+      "id": "config:clear",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2153,14 +2193,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "import.js"
+        "config",
+        "clear.js"
       ]
     },
-    "compile:stats": {
+    "config:set": {
       "aliases": [],
-      "args": {},
-      "description": "Show compilation stats per face",
+      "args": {
+        "key": {
+          "description": "Config key",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "Config value",
+          "name": "value",
+          "required": true
+        }
+      },
+      "description": "Set a config value (e.g. base_url, api_key, token)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2196,7 +2247,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:stats",
+      "id": "config:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2206,20 +2257,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "stats.js"
+        "config",
+        "set.js"
       ]
     },
-    "compile:upload": {
+    "config:show": {
       "aliases": [],
-      "args": {
-        "alias": {
-          "description": "Face alias",
-          "name": "alias",
-          "required": true
-        }
-      },
-      "description": "Upload a file (text/PDF/audio/video) to compile into a face",
+      "args": {},
+      "description": "Print current config (credentials are masked)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2251,56 +2296,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "file": {
-          "description": "File to upload",
-          "name": "file",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "kind": {
-          "description": "Upload kind: document or thread",
-          "name": "kind",
-          "default": "document",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "document",
-            "thread"
-          ],
-          "type": "option"
-        },
-        "perspective": {
-          "description": "Perspective (document only)",
-          "name": "perspective",
-          "default": "third-person",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "first-person",
-            "third-person"
-          ],
-          "type": "option"
-        },
-        "face-speaker": {
-          "description": "Speaker name to map to the face (thread only). If omitted, auto-detected from face name.",
-          "name": "face-speaker",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-wait": {
-          "description": "Return immediately after upload (do not poll for transcription). Prints the ID for manual polling.",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:upload",
+      "id": "config:show",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -2310,8 +2310,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "upload.js"
+        "config",
+        "show.js"
       ]
     },
     "keys:create": {
@@ -6040,5 +6040,5 @@
       ]
     }
   },
-  "version": "1.6.18"
+  "version": "1.7.0"
 }