@adcp/client 3.14.1 → 3.16.0

package/dist/lib/registry/index.d.ts

@@ -1,46 +1,112 @@
-import type { ResolvedBrand, PropertyInfo, RegistryClientConfig } from './types';
-export type { ResolvedBrand, PropertyInfo, RegistryClientConfig } from './types';
+import type { ResolvedBrand, ResolvedProperty, RegistryClientConfig, SaveBrandRequest, SaveBrandResponse, SavePropertyRequest, SavePropertyResponse, BrandRegistryItem, PropertyRegistryItem, ValidationResult, FederatedAgentWithDetails, FederatedPublisher, DomainLookupResult, ListOptions, ListAgentsOptions, CreateAdagentsRequest, PublisherPropertySelector } from './types';
+export type { ResolvedBrand, ResolvedProperty, PropertyInfo, RegistryClientConfig, SaveBrandRequest, SaveBrandResponse, SavePropertyRequest, SavePropertyResponse, BrandRegistryItem, PropertyRegistryItem, ValidationResult, FederatedAgentWithDetails, FederatedPublisher, DomainLookupResult, ListOptions, ListAgentsOptions, ValidateAdagentsRequest, CreateAdagentsRequest, ValidateProductAuthorizationRequest, ExpandProductIdentifiersRequest, PublisherPropertySelector, } from './types';
+export type { paths, operations, components, LocalizedName, PropertyIdentifier, RegistryError, AgentHealth, AgentStats, AgentCapabilities, PropertySummary, } from './types';
 /**
- * Client for looking up brands and properties in the AdCP registry.
+ * Client for the AdCP Registry API.
+ *
+ * Covers brand resolution, property resolution, agent discovery,
+ * authorization lookups, validation tools, and search.
  *
  * @example
  * ```ts
- * const registry = new RegistryClient();
+ * const registry = new RegistryClient({ apiKey: 'sk_...' });
  * const brand = await registry.lookupBrand('nike.com');
- * const properties = await registry.lookupProperties(['nytimes.com', 'wsj.com']);
+ * const agents = await registry.listAgents({ type: 'sales' });
+ * const results = await registry.search('nike');
  * ```
  */
 export declare class RegistryClient {
     private readonly baseUrl;
+    private readonly apiKey;
     constructor(config?: RegistryClientConfig);
-    /**
-     * Resolve a single domain to its canonical brand identity.
-     *
-     * @param domain - Domain to resolve (e.g. "nike.com")
-     * @returns The resolved brand, or null if not found
-     */
+    /** Resolve a single domain to its canonical brand identity. */
     lookupBrand(domain: string): Promise<ResolvedBrand | null>;
-    /**
-     * Bulk resolve domains to their canonical brand identities.
-     *
-     * @param domains - Array of domains to resolve (max 100)
-     * @returns Map of domain to resolved brand (null if not found)
-     */
+    /** Bulk resolve domains to their canonical brand identities (max 100). */
     lookupBrands(domains: string[]): Promise<Record<string, ResolvedBrand | null>>;
-    /**
-     * Resolve a single domain to its property information.
-     *
-     * @param domain - Publisher domain to resolve (e.g. "nytimes.com")
-     * @returns The resolved property info, or null if not found
-     */
-    lookupProperty(domain: string): Promise<PropertyInfo | null>;
-    /**
-     * Bulk resolve domains to their property information.
-     *
-     * @param domains - Array of publisher domains to resolve (max 100)
-     * @returns Map of domain to property info (null if not found)
-     */
-    lookupProperties(domains: string[]): Promise<Record<string, PropertyInfo | null>>;
+    /** List brands in the registry with optional search and pagination. */
+    listBrands(options?: ListOptions): Promise<{
+        brands: BrandRegistryItem[];
+        stats: Record<string, unknown>;
+    }>;
+    /** Fetch raw brand.json data for a domain. */
+    getBrandJson(domain: string): Promise<Record<string, unknown> | null>;
+    /** Enrich a brand with Brandfetch data. */
+    enrichBrand(domain: string): Promise<Record<string, unknown>>;
+    /** Save or update a community brand. Requires authentication. */
+    saveBrand(brand: SaveBrandRequest): Promise<SaveBrandResponse>;
+    /** Resolve a single domain to its property information. */
+    lookupProperty(domain: string): Promise<ResolvedProperty | null>;
+    /** Bulk resolve domains to their property information (max 100). */
+    lookupProperties(domains: string[]): Promise<Record<string, ResolvedProperty | null>>;
+    /** List properties in the registry with optional search and pagination. */
+    listProperties(options?: ListOptions): Promise<{
+        properties: PropertyRegistryItem[];
+        stats: Record<string, unknown>;
+    }>;
+    /** Validate a domain's adagents.json file. */
+    validateProperty(domain: string): Promise<ValidationResult>;
+    /** Save or update a hosted property. Requires authentication. */
+    saveProperty(property: SavePropertyRequest): Promise<SavePropertyResponse>;
+    /** List registered agents with optional filtering. */
+    listAgents(options?: ListAgentsOptions): Promise<{
+        agents: FederatedAgentWithDetails[];
+        count: number;
+        sources: Record<string, unknown>;
+    }>;
+    /** List publishers in the registry. */
+    listPublishers(): Promise<{
+        publishers: FederatedPublisher[];
+        count: number;
+        sources: Record<string, unknown>;
+    }>;
+    /** Get aggregate registry statistics. */
+    getRegistryStats(): Promise<Record<string, unknown>>;
+    /** Look up agents authorized for a domain. */
+    lookupDomain(domain: string): Promise<DomainLookupResult>;
+    /** Look up agents by property identifier (type + value). */
+    lookupPropertyByIdentifier(type: string, value: string): Promise<Record<string, unknown>>;
+    /** Get domains associated with an agent. */
+    getAgentDomains(agentUrl: string): Promise<{
+        agent_url: string;
+        domains: string[];
+        count: number;
+    }>;
+    /** Check if an agent is authorized for a specific property identifier. */
+    validatePropertyAuthorization(agentUrl: string, identifierType: string, identifierValue: string): Promise<{
+        agent_url: string;
+        identifier_type: string;
+        identifier_value: string;
+        authorized: boolean;
+        checked_at: string;
+    }>;
+    /** Validate product authorization for an agent across publisher properties. */
+    validateProductAuthorization(agentUrl: string, publisherProperties: PublisherPropertySelector[]): Promise<Record<string, unknown>>;
+    /** Expand product identifiers for an agent across publisher properties. */
+    expandProductIdentifiers(agentUrl: string, publisherProperties: PublisherPropertySelector[]): Promise<Record<string, unknown>>;
+    /** Validate a domain's adagents.json compliance. */
+    validateAdagents(domain: string): Promise<Record<string, unknown>>;
+    /** Generate a valid adagents.json from an agent configuration. */
+    createAdagents(config: CreateAdagentsRequest): Promise<Record<string, unknown>>;
+    /** Search brands, publishers, and properties. */
+    search(query: string): Promise<{
+        brands: unknown[];
+        publishers: unknown[];
+        properties: unknown[];
+    }>;
+    /** Look up a manifest reference by domain. */
+    lookupManifestRef(domain: string, type?: string): Promise<Record<string, unknown>>;
+    /** Probe a live agent endpoint to discover its capabilities. */
+    discoverAgent(url: string): Promise<Record<string, unknown>>;
+    /** Get creative formats supported by an agent. */
+    getAgentFormats(url: string): Promise<Record<string, unknown>>;
+    /** Get products available from an agent. */
+    getAgentProducts(url: string): Promise<Record<string, unknown>>;
+    /** Validate a publisher domain's configuration. */
+    validatePublisher(domain: string): Promise<Record<string, unknown>>;
+    private get;
+    private post;
+    private getHeaders;
     private parseJson;
+    private buildParams;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/registry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEjF,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAKjF;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,CAAC,EAAE,oBAAoB;IAIzC;;;;;OAKG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAehE;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC;IAsBpF;;;;;OAKG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAelE;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC,CAAC;YAsBzE,SAAS;CAQxB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAEhB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EAEjB,qBAAqB,EAGrB,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,mCAAmC,EACnC,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,KAAK,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,eAAe,GAChB,MAAM,SAAS,CAAC;AAKjB;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;gBAEhC,MAAM,CAAC,EAAE,oBAAoB;IAOzC,+DAA+D;IACzD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAMhE,0EAA0E;IACpE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC;IASpF,uEAAuE;IACjE,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAKjH,8CAA8C;IACxC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAM3E,2CAA2C;IACrC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKnE,iEAAiE;IAC3D,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IASpE,2DAA2D;IACrD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAMtE,oEAAoE;IAC9D,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAS3F,2EAA2E;IACrE,cAAc,CAClB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC;QAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAKlF,8CAA8C;IACxC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKjE,iEAAiE;IAC3D,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAShF,sDAAsD;IAChD,UAAU,CACd,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC;QAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAUpG,uCAAuC;IACjC,cAAc,IAAI,OAAO,CAAC;QAC9B,UAAU,EAAE,kBAAkB,EAAE,CAAC;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;IAIF,yCAAyC;IACnC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAM1D,8CAA8C;IACxC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAK/D,4DAA4D;IACtD,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAO/F,4CAA4C;IACtC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAKzG,0EAA0E;IACpE,6BAA6B,CACjC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAUF,+EAA+E;IACzE,4BAA4B,CAChC,QAAQ,EAAE,MAAM,EAChB,mBAAmB,EAAE,yBAAyB,EAAE,GAC/C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAOnC,2EAA2E;IACrE,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,mBAAmB,EAAE,yBAAyB,EAAE,GAC/C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IASnC,oDAAoD;IAC9C,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKxE,kEAAkE;IAC5D,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMrF,iDAAiD;IAC3C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAAC,UAAU,EAAE,OAAO,EAAE,CAAC;QAAC,UAAU,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAKzG,8CAA8C;IACxC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAOxF,gEAAgE;IAC1D,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKlE,kDAAkD;IAC5C,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKpE,4CAA4C;IACtC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKrE,mDAAmD;IAC7C,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAO3D,GAAG;YAUH,IAAI;IAalB,OAAO,CAAC,UAAU;YAQJ,SAAS;IASvB,OAAO,CAAC,WAAW;CASpB"}

package/dist/lib/registry/index.js

@@ -4,107 +4,261 @@ exports.RegistryClient = void 0;
 const DEFAULT_BASE_URL = 'https://adcontextprotocol.org';
 const MAX_BULK_DOMAINS = 100;
 /**
- * Client for looking up brands and properties in the AdCP registry.
+ * Client for the AdCP Registry API.
+ *
+ * Covers brand resolution, property resolution, agent discovery,
+ * authorization lookups, validation tools, and search.
  *
  * @example
  * ```ts
- * const registry = new RegistryClient();
+ * const registry = new RegistryClient({ apiKey: 'sk_...' });
  * const brand = await registry.lookupBrand('nike.com');
- * const properties = await registry.lookupProperties(['nytimes.com', 'wsj.com']);
+ * const agents = await registry.listAgents({ type: 'sales' });
+ * const results = await registry.search('nike');
  * ```
  */
 class RegistryClient {
     baseUrl;
+    apiKey;
     constructor(config) {
         this.baseUrl = (config?.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+        this.apiKey = config?.apiKey ?? process.env.ADCP_REGISTRY_API_KEY;
     }
-    /**
-     * Resolve a single domain to its canonical brand identity.
-     *
-     * @param domain - Domain to resolve (e.g. "nike.com")
-     * @returns The resolved brand, or null if not found
-     */
+    // ====== Brand Resolution ======
+    /** Resolve a single domain to its canonical brand identity. */
     async lookupBrand(domain) {
         if (!domain?.trim())
             throw new Error('domain is required');
         const url = `${this.baseUrl}/api/brands/resolve?domain=${encodeURIComponent(domain)}`;
-        const res = await fetch(url);
-        if (res.status === 404)
-            return null;
-        if (!res.ok) {
-            const body = await res.text();
-            throw new Error(`Registry brand lookup failed (${res.status}): ${body}`);
-        }
-        return this.parseJson(res);
+        return this.get(url, { nullOn404: true });
     }
-    /**
-     * Bulk resolve domains to their canonical brand identities.
-     *
-     * @param domains - Array of domains to resolve (max 100)
-     * @returns Map of domain to resolved brand (null if not found)
-     */
+    /** Bulk resolve domains to their canonical brand identities (max 100). */
     async lookupBrands(domains) {
         if (domains.length === 0)
             return {};
         if (domains.length > MAX_BULK_DOMAINS) {
             throw new Error(`Cannot resolve more than ${MAX_BULK_DOMAINS} domains at once (got ${domains.length})`);
         }
-        const url = `${this.baseUrl}/api/brands/resolve/bulk`;
-        const res = await fetch(url, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ domains }),
-        });
-        if (!res.ok) {
-            const body = await res.text();
-            throw new Error(`Registry bulk brand lookup failed (${res.status}): ${body}`);
-        }
-        const data = await this.parseJson(res);
+        const data = await this.post(`${this.baseUrl}/api/brands/resolve/bulk`, { domains });
         return data.results;
     }
