v1

type AICatalog struct {

	// AI Catalog spec version this document conforms to, as "Major.Minor".
	SpecVersion string `protobuf:"bytes,1,opt,name=spec_version,json=specVersion,proto3" json:"spec_version,omitempty"`
	// Operator of this catalog. Required at the Discoverable/Trusted levels.
	Host *HostInfo `protobuf:"bytes,2,opt,name=host,proto3,oneof" json:"host,omitempty"`
	// Catalog entries. May be empty.
	Entries []*CatalogEntry `protobuf:"bytes,3,rep,name=entries,proto3" json:"entries,omitempty"`
	// Custom or vendor-specific metadata.
	Metadata map[string]*structpb.Value `` /* 143-byte string literal not displayed */
	// contains filtered or unexported fields
}

type AIFinderServiceClient interface {
	// ListAgents returns catalog entries with deterministic, cacheable browsing
	// semantics (database filtering, no relevance ranking).
	ListAgents(ctx context.Context, in *ListAgentsRequest, opts ...grpc.CallOption) (*ListAgentsResponse, error)
	// GetAgent returns a single CatalogEntry by CID. The response shape is the
	// same as one element in ListAgentsResponse.results[], providing a stable
	// detail URL for any agent discovered through listing.
	GetAgent(ctx context.Context, in *GetAgentRequest, opts ...grpc.CallOption) (*GetAgentResponse, error)
	// ExportAgent returns the full agent record in one of the supported export
	// formats (oasf, a2a, agent-skill, mcp-ghcopilot). The bytes are written
	// directly into the response body via google.api.HttpBody with an appropriate
	// Content-Type.
	ExportAgent(ctx context.Context, in *ExportAgentRequest, opts ...grpc.CallOption) (*httpbody.HttpBody, error)
	// GetWellKnownCatalog returns the AI Catalog well-known document (host
	// descriptor, published entries, and dynamic collections) at the RFC 8615 URI.
	GetWellKnownCatalog(ctx context.Context, in *GetWellKnownCatalogRequest, opts ...grpc.CallOption) (*GetWellKnownCatalogResponse, error)
}

type AIFinderServiceServer interface {
	// ListAgents returns catalog entries with deterministic, cacheable browsing
	// semantics (database filtering, no relevance ranking).
	ListAgents(context.Context, *ListAgentsRequest) (*ListAgentsResponse, error)
	// GetAgent returns a single CatalogEntry by CID. The response shape is the
	// same as one element in ListAgentsResponse.results[], providing a stable
	// detail URL for any agent discovered through listing.
	GetAgent(context.Context, *GetAgentRequest) (*GetAgentResponse, error)
	// ExportAgent returns the full agent record in one of the supported export
	// formats (oasf, a2a, agent-skill, mcp-ghcopilot). The bytes are written
	// directly into the response body via google.api.HttpBody with an appropriate
	// Content-Type.
	ExportAgent(context.Context, *ExportAgentRequest) (*httpbody.HttpBody, error)
	// GetWellKnownCatalog returns the AI Catalog well-known document (host
	// descriptor, published entries, and dynamic collections) at the RFC 8615 URI.
	GetWellKnownCatalog(context.Context, *GetWellKnownCatalogRequest) (*GetWellKnownCatalogResponse, error)
}

type Attestation struct {

	// Attestation type (e.g. "SOC2-Type2", "ISO27001", "publisher-identity").
	Type string `protobuf:"bytes,1,opt,name=type,proto3" json:"type,omitempty"`
	// Location of the attestation document (HTTPS URL or Data URI).
	Uri string `protobuf:"bytes,2,opt,name=uri,proto3" json:"uri,omitempty"`
	// Media type of the attestation document (e.g. "application/pdf").
	MediaType string `protobuf:"bytes,3,opt,name=media_type,json=mediaType,proto3" json:"media_type,omitempty"`
	// Integrity digest as "algorithm:hex" (SHA-256 or stronger).
	Digest *string `protobuf:"bytes,4,opt,name=digest,proto3,oneof" json:"digest,omitempty"`
	// Size of the attestation document in bytes.
	Size *uint64 `protobuf:"varint,5,opt,name=size,proto3,oneof" json:"size,omitempty"`
	// Human-readable label for the attestation.
	Description *string `protobuf:"bytes,6,opt,name=description,proto3,oneof" json:"description,omitempty"`
	// contains filtered or unexported fields
}

