komrad

check_forges

Check that each connected forge still accepts its credential, and record the result on the connection.

writesnot idempotentMCP toolForge

Calling it#

curl -X POST http://127.0.0.1:8787/komrad.forge.v1.ForgeService/CheckForges \
  -H 'Content-Type: application/json' \
  -d '{}'

Request#

Empty#

No fields.

Response#

CheckForgesResponse#

Types#

ForgeCheck#

ForgeCheck is what one forge said about komrad's credential.

FieldTypeDescription
forgeForge

The connection checked.

problemstring

What the forge said was wrong. Empty when the forge accepted the credential.

problem_kindProblemKind

The kind of problem. Unspecified when there is none.

Forge#

Forge is komrad's connection to one forge host and the credential komrad uses there.

FieldTypeDescription
iduuid*

The connection's id.

kindKind

The kind of forge the host runs.

hoststring

The host that git remotes name, such as github.com.

api_urlstring

The address of an enterprise host's API. Empty for the public forge.

methodCredentialMethod

How the credential was given.

loginstring

The account the forge says the credential belongs to, a user login or an App's name.

verified_attimestamp

When the forge last accepted the credential. Unset once the forge refuses it.

has_credentialbool

Whether this machine still has the credential. A token connection needs its token file, and a github_app connection always has its credential.

created_attimestamp

When the connection was created.

ProblemKind#

ProblemKind is the kind of problem a check found with a forge connection.

ValueDescription
refused

The forge refused the credential.

no-credential

This machine no longer has the credential.

unreachable

The forge could not be reached.

Kind#

Kind is the kind of forge a host runs.

ValueDescription
github

GitHub, or a GitHub Enterprise host.

gitlab

GitLab, or a self-managed GitLab host.

CredentialMethod#

CredentialMethod is how a forge connection's credential is given.

ValueDescription
token

A token the person supplied.

rotating-token

A GitLab token that komrad rotates before it expires.

github-app

A token minted from the GitHub App in the server's config.