faces-cli 1.4.1 → 1.4.3

package/dist/commands/compile/import.js

@@ -72,7 +72,7 @@ export default class CompileImport extends BaseCommand {
                 this.log(`label:       ${thread.label}`);
                 this.log(``);
                 this.log(`Next step:`);
-                this.log(`  faces compile:thread:sync ${thread.thread_id}`);
+                this.log(`  faces compile:thread:make ${thread.thread_id}`);
             }
         }
         return data;

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

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../../base.js';
+export default class CompileThreadMake extends BaseCommand {
+    static description: string;
+    static flags: {
+        timeout: import("@oclif/core/interfaces").OptionFlag<number, 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>;
+    };
+    static args: {
+        thread_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<unknown>;
+}

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

@@ -0,0 +1,56 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+import { pollCompileProgress } from '../../../poll.js';
+export default class CompileThreadMake extends BaseCommand {
+    static description = 'Compile an existing thread (prepare + sync in one step)';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        timeout: Flags.integer({ description: 'Compile timeout in seconds (default: 600)', default: 600 }),
+    };
+    static args = {
+        thread_id: Args.string({ description: 'Thread ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(CompileThreadMake);
+        const client = this.makeClient(flags);
+        const json = this.jsonEnabled();
+        let makeResponse;
+        try {
+            makeResponse = await client.post(`/v1/compile/threads/${args.thread_id}/make`);
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        const chunksTotal = makeResponse.chunks_total;
+        if (!json)
+            process.stderr.write(`Compiling${chunksTotal ? ` (${chunksTotal} chunks)` : ''}:\n`);
+        let result;
+        try {
+            result = await pollCompileProgress(client, args.thread_id, {
+                timeoutMs: flags.timeout * 1000,
+                endpoint: `/v1/compile/threads/${args.thread_id}`,
+                onProgress: (p) => {
+                    if (!json) {
+                        const c = p.current_counts;
+                        const counts = c ? `ε=${c.epsilon} β=${c.beta} δ=${c.delta} α=${c.alpha}` : '';
+                        const phase = p.prepare_status === 'syncing' ? ' (syncing)' : '';
+                        process.stderr.write(`  [${p.chunks_completed ?? '?'}/${p.chunks_total ?? '?'}] ${counts}${phase}\n`);
+                    }
+                },
+            });
+        }
+        catch (err) {
+            if (err instanceof Error)
+                this.error(err.message);
+            throw err;
+        }
+        if (!json)
+            process.stderr.write('Done.\n');
+        if (json)
+            this.log(JSON.stringify(result, null, 2));
+        return result;
+    }
+}

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

@@ -4,6 +4,8 @@ export default class FaceUpload extends BaseCommand {
     static flags: {
         file: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         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>;
         '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/face/upload.js

@@ -13,6 +13,14 @@ export default class FaceUpload extends BaseCommand {
             options: ['document', 'thread'],
             default: 'document',
         }),
+        perspective: Flags.string({
+            description: 'Perspective (document only)',
+            options: ['first-person', 'third-person'],
+            default: 'third-person',
+        }),
+        'face-speaker': Flags.string({
+            description: 'Speaker name to map to the face (thread only). If omitted, first speaker is used.',
+        }),
     };
     static args = {
         face_id: Args.string({ description: 'Face ID or username', required: true }),
@@ -26,18 +34,33 @@ export default class FaceUpload extends BaseCommand {
         const fileBlob = new Blob([fs.readFileSync(flags.file)], { type: 'application/octet-stream' });
         const form = new FormData();
         form.append('file', fileBlob, filename);
-        form.append('type', flags.kind);
+        // type, perspective, face_speaker are query params (not form fields)
+        const params = new URLSearchParams();
+        params.set('type', flags.kind);
+        params.set('perspective', flags.perspective);
+        if (flags['face-speaker'])
+            params.set('face_speaker', flags['face-speaker']);
         let data;
         try {
-            data = await client.postForm(`/v1/faces/${args.face_id}/upload`, form);
+            data = await client.postForm(`/v1/faces/${args.face_id}/upload?${params}`, form);
         }
         catch (err) {
             if (err instanceof FacesAPIError)
                 this.error(`Error (${err.statusCode}): ${err.message}`);
             throw err;
         }
-        if (!this.jsonEnabled())
+        if (!this.jsonEnabled()) {
             this.printHuman(data);
+            const res = data;
+            if (flags.kind === 'thread' && res.thread_id) {
+                this.log(`\nNext step:`);
+                this.log(`  faces compile:thread:make ${res.thread_id}`);
+            }
+            else if (flags.kind === 'document' && res.document_id) {
+                this.log(`\nNext step:`);
+                this.log(`  faces compile:doc:make ${res.document_id}`);
+            }
+        }
         return data;
     }
 }

package/dist/poll.d.ts

@@ -1,5 +1,5 @@
 /**
- * Shared polling helper for document compile progress.
+ * Shared polling helper for compile progress (documents and threads).
  *
  * Works with both /make (preparing → syncing → synced) and
  * legacy /prepare (processing → ready) status flows.
@@ -20,11 +20,13 @@ export interface PollOptions {
     intervalMs?: number;
     timeoutMs?: number;
     onProgress?: (p: PollProgress) => void;
+    /** Override the GET endpoint path. Defaults to /v1/compile/documents/{id}. */
+    endpoint?: string;
 }
 /**
- * Poll GET /compile/documents/{docId} until a terminal status is reached.
+ * Poll a compile GET endpoint until a terminal status is reached.
  * Terminal statuses: "synced" (from /make), "ready" (from /prepare), "failed".
  * Returns the final GET response.
  * Throws on timeout or failure.
  */
-export declare function pollCompileProgress(client: FacesClient, docId: string, opts?: PollOptions): Promise<unknown>;
+export declare function pollCompileProgress(client: FacesClient, id: string, opts?: PollOptions): Promise<unknown>;

package/dist/poll.js

@@ -1,20 +1,21 @@
 /**
- * Poll GET /compile/documents/{docId} until a terminal status is reached.
+ * Poll a compile GET endpoint until a terminal status is reached.
  * Terminal statuses: "synced" (from /make), "ready" (from /prepare), "failed".
  * Returns the final GET response.
  * Throws on timeout or failure.
  */
-export async function pollCompileProgress(client, docId, opts = {}) {
+export async function pollCompileProgress(client, id, opts = {}) {
     const interval = opts.intervalMs ?? 3000;
     const timeout = opts.timeoutMs ?? 600_000;
     const start = Date.now();
+    const endpoint = opts.endpoint ?? `/v1/compile/documents/${id}`;
     let lastChunks = -1;
     while (true) {
         if (Date.now() - start > timeout) {
             throw new Error(`Compile timed out after ${Math.round(timeout / 1000)}s`);
         }
         await sleep(interval);
-        const data = await client.get(`/v1/compile/documents/${docId}`);
+        const data = await client.get(endpoint);
         const progress = {
             prepare_status: data.prepare_status ?? null,
             chunks_total: data.chunks_total ?? null,