@easynet/agent-memory 0.0.2 → 1.0.0

package/dist/src/ingest/url-ingest.js

@@ -0,0 +1,301 @@
+"use strict";
+/**
+ * Ingest from a single URL: local path (PDF/txt/HTML/image) or remote URL.
+ * Format/media detection is for ingest pipeline only—not use-case routing; routing is config-driven.
+ * PDF requires pdf-parse; images may use captionFn for caption.
+ * Chunking is paragraph-based (semantic); we never store image binaries—only caption + URL.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ingestUrlToMemory = ingestUrlToMemory;
+const node_path_1 = require("node:path");
+function isRemote(url) {
+    return /^https?:\/\//i.test(url);
+}
+function isFileProtocol(url) {
+    return url.toLowerCase().startsWith("file://");
+}
+function getContentTypeFromPath(path) {
+    const ext = path.replace(/\?.*$/, "").split(".").pop()?.toLowerCase() ?? "";
+    const map = {
+        pdf: "application/pdf",
+        txt: "text/plain",
+        html: "text/html",
+        htm: "text/html",
+        xhtml: "text/html",
+        png: "image/png",
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        gif: "image/gif",
+        webp: "image/webp",
+    };
+    return map[ext] ?? "application/octet-stream";
+}
+async function getResource(url) {
+    if (isRemote(url)) {
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Error(`Failed to fetch ${url}: ${res.status} ${res.statusText}`);
+        const contentType = res.headers.get("content-type")?.split(";")[0].trim() ?? "";
+        const ab = await res.arrayBuffer();
+        return { buffer: Buffer.from(ab), contentType };
+    }
+    const { readFile } = await import("node:fs/promises");
+    const path = isFileProtocol(url) ? decodeURIComponent(url.slice(7)) : url;
+    const buffer = await readFile(path);
+    const contentType = getContentTypeFromPath(path);
+    return { buffer, contentType };
+}
+/**
+ * Semantic chunking: paragraph-based so chunks respect meaning.
+ * Splits on double newline; long paragraphs are split by chunkSize.
+ */
+function chunkText(text, chunkSize) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return [];
+    const chunks = [];
+    const paragraphs = trimmed.split(/\n\n+/);
+    let current = "";
+    for (const p of paragraphs) {
+        if (current.length + p.length + 2 <= chunkSize) {
+            current = current ? `${current}\n\n${p}` : p;
+        }
+        else {
+            if (current)
+                chunks.push(current);
+            if (p.length <= chunkSize) {
+                current = p;
+            }
+            else {
+                for (let i = 0; i < p.length; i += chunkSize) {
+                    chunks.push(p.slice(i, i + chunkSize));
+                }
+                current = "";
+            }
+        }
+    }
+    if (current)
+        chunks.push(current);
+    return chunks;
+}
+function resolveImageUrl(src, baseUrl) {
+    if (!src?.trim())
+        return null;
+    const s = src.trim();
+    if (/^https?:\/\//i.test(s))
+        return s;
+    try {
+        return new URL(s, baseUrl).href;
+    }
+    catch {
+        return null;
+    }
+}
+/** Extract main body content and image URLs from HTML. Uses cheerio when available; else stripHtml + no images. */
+async function extractMainContent(html, pageUrl) {
+    try {
+        const cheerio = await import("cheerio");
+        const $ = cheerio.load(html);
+        $("script, style, nav, footer, header, aside, iframe").remove();
+        const main = $("article").length > 0
+            ? $("article").first()
+            : $("main").length > 0
+                ? $("main").first()
+                : $("body");
+        const textSource = main.length > 0 ? main : $("body");
+        const text = textSource.text().replace(/\s+/g, " ").trim();
+        const imageUrls = [];
+        const imgContainer = main.length > 0 ? main : $("body");
+        if (imgContainer.length > 0) {
+            imgContainer.find("img").each((_, el) => {
+                const resolved = resolveImageUrl($(el).attr("src") ?? undefined, pageUrl);
+                if (resolved && !imageUrls.includes(resolved))
+                    imageUrls.push(resolved);
+            });
+        }
+        else {
+            $("img").each((_, el) => {
+                const resolved = resolveImageUrl($(el).attr("src") ?? undefined, pageUrl);
+                if (resolved && !imageUrls.includes(resolved))
+                    imageUrls.push(resolved);
+            });
+        }
+        return { text, imageUrls };
+    }
+    catch {
+        return { text: stripHtml(html), imageUrls: [] };
+    }
+}
+function stripHtml(html) {
+    const noScript = html.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, " ");
+    const noStyle = noScript.replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, " ");
+    const noTags = noStyle.replace(/<[^>]+>/g, " ");
+    const decoded = noTags
+        .replace(/&nbsp;/gi, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"');
+    return decoded.replace(/\s+/g, " ").trim();
+}
+function isPdf(contentType, url) {
+    if (contentType.includes("application/pdf"))
+        return true;
+    if (/\.pdf(\?|$)/i.test(url))
+        return true;
+    return false;
+}
+function isHtml(contentType, url) {
+    if (contentType.includes("text/html"))
+        return true;
+    if (/\.(html?|xhtml)(\?|$)/i.test(url))
+        return true;
+    return false;
+}
+function isImage(contentType, url) {
+    if (contentType.startsWith("image/"))
+        return true;
+    if (/\.(png|jpe?g|gif|webp)(\?|$)/i.test(url))
+        return true;
+    return false;
+}
+/** Detect image by magic bytes so uploads without extension (e.g. multer temp files) are still treated as images. */
+function isImageBuffer(buffer) {
+    if (buffer.length < 12)
+        return false;
+    // PNG: 89 50 4E 47 0D 0A 1A 0A
+    if (buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47)
+        return true;
+    // JPEG: FF D8 FF
+    if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff)
+        return true;
+    // GIF: GIF87a or GIF89a
+    if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46)
+        return true;
+    // WebP: RIFF....WEBP
+    if (buffer[0] === 0x52 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x46 && buffer.length >= 12 &&
+        buffer[8] === 0x57 && buffer[9] === 0x45 && buffer[10] === 0x42 && buffer[11] === 0x50)
+        return true;
+    return false;
+}
+async function extractTextFromPdf(buffer) {
+    try {
+        const pdfParse = (await import("pdf-parse")).default;
+        const data = await pdfParse(buffer);
+        return typeof data?.text === "string" ? data.text : "";
+    }
+    catch (e) {
+        const err = e;
+        if (err?.code === "ERR_MODULE_NOT_FOUND" || err?.message?.includes("pdf-parse")) {
+            throw new Error("PDF support requires pdf-parse: pnpm add pdf-parse");
+        }
+        throw e;
+    }
+}
+/**
+ * Ingest from local path or remote URL; detect PDF/txt/HTML/image by format, then write as knowledge.
+ */
+async function ingestUrlToMemory(memory, options) {
+    const { url, namespace, type = "knowledge", chunkSize = 800, metadata = {}, captionFn, } = options;
+    const { buffer, contentType } = await getResource(url);
+    const ct = contentType.toLowerCase();
+    const detectedAsImage = isImage(ct, url) || isImageBuffer(buffer);
+    let firstItem;
+    let totalCount = 0;
+    if (isPdf(ct, url)) {
+        const text = await extractTextFromPdf(buffer);
+        const chunks = chunkText(text, chunkSize);
+        for (const content of chunks) {
+            if (!content.trim())
+                continue;
+            const item = await memory.memorize({
+                namespace,
+                type,
+                content,
+                metadata: { ...metadata, source: "doc" },
+            });
+            if (!firstItem)
+                firstItem = item;
+            totalCount += 1;
+        }
+        return { count: totalCount, firstItem };
+    }
+    if (detectedAsImage) {
+        const text = captionFn ? await captionFn(buffer) : `(image: ${url})`;
+        const item = await memory.memorize({
+            namespace,
+            type,
+            content: text,
+            metadata: { ...metadata, source: "doc" },
+        });
+        if (!firstItem)
+            firstItem = item;
+        return { count: 1, firstItem };
+    }
+    if (isHtml(ct, url)) {
+        const html = buffer.toString("utf-8");
+        const pageBase = isRemote(url)
+            ? url
+            : url.toLowerCase().startsWith("file://")
+                ? url
+                : "file://" + (0, node_path_1.resolve)(url).replace(/\\/g, "/");
+        const { text: mainText, imageUrls } = await extractMainContent(html, pageBase);
+        for (const imageUrl of imageUrls) {
+            let content;
+            if (captionFn) {
+                try {
+                    const { buffer: imgBuffer } = await getResource(imageUrl);
+                    const caption = await captionFn(imgBuffer);
+                    content = `[image: ${imageUrl}]: ${caption}`;
+                }
+                catch {
+                    content = `[image: ${imageUrl}]`;
+                }
+            }
+            else {
+                content = `[image: ${imageUrl}]`;
+            }
+            const item = await memory.memorize({
+                namespace,
+                type,
+                content,
+                metadata: { ...metadata, source: "doc" },
+            });
+            if (!firstItem)
+                firstItem = item;
+            totalCount += 1;
+        }
+        const chunks = chunkText(mainText, chunkSize);
+        for (const content of chunks) {
+            if (!content.trim())
+                continue;
+            const item = await memory.memorize({
+                namespace,
+                type,
+                content,
+                metadata: { ...metadata, source: "doc" },
+            });
+            if (!firstItem)
+                firstItem = item;
+            totalCount += 1;
+        }
+        return { count: totalCount, firstItem };
+    }
+    const text = buffer.toString("utf-8");
+    const chunks = chunkText(text, chunkSize);
+    for (const content of chunks) {
+        if (!content.trim())
+            continue;
+        const item = await memory.memorize({
+            namespace,
+            type,
+            content,
+            metadata: { ...metadata, source: "doc" },
+        });
+        if (!firstItem)
+            firstItem = item;
+        totalCount += 1;
+    }
+    return { count: totalCount, firstItem };
+}
+//# sourceMappingURL=url-ingest.js.map

