api

type AdminChecksOverrideJSONRequestBody = AdminChecksOverrideRequest

type AdminChecksOverrideRequest struct {
	Check       string `json:"check"`
	Conclusion  string `json:"conclusion"`
	Environment string `json:"environment"`
	Pr          int    `json:"pr"`
	Reason      string `json:"reason"`
}

type AdminChecksOverrideResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type AdminExecutionsCancelJSONRequestBody = AdminExecutionsCancelRequest

type AdminExecutionsCancelRequest struct {
	Id     string `json:"id"`
	Reason string `json:"reason"`
}

type AdminExecutionsCancelResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type AdminGatesSatisfyJSONRequestBody = AdminGatesSatisfyRequest

type AdminGatesSatisfyRequest struct {
	Class       string `json:"class"`
	Environment string `json:"environment"`
	Pr          int    `json:"pr"`
	Reason      string `json:"reason"`
	Target      string `json:"target"`
}

type AdminGatesSatisfyResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type AdminGrantsReleaseJSONRequestBody = AdminGrantsReleaseRequest

type AdminGrantsReleaseRequest struct {
	Class       string `json:"class"`
	Environment string `json:"environment"`
	Pr          int    `json:"pr"`
	Reason      string `json:"reason"`
	Target      string `json:"target"`
}

type AdminGrantsReleaseResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type AppendLogsJSONRequestBody = LogChunk

type AppendLogsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type Catalog struct {
	Components []CatalogComponent `json:"components"`
	Edges      []CatalogEdge      `json:"edges"`
}

type CatalogComponent struct {
	Id      string   `json:"id"`
	Stacks  []string `json:"stacks"`
	Watches []string `json:"watches"`
}

type CatalogEdge struct {
	From string `json:"from"`
	Kind string `json:"kind"`
	To   string `json:"to"`
}

type Category = events.Category

type ChangeReason struct {
	Kind  string   `json:"kind"`
	Stack string   `json:"stack"`
	Via   []string `json:"via"`
}

type CheckGateJSONRequestBody = GateCheck

type CheckGateResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *GateCheckOK
	JSON409      *CodedError
	JSON500      *CodedError
	JSON503      *CodedError
}

type Claim = events.Claim

type ClaimsListRequest struct {
	Environment string `json:"environment"`
}

type ClaimsReleaseRequest struct {
	Environment string `json:"environment"`
	Pr          int    `json:"pr"`

	// Stack Empty releases all of the PR's claims in the environment.
	Stack string `json:"stack"`
}

type Client struct {
	// The endpoint of the server conforming to this interface, with scheme,
	// https://api.deepmap.com for example. This can contain a path relative
	// to the server, such as https://api.deepmap.com/dev-test, and all the
	// paths in the swagger spec will be appended to the server.
	Server string

	// Doer for performing requests, typically a *http.Client with any
	// customized settings, such as certificate chains.
	Client HttpRequestDoer

	// A list of callbacks for modifying requests which are generated before sending over
	// the network.
	RequestEditors []RequestEditorFn
}

