package golem.registry.v1

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc AuthenticateToken (AuthenticateTokenRequest, AuthenticateTokenResponse)

  registry_service.proto:27

  auth api

  message AuthenticateTokenRequest

  registry_service.proto:61

  • string secret = 1

  message AuthenticateTokenResponse

  registry_service.proto:65

  • oneof result

    • AuthenticateTokenSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc BatchUpdateResourceUsage (BatchUpdateResourceUsageRequest, BatchUpdateResourceUsageResponse)

  registry_service.proto:32

  message BatchUpdateResourceUsageRequest

  registry_service.proto:104

  • repeated ResourceUsageUpdate updates = 1

  message BatchUpdateResourceUsageResponse

  registry_service.proto:108

  • oneof result

    • BatchUpdateResourceUsageSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc DownloadComponent (DownloadComponentRequest, stream DownloadComponentResponse)

  registry_service.proto:35

  components api

  message DownloadComponentRequest

  registry_service.proto:119

  • optional component.ComponentId componentId = 1

  • uint64 revision = 2

  message DownloadComponentResponse

  registry_service.proto:124

  • oneof result

    • bytes successChunk = 1

    • RegistryServiceError error = 2

• rpc GetActiveMcpForDomain (GetActiveMcpForDomainRequest, GetActiveMcpForDomainResponse)

  registry_service.proto:49

  message GetActiveMcpForDomainRequest

  registry_service.proto:260

  • string domain = 1

  message GetActiveMcpForDomainResponse

  registry_service.proto:271

  • oneof result

    • GetActiveMcpForDomainSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc GetActiveRoutesForDomain (GetActiveRoutesForDomainRequest, GetActiveRoutesForDomainResponse)

  registry_service.proto:48

  current deployment agents/routes

  message GetActiveRoutesForDomainRequest

  registry_service.proto:256

  • string domain = 1

  message GetActiveRoutesForDomainResponse

  registry_service.proto:264

  • oneof result

    • GetActiveRoutesForDomainSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc GetAgentType (GetAgentTypeRequest, GetAgentTypeResponse)

  registry_service.proto:43

  message GetAgentTypeRequest

  registry_service.proto:212

  • optional common.EnvironmentId environment_id = 1

  • optional component.ComponentId component_id = 2

  • uint64 component_revision = 3

  • string agentType = 4

  message GetAgentTypeResponse

  registry_service.proto:219

  • oneof result

    • GetAgentTypeSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc GetAllAgentTypes (GetAllAgentTypesRequest, GetAllAgentTypesResponse)

  registry_service.proto:42

  agent types api

  message GetAllAgentTypesRequest

  registry_service.proto:195

  • optional common.EnvironmentId environment_id = 1

  • optional component.ComponentId component_id = 2

  • uint64 component_revision = 3

  message GetAllAgentTypesResponse

  registry_service.proto:201

  • oneof result

    • GetAllAgentTypesSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc GetAllDeployedComponentRevisions (GetAllDeployedComponentRevisionsRequest, GetAllDeployedComponentRevisionsResponse)

  registry_service.proto:38

  message GetAllDeployedComponentRevisionsRequest

  registry_service.proto:162

  • optional component.ComponentId componentId = 1

  message GetAllDeployedComponentRevisionsResponse

  registry_service.proto:166

  • oneof result

    • GetAllDeployedComponentRevisionsSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc GetComponentMetadata (GetComponentMetadataRequest, GetComponentMetadataResponse)

  registry_service.proto:36

  message GetComponentMetadataRequest

  registry_service.proto:131

  • optional component.ComponentId componentId = 1

  • uint64 revision = 2

  message GetComponentMetadataResponse

  registry_service.proto:136

  • oneof result

    • GetComponentMetadataSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc GetCurrentEnvironmentState (GetCurrentEnvironmentStateRequest, GetCurrentEnvironmentStateResponse)

  registry_service.proto:50

  message GetCurrentEnvironmentStateRequest

  registry_service.proto:286

  • optional common.EnvironmentId environment_id = 1

  message GetCurrentEnvironmentStateResponse

  registry_service.proto:290

  • oneof result

    • GetCurrentEnvironmentStateSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc GetDeployedComponentMetadata (GetDeployedComponentMetadataRequest, GetDeployedComponentMetadataResponse)

  registry_service.proto:37

  message GetDeployedComponentMetadataRequest

  registry_service.proto:147

  • optional component.ComponentId componentId = 1

  message GetDeployedComponentMetadataResponse

  registry_service.proto:151

  • oneof result

    • GetDeployedComponentMetadataSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc GetResourceDefinitionById (GetResourceDefinitionByIdRequest, GetResourceDefinitionByIdResponse)

  registry_service.proto:53

  quotas api

  message GetResourceDefinitionByIdRequest

  registry_service.proto:301

  • optional common.ResourceDefinitionId resource_definition_id = 1

  message GetResourceDefinitionByIdResponse

  registry_service.proto:305

  • oneof result

    • GetResourceDefinitionByIdSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc GetResourceDefinitionByName (GetResourceDefinitionByNameRequest, GetResourceDefinitionByNameResponse)

  registry_service.proto:54

  message GetResourceDefinitionByNameRequest

  registry_service.proto:316

  • optional common.EnvironmentId environment_id = 1

  • string name = 2

  message GetResourceDefinitionByNameResponse

  registry_service.proto:321

  • oneof result

    • GetResourceDefinitionByNameSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc GetResourceLimits (GetResourceLimitsRequest, GetResourceLimitsResponse)

  registry_service.proto:30

  limits api

  message GetResourceLimitsRequest

  registry_service.proto:76

  • optional common.AccountId accountId = 1

  message GetResourceLimitsResponse

  registry_service.proto:80

  • oneof result

    • GetResourceLimitsSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc ResolveAgentTypeByNames (ResolveAgentTypeByNamesRequest, ResolveAgentTypeByNamesResponse)

  registry_service.proto:44

  message ResolveAgentTypeByNamesRequest

  registry_service.proto:230

  • string app_name = 1

  • string environment_name = 2

  • string agent_type_name = 3

  • optional uint64 deployment_revision = 4

    If set, resolves at this concrete deployment revision. If omitted, resolves at the latest current deployment.

  • optional string owner_account_email = 5

  • optional auth.AuthCtx auth_ctx = 6

  message ResolveAgentTypeByNamesResponse

  registry_service.proto:241

  • oneof result

    • ResolveAgentTypeByNamesSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc ResolveComponent (ResolveComponentRequest, ResolveComponentResponse)

  registry_service.proto:39

  message ResolveComponentRequest

  registry_service.proto:177

  • optional common.AccountId resolving_account_id = 1

  • optional common.ApplicationId resolving_application_id = 2

  • optional common.EnvironmentId resolving_environment_id = 3

  • string component_slug = 4

  message ResolveComponentResponse

  registry_service.proto:184

  • oneof result

    • ResolveComponentSuccessResponse success = 1

    • RegistryServiceError error = 2