-    /**
-     * Resolve a single domain to its property information.
-     *
-     * @param domain - Publisher domain to resolve (e.g. "nytimes.com")
-     * @returns The resolved property info, or null if not found
-     */
+    /** List brands in the registry with optional search and pagination. */
+    async listBrands(options) {
+        const params = this.buildParams(options);
+        return this.get(`${this.baseUrl}/api/brands/registry${params}`);
+    }
+    /** Fetch raw brand.json data for a domain. */
+    async getBrandJson(domain) {
+        if (!domain?.trim())
+            throw new Error('domain is required');
+        const url = `${this.baseUrl}/api/brands/brand-json?domain=${encodeURIComponent(domain)}`;
+        return this.get(url, { nullOn404: true });
+    }
+    /** Enrich a brand with Brandfetch data. */
+    async enrichBrand(domain) {
+        if (!domain?.trim())
+            throw new Error('domain is required');
+        return this.get(`${this.baseUrl}/api/brands/enrich?domain=${encodeURIComponent(domain)}`);
+    }
+    /** Save or update a community brand. Requires authentication. */
+    async saveBrand(brand) {
+        if (!brand?.domain?.trim())
+            throw new Error('domain is required');
+        if (!brand?.brand_name?.trim())
+            throw new Error('brand_name is required');
+        if (!this.apiKey)
+            throw new Error('apiKey is required for save operations');
+        return this.post(`${this.baseUrl}/api/brands/save`, brand);
+    }
+    // ====== Property Resolution ======
+    /** Resolve a single domain to its property information. */
     async lookupProperty(domain) {
         if (!domain?.trim())
             throw new Error('domain is required');
         const url = `${this.baseUrl}/api/properties/resolve?domain=${encodeURIComponent(domain)}`;
-        const res = await fetch(url);
-        if (res.status === 404)
-            return null;
-        if (!res.ok) {
-            const body = await res.text();
-            throw new Error(`Registry property lookup failed (${res.status}): ${body}`);
-        }
-        return this.parseJson(res);
+        return this.get(url, { nullOn404: true });
     }
