faces-cli 1.5.0 → 1.5.2

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

@@ -3,6 +3,7 @@ export default class CompileDocMake extends BaseCommand {
     static description: string;
     static flags: {
         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/make.js

@@ -7,6 +7,10 @@ export default class CompileDocMake extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         timeout: Flags.integer({ description: 'Compile timeout in seconds (default: 600)', default: 600 }),
+        'no-wait': Flags.boolean({
+            description: 'Return immediately after triggering compilation. Prints the document ID for manual polling.',
+            default: false,
+        }),
     };
     static args = {
         doc_id: Args.string({ description: 'Document ID', required: true }),
@@ -25,6 +29,13 @@ export default class CompileDocMake 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 ${args.doc_id} --json\n`);
+            }
+            return makeResponse;
+        }
         if (!json)
             process.stderr.write(`Compiling${chunksTotal ? ` (${chunksTotal} chunks)` : ''}:\n`);
         let result;

package/dist/commands/compile/import.d.ts

@@ -6,6 +6,7 @@ export default class CompileImport extends BaseCommand {
         type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         perspective: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'face-speaker': import("@oclif/core/interfaces").OptionFlag<string | undefined, 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/import.js

@@ -25,6 +25,10 @@ export default class CompileImport extends BaseCommand {
         'face-speaker': Flags.string({
             description: 'For --type thread: AssemblyAI speaker label (e.g. "A") that corresponds to the face. Defaults to first detected speaker.',
         }),
+        'no-wait': Flags.boolean({
+            description: 'Return immediately after import starts (do not poll for transcription). Prints the ID for manual polling.',
+            default: false,
+        }),
     };
     static args = {
         face_id: Args.string({ description: 'Face alias', required: true }),
@@ -58,7 +62,15 @@ export default class CompileImport extends BaseCommand {
             }
             throw err;
         }
-        // Poll until transcription completes
+        // Poll until transcription completes — unless --no-wait
+        if (data.prepare_status === 'transcribing' && flags['no-wait']) {
+            const id = (data.thread_id ?? data.document_id);
+            if (!json) {
+                process.stderr.write(`Import started in background (downloading + transcribing).\n`);
+                process.stderr.write(`Poll with: faces compile:${flags.type === 'thread' ? 'thread' : 'doc'}:get ${id} --json\n`);
+            }
+            return data;
+        }
         if (data.prepare_status === 'transcribing') {
             const id = (data.thread_id ?? data.document_id);
             const endpoint = flags.type === 'thread'

package/dist/commands/compile/thread/edit.d.ts

@@ -2,7 +2,8 @@ import { BaseCommand } from '../../../base.js';
 export default class CompileThreadEdit extends BaseCommand {
     static description: string;
     static flags: {
-        label: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        label: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'face-speaker': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         '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/thread/edit.js

@@ -2,10 +2,13 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../../base.js';
 import { FacesAPIError } from '../../../client.js';
 export default class CompileThreadEdit extends BaseCommand {
-    static description = 'Edit a thread (label)';
+    static description = 'Edit a thread (label and/or reassign face speaker)';
     static flags = {
         ...BaseCommand.baseFlags,
-        label: Flags.string({ description: 'New thread label', required: true }),
+        label: Flags.string({ description: 'New thread label' }),
+        'face-speaker': Flags.string({
+            description: 'Reassign face speaker: set this speaker to role=user, all others to role=assistant',
+        }),
     };
     static args = {
         thread_id: Args.string({ description: 'Thread ID', required: true }),
@@ -13,16 +16,77 @@ export default class CompileThreadEdit extends BaseCommand {
     async run() {
         const { args, flags } = await this.parse(CompileThreadEdit);
         const client = this.makeClient(flags);
+        const json = this.jsonEnabled();
+        if (!flags.label && !flags['face-speaker']) {
+            this.error('Provide at least one of --label or --face-speaker');
+        }
+        // If --face-speaker, fetch messages, remap roles, PATCH back
+        if (flags['face-speaker']) {
+            const speaker = flags['face-speaker'];
+            // Fetch current thread
+            let thread;
+            try {
+                thread = await client.get(`/v1/compile/threads/${args.thread_id}`);
+            }
+            catch (err) {
+                if (err instanceof FacesAPIError)
+                    this.error(`Error (${err.statusCode}): ${err.message}`);
+                throw err;
+            }
+            const messages = thread.messages;
+            if (!messages || messages.length === 0) {
+                this.error('Thread has no messages to remap');
+            }
+            // Remap roles
+            let remapped = 0;
+            const updated = messages.map((m) => {
+                const isFace = m.name && m.name.toLowerCase() === speaker.toLowerCase();
+                const newRole = isFace ? 'user' : 'assistant';
+                if (m.role !== newRole)
+                    remapped++;
+                return { role: newRole, content: m.content, from: m.name };
+            });
+            // PATCH messages
+            try {
+                await client.patch(`/v1/compile/threads/${args.thread_id}/messages`, {
+                    body: { messages: updated },
+                });
+            }
+            catch (err) {
+                if (err instanceof FacesAPIError)
+                    this.error(`Error (${err.statusCode}): ${err.message}`);
+                throw err;
+            }
+            if (!json) {
+                const userCount = updated.filter((m) => m.role === 'user').length;
+                const assistantCount = updated.filter((m) => m.role === 'assistant').length;
+                process.stderr.write(`Remapped ${remapped} messages: "${speaker}" → user (${userCount}), all others → assistant (${assistantCount})\n`);
+            }
+        }
+        // If --label, update it
+        if (flags.label) {
+            try {
+                await client.patch(`/v1/compile/threads/${args.thread_id}`, { body: { label: flags.label } });
+            }
+            catch (err) {
+                if (err instanceof FacesAPIError)
+                    this.error(`Error (${err.statusCode}): ${err.message}`);
+                throw err;
+            }
+            if (!json)
+                process.stderr.write(`Label updated to "${flags.label}"\n`);
+        }
+        // Fetch final state and return
         let data;
         try {
-            data = await client.patch(`/v1/compile/threads/${args.thread_id}`, { body: { label: flags.label } });
+            data = await client.get(`/v1/compile/threads/${args.thread_id}`);
         }
         catch (err) {
             if (err instanceof FacesAPIError)
                 this.error(`Error (${err.statusCode}): ${err.message}`);
             throw err;
         }
-        if (!this.jsonEnabled())
+        if (!json)
             this.printHuman(data);
         return data;
     }

package/dist/commands/compile/thread/make.d.ts

@@ -3,6 +3,7 @@ export default class CompileThreadMake extends BaseCommand {
     static description: string;
     static flags: {
         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/thread/make.js

@@ -7,6 +7,10 @@ export default class CompileThreadMake extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         timeout: Flags.integer({ description: 'Compile timeout in seconds (default: 600)', default: 600 }),
+        'no-wait': Flags.boolean({
+            description: 'Return immediately after triggering compilation. Prints the thread ID for manual polling.',
+            default: false,
+        }),
     };
     static args = {
         thread_id: Args.string({ description: 'Thread ID', required: true }),
@@ -25,6 +29,13 @@ export default class CompileThreadMake 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:thread:get ${args.thread_id} --json\n`);
+            }
+            return makeResponse;
+        }
         if (!json)
             process.stderr.write(`Compiling${chunksTotal ? ` (${chunksTotal} chunks)` : ''}:\n`);
         let result;

