@tpsdev-ai/flair 0.3.17 → 0.3.19

package/resources/embeddings-provider.ts

@@ -1,61 +0,0 @@
-/**
- * embeddings-provider.ts
- *
- * Wrapper around harper-fabric-embeddings for Flair resources.
- *
- * Harper loads resources in a VM sandbox with a separate module cache from
- * the main thread. This means our import of harper-fabric-embeddings gets
- * a different (uninitialized) instance from the one Harper initialized via
- * handleApplication in config.yaml.
- *
- * Solution: we call hfe.init() ourselves on first use. The model is already
- * on disk (downloaded by Harper's plugin loader), so init just loads the
- * native binary and model file — no download needed.
- */
-
-import * as hfe from "harper-fabric-embeddings";
-import { join } from "node:path";
-
-let _ready = false;
-
-async function ensureInit(): Promise<void> {
-  if (_ready) return;
-  try {
-    // Check if already initialized (e.g. shared context)
-    hfe.dimensions();
-    _ready = true;
-    return;
-  } catch {
-    // Not initialized — init with modelsDir pointing to where Harper's
-    // plugin loader downloaded the model (process.cwd() is the app dir)
-    const modelsDir = join(process.cwd(), "models");
-    await hfe.init({ modelsDir });
-    _ready = true;
-  }
-}
-
-/**
- * Generate an embedding vector for the given text.
- * Returns null if the embedding engine isn't available on this platform.
- */
-export async function getEmbedding(text: string): Promise<number[] | null> {
-  try {
-    await ensureInit();
-    return await hfe.embed(text);
-  } catch (err: any) {
-    console.error(`[embeddings] embed failed: ${err.message}`);
-    return null;
-  }
-}
-
-/**
- * Check if the embedding engine is currently available.
- */
-export function getMode(): "local" | "none" {
-  try {
-    hfe.dimensions();
-    return "local";
-  } catch {
-    return "none";
-  }
-}

package/resources/embeddings.ts

@@ -1,28 +0,0 @@
-/**
- * Fallback hash-based embedding (used when sidecar is unavailable).
- * Real embeddings come from the embed-server sidecar (harper-fabric-embeddings).
- */
-const DIMS = 512;
-function h1(s: string): number { let h = 5381; for (let i = 0; i < s.length; i++) h = ((h << 5) + h + s.charCodeAt(i)) >>> 0; return h % DIMS; }
-function h2(s: string): number { let h = 0x811c9dc5; for (let i = 0; i < s.length; i++) { h ^= s.charCodeAt(i); h = Math.imul(h, 0x01000193) >>> 0; } return h % DIMS; }
-
-export function fallbackEmbed(text: string): number[] {
-  const tokens = text.toLowerCase().replace(/[^a-z0-9\s-]/g, ' ').split(/\s+/).filter(t => t.length > 1);
-  const clean = text.toLowerCase().replace(/\s+/g, ' ');
-  const vec = new Float64Array(DIMS);
-  for (const t of tokens) { vec[h1(t)] += 2; vec[h2(t)] += 1; }
-  for (let i = 0; i < tokens.length - 1; i++) vec[h1(tokens[i] + '_' + tokens[i + 1])] += 1.5;
-  for (let i = 0; i <= clean.length - 3; i++) vec[h1(clean.slice(i, i + 3))] += 0.5;
-  for (let i = 0; i < DIMS; i++) if (vec[i] > 0) vec[i] = 1 + Math.log(vec[i]);
-  let norm = 0; for (let i = 0; i < DIMS; i++) norm += vec[i] * vec[i];
-  norm = Math.sqrt(norm);
-  if (norm > 0) for (let i = 0; i < DIMS; i++) vec[i] /= norm;
-  return Array.from(vec);
-}
-
-export function cosineSimilarity(a: number[], b: number[]): number {
-  let dot = 0;
-  const len = Math.min(a.length, b.length);
-  for (let i = 0; i < len; i++) dot += a[i] * b[i];
-  return dot;
-}

package/resources/health.ts

@@ -1,7 +0,0 @@
-import { Resource } from "@harperfast/harper";
-
-export class Health extends Resource {
-  async get() {
-    return { ok: true };
-  }
-}

package/resources/memory-feed-lib.ts

@@ -1,22 +0,0 @@
-import { createHash } from "node:crypto";
-
-export function computeContentHash(agentId: string, content: string): string {
-  return createHash("sha256")
-    .update(`${agentId}${content}`)
-    .digest("hex")
-    .slice(0, 16);
-}
-
-export async function findExistingMemoryByContentHash(
-  records: AsyncIterable<any> | Iterable<any>,
-  agentId: string,
-  contentHash: string,
-): Promise<any | null> {
-  for await (const record of records) {
-    if (record?.agentId === agentId && record?.contentHash === contentHash) {
-      return record;
-    }
-  }
-
-  return null;
-}

package/resources/table-helpers.ts

@@ -1,46 +0,0 @@
-/**
- * Safe read-modify-write helper for Harper tables.
- *
- * Harper's `put()` is FULL RECORD REPLACEMENT. If you pass a partial
- * object, all missing fields (including embeddings!) are permanently
- * deleted. This helper ensures you always read the full record first.
- *
- * Usage:
- *   import { patchRecord } from "./table-helpers.js";
- *   await patchRecord(tables.Memory, id, { lastReflected: now });
- */
-
-export async function patchRecord(
-  table: any,
-  id: string,
-  patch: Record<string, unknown>,
-): Promise<void> {
-  const existing = await table.get(id);
-  if (!existing) throw new Error(`Record ${id} not found`);
-  await table.put({ ...existing, ...patch });
-}
-
-/**
- * Fire-and-forget variant — swallows errors silently.
- * Use for best-effort metadata updates (lastReflected, lastRetrieved, etc.)
- * where a failure should never break the calling request.
- */
-export function patchRecordSilent(
-  table: any,
-  id: string,
-  patch: Record<string, unknown>,
-): void {
-  patchRecord(table, id, patch).catch(() => {});
-}
-
-// ── RULE ──────────────────────────────────────────────────────────────────────
-// Never call `tables.X.put(partial)` directly anywhere in Flair resources.
-// Harper put() = FULL RECORD REPLACEMENT. Missing fields are deleted permanently.
-// Always use patchRecord() or patchRecordSilent().
-// ─────────────────────────────────────────────────────────────────────────────
-
-// ── RULE ──────────────────────────────────────────────────────────────────────
-// Never call `tables.X.put(partial)` directly anywhere in Flair resources.
-// Harper put() = FULL RECORD REPLACEMENT. Missing fields are deleted permanently.
-// Always use patchRecord() or patchRecordSilent().
-// ─────────────────────────────────────────────────────────────────────────────