feat(v3-ref-seller): broaden sales surface + sync_accounts + invoice_recipient

[bokelley]

Summary

Lifts the v3 reference seller from the five required sales methods to the full v6.0 rc.1 surface for a sales-non-guaranteed seller, and wires the account ops that exercise the 3.1-readiness billing_entity.bank projection guard.

Closes #376, #377, #378.

• feat(v3-ref-seller): implement 4 spec-required sales-* methods (get_media_buys, provide_performance_feedback, list_creative_formats, list_creatives) #376 — Adds the four optional Sales Protocol methods every sales-* specialism is required to expose in v6.0 rc.1+:

  • get_media_buys — list buys for the resolved account, limit/offset paged, scoped to (tenant_id, account_id). Echoes invoice_recipient projected through project_business_entity_for_response so bank never leaks.
  • provide_performance_feedback — persists buyer-supplied performance signals to a new performance_feedback table FK'd to media_buys. Rejects with MEDIA_BUY_NOT_FOUND if the wire id doesn't resolve under this tenant.
  • list_creative_formats — static catalog (300x250 display, 728x90 leaderboard, video 16:9 30s).
  • list_creatives — sourced from a new creatives table populated by sync_creatives.
  • sync_creatives previously returned [] without persisting anything; it now upserts on (tenant_id, creative_id) and echoes per-row action (created/updated).

• feat(v3-ref-seller): implement sync_accounts + list_accounts with billing_entity write-only projection guard wired #377 — sync_accounts and list_accounts:

  • sync_accounts upserts under the authenticated buyer agent. Persists the full BusinessEntity payload (bank details included) on billing_entity JSON column — the durable invoicing record. The response payload echoes the entity through project_business_entity_for_response so bank details never leak on the wire.
  • list_accounts runs every account through adcp.decisioning.project_account_for_response before serialization. This is the headline 3.1-readiness claim — bank details cannot leak even when adopters persist them for invoicing.

• feat(v3-ref-seller): MediaBuy.invoice_recipient first-class column (3.1 readiness) #378 — MediaBuy.invoice_recipient first-class column:

  • New Mapped[dict | None] = mapped_column(JSON, nullable=True) column on the MediaBuy model.
  • create_media_buy extracts req.invoice_recipient (a BusinessEntity | None) and persists it.
  • update_media_buy patches it for per-buy invoice override semantics (3.1 setup).

Models added

• Creative (account-scoped, manifest_json blob, unique on (tenant_id, creative_id))
• PerformanceFeedback (FK'd to media_buys, JSON value carrying full request payload)

Other changes

• seed.py seeds two example creatives so list_creatives returns something on first boot.

Framework-level changes

None required — every wire type used (GetMediaBuysResponse, ListAccountsResponse, SyncAccountsSuccessResponse, ListCreativeFormatsResponse, ListCreativesResponse, ProvidePerformanceFeedbackSuccessResponse) is already exported from adcp.types. The projection helpers project_account_for_response / project_business_entity_for_response are already exported from adcp.decisioning.

Test plan

• ruff check src/ examples/v3_reference_seller/ passes
• mypy src/adcp/ passes (in the project venv)
• pytest examples/v3_reference_seller/tests/ -v — 13/13 passing (7 existing + 6 new in test_smoke_broadening.py)
• pytest tests/ -q — 3200 passed, 21 skipped, 1 xfailed (full SDK suite, no regressions)
• All 9 sales methods + sync_accounts / list_accounts callable on V3ReferenceSeller
• list_accounts projection strips billing_entity.bank on every response (direct projection assertion + end-to-end mocked-session test)
• MediaBuy.invoice_recipient populates from CreateMediaBuyRequest
• Creative round-trip through sync_creatives → list_creatives

🤖 Generated with Claude Code