@adcp/sdk 14.0.0-beta.0 → 14.0.0-beta.1

package/dist/lib/schemas-data/3.2.0-beta.0/mcp/2026-07-28/profiles/media-buy/model-context/manifest.json

@@ -0,0 +1,175 @@
+{
+  "mcp_protocol_version": "2026-07-28",
+  "schema_dialect": "https://json-schema.org/draft/2020-12/schema",
+  "source_schema_dialect": "http://json-schema.org/draft-07/schema#",
+  "compatibility": "semantics-preserving projection; no 4.0 strictness rules applied",
+  "delivery": "client-side prompt input projection; servers continue to advertise outputSchema and clients validate with the parent profile",
+  "annotation_mode": "model-context",
+  "schema_fields": [
+    "inputSchema"
+  ],
+  "profile": "media-buy",
+  "profile_kind": "active-role-catalog",
+  "view": "client-prompt-inputs",
+  "surface_version": "3.2.0",
+  "compatibility_scope": "active-3.2-only",
+  "filters": {
+    "include_tools": [
+      "accept_proposal",
+      "buy_products",
+      "control_media_buy",
+      "decline_proposals",
+      "get_account_financials",
+      "get_adcp_capabilities",
+      "get_media_buy_delivery",
+      "get_media_buys",
+      "get_task_status",
+      "list_accounts",
+      "list_creatives",
+      "list_products",
+      "list_tasks",
+      "log_event",
+      "provide_performance_feedback",
+      "refine_proposals",
+      "report_usage",
+      "request_proposals",
+      "sync_accounts",
+      "sync_agent_notification_configs",
+      "sync_audiences",
+      "sync_catalogs",
+      "sync_creatives",
+      "sync_event_sources",
+      "sync_governance"
+    ],
+    "exclude_deprecated": true
+  },
+  "validation_profile": "../manifest.json",
+  "canonical_projection": "../../../manifest.json",
+  "tools": {
+    "accept_proposal": {
+      "protocol": "media-buy",
+      "summary": "Accept a committed proposal to create or amend a media buy, or apply a negotiated cancellation.",
+      "inputSchema": "media-buy/accept-proposal-request.json"
+    },
+    "buy_products": {
+      "protocol": "media-buy",
+      "summary": "Create a media buy directly from published seller products and record its accepted commercial snapshot.",
+      "inputSchema": "media-buy/buy-products-request.json"
+    },
+    "control_media_buy": {
+      "protocol": "media-buy",
+      "summary": "Pause, resume, cancel, or adjust delivery controls without changing accepted commercial terms.",
+      "inputSchema": "media-buy/control-media-buy-request.json"
+    },
+    "decline_proposals": {
+      "protocol": "media-buy",
+      "summary": "Terminally decline one or more proposals and record the buyer's reason.",
+      "inputSchema": "media-buy/decline-proposals-request.json"
+    },
+    "get_account_financials": {
+      "protocol": "account",
+      "summary": "Retrieve spend, credit or balance status, and invoice history for an operator-billed account.",
+      "inputSchema": "account/get-account-financials-request.json"
+    },
+    "get_adcp_capabilities": {
+      "protocol": "protocol",
+      "summary": "Discover the AdCP protocols and feature sets supported by this agent.",
+      "inputSchema": "protocol/get-adcp-capabilities-request.json"
+    },
+    "get_media_buy_delivery": {
+      "protocol": "media-buy",
+      "summary": "Retrieve media-buy delivery metrics with optional date, package, window, attribution, and dimension breakdowns.",
+      "inputSchema": "media-buy/get-media-buy-delivery-request.json"
+    },
+    "get_media_buys": {
+      "protocol": "media-buy",
+      "summary": "List media buys with current status, creative approval state, and optional delivery snapshots.",
+      "inputSchema": "media-buy/get-media-buys-request.json"
+    },
+    "get_task_status": {
+      "protocol": "protocol",
+      "summary": "Retrieve an AdCP asynchronous task, its conversation history, and terminal result by task ID.",
+      "inputSchema": "protocol/get-task-status-request.json"
+    },
+    "list_accounts": {
+      "protocol": "account",
+      "summary": "List accounts accessible to the caller and recover their canonical account references.",
+      "inputSchema": "account/list-accounts-request.json"
+    },
+    "list_creatives": {
+      "protocol": "creative",
+      "summary": "List creative-library assets with filtering, sorting, and pagination.",
+      "inputSchema": "creative/list-creatives-request.json"
+    },
+    "list_products": {
+      "protocol": "media-buy",
+      "summary": "List seller products that match structured discovery criteria.",
+      "inputSchema": "media-buy/list-products-request.json"
+    },
+    "list_tasks": {
+      "protocol": "protocol",
+      "summary": "List and filter AdCP asynchronous tasks for state reconciliation.",
+      "inputSchema": "protocol/list-tasks-request.json"
+    },
+    "log_event": {
+      "protocol": "media-buy",
+      "summary": "Log batches of marketing events against a configured event source for measurement and attribution.",
+      "inputSchema": "media-buy/log-event-request.json"
+    },
+    "provide_performance_feedback": {
+      "protocol": "media-buy",
+      "summary": "Submit an optimizer-ready performance assertion for validation and forwarding to a seller.",
+      "inputSchema": "media-buy/provide-performance-feedback-request.json"
+    },
+    "refine_proposals": {
+      "protocol": "media-buy",
+      "summary": "Revise draft proposals or finalize them into committed, inventory-held snapshots.",
+      "inputSchema": "media-buy/refine-proposals-request.json"
+    },
+    "report_usage": {
+      "protocol": "account",
+      "summary": "Report vendor-service consumption and final measurements for revenue tracking and billing reconciliation.",
+      "inputSchema": "account/report-usage-request.json"
+    },
+    "request_proposals": {
+      "protocol": "media-buy",
+      "summary": "Ask a seller to create one or more draft media-plan proposals from a campaign brief.",
+      "inputSchema": "media-buy/request-proposals-request.json"
+    },
+    "sync_accounts": {
+      "protocol": "account",
+      "summary": "Provision advertiser accounts or update settings for existing accounts through declarative synchronization.",
+      "inputSchema": "account/sync-accounts-request.json"
+    },
+    "sync_agent_notification_configs": {
+      "protocol": "protocol",
+      "summary": "Register, replace, pause, or clear caller-scoped webhooks for agent-level notifications.",
+      "inputSchema": "protocol/sync-agent-notification-configs-request.json"
+    },
+    "sync_audiences": {
+      "protocol": "media-buy",
+      "summary": "List or synchronize account audiences with upsert, member-delta, and optional replacement semantics.",
+      "inputSchema": "media-buy/sync-audiences-request.json"
+    },
+    "sync_catalogs": {
+      "protocol": "media-buy",
+      "summary": "List or synchronize buyer-managed account catalog feeds, suppress or restore specific items, and read current availability state.",
+      "inputSchema": "media-buy/sync-catalogs-request.json"
+    },
+    "sync_creatives": {
+      "protocol": "creative",
+      "summary": "List or synchronize creative assets, scoped updates, and media-buy assignments.",
+      "inputSchema": "creative/sync-creatives-request.json"
+    },
+    "sync_event_sources": {
+      "protocol": "media-buy",
+      "summary": "List or synchronize account event sources with upsert and optional replacement semantics.",
+      "inputSchema": "media-buy/sync-event-sources-request.json"
+    },
+    "sync_governance": {
+      "protocol": "account",
+      "summary": "Bind or replace the governance agent used for approval across specific advertiser accounts.",
+      "inputSchema": "account/sync-governance-request.json"
+    }
+  }
+}

