minimem 0.0.3 → 0.0.4

package/dist/internal.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Debug function type for optional logging
+ */
+type DebugFn = (message: string, data?: Record<string, unknown>) => void;
+/**
+ * Log an error with context (for debugging).
+ * Only logs if a debug function is provided.
+ *
+ * @param context - A short identifier for where the error occurred
+ * @param error - The error object or message
+ * @param debug - Optional debug function to log to
+ */
+declare function logError(context: string, error: unknown, debug?: DebugFn): void;
+type MemoryFileEntry = {
+    path: string;
+    absPath: string;
+    mtimeMs: number;
+    size: number;
+    hash: string;
+};
+type MemoryChunk = {
+    startLine: number;
+    endLine: number;
+    text: string;
+    hash: string;
+};
+/**
+ * Ensure a directory exists, creating it if necessary.
+ *
+ * @param dir - The directory path to ensure exists
+ * @param debug - Optional debug function for logging errors
+ * @returns The directory path
+ */
+declare function ensureDir(dir: string, debug?: DebugFn): string;
+declare function normalizeRelPath(value: string): string;
+declare function isMemoryPath(relPath: string): boolean;
+declare function listMemoryFiles(memoryDir: string): Promise<string[]>;
+declare function hashText(value: string): string;
+declare function buildFileEntry(absPath: string, memoryDir: string): Promise<MemoryFileEntry>;
+/**
+ * Strip content between <private>...</private> tags.
+ * Replaces private blocks with the same number of empty lines to preserve line numbering.
+ */
+declare function stripPrivateContent(content: string): string;
+declare function chunkMarkdown(content: string, chunking: {
+    tokens: number;
+    overlap: number;
+}): MemoryChunk[];
+/**
+ * Extract metadata from a chunk's text content.
+ * Looks for HTML comments like <!-- type: decision --> in the chunk.
+ */
+declare function extractChunkMetadata(text: string): {
+    type?: string;
+};
+declare function parseEmbedding(raw: string): number[];
+declare function cosineSimilarity(a: number[], b: number[]): number;
+declare function truncateUtf16Safe(text: string, maxChars: number): string;
+/**
+ * Convert a numeric embedding vector to a Buffer suitable for sqlite-vec storage.
+ * Uses Float32 encoding, which is the format expected by sqlite-vec's vector functions.
+ */
+declare function vectorToBlob(embedding: number[]): Buffer;
+
+export { type DebugFn, type MemoryChunk, type MemoryFileEntry, buildFileEntry, chunkMarkdown, cosineSimilarity, ensureDir, extractChunkMetadata, hashText, isMemoryPath, listMemoryFiles, logError, normalizeRelPath, parseEmbedding, stripPrivateContent, truncateUtf16Safe, vectorToBlob };

package/dist/internal.js

@@ -0,0 +1,33 @@
+import {
+  buildFileEntry,
+  chunkMarkdown,
+  cosineSimilarity,
+  ensureDir,
+  extractChunkMetadata,
+  hashText,
+  isMemoryPath,
+  listMemoryFiles,
+  logError,
+  normalizeRelPath,
+  parseEmbedding,
+  stripPrivateContent,
+  truncateUtf16Safe,
+  vectorToBlob
+} from "./chunk-ARZQHOJI.js";
+export {
+  buildFileEntry,
+  chunkMarkdown,
+  cosineSimilarity,
+  ensureDir,
+  extractChunkMetadata,
+  hashText,
+  isMemoryPath,
+  listMemoryFiles,
+  logError,
+  normalizeRelPath,
+  parseEmbedding,
+  stripPrivateContent,
+  truncateUtf16Safe,
+  vectorToBlob
+};
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/session.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Session tracking for memory entries
+ *
+ * Captures context about the originating session (Claude Code, VS Code, etc.)
+ * and stores it as YAML frontmatter in memory files.
+ */
+/**
+ * Session metadata for memory entries
+ */
+type SessionContext = {
+    /** Session identifier (e.g., Claude Code session ID) */
+    id?: string;
+    /** Source application (claude-code, vscode, cursor, etc.) */
+    source?: string;
+    /** Project directory path */
+    project?: string;
+    /** Path to session transcript/log file */
+    transcript?: string;
+};
+/**
+ * Source provenance for a knowledge entry
+ */
+type KnowledgeSource = {
+    origin?: string;
+    trajectories?: string[];
+    agentId?: string;
+};
+/**
+ * A directional link from this entry to another knowledge node
+ */
+type KnowledgeLink = {
+    target: string;
+    relation: string;
+    layer?: string;
+};
+/**
+ * Frontmatter structure for memory files
+ */
+type MemoryFrontmatter = {
+    session?: SessionContext;
+    created?: string;
+    updated?: string;
+    tags?: string[];
+    /** Knowledge node identifier */
+    id?: string;
+    /** Knowledge entry type */
+    type?: "observation" | "entity" | "domain-summary" | string;
+    /** Domain tags for this knowledge entry */
+    domain?: string[];
+    /** Entity references in this knowledge entry */
+    entities?: string[];
+    /** Confidence score 0-1 */
+    confidence?: number;
+    /** Source provenance */
+    source?: KnowledgeSource;
+    /** Links to other knowledge nodes */
+    links?: KnowledgeLink[];
+    /** ID of the entry this supersedes */
+    supersedes?: string | null;
+};
+/**
+ * Parse YAML frontmatter from content
+ *
+ * Frontmatter is delimited by --- at the start and end:
+ * ```
+ * ---
+ * session:
+ *   id: abc123
+ *   source: claude-code
+ * created: 2024-01-27T14:30:00Z
+ * ---
+ * Actual content here...
+ * ```
+ */
+declare function parseFrontmatter(content: string): {
+    frontmatter: MemoryFrontmatter | undefined;
+    body: string;
+};
+/**
+ * Serialize frontmatter to YAML string
+ */
+declare function serializeFrontmatter(frontmatter: MemoryFrontmatter): string;
+/**
+ * Add or update frontmatter in content
+ */
+declare function addFrontmatter(content: string, frontmatter: MemoryFrontmatter): string;
+/**
+ * Add session context as frontmatter to content
+ */
+declare function addSessionToContent(content: string, session: SessionContext): string;
+/**
+ * Extract session context from file content
+ */
+declare function extractSession(content: string): SessionContext | undefined;
+
+export { type KnowledgeLink, type KnowledgeSource, type MemoryFrontmatter, type SessionContext, addFrontmatter, addSessionToContent, extractSession, parseFrontmatter, serializeFrontmatter };

package/dist/session.js

@@ -0,0 +1,15 @@
+import {
+  addFrontmatter,
+  addSessionToContent,
+  extractSession,
+  parseFrontmatter,
+  serializeFrontmatter
+} from "./chunk-GVWPZRF7.js";
+export {
+  addFrontmatter,
+  addSessionToContent,
+  extractSession,
+  parseFrontmatter,
+  serializeFrontmatter
+};
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimem",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "A lightweight file-based memory system with vector search for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -10,6 +10,14 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./session": {
+      "types": "./dist/session.d.ts",
+      "import": "./dist/session.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js"
     }
   },
   "files": [
@@ -17,7 +25,7 @@
   ],
   "scripts": {
     "build": "tsup && npm run postbuild",
-    "postbuild": "sed -i '' 's/from \"sqlite\"/from \"node:sqlite\"/g' dist/cli/index.js",
+    "postbuild": "node scripts/postbuild.js",
     "dev": "tsup --watch",
     "test": "vitest run",
     "test:integration": "npx tsx --test src/__tests__/minimem.integration.test.ts",