feat: enforce strict FormatID typing and remove deprecated fields

[bokelley]

Summary

This PR enforces strict FormatID typing throughout the codebase and removes support for deprecated fields per AdCP spec v2.0.0.

Breaking Changes

🔒 Strict FormatID Typing

All format ID fields now use the structured FormatID type with agent_url and id properties. No more plain string format IDs.

Before:

format_id: "banner_300x250"

After:

format_id: {
  agent_url: "https://creatives.adcontextprotocol.org",
  id: "banner_300x250"
}

Affected fields:

• format_id
• format_ids
• output_format_ids
• formats_to_provide
• format_ids_to_provide

🗑️ Deprecated Field Removal

Per AdCP PR #126:

Deprecated Field	Replacement	Status
promoted_offering	brand_manifest	✅ Migrated
products[] (in packages)	product_id	✅ Not used
video_completions	completed_views	✅ Not used

Changes Made

Type System

• ✅ Import structured FormatID from generated types
• ✅ Update CreativeFormat to use FormatID
• ✅ Update CreativeFilters to use FormatID | FormatID[]
• ✅ Convert hardcoded format IDs to structured objects
• ✅ Remove stale /src/types/adcp.ts file
• ✅ Export FormatID from main types index

API & Server

• ✅ Replace promoted_offering with brand_manifest in all endpoints
• ✅ Update buildToolArgs() to send brand_manifest
• ✅ Update API request/response types
• ✅ Fix import paths after removing stale types

UI

• ✅ Update HTML to use brand_manifest instead of promoted_offering
• ✅ Rename JavaScript variables: promotedOffering → brandManifest

Generated Types

• ✅ Synced with AdCP spec v2.0.0
• ✅ Clean type generation (no post-processing hacks needed)
• ✅ All format IDs properly typed as FormatID

Verification

✅ Type Safety

npm run build
# ✅ Passes with no errors
# ✅ All format IDs strictly typed

✅ Schema Compliance

• Updated schemas from https://adcontextprotocol.org/schemas/v1/
• All format_id fields use $ref: "/schemas/v1/core/format-id.json"
• No string format IDs remain in schemas

✅ No Deprecated Fields Sent

Client now sends:

• ✅ brand_manifest (not promoted_offering)
• ✅ product_id (not products[])
• ✅ completed_views (not video_completions)

Migration Guide

If you're using this client library:

Format IDs

Update any code that creates format IDs:

// Before
const formatId = "banner_300x250";

// After  
const formatId: FormatID = {
  agent_url: "https://creatives.adcontextprotocol.org",
  id: "banner_300x250"
};

Test Requests

Update test request parameters:

// Before
const request: TestRequest = {
  agents: [...],
  brief: "...",
  promoted_offering: "..."  // ❌ Deprecated
};

// After
const request: TestRequest = {
  agents: [...],
  brief: "...",
  brand_manifest: "..."  // ✅ Use this
};

Related

• AdCP Spec: https://adcontextprotocol.org/
• Deprecated Fields PR: Remove deprecated and fallback fields adcp#126

🤖 Generated with Claude Code