@easynet/agent-memory 1.0.0 → 1.0.2

package/README.md

@@ -1,125 +1,135 @@
-# agent-memory
+# @easynet/agent-memory
 
-**Source:** `git@github.com:easynet-world/agent-memory.git`
+面向 Agent 的轻量记忆包。  
+默认只需要 1 个入口函数：`createAgentMemory()`。
 
-**Agent 生态记忆组件**（**独立项目**：不依赖 agent-llm、agent-tool）。**Two APIs only:** `memorize` (store) and `recall` (retrieve).
+## 最小接口
 
-Local or remote PDF, txt, HTML, and images: pass a `url` to ingest; recall by `query`.
-
-**Three memory types:**
-
-| type | Description | Usage |
-|------|-------------|-------|
-| `thread` | Current session | This session only |
-| `cross_thread` | Cross-session | Cross-session preferences/settings |
-| `knowledge` | Docs/RAG | Documents or `memorize({ url })` |
+```ts
+import { createAgentMemory } from "@easynet/agent-memory";
 
-When unsure about type: pass a `classifyMemory` callback and let the program decide.
+const memory = await createAgentMemory();
 
----
+// 写入：memorize
+await memory.memorize({
+  namespace: "user:alice",
+  type: "cross_thread",
+  content: "用户偏好中文回答，尽量简洁。",
+});
 
-## Quick start
+// 检索：recall
+const { injectedText } = await memory.recall({
+  namespace: "user:alice",
+  query: "用户偏好",
+  topK: 5,
+});
 
-```bash
-pnpm install && pnpm run build
-# SQLite persistence: pnpm add better-sqlite3
+console.log(injectedText);
 ```
 
----
+可选能力：
+- `memorize({ url })`：直接摄入本地/远程 PDF、txt、HTML、图片（写入 `knowledge`）
+- `retrieveContextForLangChain` / `writeMemoryForLangChain`：LangChain 快捷接入
 
-## Examples
+## 最简单示例（带详细注释）
 
 ```ts
 import { createAgentMemory } from "@easynet/agent-memory";
 
-const memory = await createAgentMemory();
-
-await memory.memorize({ namespace: "user:123", type: "cross_thread", content: "Use Chinese." });
-await memory.memorize({ namespace: "project:docs", type: "knowledge", content: "API: Bearer token." });
-const { injectedText } = await memory.recall({ namespace: "user:123", query: "preferences", topK: 8 });
+async function main() {
+  // 1) 创建 memory 实例：
+  //    - 不传参数时，会尝试读取 ./config/agent-memory.yaml
+  //    - 如果文件不存在，自动退回内存版 in_memory provider
+  const memory = await createAgentMemory();
+
+  // 2) 写入长期偏好（cross_thread）：
+  //    namespace 是逻辑隔离维度，建议固定命名规范（如 user:{id}）
+  await memory.memorize({
+    namespace: "user:alice",
+    type: "cross_thread",
+    content: "用户希望所有输出优先中文。",
+    metadata: {
+      source: "chat",
+      tags: ["preference", "language"],
+    },
+  });
+
+  // 3) 写入知识（knowledge）：
+  await memory.memorize({
+    namespace: "project:demo",
+    type: "knowledge",
+    content: "Demo API 统一使用 Bearer Token 鉴权。",
+  });
+
+  // 4) 检索上下文：
+  //    recall 会返回可直接拼进 prompt 的 injectedText
+  const result = await memory.recall({
+    namespace: "project:demo",
+    query: "这个项目如何鉴权？",
+    topK: 3,
+    budgetTokens: 400,
+  });
+
+  console.log("traceId:", result.traceId);
+  console.log("context:\\n", result.injectedText);
+}
+
+main().catch(console.error);
 ```
 
-**URL ingest** (supported by `createAgentMemory()`; PDF requires `pdf-parse`):
+## 最简单 YAML（推荐先用这个）
 
-```ts
-import { createAgentMemory } from "@easynet/agent-memory";
-const memory = await createAgentMemory();
-await memory.memorize({ url: "./doc.pdf", namespace: "project:docs" });
-await memory.memorize({ url: "https://example.com/page.html", namespace: "project:docs" });
-```
-
-**LangChain Agent** (inject memory before calling LLM; write memory after each turn):
+`config/agent-memory.yaml`
 
-```ts
-import { createAgentMemory, retrieveContextForLangChain, writeMemoryForLangChain } from "@easynet/agent-memory";
-const memory = await createAgentMemory();
-const ns = "user:alice";
-// Before LLM: retrieve relevant memory, inject into system or first user message
-const { injectedText } = await retrieveContextForLangChain(memory, { namespace: ns, query: "preferences and settings", topK: 8 });
-// After each turn/tool: write long-term memory
-await writeMemoryForLangChain(memory, { namespace: ns, type: "cross_thread", content: "User prefers Chinese and concise replies." });
-```
+```yaml
+# 最小配置：单一 in_memory provider（进程内存，重启后数据丢失）
+providers:
+  - id: default
+    type: in_memory
 
