@dollhousemcp/mcp-server 1.8.1 โ 1.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.github.md +96 -33
- package/README.md +3 -3
- package/README.md.backup +100 -36
- package/README.npm.md +3 -3
- package/dist/collection/CollectionBrowser.d.ts.map +1 -1
- package/dist/collection/CollectionBrowser.js +6 -5
- package/dist/elements/memories/Memory.d.ts +190 -0
- package/dist/elements/memories/Memory.d.ts.map +1 -0
- package/dist/elements/memories/Memory.js +627 -0
- package/dist/elements/memories/MemoryManager.d.ts +136 -0
- package/dist/elements/memories/MemoryManager.d.ts.map +1 -0
- package/dist/elements/memories/MemoryManager.js +607 -0
- package/dist/elements/memories/MemorySearchIndex.d.ts +156 -0
- package/dist/elements/memories/MemorySearchIndex.d.ts.map +1 -0
- package/dist/elements/memories/MemorySearchIndex.js +690 -0
- package/dist/elements/memories/constants.d.ts +95 -0
- package/dist/elements/memories/constants.d.ts.map +1 -0
- package/dist/elements/memories/constants.js +102 -0
- package/dist/elements/memories/index.d.ts +7 -0
- package/dist/elements/memories/index.d.ts.map +1 -0
- package/dist/elements/memories/index.js +7 -0
- package/dist/elements/memories/utils.d.ts +68 -0
- package/dist/elements/memories/utils.d.ts.map +1 -0
- package/dist/elements/memories/utils.js +137 -0
- package/dist/generated/version.d.ts +2 -2
- package/dist/generated/version.js +3 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +10 -4
- package/dist/security/audit/SecurityAuditor.d.ts.map +1 -1
- package/dist/security/audit/SecurityAuditor.js +24 -2
- package/dist/security/audit/config/suppressions.d.ts.map +1 -1
- package/dist/security/audit/config/suppressions.js +91 -1
- package/dist/security/securityMonitor.d.ts +1 -1
- package/dist/security/securityMonitor.d.ts.map +1 -1
- package/dist/security/securityMonitor.js +1 -1
- package/dist/server/tools/CollectionTools.js +7 -7
- package/package.json +1 -1
- package/dist/config/ConfigWizardDisplay.d.ts +0 -64
- package/dist/config/ConfigWizardDisplay.d.ts.map +0 -1
- package/dist/config/ConfigWizardDisplay.js +0 -150
- package/dist/config/WizardFirstResponse.d.ts +0 -25
- package/dist/config/WizardFirstResponse.d.ts.map +0 -1
- package/dist/config/WizardFirstResponse.js +0 -118
- package/dist/scripts/scripts/run-config-wizard.js +0 -57
- package/dist/scripts/src/config/ConfigManager.js +0 -799
- package/dist/scripts/src/config/ConfigWizard.js +0 -368
- package/dist/scripts/src/errors/SecurityError.js +0 -47
- package/dist/scripts/src/security/constants.js +0 -28
- package/dist/scripts/src/security/contentValidator.js +0 -415
- package/dist/scripts/src/security/errors.js +0 -32
- package/dist/scripts/src/security/regexValidator.js +0 -217
- package/dist/scripts/src/security/secureYamlParser.js +0 -272
- package/dist/scripts/src/security/securityMonitor.js +0 -111
- package/dist/scripts/src/security/validators/unicodeValidator.js +0 -315
- package/dist/scripts/src/utils/logger.js +0 -288
- package/dist/tools/getWelcomeMessage.d.ts +0 -41
- package/dist/tools/getWelcomeMessage.d.ts.map +0 -1
- package/dist/tools/getWelcomeMessage.js +0 -109
package/README.github.md
CHANGED
|
@@ -97,11 +97,11 @@
|
|
|
97
97
|
```bash
|
|
98
98
|
npm install @dollhousemcp/mcp-server
|
|
99
99
|
```
|
|
100
|
-
See [Quick Start](
|
|
100
|
+
See [Quick Start](#-quick-start) for complete setup instructions.
|
|
101
101
|
|
|
102
102
|
---
|
|
103
103
|
|
|
104
|
-
## ๐ฏ Element Types
|
|
104
|
+
## ๐ฏ Element Types
|
|
105
105
|
|
|
106
106
|
### โ
Available Now
|
|
107
107
|
|
|
@@ -121,7 +121,7 @@ Shape how your AI behaves and responds
|
|
|
121
121
|
</td>
|
|
122
122
|
<td width="50%">
|
|
123
123
|
|
|
124
|
-
#### ๐ก Skills
|
|
124
|
+
#### ๐ก Skills
|
|
125
125
|
Add specialized capabilities your AI can use
|
|
126
126
|
- **Code Review** - Analyze code quality and suggest improvements
|
|
127
127
|
- **Data Analysis** - Statistical analysis and visualization
|
|
@@ -156,34 +156,50 @@ Enable autonomous task completion
|
|
|
156
156
|
- **Security Fix Specialist** - Vulnerability remediation
|
|
157
157
|
- **Use**: `"Run the code reviewer agent"`
|
|
158
158
|
|
|
159
|
+
</td>
|
|
160
|
+
</tr>
|
|
161
|
+
<tr>
|
|
162
|
+
<td colspan="2">
|
|
163
|
+
|
|
164
|
+
#### ๐ง Memory <span style="background-color: #4CAF50; color: white; padding: 2px 6px; border-radius: 3px; font-size: 0.8em;">NEW in v1.9.0</span>
|
|
165
|
+
Persistent context across sessions with intelligent organization
|
|
166
|
+
- **Text-based storage** - Currently supports text content (PDFs, images, and other media types coming soon)
|
|
167
|
+
- **Date-based folders** - Automatic YYYY-MM-DD organization prevents flat directory issues
|
|
168
|
+
- **YAML format** - Human-readable structured data (vs Markdown for other elements)
|
|
169
|
+
- **Smart deduplication** - SHA-256 hashing prevents duplicate storage
|
|
170
|
+
- **Search indexing** - Fast queries across thousands of entries
|
|
171
|
+
- **Use**: `"Create a memory for this project"` or `"Remember this conversation"`
|
|
172
|
+
|
|
173
|
+
**Typical file sizes**: Single memories up to ~100KB, folder structure enables unlimited collections
|
|
174
|
+
|
|
159
175
|
</td>
|
|
160
176
|
</tr>
|
|
161
177
|
</table>
|
|
162
178
|
|
|
163
|
-
###
|
|
179
|
+
### ๐ Coming Soon
|
|
164
180
|
|
|
165
181
|
<table>
|
|
166
182
|
<tr>
|
|
167
183
|
<td width="50%">
|
|
168
184
|
|
|
169
|
-
#### ๐ง Memory
|
|
170
|
-
Persistent context across sessions
|
|
171
|
-
- **Project Context** - Remember project details and decisions
|
|
172
|
-
- **Learning Progress** - Track skill development over time
|
|
173
|
-
- **Personal Preferences** - Store user-specific settings
|
|
174
|
-
- **Conversation History** - Maintain dialogue continuity
|
|
175
|
-
- **Status**: Coming Soon
|
|
176
|
-
|
|
177
|
-
</td>
|
|
178
|
-
<td width="50%">
|
|
179
|
-
|
|
180
185
|
#### ๐ฏ Ensembles
|
|
181
186
|
Combine multiple elements as one unified entity
|
|
182
187
|
- **Full-Stack Developer** - Frontend + Backend + DevOps skills
|
|
183
188
|
- **Writing Suite** - Creative + Technical + Editorial capabilities
|
|
184
189
|
- **Security Team** - Analyst + Auditor + Remediation skills
|
|
185
190
|
- **Data Science Platform** - Analysis + Visualization + ML skills
|
|
186
|
-
- **Status**:
|
|
191
|
+
- **Status**: In development
|
|
192
|
+
|
|
193
|
+
</td>
|
|
194
|
+
<td width="50%">
|
|
195
|
+
|
|
196
|
+
#### ๐ Prompts
|
|
197
|
+
Reusable instruction sets
|
|
198
|
+
- **Code Review Checklist** - Systematic review steps
|
|
199
|
+
- **Security Audit Guide** - Vulnerability assessment process
|
|
200
|
+
- **Writing Guidelines** - Style and tone instructions
|
|
201
|
+
- **Debug Workflow** - Problem-solving methodology
|
|
202
|
+
- **Status**: Planned
|
|
187
203
|
|
|
188
204
|
</td>
|
|
189
205
|
</tr>
|
|
@@ -196,18 +212,18 @@ External function calls and commands
|
|
|
196
212
|
- **Database Queries** - Direct database interaction
|
|
197
213
|
- **API Calls** - External service integration
|
|
198
214
|
- **File Operations** - Advanced file manipulation
|
|
199
|
-
- **Status**:
|
|
215
|
+
- **Status**: Under consideration
|
|
200
216
|
|
|
201
217
|
</td>
|
|
202
218
|
<td width="50%">
|
|
203
219
|
|
|
204
|
-
####
|
|
205
|
-
|
|
206
|
-
- **
|
|
207
|
-
- **
|
|
208
|
-
- **
|
|
209
|
-
- **
|
|
210
|
-
- **Status**:
|
|
220
|
+
#### ๐ Memory Enhancements
|
|
221
|
+
Expanding memory capabilities
|
|
222
|
+
- **PDF Support** - Text extraction from PDF documents
|
|
223
|
+
- **Image Analysis** - Visual content understanding
|
|
224
|
+
- **Audio Transcription** - Voice and sound processing
|
|
225
|
+
- **Video Understanding** - Motion and scene analysis
|
|
226
|
+
- **Status**: Roadmap planned
|
|
211
227
|
|
|
212
228
|
</td>
|
|
213
229
|
</tr>
|
|
@@ -301,7 +317,7 @@ Assistant: "I've saved 'Hard SciFi Writer' to your portfolio. You can activate i
|
|
|
301
317
|
- **Save your favorites**: `"Save this configuration as my default setup"`
|
|
302
318
|
- **Share with others**: `"Submit my custom persona to the community collection"`
|
|
303
319
|
|
|
304
|
-
##
|
|
320
|
+
## ๐ฆ Installation
|
|
305
321
|
|
|
306
322
|
### Choose Your Installation Method
|
|
307
323
|
|
|
@@ -467,7 +483,7 @@ After configuring and restarting Claude Desktop, test with:
|
|
|
467
483
|
list_elements type="personas"
|
|
468
484
|
```
|
|
469
485
|
|
|
470
|
-
You should see your available personas. If not, check the [Troubleshooting](
|
|
486
|
+
You should see your available personas. If not, check the [Troubleshooting](#-troubleshooting) section.
|
|
471
487
|
|
|
472
488
|
---
|
|
473
489
|
|
|
@@ -479,7 +495,7 @@ By default, your elements are stored in:
|
|
|
479
495
|
|
|
480
496
|
Use the `DOLLHOUSE_PORTFOLIO_DIR` environment variable to customize this location.
|
|
481
497
|
|
|
482
|
-
##
|
|
498
|
+
## ๐ Quick Start
|
|
483
499
|
|
|
484
500
|
Once installed, try these commands in Claude:
|
|
485
501
|
|
|
@@ -525,14 +541,28 @@ Your portfolio is organized by element type:
|
|
|
525
541
|
|
|
526
542
|
```
|
|
527
543
|
~/.dollhouse/portfolio/
|
|
528
|
-
โโโ personas/ # Behavioral profiles
|
|
529
|
-
โโโ skills/ # Discrete capabilities
|
|
530
|
-
โโโ templates/ # Reusable content structures
|
|
531
|
-
โโโ agents/ # Goal-oriented actors
|
|
532
|
-
โโโ memories/ # Persistent context
|
|
533
|
-
|
|
544
|
+
โโโ personas/ # Behavioral profiles (Markdown files)
|
|
545
|
+
โโโ skills/ # Discrete capabilities (Markdown files)
|
|
546
|
+
โโโ templates/ # Reusable content structures (Markdown files)
|
|
547
|
+
โโโ agents/ # Goal-oriented actors (Markdown files)
|
|
548
|
+
โโโ memories/ # Persistent context (YAML files with date folders)
|
|
549
|
+
โ โโโ 2025-09-18/
|
|
550
|
+
โ โ โโโ project-context.yaml
|
|
551
|
+
โ โโโ 2025-09-19/
|
|
552
|
+
โ โโโ meeting-notes.yaml
|
|
553
|
+
โ โโโ code-review.yaml
|
|
554
|
+
โโโ ensembles/ # Element combinations (Markdown files)
|
|
534
555
|
```
|
|
535
556
|
|
|
557
|
+
**Note on File Types:**
|
|
558
|
+
- **Markdown (.md)**: Used for personas, skills, templates, agents, and ensembles - human-readable with YAML frontmatter
|
|
559
|
+
- **YAML (.yaml)**: Used exclusively for memories - structured data optimized for context storage
|
|
560
|
+
|
|
561
|
+
**Memory Organization:**
|
|
562
|
+
- Memories use automatic **YYYY-MM-DD** folder structure to prevent flat directory performance issues
|
|
563
|
+
- Each memory file can grow up to ~100KB before creating a new file
|
|
564
|
+
- Folder structure enables unlimited memory collections without degradation
|
|
565
|
+
|
|
536
566
|
### Key Features
|
|
537
567
|
|
|
538
568
|
- **Local-First Architecture**: All elements stored locally with optional cloud sync
|
|
@@ -842,6 +872,39 @@ For detailed guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
|
842
872
|
|
|
843
873
|
## ๐ท๏ธ Version History
|
|
844
874
|
|
|
875
|
+
### v1.9.0 - September 19, 2025
|
|
876
|
+
|
|
877
|
+
**๐ Memory Element Release**: Persistent context storage with enterprise-grade features
|
|
878
|
+
|
|
879
|
+
#### โจ New Features
|
|
880
|
+
- **Memory Element**: Complete implementation of persistent context storage (PR #1000 - The Milestone PR!)
|
|
881
|
+
- **Date-based Organization**: Automatic folder structure (YYYY-MM-DD) prevents flat directory issues
|
|
882
|
+
- **Content Deduplication**: SHA-256 hashing prevents duplicate storage (Issue #994)
|
|
883
|
+
- **Search Indexing**: Fast queries across thousands of entries with O(log n) performance (Issue #984)
|
|
884
|
+
- **Privacy Levels**: Three-tier access control (public, private, sensitive)
|
|
885
|
+
- **Retention Policies**: Automatic cleanup based on age and capacity
|
|
886
|
+
|
|
887
|
+
#### ๐ง Improvements
|
|
888
|
+
- **Performance Optimizations**: 60-second cache for date folder operations
|
|
889
|
+
- **Collision Handling**: Automatic version suffixes for same-named files
|
|
890
|
+
- **Atomic Operations**: FileLockManager prevents corruption and race conditions
|
|
891
|
+
- **Sanitization Caching**: SHA-256 checksums reduce CPU usage by ~40% during deserialization
|
|
892
|
+
- **Retry Logic**: Search index building with exponential backoff
|
|
893
|
+
|
|
894
|
+
#### ๐ก๏ธ Security
|
|
895
|
+
- **Comprehensive Input Validation**: All memory content sanitized with DOMPurify
|
|
896
|
+
- **Path Traversal Protection**: Robust validation in MemoryManager
|
|
897
|
+
- **Size Limits**: DoS protection with 1MB memory and 100KB entry limits
|
|
898
|
+
- **Audit Logging**: Complete security event tracking
|
|
899
|
+
|
|
900
|
+
#### ๐งช Testing
|
|
901
|
+
- **89 Memory Tests**: Comprehensive coverage across 4 test suites
|
|
902
|
+
- **Concurrent Access Tests**: Thread safety verification
|
|
903
|
+
- **Security Coverage**: XSS, Unicode attacks, path traversal
|
|
904
|
+
- **CI Improvements**: Fixed GitHub integration test conflicts (PR #1001)
|
|
905
|
+
|
|
906
|
+
---
|
|
907
|
+
|
|
845
908
|
### v1.8.1 - September 15, 2025
|
|
846
909
|
|
|
847
910
|
**CI Reliability Improvements**: Fixed persistent test failures across platforms
|
package/README.md
CHANGED
|
@@ -12,7 +12,7 @@ A comprehensive Model Context Protocol (MCP) server that enables dynamic AI pers
|
|
|
12
12
|
**๐ฆ NPM Package**: https://www.npmjs.com/package/@dollhousemcp/mcp-server
|
|
13
13
|
**๐ Website**: https://dollhousemcp.com
|
|
14
14
|
|
|
15
|
-
##
|
|
15
|
+
## ๐ฆ Installation
|
|
16
16
|
|
|
17
17
|
### Choose Your Installation Method
|
|
18
18
|
|
|
@@ -178,7 +178,7 @@ After configuring and restarting Claude Desktop, test with:
|
|
|
178
178
|
list_elements type="personas"
|
|
179
179
|
```
|
|
180
180
|
|
|
181
|
-
You should see your available personas. If not, check the [Troubleshooting](
|
|
181
|
+
You should see your available personas. If not, check the [Troubleshooting](#-troubleshooting) section.
|
|
182
182
|
|
|
183
183
|
---
|
|
184
184
|
|
|
@@ -190,7 +190,7 @@ By default, your elements are stored in:
|
|
|
190
190
|
|
|
191
191
|
Use the `DOLLHOUSE_PORTFOLIO_DIR` environment variable to customize this location.
|
|
192
192
|
|
|
193
|
-
##
|
|
193
|
+
## ๐ Quick Start
|
|
194
194
|
|
|
195
195
|
Once installed, try these commands in Claude:
|
|
196
196
|
|
package/README.md.backup
CHANGED
|
@@ -49,7 +49,7 @@
|
|
|
49
49
|
|
|
50
50
|
## Elements That Customize Your AI's Capabilities and Actions
|
|
51
51
|
|
|
52
|
-
**DollhouseMCP** is open source, community-powered AI customization. Create your own customization elementsโpersonas that shape behavior, skills that add capabilities, templates for consistent outputs, and
|
|
52
|
+
**DollhouseMCP** is open source, community-powered AI customization. Create your own customization elementsโpersonas that shape behavior, skills that add capabilities, templates for consistent outputs, agents for automation, and memories for persistent contextโor use and modify an ever-growing number of customization elements from the community. Every element you create can be saved to your portfolio and used again or shared back to the DollhouseMCP Collection to help others.
|
|
53
53
|
|
|
54
54
|
### What Are Customization Elements?
|
|
55
55
|
|
|
@@ -57,11 +57,12 @@
|
|
|
57
57
|
- **Skills** โ Add specialized capabilities your AI can use
|
|
58
58
|
- **Templates** โ Ensure consistent, high-quality outputs
|
|
59
59
|
- **Agents** โ Enable autonomous task completion with smart decision-making
|
|
60
|
+
- **Memory** โ Persistent context storage across sessions
|
|
60
61
|
|
|
61
62
|
### Core Capabilities
|
|
62
63
|
|
|
63
|
-
- **๐ Community Element Library** โ A growing number of tested personas, skills, templates, and
|
|
64
|
-
- **โจ Create Custom Elements** โ Create personas, skills, templates, and
|
|
64
|
+
- **๐ Community Element Library** โ A growing number of tested personas, skills, templates, agents, and memories
|
|
65
|
+
- **โจ Create Custom Elements** โ Create personas, skills, templates, agents, and memories from scratch using natural language
|
|
65
66
|
- **๐ค Open Source** โ AGPL-3.0 licensed, ensuring community contributions stay free
|
|
66
67
|
- **๐ The DollhouseMCP Collection** โ Install any community element with one command
|
|
67
68
|
- **๐ ๏ธ 41 Professional Tools** โ Complete toolkit for element creation and management
|
|
@@ -97,11 +98,11 @@
|
|
|
97
98
|
```bash
|
|
98
99
|
npm install @dollhousemcp/mcp-server
|
|
99
100
|
```
|
|
100
|
-
See [Quick Start](
|
|
101
|
+
See [Quick Start](#-quick-start) for complete setup instructions.
|
|
101
102
|
|
|
102
103
|
---
|
|
103
104
|
|
|
104
|
-
## ๐ฏ Element Types
|
|
105
|
+
## ๐ฏ Element Types
|
|
105
106
|
|
|
106
107
|
### โ
Available Now
|
|
107
108
|
|
|
@@ -121,7 +122,7 @@ Shape how your AI behaves and responds
|
|
|
121
122
|
</td>
|
|
122
123
|
<td width="50%">
|
|
123
124
|
|
|
124
|
-
#### ๐ก Skills
|
|
125
|
+
#### ๐ก Skills
|
|
125
126
|
Add specialized capabilities your AI can use
|
|
126
127
|
- **Code Review** - Analyze code quality and suggest improvements
|
|
127
128
|
- **Data Analysis** - Statistical analysis and visualization
|
|
@@ -156,34 +157,50 @@ Enable autonomous task completion
|
|
|
156
157
|
- **Security Fix Specialist** - Vulnerability remediation
|
|
157
158
|
- **Use**: `"Run the code reviewer agent"`
|
|
158
159
|
|
|
160
|
+
</td>
|
|
161
|
+
</tr>
|
|
162
|
+
<tr>
|
|
163
|
+
<td colspan="2">
|
|
164
|
+
|
|
165
|
+
#### ๐ง Memory <span style="background-color: #4CAF50; color: white; padding: 2px 6px; border-radius: 3px; font-size: 0.8em;">NEW in v1.9.0</span>
|
|
166
|
+
Persistent context across sessions with intelligent organization
|
|
167
|
+
- **Text-based storage** - Currently supports text content (PDFs, images, and other media types coming soon)
|
|
168
|
+
- **Date-based folders** - Automatic YYYY-MM-DD organization prevents flat directory issues
|
|
169
|
+
- **YAML format** - Human-readable structured data (vs Markdown for other elements)
|
|
170
|
+
- **Smart deduplication** - SHA-256 hashing prevents duplicate storage
|
|
171
|
+
- **Search indexing** - Fast queries across thousands of entries
|
|
172
|
+
- **Use**: `"Create a memory for this project"` or `"Remember this conversation"`
|
|
173
|
+
|
|
174
|
+
**Typical file sizes**: Single memories up to ~100KB, folder structure enables unlimited collections
|
|
175
|
+
|
|
159
176
|
</td>
|
|
160
177
|
</tr>
|
|
161
178
|
</table>
|
|
162
179
|
|
|
163
|
-
###
|
|
180
|
+
### ๐ Coming Soon
|
|
164
181
|
|
|
165
182
|
<table>
|
|
166
183
|
<tr>
|
|
167
184
|
<td width="50%">
|
|
168
185
|
|
|
169
|
-
#### ๐ง Memory
|
|
170
|
-
Persistent context across sessions
|
|
171
|
-
- **Project Context** - Remember project details and decisions
|
|
172
|
-
- **Learning Progress** - Track skill development over time
|
|
173
|
-
- **Personal Preferences** - Store user-specific settings
|
|
174
|
-
- **Conversation History** - Maintain dialogue continuity
|
|
175
|
-
- **Status**: Coming Soon
|
|
176
|
-
|
|
177
|
-
</td>
|
|
178
|
-
<td width="50%">
|
|
179
|
-
|
|
180
186
|
#### ๐ฏ Ensembles
|
|
181
187
|
Combine multiple elements as one unified entity
|
|
182
188
|
- **Full-Stack Developer** - Frontend + Backend + DevOps skills
|
|
183
189
|
- **Writing Suite** - Creative + Technical + Editorial capabilities
|
|
184
190
|
- **Security Team** - Analyst + Auditor + Remediation skills
|
|
185
191
|
- **Data Science Platform** - Analysis + Visualization + ML skills
|
|
186
|
-
- **Status**:
|
|
192
|
+
- **Status**: In development
|
|
193
|
+
|
|
194
|
+
</td>
|
|
195
|
+
<td width="50%">
|
|
196
|
+
|
|
197
|
+
#### ๐ Prompts
|
|
198
|
+
Reusable instruction sets
|
|
199
|
+
- **Code Review Checklist** - Systematic review steps
|
|
200
|
+
- **Security Audit Guide** - Vulnerability assessment process
|
|
201
|
+
- **Writing Guidelines** - Style and tone instructions
|
|
202
|
+
- **Debug Workflow** - Problem-solving methodology
|
|
203
|
+
- **Status**: Planned
|
|
187
204
|
|
|
188
205
|
</td>
|
|
189
206
|
</tr>
|
|
@@ -196,18 +213,18 @@ External function calls and commands
|
|
|
196
213
|
- **Database Queries** - Direct database interaction
|
|
197
214
|
- **API Calls** - External service integration
|
|
198
215
|
- **File Operations** - Advanced file manipulation
|
|
199
|
-
- **Status**:
|
|
216
|
+
- **Status**: Under consideration
|
|
200
217
|
|
|
201
218
|
</td>
|
|
202
219
|
<td width="50%">
|
|
203
220
|
|
|
204
|
-
####
|
|
205
|
-
|
|
206
|
-
- **
|
|
207
|
-
- **
|
|
208
|
-
- **
|
|
209
|
-
- **
|
|
210
|
-
- **Status**:
|
|
221
|
+
#### ๐ Memory Enhancements
|
|
222
|
+
Expanding memory capabilities
|
|
223
|
+
- **PDF Support** - Text extraction from PDF documents
|
|
224
|
+
- **Image Analysis** - Visual content understanding
|
|
225
|
+
- **Audio Transcription** - Voice and sound processing
|
|
226
|
+
- **Video Understanding** - Motion and scene analysis
|
|
227
|
+
- **Status**: Roadmap planned
|
|
211
228
|
|
|
212
229
|
</td>
|
|
213
230
|
</tr>
|
|
@@ -301,7 +318,7 @@ Assistant: "I've saved 'Hard SciFi Writer' to your portfolio. You can activate i
|
|
|
301
318
|
- **Save your favorites**: `"Save this configuration as my default setup"`
|
|
302
319
|
- **Share with others**: `"Submit my custom persona to the community collection"`
|
|
303
320
|
|
|
304
|
-
##
|
|
321
|
+
## ๐ฆ Installation
|
|
305
322
|
|
|
306
323
|
### Choose Your Installation Method
|
|
307
324
|
|
|
@@ -467,7 +484,7 @@ After configuring and restarting Claude Desktop, test with:
|
|
|
467
484
|
list_elements type="personas"
|
|
468
485
|
```
|
|
469
486
|
|
|
470
|
-
You should see your available personas. If not, check the [Troubleshooting](
|
|
487
|
+
You should see your available personas. If not, check the [Troubleshooting](#-troubleshooting) section.
|
|
471
488
|
|
|
472
489
|
---
|
|
473
490
|
|
|
@@ -479,7 +496,7 @@ By default, your elements are stored in:
|
|
|
479
496
|
|
|
480
497
|
Use the `DOLLHOUSE_PORTFOLIO_DIR` environment variable to customize this location.
|
|
481
498
|
|
|
482
|
-
##
|
|
499
|
+
## ๐ Quick Start
|
|
483
500
|
|
|
484
501
|
Once installed, try these commands in Claude:
|
|
485
502
|
|
|
@@ -525,14 +542,28 @@ Your portfolio is organized by element type:
|
|
|
525
542
|
|
|
526
543
|
```
|
|
527
544
|
~/.dollhouse/portfolio/
|
|
528
|
-
โโโ personas/ # Behavioral profiles
|
|
529
|
-
โโโ skills/ # Discrete capabilities
|
|
530
|
-
โโโ templates/ # Reusable content structures
|
|
531
|
-
โโโ agents/ # Goal-oriented actors
|
|
532
|
-
โโโ memories/ # Persistent context
|
|
533
|
-
|
|
545
|
+
โโโ personas/ # Behavioral profiles (Markdown files)
|
|
546
|
+
โโโ skills/ # Discrete capabilities (Markdown files)
|
|
547
|
+
โโโ templates/ # Reusable content structures (Markdown files)
|
|
548
|
+
โโโ agents/ # Goal-oriented actors (Markdown files)
|
|
549
|
+
โโโ memories/ # Persistent context (YAML files with date folders)
|
|
550
|
+
โ โโโ 2025-09-18/
|
|
551
|
+
โ โ โโโ project-context.yaml
|
|
552
|
+
โ โโโ 2025-09-19/
|
|
553
|
+
โ โโโ meeting-notes.yaml
|
|
554
|
+
โ โโโ code-review.yaml
|
|
555
|
+
โโโ ensembles/ # Element combinations (Markdown files)
|
|
534
556
|
```
|
|
535
557
|
|
|
558
|
+
**Note on File Types:**
|
|
559
|
+
- **Markdown (.md)**: Used for personas, skills, templates, agents, and ensembles - human-readable with YAML frontmatter
|
|
560
|
+
- **YAML (.yaml)**: Used exclusively for memories - structured data optimized for context storage
|
|
561
|
+
|
|
562
|
+
**Memory Organization:**
|
|
563
|
+
- Memories use automatic **YYYY-MM-DD** folder structure to prevent flat directory performance issues
|
|
564
|
+
- Each memory file can grow up to ~100KB before creating a new file
|
|
565
|
+
- Folder structure enables unlimited memory collections without degradation
|
|
566
|
+
|
|
536
567
|
### Key Features
|
|
537
568
|
|
|
538
569
|
- **Local-First Architecture**: All elements stored locally with optional cloud sync
|
|
@@ -842,6 +873,39 @@ For detailed guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
|
842
873
|
|
|
843
874
|
## ๐ท๏ธ Version History
|
|
844
875
|
|
|
876
|
+
### v1.9.0 - September 19, 2025
|
|
877
|
+
|
|
878
|
+
**๐ Memory Element Release**: Persistent context storage with enterprise-grade features
|
|
879
|
+
|
|
880
|
+
#### โจ New Features
|
|
881
|
+
- **Memory Element**: Complete implementation of persistent context storage (PR #1000 - The Milestone PR!)
|
|
882
|
+
- **Date-based Organization**: Automatic folder structure (YYYY-MM-DD) prevents flat directory issues
|
|
883
|
+
- **Content Deduplication**: SHA-256 hashing prevents duplicate storage (Issue #994)
|
|
884
|
+
- **Search Indexing**: Fast queries across thousands of entries with O(log n) performance (Issue #984)
|
|
885
|
+
- **Privacy Levels**: Three-tier access control (public, private, sensitive)
|
|
886
|
+
- **Retention Policies**: Automatic cleanup based on age and capacity
|
|
887
|
+
|
|
888
|
+
#### ๐ง Improvements
|
|
889
|
+
- **Performance Optimizations**: 60-second cache for date folder operations
|
|
890
|
+
- **Collision Handling**: Automatic version suffixes for same-named files
|
|
891
|
+
- **Atomic Operations**: FileLockManager prevents corruption and race conditions
|
|
892
|
+
- **Sanitization Caching**: SHA-256 checksums reduce CPU usage by ~40% during deserialization
|
|
893
|
+
- **Retry Logic**: Search index building with exponential backoff
|
|
894
|
+
|
|
895
|
+
#### ๐ก๏ธ Security
|
|
896
|
+
- **Comprehensive Input Validation**: All memory content sanitized with DOMPurify
|
|
897
|
+
- **Path Traversal Protection**: Robust validation in MemoryManager
|
|
898
|
+
- **Size Limits**: DoS protection with 1MB memory and 100KB entry limits
|
|
899
|
+
- **Audit Logging**: Complete security event tracking
|
|
900
|
+
|
|
901
|
+
#### ๐งช Testing
|
|
902
|
+
- **89 Memory Tests**: Comprehensive coverage across 4 test suites
|
|
903
|
+
- **Concurrent Access Tests**: Thread safety verification
|
|
904
|
+
- **Security Coverage**: XSS, Unicode attacks, path traversal
|
|
905
|
+
- **CI Improvements**: Fixed GitHub integration test conflicts (PR #1001)
|
|
906
|
+
|
|
907
|
+
---
|
|
908
|
+
|
|
845
909
|
### v1.8.1 - September 15, 2025
|
|
846
910
|
|
|
847
911
|
**CI Reliability Improvements**: Fixed persistent test failures across platforms
|
package/README.npm.md
CHANGED
|
@@ -12,7 +12,7 @@ A comprehensive Model Context Protocol (MCP) server that enables dynamic AI pers
|
|
|
12
12
|
**๐ฆ NPM Package**: https://www.npmjs.com/package/@dollhousemcp/mcp-server
|
|
13
13
|
**๐ Website**: https://dollhousemcp.com
|
|
14
14
|
|
|
15
|
-
##
|
|
15
|
+
## ๐ฆ Installation
|
|
16
16
|
|
|
17
17
|
### Choose Your Installation Method
|
|
18
18
|
|
|
@@ -178,7 +178,7 @@ After configuring and restarting Claude Desktop, test with:
|
|
|
178
178
|
list_elements type="personas"
|
|
179
179
|
```
|
|
180
180
|
|
|
181
|
-
You should see your available personas. If not, check the [Troubleshooting](
|
|
181
|
+
You should see your available personas. If not, check the [Troubleshooting](#-troubleshooting) section.
|
|
182
182
|
|
|
183
183
|
---
|
|
184
184
|
|
|
@@ -190,7 +190,7 @@ By default, your elements are stored in:
|
|
|
190
190
|
|
|
191
191
|
Use the `DOLLHOUSE_PORTFOLIO_DIR` environment variable to customize this location.
|
|
192
192
|
|
|
193
|
-
##
|
|
193
|
+
## ๐ Quick Start
|
|
194
194
|
|
|
195
195
|
Once installed, try these commands in Claude:
|
|
196
196
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"CollectionBrowser.d.ts","sourceRoot":"","sources":["../../src/collection/CollectionBrowser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAkB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;
|
|
1
|
+
{"version":3,"file":"CollectionBrowser.d.ts","sourceRoot":"","sources":["../../src/collection/CollectionBrowser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAkB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAgCrE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,OAAO,CAAmE;gBAEtE,YAAY,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE,eAAe,EAAE,YAAY,CAAC,EAAE,sBAAsB;IAMhH;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAAC,UAAU,EAAE,GAAG,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IA+DvH;;;OAGG;YACW,eAAe;IAiC7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAiBhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAWvC;;OAEG;YACW,eAAe;IAwC7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqBhC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAWvC;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,GAAE,MAAW,GAAG,MAAM;CAgF7H"}
|