codebaxing 0.1.0

package/README.vi.md

@@ -0,0 +1,402 @@
+# Codebaxing
+
+MCP server cho **semantic code search**. Index codebase và tìm kiếm bằng ngôn ngữ tự nhiên.
+
+## Ý tưởng
+
+Tìm kiếm code truyền thống (grep, ripgrep) chỉ match exact text. Nhưng lập trình viên suy nghĩ theo khái niệm:
+
+- *"Logic xác thực người dùng ở đâu?"* - không phải `grep "authentication"`
+- *"Tìm code kết nối database"* - không phải `grep "database"`
+- *"Xử lý lỗi hoạt động như thế nào?"* - không phải `grep "error"`
+
+**Codebaxing** giải quyết vấn đề này bằng **semantic search**:
+
+```
+Query: "user authentication"
+         ↓
+Tìm được: login(), validateCredentials(), checkPassword(), authMiddleware()
+          (dù chúng không chứa từ "authentication")
+```
+
+## Cơ chế hoạt động
+
+### Kiến trúc tổng quan
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                         INDEXING                                │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│   Source Files (.py, .ts, .js, .go, .rs, ...)                  │
+│         │                                                       │
+│         ▼                                                       │
+│   ┌──────────────┐    ┌──────────────┐    ┌──────────────┐     │
+│   │ Tree-sitter  │───▶│   Symbols    │───▶│  Embedding   │     │
+│   │   Parser     │    │  Extraction  │    │    Model     │     │
+│   └──────────────┘    └──────────────┘    └──────────────┘     │
+│         │                    │                    │             │
+│    Parse AST            Functions,          Text → Vector       │
+│                        Classes, etc.       (384 chiều)          │
+│                                                  │              │
+│                                                  ▼              │
+│                                          ┌──────────────┐      │
+│                                          │   ChromaDB   │      │
+│                                          │  (vectors)   │      │
+│                                          └──────────────┘      │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────┐
+│                          SEARCH                                 │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│   "find auth code"                                              │
+│         │                                                       │
+│         ▼                                                       │
+│   ┌──────────────┐         ┌──────────────┐                    │
+│   │  Embedding   │────────▶│   ChromaDB   │                    │
+│   │    Model     │  query  │    Query     │                    │
+│   └──────────────┘  vector └──────────────┘                    │
+│                                   │                             │
+│                                   ▼                             │
+│                            Cosine Similarity                    │
+│                                   │                             │
+│                                   ▼                             │
+│                            Top-k Results                        │
+│                       (login.py, auth.ts, ...)                  │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### Quy trình chi tiết
+
+#### 1. Parsing (Tree-sitter)
+
+Tree-sitter parse source code thành Abstract Syntax Tree (AST), trích xuất các symbols có ý nghĩa:
+
+```python
+# Input: auth.py
+def login(username, password):
+    """Authenticate user credentials"""
+    if validate(username, password):
+        return create_session(username)
+    raise AuthError("Invalid credentials")
+```
+
+```
+# Output: Symbol
+{
+  name: "login",
+  type: "function",
+  signature: "def login(username, password)",
+  code: "def login(username, password):...",
+  filepath: "auth.py",
+  lineStart: 1,
+  lineEnd: 6
+}
+```
+
+#### 2. Embedding (all-MiniLM-L6-v2)
+
+Mỗi code chunk được chuyển thành vector 384 chiều bằng neural network:
+
+```
+"def login(username, password): authenticate user..."
+                    ↓
+    Embedding Model (chạy local, ONNX)
+                    ↓
+    [0.12, -0.34, 0.56, 0.08, ..., -0.22]  (384 số)
+```
+
+Model hiểu được quan hệ ngữ nghĩa:
+- `"authentication"` ≈ `"login"` ≈ `"credentials"` (vectors gần nhau)
+- `"database"` ≈ `"query"` ≈ `"SQL"` (vectors gần nhau)
+- `"authentication"` ≠ `"database"` (vectors xa nhau)
+
+#### 3. Lưu trữ (ChromaDB)
+
+Vectors được lưu trong ChromaDB, database tối ưu cho similarity search:
+
+```
+ChromaDB Collection:
+┌─────────────────────────────────────────────────────┐
+│ ID          │ Vector (384d)      │ Metadata         │
+├─────────────────────────────────────────────────────┤
+│ chunk_001   │ [0.12, -0.34, ...] │ {file: auth.py}  │
+│ chunk_002   │ [0.45, 0.23, ...]  │ {file: db.py}    │
+│ chunk_003   │ [-0.11, 0.67, ...] │ {file: api.ts}   │
+│ ...         │ ...                │ ...              │
+└─────────────────────────────────────────────────────┘
+```
+
+#### 4. Tìm kiếm (Cosine Similarity)
+
+Khi bạn search, query được embed và so sánh với tất cả vectors đã lưu:
+
+```
+Query: "user authentication"
+              ↓
+Query Vector: [0.15, -0.31, 0.52, ...]
+              ↓
+So sánh với tất cả vectors bằng cosine similarity:
+  - chunk_001 (login): similarity = 0.89  ← CAO
+  - chunk_002 (db):    similarity = 0.23  ← THẤP
+  - chunk_003 (auth):  similarity = 0.85  ← CAO
+              ↓
+Trả về top-k chunks tương tự nhất
+```
+
+### Tại sao Semantic Search hoạt động
+
+Embedding model được train trên hàng triệu cặp text, học được rằng:
+
+| Khái niệm A | ≈ Tương tự với | Khoảng cách |
+|-------------|----------------|-------------|
+| authentication | login, credentials, auth, signin | Gần |
+| database | query, SQL, connection, ORM | Gần |
+| error | exception, failure, catch, throw | Gần |
+| parse | tokenize, lexer, AST, syntax | Gần |
+
+Điều này cho phép tìm code theo **ý nghĩa**, không chỉ từ khóa.
+
+## Tính năng
+
+- **Semantic Code Search**: Tìm code bằng cách mô tả những gì bạn cần
+- **24+ Ngôn ngữ**: Python, TypeScript, JavaScript, Go, Rust, Java, C/C++, và nhiều hơn nữa
+- **Memory Layer**: Lưu trữ và truy xuất context dự án qua các session
+- **Incremental Indexing**: Chỉ re-index các file đã thay đổi
+- **100% Local**: Không gọi API, không cloud, hoạt động offline
+- **GPU Acceleration**: Hỗ trợ WebGPU/CUDA tùy chọn
+
+## Yêu cầu
+
+- Node.js >= 20.0.0
+- ~500MB dung lượng đĩa cho embedding model (tải xuống lần chạy đầu tiên)
+
+## Cài đặt
+
+### Cách 1: Qua npx (Khuyến nghị)
+
+Không cần cài đặt! Chỉ cần cấu hình Claude Desktop trực tiếp.
+
+### Cách 2: Qua npm (Cài global)
+
+```bash
+npm install -g codebaxing
+```
+
+### Cách 3: Clone từ source
+
+```bash
+git clone https://github.com/duysolo/codebaxing.git
+cd codebaxing
+npm install
+npm run build
+```
+
+### (Tùy chọn) Cài đặt persistent storage
+
+Mặc định, index được lưu trong memory và mất khi server restart.
+
+Để lưu trữ vĩnh viễn, chạy ChromaDB:
+
+```bash
+# Dùng Docker (khuyến nghị)
+docker run -d -p 8000:8000 chromadb/chroma
+
+# Set biến môi trường
+export CHROMADB_URL=http://localhost:8000
+```
+
+### Cấu hình Claude Desktop
+
+Thêm vào file config của Claude Desktop:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+#### Qua npx (không cần cài):
+
+```json
+{
+  "mcpServers": {
+    "codebaxing": {
+      "command": "npx",
+      "args": ["-y", "codebaxing"]
+    }
+  }
+}
+```
+
+#### Qua global install:
+
+```bash
+npm install -g codebaxing
+```
+
+```json
+{
+  "mcpServers": {
+    "codebaxing": {
+      "command": "codebaxing"
+    }
+  }
+}
+```
+
+#### Với persistent storage (ChromaDB):
+
+```json
+{
+  "mcpServers": {
+    "codebaxing": {
+      "command": "npx",
+      "args": ["-y", "codebaxing"],
+      "env": {
+        "CHROMADB_URL": "http://localhost:8000"
+      }
+    }
+  }
+}
+```
+
+#### Từ source (development):
+
+```json
+{
+  "mcpServers": {
+    "codebaxing": {
+      "command": "node",
+      "args": ["/path/to/codebaxing/dist/mcp/server.js"]
+    }
+  }
+}
+```
+
+### Khởi động lại Claude Desktop
+
+Các tool Codebaxing sẽ có sẵn trong Claude.
+
+## Sử dụng
+
+### MCP Tools
+
+| Tool | Mô tả |
+|------|-------|
+| `index` | Index codebase. Modes: `auto` (incremental), `full`, `load-only` |
+| `search` | Semantic search. Trả về ranked code chunks |
+| `stats` | Thống kê index (files, symbols, chunks) |
+| `languages` | Liệt kê các file extensions được hỗ trợ |
+| `remember` | Lưu memories (conversation, status, decision, preference, doc, note) |
+| `recall` | Semantic search trên memories |
+| `forget` | Xóa memories theo ID, type, tags, hoặc tuổi |
+| `memory-stats` | Thống kê memory theo type |
+
+### Ví dụ Workflow
+
+1. **Index codebase:**
+   ```
+   index(path="/path/to/your/project")
+   ```
+
+2. **Tìm kiếm code:**
+   ```
+   search(question="authentication middleware")
+   search(question="database connection", language="typescript")
+   search(question="error handling", symbol_type="function")
+   ```
+
+3. **Lưu context:**
+   ```
+   remember(content="Sử dụng PostgreSQL với Prisma ORM", memory_type="decision")
+   remember(content="Auth dùng JWT tokens", memory_type="doc", tags=["auth", "security"])
+   ```
+
+4. **Truy xuất context:**
+   ```
+   recall(query="database setup")
+   recall(query="authentication", memory_type="decision")
+   ```
+
+## Ngôn ngữ được hỗ trợ
+
+Python, JavaScript, TypeScript, C, C++, Bash, Go, Java, Kotlin, Rust, Ruby, C#, PHP, Scala, Swift, Lua, Dart, Elixir, Haskell, OCaml, Zig, Perl, CSS, HTML, Vue, JSON, YAML, TOML, Makefile
+
+## Cấu hình
+
+### Biến môi trường
+
+| Biến | Mô tả | Mặc định |
+|------|-------|----------|
+| `CHROMADB_URL` | URL ChromaDB server để lưu trữ vĩnh viễn | (in-memory) |
+| `CODEBAXING_DEVICE` | Thiết bị tính toán cho embeddings | `cpu` |
+
+### Tăng tốc GPU
+
+Bật GPU để tạo embedding nhanh hơn:
+
+```bash
+# WebGPU (thử nghiệm, dùng Metal trên macOS)
+export CODEBAXING_DEVICE=webgpu
+
+# Tự động chọn thiết bị tốt nhất
+export CODEBAXING_DEVICE=auto
+
+# NVIDIA GPU (chỉ Linux/Windows, cần CUDA)
+export CODEBAXING_DEVICE=cuda
+```
+
+Mặc định là `cpu`, hoạt động mọi nơi.
+
+**Lưu ý:** macOS không hỗ trợ CUDA (không có NVIDIA drivers). Dùng `webgpu` để tăng tốc trên Mac.
+
+### Lưu trữ
+
+Metadata được lưu trong thư mục `.codebaxing/` trong project:
+- `metadata.json` - Index metadata và file timestamps
+
+## Development
+
+```bash
+npm run dev       # Chạy với tsx (không cần build)
+npm run build     # Compile TypeScript
+npm start         # Chạy bản đã compile
+npm test          # Chạy tests
+npm run typecheck # Type check không emit
+```
+
+### Testing
+
+```bash
+# Chạy unit tests
+npm test
+
+# Test indexing thủ công
+CHROMADB_URL=http://localhost:8000 npx tsx test-indexing.ts
+```
+
+## So sánh: Grep vs Semantic Search
+
+| Khía cạnh | Grep | Semantic Search |
+|-----------|------|-----------------|
+| Query | Match exact text | Ngôn ngữ tự nhiên |
+| "authentication" | Chỉ tìm "authentication" | Tìm login, auth, credentials, v.v. |
+| Hiểu context | Không | Có |
+| Tìm từ đồng nghĩa | Không | Có |
+| Tốc độ | Rất nhanh | Nhanh (sau khi index) |
+| Setup | Không cần | Cần indexing |
+
+## Chi tiết kỹ thuật
+
+| Component | Công nghệ |
+|-----------|-----------|
+| Embedding Model | `all-MiniLM-L6-v2` (384 chiều) |
+| Model Runtime | `@huggingface/transformers` (ONNX) |
+| Vector Database | ChromaDB |
+| Code Parser | Tree-sitter |
+| MCP SDK | `@modelcontextprotocol/sdk` |
+
+## License
+
+MIT

