Skip to main content
SCSyndicate Code
Get Started

Providers Catalog

Catalog source

Syndicate Code fetches provider and model catalog data from:

https://models.dev/api.json

Catalog providers are OpenAI Chat Completions compatible, and the catalog exposes 105+ providers (provider_routing_and_model_abstraction_spec.md §4.6).

Caching and fallback

Default cache policy (provider_routing_and_model_abstraction_spec.md §4.6.2):

  • cache path: $XDG_CACHE_HOME/syndicate/models-catalog.json
  • TTL: 24 hours
  • fetch timeout: 10 seconds

Failure handling:

  • live fetch fails + stale cache exists: stale cache is used and provider.catalog_stale is emitted
  • live fetch fails + no cache: embedded fallback catalog (go:embed) is used
  • fetch transport must be HTTPS; TLS errors fail without bypass

Provider command patterns

# List all discovered and registered providers
syndicate provider list
syndicate provider list --output json

# Register a provider from configuration
syndicate provider register <config-file>

# Add-style examples listed in docs-site tasks and master plan
syndicate provider add anthropic
syndicate provider add openai

# Add an OpenAI-compatible local endpoint
syndicate provider add my-local --wire-format openai --url http://localhost:11434/v1

# Probe provider connectivity and capability conformance
syndicate provider test anthropic

# View capability dimensions for a provider
syndicate provider capabilities anthropic

# Remove a provider
syndicate provider remove my-local

Credential input is interactive for add-style flows; secrets are not passed as plain CLI flags in that path.

Mid-session model switch

Model switching is supported during active sessions (provider_routing_and_model_abstraction_spec.md §13):

  • session context is preserved
  • if incoming capability class is higher, active execution envelope is re-evaluated
  • if envelope max capability is exceeded, envelope is invalidated and checkpoint is triggered
  • if capability class is same or lower, envelope remains valid

Every switch emits provider_switch with outgoing/incoming identity, trigger source, compaction signal, capability-class delta, and approval-fingerprint impact (provider_routing_and_model_abstraction_spec.md §13.5).

What changes:

  • active provider/model in title bar and governance panel

What does not change:

  • session identity
  • trust boundary history
  • audit-chain continuity