Interface: BaseAgentConnectorConfig<TBus, TProviderConfig>

Directory restrictions for file-system tool execution. When set, forwarded as constraints.allowedDirectories in every tool call. Empty array means no restriction; undefined means no restriction.

bus

bus: TBus

Defined in: ../../../adapters/core/src/agent/types.ts:73

Inherited from

MinimalAgentConnectorConfig.bus

clientId?

optional clientId?: string

Defined in: ../../../adapters/core/src/agent/types.ts:127

Client identifier for the application this adapter belongs to (e.g., ‘claude-code’, ‘gemini’).

cwd

cwd: string

Defined in: ../../../adapters/core/src/agent/types.ts:40

Working directory for agent execution (optional - platform provides default)

Inherited from

AIAgentConfig.cwd

env?

optional env?: Record<string, string>

Defined in: ../../../adapters/core/src/agent/types.ts:42

Environment variables to pass to agent execution

Inherited from

AIAgentConfig.env

errorHandler?

optional errorHandler?: (error, terminate) => void

Defined in: ../../../adapters/core/src/agent/types.ts:86

Parameters

error

Error

terminate

boolean

Returns

void

harnessId?

optional harnessId?: string

Defined in: ../../../adapters/core/src/agent/types.ts:124

Resolved harness ID for tool policy lookup.

mcpSessionContext?

optional mcpSessionContext?: LedgerSessionContext

Defined in: ../../../adapters/core/src/agent/types.ts:149

MCP session context resolved by the orchestrator. Provides the direct and discoverable tool sets for the current session. When present, enables MCP tool injection and ledger tracking.

Intentionally narrowed to LedgerSessionContext — the minimal shape the ledger needs. Adapters requiring the full McpSessionContext (with resolution keys / servers) re-declare this field via Omit + intersection in their own config types (e.g. BaseStreamConnectorConfig, ClaudeAgentConfig).

model

model: string

Defined in: ../../../adapters/core/src/agent/types.ts:38

Model to use (optional - adapter provides default)

Inherited from

AIAgentConfig.model

onMessageSent?

optional onMessageSent?: (messageHandle) => void

Defined in: ../../../adapters/core/src/agent/types.ts:130

Callback when a user message is enqueued

Parameters

messageHandle

MessageHandle

Returns

void

providerConfig?

optional providerConfig?: TProviderConfig

Defined in: ../../../adapters/core/src/agent/types.ts:110

providerConfigId?

optional providerConfigId?: string

Defined in: ../../../adapters/core/src/agent/types.ts:98

UUID of the ProviderConfig entity used during agent creation. Carried on the connector config for runtime introspection and dynamic provider switching.

providerContext?

optional providerContext?: object

Defined in: ../../../adapters/core/src/agent/types.ts:108

Unresolved provider context (credential refs, not plaintext).

Passed through from the factory input so connectors can call resolveConnectorCredentials() locally during initialization. Connectors must NOT read plaintext credentials from this field — they must resolve refs via resolveConnectorCredentials().

credentialEnvVars?

optional credentialEnvVars?: Record<string, string>

Maps credential keys to environment variable names for subprocess adapters. E.g., { apiKey: 'ANTHROPIC_API_KEY' }.

credentialRefs

credentialRefs: Record<string, string & $brand<"CredentialRef">>

Credential references resolved at the connector layer, not on the bus.

definitionId

definitionId: string

Provider definition ID (e.g., 'anthropic', 'alibaba').

endpointOverrides?

optional endpointOverrides?: object

Endpoint URL overrides keyed by protocol.

endpointOverrides.anthropic?

optional anthropic?: string

endpointOverrides.openai?

optional openai?: string

providerConfigId

providerConfigId: string

Provider config UUID. Links back to the ProviderConfig that produced this context.

reasoningEffort?

optional reasoningEffort?: "none" | "low" | "medium" | "high" | "extra-high"

Defined in: ../../../adapters/core/src/agent/types.ts:44

Reasoning effort for supporting adapters

Inherited from

AIAgentConfig.reasoningEffort

resumeAdapterSessionId?

optional resumeAdapterSessionId?: string

Defined in: ../../../adapters/core/src/agent/types.ts:121

Previous adapter session ID for resume attempts.

sessionId?

optional sessionId?: string

Defined in: ../../../adapters/core/src/agent/types.ts:85

Makaio session ID for tool execution context and multi-session correlation

supportedReasoningLevels?

optional supportedReasoningLevels?: object

Defined in: ../../../adapters/core/src/agent/types.ts:118

Maps supported reasoning levels to provider-native values for the active model.

Populated by the config factory when the resolved model declares reasoning support. Absent when the model does not support extended thinking.

extra-high?

optional extra-high?: string | number = reasoningLevelValue

high?

optional high?: string | number = reasoningLevelValue

low?

optional low?: string | number = reasoningLevelValue

medium?

optional medium?: string | number = reasoningLevelValue

none?

optional none?: string | number = reasoningLevelValue

timeouts?

optional timeouts?: TrackedTimeoutConfig

Defined in: ../../../adapters/core/src/agent/types.ts:92

Resolved timeout configuration with provenance tracking. Set by configFactory after merging all timeout layers.

toolLedger?

optional toolLedger?: ISessionToolLedger

Defined in: ../../../adapters/core/src/agent/types.ts:155

Session-scoped tool ledger for tracking injection, discovery, and call history. When present, the connector records tool events into this ledger.