faces-cli 1.5.14 → 1.6.0

package/dist/commands/chat/messages.js

@@ -9,6 +9,7 @@ export default class ChatMessages extends BaseCommand {
         system: Flags.string({ description: 'System prompt' }),
         stream: Flags.boolean({ description: 'Stream the response', default: false }),
         'max-tokens': Flags.integer({ description: 'Max tokens', default: 1024 }),
+        'oauth-only': Flags.boolean({ description: 'Prevent fallback to paid system key (use OAuth only)', default: false }),
     };
     static args = {
         face_model: Args.string({ description: 'Face model (e.g. myface or myface@claude-sonnet-4-6)', required: true }),
@@ -25,6 +26,8 @@ export default class ChatMessages extends BaseCommand {
         };
         if (flags.system)
             payload.system = flags.system;
+        if (flags['oauth-only'])
+            payload.oauth_only = true;
         try {
             if (flags.stream) {
                 for await (const line of client.stream('/v1/messages', payload)) {
@@ -48,20 +51,36 @@ export default class ChatMessages extends BaseCommand {
                 process.stdout.write('\n');
                 return {};
             }
-            const data = (await client.post('/v1/messages', { body: payload }));
-            if (this.jsonEnabled())
-                return data;
+            const { data, headers } = await client.postWithHeaders('/v1/messages', { body: payload });
+            const body = data;
+            if (this.jsonEnabled()) {
+                const meta = {};
+                if (headers['x-faces-provider'])
+                    meta.provider = headers['x-faces-provider'];
+                if (headers['x-faces-cost-usd'])
+                    meta.cost_usd = headers['x-faces-cost-usd'];
+                if (Object.keys(meta).length > 0)
+                    body._meta = meta;
+                return body;
+            }
             let content = '';
-            for (const block of data.content ?? []) {
+            for (const block of body.content ?? []) {
                 if (block.type === 'text')
                     content += String(block.text ?? '');
             }
             this.log(content);
-            return data;
+            return body;
         }
         catch (err) {
-            if (err instanceof FacesAPIError)
+            if (err instanceof FacesAPIError) {
+                if (err.errorCode === 'oauth_rejected') {
+                    const hint = err.fallbackAvailable
+                        ? 'Run `faces account:preferences api_fallback true` to allow paid fallback.'
+                        : 'Run `faces billing:topup` to add credits, then enable fallback with `faces account:preferences api_fallback true`.';
+                    this.error(`OAuth failed: ${err.message}\n${hint}`);
+                }
                 this.error(`Error (${err.statusCode}): ${err.message}`);
+            }
             throw err;
         }
     }

package/dist/commands/chat/responses.d.ts

@@ -5,6 +5,7 @@ export default class ChatResponses extends BaseCommand {
         message: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         instructions: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         stream: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'oauth-only': 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/chat/responses.js

@@ -8,6 +8,7 @@ export default class ChatResponses extends BaseCommand {
         message: Flags.string({ char: 'm', description: 'User input message', required: true }),
         instructions: Flags.string({ description: 'System instructions' }),
         stream: Flags.boolean({ description: 'Stream the response', default: false }),
+        'oauth-only': Flags.boolean({ description: 'Prevent fallback to paid system key (use OAuth only)', default: false }),
     };
     static args = {
         face_model: Args.string({ description: 'Face model (e.g. myface or myface@gpt-4o)', required: true }),
@@ -22,6 +23,8 @@ export default class ChatResponses extends BaseCommand {
         };
         if (flags.instructions)
             payload.instructions = flags.instructions;
+        if (flags['oauth-only'])
+            payload.oauth_only = true;
         try {
             if (flags.stream) {
                 for await (const line of client.stream('/v1/responses', payload)) {
@@ -45,22 +48,38 @@ export default class ChatResponses extends BaseCommand {
                 process.stdout.write('\n');
                 return {};
             }
-            const data = (await client.post('/v1/responses', { body: payload }));
-            if (this.jsonEnabled())
-                return data;
+            const { data, headers } = await client.postWithHeaders('/v1/responses', { body: payload });
+            const body = data;
+            if (this.jsonEnabled()) {
+                const meta = {};
+                if (headers['x-faces-provider'])
+                    meta.provider = headers['x-faces-provider'];
+                if (headers['x-faces-cost-usd'])
+                    meta.cost_usd = headers['x-faces-cost-usd'];
+                if (Object.keys(meta).length > 0)
+                    body._meta = meta;
+                return body;
+            }
             let outputText = '';
-            for (const item of data.output ?? []) {
+            for (const item of body.output ?? []) {
                 for (const block of item.content ?? []) {
                     if (block.type === 'output_text')
                         outputText += String(block.text ?? '');
                 }
             }
             this.log(outputText);
-            return data;
+            return body;
         }
         catch (err) {
-            if (err instanceof FacesAPIError)
+            if (err instanceof FacesAPIError) {
+                if (err.errorCode === 'oauth_rejected') {
+                    const hint = err.fallbackAvailable
+                        ? 'Run `faces account:preferences api_fallback true` to allow paid fallback.'
+                        : 'Run `faces billing:topup` to add credits, then enable fallback with `faces account:preferences api_fallback true`.';
+                    this.error(`OAuth failed: ${err.message}\n${hint}`);
+                }
                 this.error(`Error (${err.statusCode}): ${err.message}`);
+            }
             throw err;
         }
     }

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

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../base.js';
+export default class CompileAll 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>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/compile/all.js

@@ -0,0 +1,116 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+import { pollCompileProgress } from '../../poll.js';
+export default class CompileAll extends BaseCommand {
+    static description = 'Compile all uncompiled documents and threads across all faces';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        timeout: Flags.integer({ description: 'Per-item compile timeout in seconds (default: 600)', default: 600 }),
+    };
+    async run() {
+        const { flags } = await this.parse(CompileAll);
+        const client = this.makeClient(flags);
+        const json = this.jsonEnabled();
+        // Fetch all faces
+        let faces;
+        try {
+            const resp = await client.get('/v1/faces');
+            faces = (resp.data ?? resp);
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        // Collect uncompiled items
+        const items = [];
+        for (const face of faces) {
+            const alias = face.alias;
+            if (face.formula)
+                continue; // composite faces have no source material
+            // Check documents
+            try {
+                const docs = await client.get('/v1/compile/documents', { params: { alias } });
+                for (const doc of docs) {
+                    const status = doc.prepare_status;
+                    if (status !== 'synced' && status !== 'ready') {
+                        items.push({
+                            type: 'document',
+                            id: doc.document_id,
+                            alias,
+                            label: doc.label ?? null,
+                        });
+                    }
+                }
+            }
+            catch { /* no docs */ }
+            // Check threads
+            try {
+                const threads = await client.get('/v1/compile/threads', { params: { alias } });
+                for (const thread of threads) {
+                    const status = thread.prepare_status;
+                    if (status !== 'synced' && status !== 'ready') {
+                        items.push({
+                            type: 'thread',
+                            id: thread.thread_id,
+                            alias,
+                            label: thread.label ?? null,
+                        });
+                    }
+                }
+            }
+            catch { /* no threads */ }
+        }
+        if (items.length === 0) {
+            if (!json)
+                this.log('Nothing to compile — all documents and threads are up to date.');
+            return { compiled: 0, failed: 0, items: [] };
+        }
+        if (!json)
+            this.log(`Found ${items.length} item(s) to compile\n`);
+        let compiled = 0;
+        let failed = 0;
+        const results = [];
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            const tag = `[${i + 1}/${items.length}]`;
+            const name = item.label ?? item.id.slice(0, 8);
+            if (!json)
+                process.stderr.write(`${tag} ${item.type} "${name}" (${item.alias})... `);
+            const makeEndpoint = item.type === 'document'
+                ? `/v1/compile/documents/${item.id}/make`
+                : `/v1/compile/threads/${item.id}/make`;
+            const pollEndpoint = item.type === 'document'
+                ? `/v1/compile/documents/${item.id}`
+                : `/v1/compile/threads/${item.id}`;
+            try {
+                await client.post(makeEndpoint);
+                await pollCompileProgress(client, item.id, {
+                    timeoutMs: flags.timeout * 1000,
+                    endpoint: pollEndpoint,
+                    onProgress: (p) => {
+                        if (!json) {
+                            process.stderr.write(`[${p.chunks_completed ?? '?'}/${p.chunks_total ?? '?'}] `);
+                        }
+                    },
+                });
+                compiled++;
+                results.push({ ...item, status: 'compiled' });
+                if (!json)
+                    process.stderr.write('done\n');
+            }
+            catch (err) {
+                failed++;
+                const msg = err instanceof FacesAPIError ? `${err.statusCode}: ${err.message}` : err instanceof Error ? err.message : String(err);
+                results.push({ ...item, status: `failed: ${msg}` });
+                if (!json)
+                    process.stderr.write(`failed: ${msg}\n`);
+            }
+        }
+        if (!json) {
+            this.log(`\nCompile complete: ${compiled} succeeded, ${failed} failed`);
+        }
+        return { compiled, failed, items: results };
+    }
+}

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

@@ -3,6 +3,7 @@ export default class CompileThreadCreate extends BaseCommand {
     static description: string;
     static flags: {
         label: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'oauth-only': 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/create.js

@@ -6,6 +6,7 @@ export default class CompileThreadCreate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         label: Flags.string({ description: 'Thread label' }),
+        'oauth-only': Flags.boolean({ description: 'Prevent fallback to paid system key (use OAuth only)', default: false }),
     };
     static args = {
         face_id: Args.string({ description: 'Face alias', required: true }),
@@ -16,13 +17,22 @@ export default class CompileThreadCreate extends BaseCommand {
         const payload = { alias: args.face_id };
         if (flags.label)
             payload.label = flags.label;
+        if (flags['oauth-only'])
+            payload.oauth_only = true;
         let data;
         try {
             data = await client.post('/v1/compile/threads', { body: payload });
         }
         catch (err) {
-            if (err instanceof FacesAPIError)
+            if (err instanceof FacesAPIError) {
+                if (err.errorCode === 'oauth_rejected') {
+                    const hint = err.fallbackAvailable
+                        ? 'Run `faces account:preferences api_fallback true` to allow paid fallback.'
+                        : 'Run `faces billing:topup` to add credits, then enable fallback with `faces account:preferences api_fallback true`.';
+                    this.error(`OAuth failed: ${err.message}\n${hint}`);
+                }
                 this.error(`Error (${err.statusCode}): ${err.message}`);
+            }
             throw err;
         }
         if (!this.jsonEnabled())

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

@@ -3,6 +3,7 @@ export default class CompileThreadMessage extends BaseCommand {
     static description: string;
     static flags: {
         message: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'oauth-only': 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/message.js

@@ -6,6 +6,7 @@ export default class CompileThreadMessage extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         message: Flags.string({ char: 'm', description: 'User message to append', required: true }),
+        'oauth-only': Flags.boolean({ description: 'Prevent fallback to paid system key (use OAuth only)', default: false }),
     };
     static args = {
         thread_id: Args.string({ description: 'Thread ID', required: true }),
@@ -13,15 +14,25 @@ export default class CompileThreadMessage extends BaseCommand {
     async run() {
         const { args, flags } = await this.parse(CompileThreadMessage);
         const client = this.makeClient(flags);
+        const payload = { message: flags.message };
+        if (flags['oauth-only'])
+            payload.oauth_only = true;
         let data;
         try {
             data = await client.post(`/v1/compile/threads/${args.thread_id}/messages`, {
-                body: { message: flags.message },
+                body: payload,
             });
         }
         catch (err) {
-            if (err instanceof FacesAPIError)
+            if (err instanceof FacesAPIError) {
+                if (err.errorCode === 'oauth_rejected') {
+                    const hint = err.fallbackAvailable
+                        ? 'Run `faces account:preferences api_fallback true` to allow paid fallback.'
+                        : 'Run `faces billing:topup` to add credits, then enable fallback with `faces account:preferences api_fallback true`.';
+                    this.error(`OAuth failed: ${err.message}\n${hint}`);
+                }
                 this.error(`Error (${err.statusCode}): ${err.message}`);
+            }
             throw err;
         }
         if (!this.jsonEnabled())