package/dist/src/ingest/url-ingest.js.map

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

package/dist/src/integrations/deepagents-adapter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * LangGraph BaseStore adapter backed by AgentMemory.
+ * Use with DeepAgents StoreBackend so that /memories/* is persisted via agent-memory.
+ * Compatible with DeepAgents 1.6.1 and @langchain/langgraph-checkpoint.
+ */
+import type { AgentMemory } from "../core/agent-memory.js";
+import type { CreateAgentMemoryResult } from "../create-agent-memory.js";
+import { BaseStore, type GetOperation, type Item, type ListNamespacesOperation, type PutOperation, type SearchItem, type SearchOperation } from "@langchain/langgraph-checkpoint";
+export interface AgentMemoryStoreAdapterOptions {
+    /** AgentMemory instance or createAgentMemory() result */
+    agentMemory: AgentMemory | CreateAgentMemoryResult;
+}
+/**
+ * BaseStore implementation that delegates to AgentMemory.
+ * Store keys are file paths (e.g. "/memories/user_preferences.txt"); value is { content, created_at?, modified_at? }.
+ */
+export declare class AgentMemoryStoreAdapter extends BaseStore {
+    private agentMemory;
+    constructor(options: AgentMemoryStoreAdapterOptions);
+    private putOne;
+    private getOne;
+    batch<Op extends (GetOperation | PutOperation | SearchOperation | ListNamespacesOperation)[]>(operations: Op): Promise<{
+        [K in keyof Op]: Op[K] extends PutOperation ? void : Op[K] extends SearchOperation ? SearchItem[] : Op[K] extends GetOperation ? Item | null : Op[K] extends ListNamespacesOperation ? string[][] : never;
+    }>;
+    get(namespace: string[], key: string): Promise<Item | null>;
+    search(namespacePrefix: string[], options?: {
+        filter?: Record<string, unknown>;
+        limit?: number;
+        offset?: number;
+        query?: string;
+    }): Promise<SearchItem[]>;
+    put(namespace: string[], key: string, value: Record<string, unknown>, _index?: false | string[]): Promise<void>;
+    delete(namespace: string[], key: string): Promise<void>;
+    listNamespaces(options?: {
+        prefix?: string[];
+        suffix?: string[];
+        maxDepth?: number;
+        limit?: number;
+        offset?: number;
+    }): Promise<string[][]>;
+}
+//# sourceMappingURL=deepagents-adapter.d.ts.map

