agntcy-dir 1.3.0 → 1.5.0

package/dist/agntcy-dir.d.ts

@@ -1,12 +1,22 @@
+import { AICatalog } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/models_pb';
+import { AICatalogSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/models_pb';
+import { AIFinderService } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
 import { BasicAuthCredentials } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/sync_service_pb';
 import { BasicAuthCredentialsSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/sync_service_pb';
-import { Client as Client_2 } from '@connectrpc/connect';
+import { CatalogCollection } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/models_pb';
+import { CatalogCollectionSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/models_pb';
+import { CatalogEntry } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/models_pb';
+import { CatalogEntrySchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/models_pb';
 import { CreatePublicationResponse } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/routing/v1/publication_service_pb';
 import { CreatePublicationResponseSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/routing/v1/publication_service_pb';
 import { CreateSyncRequest } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/sync_service_pb';
 import { CreateSyncRequestSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/sync_service_pb';
 import { CreateSyncResponse } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/sync_service_pb';
 import { CreateSyncResponseSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/sync_service_pb';
+import { DeleteReferrerRequest } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/store_service_pb';
+import { DeleteReferrerRequestSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/store_service_pb';
+import { DeleteReferrerResponse } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/store_service_pb';
+import { DeleteReferrerResponseSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/store_service_pb';
 import { DeleteSyncRequest } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/sync_service_pb';
 import { DeleteSyncRequestSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/sync_service_pb';
 import { DeleteSyncResponse } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/sync_service_pb';
@@ -18,6 +28,10 @@ import { EventSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/events/v1/ev
 import { EventService } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/events/v1/event_service_pb';
 import { EventType } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/events/v1/event_service_pb';
 import { EventTypeSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/events/v1/event_service_pb';
+import { ExportAgentRequest } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { ExportAgentRequestSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { file_agntcy_dir_catalog_v1_ai_finder_service } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { file_agntcy_dir_catalog_v1_models } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/models_pb';
 import { file_agntcy_dir_core_v1_record } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/core/v1/record_pb';
 import { file_agntcy_dir_events_v1_event_service } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/events/v1/event_service_pb';
 import { file_agntcy_dir_naming_v1_name_verification } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/naming/v1/name_verification_pb';
@@ -33,6 +47,10 @@ import { file_agntcy_dir_sign_v1_sign_service } from '@buf/agntcy_dir.bufbuild_e
 import { file_agntcy_dir_sign_v1_signature } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/sign/v1/signature_pb';
 import { file_agntcy_dir_store_v1_store_service } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/store_service_pb';
 import { file_agntcy_dir_store_v1_sync_service } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/store/v1/sync_service_pb';
+import { GetAgentRequest } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { GetAgentRequestSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { GetAgentResponse } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { GetAgentResponseSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
 import { GetPublicationRequest } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/routing/v1/publication_service_pb';
 import { GetPublicationRequestSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/routing/v1/publication_service_pb';
 import { GetPublicationResponse } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/routing/v1/publication_service_pb';
@@ -45,6 +63,18 @@ import { GetVerificationInfoRequest } from '@buf/agntcy_dir.bufbuild_es/agntcy/d
 import { GetVerificationInfoRequestSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/naming/v1/naming_service_pb';
 import { GetVerificationInfoResponse } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/naming/v1/naming_service_pb';
 import { GetVerificationInfoResponseSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/naming/v1/naming_service_pb';
+import { GetWellKnownCatalogRequest } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { GetWellKnownCatalogRequestSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { GetWellKnownCatalogResponse } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { GetWellKnownCatalogResponseSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { HostInfo } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/models_pb';
+import { HostInfoSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/models_pb';
+import { HttpBody } from '@buf/googleapis_googleapis.bufbuild_es/google/api/httpbody_pb';
+import { HttpBodySchema } from '@buf/googleapis_googleapis.bufbuild_es/google/api/httpbody_pb';
+import { ListAgentsRequest } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { ListAgentsRequestSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { ListAgentsResponse } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
+import { ListAgentsResponseSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/ai_finder_service_pb';
 import { ListenRequest } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/events/v1/event_service_pb';
 import { ListenRequestSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/events/v1/event_service_pb';
 import { ListenResponse } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/events/v1/event_service_pb';
@@ -169,670 +199,100 @@ import { VerifyWithKey } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/sign/v1/si
 import { VerifyWithKeySchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/sign/v1/sign_service_pb';
 import { VerifyWithOIDC } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/sign/v1/sign_service_pb';
 import { VerifyWithOIDCSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/sign/v1/sign_service_pb';
+import { WellKnownCatalog } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/models_pb';
+import { WellKnownCatalogSchema } from '@buf/agntcy_dir.bufbuild_es/agntcy/dir/catalog/v1/models_pb';
 
+/**
+ * Authentication mode for Directory client connections.
+ *
+ * @public
+ */
 export declare type AuthMode = '' | 'x509' | 'jwt' | 'tls' | 'oidc';
 
-export declare class CachedToken {
-    accessToken: string;
-    tokenType: string;
-    provider: string;
-    issuer: string;
-    refreshToken: string;
-    expiresAt: Date | undefined;
-    user: string;
-    userId: string;
-    email: string;
-    createdAt: Date | undefined;
-    constructor(accessToken: string, tokenType?: string, provider?: string, issuer?: string, refreshToken?: string, expiresAt?: Date | undefined, user?: string, userId?: string, email?: string, createdAt?: Date | undefined);
-    static fromJson(payload: CachedTokenJson): CachedToken;
-    toJson(): Record<string, string>;
-}
-
-declare interface CachedTokenJson {
-    access_token: string;
-    token_type?: string;
-    provider?: string;
-    issuer?: string;
-    refresh_token?: string;
-    expires_at?: string;
-    user?: string;
-    user_id?: string;
-    email?: string;
-    created_at?: string;
+export declare namespace catalog_v1 {
+    export {
+        file_agntcy_dir_catalog_v1_ai_finder_service,
+        AIFinderService,
+        ExportAgentRequest,
+        ExportAgentRequestSchema,
+        GetAgentRequest,
+        GetAgentRequestSchema,
+        GetAgentResponse,
+        GetAgentResponseSchema,
+        GetWellKnownCatalogRequest,
+        GetWellKnownCatalogRequestSchema,
+        GetWellKnownCatalogResponse,
+        GetWellKnownCatalogResponseSchema,
+        ListAgentsRequest,
+        ListAgentsRequestSchema,
+        ListAgentsResponse,
+        ListAgentsResponseSchema,
+        file_agntcy_dir_catalog_v1_models,
+        AICatalog,
+        AICatalogSchema,
+        CatalogCollection,
+        CatalogCollectionSchema,
+        CatalogEntry,
+        CatalogEntrySchema,
+        HostInfo,
+        HostInfoSchema,
+        WellKnownCatalog,
+        WellKnownCatalogSchema,
+        HttpBody,
+        HttpBodySchema
+    }
 }
 
 /**
  * High-level client for interacting with AGNTCY Directory services.
  *
- * This client provides a unified interface for operations across the Directory API.
- * It handles gRPC communication and provides convenient methods for common operations
- * including storage, routing, search, signing, and synchronization.
- *
- * @example
- * ```typescript
- * // Create client with default configuration
- * const client = new Client();
- *
- * // Create client with custom configuration
- * const config = new Config('localhost:8888', '/usr/local/bin/dirctl');
- * const client = new Client(config);
- *
- * // Use client for operations
- * const records = await client.push([record]);
- * ```
+ * @public
  */
 export declare class Client {
     config: Config;
-    storeClient: Client_2<typeof models_2.store_v1.StoreService>;
-    routingClient: Client_2<typeof models_2.routing_v1.RoutingService>;
-    publicationClient: Client_2<typeof models_2.routing_v1.PublicationService>;
-    searchClient: Client_2<typeof models_2.search_v1.SearchService>;
-    signClient: Client_2<typeof models_2.sign_v1.SignService>;
-    syncClient: Client_2<typeof models_2.store_v1.SyncService>;
-    eventClient: Client_2<typeof models_2.events_v1.EventService>;
-    namingClient: Client_2<typeof models_2.naming_v1.NamingService>;
-    private oauthHolder;
-    /**
-     * Initialize the client with the given configuration.
-     *
-     * @param config - Optional client configuration. If null, loads from environment
-     *                variables using Config.loadFromEnv()
-     * @param grpcTransport - Optional transport to use for gRPC communication.
-     *                Can be created with Client.createGRPCTransport(config)
-     *
-     * @throws {Error} If unable to establish connection to the server or configuration is invalid
-     *
-     * @example
-     * ```typescript
-     * // Load config from environment
-     * const client = new Client();
-     *
-     * // Use custom config
-     * const config = new Config('localhost:9999');
-     * const grpcTransport = await Client.createGRPCTransport(config);
-     * const client = new Client(config, grpcTransport);
-     * ```
-     */
-    constructor();
-    constructor(config?: Config);
+    readonly oauthSession: OAuthSessionManager;
     constructor(config?: Config, grpcTransport?: Transport);
-    private static convertToPEM;
-    private static secureNodeOptions;
-    private static createOidcTransport;
-    static createGRPCTransport(config: Config, oidcOptions?: {
-        oidcTokenHolder: OAuthTokenHolder;
+    static createGRPCTransport(config: Config, options?: {
+        oidcTokenHolder?: OAuthTokenHolder;
     }): Promise<Transport>;
-    private static createX509Transport;
-    private static createJWTTransport;
-    private static createTLSTransport;
-    private cachedTokenFromResponse;
-    /**
-     * Run browser-based OAuth 2.0 Authorization Code + PKCE login (loopback callback).
-     *
-     * Requires `authMode: 'oidc'`, `oidcIssuer`, and `oidcClientId`.
-     */
+    hasCachedOAuthToken(): boolean;
+    getAccessToken(): string;
     authenticateOAuthPkce(): Promise<void>;
-    /**
-     * Request generator helper function for streaming requests.
-     */
-    private requestGenerator;
-    /**
-     * Push records to the Store API.
-     *
-     * Uploads one or more records to the content store, making them available
-     * for retrieval and reference. Each record is assigned a unique content
-     * identifier (CID) based on its content hash.
-     *
-     * @param records - Array of Record objects to push to the store
-     * @returns Promise that resolves to an array of RecordRef objects containing the CIDs of the pushed records
-     *
-     * @throws {Error} If the gRPC call fails or the push operation fails
-     *
-     * @example
-     * ```typescript
-     * const records = [createRecord("example")];
-     * const refs = await client.push(records);
-     * console.log(`Pushed with CID: ${refs[0].cid}`);
-     * ```
-     */
-    push(records: models_2.core_v1.Record[]): Promise<models_2.core_v1.RecordRef[]>;
-    /**
-     * Push records with referrer metadata to the Store API.
-     *
-     * Uploads records along with optional artifacts and referrer information.
-     * This is useful for pushing complex objects that include additional
-     * metadata or associated artifacts.
-     *
-     * @param requests - Array of PushReferrerRequest objects containing records and optional artifacts
-     * @returns Promise that resolves to an array of PushReferrerResponse objects containing the details of pushed artifacts
-     *
-     * @throws {Error} If the gRPC call fails or the push operation fails
-     *
-     * @example
-     * ```typescript
-     * const requests = [new models.store_v1.PushReferrerRequest({record: record})];
-     * const responses = await client.push_referrer(requests);
-     * ```
-     */
-    push_referrer(requests: models_2.store_v1.PushReferrerRequest[]): Promise<models_2.store_v1.PushReferrerResponse[]>;
-    /**
-     * Pull records from the Store API by their references.
-     *
-     * Retrieves one or more records from the content store using their
-     * content identifiers (CIDs).
-     *
-     * @param refs - Array of RecordRef objects containing the CIDs to retrieve
-     * @returns Promise that resolves to an array of Record objects retrieved from the store
-     *
-     * @throws {Error} If the gRPC call fails or the pull operation fails
-     *
-     * @example
-     * ```typescript
-     * const refs = [new models.core_v1.RecordRef({cid: "QmExample123"})];
-     * const records = await client.pull(refs);
-     * for (const record of records) {
-     *   console.log(`Retrieved record: ${record}`);
-     * }
-     * ```
-     */
-    pull(refs: models_2.core_v1.RecordRef[]): Promise<models_2.core_v1.Record[]>;
-    /**
-     * Pull records with referrer metadata from the Store API.
-     *
-     * Retrieves records along with their associated artifacts and referrer
-     * information. This provides access to complex objects that include
-     * additional metadata or associated artifacts.
-     *
-     * @param requests - Array of PullReferrerRequest objects containing records and optional artifacts for pull operations
-     * @returns Promise that resolves to an array of PullReferrerResponse objects containing the retrieved records
-     *
-     * @throws {Error} If the gRPC call fails or the pull operation fails
-     *
-     * @example
-     * ```typescript
-     * const requests = [new models.store_v1.PullReferrerRequest({ref: ref})];
-     * const responses = await client.pull_referrer(requests);
-     * for (const response of responses) {
-     *   console.log(`Retrieved: ${response}`);
-     * }
-     * ```
-     */
-    pull_referrer(requests: models_2.store_v1.PullReferrerRequest[]): Promise<models_2.store_v1.PullReferrerResponse[]>;
-    /**
-     * Search objects from the Store API matching the specified queries.
-     *
-     * Performs a search across the storage using the provided search queries
-     * and returns a list of matching CIDs. This is efficient for lookups
-     * where only the CIDs are needed.
-     *
-     * @param request - SearchCIDsRequest containing queries, filters, and search options
-     * @returns Promise that resolves to an array of SearchCIDsResponse objects matching the queries
-     *
-     * @throws {Error} If the gRPC call fails or the search operation fails
-     *
-     * @example
-     * ```typescript
-     * const request = create(models.search_v1.SearchCIDsRequestSchema, {queries: [query], limit: 10});
-     * const responses = await client.searchCIDs(request);
-     * for (const response of responses) {
-     *   console.log(`Found CID: ${response.recordCid}`);
-     * }
-     * ```
-     */
-    searchCIDs(request: models_2.search_v1.SearchCIDsRequest): Promise<models_2.search_v1.SearchCIDsResponse[]>;
-    /**
-     * Search for full records from the Store API matching the specified queries.
-     *
-     * Performs a search across the storage using the provided search queries
-     * and returns a list of full records with all metadata.
-     *
-     * @param request - SearchRecordsRequest containing queries, filters, and search options
-     * @returns Promise that resolves to an array of SearchRecordsResponse objects matching the queries
-     *
-     * @throws {Error} If the gRPC call fails or the search operation fails
-     *
-     * @example
-     * ```typescript
-     * const request = create(models.search_v1.SearchRecordsRequestSchema, {queries: [query], limit: 10});
-     * const responses = await client.searchRecords(request);
-     * for (const response of responses) {
-     *   console.log(`Found: ${response.record?.name}`);
-     * }
-     * ```
-     */
-    searchRecords(request: models_2.search_v1.SearchRecordsRequest): Promise<models_2.search_v1.SearchRecordsResponse[]>;
-    /**
-     * Look up metadata for records in the Store API.
-     *
-     * Retrieves metadata information for one or more records without
-     * downloading the full record content. This is useful for checking
-     * if records exist and getting basic information about them.
-     *
-     * @param refs - Array of RecordRef objects containing the CIDs to look up
-     * @returns Promise that resolves to an array of RecordMeta objects containing metadata for the records
-     *
-     * @throws {Error} If the gRPC call fails or the lookup operation fails
-     *
-     * @example
-     * ```typescript
-     * const refs = [new models.core_v1.RecordRef({cid: "QmExample123"})];
-     * const metadatas = await client.lookup(refs);
-     * for (const meta of metadatas) {
-     *   console.log(`Record size: ${meta.size}`);
-     * }
-     * ```
-     */
-    lookup(refs: models_2.core_v1.RecordRef[]): Promise<models_2.core_v1.RecordMeta[]>;
-    /**
-     * List objects from the Routing API matching the specified criteria.
-     *
-     * Returns a list of objects that match the filtering and
-     * query criteria specified in the request.
-     *
-     * @param request - ListRequest specifying filtering criteria, pagination, etc.
-     * @returns Promise that resolves to an array of ListResponse objects matching the criteria
-     *
-     * @throws {Error} If the gRPC call fails or the list operation fails
-     *
-     * @example
-     * ```typescript
-     * const request = new models.routing_v1.ListRequest({limit: 10});
-     * const responses = await client.list(request);
-     * for (const response of responses) {
-     *   console.log(`Found object: ${response.cid}`);
-     * }
-     * ```
-     */
-    list(request: models_2.routing_v1.ListRequest): Promise<models_2.routing_v1.ListResponse[]>;
-    /**
-     * Publish objects to the Routing API matching the specified criteria.
-     *
-     * Makes the specified objects available for discovery and retrieval by other
-     * clients in the network. The objects must already exist in the store before
-     * they can be published.
-     *
-     * @param request - PublishRequest containing the query for the objects to publish
-     * @returns Promise that resolves when the publish operation is complete
-     *
-     * @throws {Error} If the gRPC call fails or the object cannot be published
-     *
-     * @example
-     * ```typescript
-     * const ref = new models.routing_v1.RecordRef({cid: "QmExample123"});
-     * const request = new models.routing_v1.PublishRequest({recordRefs: [ref]});
-     * await client.publish(request);
-     * ```
-     */
-    publish(request: models_2.routing_v1.PublishRequest): Promise<void>;
-    /**
-     * Unpublish objects from the Routing API matching the specified criteria.
-     *
-     * Removes the specified objects from the public network, making them no
-     * longer discoverable by other clients. The objects remain in the local
-     * store but are not available for network discovery.
-     *
-     * @param request - UnpublishRequest containing the query for the objects to unpublish
-     * @returns Promise that resolves when the unpublish operation is complete
-     *
-     * @throws {Error} If the gRPC call fails or the objects cannot be unpublished
-     *
-     * @example
-     * ```typescript
-     * const ref = new models.routing_v1.RecordRef({cid: "QmExample123"});
-     * const request = new models.routing_v1.UnpublishRequest({recordRefs: [ref]});
-     * await client.unpublish(request);
-     * ```
-     */
-    unpublish(request: models_2.routing_v1.UnpublishRequest): Promise<void>;
-    /**
-     * Delete records from the Store API.
-     *
-     * Permanently removes one or more records from the content store using
-     * their content identifiers (CIDs). This operation cannot be undone.
-     *
-     * @param refs - Array of RecordRef objects containing the CIDs to delete
-     * @returns Promise that resolves when the deletion is complete
-     *
-     * @throws {Error} If the gRPC call fails or the delete operation fails
-     *
-     * @example
-     * ```typescript
-     * const refs = [new models.core_v1.RecordRef({cid: "QmExample123"})];
-     * await client.delete(refs);
-     * ```
-     */
-    delete(refs: models_2.core_v1.RecordRef[]): Promise<void>;
-    /**
-     * Sign a record with a cryptographic signature.
-     *
-     * Creates a cryptographic signature for a record using either a private
-     * key or OIDC-based signing. The signing process uses the external dirctl
-     * command-line tool to perform the actual cryptographic operations.
-     *
-     * @param req - SignRequest containing the record reference and signing provider
-     *              configuration. The provider can specify either key-based signing
-     *              (with a private key) or OIDC-based signing
-     * @param oidc_client_id - OIDC client identifier for OIDC-based signing. Defaults to "sigstore"
-     * @returns SignResponse containing the signature
-     *
-     * @throws {Error} If the signing operation fails or unsupported provider is supplied
-     *
-     * @example
-     * ```typescript
-     * const req = new models.sign_v1.SignRequest({
-     *   recordRef: new models.core_v1.RecordRef({cid: "QmExample123"}),
-     *   provider: new models.sign_v1.SignProvider({key: keyConfig})
-     * });
-     * const response = client.sign(req);
-     * console.log(`Signature: ${response.signature}`);
-     * ```
-     */
-    sign(req: models_2.sign_v1.SignRequest): void;
-    /**
-     * Verify a cryptographic signature on a record.
-     *
-     * Validates the cryptographic signature of a previously signed record
-     * to ensure its authenticity and integrity. This operation verifies
-     * that the record has not been tampered with since signing.
-     *
-     * The verification process uses the external dirctl command-line tool
-     * to perform the actual cryptographic operations.
-     *
-     * When fromServer is true, uses the server's cached verification result.
-     *
-     * @param request - VerifyRequest containing the record reference and verification parameters.
-     *                  The provider can specify either key-based verification (with a public key)
-     *                  or OIDC-based verification
-     * @returns VerifyResponse containing the verification result and details
-     *
-     * @throws {Error} If the verification operation fails or unsupported provider is supplied
-     *
-     * @example
-     * ```typescript
-     * const request = new models.sign_v1.VerifyRequest({
-     *   recordRef: new models.core_v1.RecordRef({cid: "QmExample123"})
-     * });
-     * const response = client.verify(request);
-     * console.log(`Signature valid: ${response.success}`);
-     * ```
-     */
-    verify(request: models_2.sign_v1.VerifyRequest): Promise<models_2.sign_v1.VerifyResponse>;
-    private _verifyViaServer;
-    /**
-     * Create a new synchronization configuration.
-     *
-     * Creates a new sync configuration that defines how data should be
-     * synchronized between different Directory servers. This allows for
-     * automated data replication and consistency across multiple locations.
-     *
-     * @param request - CreateSyncRequest containing the sync configuration details
-     *                  including source, target, and synchronization parameters
-     * @returns Promise that resolves to a CreateSyncResponse containing the created sync details
-     *          including the sync ID and configuration
-     *
-     * @throws {Error} If the gRPC call fails or the sync creation fails
-     *
-     * @example
-     * ```typescript
-     * const request = new models.store_v1.CreateSyncRequest();
-     * const response = await client.create_sync(request);
-     * console.log(`Created sync with ID: ${response.syncId}`);
-     * ```
-     */
-    create_sync(request: models_2.store_v1.CreateSyncRequest): Promise<models_2.store_v1.CreateSyncResponse>;
-    /**
-     * List existing synchronization configurations.
-     *
-     * Retrieves a list of all sync configurations that have been created,
-     * with optional filtering and pagination support. This allows you to
-     * monitor and manage multiple synchronization processes.
-     *
-     * @param request - ListSyncsRequest containing filtering criteria, pagination options,
-     *                  and other query parameters
-     * @returns Promise that resolves to an array of ListSyncsItem objects with
-     *          their details including ID, name, status, and configuration parameters
-     *
-     * @throws {Error} If the gRPC call fails or the list operation fails
-     *
-     * @example
-     * ```typescript
-     * const request = new models.store_v1.ListSyncsRequest({limit: 10});
-     * const syncs = await client.list_syncs(request);
-     * for (const sync of syncs) {
-     *   console.log(`Sync: ${sync}`);
-     * }
-     * ```
-     */
-    list_syncs(request: models_2.store_v1.ListSyncsRequest): Promise<models_2.store_v1.ListSyncsItem[]>;
-    /**
-     * Retrieve detailed information about a specific synchronization configuration.
-     *
-     * Gets comprehensive details about a specific sync configuration including
-     * its current status, configuration parameters, performance metrics,
-     * and any recent errors or warnings.
-     *
-     * @param request - GetSyncRequest containing the sync ID or identifier to retrieve
-     * @returns Promise that resolves to a GetSyncResponse with detailed information about the sync configuration
-     *          including status, metrics, configuration, and logs
-     *
-     * @throws {Error} If the gRPC call fails or the get operation fails
-     *
-     * @example
-     * ```typescript
-     * const request = new models.store_v1.GetSyncRequest({syncId: "sync-123"});
-     * const response = await client.get_sync(request);
-     * console.log(`Sync status: ${response.status}`);
-     * console.log(`Last update: ${response.lastUpdateTime}`);
-     * ```
-     */
-    get_sync(request: models_2.store_v1.GetSyncRequest): Promise<models_2.store_v1.GetSyncResponse>;
-    /**
-     * Delete a synchronization configuration.
-     *
-     * Permanently removes a sync configuration and stops any ongoing
-     * synchronization processes. This operation cannot be undone and
-     * will halt all data synchronization for the specified configuration.
-     *
-     * @param request - DeleteSyncRequest containing the sync ID or identifier to delete
-     * @returns Promise that resolves to a DeleteSyncResponse when the deletion is complete
-     *
-     * @throws {Error} If the gRPC call fails or the delete operation fails
-     *
-     * @example
-     * ```typescript
-     * const request = new models.store_v1.DeleteSyncRequest({syncId: "sync-123"});
-     * await client.delete_sync(request);
-     * console.log("Sync deleted");
-     * ```
-     */
-    delete_sync(request: models_2.store_v1.DeleteSyncRequest): Promise<models_2.store_v1.DeleteSyncResponse>;
-    /**
-     * Get events from the Event API matching the specified criteria.
-     *
-     * Retrieves a list of events that match the filtering and query criteria
-     * specified in the request.
-     *
-     * @param request - ListenRequest specifying filtering criteria, pagination, etc.
-     * @returns Promise that resolves to an array of ListenResponse objects matching the criteria
-     *
-     * @throws {Error} If the gRPC call fails or the get events operation fails
-     */
-    listen(request: models_2.events_v1.ListenRequest): AsyncIterable<models_2.events_v1.ListenResponse>;
-    /**
-     * CreatePublication creates a new publication request that will be processed by the PublicationWorker.
-     * The publication request can specify either a query, a list of specific CIDs,
-     * or all records to be announced to the DHT.
-     *
-     * @param request - PublishRequest containing record references and queries options.
-     *
-     * @returns CreatePublicationResponse returns the result of creating a publication request.
-     * This includes the publication ID and any relevant metadata.
-     *
-     * @throws {Error} If the gRPC call fails or the list operation fails
-     */
-    create_publication(request: models_2.routing_v1.PublishRequest): Promise<models_2.routing_v1.CreatePublicationResponse>;
-    /**
-     * ListPublications returns a stream of all publication requests in the system.
-     * This allows monitoring of pending, processing, and completed publication requests.
-     *
-     * @param request - ListPublicationsRequest contains optional filters for listing publication requests.
-     *
-     * @returns Promise that resolves to an array of ListPublicationsItem represents
-     * a single publication request in the list response.
-     * Contains publication details including ID, status, and creation timestamp.
-     *
-     * @throws {Error} If the gRPC call fails or the list operation fails
-     */
-    list_publication(request: models_2.routing_v1.ListPublicationsRequest): Promise<models_2.routing_v1.ListPublicationsItem[]>;
-    /**
-     * GetPublication retrieves details of a specific publication request by its identifier.
-     * This includes the current status and any associated metadata.
-     *
-     * @param request - GetPublicationRequest specifies which publication to retrieve by its identifier.
-     *
-     * @returns GetPublicationResponse contains the full details of a specific publication request.
-     * Includes status, progress information, and any error details if applicable.
-     *
-     * @throws {Error} If the gRPC call fails or the get operation fails
-     */
-    get_publication(request: models_2.routing_v1.GetPublicationRequest): Promise<models_2.routing_v1.GetPublicationResponse>;
-    /**
-     * Resolve a record name to CIDs.
-     *
-     * Resolves a record reference (name with optional version) to content identifiers (CIDs).
-     * When no version is specified, returns all versions sorted by creation time (newest first).
-     *
-     * @param request - ResolveRequest containing the name and optional version
-     * @returns Promise that resolves to a ResolveResponse containing the resolved record references
-     *
-     * @throws {Error} If the gRPC call fails or the resolve operation fails
-     *
-     * @example
-     * ```typescript
-     * import { create } from "@bufbuild/protobuf";
-     *
-     * // Resolve latest version
-     * const request = create(models.naming_v1.ResolveRequestSchema, { name: "cisco.com/agent" });
-     * const response = await client.resolve(request);
-     * console.log(`Latest CID: ${response.records[0].cid}`);
-     *
-     * // Resolve specific version
-     * const request = create(models.naming_v1.ResolveRequestSchema, { name: "cisco.com/agent", version: "v1.0.0" });
-     * const response = await client.resolve(request);
-     * ```
-     */
-    resolve(request: models_2.naming_v1.ResolveRequest): Promise<models_2.naming_v1.ResolveResponse>;
-    /**
-     * Get verification info for a record.
-     *
-     * Retrieves the name verification status for a record. Can look up by CID directly
-     * or by name (with optional version) which will be resolved first.
-     *
-     * @param request - GetVerificationInfoRequest containing cid, name, and/or version
-     * @returns Promise that resolves to a GetVerificationInfoResponse containing verification status
-     *
-     * @throws {Error} If the gRPC call fails or the operation fails
-     *
-     * @example
-     * ```typescript
-     * import { create } from "@bufbuild/protobuf";
-     *
-     * // Check by CID
-     * const request = create(models.naming_v1.GetVerificationInfoRequestSchema, { cid: "bafyreib..." });
-     * const response = await client.getVerificationInfo(request);
-     *
-     * // Check by name (latest version)
-     * const request = create(models.naming_v1.GetVerificationInfoRequestSchema, { name: "cisco.com/agent" });
-     * const response = await client.getVerificationInfo(request);
-     *
-     * // Check by name with specific version
-     * const request = create(models.naming_v1.GetVerificationInfoRequestSchema, { name: "cisco.com/agent", version: "v1.0.0" });
-     * const response = await client.getVerificationInfo(request);
-     * ```
-     */
-    getVerificationInfo(request: models_2.naming_v1.GetVerificationInfoRequest): Promise<models_2.naming_v1.GetVerificationInfoResponse>;
-    /**
-     * Sign a record using a private key.
-     *
-     * This private method handles key-based signing by passing the key reference
-     * directly to the dirctl command. The key can be a file path, URL, or KMS URI.
-     *
-     * @param cid - Content identifier of the record to sign
-     * @param req - SignWithKey request containing the private key reference
-     * @returns SignResponse containing the signature
-     *
-     * @throws {Error} If any error occurs during signing
-     *
-     * @private
-     */
-    private __sign_with_key;
-    /**
-     * Sign a record using OIDC-based authentication.
-     *
-     * This private method handles OIDC-based signing by building the appropriate
-     * dirctl command with OIDC parameters and executing it.
-     *
-     * @param cid - Content identifier of the record to sign
-     * @param req - SignWithOIDC request containing the OIDC configuration
-     * @returns SignResponse containing the signature
-     *
-     * @throws {Error} If any error occurs during signing
-     *
-     * @private
-     */
-    private __sign_with_oidc;
-    /**
-     * Verify a record using a public key.
-     *
-     * This private method handles key-based verification by passing the public key
-     * reference to the dirctl command. The key can be a file path, URL, or KMS URI.
-     *
-     * @param cid - Content identifier of the record to verify
-     * @param req - VerifyWithKey request containing the public key reference
-     * @param outputPath - Path to the output file for the verification result
-     *
-     * @throws {Error} If any error occurs during verification
-     *
-     * @private
-     */
-    private __verify_with_key;
-    /**
-     * Verify a record with any valid signature.
-     *
-     * This private method handles verification that accepts any valid signature,
-     * with optional OIDC verification options for additional constraints.
-     *
-     * @param cid - Content identifier of the record to verify
-     * @param req - VerifyWithAny request containing optional OIDC options, or undefined for default verification
-     * @param outputPath - Path to the output file for the verification result
-     *
-     * @throws {Error} If any error occurs during verification
-     *
-     * @private
-     */
-    private __verify_with_any;
-    /**
-     * Verify a record using OIDC-based verification.
-     *
-     * This private method handles OIDC-based verification by building the appropriate
-     * dirctl command with OIDC parameters and executing it.
-     *
-     * @param cid - Content identifier of the record to verify
-     * @param req - VerifyWithOIDC request containing the OIDC configuration, or undefined for default verification
-     * @param outputPath - Path to the output file for the verification result
-     *
-     * @throws {Error} If any error occurs during verification
-     *
-     * @private
-     */
-    private __verify_with_oidc;
+    push(records: Record_2[]): Promise<RecordRef[]>;
+    push_referrer(requests: PushReferrerRequest[]): Promise<PushReferrerResponse[]>;
+    pull(refs: RecordRef[]): Promise<Record_2[]>;
+    pull_referrer(requests: PullReferrerRequest[]): Promise<PullReferrerResponse[]>;
+    searchCIDs(request: SearchCIDsRequest): Promise<SearchCIDsResponse[]>;
+    searchRecords(request: SearchRecordsRequest): Promise<SearchRecordsResponse[]>;
+    lookup(refs: RecordRef[]): Promise<RecordMeta[]>;
+    list(request: ListRequest): Promise<ListResponse[]>;
+    searchRouting(request: SearchRequest): Promise<SearchResponse[]>;
+    publish(request: PublishRequest): Promise<void>;
+    unpublish(request: UnpublishRequest): Promise<void>;
+    delete(refs: RecordRef[]): Promise<void>;
+    deleteReferrer(request: DeleteReferrerRequest): Promise<DeleteReferrerResponse>;
+    sign(req: SignRequest): void;
+    verify(request: VerifyRequest): Promise<VerifyResponse>;
+    create_sync(request: CreateSyncRequest): Promise<CreateSyncResponse>;
+    list_syncs(request: ListSyncsRequest): Promise<ListSyncsItem[]>;
+    get_sync(request: GetSyncRequest): Promise<GetSyncResponse>;
+    delete_sync(request: DeleteSyncRequest): Promise<DeleteSyncResponse>;
+    listen(request: ListenRequest): AsyncIterable<ListenResponse>;
+    create_publication(request: PublishRequest): Promise<CreatePublicationResponse>;
+    list_publication(request: ListPublicationsRequest): Promise<ListPublicationsItem[]>;
+    get_publication(request: GetPublicationRequest): Promise<GetPublicationResponse>;
+    resolve(request: ResolveRequest): Promise<ResolveResponse>;
+    getVerificationInfo(request: GetVerificationInfoRequest): Promise<GetVerificationInfoResponse>;
+    listAgents(request: ListAgentsRequest): Promise<ListAgentsResponse>;
+    getAgent(request: GetAgentRequest): Promise<GetAgentResponse>;
+    exportAgent(request: ExportAgentRequest): Promise<HttpBody>;
+    getWellKnownCatalog(request: GetWellKnownCatalogRequest): Promise<GetWellKnownCatalogResponse>;
 }
 
 /**
  * Configuration class for the AGNTCY Directory client.
  *
- * This class manages configuration settings for connecting to the Directory service
- * and provides default values and environment-based configuration loading.
+ * @public
  */
 export declare class Config {
     static DEFAULT_SERVER_ADDRESS: string;
@@ -874,31 +334,7 @@ export declare class Config {
     oidcAuthTimeout: number;
     oidcScopes: string[];
     dockerConfig: DockerConfig | undefined;
-    /**
-     * Creates a new Config instance.
-     *
-     * @param serverAddress - The server address to connect to. Defaults to '127.0.0.1:8888'
-     * @param dirctlPath - Path to the dirctl executable. Defaults to 'dirctl'
-     * @param spiffeEndpointSocket - Path to the spire server socket. Defaults to empty string.
-     * @param authMode - Authentication mode: '' for insecure, 'x509', 'jwt', 'tls', or 'oidc'. Defaults to ''
-     * @param jwtAudience - JWT audience for JWT authentication. Required when authMode is 'jwt'
-     */
     constructor(serverAddress?: string, dirctlPath?: string, spiffeEndpointSocket?: string, authMode?: AuthMode, jwtAudience?: string, tlsCaFile?: string, tlsCertFile?: string, tlsKeyFile?: string, authToken?: string, tlsServerName?: string, tlsSkipVerify?: boolean, oidcIssuer?: string, oidcClientId?: string, oidcClientSecret?: string, oidcRedirectUri?: string, oidcCallbackPort?: number, oidcAuthTimeout?: number, oidcScopes?: string[] | undefined, oidcAccessToken?: string | undefined, dockerConfig?: DockerConfig | undefined);
-    /**
-     * Load configuration from environment variables.
-     *
-     * @param prefix - Environment variable prefix. Defaults to 'DIRECTORY_CLIENT_'
-     * @returns A new Config instance with values loaded from environment variables
-     *
-     * @example
-     * ```typescript
-     * // Load with default prefix
-     * const config = Config.loadFromEnv();
-     *
-     * // Load with custom prefix
-     * const config = Config.loadFromEnv("MY_APP_");
-     * ```
-     */
     static loadFromEnv(prefix?: string): Config;
     getCommandAndArgs(args: string[]): [string, string[]];
 }
@@ -919,7 +355,26 @@ export declare namespace core_v1 {
     }
 }
 
-declare class DockerConfig {
+export { CreatePublicationResponse }
+
+export { CreateSyncRequest }
+
+export { CreateSyncResponse }
+
+export { DeleteReferrerRequest }
+
+export { DeleteReferrerResponse }
+
+export { DeleteSyncRequest }
+
+export { DeleteSyncResponse }
+
+/**
+ * Docker invocation settings for running dirctl in a container.
+ *
+ * @public
+ */
+export declare class DockerConfig {
     static DEFAULT_DIRCTL_IMAGE: string;
     static DEFAULT_DIRCTL_IMAGE_TAG: string;
     dirctlImage: string;
@@ -947,20 +402,53 @@ export declare namespace events_v1 {
     }
 }
 
-export declare namespace models {
-    export {
-        core_v1,
-        naming_v1,
-        routing_v1,
-        search_v1,
-        sign_v1,
-        store_v1,
-        events_v1
-    }
-}
+export { ExportAgentRequest }
+
+export { GetAgentRequest }
+
+export { GetAgentResponse }
+
+export { GetPublicationRequest }
+
+export { GetPublicationResponse }
+
+export { GetSyncRequest }
+
+export { GetSyncResponse }
+
+export { GetVerificationInfoRequest }
+
+export { GetVerificationInfoResponse }
+
+export { GetWellKnownCatalogRequest }
+
+export { GetWellKnownCatalogResponse }
 
-declare namespace models_2 {
+export { HttpBody }
+
+export { ListAgentsRequest }
+
+export { ListAgentsResponse }
+
+export { ListenRequest }
+
+export { ListenResponse }
+
+export { ListPublicationsItem }
+
+export { ListPublicationsRequest }
+
+export { ListRequest }
+
+export { ListResponse }
+
+export { ListSyncsItem }
+
+export { ListSyncsRequest }
+
+export declare namespace models {
     export {
+        catalog_v1,
         core_v1,
         naming_v1,
         routing_v1,
@@ -991,10 +479,35 @@ export declare namespace naming_v1 {
     }
 }
 
+/**
+ * Error thrown when OAuth PKCE authentication fails.
+ *
+ * @public
+ */
 export declare class OAuthPkceError extends Error {
     constructor(message: string);
 }
 
+/**
+ * Coordinates OIDC token state with interactive PKCE flow and cache.
+ *
+ * @public
+ */
+export declare class OAuthSessionManager {
+    readonly config: Config;
+    private readonly tokenCache;
+    private _oauthHolder;
+    constructor(config: Config);
+    get oauthHolder(): OAuthTokenHolder | null;
+    hasAccessToken(): boolean;
+    authenticate(): Promise<void>;
+}
+
+/**
+ * Holds an OAuth access token for Connect transport interceptors.
+ *
+ * @public
+ */
 export declare class OAuthTokenHolder {
     private accessToken;
     setTokens(accessToken: string): void;
@@ -1002,6 +515,26 @@ export declare class OAuthTokenHolder {
     getAccessToken(): string;
 }
 
+export { PublishRequest }
+
+export { PullReferrerRequest }
+
+export { PullReferrerResponse }
+
+export { PushReferrerRequest }
+
+export { PushReferrerResponse }
+
+export { Record_2 as Record }
+
+export { RecordMeta }
+
+export { RecordRef }
+
+export { ResolveRequest }
+
+export { ResolveResponse }
+
 export declare namespace routing_v1 {
     export {
         file_agntcy_dir_routing_v1_peer,
@@ -1069,6 +602,18 @@ export declare namespace search_v1 {
     }
 }
 
+export { SearchCIDsRequest }
+
+export { SearchCIDsResponse }
+
+export { SearchRecordsRequest }
+
+export { SearchRecordsResponse }
+
+export { SearchRequest }
+
+export { SearchResponse }
+
 export declare namespace sign_v1 {
     export {
         file_agntcy_dir_sign_v1_sign_service,
@@ -1114,6 +659,8 @@ export declare namespace sign_v1 {
     }
 }
 
+export { SignRequest }
+
 export declare namespace store_v1 {
     export {
         file_agntcy_dir_store_v1_store_service,
@@ -1125,6 +672,10 @@ export declare namespace store_v1 {
         PullReferrerRequestSchema,
         PullReferrerResponse,
         PullReferrerResponseSchema,
+        DeleteReferrerRequest,
+        DeleteReferrerRequestSchema,
+        DeleteReferrerResponse,
+        DeleteReferrerResponseSchema,
         StoreService,
         file_agntcy_dir_store_v1_sync_service,
         CreateSyncRequest,
@@ -1155,17 +706,10 @@ export declare namespace store_v1 {
     }
 }
 
-export declare const TOKEN_CACHE_FILE = "auth-token.json";
-
-export declare class TokenCache {
-    readonly cacheDir: string;
-    constructor(cacheDir?: string);
-    getCachePath(): string;
-    load(): CachedToken | undefined;
-    save(token: CachedToken): void;
-    clear(): void;
-    isValid(token: CachedToken | undefined): boolean;
-    getValidToken(): CachedToken | undefined;
-}
+export { UnpublishRequest }
+
+export { VerifyRequest }
+
+export { VerifyResponse }
 
 export { }