@whenmoon-afk/memory-mcp 2.0.0

package/dist/tools/response-formatter.js

@@ -0,0 +1,180 @@
+/**
+ * Response Formatter - Format memories with tiered detail levels
+ *
+ * Critical: NEVER include embedding or vector fields in responses
+ * Token targets: minimal=30, standard=200, full=500
+ */
+import { estimateTokens } from '../utils/token-estimator.js';
+/**
+ * Format a single memory according to detail level
+ *
+ * @param memory - The memory to format
+ * @param detailLevel - Level of detail to include
+ * @param options - Optional entities, provenance, and tags
+ * @returns Formatted memory (NO embeddings)
+ */
+export function formatMemory(memory, detailLevel, options = {}) {
+    switch (detailLevel) {
+        case 'minimal':
+            return formatMinimal(memory);
+        case 'standard':
+            return formatStandard(memory, options);
+        case 'full':
+            return formatFull(memory, options);
+        default:
+            return formatStandard(memory, options);
+    }
+}
+/**
+ * Format minimal memory (~30 tokens)
+ * Only essential fields: id, type, summary, importance
+ */
+function formatMinimal(memory) {
+    return {
+        id: memory.id,
+        type: memory.type,
+        summary: memory.summary,
+        importance: memory.importance,
+    };
+}
+/**
+ * Format standard memory (~200 tokens)
+ * Includes: minimal fields + content + optional entities + timestamps
+ */
+function formatStandard(memory, options) {
+    const formatted = {
+        id: memory.id,
+        type: memory.type,
+        summary: memory.summary,
+        content: memory.content,
+        importance: memory.importance,
+        created_at: new Date(memory.created_at).toISOString(),
+        last_accessed: new Date(memory.last_accessed).toISOString(),
+    };
+    // Only include entities if present
+    if (options.entities && options.entities.length > 0) {
+        formatted.entities = options.entities.map((e) => e.name);
+    }
+    return formatted;
+}
+/**
+ * Format full memory (~500 tokens)
+ * Includes: all standard fields + entities + tags + access_count + expires_at + provenance
+ */
+function formatFull(memory, options) {
+    const formatted = {
+        id: memory.id,
+        type: memory.type,
+        summary: memory.summary,
+        content: memory.content,
+        entities: options.entities ? options.entities.map((e) => e.name) : [],
+        tags: options.tags || extractTagsFromMetadata(memory.metadata),
+        importance: memory.importance,
+        access_count: memory.access_count,
+        created_at: new Date(memory.created_at).toISOString(),
+        last_accessed: new Date(memory.last_accessed).toISOString(),
+        expires_at: memory.expires_at ? new Date(memory.expires_at).toISOString() : null,
+        provenance: extractProvenanceInfo(options.provenance),
+    };
+    return formatted;
+}
+/**
+ * Extract tags from metadata
+ */
+function extractTagsFromMetadata(metadata) {
+    if (metadata.tags && Array.isArray(metadata.tags)) {
+        return metadata.tags.filter((tag) => typeof tag === 'string');
+    }
+    return [];
+}
+/**
+ * Extract provenance information (only most recent)
+ */
+function extractProvenanceInfo(provenance) {
+    if (!provenance || provenance.length === 0) {
+        return null;
+    }
+    // Get most recent provenance record
+    const mostRecent = provenance.reduce((latest, current) => current.timestamp > latest.timestamp ? current : latest);
+    return {
+        source: mostRecent.source,
+        timestamp: new Date(mostRecent.timestamp).toISOString(),
+    };
+}
+/**
+ * Format a list of memories
+ *
+ * @param memories - Array of memories to format
+ * @param detailLevel - Level of detail to include
+ * @param optionsMap - Map of memory IDs to format options
+ * @returns Array of formatted memories
+ */
+export function formatMemoryList(memories, detailLevel, optionsMap) {
+    return memories.map((memory) => {
+        const options = optionsMap?.get(memory.id) || {};
+        return formatMemory(memory, detailLevel, options);
+    });
+}
+/**
+ * Get estimated token count for a formatted memory
+ *
+ * @param memory - Formatted memory to estimate
+ * @returns Estimated token count
+ */
+export function getMemoryTokenCount(memory) {
+    return estimateTokens(memory);
+}
+/**
+ * Validate that a memory list fits within token budget
+ *
+ * @param memories - Array of formatted memories
+ * @param maxTokens - Maximum allowed tokens
+ * @returns Validation result
+ */
+export function validateMemoryBudget(memories, maxTokens) {
+    const estimated = estimateTokens(memories);
+    return {
+        fits: estimated <= maxTokens,
+        estimated,
+        count: memories.length,
+    };
+}
+/**
+ * Truncate memory list to fit within token budget
+ *
+ * @param memories - Array of formatted memories
+ * @param maxTokens - Maximum token budget
+ * @returns Truncated array that fits within budget
+ */
+export function truncateToTokenBudget(memories, maxTokens) {
+    const result = [];
+    let currentTokens = 0;
+    for (const memory of memories) {
+        const memoryTokens = getMemoryTokenCount(memory);
+        if (currentTokens + memoryTokens <= maxTokens) {
+            result.push(memory);
+            currentTokens += memoryTokens;
+        }
+        else {
+            break;
+        }
+    }
+    return result;
+}
+/**
+ * Debug: Get token statistics for a memory
+ *
+ * @param memory - Formatted memory to analyze
+ * @returns Token statistics
+ */
+export function getMemoryTokenStats(memory) {
+    const byField = {};
+    let total = 0;
+    for (const [key, value] of Object.entries(memory)) {
+        const fieldTokens = estimateTokens(JSON.stringify(value));
+        byField[key] = fieldTokens;
+        total += fieldTokens;
+    }
+    return { total, byField };
+}
+//# sourceMappingURL=response-formatter.js.map

