Class AgentRegistry

constructor

• new AgentRegistry(
      options: {
          headerProvider?: (context: ReadonlyContext) => Record<string, string>;
          location?: string | null;
          projectId?: string | null;
      },
  ): AgentRegistry

  Parameters

  • options: {
        headerProvider?: (context: ReadonlyContext) => Record<string, string>;
        location?: string | null;
        projectId?: string | null;
    }

  Returns AgentRegistry

Readonlylocation

ReadonlyprojectId

getAgentInfo

• getAgentInfo(name: string): Promise<AgentInfo>

  Parameters

  • name: string

  Returns Promise<AgentInfo>

getAuthHeaders

• getAuthHeaders(): Promise<Record<string, string>>

  Resolves default Google Cloud credentials and returns standard headers. Automatically caches, fetches, and handles refreshing expired OAuth tokens. Injects the billing/quota project identifier x-goog-user-project if present.

  Returns Promise<Record<string, string>>

getConnectionUri

• getConnectionUri(
      resourceDetails: {
          interfaces?: { protocolBinding?: string; url?: string }[];
          protocols?: {
              interfaces?: { protocolBinding?: string; url?: string }[];
              protocolVersion?: string;
              type?: ProtocolType;
          }[];
      },
      filters?: ConnectionUriFilter,
  ): ConnectionUriResult

  Parses connection interfaces list from registry metadata and returns the first match corresponding to requested protocol types and binding options.

  Parameters

  • resourceDetails: {
        interfaces?: { protocolBinding?: string; url?: string }[];
        protocols?: {
            interfaces?: { protocolBinding?: string; url?: string }[];
            protocolVersion?: string;
            type?: ProtocolType;
        }[];
    }
  • Optionalfilters: ConnectionUriFilter

  Returns ConnectionUriResult

getEndpoint

• getEndpoint(name: string): Promise<Endpoint>

  Parameters

  • name: string

  Returns Promise<Endpoint>

getMcpServer

• getMcpServer(name: string): Promise<McpServer>

  Parameters

  • name: string

  Returns Promise<McpServer>

getMcpToolset

• getMcpToolset(
      mcpServerName: string,
      options?: {
          authCredential?: AuthCredential;
          authScheme?: AuthScheme;
          continueUri?: string;
      },
  ): Promise<AgentRegistrySingleMCPToolset>

  Parameters

  • mcpServerName: string
  • Optionaloptions: {
        authCredential?: AuthCredential;
        authScheme?: AuthScheme;
        continueUri?: string;
    }

  Returns Promise<AgentRegistrySingleMCPToolset>

getModelName

• getModelName(endpointName: string): Promise<string>

  Parameters

  • endpointName: string

  Returns Promise<string>

getRemoteA2AAgent

• getRemoteA2AAgent(
      agentName: string,
      options?: { client?: Client; clientFactory?: ClientFactory },
  ): Promise<RemoteA2AAgent>

  Parameters

  • agentName: string
  • Optionaloptions: { client?: Client; clientFactory?: ClientFactory }

  Returns Promise<RemoteA2AAgent>

listAgents

• listAgents(
      options?: { filterStr?: string; pageSize?: number; pageToken?: string },
  ): Promise<ListAgentsResponse>

  Parameters

  • Optionaloptions: { filterStr?: string; pageSize?: number; pageToken?: string }

  Returns Promise<ListAgentsResponse>

listEndpoints

• listEndpoints(
      options?: { filterStr?: string; pageSize?: number; pageToken?: string },
  ): Promise<ListEndpointsResponse>

  Parameters

  • Optionaloptions: { filterStr?: string; pageSize?: number; pageToken?: string }

  Returns Promise<ListEndpointsResponse>

listMcpServers

• listMcpServers(
      options?: { filterStr?: string; pageSize?: number; pageToken?: string },
  ): Promise<ListMcpServersResponse>

  Parameters

  • Optionaloptions: { filterStr?: string; pageSize?: number; pageToken?: string }

  Returns Promise<ListMcpServersResponse>

makeRequest

• makeRequest<T = unknown>(
      path: string,
      params?: Record<string, string>,
  ): Promise<T>

  Helper function to execute HTTP GET requests against the Agent Registry API. Handles path resolution, search query params compilation, and auth headers fetching.

  Type Parameters

  • T = unknown

  Parameters

  • path: string
  • Optionalparams: Record<string, string>

  Returns Promise<T>