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 --dangerously-skip-permissions: 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. Mirrors Claude Code's
	// --dangerously-skip-permissions flag.
	BypassPermissions      bool
	MaxIterations          int
	Provider               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

	// 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
}