agentic-memory 0.1.0

package/dist/types-CQ8Hcoqw.d.mts

@@ -0,0 +1,131 @@
+type MemoryType = 'preference' | 'fact' | 'task' | 'episodic' | 'constraint';
+type ImportanceLevel = 'hard' | 'soft' | 'ephemeral';
+type DecayPolicy = 'none' | 'linear' | 'exponential' | 'step';
+interface MemoryEntry {
+    /** Unique identifier */
+    id: string;
+    /** The content of the memory */
+    content: string;
+    /** Semantic type - determines decay and conflict behavior */
+    type: MemoryType;
+    /** Namespace for isolation (e.g., 'user:123', 'agent:planner') */
+    scope: string;
+    /** How important this memory is - 'hard' never decays */
+    importance: ImportanceLevel;
+    /** Numeric confidence score 0-1 */
+    confidence: number;
+    /** Embedding vector (populated by retriever) */
+    embedding?: number[];
+    /** Arbitrary metadata */
+    metadata: Record<string, unknown>;
+    /** ISO timestamp of creation */
+    createdAt: string;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Version counter for optimistic concurrency */
+    version: number;
+}
+type RetrievalSignal = 'similarity' | 'recency' | 'importance' | 'taskRelevance';
+interface RetrievalQuery {
+    /** The search query text */
+    query: string;
+    /** Current task context for task-relevance scoring */
+    taskContext?: string;
+    /** Scope to search within */
+    scope?: string;
+    /** Memory types to include */
+    types?: MemoryType[];
+    /** Signals to combine for ranking */
+    signals?: RetrievalSignal[];
+    /** Max results to return */
+    limit?: number;
+    /** Minimum combined score threshold (0-1) */
+    threshold?: number;
+}
+interface RetrievalResult {
+    entry: MemoryEntry;
+    /** Combined score from all signals */
+    score: number;
+    /** Breakdown of individual signal scores */
+    signalScores: Partial<Record<RetrievalSignal, number>>;
+}
+interface ConflictResult {
+    /** The new content that conflicts */
+    incoming: string;
+    /** The stored entry it conflicts with */
+    stored: MemoryEntry;
+    /** Confidence that this is a real conflict (0-1) */
+    confidence: number;
+    /** Suggested action */
+    action: 'clarify' | 'override' | 'keep_both' | 'ignore';
+    /** Reason for the suggestion */
+    reason: string;
+}
+interface Checkpoint {
+    id: string;
+    /** Structured task state */
+    taskGraph: TaskNode[];
+    /** Compressed summary of conversation so far */
+    summary: string;
+    /** Key tool outputs to preserve */
+    toolOutputs: Record<string, unknown>;
+    /** Memories that were in active use */
+    activeMemoryIds: string[];
+    /** ISO timestamp */
+    createdAt: string;
+}
+interface TaskNode {
+    id: string;
+    description: string;
+    status: 'pending' | 'in_progress' | 'done' | 'failed' | 'skipped';
+    result?: unknown;
+    dependencies: string[];
+}
+interface StorageBackend {
+    get(id: string): Promise<MemoryEntry | null>;
+    getAll(scope?: string): Promise<MemoryEntry[]>;
+    set(entry: MemoryEntry): Promise<void>;
+    delete(id: string): Promise<boolean>;
+    clear(scope?: string): Promise<void>;
+    search(query: RetrievalQuery): Promise<MemoryEntry[]>;
+}
+interface Embedder {
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    dimensions(): number;
+}
+interface DecayConfig {
+    /** Policy per memory type */
+    policies: Partial<Record<MemoryType, {
+        policy: DecayPolicy;
+        /** Half-life in milliseconds (for exponential) */
+        halfLife?: number;
+        /** Linear decay rate per day (0-1) */
+        ratePerDay?: number;
+        /** Step function: drop to 0 after this many ms */
+        maxAge?: number;
+    }>>;
+    /** Default policy for unlisted types */
+    defaultPolicy: DecayPolicy;
+    /** Default half-life in ms */
+    defaultHalfLife: number;
+}
+interface AgentMemoryConfig {
+    /** Storage backend - 'local' uses in-memory Map */
+    store?: 'local' | StorageBackend;
+    /** Embedder for similarity search */
+    embedder?: 'builtin' | Embedder;
+    /** Decay configuration */
+    decay?: Partial<DecayConfig>;
+    /** Auto-checkpoint config */
+    checkpoint?: {
+        /** Context usage ratio to trigger checkpoint (0-1) */
+        threshold?: number;
+        /** Max checkpoints to retain */
+        maxCheckpoints?: number;
+    };
+    /** Default scope for entries without explicit scope */
+    defaultScope?: string;
+}
+
+export type { AgentMemoryConfig as A, ConflictResult as C, DecayConfig as D, Embedder as E, ImportanceLevel as I, MemoryType as M, RetrievalQuery as R, StorageBackend as S, TaskNode as T, MemoryEntry as a, RetrievalResult as b, Checkpoint as c, RetrievalSignal as d, DecayPolicy as e };

package/dist/types-CQ8Hcoqw.d.ts

