core

type AIResponseEvent struct {
	// Text is the AI response text.
	Text string
	// Iteration is the current iteration number.
	Iteration int
}

type AutoCommitEvent struct {
	SHA       string
	Message   string
	Tag       string
	Iteration int
}

type BlockedPhraseDetectedEvent struct {
	// Phrase is the blocked phrase that was detected.
	Phrase string
	// Iteration is the iteration where the phrase was detected.
	Iteration int
}

type CarryContextMode string

type CheckpointSavedEvent struct {
	Path      string
	Iteration int
}

type ErrorEvent struct {
	// Error is the error that occurred.
	Error error
	// Iteration is the current iteration number (0 if not in iteration).
	Iteration int
	// Recoverable indicates if the error is recoverable.
	Recoverable bool
}

type ErrorStopEvent struct {
	// Threshold is the configured consecutive-error budget.
	Threshold int
	// Iteration is the iteration where the threshold was reached.
	Iteration int
}

type IterationCompleteEvent struct {
	// Iteration is the iteration number (1-based).
	Iteration int
	// Duration is how long the iteration took.
	Duration time.Duration
}

type IterationStartEvent struct {
	// Iteration is the iteration number (1-based).
	Iteration int
	// MaxIterations is the maximum number of iterations.
	MaxIterations int
}

type IterationTimeoutEvent struct {
	// Timeout is the configured per-iteration timeout.
	Timeout time.Duration
	// Iteration is the iteration that timed out.
	Iteration int
}

type LoopCancelledEvent struct {
	// Result contains partial loop result.
	Result *LoopResult
}

type LoopCompleteEvent struct {
	// Result contains the loop result.
	Result *LoopResult
}

type LoopConfig struct {
	Prompt           string
	PromisePhrase    string
	Model            string
	WorkingDir       string
	LogLevel         string
	SystemPrompt     string
	SystemPromptMode string

	// CarryContext controls how the previous iteration's reply is fed into
	// the next iteration's prompt. Defaults to CarryContextSummary.
	CarryContext CarryContextMode
	// CarryContextMaxRunes clamps a carried summary so a chatty assistant
	// cannot inflate the next prompt indefinitely. <=0 disables truncation.
	CarryContextMaxRunes int

	// PlanFile is the path (relative or absolute) to the running fix_plan.md
	// scratchpad. Empty means "do not surface a plan file in the prompt".
	PlanFile string
	// SpecsDir is a directory whose Markdown files are listed in the prompt
	// so the assistant knows specs exist. Empty means "no specs".
	SpecsDir string

	// StopOnNoChanges halts the loop when this many consecutive iterations
	// leave the git working tree unchanged. <=0 disables the check.
	StopOnNoChanges int
	// StopOnError halts the loop when this many consecutive iterations emit
	// an error event. <=0 disables the check.
	StopOnError int

	// IterationTimeout is the per-iteration soft deadline. <=0 disables.
	IterationTimeout time.Duration

	// VerifyCmd is a shell command run after each iteration. When it
	// exits non-zero its captured output is folded into the next
	// iteration's prompt so the assistant can react to failing
	// tests/builds. Empty disables the feature.
	VerifyCmd string
	// VerifyTimeout caps a single verify run. <=0 disables.
	VerifyTimeout time.Duration
	// VerifyMaxBytes truncates the captured stdout/stderr/combined buffers
	// per stream. <=0 means unlimited (use with care).
	VerifyMaxBytes int

	// AutoCommit, when true, runs `git add -A && git commit` after every
	// iteration that produced changes. Requires WorkingDir to be a git
	// repository.
	AutoCommit bool
	// AutoCommitOnVerifyOnly, when true, only auto-commits when verify
	// succeeded (or is disabled). Defaults to true to avoid recording
	// known-bad states.
	AutoCommitOnVerifyOnly bool
	// AutoCommitMessage is a Go template-free format string for the commit
	// message. Use %d for the iteration number. Empty falls back to a
	// sensible default.
	AutoCommitMessage string
	// AutoTag, when non-empty, creates an annotated tag (with %d for
	// iteration number) on each successful auto-commit. Tags are never
	// pushed.
	AutoTag string
	// EmitDiffStat, when true, emits a WorkspaceDiffEvent at the end of
	// each iteration carrying `git diff --stat HEAD`.
	EmitDiffStat bool

	// CheckpointFile is the path the engine writes loop state to after
	// each iteration. Empty disables checkpointing.
	CheckpointFile string
	// ResumeFromIteration, when >0, instructs the engine to start
	// numbering iterations from this value+1 (i.e. it continues a
	// previously-checkpointed run). The engine treats it as advisory and
	// still respects MaxIterations.
	ResumeFromIteration int
	// ResumeSummary, when non-empty, primes the carry-context summary so
	// the first resumed iteration sees the previous run's last summary.
	ResumeSummary string

	// OracleModel is the model used for the second-opinion oracle. Empty
	// disables oracle consultations entirely.
	OracleModel string
	// OracleEvery, when >0, consults the oracle every N iterations.
	OracleEvery int
	// OracleOnVerifyFail, when true, also consults the oracle whenever
	// --verify-cmd fails for an iteration.
	OracleOnVerifyFail bool

	// PromptStack lists additional prompts (already resolved to text)
	// that are prepended to the main prompt in order.
	PromptStack []string

	// NoRateLimitWait, when true, surfaces Copilot rate-limit errors as
	// fatal instead of pausing the loop until reset.
	NoRateLimitWait bool

	// BlockedPhrase, when non-empty, makes the engine watch for
	// <blocked>...</blocked> in every assistant response. When detected the
	// loop stops with StateBlocked (exit code 5).
	BlockedPhrase string

	// StallAfter, when > 0, stops the loop after this many consecutive
	// iterations that produce an identical (byte-for-byte) assistant
	// response. Protects against models stuck in a non-progressing loop.
	StallAfter int

	// IterationDelay is a pause inserted between iterations. <=0 disables.
	IterationDelay time.Duration

	// OnCompleteCmd is a shell command executed after a successful loop
	// (promise detected). Empty disables the hook.
	OnCompleteCmd string

	// OnBlockedCmd is a shell command executed when the model emits the
	// blocked signal. Empty disables the hook.
	OnBlockedCmd string

	MaxIterations int
	Timeout       time.Duration
	DryRun        bool
	Streaming     bool
}

