resources

type BoardResourceOutput struct {
	ID   int64  `json:"id"`
	Name string `json:"name"`
}

type BranchResourceOutput struct {
	Name      string `json:"name"`
	Protected bool   `json:"protected"`
	Merged    bool   `json:"merged"`
	Default   bool   `json:"default"`
	WebURL    string `json:"web_url"`
}

type CommitResourceOutput struct {
	ID             string             `json:"id"`
	ShortID        string             `json:"short_id"`
	Title          string             `json:"title"`
	Message        string             `json:"message"`
	AuthorName     string             `json:"author_name"`
	AuthorEmail    string             `json:"author_email"`
	CommitterName  string             `json:"committer_name"`
	CommitterEmail string             `json:"committer_email"`
	AuthoredDate   string             `json:"authored_date,omitempty"`
	CommittedDate  string             `json:"committed_date,omitempty"`
	WebURL         string             `json:"web_url"`
	ParentIDs      []string           `json:"parent_ids,omitempty"`
	Stats          *CommitStatsOutput `json:"stats,omitempty"`
}

type CommitStatsOutput struct {
	Additions int64 `json:"additions"`
	Deletions int64 `json:"deletions"`
	Total     int64 `json:"total"`
}

type DeployKeyResourceOutput struct {
	ID          int64  `json:"id"`
	Title       string `json:"title"`
	Key         string `json:"key"`
	Fingerprint string `json:"fingerprint,omitempty"`
}

type DeploymentResourceOutput struct {
	ID          int64  `json:"id"`
	IID         int64  `json:"iid"`
	Ref         string `json:"ref"`
	SHA         string `json:"sha"`
	Status      string `json:"status"`
	Environment string `json:"environment,omitempty"`
}

type EnvironmentResourceOutput struct {
	ID    int64  `json:"id"`
	Name  string `json:"name"`
	Slug  string `json:"slug"`
	State string `json:"state"`
	Tier  string `json:"tier,omitempty"`
}

type FeatureFlagResourceOutput struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Active      bool   `json:"active"`
	Version     string `json:"version"`
}

type FileBlobResourceOutput struct {
	FileName        string `json:"file_name"`
	FilePath        string `json:"file_path"`
	Size            int64  `json:"size"`
	Encoding        string `json:"encoding,omitempty"`
	Ref             string `json:"ref"`
	BlobID          string `json:"blob_id"`
	CommitID        string `json:"commit_id"`
	LastCommitID    string `json:"last_commit_id"`
	Content         string `json:"content,omitempty"`
	ContentCategory string `json:"content_category"`
	Truncated       bool   `json:"truncated,omitempty"`
}

type GroupResourceOutput struct {
	ID          int64  `json:"id"`
	Name        string `json:"name"`
	Path        string `json:"path"`
	FullPath    string `json:"full_path"`
	Description string `json:"description"`
	Visibility  string `json:"visibility"`
	WebURL      string `json:"web_url"`
}

type HandlerIndex map[string]mcp.ResourceHandler

type IssueResourceOutput struct {
	ID        int64    `json:"id"`
	IID       int64    `json:"iid"`
	Title     string   `json:"title"`
	State     string   `json:"state"`
	Labels    []string `json:"labels"`
	Assignees []string `json:"assignees"`
	Author    string   `json:"author"`
	WebURL    string   `json:"web_url"`
	CreatedAt string   `json:"created_at"`
}

type JobResourceOutput struct {
	ID            int64   `json:"id"`
	Name          string  `json:"name"`
	Stage         string  `json:"stage"`
	Status        string  `json:"status"`
	Ref           string  `json:"ref"`
	Duration      float64 `json:"duration"`
	FailureReason string  `json:"failure_reason,omitempty"`
	WebURL        string  `json:"web_url"`
}

type LabelResourceOutput struct {
	ID          int64  `json:"id"`
	Name        string `json:"name"`
	Color       string `json:"color"`
	Description string `json:"description"`
}

type LabelUsageResourceOutput struct {
	LabelResourceOutput
	OpenIssuesCount        int64 `json:"open_issues_count"`
	OpenMergeRequestsCount int64 `json:"open_merge_requests_count"`
}

type MRDiscussionNoteResourceOutput struct {
	ID         int64  `json:"id"`
	Author     string `json:"author"`
	Body       string `json:"body"`
	System     bool   `json:"system"`
	Resolved   bool   `json:"resolved"`
	Resolvable bool   `json:"resolvable"`
	CreatedAt  string `json:"created_at,omitempty"`
}

type MRDiscussionResourceOutput struct {
	ID             string                           `json:"id"`
	IndividualNote bool                             `json:"individual_note"`
	Notes          []MRDiscussionNoteResourceOutput `json:"notes"`
}

