// 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/annotations.proto";
import "google/api/client.proto";
import "google/api/field_behavior.proto";
import "google/api/field_info.proto";
import "google/api/resource.proto";
import "google/cloud/agentregistry/v1/agent.proto";
import "google/cloud/agentregistry/v1/binding.proto";
import "google/cloud/agentregistry/v1/endpoint.proto";
import "google/cloud/agentregistry/v1/mcp_server.proto";
import "google/cloud/agentregistry/v1/service.proto";
import "google/longrunning/operations.proto";
import "google/protobuf/empty.proto";
import "google/protobuf/field_mask.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 = "AgentRegistryServiceProto";
option java_package = "com.google.cloud.agentregistry.v1";
option php_namespace = "Google\\Cloud\\AgentRegistry\\V1";
option ruby_package = "Google::Cloud::AgentRegistry::V1";

// Service for managing Agents, Endpoints, McpServers, Services, and Bindings.
service AgentRegistry {
  option (google.api.default_host) = "agentregistry.googleapis.com";
  option (google.api.oauth_scopes) =
      "https://www.googleapis.com/auth/agentregistry.read-only,"
      "https://www.googleapis.com/auth/agentregistry.read-write,"
      "https://www.googleapis.com/auth/cloud-platform,"
      "https://www.googleapis.com/auth/cloud-platform.read-only";

  // Lists Agents in a given project and location.
  rpc ListAgents(ListAgentsRequest) returns (ListAgentsResponse) {
    option (google.api.http) = {
      get: "/v1/{parent=projects/*/locations/*}/agents"
    };
    option (google.api.method_signature) = "parent";
  }

  // Searches Agents in a given project and location.
  rpc SearchAgents(SearchAgentsRequest) returns (SearchAgentsResponse) {
    option (google.api.http) = {
      post: "/v1/{parent=projects/*/locations/*}/agents:search"
      body: "*"
    };
    option (google.api.method_signature) = "parent";
  }

  // Gets details of a single Agent.
  rpc GetAgent(GetAgentRequest) returns (Agent) {
    option (google.api.http) = {
      get: "/v1/{name=projects/*/locations/*/agents/*}"
    };
    option (google.api.method_signature) = "name";
  }

  // Lists Endpoints in a given project and location.
  rpc ListEndpoints(ListEndpointsRequest) returns (ListEndpointsResponse) {
    option (google.api.http) = {
      get: "/v1/{parent=projects/*/locations/*}/endpoints"
    };
    option (google.api.method_signature) = "parent";
  }

  // Gets details of a single Endpoint.
  rpc GetEndpoint(GetEndpointRequest) returns (Endpoint) {
    option (google.api.http) = {
      get: "/v1/{name=projects/*/locations/*/endpoints/*}"
    };
    option (google.api.method_signature) = "name";
  }

  // Lists McpServers in a given project and location.
  rpc ListMcpServers(ListMcpServersRequest) returns (ListMcpServersResponse) {
    option (google.api.http) = {
      get: "/v1/{parent=projects/*/locations/*}/mcpServers"
    };
    option (google.api.method_signature) = "parent";
  }

  // Searches McpServers in a given project and location.
  rpc SearchMcpServers(SearchMcpServersRequest)
      returns (SearchMcpServersResponse) {
    option (google.api.http) = {
      post: "/v1/{parent=projects/*/locations/*}/mcpServers:search"
      body: "*"
    };
    option (google.api.method_signature) = "parent";
  }

  // Gets details of a single McpServer.
  rpc GetMcpServer(GetMcpServerRequest) returns (McpServer) {
    option (google.api.http) = {
      get: "/v1/{name=projects/*/locations/*/mcpServers/*}"
    };
    option (google.api.method_signature) = "name";
  }

  // Lists Services in a given project and location.
  rpc ListServices(ListServicesRequest) returns (ListServicesResponse) {
    option (google.api.http) = {
      get: "/v1/{parent=projects/*/locations/*}/services"
    };
    option (google.api.method_signature) = "parent";
  }

  // Gets details of a single Service.
  rpc GetService(GetServiceRequest) returns (Service) {
    option (google.api.http) = {
      get: "/v1/{name=projects/*/locations/*/services/*}"
    };
    option (google.api.method_signature) = "name";
  }

  // Creates a new Service in a given project and location.
  rpc CreateService(CreateServiceRequest)
      returns (google.longrunning.Operation) {
    option (google.api.http) = {
      post: "/v1/{parent=projects/*/locations/*}/services"
      body: "service"
    };
    option (google.api.method_signature) = "parent,service,service_id";
    option (google.longrunning.operation_info) = {
      response_type: "Service"
      metadata_type: "OperationMetadata"
    };
  }

  // Updates the parameters of a single Service.
  rpc UpdateService(UpdateServiceRequest)
      returns (google.longrunning.Operation) {
    option (google.api.http) = {
      patch: "/v1/{service.name=projects/*/locations/*/services/*}"
      body: "service"
    };
    option (google.api.method_signature) = "service,update_mask";
    option (google.longrunning.operation_info) = {
      response_type: "Service"
      metadata_type: "OperationMetadata"
    };
  }

  // Deletes a single Service.
  rpc DeleteService(DeleteServiceRequest)
      returns (google.longrunning.Operation) {
    option (google.api.http) = {
      delete: "/v1/{name=projects/*/locations/*/services/*}"
    };
    option (google.api.method_signature) = "name";
    option (google.longrunning.operation_info) = {
      response_type: "google.protobuf.Empty"
      metadata_type: "OperationMetadata"
    };
  }

  // Lists Bindings in a given project and location.
  rpc ListBindings(ListBindingsRequest) returns (ListBindingsResponse) {
    option (google.api.http) = {
      get: "/v1/{parent=projects/*/locations/*}/bindings"
    };
    option (google.api.method_signature) = "parent";
  }

  // Gets details of a single Binding.
  rpc GetBinding(GetBindingRequest) returns (Binding) {
    option (google.api.http) = {
      get: "/v1/{name=projects/*/locations/*/bindings/*}"
    };
    option (google.api.method_signature) = "name";
  }

  // Creates a new Binding in a given project and location.
  rpc CreateBinding(CreateBindingRequest)
      returns (google.longrunning.Operation) {
    option (google.api.http) = {
      post: "/v1/{parent=projects/*/locations/*}/bindings"
      body: "binding"
    };
    option (google.api.method_signature) = "parent,binding,binding_id";
    option (google.longrunning.operation_info) = {
      response_type: "Binding"
      metadata_type: "OperationMetadata"
    };
  }

  // Updates the parameters of a single Binding.
  rpc UpdateBinding(UpdateBindingRequest)
      returns (google.longrunning.Operation) {
    option (google.api.http) = {
      patch: "/v1/{binding.name=projects/*/locations/*/bindings/*}"
      body: "binding"
    };
    option (google.api.method_signature) = "binding,update_mask";
    option (google.longrunning.operation_info) = {
      response_type: "Binding"
      metadata_type: "OperationMetadata"
    };
  }

  // Deletes a single Binding.
  rpc DeleteBinding(DeleteBindingRequest)
      returns (google.longrunning.Operation) {
    option (google.api.http) = {
      delete: "/v1/{name=projects/*/locations/*/bindings/*}"
    };
    option (google.api.method_signature) = "name";
    option (google.longrunning.operation_info) = {
      response_type: "google.protobuf.Empty"
      metadata_type: "OperationMetadata"
    };
  }

  // Fetches available Bindings.
  rpc FetchAvailableBindings(FetchAvailableBindingsRequest)
      returns (FetchAvailableBindingsResponse) {
    option (google.api.http) = {
      get: "/v1/{parent=projects/*/locations/*}/bindings:fetchAvailable"
    };
    option (google.api.method_signature) = "parent";
  }
}

