model

type ApprovalWrite struct {
	Outcome string `json:"outcome" jsonschema:"approved, unapproved, unchanged or dry_run"`
	Write
	IID           int64    `json:"iid"`
	SHA           string   `json:"sha" jsonschema:"The head the approval was given at; empty for unapprove"`
	YouApproved   bool     `json:"you_approved" jsonschema:"Whether your approval stands after the call"`
	Approved      bool     `json:"approved" jsonschema:"Whether the merge request's approval rules are met"`
	ApprovedBy    []string `json:"approved_by" jsonschema:"Usernames"`
	ApprovalsLeft *int     `json:"approvals_left" jsonschema:"Approvals still required; null where the tier has no approval rules"`
}

type Approvals struct {
	Approved   bool     `json:"approved"`
	Required   *int     `json:"required"`
	Left       *int     `json:"left"`
	ApprovedBy []string `json:"approved_by" jsonschema:"Usernames"`
}

type Artifact struct {
	Project ProjectRef `json:"project"`
	JobID   int64      `json:"job_id"`
	Path    string     `json:"path"`
	Size    int        `json:"size_bytes"`
	Binary  bool       `json:"binary" jsonschema:"True when the file is not text; only its size is returned"`
	// SecretsMasked counts the secret shapes replaced, as in a job log.
	SecretsMasked    int    `json:"secrets_masked" jsonschema:"Token and key shapes replaced with [MASKED kind]"`
	UntrustedContent string `json:"untrusted_content"`
	Budget           Budget `json:"content_budget"`
}

type ArtifactEntry struct {
	Path string `json:"path"`
	Type string `json:"type" jsonschema:"file or directory"`
	Size *int64 `json:"size_bytes"`
}

type Artifacts struct {
	Project ProjectRef      `json:"project"`
	JobID   int64           `json:"job_id"`
	Path    string          `json:"path" jsonschema:"The directory listed; empty for the top"`
	Entries []ArtifactEntry `json:"entries"`
	Listing Listing         `json:"listing"`
}

type Blame struct {
	Project ProjectRef   `json:"project"`
	Path    string       `json:"path"`
	Ref     string       `json:"ref"`
	Ranges  []BlameRange `json:"ranges"`
	// NextLine continues the blame after the budget.
	NextLine      *int `json:"next_line" jsonschema:"Pass as start_line to read on; null at the end of what was asked"`
	HiddenRemoved int  `json:"hidden_chars_removed"`
}

type BlameRange struct {
	StartLine        int       `json:"start_line"`
	EndLine          int       `json:"end_line"`
	CommitSHA        string    `json:"commit_sha"`
	Author           string    `json:"author_name"`
	AuthoredAt       time.Time `json:"authored_at"`
	UntrustedSummary string    `json:"untrusted_summary" jsonschema:"The commit's title"`
	UntrustedLines   string    `json:"untrusted_lines"`
}

type Branch struct {
	Name                 string    `json:"name"`
	Default              bool      `json:"default"`
	Protected            bool      `json:"protected"`
	Merged               bool      `json:"merged"`
	CanPush              bool      `json:"can_push" jsonschema:"Whether the signed-in account may push to it"`
	CommitID             string    `json:"commit_id"`
	CommittedAt          time.Time `json:"committed_at"`
	UntrustedCommitTitle string    `json:"untrusted_commit_title"`
}

type BranchDelete struct {
	Outcome string `json:"outcome" jsonschema:"deleted or dry_run"`
	Write
	Branch string `json:"branch"`
	SHA    string `json:"sha" jsonschema:"The head the branch had when it was deleted"`
	Merged bool   `json:"merged" jsonschema:"Whether GitLab counted it merged into the default branch"`
}

type BranchWrite struct {
	Outcome string `json:"outcome" jsonschema:"created or dry_run"`
	Write
	Branch    string `json:"branch"`
	CommitSHA string `json:"commit_sha" jsonschema:"The commit the branch points at"`
	Protected bool   `json:"protected"`
	WebURL    string `json:"web_url"`
}

type Branches struct {
	Project  ProjectRef `json:"project"`
	Branches []Branch   `json:"branches"`
	Listing  Listing    `json:"listing"`
}

type Budget struct {
	BudgetChars int `json:"budget_chars" jsonschema:"The most characters this result shows of the text"`
	TotalChars  int `json:"total_chars" jsonschema:"The text's length in characters, after hidden text was removed"`
	Offset      int `json:"offset" jsonschema:"The character offset the shown part starts at"`
	ShownChars  int `json:"shown_chars"`
	// ContinueOffset is where to continue from, null when the text was
	// shown to its end.
	ContinueOffset *int `json:"continue_offset" jsonschema:"Pass as offset to read on; null when shown to the end"`
	// HiddenRemoved counts characters dropped or made visible because a
	// reader of the rendered page would not see them (§4.1.2).
	HiddenRemoved int `` /* 126-byte string literal not displayed */
}

type CommentDelete struct {
	Outcome string `json:"outcome" jsonschema:"deleted or dry_run"`
	Write
	Type   string `json:"type" jsonschema:"issue or merge_request"`
	IID    int64  `json:"iid"`
	NoteID int64  `json:"note_id"`
}

type CommentWrite struct {
	Outcome string `json:"outcome" jsonschema:"created or dry_run"`
	Write
	// Kind is comment, thread, reply or draft.
	Kind         string        `` /* 138-byte string literal not displayed */
	NoteID       int64         `json:"note_id" jsonschema:"The comment's id; for a draft, the draft's id"`
	DiscussionID string        `` /* 184-byte string literal not displayed */
	Position     *DiffPosition `json:"position" jsonschema:"Where on the diff it landed, as GitLab stored it; null for a comment not on a line"`
	LineRange    *LineSpan     `json:"line_range" jsonschema:"The lines a multi-line comment covers; null for one line"`
	LineCode     string        `` /* 137-byte string literal not displayed */
}

type Commit struct {
	Project          ProjectRef   `json:"project"`
	ID               string       `json:"id"`
	ShortID          string       `json:"short_id"`
	WebURL           string       `json:"web_url"`
	AuthorName       string       `json:"author_name"`
	AuthoredAt       time.Time    `json:"authored_at"`
	CommitterName    string       `json:"committer_name"`
	CommittedAt      time.Time    `json:"committed_at"`
	ParentIDs        []string     `json:"parent_ids"`
	Additions        int          `json:"additions"`
	Deletions        int          `json:"deletions"`
	UntrustedMessage string       `json:"untrusted_message"`
	MessageBudget    Budget       `json:"message_budget" jsonschema:"What part of the message is shown; pass continue_offset as message_offset to read on"`
	Files            []FileDiff   `json:"files" jsonschema:"Changed files whose diff fit the budget"`
	NotShown         []FileChange `json:"files_not_shown" jsonschema:"Changed files left out by the budget or cut by GitLab"`
	FilesComplete    bool         `json:"files_complete" jsonschema:"False when the commit changes more files than were read"`
	NextFileOffset   *int         `json:"next_file_offset" jsonschema:"Pass as file_offset to see the diffs left out by the budget; null when none were"`
	DiffBudget       int          `json:"diff_budget_chars"`
	// HiddenRemoved counts the hidden characters made visible in the
	// diffs shown; the message's are in MessageBudget.
	HiddenRemoved int `json:"hidden_chars_removed"`
}