-    /**
-     * Bulk resolve domains to their property information.
-     *
-     * @param domains - Array of publisher domains to resolve (max 100)
-     * @returns Map of domain to property info (null if not found)
-     */
+    /** Bulk resolve domains to their property information (max 100). */
     async lookupProperties(domains) {
         if (domains.length === 0)
             return {};
         if (domains.length > MAX_BULK_DOMAINS) {
             throw new Error(`Cannot resolve more than ${MAX_BULK_DOMAINS} domains at once (got ${domains.length})`);
         }
-        const url = `${this.baseUrl}/api/properties/resolve/bulk`;
+        const data = await this.post(`${this.baseUrl}/api/properties/resolve/bulk`, { domains });
+        return data.results;
+    }
+    /** List properties in the registry with optional search and pagination. */
+    async listProperties(options) {
+        const params = this.buildParams(options);
+        return this.get(`${this.baseUrl}/api/properties/registry${params}`);
+    }
+    /** Validate a domain's adagents.json file. */
+    async validateProperty(domain) {
+        if (!domain?.trim())
+            throw new Error('domain is required');
+        return this.get(`${this.baseUrl}/api/properties/validate?domain=${encodeURIComponent(domain)}`);
+    }
+    /** Save or update a hosted property. Requires authentication. */
+    async saveProperty(property) {
+        if (!property?.publisher_domain?.trim())
+            throw new Error('publisher_domain is required');
+        if (!property?.authorized_agents?.length)
+            throw new Error('authorized_agents is required');
+        if (!this.apiKey)
+            throw new Error('apiKey is required for save operations');
+        return this.post(`${this.baseUrl}/api/properties/save`, property);
+    }
+    // ====== Agent Discovery ======
+    /** List registered agents with optional filtering. */
+    async listAgents(options) {
+        const params = new URLSearchParams();
+        if (options?.type)
+            params.set('type', options.type);
+        if (options?.health)
+            params.set('health', 'true');
+        if (options?.capabilities)
+            params.set('capabilities', 'true');
+        if (options?.properties)
+            params.set('properties', 'true');
+        const qs = params.toString();
+        return this.get(`${this.baseUrl}/api/registry/agents${qs ? '?' + qs : ''}`);
+    }
+    /** List publishers in the registry. */
+    async listPublishers() {
+        return this.get(`${this.baseUrl}/api/registry/publishers`);
+    }
+    /** Get aggregate registry statistics. */
+    async getRegistryStats() {
+        return this.get(`${this.baseUrl}/api/registry/stats`);
+    }
+    // ====== Authorization Lookups ======
+    /** Look up agents authorized for a domain. */
+    async lookupDomain(domain) {
+        if (!domain?.trim())
+            throw new Error('domain is required');
+        return this.get(`${this.baseUrl}/api/registry/lookup/domain/${encodeURIComponent(domain)}`);
+    }
+    /** Look up agents by property identifier (type + value). */
+    async lookupPropertyByIdentifier(type, value) {
+        if (!type?.trim())
+            throw new Error('type is required');
+        if (!value?.trim())
+            throw new Error('value is required');
+        const params = `?type=${encodeURIComponent(type)}&value=${encodeURIComponent(value)}`;
+        return this.get(`${this.baseUrl}/api/registry/lookup/property${params}`);
+    }
+    /** Get domains associated with an agent. */
+    async getAgentDomains(agentUrl) {
+        if (!agentUrl?.trim())
+            throw new Error('agentUrl is required');
+        return this.get(`${this.baseUrl}/api/registry/lookup/agent/${encodeURIComponent(agentUrl)}/domains`);
+    }
+    /** Check if an agent is authorized for a specific property identifier. */
+    async validatePropertyAuthorization(agentUrl, identifierType, identifierValue) {
+        if (!agentUrl?.trim())
+            throw new Error('agentUrl is required');
+        const params = new URLSearchParams({
+            agent_url: agentUrl,
+            identifier_type: identifierType,
+            identifier_value: identifierValue,
+        });
+        return this.get(`${this.baseUrl}/api/registry/validate/property-authorization?${params}`);
+    }
+    /** Validate product authorization for an agent across publisher properties. */
+    async validateProductAuthorization(agentUrl, publisherProperties) {
+        return this.post(`${this.baseUrl}/api/registry/validate/product-authorization`, {
+            agent_url: agentUrl,
+            publisher_properties: publisherProperties,
+        });
+    }
+    /** Expand product identifiers for an agent across publisher properties. */
+    async expandProductIdentifiers(agentUrl, publisherProperties) {
+        return this.post(`${this.baseUrl}/api/registry/expand/product-identifiers`, {
+            agent_url: agentUrl,
+            publisher_properties: publisherProperties,
+        });
+    }
+    // ====== Adagents Tooling ======
+    /** Validate a domain's adagents.json compliance. */
+    async validateAdagents(domain) {
+        if (!domain?.trim())
+            throw new Error('domain is required');
+        return this.post(`${this.baseUrl}/api/adagents/validate`, { domain });
+    }
+    /** Generate a valid adagents.json from an agent configuration. */
+    async createAdagents(config) {
+        return this.post(`${this.baseUrl}/api/adagents/create`, config);
+    }
+    // ====== Search & Discovery ======
+    /** Search brands, publishers, and properties. */
+    async search(query) {
+        if (!query?.trim())
+            throw new Error('query is required');
+        return this.get(`${this.baseUrl}/api/search?q=${encodeURIComponent(query)}`);
+    }
+    /** Look up a manifest reference by domain. */
+    async lookupManifestRef(domain, type) {
+        if (!domain?.trim())
+            throw new Error('domain is required');
+        const params = new URLSearchParams({ domain });
+        if (type)
+            params.set('type', type);
+        return this.get(`${this.baseUrl}/api/manifest-refs/lookup?${params}`);
+    }
+    /** Probe a live agent endpoint to discover its capabilities. */
+    async discoverAgent(url) {
+        if (!url?.trim())
+            throw new Error('url is required');
+        return this.get(`${this.baseUrl}/api/public/discover-agent?url=${encodeURIComponent(url)}`);
+    }
+    /** Get creative formats supported by an agent. */
+    async getAgentFormats(url) {
+        if (!url?.trim())
+            throw new Error('url is required');
+        return this.get(`${this.baseUrl}/api/public/agent-formats?url=${encodeURIComponent(url)}`);
+    }
+    /** Get products available from an agent. */
+    async getAgentProducts(url) {
+        if (!url?.trim())
+            throw new Error('url is required');
+        return this.get(`${this.baseUrl}/api/public/agent-products?url=${encodeURIComponent(url)}`);
+    }
+    /** Validate a publisher domain's configuration. */
+    async validatePublisher(domain) {
+        if (!domain?.trim())
+            throw new Error('domain is required');
+        return this.get(`${this.baseUrl}/api/public/validate-publisher?domain=${encodeURIComponent(domain)}`);
+    }
+    // ====== Private helpers ======
+    async get(url, opts) {
+        const res = await fetch(url, { headers: this.getHeaders() });
+        if (opts?.nullOn404 && res.status === 404)
+            return null;
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`Registry request failed (${res.status}): ${body}`);
+        }
+        return this.parseJson(res);
+    }
+    async post(url, body) {
         const res = await fetch(url, {
             method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ domains }),
+            headers: { ...this.getHeaders(), 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
         });
         if (!res.ok) {
-            const body = await res.text();
-            throw new Error(`Registry bulk property lookup failed (${res.status}): ${body}`);
+            const text = await res.text();
+            throw new Error(`Registry request failed (${res.status}): ${text}`);
         }
