@tpsdev-ai/flair-client 0.4.2 → 0.5.0

package/dist/client.d.ts

@@ -25,6 +25,10 @@ export declare class FlairClient {
     /** Cold-start bootstrap — get soul + recent memories as a formatted context block. */
     bootstrap(opts?: {
         maxTokens?: number;
+        currentTask?: string;
+        channel?: string;
+        surface?: string;
+        subjects?: string[];
     }): Promise<BootstrapResult>;
     /** Health check. */
     health(): Promise<{
@@ -48,10 +52,12 @@ declare class MemoryApi {
         /** Similarity threshold for dedup. Default: 0.95 */
         dedupThreshold?: number;
     }): Promise<Memory>;
-    /** Search memories by meaning. */
+    /** Search memories by meaning. Optionally filter to facts valid at a specific point in time. */
     search(query: string, opts?: {
         limit?: number;
         minScore?: number;
+        scoring?: "composite" | "raw";
+        asOf?: string;
     }): Promise<SearchResult[]>;
     /** Get a memory by ID. */
     get(id: string): Promise<Memory | null>;

package/dist/client.js

@@ -9,7 +9,7 @@
  */
 import { loadPrivateKey, resolveKeyPath, signRequest } from "./auth.js";
 const DEFAULT_URL = "http://localhost:19926";
-const DEFAULT_TIMEOUT = 10_000;
+const DEFAULT_TIMEOUT = 30_000;
 export class FlairClient {
     url;
     agentId;
@@ -74,6 +74,10 @@ export class FlairClient {
         return this.request("POST", "/BootstrapMemories", {
             agentId: this.agentId,
             maxTokens: opts.maxTokens ?? 4000,
+            currentTask: opts.currentTask,
+            channel: opts.channel,
+            surface: opts.surface,
+            subjects: opts.subjects,
         });
     }
     /** Health check. */
@@ -93,7 +97,9 @@ class MemoryApi {
         // is unreliable (e.g., "ok", "thanks" would match each other)
         if (opts.dedup && content.length >= 20) {
             const threshold = opts.dedupThreshold ?? 0.95;
-            const existing = await this.search(content, { limit: 1, minScore: threshold });
+            // Use raw scoring to avoid retrieval-boost feedback loop where repeated
+            // dedup checks inflate scores above the threshold.
+            const existing = await this.search(content, { limit: 1, minScore: threshold, scoring: "raw" });
             if (existing.length > 0) {
                 // Return the existing memory instead of creating a duplicate
                 const match = await this.get(existing[0].id);
@@ -116,9 +122,9 @@ class MemoryApi {
         // Harper PUT returns {} — return the record we constructed
         return record;
     }
-    /** Search memories by meaning. */
+    /** Search memories by meaning. Optionally filter to facts valid at a specific point in time. */
     async search(query, opts = {}) {
-        const result = await this.client.request("POST", "/SemanticSearch", { agentId: this.client.agentId, q: query, limit: opts.limit ?? 5 });
+        const result = await this.client.request("POST", "/SemanticSearch", { agentId: this.client.agentId, q: query, limit: opts.limit ?? 5, scoring: opts.scoring, asOf: opts.asOf });
         const minScore = opts.minScore ?? 0;
         return (result.results ?? [])
             .map((r) => ({

package/package.json

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