-**DeepAgents** (agent-memory as long-term store under `/memories/`):
+router:
+  # 所有读写都走 default provider
+  defaultProvider: default
+  rules: []
 
-```ts
-import { createAgentMemory, AgentMemoryStoreAdapter } from "@easynet/agent-memory";
-import { createDeepAgent, CompositeBackend, StateBackend, StoreBackend } from "deepagents";
-const agentMemory = await createAgentMemory();
-const store = new AgentMemoryStoreAdapter({ agentMemory });
-const agent = createDeepAgent({
-  store,
-  backend: (c) => new CompositeBackend(new StateBackend(c), { "/memories/": new StoreBackend(c) }),
-  systemPrompt: "When users state preferences, save to /memories/user_preferences.txt",
-});
-```
+policy:
+  # 允许写入三类记忆
+  allowedWriteTypes: [thread, cross_thread, knowledge]
+  # 单类型最多保留多少条（超过后由策略裁剪）
+  maxItemsPerType: 20
 
----
+observability:
+  # 是否记录 recall trace（建议开发期开，生产按需）
+  trace: false
 
-## Config (YAML)
+privacy:
+  # 写入前移除敏感 metadata 字段
+  forbiddenMetadataKeys: [password, api_key, secret, token]
+```
 
-Config file `config/agent-memory.yaml`; omit for in-memory default.
+## SQLite YAML（本地持久化）
 
 ```yaml
 providers:
   - id: default
     type: sqlite
     options:
+      # SQLite 文件路径；相对路径以该 YAML 所在目录为基准
       dbPath: ./data/agent-memory.db
-  - id: rag
-    type: rag
-  - id: mem0
-    type: mem0
+
 router:
   defaultProvider: default
-  rules:
-    - types: [knowledge]
-      providerId: rag
-    - types: [cross_thread]
-      providerId: mem0
+  rules: []
+
 policy:
   allowedWriteTypes: [thread, cross_thread, knowledge]
-  maxItemsPerType: 20
+  maxItemsPerType: 50
+
 observability:
   trace: true
