faces-cli 1.7.6 → 1.7.7

package/dist/commands/voiceprint/score-status.d.ts

@@ -1,14 +0,0 @@
-import { BaseCommand } from '../../base.js';
-export default class VoiceprintScoreStatus extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        '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>;
-    };
-    static args: {
-        job_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    run(): Promise<unknown>;
-}

package/dist/commands/voiceprint/score-status.js

@@ -1,46 +0,0 @@
-import { Args } from '@oclif/core';
-import { BaseCommand } from '../../base.js';
-import { FacesAPIError } from '../../client.js';
-import { jobFailureMessage } from '../../voiceprint.js';
-import { printScoreReport } from './score.js';
-export default class VoiceprintScoreStatus extends BaseCommand {
-    static description = 'Get the status/result of a voiceprint scoring job (from voiceprint:score without --wait)';
-    static examples = ['<%= config.bin %> <%= command.id %> 4e13bf03-fbc1-4ad0-92ae-16984e2f9a1d'];
-    static flags = { ...BaseCommand.baseFlags };
-    static args = {
-        job_id: Args.string({ description: 'Scoring job id', required: true }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(VoiceprintScoreStatus);
-        const client = this.makeClient(flags);
-        let data;
-        try {
-            data = (await client.get(`/v1/voiceprint/score/${encodeURIComponent(args.job_id)}`));
-        }
-        catch (err) {
-            if (err instanceof FacesAPIError)
-                this.error(`Error (${err.statusCode}): ${err.message}`);
-            throw err;
-        }
-        if (this.jsonEnabled())
-            return data;
-        const status = String(data.status ?? 'unknown');
-        if (status === 'done') {
-            printScoreReport(this, undefined, args.job_id, (data.report ?? {}));
-        }
-        else if (status === 'failed') {
-            this.log(`job:    ${args.job_id}`);
-            this.log(`status: failed`);
-            this.log(`error:  ${jobFailureMessage(data.error)}`);
-        }
-        else {
-            const p = data.progress;
-            this.log(`job:    ${args.job_id}`);
-            this.log(`status: ${status}`);
-            if (p && typeof p.pairs_done === 'number')
-                this.log(`pairs:  ${p.pairs_done}/${p.pairs_total ?? '?'}`);
-            this.log(`(still running — poll again with: faces voiceprint:score-status ${args.job_id})`);
-        }
-        return data;
-    }
-}

package/dist/commands/voiceprint/score.d.ts

@@ -1,24 +0,0 @@
-import { BaseCommand } from '../../base.js';
-export default class VoiceprintScore extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        emails: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'emails-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'author-corpus': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        model: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'oauth-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        wait: 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>;
-    };
-    static args: {
-        face: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    run(): Promise<unknown>;
-}
-/** Shared score-report formatter (used by voiceprint:score --wait and voiceprint:score-status). */
-export declare function printScoreReport(cmd: {
-    log: (m: string) => void;
-}, face: string | undefined, jobId: string, report: Record<string, unknown>): void;

package/dist/commands/voiceprint/score.js

