@adcp/client 3.14.1 → 3.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/bin/adcp-registry.js +736 -0
  2. package/bin/adcp.js +38 -2
  3. package/dist/lib/core/SingleAgentClient.d.ts +0 -1
  4. package/dist/lib/core/SingleAgentClient.d.ts.map +1 -1
  5. package/dist/lib/core/SingleAgentClient.js +1 -2
  6. package/dist/lib/core/SingleAgentClient.js.map +1 -1
  7. package/dist/lib/index.d.ts +1 -1
  8. package/dist/lib/index.d.ts.map +1 -1
  9. package/dist/lib/index.js.map +1 -1
  10. package/dist/lib/protocols/mcp.d.ts.map +1 -1
  11. package/dist/lib/protocols/mcp.js +49 -20
  12. package/dist/lib/protocols/mcp.js.map +1 -1
  13. package/dist/lib/registry/index.d.ts +97 -31
  14. package/dist/lib/registry/index.d.ts.map +1 -1
  15. package/dist/lib/registry/index.js +228 -61
  16. package/dist/lib/registry/index.js.map +1 -1
  17. package/dist/lib/registry/types.d.ts +41 -57
  18. package/dist/lib/registry/types.d.ts.map +1 -1
  19. package/dist/lib/registry/types.generated.d.ts +1860 -0
  20. package/dist/lib/registry/types.generated.d.ts.map +1 -0
  21. package/dist/lib/registry/types.generated.js +8 -0
  22. package/dist/lib/registry/types.generated.js.map +1 -0
  23. package/dist/lib/registry/types.js +6 -0
  24. package/dist/lib/registry/types.js.map +1 -1
  25. package/dist/lib/types/core.generated.d.ts +91 -64
  26. package/dist/lib/types/core.generated.d.ts.map +1 -1
  27. package/dist/lib/types/core.generated.js +2 -2
  28. package/dist/lib/types/core.generated.js.map +1 -1
  29. package/dist/lib/types/schemas.generated.d.ts +334 -42
  30. package/dist/lib/types/schemas.generated.d.ts.map +1 -1
  31. package/dist/lib/types/schemas.generated.js +65 -29
  32. package/dist/lib/types/schemas.generated.js.map +1 -1
  33. package/dist/lib/types/tools.generated.d.ts +178 -67
  34. package/dist/lib/types/tools.generated.d.ts.map +1 -1
  35. package/dist/lib/version.d.ts +5 -5
  36. package/dist/lib/version.d.ts.map +1 -1
  37. package/dist/lib/version.js +5 -5
  38. package/dist/lib/version.js.map +1 -1
  39. package/package.json +4 -2
