apiregistrypb

type CloudApiRegistryClient interface {
	// Gets a single McpServer.
	GetMcpServer(ctx context.Context, in *GetMcpServerRequest, opts ...grpc.CallOption) (*McpServer, error)
	// Lists McpServers in a given Project.
	ListMcpServers(ctx context.Context, in *ListMcpServersRequest, opts ...grpc.CallOption) (*ListMcpServersResponse, error)
	// Gets a single McpTool.
	GetMcpTool(ctx context.Context, in *GetMcpToolRequest, opts ...grpc.CallOption) (*McpTool, error)
	// Lists McpTools in a given McpServer.
	ListMcpTools(ctx context.Context, in *ListMcpToolsRequest, opts ...grpc.CallOption) (*ListMcpToolsResponse, error)
}

type CloudApiRegistryServer interface {
	// Gets a single McpServer.
	GetMcpServer(context.Context, *GetMcpServerRequest) (*McpServer, error)
	// Lists McpServers in a given Project.
	ListMcpServers(context.Context, *ListMcpServersRequest) (*ListMcpServersResponse, error)
	// Gets a single McpTool.
	GetMcpTool(context.Context, *GetMcpToolRequest) (*McpTool, error)
	// Lists McpTools in a given McpServer.
	ListMcpTools(context.Context, *ListMcpToolsRequest) (*ListMcpToolsResponse, error)
}

type GetMcpServerRequest struct {

	// Required. Name of the resource
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// contains filtered or unexported fields
}

type GetMcpToolRequest struct {

	// Required. Name of the resource
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// contains filtered or unexported fields
}

type ListMcpServersRequest struct {

	// Required. Parent value for ListMcpServersRequest
	Parent string `protobuf:"bytes,1,opt,name=parent,proto3" json:"parent,omitempty"`
	// Optional. Requested page size. Server may return fewer items than
	// requested. If unspecified, server will pick an appropriate default.
	PageSize int32 `protobuf:"varint,2,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"`
	// Optional. A token identifying a page of results the server should return.
	PageToken string `protobuf:"bytes,3,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
	// Optional. Filtering results
	Filter string `protobuf:"bytes,4,opt,name=filter,proto3" json:"filter,omitempty"`
	// Optional. Hint for how to order the results
	OrderBy string `protobuf:"bytes,5,opt,name=order_by,json=orderBy,proto3" json:"order_by,omitempty"`
	// contains filtered or unexported fields
}

type ListMcpServersResponse struct {

	// The list of McpServer
	McpServers []*McpServer `protobuf:"bytes,1,rep,name=mcp_servers,json=mcpServers,proto3" json:"mcp_servers,omitempty"`
	// A token identifying a page of results the server should return.
	NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
	// Locations that could not be reached.
	Unreachable []string `protobuf:"bytes,3,rep,name=unreachable,proto3" json:"unreachable,omitempty"`
	// contains filtered or unexported fields
}

type ListMcpToolsRequest struct {

	// Required. Parent value for ListMcpToolsRequest
	Parent string `protobuf:"bytes,1,opt,name=parent,proto3" json:"parent,omitempty"`
	// Optional. Requested page size. Server may return fewer items than
	// requested. If unspecified, server will pick an appropriate default.
	PageSize int32 `protobuf:"varint,2,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"`
	// Optional. A token identifying a page of results the server should return.
	PageToken string `protobuf:"bytes,3,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
	// Optional. Filtering results
	Filter string `protobuf:"bytes,4,opt,name=filter,proto3" json:"filter,omitempty"`
	// Optional. Hint for how to order the results
	OrderBy string `protobuf:"bytes,5,opt,name=order_by,json=orderBy,proto3" json:"order_by,omitempty"`
	// contains filtered or unexported fields
}

type ListMcpToolsResponse struct {

	// The list of McpTool
	McpTools []*McpTool `protobuf:"bytes,1,rep,name=mcp_tools,json=mcpTools,proto3" json:"mcp_tools,omitempty"`
	// A token identifying a page of results the server should return.
	NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
	// Locations that could not be reached.
	Unreachable []string `protobuf:"bytes,3,rep,name=unreachable,proto3" json:"unreachable,omitempty"`
	// contains filtered or unexported fields
}

