Skip to content

spec: extend three-shape submitted-envelope pattern to other sync_* operations #2435

@bokelley

Description

@bokelley

Raised during PR #2434 review (ad-tech-protocol-expert #6, adtech-product-expert #2, dx-expert): if `sync_creatives` gets a top-level `SyncCreativesSubmitted` envelope for operation-level async, we should audit whether the sibling batch mutations warrant the same shape:

  • `sync_accounts` — already has per-item `action` + `status`; question is whether operation-level async (governance review gating the whole sync) is a real scenario.
  • `sync_audiences` — audience matching is classically async (capabilities already declares `audience_targeting.matching_latency_hours`); batch ingestion that can't return per-item results synchronously seems plausible.
  • `sync_event_sources` — same question.
  • `activate_signal` — currently two-shape, explicitly atomic. Flag for 4.0 if async signal activation becomes real.

Decision needed: either (a) extend the envelope pattern across sync_* to maintain symmetry, or (b) confirm and document why only sync_creatives warrants it, so the asymmetry is deliberate rather than an oversight.

Preferred path: do a short design pass with SDK implementers before extending, to avoid locking in a pattern in batches where no seller actually needs operation-level async.

Follow-up to #2428 / PR #2434.

Metadata

Metadata

Assignees

No one assigned

    Labels

    claude-triagedIssue has been triaged by the Claude Code triage routine. Remove to re-triage.rfcProtocol change — auto-adds to roadmap board

    Type

    No type

    Projects

    Status

    No status

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions