agentui

type OpenGrokBindState struct {
	State           string `json:"state"` // in_progress|ok|failed
	StartedAt       string `json:"started_at"`
	FinishedAt      string `json:"finished_at,omitempty"`
	Error           string `json:"error,omitempty"`
	RunnerSessionID string `json:"runner_session_id,omitempty"`
}

type RunOptions struct {
	Prompt    string
	Runner    string
	Model     string
	SessionID string
	// TerminalSessionID is the TTY registry id. When empty, SessionID is used as
	// the custom terminal id (legacy --session / --session-id-from-prompt).
	// When PreferAutoTerminal is true, TerminalSessionID is ignored and the TTY
	// id is auto-allocated (session-N) while SessionID remains agent storage.
	TerminalSessionID string
	// PreferAutoTerminal forces auto session-N for the TTY registry even when
	// SessionID is set (used by resume fallback when zombie reclaim cannot free
	// the prior terminal id).
	PreferAutoTerminal    bool
	AgentRunnerBinary     string // optional binary name/path or "binary flag..." shell spec
	AgentRunnerConfigHome string // grok/codex data dir; falls back to AGENT_RUNNER_CONFIG_HOME
	// PrependPaths are absolute dirs prepended to the TTY child PATH (persisted on meta).
	PrependPaths []string
	// Env is ordered KEY=VALUE entries for the TTY child (persisted on meta; last-win).
	Env               []string
	JSON              bool
	Workspace         string
	Store             agentstorage.Store
	Stdout            io.Writer
	Stderr            io.Writer
	StreamPhases      bool // web: phased assistant start/update/end; CLI: single message events
	KeepTerminalAlive bool
	// Open is run --open: silent keep-alive TTY start, auto-attach, print id after detach.
	Open bool
	// NoSubmit is run --no-submit: with Open, inject prompt without trailing Enter.
	NoSubmit bool
	// WebManagedGrokSync skips in-process grok sync; caller runs agentsync.EnsureGrokSync.
	WebManagedGrokSync bool
}