@@ -0,0 +1,131 @@
+type MemoryType = 'preference' | 'fact' | 'task' | 'episodic' | 'constraint';
+type ImportanceLevel = 'hard' | 'soft' | 'ephemeral';
+type DecayPolicy = 'none' | 'linear' | 'exponential' | 'step';
+interface MemoryEntry {
+    /** Unique identifier */
+    id: string;
+    /** The content of the memory */
+    content: string;
+    /** Semantic type - determines decay and conflict behavior */
+    type: MemoryType;
+    /** Namespace for isolation (e.g., 'user:123', 'agent:planner') */
+    scope: string;
+    /** How important this memory is - 'hard' never decays */
+    importance: ImportanceLevel;
+    /** Numeric confidence score 0-1 */
+    confidence: number;
+    /** Embedding vector (populated by retriever) */
+    embedding?: number[];
+    /** Arbitrary metadata */
+    metadata: Record<string, unknown>;
+    /** ISO timestamp of creation */
+    createdAt: string;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Version counter for optimistic concurrency */
+    version: number;
+}
+type RetrievalSignal = 'similarity' | 'recency' | 'importance' | 'taskRelevance';
+interface RetrievalQuery {
+    /** The search query text */
+    query: string;
+    /** Current task context for task-relevance scoring */
+    taskContext?: string;
+    /** Scope to search within */
+    scope?: string;
+    /** Memory types to include */
+    types?: MemoryType[];
+    /** Signals to combine for ranking */
+    signals?: RetrievalSignal[];
+    /** Max results to return */
+    limit?: number;
+    /** Minimum combined score threshold (0-1) */
+    threshold?: number;
+}
+interface RetrievalResult {
+    entry: MemoryEntry;
+    /** Combined score from all signals */
+    score: number;
+    /** Breakdown of individual signal scores */
+    signalScores: Partial<Record<RetrievalSignal, number>>;
+}
+interface ConflictResult {
+    /** The new content that conflicts */
+    incoming: string;
+    /** The stored entry it conflicts with */
+    stored: MemoryEntry;
+    /** Confidence that this is a real conflict (0-1) */
+    confidence: number;
+    /** Suggested action */
+    action: 'clarify' | 'override' | 'keep_both' | 'ignore';
+    /** Reason for the suggestion */
+    reason: string;
+}
+interface Checkpoint {
+    id: string;
+    /** Structured task state */
+    taskGraph: TaskNode[];
+    /** Compressed summary of conversation so far */
+    summary: string;
+    /** Key tool outputs to preserve */
+    toolOutputs: Record<string, unknown>;
+    /** Memories that were in active use */
+    activeMemoryIds: string[];
+    /** ISO timestamp */
+    createdAt: string;
+}
+interface TaskNode {
+    id: string;
+    description: string;
+    status: 'pending' | 'in_progress' | 'done' | 'failed' | 'skipped';
+    result?: unknown;
+    dependencies: string[];
+}
+interface StorageBackend {
+    get(id: string): Promise<MemoryEntry | null>;
+    getAll(scope?: string): Promise<MemoryEntry[]>;
+    set(entry: MemoryEntry): Promise<void>;
+    delete(id: string): Promise<boolean>;
+    clear(scope?: string): Promise<void>;
+    search(query: RetrievalQuery): Promise<MemoryEntry[]>;
+}
+interface Embedder {
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    dimensions(): number;
+}
+interface DecayConfig {
+    /** Policy per memory type */
+    policies: Partial<Record<MemoryType, {
+        policy: DecayPolicy;
+        /** Half-life in milliseconds (for exponential) */
+        halfLife?: number;
+        /** Linear decay rate per day (0-1) */
+        ratePerDay?: number;
+        /** Step function: drop to 0 after this many ms */
+        maxAge?: number;
+    }>>;
+    /** Default policy for unlisted types */
+    defaultPolicy: DecayPolicy;
+    /** Default half-life in ms */
+    defaultHalfLife: number;
+}
+interface AgentMemoryConfig {
+    /** Storage backend - 'local' uses in-memory Map */
+    store?: 'local' | StorageBackend;
+    /** Embedder for similarity search */
+    embedder?: 'builtin' | Embedder;
+    /** Decay configuration */
+    decay?: Partial<DecayConfig>;
+    /** Auto-checkpoint config */
+    checkpoint?: {
+        /** Context usage ratio to trigger checkpoint (0-1) */
+        threshold?: number;
+        /** Max checkpoints to retain */
+        maxCheckpoints?: number;
+    };
+    /** Default scope for entries without explicit scope */
+    defaultScope?: string;
+}
+
+export type { AgentMemoryConfig as A, ConflictResult as C, DecayConfig as D, Embedder as E, ImportanceLevel as I, MemoryType as M, RetrievalQuery as R, StorageBackend as S, TaskNode as T, MemoryEntry as a, RetrievalResult as b, Checkpoint as c, RetrievalSignal as d, DecayPolicy as e };

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "agentic-memory",
+  "version": "0.1.0",
+  "description": "Framework-agnostic memory layer for AI agents. Multi-signal retrieval, conflict detection, typed decay, checkpointing. Zero dependencies.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./adapters/openai": {
+      "types": "./dist/adapters/openai.d.ts",
+      "import": "./dist/adapters/openai.mjs",
+      "require": "./dist/adapters/openai.js"
+    },
+    "./adapters/voyageai": {
+      "types": "./dist/adapters/voyageai.d.ts",
+      "import": "./dist/adapters/voyageai.mjs",
+      "require": "./dist/adapters/voyageai.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/adapters/openai.ts src/adapters/voyageai.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts src/adapters/openai.ts src/adapters/voyageai.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "memory",
+    "agentic",
+    "llm",
+    "context-management",
+    "multi-agent",
+    "state-management",
+    "conflict-detection",
+    "checkpoint",
+    "retrieval",
+    "rag",
+    "anthropic",
+    "openai",
+    "langchain",
+    "vercel-ai"
+  ],
+  "author": "genieincodebottle",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/genieincodebottle/agentic-memory"
+  },
+  "homepage": "https://github.com/genieincodebottle/agentic-memory#readme",
+  "bugs": {
+    "url": "https://github.com/genieincodebottle/agentic-memory/issues"
+  },
+  "devDependencies": {
+    "@rollup/rollup-win32-x64-msvc": "^4.60.1",
+    "@types/node": "^25.5.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}