@tpsdev-ai/flair-client 0.2.0 → 0.4.0

package/dist/client.d.ts

@@ -17,6 +17,7 @@ export declare class FlairClient {
     private keyResolved;
     private keyPath;
     private timeoutMs;
+    private basicAuth;
     constructor(config: FlairClientConfig);
     private resolveKey;
     /** Make an authenticated request to Flair. */

package/dist/client.js

@@ -8,7 +8,7 @@
  *   const ctx = await flair.bootstrap({ maxTokens: 4000 })
  */
 import { loadPrivateKey, resolveKeyPath, signRequest } from "./auth.js";
-const DEFAULT_URL = "http://localhost:9926";
+const DEFAULT_URL = "http://localhost:19926";
 const DEFAULT_TIMEOUT = 10_000;
 export class FlairClient {
     url;
@@ -19,11 +19,18 @@ export class FlairClient {
     keyResolved = false;
     keyPath;
     timeoutMs;
+    basicAuth = null;
     constructor(config) {
         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;
+        // Basic auth fallback for standalone deployments without Ed25519 keys
+        const adminUser = config.adminUser ?? process.env.FLAIR_ADMIN_USER;
+        const adminPass = config.adminPassword ?? process.env.FLAIR_ADMIN_PASSWORD;
+        if (adminUser && adminPass) {
+            this.basicAuth = `Basic ${Buffer.from(`${adminUser}:${adminPass}`).toString("base64")}`;
+        }
         this.memory = new MemoryApi(this);
         this.soul = new SoulApi(this);
     }
@@ -46,6 +53,9 @@ export class FlairClient {
         if (key) {
             headers["Authorization"] = signRequest(this.agentId, key, method, path);
         }
+        else if (this.basicAuth) {
+            headers["Authorization"] = this.basicAuth;
+        }
         const res = await fetch(`${this.url}${path}`, {
             method,
             headers,
@@ -92,7 +102,7 @@ class MemoryApi {
             }
         }
         const id = opts.id ?? `${this.client.agentId}-${Date.now()}`;
-        return this.client.request("PUT", `/Memory/${id}`, {
+        const record = {
             id,
             agentId: this.client.agentId,
             content,
@@ -101,7 +111,10 @@ 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 = {}) {

package/dist/types.d.ts

@@ -41,7 +41,7 @@ export interface BootstrapResult {
 }
 /** Client configuration. */
 export interface FlairClientConfig {
-    /** Flair server URL. Default: http://localhost:9926 */
+    /** Flair server URL. Default: http://localhost:19926 */
     url?: string;
     /** Agent ID for authentication and data scoping. Falls back to FLAIR_AGENT_ID env var. */
     agentId?: string;
@@ -49,4 +49,8 @@ export interface FlairClientConfig {
     keyPath?: string;
     /** Request timeout in ms. Default: 10000 */
     timeoutMs?: number;
+    /** Admin username for Basic auth fallback (standalone deployments). Falls back to FLAIR_ADMIN_USER env var. */
+    adminUser?: string;
+    /** Admin password for Basic auth fallback (standalone deployments). Falls back to FLAIR_ADMIN_PASSWORD env var. */
+    adminPassword?: string;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tpsdev-ai/flair-client",
-  "version": "0.2.0",
-  "description": "Lightweight client for Flair \u2014 identity, memory, and soul for AI agents. Zero heavy dependencies.",
+  "version": "0.4.0",
+  "description": "Lightweight client for Flair — identity, memory, and soul for AI agents. Zero heavy dependencies.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -45,4 +45,4 @@
   "devDependencies": {
     "typescript": "5.9.3"
   }
-}
+}