CloudflareConfig

Defined in: backend/src/providers/cloudflare.ts:96

Configuration options for backend adapters.

Extends

BackendAdapterConfig

Properties

accountId?

optional accountId: string

Defined in: backend/src/providers/cloudflare.ts:97

apiKey

readonly apiKey: string

Defined in: ai.matey.types/dist/types/adapters.d.ts:103

API key for authentication. Should be injected from environment or secure config.

Inherited from

BackendAdapterConfig.apiKey

baseURL?

readonly optional baseURL: string

Defined in: ai.matey.types/dist/types/adapters.d.ts:108

Base URL for API endpoint. Useful for proxies or alternative endpoints.

Inherited from

BackendAdapterConfig.baseURL

browserMode?

readonly optional browserMode: boolean

Defined in: ai.matey.types/dist/types/adapters.d.ts:155

Enable browser-compatible mode.

⚠️ SECURITY WARNING: Enabling browser mode may expose API keys in client-side code. This option should ONLY be used for development and testing. Production applications should always use proxy servers to protect API keys.

Each provider implements browser compatibility differently:

Anthropic: Adds anthropic-dangerous-direct-browser-access: true header
Gemini: Already browser-compatible (API key in URL), this flag has no effect
OpenAI: Already browser-compatible, this flag has no effect
Other providers: May have provider-specific implementations

Default

false

Example

// Development only - DO NOT use in production!
const backend = new AnthropicBackendAdapter({
  apiKey: process.env.ANTHROPIC_API_KEY,
  browserMode: true  // ⚠️ Exposes API key in browser
});

Inherited from

BackendAdapterConfig.browserMode

cacheModels?

readonly optional cacheModels: boolean

Defined in: ai.matey.types/dist/types/adapters.d.ts:181

Enable model list caching.

Default

true

Inherited from

BackendAdapterConfig.cacheModels

custom?

readonly optional custom: Record<string, unknown>

Defined in: ai.matey.types/dist/types/adapters.d.ts:131

Provider-specific configuration options.

Inherited from

BackendAdapterConfig.custom

debug?

readonly optional debug: boolean

Defined in: ai.matey.types/dist/types/adapters.d.ts:123

Enable debug logging.

Default

false

Inherited from

BackendAdapterConfig.debug

defaultModel?

readonly optional defaultModel: string

Defined in: ai.matey.types/dist/types/adapters.d.ts:162

Default model to use when no model is specified in the request. This provides a fallback model for requests that don’t specify one.

Example

'gpt-4o' for OpenAI, 'claude-3-5-sonnet-20241022' for Anthropic

Inherited from

BackendAdapterConfig.defaultModel

headers?

readonly optional headers: Record<string, string>

Defined in: ai.matey.types/dist/types/adapters.d.ts:127

Custom HTTP headers to include in requests.

Inherited from

BackendAdapterConfig.headers

maxRetries?

readonly optional maxRetries: number

Defined in: ai.matey.types/dist/types/adapters.d.ts:118

Maximum number of retries for transient failures.

Default

Inherited from

BackendAdapterConfig.maxRetries

models?

readonly optional models: readonly (string | AIModel)[]

Defined in: ai.matey.types/dist/types/adapters.d.ts:171

Static model list (used when provider doesn’t have listing endpoint or to override remote list).

Can be either:

Array of model IDs (strings) - will be normalized to AIModel objects
Array of full AIModel objects with capabilities

Inherited from

BackendAdapterConfig.models

modelsCacheScope?

readonly optional modelsCacheScope: "global" | "instance"

Defined in: ai.matey.types/dist/types/adapters.d.ts:193

Cache scope strategy.

‘global’: Share cache across all adapter instances (default)
‘instance’: Each adapter instance has its own cache

Default

'global'

Inherited from

BackendAdapterConfig.modelsCacheScope

modelsCacheTTL?

readonly optional modelsCacheTTL: number

Defined in: ai.matey.types/dist/types/adapters.d.ts:186

Cache TTL in milliseconds.

Default

3600000 (1 hour)

Inherited from

BackendAdapterConfig.modelsCacheTTL

modelsEndpoint?

readonly optional modelsEndpoint: string

Defined in: ai.matey.types/dist/types/adapters.d.ts:176

URL endpoint for fetching models (overrides default). Used for custom model endpoints or proxies.

Inherited from

BackendAdapterConfig.modelsEndpoint

streaming?

readonly optional streaming: StreamingConfig

Defined in: ai.matey.types/dist/types/adapters.d.ts:204

Streaming configuration for this backend.

Controls how streaming responses are delivered:

mode: ‘delta’ (incremental only) or ‘accumulated’ (full text each chunk)
includeBoth: Whether to provide both delta and accumulated in chunks
bufferStrategy: How to buffer for accumulated mode

Default

{ mode: 'delta', includeBoth: false, bufferStrategy: 'memory' }

Inherited from

BackendAdapterConfig.streaming

timeout?

readonly optional timeout: number

Defined in: ai.matey.types/dist/types/adapters.d.ts:113

Request timeout in milliseconds.

Default

Inherited from

BackendAdapterConfig.timeout