package/dist/src/integrations/deepagents-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagents-adapter.d.ts","sourceRoot":"","sources":["../../../src/integrations/deepagents-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EACL,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,IAAI,EACT,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AAczC,MAAM,WAAW,8BAA8B;IAC7C,yDAAyD;IACzD,WAAW,EAAE,WAAW,GAAG,uBAAuB,CAAC;CACpD;AAED;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;IACpD,OAAO,CAAC,WAAW,CAAwC;gBAE/C,OAAO,EAAE,8BAA8B;YAKrC,MAAM;YAgBN,MAAM;IAuBd,KAAK,CAAC,EAAE,SAAS,CAAC,YAAY,GAAG,YAAY,GAAG,eAAe,GAAG,uBAAuB,CAAC,EAAE,EAChG,UAAU,EAAE,EAAE,GACb,OAAO,CAAC;SAAG,CAAC,IAAI,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,eAAe,GAAG,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,uBAAuB,GAAG,MAAM,EAAE,EAAE,GAAG,KAAK;KAAE,CAAC;IAwCnN,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAI3D,MAAM,CACV,eAAe,EAAE,MAAM,EAAE,EACzB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9F,OAAO,CAAC,UAAU,EAAE,CAAC;IAsBlB,GAAG,CACP,SAAS,EAAE,MAAM,EAAE,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,GACxB,OAAO,CAAC,IAAI,CAAC;IAIV,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,cAAc,CAAC,OAAO,CAAC,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAGxB"}