type CatalogCollection struct {

	// Human-readable name for the collection.
	DisplayName string `protobuf:"bytes,1,opt,name=display_name,json=displayName,proto3" json:"display_name,omitempty"`
	// URL that resolves to the collection contents.
	Url string `protobuf:"bytes,2,opt,name=url,proto3" json:"url,omitempty"`
	// Description of what the collection returns.
	Description *string `protobuf:"bytes,3,opt,name=description,proto3,oneof" json:"description,omitempty"`
	// Media type of the document returned by fetching url.
	MediaType *string `protobuf:"bytes,4,opt,name=media_type,json=mediaType,proto3,oneof" json:"media_type,omitempty"`
	// Free-form tags for filtering and discovery.
	Tags []string `protobuf:"bytes,5,rep,name=tags,proto3" json:"tags,omitempty"`
	// Custom metadata.
	Metadata map[string]*structpb.Value `` /* 143-byte string literal not displayed */
	// contains filtered or unexported fields
}

type CatalogEntry struct {

	// Stable, globally unique identifier, ideally a URN (RFC 8141) or URI.
	Identifier string `protobuf:"bytes,1,opt,name=identifier,proto3" json:"identifier,omitempty"`
	// Human-readable name for the artifact.
	DisplayName string `protobuf:"bytes,2,opt,name=display_name,json=displayName,proto3" json:"display_name,omitempty"`
	// Media type of the artifact, e.g. "application/a2a-agent-card+json",
	// "application/mcp-server-card+json", or "application/ai-catalog+json"
	// for a nested catalog.
	MediaType string `protobuf:"bytes,3,opt,name=media_type,json=mediaType,proto3" json:"media_type,omitempty"`
	// Artifact content. Exactly one of url or data must be set.
	//
	// Types that are valid to be assigned to Artifact:
	//
	//	*CatalogEntry_Url
	//	*CatalogEntry_Data
	Artifact isCatalogEntry_Artifact `protobuf_oneof:"artifact"`
	// Artifact version. Semantic Versioning is recommended.
	Version *string `protobuf:"bytes,6,opt,name=version,proto3,oneof" json:"version,omitempty"`
	// Description of the artifact.
	Description *string `protobuf:"bytes,7,opt,name=description,proto3,oneof" json:"description,omitempty"`
	// Free-form keywords for filtering and discovery.
	Tags []string `protobuf:"bytes,8,rep,name=tags,proto3" json:"tags,omitempty"`
	// Publishing entity. Canonical location for publisher info, not duplicated
	// in trust_manifest.
	Publisher *Publisher `protobuf:"bytes,9,opt,name=publisher,proto3,oneof" json:"publisher,omitempty"`
	// Trust metadata. When present, trust_manifest.identity must match identifier.
	TrustManifest *TrustManifest `protobuf:"bytes,10,opt,name=trust_manifest,json=trustManifest,proto3,oneof" json:"trust_manifest,omitempty"`
	// RFC 3339 timestamp of the last modification to this entry.
	UpdatedAt *string `protobuf:"bytes,11,opt,name=updated_at,json=updatedAt,proto3,oneof" json:"updated_at,omitempty"`
	// Custom metadata.
	Metadata map[string]*structpb.Value `` /* 144-byte string literal not displayed */
	// contains filtered or unexported fields
}

type CatalogEntry_Data struct {
	// Artifact document embedded inline; its structure follows media_type.
	Data *structpb.Value `protobuf:"bytes,5,opt,name=data,proto3,oneof"`
}

type CatalogEntry_Url struct {
	// URL where the artifact document can be retrieved.
	Url string `protobuf:"bytes,4,opt,name=url,proto3,oneof"`
}

type ConvertOption func(*convertOptions)

type ExportAgentRequest struct {

	// Content-addressable identifier of the agent record.
	Cid string `protobuf:"bytes,1,opt,name=cid,proto3" json:"cid,omitempty"`
	// Export format. Empty string is treated as "oasf".
	Format string `protobuf:"bytes,2,opt,name=format,proto3" json:"format,omitempty"`
	// contains filtered or unexported fields
}