type CommitRow struct {
	ID             string    `json:"id"`
	ShortID        string    `json:"short_id"`
	AuthorName     string    `json:"author_name"`
	AuthoredAt     time.Time `json:"authored_at"`
	CommittedAt    time.Time `json:"committed_at"`
	Parents        int       `json:"parents"`
	UntrustedTitle string    `json:"untrusted_title"`
}

type CommitWrite struct {
	Outcome string `json:"outcome" jsonschema:"created or dry_run"`
	Write
	SHA        string   `json:"sha"`
	ShortID    string   `json:"short_id"`
	Branch     string   `json:"branch"`
	BranchHead string   `json:"branch_head" jsonschema:"The branch's head read after the commit"`
	ParentIDs  []string `json:"parent_ids"`
	Additions  int      `json:"additions"`
	Deletions  int      `json:"deletions"`
	Files      []string `json:"files" jsonschema:"The paths the commit touched"`
	WebURL     string   `json:"web_url"`
}

type Commits struct {
	Project ProjectRef  `json:"project"`
	Ref     string      `json:"ref"`
	Commits []CommitRow `json:"commits"`
	Listing Listing     `json:"listing"`
}

type Compare struct {
	Project  ProjectRef `json:"project"`
	From     string     `json:"from"`
	To       string     `json:"to"`
	Straight bool       `json:"straight" jsonschema:"True: from and to compared directly; false: from their merge base, as a merge request compares"`
	WebURL   string     `json:"web_url"`
	SameRef  bool       `json:"same_ref" jsonschema:"from and to are the same commit"`
	// Timeout is GitLab giving up on the comparison: the commits and
	// diffs are then empty, not absent.
	Timeout bool        `json:"timeout" jsonschema:"GitLab gave up on the comparison; the commits and diffs it returned are not the whole answer"`
	Commits []CommitRow `json:"commits" jsonschema:"Commits in to that are not in from, from commit_offset"`
	// CommitsTotal counts every commit GitLab returned.
	CommitsTotal     int  `json:"commits_total"`
	NextCommitOffset *int `json:"next_commit_offset" jsonschema:"Pass as commit_offset to see more commits; null when none are left"`
	Diffs
}

type DeploymentRef struct {
	ID        int64     `json:"id"`
	IID       int64     `json:"iid"`
	Status    string    `json:"status"`
	Ref       string    `json:"ref"`
	SHA       string    `json:"sha"`
	CreatedAt time.Time `json:"created_at"`
}

type DeploymentRow struct {
	ID          int64      `json:"id"`
	IID         int64      `json:"iid"`
	Status      string     `json:"status"`
	Environment string     `json:"environment"`
	Ref         string     `json:"ref"`
	SHA         string     `json:"sha"`
	User        string     `json:"user" jsonschema:"Username of who deployed"`
	JobID       int64      `json:"job_id" jsonschema:"The job that deployed; 0 when none"`
	JobName     string     `json:"job_name"`
	CreatedAt   time.Time  `json:"created_at"`
	UpdatedAt   *time.Time `json:"updated_at"`
}

type Deployments struct {
	Project     ProjectRef      `json:"project"`
	Deployments []DeploymentRow `json:"deployments"`
	Listing     Listing         `json:"listing"`
}

type DiffPosition struct {
	OldPath string `json:"old_path"`
	NewPath string `json:"new_path"`
	OldLine *int   `json:"old_line"`
	NewLine *int   `json:"new_line"`
	HeadSHA string `json:"head_sha"`
}

type DiffRefs struct {
	BaseSHA  string `json:"base_sha"`
	StartSHA string `json:"start_sha"`
	HeadSHA  string `json:"head_sha"`
}

type Diffs struct {
	Files          []FileDiff   `json:"files" jsonschema:"Changed files whose diff fit the budget"`
	NotShown       []FileChange `json:"files_not_shown" jsonschema:"Changed files left out by the budget or cut by GitLab"`
	FilesComplete  bool         `json:"files_complete" jsonschema:"False when there are more changed files than were read"`
	NextFileOffset *int         `json:"next_file_offset" jsonschema:"Pass as file_offset to see the diffs left out by the budget; null when none were"`
	DiffBudget     int          `json:"diff_budget_chars"`
	HiddenRemoved  int          `json:"hidden_chars_removed" jsonschema:"Zero-width and bidirectional-control characters in the diffs shown, made visible"`
}

type DiscussionSummary struct {
	// Known is false when the threads could not be read; the counts are
	// then zero and mean nothing.
	Known        bool       `json:"known"`
	Threads      int        `json:"threads" jsonschema:"Threads with at least one comment written by a person"`
	Unresolved   int        `json:"unresolved" jsonschema:"Resolvable threads not yet resolved"`
	LastActivity *time.Time `json:"last_activity"`
	// Complete is false when there were more threads than were read.
	Complete bool `json:"complete"`
}

type DiscussionWrite struct {
	Outcome string `json:"outcome" jsonschema:"resolved, reopened, unchanged or dry_run"`
	Write
	DiscussionID string `json:"discussion_id"`
	Resolved     bool   `json:"resolved" jsonschema:"The thread's state after the call, as GitLab reported it"`
}

type Discussions struct {
	Project ProjectRef `json:"project"`
	IID     int64      `json:"iid"`
	Type    string     `json:"type" jsonschema:"issue or merge_request"`
	Threads []Thread   `json:"threads" jsonschema:"Newest activity first"`
	// NotShown lists the threads of this page the budget left out; they
	// come first on the next page.
	NotShown []ThreadStub `json:"not_shown" jsonschema:"Threads of this page left out by the character budget; the next page starts with them"`
	Budget   int          `json:"budget_chars"`
	Listing  Listing      `json:"listing"`
}

type DownstreamRow struct {
	ID        int64  `json:"id"`
	ProjectID int64  `json:"project_id" jsonschema:"The project it ran in, which may be another; get_pipeline with this id reads it"`
	Status    string `json:"status"`
	WebURL    string `json:"web_url"`
}

type DraftDelete struct {
	Outcome string `json:"outcome" jsonschema:"deleted or dry_run"`
	Write
	DraftID   int64 `json:"draft_id"`
	Remaining int   `json:"remaining" jsonschema:"Your drafts still on the merge request, read after the delete"`
}

type DraftNote struct {
	ID int64 `json:"id"`
	// DiscussionID is the thread it replies to, empty for a new one.
	DiscussionID      string        `json:"discussion_id" jsonschema:"The thread this draft replies to; empty for a new thread"`
	ResolveDiscussion bool          `json:"resolve_discussion" jsonschema:"Publishing it resolves the thread it replies to"`
	Position          *DiffPosition `json:"position" jsonschema:"Where an inline draft sits; null for a general one"`
	UntrustedBody     string        `json:"untrusted_body"`
	Budget            Budget        `json:"body_budget"`
}

type DraftNotes struct {
	Project ProjectRef  `json:"project"`
	IID     int64       `json:"iid"`
	Drafts  []DraftNote `json:"drafts"`
	// NotShown names the drafts the page budget left out.
	NotShown []int64 `json:"not_shown" jsonschema:"Ids of drafts left out by the character budget; the next page starts with them"`
	Budget   int     `json:"budget_chars"`
	Listing  Listing `json:"listing"`
}

type EnvironmentRow struct {
	ID             int64          `json:"id"`
	Name           string         `json:"name"`
	Slug           string         `json:"slug"`
	State          string         `json:"state" jsonschema:"available, stopping or stopped"`
	Tier           string         `json:"tier"`
	ExternalURL    string         `json:"external_url" jsonschema:"Where the environment is served, as the project configured it; never fetched"`
	UpdatedAt      time.Time      `json:"updated_at"`
	AutoStopAt     *time.Time     `json:"auto_stop_at"`
	LastDeployment *DeploymentRef `json:"last_deployment"`
}