type LoopEngine struct {
	// contains filtered or unexported fields
}

type LoopFailedEvent struct {
	// Error is the error that caused the failure.
	Error error
	// Result contains partial loop result.
	Result *LoopResult
}

type LoopResult struct {
	Error      error
	State      LoopState
	Iterations int
	Duration   time.Duration
}

type LoopStartEvent struct {
	// Config is the loop configuration.
	Config *LoopConfig
}

type LoopState string

type NoChangesStopEvent struct {
	// Threshold is the configured number of clean iterations that triggers
	// the stop.
	Threshold int
	// Iteration is the iteration where the threshold was reached.
	Iteration int
}

type OracleAdviceEvent struct {
	Model     string
	Advice    string
	Iteration int
	Reason    string
}

type OracleClient interface {
	Consult(ctx context.Context, prompt string) (string, error)
}

type PlanUpdatedEvent struct {
	// Path is the absolute path of the plan file.
	Path string
	// Bytes is the new size of the plan file on disk.
	Bytes int
	// Iteration is the iteration number that produced the change.
	Iteration int
}

type PromiseDetectedEvent struct {
	// Phrase is the promise phrase that was detected.
	Phrase string
	// Source is where the promise was found (e.g., "ai_response", "tool_output").
	Source string
	// Iteration is the iteration number where promise was found.
	Iteration int
}

type RateLimitWaitEvent struct {
	// ResetAt is when the rate limit is expected to reset. Only meaningful
	// when HasReset is true.
	ResetAt time.Time
	// Wait is the duration the engine will sleep before retrying.
	Wait time.Duration
	// Message is the human-readable message reported by the SDK.
	Message string
	// ErrorType is the SDK-reported error category (e.g. "rate_limit").
	ErrorType string
	// Iteration is the iteration number being retried.
	Iteration int
	// HasReset indicates whether ResetAt is meaningful.
	HasReset bool
}

type SDKClient interface {
	// Start initializes the SDK client.
	Start() error
	// Stop closes the SDK client and releases resources.
	Stop() error
	// CreateSession creates a new SDK session.
	// The implementation should initialize any SDK session resources and return an error if it fails.
	CreateSession(ctx context.Context) error
	// DestroySession destroys the current session.
	DestroySession(ctx context.Context) error
	// SendPrompt sends a prompt to the AI and returns an event stream.
	SendPrompt(ctx context.Context, prompt string) (<-chan sdk.Event, error)
	// Model returns the configured AI model name.
	Model() string
}

type StallStopEvent struct {
	// Threshold is the configured number of identical iterations that
	// triggers the stop.
	Threshold int
	// Iteration is the iteration where the threshold was reached.
	Iteration int
}

type ToolEvent struct {
	Parameters map[string]any
	ToolName   string
	Iteration  int
}

type ToolExecutionEvent struct {
	Error error
	ToolEvent
	Result   string
	Duration time.Duration
}

type ToolExecutionStartEvent struct {
	ToolEvent
}

type VerifyResultEvent struct {
	Cmd       string
	Output    string
	Iteration int
	ExitCode  int
	Duration  time.Duration
	Success   bool
	TimedOut  bool
}

type WorkspaceDiffEvent struct {
	Stat      string
	Iteration int
}