app

type App struct {
	Sessions    session.Service
	Messages    message.Service
	History     history.Service
	Permissions permission.Service
	UserInput   userinput.Service
	DBQuerier   db.Querier

	CoderAgent agent.Service

	Projects            project.Service
	ProjectManager      *project.Manager
	AgentVCS            agentvcs.Service
	LSPClients          map[string]*lsp.Client
	SkillManager        *skills.SkillManager
	MesnadaOrchestrator *mesnadaOrch.Orchestrator
	CronService         *cronjob.Service
	MesnadaServer       *mesnadaServer.Server
	Remembrances        *rag.RemembrancesService
	ContextEnricher     *rag.ContextEnricher
	LuaManager          *luaengine.FilterManager
	MCPGateway          *mcpgateway.Gateway
	Evaluator           *evaluator.EvaluatorService

	// Extensions owns the compiled-in extensions (pkg/extension). It is always
	// non-nil; a build with no extensions simply holds an empty manager.
	Extensions *extension.Manager

	// MemorySink is the fan-out from remembrance writes to the extensions that
	// observe them. Nil unless [Extensions.Memory] opens the gate and a loaded
	// extension implements extension.MemorySink.
	MemorySink *extensions.MemoryPublisher

	// Identity reports who the host is running for, when a loaded extension
	// implements extension.IdentityProvider. It is always non-nil and is asked
	// per use, never cached, so a sign-in or a sign-out during a run takes
	// effect without a restart. With no provider it always reports false and
	// every consumer behaves exactly as an unextended Pando.
	Identity func(ctx context.Context) (extensions.Identity, bool)

	// UIPolicy reports what the settings surfaces should hide and what they
	// should render read-only, when a loaded extension implements
	// extension.UIPolicyProvider. It is always non-nil and is asked at render
	// time, so a policy that appears or disappears during a run takes effect on
	// the next rebuild. With no provider it returns the zero policy and every
	// surface behaves exactly as an unextended Pando.
	UIPolicy func(ctx context.Context) extensions.UIPolicy

	// ResumeHandlers lets a surface that streams runs (the WebUI API, ACP) own
	// the runs the delegation supervisor resumes for an idle session, instead of
	// the agent draining them. Always non-nil; with nothing registered (TUI, CLI)
	// resumed runs are drained by the agent exactly as before.
	ResumeHandlers *agent.ResumeRegistry

	// IPCBus is set on the leader instance after calling SetupIPC.
	// Followers leave this nil.
	IPCBus *ipc.Bus
	// IPCIsPrimary is true when this instance holds the IPC lock (the leader).
	IPCIsPrimary bool
	// contains filtered or unexported fields
}

type AppOptions struct {
	// SkipLSP disables LSP client initialisation. Set this to true in headless
	// modes (e.g. ACP stdio) where the editor manages its own language servers.
	SkipLSP bool
	// SkipMesnadaServer avoids starting the embedded Mesnada HTTP server while
	// still allowing the orchestrator and related tools to be initialized.
	SkipMesnadaServer bool
	// StartupMode identifies the mode in which Pando is starting so background
	// remembrances behaviors can be aligned consistently across entrypoints.
	StartupMode string
	// SkipStartupIndexing disables the startup KB import, the KB watcher and
	// the code-index startup scan/watcher. Set it for one-shot runs (`-p`,
	// `--goal`, mesnada pando-cli subagents): those processes are short-lived,
	// often started several at a time, and re-running a full embedding sync in
	// each one saturates the embedding backend (e.g. Ollama at 100% CPU).
	SkipStartupIndexing bool
	// ChildParentInstanceID is set when this process was spawned as a project
	// child by another Pando instance. Child instances must not spawn nested
	// project children, but they still import peer projects for IPC delegation.
	ChildParentInstanceID string
	// DBQuerier overrides the db.Querier used for sessions, messages, and projects.
	// When non-nil this querier is used instead of db.New(conn).
	DBQuerier db.Querier
	// IPCFollower is true when another process holds the IPC lock for this
	// workdir: the singleton jobs (code index + watcher, evaluator sweeps) are
	// left to the leader until failover promotes this instance.
	IPCFollower bool
	// InstanceID identifies the current Pando process for project child ownership.
	InstanceID string
	// WebChildTLSCertFile/WebChildTLSKeyFile configure the certificate the
	// project manager passes to spawned background WebUI children.
	WebChildTLSCertFile string
	WebChildTLSKeyFile  string
	WebChildTLSDataDir  string
}

type LSPAvailability int

type LSPResolution struct {
	// Command and Args are the process to spawn. They are only meaningful when
	// Availability is LSPAvailable.
	Command string
	Args    []string
	// Availability says whether the server can start, could start after an
	// install, or needs the user to act.
	Availability LSPAvailability
	// Reason explains, in a sentence a user can act on, why the server is not
	// available. Empty when Availability is LSPAvailable.
	Reason string
}

type LSPServerStatus struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	// Command is the configured command, as it should be written back to the
	// configuration; ResolvedCommand is the executable Pando would actually
	// spawn (an absolute path, possibly inside Pando's own staging directory).
	Command         string   `json:"command"`
	ResolvedCommand string   `json:"resolvedCommand,omitempty"`
	Args            []string `json:"args,omitempty"`
	Languages       []string `json:"languages,omitempty"`
	Filenames       []string `json:"filenames,omitempty"`

	// Configured reports that the user declared this server under [LSP.<name>]
	// instead of only inheriting the built-in preset.
	Configured bool `json:"configured"`
	// OptIn reports a preset that stays inactive until it is declared.
	OptIn     bool `json:"optIn"`
	Disabled  bool `json:"disabled"`
	Autostart bool `json:"autostart"`

	// Availability is "installed", "installable" or "manual".
	Availability string `json:"availability"`
	// AvailabilityLabel is the short human-readable form, e.g.
	// "installable (bun)".
	AvailabilityLabel string `json:"availabilityLabel"`
	// Reason explains a non-installed server; Hint is the command the user can
	// run themselves and URL its documentation.
	Reason string `json:"reason,omitempty"`
	Hint   string `json:"hint,omitempty"`
	URL    string `json:"url,omitempty"`

	// RunState is "stopped", "starting", "ready" or "error".
	RunState   string `json:"runState"`
	Installing bool   `json:"installing"`
}

type NonInteractiveGoalResult struct {
	SessionID          string `json:"session_id"`
	Objective          string `json:"objective"`
	Status             string `json:"status"`
	Iteration          int64  `json:"iteration"`
	MaxIterations      int64  `json:"max_iterations"`
	MaxDurationSeconds int64  `json:"max_duration_seconds"`
	Response           string `json:"response"`
	Progress           string `json:"progress,omitempty"`
	NextStep           string `json:"next_step,omitempty"`
	BlockedReason      string `json:"blocked_reason,omitempty"`
}