• rpc SubscribeRegistryInvalidations (SubscribeRegistryInvalidationsRequest, stream RegistryInvalidationEvent)

  registry_service.proto:57

  registry invalidation stream — multiplexed event types

  message SubscribeRegistryInvalidationsRequest

  registry_service.proto:334

  • optional uint64 last_seen_event_id = 1

    The event_id of the last event the client successfully processed. If omitted, the server starts streaming from live events only (no replay).

  message RegistryInvalidationEvent

  registry_service.proto:342

  Streamed to worker-service subscribers when any registry state changes. Each event carries exactly one payload variant.

  • uint64 event_id = 1

  • oneof payload

    • CursorExpiredEvent cursor_expired = 2

    • DeploymentChangedEvent deployment_changed = 3

    • AccountTokensInvalidatedEvent account_tokens_invalidated = 4

    • EnvironmentPermissionsChangedEvent permissions_changed = 5

    • DomainRegistrationChangedEvent domain_registration_changed = 6

    • SecuritySchemeChangedEvent security_scheme_changed = 7

    • ResourceDefinitionChangedEvent resource_definition_changed = 8

    • RetryPolicyChangedEvent retry_policy_changed = 9

    • AgentSecretChangedEvent agent_secret_changed = 10

    • ApplicationDeletedEvent application_deleted = 11

    • EnvironmentDeletedEvent environment_deleted = 12

    • CardRevokedEvent card_revoked = 13

• rpc UpdateWorkerConnectionLimit (UpdateWorkerConnectionLimitRequest, UpdateWorkerConnectionLimitResponse)

  registry_service.proto:31

  message UpdateWorkerConnectionLimitRequest

  registry_service.proto:91

  • optional common.AccountId accountId = 1

  • optional worker.AgentId agentId = 2

  • bool added = 3

  message UpdateWorkerConnectionLimitResponse

  registry_service.proto:97

  • oneof result

    • common.Empty success = 1

    • RegistryServiceError error = 2

Sent when an account's tokens are invalidated (token deleted or account soft-deleted).

Used in: RegistryInvalidationEvent

• optional common.AccountId account_id = 1

Sent when an environment agent secret is created, updated, or deleted.

Used in: RegistryInvalidationEvent

• optional common.EnvironmentId environment_id = 1

Sent when an application is soft-deleted so subscribers can flush any caches keyed on the application's name.

Used in: RegistryInvalidationEvent

• optional common.ApplicationId application_id = 1

