Service claw routing service

claw-routing-service

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

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

Persistence models

• AssistantModel
• CapabilityEvidence
• ModelCostVersion
• ModelDeployment
• ReplayCase
• ReplayRun
• RouterAdminOverride
• RouterChainEntry
• RouterCircuitBreaker
• RouterConfiguration
• RouterLearnedScore
• RouterModelProfile
• RouterModelRegistry
• RouterProviderAttempt
• RouterTopicProfile
• RouterWorkflow
• RouterWorkspacePrior
• RoutingCalibrationSnapshot
• RoutingCandidateScore
• RoutingDecision
• RoutingFeedbackRecord
• RoutingOutcomeRecord
• RoutingPolicy
• SeedExecution
• TaxonomyRole

HTTP API (76)

Method	Route	Source
GET	/health	health.controller.ts
GET	/internal/assistant-models/:role/candidates	assistant-models-internal.controller.ts
GET	/internal/router-models/context-window/:provider/:model	model-context-window-internal.controller.ts
GET	/internal/router-models/costs/:provider/:model	model-cost-internal.controller.ts
POST	/internal/router-models/costs/classes	model-cost-internal.controller.ts
GET	/router-models/costs	model-cost.controller.ts
POST	/router-models/costs	model-cost.controller.ts
GET	/router-models/costs/:provider/:model	model-cost.controller.ts
GET	/router-models/costs/:provider/:model/versions	model-cost.controller.ts
GET	/router-models/costs/catalog	model-cost.controller.ts
POST	/router-models/costs/estimate	model-cost.controller.ts
POST	/router-models/costs/price	model-cost.controller.ts
GET	/router-models/costs/unpriced	model-cost.controller.ts
GET	/router-models/intelligence/:provider/:model	model-intelligence.controller.ts
PATCH	/router-models/intelligence/:provider/:model	model-intelligence.controller.ts
POST	/router-models/intelligence/:provider/:model/reset	model-intelligence.controller.ts
GET	/routing/adaptive-insights	routing.controller.ts
GET	/routing/assistant-models/:role	assistant-models.controller.ts
PUT	/routing/assistant-models/:role	assistant-models.controller.ts
GET	/routing/circuit-breakers	reliability.controller.ts
GET	/routing/circuit-breakers/:scope	reliability.controller.ts
POST	/routing/circuit-breakers/:scope/reset	reliability.controller.ts
POST	/routing/classify	classifier.controller.ts
GET	/routing/configurations	router-configuration-admin.controller.ts
POST	/routing/configurations	router-configuration-admin.controller.ts
GET	/routing/configurations/:id	router-configuration-admin.controller.ts
PATCH	/routing/configurations/:id	router-configuration-admin.controller.ts
PATCH	/routing/configurations/:id/entries	router-configuration-admin.controller.ts
POST	/routing/configurations/:id/publish	router-configuration-admin.controller.ts
POST	/routing/configurations/disable	router-configuration-admin.controller.ts
POST	/routing/configurations/enable	router-configuration-admin.controller.ts
GET	/routing/configurations/selectable-deployments	router-configuration-admin.controller.ts
GET	/routing/decisions/:id/legacy-vs-cloud	routing.controller.ts
GET	/routing/decisions/:threadId	routing.controller.ts
GET	/routing/decisions/detail/:id	routing.controller.ts
POST	/routing/detect-language	language-detection.controller.ts
POST	/routing/detect-modality	modality-detection.controller.ts
GET	/routing/education/model-profiles	routing.controller.ts
GET	/routing/education/snapshot	routing.controller.ts
GET	/routing/education/topic-profiles	routing.controller.ts
POST	/routing/evaluate	routing.controller.ts
POST	/routing/evaluate-shadow	evaluate-shadow.controller.ts
POST	/routing/evaluate-v2	route-evaluator.controller.ts
POST	/routing/learning-loop/feedback	learning-loop.controller.ts
GET	/routing/learning-loop/profile/:profileKey	learning-loop.controller.ts
GET	/routing/models	router-models.controller.ts
POST	/routing/models	router-models.controller.ts
DELETE	/routing/models/:id	router-models.controller.ts
GET	/routing/models/:id	router-models.controller.ts
PATCH	/routing/models/:id	router-models.controller.ts
GET	/routing/models/:id/overrides	router-models.controller.ts
DELETE	/routing/models/:id/overrides/:fieldName	router-models.controller.ts
POST	/routing/models/discovery/run	router-models.controller.ts
POST	/routing/models/sync	router-sync.controller.ts
GET	/routing/observability/summary	observability.controller.ts
POST	/routing/playground/analyze-semantic	playground.controller.ts
GET	/routing/policies	routing.controller.ts
POST	/routing/policies	routing.controller.ts
DELETE	/routing/policies/:id	routing.controller.ts
GET	/routing/policies/:id	routing.controller.ts
PATCH	/routing/policies/:id	routing.controller.ts
GET	/routing/recovery/stats	routing.controller.ts
POST	/routing/replay	routing.controller.ts
POST	/routing/replay/cases/:caseId/promote	routing.controller.ts
POST	/routing/replay/cases/:caseId/review	routing.controller.ts
GET	/routing/replay/legacy-vs-cloud	routing.controller.ts
GET	/routing/replay/runs	routing.controller.ts
GET	/routing/replay/runs/:runId/cases	routing.controller.ts
GET	/routing/replay/runs/:runId/export	routing.controller.ts
GET	/routing/replay/runs/:runId/suspicious	routing.controller.ts
GET	/routing/replay/runs/compare	routing.controller.ts
POST	/routing/score	scoring.controller.ts
GET	/routing/taxonomy/domains	taxonomy.controller.ts
GET	/routing/taxonomy/roles	taxonomy.controller.ts
POST	/routing/taxonomy/roles	taxonomy.controller.ts
GET	/routing/taxonomy/roles/:id	taxonomy.controller.ts

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

• Publishes: log.server, message.routed, router.trace.emitted, routing.model_cost.published, routing.models.synced
• Consumes: connector.health_checked, connector.synced, llamacpp.model.crashed, llamacpp.model.loaded, llamacpp.model.unloaded, message.completed, message.created, model.deleted, model.pulled, routing.circuit_breaker.closed, routing.circuit_breaker.opened, routing.learned_score.updated, routing.profile.created, routing.profile.lifecycle_changed, routing.profile.updated