package/dist/core/exceptions.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Custom exceptions for Codebaxing.
+ */
+export declare class CodebaxingError extends Error {
+    constructor(message: string);
+}
+export declare class ParseError extends CodebaxingError {
+    filepath: string;
+    language: string;
+    details: string;
+    constructor(filepath: string, language: string, details: string);
+}
+export declare class IndexingError extends CodebaxingError {
+    constructor(message: string);
+}
+export declare class EmbeddingError extends CodebaxingError {
+    constructor(message: string);
+}
+export declare class SearchError extends CodebaxingError {
+    constructor(message: string);
+}
+export declare class ConfigurationError extends CodebaxingError {
+    constructor(message: string);
+}
+//# sourceMappingURL=exceptions.d.ts.map

package/dist/core/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../src/core/exceptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,UAAW,SAAQ,eAAe;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;gBAEJ,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAOhE;AAED,qBAAa,aAAc,SAAQ,eAAe;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAe,SAAQ,eAAe;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,WAAY,SAAQ,eAAe;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/core/exceptions.js

@@ -0,0 +1,46 @@
+/**
+ * Custom exceptions for Codebaxing.
+ */
+export class CodebaxingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CodebaxingError';
+    }
+}
+export class ParseError extends CodebaxingError {
+    filepath;
+    language;
+    details;
+    constructor(filepath, language, details) {
+        super(`Failed to parse ${filepath} (${language}): ${details}`);
+        this.name = 'ParseError';
+        this.filepath = filepath;
+        this.language = language;
+        this.details = details;
+    }
+}
+export class IndexingError extends CodebaxingError {
+    constructor(message) {
+        super(message);
+        this.name = 'IndexingError';
+    }
+}
+export class EmbeddingError extends CodebaxingError {
+    constructor(message) {
+        super(message);
+        this.name = 'EmbeddingError';
+    }
+}
+export class SearchError extends CodebaxingError {
+    constructor(message) {
+        super(message);
+        this.name = 'SearchError';
+    }
+}
+export class ConfigurationError extends CodebaxingError {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigurationError';
+    }
+}
+//# sourceMappingURL=exceptions.js.map

