gemini

type AuthSnapshot struct {
	Authenticated bool
	AuthType      string
	Account       *harnesses.AccountInfo
	CapturedAt    time.Time
	Fresh         bool
	Source        string
	Detail        string
}

type GeminiQuotaRoutingDecision struct {
	// PreferGemini is true when the snapshot is fresh and at least one
	// non-exhausted tier is present.
	PreferGemini bool
	// SnapshotPresent is true when a snapshot was found (even if stale).
	SnapshotPresent bool
	// Fresh is true when the snapshot is present and newer than staleAfter.
	Fresh bool
	// Age is the snapshot age (zero when absent).
	Age time.Duration
	// Snapshot is the cached snapshot when present.
	Snapshot *GeminiQuotaSnapshot
	// AvailableTiers lists tier limit_ids (e.g. "gemini-flash") that are
	// fresh and below the exhaustion threshold.
	AvailableTiers []string
	// ExhaustedTiers lists tier limit_ids currently blocked (e.g. "gemini-pro"
	// at 100% used).
	ExhaustedTiers []string
	// Reason describes the diagnostic outcome.
	Reason string
}

type GeminiQuotaSnapshot struct {
	CapturedAt time.Time               `json:"captured_at"`
	Windows    []harnesses.QuotaWindow `json:"windows"`
	Source     string                  `json:"source"` // e.g. "pty", "cassette"
	Account    *harnesses.AccountInfo  `json:"account,omitempty"`
	Detail     string                  `json:"detail,omitempty"`
}

type QuotaPTYOption func(*quotaPTYOptions)

type Runner struct {
	// Binary is the absolute path to the gemini executable. When empty the
	// runner resolves "gemini" via PATH at Execute time.
	Binary string

	// BaseArgs is prepended to the per-request argument list.
	// Gemini default: ["--output-format", "stream-json"].
	BaseArgs []string

	// PromptMode controls how the prompt is delivered.
	// "arg" (default) sends "-p <prompt>"; "stdin" sends "-p ”" and writes
	// the prompt to stdin. Gemini requires -p/--prompt for headless mode.
	PromptMode string

	// EventBuffer overrides the per-Execute channel buffer size.
	EventBuffer int
}