type Environments struct {
	Project      ProjectRef       `json:"project"`
	Environments []EnvironmentRow `json:"environments"`
	Listing      Listing          `json:"listing"`
}

type EscapedLine struct {
	Input   string `json:"input" jsonschema:"The input the line was in"`
	Line    int    `json:"line" jsonschema:"The 1-based line number in that input"`
	Command string `json:"command" jsonschema:"The command name, without the slash"`
}

type EventRow struct {
	ID                   int64     `json:"id"`
	Action               string    `json:"action" jsonschema:"GitLab's action name, such as opened, commented on or pushed to"`
	TargetType           string    `json:"target_type" jsonschema:"Issue, MergeRequest, Note, DiffNote, Milestone, WikiPage::Meta and the like; empty for a push"`
	TargetID             *int64    `json:"target_id"`
	TargetIID            *int64    `json:"target_iid"`
	UntrustedTargetTitle string    `json:"untrusted_target_title"`
	Author               string    `json:"author" jsonschema:"Username"`
	ProjectID            *int64    `json:"project_id"`
	CreatedAt            time.Time `json:"created_at"`
	PushRef              string    `json:"push_ref" jsonschema:"For a push: the branch or tag"`
	PushCommits          int       `json:"push_commits" jsonschema:"For a push: how many commits"`
	UntrustedCommitTitle string    `json:"untrusted_commit_title" jsonschema:"For a push: the newest commit's title"`
}

type Events struct {
	Project *ProjectRef `json:"project" jsonschema:"The project listed; null for your own activity"`
	Events  []EventRow  `json:"events"`
	Listing Listing     `json:"listing"`
}

type File struct {
	Project ProjectRef `json:"project"`
	Path    string     `json:"path"`
	Ref     string     `json:"ref"`
	Size    int64      `json:"size_bytes"`
	BlobID  string     `json:"blob_id"`
	// LastCommitID is the witness an update or delete of this file
	// carries (§4.6).
	LastCommitID string `json:"last_commit_id" jsonschema:"The last commit that changed this file; the witness a later edit carries"`
	CommitID     string `json:"commit_id" jsonschema:"The commit the ref resolved to"`
	SHA256       string `json:"content_sha256"`
	Binary       bool   `json:"binary" jsonschema:"True when the content is not text; only metadata is returned"`
	ContentType  string `json:"content_type" jsonschema:"A guess from the first bytes"`
	// UntrustedContent is empty for a binary file.
	UntrustedContent string `json:"untrusted_content"`
	Budget           Budget `json:"content_budget"`
}

type FileChange struct {
	OldPath string `json:"old_path"`
	NewPath string `json:"new_path"`
	Status  string `json:"status" jsonschema:"added, deleted, renamed or modified"`
	// Reason says why its diff is not shown: budget, too_large or
	// collapsed.
	Reason string `json:"reason"`
}

type FileDiff struct {
	OldPath       string `json:"old_path"`
	NewPath       string `json:"new_path"`
	Status        string `json:"status"`
	UntrustedDiff string `json:"untrusted_diff"`
	// DiffOffset is where the text shown starts in this file's diff.
	DiffOffset int `` /* 127-byte string literal not displayed */
	// Truncated marks a single diff larger than the whole budget, cut
	// at it; ContinueDiffOffset reads on.
	Truncated          bool `json:"truncated" jsonschema:"True when this one diff was over the whole budget and was cut"`
	ContinueDiffOffset *int `` /* 150-byte string literal not displayed */
}

type InstanceInfo struct {
	URL string `json:"url"`
	// Known is false when /metadata could not be read.
	Known   bool   `json:"known"`
	Version string `json:"version"`
	Edition string `json:"edition" jsonschema:"Community or Enterprise"`
}

type Issue struct {
	Project        ProjectRef        `json:"project"`
	IID            int64             `json:"iid"`
	Reference      string            `json:"reference"`
	WebURL         string            `json:"web_url"`
	State          string            `json:"state"`
	Type           string            `json:"issue_type"`
	Confidential   bool              `json:"confidential"`
	Author         User              `json:"author"`
	Assignees      []User            `json:"assignees"`
	Labels         []string          `json:"labels"`
	Milestone      *Milestone        `json:"milestone"`
	CreatedAt      time.Time         `json:"created_at"`
	UpdatedAt      time.Time         `json:"updated_at" jsonschema:"The witness a later update carries"`
	ClosedAt       *time.Time        `json:"closed_at"`
	ClosedBy       *User             `json:"closed_by"`
	DueDate        *string           `json:"due_date" jsonschema:"A date, not an instant: 2026-10-01"`
	Tasks          *Tasks            `json:"tasks"`
	Discussions    DiscussionSummary `json:"discussions"`
	UntrustedTitle string            `json:"untrusted_title"`
	// UntrustedDescription is the part of the description the budget
	// allowed, with hidden text removed.
	UntrustedDescription string `json:"untrusted_description"`
	DescriptionBudget    Budget `json:"description_budget"`
}

type IssueLinkWrite struct {
	Outcome string `json:"outcome" jsonschema:"linked, unlinked, unchanged or dry_run"`
	Write
	IID           int64      `json:"iid"`
	TargetProject ProjectRef `json:"target_project"`
	TargetIID     int64      `json:"target_iid"`
	LinkID        int64      `json:"link_id" jsonschema:"The link's id; 0 when there is none"`
	LinkType      string     `json:"link_type" jsonschema:"relates_to, blocks or is_blocked_by, from the first issue's side"`
}

type IssueMove struct {
	Outcome string `json:"outcome" jsonschema:"moved or dry_run"`
	Write
	FromIID int64 `json:"from_iid" jsonschema:"The issue in the project it was moved from, which GitLab closes"`
	// To is the project it went to; IID and WebURL are the new issue's.
	To     ProjectRef `json:"to_project"`
	IID    int64      `json:"iid" jsonschema:"The new issue's number in the project it went to; 0 for a dry run"`
	WebURL string     `json:"web_url"`
	// ToVisibility is who can see the new issue.
	ToVisibility string `json:"to_visibility" jsonschema:"public, internal or private: who can see the issue where it went"`
}

type IssueWrite struct {
	Outcome string `json:"outcome" jsonschema:"created, updated, unchanged or dry_run"`
	Write
	IID          int64      `json:"iid"`
	WebURL       string     `json:"web_url"`
	State        string     `json:"state"`
	LabelsBefore []string   `json:"labels_before" jsonschema:"The labels before an update; empty for a create"`
	Labels       []string   `json:"labels" jsonschema:"The labels GitLab reported after the write"`
	Assignees    []string   `json:"assignees" jsonschema:"Usernames"`
	Milestone    *Milestone `json:"milestone"`
	DueDate      string     `json:"due_date"`
	Confidential bool       `json:"confidential"`
	UpdatedAt    *time.Time `json:"updated_at" jsonschema:"Pass as updated_at to the next update_issue"`
	// Changed names the fields that differ from before, as read back.
	Changed []string `json:"changed" jsonschema:"The fields whose value differs after the write, as GitLab reported it"`
	// DescriptionRemoved is set when a description was replaced.
	DescriptionRemoved *Removed `json:"description_removed" jsonschema:"What replacing the description took out; null when it was not replaced"`
}

type ItemList struct {
	Items   []ItemRow `json:"items"`
	Listing Listing   `json:"listing"`
}

