@tpsdev-ai/flair-client 0.1.0 → 0.2.1

package/dist/client.d.ts

@@ -33,17 +33,24 @@ export declare class FlairClient {
 declare class MemoryApi {
     private client;
     constructor(client: FlairClient);
-    /** Write a memory. */
+    /** Write a memory. Optionally checks for near-duplicates before writing. */
     write(content: string, opts?: {
         id?: string;
         type?: MemoryType;
         durability?: Durability;
         tags?: string[];
         subject?: string;
+        /** Check for similar existing memories before writing. If a near-duplicate
+         *  is found (score >= threshold), returns it instead of creating a new one.
+         *  Default: false (no dedup check). */
+        dedup?: boolean;
+        /** Similarity threshold for dedup. Default: 0.7 */
+        dedupThreshold?: number;
     }): Promise<Memory>;
     /** Search memories by meaning. */
     search(query: string, opts?: {
         limit?: number;
+        minScore?: number;
     }): Promise<SearchResult[]>;
     /** Get a memory by ID. */
     get(id: string): Promise<Memory | null>;

package/dist/client.js

@@ -20,8 +20,8 @@ export class FlairClient {
     keyPath;
     timeoutMs;
     constructor(config) {
-        this.url = (config.url ?? DEFAULT_URL).replace(/\/$/, "");
-        this.agentId = config.agentId;
+        this.url = (config.url ?? process.env.FLAIR_URL ?? DEFAULT_URL).replace(/\/$/, "");
+        this.agentId = config.agentId || process.env.FLAIR_AGENT_ID || "";
         this.keyPath = config.keyPath;
         this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT;
         this.memory = new MemoryApi(this);
@@ -77,10 +77,22 @@ class MemoryApi {
     constructor(client) {
         this.client = client;
     }
-    /** Write a memory. */
+    /** Write a memory. Optionally checks for near-duplicates before writing. */
     async write(content, opts = {}) {
+        // Near-duplicate check — skip for very short content where similarity
+        // is unreliable (e.g., "ok", "thanks" would match each other)
+        if (opts.dedup && content.length >= 20) {
+            const threshold = opts.dedupThreshold ?? 0.7;
+            const existing = await this.search(content, { limit: 1, minScore: threshold });
+            if (existing.length > 0) {
+                // Return the existing memory instead of creating a duplicate
+                const match = await this.get(existing[0].id);
+                if (match)
+                    return match;
+            }
+        }
         const id = opts.id ?? `${this.client.agentId}-${Date.now()}`;
-        return this.client.request("PUT", `/Memory/${id}`, {
+        const record = {
             id,
             agentId: this.client.agentId,
             content,
@@ -89,20 +101,26 @@ class MemoryApi {
             tags: opts.tags ?? [],
             subject: opts.subject,
             createdAt: new Date().toISOString(),
-        });
+        };
+        await this.client.request("PUT", `/Memory/${id}`, record);
+        // Harper PUT returns {} — return the record we constructed
+        return record;
     }
     /** Search memories by meaning. */
     async search(query, opts = {}) {
         const result = await this.client.request("POST", "/SemanticSearch", { agentId: this.client.agentId, q: query, limit: opts.limit ?? 5 });
-        return (result.results ?? []).map((r) => ({
+        const minScore = opts.minScore ?? 0;
+        return (result.results ?? [])
+            .map((r) => ({
             id: r.id ?? r.memory?.id ?? "",
             content: r.content ?? r.memory?.content ?? "",
-            score: r.score ?? r.similarity ?? 0,
+            score: r._score ?? r.score ?? r.similarity ?? 0,
             type: r.type ?? r.memory?.type,
             durability: r.durability ?? r.memory?.durability,
             tags: r.tags ?? r.memory?.tags,
             createdAt: r.createdAt ?? r.memory?.createdAt,
-        }));
+        }))
+            .filter((r) => r.score >= minScore);
     }
     /** Get a memory by ID. */
     async get(id) {

package/dist/types.d.ts

@@ -43,8 +43,8 @@ export interface BootstrapResult {
 export interface FlairClientConfig {
     /** Flair server URL. Default: http://localhost:9926 */
     url?: string;
-    /** Agent ID for authentication and data scoping. */
-    agentId: string;
+    /** Agent ID for authentication and data scoping. Falls back to FLAIR_AGENT_ID env var. */
+    agentId?: string;
     /** Path to Ed25519 private key file. Auto-resolved if omitted. */
     keyPath?: string;
     /** Request timeout in ms. Default: 10000 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tpsdev-ai/flair-client",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Lightweight client for Flair — identity, memory, and soul for AI agents. Zero heavy dependencies.",
   "type": "module",
   "main": "dist/index.js",