@google-cloud/agentregistry 0.1.0

package/build/protos/google/cloud/agentregistry/v1/binding.proto

@@ -0,0 +1,120 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.agentregistry.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.AgentRegistry.V1";
+option go_package = "cloud.google.com/go/agentregistry/apiv1/agentregistrypb;agentregistrypb";
+option java_multiple_files = true;
+option java_outer_classname = "BindingProto";
+option java_package = "com.google.cloud.agentregistry.v1";
+option php_namespace = "Google\\Cloud\\AgentRegistry\\V1";
+option ruby_package = "Google::Cloud::AgentRegistry::V1";
+
+// Represents a user-defined Binding.
+message Binding {
+  option (google.api.resource) = {
+    type: "agentregistry.googleapis.com/Binding"
+    pattern: "projects/{project}/locations/{location}/bindings/{binding}"
+    plural: "bindings"
+    singular: "binding"
+  };
+
+  // The source of the Binding.
+  message Source {
+    // The type of the source, currently only supports Agents.
+    // Potential future fields include 'tag', etc.
+    oneof source_type {
+      // The identifier of the source Agent.
+      // Format:
+      //
+      // * `urn:agent:{publisher}:{namespace}:{name}`
+      string identifier = 1;
+    }
+  }
+
+  // The target of the Binding.
+  message Target {
+    // The type of the target, currently only supports an AgentRegistry
+    // Resource.
+    // Potential future fields include 'tag', etc.
+    oneof target_type {
+      // The identifier of the target Agent, MCP Server, or Endpoint.
+      // Format:
+      //
+      // * `urn:agent:{publisher}:{namespace}:{name}`
+      // * `urn:mcp:{publisher}:{namespace}:{name}`
+      // * `urn:endpoint:{publisher}:{namespace}:{name}`
+      string identifier = 1;
+    }
+  }
+
+  // The AuthProvider of the Binding.
+  message AuthProviderBinding {
+    // Required. The resource name of the target AuthProvider.
+    // Format:
+    //
+    // * `projects/{project}/locations/{location}/authProviders/{auth_provider}`
+    string auth_provider = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Optional. The list of OAuth2 scopes of the AuthProvider.
+    repeated string scopes = 2 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. The continue URI of the AuthProvider.
+    // The URI is used to reauthenticate the user and finalize the managed OAuth
+    // flow.
+    string continue_uri = 3 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // The configuration for the Binding.
+  oneof binding {
+    // The binding for AuthProvider.
+    AuthProviderBinding auth_provider_binding = 6;
+  }
+
+  // Required. Identifier. The resource name of the Binding.
+  // Format: `projects/{project}/locations/{location}/bindings/{binding}`.
+  string name = 1 [
+    (google.api.field_behavior) = IDENTIFIER,
+    (google.api.field_behavior) = REQUIRED
+  ];
+
+  // Optional. User-defined display name for the Binding.
+  // Can have a maximum length of `63` characters.
+  string display_name = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. User-defined description of a Binding.
+  // Can have a maximum length of `2048` characters.
+  string description = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. The target Agent of the Binding.
+  Source source = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The target Agent Registry Resource of the Binding.
+  Target target = 5 [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. Timestamp when this binding was created.
+  google.protobuf.Timestamp create_time = 7
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Timestamp when this binding was last updated.
+  google.protobuf.Timestamp update_time = 8
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}

package/build/protos/google/cloud/agentregistry/v1/endpoint.proto

@@ -0,0 +1,75 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.agentregistry.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/agentregistry/v1/properties.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.AgentRegistry.V1";
+option go_package = "cloud.google.com/go/agentregistry/apiv1/agentregistrypb;agentregistrypb";
+option java_multiple_files = true;
+option java_outer_classname = "EndpointProto";
+option java_package = "com.google.cloud.agentregistry.v1";
+option php_namespace = "Google\\Cloud\\AgentRegistry\\V1";
+option ruby_package = "Google::Cloud::AgentRegistry::V1";
+
+// Represents an Endpoint.
+message Endpoint {
+  option (google.api.resource) = {
+    type: "agentregistry.googleapis.com/Endpoint"
+    pattern: "projects/{project}/locations/{location}/endpoints/{endpoint}"
+    plural: "endpoints"
+    singular: "endpoint"
+  };
+
+  // Identifier. The resource name of the Endpoint.
+  // Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`.
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Output only. A stable, globally unique identifier for Endpoint.
+  string endpoint_id = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Display name for the Endpoint.
+  string display_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Description of an Endpoint.
+  string description = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Required. The connection details for the Endpoint.
+  repeated Interface interfaces = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. Create time.
+  google.protobuf.Timestamp create_time = 5
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Update time.
+  google.protobuf.Timestamp update_time = 6
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Attributes of the Endpoint.
+  //
+  // Valid values:
+  //
+  //  * `agentregistry.googleapis.com/system/RuntimeReference`:
+  //    {"uri": "//..."} - the URI of the underlying resource hosting the
+  //    Endpoint, for example, the GKE Deployment.
+  map<string, google.protobuf.Struct> attributes = 7
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}

package/build/protos/google/cloud/agentregistry/v1/mcp_server.proto

@@ -0,0 +1,120 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.agentregistry.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/agentregistry/v1/properties.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.AgentRegistry.V1";
+option go_package = "cloud.google.com/go/agentregistry/apiv1/agentregistrypb;agentregistrypb";
+option java_multiple_files = true;
+option java_outer_classname = "McpServerProto";
+option java_package = "com.google.cloud.agentregistry.v1";
+option php_namespace = "Google\\Cloud\\AgentRegistry\\V1";
+option ruby_package = "Google::Cloud::AgentRegistry::V1";
+
+// Represents an MCP (Model Context Protocol) Server.
+message McpServer {
+  option (google.api.resource) = {
+    type: "agentregistry.googleapis.com/McpServer"
+    pattern: "projects/{project}/locations/{location}/mcpServers/{mcp_server}"
+    plural: "mcpServers"
+    singular: "mcpServer"
+  };
+
+  // Represents a single tool provided by an MCP Server.
+  message Tool {
+    // Annotations describing the characteristics and behavior of a tool or
+    // operation.
+    message Annotations {
+      // Output only. A human-readable title for the tool.
+      string title = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+      // Output only. If true, the tool may perform destructive updates to its
+      // environment. If false, the tool performs only additive updates. NOTE:
+      // This property is meaningful only when `read_only_hint == false`
+      // Default: true
+      bool destructive_hint = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+      // Output only. If true, calling the tool repeatedly with the same
+      // arguments will have no additional effect on its environment. NOTE: This
+      // property is meaningful only when `read_only_hint == false` Default:
+      // false
+      bool idempotent_hint = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+      // Output only. If true, this tool may interact with an "open world" of
+      // external entities. If false, the tool's domain of interaction is
+      // closed. For example, the world of a web search tool is open, whereas
+      // that of a memory tool is not. Default: true
+      bool open_world_hint = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+      // Output only. If true, the tool does not modify its environment.
+      // Default: false
+      bool read_only_hint = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+    }
+
+    // Output only. Human-readable name of the tool.
+    string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. Description of what the tool does.
+    string description = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. Annotations associated with the tool.
+    Annotations annotations = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // Identifier. The resource name of the MCP Server.
+  // Format: `projects/{project}/locations/{location}/mcpServers/{mcp_server}`.
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Output only. A stable, globally unique identifier for MCP Servers.
+  string mcp_server_id = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The display name of the MCP Server.
+  string display_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The description of the MCP Server.
+  string description = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The connection details for the MCP Server.
+  repeated Interface interfaces = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Tools provided by the MCP Server.
+  repeated Tool tools = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Create time.
+  google.protobuf.Timestamp create_time = 6
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Update time.
+  google.protobuf.Timestamp update_time = 7
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Attributes of the MCP Server.
+  // Valid values:
+  //
+  //  * `agentregistry.googleapis.com/system/RuntimeIdentity`: {"principal":
+  //  "principal://..."} - the runtime identity associated with the MCP Server.
+  //  * `agentregistry.googleapis.com/system/RuntimeReference`: {"uri": "//..."}
+  //  - the URI of the underlying resource hosting the MCP Server, for
+  //  example, the GKE Deployment.
+  map<string, google.protobuf.Struct> attributes = 8
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}

package/build/protos/google/cloud/agentregistry/v1/properties.proto

@@ -0,0 +1,51 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.agentregistry.v1;
+
+import "google/api/field_behavior.proto";
+
+option csharp_namespace = "Google.Cloud.AgentRegistry.V1";
+option go_package = "cloud.google.com/go/agentregistry/apiv1/agentregistrypb;agentregistrypb";
+option java_multiple_files = true;
+option java_outer_classname = "PropertiesProto";
+option java_package = "com.google.cloud.agentregistry.v1";
+option php_namespace = "Google\\Cloud\\AgentRegistry\\V1";
+option ruby_package = "Google::Cloud::AgentRegistry::V1";
+
+// Represents the connection details for an Agent or MCP Server.
+message Interface {
+  // The protocol binding of the interface.
+  enum ProtocolBinding {
+    // Unspecified transport protocol.
+    PROTOCOL_BINDING_UNSPECIFIED = 0;
+
+    // JSON-RPC specification.
+    JSONRPC = 1;
+
+    // gRPC specification.
+    GRPC = 2;
+
+    // HTTP+JSON specification.
+    HTTP_JSON = 3;
+  }
+
+  // Required. The destination URL.
+  string url = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The protocol binding of the interface.
+  ProtocolBinding protocol_binding = 2 [(google.api.field_behavior) = REQUIRED];
+}

package/build/protos/google/cloud/agentregistry/v1/service.proto

@@ -0,0 +1,154 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.agentregistry.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/agentregistry/v1/properties.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.AgentRegistry.V1";
+option go_package = "cloud.google.com/go/agentregistry/apiv1/agentregistrypb;agentregistrypb";
+option java_multiple_files = true;
+option java_outer_classname = "ServiceProto";
+option java_package = "com.google.cloud.agentregistry.v1";
+option php_namespace = "Google\\Cloud\\AgentRegistry\\V1";
+option ruby_package = "Google::Cloud::AgentRegistry::V1";
+
+// Represents a user-defined Service.
+message Service {
+  option (google.api.resource) = {
+    type: "agentregistry.googleapis.com/Service"
+    pattern: "projects/{project}/locations/{location}/services/{service}"
+    plural: "services"
+    singular: "service"
+  };
+
+  // The spec of the agent.
+  message AgentSpec {
+    // The type of the agent spec.
+    enum Type {
+      // Unspecified type.
+      TYPE_UNSPECIFIED = 0;
+
+      // There is no spec for the Agent. The `content` field must be empty.
+      NO_SPEC = 1;
+
+      // The content is an A2A Agent Card following the A2A specification.
+      // The `interfaces` field must be empty.
+      A2A_AGENT_CARD = 2;
+    }
+
+    // Required. The type of the agent spec content.
+    Type type = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Optional. The content of the Agent spec in the JSON format.
+    // This payload is validated against the schema for the specified type.
+    // The content size is limited to `10KB`.
+    google.protobuf.Struct content = 2 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // The spec of the MCP Server.
+  message McpServerSpec {
+    // The type of the MCP Server spec.
+    enum Type {
+      // Unspecified type.
+      TYPE_UNSPECIFIED = 0;
+
+      // There is no spec for the MCP Server. The `content` field must be empty.
+      NO_SPEC = 1;
+
+      // The content is a MCP Tool Spec following the One MCP specification.
+      // The payload is the same as the `tools/list` response.
+      TOOL_SPEC = 2;
+    }
+
+    // Required. The type of the MCP Server spec content.
+    Type type = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Optional. The content of the MCP Server spec.
+    // This payload is validated against the schema for the specified type.
+    // The content size is limited to `10KB`.
+    google.protobuf.Struct content = 2 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // The spec of the endpoint.
+  message EndpointSpec {
+    // The type of the endpoint spec.
+    enum Type {
+      // Unspecified type.
+      TYPE_UNSPECIFIED = 0;
+
+      // There is no spec for the Endpoint. The `content` field must be empty.
+      NO_SPEC = 1;
+    }
+
+    // Required. The type of the endpoint spec content.
+    Type type = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Optional. The content of the endpoint spec.
+    // Reserved for future use.
+    google.protobuf.Struct content = 2 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // The spec of the service. At least one of the specs must be set.
+  oneof spec {
+    // Optional. The spec of the Agent. When `agent_spec` is set, the type of
+    // the service is Agent.
+    AgentSpec agent_spec = 5 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. The spec of the MCP Server. When `mcp_server_spec` is set, the
+    // type of the service is MCP Server.
+    McpServerSpec mcp_server_spec = 6 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. The spec of the Endpoint. When `endpoint_spec` is set, the type
+    // of the service is Endpoint.
+    EndpointSpec endpoint_spec = 7 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Identifier. The resource name of the Service.
+  // Format: `projects/{project}/locations/{location}/services/{service}`.
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Optional. User-defined display name for the Service.
+  // Can have a maximum length of `63` characters.
+  string display_name = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. User-defined description of an Service.
+  // Can have a maximum length of `2048` characters.
+  string description = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The connection details for the Service.
+  repeated Interface interfaces = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. The resource name of the resulting Agent, MCP Server, or
+  // Endpoint. Format:
+  //
+  // * `projects/{project}/locations/{location}/mcpServers/{mcp_server}`
+  // * `projects/{project}/locations/{location}/agents/{agent}`
+  // * `projects/{project}/locations/{location}/endpoints/{endpoint}`
+  string registry_resource = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Create time.
+  google.protobuf.Timestamp create_time = 8
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Update time.
+  google.protobuf.Timestamp update_time = 9
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}