faces-cli 1.8.6 → 1.8.8

package/dist/catalog.js

@@ -135,7 +135,7 @@ export class CatalogService {
                 // what kept it alive across writes; dropping it lets the next sync
                 // replace it with the real one.
                 if (existingDescription.length > MAX_FRONTMATTER_VALUE) {
-                    process.stderr.write(`warn: discarded a ${existingDescription.length}-character description on '${alias}' — ` +
+                    process.stderr.write(`warn: discarded a ${existingDescription.length}-character description on '${alias}': ` +
                         'too large to be real. It will be restored from the server on the next sync.\n');
                 }
                 else {

package/dist/commands/auth/connect.js

@@ -83,13 +83,13 @@ export default class AuthConnect extends BaseCommand {
         // 3. Show the code + URL and the one-time enable-setting guidance.
         emit('');
         emit('To connect ChatGPT:');
-        emit(`  1. Open this URL in any browser (phone, laptop — anywhere):`);
+        emit(`  1. Open this URL in any browser (phone, laptop, anywhere):`);
         emit(`       ${verificationUri}`);
         emit(`  2. Enter this code:  ${start.user_code}`);
         emit(`  3. Sign in to ChatGPT and click Continue.`);
         emit('');
         emit('If this is your first time, you may need to enable device-code authorization in ChatGPT first:');
-        emit(`  1. Open ${SETTINGS_URL}  (the settings panel can take a few seconds to appear — give it a moment)`);
+        emit(`  1. Open ${SETTINGS_URL}  (the settings panel can take a few seconds to appear, so give it a moment)`);
         emit('  2. Turn on "Enable device code authorization for Codex"');
         emit('  3. Then enter the code above');
         emit('');
@@ -193,7 +193,7 @@ export default class AuthConnect extends BaseCommand {
                 const steps = Array.isArray(d.settings_steps) && d.settings_steps.length > 0
                     ? d.settings_steps
                     : [
-                        `Open ${url}  (the settings panel can take a few seconds to appear — give it a moment)`,
+                        `Open ${url}  (the settings panel can take a few seconds to appear, so give it a moment)`,
                         'Turn on "Enable device code authorization for Codex"',
                         'Then run `faces auth:connect openai` again',
                     ];

package/dist/commands/auth/connections.js

@@ -26,7 +26,7 @@ export default class AuthConnections extends BaseCommand {
                         const tier = label ? ` (${label})` : '';
                         this.log(`openai  connected${who}${tier}  connected_at=${row.connected_at}`);
                         if (!plan || plan === 'free') {
-                            this.log('  ⚠️  This ChatGPT plan may not include API access — connecting requires a paid plan (Plus/Pro/Team, etc.).');
+                            this.log('  ⚠️  This ChatGPT plan may not include API access. Connecting requires a paid plan (Plus/Pro/Team, etc.).');
                         }
                     }
                     else {

package/dist/commands/billing/subscription/activate.js

@@ -46,7 +46,7 @@ export default class BillingSubscriptionActivate extends BaseCommand {
             }
             const result = data;
             if (!json) {
-                this.log(`Reactivated. Connect plan continues — next renewal: ${result.current_period_end ?? 'unknown'}.`);
+                this.log(`Reactivated. Connect plan continues. Next renewal: ${result.current_period_end ?? 'unknown'}.`);
             }
             return { status: 'reactivated', ...result };
         }
@@ -63,7 +63,7 @@ export default class BillingSubscriptionActivate extends BaseCommand {
         const result = data;
         const url = result.checkout_url;
         if (!json) {
-            this.log('Subscription Connect — $17/month');
+            this.log('Subscription Connect: $17/month');
             this.log('');
             this.log('Complete payment at this link:');
             this.log(`  ${url}`);

package/dist/commands/catalog/doctor.js

@@ -301,7 +301,7 @@ export default class CatalogDoctor extends BaseCommand {
                 }
                 catch (err) {
                     const msg = err instanceof FacesAPIError ? `Error (${err.statusCode}): ${err.message}` : String(err);
-                    this.log(`  ${alias}: failed — ${msg}`);
+                    this.log(`  ${alias}: failed: ${msg}`);
                 }
             }
             this.log(`Generated ${generated} description(s).`);

package/dist/commands/catalog/list.js

@@ -19,7 +19,7 @@ export default class CatalogList extends BaseCommand {
         if (this.jsonEnabled())
             return entries;
         if (entries.length === 0) {
-            this.log('(no faces in catalog — run faces catalog:doctor --fix)');
+            this.log('(no faces in catalog. Run faces catalog:doctor --fix)');
             return entries;
         }
         const nameWidth = Math.max(...entries.map((e) => String(e.alias ?? '').length));

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/chat/thread.js

@@ -73,7 +73,7 @@ function listThreads() {
     return out;
 }
 export default class ChatThread extends BaseCommand {
-    static description = 'Multi-turn chat thread. Conversation history is stored under ~/.faces/threads/<id>.json — resume any thread later with --id.';
+    static description = 'Multi-turn chat thread. Conversation history is stored under ~/.faces/threads/<id>.json. Resume any thread later with --id.';
     static examples = [
         '<%= config.bin %> <%= command.id %> socrates -m "What is justice?"',
         '<%= config.bin %> <%= command.id %> --id t_abc123 -m "Say more about that"',
@@ -99,7 +99,7 @@ export default class ChatThread extends BaseCommand {
     };
     static args = {
         face_username: Args.string({
-            description: 'Face alias (alias@model, or owner:alias@model for a published face) — 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/compile/all.js

@@ -64,7 +64,7 @@ export default class CompileAll extends BaseCommand {
         }
         if (items.length === 0) {
             if (!json)
-                this.log('Nothing to compile — all documents and threads are up to date.');
+                this.log('Nothing to compile. All documents and threads are up to date.');
             return { compiled: 0, failed: 0, items: [] };
         }
         if (!json)

package/dist/commands/compile/doc/index.js

@@ -17,7 +17,7 @@ export default class CompileDoc extends BaseCommand {
         ...BaseCommand.baseFlags,
         label: Flags.string({ description: 'Document label/title (single document only; with several files each is labelled by its filename)' }),
         content: Flags.string({ description: 'Inline text content', exclusive: ['file'] }),
-        file: Flags.string({ description: 'Read content from file (repeatable — each file becomes its own document)', multiple: true }),
+        file: Flags.string({ description: 'Read content from file (repeatable; each file becomes its own document)', multiple: true }),
         medium: Flags.string({ description: MEDIUM_FLAG_DESCRIPTION }),
         perspective: Flags.string({
             description: 'Perspective',
@@ -177,8 +177,8 @@ export default class CompileDoc extends BaseCommand {
 }
 /** Extensions the compile-documents endpoint takes as inline text. */
 const BINARY_HINTS = {
-    '.pdf': 'PDF is supported, but not by this command — use: faces compile:upload <alias> --file <path> --kind document',
-    '.docx': 'Word documents are supported, but not by this command — use: faces compile:upload <alias> --file <path> --kind document',
+    '.pdf': 'PDF is supported, but not by this command. Use: faces compile:upload <alias> --file <path> --kind document',
+    '.docx': 'Word documents are supported, but not by this command. Use: faces compile:upload <alias> --file <path> --kind document',
     '.doc': "Legacy '.doc' is not supported. Open it in Word or Pages and save as .docx, then upload that with: faces compile:upload <alias> --file <path> --kind document",
     '.pages': 'Pages documents are not supported. Export it as text or PDF first.',
     '.rtf': 'RTF is not supported. Convert it to plain text first (e.g. `textutil -convert txt file.rtf`).',

package/dist/commands/compile/doc/pause.js

@@ -60,13 +60,13 @@ export default class CompileDocPause extends BaseCommand {
             }
             case 'synced':
             case 'ready': {
-                return 'Compile finished before the pause took effect — nothing to resume.';
+                return 'Compile finished before the pause took effect. Nothing to resume.';
             }
             case 'failed': {
                 return 'Compile failed before the pause took effect.';
             }
             case null: {
-                return 'Stopped — the compile is no longer running.';
+                return 'Stopped. The compile is no longer running.';
             }
             default: {
                 return `Still stopping after ${timeout}s. Poll with: faces compile:doc:get ${id} --json`;

package/dist/commands/compile/import.js

@@ -56,7 +56,7 @@ export default class CompileImport extends BaseCommand {
         catch (err) {
             if (err instanceof FacesAPIError) {
                 if (err.statusCode === 422 && flags.type === 'thread') {
-                    this.error(`${err.message} — try again with --type document`);
+                    this.error(`${err.message}. Try again with --type document`);
                 }
                 this.error(`Error (${err.statusCode}): ${err.message}`);
             }

package/dist/commands/compile/thread/pause.js

@@ -61,13 +61,13 @@ export default class CompileThreadPause extends BaseCommand {
             }
             case 'synced':
             case 'ready': {
-                return 'Compile finished before the pause took effect — nothing to resume.';
+                return 'Compile finished before the pause took effect. Nothing to resume.';
             }
             case 'failed': {
                 return 'Compile failed before the pause took effect.';
             }
             case null: {
-                return 'Stopped — the compile is no longer running.';
+                return 'Stopped. The compile is no longer running.';
             }
             default: {
                 return `Still stopping after ${timeout}s. Poll with: faces compile:thread:get ${id} --json`;

package/dist/commands/face/diff.js

@@ -30,7 +30,7 @@ export default class FaceDiff extends BaseCommand {
         if (!this.jsonEnabled()) {
             const res = data;
             const faces = res.faces;
-            const fmt = (v) => (v === null || v === undefined ? '—' : v.toFixed(2));
+            const fmt = (v) => (v === null || v === undefined ? '-' : v.toFixed(2));
             for (let i = 0; i < faces.length; i++) {
                 for (let j = i + 1; j < faces.length; j++) {
                     const a = faces[i];

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,
@@ -24,7 +24,7 @@ export default class FaceLock extends BaseCommand {
         }
         if (!this.jsonEnabled()) {
             const res = data;
-            this.log(`Locked '${res.alias ?? args.face_id}' — read only.`);
+            this.log(`Locked '${res.alias ?? args.face_id}' is now read only.`);
             const affected = res.affected ?? [];
             if (affected.length > 0)
                 this.log(`Affected: ${affected.join(', ')}`);

package/dist/commands/face/neighbors.js

@@ -6,7 +6,7 @@ export default class FaceNeighbors extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         k: Flags.integer({
-            description: 'Number of results (1–20)',
+            description: 'Number of results (1-20)',
             default: 5,
             min: 1,
             max: 20,

package/dist/commands/face/share.js

@@ -15,7 +15,7 @@ export default class FaceShare extends BaseCommand {
         ...BaseCommand.baseFlags,
         list: Flags.boolean({ description: 'Show who the face is shared with, and change nothing', default: false }),
         add: Flags.string({
-            description: 'Add an account, keeping everyone already on the list — username or email (repeatable)',
+            description: 'Add an account, keeping everyone already on the list. Username or email (repeatable)',
             multiple: true,
             exclusive: ['with', 'none'],
         }),

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,
@@ -24,7 +24,7 @@ export default class FaceUnlock extends BaseCommand {
         }
         if (!this.jsonEnabled()) {
             const res = data;
-            this.log(`Unlocked '${res.alias ?? args.face_id}' — writable.`);
+            this.log(`Unlocked '${res.alias ?? args.face_id}' is now writable.`);
             const affected = res.affected ?? [];
             if (affected.length > 0)
                 this.log(`Affected: ${affected.join(', ')}`);

package/dist/commands/face/unpublish.js

@@ -2,7 +2,7 @@ import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 export default class FaceUnpublish extends BaseCommand {
-    static description = 'Stop publishing a face. Anyone it is individually shared with keeps their access — publishing is an ' +
+    static description = 'Stop publishing a face. Anyone it is individually shared with keeps their access. Publishing is an ' +
         'override on top of sharing, not a replacement for it.';
     static flags = { ...BaseCommand.baseFlags };
     static args = {

package/dist/commands/face/unshare.js

@@ -2,7 +2,7 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 export default class FaceUnshare extends BaseCommand {
-    static description = 'Revoke access to a shared face. Takes effect immediately — there is no grace period.';
+    static description = 'Revoke access to a shared face. Takes effect immediately. There is no grace period.';
     static examples = [
         '<%= config.bin %> <%= command.id %> alice --from dana --yes',
         '<%= config.bin %> <%= command.id %> alice --all --yes',

package/dist/commands/keys/create.js

@@ -55,15 +55,15 @@ export default class KeysCreate extends BaseCommand {
         }
         this.printHuman(data);
         this.log('');
-        this.log('⚠  The full key is shown only once — `faces keys:list` returns it truncated by design.');
+        this.log('⚠  The full key is shown only once. `faces keys:list` returns it truncated by design.');
         if (saved) {
-            this.log('✓  Saved to ~/.faces/config.json as api_key — faces commands will use it automatically.');
+            this.log('✓  Saved to ~/.faces/config.json as api_key. Faces commands will use it automatically.');
         }
         else if (!flags.save) {
             this.log('   Not saved (--no-save). Copy the key above now.');
         }
         else {
-            this.warn('Could not find the key in the response — nothing was saved. Copy it manually.');
+            this.warn('Could not find the key in the response. Nothing was saved. Copy it manually.');
         }
         return data;
     }

package/dist/commands/style/delete.js

@@ -3,18 +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: `map` clears the captured style, `all` clears it and
- * destroys the uploaded material with it. This CLI only ever sends `map`.
- *
- * Nothing that removes a style should be able to take source text with it. A
- * user reaching for "delete the style" is not asking to lose the writing it was
- * learned from, and the two are one keystroke apart on the same command. Source
- * text is deleted through the commands that own it — compile:doc:delete and
- * compile:thread:delete — where that is the whole point of the call rather than
- * a side effect of a flag value.
- */
-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 ' +
@@ -43,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;
     }
@@ -173,14 +177,23 @@ export default class StyleMake extends BaseCommand {
         else {
             chosen = [];
             const missing = [];
+            // Naming a source twice is accepted by the server and prints it twice,
+            // which weights it double in the analysis for no stated reason. A later
+            // mention wins so `--source X --source X:essay` declares a medium rather
+            // than being a contradiction.
+            const seen = new Map();
             for (const raw of flags.source ?? []) {
                 const { id, medium } = parseSourceArg(raw);
-                const s = byId.get(id);
-                if (s)
-                    chosen.push({ s, declared: medium });
-                else
+                if (!byId.has(id)) {
                     missing.push(id);
+                    continue;
+                }
+                if (seen.has(id) && medium === undefined)
+                    continue;
+                seen.set(id, medium ?? seen.get(id));
             }
+            for (const [id, medium] of seen)
+                chosen.push({ s: byId.get(id), declared: medium });
             if (missing.length > 0) {
                 this.error(`Not a source on '${alias}': ${missing.join(', ')}\n` +
                     `List what is there with: faces face:sources ${alias}`);

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) {
@@ -181,6 +179,16 @@ export async function pollStyleJob(client, basePath, jobId, opts = {}) {
  * A build failure is shown to the user, and a stack trace or a SQL statement
  * tells them nothing they can act on while burying whatever might have. These
  * are reported as an upstream fault with the first line kept for a bug report.
+ *
+ * The server sanitises `error` itself now (faces-backend-shared#623), so this
+ * is inert against everything it currently returns — checked against the
+ * sanitised text and against every deliberate code it documents
+ * (CHATGPT_AUTH, INSUFFICIENT_CREDITS, NOTHING_AUTHORED, HOLDOUT_UNMEETABLE,
+ * OAUTH_RATE_LIMITED), none of which match. It is kept as a backstop rather
+ * than removed: `error` is rendered straight to a user, a raw statement reached
+ * one once, and a check that costs nothing until it fires is worth more than
+ * the line it saves. It is deliberately narrow so an actionable message can
+ * never be swallowed by it.
  */
 const INTERNAL_FAULT = /sqlalchemy|asyncpg|psycopg|Traceback|\[SQL:|IntegrityError|OperationalError/i;
 /** Failure text, with the one hint that is actionable rather than descriptive. */

package/dist/utils.js

@@ -95,7 +95,7 @@ export function isMaxTokensRenameError(message) {
  * synonyms fold server-side, the set grows, and compile's own 422 names the
  * valid ones better than a stale local list could.
  */
-export const MEDIUM_FLAG_DESCRIPTION = 'What sort of writing this is — e.g. email, text message, social post, essay, academic paper, ' +
+export const MEDIUM_FLAG_DESCRIPTION = 'What sort of writing this is, e.g. email, text message, social post, essay, academic paper, ' +
     'blog post, legal document, thread reply, conversation (dialogue: transcripts, interviews, calls), ' +
     'lecture (sustained speech nobody interrupts: talks, sermons, keynotes). Common synonyms fold ' +
     'automatically. Omit it if you do not know: a wrong declaration is worse than none, because a ' +
@@ -120,7 +120,7 @@ export function warnDroppedParams(headers, flagFor) {
         .map((p) => flagFor[p] ?? `--${p.replaceAll('_', '-')}`);
     if (flags.length === 0)
         return;
-    process.stderr.write(`Note: ${flags.join(' and ')} had no effect — this request ran on your linked ChatGPT account, ` +
+    process.stderr.write(`Note: ${flags.join(' and ')} had no effect. This request ran on your linked ChatGPT account, ` +
         'which does not accept them. Use --no-oauth-only to run on the paid API instead.\n');
 }
 /** Maps the server's parameter names back to the flags a user actually typed. */