Function NewLocalRuntime

pkg/runtime/runtime.go:567–700

NewLocalRuntime creates a new LocalRuntime without the persistence wrapper. This is useful for testing or when persistence is handled externally.

(ctx context.Context, agents *team.Team, opts ...Opt)

// NewLocalRuntime creates a new LocalRuntime without the persistence wrapper.
// This is useful for testing or when persistence is handled externally.
func NewLocalRuntime(ctx context.Context, agents *team.Team, opts ...Opt) (*LocalRuntime, error) {
	defaultAgent, err := agents.DefaultAgent()
	if err != nil {
		return nil, err
	}

	r := &LocalRuntime{
		ctx:                    func() context.Context { return context.WithoutCancel(ctx) },
		toolMap:                make(map[string]ToolHandlerFunc),
		team:                   agents,
		agents:                 newAgentRouter(agents, defaultAgent.Name()),
		resumeChan:             make(chan ResumeRequest),
		elicitationRequestCh:   make(chan ElicitationResult),
		steerQueue:             NewInMemoryMessageQueue(defaultSteerQueueCapacity),
		followUpQueue:          NewInMemoryMessageQueue(defaultFollowUpQueueCapacity),
		sessionCompaction:      true,
		managedOAuth:           true,
		sessionStore:           session.NewInMemorySessionStore(),
		fallback:               newFallbackExecutor(),
		now:                    time.Now,
		telemetry:              defaultTelemetry{},
		providerRegistry:       provider.DefaultRegistry(),
		maxOverflowCompactions: defaultMaxOverflowCompactions,
		toolListTimeout:        defaultToolListTimeout,
		toolStartTimeout:       defaultToolStartTimeout,
		dmrModelLister:         dmr.ListModels,
	}
	r.bgAgents = agenttool.NewHandler(r)

	// stripUnsupportedModalitiesTransform captures the runtime closure to
	// resolve the agent from Input.AgentName, so it lives here rather
	// than as a stateless builtin in pkg/hooks/builtins. It drops image
	// content for text-only models on every model call.
	//
	// redact_secrets used to live here as a sibling [MessageTransform];
	// it now ships entirely as a [hooks.BuiltinFunc] in
	// pkg/hooks/builtins/redact_secrets.go and is wired into all three
	// of pre_tool_use, before_llm_call, and tool_response_transform via
	// [builtins.ApplyAgentDefaults] (or a user's hooks YAML directly),
	// so the rewrite path is the same for every leak vector and there
	// is no flag-only code path to keep in sync.
	r.transforms = append(r.transforms,
		registeredTransform{
			name: BuiltinStripUnsupportedModalities,
			fn:   r.stripUnsupportedModalitiesTransform,
		},
	)

	for _, opt := range opts {
		opt(r)
	}

	// Set up the hooks registry. Use the embedder-supplied registry
	// (via [WithHooksRegistry]) when present so any builtins the
	// embedder pre-registered — typically the snapshot builtin from
	// [builtins.RegisterSnapshot] — are visible to the runtime, then
	// register the runtime-owned builtins on top.
	if r.hooksRegistry == nil {