Service claw connector service

claw-connector-service

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

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

Persistence models

• Connector
• ConnectorHealthEvent
• ConnectorModel
• ConnectorProviderDefinition
• ModelSyncRun

HTTP API (29)

Method	Route	Source
GET	/connectors	connectors.controller.ts
POST	/connectors	connectors.controller.ts
DELETE	/connectors/:id	connectors.controller.ts
GET	/connectors/:id	connectors.controller.ts
GET	/connectors/:id	connectors.controller.ts
PATCH	/connectors/:id	connectors.controller.ts
GET	/connectors/:id/models	connectors.controller.ts
POST	/connectors/:id/models/:modelKey/probe-tools	connectors.controller.ts
PUT	/connectors/:id/models/exposure	connectors.controller.ts
PUT	/connectors/:id/models/prompt-caching	connectors.controller.ts
POST	/connectors/:id/sync	connectors.controller.ts
POST	/connectors/:id/test	connectors.controller.ts
GET	/connectors/available-models	connectors.controller.ts
GET	/connectors/provider-definitions	provider-definitions.controller.ts
POST	/connectors/provider-definitions	provider-definitions.controller.ts
DELETE	/connectors/provider-definitions/:id	provider-definitions.controller.ts
GET	/connectors/provider-definitions/:id	provider-definitions.controller.ts
PATCH	/connectors/provider-definitions/:id	provider-definitions.controller.ts
PATCH	/connectors/provider-definitions/:id/status	provider-definitions.controller.ts
GET	/health	health.controller.ts
GET	/internal/connectors/config	connectors-internal.controller.ts
GET	/internal/connectors/credit-headroom	credit-headroom-internal.controller.ts
GET	/internal/connectors/health-snapshot	connectors-internal.controller.ts
GET	/internal/connectors/models-snapshot	connectors-internal.controller.ts
POST	/internal/connectors/models/output-limit	model-output-limit-internal.controller.ts
POST	/internal/connectors/models/unavailable	model-unavailable-internal.controller.ts
POST	/internal/connectors/models/validate-exposed	connectors-internal.controller.ts
GET	/internal/connectors/payg-policy	connectors-internal.controller.ts
GET	/internal/connectors/public-catalog	public-model-catalog.controller.ts

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

• Publishes: connector.created, connector.deleted, connector.health_checked, connector.model_exposure_changed, connector.synced, connector.updated, log.server
• Consumes: none found