// Message for requesting list of Agents
message ListAgentsRequest {
  // Required. Parent value for ListAgentsRequest
  string parent = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      child_type: "agentregistry.googleapis.com/Agent"
    }
  ];

  // Optional. Requested page size. Server may return fewer items than
  // requested. If unspecified, server will pick an appropriate default.
  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];

  // Optional. A token identifying a page of results the server should return.
  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];

  // Optional. Filtering results
  string filter = 4 [(google.api.field_behavior) = OPTIONAL];

  // Optional. Hint for how to order the results
  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
}

// Message for response to listing Agents
message ListAgentsResponse {
  // The list of Agents.
  repeated Agent agents = 1;

  // A token identifying a page of results the server should return.
  string next_page_token = 2;
}

// Message for searching Agents
message SearchAgentsRequest {
  // Required. Parent value for SearchAgentsRequest. Format:
  // `projects/{project}/locations/{location}`.
  string parent = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      child_type: "agentregistry.googleapis.com/Agent"
    }
  ];

  // Optional. Search criteria used to select the Agents to return. If no search
  // criteria is specified then all accessible Agents will be returned.
  //
  // Search expressions can be used to restrict results based upon searchable
  // fields, where the operators can be used along with the suffix wildcard
  // symbol `*`. See
  // [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools)
  // for more details.
  //
  // Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`.
  //
  // Searchable fields:
  //
  // | Field              | `=` | `:` | `*` | Keyword Search |
  // |--------------------|-----|-----|-----|----------------|
  // | agentId            | Yes | Yes | Yes | Included       |
  // | name               | No  | Yes | Yes | Included       |
  // | displayName        | No  | Yes | Yes | Included       |
  // | description        | No  | Yes | No  | Included       |
  // | skills             | No  | Yes | No  | Included       |
  // | skills.id          | No  | Yes | No  | Included       |
  // | skills.name        | No  | Yes | No  | Included       |
  // | skills.description | No  | Yes | No  | Included       |
  // | skills.tags        | No  | Yes | No  | Included       |
  // | skills.examples    | No  | Yes | No  | Included       |
  //
  // Examples:
  //
  // * `agentId="urn:agent:projects-123:projects:123:locations:us-central1:reasoningEngines:1234"`
  //   to find the agent with the specified agent ID.
  // * `name:important` to find agents whose name contains `important` as a
  //   word.
  // * `displayName:works*` to find agents whose display name contains words
  //   that start with `works`.
  // * `skills.tags:test` to find agents whose skills tags contain `test`.
  // * `planner OR booking` to find agents whose metadata contains the words
  //   `planner` or `booking`.
  string search_string = 3 [(google.api.field_behavior) = OPTIONAL];

  // Optional. The maximum number of search results to return per page. The page
  // size is capped at `100`, even if a larger value is specified. A negative
  // value will result in an `INVALID_ARGUMENT` error. If unspecified or set to
  // `0`, a default value of `20` will be used. The server may return fewer
  // results than requested.
  int32 page_size = 6 [(google.api.field_behavior) = OPTIONAL];

  // Optional. If present, retrieve the next batch of results from the preceding
  // call to this method. `page_token` must be the value of `next_page_token`
  // from the previous response. The values of all other method parameters, must
  // be identical to those in the previous call.
  string page_token = 7 [(google.api.field_behavior) = OPTIONAL];
}

