@easynet/agent-memory 0.0.2

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8HxB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/types/config.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * Configuration type definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigSchema = void 0;
+const zod_1 = require("zod");
+// Schema for YAML configuration
+exports.ConfigSchema = zod_1.z.object({
+    version: zod_1.z.number().default(1),
+    app: zod_1.z.object({
+        name: zod_1.z.string(),
+        env: zod_1.z.string().optional(),
+    }).optional(),
+    store: zod_1.z.object({
+        provider: zod_1.z.enum(["mem0"]),
+        mem0: zod_1.z.object({
+            api_key: zod_1.z.string().optional(),
+            base_url: zod_1.z.string().optional().default("https://api.mem0.ai"),
+            mode: zod_1.z.enum(["platform", "in_memory"]).optional().default("platform"),
+            namespace: zod_1.z.object({
+                project_from: zod_1.z.string().optional(),
+                run_from: zod_1.z.string().optional(),
+                user_from: zod_1.z.string().optional(),
+            }).optional(),
+        }),
+    }).refine((store) => {
+        if (store.mem0.mode === "platform" && !store.mem0.api_key) {
+            return false;
+        }
+        return true;
+    }, {
+        message: "api_key is required when mem0.mode is 'platform'",
+    }),
+    docs: zod_1.z.object({
+        enabled: zod_1.z.boolean().default(true),
+        retriever: zod_1.z.enum(["rag_http"]).optional(),
+        rag_http: zod_1.z.object({
+            base_url: zod_1.z.string(),
+            endpoints: zod_1.z.object({
+                search: zod_1.z.string().default("/search"),
+            }),
+            timeout_ms: zod_1.z.number().default(8000),
+            top_k: zod_1.z.number().default(6),
+        }).optional(),
+    }).optional().refine((docs) => {
+        if (!docs || !docs.enabled)
+            return true;
+        return docs.retriever !== undefined && docs.rag_http !== undefined;
+    }, {
+        message: "When docs.enabled is true, retriever and rag_http are required",
+    }),
+    memory: zod_1.z.object({
+        gate: zod_1.z.object({
+            enabled: zod_1.z.boolean().default(true),
+            redact: zod_1.z.object({
+                enabled: zod_1.z.boolean().default(true),
+                patterns: zod_1.z.array(zod_1.z.string()).default([]),
+            }).optional(),
+            rules: zod_1.z.array(zod_1.z.object({
+                type: zod_1.z.enum(["profile", "policy", "episodic", "decision"]),
+                min_confidence: zod_1.z.number().min(0).max(1),
+                when: zod_1.z.array(zod_1.z.string()).optional(),
+            })).optional(),
+            dedupe: zod_1.z.object({
+                enabled: zod_1.z.boolean().default(true),
+                similarity_threshold: zod_1.z.number().min(0).max(1).default(0.92),
+            }).optional(),
+        }).optional(),
+    }).optional(),
+    recall: zod_1.z.object({
+        strategy: zod_1.z.enum(["memory_only", "docs_only", "hybrid"]).default("hybrid"),
+        ranker: zod_1.z.object({
+            memory: zod_1.z.object({
+                sim_weight: zod_1.z.number().default(0.6),
+                utility_weight: zod_1.z.number().default(0.4),
+            }).optional(),
+            docs: zod_1.z.object({
+                score_weight: zod_1.z.number().default(1.0),
+            }).optional(),
+        }).optional(),
+        context: zod_1.z.object({
+            enabled: zod_1.z.boolean().default(true),
+            template: zod_1.z.string().default("default"),
+            max_tokens: zod_1.z.number().default(1400),
+        }).optional(),
+    }).optional(),
+    telemetry: zod_1.z.object({
+        logging: zod_1.z.object({
+            level: zod_1.z.enum(["debug", "info", "warn", "error"]).default("info"),
+        }).optional(),
+    }).optional(),
+    persistence: zod_1.z.object({
+        sqlite: zod_1.z.object({
+            path: zod_1.z.string(),
+            wal: zod_1.z.boolean().optional().default(true),
+        }),
+    }).optional(),
+    embedding: zod_1.z.object({
+        provider: zod_1.z.enum(["ollama", "openai"]),
+        model: zod_1.z.string(),
+        dim: zod_1.z.number(),
+        base_url: zod_1.z.string().optional(),
+        api_key: zod_1.z.string().optional(),
+        concurrency: zod_1.z.number().optional().default(4),
+    }).optional(),
+    boot: zod_1.z.object({
+        rebuild: zod_1.z.object({
+            enabled: zod_1.z.boolean().default(true),
+            batch_size: zod_1.z.number().optional().default(200),
+            on_model_mismatch: zod_1.z.enum(["fail", "reembed_all"]).optional().default("fail"),
+        }).optional(),
+    }).optional(),
+}).refine((config) => {
+    // If mem0 mode is in_memory, persistence and embedding are required
+    if (config.store.mem0.mode === "in_memory") {
+        if (!config.persistence) {
+            return false;
+        }
+        if (!config.embedding) {
+            return false;
+        }
+    }
+    return true;
+}, {
+    message: "persistence and embedding are required when mem0.mode is 'in_memory'",
+});
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

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