package/dist/core/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../src/core/exceptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,eAAe;IAC7C,QAAQ,CAAS;IACjB,QAAQ,CAAS;IACjB,OAAO,CAAS;IAEhB,YAAY,QAAgB,EAAE,QAAgB,EAAE,OAAe;QAC7D,KAAK,CAAC,mBAAmB,QAAQ,KAAK,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,eAAe;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,eAAe;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,eAAe;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/core/interfaces.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Abstract interfaces for Codebaxing components.
+ */
+import type { ParsedFile } from './models.js';
+export interface IParser {
+    /** Determine if this parser can handle the given file. */
+    canParse(filepath: string): boolean;
+    /** Parse a source file and extract all symbols. */
+    parseFile(filepath: string): ParsedFile;
+    /** Return list of file extensions this parser supports. */
+    getSupportedExtensions(): string[];
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/core/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/core/interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,OAAO;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAEpC,mDAAmD;IACnD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC;IAExC,2DAA2D;IAC3D,sBAAsB,IAAI,MAAM,EAAE,CAAC;CACpC"}

package/dist/core/interfaces.js

@@ -0,0 +1,5 @@
+/**
+ * Abstract interfaces for Codebaxing components.
+ */
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/core/interfaces.js.map

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

package/dist/core/models.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Core data models for Codebaxing.
+ *
+ * Defines the fundamental data structures used throughout the system
+ * for representing code symbols, parsed files, and codebase indices.
+ */
+export declare enum SymbolType {
+    FUNCTION = "function",
+    CLASS = "class",
+    METHOD = "method",
+    VARIABLE = "variable"
+}
+export declare function symbolTypeFromString(value: string): SymbolType;
+export interface SymbolData {
+    name: string;
+    type: SymbolType;
+    filepath: string;
+    lineStart: number;
+    lineEnd: number;
+    language: string;
+    signature: string;
+    docstring?: string;
+    parent?: string;
+    codeSnippet?: string;
+    imports?: string[];
+    calls?: string[];
+    metadata?: Record<string, unknown>;
+}
+export declare class Symbol {
+    readonly name: string;
+    readonly type: SymbolType;
+    readonly filepath: string;
+    readonly lineStart: number;
+    readonly lineEnd: number;
+    readonly language: string;
+    readonly signature: string;
+    readonly docstring: string;
+    readonly parent: string | undefined;
+    readonly codeSnippet: string;
+    readonly imports: string[];
+    readonly calls: string[];
+    readonly metadata: Record<string, unknown>;
+    constructor(data: SymbolData);
+    get qualifiedName(): string;
+    get lineCount(): number;
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): Symbol;
+}
+export interface ParsedFileData {
+    filepath: string;
+    language: string;
+    symbols?: Symbol[];
+    imports?: string[];
+    parseTime?: number;
+    error?: string;
+}
+export declare class ParsedFile {
+    readonly filepath: string;
+    readonly language: string;
+    readonly symbols: Symbol[];
+    readonly imports: string[];
+    readonly parseTime: number;
+    readonly error: string | undefined;
+    constructor(data: ParsedFileData);
+    get isSuccessful(): boolean;
+    get symbolCount(): number;
+    getSymbolsByType(symbolType: SymbolType): Symbol[];
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): ParsedFile;
+}
+export interface CodebaseIndexData {
+    rootPath: string;
+    files?: Record<string, ParsedFile>;
+    totalFiles?: number;
+    totalSymbols?: number;
+    indexedAt?: string;
+}
+export declare class CodebaseIndex {
+    readonly rootPath: string;
+    readonly files: Record<string, ParsedFile>;
+    readonly totalFiles: number;
+    readonly totalSymbols: number;
+    readonly indexedAt: string;
+    constructor(data: CodebaseIndexData);
+    get successfulParses(): number;
+    get failedParses(): number;
+    getSymbolsByName(name: string): Symbol[];
+    getSymbolsByType(symbolType: SymbolType): Symbol[];
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): CodebaseIndex;
+}
+export declare enum MemoryType {
+    CONVERSATION = "conversation",
+    STATUS = "status",
+    DECISION = "decision",
+    PREFERENCE = "preference",
+    DOC = "doc",
+    NOTE = "note"
+}
+export declare function memoryTypeFromString(value: string): MemoryType;
+declare const VALID_TTLS: readonly ["session", "day", "week", "month", "permanent"];
+export type TTL = typeof VALID_TTLS[number];
+export interface MemoryData {
+    id: string;
+    content: string;
+    memoryType: MemoryType;
+    project: string;
+    tags?: string[];
+    createdAt?: string;
+    accessedAt?: string;
+    ttl?: TTL;
+    source?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare class Memory {
+    id: string;
+    content: string;
+    memoryType: MemoryType;
+    project: string;
+    tags: string[];
+    createdAt: string;
+    accessedAt: string;
+    ttl: TTL;
+    source: string;
+    metadata: Record<string, unknown>;
+    constructor(data: MemoryData);
+    toDict(): Record<string, unknown>;
+    static fromDict(data: Record<string, unknown>): Memory;
+    touch(): void;
+}
+export {};
+//# sourceMappingURL=models.d.ts.map

package/dist/core/models.d.ts.map

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