adapter

type Agent struct {
	NameValue        string
	DisplayNameValue string
	Candidates       []CommandCandidate
	YoloArgs         []string
	Backend          Backend
	Terminal         ProviderTerminalPolicy
	SessionArgs      func(req ResumeRequest, activity string) []string
	// PrepareLaunch runs after cwd and canonical session-name resolution.
	// Preparation args run first; legacy SessionArgs are appended after them.
	// Preparation identity overrides ProviderSession, which overrides the
	// request's stored identity. Core UAM env keys cannot be overridden.
	PrepareLaunch PrepareLaunchFunc
	// ProviderSession optionally reports the provider-side session id that
	// the launched agent will use (e.g. the uuid claude was seeded with via
	// --session-id), or "" when unknown. It is persisted so a later resume
	// can target the exact provider session (F-resume).
	ProviderSession       func(req ResumeRequest, activity string) string
	LiveProviderSessionID func(sessionName string) (string, error)
	ResumeKindFor         func(req ResumeRequest) ResumeKind
	SkipPromptOnResume    bool
	// contains filtered or unexported fields
}

type AgentAdapter interface {
	Name() string
	DisplayName() string
	Available() (bool, string)
	Dispatch(ctx Context, req DispatchRequest) (Session, error)
	List(ctx Context) ([]Session, error)
	Attach(id string) (AttachSpec, error)
	Stop(ctx Context, id string) error
}

type AttachProfileSnapshot struct {
	Selected      string
	Effective     string
	Mouse         string
	ControlPrefix string
	BackDetach    bool
}

type AttachSpec struct {
	Argv    []string
	Profile AttachProfileSnapshot
}

type BackDetachPolicy string

type Backend interface {
	CreateProviderSession(ctx context.Context, spec session.CreateSpec) error
	SetSessionLabel(ctx context.Context, name, label string) error
	List(ctx context.Context) ([]session.Info, error)
	Capture(ctx context.Context, name string, lines int) (string, error)
	SendLine(ctx context.Context, name, text string) error
	// SendPrompt types the initial prompt once the provider has taken the
	// terminal, so a starting TUI receives it as keys rather than a cooked line.
	SendPrompt(ctx context.Context, name, text string) error
	Kill(ctx context.Context, name string) error
	HasSession(ctx context.Context, name string) bool
	AttachArgv(name string) ([]string, error)
}

type CommandCandidate struct {
	Display string
	Args    []string
}

type Context = context.Context

type DispatchRequest struct {
	Prompt          string
	Cwd             string
	Mode            string
	Name            string
	CommandAlias    string
	ScrollbackLines int
}

type HasSessionAdapter interface {
	HasSession(ctx Context, id string) bool
}

type KeyProtocolPolicy string

type LaunchPreparation struct {
	Command           []string
	ExtraArgs         []string
	Env               map[string]string
	ProviderSessionID string
	// InitialPrompt bypasses terminal input and is inherited by the provider
	// command as fd 3. Agent closes its copy after creating the session.
	InitialPrompt *os.File
}

type OuterScreenPolicy string

type PRRef struct {
	URL    string
	Owner  string
	Repo   string
	Number int
	Status PRStatus
}

type PRStatus string

type PrepareLaunchFunc func(ctx Context, req ResumeRequest, activity, sessionName, cwd string) (LaunchPreparation, error)

type ProcLiveness string

type ProviderIdentity string

type ProviderTerminalPolicy struct {
	Identity    ProviderIdentity
	OuterScreen OuterScreenPolicy
	KeyProtocol KeyProtocolPolicy
	BackDetach  BackDetachPolicy
}

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

type ResumableAdapter interface {
	Resume(ctx Context, req ResumeRequest) (Session, error)
}

type ResumeKind string

type ResumeKindAdapter interface {
	ResumeKind(ResumeRequest) ResumeKind
}

type ResumeRequest struct {
	ID              string
	Name            string
	CommandAlias    string
	ScrollbackLines int
	Prompt          string
	Cwd             string
	Mode            string
	SessionName     string
	// ProviderSessionID is the persisted provider-side session id, when one
	// was recorded at dispatch; providers that support exact resume use it
	// instead of their "most recent" heuristic.
	ProviderSessionID string
	CreatedAt         time.Time
	// ExecutablePath is transient launch metadata populated by Agent only
	// after alias validation and PATH resolution. Preparation hooks may probe
	// it; it is never persisted.
	ExecutablePath string
}

type Session struct {
	ID           string
	AgentType    string
	CommandAlias string
	DisplayName  string
	Prompt       string
	Cwd          string
	SessionName  string
	// ProviderSessionID is the agent CLI's own session identifier, recorded
	// when the provider lets uam seed or learn it (e.g. claude --session-id).
	// It upgrades resume from "most recent conversation in this cwd" to an
	// exact-session resume.
	ProviderSessionID string
	State             State
	ProcAlive         ProcLiveness
	LastChange        time.Time
	CreatedAt         time.Time
	PR                *PRRef
	Pinned            bool
	Group             string
	SortIndex         int
	// ExitCode is the agent process's exit status from its most recent close
	// (-1 when it died on a signal), recorded by the session host. Nil while
	// the session is live or when no exit has been observed.
	ExitCode *int
	// Closed mirrors store.StatusClosedByUser: explicit UAM stop/restart reason
	// metadata retained for compatibility. Dashboard lifecycle grouping uses
	// ProcAlive, so every exited process is STOPPED regardless of this flag.
	Closed bool
}

type State string

type TerminalPolicyAdapter interface {
	TerminalPolicy() ProviderTerminalPolicy
}