core

type Config struct {
	Model        ac.ChatModel
	SystemPrompt string
	Tools        []ac.Tool
	Skills       *skill.Set
	Store        memory.Store
	Recaller     memory.Recaller
	AgentID      string
	MaxTurns     int
	Gate         ac.ToolGate
	Audit        ledger.Sink
	Extra        []ac.AgentOption // passthrough for the long tail

	// Approver and AllowAll configure the default gate that Agent builds when
	// Gate is nil. A non-nil Gate (jess.WithToolGate) wins and both are ignored.
	// AllowAll is the explicit, greppable opt-out from the fail-closed default.
	// Neither bypasses the audit middleware's "no durable record, no action"
	// enforcement: that is gate-independent.
	Approver gate.Approver
	AllowAll bool
}

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

type ContextManagerOptions struct {
	// AgentID scopes Recall queries to one agent. Empty matches memories with
	// no AgentID (the global scope); pass an agent identifier for per-agent
	// memory.
	AgentID string
	// MaxItems caps how many memory entries get injected per call. Default 8.
	// Set to 0 for "as many as Recaller returns".
	MaxItems int
	// Header is the prefix line for the injected message. Default "Relevant
	// memories for this conversation:". Set to "" to omit the header entirely.
	Header string
	// Inner is the underlying ContextManager. May be nil — see PassthroughInner
	// for the no-op default applied in that case.
	Inner ac.ContextManager

	// Kinds is the registry of per-Kind policies. nil uses the baked-in
	// defaults from memory.NewKindRegistry. The ContextManager uses it to decide
	// which Kinds bypass recall (AlwaysInclude=true) and how many entries of
	// each Kind to inject per turn.
	Kinds *memory.KindRegistry

	// Audit is the provenance sink. When set, Project records one KindRetrieved
	// event per turn referencing every injected memory entry (by id + text hash).
	// nil disables retrieval provenance. Recording is best-effort.
	Audit ledger.Sink

	// RunState supplies the current RunID so a KindRetrieved event correlates with
	// the run that injected the memory. nil yields an empty RunID.
	RunState *runState
}

type GenerateFunc func(ctx context.Context, msgs []ac.Message, tools []ac.ToolSpec) (*ac.LLMResponse, error)

type PassthroughInner struct{}