harness

type DeepAgentConfig struct {
	// ID and Name identify the agent; they default to "deep-agent"/"Deep Agent".
	ID   string
	Name string

	// Model is the LLM provider driving the loop. Required.
	Model model.Provider

	// Storage, when set, makes the plan and virtual filesystem durable and
	// enables session compaction via Agent.ChatWithSession. It must implement
	// storage.SessionFileStore (sqlite and postgres do) to back the VFS. When nil,
	// the plan and VFS are in-memory (ephemeral) and compaction is unavailable
	// (compaction needs a session), so drive the agent with Agent.Chat.
	//
	// Note: the plan and VFS tools are session-scoped even in memory, so any call
	// path must carry a session-scoped context (storage.WithSession); ChatWithSession
	// does this automatically. For storageless use, wrap the context yourself:
	//	ctx = storage.WithSession(ctx, "some-session-id")
	Storage storage.Storage

	// MemoryManager, when set, is attached so cross-session semantic recall
	// (WC-D-001) is available; recall is on by default when the manager has a
	// vector index.
	MemoryManager *memory.Manager

	// Broker, when set, receives plan-update stream events.
	Broker *stream.Broker

	// SystemPrompt overrides DefaultDeepAgentSystemPrompt.
	SystemPrompt string

	// Instructions are appended as additional system-level guidance.
	Instructions []string

	// SubAgents pre-registers named specialist templates the agent can select by
	// name via spawn_subagent (it can also define subagents dynamically).
	SubAgents []SubAgentSpec

	// MaxSubAgentDepth bounds subagent nesting; <= 0 uses DefaultMaxSubAgentDepth.
	MaxSubAgentDepth int

	// DisableSubAgents omits the spawn_subagent tool entirely.
	DisableSubAgents bool

	// SubAgentRunner overrides the execution strategy for subagents; nil uses an
	// in-process runner. Pass a QueuedRunner for durable, relocatable subagents.
	SubAgentRunner Runner

	// ExtraTools and ExtraToolkits add domain tools (e.g. web search, SQL) on top
	// of the harness primitives. Subagents may be granted these by name.
	ExtraTools    []*tool.Definition
	ExtraToolkits []*tool.Toolkit

	// Context overrides the compaction policy; nil uses defaultDeepAgentContext.
	// The active plan is pinned regardless, so it is never summarized away.
	Context *agent.ContextConfig
}

type InProcessRunner struct {
	// contains filtered or unexported fields
}

type Option func(*SubAgentService)

type QueuedOption func(*QueuedRunner)

type QueuedRunner struct {
	// contains filtered or unexported fields
}

type Runner interface {
	Run(ctx context.Context, spec SubAgentSpec, task string) (string, error)
}

type SubAgentService struct {
	// contains filtered or unexported fields
}

type SubAgentSpec struct {
	// Name identifies the subagent (used as its agent id and, for registered
	// specs, the key the parent selects it by).
	Name string `json:"name"`
	// Description is a human-readable summary surfaced to the model.
	Description string `json:"description,omitempty"`
	// SystemPrompt is the subagent's system prompt; it defines its role.
	SystemPrompt string `json:"system_prompt,omitempty"`
	// Instructions are additional system-level instructions.
	Instructions []string `json:"instructions,omitempty"`
	// ToolNames selects which of the parent's tools the subagent may use. An
	// empty list gives the subagent no tools (pure reasoning). Names not present
	// in the parent registry are rejected at build time.
	ToolNames []string `json:"tool_names,omitempty"`
}