package/dist/src/integrations/deepagents-adapter.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * LangGraph BaseStore adapter backed by AgentMemory.
+ * Use with DeepAgents StoreBackend so that /memories/* is persisted via agent-memory.
+ * Compatible with DeepAgents 1.6.1 and @langchain/langgraph-checkpoint.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentMemoryStoreAdapter = void 0;
+const langgraph_checkpoint_1 = require("@langchain/langgraph-checkpoint");
+function toStoreNamespace(arr) {
+    return "memory:" + (arr.length > 0 ? arr.join(":") : "default");
+}
+function fromStoreNamespace(s) {
+    if (s.startsWith("memory:")) {
+        const rest = s.slice("memory:".length);
+        return rest ? rest.split(":") : [];
+    }
+    return [];
+}
+/**
+ * BaseStore implementation that delegates to AgentMemory.
+ * Store keys are file paths (e.g. "/memories/user_preferences.txt"); value is { content, created_at?, modified_at? }.
+ */
+class AgentMemoryStoreAdapter extends langgraph_checkpoint_1.BaseStore {
+    agentMemory;
+    constructor(options) {
+        super();
+        this.agentMemory = options.agentMemory;
+    }
+    async putOne(namespace, key, value) {
+        const ns = toStoreNamespace(namespace);
+        await this.agentMemory.deleteByKey(ns, key);
+        const content = typeof value.content === "string" ? value.content : JSON.stringify(value);
+        await this.agentMemory.memorize({
+            namespace: ns,
+            type: "cross_thread",
+            content,
+            metadata: {
+                path: key,
+                created_at: value.created_at ?? new Date().toISOString(),
+                updated_at: value.modified_at ?? value.updated_at ?? new Date().toISOString(),
+            },
+        });
+    }
+    async getOne(namespace, key) {
+        const ns = toStoreNamespace(namespace);
+        const item = await this.agentMemory.getByKey(ns, key);
+        if (!item)
+            return null;
+        const created = item.metadata?.created_at
+            ? new Date(item.metadata.created_at)
+            : new Date();
+        const updated = item.metadata?.updated_at
+            ? new Date(item.metadata.updated_at)
+            : created;
+        return {
+            key: item.metadata?.path ?? key,
+            namespace: fromStoreNamespace(item.namespace),
+            value: {
+                content: item.content,
+                created_at: created.toISOString(),
+                modified_at: updated.toISOString(),
+            },
+            createdAt: created,
+            updatedAt: updated,
+        };
+    }
+    async batch(operations) {
+        const results = [];
+        for (const op of operations) {
+            if ("key" in op && "namespace" in op && "value" in op) {
+                const putOp = op;
+                if (putOp.value != null) {
+                    await this.putOne(putOp.namespace, putOp.key, putOp.value);
+                }
+                else {
+                    await this.delete(putOp.namespace, putOp.key);
+                }
+                results.push(undefined);
+            }
+            else if ("namespace" in op && "key" in op && !("value" in op)) {
+                const getOp = op;
+                const item = await this.getOne(getOp.namespace, getOp.key);
+                results.push(item);
+            }
+            else if ("namespacePrefix" in op) {
+                const searchOp = op;
+                const items = await this.search(searchOp.namespacePrefix, {
+                    filter: searchOp.filter,
+                    limit: searchOp.limit ?? 10,
+                    offset: searchOp.offset ?? 0,
+                    query: searchOp.query,
+                });
+                results.push(items);
+            }
+            else if ("limit" in op && "offset" in op) {
+                const listOp = op;
+                const namespaces = await this.listNamespaces({
+                    limit: listOp.limit,
+                    offset: listOp.offset,
+                    maxDepth: listOp.maxDepth,
+                    prefix: listOp.matchConditions?.find((m) => m.matchType === "prefix")?.path,
+                });
+                results.push(namespaces);
+            }
+            else {
+                results.push(undefined);
+            }
+        }
+        return results;
+    }
+    async get(namespace, key) {
+        return this.getOne(namespace, key);
+    }
+    async search(namespacePrefix, options) {
+        const ns = toStoreNamespace(namespacePrefix);
+        const req = {
+            namespace: ns,
+            query: options?.query ?? "",
+            topK: options?.limit ?? 10,
+            filters: options?.filter,
+        };
+        const { items } = await this.agentMemory.recall(req);
+        const created = (m) => m.metadata?.created_at ? new Date(m.metadata.created_at) : new Date();
+        const updated = (m) => m.metadata?.updated_at ? new Date(m.metadata.updated_at) : created(m);
+        return items.map((item) => ({
+            key: item.metadata?.path ?? item.id,
+            namespace: fromStoreNamespace(item.namespace),
+            value: { content: item.content, created_at: created(item).toISOString(), modified_at: updated(item).toISOString() },
+            createdAt: created(item),
+            updatedAt: updated(item),
+        }));
+    }
+    async put(namespace, key, value, _index) {
+        await this.putOne(namespace, key, value);
+    }
+    async delete(namespace, key) {
+        const ns = toStoreNamespace(namespace);
+        await this.agentMemory.deleteByKey(ns, key);
+    }
+    async listNamespaces(options) {
+        return [["filesystem"]];
+    }
+}
+exports.AgentMemoryStoreAdapter = AgentMemoryStoreAdapter;
+//# sourceMappingURL=deepagents-adapter.js.map