type MRNoteResourceOutput struct {
	ID         int64  `json:"id"`
	Author     string `json:"author"`
	Body       string `json:"body"`
	System     bool   `json:"system"`
	Resolvable bool   `json:"resolvable,omitempty"`
	Resolved   bool   `json:"resolved,omitempty"`
	CreatedAt  string `json:"created_at,omitempty"`
	UpdatedAt  string `json:"updated_at,omitempty"`
}

type MRResourceOutput struct {
	ID           int64  `json:"id"`
	IID          int64  `json:"iid"`
	Title        string `json:"title"`
	State        string `json:"state"`
	SourceBranch string `json:"source_branch"`
	TargetBranch string `json:"target_branch"`
	Author       string `json:"author"`
	WebURL       string `json:"web_url"`
	MergeStatus  string `json:"merge_status"`
}

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

type MilestoneResourceOutput struct {
	ID          int64  `json:"id"`
	IID         int64  `json:"iid"`
	Title       string `json:"title"`
	Description string `json:"description"`
	State       string `json:"state"`
	DueDate     string `json:"due_date,omitempty"`
	WebURL      string `json:"web_url"`
}

type PipelineResourceOutput struct {
	ID     int64  `json:"id"`
	IID    int64  `json:"iid"`
	Status string `json:"status"`
	Ref    string `json:"ref"`
	SHA    string `json:"sha"`
	WebURL string `json:"web_url"`
	Source string `json:"source"`
}

type ProjectResourceOutput struct {
	ID                int64  `json:"id"`
	Name              string `json:"name"`
	PathWithNamespace string `json:"path_with_namespace"`
	Visibility        string `json:"visibility"`
	WebURL            string `json:"web_url"`
	Description       string `json:"description"`
	DefaultBranch     string `json:"default_branch"`
}

type RegisterOptions struct {
	// ExcludedActions holds canonical catalog action IDs ("project.get") the
	// operator removed on the active surface.
	//
	// Canonical IDs rather than tool names on purpose: --exclude-tools accepts
	// a group name, an individual tool name or an action ID, and only the
	// action catalog can resolve those three spellings to the same action. The
	// caller resolves them once against the catalog it just filtered, so this
	// package needs one table keyed by one kind of name.
	ExcludedActions []string
}

type ReleaseResourceOutput struct {
	TagName     string `json:"tag_name"`
	Name        string `json:"name"`
	Description string `json:"description"`
	Author      string `json:"author"`
	CreatedAt   string `json:"created_at,omitempty"`
	ReleasedAt  string `json:"released_at,omitempty"`
}

type SnippetResourceOutput struct {
	ID          int64  `json:"id"`
	Title       string `json:"title"`
	FileName    string `json:"file_name"`
	Description string `json:"description"`
	Visibility  string `json:"visibility"`
	WebURL      string `json:"web_url"`
}

type TagResourceOutput struct {
	Name      string `json:"name"`
	Message   string `json:"message,omitempty"`
	Target    string `json:"target"`
	Protected bool   `json:"protected"`
	CreatedAt string `json:"created_at,omitempty"`
}

type ToolSurfaceCallShape struct {
	Tool            string `json:"tool"`
	Action          string `json:"action,omitempty"`
	ActionLocation  string `json:"action_location,omitempty"`
	ParamsLocation  string `json:"params_location"`
	ConfirmLocation string `json:"confirm_location,omitempty"`
}

type ToolSurfaceDetail struct {
	ToolSurfaceEntry
	Call        ToolSurfaceCallShape `json:"call"`
	InputSchema any                  `json:"input_schema,omitempty"`
	// FineGrained is what a fine-grained personal access token needs for the
	// action at the GitLab release the table was recorded at, in GitLab's
	// words, or why none can run it. It is served for every session, classic
	// tokens included, since the detail is where a model looks up what an
	// action needs; the listing and find results do not carry it.
	FineGrained *finegrained.Description `json:"fine_grained,omitempty"`
	// Withheld says why this session may not run the action, when it is a
	// fine-grained session the action is withheld from, or, on a meta tool's
	// own detail, why it may run none of the tool's actions; absent otherwise.
	// The detail is served rather than answered not found, because the detail
	// is where a model looks up why it cannot find an action in the listing.
	Withheld *ToolSurfaceWithheld `json:"withheld,omitempty"`
}

