@prmichaelsen/remember-mcp 0.1.0

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.
Files changed (95) hide show
  1. package/.env.example +65 -0
  2. package/AGENT.md +840 -0
  3. package/README.md +72 -0
  4. package/agent/design/.gitkeep +0 -0
  5. package/agent/design/access-control-result-pattern.md +458 -0
  6. package/agent/design/action-audit-memory-types.md +637 -0
  7. package/agent/design/common-template-fields.md +282 -0
  8. package/agent/design/complete-tool-set.md +407 -0
  9. package/agent/design/content-types-expansion.md +521 -0
  10. package/agent/design/cross-database-id-strategy.md +358 -0
  11. package/agent/design/default-template-library.md +423 -0
  12. package/agent/design/firestore-wrapper-analysis.md +606 -0
  13. package/agent/design/llm-provider-abstraction.md +691 -0
  14. package/agent/design/location-handling-architecture.md +523 -0
  15. package/agent/design/memory-templates-design.md +364 -0
  16. package/agent/design/permissions-storage-architecture.md +680 -0
  17. package/agent/design/relationship-storage-strategy.md +361 -0
  18. package/agent/design/remember-mcp-implementation-tasks.md +417 -0
  19. package/agent/design/remember-mcp-progress.yaml +141 -0
  20. package/agent/design/requirements-enhancements.md +468 -0
  21. package/agent/design/requirements.md +56 -0
  22. package/agent/design/template-storage-strategy.md +412 -0
  23. package/agent/design/template-suggestion-system.md +853 -0
  24. package/agent/design/trust-escalation-prevention.md +343 -0
  25. package/agent/design/trust-system-implementation.md +592 -0
  26. package/agent/design/user-preferences.md +683 -0
  27. package/agent/design/weaviate-collection-strategy.md +461 -0
  28. package/agent/milestones/.gitkeep +0 -0
  29. package/agent/milestones/milestone-1-project-foundation.md +121 -0
  30. package/agent/milestones/milestone-2-core-memory-system.md +150 -0
  31. package/agent/milestones/milestone-3-relationships-graph.md +116 -0
  32. package/agent/milestones/milestone-4-user-preferences.md +103 -0
  33. package/agent/milestones/milestone-5-template-system.md +126 -0
  34. package/agent/milestones/milestone-6-auth-multi-tenancy.md +124 -0
  35. package/agent/milestones/milestone-7-trust-permissions.md +133 -0
  36. package/agent/milestones/milestone-8-testing-quality.md +137 -0
  37. package/agent/milestones/milestone-9-deployment-documentation.md +147 -0
  38. package/agent/patterns/.gitkeep +0 -0
  39. package/agent/patterns/bootstrap.md +1271 -0
  40. package/agent/patterns/firebase-admin-sdk-v8-usage.md +950 -0
  41. package/agent/patterns/firestore-users-pattern-best-practices.md +347 -0
  42. package/agent/patterns/library-services.md +454 -0
  43. package/agent/patterns/testing-colocated.md +316 -0
  44. package/agent/progress.yaml +395 -0
  45. package/agent/tasks/.gitkeep +0 -0
  46. package/agent/tasks/task-1-initialize-project-structure.md +266 -0
  47. package/agent/tasks/task-2-install-dependencies.md +199 -0
  48. package/agent/tasks/task-3-setup-weaviate-client.md +330 -0
  49. package/agent/tasks/task-4-setup-firestore-client.md +362 -0
  50. package/agent/tasks/task-5-create-basic-mcp-server.md +114 -0
  51. package/agent/tasks/task-6-create-integration-tests.md +195 -0
  52. package/agent/tasks/task-7-finalize-milestone-1.md +363 -0
  53. package/agent/tasks/task-8-setup-utility-scripts.md +382 -0
  54. package/agent/tasks/task-9-create-server-factory.md +404 -0
  55. package/dist/config.d.ts +26 -0
  56. package/dist/constants/content-types.d.ts +60 -0
  57. package/dist/firestore/init.d.ts +14 -0
  58. package/dist/firestore/paths.d.ts +53 -0
  59. package/dist/firestore/paths.spec.d.ts +2 -0
  60. package/dist/server-factory.d.ts +40 -0
  61. package/dist/server-factory.js +1741 -0
  62. package/dist/server-factory.spec.d.ts +2 -0
  63. package/dist/server.d.ts +3 -0
  64. package/dist/server.js +1690 -0
  65. package/dist/tools/create-memory.d.ts +94 -0
  66. package/dist/tools/delete-memory.d.ts +47 -0
  67. package/dist/tools/search-memory.d.ts +88 -0
  68. package/dist/types/memory.d.ts +183 -0
  69. package/dist/utils/logger.d.ts +7 -0
  70. package/dist/weaviate/client.d.ts +39 -0
  71. package/dist/weaviate/client.spec.d.ts +2 -0
  72. package/dist/weaviate/schema.d.ts +29 -0
  73. package/esbuild.build.js +60 -0
  74. package/esbuild.watch.js +25 -0
  75. package/jest.config.js +31 -0
  76. package/jest.e2e.config.js +17 -0
  77. package/package.json +68 -0
  78. package/src/.gitkeep +0 -0
  79. package/src/config.ts +56 -0
  80. package/src/constants/content-types.ts +454 -0
  81. package/src/firestore/init.ts +68 -0
  82. package/src/firestore/paths.spec.ts +75 -0
  83. package/src/firestore/paths.ts +124 -0
  84. package/src/server-factory.spec.ts +60 -0
  85. package/src/server-factory.ts +215 -0
  86. package/src/server.ts +243 -0
  87. package/src/tools/create-memory.ts +198 -0
  88. package/src/tools/delete-memory.ts +126 -0
  89. package/src/tools/search-memory.ts +216 -0
  90. package/src/types/memory.ts +276 -0
  91. package/src/utils/logger.ts +42 -0
  92. package/src/weaviate/client.spec.ts +58 -0
  93. package/src/weaviate/client.ts +114 -0
  94. package/src/weaviate/schema.ts +288 -0
  95. package/tsconfig.json +26 -0