type ItemRow struct {
	Project   ProjectRef `json:"project"`
	IID       int64      `json:"iid"`
	Reference string     `json:"reference" jsonschema:"GitLab's full reference, group/project#12 or group/project!12"`
	State     string     `json:"state"`
	Draft     bool       `json:"draft"`
	Author    string     `json:"author" jsonschema:"The author's username"`
	Labels    []string   `json:"labels"`
	CreatedAt time.Time  `json:"created_at"`
	UpdatedAt time.Time  `json:"updated_at"`
	// UntrustedTitle is shortened to one line.
	UntrustedTitle string `json:"untrusted_title"`
}

type JobLog struct {
	Project ProjectRef `json:"project"`
	Job     JobRow     `json:"job"`
	// TotalBytes is the stored log's size.
	TotalBytes int `json:"total_bytes"`
	// ByteOffset and ByteEnd bound the window shown, in the stored log.
	ByteOffset int `json:"byte_offset" jsonschema:"Where the window starts in the stored log"`
	ByteEnd    int `json:"byte_end" jsonschema:"Where the window ends in the stored log"`
	// PrevByteOffset and NextByteOffset continue backwards and forwards.
	PrevByteOffset *int `json:"prev_byte_offset" jsonschema:"Pass as byte_offset to read the part before this window; null at the start"`
	NextByteOffset *int `json:"next_byte_offset" jsonschema:"Pass as byte_offset to read the part after this window; null at the end"`
	// Section names the section failed_only jumped to.
	Section string `json:"section" jsonschema:"With failed_only, the log section the job failed in; empty otherwise"`
	// FailureNotFound is failed_only finding no failure line.
	FailureNotFound bool `json:"failure_not_found" jsonschema:"With failed_only, true when the log has no failure line and the tail is shown instead"`
	// SecretsMasked counts the secret shapes replaced with [MASKED …].
	SecretsMasked int    `json:"secrets_masked" jsonschema:"Token and key shapes replaced with [MASKED kind] in the window shown"`
	HiddenRemoved int    `json:"hidden_chars_removed" jsonschema:"Zero-width and bidirectional-control characters made visible"`
	UntrustedLog  string `json:"untrusted_log"`
}

type JobRow struct {
	ID            int64      `json:"id"`
	Name          string     `json:"name"`
	Stage         string     `json:"stage"`
	Status        string     `json:"status"`
	AllowFailure  bool       `json:"allow_failure" jsonschema:"A failure of this job does not fail the pipeline"`
	FailureReason string     `json:"failure_reason" jsonschema:"GitLab's reason for a failure, such as script_failure; empty otherwise"`
	CreatedAt     time.Time  `json:"created_at"`
	StartedAt     *time.Time `json:"started_at"`
	FinishedAt    *time.Time `json:"finished_at"`
	Duration      *float64   `json:"duration_seconds"`
	WebURL        string     `json:"web_url"`
}

type JobWrite struct {
	Outcome string `json:"outcome" jsonschema:"retried, played or dry_run"`
	Write
	JobID      int64    `json:"job_id" jsonschema:"The job that runs: for a retry, the new job GitLab made; for play, the job itself"`
	FromJobID  int64    `json:"from_job_id" jsonschema:"The job the call was given"`
	Name       string   `json:"name"`
	Stage      string   `json:"stage"`
	Status     string   `json:"status"`
	PipelineID int64    `json:"pipeline_id"`
	WebURL     string   `json:"web_url"`
	Variables  []string `json:"variables" jsonschema:"The keys of the variables sent; their values are never shown"`
	Inputs     []string `json:"inputs" jsonschema:"The names of the job inputs sent"`
}

type Jobs struct {
	Project    ProjectRef `json:"project"`
	PipelineID int64      `json:"pipeline_id"`
	Jobs       []JobRow   `json:"jobs"`
	Listing    Listing    `json:"listing"`
}

type Label struct {
	ID          int64  `json:"id"`
	Name        string `json:"name" jsonschema:"The exact name to pass as a label, scoped labels such as priority::high included"`
	Color       string `json:"color"`
	ProjectOnly bool   `json:"project_label" jsonschema:"Defined in the project rather than inherited from a group"`
	Priority    *int   `json:"priority"`
	// The counts are null unless with_counts was asked for.
	OpenIssues           *int   `json:"open_issues"`
	ClosedIssues         *int   `json:"closed_issues"`
	OpenMergeRequests    *int   `json:"open_merge_requests"`
	UntrustedDescription string `json:"untrusted_description"`
	// Version is the witness update_label and delete_label take: GitLab
	// keeps no version of a label (§4.6).
	Version string `` /* 141-byte string literal not displayed */
}

type LabelWrite struct {
	Outcome string `json:"outcome" jsonschema:"created, updated, deleted, unchanged or dry_run"`
	Write
	Label   Label    `json:"label" jsonschema:"The label as GitLab reported it after the write, or before a delete"`
	Changed []string `json:"changed" jsonschema:"The fields whose value differs after an update"`
}

type Labels struct {
	Project ProjectRef `json:"project"`
	Labels  []Label    `json:"labels"`
	Listing Listing    `json:"listing"`
}

type LineSpan struct {
	Side  string `json:"side" jsonschema:"new or old"`
	Start int    `json:"start"`
	End   int    `json:"end"`
}

type LinkRow struct {
	Name     string `json:"name"`
	URL      string `json:"url"`
	LinkType string `json:"link_type"`
}

type Lint struct {
	Project  ProjectRef `json:"project"`
	Ref      string     `json:"ref" jsonschema:"The ref whose configuration was linted; empty for the default branch"`
	Simulate bool       `json:"simulated" jsonschema:"True when GitLab simulated creating a pipeline"`
	// Supplied is true when the caller's content was linted rather than
	// the committed configuration.
	Supplied bool `json:"supplied" jsonschema:"True when the content passed in was linted rather than the configuration committed at ref"`
	Valid    bool `json:"valid"`
	// Errors and warnings quote the configuration, which people other
	// than the caller wrote.
	UntrustedErrors   []string  `json:"untrusted_errors"`
	UntrustedWarnings []string  `json:"untrusted_warnings"`
	Jobs              []LintJob `json:"jobs" jsonschema:"The jobs the configuration defines, with include_jobs"`
	// UntrustedMergedYAML is the configuration with every include
	// expanded, under the file budget.
	UntrustedMergedYAML string `json:"untrusted_merged_yaml"`
	MergedYAMLBudget    Budget `json:"merged_yaml_budget"`
}

type LintJob struct {
	Name         string `json:"name"`
	Stage        string `json:"stage"`
	When         string `json:"when"`
	AllowFailure bool   `json:"allow_failure"`
}

type Listing struct {
	Returned int  `json:"returned" jsonschema:"Rows in this result"`
	Complete bool `json:"complete" jsonschema:"True when there is no further page"`
	// Total is GitLab's count, null when GitLab did not say: past
	// 10,000 rows and on keyset pages it stops counting.
	Total         *int    `json:"total" jsonschema:"GitLab's total count, or null when it is unknown"`
	NextPageToken *string `json:"next_page_token" jsonschema:"Pass as page_token to continue; null when complete"`
}

type MRCommits struct {
	Project ProjectRef  `json:"project"`
	IID     int64       `json:"iid"`
	Commits []CommitRow `json:"commits" jsonschema:"Newest first"`
	Listing Listing     `json:"listing"`
}

type MRDiff struct {
	Project ProjectRef `json:"project"`
	IID     int64      `json:"iid"`
	Diffs
}