// Message for response to searching Agents
message SearchAgentsResponse {
  // A list of Agents that match the `search_string`.
  repeated Agent agents = 1;

  // If there are more results than those appearing in this response, then
  // `next_page_token` is included. To get the next set of results, call this
  // method again using the value of `next_page_token` as `page_token`.
  string next_page_token = 2;
}

// Message for getting a Agent
message GetAgentRequest {
  // Required. Name of the resource
  string name = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      type: "agentregistry.googleapis.com/Agent"
    }
  ];
}

// Message for requesting list of Endpoints
message ListEndpointsRequest {
  // Required. The project and location to list endpoints in.
  // Expected format: `projects/{project}/locations/{location}`.
  string parent = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      child_type: "agentregistry.googleapis.com/Endpoint"
    }
  ];

  // Optional. Requested page size. Server may return fewer items than
  // requested. If unspecified, server will pick an appropriate default.
  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];

  // Optional. A token identifying a page of results the server should return.
  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];

  // Optional. A query string used to filter the list of endpoints returned.
  // The filter expression must follow AIP-160 syntax.
  //
  // Filtering is supported on the `name`, `display_name`, `description`,
  // `version`, and `interfaces` fields.
  //
  // Some examples:
  //
  //   * `name = "projects/p1/locations/l1/endpoints/e1"`
  //   * `display_name = "my-endpoint"`
  //   * `description = "my-endpoint-description"`
  //   * `version = "v1"`
  //   * `interfaces.transport = "HTTP_JSON"`
  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
}

// Message for response to listing Endpoints
message ListEndpointsResponse {
  // The list of Endpoint resources matching the parent and filter criteria in
  // the request. Each Endpoint resource follows the format:
  // `projects/{project}/locations/{location}/endpoints/{endpoint}`.
  repeated Endpoint endpoints = 1;

  // A token identifying a page of results the server should return.
  // Used in
  // [page_token][google.cloud.agentregistry.v1main.ListEndpointsRequest.page_token].
  string next_page_token = 2;
}

