Interface: AgentRuntimeMutationManagerConfig
Makaio Framework / ai-adapters-core / AgentRuntimeMutationManagerConfig
Interface: AgentRuntimeMutationManagerConfig
Section titled “Interface: AgentRuntimeMutationManagerConfig”Defined in: ../../../adapters/core/src/agent/agent-runtime-mutation-manager.ts:28
Dependencies for runtime mutation handling.
Properties
Section titled “Properties”agentId
Section titled “agentId”agentId:
string
Defined in: ../../../adapters/core/src/agent/agent-runtime-mutation-manager.ts:30
Stable agent identifier.
emitCwdChanged
Section titled “emitCwdChanged”emitCwdChanged: (
payload) =>Promise<void>
Defined in: ../../../adapters/core/src/agent/agent-runtime-mutation-manager.ts:42
Emit cwd.changed payload.
Parameters
Section titled “Parameters”payload
Section titled “payload”Omit<ExtractSubjectPayload<typeof AgentSubjects.cwd.changed>, "agentId" | "adapterId" | "adapterName" | "adapterSessionId">
Returns
Section titled “Returns”Promise<void>
emitModelChanged
Section titled “emitModelChanged”emitModelChanged: (
payload) =>Promise<void>
Defined in: ../../../adapters/core/src/agent/agent-runtime-mutation-manager.ts:49
Emit model.changed payload.
Parameters
Section titled “Parameters”payload
Section titled “payload”Omit<ExtractSubjectPayload<typeof AgentSubjects.model.changed>, "agentId" | "adapterId" | "adapterName" | "adapterSessionId">
Returns
Section titled “Returns”Promise<void>
getConnector
Section titled “getConnector”getConnector: () =>
AIAgentConnector
Defined in: ../../../adapters/core/src/agent/agent-runtime-mutation-manager.ts:36
Read current connector.
Returns
Section titled “Returns”getProviderContext
Section titled “getProviderContext”getProviderContext: () => {
ambientCredentialEnvVars?:string[];credentialEnvVars?:Record<string,string>;credentialRefs:Record<string,string&$brand<"CredentialRef">>;definitionId:string;endpointOverrides?: {anthropic?:string;openai?:string; };providerConfigId:string; } |undefined
Defined in: ../../../adapters/core/src/agent/agent-runtime-mutation-manager.ts:60
Read the agent’s current provider context for no-op detection. Returns undefined during rehydration or when the orchestrator has not yet resolved credentials for this agent.
Returns
Section titled “Returns”Type Literal
Section titled “Type Literal”{ ambientCredentialEnvVars?: string[]; credentialEnvVars?: Record<string, string>; credentialRefs: Record<string, string & $brand<"CredentialRef">>; definitionId: string; endpointOverrides?: { anthropic?: string; openai?: string; }; providerConfigId: string; }
ambientCredentialEnvVars?
Section titled “ambientCredentialEnvVars?”
optionalambientCredentialEnvVars?:string[]
Provider credential environment variables known to the host.
Subprocess adapters remove these from ambient process.env before spawning
clients, then add back only credentials explicitly resolved from
credentialRefs.
credentialEnvVars?
Section titled “credentialEnvVars?”
optionalcredentialEnvVars?:Record<string,string>
Maps credential keys to environment variable names for subprocess adapters.
E.g., { apiKey: 'ANTHROPIC_API_KEY' }.
credentialRefs
Section titled “credentialRefs”credentialRefs:
Record<string,string&$brand<"CredentialRef">>
Credential references resolved at the connector layer, not on the bus.
definitionId
Section titled “definitionId”definitionId:
string
Provider definition ID (e.g., 'anthropic', 'alibaba').
endpointOverrides?
Section titled “endpointOverrides?”
optionalendpointOverrides?:object
Endpoint URL overrides keyed by protocol.
endpointOverrides.anthropic?
Section titled “endpointOverrides.anthropic?”
optionalanthropic?:string
endpointOverrides.openai?
Section titled “endpointOverrides.openai?”
optionalopenai?:string
providerConfigId
Section titled “providerConfigId”providerConfigId:
string
Provider config UUID. Links back to the ProviderConfig that produced this context.
undefined
globalBus
Section titled “globalBus”globalBus:
IMakaioBus
Defined in: ../../../adapters/core/src/agent/agent-runtime-mutation-manager.ts:34
Global bus for persistence and events.
resolveSupportedReasoningLevels
Section titled “resolveSupportedReasoningLevels”resolveSupportedReasoningLevels: (
model) => {extra-high?:string|number;high?:string|number;low?:string|number;medium?:string|number;none?:string|number; } |undefined
Defined in: ../../../adapters/core/src/agent/agent-runtime-mutation-manager.ts:70
Resolve supported reasoning levels for a model from the agent’s available models.
Parameters
Section titled “Parameters”string
Returns
Section titled “Returns”{ extra-high?: string | number; high?: string | number; low?: string | number; medium?: string | number; none?: string | number; } | undefined
sessionId?
Section titled “sessionId?”
optionalsessionId?:string
Defined in: ../../../adapters/core/src/agent/agent-runtime-mutation-manager.ts:32
Optional Makaio session identifier.
setProviderContext
Section titled “setProviderContext”setProviderContext: (
providerContext) =>void
Defined in: ../../../adapters/core/src/agent/agent-runtime-mutation-manager.ts:66
Persist provider context changes on agent config for sequential swaps.
Called after a connector swap driven by a provider change so subsequent
buildConfigInput calls carry the updated context.
Parameters
Section titled “Parameters”providerContext
Section titled “providerContext”ambientCredentialEnvVars?
Section titled “ambientCredentialEnvVars?”string[] = ...
Provider credential environment variables known to the host.
Subprocess adapters remove these from ambient process.env before spawning
clients, then add back only credentials explicitly resolved from
credentialRefs.
credentialEnvVars?
Section titled “credentialEnvVars?”Record<string, string> = ...
Maps credential keys to environment variable names for subprocess adapters.
E.g., { apiKey: 'ANTHROPIC_API_KEY' }.
credentialRefs
Section titled “credentialRefs”Record<string, string & $brand<"CredentialRef">> = ...
Credential references resolved at the connector layer, not on the bus.
definitionId
Section titled “definitionId”string = ...
Provider definition ID (e.g., 'anthropic', 'alibaba').
endpointOverrides?
Section titled “endpointOverrides?”{ anthropic?: string; openai?: string; } = ...
Endpoint URL overrides keyed by protocol.
endpointOverrides.anthropic?
Section titled “endpointOverrides.anthropic?”string = ...
endpointOverrides.openai?
Section titled “endpointOverrides.openai?”string = ...
providerConfigId
Section titled “providerConfigId”string = ...
Provider config UUID. Links back to the ProviderConfig that produced this context.
Returns
Section titled “Returns”void
setReasoningEffort
Section titled “setReasoningEffort”setReasoningEffort: (
reasoningEffort) =>void
Defined in: ../../../adapters/core/src/agent/agent-runtime-mutation-manager.ts:68
Persist reasoning effort changes on agent config for sequential swaps.
Parameters
Section titled “Parameters”reasoningEffort
Section titled “reasoningEffort”"none" | "low" | "medium" | "high" | "extra-high" | undefined
Returns
Section titled “Returns”void
swapConnector
Section titled “swapConnector”swapConnector: (
configOverrides?) =>Promise<void>
Defined in: ../../../adapters/core/src/agent/agent-runtime-mutation-manager.ts:38
Swap connector with runtime overrides.
Parameters
Section titled “Parameters”configOverrides?
Section titled “configOverrides?”Partial<{ cwd: string; model: string; providerContext: { ambientCredentialEnvVars?: string[]; credentialEnvVars?: Record<string, string>; credentialRefs: Record<string, string & $brand<"CredentialRef">>; definitionId: string; endpointOverrides?: { anthropic?: string; openai?: string; }; providerConfigId: string; }; }>
Returns
Section titled “Returns”Promise<void>