@@ -1,114 +0,0 @@
-import { Args, Flags } from '@oclif/core';
-import { BaseCommand } from '../../base.js';
-import { FacesAPIError } from '../../client.js';
-import { loadVoiceprintEmails } from '../../utils.js';
-import { pollVoiceprintJob, jobFailureMessage } from '../../voiceprint.js';
-/** Minimum held-out emails the scorer needs for a well-posed measurement (handoff §4.5). */
-const MIN_EMAILS = 20;
-export default class VoiceprintScore extends BaseCommand {
-    static description = 'Score how closely a face writes like a specific person. Returns VCI (closeness, 0–100) and VFI (voice captured vs a generic baseline, 0–100). Deterministic — ideal for before/after tuning.';
-    static examples = [
-        '<%= config.bin %> <%= command.id %> "(alice-voiceprint | alice)" --emails ./sent.jsonl --wait',
-        '<%= config.bin %> <%= command.id %> alice --emails-dir ./sent-emails/ --wait',
-        '<%= config.bin %> <%= command.id %> alice --emails ./sent.json   # prints job_id; poll with voiceprint:score-status',
-    ];
-    static flags = {
-        ...BaseCommand.baseFlags,
-        emails: Flags.string({ description: "JSON or JSONL file of the person's real writing — {id?, text} objects or plain strings (provide at least 20)" }),
-        'emails-dir': Flags.string({ description: 'Directory with one sample per file (id = filename). Alternative to --emails.', exclusive: ['emails'] }),
-        'author-corpus': Flags.string({ description: "Optional larger reference of the person's writing (JSON/JSONL/dir) used to define their voice; defaults to --emails" }),
-        model: Flags.string({ description: 'Model used to generate comparison drafts', default: 'gpt-5.4' }),
-        'oauth-only': Flags.boolean({ description: 'Only run when a free (OAuth) model route is available; never fall back to billed inference', default: false }),
-        wait: Flags.boolean({ description: 'Block and poll until the score is ready, then print it (default: print the job_id and return)', default: false }),
-    };
-    static args = {
-        face: Args.string({ description: 'Face to score (alias, owner:alias, or a union like "(alice-voiceprint | alice)")', required: true }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(VoiceprintScore);
-        const client = this.makeClient(flags);
-        const json = this.jsonEnabled();
-        let emails;
-        try {
-            emails = loadVoiceprintEmails(flags.emails, flags['emails-dir']);
-        }
-        catch (err) {
-            this.error(err instanceof Error ? err.message : String(err));
-        }
-        if (emails.length < MIN_EMAILS) {
-            this.error(`Need at least ${MIN_EMAILS} writing samples, got ${emails.length}. ~100 gives a well-posed measurement.`);
-        }
-        const payload = { face: args.face, emails, model: flags.model };
-        if (flags['oauth-only'])
-            payload.oauth_only = true;
-        if (flags['author-corpus']) {
-            try {
-                payload.author_corpus = loadVoiceprintEmails(flags['author-corpus'], undefined).map((e) => e.text);
-            }
-            catch (err) {
-                this.error(err instanceof Error ? err.message : String(err));
-            }
-        }
-        let started;
-        try {
-            started = (await client.post('/v1/voiceprint/score', { body: payload }));
-        }
-        catch (err) {
-            if (err instanceof FacesAPIError)
-                this.error(`Error (${err.statusCode}): ${err.message}`);
-            throw err;
-        }
-        const jobId = String(started.job_id ?? '');
-        if (!jobId)
-            this.error('Server did not return a job_id');
-        if (!flags.wait) {
-            if (!json) {
-                this.log(`Scoring started: ${jobId}`);
-                this.log(`Poll with: faces voiceprint:score-status ${jobId}`);
-            }
-            return started;
-        }
-        if (!json)
-            process.stderr.write(`Scoring ${args.face} against ${emails.length} samples (job ${jobId})...\n`);
-        let final;
-        let lastDone = -1;
-        try {
-            final = await pollVoiceprintJob(client, '/v1/voiceprint/score', jobId, {
-                onPoll: (data) => {
-                    if (json)
-                        return;
-                    const p = data.progress;
-                    if (p && typeof p.pairs_done === 'number' && p.pairs_done !== lastDone) {
-                        lastDone = p.pairs_done;
-                        process.stderr.write(`  ${data.status}: ${p.pairs_done}/${p.pairs_total ?? '?'} pairs\n`);
-                    }
-                },
-            });
-        }
-        catch (err) {
-            if (err instanceof FacesAPIError)
-                this.error(`Error (${err.statusCode}): ${err.message}`);
-            this.error(err instanceof Error ? err.message : String(err));
-        }
-        if (final.status === 'failed')
-            this.error(`Scoring failed: ${jobFailureMessage(final.error)}`);
-        if (json)
-            return final;
-        printScoreReport(this, args.face, jobId, (final.report ?? {}));
-        return final;
-    }
-}
-/** Shared score-report formatter (used by voiceprint:score --wait and voiceprint:score-status). */
-export function printScoreReport(cmd, face, jobId, report) {
-    if (face)
-        cmd.log(`face:    ${face}`);
-    cmd.log(`job:     ${jobId}`);
-    cmd.log(`VCI:     ${report.VCI ?? 'n/a'}   (voice closeness — 100 = writes indistinguishably from the person)`);
-    cmd.log(`VFI:     ${report.VFI ?? 'n/a'}   (voice fidelity — how much of their voice is captured vs a generic baseline)`);
-    if (report.delta_ratio !== undefined)
-        cmd.log(`delta:   ${report.delta_ratio}   (imposter-normalized Burrows' Delta; <1.0 = closer to the author than to others)`);
-    if (report.confidence !== undefined)
-        cmd.log(`conf:    ${report.confidence}`);
-    if (report.n_pairs !== undefined)
-        cmd.log(`n_pairs: ${report.n_pairs}`);
-}

package/dist/commands/voiceprint/upload.d.ts

@@ -1,17 +0,0 @@
-import { BaseCommand } from '../../base.js';
-export default class VoiceprintUpload extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'emails-per-thread': import("@oclif/core/interfaces").OptionFlag<number, 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>;
-    };
-    static args: {
-        self_alias: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-        file: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    run(): Promise<unknown>;
-}

package/dist/commands/voiceprint/upload.js

@@ -1,66 +0,0 @@
-import { Args, Flags } from '@oclif/core';
-import fs from 'node:fs';
-import path from 'node:path';
-import { BaseCommand } from '../../base.js';
-import { FacesAPIError } from '../../client.js';
-export default class VoiceprintUpload extends BaseCommand {
-    static description = "Write a self face's email corpus as threads (the source for a voiceprint build). Pure data write — no compilation, no per-message billing.";
-    static examples = [
-        '<%= config.bin %> <%= command.id %> alice ./corpus.json',
-        '<%= config.bin %> <%= command.id %> alice ./mail.jsonl --type email_jsonl --emails-per-thread 50',
-    ];
-    static flags = {
-        ...BaseCommand.baseFlags,
-        type: Flags.string({
-            description: 'thread_json: a JSON array of canonical email objects → one room. email_jsonl: JSONL (one email/line) → chunked into several rooms.',
-            options: ['thread_json', 'email_jsonl'],
-            default: 'thread_json',
-        }),
-        'emails-per-thread': Flags.integer({ description: 'For --type email_jsonl: emails per room (default 50)', default: 50 }),
-    };
-    static args = {
-        self_alias: Args.string({ description: 'Self face alias', required: true }),
-        file: Args.string({ description: 'Corpus file (JSON array for thread_json, JSONL for email_jsonl)', required: true }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(VoiceprintUpload);
-        const client = this.makeClient(flags);
-        const json = this.jsonEnabled();
-        if (!fs.existsSync(args.file))
-            this.error(`File not found: ${args.file}`);
-        const filename = path.basename(args.file);
-        const fileBlob = new Blob([fs.readFileSync(args.file)], { type: 'application/json' });
-        const form = new FormData();
-        form.append('file', fileBlob, filename);
-        const params = new URLSearchParams();
-        params.set('type', flags.type);
-        if (flags.type === 'email_jsonl')
-            params.set('emails_per_thread', String(flags['emails-per-thread']));
-        let data;
-        try {
-            data = (await client.postForm(`/v1/faces/${encodeURIComponent(args.self_alias)}/upload?${params}`, form));
-        }
-        catch (err) {
-            if (err instanceof FacesAPIError)
-                this.error(`Error (${err.statusCode}): ${err.message}`);
-            throw err;
-        }
-        if (json)
-            return data;
-        const roomIds = data.room_ids ?? [];
-        this.log(`alias:         ${data.alias ?? args.self_alias}`);
-        this.log(`type:          ${data.type ?? flags.type}`);
-        this.log(`message_count: ${data.message_count ?? '?'}`);
-        this.log(`room_count:    ${data.room_count ?? roomIds.length}`);
-        if (roomIds.length > 0) {
-            this.log(`room_ids:`);
-            for (const id of roomIds)
-                this.log(`  ${id}`);
-            this.log(`\nBuild the voice map:  faces voiceprint:build ${args.self_alias} --wait`);
-            this.log(`Compile for knowledge (per room):`);
-            for (const id of roomIds)
-                this.log(`  faces compile:thread:make ${id}`);
-        }
-        return data;
-    }
-}

package/dist/commands/voiceprint/versions.d.ts

@@ -1,14 +0,0 @@
-import { BaseCommand } from '../../base.js';
-export default class VoiceprintVersions extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        '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>;
-    };
-    static args: {
-        self_alias: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    run(): Promise<unknown>;
-}

package/dist/commands/voiceprint/versions.js