package/dist/tools/response-formatter.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,244 @@
+/**
+ * Core type definitions for Memory MCP v2.0
+ */
+export type MemoryType = 'fact' | 'entity' | 'relationship' | 'self';
+export interface Memory {
+    id: string;
+    content: string;
+    summary: string;
+    type: MemoryType;
+    importance: number;
+    created_at: number;
+    last_accessed: number;
+    access_count: number;
+    expires_at: number | null;
+    metadata: Record<string, unknown>;
+    is_deleted: boolean;
+}
+export interface MemoryInput {
+    id?: string;
+    content: string;
+    type: MemoryType;
+    importance?: number;
+    entities?: string[];
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    ttl_days?: number | null;
+    expires_at?: string;
+    provenance?: ProvenanceInput;
+}
+export interface MemoryUpdate {
+    id: string;
+    content?: string;
+    importance?: number;
+    metadata?: Record<string, unknown>;
+    ttl_days?: number | null;
+    updateReason?: string;
+}
+export interface MemorySearchResult extends Memory {
+    score: number;
+    entities: Entity[];
+    provenance: Provenance[];
+}
+export type EntityType = 'person' | 'organization' | 'project' | 'technology' | 'location' | 'concept' | 'document' | 'other';
+export interface Entity {
+    id: string;
+    name: string;
+    type: EntityType;
+    metadata: Record<string, unknown>;
+    created_at: number;
+}
+export interface EntityInput {
+    name: string;
+    type?: EntityType;
+    metadata?: Record<string, unknown>;
+}
+export type ProvenanceOperation = 'create' | 'update' | 'delete' | 'access' | 'restore';
+export interface Provenance {
+    id: string;
+    memory_id: string;
+    operation: ProvenanceOperation;
+    timestamp: number;
+    source: string;
+    context: string | null;
+    user_id: string | null;
+    changes: Record<string, unknown> | null;
+}
+export interface ProvenanceInput {
+    source: string;
+    timestamp?: string;
+    context?: string;
+    user_id?: string;
+}
+export interface SearchOptions {
+    query: string;
+    max_tokens?: number;
+    type?: MemoryType;
+    entities?: string[];
+    limit?: number;
+}
+export interface SearchOptionsInternal extends SearchOptions {
+    offset?: number;
+    minImportance?: number;
+    includeExpired?: boolean;
+}
+export interface SearchFilters {
+    type?: MemoryType;
+    entities?: string[];
+    minImportance?: number;
+    includeExpired: boolean;
+}
+export interface ImportanceFactors {
+    contentComplexity: number;
+    entityCount: number;
+    isUserPreference: boolean;
+    hasProvenance: boolean;
+    hasMetadata: boolean;
+    isExplicit: boolean;
+    typeBonus: number;
+}
+export interface TTLConfig {
+    defaultDays: number;
+    importanceMultiplier: number;
+    accessBonusDays: number;
+    refreshThresholdDays: number;
+}
+export type DetailLevel = 'minimal' | 'standard' | 'full';
+/**
+ * Minimal format: ~30 tokens - summaries only
+ */
+export interface MinimalMemory {
+    id: string;
+    type: string;
+    summary: string;
+    importance: number;
+}
+/**
+ * Standard format: ~200 tokens - content + optional entities
+ */
+export interface StandardMemory {
+    id: string;
+    type: string;
+    summary: string;
+    content: string;
+    entities?: string[];
+    importance: number;
+    created_at: string;
+    last_accessed: string;
+}
+/**
+ * Full format: ~500 tokens - everything + provenance
+ */
+export interface FullMemory {
+    id: string;
+    type: string;
+    summary: string;
+    content: string;
+    entities: string[];
+    tags: string[];
+    importance: number;
+    access_count: number;
+    created_at: string;
+    last_accessed: string;
+    expires_at: string | null;
+    provenance: {
+        source: string;
+        timestamp: string;
+    } | null;
+}
+/**
+ * Union type for all formatted memory formats
+ */
+export type FormattedMemory = MinimalMemory | StandardMemory | FullMemory;
+export interface StoreResponse {
+    success: boolean;
+    memory_id: string;
+    importance: number;
+    entities_extracted: string[];
+    expires_at: number | null;
+    message: string;
+}
+export interface RecallResponse {
+    index: MinimalMemory[];
+    details: FormattedMemory[];
+    total_count: number;
+    has_more: boolean;
+    tokens_used: number;
+    query: string;
+}
+export interface UpdateResponse {
+    success: boolean;
+    memory_id: string;
+    changes: Record<string, unknown>;
+    message: string;
+}
+export interface ForgetResponse {
+    success: boolean;
+    memory_id: string;
+    message: string;
+}
+export interface PruneResponse {
+    success: boolean;
+    pruned_count: number;
+    dry_run: boolean;
+    details: {
+        expired_count: number;
+        deleted_count: number;
+        old_threshold_days: number;
+    };
+}
+export declare class MemoryError extends Error {
+    code: string;
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
+}
+export declare class DatabaseError extends MemoryError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class ValidationError extends MemoryError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export interface CacheEntry<T> {
+    data: T;
+    expiresAt: number;
+}
+export type Awaitable<T> = T | Promise<T>;
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+export interface MemoryRow {
+    id: string;
+    content: string;
+    summary: string;
+    type: string;
+    importance: number;
+    created_at: number;
+    last_accessed: number;
+    access_count: number;
+    expires_at: number | null;
+    metadata: string;
+    is_deleted: number;
+}
+export interface EntityRow {
+    id: string;
+    name: string;
+    type: string;
+    metadata: string;
+    created_at: number;
+}
+export interface MemoryEntityRow {
+    memory_id: string;
+    entity_id: string;
+    created_at: number;
+}
+export interface ProvenanceRow {
+    id: string;
+    memory_id: string;
+    operation: string;
+    timestamp: number;
+    source: string;
+    context: string | null;
+    user_id: string | null;
+    changes: string | null;
+}
+//# 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,29 @@
+/**
+ * Core type definitions for Memory MCP v2.0
+ */
+// ============================================================================
+// Error Types
+// ============================================================================
+export class MemoryError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'MemoryError';
+    }
+}
+export class DatabaseError extends MemoryError {
+    constructor(message, details) {
+        super(message, 'DATABASE_ERROR', details);
+        this.name = 'DatabaseError';
+    }
+}
+export class ValidationError extends MemoryError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', details);
+        this.name = 'ValidationError';
+    }
+}
+//# 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;AAgQH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,OAAO,WAAY,SAAQ,KAAK;IAG3B;IACA;IAHT,YACE,OAAe,EACR,IAAY,EACZ,OAAiC;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAA0B;QAGxC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/utils/token-estimator.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Token Estimation Utilities
+ *
+ * Simple heuristic-based token counting for response formatting
+ * Uses the rule of thumb: ~4 characters per token
+ */
+/**
+ * Estimate token count for text or JSON object
+ *
+ * @param input - Text string or object to estimate
+ * @returns Estimated token count
+ */
+export declare function estimateTokens(input: string | object): number;
+/**
+ * Validate that memories fit within a token budget
+ *
+ * @param memories - Array of formatted memories
+ * @param maxTokens - Maximum token budget
+ * @returns Validation result with estimated token count
+ */
+export declare function validateTokenBudget(memories: unknown[], maxTokens: number): {
+    fits: boolean;
+    estimated: number;
+};
+/**
+ * Filter memories to fit within a token budget
+ *
+ * @param memories - Array of memories (any format)
+ * @param maxTokens - Maximum token budget
+ * @returns Filtered array that fits within budget
+ */
+export declare function fitWithinBudget<T extends object>(memories: T[], maxTokens: number): T[];
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/utils/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../../src/utils/token-estimator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAI7D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAMtC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE,CAevF"}

