faces-cli 1.7.0 → 1.7.1

package/dist/commands/chat/chat.js

@@ -19,7 +19,7 @@ export default class ChatChat extends BaseCommand {
         'oauth-only': Flags.boolean({ description: 'Prevent fallback to paid system key (use OAuth only)', default: false }),
     };
     static args = {
-        face_username: Args.string({ description: 'Face alias (or alias@model)', required: true }),
+        face_username: Args.string({ description: 'Face alias (alias@model, or owner:alias@model for a published face)', required: true }),
     };
     async run() {
         const { args, flags } = await this.parse(ChatChat);

package/dist/commands/chat/messages.js

@@ -12,7 +12,7 @@ export default class ChatMessages extends BaseCommand {
         '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 }),
+        face_model: Args.string({ description: 'Face model (e.g. myface, myface@claude-sonnet-4-6, or head:judge@claude-sonnet-4-6)', required: true }),
     };
     async run() {
         const { args, flags } = await this.parse(ChatMessages);

package/dist/commands/chat/responses.js

@@ -11,7 +11,7 @@ export default class ChatResponses extends BaseCommand {
         '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 }),
+        face_model: Args.string({ description: 'Face model (e.g. myface, myface@gpt-4o, or head:logician@gpt-5.4)', required: true }),
     };
     async run() {
         const { args, flags } = await this.parse(ChatResponses);

package/dist/commands/chat/thread.js

@@ -98,7 +98,7 @@ export default class ChatThread extends BaseCommand {
     };
     static args = {
         face_username: Args.string({
-            description: 'Face alias (or alias@model) — required when starting a new thread',
+            description: 'Face alias (alias@model, or owner:alias@model for a published face) — required when starting a new thread',
             required: false,
         }),
     };

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

@@ -5,6 +5,10 @@ export default class FaceList extends BaseCommand {
         tag: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         team: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         include: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        public: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        system: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'from-users': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'not-from-users': 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/list.js

@@ -2,17 +2,34 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 import { renameFaceFields } from '../../utils.js';
+/** Curated system faces are served under this owner account. */
+const SYSTEM_OWNER = 'head';
 export default class FaceList extends BaseCommand {
-    static description = 'List all owned faces';
+    static description = 'List faces. By default lists owned faces; use --public to include published faces from other accounts.';
     static flags = {
         ...BaseCommand.baseFlags,
         tag: Flags.string({ description: 'Filter by tag (repeatable, AND logic)', multiple: true }),
         team: Flags.string({ description: 'Filter by team ID (repeatable, OR logic)', multiple: true }),
         include: Flags.string({ description: 'Include extra fields: tags, teams (comma-separated)' }),
+        public: Flags.boolean({ description: 'Include published faces from other accounts' }),
+        system: Flags.boolean({ description: `Show only the curated system faces (published faces owned by '${SYSTEM_OWNER}')` }),
+        'from-users': Flags.string({ description: 'Only published faces from these owners (repeatable/comma-separated)', multiple: true }),
+        'not-from-users': Flags.string({ description: 'Exclude published faces from these owners (repeatable/comma-separated)', multiple: true }),
     };
     async run() {
         const { flags } = await this.parse(FaceList);
         const client = this.makeClient(flags);
+        // Split comma-separated owner lists into individual values.
+        const split = (vals) => (vals ?? []).flatMap(v => v.split(',')).map(v => v.trim()).filter(Boolean);
+        const fromUsers = split(flags['from-users']);
+        if (flags.system)
+            fromUsers.push(SYSTEM_OWNER);
+        const notFromUsers = split(flags['not-from-users']);
+        if (fromUsers.length > 0 && notFromUsers.length > 0) {
+            this.error('--from-users and --not-from-users are mutually exclusive');
+        }
+        // Any cross-account owner filter implies we want published faces.
+        const includePublished = flags.public || flags.system || fromUsers.length > 0 || notFromUsers.length > 0;
         // Build query string manually for repeated params
         const parts = [];
         if (flags.tag && flags.tag.length > 0) {
@@ -25,6 +42,12 @@ export default class FaceList extends BaseCommand {
         }
         if (flags.include)
             parts.push(`include=${encodeURIComponent(flags.include)}`);
+        if (includePublished)
+            parts.push('include_published=true');
+        for (const u of fromUsers)
+            parts.push(`from_users=${encodeURIComponent(u)}`);
+        for (const u of notFromUsers)
+            parts.push(`not_from_users=${encodeURIComponent(u)}`);
         let data;
         try {
             const path = parts.length > 0 ? `/v1/faces?${parts.join('&')}` : '/v1/faces';
@@ -40,13 +63,31 @@ export default class FaceList extends BaseCommand {
         for (const f of raw) {
             renameFaceFields(f);
         }
+        // The API's from_users/not_from_users only constrain the *appended published*
+        // set — the caller's own faces always come back. Filter client-side so
+        // --system / --from-users / --not-from-users actually mean "from these owners".
+        let faces = raw;
+        if (fromUsers.length > 0) {
+            const allow = new Set(fromUsers);
+            faces = faces.filter(f => f.owned_by != null && allow.has(f.owned_by));
+        }
+        else if (notFromUsers.length > 0) {
+            const block = new Set(notFromUsers);
+            faces = faces.filter(f => f.owned_by == null || !block.has(f.owned_by));
+        }
+        // Keep --json output consistent with what we display.
+        if (data.data !== undefined)
+            data.data = faces;
+        else
+            data = faces;
         if (!this.jsonEnabled()) {
-            const faces = raw;
+            // Published faces are chatted as `owner:alias`; own faces stay bare.
+            const handle = (f) => f.published && f.owned_by ? `${f.owned_by}:${f.alias}` : f.alias;
             if (faces.length === 0) {
                 this.log('(no faces)');
             }
             else {
-                const aliasWidth = Math.max(...faces.map(f => f.alias.length));
+                const handleWidth = Math.max(...faces.map(f => handle(f).length));
                 const nameWidth = Math.max(...faces.map(f => f.name.length));
                 for (const f of faces) {
                     let suffix = '';
@@ -59,7 +100,9 @@ export default class FaceList extends BaseCommand {
                         const profile = f.profile_token_count ?? 0;
                         suffix = `  [profile: ${profile} tok, components: ${total}]`;
                     }
-                    this.log(`${f.alias.padEnd(aliasWidth)}  ${f.name.padEnd(nameWidth)}${suffix}`);
+                    if (f.published)
+                        suffix += '  [public · requires @model]';
+                    this.log(`${handle(f).padEnd(handleWidth)}  ${f.name.padEnd(nameWidth)}${suffix}`);
                 }
             }
         }