-        const data = await this.parseJson(res);
-        return data.results;
+        return this.parseJson(res);
+    }
+    getHeaders() {
+        const headers = {};
+        if (this.apiKey) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+        return headers;
     }
     async parseJson(res) {
         const text = await res.text();
@@ -115,6 +269,19 @@ class RegistryClient {
             throw new Error(`Registry returned invalid JSON: ${text.slice(0, 200)}`);
         }
     }
+    buildParams(options) {
+        if (!options)
+            return '';
+        const params = new URLSearchParams();
+        if (options.search)
+            params.set('search', options.search);
+        if (options.limit != null)
+            params.set('limit', String(options.limit));
+        if (options.offset != null)
+            params.set('offset', String(options.offset));
+        const qs = params.toString();
+        return qs ? '?' + qs : '';
+    }
 }
 exports.RegistryClient = RegistryClient;
 //# sourceMappingURL=index.js.map

package/dist/lib/registry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/registry/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/registry/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/registry/types.d.ts

@@ -1,64 +1,48 @@
 /**
- * A brand resolved from the AdCP registry via domain lookup.
- */
-export interface ResolvedBrand {
-    /** Canonical identifier, e.g. "nike.com" or "nike.com#air-jordan" */
-    canonical_id: string;
-    /** Canonical domain for this brand */
-    canonical_domain: string;
-    /** Human-readable brand name */
-    brand_name: string;
-    /** Localized name variants keyed by language code */
-    names?: Array<Record<string, string>>;
-    /** Brand architecture classification (Keller's theory) */
-    keller_type?: 'master' | 'sub_brand' | 'endorsed' | 'independent';
-    /** Parent brand canonical ID, if this is a sub-brand */
-    parent_brand?: string;
-    /** Corporate house domain that owns this brand */
-    house_domain?: string;
-    /** Corporate house name */
-    house_name?: string;
-    /** URL to the brand's AdCP agent */
-    brand_agent_url?: string;
-    /** Brand manifest data (logos, colors, etc.) */
-    brand_manifest?: Record<string, unknown>;
-    /** How this brand record was sourced */
-    source: 'brand_json' | 'community' | 'enriched';
-}
-/**
- * A property (publisher) resolved from the AdCP registry via domain lookup.
- */
-export interface PropertyInfo {
-    /** Publisher domain that owns this property */
-    publisher_domain: string;
-    /** How this property record was sourced */
-    source: 'hosted' | 'adagents_json';
-    /** Agents authorized to sell inventory on this property */
-    authorized_agents: Array<{
-        url: string;
-    }>;
-    /** Properties associated with this domain */
-    properties: Array<{
-        id: string;
-        type: string;
-        name: string;
-        identifiers: Array<{
-            type: string;
-            value: string;
-            include_subdomains?: boolean;
-        }>;
-        tags?: string[];
-    }>;
-    /** Publisher contact information */
-    contact?: Record<string, unknown>;
-    /** Whether domain ownership has been verified */
-    verified: boolean;
-}
-/**
- * Configuration for the registry client.
+ * AdCP Registry Types
+ *
+ * Generated types are in types.generated.ts (from OpenAPI spec).
+ * This file re-exports them with ergonomic names and adds client-specific types.
  */
