faces-cli 1.0.0

package/dist/commands/billing/balance.js

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class BillingBalance extends BaseCommand {
+    static description = 'Show credit balance and payment method status';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(BillingBalance);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get('/v1/billing/balance');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/billing/card-setup.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base.js';
+export default class BillingCardSetup extends BaseCommand {
+    static description: string;
+    static flags: {
+        '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/billing/card-setup.js

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class BillingCardSetup extends BaseCommand {
+    static description = 'Get a Stripe card setup URL to save a payment method';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(BillingCardSetup);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.post('/v1/billing/card-setup');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/billing/checkout.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../base.js';
+export default class BillingCheckout extends BaseCommand {
+    static description: string;
+    static flags: {
+        plan: import("@oclif/core/interfaces").OptionFlag<string, 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/billing/checkout.js

@@ -0,0 +1,30 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class BillingCheckout extends BaseCommand {
+    static description = 'Get a Stripe checkout URL to upgrade your subscription plan';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        plan: Flags.string({
+            description: 'Plan to upgrade to',
+            options: ['standard', 'pro'],
+            required: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(BillingCheckout);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.post(`/v1/billing/checkout?plan=${flags.plan}`);
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/billing/llm-costs.d.ts

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

package/dist/commands/billing/llm-costs.js

@@ -0,0 +1,29 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class BillingLlmCosts extends BaseCommand {
+    static description = 'List available LLMs and their per-token costs';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        provider: Flags.string({ description: 'Filter by provider (e.g. openai, anthropic)' }),
+    };
+    async run() {
+        const { flags } = await this.parse(BillingLlmCosts);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get('/v1/billing/llm-costs');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (flags.provider && Array.isArray(data)) {
+            data = data.filter((row) => String(row.provider ?? '').toLowerCase() === flags.provider.toLowerCase());
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/billing/quota.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base.js';
+export default class BillingQuota extends BaseCommand {
+    static description: string;
+    static flags: {
+        '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/billing/quota.js

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class BillingQuota extends BaseCommand {
+    static description = 'Show compile token quota and per-face stats';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(BillingQuota);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get('/v1/billing/compile-quota');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/billing/subscription.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base.js';
+export default class BillingSubscription extends BaseCommand {
+    static description: string;
+    static flags: {
+        '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/billing/subscription.js

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class BillingSubscription extends BaseCommand {
+    static description = 'Show current plan, face count, and renewal date';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(BillingSubscription);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get('/v1/billing/subscription');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/billing/topup.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base.js';
+export default class BillingTopup extends BaseCommand {
+    static description: string;
+    static flags: {
+        amount: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'payment-ref': 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>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/billing/topup.js

@@ -0,0 +1,33 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class BillingTopup extends BaseCommand {
+    static description = 'Top up credit balance using saved payment method';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        amount: Flags.string({ description: 'Top-up amount in USD (min $1)', required: true }),
+        'payment-ref': Flags.string({ description: 'Payment reference (admin/test path)' }),
+    };
+    async run() {
+        const { flags } = await this.parse(BillingTopup);
+        const client = this.makeClient(flags);
+        const amount = Number.parseFloat(flags.amount);
+        if (Number.isNaN(amount) || amount < 1.0)
+            this.error('Minimum topup is $1.00 (--amount)');
+        const payload = { amount };
+        if (flags['payment-ref'])
+            payload.payment_ref = flags['payment-ref'];
+        let data;
+        try {
+            data = await client.post('/v1/billing/topup', { body: payload });
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/billing/usage.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base.js';
+export default class BillingUsage extends BaseCommand {
+    static description: string;
+    static flags: {
+        'group-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        to: 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>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/billing/usage.js

@@ -0,0 +1,38 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class BillingUsage extends BaseCommand {
+    static description = 'Aggregated usage analytics';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'group-by': Flags.string({
+            description: 'Group results',
+            options: ['api_key', 'model', 'llm', 'date'],
+        }),
+        from: Flags.string({ description: 'Start date (YYYY-MM-DD)' }),
+        to: Flags.string({ description: 'End date (YYYY-MM-DD)' }),
+    };
+    async run() {
+        const { flags } = await this.parse(BillingUsage);
+        const client = this.makeClient(flags);
+        const params = {};
+        if (flags['group-by'])
+            params.group_by = flags['group-by'];
+        if (flags.from)
+            params.from = flags.from;
+        if (flags.to)
+            params.to = flags.to;
+        let data;
+        try {
+            data = await client.get('/v1/billing/usage', { params });
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

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

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../base.js';
+export default class ChatChat extends BaseCommand {
+    static description: string;
+    static flags: {
+        message: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        llm: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        system: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        stream: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'max-tokens': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        temperature: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        file: 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>;
+    };
+    static args: {
+        face_username: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/chat/chat.js

@@ -0,0 +1,81 @@
+import { Args, Flags } from '@oclif/core';
+import fs from 'node:fs';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class ChatChat extends BaseCommand {
+    static description = 'OpenAI-compatible chat completion via a face';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        message: Flags.string({ char: 'm', description: 'User message (repeatable)', multiple: true, required: false }),
+        llm: Flags.string({ description: 'LLM override (e.g. claude-sonnet-4-6)' }),
+        system: Flags.string({ description: 'System prompt override' }),
+        stream: Flags.boolean({ description: 'Stream the response', default: false }),
+        'max-tokens': Flags.integer({ description: 'Max tokens' }),
+        temperature: Flags.string({ description: 'Temperature (0.0-2.0)' }),
+        file: Flags.string({ description: 'Read message from file' }),
+    };
+    static args = {
+        face_username: Args.string({ description: 'Face username', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ChatChat);
+        const client = this.makeClient(flags);
+        const messages = [];
+        if (flags.system)
+            messages.push({ role: 'system', content: flags.system });
+        if (flags.file) {
+            if (!fs.existsSync(flags.file))
+                this.error(`File not found: ${flags.file}`);
+            messages.push({ role: 'user', content: fs.readFileSync(flags.file, 'utf8') });
+        }
+        else if (flags.message && flags.message.length > 0) {
+            for (const m of flags.message)
+                messages.push({ role: 'user', content: m });
+        }
+        else {
+            this.error('Provide at least one --message/-m or --file');
+        }
+        const model = flags.llm ? `${args.face_username}@${flags.llm}` : args.face_username;
+        const payload = { model, messages, stream: flags.stream };
+        if (flags['max-tokens'])
+            payload.max_tokens = flags['max-tokens'];
+        if (flags.temperature !== undefined)
+            payload.temperature = Number.parseFloat(flags.temperature);
+        try {
+            if (flags.stream) {
+                for await (const line of client.stream('/v1/chat/completions', payload)) {
+                    if (!line.startsWith('data: '))
+                        continue;
+                    const chunk = line.slice(6);
+                    if (chunk.trim() === '[DONE]')
+                        break;
+                    try {
+                        const parsed = JSON.parse(chunk);
+                        const choices = parsed?.choices;
+                        const delta = choices?.[0]?.delta?.content ?? '';
+                        if (delta)
+                            process.stdout.write(String(delta));
+                    }
+                    catch {
+                        // ignore parse errors
+                    }
+                }
+                process.stdout.write('\n');
+                return {};
+            }
+            const data = (await client.post('/v1/chat/completions', { body: payload }));
+            if (this.jsonEnabled())
+                return data;
+            const choices = data.choices;
+            const message = choices?.[0]?.message;
+            const content = message?.content ?? '';
+            this.log(String(content));
+            return data;
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+    }
+}

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

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../../base.js';
+export default class ChatMessages extends BaseCommand {
+    static description: string;
+    static flags: {
+        message: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        system: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        stream: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'max-tokens': 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: {
+        face_model: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/chat/messages.js

@@ -0,0 +1,68 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class ChatMessages extends BaseCommand {
+    static description = 'Anthropic Messages API proxy via a face (e.g. face@claude-sonnet-4-6)';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        message: Flags.string({ char: 'm', description: 'User message (repeatable)', multiple: true, required: true }),
+        system: Flags.string({ description: 'System prompt' }),
+        stream: Flags.boolean({ description: 'Stream the response', default: false }),
+        'max-tokens': Flags.integer({ description: 'Max tokens', default: 1024 }),
+    };
+    static args = {
+        face_model: Args.string({ description: 'Face model (e.g. myface or myface@claude-sonnet-4-6)', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ChatMessages);
+        const client = this.makeClient(flags);
+        const msgs = flags.message.map((m) => ({ role: 'user', content: m }));
+        const payload = {
+            model: args.face_model,
+            messages: msgs,
+            max_tokens: flags['max-tokens'],
+            stream: flags.stream,
+        };
+        if (flags.system)
+            payload.system = flags.system;
+        try {
+            if (flags.stream) {
+                for await (const line of client.stream('/v1/messages', payload)) {
+                    if (!line.startsWith('data: '))
+                        continue;
+                    const chunk = line.slice(6);
+                    if (chunk.trim() === '[DONE]' || chunk.trim() === '')
+                        continue;
+                    try {
+                        const obj = JSON.parse(chunk);
+                        if (obj.type === 'content_block_delta') {
+                            const delta = obj.delta?.text ?? '';
+                            if (delta)
+                                process.stdout.write(String(delta));
+                        }
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+                process.stdout.write('\n');
+                return {};
+            }
+            const data = (await client.post('/v1/messages', { body: payload }));
+            if (this.jsonEnabled())
+                return data;
+            let content = '';
+            for (const block of data.content ?? []) {
+                if (block.type === 'text')
+                    content += String(block.text ?? '');
+            }
+            this.log(content);
+            return data;
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+    }
+}

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

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

package/dist/commands/chat/responses.js

@@ -0,0 +1,67 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class ChatResponses extends BaseCommand {
+    static description = 'OpenAI Responses API proxy via a face';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        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 }),
+    };
+    static args = {
+        face_model: Args.string({ description: 'Face model (e.g. myface or myface@gpt-4o)', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ChatResponses);
+        const client = this.makeClient(flags);
+        const payload = {
+            model: args.face_model,
+            input: flags.message,
+            stream: flags.stream,
+        };
+        if (flags.instructions)
+            payload.instructions = flags.instructions;
+        try {
+            if (flags.stream) {
+                for await (const line of client.stream('/v1/responses', payload)) {
+                    if (!line.startsWith('data: '))
+                        continue;
+                    const chunk = line.slice(6);
+                    if (chunk.trim() === '[DONE]' || chunk.trim() === '')
+                        continue;
+                    try {
+                        const obj = JSON.parse(chunk);
+                        if (obj.type === 'response.output_text.delta') {
+                            const delta = obj.delta ?? '';
+                            if (delta)
+                                process.stdout.write(String(delta));
+                        }
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+                process.stdout.write('\n');
+                return {};
+            }
+            const data = (await client.post('/v1/responses', { body: payload }));
+            if (this.jsonEnabled())
+                return data;
+            let outputText = '';
+            for (const item of data.output ?? []) {
+                for (const block of item.content ?? []) {
+                    if (block.type === 'output_text')
+                        outputText += String(block.text ?? '');
+                }
+            }
+            this.log(outputText);
+            return data;
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+    }
+}

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

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../../base.js';
+export default class CompileDocCreate extends BaseCommand {
+    static description: string;
+    static flags: {
+        label: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        content: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        file: 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>;
+    };
+    static args: {
+        face_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<unknown>;
+}