cli

type ChatOptions struct {
	Model        string
	BaseURL      string
	APIKey       string
	SystemPrompt string
	Resume       string
	// Continue requests that, when set, the CLI resume the most recent
	// session in the current working directory (mirroring Claude
	// Code's --continue / -c flag). Mutually exclusive with Resume:
	// passing both is a user error and main.go errors out before
	// either path runs. The cwd lookup happens at command-dispatch
	// time, not in Resolve, because Resolve doesn't know cwd.
	Continue bool
	// Summarized requests that, when Resume is non-empty, the session
	// be loaded with its prior transcript replaced by a structured
	// summary (the same path /resume --summarized takes inside the
	// TUI). Defaults to false; only the `resume` subcommand sets it.
	Summarized bool
	// BypassPermissions is the internal name for what the user-facing
	// CLI exposes as --yolo: auto-approve every
	// tool call without prompting. DANGEROUS — model-emitted commands
	// run without a human in the loop. Explicit `deny` rules in
	// .yottacode/permissions.json are still honored, but every other
	// approval gate is skipped. Reserved for trusted CI / scripted
	// contexts; never enable in shared shells.
	BypassPermissions bool
	MaxIterations     int
	Provider          string
	// ProviderKind is the adapter kind (e.g. "copilot") resolved from
	// the config profile. May differ from Provider (the profile name,
	// e.g. "copilot-auth"). Set by applyProviderProfile; used by the
	// adapter ProviderOverride so routing works correctly.
	ProviderKind           string
	ReasoningEffort        string
	EnableWebSearch        bool
	DisableWebSearch       bool
	EnableXSearch          bool
	EnableCodeInterpreter  bool
	SearchAllowedDomains   string
	SearchExcludedDomains  string
	XSearchAllowedHandles  string
	XSearchExcludedHandles string
	XSearchFromDate        string
	XSearchToDate          string

	// AllowPaths is a comma-separated list of additional roots the
	// model's filesystem write tools are allowed to mutate, beyond the
	// session's cwd. Useful when legitimate work spans sibling repos
	// or shared dirs. Empty by default — writes confine to cwd.
	AllowPaths string

	// PermissionMode selects the startup permission mode, mirroring
	// Claude Code's --permission-mode flag. Valid values:
	//
	//   ""        — same as "default": no mode at startup.
	//   "default" — explicit form of the empty default.
	//   "plan"    — enter plan mode (read-only research; describe the
	//               task as your first message). Equivalent to typing
	//               /plan immediately after launch.
	//   "auto"    — enter auto mode (edits auto-allow; run_bash and
	//               git mutations still prompt). Reachable mid-session
	//               via Shift+Tab.
	//
	// No-op for oneshot (`yottacode run`) since the interactive modes
	// require an approval surface.
	PermissionMode string

	// PlanResume is a slug or substring matched against existing
	// plan files under ~/.yottacode/plans/. When set, the TUI
	// enters plan mode with the matched plan file attached so the
	// model picks up where it (or you) left off. Empty means "start
	// fresh"; an unmatched value falls back to fresh entry with a
	// log line so the user sees what happened. Implies
	// --permission-mode plan.
	PlanResume string

	// Worktree is the yottacode worktree name the session should be
	// launched inside (via the --worktree / -w flag). Empty for the
	// main checkout (default). The sentinel WorktreeAutoGenerate marks
	// "flag was passed without a value, auto-generate a name." Resolved
	// to a concrete name by ensureWorktree() before tui.Run / oneshot.Run
	// sees it; from those layers' perspective, an empty value means "no
	// worktree" and a non-empty value is always a concrete name.
	Worktree string

	// Experimental enables not-yet-stable features gated by the
	// internal/experimental package. The CLI flag is repeatable so
	// users can stack multiple opt-ins: `--experimental foo
	// --experimental bar`. Names also accept comma-separated lists
	// for symmetry with the $YOTTACODE_EXPERIMENTAL env var. The
	// config-file [experimental] section provides a third source;
	// they merge at startup. Unknown names land in the Set's
	// UnknownNames and surface as a startup warning rather than
	// fatal errors — so a typo or graduated feature doesn't lock
	// the user out.
	Experimental []string
}

type RouterAdapters struct {
	Fast       adapter.Client
	Smart      adapter.Client
	FastModel  string
	SmartModel string
	// Resolve returns an adapter for an arbitrary configured model
	// name, or nil when the name matches no configured provider model
	// (the caller then inherits the parent/smart adapter). Adapters are
	// memoized so repeated dispatches of the same agent type reuse one
	// client.
	Resolve func(model string) adapter.Streamer
}