type ClientInterface interface {
	// AdminChecksOverrideWithBody request with any body
	AdminChecksOverrideWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	AdminChecksOverride(ctx context.Context, body AdminChecksOverrideJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// AdminExecutionsCancelWithBody request with any body
	AdminExecutionsCancelWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	AdminExecutionsCancel(ctx context.Context, body AdminExecutionsCancelJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// AdminGatesSatisfyWithBody request with any body
	AdminGatesSatisfyWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	AdminGatesSatisfy(ctx context.Context, body AdminGatesSatisfyJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// AdminGrantsReleaseWithBody request with any body
	AdminGrantsReleaseWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	AdminGrantsRelease(ctx context.Context, body AdminGrantsReleaseJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListApprovals request
	ListApprovals(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetCatalog request
	GetCatalog(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListClaimsWithBody request with any body
	ListClaimsWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	ListClaims(ctx context.Context, body ListClaimsJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ReleaseClaimsWithBody request with any body
	ReleaseClaimsWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	ReleaseClaims(ctx context.Context, body ReleaseClaimsJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetExecution request
	GetExecution(ctx context.Context, id string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListExecutions request
	ListExecutions(ctx context.Context, params *ListExecutionsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// FinalizeExecutionWithBody request with any body
	FinalizeExecutionWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	FinalizeExecution(ctx context.Context, body FinalizeExecutionJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// CheckGateWithBody request with any body
	CheckGateWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	CheckGate(ctx context.Context, body CheckGateJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ReconcileGates request
	ReconcileGates(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// RevokeGateWithBody request with any body
	RevokeGateWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	RevokeGate(ctx context.Context, body RevokeGateJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// InitExecutionWithBody request with any body
	InitExecutionWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	InitExecution(ctx context.Context, body InitExecutionJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// InspectClaims request
	InspectClaims(ctx context.Context, env string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// InspectEvents request
	InspectEvents(ctx context.Context, stream string, params *InspectEventsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// InspectGate request
	InspectGate(ctx context.Context, pr int, env string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// InspectGrants request
	InspectGrants(ctx context.Context, params *InspectGrantsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// InspectOverview request
	InspectOverview(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// InspectPool request
	InspectPool(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetLifecycle request
	GetLifecycle(ctx context.Context, params *GetLifecycleParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// AppendLogsWithBody request with any body
	AppendLogsWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	AppendLogs(ctx context.Context, body AppendLogsJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// MergeQueue request
	MergeQueue(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ReportPhaseWithBody request with any body
	ReportPhaseWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	ReportPhase(ctx context.Context, body ReportPhaseJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetPR request
	GetPR(ctx context.Context, n int, reqEditors ...RequestEditorFn) (*http.Response, error)

	// UpdateStackWithBody request with any body
	UpdateStackWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	UpdateStack(ctx context.Context, body UpdateStackJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)
}

type ClientOption func(*Client) error

type ClientWithResponses struct {
	ClientInterface
}

type ClientWithResponsesInterface interface {
	// AdminChecksOverrideWithBodyWithResponse request with any body
	AdminChecksOverrideWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*AdminChecksOverrideResponse, error)

	AdminChecksOverrideWithResponse(ctx context.Context, body AdminChecksOverrideJSONRequestBody, reqEditors ...RequestEditorFn) (*AdminChecksOverrideResponse, error)

	// AdminExecutionsCancelWithBodyWithResponse request with any body
	AdminExecutionsCancelWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*AdminExecutionsCancelResponse, error)

	AdminExecutionsCancelWithResponse(ctx context.Context, body AdminExecutionsCancelJSONRequestBody, reqEditors ...RequestEditorFn) (*AdminExecutionsCancelResponse, error)

	// AdminGatesSatisfyWithBodyWithResponse request with any body
	AdminGatesSatisfyWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*AdminGatesSatisfyResponse, error)

	AdminGatesSatisfyWithResponse(ctx context.Context, body AdminGatesSatisfyJSONRequestBody, reqEditors ...RequestEditorFn) (*AdminGatesSatisfyResponse, error)

	// AdminGrantsReleaseWithBodyWithResponse request with any body
	AdminGrantsReleaseWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*AdminGrantsReleaseResponse, error)

	AdminGrantsReleaseWithResponse(ctx context.Context, body AdminGrantsReleaseJSONRequestBody, reqEditors ...RequestEditorFn) (*AdminGrantsReleaseResponse, error)

	// ListApprovalsWithResponse request
	ListApprovalsWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*ListApprovalsResponse, error)

	// GetCatalogWithResponse request
	GetCatalogWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*GetCatalogResponse, error)

	// ListClaimsWithBodyWithResponse request with any body
	ListClaimsWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*ListClaimsResponse, error)

	ListClaimsWithResponse(ctx context.Context, body ListClaimsJSONRequestBody, reqEditors ...RequestEditorFn) (*ListClaimsResponse, error)

	// ReleaseClaimsWithBodyWithResponse request with any body
	ReleaseClaimsWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*ReleaseClaimsResponse, error)

	ReleaseClaimsWithResponse(ctx context.Context, body ReleaseClaimsJSONRequestBody, reqEditors ...RequestEditorFn) (*ReleaseClaimsResponse, error)

	// GetExecutionWithResponse request
	GetExecutionWithResponse(ctx context.Context, id string, reqEditors ...RequestEditorFn) (*GetExecutionResponse, error)

	// ListExecutionsWithResponse request
	ListExecutionsWithResponse(ctx context.Context, params *ListExecutionsParams, reqEditors ...RequestEditorFn) (*ListExecutionsResponse, error)

	// FinalizeExecutionWithBodyWithResponse request with any body
	FinalizeExecutionWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*FinalizeExecutionResponse, error)

	FinalizeExecutionWithResponse(ctx context.Context, body FinalizeExecutionJSONRequestBody, reqEditors ...RequestEditorFn) (*FinalizeExecutionResponse, error)

	// CheckGateWithBodyWithResponse request with any body
	CheckGateWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*CheckGateResponse, error)

	CheckGateWithResponse(ctx context.Context, body CheckGateJSONRequestBody, reqEditors ...RequestEditorFn) (*CheckGateResponse, error)

	// ReconcileGatesWithResponse request
	ReconcileGatesWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*ReconcileGatesResponse, error)

	// RevokeGateWithBodyWithResponse request with any body
	RevokeGateWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*RevokeGateResponse, error)

	RevokeGateWithResponse(ctx context.Context, body RevokeGateJSONRequestBody, reqEditors ...RequestEditorFn) (*RevokeGateResponse, error)

	// InitExecutionWithBodyWithResponse request with any body
	InitExecutionWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*InitExecutionResponse, error)

	InitExecutionWithResponse(ctx context.Context, body InitExecutionJSONRequestBody, reqEditors ...RequestEditorFn) (*InitExecutionResponse, error)

	// InspectClaimsWithResponse request
	InspectClaimsWithResponse(ctx context.Context, env string, reqEditors ...RequestEditorFn) (*InspectClaimsResponse, error)

	// InspectEventsWithResponse request
	InspectEventsWithResponse(ctx context.Context, stream string, params *InspectEventsParams, reqEditors ...RequestEditorFn) (*InspectEventsResponse, error)

	// InspectGateWithResponse request
	InspectGateWithResponse(ctx context.Context, pr int, env string, reqEditors ...RequestEditorFn) (*InspectGateResponse, error)

	// InspectGrantsWithResponse request
	InspectGrantsWithResponse(ctx context.Context, params *InspectGrantsParams, reqEditors ...RequestEditorFn) (*InspectGrantsResponse, error)

	// InspectOverviewWithResponse request
	InspectOverviewWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*InspectOverviewResponse, error)

	// InspectPoolWithResponse request
	InspectPoolWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*InspectPoolResponse, error)

	// GetLifecycleWithResponse request
	GetLifecycleWithResponse(ctx context.Context, params *GetLifecycleParams, reqEditors ...RequestEditorFn) (*GetLifecycleResponse, error)

	// AppendLogsWithBodyWithResponse request with any body
	AppendLogsWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*AppendLogsResponse, error)

	AppendLogsWithResponse(ctx context.Context, body AppendLogsJSONRequestBody, reqEditors ...RequestEditorFn) (*AppendLogsResponse, error)

	// MergeQueueWithResponse request
	MergeQueueWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*MergeQueueResponse, error)

	// ReportPhaseWithBodyWithResponse request with any body
	ReportPhaseWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*ReportPhaseResponse, error)

	ReportPhaseWithResponse(ctx context.Context, body ReportPhaseJSONRequestBody, reqEditors ...RequestEditorFn) (*ReportPhaseResponse, error)

	// GetPRWithResponse request
	GetPRWithResponse(ctx context.Context, n int, reqEditors ...RequestEditorFn) (*GetPRResponse, error)

	// UpdateStackWithBodyWithResponse request with any body
	UpdateStackWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*UpdateStackResponse, error)

	UpdateStackWithResponse(ctx context.Context, body UpdateStackJSONRequestBody, reqEditors ...RequestEditorFn) (*UpdateStackResponse, error)
}

type CodedError struct {
	// Code e.g. GATE-001, GATE-002, GATE-003, SRV-001
	Code    string `json:"code"`
	Message string `json:"message"`
}

type Counts = events.Counts

type Edge = events.Edge

type ExecutionDetail struct {
	// CheckRunID A database nullable int64, serialized raw (historical accident, preserved for wire compatibility).
	CheckRunID     NullInt64 `json:"CheckRunID"`
	CreatedAt      time.Time `json:"CreatedAt"`
	Environment    string    `json:"Environment"`
	ID             string    `json:"ID"`
	LogURL         string    `json:"LogURL"`
	PR             int       `json:"PR"`
	Phase          string    `json:"Phase"`
	ProgressLabel  string    `json:"ProgressLabel"`
	ProgressPct    int       `json:"ProgressPct"`
	Repo           string    `json:"Repo"`
	ReportMarkdown string    `json:"ReportMarkdown"`
	Rev            int       `json:"Rev"`
	SHA            string    `json:"SHA"`

	// Status Execution-level status (in_progress/success/failure).
	Status        string             `json:"Status"`
	StatusContext string             `json:"StatusContext"`
	SupersededBy  string             `json:"SupersededBy"`
	ChangeReasons *[]ChangeReason    `json:"change_reasons,omitempty"`
	Gates         []StoredGateTarget `json:"gates"`

	// Graph The changed subgraph for one execution.
	Graph Graph `json:"graph"`

	// VerifyExecutionId Latest verify execution for the same (pr, environment), "" when none. Additive (2026-07) — snake_case unlike its legacy siblings.
	VerifyExecutionId string `json:"verify_execution_id"`
}

type ExecutionSummary struct {
	// Context The commit-status context the run drives (e.g. plan/<env>, apply/<env>, verify/<env>).
	Context     string    `json:"context"`
	CreatedAt   time.Time `json:"created_at"`
	Environment string    `json:"environment"`
	Id          string    `json:"id"`
	LogUrl      string    `json:"log_url"`

	// Phase Current lifecycle phase ("" before the first phase event).
	Phase string `json:"phase"`
	Pr    int    `json:"pr"`

	// ProgressLabel Dynamic progress label.
	ProgressLabel string `json:"progress_label"`

	// ProgressPct Dynamic progress percentage (0-100).
	ProgressPct int    `json:"progress_pct"`
	Repo        string `json:"repo"`
	Sha         string `json:"sha"`

	// Status Execution-level status (in_progress/success/failure).
	Status string `json:"status"`

	// SupersededBy Id of the execution that superseded this one ("" when live).
	SupersededBy string `json:"superseded_by"`
}

type Finalize = events.Finalize

type FinalizeExecutionJSONRequestBody = Finalize

type FinalizeExecutionResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type GateCheck = events.GateCheck

type GateCheckOK struct {
	// Requester Leased requester SA the apply impersonates; empty for a clean/no-gate pass.
	Requester string `json:"requester"`
}

type GateRevoke = events.GateRevoke

type GateTarget = events.GateTarget

type GetCatalogResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *Catalog
}

type GetExecutionResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *ExecutionDetail
}

type GetLifecycleParams struct {
	Pr int `form:"pr" json:"pr"`
}

type GetLifecycleResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *[]LifecyclePhase
}

type GetPRResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *PRView
}

type Graph = events.Graph

type HttpRequestDoer interface {
	Do(req *http.Request) (*http.Response, error)
}

type Init = events.Init

type InitExecutionJSONRequestBody = Init

type InitExecutionResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type InspectClaim struct {
	ExpiresAt time.Time `json:"expires_at"`
	Pr        int       `json:"pr"`
	Stack     string    `json:"stack"`
}

type InspectClaimsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *InspectClaimsSet
}

type InspectClaimsSet struct {
	Claims      []InspectClaim `json:"claims"`
	Environment string         `json:"environment"`
}

type InspectEvent struct {
	Data       json.RawMessage `json:"data"`
	OccurredAt time.Time       `json:"occurred_at"`
	Type       string          `json:"type"`
	Version    int             `json:"version"`
}

type InspectEventsParams struct {
	After *int `form:"after,omitempty" json:"after,omitempty"`
}

type InspectEventsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *[]InspectEvent
}