+export type { ResolvedBrand, LocalizedName, BrandRegistryItem, ResolvedProperty, PropertyIdentifier, PropertyRegistryItem, ValidationResult, RegistryError, PublisherPropertySelector, FederatedAgentWithDetails, AgentHealth, AgentStats, AgentCapabilities, PropertySummary, FederatedPublisher, DomainLookupResult, } from './types.generated';
+export type { paths, operations, components } from './types.generated';
+import type { operations } from './types.generated';
+/** Request body for POST /api/brands/save */
+export type SaveBrandRequest = NonNullable<operations['saveBrand']['requestBody']>['content']['application/json'];
+/** Response from POST /api/brands/save (200) */
+export type SaveBrandResponse = operations['saveBrand']['responses']['200']['content']['application/json'];
+/** Request body for POST /api/properties/save */
+export type SavePropertyRequest = NonNullable<operations['saveProperty']['requestBody']>['content']['application/json'];
+/** Response from POST /api/properties/save (200) */
+export type SavePropertyResponse = operations['saveProperty']['responses']['200']['content']['application/json'];
+/** Request body for POST /api/adagents/validate */
+export type ValidateAdagentsRequest = NonNullable<operations['validateAdagents']['requestBody']>['content']['application/json'];
+/** Request body for POST /api/adagents/create */
+export type CreateAdagentsRequest = NonNullable<operations['createAdagents']['requestBody']>['content']['application/json'];
+/** Request body for POST /api/registry/validate/product-authorization */
+export type ValidateProductAuthorizationRequest = NonNullable<operations['validateProductAuthorization']['requestBody']>['content']['application/json'];
+/** Request body for POST /api/registry/expand/product-identifiers */
+export type ExpandProductIdentifiersRequest = NonNullable<operations['expandProductIdentifiers']['requestBody']>['content']['application/json'];
+/** @deprecated Use ResolvedProperty instead */
+export type PropertyInfo = import('./types.generated').ResolvedProperty;
+/** Configuration for the registry client. */
 export interface RegistryClientConfig {
     /** Base URL of the AdCP registry. Defaults to https://adcontextprotocol.org */
     baseUrl?: string;
+    /** API key for authenticated registry access. Falls back to ADCP_REGISTRY_API_KEY env var. */
+    apiKey?: string;
+}
+/** Options for list/search endpoints with pagination. */
+export interface ListOptions {
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Options for listing agents with filtering. */
+export interface ListAgentsOptions {
+    type?: 'creative' | 'signals' | 'sales' | 'governance' | 'si';
+    health?: boolean;
+    capabilities?: boolean;
+    properties?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map