// Message for getting a Endpoint
message GetEndpointRequest {
  // Required. The name of the endpoint to retrieve.
  // Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`
  string name = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      type: "agentregistry.googleapis.com/Endpoint"
    }
  ];
}

// Message for requesting list of McpServers
message ListMcpServersRequest {
  // Required. Parent value for ListMcpServersRequest. Format:
  // `projects/{project}/locations/{location}`.
  string parent = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      child_type: "agentregistry.googleapis.com/McpServer"
    }
  ];

  // Optional. Requested page size. Server may return fewer items than
  // requested. If unspecified, server will pick an appropriate default.
  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];

  // Optional. A token identifying a page of results the server should return.
  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];

  // Optional. Filtering results
  string filter = 4 [(google.api.field_behavior) = OPTIONAL];

  // Optional. Hint for how to order the results
  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
}

// Message for response to listing McpServers
message ListMcpServersResponse {
  // The list of McpServers.
  repeated McpServer mcp_servers = 1;

  // A token identifying a page of results the server should return.
  string next_page_token = 2;
}

// Message for searching MCP Servers
message SearchMcpServersRequest {
  // Required. Parent value for SearchMcpServersRequest. Format:
  // `projects/{project}/locations/{location}`.
  string parent = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      child_type: "agentregistry.googleapis.com/McpServer"
    }
  ];

  // Optional. Search criteria used to select the MCP Servers to return. If no
  // search criteria is specified then all accessible MCP Servers will be
  // returned.
  //
  // Search expressions can be used to restrict results based upon searchable
  // fields, where the operators can be used along with the suffix wildcard
  // symbol `*`. See
  // [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools)
  // for more details.
  //
  // Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`.
  //
  // Searchable fields:
  //
  // | Field              | `=` | `:` | `*` | Keyword Search |
  // |--------------------|-----|-----|-----|----------------|
  // | mcpServerId        | Yes | Yes | Yes | Included       |
  // | name               | No  | Yes | Yes | Included       |
  // | displayName        | No  | Yes | Yes | Included       |
  //
  // Examples:
  //
  // * `mcpServerId="urn:mcp:projects-123:projects:123:locations:us-central1:agentregistry:services:service-id"`
  //   to find the MCP Server with the specified MCP Server ID.
  // * `name:important` to find MCP Servers whose name contains `important` as a
  //   word.
  // * `displayName:works*` to find MCP Servers whose display name contains
  //   words that start with `works`.
  // * `planner OR booking` to find MCP Servers whose metadata contains the
  //   words `planner` or `booking`.
  // * `mcpServerId:service-id AND (displayName:planner OR
  //   displayName:booking)` to find MCP Servers whose MCP Server ID contains
  //   `service-id` and whose display name contains `planner` or
  //   `booking`.
  string search_string = 3 [(google.api.field_behavior) = OPTIONAL];

  // Optional. The maximum number of search results to return per page. The page
  // size is capped at `100`, even if a larger value is specified. A negative
  // value will result in an `INVALID_ARGUMENT` error. If unspecified or set to
  // `0`, a default value of `20` will be used. The server may return fewer
  // results than requested.
  int32 page_size = 6 [(google.api.field_behavior) = OPTIONAL];

  // Optional. If present, retrieve the next batch of results from the preceding
  // call to this method. `page_token` must be the value of `next_page_token`
  // from the previous response. The values of all other method parameters, must
  // be identical to those in the previous call.
  string page_token = 7 [(google.api.field_behavior) = OPTIONAL];
}

// Message for response to searching MCP Servers
message SearchMcpServersResponse {
  // A list of McpServers that match the `search_string`.
  repeated McpServer mcp_servers = 1;

  // If there are more results than those appearing in this response, then
  // `next_page_token` is included. To get the next set of results, call this
  // method again using the value of `next_page_token` as `page_token`.
  string next_page_token = 2;
}

// Message for getting a McpServer
message GetMcpServerRequest {
  // Required. Name of the resource
  string name = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      type: "agentregistry.googleapis.com/McpServer"
    }
  ];
}