package/dist/lib/schemas-data/3.2.0-beta.0/mcp/2026-07-28/profiles/media-buy/model-context/media-buy/accept-proposal-request.json

@@ -0,0 +1,498 @@
+{
+  "type": "object",
+  "properties": {
+    "adcp_version": {
+      "$ref": "#/$defs/external:core~1version-envelope.json/properties/adcp_version"
+    },
+    "idempotency_key": {
+      "type": "string"
+    },
+    "account": {
+      "$ref": "#/$defs/external:core~1canonical-account-ref.json"
+    },
+    "proposal_id": {
+      "type": "string"
+    },
+    "proposal_terms_digest": {
+      "type": "string"
+    },
+    "total_budget": {
+      "type": "object",
+      "properties": {
+        "amount": {
+          "type": "number"
+        },
+        "currency": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "amount",
+        "currency"
+      ]
+    },
+    "daily_budget_cap": {
+      "type": "number"
+    },
+    "budget_cap_timezone": {
+      "type": "string"
+    },
+    "io_acceptance": {
+      "type": "object",
+      "properties": {
+        "io_id": {
+          "type": "string"
+        },
+        "accepted_at": {
+          "type": "string"
+        },
+        "signatory": {
+          "type": "string"
+        },
+        "signature_id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "io_id",
+        "accepted_at",
+        "signatory"
+      ]
+    },
+    "purchase_order_ref": {
+      "type": "string"
+    },
+    "governance_context": {
+      "type": "string"
+    },
+    "push_notification_config": {
+      "$ref": "#/$defs/external:core~1push-notification-config.json"
+    },
+    "reporting_webhook": {
+      "$ref": "#/$defs/external:core~1reporting-webhook.json"
+    },
+    "opportunity": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/external:core~1opportunity-context.json"
+        },
+        {
+          "properties": {
+            "status": {
+              "const": "closed"
+            }
+          },
+          "if": {
+            "properties": {
+              "status": {
+                "const": "closed"
+              }
+            },
+            "required": [
+              "status"
+            ]
+          },
+          "then": {
+            "properties": {
+              "close_reason": {
+                "const": "accepted_with_seller"
+              }
+            }
+          }
+        }
+      ]
+    },
+    "context": {
+      "$ref": "#/$defs/external:core~1context.json"
+    },
+    "ext": {
+      "$ref": "#/$defs/external:core~1ext.json"
+    }
+  },
+  "required": [
+    "idempotency_key",
+    "account",
+    "proposal_id",
+    "proposal_terms_digest"
+  ],
+  "not": {
+    "anyOf": [
+      {
+        "required": [
+          "packages"
+        ]
+      },
+      {
+        "required": [
+          "purchases"
+        ]
+      },
+      {
+        "required": [
+          "creatives"
+        ]
+      },
+      {
+        "required": [
+          "creative_assignments"
+        ]
+      }
+    ]
+  },
+  "$defs": {
+    "external:core/version-envelope.json": {
+      "type": "object",
+      "properties": {
+        "adcp_version": {
+          "type": "string"
+        },
+        "adcp_major_version": {
+          "type": "integer"
+        }
+      }
+    },
+    "external:core/canonical-account-ref.json": {
+      "type": "object",
+      "anyOf": [
+        {
+          "properties": {
+            "account_id": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "account_id"
+          ]
+        },
+        {
+          "properties": {
+            "brand": {
+              "$ref": "#/$defs/external:core~1brand-key.json"
+            },
+            "operator": {
+              "type": "string"
+            },
+            "operator_unit": {
+              "$ref": "#/$defs/external:core~1operator-unit.json"
+            },
+            "currency": {
+              "type": "string"
+            },
+            "timezone": {
+              "type": "string"
+            },
+            "sandbox": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "brand",
+            "operator"
+          ]
+        }
+      ]
+    },
+    "external:core/brand-key.json": {
+      "type": "object",
+      "properties": {
+        "domain": {
+          "type": "string"
+        },
+        "brand_id": {
+          "$ref": "#/$defs/external:core~1brand-id.json"
+        },
+        "countries": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "domain"
+      ]
+    },
+    "external:core/brand-id.json": {
+      "type": "string"
+    },
+    "external:core/operator-unit.json": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "external:core/push-notification-config.json": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string"
+        },
+        "operation_id": {
+          "type": "string"
+        },
+        "token": {
+          "type": "string"
+        },
+        "authentication": {
+          "type": "object",
+          "properties": {
+            "schemes": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/external:enums~1auth-scheme.json"
+              }
+            },
+            "credentials": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "schemes",
+            "credentials"
+          ]
+        }
+      },
+      "required": [
+        "url"
+      ]
+    },
+    "external:enums/auth-scheme.json": {
+      "type": "string",
+      "enum": [
+        "Bearer",
+        "HMAC-SHA256"
+      ]
+    },
+    "external:core/reporting-webhook.json": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string"
+        },
+        "token": {
+          "type": "string"
+        },
+        "authentication": {
+          "type": "object",
+          "properties": {
+            "schemes": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/external:enums~1auth-scheme.json"
+              }
+            },
+            "credentials": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "schemes",
+            "credentials"
+          ]
+        },
+        "reporting_frequency": {
+          "type": "string",
+          "enum": [
+            "hourly",
+            "daily",
+            "monthly"
+          ]
+        },
+        "requested_metrics": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/external:enums~1available-metric.json"
+          }
+        }
+      },
+      "required": [
+        "url",
+        "authentication",
+        "reporting_frequency"
+      ],
+      "additionalProperties": true
+    },
+    "external:enums/available-metric.json": {
+      "type": "string",
+      "enum": [
+        "impressions",
+        "spend",
+        "clicks",
+        "ctr",
+        "views",
+        "completed_views",
+        "completion_rate",
+        "conversions",
+        "conversion_value",
+        "commissionable_value",
+        "roas",
+        "cost_per_acquisition",
+        "new_to_brand_rate",
+        "leads",
+        "reach",
+        "frequency",
+        "grps",
+        "engagements",
+        "engagement_rate",
+        "follows",
+        "saves",
+        "profile_visits",
+        "viewability",
+        "quartile_data",
+        "dooh_metrics",
+        "cost_per_click",
+        "cost_per_completed_view",
+        "cpm",
+        "downloads",
+        "units_sold",
+        "new_to_brand_units",
+        "plays",
+        "incremental_sales_lift",
+        "brand_lift",
+        "foot_traffic",
+        "conversion_lift",
+        "brand_search_lift"
+      ]
+    },
+    "external:core/opportunity-context.json": {
+      "type": "object",
+      "properties": {
+        "opportunity_id": {
+          "type": "string"
+        },
+        "phase": {
+          "type": "string",
+          "enum": [
+            "exploratory",
+            "planning",
+            "active_sourcing"
+          ]
+        },
+        "intent": {
+          "type": "string",
+          "enum": [
+            "test",
+            "speculative",
+            "planning",
+            "live_rfp"
+          ]
+        },
+        "planning_horizon": {
+          "$ref": "#/$defs/external:core~1date-range.json"
+        },
+        "response_deadline": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "open",
+            "closed"
+          ]
+        },
+        "close_reason": {
+          "type": "string",
+          "enum": [
+            "accepted_with_seller",
+            "purchased_elsewhere",
+            "selected_alternative",
+            "not_pursued",
+            "budget_changed",
+            "timing_changed",
+            "other"
+          ]
+        },
+        "close_detail": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "opportunity_id"
+      ],
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "status": {
+                "const": "closed"
+              }
+            },
+            "required": [
+              "status"
+            ]
+          },
+          "then": {
+            "required": [
+              "close_reason"
+            ]
+          },
+          "else": {
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "close_reason"
+                  ]
+                },
+                {
+                  "required": [
+                    "close_detail"
+                  ]
+                }
+              ]
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "close_reason": {
+                "const": "other"
+              }
+            },
+            "required": [
+              "close_reason"
+            ]
+          },
+          "then": {
+            "required": [
+              "close_detail"
+            ]
+          }
+        }
+      ]
+    },
+    "external:core/date-range.json": {
+      "type": "object",
+      "properties": {
+        "start": {
+          "type": "string"
+        },
+        "end": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "start",
+        "end"
+      ],
+      "additionalProperties": true
+    },
+    "external:core/context.json": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "external:core/ext.json": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  }
+}