agentrunapi

type FollowUpOpts struct {
	// Driver is the host re-exec config. Zero Binary → Resolve defaults to self
	// unless legacy DriverBinary/DriverArgsPrefix are set (compat).
	Driver agentdriver.Driver
	// DriverBinary is deprecated: use Driver.Binary.
	// Empty with empty Driver → historical default "agent-run" for bare CLI PATH.
	DriverBinary string
	// DriverArgsPrefix is deprecated: use Driver.Args.
	DriverArgsPrefix []string

	SessionID                     string
	Prompt                        string
	AgentRunner                   string
	WorkspaceDir                  string
	NoSubmit                      bool
	AllowRelocateResumeSessionDir bool
	Open                          bool
	Detach                        bool
	// Env each "KEY=VALUE" → -e KEY=VALUE before -- / prompt (optional).
	Env []string
}

type Mode string

type OpenInNewTerminalOpts struct {
	WorkspaceDir string
	// FollowUp if non-empty is used as-is; else built from FollowUpOpts.
	FollowUp     string
	FollowUpOpts FollowUpOpts
	// OpenTerminal replaces production iTerm ForceNew when set (unit tests).
	OpenTerminal func(dir string, followUp string) error
}

type Opts struct {
	SessionID                     string
	Prompt                        string
	WorkspaceDir                  string
	AgentRunner                   string
	AgentRunnerBinary             string
	RunnerConfigHome              string
	Model                         string
	Open                          bool
	Detach                        bool
	NoSubmit                      bool
	KeepTTY                       bool
	JSON                          bool
	AllowRelocateResumeSessionDir bool
	// Driver is the host re-exec config for TTY __serve_* and should match
	// ForceNew FollowUp Driver (see pkgs/agentdriver). Zero → DefaultSelf in serve.
	Driver agentdriver.Driver
	// NewTerminal: P1 unit leaves keep false. When true, ForceNew may remain CLI-owned.
	NewTerminal  bool
	Env          []string
	PrependPaths []string
	Store        agentstorage.Store
	Stdout       io.Writer
	Stderr       io.Writer
	Probe        ProbeFunc

	// Optional dispatch overrides (nil = production path).
	RunSession    func(ctx context.Context, opts Opts, meta agentstorage.SessionMeta, found bool) error
	SendLive      func(ctx context.Context, opts Opts, meta agentstorage.SessionMeta) error
	ResumeSession func(ctx context.Context, opts Opts, meta agentstorage.SessionMeta) error
}

type ProbeFunc func(store agentstorage.Store, meta agentstorage.SessionMeta) (ProbeReport, error)

type ProbeReport struct {
	// ResumeReady is true when runner is bound and exited (resume path).
	ResumeReady bool
	// RunnerExited is nil when unknown; false when live; true when exited.
	RunnerExited *bool
}

type WaitReadyOpts struct {
	SessionID    string                            // required (non-empty after trim)
	StatusFn     func() (stdout string, err error) // required
	Timeout      time.Duration                     // 0 → 60s
	PollInterval time.Duration                     // 0 → 500ms
}