feat(registry): expose requestManagerRevalidation on RegistryClient

[bokelley]

Gap

The registry exposes a manager-revalidation operation at POST /api/registry/manager-revalidation-request — it re-validates every publisher delegating to a manager domain via the ads.txt MANAGERDOMAIN one-hop (the right tool after a manager rotates its adagents.json). It's present in the generated OpenAPI types, but RegistryClient does not expose a typed method for it in @adcp/sdk@9.1.0 — the only typed crawl/freshness primitives are requestCrawl(domain) and getFeed(). To trigger a manager-wide revalidation today, a consumer has to call the REST path directly, bypassing the typed client.

Ask

Add RegistryClient.requestManagerRevalidation(managerDomain: string) mirroring requestCrawl, returning the 202 enqueued-count response. This gives parity with the REST surface and a typed way to refresh all publishers under a manager (e.g. a CafeMedia/Raptive-style network) in one call instead of N per-domain requestCrawls.

Context: we're building publisher-identity refresh in a reference implementation (Scope3 / Interchange) and need manager-level revalidation as part of an SLA-driven freshness loop; per-domain requestCrawl doesn't scale to large managed networks.

[bokelley]

Triage

Classification: Feature request
Bucket(s): library
Status: ready-to-implement

What the experts said:

• code-reviewer: faithful mirror of requestCrawl, pure addition; needs TSDoc covering the shared rate-limit bucket and the publishers_enqueued: 0 no-op case
• dx-expert: naming is fine as-is; doc should explicitly disambiguate from requestCrawl (manager domain vs. own domain) and call out that zero enqueued means "no delegates configured," not an error

My take: Endpoint is already spec'd and codegen'd (types.generated.ts:6091, registry.yaml:7098) — this just wraps an existing gap in the client surface, low-risk, but needs the disambiguation and rate-limit TSDoc both experts flagged.

• Add requestManagerRevalidation(managerDomain: string): Promise<ManagerRevalidationResponse> to RegistryClient (index.ts, after requestCrawl ~line 1047), mirroring its guard-clause order and POST pattern
• Export ManagerRevalidationResponse type alongside CrawlRequestResponse in types.ts/index.ts
• TSDoc: note shared 30/hr rate-limit bucket with requestCrawl, and that publishers_enqueued: 0 means no delegating publishers, not an error
• Tests: success/202, missing apiKey, empty managerDomain throws, error-status path, assert POST body key is manager_domain

---

Triaged by Claude Code. Session: https://claude.ai/code/session_01Ar2T9nEB6S7NG5N6SJoZmm

---

Generated by Claude Code

[bokelley]

Triage

Classification: Feature request
Bucket(s): library
Status: ready-to-implement

What the experts said:

• code-reviewer: Safe, additive, non-breaking — mirror requestCrawl's guard pattern; add test parity (success/no-key/empty-domain/429) plus a new 400 case; keep the new type alias in the generator script, not the generated file.
• dx-expert: Keep requestManagerRevalidation(managerDomain: string) positional, matching requestCrawl's shape — just document the shared rate-limit bucket and that publishers_enqueued: 0 isn't an error.

My take: Clean, well-scoped parity gap with a real reference implementation (Scope3/Interchange) already blocked on it. Both experts converge on shipping as proposed with doc clarifications.

• Add RegistryClient.requestManagerRevalidation(managerDomain: string): Promise<ManagerRevalidationResponse> in src/lib/registry/index.ts, mirroring requestCrawl's guards, POSTing { manager_domain: managerDomain } to /api/registry/manager-revalidation-request.
• Add ManagerRevalidationResponse in scripts/generate-registry-types.ts (next to CrawlRequestResponse), then npm run generate-registry-types — never hand-edit types.generated.ts.
• Tests in test/lib/registry.test.js mirroring requestCrawl's cases + a 400 case.
• Non-breaking (new method + new type only); needs a minor changeset.

---

Triaged by Claude Code. Session: https://claude.ai/code/session_01KHTti2NdVPxToevT2rxSPb

---

Generated by Claude Code