type McpServer struct {

	// Identifier. The resource name of the MCP Server.
	// Format:
	// `projects/{project}/locations/{location}/mcpServers/{mcp_server}`.
	// Example:
	// projects/12345/locations/us-central1/mcpServers/google:bigquery.googleapis.com:mcp
	// for 1p
	// projects/12345/locations/us-central1/mcpServers/apphub:starbucks for
	// 2p
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Optional. A human readable name for the MCP server.
	DisplayName string `protobuf:"bytes,2,opt,name=display_name,json=displayName,proto3" json:"display_name,omitempty"`
	// Optional. A human-readable description of the MCP Server's functionality.
	Description string `protobuf:"bytes,3,opt,name=description,proto3" json:"description,omitempty"`
	// The base URL of the MCP server. Example: [geolocation.googleapis.com/mcp].
	Urls []string `protobuf:"bytes,4,rep,name=urls,proto3" json:"urls,omitempty"`
	// The capabilities that a server may support. Known capabilities defined in
	// https://modelcontextprotocol.io/specification/2025-06-18/schema#servercapabilities
	// and additional capabilities defined by the servers.
	Capabilities *structpb.Struct `protobuf:"bytes,6,opt,name=capabilities,proto3" json:"capabilities,omitempty"`
	// Output only. The state of the MCP Server.
	State State `protobuf:"varint,7,opt,name=state,proto3,enum=google.cloud.apiregistry.v1beta.State" json:"state,omitempty"`
	// contains filtered or unexported fields
}

type McpTool struct {

	// Identifier. The resource name of the McpTool.
	// Format:
	// `projects/{project}/locations/{location}/mcpServers/{mcp_server}/mcpTools/{mcp_tool}`.
	// Example:
	// projects/12345/locations/us-central1/mcpServers/google:bigquery.googleapis.com:mcp/mcpTools/insert_job
	// for 1p
	// projects/12345/locations/us-central1/mcpServers/apphub:starbucks/mcpTools/order_pizza
	// for 2p
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Optional. A human-readable name for the tool, suitable for display.
	DisplayName string `protobuf:"bytes,2,opt,name=display_name,json=displayName,proto3" json:"display_name,omitempty"`
	// A human-readable description of the tool's functionality.
	Description string `protobuf:"bytes,3,opt,name=description,proto3" json:"description,omitempty"`
	// Automatically populated reference to MCP Server. Helpful when multiple
	// tools are requested across different MCP Servers.
	McpServerUrls []string `protobuf:"bytes,4,rep,name=mcp_server_urls,json=mcpServerUrls,proto3" json:"mcp_server_urls,omitempty"`
	// A JSON Schema object defining the expected parameters for invoking the
	// tool.
	InputSchema *structpb.Struct `protobuf:"bytes,5,opt,name=input_schema,json=inputSchema,proto3" json:"input_schema,omitempty"`
	// Optional. A JSON Schema object defining the expected structure of the
	// tool's output.
	OutputSchema *structpb.Struct `protobuf:"bytes,6,opt,name=output_schema,json=outputSchema,proto3" json:"output_schema,omitempty"`
	// Optional key-value object that allows developers to provide additional
	// information regarding tool properties, behavior, and usage best practices.
	// Annotations or tags to facilitate semantic search across tools ("semantic
	// tags") are not in the MVP scope. When implemented, the first set of
	// supported annotations will likely be the standard, predefined annotations
	// from the open-source MCP spec. These include:
	//   - title: A human-readable title for the tool, useful for UI display.
	//   - readOnlyHint: If true, indicates the tool does not modify its
	//     environment.
	//   - destructiveHint: If true, the tool may perform destructive updates
	//     (only meaningful when readOnlyHint is false).
	//   - idempotentHint: If true, calling the tool repeatedly with the same
	//     arguments has no additional effect (only meaningful when readOnlyHint is
	//     false).
	//   - openWorldHint: If true, the tool may interact with an "open world" of
	//     external entities.
	Annotations *structpb.Struct `protobuf:"bytes,7,opt,name=annotations,proto3" json:"annotations,omitempty"`
	// contains filtered or unexported fields
}

type State int32

type UnimplementedCloudApiRegistryServer struct {
}

type UnsafeCloudApiRegistryServer interface {
	// contains filtered or unexported methods
}