Struct LocalRuntime

pkg/runtime/runtime.go:207–328

LocalRuntime manages the execution of agents

// LocalRuntime manages the execution of agents
type LocalRuntime struct {
	ctx                       func() context.Context
	toolMap                   map[string]ToolHandlerFunc
	team                      *team.Team
	agents                    *agentRouter
	resumeChan                chan ResumeRequest
	tracer                    trace.Tracer
	modelsStore               ModelStore
	sessionCompaction         bool
	managedOAuth              bool
	unmanagedOAuthRedirectURI string
	nonInteractive            bool
	startupInfoEmitted        bool                   // Track if startup info has been emitted to avoid unnecessary duplication
	elicitationRequestCh      chan ElicitationResult // Channel for receiving elicitation responses
	elicitation               elicitationBridge      // Owns the per-stream events channel for outbound elicitation requests
	sessionStore              session.Store
	workingDir                string   // Working directory for hooks execution
	env                       []string // Environment variables for hooks execution
	modelSwitcherCfg          *ModelSwitcherConfig
	providerRegistry          *provider.Registry
	gatewayModels             gatewayModelsCache
	dmrModels                 dmrModelsCache

	// hooksRegistry is the runtime-private hooks.Registry used to build
	// every Executor. It carries the runtime-owned builtin hooks
	// (add_date, add_environment_info) registered once during
	// NewLocalRuntime, so they're available to every agent without
	// touching any process-wide state.
	hooksRegistry *hooks.Registry

	// autoInjectors run on every per-agent hook config during
	// [buildHooksExecutors] so embedders can plug in builtins (today
	// snapshot via [builtins.SnapshotController]) without the runtime
	// hard-coding their wiring. Set via [WithAutoInjector].
	autoInjectors []builtins.AutoInjector

	// hooksExecByAgent holds the per-agent [hooks.Executor], keyed by
	// agent name. Built once in [NewLocalRuntime.buildHooksExecutors]
	// after team and runtime config are finalized; agents with no hooks
	// have no entry, so [hooksExec] returns nil for them. Read-only after
	// construction, so no locking is needed.
	hooksExecByAgent map[string]*hooks.Executor

	// transforms is the runtime's [MessageTransform] chain, applied to
	// every LLM call in registration order. Populated by
	// [NewLocalRuntime] (for the runtime-shipped strip transform) and by
	// [WithMessageTransform] (for embedder-supplied transforms).
	// Read-only after construction.
	transforms []registeredTransform

	fallback *fallbackExecutor

	// observers receive every event the runtime produces, in
	// registration order. Built up via [WithEventObserver] during
	// construction; read-only afterwards. Always contains at least one
	// entry: the auto-registered [PersistenceObserver] for the
	// configured session store. See [EventObserver] for the contract.
	observers []EventObserver