faces-cli 1.5.2 → 1.5.4

package/dist/base.d.ts

@@ -12,5 +12,8 @@ export declare abstract class BaseCommand extends Command {
         token?: string;
         'api-key'?: string;
     }, _requireJwt?: boolean): FacesClient;
+    catch(err: Error & {
+        exitCode?: number;
+    }): Promise<unknown>;
     protected printHuman(data: unknown, indent?: number): void;
 }

package/dist/base.js

@@ -23,6 +23,16 @@ export class BaseCommand extends Command {
         const apiKey = resolveApiKey(flags['api-key']);
         return new FacesClient(baseUrl, token, apiKey);
     }
+    async catch(err) {
+        // When --json is enabled, oclif swallows error messages. Override to
+        // include the message in structured JSON output so agents can parse it.
+        if (this.jsonEnabled()) {
+            const code = err.exitCode ?? 1;
+            process.stdout.write(JSON.stringify({ error: { message: err.message, code } }) + '\n');
+            process.exit(code);
+        }
+        throw err;
+    }
     printHuman(data, indent = 0) {
         const prefix = '  '.repeat(indent);
         if (Array.isArray(data)) {

package/dist/commands/compile/doc/index.d.ts

@@ -7,6 +7,7 @@ export default class CompileDoc extends BaseCommand {
         file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         perspective: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'no-wait': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/compile/doc/index.js

@@ -16,6 +16,10 @@ export default class CompileDoc extends BaseCommand {
             default: 'first-person',
         }),
         timeout: Flags.integer({ description: 'Compile timeout in seconds (default: 600)', default: 600 }),
+        'no-wait': Flags.boolean({
+            description: 'Create and trigger compilation, then return immediately without polling.',
+            default: false,
+        }),
     };
     static args = {
         face_id: Args.string({ description: 'Face alias', required: true }),
@@ -64,6 +68,13 @@ export default class CompileDoc extends BaseCommand {
             throw err;
         }
         const chunksTotal = makeResponse.chunks_total;
+        if (flags['no-wait']) {
+            if (!json) {
+                process.stderr.write(`Compilation started in background${chunksTotal ? ` (${chunksTotal} chunks)` : ''}.\n`);
+                process.stderr.write(`Poll with: faces compile:doc:get ${docId} --json\n`);
+            }
+            return makeResponse;
+        }
         if (!json)
             process.stderr.write(`Compiling${chunksTotal ? ` (${chunksTotal} chunks)` : ''}:\n`);
         // Step 3: Poll until synced

package/dist/commands/compile/thread/edit.js

@@ -37,10 +37,11 @@ export default class CompileThreadEdit extends BaseCommand {
             if (!messages || messages.length === 0) {
                 this.error('Thread has no messages to remap');
             }
-            // Remap roles
+            // Remap roles — case-insensitive exact match against speaker label
             let remapped = 0;
+            const speakerLower = speaker.toLowerCase();
             const updated = messages.map((m) => {
-                const isFace = m.name && m.name.toLowerCase() === speaker.toLowerCase();
+                const isFace = (m.name ?? '').toLowerCase() === speakerLower;
                 const newRole = isFace ? 'user' : 'assistant';
                 if (m.role !== newRole)
                     remapped++;

package/oclif.manifest.json

@@ -1453,10 +1453,16 @@
         "responses.js"
       ]
     },
-    "config:clear": {
+    "compile:import": {
       "aliases": [],
-      "args": {},
-      "description": "Delete all saved credentials and config",
+      "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",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1489,16 +1495,55 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip confirmation",
-          "name": "yes",
+        "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",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:clear",
+      "id": "compile:import",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1508,25 +1553,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "clear.js"
+        "compile",
+        "import.js"
       ]
     },
-    "config:set": {
+    "compile:upload": {
       "aliases": [],
       "args": {
-        "key": {
-          "description": "Config key",
-          "name": "key",
-          "required": true
-        },
-        "value": {
-          "description": "Config value",
-          "name": "value",
+        "alias": {
+          "description": "Face alias",
+          "name": "alias",
           "required": true
         }
       },
-      "description": "Set a config value (e.g. base_url, api_key, token)",
+      "description": "Upload a file (text/PDF/audio/video) to compile into a face",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1558,11 +1598,56 @@
           "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": "config:set",
+      "id": "compile:upload",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1572,14 +1657,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "set.js"
+        "compile",
+        "upload.js"
       ]
     },
-    "config:show": {
+    "config:clear": {
       "aliases": [],
       "args": {},
-      "description": "Print current config (credentials are masked)",
+      "description": "Delete all saved credentials and config",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1611,11 +1696,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:show",
+      "id": "config:clear",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1626,19 +1717,24 @@
         "dist",
         "commands",
         "config",
-        "show.js"
+        "clear.js"
       ]
     },
-    "compile:import": {
+    "config:set": {
       "aliases": [],
       "args": {
-        "face_id": {
-          "description": "Face alias",
-          "name": "face_id",
+        "key": {
+          "description": "Config key",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "Config value",
+          "name": "value",
           "required": true
         }
       },
-      "description": "Import a YouTube video into a face via server-side download and transcription",
+      "description": "Set a config value (e.g. base_url, api_key, token)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1670,56 +1766,11 @@
           "hasDynamicHelp": false,
           "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",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "compile:import",
+      "id": "config:set",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1729,20 +1780,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "import.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.",
@@ -1774,56 +1819,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",
@@ -1833,8 +1833,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "compile",
-        "upload.js"
+        "config",
+        "show.js"
       ]
     },
     "face:create": {
@@ -3197,6 +3197,12 @@
           "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,
@@ -3881,5 +3887,5 @@
       ]
     }
   },
-  "version": "1.5.2"
+  "version": "1.5.4"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faces-cli",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "description": "CLI for the Faces AI platform",
   "type": "module",
   "author": "sybileak <sybileak@proton.me>",