Documentation
¶
Overview ¶
Package runnercontrollers implements MCP tools for GitLab runner controller operations.
The package wraps GitLab GraphQL runner manager fields:
Index ¶
- func ActionSpecs(client *gitlabclient.Client) []toolutil.ActionSpec
- func Delete(ctx context.Context, client *gitlabclient.Client, input DeleteInput) error
- func FormatDetailsMarkdown(out DetailsOutput) string
- func FormatListMarkdown(out ListOutput) string
- func FormatOutputMarkdown(out Output) string
- type CreateInput
- type DeleteInput
- type DetailsOutput
- type GetInput
- type ListInput
- type ListOutput
- type Output
- type UpdateInput
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func ActionSpecs ¶
func ActionSpecs(client *gitlabclient.Client) []toolutil.ActionSpec
ActionSpecs returns canonical specs for runner controller actions.
func Delete ¶
func Delete(ctx context.Context, client *gitlabclient.Client, input DeleteInput) error
Delete removes a runner controller (admin only).
func FormatDetailsMarkdown ¶
func FormatDetailsMarkdown(out DetailsOutput) string
FormatDetailsMarkdown renders one runner controller in full: the same fields with whether it is connected right now.
func FormatListMarkdown ¶
func FormatListMarkdown(out ListOutput) string
FormatListMarkdown renders a page of runner controllers as a Markdown table.
func FormatOutputMarkdown ¶
FormatOutputMarkdown renders one runner controller as the card of a single object.
Types ¶
type CreateInput ¶
type CreateInput struct {
Description string `json:"description,omitempty" jsonschema:"Description of the runner controller"`
State string `json:"state,omitempty" jsonschema:"State: enabled, disabled, or dry_run"`
}
CreateInput defines parameters for creating a runner controller.
type DeleteInput ¶
type DeleteInput struct {
ControllerID int64 `json:"controller_id" jsonschema:"Runner controller ID,required"`
}
DeleteInput defines parameters for deleting a runner controller.
type DetailsOutput ¶
type DetailsOutput struct {
toolutil.HintableOutput
Output
Connected bool `json:"connected"`
}
DetailsOutput represents detailed runner controller information.
func Get ¶
func Get(ctx context.Context, client *gitlabclient.Client, input GetInput) (DetailsOutput, error)
Get retrieves a single runner controller (admin only).
type GetInput ¶
type GetInput struct {
ControllerID int64 `json:"controller_id" jsonschema:"Runner controller ID,required"`
}
GetInput defines parameters for getting a runner controller.
type ListInput ¶
type ListInput struct {
toolutil.PaginationInput
toolutil.KeysetPaginationInput
OrderBy string `json:"order_by,omitempty" jsonschema:"Column to order the result set by (e.g. id, created_at)"`
Sort string `json:"sort,omitempty" jsonschema:"Sort order: asc or desc"`
}
ListInput defines parameters for listing runner controllers.
type ListOutput ¶
type ListOutput struct {
toolutil.HintableOutput
Controllers []Output `json:"controllers"`
Pagination toolutil.PaginationOutput `json:"pagination"`
}
ListOutput holds a paginated list of runner controllers.
func List ¶
func List(ctx context.Context, client *gitlabclient.Client, input ListInput) (ListOutput, error)
List retrieves all runner controllers (admin only).
type Output ¶
type Output struct {
toolutil.HintableOutput
ID int64 `json:"id"`
Description string `json:"description"`
State string `json:"state"`
CreatedAt string `json:"created_at,omitempty"`
UpdatedAt string `json:"updated_at,omitempty"`
}
Output represents a runner controller in responses.
func Create ¶
func Create(ctx context.Context, client *gitlabclient.Client, input CreateInput) (Output, error)
Create registers a new runner controller (admin only).
func Update ¶
func Update(ctx context.Context, client *gitlabclient.Client, input UpdateInput) (Output, error)
Update modifies an existing runner controller (admin only).
type UpdateInput ¶
type UpdateInput struct {
ControllerID int64 `json:"controller_id" jsonschema:"Runner controller ID,required"`
Description string `json:"description,omitempty" jsonschema:"New description"`
State string `json:"state,omitempty" jsonschema:"New state: enabled, disabled, or dry_run"`
}
UpdateInput defines parameters for updating a runner controller.
Source Files