type GetAgentRequest struct {

	// Content-addressable identifier of the agent record.
	Cid string `protobuf:"bytes,1,opt,name=cid,proto3" json:"cid,omitempty"`
	// contains filtered or unexported fields
}

type GetAgentResponse struct {

	// CatalogEntry for the requested CID.
	Entry *CatalogEntry `protobuf:"bytes,1,opt,name=entry,proto3" json:"entry,omitempty"`
	// contains filtered or unexported fields
}

type GetWellKnownCatalogRequest struct {
	// contains filtered or unexported fields
}

type GetWellKnownCatalogResponse struct {

	// The well-known AI Catalog document.
	Catalog *WellKnownCatalog `protobuf:"bytes,1,opt,name=catalog,proto3" json:"catalog,omitempty"`
	// contains filtered or unexported fields
}

type HostInfo struct {

	// Human-readable name of the host (e.g. the organization name).
	DisplayName string `protobuf:"bytes,1,opt,name=display_name,json=displayName,proto3" json:"display_name,omitempty"`
	// Verifiable identifier for the host (e.g. a DID or domain name).
	Identifier *string `protobuf:"bytes,2,opt,name=identifier,proto3,oneof" json:"identifier,omitempty"`
	// URL to the host's documentation.
	DocumentationUrl *string `protobuf:"bytes,3,opt,name=documentation_url,json=documentationUrl,proto3,oneof" json:"documentation_url,omitempty"`
	// URL to the host's logo. Data URIs (RFC 2397) are recommended.
	LogoUrl *string `protobuf:"bytes,4,opt,name=logo_url,json=logoUrl,proto3,oneof" json:"logo_url,omitempty"`
	// Trust metadata for the host itself.
	TrustManifest *TrustManifest `protobuf:"bytes,5,opt,name=trust_manifest,json=trustManifest,proto3,oneof" json:"trust_manifest,omitempty"`
	// contains filtered or unexported fields
}

