pool

type ActiveEntry struct {
	SessionID  string
	AgentName  string
	CWD        string // resolved workspace path, used by RouteByCWD
	PID        int
	Lifecycle  string
	Substate   string
	LastActive time.Time
}

type AgentFactory interface {
	Build(opt FactoryOptions) (BuildResult, error)
}

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

type BuildResult struct {
	Agent     *provider.Agent
	State     *state.Machine
	Store     *store.Store
	OnStarted func(meta SpawnStartMeta)
}

type ClaudeFactory struct {
	Layout    config.Layout
	Spawner   provider.Spawner // optional override; nil = real claude
	RecordRaw bool
	OnEvent   func(sessionID, agentName string, ev event.AgentEvent)
	OnExit    func(sessionID, agentName string, reason provider.ExitReason)

	// Gate (optional) attaches a static command whitelist to every spawn.
	// When non-nil, Build writes a per-session settings.json + spec
	// file to a temp dir, points the spawner at the settings file,
	// and injects WICK_GATE_SPEC into ExtraEnv so wick-gate finds
	// its config. nil = no gate (fail-open, only safe for tests).
	Gate *GateConfig
	// GateLoader (optional) is called on every Build to fetch the
	// current gate config from the live config store. Takes precedence
	// over Gate when non-nil. This lets operators toggle gate_enabled
	// or edit AllowedCmds in the UI without restarting the server.
	GateLoader func() *GateConfig
	// BypassPermissionsLoader (optional) is called on every Build to
	// check whether --permission-mode bypassPermissions should be added
	// when no gate is active. Useful for non-interactive channels
	// (Slack, HTTP) where the operator wants to skip prompts without
	// enabling the full command gate.
	BypassPermissionsLoader func() bool

	// SpawnLogger (optional) writes one jsonl per spawn under
	// `<base>/backends/spawns/`. Each spawn emits `start` on Build +
	// `exit` from the OnExit hook so the Backends UI can list spawn
	// history per backend by `ls`-ing the directory. nil = no logging.
	SpawnLogger *provider.SpawnLogger
}

type FactoryOptions struct {
	SessionID     string
	AgentName     string
	ProviderType  string
	ProviderName  string
	Workspace     string
	ResumeID      string
	IdleTimeout   time.Duration
	KillAfterIdle time.Duration
	OnEvent       func(event.AgentEvent)
}

type GateConfig struct {
	// GateBinary is the absolute path to the wick-gate binary. Required.
	GateBinary string
	// Rules is the whitelist enforced for every spawn under this factory.
	Rules []gate.CommandRule
	// AppName drives the shared spec path (~/.<app>/agents/gate/spec.json).
	// Falls back to "wick" when empty.
	AppName string
	// DefaultScope is written into spec.json as the fallback scope for
	// rules that have an empty Scope field. Typically the default
	// workspace directory so no-scope rules are still path-restricted.
	DefaultScope string
	// TempDirRoot is where per-spawn gate artifacts live. If empty,
	// `<Layout.SessionDir(id)>/gate` is used.
	TempDirRoot string
}

type LifecycleEvent struct {
	SessionID string
	AgentName string
	Lifecycle string // "spawning" | "killed"
	PID       int
	At        time.Time
}

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

type PoolConfig struct {
	MaxConcurrent    int
	IdleTimeout      time.Duration
	KillAfterIdle    time.Duration
	Layout           config.Layout
	Factory          AgentFactory
	DefaultWorkspace string
	// OnSessionCreated is called after the pool auto-creates a session for a
	// channel message (e.g. Slack thread_ts). Wire this to
	// manager.Register so the dashboard sees the session immediately.
	OnSessionCreated func(s session.Session)
	// OnLifecycle fires when the pool transitions a session+agent's
	// lifecycle (Spawning, Killed). Idle/Working transitions are
	// implicit from event flow and are NOT routed here — UIs that
	// want every transition should subscribe to AgentEvent via
	// the factory's OnEvent. Optional; nil = no callback.
	OnLifecycle func(LifecycleEvent)
}

type QueueEntry struct {
	SessionID string
	AgentName string
	Enqueued  time.Time
}

type SpawnStartMeta struct {
	PID              int
	Binary           string
	Argv             []string
	FirstUserMessage string
}