faces-cli 1.7.2 → 1.7.4

package/dist/commands/chat/chat.js

@@ -15,7 +15,7 @@ export default class ChatChat extends BaseCommand {
         ...BaseCommand.baseFlags,
         message: Flags.string({ char: 'm', description: 'User message (repeatable)', multiple: true, required: false }),
         llm: Flags.string({ description: 'LLM override (e.g. gpt-4o-mini, claude-sonnet-4-6)' }),
-        formula: Flags.string({ description: 'Compose a run-time composite from your own faces, e.g. "socrates | nietzsche" (operators: | & ^ -). Requires --llm.' }),
+        formula: Flags.string({ description: 'Compose a run-time composite from your own faces, e.g. "socrates | nietzsche" (operators: | & ^ -). Requires --llm. The composite takes the name of its first operand; use face:create --formula for a named, persisted composite.' }),
         system: Flags.string({ description: 'System prompt / instructions' }),
         stream: Flags.boolean({ description: 'Stream the response', default: false }),
         'max-tokens': Flags.integer({ description: 'Max tokens' }),

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

@@ -10,6 +10,8 @@ export default class FaceCreate extends BaseCommand {
         formula: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         attr: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         tool: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'profile-addendum': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'profile-addendum-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>;

package/dist/commands/face/create.js

@@ -2,7 +2,7 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 import { CatalogService } from '../../catalog.js';
-import { renameFaceFields } from '../../utils.js';
+import { renameFaceFields, resolveProfileAddendum } from '../../utils.js';
 export default class FaceCreate extends BaseCommand {
     static description = 'Create a new face';
     static flags = {
@@ -15,6 +15,8 @@ export default class FaceCreate extends BaseCommand {
         formula: Flags.string({ description: 'Boolean formula over owned concrete face aliases (e.g. "a | b", "(a | b) - c"). Creates a composite face.' }),
         attr: Flags.string({ description: 'Attribute KEY=VALUE (repeatable)', multiple: true }),
         tool: Flags.string({ description: 'Tool name to enable (repeatable)', multiple: true }),
+        'profile-addendum': Flags.string({ description: 'Per-face system prompt, injected after the persona profile and before any per-request system prompt (max 100,000 chars).' }),
+        'profile-addendum-file': Flags.string({ description: 'Read the per-face system prompt from a file (alternative to --profile-addendum).', exclusive: ['profile-addendum'] }),
     };
     static args = {};
     async run() {
@@ -26,6 +28,15 @@ export default class FaceCreate extends BaseCommand {
         const payload = { name: flags.name, alias: flags.alias };
         if (flags.description)
             payload.description = flags.description;
+        let addendum;
+        try {
+            addendum = resolveProfileAddendum(flags['profile-addendum'], flags['profile-addendum-file']);
+        }
+        catch (err) {
+            this.error(err instanceof Error ? err.message : String(err));
+        }
+        if (addendum !== undefined)
+            payload.profile_addendum = addendum;
         if (flags.formula) {
             payload.formula = flags.formula;
             if (flags['default-model'])

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

@@ -9,6 +9,9 @@ export default class FaceEdit extends BaseCommand {
         formula: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         attr: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         tool: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'profile-addendum': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'profile-addendum-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'clear-profile-addendum': 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/face/edit.js

@@ -2,7 +2,7 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 import { CatalogService } from '../../catalog.js';
-import { renameFaceFields } from '../../utils.js';
+import { renameFaceFields, resolveProfileAddendum } from '../../utils.js';
 export default class FaceEdit extends BaseCommand {
     static description = "Edit a face's metadata";
     static flags = {
@@ -14,6 +14,9 @@ export default class FaceEdit extends BaseCommand {
         formula: Flags.string({ description: 'New boolean formula (synthetic faces only)' }),
         attr: Flags.string({ description: 'Update attribute KEY=VALUE (repeatable)', multiple: true }),
         tool: Flags.string({ description: 'Tool names to set (replaces list, repeatable)', multiple: true }),
+        'profile-addendum': Flags.string({ description: 'Replace the per-face system prompt (max 100,000 chars).' }),
+        'profile-addendum-file': Flags.string({ description: 'Replace the per-face system prompt from a file.', exclusive: ['profile-addendum'] }),
+        'clear-profile-addendum': Flags.boolean({ description: 'Remove the per-face system prompt.', exclusive: ['profile-addendum', 'profile-addendum-file'] }),
     };
     static args = {
         face_id: Args.string({ description: 'Face alias', required: true }),
@@ -42,6 +45,20 @@ export default class FaceEdit extends BaseCommand {
             payload.default_model = flags['default-model'];
         if (flags.description !== undefined)
             payload.description = flags.description;
+        if (flags['clear-profile-addendum']) {
+            payload.profile_addendum = '';
+        }
+        else {
+            let addendum;
+            try {
+                addendum = resolveProfileAddendum(flags['profile-addendum'], flags['profile-addendum-file']);
+            }
+            catch (err) {
+                this.error(err instanceof Error ? err.message : String(err));
+            }
+            if (addendum !== undefined)
+                payload.profile_addendum = addendum;
+        }
         const hasTags = flags.tag && flags.tag.length > 0;
         if (Object.keys(payload).length === 0 && !hasTags)
             this.error('Provide at least one field to update.');

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

@@ -3,6 +3,7 @@ export default class FaceGet extends BaseCommand {
     static description: string;
     static flags: {
         include: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        full: 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/face/get.js

@@ -7,6 +7,7 @@ export default class FaceGet extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         include: Flags.string({ description: 'Include extra fields: tags, teams (comma-separated)' }),
+        full: Flags.boolean({ description: 'Print the full profile_addendum instead of a truncated preview' }),
     };
     static args = {
         face_id: Args.string({ description: 'Face alias', required: true }),
@@ -55,6 +56,20 @@ export default class FaceGet extends BaseCommand {
                 if (f.default_model)
                     this.log(`default_model: ${f.default_model}`);
             }
+            if (f.profile_addendum) {
+                const text = f.profile_addendum;
+                if (flags.full) {
+                    this.log(`profile_addendum (${text.length} chars):`);
+                    this.log(text);
+                }
+                else {
+                    const oneLine = text.replace(/\s+/g, ' ').trim();
+                    const preview = oneLine.length > 160 ? `${oneLine.slice(0, 160)}…` : oneLine;
+                    this.log(`profile_addendum (${text.length} chars): ${preview}`);
+                    if (oneLine.length > 160)
+                        this.log('  (use --full to print the whole prompt)');
+                }
+            }
         }
         return data;
     }

package/dist/utils.d.ts

@@ -1,3 +1,11 @@
+/** Max length of a face's profile_addendum (per-face system prompt). Mirrors the backend. */
+export declare const PROFILE_ADDENDUM_MAX_CHARS = 100000;
+/**
+ * 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
+ * file or over-length content so the caller can surface a friendly error.
+ */
+export declare function resolveProfileAddendum(text: string | undefined, file: string | undefined): string | undefined;
 /**
  * Flatten basic_facts/attributes from API's nested {value, status, identification} format
  * to simple {key: value} strings.

package/dist/utils.js

@@ -1,3 +1,26 @@
+import fs from 'node:fs';
+/** Max length of a face's profile_addendum (per-face system prompt). Mirrors the backend. */
+export const PROFILE_ADDENDUM_MAX_CHARS = 100_000;
+/**
+ * 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
+ * file or over-length content so the caller can surface a friendly error.
+ */
+export function resolveProfileAddendum(text, file) {
+    let value;
+    if (file !== undefined) {
+        if (!fs.existsSync(file))
+            throw new Error(`File not found: ${file}`);
+        value = fs.readFileSync(file, 'utf8');
+    }
+    else if (text !== undefined) {
+        value = text;
+    }
+    if (value !== undefined && value.length > PROFILE_ADDENDUM_MAX_CHARS) {
+        throw new Error(`--profile-addendum is ${value.length} chars; max is ${PROFILE_ADDENDUM_MAX_CHARS}.`);
+    }
+    return value;
+}
 /**
  * Flatten basic_facts/attributes from API's nested {value, status, identification} format
  * to simple {key: value} strings.