faces-cli 1.8.7 → 1.8.8

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

@@ -13,6 +13,7 @@ export default class ChatChat extends BaseCommand {
         file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         responses: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         medium: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'best-of': import("@oclif/core/interfaces").OptionFlag<number | 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>;

package/dist/commands/chat/chat.js

@@ -5,9 +5,12 @@ import { FacesAPIError } from '../../client.js';
 import { extractStreamDelta, isMaxTokensRenameError, MIN_MAX_OUTPUT_TOKENS, MEDIUM_FLAG_DESCRIPTION, warnDroppedParams, CHAT_PARAM_FLAGS } from '../../utils.js';
 import { resolveEndpoint, MESSAGES_ENDPOINT, RESPONSES_ENDPOINT, isCompositeFormula, faceSpecOf, llmFromArg } from '../../routing.js';
 export default class ChatChat extends BaseCommand {
-    static description = 'Chat via a face. Auto-routes to the correct API endpoint based on the model catalog.';
+    static description = 'Chat via a face. Auto-routes to the correct API endpoint based on the model catalog. ' +
+        'Prefix the alias with + to answer in the style the face captured, e.g. +alice; without it the face ' +
+        'uses its ordinary voice.';
     static examples = [
         '<%= config.bin %> <%= command.id %> socrates -m "What is virtue?"',
+        '<%= config.bin %> <%= command.id %> +alice -m "Reply to the note below." --medium email',
         '<%= config.bin %> <%= command.id %> "(socrates | nietzsche)@claude-sonnet-4-6" -m "What is virtue?"',
         '<%= config.bin %> <%= command.id %> --formula "socrates | nietzsche" --llm claude-sonnet-4-6 -m "What is virtue?"',
     ];
@@ -23,11 +26,16 @@ export default class ChatChat extends BaseCommand {
         file: Flags.string({ description: 'Read message from file' }),
         responses: Flags.boolean({ description: 'Force the OpenAI Responses API endpoint (escape hatch; routing is automatic otherwise)', default: false }),
         medium: Flags.string({ description: MEDIUM_FLAG_DESCRIPTION }),
+        'best-of': Flags.integer({
+            description: 'Write N replies and serve the one closest to the captured style (1-5, default 1). Only ' +
+                'meaningful with a + alias, and it multiplies the cost of the request by N. Cannot be streamed.',
+        }),
         '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 (alias@model, owner:alias@model for a published face, or a composite formula like "(a | b)@model"). Omit when using --formula.',
+            description: 'Face alias (alias@model, owner:alias@model for a published face, or a composite formula like ' +
+                '"(a | b)@model"). Prefix with + to use the face\'s captured style. Omit when using --formula.',
             required: false,
         }),
     };
@@ -59,6 +67,20 @@ export default class ChatChat extends BaseCommand {
             this.error(`Composite face '${spec}' has no default model. Specify one explicitly, ` +
                 `e.g. '${spec}@claude-sonnet-4-6', or pass --llm <model>.`);
         }
