Documentation
¶
Overview ¶
Package runnercontrollertokens implements MCP tool handlers for GitLab Runner Controller Tokens. This is an admin-only API. Experimental: may change or be removed in future versions.
Index ¶
- func FormatGetMarkdown(out Output) *mcp.CallToolResult
- func FormatListMarkdown(out ListOutput) string
- func FormatOutputMarkdown(out Output) string
- func RegisterMeta(server *mcp.Server, client *gitlabclient.Client)
- func RegisterTools(server *mcp.Server, client *gitlabclient.Client)
- func Revoke(ctx context.Context, client *gitlabclient.Client, input RevokeInput) error
- type CreateInput
- type GetInput
- type ListInput
- type ListOutput
- type Output
- type RevokeInput
- type RotateInput
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func FormatGetMarkdown ¶
func FormatGetMarkdown(out Output) *mcp.CallToolResult
FormatGetMarkdown formats Get output as an MCP tool result.
func FormatListMarkdown ¶
func FormatListMarkdown(out ListOutput) string
FormatListMarkdown renders a list of runner controller tokens as Markdown.
func FormatOutputMarkdown ¶
FormatOutputMarkdown renders a runner controller token as Markdown.
func RegisterMeta ¶
func RegisterMeta(server *mcp.Server, client *gitlabclient.Client)
RegisterMeta registers the gitlab_runner_controller_token meta-tool.
func RegisterTools ¶
func RegisterTools(server *mcp.Server, client *gitlabclient.Client)
RegisterTools registers all runner controller token tools on the MCP server.
func Revoke ¶
func Revoke(ctx context.Context, client *gitlabclient.Client, input RevokeInput) error
Revoke revokes a runner controller token (admin only).
Types ¶
type CreateInput ¶
type CreateInput struct {
ControllerID int64 `json:"controller_id" jsonschema:"Runner controller ID,required"`
Description string `json:"description,omitempty" jsonschema:"Description of the token"`
}
CreateInput defines parameters for creating a runner controller token.
type GetInput ¶
type GetInput struct {
ControllerID int64 `json:"controller_id" jsonschema:"Runner controller ID,required"`
TokenID int64 `json:"token_id" jsonschema:"Token ID,required"`
}
GetInput defines parameters for getting a runner controller token.
type ListInput ¶
type ListInput struct {
ControllerID int64 `json:"controller_id" jsonschema:"Runner controller ID,required"`
toolutil.PaginationInput
}
ListInput defines parameters for listing runner controller tokens.
type ListOutput ¶
type ListOutput struct {
toolutil.HintableOutput
Tokens []Output `json:"tokens"`
Pagination toolutil.PaginationOutput `json:"pagination"`
}
ListOutput holds a paginated list of runner controller tokens.
func List ¶
func List(ctx context.Context, client *gitlabclient.Client, input ListInput) (ListOutput, error)
List retrieves all tokens for a runner controller (admin only).
type Output ¶
type Output struct {
toolutil.HintableOutput
ID int64 `json:"id"`
RunnerControllerID int64 `json:"runner_controller_id"`
Description string `json:"description"`
Token string `json:"token,omitempty"`
LastUsedAt string `json:"last_used_at,omitempty"`
CreatedAt string `json:"created_at,omitempty"`
UpdatedAt string `json:"updated_at,omitempty"`
}
Output represents a runner controller token in responses.
func Create ¶
func Create(ctx context.Context, client *gitlabclient.Client, input CreateInput) (Output, error)
Create creates a new runner controller token (admin only).
func Rotate ¶
func Rotate(ctx context.Context, client *gitlabclient.Client, input RotateInput) (Output, error)
Rotate rotates a runner controller token (admin only).
type RevokeInput ¶
type RevokeInput struct {
ControllerID int64 `json:"controller_id" jsonschema:"Runner controller ID,required"`
TokenID int64 `json:"token_id" jsonschema:"Token ID,required"`
}
RevokeInput defines parameters for revoking a runner controller token.
type RotateInput ¶
type RotateInput struct {
ControllerID int64 `json:"controller_id" jsonschema:"Runner controller ID,required"`
TokenID int64 `json:"token_id" jsonschema:"Token ID,required"`
}
RotateInput defines parameters for rotating a runner controller token.
Source Files