@@ -0,0 +1,1860 @@
1
+ export interface paths {
2
+ "/api": {
3
+ parameters: {
4
+ query?: never;
5
+ header?: never;
6
+ path?: never;
7
+ cookie?: never;
8
+ };
9
+ /**
10
+ * API discovery
11
+ * @description Returns links to the main API entry points and documentation.
12
+ */
13
+ get: operations["apiDiscovery"];
14
+ put?: never;
15
+ post?: never;
16
+ delete?: never;
17
+ options?: never;
18
+ head?: never;
19
+ patch?: never;
20
+ trace?: never;
21
+ };
22
+ "/api/brands/resolve": {
23
+ parameters: {
24
+ query?: never;
25
+ header?: never;
26
+ path?: never;
27
+ cookie?: never;
28
+ };
29
+ /**
30
+ * Resolve brand
31
+ * @description Resolve a domain to its canonical brand identity. Follows brand.json redirects and returns the resolved brand with its house, architecture type, and optional manifest.
32
+ */
33
+ get: operations["resolveBrand"];
34
+ put?: never;
35
+ post?: never;
36
+ delete?: never;
37
+ options?: never;
38
+ head?: never;
39
+ patch?: never;
40
+ trace?: never;
41
+ };
42
+ "/api/brands/resolve/bulk": {
43
+ parameters: {
44
+ query?: never;
45
+ header?: never;
46
+ path?: never;
47
+ cookie?: never;
48
+ };
49
+ get?: never;
50
+ put?: never;
51
+ /**
52
+ * Bulk resolve brands
53
+ * @description Resolve up to 100 domains to their canonical brand identities in a single request.
54
+ *
55
+ * **Rate limit:** 20 requests per minute per IP address.
56
+ */
57
+ post: operations["resolveBrandsBulk"];
58
+ delete?: never;
59
+ options?: never;
60
+ head?: never;
61
+ patch?: never;
62
+ trace?: never;
63
+ };
64
+ "/api/brands/brand-json": {
65
+ parameters: {
66
+ query?: never;
67
+ header?: never;
68
+ path?: never;
69
+ cookie?: never;
70
+ };
71
+ /**
72
+ * Get brand.json
73
+ * @description Fetch the raw brand.json file for a domain.
74
+ */
75
+ get: operations["getBrandJson"];
76
+ put?: never;
77
+ post?: never;
78
+ delete?: never;
79
+ options?: never;
80
+ head?: never;
81
+ patch?: never;
82
+ trace?: never;
83
+ };
84
+ "/api/brands/save": {
85
+ parameters: {
86
+ query?: never;
87
+ header?: never;
88
+ path?: never;
89
+ cookie?: never;
90
+ };
91
+ get?: never;
92
+ put?: never;
93
+ /**
94
+ * Save brand
95
+ * @description Save or update a brand in the registry. Requires authentication. For existing brands, creates a revision-tracked edit. For new brands, creates the brand directly. Cannot edit authoritative brands managed via brand.json.
96
+ */
97
+ post: operations["saveBrand"];
98
+ delete?: never;
99
+ options?: never;
100
+ head?: never;
101
+ patch?: never;
102
+ trace?: never;
103
+ };
104
+ "/api/brands/registry": {
105
+ parameters: {
106
+ query?: never;
107
+ header?: never;
108
+ path?: never;
109
+ cookie?: never;
110
+ };
111
+ /**
112
+ * List brands
113
+ * @description List all brands in the registry with optional search, pagination.
114
+ */
115
+ get: operations["listBrands"];
116
+ put?: never;
117
+ post?: never;
118
+ delete?: never;
119
+ options?: never;
120
+ head?: never;
121
+ patch?: never;
122
+ trace?: never;
123
+ };
124
+ "/api/brands/enrich": {
125
+ parameters: {
126
+ query?: never;
127
+ header?: never;
128
+ path?: never;
129
+ cookie?: never;
130
+ };
131
+ /**
132
+ * Enrich brand
133
+ * @description Enrich brand data using Brandfetch. Returns logo, colors, and company information.
134
+ */
135
+ get: operations["enrichBrand"];
136
+ put?: never;
137
+ post?: never;
138
+ delete?: never;
139
+ options?: never;
140
+ head?: never;
141
+ patch?: never;
142
+ trace?: never;
143
+ };
144
+ "/api/properties/resolve": {
145
+ parameters: {
146
+ query?: never;
147
+ header?: never;
148
+ path?: never;
149
+ cookie?: never;
150
+ };
151
+ /**
152
+ * Resolve property
153
+ * @description Resolve a publisher domain to its property information. Checks hosted properties, discovered properties, then live adagents.json validation.
154
+ */
155
+ get: operations["resolveProperty"];
156
+ put?: never;
157
+ post?: never;
158
+ delete?: never;
159
+ options?: never;
160
+ head?: never;
161
+ patch?: never;
162
+ trace?: never;
163
+ };
164
+ "/api/properties/resolve/bulk": {
165
+ parameters: {
166
+ query?: never;
167
+ header?: never;
168
+ path?: never;
169
+ cookie?: never;
170
+ };
171
+ get?: never;
172
+ put?: never;
173
+ /**
174
+ * Bulk resolve properties
175
+ * @description Resolve up to 100 publisher domains at once.
176
+ *
177
+ * **Rate limit:** 20 requests per minute per IP address.
178
+ */
179
+ post: operations["resolvePropertiesBulk"];
180
+ delete?: never;
181
+ options?: never;
182
+ head?: never;
183
+ patch?: never;
184
+ trace?: never;
185
+ };
186
+ "/api/properties/registry": {
187
+ parameters: {
188
+ query?: never;
189
+ header?: never;
190
+ path?: never;
191
+ cookie?: never;
192
+ };
193
+ /**
194
+ * List properties
195
+ * @description List all properties in the registry with optional search, pagination.
196
+ */
197
+ get: operations["listProperties"];
198
+ put?: never;
199
+ post?: never;
200
+ delete?: never;
201
+ options?: never;
202
+ head?: never;
203
+ patch?: never;
204
+ trace?: never;
205
+ };
206
+ "/api/properties/validate": {
207
+ parameters: {
208
+ query?: never;
209
+ header?: never;
210
+ path?: never;
211
+ cookie?: never;
212
+ };
213
+ /**
214
+ * Validate adagents.json
215
+ * @description Validate a domain's adagents.json file and return the validation result.
216
+ */
217
+ get: operations["validateProperty"];
218
+ put?: never;
219
+ post?: never;
220
+ delete?: never;
221
+ options?: never;
222
+ head?: never;
223
+ patch?: never;
224
+ trace?: never;
225
+ };
226
+ "/api/properties/save": {
227
+ parameters: {
228
+ query?: never;
229
+ header?: never;
230
+ path?: never;
231
+ cookie?: never;
232
+ };
233
+ get?: never;
234
+ put?: never;
235
+ /**
236
+ * Save property
237
+ * @description Save or update a hosted property in the registry. Requires authentication. For existing properties, creates a revision-tracked edit. For new properties, creates the property directly. Cannot edit authoritative properties managed via adagents.json.
238
+ */
239
+ post: operations["saveProperty"];
240
+ delete?: never;
241
+ options?: never;
242
+ head?: never;
243
+ patch?: never;
244
+ trace?: never;
245
+ };
246
+ "/api/registry/agents": {
247
+ parameters: {
248
+ query?: never;
249
+ header?: never;
250
+ path?: never;
251
+ cookie?: never;
252
+ };
253
+ /**
254
+ * List agents
255
+ * @description List all registered and discovered agents. Optionally enrich with health checks, capabilities, and property summaries via query parameters.
256
+ */
257
+ get: operations["listAgents"];
258
+ put?: never;
259
+ post?: never;
260
+ delete?: never;
261
+ options?: never;
262
+ head?: never;
263
+ patch?: never;
264
+ trace?: never;
265
+ };
266
+ "/api/registry/publishers": {
267
+ parameters: {
268
+ query?: never;
269
+ header?: never;
270
+ path?: never;
271
+ cookie?: never;
272
+ };
273
+ /**
274
+ * List publishers
275
+ * @description List all registered and discovered publishers.
276
+ */
277
+ get: operations["listPublishers"];
278
+ put?: never;
279
+ post?: never;
280
+ delete?: never;
281
+ options?: never;
282
+ head?: never;
283
+ patch?: never;
284
+ trace?: never;
285
+ };
286
+ "/api/registry/stats": {
287
+ parameters: {
288
+ query?: never;
289
+ header?: never;
290
+ path?: never;
291
+ cookie?: never;
292
+ };
293
+ /**
294
+ * Registry statistics
295
+ * @description Get aggregate statistics about the registry.
296
+ */
297
+ get: operations["getRegistryStats"];
298
+ put?: never;
299
+ post?: never;
300
+ delete?: never;
301
+ options?: never;
302
+ head?: never;
303
+ patch?: never;
304
+ trace?: never;
305
+ };
306
+ "/api/registry/lookup/domain/{domain}": {
307
+ parameters: {
308
+ query?: never;
309
+ header?: never;
310
+ path?: never;
311
+ cookie?: never;
312
+ };
313
+ /**
314
+ * Domain lookup
315
+ * @description Find all agents authorized for a given publisher domain.
316
+ */
317
+ get: operations["lookupDomain"];
318
+ put?: never;
319
+ post?: never;
320
+ delete?: never;
321
+ options?: never;
322
+ head?: never;
323
+ patch?: never;
324
+ trace?: never;
325
+ };
326
+ "/api/registry/lookup/property": {
327
+ parameters: {
328
+ query?: never;
329
+ header?: never;
330
+ path?: never;
331
+ cookie?: never;
332
+ };
333
+ /**
334
+ * Property identifier lookup
335
+ * @description Find agents that hold a specific property identifier.
336
+ */
337
+ get: operations["lookupProperty"];
338
+ put?: never;
339
+ post?: never;
340
+ delete?: never;
341
+ options?: never;
342
+ head?: never;
343
+ patch?: never;
344
+ trace?: never;
345
+ };
346
+ "/api/registry/lookup/agent/{agentUrl}/domains": {
347
+ parameters: {
348
+ query?: never;
349
+ header?: never;
350
+ path?: never;
351
+ cookie?: never;
352
+ };
353
+ /**
354
+ * Agent domain lookup
355
+ * @description Get all publisher domains associated with an agent.
356
+ */
357
+ get: operations["getAgentDomains"];
358
+ put?: never;
359
+ post?: never;
360
+ delete?: never;
361
+ options?: never;
362
+ head?: never;
363
+ patch?: never;
364
+ trace?: never;
365
+ };
366
+ "/api/registry/validate/product-authorization": {
367
+ parameters: {
368
+ query?: never;
369
+ header?: never;
370
+ path?: never;
371
+ cookie?: never;
372
+ };
373
+ get?: never;
374
+ put?: never;
375
+ /**
376
+ * Validate product authorization
377
+ * @description Check whether an agent is authorized to sell a product based on its publisher_properties.
378
+ */
379
+ post: operations["validateProductAuthorization"];
380
+ delete?: never;
381
+ options?: never;
382
+ head?: never;
383
+ patch?: never;
384
+ trace?: never;
385
+ };
386
+ "/api/registry/expand/product-identifiers": {
387
+ parameters: {
388
+ query?: never;
389
+ header?: never;
390
+ path?: never;
391
+ cookie?: never;
392
+ };
393
+ get?: never;
394
+ put?: never;
395
+ /**
396
+ * Expand product identifiers
397
+ * @description Expand publisher_properties selectors into concrete property identifiers for caching.
398
+ */
399
+ post: operations["expandProductIdentifiers"];
400
+ delete?: never;
401
+ options?: never;
402
+ head?: never;
403
+ patch?: never;
404
+ trace?: never;
405
+ };
406
+ "/api/registry/validate/property-authorization": {
407
+ parameters: {
408
+ query?: never;
409
+ header?: never;
410
+ path?: never;
411
+ cookie?: never;
412
+ };
413
+ /**
414
+ * Property authorization check
415
+ * @description Quick check if a property identifier is authorized for an agent. Optimized for real-time ad request validation.
416
+ */
417
+ get: operations["validatePropertyAuthorization"];
418
+ put?: never;
419
+ post?: never;
420
+ delete?: never;
421
+ options?: never;
422
+ head?: never;
423
+ patch?: never;
424
+ trace?: never;
425
+ };
426
+ "/api/adagents/validate": {
427
+ parameters: {
428
+ query?: never;
429
+ header?: never;
430
+ path?: never;
431
+ cookie?: never;
432
+ };
433
+ get?: never;
434
+ put?: never;
435
+ /**
436
+ * Validate adagents.json
437
+ * @description Validate a domain's adagents.json file and optionally validate referenced agent cards.
438
+ */
439
+ post: operations["validateAdagents"];
440
+ delete?: never;
441
+ options?: never;
442
+ head?: never;
443
+ patch?: never;
444
+ trace?: never;
445
+ };
446
+ "/api/adagents/create": {
447
+ parameters: {
448
+ query?: never;
449
+ header?: never;
450
+ path?: never;
451
+ cookie?: never;
452
+ };
453
+ get?: never;
454
+ put?: never;
455
+ /**
456
+ * Generate adagents.json
457
+ * @description Generate a valid adagents.json file from a list of authorized agents.
458
+ */
459
+ post: operations["createAdagents"];
460
+ delete?: never;
461
+ options?: never;
462
+ head?: never;
463
+ patch?: never;
464
+ trace?: never;
465
+ };
466
+ "/api/search": {
467
+ parameters: {
468
+ query?: never;
469
+ header?: never;
470
+ path?: never;
471
+ cookie?: never;
472
+ };
473
+ /**
474
+ * Search
475
+ * @description Search across brands, publishers, and properties. Returns up to 5 results per category.
476
+ */
477
+ get: operations["search"];
478
+ put?: never;
479
+ post?: never;
480
+ delete?: never;
481
+ options?: never;
482
+ head?: never;
483
+ patch?: never;
484
+ trace?: never;
485
+ };
486
+ "/api/manifest-refs/lookup": {
487
+ parameters: {
488
+ query?: never;
489
+ header?: never;
490
+ path?: never;
491
+ cookie?: never;
492
+ };
493
+ /**
494
+ * Manifest reference lookup
495
+ * @description Find the best manifest reference (brand.json URL or agent) for a domain.
496
+ */
497
+ get: operations["lookupManifestRef"];
498
+ put?: never;
499
+ post?: never;
500
+ delete?: never;
501
+ options?: never;
502
+ head?: never;
503
+ patch?: never;
504
+ trace?: never;
505
+ };
506
+ "/api/public/discover-agent": {
507
+ parameters: {
508
+ query?: never;
509
+ header?: never;
510
+ path?: never;
511
+ cookie?: never;
512
+ };
513
+ /**
514
+ * Discover agent
515
+ * @description Probe an agent URL to discover its name, type, supported protocols, and basic statistics.
516
+ */
517
+ get: operations["discoverAgent"];
518
+ put?: never;
519
+ post?: never;
520
+ delete?: never;
521
+ options?: never;
522
+ head?: never;
523
+ patch?: never;
524
+ trace?: never;
525
+ };
526
+ "/api/public/agent-formats": {
527
+ parameters: {
528
+ query?: never;
529
+ header?: never;
530
+ path?: never;
531
+ cookie?: never;
532
+ };
533
+ /**
534
+ * Get agent formats
535
+ * @description Fetch creative formats from a creative agent.
536
+ */
537
+ get: operations["getAgentFormats"];
538
+ put?: never;
539
+ post?: never;
540
+ delete?: never;
541
+ options?: never;
542
+ head?: never;
543
+ patch?: never;
544
+ trace?: never;
545
+ };
546
+ "/api/public/agent-products": {
547
+ parameters: {
548
+ query?: never;
549
+ header?: never;
550
+ path?: never;
551
+ cookie?: never;
552
+ };
553
+ /**
554
+ * Get agent products
555
+ * @description Fetch products from a sales agent.
556
+ */
557
+ get: operations["getAgentProducts"];
558
+ put?: never;
559
+ post?: never;
560
+ delete?: never;
561
+ options?: never;
562
+ head?: never;
563
+ patch?: never;
564
+ trace?: never;
565
+ };
566
+ "/api/public/validate-publisher": {
567
+ parameters: {
568
+ query?: never;
569
+ header?: never;
570
+ path?: never;
571
+ cookie?: never;
572
+ };
573
+ /**
574
+ * Validate publisher
575
+ * @description Validate a publisher domain's adagents.json and return summary statistics.
576
+ */
577
+ get: operations["validatePublisher"];
578
+ put?: never;
579
+ post?: never;
580
+ delete?: never;
581
+ options?: never;
582
+ head?: never;
583
+ patch?: never;
584
+ trace?: never;
585
+ };
586
+ }
587
+ export type webhooks = Record<string, never>;
588
+ export interface components {
589
+ schemas: {
590
+ ResolvedBrand: {
591
+ /** @example acmecorp.com */
592
+ canonical_id: string;
593
+ /** @example acmecorp.com */
594
+ canonical_domain: string;
595
+ /** @example Acme Corp */
596
+ brand_name: string;
597
+ names?: components["schemas"]["LocalizedName"][];
598
+ /** @enum {string} */
599
+ keller_type?: "master" | "sub_brand" | "endorsed" | "independent";
600
+ parent_brand?: string;
601
+ house_domain?: string;
602
+ house_name?: string;
603
+ brand_agent_url?: string;
604
+ brand_manifest?: {
605
+ [key: string]: unknown;
606
+ };
607
+ /** @enum {string} */
608
+ source: "brand_json" | "community" | "enriched";
609
+ };
610
+ LocalizedName: {
611
+ [key: string]: string;
612
+ };
613
+ Error: {
614
+ error: string;
615
+ };
616
+ BrandRegistryItem: {
617
+ /** @example acmecorp.com */
618
+ domain: string;
619
+ /** @example Acme Corp */
620
+ brand_name?: string;
621
+ /** @enum {string} */
622
+ source: "hosted" | "brand_json" | "community" | "enriched";
623
+ has_manifest: boolean;
624
+ verified: boolean;
625
+ house_domain?: string;
626
+ /** @enum {string} */
627
+ keller_type?: "master" | "sub_brand" | "endorsed" | "independent";
628
+ };
629
+ ResolvedProperty: {
630
+ /** @example examplepub.com */
631
+ publisher_domain: string;
632
+ /** @enum {string} */
633
+ source: "adagents_json" | "hosted" | "discovered";
634
+ authorized_agents?: {
635
+ url: string;
636
+ authorized_for?: string;
637
+ }[];
638
+ properties?: {
639
+ id?: string;
640
+ type?: string;
641
+ name?: string;
642
+ identifiers?: components["schemas"]["PropertyIdentifier"][];
643
+ tags?: string[];
644
+ }[];
645
+ contact?: {
646
+ name?: string;
647
+ email?: string;
648
+ };
649
+ verified: boolean;
650
+ };
651
+ PropertyIdentifier: {
652
+ /** @example domain */
653
+ type: string;
654
+ /** @example examplepub.com */
655
+ value: string;
656
+ };
657
+ PropertyRegistryItem: {
658
+ /** @example examplepub.com */
659
+ domain: string;
660
+ /** @enum {string} */
661
+ source: "adagents_json" | "hosted" | "community" | "discovered" | "enriched";
662
+ property_count: number;
663
+ agent_count: number;
664
+ verified: boolean;
665
+ };
666
+ ValidationResult: {
667
+ valid: boolean;
668
+ domain?: string;
669
+ url?: string;
670
+ errors?: string[];
671
+ warnings?: string[];
672
+ status_code?: number;
673
+ raw_data?: {
674
+ [key: string]: unknown;
675
+ };
676
+ };
677
+ FederatedAgentWithDetails: {
678
+ url: string;
679
+ name: string;
680
+ /** @enum {string} */
681
+ type: "creative" | "signals" | "sales" | "governance" | "si" | "unknown";
682
+ /** @enum {string} */
683
+ protocol?: "mcp" | "a2a";
684
+ description?: string;
685
+ mcp_endpoint?: string;
686
+ contact?: {
687
+ name: string;
688
+ email: string;
689
+ website: string;
690
+ };
691
+ added_date?: string;
692
+ /** @enum {string} */
693
+ source?: "registered" | "discovered";
694
+ member?: {
695
+ slug?: string;
696
+ display_name?: string;
697
+ };
698
+ discovered_from?: {
699
+ publisher_domain?: string;
700
+ authorized_for?: string;
701
+ };
702
+ health?: components["schemas"]["AgentHealth"];
703
+ stats?: components["schemas"]["AgentStats"];
704
+ capabilities?: components["schemas"]["AgentCapabilities"];
705
+ publisher_domains?: string[];
706
+ property_summary?: components["schemas"]["PropertySummary"];
707
+ };
708
+ AgentHealth: {
709
+ online: boolean;
710
+ checked_at: string;
711
+ response_time_ms?: number;
712
+ tools_count?: number;
713
+ resources_count?: number;
714
+ error?: string;
715
+ };
716
+ AgentStats: {
717
+ property_count?: number;
718
+ publisher_count?: number;
719
+ publishers?: string[];
720
+ creative_formats?: number;
721
+ };
722
+ AgentCapabilities: {
723
+ tools_count: number;
724
+ tools?: {
725
+ name: string;
726
+ description: string;
727
+ }[];
728
+ standard_operations?: {
729
+ can_search_inventory: boolean;
730
+ can_get_availability: boolean;
731
+ can_reserve_inventory: boolean;
732
+ can_get_pricing: boolean;
733
+ can_create_order: boolean;
734
+ can_list_properties: boolean;
735
+ };
736
+ creative_capabilities?: {
737
+ formats_supported: string[];
738
+ can_generate: boolean;
739
+ can_validate: boolean;
740
+ can_preview: boolean;
741
+ };
742
+ };
743
+ PropertySummary: {
744
+ total_count: number;
745
+ count_by_type: {
746
+ [key: string]: number;
747
+ };
748
+ tags: string[];
749
+ publisher_count: number;
750
+ };
751
+ FederatedPublisher: {
752
+ domain: string;
753
+ /** @enum {string} */
754
+ source?: "registered" | "discovered";
755
+ member?: {
756
+ slug?: string;
757
+ display_name?: string;
758
+ };
759
+ agent_count?: number;
760
+ last_validated?: string;
761
+ discovered_from?: {
762
+ agent_url?: string;
763
+ };
764
+ has_valid_adagents?: boolean;
765
+ discovered_at?: string;
766
+ };
767
+ DomainLookupResult: {
768
+ /** @example examplepub.com */
769
+ domain: string;
770
+ authorized_agents: {
771
+ url: string;
772
+ authorized_for?: string;
773
+ /** @enum {string} */
774
+ source?: "registered" | "discovered";
775
+ member?: {
776
+ slug?: string;
777
+ display_name?: string;
778
+ };
779
+ }[];
780
+ sales_agents_claiming: {
781
+ url: string;
782
+ /** @enum {string} */
783
+ source?: "registered" | "discovered";
784
+ member?: {
785
+ slug?: string;
786
+ display_name?: string;
787
+ };
788
+ }[];
789
+ };
790
+ PublisherPropertySelector: {
791
+ /** @example examplepub.com */
792
+ publisher_domain?: string;
793
+ property_types?: string[];
794
+ property_ids?: string[];
795
+ tags?: string[];
796
+ };
797
+ };
798
+ responses: never;
799
+ parameters: never;
800
+ requestBodies: never;
801
+ headers: never;
802
+ pathItems: never;
803
+ }
804
+ export type $defs = Record<string, never>;
805
+ export interface operations {
806
+ apiDiscovery: {
807
+ parameters: {
808
+ query?: never;
809
+ header?: never;
810
+ path?: never;
811
+ cookie?: never;
812
+ };
813
+ requestBody?: never;
814
+ responses: {
815
+ /** @description API discovery information */
816
+ 200: {
817
+ headers: {
818
+ [name: string]: unknown;
819
+ };
820
+ content: {
821
+ "application/json": {
822
+ name: string;
823
+ version: string;
824
+ documentation: string;
825
+ openapi: string;
826
+ endpoints: {
827
+ [key: string]: string;
828
+ };
829
+ };
830
+ };
831
+ };
832
+ };
833
+ };
834
+ resolveBrand: {
835
+ parameters: {
836
+ query: {
837
+ domain: string;
838
+ fresh?: "true" | "false";
839
+ };
840
+ header?: never;
841
+ path?: never;
842
+ cookie?: never;
843
+ };
844
+ requestBody?: never;
845
+ responses: {
846
+ /** @description Brand resolved successfully */
847
+ 200: {
848
+ headers: {
849
+ [name: string]: unknown;
850
+ };
851
+ content: {
852
+ "application/json": components["schemas"]["ResolvedBrand"];
853
+ };
854
+ };
855
+ /** @description Brand not found */
856
+ 404: {
857
+ headers: {
858
+ [name: string]: unknown;
859
+ };
860
+ content: {
861
+ "application/json": {
862
+ error: string;
863
+ domain: string;
864
+ /** @description HTTP status code from brand.json fetch (e.g. 404 vs 200 with invalid data) */
865
+ file_status?: number;
866
+ };
867
+ };
868
+ };
869
+ };
870
+ };
871
+ resolveBrandsBulk: {
872
+ parameters: {
873
+ query?: never;
874
+ header?: never;
875
+ path?: never;
876
+ cookie?: never;
877
+ };
878
+ requestBody?: {
879
+ content: {
880
+ "application/json": {
881
+ domains: string[];
882
+ };
883
+ };
884
+ };
885
+ responses: {
886
+ /** @description Bulk resolution results */
887
+ 200: {
888
+ headers: {
889
+ [name: string]: unknown;
890
+ };
891
+ content: {
892
+ "application/json": {
893
+ results: {
894
+ [key: string]: components["schemas"]["ResolvedBrand"] & (Record<string, never> | null);
895
+ };
896
+ };
897
+ };
898
+ };
899
+ /** @description Rate limit exceeded */
900
+ 429: {
901
+ headers: {
902
+ [name: string]: unknown;
903
+ };
904
+ content: {
905
+ "application/json": components["schemas"]["Error"];
906
+ };
907
+ };
908
+ };
909
+ };
910
+ getBrandJson: {
911
+ parameters: {
912
+ query: {
913
+ domain: string;
914
+ fresh?: "true" | "false";
915
+ };
916
+ header?: never;
917
+ path?: never;
918
+ cookie?: never;
919
+ };
920
+ requestBody?: never;
921
+ responses: {
922
+ /** @description Raw brand.json data */
923
+ 200: {
924
+ headers: {
925
+ [name: string]: unknown;
926
+ };
927
+ content: {
928
+ "application/json": {
929
+ domain: string;
930
+ url: string;
931
+ variant?: string;
932
+ data: {
933
+ [key: string]: unknown;
934
+ };
935
+ warnings?: string[];
936
+ };
937
+ };
938
+ };
939
+ /** @description Brand not found */
940
+ 404: {
941
+ headers: {
942
+ [name: string]: unknown;
943
+ };
944
+ content: {
945
+ "application/json": components["schemas"]["Error"];
946
+ };
947
+ };
948
+ };
949
+ };
950
+ saveBrand: {
951
+ parameters: {
952
+ query?: never;
953
+ header?: never;
954
+ path?: never;
955
+ cookie?: never;
956
+ };
957
+ requestBody?: {
958
+ content: {
959
+ "application/json": {
960
+ /** @example acmecorp.com */
961
+ domain: string;
962
+ /** @example Acme Corp */
963
+ brand_name: string;
964
+ brand_manifest?: {
965
+ [key: string]: unknown;
966
+ };
967
+ };
968
+ };
969
+ };
970
+ responses: {
971
+ /** @description Brand saved or updated */
972
+ 200: {
973
+ headers: {
974
+ [name: string]: unknown;
975
+ };
976
+ content: {
977
+ "application/json": {
978
+ /** @enum {boolean} */
979
+ success: true;
980
+ message: string;
981
+ domain: string;
982
+ id: string;
983
+ revision_number?: number;
984
+ };
985
+ };
986
+ };
987
+ /** @description Missing required fields or invalid domain */
988
+ 400: {
989
+ headers: {
990
+ [name: string]: unknown;
991
+ };
992
+ content: {
993
+ "application/json": components["schemas"]["Error"];
994
+ };
995
+ };
996
+ /** @description Authentication required */
997
+ 401: {
998
+ headers: {
999
+ [name: string]: unknown;
1000
+ };
1001
+ content: {
1002
+ "application/json": components["schemas"]["Error"];
1003
+ };
1004
+ };
1005
+ /** @description Cannot edit authoritative brand */
1006
+ 409: {
1007
+ headers: {
1008
+ [name: string]: unknown;
1009
+ };
1010
+ content: {
1011
+ "application/json": components["schemas"]["Error"];
1012
+ };
1013
+ };
1014
+ /** @description Rate limit exceeded */
1015
+ 429: {
1016
+ headers: {
1017
+ [name: string]: unknown;
1018
+ };
1019
+ content: {
1020
+ "application/json": components["schemas"]["Error"];
1021
+ };
1022
+ };
1023
+ };
1024
+ };
1025
+ listBrands: {
1026
+ parameters: {
1027
+ query?: {
1028
+ search?: string;
1029
+ limit?: string;
1030
+ offset?: string;
1031
+ };
1032
+ header?: never;
1033
+ path?: never;
1034
+ cookie?: never;
1035
+ };
1036
+ requestBody?: never;
1037
+ responses: {
1038
+ /** @description Brand list with stats */
1039
+ 200: {
1040
+ headers: {
1041
+ [name: string]: unknown;
1042
+ };
1043
+ content: {
1044
+ "application/json": {
1045
+ brands: components["schemas"]["BrandRegistryItem"][];
1046
+ stats: {
1047
+ total: number;
1048
+ brand_json: number;
1049
+ hosted: number;
1050
+ community: number;
1051
+ enriched: number;
1052
+ };
1053
+ };
1054
+ };
1055
+ };
1056
+ };
1057
+ };
1058
+ enrichBrand: {
1059
+ parameters: {
1060
+ query: {
1061
+ domain: string;
1062
+ };
1063
+ header?: never;
1064
+ path?: never;
1065
+ cookie?: never;
1066
+ };
1067
+ requestBody?: never;
1068
+ responses: {
1069
+ /** @description Enrichment data from Brandfetch */
1070
+ 200: {
1071
+ headers: {
1072
+ [name: string]: unknown;
1073
+ };
1074
+ content: {
1075
+ "application/json": {
1076
+ [key: string]: unknown;
1077
+ };
1078
+ };
1079
+ };
1080
+ /** @description Brandfetch not configured */
1081
+ 503: {
1082
+ headers: {
1083
+ [name: string]: unknown;
1084
+ };
1085
+ content: {
1086
+ "application/json": components["schemas"]["Error"];
1087
+ };
1088
+ };
1089
+ };
1090
+ };
1091
+ resolveProperty: {
1092
+ parameters: {
1093
+ query: {
1094
+ domain: string;
1095
+ };
1096
+ header?: never;
1097
+ path?: never;
1098
+ cookie?: never;
1099
+ };
1100
+ requestBody?: never;
1101
+ responses: {
1102
+ /** @description Property resolved */
1103
+ 200: {
1104
+ headers: {
1105
+ [name: string]: unknown;
1106
+ };
1107
+ content: {
1108
+ "application/json": components["schemas"]["ResolvedProperty"];
1109
+ };
1110
+ };
1111
+ /** @description Property not found */
1112
+ 404: {
1113
+ headers: {
1114
+ [name: string]: unknown;
1115
+ };
1116
+ content: {
1117
+ "application/json": {
1118
+ error: string;
1119
+ domain: string;
1120
+ };
1121
+ };
1122
+ };
1123
+ };
1124
+ };
1125
+ resolvePropertiesBulk: {
1126
+ parameters: {
1127
+ query?: never;
1128
+ header?: never;
1129
+ path?: never;
1130
+ cookie?: never;
1131
+ };
1132
+ requestBody?: {
1133
+ content: {
1134
+ "application/json": {
1135
+ domains: string[];
1136
+ };
1137
+ };
1138
+ };
1139
+ responses: {
1140
+ /** @description Bulk resolution results */
1141
+ 200: {
1142
+ headers: {
1143
+ [name: string]: unknown;
1144
+ };
1145
+ content: {
1146
+ "application/json": {
1147
+ results: {
1148
+ [key: string]: components["schemas"]["ResolvedProperty"] & (Record<string, never> | null);
1149
+ };
1150
+ };
1151
+ };
1152
+ };
1153
+ /** @description Rate limit exceeded */
1154
+ 429: {
1155
+ headers: {
1156
+ [name: string]: unknown;
1157
+ };
1158
+ content: {
1159
+ "application/json": components["schemas"]["Error"];
1160
+ };
1161
+ };
1162
+ };
1163
+ };
1164
+ listProperties: {
1165
+ parameters: {
1166
+ query?: {
1167
+ search?: string;
1168
+ limit?: string;
1169
+ offset?: string;
1170
+ };
1171
+ header?: never;
1172
+ path?: never;
1173
+ cookie?: never;
1174
+ };
1175
+ requestBody?: never;
1176
+ responses: {
1177
+ /** @description Property list with stats */
1178
+ 200: {
1179
+ headers: {
1180
+ [name: string]: unknown;
1181
+ };
1182
+ content: {
1183
+ "application/json": {
1184
+ properties: components["schemas"]["PropertyRegistryItem"][];
1185
+ stats: {
1186
+ [key: string]: unknown;
1187
+ };
1188
+ };
1189
+ };
1190
+ };
1191
+ };
1192
+ };
1193
+ validateProperty: {
1194
+ parameters: {
1195
+ query: {
1196
+ domain: string;
1197
+ };
1198
+ header?: never;
1199
+ path?: never;
1200
+ cookie?: never;
1201
+ };
1202
+ requestBody?: never;
1203
+ responses: {
1204
+ /** @description Validation result */
1205
+ 200: {
1206
+ headers: {
1207
+ [name: string]: unknown;
1208
+ };
1209
+ content: {
1210
+ "application/json": components["schemas"]["ValidationResult"];
1211
+ };
1212
+ };
1213
+ };
1214
+ };
1215
+ saveProperty: {
1216
+ parameters: {
1217
+ query?: never;
1218
+ header?: never;
1219
+ path?: never;
1220
+ cookie?: never;
1221
+ };
1222
+ requestBody?: {
1223
+ content: {
1224
+ "application/json": {
1225
+ /** @example examplepub.com */
1226
+ publisher_domain: string;
1227
+ /**
1228
+ * @example [
1229
+ * {
1230
+ * "url": "https://agent.example.com"
1231
+ * }
1232
+ * ]
1233
+ */
1234
+ authorized_agents: {
1235
+ url: string;
1236
+ authorized_for?: string;
1237
+ }[];
1238
+ /**
1239
+ * @example [
1240
+ * {
1241
+ * "type": "website",
1242
+ * "name": "Example Publisher"
1243
+ * }
1244
+ * ]
1245
+ */
1246
+ properties?: {
1247
+ type: string;
1248
+ name: string;
1249
+ }[];
1250
+ contact?: {
1251
+ name?: string;
1252
+ email?: string;
1253
+ };
1254
+ };
1255
+ };
1256
+ };
1257
+ responses: {
1258
+ /** @description Property saved or updated */
1259
+ 200: {
1260
+ headers: {
1261
+ [name: string]: unknown;
1262
+ };
1263
+ content: {
1264
+ "application/json": {
1265
+ /** @enum {boolean} */
1266
+ success: true;
1267
+ message: string;
1268
+ id: string;
1269
+ revision_number?: number;
1270
+ };
1271
+ };
1272
+ };
1273
+ /** @description Missing required fields or invalid domain */
1274
+ 400: {
1275
+ headers: {
1276
+ [name: string]: unknown;
1277
+ };
1278
+ content: {
1279
+ "application/json": components["schemas"]["Error"];
1280
+ };
1281
+ };
1282
+ /** @description Authentication required */
1283
+ 401: {
1284
+ headers: {
1285
+ [name: string]: unknown;
1286
+ };
1287
+ content: {
1288
+ "application/json": components["schemas"]["Error"];
1289
+ };
1290
+ };
1291
+ /** @description Cannot edit authoritative property */
1292
+ 409: {
1293
+ headers: {
1294
+ [name: string]: unknown;
1295
+ };
1296
+ content: {
1297
+ "application/json": components["schemas"]["Error"];
1298
+ };
1299
+ };
1300
+ /** @description Rate limit exceeded */
1301
+ 429: {
1302
+ headers: {
1303
+ [name: string]: unknown;
1304
+ };
1305
+ content: {
1306
+ "application/json": components["schemas"]["Error"];
1307
+ };
1308
+ };
1309
+ };
1310
+ };
1311
+ listAgents: {
1312
+ parameters: {
1313
+ query?: {
1314
+ type?: "creative" | "signals" | "sales" | "governance" | "si" | "unknown";
1315
+ health?: "true";
1316
+ capabilities?: "true";
1317
+ properties?: "true";
1318
+ };
1319
+ header?: never;
1320
+ path?: never;
1321
+ cookie?: never;
1322
+ };
1323
+ requestBody?: never;
1324
+ responses: {
1325
+ /** @description Agent list */
1326
+ 200: {
1327
+ headers: {
1328
+ [name: string]: unknown;
1329
+ };
1330
+ content: {
1331
+ "application/json": {
1332
+ agents: components["schemas"]["FederatedAgentWithDetails"][];
1333
+ count: number;
1334
+ sources: {
1335
+ registered: number;
1336
+ discovered: number;
1337
+ };
1338
+ };
1339
+ };
1340
+ };
1341
+ };
1342
+ };
1343
+ listPublishers: {
1344
+ parameters: {
1345
+ query?: never;
1346
+ header?: never;
1347
+ path?: never;
1348
+ cookie?: never;
1349
+ };
1350
+ requestBody?: never;
1351
+ responses: {
1352
+ /** @description Publisher list */
1353
+ 200: {
1354
+ headers: {
1355
+ [name: string]: unknown;
1356
+ };
1357
+ content: {
1358
+ "application/json": {
1359
+ publishers: components["schemas"]["FederatedPublisher"][];
1360
+ count: number;
1361
+ sources: {
1362
+ registered: number;
1363
+ discovered: number;
1364
+ };
1365
+ };
1366
+ };
1367
+ };
1368
+ };
1369
+ };
1370
+ getRegistryStats: {
1371
+ parameters: {
1372
+ query?: never;
1373
+ header?: never;
1374
+ path?: never;
1375
+ cookie?: never;
1376
+ };
1377
+ requestBody?: never;
1378
+ responses: {
1379
+ /** @description Registry statistics */
1380
+ 200: {
1381
+ headers: {
1382
+ [name: string]: unknown;
1383
+ };
1384
+ content: {
1385
+ "application/json": {
1386
+ [key: string]: unknown;
1387
+ };
1388
+ };
1389
+ };
1390
+ };
1391
+ };
1392
+ lookupDomain: {
1393
+ parameters: {
1394
+ query?: never;
1395
+ header?: never;
1396
+ path: {
1397
+ domain: string;
1398
+ };
1399
+ cookie?: never;
1400
+ };
1401
+ requestBody?: never;
1402
+ responses: {
1403
+ /** @description Domain lookup result */
1404
+ 200: {
1405
+ headers: {
1406
+ [name: string]: unknown;
1407
+ };
1408
+ content: {
1409
+ "application/json": components["schemas"]["DomainLookupResult"];
1410
+ };
1411
+ };
1412
+ };
1413
+ };
1414
+ lookupProperty: {
1415
+ parameters: {
1416
+ query: {
1417
+ type: string;
1418
+ value: string;
1419
+ };
1420
+ header?: never;
1421
+ path?: never;
1422
+ cookie?: never;
1423
+ };
1424
+ requestBody?: never;
1425
+ responses: {
1426
+ /** @description Matching agents */
1427
+ 200: {
1428
+ headers: {
1429
+ [name: string]: unknown;
1430
+ };
1431
+ content: {
1432
+ "application/json": {
1433
+ type: string;
1434
+ value: string;
1435
+ agents: unknown[];
1436
+ count: number;
1437
+ };
1438
+ };
1439
+ };
1440
+ };
1441
+ };
1442
+ getAgentDomains: {
1443
+ parameters: {
1444
+ query?: never;
1445
+ header?: never;
1446
+ path: {
1447
+ agentUrl: string;
1448
+ };
1449
+ cookie?: never;
1450
+ };
1451
+ requestBody?: never;
1452
+ responses: {
1453
+ /** @description Domains for the agent */
1454
+ 200: {
1455
+ headers: {
1456
+ [name: string]: unknown;
1457
+ };
1458
+ content: {
1459
+ "application/json": {
1460
+ agent_url: string;
1461
+ domains: string[];
1462
+ count: number;
1463
+ };
1464
+ };
1465
+ };
1466
+ };
1467
+ };
1468
+ validateProductAuthorization: {
1469
+ parameters: {
1470
+ query?: never;
1471
+ header?: never;
1472
+ path?: never;
1473
+ cookie?: never;
1474
+ };
1475
+ requestBody?: {
1476
+ content: {
1477
+ "application/json": {
1478
+ agent_url: string;
1479
+ publisher_properties: components["schemas"]["PublisherPropertySelector"][];
1480
+ };
1481
+ };
1482
+ };
1483
+ responses: {
1484
+ /** @description Authorization validation result */
1485
+ 200: {
1486
+ headers: {
1487
+ [name: string]: unknown;
1488
+ };
1489
+ content: {
1490
+ "application/json": {
1491
+ agent_url: string;
1492
+ authorized: boolean;
1493
+ checked_at: string;
1494
+ } & {
1495
+ [key: string]: unknown;
1496
+ };
1497
+ };
1498
+ };
1499
+ };
1500
+ };
1501
+ expandProductIdentifiers: {
1502
+ parameters: {
1503
+ query?: never;
1504
+ header?: never;
1505
+ path?: never;
1506
+ cookie?: never;
1507
+ };
1508
+ requestBody?: {
1509
+ content: {
1510
+ "application/json": {
1511
+ agent_url: string;
1512
+ publisher_properties: components["schemas"]["PublisherPropertySelector"][];
1513
+ };
1514
+ };
1515
+ };
1516
+ responses: {
1517
+ /** @description Expanded identifiers */
1518
+ 200: {
1519
+ headers: {
1520
+ [name: string]: unknown;
1521
+ };
1522
+ content: {
1523
+ "application/json": {
1524
+ agent_url: string;
1525
+ properties: unknown[];
1526
+ identifiers: {
1527
+ type: string;
1528
+ value: string;
1529
+ property_id: string;
1530
+ publisher_domain: string;
1531
+ }[];
1532
+ property_count: number;
1533
+ identifier_count: number;
1534
+ generated_at: string;
1535
+ };
1536
+ };
1537
+ };
1538
+ };
1539
+ };
1540
+ validatePropertyAuthorization: {
1541
+ parameters: {
1542
+ query: {
1543
+ agent_url: string;
1544
+ identifier_type: string;
1545
+ identifier_value: string;
1546
+ };
1547
+ header?: never;
1548
+ path?: never;
1549
+ cookie?: never;
1550
+ };
1551
+ requestBody?: never;
1552
+ responses: {
1553
+ /** @description Authorization result */
1554
+ 200: {
1555
+ headers: {
1556
+ [name: string]: unknown;
1557
+ };
1558
+ content: {
1559
+ "application/json": {
1560
+ agent_url: string;
1561
+ identifier_type: string;
1562
+ identifier_value: string;
1563
+ authorized: boolean;
1564
+ checked_at: string;
1565
+ } & {
1566
+ [key: string]: unknown;
1567
+ };
1568
+ };
1569
+ };
1570
+ };
1571
+ };
1572
+ validateAdagents: {
1573
+ parameters: {
1574
+ query?: never;
1575
+ header?: never;
1576
+ path?: never;
1577
+ cookie?: never;
1578
+ };
1579
+ requestBody?: {
1580
+ content: {
1581
+ "application/json": {
1582
+ domain: string;
1583
+ };
1584
+ };
1585
+ };
1586
+ responses: {
1587
+ /** @description Validation result */
1588
+ 200: {
1589
+ headers: {
1590
+ [name: string]: unknown;
1591
+ };
1592
+ content: {
1593
+ "application/json": {
1594
+ success: boolean;
1595
+ data: {
1596
+ domain: string;
1597
+ found: boolean;
1598
+ validation?: unknown;
1599
+ agent_cards?: unknown;
1600
+ };
1601
+ timestamp: string;
1602
+ };
1603
+ };
1604
+ };
1605
+ };
1606
+ };
1607
+ createAdagents: {
1608
+ parameters: {
1609
+ query?: never;
1610
+ header?: never;
1611
+ path?: never;
1612
+ cookie?: never;
1613
+ };
1614
+ requestBody?: {
1615
+ content: {
1616
+ "application/json": {
1617
+ authorized_agents: {
1618
+ url: string;
1619
+ authorized_for?: string;
1620
+ }[];
1621
+ include_schema?: boolean;
1622
+ include_timestamp?: boolean;
1623
+ properties?: unknown[];
1624
+ };
1625
+ };
1626
+ };
1627
+ responses: {
1628
+ /** @description Generated adagents.json */
1629
+ 200: {
1630
+ headers: {
1631
+ [name: string]: unknown;
1632
+ };
1633
+ content: {
1634
+ "application/json": {
1635
+ success: boolean;
1636
+ data: {
1637
+ success: boolean;
1638
+ adagents_json?: unknown;
1639
+ validation?: unknown;
1640
+ };
1641
+ timestamp: string;
1642
+ };
1643
+ };
1644
+ };
1645
+ };
1646
+ };
1647
+ search: {
1648
+ parameters: {
1649
+ query: {
1650
+ q: string;
1651
+ };
1652
+ header?: never;
1653
+ path?: never;
1654
+ cookie?: never;
1655
+ };
1656
+ requestBody?: never;
1657
+ responses: {
1658
+ /** @description Search results */
1659
+ 200: {
1660
+ headers: {
1661
+ [name: string]: unknown;
1662
+ };
1663
+ content: {
1664
+ "application/json": {
1665
+ brands: unknown[];
1666
+ publishers: unknown[];
1667
+ properties: unknown[];
1668
+ };
1669
+ };
1670
+ };
1671
+ };
1672
+ };
1673
+ lookupManifestRef: {
1674
+ parameters: {
1675
+ query: {
1676
+ domain: string;
1677
+ type?: string;
1678
+ };
1679
+ header?: never;
1680
+ path?: never;
1681
+ cookie?: never;
1682
+ };
1683
+ requestBody?: never;
1684
+ responses: {
1685
+ /** @description Reference lookup result */
1686
+ 200: {
1687
+ headers: {
1688
+ [name: string]: unknown;
1689
+ };
1690
+ content: {
1691
+ "application/json": {
1692
+ /** @enum {boolean} */
1693
+ success: true;
1694
+ /** @enum {boolean} */
1695
+ found: true;
1696
+ reference: {
1697
+ /** @enum {string} */
1698
+ reference_type: "url" | "agent";
1699
+ manifest_url: string | null;
1700
+ agent_url: string | null;
1701
+ agent_id: string | null;
1702
+ /** @enum {string} */
1703
+ verification_status: "pending" | "valid" | "invalid" | "unreachable";
1704
+ };
1705
+ } | {
1706
+ /** @enum {boolean} */
1707
+ success: false;
1708
+ /** @enum {boolean} */
1709
+ found: false;
1710
+ };
1711
+ };
1712
+ };
1713
+ };
1714
+ };
1715
+ discoverAgent: {
1716
+ parameters: {
1717
+ query: {
1718
+ url: string;
1719
+ };
1720
+ header?: never;
1721
+ path?: never;
1722
+ cookie?: never;
1723
+ };
1724
+ requestBody?: never;
1725
+ responses: {
1726
+ /** @description Discovered agent info */
1727
+ 200: {
1728
+ headers: {
1729
+ [name: string]: unknown;
1730
+ };
1731
+ content: {
1732
+ "application/json": {
1733
+ name: string;
1734
+ description?: string;
1735
+ protocols: string[];
1736
+ type: string;
1737
+ stats: {
1738
+ format_count?: number;
1739
+ product_count?: number;
1740
+ publisher_count?: number;
1741
+ };
1742
+ };
1743
+ };
1744
+ };
1745
+ /** @description Connection timeout */
1746
+ 504: {
1747
+ headers: {
1748
+ [name: string]: unknown;
1749
+ };
1750
+ content: {
1751
+ "application/json": {
1752
+ error: string;
1753
+ message: string;
1754
+ };
1755
+ };
1756
+ };
1757
+ };
1758
+ };
1759
+ getAgentFormats: {
1760
+ parameters: {
1761
+ query: {
1762
+ url: string;
1763
+ };
1764
+ header?: never;
1765
+ path?: never;
1766
+ cookie?: never;
1767
+ };
1768
+ requestBody?: never;
1769
+ responses: {
1770
+ /** @description Creative formats */
1771
+ 200: {
1772
+ headers: {
1773
+ [name: string]: unknown;
1774
+ };
1775
+ content: {
1776
+ "application/json": {
1777
+ success: boolean;
1778
+ formats: unknown[];
1779
+ };
1780
+ };
1781
+ };
1782
+ };
1783
+ };
1784
+ getAgentProducts: {
1785
+ parameters: {
1786
+ query: {
1787
+ url: string;
1788
+ };
1789
+ header?: never;
1790
+ path?: never;
1791
+ cookie?: never;
1792
+ };
1793
+ requestBody?: never;
1794
+ responses: {
1795
+ /** @description Products */
1796
+ 200: {
1797
+ headers: {
1798
+ [name: string]: unknown;
1799
+ };
1800
+ content: {
1801
+ "application/json": {
1802
+ success: boolean;
1803
+ products: unknown[];
1804
+ };
1805
+ };
1806
+ };
1807
+ };
1808
+ };
1809
+ validatePublisher: {
1810
+ parameters: {
1811
+ query: {
1812
+ domain: string;
1813
+ };
1814
+ header?: never;
1815
+ path?: never;
1816
+ cookie?: never;
1817
+ };
1818
+ requestBody?: never;
1819
+ responses: {
1820
+ /** @description Publisher validation result */
1821
+ 200: {
1822
+ headers: {
1823
+ [name: string]: unknown;
1824
+ };
1825
+ content: {
1826
+ "application/json": {
1827
+ valid: boolean;
1828
+ domain: string;
1829
+ url?: string;
1830
+ agent_count: number;
1831
+ property_count: number;
1832
+ property_type_counts: {
1833
+ [key: string]: number;
1834
+ };
1835
+ tag_count: number;
1836
+ errors?: string[];
1837
+ warnings?: string[];
1838
+ };
1839
+ };
1840
+ };
1841
+ };
1842
+ };
1843
+ }
1844
+ export type ResolvedBrand = components['schemas']['ResolvedBrand'];
1845
+ export type LocalizedName = components['schemas']['LocalizedName'];
1846
+ export type BrandRegistryItem = components['schemas']['BrandRegistryItem'];
1847
+ export type ResolvedProperty = components['schemas']['ResolvedProperty'];
1848
+ export type PropertyIdentifier = components['schemas']['PropertyIdentifier'];
1849
+ export type PropertyRegistryItem = components['schemas']['PropertyRegistryItem'];
1850
+ export type ValidationResult = components['schemas']['ValidationResult'];
1851
+ export type RegistryError = components['schemas']['Error'];
1852
+ export type PublisherPropertySelector = components['schemas']['PublisherPropertySelector'];
1853
+ export type FederatedAgentWithDetails = components['schemas']['FederatedAgentWithDetails'];
1854
+ export type AgentHealth = components['schemas']['AgentHealth'];
1855
+ export type AgentStats = components['schemas']['AgentStats'];
1856
+ export type AgentCapabilities = components['schemas']['AgentCapabilities'];
1857
+ export type PropertySummary = components['schemas']['PropertySummary'];
1858
+ export type FederatedPublisher = components['schemas']['FederatedPublisher'];
1859
+ export type DomainLookupResult = components['schemas']['DomainLookupResult'];
1860
+ //# sourceMappingURL=types.generated.d.ts.map