gitlab

type ApprovalSummary struct {
	Approved      bool          `json:"approved"`
	ApprovalsLeft int64         `json:"approvals_left"`
	ApprovedBy    []UserSummary `json:"approved_by,omitempty"`
}

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

type Config struct {
	// BaseURL is the GitLab instance, e.g. https://gitlab.example.com. Empty
	// means [DefaultBaseURL].
	BaseURL string
	// Token authenticates every request. Empty means unauthenticated, which
	// can still read public projects.
	Token string

	// DefaultProject is used by tools whose project argument is empty. It is
	// what makes a server pinned to one project convenient without making
	// every other project unreachable; unlike glab, an explicit project always
	// wins and none is required.
	DefaultProject string

	Timeout time.Duration

	// FS is the only host filesystem the release asset tools can reach. A nil
	// FS denies them, which is the right default for a server that has no
	// business touching local files.
	FS effect.FS

	// HTTPClient performs every GitLab request. If nil, it is an
	// [effect.NewHTTPClient] whose egress allowlist is exactly the configured
	// instance, so neither the API client nor an asset download can reach
	// another host.
	//
	// It exists as a seam for tests; production code leaves it nil.
	HTTPClient *http.Client
}

type CreateIssueArgs struct {
	Project      string   `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	Title        string   `json:"title" jsonschema:"issue title"`
	Description  string   `json:"description,omitempty" jsonschema:"issue body, in GitLab-flavored Markdown"`
	Labels       []string `json:"labels,omitempty" jsonschema:"label names to apply"`
	Assignees    []string `json:"assignees,omitempty" jsonschema:"usernames to assign"`
	Milestone    string   `json:"milestone,omitempty" jsonschema:"milestone title to attach"`
	Confidential bool     `json:"confidential,omitempty" jsonschema:"make the issue visible only to project members"`
}

type CreateIssueNoteArgs struct {
	Project string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	IID     int64  `json:"iid" jsonschema:"project-scoped issue number, the one shown as #123"`
	Body    string `json:"body" jsonschema:"comment text, in GitLab-flavored Markdown"`
}

type CreateMergeRequestArgs struct {
	Project      string   `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	SourceBranch string   `json:"source_branch" jsonschema:"branch holding the changes"`
	TargetBranch string   `json:"target_branch,omitempty" jsonschema:"branch to merge into; defaults to the project's default branch"`
	Title        string   `json:"title" jsonschema:"merge request title; prefix with Draft: to open it as a draft"`
	Description  string   `json:"description,omitempty" jsonschema:"merge request body, in GitLab-flavored Markdown"`
	Labels       []string `json:"labels,omitempty" jsonschema:"label names to apply"`
	Assignees    []string `json:"assignees,omitempty" jsonschema:"usernames to assign"`
	Reviewers    []string `json:"reviewers,omitempty" jsonschema:"usernames to request review from"`
	Milestone    string   `json:"milestone,omitempty" jsonschema:"milestone title to attach"`
	RemoveSource bool     `json:"remove_source_branch,omitempty" jsonschema:"delete the source branch once merged"`
	Squash       bool     `json:"squash,omitempty" jsonschema:"squash commits when merging"`
}

type CreateMergeRequestNoteArgs struct {
	Project string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	IID     int64  `json:"iid" jsonschema:"project-scoped merge request number, the one shown as !123"`
	Body    string `json:"body" jsonschema:"comment text, in GitLab-flavored Markdown"`
}

type CreateReleaseArgs struct {
	Project     string   `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	TagName     string   `json:"tag_name" jsonschema:"tag to release; it is created from ref when it does not exist"`
	Ref         string   `` /* 130-byte string literal not displayed */
	Name        string   `json:"name,omitempty" jsonschema:"release title; defaults to the tag name"`
	Description string   `json:"description,omitempty" jsonschema:"release notes, in GitLab-flavored Markdown"`
	Milestones  []string `json:"milestones,omitempty" jsonschema:"milestone titles to associate"`
	ReleasedAt  string   `json:"released_at,omitempty" jsonschema:"RFC 3339 timestamp; a future value creates an upcoming release"`
}

type DownloadReleaseAssetArgs struct {
	Project string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	TagName string `json:"tag_name" jsonschema:"tag of the release holding the asset"`
	Name    string `json:"name" jsonschema:"asset name as listed by release_view"`
	Path    string `json:"path" jsonschema:"local destination, relative to the server's assets directory"`
}

type DownloadReleaseAssetRes struct {
	Path string `json:"path" jsonschema:"host path the asset was written to"`
	Size int64  `json:"size" jsonschema:"bytes written"`
}

type FileArgs struct {
	Project string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	Path    string `json:"path" jsonschema:"file path within the repository, e.g. cmd/main.go"`
	Ref     string `json:"ref,omitempty" jsonschema:"branch, tag or commit SHA; defaults to the project's default branch"`
}

type FileDiff struct {
	OldPath     string `json:"old_path"`
	NewPath     string `json:"new_path"`
	NewFile     bool   `json:"new_file,omitempty"`
	RenamedFile bool   `json:"renamed_file,omitempty"`
	DeletedFile bool   `json:"deleted_file,omitempty"`
	Generated   bool   `json:"generated_file,omitempty" jsonschema:"GitLab considers this file generated, e.g. by a linguist-generated gitattribute"`
	// Diff is unified diff text. It is empty when the file was omitted: either
	// GitLab itself declined to send it (TooLarge) or the response hit the
	// tool's own budget.
	Diff     string `json:"diff,omitempty"`
	TooLarge bool   `json:"too_large,omitempty" jsonschema:"GitLab did not return this file's diff because it exceeds the instance limit"`
	Omitted  bool   `` /* 133-byte string literal not displayed */
}

type FileRes struct {
	Path      string `json:"path"`
	Ref       string `json:"ref,omitempty"`
	Content   string `json:"content,omitempty"`
	Size      int64  `json:"size" jsonschema:"size of the file in bytes, before any truncation"`
	Truncated bool   `json:"truncated,omitempty"`
	// Binary reports that the file is not valid UTF-8, so Content is empty
	// rather than a wall of escaped bytes.
	Binary bool `json:"binary,omitempty"`
}

type GlabConfig struct {
	// Host is the default instance hostname.
	Host string `yaml:"host"`
	// Hosts maps a hostname to its credentials.
	Hosts map[string]GlabHost `yaml:"hosts"`
}

type GlabHost struct {
	Token       string `yaml:"token"`
	APIHost     string `yaml:"api_host"`
	APIProtocol string `yaml:"api_protocol"`
}

type IssueDetail struct {
	IssueSummary
	Description string `json:"description,omitempty"`
	// DescriptionTruncated reports that Description was cut at
	// [descriptionLimit] runes.
	DescriptionTruncated bool          `json:"description_truncated,omitempty"`
	Confidential         bool          `json:"confidential,omitempty"`
	CreatedAt            *time.Time    `json:"created_at,omitempty"`
	ClosedAt             *time.Time    `json:"closed_at,omitempty"`
	Notes                []NoteSummary `json:"notes,omitempty"`
}

type IssueRes struct {
	Issue IssueSummary `json:"issue"`
}

type IssueSummary struct {
	IID       int64         `json:"iid" jsonschema:"project-scoped issue number, the one shown as #123"`
	Title     string        `json:"title"`
	State     string        `json:"state"`
	Author    *UserSummary  `json:"author,omitempty"`
	Assignees []UserSummary `json:"assignees,omitempty"`
	Labels    []string      `json:"labels,omitempty"`
	Milestone string        `json:"milestone,omitempty"`
	UpdatedAt *time.Time    `json:"updated_at,omitempty"`
	WebURL    string        `json:"web_url,omitempty"`
}

type ListArgs struct {
	Page    int `json:"page,omitempty" jsonschema:"1-based page number; defaults to 1"`
	PerPage int `json:"per_page,omitempty" jsonschema:"results per page, 1-100; defaults to 20"`
}

type ListIssuesArgs struct {
	ListArgs
	Project string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	State   string `json:"state,omitempty" jsonschema:"opened, closed, or all; defaults to opened"`
	Labels  string `json:"labels,omitempty" jsonschema:"comma-separated label names the issue must have all of"`
	// Assignee and Author take usernames because that is what an agent reading
	// an issue thread has; the API's *_id variants would need a lookup first.
	Assignee  string `json:"assignee,omitempty" jsonschema:"filter by assignee username"`
	Author    string `json:"author,omitempty" jsonschema:"filter by author username"`
	Milestone string `json:"milestone,omitempty" jsonschema:"filter by milestone title"`
	Search    string `json:"search,omitempty" jsonschema:"free-text search over title and description"`
	OrderBy   string `json:"order_by,omitempty" jsonschema:"created_at, updated_at, or priority; defaults to created_at"`
	Sort      string `json:"sort,omitempty" jsonschema:"asc or desc; defaults to desc"`
}

type ListIssuesRes struct {
	Issues []IssueSummary `json:"issues"`
}

type ListMergeRequestsArgs struct {
	ListArgs
	Project      string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	State        string `json:"state,omitempty" jsonschema:"opened, closed, merged, locked, or all; defaults to opened"`
	Labels       string `json:"labels,omitempty" jsonschema:"comma-separated label names the merge request must have all of"`
	Author       string `json:"author,omitempty" jsonschema:"filter by author username"`
	Assignee     string `json:"assignee,omitempty" jsonschema:"filter by assignee username"`
	Reviewer     string `json:"reviewer,omitempty" jsonschema:"filter by reviewer username"`
	SourceBranch string `json:"source_branch,omitempty"`
	TargetBranch string `json:"target_branch,omitempty"`
	Milestone    string `json:"milestone,omitempty" jsonschema:"filter by milestone title"`
	Search       string `json:"search,omitempty" jsonschema:"free-text search over title and description"`
	OrderBy      string `json:"order_by,omitempty" jsonschema:"created_at or updated_at; defaults to created_at"`
	Sort         string `json:"sort,omitempty" jsonschema:"asc or desc; defaults to desc"`
}

type ListMergeRequestsRes struct {
	MergeRequests []MergeRequestSummary `json:"merge_requests"`
}

type ListReleasesArgs struct {
	ListArgs
	Project string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
}

type ListReleasesRes struct {
	Releases []ReleaseSummary `json:"releases"`
}

type MergeRequestDetail struct {
	MergeRequestSummary
	Description          string     `json:"description,omitempty"`
	DescriptionTruncated bool       `json:"description_truncated,omitempty"`
	CreatedAt            *time.Time `json:"created_at,omitempty"`
	MergedAt             *time.Time `json:"merged_at,omitempty"`
	ClosedAt             *time.Time `json:"closed_at,omitempty"`
	SHA                  string     `json:"sha,omitempty" jsonschema:"head commit of the source branch"`
	// DetailedMergeStatus is GitLab's own summary of whether the merge request
	// can merge, e.g. mergeable, ci_still_running, not_approved.
	DetailedMergeStatus string           `json:"detailed_merge_status,omitempty"`
	HasConflicts        bool             `json:"has_conflicts,omitempty"`
	ChangesCount        string           `json:"changes_count,omitempty"`
	Pipeline            *PipelineSummary `json:"pipeline,omitempty"`
	Approvals           *ApprovalSummary `json:"approvals,omitempty"`
	Notes               []NoteSummary    `json:"notes,omitempty"`
}

type MergeRequestDiffArgs struct {
	ListArgs
	Project string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	IID     int64  `json:"iid" jsonschema:"project-scoped merge request number, the one shown as !123"`
	// Paths narrows a wide merge request to the files under review, which is
	// what makes a 200-file change readable at all.
	Paths []string `json:"paths,omitempty" jsonschema:"only return diffs whose new or old path is exactly one of these"`
}

type MergeRequestDiffRes struct {
	Diffs []FileDiff `json:"diffs"`
	// Truncated reports that at least one diff was dropped for budget.
	Truncated bool `json:"truncated,omitempty"`
}

type MergeRequestRes struct {
	MergeRequest MergeRequestSummary `json:"merge_request"`
}

type MergeRequestSummary struct {
	IID          int64         `json:"iid" jsonschema:"project-scoped merge request number, the one shown as !123"`
	Title        string        `json:"title"`
	State        string        `json:"state" jsonschema:"opened, closed, merged, or locked"`
	Draft        bool          `json:"draft,omitempty"`
	SourceBranch string        `json:"source_branch"`
	TargetBranch string        `json:"target_branch"`
	Author       *UserSummary  `json:"author,omitempty"`
	Assignees    []UserSummary `json:"assignees,omitempty"`
	Reviewers    []UserSummary `json:"reviewers,omitempty"`
	Labels       []string      `json:"labels,omitempty"`
	Milestone    string        `json:"milestone,omitempty"`
	UpdatedAt    *time.Time    `json:"updated_at,omitempty"`
	WebURL       string        `json:"web_url,omitempty"`
}

type NoteRes struct {
	Note NoteSummary `json:"note"`
}

type NoteSummary struct {
	ID        int64        `json:"id"`
	Author    *UserSummary `json:"author,omitempty"`
	Body      string       `json:"body"`
	System    bool         `json:"system,omitempty" jsonschema:"true for GitLab-generated activity notes rather than human comments"`
	CreatedAt *time.Time   `json:"created_at,omitempty"`
}

type PipelineSummary struct {
	ID     int64  `json:"id"`
	Status string `json:"status"`
	Ref    string `json:"ref,omitempty"`
	WebURL string `json:"web_url,omitempty"`
}

type ProjectDetail struct {
	ProjectSummary
	OpenIssuesCount int64  `json:"open_issues_count,omitempty"`
	Readme          string `json:"readme,omitempty"`
	ReadmeTruncated bool   `json:"readme_truncated,omitempty"`
}

type ProjectSummary struct {
	ID            int64      `json:"id"`
	PathWithNS    string     `json:"path_with_namespace" jsonschema:"the group/project path other tools take as their project argument"`
	Name          string     `json:"name"`
	Description   string     `json:"description,omitempty"`
	DefaultBranch string     `json:"default_branch,omitempty"`
	Visibility    string     `json:"visibility,omitempty" jsonschema:"private, internal, or public"`
	Archived      bool       `json:"archived,omitempty"`
	Topics        []string   `json:"topics,omitempty"`
	StarCount     int64      `json:"star_count,omitempty"`
	ForksCount    int64      `json:"forks_count,omitempty"`
	LastActivity  *time.Time `json:"last_activity_at,omitempty"`
	WebURL        string     `json:"web_url,omitempty"`
}

type ReleaseAsset struct {
	ID   int64  `json:"id"`
	Name string `json:"name"`
	URL  string `json:"url"`
	// DirectAssetURL is the permalink form; release_asset_download prefers it.
	DirectAssetURL string `json:"direct_asset_url,omitempty"`
	// External marks an asset hosted outside this GitLab instance. Downloading
	// one is refused: the HTTP client's allowlist is the instance itself.
	External bool   `json:"external,omitempty"`
	LinkType string `json:"link_type,omitempty" jsonschema:"other, runbook, image, or package"`
}

type ReleaseAssetLink struct {
	Format string `json:"format"`
	URL    string `json:"url"`
}

type ReleaseDetail struct {
	ReleaseSummary
	Description          string             `json:"description,omitempty" jsonschema:"the release notes"`
	DescriptionTruncated bool               `json:"description_truncated,omitempty"`
	Milestones           []string           `json:"milestones,omitempty"`
	Assets               []ReleaseAsset     `json:"assets,omitempty"`
	Sources              []ReleaseAssetLink `json:"sources,omitempty" jsonschema:"auto-generated source archives"`
}

type ReleaseRes struct {
	Release ReleaseSummary `json:"release"`
}

type ReleaseSummary struct {
	TagName     string       `json:"tag_name"`
	Name        string       `json:"name,omitempty"`
	Author      *UserSummary `json:"author,omitempty"`
	CreatedAt   *time.Time   `json:"created_at,omitempty"`
	ReleasedAt  *time.Time   `json:"released_at,omitempty"`
	Upcoming    bool         `json:"upcoming_release,omitempty" jsonschema:"released_at is in the future, so the release is not yet published"`
	CommitSHA   string       `json:"commit_sha,omitempty"`
	AssetsCount int64        `json:"assets_count"`
}

type SearchProjectsArgs struct {
	ListArgs
	Search     string `json:"search" jsonschema:"text to match against project names and paths"`
	Membership bool   `json:"membership,omitempty" jsonschema:"only projects the authenticated user is a member of"`
	OrderBy    string `json:"order_by,omitempty" jsonschema:"id, name, path, created_at, updated_at, or last_activity_at; defaults to created_at"`
	Sort       string `json:"sort,omitempty" jsonschema:"asc or desc; defaults to desc"`
}

type SearchProjectsRes struct {
	Projects []ProjectSummary `json:"projects"`
}

type TreeArgs struct {
	ListArgs
	Project   string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	Path      string `json:"path,omitempty" jsonschema:"directory to list; empty means the repository root"`
	Ref       string `json:"ref,omitempty" jsonschema:"branch, tag or commit SHA; defaults to the project's default branch"`
	Recursive bool   `json:"recursive,omitempty" jsonschema:"list the whole subtree rather than one level"`
}

type TreeEntry struct {
	Name string `json:"name"`
	Path string `json:"path"`
	Type string `json:"type" jsonschema:"tree for a directory, blob for a file"`
}

type TreeRes struct {
	Entries []TreeEntry `json:"entries"`
}

type UpdateIssueArgs struct {
	Project     string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	IID         int64  `json:"iid" jsonschema:"project-scoped issue number, the one shown as #123"`
	Title       string `json:"title,omitempty" jsonschema:"replace the title"`
	Description string `json:"description,omitempty" jsonschema:"replace the body; this overwrites, it does not append"`
	// Labels replaces the set, while AddLabels and RemoveLabels edit it. The
	// distinction matters: an agent that means to add one label and sends
	// Labels drops every other label on the issue.
	Labels       []string `json:"labels,omitempty" jsonschema:"replace all labels with this set"`
	AddLabels    []string `json:"add_labels,omitempty" jsonschema:"add these labels, leaving existing ones"`
	RemoveLabels []string `json:"remove_labels,omitempty" jsonschema:"remove these labels, leaving the rest"`
	Assignees    []string `json:"assignees,omitempty" jsonschema:"replace assignees with these usernames; an empty list is ignored, use unassign"`
	Unassign     bool     `json:"unassign,omitempty" jsonschema:"remove all assignees"`
	Milestone    string   `json:"milestone,omitempty" jsonschema:"milestone title to attach"`
	State        string   `json:"state,omitempty" jsonschema:"close or reopen"`
}

type UpdateMergeRequestArgs struct {
	Project     string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	IID         int64  `json:"iid" jsonschema:"project-scoped merge request number, the one shown as !123"`
	Title       string `json:"title,omitempty" jsonschema:"replace the title"`
	Description string `json:"description,omitempty" jsonschema:"replace the body; this overwrites, it does not append"`
	// As with issues, Labels replaces while AddLabels and RemoveLabels edit.
	Labels       []string `json:"labels,omitempty" jsonschema:"replace all labels with this set"`
	AddLabels    []string `json:"add_labels,omitempty" jsonschema:"add these labels, leaving existing ones"`
	RemoveLabels []string `json:"remove_labels,omitempty" jsonschema:"remove these labels, leaving the rest"`
	Assignees    []string `json:"assignees,omitempty" jsonschema:"replace assignees with these usernames; an empty list is ignored, use unassign"`
	Unassign     bool     `json:"unassign,omitempty" jsonschema:"remove all assignees"`
	Reviewers    []string `json:"reviewers,omitempty" jsonschema:"replace reviewers with these usernames"`
	TargetBranch string   `json:"target_branch,omitempty" jsonschema:"retarget the merge request at another branch"`
	Milestone    string   `json:"milestone,omitempty" jsonschema:"milestone title to attach"`
	State        string   `json:"state,omitempty" jsonschema:"close or reopen"`
}

type UploadReleaseAssetArgs struct {
	Project string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	TagName string `json:"tag_name" jsonschema:"tag of an existing release to attach the asset to"`
	// Path is resolved by the server's filesystem provider, not by this
	// handler: what the agent may read is decided by how the binary was
	// started, not by the argument.
	Path     string `json:"path" jsonschema:"local file to upload, relative to the server's assets directory"`
	Name     string `json:"name,omitempty" jsonschema:"asset name shown on the release page; defaults to the file's base name"`
	LinkType string `json:"link_type,omitempty" jsonschema:"other, runbook, image, or package; defaults to other"`
}

type UploadReleaseAssetRes struct {
	Asset ReleaseAsset `json:"asset"`
	Size  int64        `json:"size" jsonschema:"bytes uploaded"`
}

type UserSummary struct {
	Username string `json:"username"`
	Name     string `json:"name,omitempty"`
}

type ViewIssueArgs struct {
	Project   string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	IID       int64  `json:"iid" jsonschema:"project-scoped issue number, the one shown as #123"`
	WithNotes bool   `json:"with_notes,omitempty" jsonschema:"include the comment thread; off by default because it can be long"`
}

type ViewIssueRes struct {
	Issue IssueDetail `json:"issue"`
}

type ViewMergeRequestArgs struct {
	Project       string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	IID           int64  `json:"iid" jsonschema:"project-scoped merge request number, the one shown as !123"`
	WithNotes     bool   `json:"with_notes,omitempty" jsonschema:"include the comment thread; off by default because it can be long"`
	WithApprovals bool   `json:"with_approvals,omitempty" jsonschema:"include who approved and how many approvals remain; costs one extra API call"`
}

type ViewMergeRequestRes struct {
	MergeRequest MergeRequestDetail `json:"merge_request"`
}

type ViewProjectArgs struct {
	Project    string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	WithReadme bool   `json:"with_readme,omitempty" jsonschema:"include the README's contents; costs one extra API call"`
}

type ViewProjectRes struct {
	Project ProjectDetail `json:"project"`
}

type ViewReleaseArgs struct {
	Project string `json:"project,omitempty" jsonschema:"project path (group/project) or numeric ID; defaults to the server's configured project"`
	TagName string `json:"tag_name,omitempty" jsonschema:"tag of the release; empty means the latest release"`
}

type ViewReleaseRes struct {
	Release ReleaseDetail `json:"release"`
}