// Message for requesting list of Services
message ListServicesRequest {
  // Required. The project and location to list services in.
  // Expected format: `projects/{project}/locations/{location}`.
  string parent = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      child_type: "agentregistry.googleapis.com/Service"
    }
  ];

  // Optional. Requested page size. Server may return fewer items than
  // requested. If unspecified, server will pick an appropriate default.
  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];

  // Optional. A token identifying a page of results the server should return.
  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];

  // Optional. A query string used to filter the list of services returned.
  // The filter expression must follow AIP-160 syntax.
  //
  // Filtering is supported on the `name`, `display_name`, `description`,
  // and `labels` fields.
  //
  // Some examples:
  //
  //   * `name = "projects/p1/locations/l1/services/s1"`
  //   * `display_name = "my-service"`
  //   * `description : "myservice description"`
  //   * `labels.env = "prod"`
  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
}

// Message for response to listing Services
message ListServicesResponse {
  // The list of Service resources matching the parent and filter criteria in
  // the request. Each Service resource follows the format:
  // `projects/{project}/locations/{location}/services/{service}`.
  repeated Service services = 1;

  // A token identifying a page of results the server should return.
  // Used in
  // [page_token][google.cloud.agentregistry.v1main.ListServicesRequest.page_token].
  string next_page_token = 2;
}

// Message for getting a Service
message GetServiceRequest {
  // Required. The name of the Service.
  // Format: `projects/{project}/locations/{location}/services/{service}`.
  string name = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      type: "agentregistry.googleapis.com/Service"
    }
  ];
}

// Message for creating a Service
message CreateServiceRequest {
  // Required. The project and location to create the Service in.
  // Expected format: `projects/{project}/locations/{location}`.
  string parent = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      child_type: "agentregistry.googleapis.com/Service"
    }
  ];

  // Required. The ID to use for the service, which will become the final
  // component of the service's resource name.
  //
  // This value should be 4-63 characters, and valid characters
  // are `/[a-z][0-9]-/`.
  string service_id = 2 [(google.api.field_behavior) = REQUIRED];

  // Required. The Service resource that is being created.
  // Format: `projects/{project}/locations/{location}/services/{service}`.
  Service service = 3 [(google.api.field_behavior) = REQUIRED];

  // Optional. An optional request ID to identify requests. Specify a unique
  // request ID so that if you must retry your request, the server will know to
  // ignore the request if it has already been completed. The server will
  // guarantee that for at least 60 minutes since the first request.
  //
  // For example, consider a situation where you make an initial request and the
  // request times out. If you make the request again with the same request
  // ID, the server can check if original operation with the same request ID
  // was received, and if so, will ignore the second request. This prevents
  // clients from accidentally creating duplicate commitments.
  //
  // The request ID must be a valid UUID with the exception that zero UUID is
  // not supported (00000000-0000-0000-0000-000000000000).
  string request_id = 4 [
    (google.api.field_info).format = UUID4,
    (google.api.field_behavior) = OPTIONAL
  ];
}

// Message for fetching available Bindings.
message FetchAvailableBindingsRequest {
  // The reference of the source Agent.
  oneof source {
    // The identifier of the source Agent.
    // Format:
    //
    // * `urn:agent:{publisher}:{namespace}:{name}`
    string source_identifier = 2;
  }

  // The reference of the target Agent Registry resource.
  oneof target {
    // Optional. 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 target_identifier = 3 [(google.api.field_behavior) = OPTIONAL];
  }

  // Required. The parent, in the format
  // `projects/{project}/locations/{location}`.
  string parent = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      child_type: "agentregistry.googleapis.com/Binding"
    }
  ];

  // Optional. Requested page size. Server may return fewer items than
  // requested. Page size is 500 if unspecified and is capped at `500` even if a
  // larger value is given.
  int32 page_size = 4 [(google.api.field_behavior) = OPTIONAL];

  // Optional. A token identifying a page of results the server should return.
  string page_token = 5 [(google.api.field_behavior) = OPTIONAL];
}

// Message for response to fetching available Bindings.
message FetchAvailableBindingsResponse {
  // The list of Bindings.
  repeated Binding bindings = 1;

  // A token identifying a page of results the server should return.
  string next_page_token = 2;
}