type InspectGateDetail struct {
	Environment string              `json:"environment"`
	GateState   string              `json:"gate_state"`
	Pr          int                 `json:"pr"`
	Reasons     []InspectGateReason `json:"reasons"`
	Targets     []InspectGateTarget `json:"targets"`
}

type InspectGateReason struct {
	Description string    `json:"description"`
	EventType   string    `json:"event_type"`
	OccurredAt  time.Time `json:"occurred_at"`
}

type InspectGateResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *InspectGateDetail
}

type InspectGateTarget struct {
	Class     string `json:"class"`
	GrantName string `json:"grant_name"`
	Requester string `json:"requester"`
	State     string `json:"state"`
	Target    string `json:"target"`
}

type InspectGrant struct {
	ActualState   *string `json:"actual_state,omitempty"`
	Class         string  `json:"class"`
	DriftDetected *bool   `json:"drift_detected,omitempty"`
	Environment   string  `json:"environment"`
	GrantName     string  `json:"grant_name"`
	Pr            int     `json:"pr"`
	Requester     string  `json:"requester"`
	State         string  `json:"state"`
	Target        string  `json:"target"`
}

type InspectGrantsParams struct {
	State *string `form:"state,omitempty" json:"state,omitempty"`
	Live  *int    `form:"live,omitempty" json:"live,omitempty"`
}

type InspectGrantsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *[]InspectGrant
}

type InspectOverviewResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *[]InspectPRSummary
}

type InspectPRSummary struct {
	Claims     []InspectClaim     `json:"claims"`
	Executions []ExecutionSummary `json:"executions"`
	GateState  string             `json:"gate_state"`

	// Meta PR-level identity as last reported by the GitHub webhook (title, author, branch, automerge).
	Meta       *PRMeta        `json:"meta,omitempty"`
	OpenGrants []InspectGrant `json:"open_grants"`
	Pr         int            `json:"pr"`
	Repo       string         `json:"repo"`
}

type InspectPoolResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *InspectPoolSet
}

type InspectPoolSet struct {
	Environment string                 `json:"environment"`
	Slots       []InspectPoolSlot      `json:"slots"`
	Waiting     []InspectPoolWaitingPR `json:"waiting"`
}

type InspectPoolSlot struct {
	ElapsedSeconds *int    `json:"elapsed_seconds,omitempty"`
	Environment    *string `json:"environment,omitempty"`
	GrantName      *string `json:"grant_name,omitempty"`
	Occupied       bool    `json:"occupied"`
	Pr             *int    `json:"pr,omitempty"`
	Requester      string  `json:"requester"`
	State          *string `json:"state,omitempty"`
}

