@runcore-sh/runcore 0.1.2

package/dist/auth/identity.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Pairing ceremony + auth for Core's human partner.
+ * Handles: pairing code generation, safe word hashing, recovery, session management.
+ */
+export interface HumanIdentity {
+    name: string;
+    safeWordHash: string;
+    pbkdf2Salt?: string;
+    recovery: {
+        question: string;
+        answerHash: string;
+    };
+    pairedAt: string;
+}
+export interface PairingCode {
+    code: string;
+    createdAt: string;
+}
+export interface Session {
+    id: string;
+    name: string;
+    createdAt: number;
+}
+export declare function validateSession(sessionId: string): Session | null;
+export declare function readHuman(): Promise<HumanIdentity | null>;
+/** Cache the session key to disk so it survives server restarts. */
+export declare function cacheSessionKey(key: Buffer): Promise<void>;
+/**
+ * Restore session + cached key at startup (survives server restarts).
+ * Returns the session and key if both can be restored.
+ */
+export declare function restoreSession(): Promise<{
+    session: Session;
+    sessionKey: Buffer;
+} | null>;
+/**
+ * Get current status: is Core paired? Does it need a pairing code entered?
+ */
+export declare function getStatus(): Promise<{
+    paired: boolean;
+    needsCode: boolean;
+}>;
+/**
+ * Called at server startup. If no human.json and no pairing-code.json,
+ * generates a new pairing code and returns it (for printing to terminal).
+ * Returns null if already paired or code already exists.
+ */
+export declare function ensurePairingCode(): Promise<string | null>;
+/**
+ * Complete the pairing ceremony: verify code, create human identity, return session.
+ */
+export declare function pair(input: {
+    code: string;
+    name: string;
+    safeWord: string;
+    recoveryQuestion?: string;
+    recoveryAnswer?: string;
+    skipCodeCheck?: boolean;
+}): Promise<{
+    session: Session;
+    sessionKey: Buffer;
+} | {
+    error: string;
+}>;
+/**
+ * Authenticate with safe word on return visits.
+ */
+export declare function authenticate(safeWord: string): Promise<{
+    session: Session;
+    name: string;
+    sessionKey: Buffer;
+} | {
+    error: string;
+}>;
+/**
+ * Get recovery question (for display).
+ */
+export declare function getRecoveryQuestion(): Promise<string | null>;
+/**
+ * Recover: verify recovery answer, set new safe word.
+ */
+export declare function recover(answer: string, newSafeWord: string): Promise<{
+    session: Session;
+    name: string;
+    sessionKey: Buffer;
+} | {
+    error: string;
+}>;
+//# sourceMappingURL=identity.d.ts.map

package/dist/auth/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/auth/identity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAyDD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAQjE;AAkBD,wBAAsB,SAAS,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAO/D;AAkDD,oEAAoE;AACpE,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhE;AAaD;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAU/F;AAID;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAKlF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUhE;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAiCxE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAWxI;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGlE;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBtJ"}

package/dist/auth/identity.js