type ToolSurfaceEntry struct {
	ID            string `json:"id"`
	Kind          string `json:"kind"`
	Tool          string `json:"tool"`
	Action        string `json:"action,omitempty"`
	Domain        string `json:"domain,omitempty"`
	BackingTool   string `json:"backing_tool,omitempty"`
	BackingAction string `json:"backing_action,omitempty"`
	Title         string `json:"title,omitempty"`
	Description   string `json:"description,omitempty"`
	// AliasOf names the primary entry when this action is a deliberate
	// alias: a second canonical ID projected from the same route and the
	// same individual tool, kept for discovery (user.me for user.current,
	// repository.file_history for repository.commit_list). Clients that
	// dedupe should keep the primary and treat this entry as a pointer.
	AliasOf        string                     `json:"alias_of,omitempty"`
	DetailURI      string                     `json:"detail_uri"`
	Destructive    bool                       `json:"destructive"`
	ReadOnly       bool                       `json:"read_only"`
	RequiredParams []ToolSurfaceRequiredParam `json:"required_params,omitempty"`
	// RequiredParamsAnyOf lists alternative requirement groups: the schema
	// accepts a call satisfying at least one group ("name, description or
	// color", "file_name+content or files"). These names are NOT in
	// RequiredParams — publishing an alternative as unconditionally
	// required invites clients to send every branch at once.
	RequiredParamsAnyOf [][]ToolSurfaceRequiredParam `json:"required_params_any_of,omitempty"`
}

type ToolSurfaceManifest struct {
	Surface          string `json:"surface"`
	URITemplate      string `json:"uri_template"`
	VisibleToolCount int    `json:"visible_tool_count"`
	EntryCount       int    `json:"entry_count"`
	// Subscriptions describes the resources/subscribe support this server
	// offers, or is omitted when it offers none. It lives in the manifest —
	// the one resource kept even on the minimal capability surface — so a
	// machine consumer has a single place to learn the watchable set.
	Subscriptions *ToolSurfaceSubscriptions `json:"subscriptions,omitempty"`
	VisibleTools  []ToolSurfaceVisibleTool  `json:"visible_tools"`
	Entries       []ToolSurfaceEntry        `json:"entries"`
}

type ToolSurfaceRequiredParam struct {
	Name string `json:"name"`
	Type string `json:"type,omitempty"`
}

type ToolSurfaceResourceOptions struct {
	Surface    string
	Tools      []*mcp.Tool
	Catalog    *actioncatalog.Catalog
	MetaRoutes map[string]toolutil.ActionMap
	// SubscribableURITemplates lists the resource URI templates that accept
	// resources/subscribe on this server. Empty means subscriptions are not
	// offered (CAPABILITY_SURFACE=minimal), and the manifest then omits the
	// section rather than advertising a capability the server would refuse.
	SubscribableURITemplates []string
	// ShareKey, when set, names the configuration the manifest describes,
	// and the snapshot built for it is cached for the process and served by
	// every server registered under the same key. The caller must include
	// in it everything the manifest depends on other than the credential:
	// the surface, the shared catalog's identity, the narrowing that
	// decides which tools are visible, the meta parameter-schema mode and
	// the capability surface. Empty builds a private snapshot.
	ShareKey string
	// StandaloneActions maps each standalone utility's registered tool name
	// to its canonical action ID. The meta and individual surfaces register
	// those tools beside the catalog rather than in it, so this is how their
	// details find the fine-grained requirement the catalog's actions carry.
	// Nil leaves them without the block.
	StandaloneActions map[string]string
	// ToolActions maps each registered tool to the canonical IDs of the
	// actions it runs: one for an individual or standalone tool, every action
	// of its group for a meta tool, none for the dynamic surface's two tools.
	// It is what a fine-grained session's read of the manifest is narrowed by
	// (issue 952), and it is the server's own answer, the same one its
	// tools/list filter reads, so the two can never list different tools.
	// Nil narrows only the entries whose action the catalog names.
	ToolActions map[string][]string
}

type ToolSurfaceSubscriptions struct {
	Supported bool `json:"supported"`
	// SubscribableURITemplates are the single-object resource URI templates
	// a subscription is accepted for; anything else is refused. Sourced
	// from the enforcement whitelist itself, never copied.
	SubscribableURITemplates []string `json:"subscribable_uri_templates"`
	Notification             string   `json:"notification"`
}

type ToolSurfaceVisibleTool struct {
	Name        string `json:"name"`
	Title       string `json:"title,omitempty"`
	DetailURI   string `json:"detail_uri"`
	ReadOnly    bool   `json:"read_only"`
	Destructive bool   `json:"destructive"`
}

type ToolSurfaceWithheld struct {
	Cause   string                      `json:"cause,omitempty"`
	Message string                      `json:"message,omitempty"`
	Actions []ToolSurfaceWithheldAction `json:"actions,omitempty"`
}

type ToolSurfaceWithheldAction struct {
	ID      string `json:"id"`
	Cause   string `json:"cause"`
	Message string `json:"message"`
}

type UserResourceOutput struct {
	ID       int64  `json:"id"`
	Username string `json:"username"`
	Name     string `json:"name"`
	Email    string `json:"email"`
	State    string `json:"state"`
	WebURL   string `json:"web_url"`
	IsAdmin  bool   `json:"is_admin"`
}

type WikiResourceOutput struct {
	Title    string `json:"title"`
	Slug     string `json:"slug"`
	Format   string `json:"format"`
	Content  string `json:"content,omitempty"`
	Encoding string `json:"encoding,omitempty"`
}