faces-cli 1.8.1 → 1.8.2

package/dist/utils.js

@@ -1,4 +1,5 @@
 import fs from 'node:fs';
+import { FacesAPIError } from './client.js';
 /** Max length of a face's profile_addendum (per-face system prompt). Mirrors the backend. */
 export const PROFILE_ADDENDUM_MAX_CHARS = 100_000;
 /**
@@ -95,9 +96,10 @@ export function isMaxTokensRenameError(message) {
  * 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, ' +
-    'blog post, legal document, thread reply, conversation (covers speech: transcripts, interviews, ' +
-    'calls). Common synonyms fold automatically. Omit it if you do not know: a wrong declaration is ' +
-    'worse than none, because a declaration is trusted and an absence is not.';
+    '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 ' +
+    'declaration is trusted and an absence is not.';
 /**
  * Warn when the server dropped request parameters before forwarding.
  *
@@ -128,3 +130,67 @@ export const CHAT_PARAM_FLAGS = {
     max_completion_tokens: '--max-tokens',
     temperature: '--temperature',
 };
+/**
+ * Look up a face by `alias` or `owner:alias`.
+ *
+ * `GET /v1/faces/{alias}` only serves faces the account owns. It answers 404
+ * for a qualified name it does not parse and 403 for someone else's bare
+ * alias, so the two ways of naming the same reachable face fail differently
+ * and neither says what is actually true. The listing does serve published and
+ * shared faces, so it is used as the fallback and the caller gets one answer:
+ * here is the face, and you do not own it.
+ *
+ * Throws the original error when the face genuinely cannot be reached.
+ */
+export async function resolveFace(client, spec, include = 'profile') {
+    const at = spec.indexOf(':');
+    const owner = at === -1 ? undefined : spec.slice(0, at);
+    const alias = at === -1 ? spec : spec.slice(at + 1);
+    const q = `include=${encodeURIComponent(include)}`;
+    // A bare name is yours until the server says otherwise.
+    if (!owner) {
+        try {
+            const face = (await client.get(`/v1/faces/${encodeURIComponent(alias)}?${q}`));
+            return { face, owned: true, handle: alias };
+        }
+        catch (err) {
+            // 403 means it exists and is not yours. Find who owns it so the caller
+            // can name it the way that works, rather than reporting a typo.
+            if (!(err instanceof FacesAPIError) || err.statusCode !== 403)
+                throw err;
+            const found = await findForeignFace(client, alias, undefined, q);
+            if (found)
+                return found;
+            throw err;
+        }
+    }
+    const found = await findForeignFace(client, alias, owner, q);
+    if (found)
+        return found;
+    throw new FacesAPIError(404, `Face ${spec} not found`);
+}
+/** Search the listing, which unlike the single-face route serves other people's faces. */
+async function findForeignFace(client, alias, owner, q) {
+    const parts = [q, 'include_published=true', 'include_shared=true'];
+    if (owner)
+        parts.push(`from_users=${encodeURIComponent(owner)}`);
+    let rows;
+    try {
+        const data = await client.get(`/v1/faces?${parts.join('&')}`);
+        rows = (data.data ??
+            data);
+    }
+    catch {
+        return undefined;
+    }
+    const hit = rows.find((f) => f.alias === alias && (owner === undefined || f.owned_by === owner));
+    if (!hit)
+        return undefined;
+    const ownedBy = hit.owned_by;
+    return {
+        face: hit,
+        owned: false,
+        handle: ownedBy ? `${ownedBy}:${alias}` : alias,
+        owner: ownedBy,
+    };
+}