agentrequests

type Answer struct {
	Options []int  `json:"options,omitempty"`
	Text    string `json:"text,omitempty"`
}

type Ask struct {
	Agent     string `json:"agent"`
	SessionID string `json:"session_id"`
	// AgentID is the Claude Code subagent asking, empty for the session's
	// main agent: the main turn's boundaries leave its requests alone.
	AgentID string `json:"agent_id,omitempty"`
	Kind    string `json:"kind"`
	Tool    string `json:"tool"`
	// Digest is Digest of the tool's name and input, which the session's
	// post-tool-use (or post-tool-use-failure) event carries once the tool
	// ran.
	Digest string `json:"digest,omitempty"`
	// StartedAt is when the hook started: a turn boundary or a finished
	// tool call recorded since makes the request moot.
	StartedAt   time.Time  `json:"started_at"`
	Input       []Row      `json:"input,omitempty"`
	Suggestions []string   `json:"suggestions,omitempty"`
	Questions   []Question `json:"questions,omitempty"`
}

type BadRequestError struct{ Reason string }

type Decision struct {
	Behavior string `json:"behavior,omitempty"`
	// Suggestion is the index of the permission suggestion to apply.
	Suggestion *int `json:"suggestion,omitempty"`
	// Answers holds one answer per question, in order.
	Answers []Answer `json:"answers,omitempty"`
}

type Message struct {
	Agent     string    `json:"agent"`
	SessionID string    `json:"session_id"`
	Text      string    `json:"text"`
	QueuedAt  time.Time `json:"queued_at"`
}

type Option struct {
	Label       string `json:"label"`
	Description string `json:"description,omitempty"`
}

type Question struct {
	Question    string   `json:"question"`
	Header      string   `json:"header,omitempty"`
	MultiSelect bool     `json:"multi_select"`
	Options     []Option `json:"options"`
}

type Reply struct {
	Behavior   string `json:"behavior"`
	Suggestion string `json:"suggestion,omitempty"`
	// Answers maps a question's text, as shown, to the label chosen (labels
	// joined by ", " for several) or to text the user wrote.
	Answers map[string]string `json:"answers,omitempty"`
}

type Request struct {
	ID          string       `json:"id"`
	Agent       string       `json:"agent"`
	SessionID   string       `json:"session_id"`
	Kind        string       `json:"kind"`
	Tool        string       `json:"tool"`
	CreatedAt   time.Time    `json:"created_at"`
	Input       []Row        `json:"input"`
	Suggestions []Suggestion `json:"suggestions"`
	Questions   []Question   `json:"questions"`
}

type Row struct {
	Label string `json:"label"`
	Value string `json:"value"`
	// Code renders the value monospace.
	Code bool `json:"code,omitempty"`
}

type Sessions interface {
	Lookup(agent, id string) (livesessions.Session, string, bool)
}

type Settings struct {
	// CodexApprovals lets the app answer Codex's permission requests. Codex
	// hides its own prompt while the hook waits, so it is off unless chosen.
	CodexApprovals bool `json:"codex_approvals"`
}

type Store struct {
	// Sessions decides which sessions can be sent a message.
	Sessions Sessions
	// Mask masks what an agent wrote, as transcripts are masked; nil keeps
	// it.
	Mask func(string) string
	// Notify is called after the requests or messages changed. It must not
	// block.
	Notify func()
	// Database is the application database path; empty keeps settings in memory.
	Database string
	// CodexWait replaces DefaultCodexWait.
	CodexWait time.Duration
	// Interrupted, when set, is told of a Claude Code session whose main
	// agent's request ended with its hook well before ClaudeHold: Claude
	// Code kills the hook when the user turns the request down in the
	// terminal, which interrupts the turn without a stop.
	Interrupted func(agent, session string, at time.Time)
	// Answered, when set, is told of a session the app answered a request
	// of: it works again, though the agent reports nothing until the tool
	// call ends.
	Answered func(agent, session string, at time.Time)
	// Resumed, when set, is told of a session whose Stop hook was handed
	// the message queued for it: the agent goes on with its turn, though it
	// may report nothing until it calls a tool or stops again.
	Resumed func(agent, session string, at time.Time)
	// Now is the clock; nil is time.Now.
	Now func() time.Time
	Log *slog.Logger
	// contains filtered or unexported fields
}

type Suggestion struct {
	ID    string `json:"id"`
	Label string `json:"label"`
}

type TakeParams struct {
	Agent     string `json:"agent"`
	SessionID string `json:"session_id"`
}

type Taken struct {
	Text string `json:"text,omitempty"`
}