• optional common.AccountId account_id = 2

• string app_name = 3

  Human-readable application name; matches the AgentResolutionCache key.

• repeated common.EnvironmentId environment_ids = 4

  UUIDs of all non-deleted environments that belonged to this application. Subscribers use these to perform targeted cache invalidation rather than flushing the entire cache.

Used in: AuthenticateTokenResponse

• optional auth.AuthCtx auth_ctx = 1

Used in: BatchUpdateResourceUsageResponse

• optional common.AccountResourceLimits account_resource_limits = 1

Sent when a permission card is revoked or deleted.

Used in: RegistryInvalidationEvent

• repeated common.UUID card_ids = 1

Sent when the client's cursor is older than the server's retention window. The client must flush all caches and use this event's event_id as its new cursor.

Used in: RegistryInvalidationEvent

(message has no fields)

Sent when the current deployment for an environment changes.

Used in: RegistryInvalidationEvent

• optional common.EnvironmentId environment_id = 1

• uint64 deployment_revision = 2

• uint64 current_deployment_revision = 3

Sent when domain registrations change (create/delete).

Used in: RegistryInvalidationEvent

• optional common.EnvironmentId environment_id = 1

• repeated string domains = 2

Sent when an environment is soft-deleted so subscribers can flush any caches scoped to the environment.

Used in: RegistryInvalidationEvent

• optional common.EnvironmentId environment_id = 1

• string app_name = 2

  Human-readable application name; matches the AgentResolutionCache key.

• string env_name = 3

  Human-readable environment name; matches the AgentResolutionCache key.

Sent when environment sharing permissions change (create/update/delete share).

Used in: RegistryInvalidationEvent

• optional common.EnvironmentId environment_id = 1

• optional common.AccountId grantee_account_id = 2

Used in: GetActiveMcpForDomainResponse

• optional mcp.CompiledMcp compiled_mcp = 1

Used in: GetActiveRoutesForDomainResponse

• optional customapi.CompiledRoutes compiled_routes = 1

Used in: GetAgentTypeResponse

• optional RegisteredAgentType agent_type = 1

Used in: GetAllAgentTypesResponse

• repeated RegisteredAgentType agent_types = 1

Used in: GetAllDeployedComponentRevisionsResponse

• repeated component.Component components = 1

Used in: GetComponentMetadataResponse

• optional component.Component component = 1

Used in: GetCurrentEnvironmentStateResponse

• optional EnvironmentState environment_state = 1

Used in: GetDeployedComponentMetadataResponse

• optional component.Component component = 1

Used in: GetResourceDefinitionByIdResponse

• optional common.ResourceDefinition resource_definition = 1

Used in: GetResourceDefinitionByNameResponse

• optional common.ResourceDefinition resource_definition = 1

Used in: GetResourceLimitsResponse

• optional common.ResourceLimits limits = 1

Used in: AuthenticateTokenResponse, BatchUpdateResourceUsageResponse, DownloadComponentResponse, GetActiveMcpForDomainResponse, GetActiveRoutesForDomainResponse, GetAgentTypeResponse, GetAllAgentTypesResponse, GetAllDeployedComponentRevisionsResponse, GetComponentMetadataResponse, GetCurrentEnvironmentStateResponse, GetDeployedComponentMetadataResponse, GetResourceDefinitionByIdResponse, GetResourceDefinitionByNameResponse, GetResourceLimitsResponse, ResolveAgentTypeByNamesResponse, ResolveComponentResponse, UpdateWorkerConnectionLimitResponse

• oneof error

  • common.ErrorsBody bad_request = 1

  • common.ErrorBody unauthorized = 2

  • common.ErrorBody limit_exceeded = 3

  • common.ErrorBody not_found = 4

  • common.ErrorBody already_exists = 5

  • common.ErrorBody internal_error = 6

  • common.ErrorBody could_not_authenticate = 7

Used in: ResolveAgentTypeByNamesResponse

• optional RegisteredAgentType agent_type = 1

• optional common.EnvironmentId environment_id = 2

• uint64 deployment_revision = 3

• optional uint64 current_deployment_revision = 4

  Present only when request.deployment_revision is not set.

Used in: ResolveComponentResponse

• optional component.Component component = 1

Sent when a resource definition is created, updated, or deleted.

Used in: RegistryInvalidationEvent

• optional common.EnvironmentId environment_id = 1

• optional common.ResourceDefinitionId resource_definition_id = 2

• string resource_name = 3

Sent when an environment retry policy is created, updated, or deleted.

Used in: RegistryInvalidationEvent

• optional common.EnvironmentId environment_id = 1

Sent when a security scheme is created, updated, or deleted.

Used in: RegistryInvalidationEvent

• optional common.EnvironmentId environment_id = 1