// Message for updating a Service
message UpdateServiceRequest {
  // Optional. Field mask is used to specify the fields to be overwritten in the
  // Service resource by the update.
  // The fields specified in the update_mask are relative to the resource, not
  // the full request. A field will be overwritten if it is in the mask. If the
  // user does not provide a mask then all fields present in the request will be
  // overwritten.
  google.protobuf.FieldMask update_mask = 1
      [(google.api.field_behavior) = OPTIONAL];

  // Required. The Service resource that is being updated.
  // Format: `projects/{project}/locations/{location}/services/{service}`.
  Service service = 2 [(google.api.field_behavior) = REQUIRED];

  // Optional. An optional request ID to identify requests. Specify a unique
  // request ID so that if you must retry your request, the server will know to
  // ignore the request if it has already been completed. The server will
  // guarantee that for at least 60 minutes since the first request.
  //
  // For example, consider a situation where you make an initial request and the
  // request times out. If you make the request again with the same request
  // ID, the server can check if original operation with the same request ID
  // was received, and if so, will ignore the second request. This prevents
  // clients from accidentally creating duplicate commitments.
  //
  // The request ID must be a valid UUID with the exception that zero UUID is
  // not supported (00000000-0000-0000-0000-000000000000).
  string request_id = 3 [
    (google.api.field_info).format = UUID4,
    (google.api.field_behavior) = OPTIONAL
  ];
}

// Message for deleting a Service
message DeleteServiceRequest {
  // Required. The name of the Service.
  // Format: `projects/{project}/locations/{location}/services/{service}`.
  string name = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      type: "agentregistry.googleapis.com/Service"
    }
  ];

  // Optional. An optional request ID to identify requests. Specify a unique
  // request ID so that if you must retry your request, the server will know to
  // ignore the request if it has already been completed. The server will
  // guarantee that for at least 60 minutes after the first request.
  //
  // For example, consider a situation where you make an initial request and the
  // request times out. If you make the request again with the same request
  // ID, the server can check if original operation with the same request ID
  // was received, and if so, will ignore the second request. This prevents
  // clients from accidentally creating duplicate commitments.
  //
  // The request ID must be a valid UUID with the exception that zero UUID is
  // not supported (00000000-0000-0000-0000-000000000000).
  string request_id = 2 [
    (google.api.field_info).format = UUID4,
    (google.api.field_behavior) = OPTIONAL
  ];
}

// Represents the metadata of the long-running operation.
message OperationMetadata {
  // Output only. The time the operation was created.
  google.protobuf.Timestamp create_time = 1
      [(google.api.field_behavior) = OUTPUT_ONLY];

  // Output only. The time the operation finished running.
  google.protobuf.Timestamp end_time = 2
      [(google.api.field_behavior) = OUTPUT_ONLY];

  // Output only. Server-defined resource path for the target of the operation.
  string target = 3 [(google.api.field_behavior) = OUTPUT_ONLY];

  // Output only. Name of the verb executed by the operation.
  string verb = 4 [(google.api.field_behavior) = OUTPUT_ONLY];

  // Output only. Human-readable status of the operation, if any.
  string status_message = 5 [(google.api.field_behavior) = OUTPUT_ONLY];

  // Output only. Identifies whether the user has requested cancellation
  // of the operation. Operations that have been cancelled successfully
  // have
  // [google.longrunning.Operation.error][google.longrunning.Operation.error]
  // value with a [google.rpc.Status.code][google.rpc.Status.code] of `1`,
  // corresponding to `Code.CANCELLED`.
  bool requested_cancellation = 6 [(google.api.field_behavior) = OUTPUT_ONLY];

  // Output only. API version used to start the operation.
  string api_version = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
}

// Message for requesting a list of Bindings.
message ListBindingsRequest {
  // Required. The project and location to list bindings in.
  // Expected format: `projects/{project}/locations/{location}`.
  string parent = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      child_type: "agentregistry.googleapis.com/Binding"
    }
  ];

  // Optional. Requested page size. Server may return fewer items than
  // requested. Page size is 500 if unspecified and is capped at `500` even if a
  // larger value is given.
  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];

  // Optional. A token identifying a page of results the server should return.
  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];

  // Optional. A query string used to filter the list of bindings returned.
  // The filter expression must follow AIP-160 syntax.
  string filter = 4 [(google.api.field_behavior) = OPTIONAL];

  // Optional. Hint for how to order the results
  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
}

// Message for response to listing Bindings
message ListBindingsResponse {
  // The list of Binding resources matching the parent and filter criteria in
  // the request. Each Binding resource follows the format:
  // `projects/{project}/locations/{location}/bindings/{binding}`.
  repeated Binding bindings = 1;

  // A token identifying a page of results the server should return.
  // Used in
  // [page_token][google.cloud.agentregistry.v1main.ListBindingsRequest.page_token].
  string next_page_token = 2;
}

