agentruntime

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

type AgentConfig struct {
	ID       uuid.UUID
	Slug     string
	Name     string
	Persona  string
	Model    string
	Provider string
	Skills   []string
}

type Builder interface {
	Build(ctx context.Context, cfg AgentConfig) (chats.AgentProcessor, error)
}

type BuilderConfig struct {
	// Defaults supplies the deployment-wide LLM configuration (provider, model,
	// API key, base URL, timezone, temperature/token limits). An agent's own
	// Model/Provider override the defaults when set; everything else is inherited.
	Defaults agent.Config

	// BaseOptions are agent.Options shared by every built instance — the
	// deployment's skill source (skill pack/manager or dirs), tools, session
	// store, and rollover policy. The builder layers each agent's enabled-skill
	// subset (WithSkillIncludes) on top, so BaseOptions supplies where skills
	// come from and the agent's config selects which are active.
	BaseOptions []agent.Option

	// Secrets resolves each agent's agent-scoped secrets, injected into the
	// instance's secrets-aware skills (notably per-agent MCP subprocess env) via
	// agent.WithSecretEnv. Optional; nil means no secrets are injected. Because
	// each instance is built with only its own agent's secrets, two agents load
	// disjoint secrets with no cross-leak (RMI-OMNIAGENT-310).
	Secrets SecretSource

	// Logger defaults to slog.Default().
	Logger *slog.Logger
}

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

type Config struct {
	// Loader reads agents' runtime configuration. Required.
	Loader ConfigLoader
	// Builder builds an instance from a config. Required.
	Builder Builder
	// MaxInstances bounds the resident instance count; <=0 uses
	// DefaultMaxInstances.
	MaxInstances int
	// Logger defaults to slog.Default().
	Logger *slog.Logger
}

type ConfigLoader interface {
	// AgentSlug returns just the agent's slug — the cheap read a group turn
	// makes for @-mention matching, without building the instance.
	AgentSlug(ctx context.Context, agentID uuid.UUID) (string, error)
	// LoadConfig returns the agent's full runtime configuration.
	LoadConfig(ctx context.Context, agentID uuid.UUID) (AgentConfig, error)
}

type SecretSource interface {
	ResolveSecrets(ctx context.Context, agentID uuid.UUID) (map[string]string, error)
}