type ListAgentsRequest struct {

	// Filter expression: "field=value" clauses joined by AND; comma-separated
	// values within a field are OR-combined.
	Filter string `protobuf:"bytes,1,opt,name=filter,proto3" json:"filter,omitempty"`
	// Sort fields, comma-separated, each optionally suffixed "ASC"/"DESC"
	// (default ASC), e.g. "created_at DESC, display_name ASC".
	OrderBy string `protobuf:"bytes,2,opt,name=order_by,json=orderBy,proto3" json:"order_by,omitempty"`
	// Maximum entries to return. Default 20, clamped to 100.
	PageSize uint32 `protobuf:"varint,3,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"`
	// Opaque continuation token from a previous call.
	PageToken string `protobuf:"bytes,4,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
	// contains filtered or unexported fields
}

type ListAgentsResponse struct {

	// Catalog entries on this page, in the requested sort order.
	Results []*CatalogEntry `protobuf:"bytes,1,rep,name=results,proto3" json:"results,omitempty"`
	// Opaque continuation token. Empty when there are no more results.
	NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
	// contains filtered or unexported fields
}

type ProvenanceLink struct {

	// Relationship to the source (e.g. "derivedFrom", "publishedFrom").
	Relation string `protobuf:"bytes,1,opt,name=relation,proto3" json:"relation,omitempty"`
	// Source artifact or data (e.g. a Git repo URL, OCI ref, dataset URI).
	SourceId string `protobuf:"bytes,2,opt,name=source_id,json=sourceId,proto3" json:"source_id,omitempty"`
	// Integrity digest of the source as "algorithm:hex".
	SourceDigest *string `protobuf:"bytes,3,opt,name=source_digest,json=sourceDigest,proto3,oneof" json:"source_digest,omitempty"`
	// URI of the registry holding the source.
	RegistryUri *string `protobuf:"bytes,4,opt,name=registry_uri,json=registryUri,proto3,oneof" json:"registry_uri,omitempty"`
	// URI of a provenance statement (e.g. an in-toto / SLSA statement).
	StatementUri *string `protobuf:"bytes,5,opt,name=statement_uri,json=statementUri,proto3,oneof" json:"statement_uri,omitempty"`
	// Reference to the key used to sign the provenance statement.
	SignatureRef *string `protobuf:"bytes,6,opt,name=signature_ref,json=signatureRef,proto3,oneof" json:"signature_ref,omitempty"`
	// contains filtered or unexported fields
}

type Publisher struct {

	// Verifiable identifier (e.g. a DID, domain name, or URI).
	Identifier string `protobuf:"bytes,1,opt,name=identifier,proto3" json:"identifier,omitempty"`
	// Human-readable name of the publisher.
	DisplayName string `protobuf:"bytes,2,opt,name=display_name,json=displayName,proto3" json:"display_name,omitempty"`
	// Type hint for identifier (e.g. "did", "dns"). May be omitted when evident.
	IdentityType *string `protobuf:"bytes,3,opt,name=identity_type,json=identityType,proto3,oneof" json:"identity_type,omitempty"`
	// contains filtered or unexported fields
}

type TrustManifest struct {

	// Primary subject identifier (DID, SPIFFE ID, or URL). Within a CatalogEntry
	// it must match the entry's identifier.
	Identity string `protobuf:"bytes,1,opt,name=identity,proto3" json:"identity,omitempty"`
	// Type hint for identity (e.g. "did", "spiffe", "dns").
	IdentityType *string `protobuf:"bytes,2,opt,name=identity_type,json=identityType,proto3,oneof" json:"identity_type,omitempty"`
	// Trust framework applied to the artifact.
	TrustSchema *TrustSchema `protobuf:"bytes,3,opt,name=trust_schema,json=trustSchema,proto3,oneof" json:"trust_schema,omitempty"`
	// Verifiable claims (publisher identity, compliance certifications, etc.).
	Attestations []*Attestation `protobuf:"bytes,4,rep,name=attestations,proto3" json:"attestations,omitempty"`
	// Lineage information for the artifact.
	Provenance []*ProvenanceLink `protobuf:"bytes,5,rep,name=provenance,proto3" json:"provenance,omitempty"`
	// URL to the privacy policy governing this artifact.
	PrivacyPolicyUrl *string `protobuf:"bytes,6,opt,name=privacy_policy_url,json=privacyPolicyUrl,proto3,oneof" json:"privacy_policy_url,omitempty"`
	// URL to the terms of service.
	TermsOfServiceUrl *string `protobuf:"bytes,7,opt,name=terms_of_service_url,json=termsOfServiceUrl,proto3,oneof" json:"terms_of_service_url,omitempty"`
	// Detached JWS (RFC 7515) signature over the manifest, using JCS (RFC 8785).
	Signature *string `protobuf:"bytes,8,opt,name=signature,proto3,oneof" json:"signature,omitempty"`
	// Custom metadata.
	Metadata map[string]*structpb.Value `` /* 143-byte string literal not displayed */
	// contains filtered or unexported fields
}

type TrustSchema struct {

	// Identifier of the trust schema.
	Identifier string `protobuf:"bytes,1,opt,name=identifier,proto3" json:"identifier,omitempty"`
	// Schema version.
	Version string `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
	// URI to the governance policy document.
	GovernanceUri *string `protobuf:"bytes,3,opt,name=governance_uri,json=governanceUri,proto3,oneof" json:"governance_uri,omitempty"`
	// Supported verification methods (e.g. "did", "x509").
	VerificationMethods []string `protobuf:"bytes,4,rep,name=verification_methods,json=verificationMethods,proto3" json:"verification_methods,omitempty"`
	// contains filtered or unexported fields
}

type UnimplementedAIFinderServiceServer struct{}

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

type WellKnownCatalog struct {

	// AI Catalog spec version this document conforms to, as "Major.Minor".
	SpecVersion string `protobuf:"bytes,1,opt,name=spec_version,json=specVersion,proto3" json:"spec_version,omitempty"`
	// Operator of this catalog. Required at the Discoverable/Trusted levels.
	Host *HostInfo `protobuf:"bytes,2,opt,name=host,proto3,oneof" json:"host,omitempty"`
	// Statically published catalog entries. May be empty.
	Entries []*CatalogEntry `protobuf:"bytes,3,rep,name=entries,proto3" json:"entries,omitempty"`
	// Dynamic collections: pre-built queries that resolve to lists of records.
	Collections []*CatalogCollection `protobuf:"bytes,4,rep,name=collections,proto3" json:"collections,omitempty"`
	// Custom or vendor-specific metadata.
	Metadata map[string]*structpb.Value `` /* 143-byte string literal not displayed */
	// contains filtered or unexported fields
}