@@ -0,0 +1,264 @@
+/**
+ * Pairing ceremony + auth for Core's human partner.
+ * Handles: pairing code generation, safe word hashing, recovery, session management.
+ */
+import { createHash, randomBytes } from "node:crypto";
+import { readFile, writeFile, unlink, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { deriveKey } from "./crypto.js";
+// --- Paths ---
+const IDENTITY_DIR = join(process.cwd(), "brain", "identity");
+const HUMAN_PATH = join(IDENTITY_DIR, "human.json");
+const PAIRING_CODE_PATH = join(IDENTITY_DIR, "pairing-code.json");
+const SESSION_KEY_CACHE_PATH = join(IDENTITY_DIR, ".session-key");
+// --- Helpers ---
+function sha256(input) {
+    return createHash("sha256").update(input.trim().toLowerCase()).digest("hex");
+}
+function generateSessionId() {
+    return randomBytes(24).toString("hex");
+}
+/**
+ * Deterministic session ID derived from safe word hash.
+ * Same safe word always produces the same session ID, so encrypted
+ * session files survive server restarts. Changes on recovery (new safe word).
+ */
+function stableSessionId(safeWordHash) {
+    return createHash("sha256").update(safeWordHash + ":session").digest("hex").slice(0, 48);
+}
+const WORD_LIST = [
+    "amber", "castle", "seven", "river", "oak", "noon",
+    "storm", "velvet", "coral", "maple", "frost", "dawn",
+    "iron", "sage", "dune", "echo", "flint", "grove",
+    "haze", "jade", "knot", "lark", "moss", "nova",
+    "opal", "pine", "quill", "reed", "silk", "tide",
+    "vale", "wren", "zinc", "arch", "bloom", "crest",
+    "drift", "elm", "forge", "glen", "hawk", "isle",
+    "jest", "keel", "lime", "mist", "nest", "orbit",
+    "peak", "rust", "shard", "thorn", "umber", "veil",
+    "whisk", "yarn", "zeal", "bolt", "clay", "dusk",
+];
+function generatePairingCode() {
+    const words = [];
+    for (let i = 0; i < 6; i++) {
+        const idx = Math.floor(Math.random() * WORD_LIST.length);
+        words.push(WORD_LIST[idx]);
+    }
+    return words.join("-");
+}
+// --- Session store (in-memory) ---
+const sessions = new Map();
+// Sessions expire after 24 hours
+const SESSION_TTL = 24 * 60 * 60 * 1000;
+export function validateSession(sessionId) {
+    const session = sessions.get(sessionId);
+    if (!session)
+        return null;
+    if (Date.now() - session.createdAt > SESSION_TTL) {
+        sessions.delete(sessionId);
+        return null;
+    }
+    return session;
+}
+function createSession(name, id) {
+    const session = {
+        id: id ?? generateSessionId(),
+        name,
+        createdAt: Date.now(),
+    };
+    sessions.set(session.id, session);
+    return session;
+}
+// --- Identity file operations ---
+async function ensureDir() {
+    await mkdir(IDENTITY_DIR, { recursive: true });
+}
+export async function readHuman() {
+    try {
+        const raw = await readFile(HUMAN_PATH, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function writeHuman(identity) {
+    await ensureDir();
+    await writeFile(HUMAN_PATH, JSON.stringify(identity, null, 2), "utf-8");
+}
+async function readPairingCode() {
+    try {
+        const raw = await readFile(PAIRING_CODE_PATH, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function writePairingCode(pc) {
+    await ensureDir();
+    await writeFile(PAIRING_CODE_PATH, JSON.stringify(pc, null, 2), "utf-8");
+}
+async function consumePairingCode() {
+    try {
+        await unlink(PAIRING_CODE_PATH);
+    }
+    catch {
+        // Already gone
+    }
+}
+// --- Key derivation helpers ---
+function generateSalt() {
+    return randomBytes(16).toString("hex");
+}
+/** Ensure human has a salt (backward compat). Returns the salt and derived key. */
+async function ensureSaltAndDeriveKey(human, safeWord) {
+    let salt = human.pbkdf2Salt;
+    if (!salt) {
+        salt = generateSalt();
+        human.pbkdf2Salt = salt;
+        await writeHuman(human);
+    }
+    const sessionKey = deriveKey(safeWord, Buffer.from(salt, "hex"));
+    return { salt, sessionKey };
+}
+/** Cache the session key to disk so it survives server restarts. */
+export async function cacheSessionKey(key) {
+    try {
+        await ensureDir();
+        await writeFile(SESSION_KEY_CACHE_PATH, key.toString("hex"), "utf-8");
+    }
+    catch { }
+}
+/** Read cached session key from disk. Returns null if not found. */
+async function loadCachedSessionKey() {
+    try {
+        const hex = (await readFile(SESSION_KEY_CACHE_PATH, "utf-8")).trim();
+        if (hex.length !== 64)
+            return null; // 32 bytes = 64 hex chars
+        return Buffer.from(hex, "hex");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Restore session + cached key at startup (survives server restarts).
+ * Returns the session and key if both can be restored.
+ */
+export async function restoreSession() {
+    const human = await readHuman();
+    if (!human)
+        return null;
+    const id = stableSessionId(human.safeWordHash);
+    // Only restore if not already in memory
+    const existing = sessions.get(id);
+    const session = existing ?? createSession(human.name, id);
+    const sessionKey = await loadCachedSessionKey();
+    if (!sessionKey)
+        return null;
+    return { session, sessionKey };
+}
+// --- Public API ---
+/**
+ * Get current status: is Core paired? Does it need a pairing code entered?
+ */
+export async function getStatus() {
+    const human = await readHuman();
+    if (human)
+        return { paired: true, needsCode: false };
+    const code = await readPairingCode();
+    return { paired: false, needsCode: code !== null };
+}
+/**
+ * Called at server startup. If no human.json and no pairing-code.json,
+ * generates a new pairing code and returns it (for printing to terminal).
+ * Returns null if already paired or code already exists.
+ */
+export async function ensurePairingCode() {
+    const human = await readHuman();
+    if (human)
+        return null; // Already paired
+    const existing = await readPairingCode();
+    if (existing)
+        return existing.code; // Code already generated
+    const code = generatePairingCode();
+    await writePairingCode({ code, createdAt: new Date().toISOString() });
+    return code;
+}
+/**
+ * Complete the pairing ceremony: verify code, create human identity, return session.
+ */
+export async function pair(input) {
+    // Check not already paired
+    const human = await readHuman();
+    if (human)
+        return { error: "Already paired" };
+    if (!input.skipCodeCheck) {
+        // Verify pairing code
+        const stored = await readPairingCode();
+        if (!stored)
+            return { error: "No pairing code found — restart the server" };
+        if (input.code.trim().toLowerCase() !== stored.code) {
+            return { error: "Invalid pairing code" };
+        }
+    }
+    // Create identity with salt for session encryption
+    const salt = generateSalt();
+    const identity = {
+        name: input.name.trim(),
+        safeWordHash: sha256(input.safeWord),
+        pbkdf2Salt: salt,
+        recovery: input.recoveryQuestion && input.recoveryAnswer ? {
+            question: input.recoveryQuestion.trim(),
+            answerHash: sha256(input.recoveryAnswer),
+        } : undefined,
+        pairedAt: new Date().toISOString(),
+    };
+    await writeHuman(identity);
+    await consumePairingCode();
+    const sessionKey = deriveKey(input.safeWord, Buffer.from(salt, "hex"));
+    const session = createSession(identity.name, stableSessionId(identity.safeWordHash));
+    return { session, sessionKey };
+}
+/**
+ * Authenticate with safe word on return visits.
+ */
+export async function authenticate(safeWord) {
+    const human = await readHuman();
+    if (!human)
+        return { error: "Not paired yet" };
+    if (sha256(safeWord) !== human.safeWordHash) {
+        return { error: "Wrong safe word" };
+    }
+    const { sessionKey } = await ensureSaltAndDeriveKey(human, safeWord);
+    const session = createSession(human.name, stableSessionId(human.safeWordHash));
+    return { session, name: human.name, sessionKey };
+}
+/**
+ * Get recovery question (for display).
+ */
+export async function getRecoveryQuestion() {
+    const human = await readHuman();
+    return human?.recovery.question ?? null;
+}
+/**
+ * Recover: verify recovery answer, set new safe word.
+ */
+export async function recover(answer, newSafeWord) {
+    const human = await readHuman();
+    if (!human)
+        return { error: "Not paired yet" };
+    if (sha256(answer) !== human.recovery.answerHash) {
+        return { error: "Wrong answer" };
+    }
+    // Update safe word and regenerate salt (old sessions unreadable — intentional)
+    human.safeWordHash = sha256(newSafeWord);
+    const salt = generateSalt();
+    human.pbkdf2Salt = salt;
+    await writeHuman(human);
+    const sessionKey = deriveKey(newSafeWord, Buffer.from(salt, "hex"));
+    const session = createSession(human.name, stableSessionId(human.safeWordHash));
+    return { session, name: human.name, sessionKey };
+}
+//# sourceMappingURL=identity.js.map

package/dist/auth/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/auth/identity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAW,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA0BxC,gBAAgB;AAEhB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AACpD,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;AAClE,MAAM,sBAAsB,GAAG,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;AAElE,kBAAkB;AAElB,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,YAAoB;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,GAAG,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,SAAS,GAAG;IAChB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;IAClD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;IACpD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAChD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9C,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC/C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAChD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC/C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;IAC/C,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;IACjD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAChD,CAAC;AAEF,SAAS,mBAAmB;IAC1B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,oCAAoC;AAEpC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE5C,iCAAiC;AACjC,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAExC,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,WAAW,EAAE,CAAC;QACjD,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,EAAW;IAC9C,MAAM,OAAO,GAAY;QACvB,EAAE,EAAE,EAAE,IAAI,iBAAiB,EAAE;QAC7B,IAAI;QACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IACF,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mCAAmC;AAEnC,KAAK,UAAU,SAAS;IACtB,MAAM,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,QAAuB;IAC/C,MAAM,SAAS,EAAE,CAAC;IAClB,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1E,CAAC;AAED,KAAK,UAAU,eAAe;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,EAAe;IAC7C,MAAM,SAAS,EAAE,CAAC;IAClB,MAAM,SAAS,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED,KAAK,UAAU,kBAAkB;IAC/B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC;AAED,iCAAiC;AAEjC,SAAS,YAAY;IACnB,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,mFAAmF;AACnF,KAAK,UAAU,sBAAsB,CACnC,KAAoB,EACpB,QAAgB;IAEhB,IAAI,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,YAAY,EAAE,CAAC;QACtB,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;QACxB,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACjE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,IAAI,CAAC;QACH,MAAM,SAAS,EAAE,CAAC;QAClB,MAAM,SAAS,CAAC,sBAAsB,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC;AAED,oEAAoE;AACpE,KAAK,UAAU,oBAAoB;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrE,IAAI,GAAG,CAAC,MAAM,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC,CAAC,0BAA0B;QAC9D,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC/C,wCAAwC;IACxC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,QAAQ,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAChD,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC;AAED,qBAAqB;AAErB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,IAAI,KAAK;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACrD,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAC;IACrC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC,CAAC,iBAAiB;IAEzC,MAAM,QAAQ,GAAG,MAAM,eAAe,EAAE,CAAC;IACzC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,yBAAyB;IAE7D,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;IACnC,MAAM,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,KAO1B;IACC,2BAA2B;IAC3B,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,IAAI,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAE9C,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QACzB,sBAAsB;QACtB,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;QAC5E,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;YACpD,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAkB;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;QACvB,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;QACpC,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;YACzD,QAAQ,EAAE,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE;YACvC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;SACzC,CAAC,CAAC,CAAC,SAAgB;QACpB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACnC,CAAC;IAEF,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3B,MAAM,kBAAkB,EAAE,CAAC;IAE3B,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IACrF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAE/C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;QAC5C,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAC/E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,OAAO,KAAK,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,WAAmB;IAC/D,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAE/C,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACjD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IACnC,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;IACxB,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IAExB,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAC/E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;AACnD,CAAC"}

package/dist/avatar/client.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Avatar client — communicates with the MuseTalk FastAPI sidecar.
+ * Handles photo preparation, video generation, and MP4 caching.
+ */
+/**
+ * Health probe — GET /health, 3-second timeout.
+ */
+export declare function checkAvatarSidecar(): Promise<boolean>;
+/**
+ * Prepare a reference photo for lip-sync generation.
+ * POST /prepare with the photo file. Runs face detection + VAE encode (cached on sidecar side).
+ */
+export declare function preparePhoto(photoPath: string): Promise<boolean>;
+/**
+ * Generate a lip-synced MP4 from WAV audio.
+ * POST /generate with WAV bytes. Returns MP4 Buffer or null.
+ * Timeout: 120s (generation time ≈ audio duration).
+ */
+export declare function generateVideo(wavBuffer: Buffer): Promise<Buffer | null>;
+/**
+ * Check if a video is already cached for the given WAV audio.
+ * Returns the cache filename (hash.mp4) if found, null otherwise.
+ */
+export declare function getCachedVideo(wavBuffer: Buffer): Promise<string | null>;
+/**
+ * Cache an MP4 video, keyed by WAV audio hash.
+ * Returns the cache filename (hash.mp4).
+ */
+export declare function cacheVideo(mp4Buffer: Buffer, wavBuffer: Buffer): Promise<string>;
+/**
+ * Clear all cached videos. Used when the reference photo changes.
+ */
+export declare function clearVideoCache(): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/avatar/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/avatar/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAW3D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBtE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+B7E;AAOD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS9E;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOtF;AAkCD;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAWrD"}

package/dist/avatar/client.js

@@ -0,0 +1,172 @@
+/**
+ * Avatar client — communicates with the MuseTalk FastAPI sidecar.
+ * Handles photo preparation, video generation, and MP4 caching.
+ */
+import { createHash } from "node:crypto";
+import { readFile, writeFile, readdir, stat, unlink, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { getAvatarConfig } from "../settings.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("avatar-client");
+const CACHE_DIR = join(process.cwd(), "public", "avatar", "cache");
+const MAX_CACHE_ENTRIES = 50;
+/** In-flight guard — only one generate request at a time. */
+let generating = false;
+function baseUrl() {
+    return `http://127.0.0.1:${getAvatarConfig().port}`;
+}
+/**
+ * Health probe — GET /health, 3-second timeout.
+ */
+export async function checkAvatarSidecar() {
+    try {
+        const res = await fetch(`${baseUrl()}/health`, {
+            signal: AbortSignal.timeout(3000),
+        });
+        if (!res.ok)
+            return false;
+        const data = await res.json();
+        return !!data.ready;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Prepare a reference photo for lip-sync generation.
+ * POST /prepare with the photo file. Runs face detection + VAE encode (cached on sidecar side).
+ */
+export async function preparePhoto(photoPath) {
+    try {
+        const photoBytes = await readFile(photoPath);
+        const formData = new FormData();
+        formData.append("photo", new Blob([photoBytes]), "photo.png");
+        const res = await fetch(`${baseUrl()}/prepare`, {
+            method: "POST",
+            body: formData,
+            signal: AbortSignal.timeout(120_000),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            log.warn(` Prepare failed: ${err.error ?? res.statusText}`);
+            return false;
+        }
+        return true;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.warn(` Prepare error: ${msg}`);
+        return false;
+    }
+}
+/**
+ * Generate a lip-synced MP4 from WAV audio.
+ * POST /generate with WAV bytes. Returns MP4 Buffer or null.
+ * Timeout: 120s (generation time ≈ audio duration).
+ */
+export async function generateVideo(wavBuffer) {
+    if (generating) {
+        log.warn(` Skipped — generation already in flight`);
+        return null;
+    }
+    generating = true;
+    try {
+        const formData = new FormData();
+        formData.append("audio", new Blob([wavBuffer]), "audio.wav");
+        const res = await fetch(`${baseUrl()}/generate`, {
+            method: "POST",
+            body: formData,
+            signal: AbortSignal.timeout(120_000),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            log.warn(` Generate failed: ${err.error ?? res.statusText}`);
+            return null;
+        }
+        const arrayBuf = await res.arrayBuffer();
+        return Buffer.from(arrayBuf);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.warn(` Generate error: ${msg}`);
+        return null;
+    }
+    finally {
+        generating = false;
+    }
+}
+/** Compute SHA-256 hash of a buffer (for cache keys). */
+function hashBuffer(buf) {
+    return createHash("sha256").update(buf).digest("hex").slice(0, 16);
+}
+/**
+ * Check if a video is already cached for the given WAV audio.
+ * Returns the cache filename (hash.mp4) if found, null otherwise.
+ */
+export async function getCachedVideo(wavBuffer) {
+    const hash = hashBuffer(wavBuffer);
+    const cachePath = join(CACHE_DIR, `${hash}.mp4`);
+    try {
+        await stat(cachePath);
+        return `${hash}.mp4`;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Cache an MP4 video, keyed by WAV audio hash.
+ * Returns the cache filename (hash.mp4).
+ */
+export async function cacheVideo(mp4Buffer, wavBuffer) {
+    await mkdir(CACHE_DIR, { recursive: true });
+    const hash = hashBuffer(wavBuffer);
+    const filename = `${hash}.mp4`;
+    await writeFile(join(CACHE_DIR, filename), mp4Buffer);
+    await pruneCache();
+    return filename;
+}
+/**
+ * Prune the cache directory to keep at most MAX_CACHE_ENTRIES files.
+ * Removes oldest files by modification time.
+ */
+async function pruneCache() {
+    try {
+        const files = await readdir(CACHE_DIR);
+        const mp4Files = files.filter((f) => f.endsWith(".mp4"));
+        if (mp4Files.length <= MAX_CACHE_ENTRIES)
+            return;
+        // Get mtimes for sorting
+        const withStats = await Promise.all(mp4Files.map(async (f) => {
+            const s = await stat(join(CACHE_DIR, f));
+            return { name: f, mtime: s.mtimeMs };
+        }));
+        // Sort oldest first
+        withStats.sort((a, b) => a.mtime - b.mtime);
+        // Remove oldest entries beyond the limit
+        const toRemove = withStats.slice(0, withStats.length - MAX_CACHE_ENTRIES);
+        for (const f of toRemove) {
+            await unlink(join(CACHE_DIR, f.name)).catch(() => { });
+        }
+    }
+    catch {
+        // Cache dir may not exist yet — that's fine
+    }
+}
+/**
+ * Clear all cached videos. Used when the reference photo changes.
+ */
+export async function clearVideoCache() {
+    try {
+        const files = await readdir(CACHE_DIR);
+        for (const f of files) {
+            if (f.endsWith(".mp4")) {
+                await unlink(join(CACHE_DIR, f)).catch(() => { });
+            }
+        }
+    }
+    catch {
+        // Cache dir may not exist yet
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/avatar/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/avatar/client.ts"],"names":[],"mappings":"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"}

package/dist/avatar/sidecar.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Avatar sidecar lifecycle manager.
+ * Spawns the MuseTalk FastAPI server and monitors its health.
+ * Graceful degradation — if MuseTalk isn't installed, Core falls back to TalkingHead/placeholder.
+ */
+/**
+ * Start the MuseTalk avatar sidecar.
+ * Verifies the MuseTalk path exists, spawns the FastAPI server, polls for health.
+ * Returns true if sidecar is available after startup.
+ */
+export declare function startAvatarSidecar(): Promise<boolean>;
+/** Check if the avatar sidecar is currently available. */
+export declare function isAvatarAvailable(): boolean;
+/** Stop the avatar sidecar process. */
+export declare function stopAvatarSidecar(): void;
+//# sourceMappingURL=sidecar.d.ts.map

package/dist/avatar/sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/avatar/sidecar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6BH;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAqF3D;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,IAAI,IAAI,CAUxC"}