@tpsdev-ai/langgraph-flair 0.9.0

package/README.md

@@ -0,0 +1,82 @@
+# @tpsdev-ai/langgraph-flair
+
+LangGraph `BaseStore` adapter backed by [Flair](https://github.com/tpsdev-ai/flair) — durable agent memory with crypto-pinned per-agent identity, federated peer-to-peer sync, and cross-orchestrator portability.
+
+Drop-in for LangGraph's `InMemoryStore`. The same memories your LangGraph agent writes are then visible to every other Flair-enabled harness:
+
+- Claude Code / Cursor / Continue.dev / Codex (via [`@tpsdev-ai/flair-mcp`](../flair-mcp))
+- OpenClaw (via [`@tpsdev-ai/openclaw-flair`](../openclaw-flair))
+- n8n (via [`@tpsdev-ai/n8n-nodes-flair`](../n8n-nodes-flair))
+- Hermes Agent (via [`hermes-flair`](../hermes-flair))
+- Pi agent (via [`@tpsdev-ai/pi-flair`](../pi-flair))
+
+## Install
+
+```bash
+npm install @tpsdev-ai/langgraph-flair @tpsdev-ai/flair-client
+# Or, if you're already using LangGraph:
+npm install @tpsdev-ai/langgraph-flair
+```
+
+## Usage
+
+```typescript
+import { FlairStore } from "@tpsdev-ai/langgraph-flair";
+import { StateGraph } from "@langchain/langgraph";
+
+const store = new FlairStore({ agentId: "my-agent" });
+
+const graph = new StateGraph(...)
+  .compile({ store });
+
+// Or with createReactAgent:
+import { createReactAgent } from "@langchain/langgraph/prebuilt";
+const agent = createReactAgent({ llm, tools, store });
+```
+
+## How LangGraph's namespace maps to Flair
+
+LangGraph's `BaseStore` uses hierarchical namespaces (`["users", "profiles"]`) and string keys (`"user123"`). FlairStore maps each item to a Flair memory:
+
+| LangGraph | Flair |
+|-----------|-------|
+| `namespace: ["users", "profiles"]` | `tags: ["lg-ns:users/profiles"]` |
+| `key: "user123"` | id suffix: `lg:<agentId>:users/profiles:user123` |
+| `value: { name: "Alice" }` | `content: '{"name":"Alice"}'` |
+| `search.query: "..."` | semantic search via Flair's HNSW index |
+| `search.filter: { age: { $gte: 18 } }` | applied client-side after retrieval |
+
+## Authentication
+
+`FlairStore` inherits from `FlairClient`. Three options:
+
+1. **Ed25519 keypair** (preferred): set `FLAIR_AGENT_ID` and the client auto-resolves your key.
+2. **Explicit key path**: `new FlairStore({ agentId, keyPath: "/path/to/key.pem" })`
+3. **Basic auth fallback**: `new FlairStore({ agentId, adminUser, adminPassword })` for standalone deployments.
+
+```typescript
+const store = new FlairStore({
+  agentId: "my-agent",
+  url: "https://flair.example.com",  // or FLAIR_URL env var
+  adminPassword: process.env.FLAIR_ADMIN_PASS,
+});
+```
+
+## What you get
+
+- **Persistence**: memories survive process restarts and re-deploys.
+- **Federation**: pair your local Flair to a hub; memories sync peer-to-peer.
+- **Cross-orchestrator**: switch from LangGraph to OpenClaw to Claude Code without losing the agent's history.
+- **Identity**: every memory is tied to a crypto-pinned `agentId`. No tenant-isolation slop.
+- **Open source**: runs on your hardware. No SaaS lock-in.
+
+## Limitations (v1)
+
+- LangGraph's `IndexConfig` (custom embedding model, per-field indexing) is ignored. Flair has its own embedding pipeline (`nomic-embed-text-v1.5`, 768-dim) and embeds the full content blob. If you need per-field embeddings, pre-extract and store as separate items.
+- `search.filter` operators (`$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`) are applied client-side after retrieving the namespace prefix. Tag-based pre-filtering (the namespace) keeps this bounded; high-fanout filters across many memories will be slower.
+- Namespace-prefix matching uses the full joined-path tag (`lg-ns:users/profiles`). Items in `["users", "profiles", "u123"]` are reachable via the `["users", "profiles"]` prefix because the search routine post-filters parsed namespaces against the requested prefix — but searching by a *single label anywhere in the namespace* (e.g. "all items with `profiles` somewhere") isn't supported. LangGraph's `BaseStore.search` API doesn't expose this surface either, so there's no read path that would benefit; if a future LangGraph extension adds it we'll add a derived index then.
+- `listNamespaces` returns namespaces seen in your stored memories (best-effort scan). Empty namespaces aren't enumerable.
+
+## License
+
+Apache 2.0 — same as Flair core.

package/dist/index.d.ts

@@ -0,0 +1,155 @@
+/**
+ * FlairStore — LangGraph BaseStore implementation backed by Flair.
+ *
+ * Lets a LangGraph agent persist long-term memory ("Store" in LangGraph
+ * vocabulary) into a Flair instance, getting crypto-pinned per-agent
+ * identity, federated peer-to-peer sync, and cross-orchestrator portability
+ * for free. The same memories are then visible to any other Flair-enabled
+ * harness (Claude Code via flair-mcp, OpenClaw via openclaw-flair, n8n via
+ * n8n-nodes-flair, Hermes via hermes-flair, Pi via pi-flair).
+ *
+ * The adapter implements the abstract `batch()` method that every BaseStore
+ * subclass must provide. The base class's concrete `get/put/search/delete/
+ * listNamespaces` helpers all funnel through `batch()`, so we get the full
+ * surface from one entry point.
+ *
+ * # Mapping
+ *
+ *   LangGraph                    Flair
+ *   ---------                    -----
+ *   namespace: string[]          tags: ["lg-ns:<joined>", "lg-ns-part:<each>"]
+ *   key: string                  id suffix (full id: "lg:<agentId>:<ns>:<key>")
+ *   value: object                content: JSON.stringify(value)
+ *   search.query                 SemanticSearch q
+ *   search.filter (eq/gt/lt)     applied client-side after retrieval
+ *   put(value=null)              DELETE
+ *
+ * Namespace fan-out: each namespace label gets its own tag prefixed with
+ * `lg-ns-part:` so search filters can match prefixes, plus the full joined
+ * namespace as `lg-ns:` for exact lookups. (LangGraph forbids periods in
+ * labels, so we use `/` as the separator.)
+ *
+ * # Limitations (v1)
+ *
+ * - LangGraph's `IndexConfig` (custom embedding model + per-field indexing)
+ *   is ignored. Flair has its own embedding pipeline (nomic-embed-text-v1.5)
+ *   and embeds the full content blob. If you need per-field embedding,
+ *   pre-extract the fields and put them as separate items.
+ * - `search.filter` operators ($eq/$ne/$gt/$gte/$lt/$lte) are applied
+ *   client-side after retrieving the namespace prefix, so filter-heavy
+ *   workloads can incur a network round-trip per matching memory. Tag-based
+ *   pre-filtering (the namespace prefix) keeps this bounded in practice.
+ * - `listNamespaces` returns namespaces seen in the agent's stored memories.
+ *   It can't enumerate empty namespaces.
+ *
+ * # Auth
+ *
+ * Inherits from FlairClient — Ed25519 keypair if available (preferred), or
+ * Basic auth via FLAIR_ADMIN_PASS for standalone deployments.
+ */
+interface Item {
+    value: Record<string, any>;
+    key: string;
+    namespace: string[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface SearchItem extends Item {
+    score?: number;
+}
+interface GetOperation {
+    namespace: string[];
+    key: string;
+}
+interface SearchOperation {
+    namespacePrefix: string[];
+    filter?: Record<string, any>;
+    limit?: number;
+    offset?: number;
+    query?: string;
+}
+interface PutOperation {
+    namespace: string[];
+    key: string;
+    value: Record<string, any> | null;
+    index?: false | string[];
+}
+interface ListNamespacesOperation {
+    matchConditions?: any[];
+    maxDepth?: number;
+    limit: number;
+    offset: number;
+}
+type Operation = GetOperation | SearchOperation | PutOperation | ListNamespacesOperation;
+/**
+ * Apply a single LangGraph filter operator. Mirrors BaseStore's documented
+ * surface: $eq (default), $ne, $gt, $gte, $lt, $lte. Bare values are $eq.
+ *
+ * Exported for unit testing (Kern review on #370 — non-trivial logic with
+ * 7 branches must have coverage).
+ */
+export declare function matchesFilter(value: any, condition: any): boolean;
+/** Apply all field filters in a search request. Logical AND across fields. */
+export declare function matchesAllFilters(value: Record<string, any>, filter: Record<string, any> | undefined): boolean;
+/**
+ * Configuration for FlairStore. Same shape as FlairClient's config plus
+ * one extra: `agentId` is required (LangGraph isn't agent-aware on its own,
+ * so we pin it at construction time).
+ */
+export interface FlairStoreConfig {
+    /** Required. The Flair agent identity to scope all memories under. */
+    agentId: string;
+    /** Flair URL. Defaults to FLAIR_URL env or http://localhost:19926. */
+    url?: string;
+    /** Path to Ed25519 private key file. Auto-resolved from agent id if omitted. */
+    keyPath?: string;
+    /** Or pass the key directly as PEM string. */
+    privateKey?: string;
+    /** Basic-auth fallback for standalone deployments without Ed25519. */
+    adminUser?: string;
+    adminPassword?: string;
+    /** Request timeout in ms. Default 30s. */
+    timeoutMs?: number;
+}
+/**
+ * FlairStore — drop-in replacement for LangGraph's `InMemoryStore` that
+ * persists into Flair. Extends LangGraph's `BaseStore` interface
+ * structurally without importing the abstract class directly (peer-dep
+ * pattern keeps the package install-light if a host already has langgraph).
+ *
+ * Usage:
+ *   import { FlairStore } from "@tpsdev-ai/langgraph-flair";
+ *   const store = new FlairStore({ agentId: "my-agent" });
+ *   const graph = new StateGraph(...).compile({ store });
+ *
+ * Or pass it to the agent directly:
+ *   const agent = createReactAgent({ llm, tools, store });
+ */
+export declare class FlairStore {
+    private client;
+    private agentId;
+    constructor(config: FlairStoreConfig);
+    /** The LangGraph-required entry point. All concrete operations funnel here. */
+    batch<Op extends Operation[]>(operations: Op): Promise<any[]>;
+    get(namespace: string[], key: string): Promise<Item | null>;
+    put(namespace: string[], key: string, value: Record<string, any>, index?: false | string[]): Promise<void>;
+    delete(namespace: string[], key: string): Promise<void>;
+    search(namespacePrefix: string[], options?: {
+        filter?: Record<string, any>;
+        limit?: number;
+        offset?: number;
+        query?: string;
+    }): Promise<SearchItem[]>;
+    private dispatch;
+    private doGet;
+    private doPut;
+    private doSearch;
+    private doListNamespaces;
+}
+export declare function parseStoredId(id: string, agentId: string): {
+    namespace: string[];
+    key: string;
+} | null;
+export declare function hasNamespacePrefix(namespace: string[], prefix: string[]): boolean;
+export type { Item, SearchItem, GetOperation, PutOperation, SearchOperation, ListNamespacesOperation };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,352 @@
+/**
+ * FlairStore — LangGraph BaseStore implementation backed by Flair.
+ *
+ * Lets a LangGraph agent persist long-term memory ("Store" in LangGraph
+ * vocabulary) into a Flair instance, getting crypto-pinned per-agent
+ * identity, federated peer-to-peer sync, and cross-orchestrator portability
+ * for free. The same memories are then visible to any other Flair-enabled
+ * harness (Claude Code via flair-mcp, OpenClaw via openclaw-flair, n8n via
+ * n8n-nodes-flair, Hermes via hermes-flair, Pi via pi-flair).
+ *
+ * The adapter implements the abstract `batch()` method that every BaseStore
+ * subclass must provide. The base class's concrete `get/put/search/delete/
+ * listNamespaces` helpers all funnel through `batch()`, so we get the full
+ * surface from one entry point.
+ *
+ * # Mapping
+ *
+ *   LangGraph                    Flair
+ *   ---------                    -----
+ *   namespace: string[]          tags: ["lg-ns:<joined>", "lg-ns-part:<each>"]
+ *   key: string                  id suffix (full id: "lg:<agentId>:<ns>:<key>")
+ *   value: object                content: JSON.stringify(value)
+ *   search.query                 SemanticSearch q
+ *   search.filter (eq/gt/lt)     applied client-side after retrieval
+ *   put(value=null)              DELETE
+ *
+ * Namespace fan-out: each namespace label gets its own tag prefixed with
+ * `lg-ns-part:` so search filters can match prefixes, plus the full joined
+ * namespace as `lg-ns:` for exact lookups. (LangGraph forbids periods in
+ * labels, so we use `/` as the separator.)
+ *
+ * # Limitations (v1)
+ *
+ * - LangGraph's `IndexConfig` (custom embedding model + per-field indexing)
+ *   is ignored. Flair has its own embedding pipeline (nomic-embed-text-v1.5)
+ *   and embeds the full content blob. If you need per-field embedding,
+ *   pre-extract the fields and put them as separate items.
+ * - `search.filter` operators ($eq/$ne/$gt/$gte/$lt/$lte) are applied
+ *   client-side after retrieving the namespace prefix, so filter-heavy
+ *   workloads can incur a network round-trip per matching memory. Tag-based
+ *   pre-filtering (the namespace prefix) keeps this bounded in practice.
+ * - `listNamespaces` returns namespaces seen in the agent's stored memories.
+ *   It can't enumerate empty namespaces.
+ *
+ * # Auth
+ *
+ * Inherits from FlairClient — Ed25519 keypair if available (preferred), or
+ * Basic auth via FLAIR_ADMIN_PASS for standalone deployments.
+ */
+import { FlairClient } from "@tpsdev-ai/flair-client";
+const NS_SEP = "/"; // LangGraph forbids periods in namespace labels
+const TAG_PREFIX_FULL = "lg-ns:";
+/** Single namespace tag — the joined-path form (e.g. "lg-ns:users/profiles").
+ *
+ *  We previously also wrote per-segment tags (lg-ns-part:users, lg-ns-part:
+ *  profiles) for "contains-label" queries, but LangGraph's BaseStore.search
+ *  contract takes a `namespacePrefix` array — there's no surface for "items
+ *  containing this label anywhere." The per-part tags inflated the Harper
+ *  tag index with no read path. Dropped per Kern's review on #370.
+ *
+ *  If a future LangGraph extension exposes a "search by label" API, we can
+ *  add a derived index then — until then, dead storage is worse than a
+ *  documented gap. */
+function nsTags(namespace) {
+    return [`${TAG_PREFIX_FULL}${namespace.join(NS_SEP)}`];
+}
+function memoryId(agentId, namespace, key) {
+    return `lg:${agentId}:${namespace.join(NS_SEP)}:${key}`;
+}
+function isGet(op) {
+    return "key" in op && !("value" in op);
+}
+function isPut(op) {
+    return "key" in op && "value" in op;
+}
+function isSearch(op) {
+    return "namespacePrefix" in op;
+}
+function isListNs(op) {
+    return !("namespace" in op) && !("namespacePrefix" in op);
+}
+/**
+ * Apply a single LangGraph filter operator. Mirrors BaseStore's documented
+ * surface: $eq (default), $ne, $gt, $gte, $lt, $lte. Bare values are $eq.
+ *
+ * Exported for unit testing (Kern review on #370 — non-trivial logic with
+ * 7 branches must have coverage).
+ */
+export function matchesFilter(value, condition) {
+    if (condition === null || typeof condition !== "object") {
+        return value === condition;
+    }
+    for (const [op, cmp] of Object.entries(condition)) {
+        switch (op) {
+            case "$eq":
+                if (value !== cmp)
+                    return false;
+                break;
+            case "$ne":
+                if (value === cmp)
+                    return false;
+                break;
+            case "$gt":
+                if (!(value > cmp))
+                    return false;
+                break;
+            case "$gte":
+                if (!(value >= cmp))
+                    return false;
+                break;
+            case "$lt":
+                if (!(value < cmp))
+                    return false;
+                break;
+            case "$lte":
+                if (!(value <= cmp))
+                    return false;
+                break;
+            default: return value === condition; // unknown operator → bare-eq fallback
+        }
+    }
+    return true;
+}
+/** Apply all field filters in a search request. Logical AND across fields. */
+export function matchesAllFilters(value, filter) {
+    if (!filter)
+        return true;
+    for (const [field, condition] of Object.entries(filter)) {
+        if (!matchesFilter(value[field], condition))
+            return false;
+    }
+    return true;
+}
+/**
+ * FlairStore — drop-in replacement for LangGraph's `InMemoryStore` that
+ * persists into Flair. Extends LangGraph's `BaseStore` interface
+ * structurally without importing the abstract class directly (peer-dep
+ * pattern keeps the package install-light if a host already has langgraph).
+ *
+ * Usage:
+ *   import { FlairStore } from "@tpsdev-ai/langgraph-flair";
+ *   const store = new FlairStore({ agentId: "my-agent" });
+ *   const graph = new StateGraph(...).compile({ store });
+ *
+ * Or pass it to the agent directly:
+ *   const agent = createReactAgent({ llm, tools, store });
+ */
+export class FlairStore {
+    client;
+    agentId;
+    constructor(config) {
+        if (!config.agentId) {
+            throw new Error("FlairStore requires `agentId` — pin the agent identity at construction time.");
+        }
+        this.agentId = config.agentId;
+        this.client = new FlairClient({
+            agentId: config.agentId,
+            url: config.url,
+            keyPath: config.keyPath,
+            privateKey: config.privateKey,
+            adminUser: config.adminUser,
+            adminPassword: config.adminPassword,
+            timeoutMs: config.timeoutMs,
+        });
+    }
+    /** The LangGraph-required entry point. All concrete operations funnel here. */
+    async batch(operations) {
+        return Promise.all(operations.map((op) => this.dispatch(op)));
+    }
+    // The same surface BaseStore exposes as concrete methods. Reproduced here
+    // so callers don't have to subclass to get them.
+    async get(namespace, key) {
+        return this.dispatch({ namespace, key });
+    }
+    async put(namespace, key, value, index) {
+        await this.dispatch({ namespace, key, value, index });
+    }
+    async delete(namespace, key) {
+        await this.dispatch({ namespace, key, value: null });
+    }
+    async search(namespacePrefix, options = {}) {
+        return this.dispatch({ namespacePrefix, ...options });
+    }
+    // ── private dispatch ─────────────────────────────────────────────────────
+    async dispatch(op) {
+        if (isGet(op))
+            return this.doGet(op);
+        if (isPut(op))
+            return this.doPut(op);
+        if (isSearch(op))
+            return this.doSearch(op);
+        if (isListNs(op))
+            return this.doListNamespaces(op);
+        throw new Error("FlairStore: unknown operation");
+    }
+    async doGet(op) {
+        const id = memoryId(this.agentId, op.namespace, op.key);
+        const mem = await this.client.memory.get(id);
+        if (!mem)
+            return null;
+        return memoryToItem(mem, op.namespace, op.key);
+    }
+    async doPut(op) {
+        const id = memoryId(this.agentId, op.namespace, op.key);
+        if (op.value === null) {
+            await this.client.memory.delete(id);
+            return;
+        }
+        const tags = nsTags(op.namespace);
+        const content = JSON.stringify(op.value);
+        // Subject lets Flair index the namespace head for fast prefix filtering.
+        const subject = op.namespace[0] ?? undefined;
+        await this.client.memory.write(content, {
+            id,
+            tags,
+            subject,
+            durability: "standard",
+        });
+    }
+    async doSearch(op) {
+        const limit = op.limit ?? 10;
+        const offset = op.offset ?? 0;
+        let candidates;
+        if (op.query) {
+            // Semantic search via Flair, then filter by namespace prefix client-side.
+            // Fetch a generous candidate pool so the post-filter still honors `limit`.
+            const fetched = await this.client.memory.search(op.query, {
+                limit: Math.max(limit + offset, 20) * 4,
+            });
+            candidates = fetched.map((r) => ({
+                id: r.id,
+                content: r.content,
+                score: r.score,
+                createdAt: r.createdAt,
+                tags: r.tags,
+            }));
+        }
+        else {
+            // Tag-based listing for the namespace prefix.
+            const fullTag = `${TAG_PREFIX_FULL}${op.namespacePrefix.join(NS_SEP)}`;
+            const fetched = await this.client.memory.list({
+                tags: op.namespacePrefix.length > 0 ? [fullTag] : [],
+                limit: Math.max(limit + offset, 20) * 4,
+                order: "createdAt-desc",
+            });
+            candidates = fetched.map((r) => ({
+                id: r.id,
+                content: r.content,
+                createdAt: r.createdAt,
+                tags: r.tags,
+            }));
+        }
+        const items = [];
+        for (const c of candidates) {
+            const parsed = parseStoredId(c.id, this.agentId);
+            if (!parsed)
+                continue;
+            // Namespace prefix gate (always applied — semantic-search candidates
+            // can come from any namespace).
+            if (!hasNamespacePrefix(parsed.namespace, op.namespacePrefix))
+                continue;
+            let value;
+            try {
+                value = JSON.parse(c.content);
+            }
+            catch {
+                // Tolerate non-LG content under the same agent — skip.
+                continue;
+            }
+            if (!matchesAllFilters(value, op.filter))
+                continue;
+            items.push({
+                namespace: parsed.namespace,
+                key: parsed.key,
+                value,
+                createdAt: c.createdAt ? new Date(c.createdAt) : new Date(0),
+                updatedAt: c.createdAt ? new Date(c.createdAt) : new Date(0),
+                score: c.score,
+            });
+        }
+        return items.slice(offset, offset + limit);
+    }
+    async doListNamespaces(op) {
+        // Best-effort: scan recent memories, derive distinct namespaces. Honors
+        // `limit` and `offset` against the derived list. maxDepth truncates each
+        // namespace to that many segments.
+        const fetched = await this.client.memory.list({
+            limit: 1000,
+            order: "createdAt-desc",
+        });
+        const seen = new Set();
+        const out = [];
+        for (const r of fetched) {
+            const parsed = parseStoredId(r.id, this.agentId);
+            if (!parsed)
+                continue;
+            let ns = parsed.namespace;
+            if (op.maxDepth !== undefined && ns.length > op.maxDepth)
+                ns = ns.slice(0, op.maxDepth);
+            const key = ns.join(NS_SEP);
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push(ns);
+            if (out.length >= op.offset + op.limit)
+                break;
+        }
+        return out.slice(op.offset, op.offset + op.limit);
+    }
+}
+// ── helpers exported for testability ────────────────────────────────────────
+export function parseStoredId(id, agentId) {
+    // id format: "lg:<agentId>:<ns-joined-by-/>:<key>"
+    const expectedPrefix = `lg:${agentId}:`;
+    if (!id.startsWith(expectedPrefix))
+        return null;
+    const rest = id.slice(expectedPrefix.length);
+    // The last `:` separates ns from key. Namespace can contain `/` but not `:`.
+    const lastColon = rest.lastIndexOf(":");
+    if (lastColon < 0)
+        return null;
+    const nsJoined = rest.slice(0, lastColon);
+    const key = rest.slice(lastColon + 1);
+    const namespace = nsJoined.length === 0 ? [] : nsJoined.split(NS_SEP);
+    return { namespace, key };
+}
+export function hasNamespacePrefix(namespace, prefix) {
+    if (prefix.length > namespace.length)
+        return false;
+    for (let i = 0; i < prefix.length; i++) {
+        if (namespace[i] !== prefix[i])
+            return false;
+    }
+    return true;
+}
+function memoryToItem(mem, namespace, key) {
+    let value = {};
+    try {
+        value = typeof mem.content === "string" ? JSON.parse(mem.content) : mem.content;
+    }
+    catch {
+        value = { __raw: mem.content };
+    }
+    return {
+        namespace,
+        key,
+        value,
+        createdAt: mem.createdAt ? new Date(mem.createdAt) : new Date(0),
+        updatedAt: mem.updatedAt ? new Date(mem.updatedAt) : (mem.createdAt ? new Date(mem.createdAt) : new Date(0)),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@tpsdev-ai/langgraph-flair",
+  "version": "0.9.0",
+  "description": "LangGraph BaseStore adapter backed by Flair — durable agent memory with crypto-pinned identity, federation, and cross-orchestrator portability.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc --noCheck",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "langgraph",
+    "langchain",
+    "flair",
+    "memory",
+    "agent",
+    "store"
+  ],
+  "homepage": "https://github.com/tpsdev-ai/flair/tree/main/packages/langgraph-flair",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tpsdev-ai/flair.git",
+    "directory": "packages/langgraph-flair"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@tpsdev-ai/flair-client": "0.9.0"
+  },
+  "peerDependencies": {
+    "@langchain/langgraph-checkpoint": ">=0.0.10"
+  }
+}