type MRFile struct {
	OldPath   string `json:"old_path"`
	NewPath   string `json:"new_path"`
	Status    string `json:"status" jsonschema:"added, deleted, renamed or modified"`
	Additions int    `json:"additions" jsonschema:"Lines added, counted from the diff; 0 when GitLab sent no diff"`
	Deletions int    `json:"deletions" jsonschema:"Lines removed, counted from the diff; 0 when GitLab sent no diff"`
	// The markers say why a diff may be absent or not worth reading.
	TooLarge  bool  `json:"too_large" jsonschema:"GitLab did not send this file's diff: too large"`
	Collapsed bool  `json:"collapsed" jsonschema:"GitLab collapsed this file's diff"`
	Generated *bool `json:"generated_file" jsonschema:"GitLab marks the file generated; null when it did not say"`
	Binary    bool  `json:"binary" jsonschema:"The diff says binary files differ; there are no lines to read"`
}

type MRFiles struct {
	Project ProjectRef `json:"project"`
	IID     int64      `json:"iid"`
	Files   []MRFile   `json:"files"`
	Listing Listing    `json:"listing"`
}

type Me struct {
	User       MeUser       `json:"user"`
	Instance   InstanceInfo `json:"instance"`
	Token      TokenInfo    `json:"token"`
	Registered Registration `json:"registered"`
	WriteScope WriteScope   `json:"write_namespaces"`
	Rate       RateReading  `json:"rate_limit"`
	Notes      []string     `json:"notes"`
}

type MeUser struct {
	ID       int64  `json:"id"`
	Username string `json:"username"`
	Name     string `json:"name"`
	State    string `json:"state"`
	Bot      bool   `json:"bot"`
	Admin    bool   `json:"admin"`
}

type Member struct {
	ID          int64   `json:"id"`
	Username    string  `json:"username"`
	Name        string  `json:"name"`
	State       string  `json:"state"`
	AccessLevel int     `` /* 140-byte string literal not displayed */
	Role        string  `json:"role" jsonschema:"The access level's name"`
	ExpiresAt   *string `json:"expires_at" jsonschema:"A date, not an instant; null when the access does not expire"`
}

type Members struct {
	Project ProjectRef `json:"project"`
	Members []Member   `json:"members"`
	Listing Listing    `json:"listing"`
}

type MergeRequest struct {
	Project              ProjectRef        `json:"project"`
	IID                  int64             `json:"iid"`
	Reference            string            `json:"reference"`
	WebURL               string            `json:"web_url"`
	State                string            `json:"state"`
	Draft                bool              `json:"draft"`
	Author               User              `json:"author"`
	Assignees            []User            `json:"assignees"`
	Reviewers            []User            `json:"reviewers"`
	Labels               []string          `json:"labels"`
	Milestone            *Milestone        `json:"milestone"`
	SourceBranch         string            `json:"source_branch"`
	TargetBranch         string            `json:"target_branch"`
	SourceProjectID      int64             `json:"source_project_id" jsonschema:"Differs from the project id for a merge request from a fork"`
	SHA                  string            `json:"sha" jsonschema:"The head commit; the witness merging and approving carry"`
	DiffRefs             *DiffRefs         `json:"diff_refs"`
	DetailedMergeStatus  string            `` /* 131-byte string literal not displayed */
	HasConflicts         bool              `json:"has_conflicts"`
	ChangesCount         string            `json:"changes_count" jsonschema:"Files changed, as GitLab counts them: 12, or 1000+"`
	HeadPipeline         *Pipeline         `json:"head_pipeline"`
	Approvals            *Approvals        `json:"approvals" jsonschema:"Null when the approval state could not be read"`
	CreatedAt            time.Time         `json:"created_at"`
	UpdatedAt            time.Time         `json:"updated_at"`
	MergedAt             *time.Time        `json:"merged_at"`
	ClosedAt             *time.Time        `json:"closed_at"`
	MergedBy             *User             `json:"merged_by"`
	Discussions          DiscussionSummary `json:"discussions"`
	UntrustedTitle       string            `json:"untrusted_title"`
	UntrustedDescription string            `json:"untrusted_description"`
	DescriptionBudget    Budget            `json:"description_budget"`
}

type MergeRequestWrite struct {
	Outcome string `json:"outcome" jsonschema:"created, updated, unchanged or dry_run"`
	Write
	IID                int64      `json:"iid"`
	WebURL             string     `json:"web_url"`
	State              string     `json:"state"`
	Draft              bool       `json:"draft"`
	SourceBranch       string     `json:"source_branch"`
	TargetBranch       string     `json:"target_branch"`
	LabelsBefore       []string   `json:"labels_before" jsonschema:"The labels before an update; empty for a create"`
	Labels             []string   `json:"labels"`
	Assignees          []string   `json:"assignees" jsonschema:"Usernames"`
	Reviewers          []string   `json:"reviewers" jsonschema:"Usernames"`
	Milestone          *Milestone `json:"milestone"`
	RemoveSourceBranch bool       `json:"remove_source_branch"`
	Squash             bool       `json:"squash"`
	UpdatedAt          *time.Time `` /* 189-byte string literal not displayed */
	Changed            []string   `json:"changed" jsonschema:"The fields whose value differs after the write, as GitLab reported it"`
	DescriptionRemoved *Removed   `json:"description_removed" jsonschema:"What replacing the description took out; null when it was not replaced"`
}

type MergeWrite struct {
	Outcome string `` /* 128-byte string literal not displayed */
	Write
	IID                 int64      `json:"iid"`
	WebURL              string     `json:"web_url"`
	State               string     `json:"state" jsonschema:"The merge request's state after the call, as GitLab reported it"`
	SourceBranch        string     `json:"source_branch"`
	TargetBranch        string     `json:"target_branch"`
	SHA                 string     `json:"sha" jsonschema:"The source branch's head that was merged, or would be"`
	MergeCommitSHA      string     `` /* 134-byte string literal not displayed */
	SquashCommitSHA     string     `json:"squash_commit_sha"`
	MergedAt            *time.Time `json:"merged_at"`
	MergedBy            string     `json:"merged_by" jsonschema:"Username"`
	DetailedMergeStatus string     `` /* 146-byte string literal not displayed */
}

type Milestone struct {
	ID    int64  `json:"id"`
	Title string `json:"title"`
	State string `json:"state"`
}

type MilestoneRow struct {
	ID             int64     `json:"id"`
	IID            int64     `json:"iid"`
	State          string    `json:"state"`
	DueDate        *string   `json:"due_date" jsonschema:"A date, not an instant: 2026-10-01"`
	StartDate      *string   `json:"start_date" jsonschema:"A date, not an instant: 2026-10-01"`
	Expired        bool      `json:"expired"`
	UpdatedAt      time.Time `json:"updated_at"`
	WebURL         string    `json:"web_url"`
	UntrustedTitle string    `json:"untrusted_title" jsonschema:"The title, which is what issues and merge requests are filtered by"`
}

type MilestoneWrite struct {
	Outcome string `json:"outcome" jsonschema:"created, updated, deleted, unchanged or dry_run"`
	Write
	Milestone            MilestoneRow `` /* 149-byte string literal not displayed */
	UntrustedDescription string       `json:"untrusted_description"`
	Changed              []string     `json:"changed" jsonschema:"The fields whose value differs after an update"`
}

type Milestones struct {
	// Project or Group names where they were listed, the other null.
	Project    *ProjectRef    `json:"project"`
	Group      *string        `json:"group"`
	Milestones []MilestoneRow `json:"milestones"`
	Listing    Listing        `json:"listing"`
}