@@ -1,44 +0,0 @@
-import { Args } from '@oclif/core';
-import { BaseCommand } from '../../base.js';
-import { FacesAPIError } from '../../client.js';
-export default class VoiceprintVersions extends BaseCommand {
-    static description = "List a self face's voice-map versions (active + one prior). Retention is one-deep; toggle with voiceprint:revert.";
-    static examples = ['<%= config.bin %> <%= command.id %> alice'];
-    static flags = { ...BaseCommand.baseFlags };
-    static args = {
-        self_alias: Args.string({ description: 'Self face alias', required: true }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(VoiceprintVersions);
-        const client = this.makeClient(flags);
-        let data;
-        try {
-            data = (await client.get(`/v1/voiceprint/versions/${encodeURIComponent(args.self_alias)}`));
-        }
-        catch (err) {
-            if (err instanceof FacesAPIError)
-                this.error(`Error (${err.statusCode}): ${err.message}`);
-            throw err;
-        }
-        if (this.jsonEnabled())
-            return data;
-        const versions = data.versions ?? [];
-        this.log(`self_face: ${data.self_face ?? args.self_alias}`);
-        if (versions.length === 0) {
-            this.log('(no versions — run faces voiceprint:build first)');
-            return data;
-        }
-        for (const v of versions) {
-            const mark = v.active ? '* ' : '  ';
-            this.log(`${mark}version ${v.version}${v.active ? ' (active)' : ''}`);
-            this.log(`    VCI/VFI: ${v.baseline_vci ?? 'n/a'} / ${v.baseline_vfi ?? 'n/a'}`);
-            if (v.model)
-                this.log(`    model:   ${v.model}`);
-            if (v.recipe !== undefined)
-                this.log(`    recipe:  ${JSON.stringify(v.recipe)}`);
-            if (v.created_at)
-                this.log(`    created: ${v.created_at}`);
-        }
-        return data;
-    }
-}

package/dist/voiceprint.d.ts

@@ -1,28 +0,0 @@
-/**
- * Shared helpers for the voiceprint (Deepself) command family.
- *
- * build / score / refine all follow the same async contract: POST returns
- * 202 {job_id, status:"queued"}; the CLI polls a matching *-status endpoint
- * until status ∈ {done, failed}. These helpers centralize the poll loop and
- * the CHATGPT_AUTH failure hint.
- */
-import { FacesClient } from './client.js';
-export type JobData = Record<string, unknown>;
-export interface PollJobOptions {
-    intervalMs?: number;
-    timeoutMs?: number;
-    /** Called on every successful poll with the raw job payload (for progress output). */
-    onPoll?: (data: JobData) => void;
-}
-/**
- * Poll `GET {basePath}/{jobId}` until the job reaches a terminal status
- * ("done" or "failed"). Returns the final payload (including a failed one — the
- * caller decides how to surface `error`). Throws only on timeout or a
- * non-transient HTTP error.
- */
-export declare function pollVoiceprintJob(client: FacesClient, basePath: string, jobId: string, opts?: PollJobOptions): Promise<JobData>;
-/**
- * Human-readable failure message for a failed job. Adds a reconnect hint when the
- * backend reports a `CHATGPT_AUTH:` error (the uploaded corpus is preserved).
- */
-export declare function jobFailureMessage(error: unknown): string;

package/dist/voiceprint.js

@@ -1,55 +0,0 @@
-/**
- * Shared helpers for the voiceprint (Deepself) command family.
- *
- * build / score / refine all follow the same async contract: POST returns
- * 202 {job_id, status:"queued"}; the CLI polls a matching *-status endpoint
- * until status ∈ {done, failed}. These helpers centralize the poll loop and
- * the CHATGPT_AUTH failure hint.
- */
-import { FacesAPIError } from './client.js';
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/**
- * Poll `GET {basePath}/{jobId}` until the job reaches a terminal status
- * ("done" or "failed"). Returns the final payload (including a failed one — the
- * caller decides how to surface `error`). Throws only on timeout or a
- * non-transient HTTP error.
- */
-export async function pollVoiceprintJob(client, basePath, jobId, opts = {}) {
-    const interval = opts.intervalMs ?? 3000;
-    const timeout = opts.timeoutMs ?? 1_800_000;
-    const start = Date.now();
-    const endpoint = `${basePath}/${encodeURIComponent(jobId)}`;
-    while (true) {
-        if (Date.now() - start > timeout) {
-            throw new Error(`Timed out after ${Math.round(timeout / 1000)}s (job ${jobId} may still finish; poll it later)`);
-        }
-        await sleep(interval);
-        let data;
-        try {
-            data = (await client.get(endpoint));
-        }
-        catch (err) {
-            // 5xx is transient — keep polling; anything else propagates.
-            if (err instanceof FacesAPIError && err.statusCode >= 500)
-                continue;
-            throw err;
-        }
-        opts.onPoll?.(data);
-        const status = String(data.status ?? '');
-        if (status === 'done' || status === 'failed')
-            return data;
-    }
-}
-/**
- * Human-readable failure message for a failed job. Adds a reconnect hint when the
- * backend reports a `CHATGPT_AUTH:` error (the uploaded corpus is preserved).
- */
-export function jobFailureMessage(error) {
-    const e = typeof error === 'string' && error ? error : 'unknown error';
-    if (e.startsWith('CHATGPT_AUTH:')) {
-        return `${e}\nReconnect your ChatGPT account: faces auth:connect openai — then re-run (your uploaded corpus is preserved).`;
-    }
-    return e;
-}