package/dist/types/document.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Document types for multi-modal document memory
+ */
+export type DocumentType = "text" | "pdf" | "image" | "markdown" | "html" | "code";
+export interface DocumentMetadata {
+    title?: string;
+    url?: string;
+    path?: string;
+    mimeType?: string;
+    size?: number;
+    pageCount?: number;
+    author?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface DocumentChunk {
+    id: string;
+    text: string;
+    type: DocumentType;
+    page?: number;
+    section?: string;
+    metadata?: DocumentMetadata;
+    extractedText?: string;
+    imageUrl?: string;
+    imageBase64?: string;
+}
+export interface DocumentMemoryOptions {
+    document: DocumentChunk | DocumentChunk[];
+    actor?: import("./index").Actor;
+    scope?: import("./index").Scope;
+    autoChunk?: boolean;
+    chunkSize?: number;
+    chunkOverlap?: number;
+    extractMetadata?: boolean;
+    tags?: string[];
+}
+//# sourceMappingURL=document.d.ts.map

package/dist/types/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/types/document.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAE5B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC;IAC1C,KAAK,CAAC,EAAE,OAAO,SAAS,EAAE,KAAK,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,SAAS,EAAE,KAAK,CAAC;IAEhC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/types/document.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Document types for multi-modal document memory
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=document.js.map

package/dist/types/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/types/document.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Core type definitions for agent-memory
+ */
+export type { DocumentType, DocumentMetadata, DocumentChunk, DocumentMemoryOptions } from "./document";
+export type ActorType = "user" | "agent" | "system";
+export interface Actor {
+    id: string;
+    type: ActorType;
+    name?: string;
+}
+export interface Scope {
+    projectId?: string;
+    channelId?: string;
+    threadId?: string;
+    runId?: string;
+}
+export type MemoryType = "profile" | "policy" | "episodic" | "decision";
+export interface MemoryItem {
+    id: string;
+    type: MemoryType;
+    content: string;
+    actor?: Actor;
+    scope?: Scope;
+    tags?: string[];
+    confidence?: number;
+    utility?: number;
+    source?: {
+        kind: "chat" | "doc" | "tool" | "manual";
+        ref?: string;
+    };
+    createdAt: string;
+    updatedAt?: string;
+    expiresAt?: string;
+    version?: number;
+}
+export interface DocChunk {
+    id: string;
+    text: string;
+    score?: number;
+    source: {
+        title?: string;
+        url?: string;
+        path?: string;
+        page?: number;
+        section?: string;
+    };
+    citations?: Array<{
+        label: string;
+        ref: string;
+    }>;
+}
+export interface RecallResult {
+    memory: MemoryItem[];
+    docs: DocChunk[];
+    context?: string;
+    traceId?: string;
+}
+export interface Message {
+    role: "user" | "assistant" | "system";
+    content: string;
+}
+export interface RememberOptions {
+    messages?: Message[];
+    text?: string;
+    actor?: Actor;
+    scope?: Scope;
+    hint?: {
+        types?: MemoryType[];
+    };
+}
+export interface RecallOptions {
+    query: string;
+    actor?: Actor;
+    scope?: Scope;
+    topK?: number;
+    includeMemory?: boolean;
+    includeDocs?: boolean;
+}
+export interface FeedbackOptions {
+    scope?: Scope;
+    outcome: "success" | "fail";
+    usedMemoryIds: string[];
+    usedDocIds: string[];
+    reward: number;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Core type definitions for agent-memory
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@easynet/agent-memory",
+  "version": "0.0.2",
+  "description": "Agent Memory SDK - Simple, YAML-driven memory layer for AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "prepublishOnly": "npm run build",
+    "chat": "ts-node src/cli/chat.ts",
+    "chat:dist": "node dist/cli/chat.js",
+    "chat:split": "ts-node src/cli/chat-split.ts",
+    "chat:split:dist": "node dist/cli/chat-split.js"
+  },
+  "bin": {
+    "agent-memory-chat": "./bin/chat"
+  },
+  "keywords": [
+    "agent",
+    "memory",
+    "rag",
+    "llm",
+    "ai"
+  ],
+  "author": "",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@types/blessed": "^0.1.27",
+    "better-sqlite3": "^9.2.2",
+    "blessed": "^0.1.81",
+    "js-yaml": "^4.1.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.8",
+    "@types/jest": "^29.5.11",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.10.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}