decisions

type BilledError struct {
	Model string
	Usage Usage
	Err   error
}

type Category string

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

type Decision struct {
	Title               string   `json:"title,omitempty"`
	Summary             string   `json:"summary"`
	Category            Category `json:"category"`
	Who                 Who      `json:"who"`
	Trigger             Trigger  `json:"trigger,omitempty"`
	Rationale           string   `json:"rationale,omitempty"`
	RejectedAlternative string   `json:"rejected_alternative,omitempty"`
	Superseded          bool     `json:"superseded"`
	Turns               []int    `json:"turns"`
	DecidedTurn         int      `json:"decided_turn,omitempty"`
	Evidence            string   `json:"evidence,omitempty"`
	EvidenceTurn        int      `json:"evidence_turn,omitempty"`
	Files               []string `json:"files"`
	// ID is the decision's ID, given by the host when it first stores the
	// extraction holding it (Identified); empty in a model reply.
	ID string `json:"decision_id,omitempty"`
}

type Dropped struct {
	// Decision is the decision's index in the model's reply.
	Decision int    `json:"decision"`
	Summary  string `json:"summary"`
	// Field names a removed field (trigger, decided_turn or evidence); Turn
	// then holds a removed decided turn. Without Field, Turn or File is the
	// removed citation. All three are empty when the whole decision was
	// dropped. Turn is a pointer so a removed turn 0 is kept.
	Field  string `json:"field,omitempty"`
	Turn   *int   `json:"turn,omitempty"`
	File   string `json:"file,omitempty"`
	Reason string `json:"reason"`
}

type Event struct {
	Kind EventKind
	// Text is the agent text, plan or subagent report.
	Text string
	// Tool is the denied tool's name.
	Tool      string
	Questions []Question
	// Discuss reports that the human chose to talk the questions over
	// instead of answering them.
	Discuss bool
	Outcome PlanOutcome
	// Feedback is what the human said when rejecting a plan, a question or a
	// tool call.
	Feedback string
}

type EventKind string

type ExtractOptions struct {
	// MaxInputTokens caps the estimated prompt size; a larger transcript
	// returns ErrTranscriptTooLarge without calling the model. Zero means no cap.
	MaxInputTokens int64
	// MaxOutputTokens is passed to ModelRequest.MaxOutputTokens; zero means
	// the provider client's default.
	MaxOutputTokens int64
	// Existing and Cutoff extend an earlier extraction of the same session
	// instead of starting over, so its decisions and their IDs stay as they
	// were. Existing are its decisions, shown to the model by handle (d1, d2,
	// ...) and returned first; Cutoff is the last turn whose decisions they
	// cover, 0 for none. Either one set extends. A cutoff is usually the turn
	// before the earlier extraction's last turn (ExtensionCutoff), since an
	// open last turn keeps growing.
	Existing []Decision
	Cutoff   int
}

type Extraction struct {
	SessionDecisions
	// PromptVersion is the Extractor's PromptVersion.
	PromptVersion string    `json:"prompt_version"`
	Model         string    `json:"model"`
	Usage         Usage     `json:"usage"`
	Dropped       []Dropped `json:"dropped,omitempty"`
}

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

type Model interface {
	Complete(ctx context.Context, req ModelRequest) (ModelResponse, error)
}

type ModelRequest struct {
	System string
	User   string
	// SchemaName names Schema for providers that require one.
	SchemaName string
	// Schema is a JSON Schema object that satisfies OpenAI's strict structured
	// outputs: every property required, additionalProperties false.
	Schema map[string]any
	// MaxOutputTokens caps the reply. Zero means the provider client's default.
	MaxOutputTokens int64
}

type ModelResponse struct {
	// JSON is the reply object, expected to match the request's Schema.
	JSON []byte
	// Model is the model the provider reports having used.
	Model string
	Usage Usage
}

type Option func(*settings)

type PlanOutcome string

type Question struct {
	Text    string
	Options []string
	// Answer is empty when no answer was recorded. For Cursor the answer, if
	// any, is the next human prompt.
	Answer string
	// Picked reports that Answer is one (or, for multi-select, only) of the
	// offered options rather than free text.
	Picked bool
	// Note is what the human added to their choice.
	Note string
}

type Redactor interface {
	RedactString(ctx context.Context, s string) (string, int, error)
}

type Row struct {
	Message *session.AssistantMessage
	ToolUse *session.ToolUse
	Index   int
}

type SessionDecisions struct {
	SessionID string     `json:"session_id"`
	Decisions []Decision `json:"decisions"`
}

type Transcript struct {
	SessionID string
	Turns     []Turn
}

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

type Trigger string

type Turn struct {
	// Ordinal is the stored UserInput.Ordinal. Decision citations use it, so
	// it is never renumbered; dropped inputs leave gaps.
	Ordinal int `json:"ordinal"`
	// Human is the cleaned prompt, empty when the input was not a human
	// prompt (a system notification, an injected skill body).
	Human  string  `json:"-"`
	Events []Event `json:"-"`
	// EditedFiles are the repo-relative paths edited during the turn, sorted.
	// Decision `files` citations are validated against this list.
	EditedFiles []string `json:"edited_files"`
}

type Usage struct {
	InputTokens       int64 `json:"input_tokens"`
	CachedInputTokens int64 `json:"cached_input_tokens"`
	OutputTokens      int64 `json:"output_tokens"`
}

type Who string