package/dist/src/integrations/deepagents-adapter.js.map

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

package/dist/src/integrations/langchain.d.ts

@@ -0,0 +1,27 @@
+/**
+ * LangChain helpers: inject retrieved memory before LLM, write memory after turn/tool.
+ * Generic: no use-case logic; namespace/query/type from caller.
+ */
+import type { AgentMemory } from "../core/agent-memory.js";
+import type { CreateAgentMemoryResult } from "../create-agent-memory.js";
+import type { MemoryWriteRequest } from "../core/types.js";
+/** Any memory instance that has recall and memorize (AgentMemory or createAgentMemory() result). */
+export type LangChainMemoryLike = AgentMemory | CreateAgentMemoryResult;
+export interface RetrieveForLangChainOptions {
+    namespace: string;
+    query: string;
+    topK?: number;
+    budgetTokens?: number;
+}
+/**
+ * Call before invoking the LLM: retrieve memory and return text to inject into system or context.
+ */
+export declare function retrieveContextForLangChain(agentMemory: LangChainMemoryLike, options: RetrieveForLangChainOptions): Promise<{
+    injectedText: string;
+    traceId: string;
+}>;
+/**
+ * Call after a turn or tool result: write a memory entry (e.g. cross_thread).
+ */
+export declare function writeMemoryForLangChain(agentMemory: LangChainMemoryLike, req: MemoryWriteRequest): Promise<void>;
+//# sourceMappingURL=langchain.d.ts.map