package/dist/commands/compile/upload.d.ts

@@ -6,6 +6,7 @@ export default class CompileUpload extends BaseCommand {
         kind: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         perspective: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'face-speaker': import("@oclif/core/interfaces").OptionFlag<string | undefined, 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/upload.js

@@ -24,6 +24,10 @@ export default class CompileUpload extends BaseCommand {
         'face-speaker': Flags.string({
             description: 'Speaker name to map to the face (thread only). If omitted, auto-detected from face name.',
         }),
+        'no-wait': Flags.boolean({
+            description: 'Return immediately after upload (do not poll for transcription). Prints the ID for manual polling.',
+            default: false,
+        }),
     };
     static args = {
         alias: Args.string({ description: 'Face alias', required: true }),
@@ -52,7 +56,15 @@ export default class CompileUpload extends BaseCommand {
                 this.error(`Error (${err.statusCode}): ${err.message}`);
             throw err;
         }
-        // If transcribing (audio/video upload), poll until complete
+        // If transcribing (audio/video upload), poll until complete — unless --no-wait
+        if (data.prepare_status === 'transcribing' && flags['no-wait']) {
+            const id = (data.thread_id ?? data.document_id);
+            if (!json) {
+                process.stderr.write(`Transcription started in background.\n`);
+                process.stderr.write(`Poll with: faces compile:${flags.kind === 'thread' ? 'thread' : 'doc'}:get ${id} --json\n`);
+            }
+            return data;
+        }
         if (data.prepare_status === 'transcribing') {
             const id = (data.thread_id ?? data.document_id);
             const endpoint = flags.kind === 'thread'