func FormatExistsMarkdown(out ExistsOutput) *mcp.CallToolResult

func FormatExistsMarkdownString(out ExistsOutput) string

func FormatListMarkdown(out ListOutput) *mcp.CallToolResult

func FormatListMarkdownString(out ListOutput) string

func FormatMarkdown(out Output) *mcp.CallToolResult

func FormatMarkdownString(out Output) string

func RegisterMeta(server *mcp.Server, client *gitlabclient.Client)

func RegisterTools(server *mcp.Server, client *gitlabclient.Client)

type ExistsInput struct {
	ID string `json:"id" jsonschema:"Namespace path to check for existence,required"`
	ParentID int64 `json:"parent_id,omitempty" jsonschema:"Parent namespace ID to scope the check"`
}

type ExistsOutput struct {
	toolutil.HintableOutput
	Exists bool `json:"exists"`
	Suggests []string `json:"suggests,omitempty"`
}

func Exists ¶

func Exists(ctx context.Context, client *gitlabclient.Client, input ExistsInput) (ExistsOutput, error)

Exists checks whether a namespace path is available.

type GetInput struct {
	ID string `json:"id" jsonschema:"Namespace ID or path,required"`
}

type ListInput struct {
	Search string `json:"search,omitempty" jsonschema:"Filter namespaces by search term"`
	OwnedOnly bool `json:"owned_only,omitempty" jsonschema:"If true return only namespaces owned by the authenticated user"`
	TopLevelOnly bool `json:"top_level_only,omitempty" jsonschema:"If true return only top-level namespaces"`
	Page int64 `json:"page,omitempty" jsonschema:"Page number for pagination (default 1)"`
	PerPage int64 `json:"per_page,omitempty" jsonschema:"Number of items per page (default 20, max 100)"`
}

type ListOutput struct {
	toolutil.HintableOutput
	Namespaces []Output `json:"namespaces"`
	Pagination toolutil.PaginationOutput `json:"pagination"`
}

func List ¶

func List(ctx context.Context, client *gitlabclient.Client, input ListInput) (ListOutput, error)

List returns a paginated list of namespaces visible to the user.

func Search ¶

func Search(ctx context.Context, client *gitlabclient.Client, input SearchInput) (ListOutput, error)

Search searches namespaces by query string.

type Output struct {
	toolutil.HintableOutput
	ID int64 `json:"id"`
	Name string `json:"name"`
	Path string `json:"path"`
	Kind string `json:"kind"`
	FullPath string `json:"full_path"`
	ParentID int64 `json:"parent_id,omitempty"`
	AvatarURL string `json:"avatar_url,omitempty"`
	WebURL string `json:"web_url,omitempty"`
	MembersCountWithDescendants int64 `json:"members_count_with_descendants,omitempty"`
	BillableMembersCount int64 `json:"billable_members_count,omitempty"`
	Plan string `json:"plan,omitempty"`
	Trial bool `json:"trial,omitempty"`
}

func Get ¶

func Get(ctx context.Context, client *gitlabclient.Client, input GetInput) (Output, error)

Get retrieves a single namespace by ID or path. Uses a raw HTTP request to work around upstream client-go issue where GetNamespace expects a single JSON object but some GitLab versions return an array for path-based lookups.

type SearchInput struct {
	Query string `json:"query" jsonschema:"Search query string for namespaces,required"`
}