+        // best_of_n picks between finished drafts, so there is nothing to stream.
+        // The server answers 400 deepself_streaming_unsupported; say so first.
+        if (flags['best-of'] !== undefined) {
+            if (flags['best-of'] < 1 || flags['best-of'] > 5) {
+                this.error(`--best-of must be between 1 and 5 (got ${flags['best-of']}).`);
+            }
+            if (flags.stream) {
+                this.error('--best-of cannot be streamed: choosing between drafts needs them finished. Drop --stream or --best-of.');
+            }
+            if (!model.startsWith('+')) {
+                this.error(`--best-of only applies to a face's captured style, so the alias needs a + prefix: '+${model}'.\n` +
+                    'Without it the face answers in its ordinary voice and there is nothing to choose between.');
+            }
+        }
         // Collect user messages
         const userMessages = [];
         if (flags.file) {
@@ -90,6 +112,14 @@ export default class ChatChat extends BaseCommand {
             if (err instanceof FacesAPIError) {
                 if (err.errorCode === 'oauth_rejected')
                     this.error(`OAuth failed: ${err.message}\n${this.oauthHint(err, { ...route, endpoint })}`);
+                // A + request on a face with no captured style is refused, not quietly
+                // downgraded. The same request without the + works.
+                if (err.statusCode === 409 && model.startsWith('+')) {
+                    const bare = faceSpecOf(model).replace(/^\+/, '');
+                    this.error(`Error (409): ${err.message}\n` +
+                        `Capture one with: faces style:make ${bare} --all\n` +
+                        `Or drop the + to use ${bare}'s ordinary voice.`);
+                }
                 this.error(`Error (${err.statusCode}): ${err.message}`);
             }
             throw err;
@@ -143,6 +173,8 @@ export default class ChatChat extends BaseCommand {
             payload.temperature = Number.parseFloat(flags.temperature);
         if (flags.medium)
             payload.medium = flags.medium;
+        if (flags['best-of'] !== undefined)
+            payload.best_of_n = flags['best-of'];
         if (flags['oauth-only'])
             payload.oauth_only = true;
         if (flags.stream) {
@@ -189,6 +221,8 @@ export default class ChatChat extends BaseCommand {
             payload.system = flags.system;
         if (flags.medium)
             payload.medium = flags.medium;
+        if (flags['best-of'] !== undefined)
+            payload.best_of_n = flags['best-of'];
         if (flags['oauth-only'])
             payload.oauth_only = true;
         if (flags.stream) {
@@ -234,6 +268,8 @@ export default class ChatChat extends BaseCommand {
             payload.temperature = Number.parseFloat(flags.temperature);
         if (flags.medium)
             payload.medium = flags.medium;
+        if (flags['best-of'] !== undefined)
+            payload.best_of_n = flags['best-of'];
         if (flags['oauth-only'])
             payload.oauth_only = true;
         if (flags.stream) {

package/dist/commands/face/lock.js

@@ -2,7 +2,7 @@ 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 description = 'Lock a face (read-only). A locked face still reads and chats normally, but it, and everything it owns (documents, threads, captured style), cannot be changed until unlocked.';
     static examples = ['<%= config.bin %> <%= command.id %> socrates'];
     static flags = {
         ...BaseCommand.baseFlags,

package/dist/commands/face/unlock.js

@@ -2,7 +2,7 @@ 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 description = 'Unlock a face (make it writable again). Thaws the face and everything it owns (documents, threads, captured style).';
     static examples = ['<%= config.bin %> <%= command.id %> socrates'];
     static flags = {
         ...BaseCommand.baseFlags,

package/dist/commands/style/delete.js

@@ -3,23 +3,6 @@ import { createInterface } from 'node:readline';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 import { STYLE_FACES_PATH } from '../../style.js';
-/**
- * The API takes a scope. This CLI only ever sends `map`.
- *
- * `map` removes the installed style. `all` removes it and everything derived
- * from it — versions, jobs, checkpoints, style exemplars. **Neither touches the
- * uploaded material.** The API reference said `all` destroyed it; that
- * documentation was wrong and has been corrected, and the behaviour is not
- * going to change (backend memo, 2026-08-28 pm).
- *
- * So the reason for sending only `map` is no longer that `all` is dangerous to
- * source text. It is that one command should do one thing: this one forgets a
- * style, and a deeper purge of derived artefacts is a different request nobody
- * has asked for. Source text is deleted through the commands that own it,
- * compile:doc:delete and compile:thread:delete, and a face's uploaded corpus
- * through the corpus route — never as a side effect of a flag value here.
- */
-const SCOPE = 'map';
 export default class StyleDelete extends BaseCommand {
     static description = "Delete a face's captured style. The material it was learned from is kept, so the style can be " +
         'captured again without re-uploading. This never deletes documents or threads: remove those with ' +
@@ -48,7 +31,7 @@ export default class StyleDelete extends BaseCommand {
         }
         let data;
         try {
-            data = await client.delete(`${STYLE_FACES_PATH}/${encodeURIComponent(args.alias)}?scope=${SCOPE}`);
+            data = await client.delete(`${STYLE_FACES_PATH}/${encodeURIComponent(args.alias)}`);
         }
         catch (err) {
             if (err instanceof FacesAPIError) {

package/dist/commands/style/make.js

@@ -104,7 +104,11 @@ export default class StyleMake extends BaseCommand {
         for (const line of formatBuildReport(final))
             this.log(line);
         this.log('');
-        this.log(`'${args.alias}' now writes in its own style. Try it: faces chat:chat ${args.alias} -m "..."`);
+        // Capturing a style does not apply it. The plain alias still answers in the
+        // face's ordinary voice; the + prefix is how a caller asks for the style.
+        this.log(`'${args.alias}' has captured a style. Use it by prefixing the alias with +:`);
+        this.log(`  faces chat:chat +${args.alias} -m "..."`);
+        this.log(`Without the +, the face answers in its ordinary voice. Both are valid.`);
         this.log(`Go back to the previous style: faces style:revert ${args.alias} --yes`);
         return final;
     }

package/dist/style.d.ts

@@ -11,9 +11,9 @@
  * other from what the list endpoints already report.
  */
 import { FacesClient } from './client.js';
-export declare const BUILDS_PATH = "/v1/voiceprint/builds";
-export declare const VERSIONS_PATH = "/v1/voiceprint/versions";
-export declare const STYLE_FACES_PATH = "/v1/voiceprint/faces";
+export declare const BUILDS_PATH = "/v1/style/builds";
+export declare const VERSIONS_PATH = "/v1/style/versions";
+export declare const STYLE_FACES_PATH = "/v1/style/faces";
 /**
  * Analyst model used when the caller does not choose one.
  *

package/dist/style.js

@@ -11,9 +11,9 @@
  * other from what the list endpoints already report.
  */
 import { FacesAPIError } from './client.js';
-export const BUILDS_PATH = '/v1/voiceprint/builds';
-export const VERSIONS_PATH = '/v1/voiceprint/versions';
-export const STYLE_FACES_PATH = '/v1/voiceprint/faces';
+export const BUILDS_PATH = '/v1/style/builds';
+export const VERSIONS_PATH = '/v1/style/versions';
+export const STYLE_FACES_PATH = '/v1/style/faces';
 /**
  * Analyst model used when the caller does not choose one.
  *
@@ -85,7 +85,7 @@ function mediumOf(r, sourceType) {
     return !declared || declared === UNIDENTIFIED_CORPUS ? undefined : declared;
 }
 function rowToSelectable(r, sourceType) {
-    const stamp = r.voiceprint ?? undefined;
+    const stamp = r.style ?? undefined;
     return {
         id: String(r.document_id ?? r.thread_id ?? ''),
         sourceType,
@@ -97,10 +97,8 @@ function rowToSelectable(r, sourceType) {
         isCorpus: sourceType === 'document' || Boolean(r.corpus_medium?.trim()),
         isLiveThread: sourceType === 'room' && !r.corpus_medium?.trim(),
         authored: r.authored_message_count ?? undefined,
-        // The stamp was renamed alongside the request field, but stored stamps kept
-        // the old key (faces-backend-shared#589), so both are read.
-        printedMedium: stamp?.medium ?? stamp?.kind,
-        printedAt: stamp?.printed_at,
+        printedMedium: stamp?.medium,
+        printedAt: stamp?.captured_at,
     };
 }
 function rowsOf(data) {