-privacy:
-  forbiddenMetadataKeys: [password, api_key, secret, token]
-  redactSecrets: false
-vlm:
-  captionUrl: http://localhost:8000/caption
-  captionPrompt: "Extract key information from the image..."
-  timeoutMs: 30000
 ```
 
-- **Namespace:** `user:{id}` / `project:{id}` / `org:{id}`
-- **SQLite:** `type: sqlite` + `options.dbPath`; requires `pnpm add better-sqlite3`; optional `options.embed` for vector search
-- **Mem0:** `type: mem0`; in code use `createAgentMemory({ overrides: { mem0 } })`
-- **VLM:** image→caption written as knowledge; `loadConfigFromYaml()` yields `config.vlm`
-
----
-
-**Trace / Privacy:** `recall()` returns `traceId`; configurable TraceRecorder and PrivacyGuard.
-
-**Layout:** 根目录主包（src/、test/、docs/、examples/）· `examples/pdf-text-rag` · `examples/deepagents-memory`
-
-**License:** MIT
+依赖说明：
+- `type: sqlite` 需要安装 `better-sqlite3`
+- URL 摄入 PDF 需要安装 `pdf-parse`
+- `type: mem0` 需要安装 `mem0ai`

package/dist/src/create-agent-memory.d.ts

@@ -6,32 +6,47 @@ import { type AgentMemoryConfig } from "./core/config.js";
 import type { MemoryItem, MemoryWriteRequest } from "./core/types.js";
 import type { AgentMemory, ClassifyMemoryFn } from "./core/agent-memory.js";
 import { type Mem0MemoryLike } from "./providers/mem0-provider.js";
-/** memorize input when using createAgentMemory: content (+ optional type) or url. */
-export type MemorizeRequestWithIngest = Omit<MemoryWriteRequest, "content" | "type"> & {
+/**
+ * Minimal write input for end users.
+ * - Use `content` for normal memory writes.
+ * - Use `url` for one-shot ingest (PDF/txt/HTML/image) into `knowledge`.
+ */
+export type MemoryWriteInput = Omit<MemoryWriteRequest, "content" | "type"> & {
     content?: string;
     type?: MemoryWriteRequest["type"];
     /** Local path or remote URL; format detected and ingested as knowledge. */
     url?: string;
 };
-export interface CreateAgentMemoryOptions {
-    /** YAML config path; default cwd/config/agent-memory.yaml or in-memory if missing */
+/**
+ * Minimal create options for end users.
+ */
+export interface CreateMemoryOptions {
+    /** YAML path. Default: `config/agent-memory.yaml` from current working directory. */
     configPath?: string;
-    /** Config object; overrides configPath */
+    /** Inline config object. When present, `configPath` is ignored. */
     config?: AgentMemoryConfig;
-    /** Provider overrides (e.g. mem0: pass initialized Memory instance) */
+    /** Runtime provider overrides (currently for mem0 instance injection). */
     overrides?: {
         mem0?: Mem0MemoryLike;
     };
-    /** When type omitted: used to infer type; otherwise default cross_thread */
+    /** Called when `type` is omitted. If not provided, defaults to `cross_thread`. */
     classifyMemory?: ClassifyMemoryFn;
-    /** For image URL ingest: generate caption; otherwise store "(image: <url>)" */
+    /** Optional image captioner for URL ingest. */
     captionFn?: (buffer: Buffer) => Promise<string>;
 }
-/** createAgentMemory return type: memorize supports content+type and url */
-export interface CreateAgentMemoryResult extends Omit<AgentMemory, "memorize" | "write"> {
-    memorize(req: MemorizeRequestWithIngest): Promise<MemoryItem>;
-    write(req: MemorizeRequestWithIngest): Promise<MemoryItem>;
+/**
+ * Minimal memory client returned by `createAgentMemory`.
+ */
+export interface AgentMemoryClient extends Omit<AgentMemory, "memorize" | "write"> {
+    /** Unified write API: accepts plain content writes and URL ingest. */
+    memorize(req: MemoryWriteInput): Promise<MemoryItem>;
+    /** Alias of `memorize` for compatibility with existing code. */
+    write(req: MemoryWriteInput): Promise<MemoryItem>;
 }
+/** Backward-compatible aliases for existing users. */
+export type MemorizeRequestWithIngest = MemoryWriteInput;
+export type CreateAgentMemoryOptions = CreateMemoryOptions;
+export type CreateAgentMemoryResult = AgentMemoryClient;
 /**
  * Create AgentMemory from YAML or default config.
  *
@@ -43,5 +58,5 @@ export interface CreateAgentMemoryResult extends Omit<AgentMemory, "memorize" |
  * const mem0 = new Memory({ ... });
  * const memory = await createAgentMemory({ configPath: "config/agent-memory.yaml", overrides: { mem0 } });
  */
-export declare function createAgentMemory(options?: CreateAgentMemoryOptions | string): Promise<CreateAgentMemoryResult>;
+export declare function createAgentMemory(options?: CreateMemoryOptions | string): Promise<AgentMemoryClient>;
 //# sourceMappingURL=create-agent-memory.d.ts.map

package/dist/src/create-agent-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-agent-memory.d.ts","sourceRoot":"","sources":["../../src/create-agent-memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAkB,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEtF,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAQ5E,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKjF,qFAAqF;AACrF,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,MAAM,CAAC,GAAG;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,uEAAuE;IACvE,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,cAAc,CAAC;KACvB,CAAC;IACF,4EAA4E;IAC5E,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACjD;AAED,4EAA4E;AAC5E,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC;IACtF,QAAQ,CAAC,GAAG,EAAE,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9D,KAAK,CAAC,GAAG,EAAE,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC5D;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAAwB,GAAG,MAAW,GAC9C,OAAO,CAAC,uBAAuB,CAAC,CA0HlC"}
+{"version":3,"file":"create-agent-memory.d.ts","sourceRoot":"","sources":["../../src/create-agent-memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAkB,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEtF,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAQ5E,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKjF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,MAAM,CAAC,GAAG;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,0EAA0E;IAC1E,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,cAAc,CAAC;KACvB,CAAC;IACF,kFAAkF;IAClF,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,+CAA+C;IAC/C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC;IAChF,sEAAsE;IACtE,QAAQ,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrD,gEAAgE;IAChE,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACnD;AAED,sDAAsD;AACtD,MAAM,MAAM,yBAAyB,GAAG,gBAAgB,CAAC;AACzD,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,CAAC;AAC3D,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAIxD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,mBAAmB,GAAG,MAAW,GACzC,OAAO,CAAC,iBAAiB,CAAC,CA0H5B"}

package/dist/src/create-agent-memory.js.map

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

package/dist/src/index.d.ts

@@ -1,22 +1,8 @@
 /**
- * agent-memory: unified memory layer for LangChain / LangGraph / DeepAgents.
- * Single package exporting core, providers, ingest, and integrations.
+ * agent-memory: LangChain-focused runtime helpers.
+ * Generic memory provider implementations should live in @easynet/agent-common.
  */
-export * from "./core/types.js";
-export * from "./core/policy.js";
-export * from "./core/observability.js";
-export * from "./core/privacy.js";
-export * from "./core/router.js";
-export * from "./core/agent-memory.js";
-export * from "./core/config.js";
-export { InMemoryStoreProvider } from "./providers/in-memory-store.js";
-export { SqliteStoreProvider, type SqliteStoreOptions } from "./providers/sqlite-store.js";
-export { RAGProvider, type RAGProviderOptions } from "./providers/rag-provider.js";
-export { Mem0Provider, type Mem0ProviderOptions, type Mem0MemoryLike, } from "./providers/mem0-provider.js";
-export { createAgentMemory, type CreateAgentMemoryOptions, type CreateAgentMemoryResult, type MemorizeRequestWithIngest, } from "./create-agent-memory.js";
-export { AgentMemoryStoreAdapter, type AgentMemoryStoreAdapterOptions } from "./integrations/deepagents-adapter.js";
+export { createAgentMemory, type CreateMemoryOptions, type AgentMemoryClient, type MemoryWriteInput, } from "./create-agent-memory.js";
+export type { MemoryType, MemoryWriteRequest, MemoryQueryRequest, } from "./core/types.js";
 export { retrieveContextForLangChain, writeMemoryForLangChain, type RetrieveForLangChainOptions, type LangChainMemoryLike, } from "./integrations/langchain.js";
-export { injectMemoryIntoState, writeMemoryFromNode, type InjectMemoryIntoStateOptions, } from "./integrations/langgraph.js";
-export { ingestPdfToMemory, type IngestPdfOptions, } from "./ingest/pdf-ingest.js";
-export { ingestUrlToMemory, type IngestUrlOptions, } from "./ingest/url-ingest.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,uBAAuB,EAAE,KAAK,8BAA8B,EAAE,MAAM,sCAAsC,CAAC;AACpH,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,GACzB,MAAM,6BAA6B,CAAC"}

package/dist/src/index.js

@@ -1,51 +1,13 @@
 "use strict";
 /**
- * agent-memory: unified memory layer for LangChain / LangGraph / DeepAgents.
- * Single package exporting core, providers, ingest, and integrations.
+ * agent-memory: LangChain-focused runtime helpers.
+ * Generic memory provider implementations should live in @easynet/agent-common.
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ingestUrlToMemory = exports.ingestPdfToMemory = exports.writeMemoryFromNode = exports.injectMemoryIntoState = exports.writeMemoryForLangChain = exports.retrieveContextForLangChain = exports.AgentMemoryStoreAdapter = exports.createAgentMemory = exports.Mem0Provider = exports.RAGProvider = exports.SqliteStoreProvider = exports.InMemoryStoreProvider = void 0;
-__exportStar(require("./core/types.js"), exports);
-__exportStar(require("./core/policy.js"), exports);
-__exportStar(require("./core/observability.js"), exports);
-__exportStar(require("./core/privacy.js"), exports);
-__exportStar(require("./core/router.js"), exports);
-__exportStar(require("./core/agent-memory.js"), exports);
-__exportStar(require("./core/config.js"), exports);
-var in_memory_store_js_1 = require("./providers/in-memory-store.js");
-Object.defineProperty(exports, "InMemoryStoreProvider", { enumerable: true, get: function () { return in_memory_store_js_1.InMemoryStoreProvider; } });
-var sqlite_store_js_1 = require("./providers/sqlite-store.js");
-Object.defineProperty(exports, "SqliteStoreProvider", { enumerable: true, get: function () { return sqlite_store_js_1.SqliteStoreProvider; } });
-var rag_provider_js_1 = require("./providers/rag-provider.js");
-Object.defineProperty(exports, "RAGProvider", { enumerable: true, get: function () { return rag_provider_js_1.RAGProvider; } });
-var mem0_provider_js_1 = require("./providers/mem0-provider.js");
-Object.defineProperty(exports, "Mem0Provider", { enumerable: true, get: function () { return mem0_provider_js_1.Mem0Provider; } });
+exports.writeMemoryForLangChain = exports.retrieveContextForLangChain = exports.createAgentMemory = void 0;
 var create_agent_memory_js_1 = require("./create-agent-memory.js");
 Object.defineProperty(exports, "createAgentMemory", { enumerable: true, get: function () { return create_agent_memory_js_1.createAgentMemory; } });
-var deepagents_adapter_js_1 = require("./integrations/deepagents-adapter.js");
-Object.defineProperty(exports, "AgentMemoryStoreAdapter", { enumerable: true, get: function () { return deepagents_adapter_js_1.AgentMemoryStoreAdapter; } });
 var langchain_js_1 = require("./integrations/langchain.js");
 Object.defineProperty(exports, "retrieveContextForLangChain", { enumerable: true, get: function () { return langchain_js_1.retrieveContextForLangChain; } });
 Object.defineProperty(exports, "writeMemoryForLangChain", { enumerable: true, get: function () { return langchain_js_1.writeMemoryForLangChain; } });
-var langgraph_js_1 = require("./integrations/langgraph.js");
-Object.defineProperty(exports, "injectMemoryIntoState", { enumerable: true, get: function () { return langgraph_js_1.injectMemoryIntoState; } });
-Object.defineProperty(exports, "writeMemoryFromNode", { enumerable: true, get: function () { return langgraph_js_1.writeMemoryFromNode; } });
-var pdf_ingest_js_1 = require("./ingest/pdf-ingest.js");
-Object.defineProperty(exports, "ingestPdfToMemory", { enumerable: true, get: function () { return pdf_ingest_js_1.ingestPdfToMemory; } });
-var url_ingest_js_1 = require("./ingest/url-ingest.js");
-Object.defineProperty(exports, "ingestUrlToMemory", { enumerable: true, get: function () { return url_ingest_js_1.ingestUrlToMemory; } });
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,kDAAgC;AAChC,mDAAiC;AACjC,0DAAwC;AACxC,oDAAkC;AAClC,mDAAiC;AACjC,yDAAuC;AACvC,mDAAiC;AAEjC,qEAAuE;AAA9D,2HAAA,qBAAqB,OAAA;AAC9B,+DAA2F;AAAlF,sHAAA,mBAAmB,OAAA;AAC5B,+DAAmF;AAA1E,8GAAA,WAAW,OAAA;AACpB,iEAIsC;AAHpC,gHAAA,YAAY,OAAA;AAId,mEAKkC;AAJhC,2HAAA,iBAAiB,OAAA;AAMnB,8EAAoH;AAA3G,gIAAA,uBAAuB,OAAA;AAChC,4DAKqC;AAJnC,2HAAA,2BAA2B,OAAA;AAC3B,uHAAA,uBAAuB,OAAA;AAIzB,4DAIqC;AAHnC,qHAAA,qBAAqB,OAAA;AACrB,mHAAA,mBAAmB,OAAA;AAGrB,wDAGgC;AAF9B,kHAAA,iBAAiB,OAAA;AAGnB,wDAGgC;AAF9B,kHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,mEAKkC;AAJhC,2HAAA,iBAAiB,OAAA;AAUnB,4DAKqC;AAJnC,2HAAA,2BAA2B,OAAA;AAC3B,uHAAA,uBAAuB,OAAA"}

package/dist/src/ingest/common-ingest.d.ts

@@ -0,0 +1,14 @@
+import type { AgentMemory } from "../core/agent-memory.js";
+import type { MemoryItem } from "../core/types.js";
+export interface IngestResultLike {
+    chunks: Array<{
+        content: string;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+export declare function loadCommonModule(): Promise<Record<string, unknown>>;
+export declare function writeChunksToMemory(memory: AgentMemory, namespace: string, type: "knowledge", chunks: IngestResultLike["chunks"]): Promise<{
+    count: number;
+    firstItem?: MemoryItem;
+}>;
+//# sourceMappingURL=common-ingest.d.ts.map

package/dist/src/ingest/common-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-ingest.d.ts","sourceRoot":"","sources":["../../../src/ingest/common-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,KAAK,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;CACJ;AAID,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKzE;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GACjC,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,CAiBpD"}

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCommonModule = loadCommonModule;
+exports.writeChunksToMemory = writeChunksToMemory;
+let commonModulePromise;
+async function loadCommonModule() {
+    if (!commonModulePromise) {
+        commonModulePromise = import("@easynet/agent-common");
+    }
+    return commonModulePromise;
+}
+async function writeChunksToMemory(memory, namespace, type, chunks) {
+    let firstItem;
+    let count = 0;
+    for (const chunk of chunks) {
+        if (!chunk.content.trim())
+            continue;
+        const item = await memory.memorize({
+            namespace,
+            type,
+            content: chunk.content,
+            metadata: chunk.metadata,
+        });
+        if (!firstItem)
+            firstItem = item;
+        count += 1;
+    }
+    return { count, firstItem };
+}
+//# sourceMappingURL=common-ingest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common-ingest.js","sourceRoot":"","sources":["../../../src/ingest/common-ingest.ts"],"names":[],"mappings":";;AAYA,4CAKC;AAED,kDAsBC;AA/BD,IAAI,mBAAiE,CAAC;AAE/D,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,mBAAmB,GAAG,MAAM,CAAC,uBAAuB,CAAqC,CAAC;IAC5F,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACvC,MAAmB,EACnB,SAAiB,EACjB,IAAiB,EACjB,MAAkC;IAElC,IAAI,SAAiC,CAAC;IACtC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;YAAE,SAAS;QACpC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;YACjC,SAAS;YACT,IAAI;YACJ,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,SAAS;YAAE,SAAS,GAAG,IAAI,CAAC;QACjC,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC"}

package/dist/src/ingest/pdf-ingest.d.ts

@@ -1,25 +1,12 @@
-/**
- * Ingest PDF from file path or URL into agent-memory.
- * Optional: install pdf-parse to use (e.g. pnpm add pdf-parse).
- */
 import type { AgentMemory } from "../core/agent-memory.js";
 import type { MemoryItem } from "../core/types.js";
 export interface IngestPdfOptions {
-    /** PDF file path (e.g. ./doc.pdf) or URL (e.g. https://example.com/doc.pdf). */
     pdf: string;
-    /** Namespace for stored memories (e.g. project:docs). */
     namespace: string;
-    /** Memory type for text chunks. Default: knowledge. */
     type?: "knowledge";
-    /** Approximate chars per chunk. Default: 800. */
     chunkSize?: number;
-    /** Optional metadata for all chunks (e.g. doc_id, source). */
     metadata?: Record<string, unknown>;
 }
-/**
- * Load a PDF from path or URL, extract text, chunk it, and store each chunk
- * into agent-memory with the given namespace and type.
- */
 export declare function ingestPdfToMemory(memory: AgentMemory, options: IngestPdfOptions): Promise<{
     count: number;
     firstItem?: MemoryItem;

package/dist/src/ingest/pdf-ingest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pdf-ingest.d.ts","sourceRoot":"","sources":["../../../src/ingest/pdf-ingest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AA0DD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,CA0BpD"}
+{"version":3,"file":"pdf-ingest.d.ts","sourceRoot":"","sources":["../../../src/ingest/pdf-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAsBD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,CAIpD"}

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

@@ -1,89 +1,21 @@
 "use strict";
-/**
- * Ingest PDF from file path or URL into agent-memory.
- * Optional: install pdf-parse to use (e.g. pnpm add pdf-parse).
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ingestPdfToMemory = ingestPdfToMemory;
-function isUrl(s) {
-    return /^https?:\/\//i.test(s);
-}
-async function getPdfBuffer(pdf) {
-    if (isUrl(pdf)) {
-        const res = await fetch(pdf);
-        if (!res.ok)
-            throw new Error(`Failed to fetch PDF: ${res.status} ${res.statusText}`);
-        const ab = await res.arrayBuffer();
-        return Buffer.from(ab);
-    }
-    const { readFile } = await import("node:fs/promises");
-    return readFile(pdf);
-}
-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 = "";
-            }
-        }
+const common_ingest_js_1 = require("./common-ingest.js");
+async function ingestToChunks(options) {
+    const common = (await (0, common_ingest_js_1.loadCommonModule)());
+    if (typeof common.ingestPdfToChunks !== "function") {
+        throw new Error("ingestPdfToMemory requires @easynet/agent-common with ingest exports. Please upgrade @easynet/agent-common.");
     }
-    if (current)
-        chunks.push(current);
-    return chunks;
+    return common.ingestPdfToChunks({
+        pdf: options.pdf,
+        chunkSize: options.chunkSize,
+        metadata: options.metadata,
+    });
 }
-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 ingestion requires pdf-parse. Install it: pnpm add pdf-parse");
-        }
-        throw e;
-    }
-}
-/**
- * Load a PDF from path or URL, extract text, chunk it, and store each chunk
- * into agent-memory with the given namespace and type.
- */
 async function ingestPdfToMemory(memory, options) {
-    const { pdf, namespace, type = "knowledge", chunkSize = 800, metadata = {}, } = options;
-    const buffer = await getPdfBuffer(pdf);
-    const text = await extractTextFromPdf(buffer);
-    const chunks = chunkText(text, chunkSize);
-    let firstItem;
-    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;
-    }
-    return { count: chunks.length, firstItem };
+    const { namespace, type = "knowledge" } = options;
+    const { chunks } = await ingestToChunks(options);
+    return (0, common_ingest_js_1.writeChunksToMemory)(memory, namespace, type, chunks);
 }
 //# sourceMappingURL=pdf-ingest.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"pdf-ingest.js","sourceRoot":"","sources":["../../../src/ingest/pdf-ingest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pdf-ingest.js","sourceRoot":"","sources":["../../../src/ingest/pdf-ingest.ts"],"names":[],"mappings":";;AAgCA,8CAOC;AArCD,yDAAkG;AAUlG,KAAK,UAAU,cAAc,CAAC,OAAyB;IACrD,MAAM,MAAM,GAAG,CAAC,MAAM,IAAA,mCAAgB,GAAE,CAMvC,CAAC;IACF,IAAI,OAAO,MAAM,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,6GAA6G,CAC9G,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,iBAAiB,CAAC;QAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC,CAAC;AACL,CAAC;AAEM,KAAK,UAAU,iBAAiB,CACrC,MAAmB,EACnB,OAAyB;IAEzB,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO,IAAA,sCAAmB,EAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC"}