v4.0.0

Highlights

• Adds 18 App Store Connect tools across app search keywords, Custom Product Pages, Product Page Optimization, promoted purchases, screenshots, and app previews. The public catalog now contains 490 tools without removing or renaming an existing tool or worker filter.
• Hardens Marketing and review-attachment pagination, parent lineage, response identity, mutation status, upload snapshot, checksum, and recovery validation against App Store Connect API 4.4.1.
• Keeps ambiguous non-idempotent writes unsafe to retry until the exact resource is inspected, and redacts credential-bearing upload URLs while preserving safe recovery identifiers.

Breaking changes

This major release adds exact confirmation parameters to destructive Marketing and review-attachment operations. Existing callers must provide the matching documented confirm parameter, including confirm_page_id, confirm_experiment_id, confirm_promoted_purchase_id, confirm_attachment_id, confirm_set_id, confirm_screenshot_id, or confirm_preview_id as applicable.

PPO experiment state changes also require confirm_experiment_id. Unknown top-level arguments in the affected Marketing and review-attachment tools are now rejected locally instead of being ignored.

Contract coverage

• 464 Apple operations mapped, 436 explicitly deferred, and 363 scoped out: all 1,263 pinned Apple 4.4.1 operations are accounted for without overlap.
• 2,756 optional inputs classified: 1,041 public, 40 internal, 1,675 intentionally omitted, and 0 unclassified.
• Optional-input identity SHA-256: d23f48816b9bc0b19933ae9f65cf4d737918730b1247f8949a802007055bd4a2.

Verification

• Debug and release builds passed with the release-warning gate enabled.
• Strict OpenAPI coverage, generated coverage, operation-manifest, annotated-tag, and release-contract gates passed.
• 1,651 tests in 130 suites passed on develop, main, and the v4.0.0 tag.

See CHANGELOG.md for the complete tool-by-tool migration guidance.