package/.env.example ADDED
@@ -0,0 +1,65 @@
1
+ # Weaviate Configuration
2
+ WEAVIATE_URL=http://localhost:8080
3
+ WEAVIATE_API_KEY=
4
+
5
+ # LLM Provider Configuration
6
+ # Options: bedrock | openai | anthropic | cohere
7
+ LLM_PROVIDER=bedrock
8
+ LLM_MODEL=anthropic.claude-sonnet-4-5-20250929-v1:0
9
+
10
+ # AWS Bedrock Configuration (when LLM_PROVIDER=bedrock)
11
+ AWS_REGION=us-east-1
12
+ AWS_ACCESS_KEY_ID=
13
+ AWS_SECRET_ACCESS_KEY=
14
+ AWS_SESSION_TOKEN=
15
+
16
+ # OpenAI Configuration (when LLM_PROVIDER=openai)
17
+ # OPENAI_API_KEY=sk-...
18
+ # OPENAI_ORG_ID=
19
+
20
+ # Anthropic Direct Configuration (when LLM_PROVIDER=anthropic)
21
+ # ANTHROPIC_API_KEY=sk-ant-...
22
+
23
+ # Cohere Configuration (when LLM_PROVIDER=cohere)
24
+ # COHERE_API_KEY=
25
+
26
+ # Embeddings Provider Configuration (for Weaviate)
27
+ # Options: openai | cohere | huggingface
28
+ EMBEDDINGS_PROVIDER=openai
29
+ EMBEDDINGS_MODEL=text-embedding-3-small
30
+
31
+ # OpenAI Embeddings (when EMBEDDINGS_PROVIDER=openai)
32
+ OPENAI_EMBEDDINGS_API_KEY=sk-...
33
+
34
+ # Cohere Embeddings (when EMBEDDINGS_PROVIDER=cohere)
35
+ # COHERE_EMBEDDINGS_API_KEY=
36
+
37
+ # Firebase Admin Configuration (using firebase-admin-sdk-v8)
38
+ # For server-side operations (MCP server)
39
+ FIREBASE_ADMIN_SERVICE_ACCOUNT_KEY='{"type":"service_account","project_id":"remember-mcp-dev","private_key":"...","client_email":"..."}'
40
+ FIREBASE_PROJECT_ID=remember-mcp-dev
41
+
42
+ # Firebase Client Configuration (for utility scripts and client SDKs)
43
+ # These are safe to expose in client-side code
44
+ FIREBASE_CLIENT_API_KEY=
45
+ FIREBASE_CLIENT_AUTH_DOMAIN=
46
+ FIREBASE_CLIENT_PROJECT_ID=
47
+ FIREBASE_CLIENT_STORAGE_BUCKET=
48
+ FIREBASE_CLIENT_MESSAGING_SENDER_ID=
49
+ FIREBASE_CLIENT_APP_ID=
50
+ FIREBASE_CLIENT_MEASUREMENT_ID=
51
+
52
+ # Server Configuration
53
+ PORT=3000
54
+ NODE_ENV=development
55
+ LOG_LEVEL=info
56
+
57
+ # Environment Configuration (for multi-environment support)
58
+ # Development: e0, e1, e2, etc. (per developer/branch sandbox)
59
+ # Production: leave empty or set to 'production'
60
+ ENVIRONMENT=e0
61
+ # Or use custom prefix:
62
+ # DB_PREFIX=myname.remember-mcp
63
+
64
+ # MCP Configuration
65
+ MCP_TRANSPORT=sse