// Message for getting a Binding
message GetBindingRequest {
  // Required. The name of the Binding.
  // Format: `projects/{project}/locations/{location}/bindings/{binding}`.
  string name = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      type: "agentregistry.googleapis.com/Binding"
    }
  ];
}

// Message for creating a Binding
message CreateBindingRequest {
  // Required. The project and location to create the Binding in.
  // Expected format: `projects/{project}/locations/{location}`.
  string parent = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      child_type: "agentregistry.googleapis.com/Binding"
    }
  ];

  // Required. The ID to use for the binding, which will become the final
  // component of the binding's resource name.
  //
  // This value should be 4-63 characters, and must conform to RFC-1034.
  // Specifically, it must match the regular expression
  // `^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$`.
  string binding_id = 2 [(google.api.field_behavior) = REQUIRED];

  // Required. The Binding resource that is being created.
  Binding binding = 3 [(google.api.field_behavior) = REQUIRED];

  // Optional. An optional request ID to identify requests. Specify a unique
  // request ID so that if you must retry your request, the server will know to
  // ignore the request if it has already been completed. The server will
  // guarantee that for at least 60 minutes since the first request.
  //
  // For example, consider a situation where you make an initial request and the
  // request times out. If you make the request again with the same request
  // ID, the server can check if original operation with the same request ID
  // was received, and if so, will ignore the second request. This prevents
  // clients from accidentally creating duplicate commitments.
  //
  // The request ID must be a valid UUID with the exception that zero UUID is
  // not supported (00000000-0000-0000-0000-000000000000).
  string request_id = 4 [
    (google.api.field_info).format = UUID4,
    (google.api.field_behavior) = OPTIONAL
  ];
}

// Message for updating a Binding
message UpdateBindingRequest {
  // Required. The Binding resource that is being updated.
  Binding binding = 1 [(google.api.field_behavior) = REQUIRED];

  // Optional. Field mask is used to specify the fields to be overwritten in the
  // Binding resource by the update.
  // The fields specified in the update_mask are relative to the resource, not
  // the full request. A field will be overwritten if it is in the mask. If the
  // user does not provide a mask then all fields present in the request will be
  // overwritten.
  google.protobuf.FieldMask update_mask = 2
      [(google.api.field_behavior) = OPTIONAL];

  // Optional. An optional request ID to identify requests. Specify a unique
  // request ID so that if you must retry your request, the server will know to
  // ignore the request if it has already been completed. The server will
  // guarantee that for at least 60 minutes since the first request.
  //
  // For example, consider a situation where you make an initial request and the
  // request times out. If you make the request again with the same request
  // ID, the server can check if original operation with the same request ID
  // was received, and if so, will ignore the second request. This prevents
  // clients from accidentally creating duplicate commitments.
  //
  // The request ID must be a valid UUID with the exception that zero UUID is
  // not supported (00000000-0000-0000-0000-000000000000).
  string request_id = 3 [
    (google.api.field_info).format = UUID4,
    (google.api.field_behavior) = OPTIONAL
  ];
}

// Message for deleting a Binding
message DeleteBindingRequest {
  // Required. The name of the Binding.
  // Format: `projects/{project}/locations/{location}/bindings/{binding}`.
  string name = 1 [
    (google.api.field_behavior) = REQUIRED,
    (google.api.resource_reference) = {
      type: "agentregistry.googleapis.com/Binding"
    }
  ];

  // Optional. An optional request ID to identify requests. Specify a unique
  // request ID so that if you must retry your request, the server will know to
  // ignore the request if it has already been completed. The server will
  // guarantee that for at least 60 minutes after the first request.
  //
  // For example, consider a situation where you make an initial request and the
  // request times out. If you make the request again with the same request
  // ID, the server can check if original operation with the same request ID
  // was received, and if so, will ignore the second request. This prevents
  // clients from accidentally creating duplicate commitments.
  //
  // The request ID must be a valid UUID with the exception that zero UUID is
  // not supported (00000000-0000-0000-0000-000000000000).
  string request_id = 2 [
    (google.api.field_info).format = UUID4,
    (google.api.field_behavior) = OPTIONAL
  ];
}