faces-cli 1.3.2 → 1.4.0

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

@@ -0,0 +1,29 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class CompileThreadEdit extends BaseCommand {
+    static description = 'Edit a thread (label)';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        label: Flags.string({ description: 'New thread label', required: true }),
+    };
+    static args = {
+        thread_id: Args.string({ description: 'Thread ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(CompileThreadEdit);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.patch(`/v1/compile/threads/${args.thread_id}`, { body: { label: flags.label } });
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/compile/{doc/prepare.d.ts → thread/get.d.ts}

@@ -1,5 +1,5 @@
 import { BaseCommand } from '../../../base.js';
-export default class CompileDocPrepare extends BaseCommand {
+export default class CompileThreadGet extends BaseCommand {
     static description: string;
     static flags: {
         'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -7,7 +7,7 @@ export default class CompileDocPrepare extends BaseCommand {
         'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     static args: {
-        doc_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        thread_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     run(): Promise<unknown>;
 }

package/dist/commands/compile/{doc/prepare.js → thread/get.js}

@@ -1,20 +1,20 @@
 import { Args } from '@oclif/core';
 import { BaseCommand } from '../../../base.js';
 import { FacesAPIError } from '../../../client.js';
-export default class CompileDocPrepare extends BaseCommand {
-    static description = 'Run LLM extraction pipeline on a document';
+export default class CompileThreadGet extends BaseCommand {
+    static description = 'Get a thread by ID';
     static flags = {
         ...BaseCommand.baseFlags,
     };
     static args = {
-        doc_id: Args.string({ description: 'Document ID', required: true }),
+        thread_id: Args.string({ description: 'Thread ID', required: true }),
     };
     async run() {
-        const { args, flags } = await this.parse(CompileDocPrepare);
+        const { args, flags } = await this.parse(CompileThreadGet);
         const client = this.makeClient(flags);
         let data;
         try {
-            data = await client.post(`/v1/compile/documents/${args.doc_id}/prepare`);
+            data = await client.get(`/v1/compile/threads/${args.thread_id}`);
         }
         catch (err) {
             if (err instanceof FacesAPIError)

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

@@ -14,7 +14,7 @@ export default class CompileThreadList extends BaseCommand {
         const client = this.makeClient(flags);
         let data;
         try {
-            data = await client.get(`/v1/faces/${args.face_id}/compile/threads`);
+            data = await client.get('/v1/compile/threads', { params: { model: args.face_id } });
         }
         catch (err) {
             if (err instanceof FacesAPIError)

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

@@ -16,7 +16,7 @@ export default class CompileThreadMessage extends BaseCommand {
         let data;
         try {
             data = await client.post(`/v1/compile/threads/${args.thread_id}/messages`, {
-                body: { role: 'user', content: flags.message },
+                body: { message: flags.message },
             });
         }
         catch (err) {

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

@@ -4,6 +4,8 @@ export default class FaceCreate extends BaseCommand {
     static flags: {
         name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         username: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'default-model': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         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>;

package/dist/commands/face/create.js

@@ -1,12 +1,16 @@
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
+import { CatalogService } from '../../catalog.js';
+import { flattenBasicFacts } from '../../utils.js';
 export default class FaceCreate extends BaseCommand {
     static description = 'Create a new face';
     static flags = {
         ...BaseCommand.baseFlags,
         name: Flags.string({ description: 'Display name', required: true }),
         username: Flags.string({ description: 'Unique username slug', required: true }),
+        description: Flags.string({ description: 'Description for local catalog' }),
+        'default-model': Flags.string({ description: 'Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)' }),
         formula: Flags.string({ description: 'Boolean formula over owned concrete face usernames (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 }),
@@ -31,9 +35,11 @@ export default class FaceCreate extends BaseCommand {
                 parsedAttrs[a.slice(0, idx).trim()] = a.slice(idx + 1).trim();
             }
             if (Object.keys(parsedAttrs).length > 0)
-                payload.facts = parsedAttrs;
+                payload.basic_facts = parsedAttrs;
             if (flags.tool && flags.tool.length > 0)
-                payload.tools = flags.tool;
+                payload.default_tools = flags.tool;
+            if (flags['default-model'])
+                payload.default_model = flags['default-model'];
         }
         let data;
         try {
@@ -44,6 +50,15 @@ export default class FaceCreate extends BaseCommand {
                 this.error(`Error (${err.statusCode}): ${err.message}`);
             throw err;
         }
+        const face = data;
+        if (face.basic_facts && typeof face.basic_facts === 'object') {
+            face.basic_facts = flattenBasicFacts(face.basic_facts);
+        }
+        try {
+            const catalog = new CatalogService();
+            catalog.writeFace(face, flags.description);
+        }
+        catch { /* catalog errors are non-fatal */ }
         if (!this.jsonEnabled())
             this.printHuman(data);
         return data;

package/dist/commands/face/delete.js

@@ -1,6 +1,7 @@
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
+import { CatalogService } from '../../catalog.js';
 import { createInterface } from 'node:readline';
 export default class FaceDelete extends BaseCommand {
     static description = 'Delete a face permanently';
@@ -28,6 +29,11 @@ export default class FaceDelete extends BaseCommand {
                 this.error(`Error (${err.statusCode}): ${err.message}`);
             throw err;
         }
+        try {
+            const catalog = new CatalogService();
+            catalog.deleteFace(args.face_id);
+        }
+        catch { /* catalog errors are non-fatal */ }
         if (!this.jsonEnabled())
             this.printHuman(data);
         return data;

package/dist/commands/face/get.js

@@ -1,6 +1,7 @@
 import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
+import { flattenBasicFacts } from '../../utils.js';
 export default class FaceGet extends BaseCommand {
     static description = 'Get details for a face by ID or username';
     static flags = {
@@ -21,8 +22,10 @@ export default class FaceGet extends BaseCommand {
                 this.error(`Error (${err.statusCode}): ${err.message}`);
             throw err;
         }
+        const f = data;
+        if (f.basic_facts)
+            f.basic_facts = flattenBasicFacts(f.basic_facts);
         if (!this.jsonEnabled()) {
-            const f = data;
             this.log(`id:        ${f.id}`);
             this.log(`uid:       ${f.uid}`);
             this.log(`name:      ${f.name}`);
@@ -37,8 +40,7 @@ export default class FaceGet extends BaseCommand {
                 if (f.basic_facts && Object.keys(f.basic_facts).length > 0) {
                     this.log('basic_facts:');
                     for (const [k, v] of Object.entries(f.basic_facts)) {
-                        const display = typeof v === 'object' ? JSON.stringify(v) : v;
-                        this.log(`  ${k}: ${display}`);
+                        this.log(`  ${k}: ${v}`);
                     }
                 }
                 if (f.default_tools && f.default_tools.length > 0)

package/dist/commands/face/list.js

@@ -1,5 +1,6 @@
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
+import { flattenBasicFacts } from '../../utils.js';
 export default class FaceList extends BaseCommand {
     static description = 'List all owned faces';
     static flags = {
@@ -17,8 +18,15 @@ export default class FaceList extends BaseCommand {
                 this.error(`Error (${err.statusCode}): ${err.message}`);
             throw err;
         }
+        // Flatten basic_facts in response
+        const raw = data.data ?? data;
+        for (const f of raw) {
+            if (f.basic_facts && typeof f.basic_facts === 'object') {
+                f.basic_facts = flattenBasicFacts(f.basic_facts);
+            }
+        }
         if (!this.jsonEnabled()) {
-            const faces = (data.data) ?? data;
+            const faces = raw;
             if (faces.length === 0) {
                 this.log('(no faces)');
             }
@@ -26,8 +34,17 @@ export default class FaceList extends BaseCommand {
                 const idWidth = Math.max(...faces.map(f => f.id.length));
                 const nameWidth = Math.max(...faces.map(f => f.name.length));
                 for (const f of faces) {
-                    const synthetic = f.formula ? `  [composite: ${f.formula}]` : '';
-                    this.log(`${f.id.padEnd(idWidth)}  ${f.name.padEnd(nameWidth)}${synthetic}`);
+                    let suffix = '';
+                    if (f.formula) {
+                        suffix = `  [composite: ${f.formula}]`;
+                    }
+                    else if (f.component_counts || f.profile_token_count) {
+                        const cc = f.component_counts;
+                        const total = cc ? cc.alpha + cc.beta + cc.delta + cc.epsilon : 0;
+                        const profile = f.profile_token_count ?? 0;
+                        suffix = `  [profile: ${profile} tok, components: ${total}]`;
+                    }
+                    this.log(`${f.id.padEnd(idWidth)}  ${f.name.padEnd(nameWidth)}${suffix}`);
                 }
             }
         }

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

@@ -3,6 +3,8 @@ export default class FaceUpdate extends BaseCommand {
     static description: string;
     static flags: {
         name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'default-model': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         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>;

package/dist/commands/face/update.js

@@ -1,11 +1,15 @@
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
+import { CatalogService } from '../../catalog.js';
+import { flattenBasicFacts } from '../../utils.js';
 export default class FaceUpdate extends BaseCommand {
     static description = "Update a face's metadata";
     static flags = {
         ...BaseCommand.baseFlags,
         name: Flags.string({ description: 'New display name' }),
+        description: Flags.string({ description: 'Description for local catalog' }),
+        'default-model': Flags.string({ description: 'Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)' }),
         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 }),
@@ -29,21 +33,47 @@ export default class FaceUpdate extends BaseCommand {
                 const idx = a.indexOf('=');
                 parsed[a.slice(0, idx).trim()] = a.slice(idx + 1).trim();
             }
-            payload.facts = parsed;
+            payload.basic_facts = parsed;
         }
         if (flags.tool && flags.tool.length > 0)
-            payload.tools = flags.tool;
-        if (Object.keys(payload).length === 0)
+            payload.default_tools = flags.tool;
+        if (flags['default-model'])
+            payload.default_model = flags['default-model'];
+        const hasApiFields = Object.keys(payload).length > 0;
+        const hasDescription = Boolean(flags.description);
+        if (!hasApiFields && !hasDescription)
             this.error('Provide at least one field to update.');
         let data;
-        try {
-            data = await client.patch(`/v1/faces/${args.face_id}`, { body: payload });
+        if (hasApiFields) {
+            try {
+                data = await client.patch(`/v1/faces/${args.face_id}`, { body: payload });
+            }
+            catch (err) {
+                if (err instanceof FacesAPIError)
+                    this.error(`Error (${err.statusCode}): ${err.message}`);
+                throw err;
+            }
+        }
+        else {
+            // description-only update: fetch current face data for catalog
+            try {
+                data = await client.get(`/v1/faces/${args.face_id}`);
+            }
+            catch (err) {
+                if (err instanceof FacesAPIError)
+                    this.error(`Error (${err.statusCode}): ${err.message}`);
+                throw err;
+            }
         }
-        catch (err) {
-            if (err instanceof FacesAPIError)
-                this.error(`Error (${err.statusCode}): ${err.message}`);
-            throw err;
+        const face = data;
+        if (face.basic_facts && typeof face.basic_facts === 'object') {
+            face.basic_facts = flattenBasicFacts(face.basic_facts);
+        }
+        try {
+            const catalog = new CatalogService();
+            catalog.writeFace(face, flags.description);
         }
+        catch { /* catalog errors are non-fatal */ }
         if (!this.jsonEnabled())
             this.printHuman(data);
         return data;

package/dist/config.d.ts

@@ -4,6 +4,8 @@ export interface FacesConfig {
     token?: string;
     api_key?: string;
     user_id?: string;
+    catalog?: string;
+    catalog_model?: string;
     [key: string]: string | undefined;
 }
 export declare function loadConfig(): FacesConfig;

package/dist/poll.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared polling helper for document compile progress.
+ *
+ * Works with both /make (preparing → syncing → synced) and
+ * legacy /prepare (processing → ready) status flows.
+ */
+import { FacesClient } from './client.js';
+export interface PollProgress {
+    prepare_status: string | null;
+    chunks_total: number | null;
+    chunks_completed: number | null;
+    current_counts: {
+        epsilon: number;
+        beta: number;
+        delta: number;
+        alpha: number;
+    } | null;
+}
+export interface PollOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+    onProgress?: (p: PollProgress) => void;
+}
+/**
+ * Poll GET /compile/documents/{docId} until a terminal status is reached.
+ * Terminal statuses: "synced" (from /make), "ready" (from /prepare), "failed".
+ * Returns the final GET response.
+ * Throws on timeout or failure.
+ */
+export declare function pollCompileProgress(client: FacesClient, docId: string, opts?: PollOptions): Promise<unknown>;

package/dist/poll.js

@@ -0,0 +1,40 @@
+/**
+ * Poll GET /compile/documents/{docId} until a terminal status is reached.
+ * Terminal statuses: "synced" (from /make), "ready" (from /prepare), "failed".
+ * Returns the final GET response.
+ * Throws on timeout or failure.
+ */
+export async function pollCompileProgress(client, docId, opts = {}) {
+    const interval = opts.intervalMs ?? 3000;
+    const timeout = opts.timeoutMs ?? 600_000;
+    const start = Date.now();
+    let lastChunks = -1;
+    while (true) {
+        if (Date.now() - start > timeout) {
+            throw new Error(`Compile timed out after ${Math.round(timeout / 1000)}s`);
+        }
+        await sleep(interval);
+        const data = await client.get(`/v1/compile/documents/${docId}`);
+        const progress = {
+            prepare_status: data.prepare_status ?? null,
+            chunks_total: data.chunks_total ?? null,
+            chunks_completed: data.chunks_completed ?? null,
+            current_counts: data.current_counts ?? null,
+        };
+        // Only fire callback when chunks change (skip initial 0/N state)
+        if (progress.chunks_completed !== lastChunks && (progress.chunks_completed ?? 0) > 0) {
+            lastChunks = progress.chunks_completed ?? -1;
+            opts.onProgress?.(progress);
+        }
+        if (progress.prepare_status === 'synced' || progress.prepare_status === 'ready') {
+            return data;
+        }
+        if (progress.prepare_status === 'failed') {
+            const error = data.error ?? 'Unknown error';
+            throw new Error(`Compile failed: ${error}`);
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Flatten basic_facts from API's nested {value, status, identification} format
+ * to simple {key: value} strings.
+ */
+export declare function flattenBasicFacts(facts: Record<string, unknown>): Record<string, string>;

package/dist/utils.js

@@ -0,0 +1,16 @@
+/**
+ * Flatten basic_facts from API's nested {value, status, identification} format
+ * to simple {key: value} strings.
+ */
+export function flattenBasicFacts(facts) {
+    const flat = {};
+    for (const [k, v] of Object.entries(facts)) {
+        if (typeof v === 'object' && v !== null && 'value' in v) {
+            flat[k] = String(v.value);
+        }
+        else {
+            flat[k] = String(v);
+        }
+    }
+    return flat;
+}