type InspectPoolWaitingPR struct {
	BlockerEnv  string `json:"blocker_env"`
	BlockerPr   int    `json:"blocker_pr"`
	Environment string `json:"environment"`
	Pr          int    `json:"pr"`
	Reason      string `json:"reason"`
}

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type LifecyclePhase struct {
	// Context plan | apply | verify | gate
	Context *string `json:"context,omitempty"`

	// Detail Human sub-phase currently running inside this segment (e.g. "warming caches" while the apply segment prepares). Only set on the "now" segment when the raw phase is finer than the segment.
	Detail  *string    `json:"detail,omitempty"`
	EndedAt *time.Time `json:"ended_at,omitempty"`

	// Key Canonical template key (prepare/init/moves/plan/classify/report/approve/apply/verify) or a raw dynamic phase name.
	Key string `json:"key"`

	// Label Human caption for the phase.
	Label string `json:"label"`

	// ProgressPct Within-segment completion percentage, derived from per-stack terminal statuses (k of N stacks). Only set on the "now" segment when real per-stack progress is known.
	ProgressPct *int `json:"progress_pct,omitempty"`

	// Result Derived summary (rollup counts / gate count / wait reason).
	Result    *string    `json:"result,omitempty"`
	StartedAt *time.Time `json:"started_at,omitempty"`

	// State done | now | pending | failed
	State string `json:"state"`
}

type ListApprovalsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *[]PendingApproval
}

type ListClaimsJSONRequestBody = ClaimsListRequest

type ListClaimsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *[]Claim
}

type ListExecutionsParams struct {
	// Pr Only executions for this pull request.
	Pr    *int `form:"pr,omitempty" json:"pr,omitempty"`
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
}

type ListExecutionsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *[]ExecutionSummary
}

type LogChunk = events.LogChunk

type MergeQueue struct {
	// Branch The queued branch (default branch); "" when unknown.
	Branch  string            `json:"branch"`
	Entries []MergeQueueEntry `json:"entries"`
}

type MergeQueueEntry struct {
	Position int `json:"position"`
	Pr       int `json:"pr"`

	// State GitHub MergeQueueEntryState (QUEUED, MERGEABLE, AWAITING_CHECKS, LOCKED, UNMERGEABLE).
	State string `json:"state"`
}

type MergeQueueResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *MergeQueue
}

type MiddlewareFunc func(http.Handler) http.Handler

type NullInt64 struct {
	Int64 int64 `json:"Int64"`
	Valid bool  `json:"Valid"`
}

type PRMergeState struct {
	// Blocker Short human-readable blocker reason ("" when not blocked).
	Blocker string `json:"blocker"`

	// CheckConclusion GitHub check conclusion vocabulary; "" means still in progress.
	CheckConclusion string `json:"check_conclusion"`

	// Environment This serve's tier (empty when the tier has none configured).
	Environment  string `json:"environment"`
	MergeBlocked bool   `json:"merge_blocked"`

	// RequiredCheck The check name that gates merge (e.g. apply-lock/<env> or terraform/<env>).
	RequiredCheck string `json:"required_check"`
}

type PRMeta struct {
	AuthorLogin string `json:"author_login"`
	AutoMerge   bool   `json:"auto_merge"`
	Body        string `json:"body"`
	HeadRef     string `json:"head_ref"`
	Title       string `json:"title"`
	Url         string `json:"url"`
}

type PRView struct {
	// Merge A PR's merge-readiness on this serve's tier.
	Merge PRMergeState `json:"merge"`

	// Meta PR-level identity as last reported by the GitHub webhook (title, author, branch, automerge).
	Meta *PRMeta `json:"meta,omitempty"`
	Pr   int     `json:"pr"`

	// Repo Repo of the PR's latest execution ("" when none).
	Repo string `json:"repo"`
}

type PendingApproval struct {
	Class       string `json:"class"`
	Environment string `json:"environment"`

	// GrantName The approval-backend grant resource name ("" until a grant exists).
	GrantName string `json:"grant_name"`
	Pr        int    `json:"pr"`

	// Repo Repo of the PR's latest execution in this environment ("" when none).
	Repo string `json:"repo"`

	// Requester Leased requester SA for this grant.
	Requester string `json:"requester"`

	// State Backend grant state (e.g. AWAITING, ACTIVATING, DENIED, REVOKED).
	State  string `json:"state"`
	Target string `json:"target"`
}

type Phase = events.Phase

type PhaseEvent = events.PhaseEvent

type ReconcileGatesResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type ReleaseClaimsJSONRequestBody = ClaimsReleaseRequest

type ReleaseClaimsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type ReportPhaseJSONRequestBody = PhaseEvent

type ReportPhaseResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type RequestEditorFn func(ctx context.Context, req *http.Request) error

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type RevokeGateJSONRequestBody = GateRevoke

type RevokeGateResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type ServeMux interface {
	HandleFunc(pattern string, handler func(http.ResponseWriter, *http.Request))
	http.Handler
}

