@tpsdev-ai/flair-client 0.19.0 → 0.20.0

package/dist/client.d.ts

@@ -7,7 +7,7 @@
  *   const results = await flair.memory.search('that thing')
  *   const ctx = await flair.bootstrap({ maxTokens: 4000 })
  */
-import type { FlairClientConfig, Memory, MemoryType, Durability, SoulEntry, SearchResult, BootstrapResult } from "./types.js";
+import type { FlairClientConfig, Memory, MemoryType, Durability, Visibility, SoulEntry, SearchResult, BootstrapResult } from "./types.js";
 export declare class FlairClient {
     readonly url: string;
     readonly agentId: string;
@@ -56,6 +56,12 @@ declare class MemoryApi {
         durability?: Durability;
         tags?: string[];
         subject?: string;
+        /** Writer-controlled sharing intent. Omit to let the
+         *  server apply its durability-keyed default (permanent/persistent →
+         *  shared, standard/ephemeral → private) — only forwarded when the
+         *  caller explicitly sets it, so omitting this is a no-op change from
+         *  today's behavior. */
+        visibility?: Visibility;
         /** Ask the server to run its conservative near-duplicate check for this
          *  write and report a collision signal if found. Does NOT suppress the
          *  write either way. Default: false (server still applies its own

package/dist/client.js

@@ -129,6 +129,12 @@ class MemoryApi {
             subject: opts.subject,
             createdAt: new Date().toISOString(),
         };
+        // Forward visibility ONLY when the caller set it — an unset visibility
+        // must reach the server as "absent" (not e.g. defaulted client-side) so
+        // the server's durability-keyed default (Memory.post/put) is the one
+        // source of truth for the default, never duplicated here.
+        if (opts.visibility !== undefined)
+            record.visibility = opts.visibility;
         // Passthrough hints — the server strips these before persisting; they are
         // never stored on the record itself.
         if (opts.dedup !== undefined)

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { FlairClient, FlairError } from "./client.js";
 export { loadPrivateKey, resolveKeyPath, signRequest } from "./auth.js";
-export type { FlairClientConfig, Memory, MemoryType, Durability, SoulEntry, SearchResult, BootstrapResult, } from "./types.js";
+export type { FlairClientConfig, Memory, MemoryType, Durability, Visibility, SoulEntry, SearchResult, BootstrapResult, } from "./types.js";

package/dist/types.d.ts

@@ -4,6 +4,15 @@ export type { KeyObject };
 export type Durability = "permanent" | "persistent" | "standard" | "ephemeral";
 /** Memory type classification. */
 export type MemoryType = "session" | "lesson" | "decision" | "preference" | "fact" | "goal";
+/**
+ * Writer-controlled sharing intent. "private" — owner only,
+ * never returned to another agent even if that agent holds a MemoryGrant.
+ * "shared" — visible to owner + any grant-holder (subject to the grant's
+ * scope). When unset on write, the server defaults it from `durability`:
+ * permanent/persistent → shared, standard/ephemeral/absent → private. An
+ * explicit value here always overrides the server default.
+ */
+export type Visibility = "private" | "shared";
 /** A memory record. */
 export interface Memory {
     id: string;
@@ -13,6 +22,11 @@ export interface Memory {
     durability: Durability;
     tags: string[];
     subject?: string;
+    /** Writer-controlled sharing intent. Absent on records written before this
+     *  field existed — the server treats absence as "shared" (migration-
+     *  invariant: an existing memory keeps reading to exactly whoever holds a
+     *  grant today), never as "private". */
+    visibility?: Visibility;
     createdAt: string;
     updatedAt?: string;
     /** Always true after a successful write()/update() — the server never

package/package.json

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