package/dist/src/integrations/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE/E,oGAAoG;AACpG,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,uBAAuB,CAAC;AAExE,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,mBAAmB,EAChC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CASpD;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,mBAAmB,EAChC,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/src/integrations/langchain.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * LangChain helpers: inject retrieved memory before LLM, write memory after turn/tool.
+ * Generic: no use-case logic; namespace/query/type from caller.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retrieveContextForLangChain = retrieveContextForLangChain;
+exports.writeMemoryForLangChain = writeMemoryForLangChain;
+/**
+ * Call before invoking the LLM: retrieve memory and return text to inject into system or context.
+ */
+async function retrieveContextForLangChain(agentMemory, options) {
+    const req = {
+        namespace: options.namespace,
+        query: options.query,
+        topK: options.topK ?? 8,
+        budgetTokens: options.budgetTokens ?? 1200,
+    };
+    const result = await agentMemory.recall(req);
+    return { injectedText: result.injectedText, traceId: result.traceId };
+}
+/**
+ * Call after a turn or tool result: write a memory entry (e.g. cross_thread).
+ */
+async function writeMemoryForLangChain(agentMemory, req) {
+    await agentMemory.memorize(req);
+}
+//# sourceMappingURL=langchain.js.map

package/dist/src/integrations/langchain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.js","sourceRoot":"","sources":["../../../src/integrations/langchain.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAmBH,kEAYC;AAKD,0DAKC;AAzBD;;GAEG;AACI,KAAK,UAAU,2BAA2B,CAC/C,WAAgC,EAChC,OAAoC;IAEpC,MAAM,GAAG,GAAuB;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;QACvB,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;KAC3C,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;AACxE,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,uBAAuB,CAC3C,WAAgC,EAChC,GAAuB;IAEvB,MAAM,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/dist/src/integrations/langgraph.d.ts

@@ -0,0 +1,23 @@
+/**
+ * LangGraph helpers: inject memory into node state or use in graph nodes.
+ * Compatible with LangGraph and DeepAgents 1.6.1.
+ */
+import type { AgentMemory } from "../core/agent-memory.js";
+import type { MemoryWriteRequest } from "../core/types.js";
+export interface InjectMemoryIntoStateOptions {
+    namespace: string;
+    query: string;
+    stateKey?: string;
+    topK?: number;
+    budgetTokens?: number;
+}
+/**
+ * Retrieve memory and return an object suitable for merging into LangGraph state
+ * (e.g. { injectedMemory: string } or custom stateKey).
+ */
+export declare function injectMemoryIntoState(agentMemory: AgentMemory, options: InjectMemoryIntoStateOptions): Promise<Record<string, unknown>>;
+/**
+ * Write a memory entry from a graph node (e.g. after a tool).
+ */
+export declare function writeMemoryFromNode(agentMemory: AgentMemory, req: MemoryWriteRequest): Promise<void>;
+//# sourceMappingURL=langgraph.d.ts.map

package/dist/src/integrations/langgraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langgraph.d.ts","sourceRoot":"","sources":["../../../src/integrations/langgraph.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE/E,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUlC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/src/integrations/langgraph.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * LangGraph helpers: inject memory into node state or use in graph nodes.
+ * Compatible with LangGraph and DeepAgents 1.6.1.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectMemoryIntoState = injectMemoryIntoState;
+exports.writeMemoryFromNode = writeMemoryFromNode;
+/**
+ * Retrieve memory and return an object suitable for merging into LangGraph state
+ * (e.g. { injectedMemory: string } or custom stateKey).
+ */
+async function injectMemoryIntoState(agentMemory, options) {
+    const req = {
+        namespace: options.namespace,
+        query: options.query,
+        topK: options.topK ?? 8,
+        budgetTokens: options.budgetTokens ?? 1200,
+    };
+    const result = await agentMemory.recall(req);
+    const key = options.stateKey ?? "injectedMemory";
+    return { [key]: result.injectedText };
+}
+/**
+ * Write a memory entry from a graph node (e.g. after a tool).
+ */
+async function writeMemoryFromNode(agentMemory, req) {
+    await agentMemory.memorize(req);
+}
+//# sourceMappingURL=langgraph.js.map

package/dist/src/integrations/langgraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langgraph.js","sourceRoot":"","sources":["../../../src/integrations/langgraph.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAiBH,sDAaC;AAKD,kDAKC;AA3BD;;;GAGG;AACI,KAAK,UAAU,qBAAqB,CACzC,WAAwB,EACxB,OAAqC;IAErC,MAAM,GAAG,GAAuB;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;QACvB,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;KAC3C,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC;IACjD,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,mBAAmB,CACvC,WAAwB,EACxB,GAAuB;IAEvB,MAAM,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC"}