faces-cli 1.7.5 → 1.7.7

package/dist/commands/chat/chat.js

@@ -195,6 +195,14 @@ export default class ChatChat extends BaseCommand {
         };
         if (flags.system)
             payload.instructions = flags.system;
+        // Responses names the output cap `max_output_tokens`, not `max_tokens`.
+        // `temperature` is accepted per-model (gpt-5.1/5.2/5.4 yes; gpt-5.5/5.6-*/o3
+        // no) with no capability flag to query, so we always send what the user asked
+        // for — the backend strips the param and retries when a model 400s on it.
+        if (flags['max-tokens'])
+            payload.max_output_tokens = flags['max-tokens'];
+        if (flags.temperature !== undefined)
+            payload.temperature = Number.parseFloat(flags.temperature);
         if (flags['oauth-only'])
             payload.oauth_only = true;
         if (flags.stream) {

package/dist/commands/face/get.js

@@ -39,6 +39,8 @@ export default class FaceGet extends BaseCommand {
             this.log(`name:      ${f.name}`);
             this.log(`owned_by:  ${f.owned_by}`);
             this.log(`created:   ${new Date(f.created * 1000).toISOString().slice(0, 10)}`);
+            if (f.read_only)
+                this.log('read only');
             if (f.formula) {
                 this.log(`formula:   ${f.formula}`);
                 this.log(`type:      composite`);

package/dist/commands/face/list.js

@@ -102,6 +102,8 @@ export default class FaceList extends BaseCommand {
                     }
                     if (f.published)
                         suffix += '  [public · requires @model]';
+                    if (f.read_only)
+                        suffix += '  [read only]';
                     this.log(`${handle(f).padEnd(handleWidth)}  ${f.name.padEnd(nameWidth)}${suffix}`);
                 }
             }

package/dist/commands/{voiceprint/get.d.ts → face/lock.d.ts}

@@ -1,5 +1,5 @@
 import { BaseCommand } from '../../base.js';
-export default class VoiceprintGet extends BaseCommand {
+export default class FaceLock extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
@@ -8,7 +8,7 @@ export default class VoiceprintGet extends BaseCommand {
         'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     static args: {
-        job_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        face_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     run(): Promise<unknown>;
 }

package/dist/commands/face/lock.js

@@ -0,0 +1,34 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class FaceLock extends BaseCommand {
+    static description = 'Lock a face (read-only). A locked face still reads and chats normally, but it — and everything it owns (documents, threads, voiceprint) — cannot be changed until unlocked.';
+    static examples = ['<%= config.bin %> <%= command.id %> socrates'];
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    static args = {
+        face_id: Args.string({ description: 'Face alias', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FaceLock);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.patch(`/v1/faces/${args.face_id}/lock`, { body: { read_only: true } });
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled()) {
+            const res = data;
+            this.log(`Locked '${res.alias ?? args.face_id}' — read only.`);
+            const affected = res.affected ?? [];
+            if (affected.length > 0)
+                this.log(`Affected: ${affected.join(', ')}`);
+        }
+        return data;
+    }
+}

package/dist/commands/{voiceprint/revert.d.ts → face/unlock.d.ts}

@@ -1,5 +1,5 @@
 import { BaseCommand } from '../../base.js';
-export default class VoiceprintRevert extends BaseCommand {
+export default class FaceUnlock extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
@@ -8,7 +8,7 @@ export default class VoiceprintRevert extends BaseCommand {
         'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     static args: {
-        self_alias: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        face_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     run(): Promise<unknown>;
 }

package/dist/commands/face/unlock.js

@@ -0,0 +1,34 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class FaceUnlock extends BaseCommand {
+    static description = 'Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, voiceprint).';
+    static examples = ['<%= config.bin %> <%= command.id %> socrates'];
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    static args = {
+        face_id: Args.string({ description: 'Face alias', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FaceUnlock);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.patch(`/v1/faces/${args.face_id}/lock`, { body: { read_only: false } });
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled()) {
+            const res = data;
+            this.log(`Unlocked '${res.alias ?? args.face_id}' — writable.`);
+            const affected = res.affected ?? [];
+            if (affected.length > 0)
+                this.log(`Affected: ${affected.join(', ')}`);
+        }
+        return data;
+    }
+}

package/dist/utils.d.ts

@@ -1,20 +1,5 @@
 /** Max length of a face's profile_addendum (per-face system prompt). Mirrors the backend. */
 export declare const PROFILE_ADDENDUM_MAX_CHARS = 100000;
-export interface VoiceprintEmail {
-    id: string;
-    text: string;
-}
-/**
- * Load voiceprint writing samples from a JSON/JSONL file or a directory.
- *
- * - `file`: a JSON array of `{id?, text}` objects or plain strings, OR JSONL
- *   (one such value per line). The format is auto-detected.
- * - `dir`: one sample per non-hidden file; `id` is the filename (sans extension),
- *   `text` is the file contents. Files are sorted by name; empty files are skipped.
- *
- * Throws on a missing path, malformed content, or no usable samples.
- */
-export declare function loadVoiceprintEmails(file: string | undefined, dir: string | undefined): VoiceprintEmail[];
 /**
  * Resolve a face's profile_addendum from the `--profile-addendum` / `--profile-addendum-file`
  * flags. Returns undefined when neither is given (field left unchanged). Throws on a missing

package/dist/utils.js

@@ -1,81 +1,6 @@
 import fs from 'node:fs';
-import path from 'node:path';
 /** Max length of a face's profile_addendum (per-face system prompt). Mirrors the backend. */
 export const PROFILE_ADDENDUM_MAX_CHARS = 100_000;
-function itemToEmail(item, i, where) {
-    if (typeof item === 'string')
-        return { id: `m${i + 1}`, text: item };
-    if (item && typeof item === 'object' && typeof item.text === 'string') {
-        const obj = item;
-        return { id: obj.id !== undefined ? String(obj.id) : `m${i + 1}`, text: obj.text };
-    }
-    throw new Error(`${where} must be a string or an object with a "text" field`);
-}
-/**
- * Load voiceprint writing samples from a JSON/JSONL file or a directory.
- *
- * - `file`: a JSON array of `{id?, text}` objects or plain strings, OR JSONL
- *   (one such value per line). The format is auto-detected.
- * - `dir`: one sample per non-hidden file; `id` is the filename (sans extension),
- *   `text` is the file contents. Files are sorted by name; empty files are skipped.
- *
- * Throws on a missing path, malformed content, or no usable samples.
- */
-export function loadVoiceprintEmails(file, dir) {
-    if (dir !== undefined) {
-        if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory())
-            throw new Error(`Directory not found: ${dir}`);
-        const emails = [];
-        const names = fs.readdirSync(dir).filter((n) => !n.startsWith('.')).sort();
-        for (const name of names) {
-            const full = path.join(dir, name);
-            if (!fs.statSync(full).isFile())
-                continue;
-            const text = fs.readFileSync(full, 'utf8').trim();
-            if (!text)
-                continue;
-            emails.push({ id: name.replace(/\.[^.]+$/, ''), text });
-        }
-        if (emails.length === 0)
-            throw new Error(`No usable files found in ${dir}`);
-        return emails;
-    }
-    if (file !== undefined) {
-        if (!fs.existsSync(file))
-            throw new Error(`File not found: ${file}`);
-        const raw = fs.readFileSync(file, 'utf8');
-        // Try a single JSON array first; fall back to JSONL (one value per line).
-        let items;
-        let asArray;
-        try {
-            asArray = JSON.parse(raw);
-        }
-        catch {
-            asArray = undefined;
-        }
-        if (Array.isArray(asArray)) {
-            items = asArray;
-        }
-        else {
-            const lines = raw.split('\n').map((l) => l.trim()).filter(Boolean);
-            if (lines.length === 0)
-                throw new Error(`${file} contains no samples`);
-            items = lines.map((line, i) => {
-                try {
-                    return JSON.parse(line);
-                }
-                catch {
-                    throw new Error(`${file} is neither a JSON array nor valid JSONL (line ${i + 1} did not parse)`);
-                }
-            });
-        }
-        const emails = items.map((item, i) => itemToEmail(item, i, `${file}[${i}]`));
-        if (emails.length === 0)
-            throw new Error(`${file} contains no samples`);
-        return emails;
-    }
-    throw new Error('Provide --emails <file> or --emails-dir <dir>');
-}
 /**
  * Resolve a face's profile_addendum from the `--profile-addendum` / `--profile-addendum-file`
  * flags. Returns undefined when neither is given (field left unchanged). Throws on a missing