@tpsdev-ai/adk-flair 0.48.0 → 0.50.0

package/README.md

@@ -89,14 +89,21 @@ server.start();
 
 All values can also be passed directly to the constructor.
 
+Hosted Flair (non-localhost `FLAIR_URL`) uses the same Ed25519 triple as the
+Python package — agent id, keyfile, server-side `Agent` row with a matching
+public key. A 404 on `GET`/`PUT /Memory/{id}` is fail-closed ownership, not
+an existence signal. Walkthrough:
+[docs/integrations.md — Hosted Flair auth](../../docs/integrations.md#hosted-flair-auth--your-agent-got-a-404).
+
 ## Architecture
 
 ### Scope model
 
 Each ADK app authenticates as **one Flair agent** (its service identity).
 Per-user isolation is enforced by a **compound tag** — `adk:<app_name>:<user_id>`
-— attached to every record and filtered on every search. Colons in `app_name`
-or `user_id` are replaced with underscores to prevent delimiter breakage.
+— attached to every record and filtered on every search. Reserved characters
+(`%`, `:`, `_`) in `app_name` or `user_id` are percent-encoded so distinct
+identities never collide and the `:` delimiter stays unambiguous.
 
 ### Search path
 
@@ -107,7 +114,13 @@ or `user_id` are replaced with underscores to prevent delimiter breakage.
 
 ### Write path
 
-- Deterministic record IDs: `app:user:session:eventId` — re-ingestion upserts
+- Deterministic record IDs: `app:user:session:eventId` — re-ingestion upserts.
+  Direct `addMemory()` writes use the entry's `id` when supplied, else the
+  first 32 hex chars of the content's SHA-256 (re-adds replace, not duplicate)
+- Creates ride `POST /Memory/` (the create verb) with the id in the body; a
+  `409` (record already exists) falls back to `PUT /Memory/{id}`, preserving
+  replace semantics — a PUT-shaped create 404s on Harper deployments where
+  PUT is update-only (flair#1336)
 - Write failures log a structured warning (session id, event count, HTTP status)
 - No-text events are filtered (Vertex parity)
 
@@ -140,8 +153,49 @@ Implements `BaseMemoryService` from `@google/adk`.
 
 #### Extra methods (Vertex parity, not called by ADK)
 
-- **`addEventsToMemory(appName, userId, events, sessionId)`** — incremental per-turn writes
-- **`addMemory(appName, userId, memories)`** — direct memory writes
+- **`addEventsToMemory(appName, userId, events, sessionId, customMetadata?)`** — incremental per-turn writes
+- **`addMemory(appName, userId, memories, customMetadata?, opts?)`** — direct
+  memory writes. `opts`: `{ subject?, durability?, visibility? }`
+- **`listMemories(appName, userId, { limit?, offset? })`** — Flair-specific
+  browsing extension (NOT part of `BaseMemoryService`)
+
+### Custom metadata & subject
+
+`customMetadata` (an arbitrary JSON-serializable object) is stored on every
+record a write call produces, as an opaque blob on the record's `metadata`
+field, and round-trips back on `FlairMemoryEntry.customMetadata` from
+`searchMemory` / `listMemories`.
+
+**Store-and-return only** — ADK's contract: no key inside the blob has ANY
+server-side effect. `{"visibility": "shared"}` in the blob does **not** share
+the memory; use the explicit `opts.visibility` for that. Caps (throw before
+any write; reject, never truncate): 64KB serialized, nesting depth ≤ 16,
+≤ 512 total keys. Non-JSON-serializable values skip that key with a warning.
+
+`subject` is a short human-readable title (≤ 512 chars) promoted to the
+record's top-level indexed `subject` column — supplied via `opts.subject` or
+`customMetadata.subject` (the explicit option is authoritative when both are
+present), never auto-extracted from content. On read it surfaces both as
+`entry.subject` and `customMetadata["subject"]` (the column is authoritative
+over a divergent blob key; the `customMetadata` channel matches the Python
+package's return shape exactly).
+
+Read-path notes: `searchMemory` opts into `/SemanticSearch`'s
+`includeMetadata` projection flag; a malformed stored blob fails soft to `{}`
+with a warning naming the record id (a corrupt blob never takes recall down).
+Returned entries also carry the record `id`, `author` (the writing Flair
+agent id), and `timestamp` (the record's `createdAt`).
+
+### listMemories
+
+Lists an app+user's memories newest-first (`createdAt` DESC) with the full
+projection — no query needed. Scope is the compound tag AND the service's
+agent identity, both pushed down server-side and re-verified client-side.
+`limit` is 1..200 — over-cap **rejects** (never silently clamps); `offset` is
+positional over a point-in-time snapshot, not a live cursor. Unlike
+`searchMemory` (whose swallow-to-empty contract is ADK's), transport and HTTP
+failures **propagate** — a browsing UI must be able to tell "no memories"
+from "Flair is down".
 
 ## License
 

package/dist/index.d.ts

@@ -4,6 +4,7 @@
  * @packageDocumentation
  */
 export { FlairMemoryService } from "./memory_service.js";
+export type { FlairMemoryEntry, FlairSearchMemoryResponse, AddMemoryOptions, ListMemoriesOptions, FlairDurability, FlairVisibility, } from "./memory_service.js";
 export { compoundTag, sanitizeTagSegment, desanitizeTagSegment } from "./tag.js";
 export { loadEd25519Key, signRequest } from "./signing.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EACV,gBAAgB,EAChB,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AASzD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/memory_service.d.ts

@@ -2,22 +2,91 @@
  * FlairMemoryService — Flair as the memory backend for Google ADK (JS/TS).
  *
  * Implements @google/adk's `BaseMemoryService` interface (2 required methods)
- * plus the Vertex-parity extras (`addEventsToMemory`, `addMemory`).
+ * plus the Vertex-parity extras (`addEventsToMemory`, `addMemory`) and the
+ * Flair-specific `listMemories` browsing extension.
  *
  * Ported from the Python `adk-flair` package. See specs/ADK-FLAIR-ADAPTER.md
- * in the tpsdev-ai/cli repo for the full design.
+ * in the tpsdev-ai/cli repo for the full design; customMetadata/subject/
+ * listMemories semantics mirror the Python package's flair#1332/#1333
+ * implementation (#1334), and the create-verb semantics mirror flair#1336
+ * (#1339).
  */
 import type { BaseMemoryService, SearchMemoryRequest, SearchMemoryResponse } from "@google/adk";
 import type { MemoryEntry } from "@google/adk";
 import type { Session } from "@google/adk";
 import type { Event } from "@google/adk";
+/** Explicit write knobs accepted by the Memory schema. */
+export type FlairDurability = "permanent" | "persistent" | "standard" | "ephemeral";
+export type FlairVisibility = "private" | "shared";
+/**
+ * A MemoryEntry as returned by this service's read paths (searchMemory /
+ * listMemories).
+ *
+ * @google/adk's `MemoryEntry` is a plain-object interface (content, author?,
+ * timestamp?) — unlike the Python package's pydantic model it drops nothing at
+ * runtime, so Flair surfaces its extra fields BOTH top-level and (for
+ * `subject`) inside `customMetadata`:
+ *
+ * - `customMetadata` — the stored metadata blob parsed back to an object
+ *   (fail-soft `{}` + warning on a malformed blob). When the record carries a
+ *   top-level `subject` column it is ALSO surfaced as
+ *   `customMetadata["subject"]` — the column is authoritative over any
+ *   divergent blob key, and this channel keeps the return shape identical to
+ *   the Python package (whose MemoryEntry has no subject attribute, making
+ *   custom_metadata its only subject return channel).
+ * - `subject` — the top-level subject column, surfaced directly as well
+ *   (JS-only convenience; same value as `customMetadata["subject"]`).
+ * - `id` — the Flair record id.
+ */
+export interface FlairMemoryEntry extends MemoryEntry {
+    /** Flair Memory record id. */
+    id?: string;
+    /** Top-level `subject` column value, when the record carries one. */
+    subject?: string;
+    /** Stored customMetadata blob, parsed back. Always present (possibly {}). */
+    customMetadata: Record<string, unknown>;
+}
+/** searchMemory response with the Flair-typed entries. */
+export interface FlairSearchMemoryResponse extends SearchMemoryResponse {
+    memories: FlairMemoryEntry[];
+}
+/**
+ * Options for `addMemory` (flair#1332 + Python-parity explicit knobs).
+ *
+ * All are trust-anchor opt-ins — never model-selected, never sourced from
+ * `customMetadata` (except `subject`, which `customMetadata.subject` may also
+ * supply; the explicit option is authoritative when both are present).
+ */
+export interface AddMemoryOptions {
+    /**
+     * Short human-readable title promoted to the record's top-level indexed
+     * `subject` column. <= 512 chars (rejects beyond). Never auto-extracted
+     * from content. Authoritative over `customMetadata["subject"]`.
+     */
+    subject?: string;
+    /**
+     * Explicit durability. Omitted → "standard" in the body (unchanged
+     * behaviour). One of permanent | persistent | standard | ephemeral.
+     */
+    durability?: FlairDurability;
+    /**
+     * Explicit visibility. Omitted → no visibility key in the body (server
+     * applies its durability-keyed default). One of private | shared.
+     */
+    visibility?: FlairVisibility;
+}
+/** Options for `listMemories` (flair#1333). */
+export interface ListMemoriesOptions {
+    /** Page size, 1..200. Over-cap REJECTS (never silently clamps). Default 50. */
+    limit?: number;
+    /** Number of newest records to skip (>= 0). Positional, not a live cursor. */
+    offset?: number;
+}
 export declare class FlairMemoryService implements BaseMemoryService {
     private readonly _url;
     private readonly _agentId;
     private readonly _privateKey;
     private readonly _timeoutMs;
-    /** Per-session state for custom_metadata warn-once (Python parity). */
-    private _warnedSessions;
     /**
      * @param url - Flair HTTP URL (default: FLAIR_URL env or http://localhost:19926)
      * @param agentId - Flair agent ID (default: FLAIR_AGENT_ID env)
@@ -31,29 +100,121 @@ export declare class FlairMemoryService implements BaseMemoryService {
         timeoutMs?: number;
     });
     addSessionToMemory(session: Session): Promise<void>;
-    searchMemory(request: SearchMemoryRequest): Promise<SearchMemoryResponse>;
+    searchMemory(request: SearchMemoryRequest): Promise<FlairSearchMemoryResponse>;
     /**
      * Add events to memory incrementally (the quickstart's after_agent_callback path).
      * Not called by ADK — use in after_agent_callback or directly.
      *
-     * @param customMetadata - If provided, logs a once-per-session warning that
-     *   custom_metadata is not supported by adk-flair (Python parity).
+     * customMetadata (flair#1332) is stored on every record this call writes,
+     * as an opaque JSON blob on the Memory record's `metadata` field, and
+     * round-trips back on `FlairMemoryEntry.customMetadata` from searchMemory /
+     * listMemories. Store-and-return only — no key in it has any server-side
+     * effect. Caps (Error before any write): 64KB serialized, nesting depth
+     * <= 16, <= 512 total keys. customMetadata["subject"] (a string) is
+     * additionally promoted to the record's top-level `subject` column
+     * (<= 512 chars).
      */
     addEventsToMemory(appName: string, userId: string, events: Event[], sessionId: string, customMetadata?: Record<string, unknown>): Promise<void>;
     /**
      * Add memory entries directly.
      * Not called by ADK — use for direct memory writes.
      *
-     * @param customMetadata - If provided, logs a once-per-session warning that
-     *   custom_metadata is not supported by adk-flair (Python parity).
+     * customMetadata (flair#1332) is stored on every record this call writes,
+     * as an opaque JSON blob on the Memory record's `metadata` field, and
+     * round-trips back on `FlairMemoryEntry.customMetadata` from searchMemory /
+     * listMemories. Store-and-return only (the ADK contract, flair#1202): no
+     * key inside the blob has ANY server-side effect — {"visibility":"shared"}
+     * in here does not share the memory (use the explicit `visibility` option
+     * for that). Caps (Error before any write; reject, never truncate): 64KB
+     * serialized, nesting depth <= 16, <= 512 total keys. Non-JSON-serializable
+     * values skip that key with a warning.
+     *
+     * opts.subject (flair#1332, Flair-specific extension): short human-readable
+     * title promoted to the record's top-level indexed `subject` column.
+     * Sourced from this option or customMetadata["subject"]; the explicit
+     * option is authoritative when both are present. <= 512 chars (Error
+     * beyond). Never auto-extracted from content.
+     *
+     * opts.durability / opts.visibility: trust-anchor opt-ins (Python-parity
+     * explicit knobs), validated against the schema enums. Omitted durability →
+     * "standard"; omitted visibility → no key in the body (server default).
+     *
+     * Record ids mirror the Python package: `entry.id` when the caller supplies
+     * one (FlairMemoryEntry input), else the first 32 hex chars of the content's
+     * SHA-256 — deterministic, so re-adding identical content replaces rather
+     * than duplicates.
      */
-    addMemory(appName: string, userId: string, memories: MemoryEntry[], customMetadata?: Record<string, unknown>): Promise<void>;
+    addMemory(appName: string, userId: string, memories: Array<MemoryEntry & {
+        id?: string;
+    }>, customMetadata?: Record<string, unknown>, opts?: AddMemoryOptions): Promise<void>;
     /**
-     * Write a single record to Flair via PUT /Memory/{recordId}.
+     * List recent memories for an app+user, newest first.
+     *
+     * Flair-specific extension — NOT part of ADK's BaseMemoryService (which
+     * specifies only searchMemory). Useful for memory review UIs, dashboards,
+     * and agent contextual browsing where there is no query to search with.
+     *
+     * Scope: the same compound tag (adk:<app>:<user>) searchMemory uses, AND
+     * agentId === this service's agent identity — both pushed down as
+     * server-side query conditions and re-verified client-side on every
+     * returned row (defense in depth).
+     *
+     * Pagination: `offset` is POSITIONAL over a point-in-time snapshot ordered
+     * by createdAt descending — not a live cursor. Memories written between
+     * two pages shift positions, so a record can appear twice or be skipped
+     * across page boundaries. For a consistent view, take one page, or dedupe
+     * by id across pages.
+     *
+     * Throws on invalid arguments, and — unlike searchMemory (whose
+     * empty-on-error contract is ADK's) — PROPAGATES transport and HTTP
+     * failures: a browsing UI must be able to tell "no memories" from
+     * "Flair is down".
+     */
+    listMemories(appName: string, userId: string, opts?: ListMemoriesOptions): Promise<FlairMemoryEntry[]>;
+    /**
+     * Map a Flair Memory record/hit onto a FlairMemoryEntry.
+     *
+     * author derives from the record's agentId — the writing Flair agent
+     * (flair#1332 incidental fix, mirrored: records carry no "author" field,
+     * so reading hit.author was always undefined). timestamp derives from the
+     * record's createdAt for the same reason.
+     */
+    private _hitToMemoryEntry;
+    /**
+     * Rebuild FlairMemoryEntry.customMetadata from a record's stored fields.
+     *
+     * - `metadata` (the opaque JSON blob) parses back to an object. FAIL-SOFT:
+     *   malformed JSON (or JSON that isn't an object) yields {} plus a warning
+     *   naming the record id — a corrupt blob on one record must never take
+     *   the whole read path down.
+     * - A top-level `subject` column is surfaced as customMetadata["subject"].
+     *   The COLUMN is authoritative (flair#1332 ruling): when the blob carries
+     *   a divergent "subject" key, the column value overwrites it in the
+     *   returned object. This keeps the customMetadata return shape identical
+     *   to the Python package — a subject written via the explicit option
+     *   (never in the blob) still round-trips through customMetadata.
+     */
+    private _hitCustomMetadata;
+    /**
+     * Send one signed JSON-bodied request. The signing payload covers the full
+     * path (METHOD:pathname), so the path passed here is the one signed.
+     */
+    private _sendJson;
+    /**
+     * Create-or-replace one Memory record.
+     *
+     * Creates via `POST /Memory/` — Harper's collection create verb — with the
+     * id in the body. The previous shape, `PUT /Memory/{id}`, is update-only on
+     * some Harper deployments and 404s when the record does not exist yet
+     * (flair#1336, observed on hosted Harper Fabric; not reproducible on stock
+     * Harper 5.2.x, where PUT upserts). Mirrors the Python package's #1339 fix.
      *
-     * The deterministic record ID is embedded in the URL path so the server
-     * can perform an idempotent upsert. The signing payload covers the full
-     * path (METHOD:pathname), so the path MUST include the record ID.
+     * A 409 from POST means the record already exists — re-ingestion of a
+     * deterministic id (addSessionToMemory re-saves a growing session's earlier
+     * events every time) or a caller-supplied id being rewritten. Fall back to
+     * `PUT /Memory/{id}` for exactly that case, preserving the pre-#1336
+     * replace/refresh semantics for existing rows. Any other error propagates
+     * unchanged (the write-path warning logs carry the real HTTP status).
      */
     private _writeRecord;
     /**

package/dist/memory_service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory_service.d.ts","sourceRoot":"","sources":["../src/memory_service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAiDzC,qBAAa,kBAAmB,YAAW,iBAAiB;IAC1D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,uEAAuE;IACvE,OAAO,CAAC,eAAe,CAA0B;IAEjD;;;;;OAKG;gBACS,IAAI,CAAC,EAAE;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAqCK,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCnD,YAAY,CAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,oBAAoB,CAAC;IAmGhC;;;;;;OAMG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,KAAK,EAAE,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC;IAgDhB;;;;;;OAMG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,EAAE,EACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC;IAqDhB;;;;;;OAMG;YACW,YAAY;IAqC1B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}
+{"version":3,"file":"memory_service.d.ts","sourceRoot":"","sources":["../src/memory_service.ts"],"names":[],"mappings":"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"}

package/dist/memory_service.js

@@ -2,10 +2,14 @@
  * FlairMemoryService — Flair as the memory backend for Google ADK (JS/TS).
  *
  * Implements @google/adk's `BaseMemoryService` interface (2 required methods)
- * plus the Vertex-parity extras (`addEventsToMemory`, `addMemory`).
+ * plus the Vertex-parity extras (`addEventsToMemory`, `addMemory`) and the
+ * Flair-specific `listMemories` browsing extension.
  *
  * Ported from the Python `adk-flair` package. See specs/ADK-FLAIR-ADAPTER.md
- * in the tpsdev-ai/cli repo for the full design.
+ * in the tpsdev-ai/cli repo for the full design; customMetadata/subject/
+ * listMemories semantics mirror the Python package's flair#1332/#1333
+ * implementation (#1334), and the create-verb semantics mirror flair#1336
+ * (#1339).
  */
 import * as crypto from "node:crypto";
 import { loadEd25519Key, signRequest } from "./signing.js";
@@ -14,6 +18,31 @@ import { compoundTag } from "./tag.js";
 const LOCALHOST_HOSTS = new Set(["localhost", "127.0.0.1", "::1", "[::1]"]);
 const ALLOW_REMOTE_ENV = "FLAIR_ALLOW_REMOTE_URL";
 const DEFAULT_FLAIR_URL = "http://localhost:19926";
+// customMetadata caps (flair#1332, Sherlock hard requirements — mirrors the
+// Python package). REJECT, never truncate — a truncated blob silently corrupts
+// the store-and-return round-trip guarantee, which is the entire contract of
+// the field.
+//   - METADATA_MAX_BYTES: serialized JSON size cap. 64KB is generous for
+//     structured attributes (merchant/price/category/media refs) while keeping
+//     a single memory record from becoming a blob store.
+//   - METADATA_MAX_DEPTH / METADATA_MAX_KEYS: cheap structural caps checked
+//     BEFORE serialization (billion-laughs-adjacent guard — a pathologically
+//     nested/wide object is refused without ever attempting to serialize it).
+const METADATA_MAX_BYTES = 64 * 1024;
+const METADATA_MAX_DEPTH = 16;
+const METADATA_MAX_KEYS = 512;
+// subject cap (flair#1332): subject is a short human-readable title promoted
+// to the record's top-level indexed `subject` column — never a content field.
+const SUBJECT_MAX_CHARS = 512;
+// listMemories page-size hard cap (flair#1333). Reject-with-error (never
+// clamp) — consistent with every other adk-flair validation: a silently
+// clamped limit would make "I asked for 500, why did I get 200" a debugging
+// session instead of an immediate, actionable error.
+const LIST_MEMORIES_MAX_LIMIT = 200;
+// Valid enum values for the explicit write knobs (mirrors the Python
+// package's flair#1234/#1238 validation).
+const VALID_DURABILITIES = new Set(["permanent", "persistent", "standard", "ephemeral"]);
+const VALID_VISIBILITIES = new Set(["private", "shared"]);
 // ─── Helpers ────────────────────────────────────────────────────────────────
 function isLocalhost(hostname) {
     return LOCALHOST_HOSTS.has(hostname);
@@ -42,14 +71,142 @@ function extractText(content) {
         .filter(Boolean)
         .join(" ");
 }
+function isPlainObjectLike(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+// ─── customMetadata / subject (flair#1332 — mirrors the Python package) ─────
+/**
+ * Structural caps on customMetadata, checked BEFORE serialization.
+ *
+ * Rejects nesting deeper than METADATA_MAX_DEPTH levels or more than
+ * METADATA_MAX_KEYS total object keys (counted across every level) with an
+ * Error. Iterative traversal — no recursion, so adversarial nesting can't
+ * blow the stack; a self-referencing structure terminates via the depth cap
+ * (each revisit is pushed one level deeper), so a circular blob is rejected
+ * here and never reaches JSON.stringify.
+ */
+function validateMetadataShape(customMetadata) {
+    const stack = [[customMetadata, 1]];
+    let keyCount = 0;
+    while (stack.length > 0) {
+        const [node, depth] = stack.pop();
+        if (depth > METADATA_MAX_DEPTH) {
+            throw new Error(`customMetadata nesting exceeds ${METADATA_MAX_DEPTH} levels — ` +
+                "flatten the structure, or store a reference to the data instead " +
+                "of embedding it");
+        }
+        let children;
+        if (Array.isArray(node)) {
+            children = node;
+        }
+        else if (isPlainObjectLike(node)) {
+            const keys = Object.keys(node);
+            keyCount += keys.length;
+            if (keyCount > METADATA_MAX_KEYS) {
+                throw new Error(`customMetadata carries more than ${METADATA_MAX_KEYS} keys ` +
+                    "in total — split the data across memories, or store a " +
+                    "reference to it instead");
+            }
+            children = keys.map((k) => node[k]);
+        }
+        else {
+            continue;
+        }
+        for (const child of children) {
+            if (Array.isArray(child) || isPlainObjectLike(child)) {
+                stack.push([child, depth + 1]);
+            }
+        }
+    }
+}
+/**
+ * Serialize customMetadata to the JSON string stored in Memory.metadata.
+ *
+ * Store-and-return contract (flair#1202): the blob is opaque to the server —
+ * stored verbatim, returned verbatim, no key in it influences any server
+ * decision.
+ *
+ * - Structural caps (depth/key-count) and the serialized 64KB cap REJECT
+ *   with an Error — never truncate (truncation corrupts the round-trip
+ *   guarantee; Sherlock hard requirement, mirrored from the Python package).
+ * - A non-serializable VALUE skips that key with a warning naming the
+ *   session key — one bad value must not discard the caller's whole blob.
+ *   (In JS "non-serializable" means JSON.stringify yields undefined —
+ *   functions, symbols, bare undefined — or throws: BigInt. Object keys are
+ *   always strings in JS, so the Python non-string-key skip has no analogue.)
+ *
+ * Returns null when there is nothing to store (no metadata, or every key
+ * was skipped).
+ */
+function serializeCustomMetadata(customMetadata, contextKey) {
+    if (!customMetadata || Object.keys(customMetadata).length === 0)
+        return null;
+    validateMetadataShape(customMetadata);
+    const clean = {};
+    for (const [key, value] of Object.entries(customMetadata)) {
+        let probe;
+        try {
+            probe = JSON.stringify(value);
+        }
+        catch {
+            probe = undefined;
+        }
+        if (probe === undefined) {
+            console.warn(`[adk-flair] customMetadata key "${key}" skipped — value is not ` +
+                `JSON-serializable (session=${contextKey})`);
+            continue;
+        }
+        clean[key] = value;
+    }
+    if (Object.keys(clean).length === 0)
+        return null;
+    const serialized = JSON.stringify(clean);
+    const size = Buffer.byteLength(serialized, "utf8");
+    if (size > METADATA_MAX_BYTES) {
+        throw new Error(`customMetadata serializes to ${size} bytes, over the ` +
+            `${METADATA_MAX_BYTES}-byte cap — store large payloads elsewhere ` +
+            "and keep a reference here. Rejected rather than truncated: a " +
+            "truncated blob would silently corrupt the store-and-return " +
+            "round-trip guarantee.");
+    }
+    return serialized;
+}
+/**
+ * Resolve the top-level `subject` column value (flair#1332).
+ *
+ * Precedence: an explicit subject option is authoritative over
+ * customMetadata["subject"] when both are supplied. NEVER auto-extracted
+ * from content. Rejects non-string or over-cap (512 chars) values with an
+ * Error — subject is a short human-readable title promoted to an indexed
+ * column, not a content field. Returns null when neither source supplies
+ * one (empty strings resolve to null — nothing to promote).
+ */
+function resolveSubject(explicitSubject, customMetadata) {
+    let subject = explicitSubject;
+    let source = "subject option";
+    if ((subject === undefined || subject === null) && customMetadata !== undefined) {
+        subject = customMetadata["subject"];
+        source = 'customMetadata["subject"]';
+    }
+    if (subject === undefined || subject === null)
+        return null;
+    if (typeof subject !== "string") {
+        throw new Error(`${source} must be a string (got: ${typeof subject}) — ` +
+            "subject is promoted to the record's top-level subject column");
+    }
+    if (subject.length > SUBJECT_MAX_CHARS) {
+        throw new Error(`${source} is ${subject.length} characters, over the ` +
+            `${SUBJECT_MAX_CHARS}-char cap — subject is a short ` +
+            "human-readable title; put longer text in content or customMetadata");
+    }
+    return subject || null;
+}
 // ─── FlairMemoryService ─────────────────────────────────────────────────────
 export class FlairMemoryService {
     _url;
     _agentId;
     _privateKey;
     _timeoutMs;
-    /** Per-session state for custom_metadata warn-once (Python parity). */
-    _warnedSessions = new Set();
     /**
      * @param url - Flair HTTP URL (default: FLAIR_URL env or http://localhost:19926)
      * @param agentId - Flair agent ID (default: FLAIR_AGENT_ID env)
@@ -126,6 +283,12 @@ export class FlairMemoryService {
             q: query,
             tag,
             limit: 20,
+            // flair#1332: opt into the `metadata` blob in each hit.
+            // /SemanticSearch's default projection deliberately omits it (other
+            // consumers must not pay result-size for a blob they never read);
+            // this flag widens the projection for THIS request only. `subject`
+            // is in the default projection.
+            includeMetadata: true,
         });
         const start = Date.now();
         let phase = "connect";
@@ -152,22 +315,17 @@ export class FlairMemoryService {
                     return { memories: [] };
                 }
                 const data = (await resp.json());
-                const results = data.results ?? [];
+                const results = Array.isArray(data.results) ? data.results : [];
                 const memories = [];
                 for (const hit of results) {
-                    // Per-hit tag re-verification: drop hits missing the compound tag
-                    const hitTags = hit.tags ?? [];
+                    if (!isPlainObjectLike(hit))
+                        continue;
+                    // Per-hit tag re-verification: drop hits missing the compound tag.
+                    // Client-side analogue of Flair's isAllowed defense-in-depth.
+                    const hitTags = Array.isArray(hit["tags"]) ? hit["tags"] : [];
                     if (!hitTags.includes(tag))
                         continue;
-                    const content = {
-                        role: "user",
-                        parts: [{ text: hit.content ?? "" }],
-                    };
-                    memories.push({
-                        content,
-                        author: hit.author,
-                        timestamp: hit.timestamp,
-                    });
+                    memories.push(this._hitToMemoryEntry(hit));
                 }
                 return { memories };
             }
@@ -188,24 +346,27 @@ export class FlairMemoryService {
      * Add events to memory incrementally (the quickstart's after_agent_callback path).
      * Not called by ADK — use in after_agent_callback or directly.
      *
-     * @param customMetadata - If provided, logs a once-per-session warning that
-     *   custom_metadata is not supported by adk-flair (Python parity).
+     * customMetadata (flair#1332) is stored on every record this call writes,
+     * as an opaque JSON blob on the Memory record's `metadata` field, and
+     * round-trips back on `FlairMemoryEntry.customMetadata` from searchMemory /
+     * listMemories. Store-and-return only — no key in it has any server-side
+     * effect. Caps (Error before any write): 64KB serialized, nesting depth
+     * <= 16, <= 512 total keys. customMetadata["subject"] (a string) is
+     * additionally promoted to the record's top-level `subject` column
+     * (<= 512 chars).
      */
     async addEventsToMemory(appName, userId, events, sessionId, customMetadata) {
-        if (!events || events.length === 0)
-            return;
-        // custom_metadata warn-once per session (Python parity)
-        if (customMetadata) {
-            const sessionKey = `${appName}:${userId}:${sessionId}`;
-            if (!this._warnedSessions.has(sessionKey)) {
-                this._warnedSessions.add(sessionKey);
-                console.warn("adk-flair: custom_metadata ignored — adk-flair does not " +
-                    `support custom_metadata keys (session=${sessionKey})`);
-            }
-        }
         const tag = compoundTag(appName, userId);
+        // customMetadata → opaque JSON blob + optional promoted subject
+        // (flair#1332). Validated/serialized ONCE, before any write — a cap
+        // violation throws here and zero events are written, never a partial
+        // batch with silently-dropped metadata.
+        const sessionKey = `${appName}:${userId}:${sessionId}`;
+        const metadataJson = serializeCustomMetadata(customMetadata, sessionKey);
+        const subjectValue = resolveSubject(undefined, customMetadata);
         let written = 0;
-        for (const event of events) {
+        const eventList = events ?? [];
+        for (const event of eventList) {
             const text = extractText(event.content);
             if (!text)
                 continue;
@@ -219,6 +380,10 @@ export class FlairMemoryService {
                 tags: [tag],
                 createdAt: epochMsToIso(event.timestamp),
             };
+            if (metadataJson !== null)
+                body["metadata"] = metadataJson;
+            if (subjectValue !== null)
+                body["subject"] = subjectValue;
             try {
                 await this._writeRecord(recordId, body);
                 written++;
@@ -226,7 +391,7 @@ export class FlairMemoryService {
             catch (err) {
                 const msg = err instanceof Error ? err.message : String(err);
                 console.warn(`[adk-flair] write failed for session ${sessionId} event ${event.id} ` +
-                    `(written=${written}/${events.length}): ${msg}`);
+                    `(written=${written}/${eventList.length}): ${msg}`);
             }
         }
         if (written === 0)
@@ -236,39 +401,72 @@ export class FlairMemoryService {
      * Add memory entries directly.
      * Not called by ADK — use for direct memory writes.
      *
-     * @param customMetadata - If provided, logs a once-per-session warning that
-     *   custom_metadata is not supported by adk-flair (Python parity).
+     * customMetadata (flair#1332) is stored on every record this call writes,
+     * as an opaque JSON blob on the Memory record's `metadata` field, and
+     * round-trips back on `FlairMemoryEntry.customMetadata` from searchMemory /
+     * listMemories. Store-and-return only (the ADK contract, flair#1202): no
+     * key inside the blob has ANY server-side effect — {"visibility":"shared"}
+     * in here does not share the memory (use the explicit `visibility` option
+     * for that). Caps (Error before any write; reject, never truncate): 64KB
+     * serialized, nesting depth <= 16, <= 512 total keys. Non-JSON-serializable
+     * values skip that key with a warning.
+     *
+     * opts.subject (flair#1332, Flair-specific extension): short human-readable
+     * title promoted to the record's top-level indexed `subject` column.
+     * Sourced from this option or customMetadata["subject"]; the explicit
+     * option is authoritative when both are present. <= 512 chars (Error
+     * beyond). Never auto-extracted from content.
+     *
+     * opts.durability / opts.visibility: trust-anchor opt-ins (Python-parity
+     * explicit knobs), validated against the schema enums. Omitted durability →
+     * "standard"; omitted visibility → no key in the body (server default).
+     *
+     * Record ids mirror the Python package: `entry.id` when the caller supplies
+     * one (FlairMemoryEntry input), else the first 32 hex chars of the content's
+     * SHA-256 — deterministic, so re-adding identical content replaces rather
+     * than duplicates.
      */
-    async addMemory(appName, userId, memories, customMetadata) {
-        if (!memories || memories.length === 0)
-            return;
-        // custom_metadata warn-once (Python parity)
-        if (customMetadata) {
-            const sessionKey = `${appName}:${userId}:direct`;
-            if (!this._warnedSessions.has(sessionKey)) {
-                this._warnedSessions.add(sessionKey);
-                console.warn("adk-flair: custom_metadata ignored — adk-flair does not " +
-                    "support custom_metadata keys");
-            }
-        }
+    async addMemory(appName, userId, memories, customMetadata, opts) {
         const tag = compoundTag(appName, userId);
+        // Validate explicit durability / visibility (mirrors Python flair#1238).
+        if (opts?.durability !== undefined && !VALID_DURABILITIES.has(opts.durability)) {
+            throw new Error(`durability must be one of ${[...VALID_DURABILITIES].sort().join(", ")} ` +
+                `(got: ${JSON.stringify(opts.durability)})`);
+        }
+        if (opts?.visibility !== undefined && !VALID_VISIBILITIES.has(opts.visibility)) {
+            throw new Error(`visibility must be one of ${[...VALID_VISIBILITIES].sort().join(", ")} ` +
+                `(got: ${JSON.stringify(opts.visibility)})`);
+        }
+        // customMetadata → opaque JSON blob + optional promoted subject
+        // (flair#1332). Validated/serialized ONCE, before any write — a cap
+        // violation throws here and zero records are written.
+        const metadataJson = serializeCustomMetadata(customMetadata, `${appName}:${userId}:direct`);
+        const subjectValue = resolveSubject(opts?.subject, customMetadata);
         let written = 0;
-        for (const mem of memories) {
+        const memoryList = memories ?? [];
+        for (const mem of memoryList) {
             const text = extractText(mem.content);
             if (!text)
                 continue;
-            const recordId = `${appName}:${userId}:direct:${crypto.randomUUID()}`;
+            const recordId = mem.id ??
+                crypto.createHash("sha256").update(text, "utf8").digest("hex").slice(0, 32);
             const body = {
                 id: recordId,
                 agentId: this._agentId,
                 content: text,
                 type: "session",
-                durability: "standard",
+                durability: opts?.durability ?? "standard",
                 tags: [tag],
-                createdAt: mem.timestamp ?? new Date().toISOString(),
+                createdAt: mem.timestamp || new Date().toISOString(),
             };
+            if (opts?.visibility !== undefined)
+                body["visibility"] = opts.visibility;
+            if (metadataJson !== null)
+                body["metadata"] = metadataJson;
+            if (subjectValue !== null)
+                body["subject"] = subjectValue;
             if (mem.author) {
-                body.author = mem.author;
+                body["author"] = mem.author;
             }
             try {
                 await this._writeRecord(recordId, body);
@@ -277,28 +475,196 @@ export class FlairMemoryService {
             catch (err) {
                 const msg = err instanceof Error ? err.message : String(err);
                 console.warn(`[adk-flair] direct memory write failed for id ${recordId} ` +
-                    `(written=${written}/${memories.length}): ${msg}`);
+                    `(written=${written}/${memoryList.length}): ${msg}`);
             }
         }
         if (written === 0)
             return;
     }
-    // ─── Internal ─────────────────────────────────────────────────────────────
+    // ─── listMemories (flair#1333 — Flair-specific extension) ─────────────────
     /**
-     * Write a single record to Flair via PUT /Memory/{recordId}.
+     * List recent memories for an app+user, newest first.
      *
-     * The deterministic record ID is embedded in the URL path so the server
-     * can perform an idempotent upsert. The signing payload covers the full
-     * path (METHOD:pathname), so the path MUST include the record ID.
+     * Flair-specific extension — NOT part of ADK's BaseMemoryService (which
+     * specifies only searchMemory). Useful for memory review UIs, dashboards,
+     * and agent contextual browsing where there is no query to search with.
+     *
+     * Scope: the same compound tag (adk:<app>:<user>) searchMemory uses, AND
+     * agentId === this service's agent identity — both pushed down as
+     * server-side query conditions and re-verified client-side on every
+     * returned row (defense in depth).
+     *
+     * Pagination: `offset` is POSITIONAL over a point-in-time snapshot ordered
+     * by createdAt descending — not a live cursor. Memories written between
+     * two pages shift positions, so a record can appear twice or be skipped
+     * across page boundaries. For a consistent view, take one page, or dedupe
+     * by id across pages.
+     *
+     * Throws on invalid arguments, and — unlike searchMemory (whose
+     * empty-on-error contract is ADK's) — PROPAGATES transport and HTTP
+     * failures: a browsing UI must be able to tell "no memories" from
+     * "Flair is down".
      */
-    async _writeRecord(recordId, body) {
-        const path = `/Memory/${recordId}`;
-        const authHeader = signRequest(this._privateKey, this._agentId, "PUT", path);
+    async listMemories(appName, userId, opts) {
+        const limit = opts?.limit ?? 50;
+        const offset = opts?.offset ?? 0;
+        if (!appName) {
+            throw new Error("appName is required");
+        }
+        if (!userId) {
+            throw new Error("userId is required — listMemories never lists unscoped");
+        }
+        if (typeof limit !== "number" || !Number.isInteger(limit) || limit < 1) {
+            throw new Error(`limit must be a positive integer (got: ${JSON.stringify(limit)})`);
+        }
+        if (limit > LIST_MEMORIES_MAX_LIMIT) {
+            throw new Error(`limit ${limit} exceeds the hard cap of ${LIST_MEMORIES_MAX_LIMIT} ` +
+                "— page with offset instead");
+        }
+        if (typeof offset !== "number" || !Number.isInteger(offset) || offset < 0) {
+            throw new Error(`offset must be a non-negative integer (got: ${JSON.stringify(offset)})`);
+        }
+        const tag = compoundTag(appName, userId);
+        // Harper REST collection query (signed like every other request — the
+        // signature covers path+query). The tag value is percent-encoded
+        // WHOLESALE: compound tags legitimately contain literal %XX escapes from
+        // sanitizeTagSegment, which must survive the server's URL decode.
+        // limit(start,end) is Harper's offset window: start=offset,
+        // end=offset+limit.
+        const path = `/Memory/?tags=${encodeURIComponent(tag)}` +
+            `&agentId=${encodeURIComponent(this._agentId)}` +
+            `&select(id,agentId,content,metadata,subject,tags,createdAt)` +
+            `&sort(-createdAt)` +
+            `&limit(${offset},${offset + limit})`;
+        const authHeader = signRequest(this._privateKey, this._agentId, "GET", path);
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this._timeoutMs);
+        let rows;
         try {
             const resp = await fetch(`${this._url}${path}`, {
-                method: "PUT",
+                method: "GET",
+                headers: { "Authorization": authHeader },
+                signal: controller.signal,
+            });
+            if (!resp.ok) {
+                const text = await resp.text().catch(() => "");
+                throw new Error(`Flair GET /Memory/ → HTTP ${resp.status}` +
+                    `${text ? `: ${text.slice(0, 200)}` : ""}`);
+            }
+            rows = await resp.json();
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        if (!Array.isArray(rows)) {
+            return [];
+        }
+        const entries = [];
+        for (const row of rows) {
+            if (!isPlainObjectLike(row))
+                continue;
+            // Defense in depth: re-verify both scope conditions client-side,
+            // mirroring searchMemory's tag re-verification.
+            const rowTags = Array.isArray(row["tags"]) ? row["tags"] : [];
+            if (!rowTags.includes(tag))
+                continue;
+            if (row["agentId"] !== this._agentId)
+                continue;
+            entries.push(this._hitToMemoryEntry(row));
+        }
+        return entries;
+    }
+    // ─── Hit → MemoryEntry mapping ─────────────────────────────────────────────
+    /**
+     * Map a Flair Memory record/hit onto a FlairMemoryEntry.
+     *
+     * author derives from the record's agentId — the writing Flair agent
+     * (flair#1332 incidental fix, mirrored: records carry no "author" field,
+     * so reading hit.author was always undefined). timestamp derives from the
+     * record's createdAt for the same reason.
+     */
+    _hitToMemoryEntry(hit) {
+        const contentText = typeof hit["content"] === "string" ? hit["content"] : "";
+        const customMetadata = this._hitCustomMetadata(hit);
+        const subject = hit["subject"];
+        const entry = {
+            content: {
+                role: "model",
+                parts: [{ text: contentText }],
+            },
+            customMetadata,
+        };
+        if (typeof hit["id"] === "string")
+            entry.id = hit["id"];
+        if (typeof hit["agentId"] === "string")
+            entry.author = hit["agentId"];
+        if (typeof hit["createdAt"] === "string")
+            entry.timestamp = hit["createdAt"];
+        if (typeof subject === "string" && subject)
+            entry.subject = subject;
+        return entry;
+    }
+    /**
+     * Rebuild FlairMemoryEntry.customMetadata from a record's stored fields.
+     *
+     * - `metadata` (the opaque JSON blob) parses back to an object. FAIL-SOFT:
+     *   malformed JSON (or JSON that isn't an object) yields {} plus a warning
+     *   naming the record id — a corrupt blob on one record must never take
+     *   the whole read path down.
+     * - A top-level `subject` column is surfaced as customMetadata["subject"].
+     *   The COLUMN is authoritative (flair#1332 ruling): when the blob carries
+     *   a divergent "subject" key, the column value overwrites it in the
+     *   returned object. This keeps the customMetadata return shape identical
+     *   to the Python package — a subject written via the explicit option
+     *   (never in the blob) still round-trips through customMetadata.
+     */
+    _hitCustomMetadata(hit) {
+        let parsed = {};
+        const raw = hit["metadata"];
+        if (raw) {
+            let loaded;
+            let malformed = false;
+            if (typeof raw === "string") {
+                try {
+                    loaded = JSON.parse(raw);
+                }
+                catch {
+                    malformed = true;
+                }
+            }
+            else {
+                malformed = true;
+            }
+            if (malformed) {
+                console.warn(`[adk-flair] malformed metadata JSON on record ${String(hit["id"])} — ` +
+                    "returning empty customMetadata for it");
+            }
+            else if (isPlainObjectLike(loaded)) {
+                parsed = loaded;
+            }
+            else {
+                console.warn(`[adk-flair] metadata on record ${String(hit["id"])} is JSON but not ` +
+                    "an object — returning empty customMetadata for it");
+            }
+        }
+        const subject = hit["subject"];
+        if (typeof subject === "string" && subject) {
+            parsed["subject"] = subject;
+        }
+        return parsed;
+    }
+    // ─── Internal ─────────────────────────────────────────────────────────────
+    /**
+     * Send one signed JSON-bodied request. The signing payload covers the full
+     * path (METHOD:pathname), so the path passed here is the one signed.
+     */
+    async _sendJson(method, path, body) {
+        const authHeader = signRequest(this._privateKey, this._agentId, method, path);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this._timeoutMs);
+        try {
+            return await fetch(`${this._url}${path}`, {
+                method,
                 headers: {
                     "Authorization": authHeader,
                     "Content-Type": "application/json",
@@ -306,15 +672,41 @@ export class FlairMemoryService {
                 body: JSON.stringify(body),
                 signal: controller.signal,
             });
-            if (!resp.ok) {
-                const text = await resp.text().catch(() => "");
-                throw new Error(`HTTP ${resp.status}${text ? `: ${text.slice(0, 200)}` : ""}`);
-            }
         }
         finally {
             clearTimeout(timeoutId);
         }
     }
+    /**
+     * Create-or-replace one Memory record.
+     *
+     * Creates via `POST /Memory/` — Harper's collection create verb — with the
+     * id in the body. The previous shape, `PUT /Memory/{id}`, is update-only on
+     * some Harper deployments and 404s when the record does not exist yet
+     * (flair#1336, observed on hosted Harper Fabric; not reproducible on stock
+     * Harper 5.2.x, where PUT upserts). Mirrors the Python package's #1339 fix.
+     *
+     * A 409 from POST means the record already exists — re-ingestion of a
+     * deterministic id (addSessionToMemory re-saves a growing session's earlier
+     * events every time) or a caller-supplied id being rewritten. Fall back to
+     * `PUT /Memory/{id}` for exactly that case, preserving the pre-#1336
+     * replace/refresh semantics for existing rows. Any other error propagates
+     * unchanged (the write-path warning logs carry the real HTTP status).
+     */
+    async _writeRecord(recordId, body) {
+        const resp = await this._sendJson("POST", "/Memory/", body);
+        if (resp.ok)
+            return;
+        if (resp.status !== 409) {
+            const text = await resp.text().catch(() => "");
+            throw new Error(`HTTP ${resp.status}${text ? `: ${text.slice(0, 200)}` : ""}`);
+        }
+        const putResp = await this._sendJson("PUT", `/Memory/${recordId}`, body);
+        if (!putResp.ok) {
+            const text = await putResp.text().catch(() => "");
+            throw new Error(`HTTP ${putResp.status}${text ? `: ${text.slice(0, 200)}` : ""}`);
+        }
+    }
     /**
      * Close the service. No-op for the HTTP-based implementation;
      * provided for API compatibility with the Python package.

package/dist/memory_service.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory_service.js","sourceRoot":"","sources":["../src/memory_service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory_service.js","sourceRoot":"","sources":["../src/memory_service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tpsdev-ai/adk-flair",
-  "version": "0.48.0",
+  "version": "0.50.0",
   "description": "Flair memory backend for Google ADK — self-hosted, federated, portable agent memory",
   "type": "module",
   "main": "dist/index.js",