package/dist/utils/token-estimator.js

@@ -0,0 +1,54 @@
+/**
+ * Token Estimation Utilities
+ *
+ * Simple heuristic-based token counting for response formatting
+ * Uses the rule of thumb: ~4 characters per token
+ */
+/**
+ * Estimate token count for text or JSON object
+ *
+ * @param input - Text string or object to estimate
+ * @returns Estimated token count
+ */
+export function estimateTokens(input) {
+    const text = typeof input === 'string' ? input : JSON.stringify(input);
+    // Rule of thumb: ~4 characters per token
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Validate that memories fit within a token budget
+ *
+ * @param memories - Array of formatted memories
+ * @param maxTokens - Maximum token budget
+ * @returns Validation result with estimated token count
+ */
+export function validateTokenBudget(memories, maxTokens) {
+    const estimated = estimateTokens(memories);
+    return {
+        fits: estimated <= maxTokens,
+        estimated,
+    };
+}
+/**
+ * Filter memories to fit within a token budget
+ *
+ * @param memories - Array of memories (any format)
+ * @param maxTokens - Maximum token budget
+ * @returns Filtered array that fits within budget
+ */
+export function fitWithinBudget(memories, maxTokens) {
+    const result = [];
+    let currentTokens = 0;
+    for (const memory of memories) {
+        const memoryTokens = estimateTokens(memory);
+        if (currentTokens + memoryTokens <= maxTokens) {
+            result.push(memory);
+            currentTokens += memoryTokens;
+        }
+        else {
+            break;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=token-estimator.js.map

package/dist/utils/token-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.js","sourceRoot":"","sources":["../../src/utils/token-estimator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAsB;IACnD,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvE,yCAAyC;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAmB,EACnB,SAAiB;IAEjB,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,SAAS,IAAI,SAAS;QAC5B,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAmB,QAAa,EAAE,SAAiB;IAChF,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,aAAa,GAAG,YAAY,IAAI,SAAS,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpB,aAAa,IAAI,YAAY,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@whenmoon-afk/memory-mcp",
+  "version": "2.0.0",
+  "description": "Brain-inspired memory for AI agents - MCP server",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "memory-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "release": "npm run test && npm run build",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "memory",
+    "context",
+    "ai",
+    "semantic-search",
+    "fts5",
+    "sqlite"
+  ],
+  "author": "Memory MCP Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/whenmoon-afk/claude-memory-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/whenmoon-afk/claude-memory-mcp/issues"
+  },
+  "homepage": "https://github.com/whenmoon-afk/claude-memory-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "better-sqlite3": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "@vitest/coverage-v8": "^1.3.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.2.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}