Service claw chat service

claw-chat-service

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

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

Persistence models

• ChatMessage
• ChatMessageContextReceipt
• ChatShare
• ChatShareMessage
• ChatShareMessageAsset
• ChatThread
• FileDeliveryRecord
• MessageAttachment
• PromptTemplate

HTTP API (74)

Method	Route	Source
POST	/chat-messages	chat-messages.controller.ts
GET	/chat-messages/:id	chat-messages.controller.ts
GET	/chat-messages/:id	chat-messages.controller.ts
GET	/chat-messages/:id/context-receipt	context-receipt.controller.ts
POST	/chat-messages/:id/context-save	context-save.controller.ts
POST	/chat-messages/:id/context-save/confirm	context-save.controller.ts
POST	/chat-messages/:id/context-save/dismiss	context-save.controller.ts
POST	/chat-messages/:id/edit	chat-messages.controller.ts
PATCH	/chat-messages/:id/feedback	chat-messages.controller.ts
GET	/chat-messages/:id/file-delivery	chat-messages.controller.ts
POST	/chat-messages/:id/regenerate	chat-messages.controller.ts
POST	/chat-messages/:id/save-to-context	context-save.controller.ts
GET	/chat-messages/:id/speech	chat-speech.controller.ts
POST	/chat-messages/:id/speech	chat-speech.controller.ts
POST	/chat-messages/:id/speech/cancel	chat-speech.controller.ts
GET	/chat-messages/admin/provider-breakers	provider-breaker-admin.controller.ts
DELETE	/chat-messages/admin/provider-breakers/:provider	provider-breaker-admin.controller.ts
POST	/chat-messages/best-of-n	chat-messages.controller.ts
POST	/chat-messages/consensus	chat-messages.controller.ts
POST	/chat-messages/cost-ensemble	chat-messages.controller.ts
POST	/chat-messages/decompose	chat-messages.controller.ts
POST	/chat-messages/escalation-chain	chat-messages.controller.ts
POST	/chat-messages/model-access	model-access.controller.ts
POST	/chat-messages/parallel	chat-messages.controller.ts
POST	/chat-messages/pipeline	chat-messages.controller.ts
POST	/chat-messages/repair	chat-messages.controller.ts
POST	/chat-messages/role-pack	chat-messages.controller.ts
POST	/chat-messages/runtime/runs	runtime-v2-run.controller.ts
POST	/chat-messages/runtime/runs/:runId/cancel	runtime-v2-command.controller.ts
POST	/chat-messages/runtime/runs/:runId/results	runtime-v2-command.controller.ts
POST	/chat-messages/runtime/runs/:runId/steering	runtime-v2-command.controller.ts
POST	/chat-messages/runtime/runs/:runId/tools	runtime-v2-tool-catalog.controller.ts
GET	/chat-messages/speech/availability	chat-speech.controller.ts
POST	/chat-messages/stream/:threadId/cancel	chat-stream.controller.ts
GET	/chat-messages/thread/:threadId	chat-messages.controller.ts
GET	/chat-messages/thread/:threadId/search	chat-messages.controller.ts
POST	/chat-messages/verify	chat-messages.controller.ts
GET	/chat-prompt-templates	prompt-library.controller.ts
POST	/chat-prompt-templates	prompt-library.controller.ts
DELETE	/chat-prompt-templates/:id	prompt-library.controller.ts
GET	/chat-prompt-templates/:id	prompt-library.controller.ts
PATCH	/chat-prompt-templates/:id	prompt-library.controller.ts
POST	/chat-prompt-templates/:id/use	prompt-library.controller.ts
GET	/chat-prompt-templates/tags	prompt-library.controller.ts
GET	/chat-threads	chat-threads.controller.ts
POST	/chat-threads	chat-threads.controller.ts
DELETE	/chat-threads/:id	chat-threads.controller.ts
GET	/chat-threads/:id	chat-threads.controller.ts
PATCH	/chat-threads/:id	chat-threads.controller.ts
GET	/chat-threads/:id/active-run	runtime-v2-thread-activity.controller.ts
POST	/chat-threads/:id/branch	chat-threads.controller.ts
GET	/chat-threads/:id/lineage	chat-threads.controller.ts
POST	/chat-threads/:id/preview-context	context-preview.controller.ts
POST	/chat-threads/:id/rewind	chat-threads.controller.ts
DELETE	/chat-threads/:threadId/share	chat-shares.controller.ts
GET	/chat-threads/:threadId/share	chat-shares.controller.ts
PATCH	/chat-threads/:threadId/share	chat-shares.controller.ts
POST	/chat-threads/:threadId/share	chat-shares.controller.ts
POST	/chat-threads/:threadId/share/refresh	chat-shares.controller.ts
POST	/chat-threads/:threadId/share/regenerate-url	chat-shares.controller.ts
GET	/coding-agent-chats	coding-agent-chats.controller.ts
GET	/coding-agent-chats/:id/messages	coding-agent-chats.controller.ts
GET	/health	health.controller.ts
GET	/internal/chat-shares/rss-feed	chat-shares-internal.controller.ts
GET	/internal/chat-shares/sitemap-count	chat-shares-internal.controller.ts
GET	/internal/chat-shares/sitemap-feed	chat-shares-internal.controller.ts
POST	/internal/chat/generate	chat-internal.controller.ts
POST	/internal/chat/generate-stream	chat-internal.controller.ts
GET	/internal/chat/model-authorization-metrics	chat-internal.controller.ts
POST	/internal/chat/threads/seeded	chat-threads-internal.controller.ts
POST	/internal/thread-snapshots/:threadId	thread-snapshot-internal.controller.ts
GET	/metrics	metrics.controller.ts
GET	/public/chat-shares/:publicShareId	public-chat-shares.controller.ts
GET	/public/chat-shares/:publicShareId/assets/:publicAssetId	public-chat-shares.controller.ts

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

• Publishes: chat_thread.context_toggled, chat_thread.memory_toggled, context.receipt_written, log.server, message.completed, message.created, message.feedback_set
• Consumes: chat.share.published, chat.share.revoked, chat.share.safety_rejected, chat.share.updated, chat.share.url_regenerated, chat.share.visibility_changed, connector.model_exposure_changed, message.routed, router.trace.emitted