Service claw memory service

claw-memory-service

Rendered from .ai/manifests/ on every publish. Rules for this service: CLAUDE.md · guide: service guide.

Property	Value
Directory	apps/claw-memory-service
Port	4005
Database	postgresql
Test files	24 (vitest)
Internal packages	@claw/shared-auth, @claw/shared-constants, @claw/shared-entitlements, @claw/shared-rabbitmq, @claw/shared-types, @claw/shared-utilities

Persistence models

• ContextPack
• ContextPackAttachment
• ContextPackItem
• ContextPackTemplate
• ContextPackUsage
• ContextPackVersion
• MemoryAuditLog
• MemoryPreference
• MemoryRecord
• MemorySuggestion
• MemoryUsage
• WorkspaceObjectEmbedding

HTTP API (51)

Method	Route	Source
GET	/context-pack-templates	context-pack-templates.controller.ts
POST	/context-pack-templates/:id/clone	context-pack-templates.controller.ts
GET	/context-packs	context-packs.controller.ts
POST	/context-packs	context-packs.controller.ts
DELETE	/context-packs/:id	context-packs.controller.ts
GET	/context-packs/:id	context-packs.controller.ts
PATCH	/context-packs/:id	context-packs.controller.ts
GET	/context-packs/:id/export	context-pack-portable.controller.ts
POST	/context-packs/:id/items	context-packs.controller.ts
DELETE	/context-packs/:id/items/:itemId	context-packs.controller.ts
GET	/context-packs/:id/versions	context-pack-versions.controller.ts
GET	/context-packs/:id/versions/:from/diff/:to	context-pack-versions.controller.ts
GET	/context-packs/:id/versions/:version	context-pack-versions.controller.ts
POST	/context-packs/:id/versions/:version/revert	context-pack-versions.controller.ts
POST	/context-packs/:id/versions/snapshot	context-pack-versions.controller.ts
POST	/context-packs/import	context-pack-portable.controller.ts
GET	/health	health.controller.ts
GET	/internal/context-packs/:id/items	context-packs-internal.controller.ts
POST	/internal/context-packs/:id/items/from-chat	context-packs-internal.controller.ts
POST	/internal/context-packs/for-chat	context-packs-internal.controller.ts
POST	/internal/context-packs/options-for-chat	context-packs-internal.controller.ts
POST	/internal/context-packs/save-from-chat	context-packs-internal.controller.ts
POST	/internal/embeddings/delete-by-object-id	embeddings.controller.ts
POST	/internal/embeddings/search-workspace-objects	embeddings.controller.ts
POST	/internal/embeddings/upsert-workspace-object	embeddings.controller.ts
POST	/internal/memories/automation-preference	memory-internal.controller.ts
GET	/internal/memories/for-context	memory-internal.controller.ts
GET	/internal/memories/learned-preferences	memory-internal.controller.ts
POST	/internal/memories/record-usage	memory-retrieval.controller.ts
POST	/internal/memories/retrieve	memory-retrieval.controller.ts
POST	/internal/memories/save-from-chat	memory-internal.controller.ts
GET	/memories	memory.controller.ts
POST	/memories	memory.controller.ts
GET	/memories-portable/export	memory-portable.controller.ts
POST	/memories-portable/import	memory-portable.controller.ts
DELETE	/memories/:id	memory.controller.ts
GET	/memories/:id	memory.controller.ts
PATCH	/memories/:id	memory.controller.ts
PATCH	/memories/:id/toggle	memory.controller.ts
POST	/memories/search	memory.controller.ts
GET	/memory-audit	memory-audit.controller.ts
GET	/memory-audit/:memoryId	memory-audit.controller.ts
GET	/memory-preferences	memory-preferences.controller.ts
PUT	/memory-preferences	memory-preferences.controller.ts
GET	/memory-suggestions	memory-suggestions.controller.ts
DELETE	/memory-suggestions/:id	memory-suggestions.controller.ts
POST	/memory-suggestions/:id/approve	memory-suggestions.controller.ts
POST	/memory-suggestions/:id/reject	memory-suggestions.controller.ts
POST	/memory-suggestions/bulk-approve	memory-suggestions.controller.ts
GET	/memory-usage/by-memory/:memoryId	memory-usage.controller.ts
GET	/memory-usage/by-message/:messageId	memory-usage.controller.ts

Events (inferred from source; verify before a critical change)

• Publishes: context_pack.version_created, context_pack.version_reverted, log.server, memory.approved, memory.extracted, memory.forgotten, memory.redacted, memory.rejected, memory.suggested
• Consumes: message.completed