type ServerInterface interface {
	// Admin override a check conclusion
	// (POST /api/admin/checks/override)
	AdminChecksOverride(w http.ResponseWriter, r *http.Request)
	// Admin cancel a running execution
	// (POST /api/admin/executions/cancel)
	AdminExecutionsCancel(w http.ResponseWriter, r *http.Request)
	// Admin satisfy a gate target manually
	// (POST /api/admin/gates/satisfy)
	AdminGatesSatisfy(w http.ResponseWriter, r *http.Request)
	// Admin release a gate grant
	// (POST /api/admin/grants/release)
	AdminGrantsRelease(w http.ResponseWriter, r *http.Request)
	// List gate targets awaiting human action, across all PRs
	// (GET /api/approvals)
	ListApprovals(w http.ResponseWriter, r *http.Request)
	// Retrieve the compiled component catalog of the main branch
	// (GET /api/catalog)
	GetCatalog(w http.ResponseWriter, r *http.Request)
	// List the apply-lock claims for an environment
	// (POST /api/claims/list)
	ListClaims(w http.ResponseWriter, r *http.Request)
	// Admin-release one stack's claim or all of a PR's claims
	// (POST /api/claims/release)
	ReleaseClaims(w http.ResponseWriter, r *http.Request)
	// Read one execution's full state
	// (GET /api/execution/{id})
	GetExecution(w http.ResponseWriter, r *http.Request, id string)
	// List executions, newest first
	// (GET /api/executions)
	ListExecutions(w http.ResponseWriter, r *http.Request, params ListExecutionsParams)
	// Record the terminal plan state
	// (POST /api/finalize)
	FinalizeExecution(w http.ResponseWriter, r *http.Request)
	// Apply-time, fail-closed gate pre-check
	// (POST /api/gate/check)
	CheckGate(w http.ResponseWriter, r *http.Request)
	// Nudge an immediate reconcile of every pending gate
	// (POST /api/gate/reconcile)
	ReconcileGates(w http.ResponseWriter, r *http.Request)
	// Revoke the grants requested for (pr, environment)
	// (POST /api/gate/revoke)
	RevokeGate(w http.ResponseWriter, r *http.Request)
	// Register an execution and its changed subgraph
	// (POST /api/init)
	InitExecution(w http.ResponseWriter, r *http.Request)
	// Get folded claim set for an environment
	// (GET /api/inspect/claims/{env})
	InspectClaims(w http.ResponseWriter, r *http.Request, env string)
	// Get ordered events for a stream
	// (GET /api/inspect/events/{stream})
	InspectEvents(w http.ResponseWriter, r *http.Request, stream string, params InspectEventsParams)
	// Get gate state explainer and reason trail
	// (GET /api/inspect/gate/{pr}/{env})
	InspectGate(w http.ResponseWriter, r *http.Request, pr int, env string)
	// List all recorded grants
	// (GET /api/inspect/grants)
	InspectGrants(w http.ResponseWriter, r *http.Request, params InspectGrantsParams)
	// System-wide overview of all active PR states
	// (GET /api/inspect/overview)
	InspectOverview(w http.ResponseWriter, r *http.Request)
	// Get applier-pool slot occupancy and waiting lists
	// (GET /api/inspect/pool)
	InspectPool(w http.ResponseWriter, r *http.Request)
	// A PR's folded phase-timeline for this tier
	// (GET /api/lifecycle)
	GetLifecycle(w http.ResponseWriter, r *http.Request, params GetLifecycleParams)
	// Ingest a per-stack output chunk
	// (POST /api/logs)
	AppendLogs(w http.ResponseWriter, r *http.Request)
	// Read the repository's live GitHub merge queue (default branch)
	// (GET /api/merge-queue)
	MergeQueue(w http.ResponseWriter, r *http.Request)
	// Narrate a lifecycle phase transition
	// (POST /api/phase)
	ReportPhase(w http.ResponseWriter, r *http.Request)
	// Read a pull request's identity and per-tier merge state
	// (GET /api/pr/{n})
	GetPR(w http.ResponseWriter, r *http.Request, n int)
	// Tick a single stack's status
	// (POST /api/update)
	UpdateStack(w http.ResponseWriter, r *http.Request)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandlerFunc   func(w http.ResponseWriter, r *http.Request, err error)
}

type StackState = events.StackState

type Status = events.Status

type StdHTTPServerOptions struct {
	BaseURL          string
	BaseRouter       ServeMux
	Middlewares      []MiddlewareFunc
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type StoredGateTarget struct {
	Class string `json:"Class"`

	// GrantName The approval-backend grant resource name (may be empty).
	GrantName string `json:"GrantName"`

	// Requester Leased requester SA for this grant.
	Requester string `json:"Requester"`

	// State Backend grant state (e.g. REQUESTED, ACTIVE, DENIED, REVOKED).
	State  string `json:"State"`
	Target string `json:"Target"`
}

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}

type Update = events.Update

type UpdateStackJSONRequestBody = Update

type UpdateStackResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}