type Note struct {
	ID            int64     `json:"id"`
	Author        User      `json:"author"`
	CreatedAt     time.Time `json:"created_at"`
	UpdatedAt     time.Time `json:"updated_at"`
	System        bool      `json:"system" jsonschema:"Written by GitLab to record an event, not by a person"`
	Internal      bool      `json:"internal"`
	UntrustedBody string    `json:"untrusted_body"`
	Budget        Budget    `json:"body_budget"`
}

type PickWrite struct {
	Outcome string `json:"outcome" jsonschema:"created or dry_run"`
	Write
	Action  string `json:"action" jsonschema:"cherry_pick or revert"`
	FromSHA string `json:"from_sha" jsonschema:"The commit picked or reverted"`
	Branch  string `json:"branch"`
	// Applies is GitLab's own dry run: whether the change applies.
	Applies bool   `json:"applies" jsonschema:"For a dry run, whether GitLab found the change applies to the branch cleanly"`
	SHA     string `json:"sha" jsonschema:"The new commit; empty for a dry run"`
	ShortID string `json:"short_id"`
	WebURL  string `json:"web_url"`
	// UntrustedTitle is the new commit's title.
	UntrustedTitle string `json:"untrusted_title"`
}

type Pipeline struct {
	ID     int64  `json:"id"`
	Status string `json:"status"`
	Ref    string `json:"ref"`
	SHA    string `json:"sha"`
}

type PipelineDetail struct {
	Project        ProjectRef `json:"project"`
	ID             int64      `json:"id"`
	IID            int64      `json:"iid"`
	Status         string     `json:"status"`
	DetailedStatus string     `json:"detailed_status" jsonschema:"The status as GitLab shows it, such as passed with warnings"`
	Ref            string     `json:"ref"`
	Tag            bool       `json:"tag" jsonschema:"ref is a tag"`
	SHA            string     `json:"sha"`
	BeforeSHA      string     `json:"before_sha"`
	Source         string     `json:"source"`
	User           *User      `json:"user" jsonschema:"Who started it"`
	CreatedAt      time.Time  `json:"created_at"`
	StartedAt      *time.Time `json:"started_at"`
	FinishedAt     *time.Time `json:"finished_at"`
	UpdatedAt      time.Time  `json:"updated_at"`
	Duration       *int64     `json:"duration_seconds"`
	QueuedDuration *int64     `json:"queued_seconds"`
	WebURL         string     `json:"web_url"`
	// UntrustedYAMLErrors is GitLab's message about a configuration it
	// could not read, which quotes the configuration.
	UntrustedYAMLErrors string `json:"untrusted_yaml_errors"`
	// FailedJobs lists the failed jobs, the latest attempt of each.
	FailedJobs         []JobRow `json:"failed_jobs"`
	FailedJobsComplete bool     `json:"failed_jobs_complete" jsonschema:"False when more jobs failed than were read; list_jobs with scope failed lists them"`
	// FailedTriggerJobs are the failed trigger jobs, which the job
	// listing leaves out.
	FailedTriggerJobs         []TriggerJobRow `` /* 136-byte string literal not displayed */
	FailedTriggerJobsComplete bool            `` /* 126-byte string literal not displayed */
}

