faces-cli 1.4.2 → 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.js

@@ -49,8 +49,18 @@ export default class FaceUpload extends BaseCommand {
                 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,

package/oclif.manifest.json

@@ -3555,6 +3555,74 @@
         "list.js"
       ]
     },
+    "compile:thread:make": {
+      "aliases": [],
+      "args": {
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
+          "required": true
+        }
+      },
+      "description": "Compile an existing thread (prepare + sync in one step)",
+      "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"
+        },
+        "timeout": {
+          "description": "Compile timeout in seconds (default: 600)",
+          "name": "timeout",
+          "default": 600,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "compile:thread:make",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "thread",
+        "make.js"
+      ]
+    },
     "compile:thread:message": {
       "aliases": [],
       "args": {
@@ -3685,5 +3753,5 @@
       ]
     }
   },
-  "version": "1.4.2"
+  "version": "1.4.3"
 }

package/package.json

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