@tpsdev-ai/flair 0.3.13 → 0.3.15

package/dist/resources/Memory.js

@@ -1,6 +1,7 @@
 import { databases } from "@harperfast/harper";
 import { patchRecord } from "./table-helpers.js";
 import { isAdmin } from "./auth-middleware.js";
+import { getEmbedding } from "./embeddings-provider.js";
 export class Memory extends databases.flair.Memory {
     /**
      * Override search() to scope collection GETs by authenticated agent.
@@ -81,11 +82,23 @@ export class Memory extends databases.flair.Memory {
             const ttlHours = Number(process.env.FLAIR_EPHEMERAL_TTL_HOURS || 24);
             content.expiresAt = new Date(Date.now() + ttlHours * 3600_000).toISOString();
         }
+        // Generate embedding from content text
+        if (content.content && !content.embedding) {
+            const vec = await getEmbedding(content.content);
+            if (vec)
+                content.embedding = vec;
+        }
         return super.post(content);
     }
     async put(content) {
         const now = new Date().toISOString();
         content.updatedAt = now;
+        // Re-generate embedding if content changed
+        if (content.content && !content.embedding) {
+            const vec = await getEmbedding(content.content);
+            if (vec)
+                content.embedding = vec;
+        }
         // If archiving, record who + when
         if (content.archived === true && !content.archivedAt) {
             content.archivedAt = now;

package/dist/resources/auth-middleware.js

@@ -1,6 +1,6 @@
 import { patchRecord } from "./table-helpers.js";
 import { server, databases } from "@harperfast/harper";
-import { initEmbeddings, getEmbedding } from "./embeddings-provider.js";
+import { getEmbedding } from "./embeddings-provider.js";
 // --- Admin credentials ---
 // Admin auth is sourced exclusively from Harper's own environment variables
 // (HDB_ADMIN_PASSWORD / FLAIR_ADMIN_PASSWORD). No filesystem token file.
@@ -93,7 +93,6 @@ async function importEd25519Key(publicKeyStr) {
     keyCache.set(publicKeyStr, key);
     return key;
 }
-initEmbeddings().catch((err) => console.error("[embeddings] init:", err.message));
 async function backfillEmbedding(memoryId) {
     try {
         const record = await databases.flair.Memory.get(memoryId);

package/dist/resources/embeddings-provider.js

@@ -2,59 +2,35 @@
  * embeddings-provider.ts
  *
  * Thin wrapper around harper-fabric-embeddings for Flair resources.
- * harper-fabric-embeddings handles loading and running the embedding model
- * at the Harper sub-component level — we just delegate to its exported API.
- *
- * On platforms where the native binary isn't available, getEmbedding()
- * returns null and semantic search falls back to keyword matching.
+ * harper-fabric-embeddings is loaded by Harper as a sub-component
+ * (declared in config.yaml). It downloads the model and initializes
+ * in the background. We just call embed() — if it's not ready yet,
+ * we return null and the caller handles it gracefully.
  */
 import * as hfe from "harper-fabric-embeddings";
-const SINGLETON_KEY = "__flair_hfe_provider_v1__";
-function getState() {
-    if (!globalThis[SINGLETON_KEY]) {
-        globalThis[SINGLETON_KEY] = { initialized: false, available: false };
-    }
-    return globalThis[SINGLETON_KEY];
-}
-export async function initEmbeddings() {
-    const state = getState();
-    if (state.initialized)
-        return;
-    // harper-fabric-embeddings is initialized by Harper as a sub-component
-    // (declared in config.yaml). It inits in the background so it may not
-    // be ready when resources first load. Retry a few times before giving up.
-    for (let attempt = 1; attempt <= 10; attempt++) {
-        try {
-            const dims = hfe.dimensions();
-            state.available = true;
-            state.initialized = true;
-            console.log(`[embeddings] ready (${dims} dims, attempt ${attempt})`);
-            return;
-        }
-        catch {
-            if (attempt < 10)
-                await new Promise(r => setTimeout(r, 500));
-        }
-    }
-    console.log("[embeddings] not available after 10 attempts — search will be keyword-only");
-    state.available = false;
-    state.initialized = true;
-}
+/**
+ * Generate an embedding vector for the given text.
+ * Returns null if the embedding engine isn't ready yet (model still loading)
+ * or not available on this platform. Never gives up permanently — each call
+ * checks independently.
+ */
 export async function getEmbedding(text) {
-    const state = getState();
-    if (!state.initialized)
-        await initEmbeddings();
-    if (!state.available)
-        return null;
     try {
-        return hfe.embed(text);
+        return await hfe.embed(text);
     }
-    catch (err) {
-        console.log(`[embeddings] embed failed: ${err.message}`);
+    catch {
         return null;
     }
 }
+/**
+ * Check if the embedding engine is currently available.
+ */
 export function getMode() {
-    const state = getState();
-    return state.available ? "local" : "none";
+    try {
+        hfe.dimensions();
+        return "local";
+    }
+    catch {
+        return "none";
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tpsdev-ai/flair",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "description": "Identity, memory, and soul for AI agents. Cryptographic identity (Ed25519), semantic memory with local embeddings, and persistent personality — all in a single process.",
   "type": "module",
   "license": "Apache-2.0",

package/resources/Memory.ts

@@ -1,6 +1,7 @@
 import { databases } from "@harperfast/harper";
 import { patchRecord } from "./table-helpers.js";
 import { isAdmin } from "./auth-middleware.js";
+import { getEmbedding } from "./embeddings-provider.js";
 
 export class Memory extends (databases as any).flair.Memory {
   /**
@@ -90,6 +91,12 @@ export class Memory extends (databases as any).flair.Memory {
       content.expiresAt = new Date(Date.now() + ttlHours * 3600_000).toISOString();
     }
 
+    // Generate embedding from content text
+    if (content.content && !content.embedding) {
+      const vec = await getEmbedding(content.content);
+      if (vec) content.embedding = vec;
+    }
+
     return super.post(content);
   }
 
@@ -97,6 +104,12 @@ export class Memory extends (databases as any).flair.Memory {
     const now = new Date().toISOString();
     content.updatedAt = now;
 
+    // Re-generate embedding if content changed
+    if (content.content && !content.embedding) {
+      const vec = await getEmbedding(content.content);
+      if (vec) content.embedding = vec;
+    }
+
     // If archiving, record who + when
     if (content.archived === true && !content.archivedAt) {
       content.archivedAt = now;

package/resources/auth-middleware.ts

@@ -1,6 +1,6 @@
 import { patchRecord } from "./table-helpers.js";
 import { server, databases } from "@harperfast/harper";
-import { initEmbeddings, getEmbedding } from "./embeddings-provider.js";
+import { getEmbedding } from "./embeddings-provider.js";
 
 // --- Admin credentials ---
 // Admin auth is sourced exclusively from Harper's own environment variables
@@ -102,7 +102,6 @@ async function importEd25519Key(publicKeyStr: string): Promise<CryptoKey> {
   return key;
 }
 
-initEmbeddings().catch((err: any) => console.error("[embeddings] init:", err.message));
 
 async function backfillEmbedding(memoryId: string): Promise<void> {
   try {

package/resources/embeddings-provider.ts

@@ -2,66 +2,36 @@
  * embeddings-provider.ts
  *
  * Thin wrapper around harper-fabric-embeddings for Flair resources.
- * harper-fabric-embeddings handles loading and running the embedding model
- * at the Harper sub-component level — we just delegate to its exported API.
- *
- * On platforms where the native binary isn't available, getEmbedding()
- * returns null and semantic search falls back to keyword matching.
+ * harper-fabric-embeddings is loaded by Harper as a sub-component
+ * (declared in config.yaml). It downloads the model and initializes
+ * in the background. We just call embed() — if it's not ready yet,
+ * we return null and the caller handles it gracefully.
  */
 
 import * as hfe from "harper-fabric-embeddings";
 
-const SINGLETON_KEY = "__flair_hfe_provider_v1__";
-
-interface ProviderState {
-  initialized: boolean;
-  available: boolean;
-}
-
-function getState(): ProviderState {
-  if (!(globalThis as any)[SINGLETON_KEY]) {
-    (globalThis as any)[SINGLETON_KEY] = { initialized: false, available: false };
-  }
-  return (globalThis as any)[SINGLETON_KEY];
-}
-
-export async function initEmbeddings(): Promise<void> {
-  const state = getState();
-  if (state.initialized) return;
-
-  // harper-fabric-embeddings is initialized by Harper as a sub-component
-  // (declared in config.yaml). It inits in the background so it may not
-  // be ready when resources first load. Retry a few times before giving up.
-  for (let attempt = 1; attempt <= 10; attempt++) {
-    try {
-      const dims = hfe.dimensions();
-      state.available = true;
-      state.initialized = true;
-      console.log(`[embeddings] ready (${dims} dims, attempt ${attempt})`);
-      return;
-    } catch {
-      if (attempt < 10) await new Promise(r => setTimeout(r, 500));
-    }
-  }
-
-  console.log("[embeddings] not available after 10 attempts — search will be keyword-only");
-  state.available = false;
-  state.initialized = true;
-}
-
+/**
+ * Generate an embedding vector for the given text.
+ * Returns null if the embedding engine isn't ready yet (model still loading)
+ * or not available on this platform. Never gives up permanently — each call
+ * checks independently.
+ */
 export async function getEmbedding(text: string): Promise<number[] | null> {
-  const state = getState();
-  if (!state.initialized) await initEmbeddings();
-  if (!state.available) return null;
   try {
-    return hfe.embed(text);
-  } catch (err: any) {
-    console.log(`[embeddings] embed failed: ${err.message}`);
+    return await hfe.embed(text);
+  } catch {
     return null;
   }
 }
 
+/**
+ * Check if the embedding engine is currently available.
+ */
 export function getMode(): "local" | "none" {
-  const state = getState();
-  return state.available ? "local" : "none";
+  try {
+    hfe.dimensions();
+    return "local";
+  } catch {
+    return "none";
+  }
 }