type PipelineRow struct {
	ID        int64     `json:"id"`
	IID       int64     `json:"iid" jsonschema:"The pipeline's number in its project; tools take id, not this"`
	Status    string    `json:"status"`
	Ref       string    `json:"ref"`
	SHA       string    `json:"sha"`
	Source    string    `json:"source" jsonschema:"What started it: push, merge_request_event, schedule, web and others"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
	WebURL    string    `json:"web_url"`
}

type PipelineWrite struct {
	Outcome string `json:"outcome" jsonschema:"created, retried, canceled, unchanged or dry_run"`
	Write
	PipelineID   int64    `json:"pipeline_id"`
	IID          int64    `json:"iid"`
	StatusBefore string   `json:"status_before" jsonschema:"The status read before the call; empty for a new pipeline"`
	Status       string   `` /* 134-byte string literal not displayed */
	Ref          string   `json:"ref"`
	SHA          string   `json:"sha"`
	Source       string   `json:"source"`
	WebURL       string   `json:"web_url"`
	Variables    []string `json:"variables" jsonschema:"The keys of the variables sent; their values are never shown"`
	Inputs       []string `json:"inputs" jsonschema:"The names of the inputs sent; their values are never shown"`
}

type Pipelines struct {
	Project   ProjectRef    `json:"project"`
	Pipelines []PipelineRow `json:"pipelines"`
	Listing   Listing       `json:"listing"`
}

type Preview struct {
	Method    string   `json:"method"`
	Operation string   `json:"operation" jsonschema:"What the request does, such as create an issue"`
	Fields    []string `json:"fields" jsonschema:"The request fields that would be sent; only these would change"`
}

type Project struct {
	Project              ProjectRef `json:"project"`
	WebURL               string     `json:"web_url"`
	Visibility           string     `json:"visibility"`
	DefaultBranch        string     `json:"default_branch"`
	Archived             bool       `json:"archived"`
	EmptyRepo            bool       `json:"empty_repo"`
	Topics               []string   `json:"topics"`
	Stars                int        `json:"star_count"`
	Forks                int        `json:"forks_count"`
	OpenIssues           *int       `json:"open_issues_count" jsonschema:"Null when issues are turned off"`
	CreatedAt            time.Time  `json:"created_at"`
	LastActivityAt       *time.Time `json:"last_activity_at"`
	Namespace            string     `json:"namespace" jsonschema:"The group or user path the project lives under"`
	NamespaceKind        string     `json:"namespace_kind" jsonschema:"group or user"`
	UntrustedName        string     `json:"untrusted_name"`
	UntrustedDescription string     `json:"untrusted_description"`
	DescriptionBudget    Budget     `json:"description_budget"`
}

type ProjectList struct {
	Projects []ProjectRow `json:"projects"`
	Listing  Listing      `json:"listing"`
}

type ProjectRef struct {
	ID   int64  `json:"id" jsonschema:"The numeric project id; the stable way to address it"`
	Path string `json:"path" jsonschema:"The full path, such as group/sub/project"`
	// MovedFrom is set when the project was addressed by a path GitLab
	// reported as renamed or transferred.
	MovedFrom *string `json:"moved_from" jsonschema:"The old path the project was addressed by, when GitLab reported it moved; null otherwise"`
}

type ProjectRow struct {
	ID             int64      `json:"id"`
	Path           string     `json:"path"`
	Visibility     string     `json:"visibility"`
	DefaultBranch  string     `json:"default_branch"`
	Archived       bool       `json:"archived"`
	LastActivityAt *time.Time `json:"last_activity_at"`
	// UntrustedName is the display name, which any maintainer sets.
	UntrustedName string `json:"untrusted_name"`
}

type RateReading struct {
	Known     bool       `json:"known" jsonschema:"False until GitLab sent RateLimit headers, which not every response carries"`
	Limit     int        `json:"limit"`
	Remaining int        `json:"remaining"`
	Reset     *time.Time `json:"reset"`
	Observed  *time.Time `json:"observed"`
}

type RebaseWrite struct {
	Outcome string `json:"outcome" jsonschema:"started or dry_run"`
	Write
	IID              int64  `json:"iid"`
	SHA              string `json:"sha" jsonschema:"The head the rebase started from"`
	RebaseInProgress bool   `` /* 136-byte string literal not displayed */
	// MergeError is GitLab's reason, when it reported one.
	UntrustedMergeError string `json:"untrusted_merge_error" jsonschema:"Why a rebase failed, as GitLab reported it; empty otherwise"`
	SkipCI              bool   `json:"skip_ci"`
}

type RefSplit struct {
	Ref  string `json:"ref"`
	Path string `json:"path"`
}

type Registration struct {
	ReadOnly bool     `json:"read_only"`
	Kinds    []string `json:"kinds" jsonschema:"read, write, ship, destructive: the kinds with at least one tool registered"`
	Toolsets []string `json:"toolsets" jsonschema:"The optional toolsets turned on"`
	Tools    int      `json:"tools"`
}

type Release struct {
	Project              ProjectRef `json:"project"`
	TagName              string     `json:"tag_name"`
	UntrustedName        string     `json:"untrusted_name"`
	UntrustedDescription string     `json:"untrusted_description"`
	Budget               Budget     `json:"description_budget"`
	Author               string     `json:"author" jsonschema:"Username"`
	CommitSHA            string     `json:"commit_sha"`
	CreatedAt            time.Time  `json:"created_at"`
	ReleasedAt           *time.Time `json:"released_at"`
	Upcoming             bool       `json:"upcoming"`
	Milestones           []string   `json:"milestones" jsonschema:"Milestone titles"`
	Assets               int        `json:"assets" jsonschema:"How many assets it has: links and source archives"`
}

type ReleaseRow struct {
	TagName       string     `json:"tag_name"`
	UntrustedName string     `json:"untrusted_name"`
	Author        string     `json:"author" jsonschema:"Username"`
	CommitSHA     string     `json:"commit_sha"`
	CreatedAt     time.Time  `json:"created_at"`
	ReleasedAt    *time.Time `json:"released_at"`
	Upcoming      bool       `json:"upcoming" jsonschema:"True when released_at is in the future"`
}

type ReleaseWrite struct {
	Outcome string `json:"outcome" jsonschema:"created or dry_run"`
	Write
	TagName    string     `json:"tag_name"`
	TagCreated bool       `` /* 134-byte string literal not displayed */
	CommitSHA  string     `json:"commit_sha"`
	ReleasedAt *time.Time `json:"released_at"`
	Milestones []string   `json:"milestones"`
	Links      []LinkRow  `json:"links" jsonschema:"The asset links the release was created with"`
}

type Releases struct {
	Project  ProjectRef   `json:"project"`
	Releases []ReleaseRow `json:"releases"`
	Listing  Listing      `json:"listing"`
}

type Removed struct {
	Chars int `json:"chars"`
	Lines int `json:"lines"`
}

type Resolved struct {
	Kind    string `json:"kind" jsonschema:"project, issue, merge_request, file, commit, compare, pipeline, job or wiki"`
	Project string `json:"project" jsonschema:"The project's full path"`
	IID     *int64 `json:"iid"`
	ID      *int64 `json:"id" jsonschema:"A pipeline or job id"`
	SHA     string `json:"sha"`
	Ref     string `json:"ref"`
	Path    string `json:"path"`
	Line    *int   `json:"line"`
	EndLine *int   `json:"end_line"`
	From    string `json:"from"`
	To      string `json:"to"`
	Slug    string `json:"slug"`
	Note    *int64 `json:"note_id"`
	// RefCandidates lists the ways a ref with slashes could split from
	// the path when no lookup settled it.
	RefCandidates []RefSplit `json:"ref_candidates" jsonschema:"Other ways the URL's ref and path could split, when a lookup did not settle it"`
	// Tool is the registered tool that reads this kind, empty when none
	// is.
	Tool      string         `json:"tool" jsonschema:"The tool that reads this, or empty when none is registered"`
	Arguments map[string]any `json:"arguments" jsonschema:"The arguments to pass that tool"`
}

type ReviewSubmit struct {
	Outcome string `json:"outcome" jsonschema:"published or dry_run"`
	Write
	Published     int    `json:"published" jsonschema:"Drafts that were published"`
	Remaining     int    `json:"remaining" jsonschema:"Your drafts still unpublished, read after the call"`
	Summary       bool   `json:"summary" jsonschema:"True when a summary comment was sent with the review"`
	ReviewerState string `json:"reviewer_state" jsonschema:"The reviewer state sent, empty when none"`
}

type Search struct {
	Scope   string      `json:"scope"`
	Where   string      `json:"where" jsonschema:"instance, group or project"`
	Rows    []SearchRow `json:"rows"`
	Listing Listing     `json:"listing"`
}

type SearchRow struct {
	Kind      string     `json:"kind" jsonschema:"issue, merge_request, project, milestone, user, blob, commit, note or wiki_blob"`
	ProjectID *int64     `json:"project_id"`
	ID        *int64     `json:"id" jsonschema:"A project, milestone, user or note id"`
	IID       *int64     `json:"iid" jsonschema:"An issue's or merge request's iid, or the iid of the item a note is on"`
	SHA       string     `json:"sha" jsonschema:"A commit"`
	Ref       string     `json:"ref" jsonschema:"The ref a blob was found at"`
	Path      string     `json:"path" jsonschema:"A blob's or wiki page's path, or a project's full path"`
	StartLine *int       `json:"start_line" jsonschema:"The first line of a blob excerpt"`
	State     string     `json:"state"`
	Author    string     `json:"author" jsonschema:"A username, or a commit author's name"`
	UpdatedAt *time.Time `json:"updated_at"`
	WebURL    string     `json:"web_url"`
	// UntrustedTitle is a title, a name or a commit title, on one line.
	UntrustedTitle string `json:"untrusted_title"`
	// UntrustedExcerpt is a blob's matching lines or a note's body, cut
	// at the per-row budget.
	UntrustedExcerpt string `json:"untrusted_excerpt"`
	ExcerptCut       bool   `json:"excerpt_cut" jsonschema:"The excerpt was longer than the per-row budget and was cut"`
}

type Snippet struct {
	Project              *ProjectRef `json:"project" jsonschema:"The project it is in; null for a personal snippet"`
	ID                   int64       `json:"id"`
	UntrustedTitle       string      `json:"untrusted_title"`
	UntrustedDescription string      `json:"untrusted_description"`
	Visibility           string      `json:"visibility"`
	Author               string      `json:"author" jsonschema:"Username"`
	Files                []string    `json:"files" jsonschema:"Every file of the snippet; pass one as file to read it"`
	File                 string      `json:"file" jsonschema:"The file shown"`
	Binary               bool        `json:"binary" jsonschema:"True when the file is binary and its content is not shown"`
	UntrustedContent     string      `json:"untrusted_content"`
	Budget               Budget      `json:"content_budget"`
	CreatedAt            time.Time   `json:"created_at"`
	UpdatedAt            time.Time   `json:"updated_at"`
	WebURL               string      `json:"web_url"`
}

type SnippetRow struct {
	ID             int64     `json:"id"`
	UntrustedTitle string    `json:"untrusted_title"`
	Visibility     string    `json:"visibility"`
	Author         string    `json:"author" jsonschema:"Username"`
	ProjectID      *int64    `json:"project_id" jsonschema:"The project it is in; null for a personal snippet"`
	Files          []string  `json:"files"`
	CreatedAt      time.Time `json:"created_at"`
	UpdatedAt      time.Time `json:"updated_at"`
	WebURL         string    `json:"web_url"`
}

type SnippetWrite struct {
	Outcome string `json:"outcome" jsonschema:"created or dry_run"`
	Write
	ID         int64    `json:"id"`
	Visibility string   `json:"visibility" jsonschema:"Always private"`
	Files      []string `json:"files"`
	WebURL     string   `json:"web_url"`
}

type Snippets struct {
	Project  *ProjectRef  `json:"project" jsonschema:"The project listed; null for your personal snippets"`
	Snippets []SnippetRow `json:"snippets"`
	Listing  Listing      `json:"listing"`
}

type Tag struct {
	Name        string     `json:"name"`
	CommitID    string     `json:"commit_id"`
	CommittedAt time.Time  `json:"committed_at"`
	CreatedAt   *time.Time `json:"created_at" jsonschema:"When an annotated tag was made; null for a lightweight tag"`
	Protected   bool       `json:"protected"`
	Release     bool       `json:"release" jsonschema:"A release is attached"`
	// UntrustedMessage is an annotated tag's message on one line.
	UntrustedMessage     string `json:"untrusted_message"`
	UntrustedCommitTitle string `json:"untrusted_commit_title"`
}

type TagWrite struct {
	Outcome string `json:"outcome" jsonschema:"created, deleted or dry_run"`
	Write
	Tag       string `json:"tag"`
	CommitSHA string `json:"commit_sha" jsonschema:"The commit the tag points at"`
	Annotated bool   `json:"annotated"`
	Protected bool   `json:"protected"`
}

type Tags struct {
	Project ProjectRef `json:"project"`
	Tags    []Tag      `json:"tags"`
	Listing Listing    `json:"listing"`
}

type Tasks struct {
	Count     int `json:"count"`
	Completed int `json:"completed"`
}

type Thread struct {
	ID           string        `json:"id"`
	Individual   bool          `json:"individual_note" jsonschema:"A single comment rather than a thread"`
	Resolvable   bool          `json:"resolvable"`
	Resolved     bool          `json:"resolved"`
	Position     *DiffPosition `json:"position" jsonschema:"Where a diff thread sits; null for a general one"`
	LastActivity time.Time     `json:"last_activity"`
	Notes        []Note        `json:"notes"`
}

type ThreadStub struct {
	ID           string    `json:"id"`
	Author       string    `json:"author"`
	Notes        int       `json:"notes"`
	LastActivity time.Time `json:"last_activity"`
}

type Todo struct {
	ID         int64       `json:"id"`
	Project    *ProjectRef `json:"project" jsonschema:"Null for an item outside a project"`
	Action     string      `json:"action" jsonschema:"Why it is on the list: assigned, mentioned, review_requested, build_failed and others"`
	TargetType string      `json:"target_type" jsonschema:"Issue, MergeRequest and others"`
	TargetIID  *int64      `json:"target_iid" jsonschema:"The issue's or merge request's iid, when the item points at one"`
	State      string      `json:"state"`
	Author     string      `json:"author" jsonschema:"The username of whoever caused it"`
	CreatedAt  time.Time   `json:"created_at"`
	TargetURL  string      `json:"target_url"`
	// UntrustedTitle and UntrustedBody are one line each.
	UntrustedTitle string `json:"untrusted_title"`
	UntrustedBody  string `json:"untrusted_body"`
}

type TodoDone struct {
	ID      int64  `json:"id"`
	Outcome string `` /* 126-byte string literal not displayed */
	Error   string `json:"error" jsonschema:"Why it was not marked; empty when it was"`
}

type Todos struct {
	Todos   []Todo  `json:"todos"`
	Listing Listing `json:"listing"`
}

type TodosDone struct {
	Outcome string `json:"outcome" jsonschema:"done, partly_done, none_done or dry_run"`
	Write
	Items []TodoDone `json:"items"`
}

type TokenInfo struct {
	Kind      string     `json:"kind" jsonschema:"How the token was obtained: oauth"`
	Scopes    []string   `json:"scopes"`
	ExpiresAt *time.Time `json:"expires_at" jsonschema:"When the access token expires; it is refreshed before then"`
}

type Tree struct {
	Project ProjectRef  `json:"project"`
	Ref     string      `json:"ref"`
	Path    string      `json:"path"`
	Entries []TreeEntry `json:"entries"`
	Listing Listing     `json:"listing"`
}

type TreeEntry struct {
	Path string `json:"path"`
	Type string `json:"type" jsonschema:"blob (a file), tree (a directory) or commit (a submodule)"`
	Mode string `json:"mode"`
	ID   string `json:"id"`
}

type TriggerJobRow struct {
	JobRow
	Downstream *DownstreamRow `json:"downstream_pipeline" jsonschema:"The pipeline this trigger job started; null when it started none"`
}

type User struct {
	Username string `json:"username"`
	Name     string `json:"name"`
}

type UserRow struct {
	ID       int64  `json:"id"`
	Username string `json:"username"`
	Name     string `json:"name"`
	State    string `json:"state"`
	WebURL   string `json:"web_url"`
}

type Users struct {
	Users   []UserRow `json:"users"`
	Listing Listing   `json:"listing"`
}

type WikiDelete struct {
	Outcome string `json:"outcome" jsonschema:"deleted or dry_run"`
	Write
	Slug string `json:"slug"`
}

type WikiPage struct {
	Project          ProjectRef `json:"project"`
	Slug             string     `json:"slug"`
	UntrustedTitle   string     `json:"untrusted_title"`
	Format           string     `json:"format" jsonschema:"markdown, rdoc, asciidoc or org"`
	ContentSHA256    string     `` /* 219-byte string literal not displayed */
	UntrustedContent string     `json:"untrusted_content"`
	Budget           Budget     `json:"content_budget"`
}

type WikiPageRow struct {
	Slug   string `json:"slug" jsonschema:"Pass as slug to get_wiki_page"`
	Title  string `json:"untrusted_title"`
	Format string `json:"format"`
}

type WikiPages struct {
	Project ProjectRef    `json:"project"`
	Pages   []WikiPageRow `json:"pages"`
	Listing Listing       `json:"listing"`
}

type WikiWrite struct {
	Outcome string `json:"outcome" jsonschema:"created, updated, unchanged or dry_run"`
	Write
	Slug           string   `json:"slug" jsonschema:"The page's slug after the write, which a new title changes"`
	Title          string   `json:"title"`
	Format         string   `json:"format"`
	ContentSHA256  string   `json:"content_sha256" jsonschema:"Pass as content_sha256 to the next save_wiki_page"`
	Changed        []string `json:"changed" jsonschema:"The fields whose value differs after the write, as GitLab reported it"`
	ContentRemoved *Removed `json:"content_removed" jsonschema:"What replacing the content took out; null when it was not replaced"`
}

type Write struct {
	// DryRun is true when nothing was sent: the result says what would
	// have been.
	DryRun bool `json:"dry_run" jsonschema:"True when nothing was written; the result describes what would have been"`
	// WouldSend is the request a dry run stopped before, nil otherwise.
	WouldSend *Preview `json:"would_send" jsonschema:"The request a dry run did not send; null when something was written"`
	// Target is where the write went, or would have.
	Target WriteTarget `json:"target"`
	// EscapedCommands are the lines the guard escaped because
	// escape_commands was true.
	EscapedCommands []EscapedLine `` /* 133-byte string literal not displayed */
	Notes           []string      `json:"notes"`
}

type WriteScope struct {
	Confined   bool     `json:"confined" jsonschema:"False means writes may go wherever the token can write"`
	Namespaces []string `json:"namespaces"`
}

type WriteTarget struct {
	Project    ProjectRef `json:"project"`
	Visibility string     `json:"visibility" jsonschema:"public, internal or private: who can see what was written"`
}