@omnixhq/ucp-js-sdk 1.1.0 → 2.0.0

package/dist/index.cjs

@@ -30,56 +30,124 @@ const CapabilityBaseSchema = zod.intersection(zod.object({
 	"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 	"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 	"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() }));
+}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+	const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+	const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+	const passed = schemas.length - errors.length;
+	if (passed !== 1) ctx.addIssue(errors.length ? {
+		path: ctx.path,
+		code: "invalid_union",
+		unionErrors: errors,
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	} : {
+		path: ctx.path,
+		code: "custom",
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	});
+}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() }));
 const CapabilityPlatformSchema = zod.intersection(zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 	"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 	"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 	"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })), zod.record(zod.string(), zod.unknown())).describe("Full capability declaration for platform-level discovery. Includes spec/schema URLs for agent fetching.");
+}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+	const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+	const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+	const passed = schemas.length - errors.length;
+	if (passed !== 1) ctx.addIssue(errors.length ? {
+		path: ctx.path,
+		code: "invalid_union",
+		unionErrors: errors,
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	} : {
+		path: ctx.path,
+		code: "custom",
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	});
+}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })), zod.record(zod.string(), zod.unknown())).describe("Full capability declaration for platform-level discovery. Includes spec/schema URLs for agent fetching.");
 const CapabilityBusinessSchema = zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 	"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 	"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 	"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })).describe("Capability configuration for business/merchant level. May include business-specific config overrides.");
+}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+	const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+	const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+	const passed = schemas.length - errors.length;
+	if (passed !== 1) ctx.addIssue(errors.length ? {
+		path: ctx.path,
+		code: "invalid_union",
+		unionErrors: errors,
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	} : {
+		path: ctx.path,
+		code: "custom",
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	});
+}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })).describe("Capability configuration for business/merchant level. May include business-specific config overrides.");
 const CapabilityResponseSchema = zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 	"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 	"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 	"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities.");
+}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+	const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+	const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+	const passed = schemas.length - errors.length;
+	if (passed !== 1) ctx.addIssue(errors.length ? {
+		path: ctx.path,
+		code: "invalid_union",
+		unionErrors: errors,
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	} : {
+		path: ctx.path,
+		code: "custom",
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	});
+}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities.");
 const PaymentHandlerBaseSchema = zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 	"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 	"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 	"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown()));
+}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+	"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+	"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() })));
 const PaymentHandlerPlatformSchema = zod.intersection(zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 	"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 	"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 	"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())), zod.record(zod.string(), zod.unknown())).describe("Platform declaration for discovery profiles. May include partial config state required for discovery.");
+}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+	"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+	"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))), zod.record(zod.string(), zod.unknown())).describe("Platform declaration for discovery profiles. May include partial config state required for discovery.");
 const PaymentHandlerBusinessSchema = zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 	"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 	"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 	"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())).describe("Business declaration for discovery profiles. May include partial config state required for discovery.");
+}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+	"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+	"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))).describe("Business declaration for discovery profiles. May include partial config state required for discovery.");
 const PaymentHandlerResponseSchema = zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 	"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 	"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 	"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())).describe("Handler reference in responses. May include full config state for runtime usage of the handler.");
+}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+	"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+	"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))).describe("Handler reference in responses. May include full config state for runtime usage of the handler.");
 const ServiceBaseSchema = zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -114,7 +182,7 @@ const ServicePlatformSchema = zod.intersection(zod.intersection(zod.object({
 	zod.object({ "transport": zod.literal("mcp").optional() }),
 	zod.object({ "transport": zod.literal("a2a").optional() }),
 	zod.object({ "transport": zod.literal("embedded").optional() })
-]))).describe("Full service declaration for platform-level discovery. Different transports require different fields.");
+]))).describe("Full service declaration for platform-level discovery. All transports require `version`, `spec`, and `transport`. REST and MCP additionally require `schema` and `endpoint`; A2A requires `endpoint`; embedded requires `schema`.");
 const ServiceBusinessSchema = zod.intersection(zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -135,7 +203,10 @@ const ServiceBusinessSchema = zod.intersection(zod.intersection(zod.object({
 	zod.object({ "transport": zod.literal("a2a").optional() }),
 	zod.object({
 		"transport": zod.literal("embedded").optional(),
-		"config": zod.object({ "delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In checkout responses, confirms accepted delegations for this session.").optional() }).describe("Per-checkout configuration for embedded transport binding. Allows businesses to vary ECP availability and delegations based on cart contents, agent authorization, or policy.").optional()
+		"config": zod.object({
+			"delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In UCP responses, confirms accepted delegations for this session.").optional(),
+			"color_scheme": zod.array(zod.enum(["light", "dark"])).describe("Color schemes the business supports. Hosts use ec_color_scheme query parameter to request a scheme from this list.").optional()
+		}).describe("Per-session configuration for embedded transport binding. Allows businesses to vary EP availability and delegations based on cart contents, agent authorization, or policy.").optional()
 	})
 ])).describe("Service binding for business/merchant configuration. May override platform endpoints.");
 const ServiceResponseSchema = zod.intersection(zod.intersection(zod.object({
@@ -158,7 +229,10 @@ const ServiceResponseSchema = zod.intersection(zod.intersection(zod.object({
 	zod.object({ "transport": zod.literal("a2a").optional() }),
 	zod.object({
 		"transport": zod.literal("embedded").optional(),
-		"config": zod.object({ "delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In checkout responses, confirms accepted delegations for this session.").optional() }).describe("Per-checkout configuration for embedded transport binding. Allows businesses to vary ECP availability and delegations based on cart contents, agent authorization, or policy.").optional()
+		"config": zod.object({
+			"delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In UCP responses, confirms accepted delegations for this session.").optional(),
+			"color_scheme": zod.array(zod.enum(["light", "dark"])).describe("Color schemes the business supports. Hosts use ec_color_scheme query parameter to request a scheme from this list.").optional()
+		}).describe("Per-session configuration for embedded transport binding. Allows businesses to vary EP availability and delegations based on cart contents, agent authorization, or policy.").optional()
 	})
 ])).describe("Service binding in API responses. Includes per-resource transport configuration via typed config.");
 const Ap2MandateMerchantAuthorizationSchema = zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Za-z0-9_-]+\\.\\.[A-Za-z0-9_-]+$")).describe("JWS Detached Content signature (RFC 7515 Appendix F) over the checkout response body (excluding ap2 field). Format: `<base64url-header>..<base64url-signature>`. The header MUST contain 'alg' (ES256/ES384/ES512) and 'kid' claims. The signature covers both the header and JCS-canonicalized checkout payload.");
@@ -191,9 +265,257 @@ const BuyerConsentBuyerSchema = zod.intersection(zod.object({
 	"marketing": zod.boolean().describe("Consent for marketing communications.").optional(),
 	"sale_of_data": zod.boolean().describe("Consent for selling data to third parties (CCPA).").optional()
 }).describe("Consent tracking fields.").optional() })).describe("Buyer object extended with consent tracking.");
+const CartSchema = zod.object({
+	"ucp": zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+		"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
+		"services": zod.record(zod.array(zod.intersection(zod.object({
+			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+		}).describe("Shared foundation for all UCP entities."), zod.object({
+			"transport": zod.enum([
+				"rest",
+				"mcp",
+				"a2a",
+				"embedded"
+			]).describe("Transport protocol for this service binding."),
+			"endpoint": zod.string().url().describe("Endpoint URL for this transport binding.").optional()
+		})))).describe("Service registry keyed by reverse-domain name.").optional(),
+		"capabilities": zod.record(zod.array(zod.intersection(zod.object({
+			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+			const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+			const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+			const passed = schemas.length - errors.length;
+			if (passed !== 1) ctx.addIssue(errors.length ? {
+				path: ctx.path,
+				code: "invalid_union",
+				unionErrors: errors,
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			} : {
+				path: ctx.path,
+				code: "custom",
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			});
+		}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+		"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
+			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+		}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+			"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+			"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+		}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+	}).describe("Base UCP metadata with shared properties for all schema types."), zod.object({ "capabilities": zod.record(zod.array(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities."))).optional() })).describe("UCP metadata for cart responses. No payment handlers needed pre-checkout."),
+	"id": zod.string().describe("Unique cart identifier."),
+	"line_items": zod.array(zod.object({
+		"id": zod.string(),
+		"item": zod.object({
+			"id": zod.string().describe("The product identifier, often the SKU, required to resolve the product details associated with this line item. Should be recognized by both the Platform, and the Business."),
+			"title": zod.string().describe("Product title."),
+			"price": zod.number().int().gte(0).describe("Unit price in ISO 4217 minor units."),
+			"image_url": zod.string().url().describe("Product image URI.").optional()
+		}),
+		"quantity": zod.number().int().gte(1).describe("Quantity of the item being purchased."),
+		"totals": zod.array(zod.object({
+			"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
+			"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
+			"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+		}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Line item totals breakdown."),
+		"parent_id": zod.string().describe("Parent line item identifier for any nested structures.").optional()
+	}).describe("Line item object. Expected to use the currency of the parent object.")).describe("Cart line items. Same structure as checkout. Full replacement on update."),
+	"context": zod.object({
+		"address_country": zod.string().describe("The country. Recommended to be in 2-letter ISO 3166-1 alpha-2 format, for example \"US\". For backward compatibility, a 3-letter ISO 3166-1 alpha-3 country code such as \"SGP\" or a full country name such as \"Singapore\" can also be used. Optional hint for market context (currency, availability, pricing)—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+		"address_region": zod.string().describe("The region in which the locality is, and which is in the country. For example, California or another appropriate first-level Administrative division. Optional hint for progressive localization—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+		"postal_code": zod.string().describe("The postal code. For example, 94043. Optional hint for regional refinement—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+		"intent": zod.string().describe("Background context describing buyer's intent (e.g., 'looking for a gift under $50', 'need something durable for outdoor use'). Informs relevance, recommendations, and personalization.").optional(),
+		"language": zod.string().describe("Preferred language for content. Use IETF BCP 47 language tags (e.g., 'en', 'fr-CA', 'zh-Hans'). For REST, equivalent to Accept-Language header—platforms SHOULD fall back to Accept-Language when this field is absent; when provided, overrides Accept-Language. Businesses MAY return content in a different language if unavailable.").optional(),
+		"currency": zod.string().describe("Preferred currency (ISO 4217, e.g., 'EUR', 'USD'). Businesses determine presentment currency from context and authoritative signals; this hint MAY inform selection in multi-currency markets. Also serves as the denomination for price filter values — platforms SHOULD include this field when sending price filters. Response prices include explicit currency confirming the resolution.").optional(),
+		"eligibility": zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Reverse-domain identifier used for collision-safe namespacing of capabilities, services, handlers, eligibility claims, and extension-contributed keys. Must contain at least two dot-separated segments (e.g., 'dev.ucp.shopping.checkout', 'com.example.loyalty_gold').")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Buyer claims about eligible benefits such as loyalty membership, payment instrument perks, and similar. Recognized claims MAY inform the Business response (e.g., member-only product availability, adjusted pricing in catalog, provisional discounts at cart or checkout). Businesses MUST ignore unrecognized values without error. Values MUST use reverse-domain naming (e.g., 'com.example.loyalty_gold', 'org.school.student') and MUST be non-identifying.").optional()
+	}).passthrough().describe("Buyer signals for localization (country, region, postal_code). Merchant uses for pricing, availability, currency. Falls back to geo-IP if omitted.").optional(),
+	"signals": zod.object({
+		"dev.ucp.buyer_ip": zod.string().describe("Client's IP address (IPv4 or IPv6).").optional(),
+		"dev.ucp.user_agent": zod.string().describe("Client's HTTP User-Agent header or equivalent.").optional()
+	}).passthrough().describe("Environment data provided by the platform to support authorization and abuse prevention. Values MUST NOT be buyer-asserted claims — platforms provide signals based on direct observation or independently verifiable third-party attestations. All signal keys MUST use reverse-domain naming to ensure provenance and prevent collisions when multiple extensions contribute to the shared namespace.").optional(),
+	"buyer": zod.object({
+		"first_name": zod.string().describe("First name of the buyer.").optional(),
+		"last_name": zod.string().describe("Last name of the buyer.").optional(),
+		"email": zod.string().describe("Email of the buyer.").optional(),
+		"phone_number": zod.string().describe("E.164 standard.").optional()
+	}).passthrough().describe("Optional buyer information for personalized estimates.").optional(),
+	"currency": zod.string().describe("ISO 4217 currency code. Determined by merchant based on context or geo-IP."),
+	"totals": zod.array(zod.intersection(zod.object({
+		"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
+		"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
+		"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+	}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text."), zod.intersection(zod.object({ "lines": zod.array(zod.object({
+		"display_text": zod.string().describe("Human-readable label for this sub-line."),
+		"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+	}).describe("Sub-line entry. Additional metadata MAY be included.")).describe("Optional itemized breakdown. The parent entry is always rendered; lines are supplementary. Sum of line amounts MUST equal the parent entry amount.").optional() }), zod.any()))).describe("Estimated cost breakdown. May be partial if shipping/tax not yet calculable."),
+	"messages": zod.array(zod.record(zod.string(), zod.unknown()).and(zod.unknown().superRefine((x, ctx) => {
+		const schemas = [
+			zod.object({
+				"type": zod.literal("error").describe("Message type discriminator."),
+				"code": zod.string().describe("Error code identifying the type of error. Standard errors are defined in specification (see examples), and have standardized semantics; freeform codes are permitted."),
+				"path": zod.string().describe("RFC 9535 JSONPath to the component the message refers to (e.g., $.items[1]).").optional(),
+				"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
+				"content": zod.string().describe("Human-readable message."),
+				"severity": zod.enum([
+					"recoverable",
+					"requires_buyer_input",
+					"requires_buyer_review",
+					"unrecoverable"
+				]).describe("Reflects the resource state and recommended action. 'recoverable': platform can resolve by modifying inputs and retrying via API. 'requires_buyer_input': merchant requires information their API doesn't support collecting programmatically (checkout incomplete). 'requires_buyer_review': buyer must authorize before order placement due to policy, regulatory, or entitlement rules. 'unrecoverable': no valid resource exists to act on, retry with new resource or inputs. Errors with 'requires_*' severity contribute to 'status: requires_escalation'.")
+			}),
+			zod.object({
+				"type": zod.literal("warning").describe("Message type discriminator."),
+				"path": zod.string().describe("JSONPath (RFC 9535) to related field (e.g., $.line_items[0]).").optional(),
+				"code": zod.string().describe("Warning code. Machine-readable identifier for the warning type (e.g., final_sale, prop65, fulfillment_changed, age_restricted, etc.)."),
+				"content": zod.string().describe("Human-readable warning message that MUST be displayed."),
+				"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
+				"presentation": zod.string().describe("Rendering contract for this warning. 'notice' (default): platform MUST display, MAY dismiss. 'disclosure': platform MUST display in proximity to the path-referenced component, MUST NOT hide or auto-dismiss. See specification for full contract.").default("notice"),
+				"image_url": zod.string().url().describe("URL to a required visual element (e.g., warning symbol, energy class label).").optional(),
+				"url": zod.string().url().describe("Reference URL for more information (e.g., regulatory site, registry entry, policy page).").optional()
+			}),
+			zod.object({
+				"type": zod.literal("info").describe("Message type discriminator."),
+				"path": zod.string().describe("RFC 9535 JSONPath to the component the message refers to.").optional(),
+				"code": zod.string().describe("Info code for programmatic handling.").optional(),
+				"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
+				"content": zod.string().describe("Human-readable message.")
+			})
+		];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	})).describe("Container for error, warning, or info messages.")).describe("Validation messages, warnings, or informational notices.").optional(),
+	"links": zod.array(zod.object({
+		"type": zod.string().describe("Type of link. Well-known values: `privacy_policy`, `terms_of_service`, `refund_policy`, `shipping_policy`, `faq`. Consumers SHOULD handle unknown values gracefully by displaying them using the `title` field or omitting the link."),
+		"url": zod.string().url().describe("The actual URL pointing to the content to be displayed."),
+		"title": zod.string().describe("Optional display text for the link. When provided, use this instead of generating from type.").optional()
+	})).describe("Optional merchant links (policies, FAQs).").optional(),
+	"continue_url": zod.string().url().describe("URL for cart handoff and session recovery. Enables sharing and human-in-the-loop flows.").optional(),
+	"expires_at": zod.string().datetime({ offset: true }).describe("Cart expiry timestamp (RFC 3339). Optional.").optional()
+}).passthrough().describe("Shopping cart with estimated pricing before checkout. Lightweight pre-purchase exploration with no payment info or complex status states.");
+const CartCreateRequestSchema = zod.object({
+	"line_items": zod.array(zod.object({
+		"id": zod.string(),
+		"item": zod.object({
+			"id": zod.string().describe("The product identifier, often the SKU, required to resolve the product details associated with this line item. Should be recognized by both the Platform, and the Business."),
+			"title": zod.string().describe("Product title."),
+			"price": zod.number().int().gte(0).describe("Unit price in ISO 4217 minor units."),
+			"image_url": zod.string().url().describe("Product image URI.").optional()
+		}),
+		"quantity": zod.number().int().gte(1).describe("Quantity of the item being purchased."),
+		"totals": zod.array(zod.object({
+			"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
+			"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
+			"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+		}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Line item totals breakdown."),
+		"parent_id": zod.string().describe("Parent line item identifier for any nested structures.").optional()
+	}).describe("Line item object. Expected to use the currency of the parent object.")).describe("Cart line items. Same structure as checkout. Full replacement on update."),
+	"context": zod.object({
+		"address_country": zod.string().describe("The country. Recommended to be in 2-letter ISO 3166-1 alpha-2 format, for example \"US\". For backward compatibility, a 3-letter ISO 3166-1 alpha-3 country code such as \"SGP\" or a full country name such as \"Singapore\" can also be used. Optional hint for market context (currency, availability, pricing)—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+		"address_region": zod.string().describe("The region in which the locality is, and which is in the country. For example, California or another appropriate first-level Administrative division. Optional hint for progressive localization—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+		"postal_code": zod.string().describe("The postal code. For example, 94043. Optional hint for regional refinement—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+		"intent": zod.string().describe("Background context describing buyer's intent (e.g., 'looking for a gift under $50', 'need something durable for outdoor use'). Informs relevance, recommendations, and personalization.").optional(),
+		"language": zod.string().describe("Preferred language for content. Use IETF BCP 47 language tags (e.g., 'en', 'fr-CA', 'zh-Hans'). For REST, equivalent to Accept-Language header—platforms SHOULD fall back to Accept-Language when this field is absent; when provided, overrides Accept-Language. Businesses MAY return content in a different language if unavailable.").optional(),
+		"currency": zod.string().describe("Preferred currency (ISO 4217, e.g., 'EUR', 'USD'). Businesses determine presentment currency from context and authoritative signals; this hint MAY inform selection in multi-currency markets. Also serves as the denomination for price filter values — platforms SHOULD include this field when sending price filters. Response prices include explicit currency confirming the resolution.").optional(),
+		"eligibility": zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Reverse-domain identifier used for collision-safe namespacing of capabilities, services, handlers, eligibility claims, and extension-contributed keys. Must contain at least two dot-separated segments (e.g., 'dev.ucp.shopping.checkout', 'com.example.loyalty_gold').")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Buyer claims about eligible benefits such as loyalty membership, payment instrument perks, and similar. Recognized claims MAY inform the Business response (e.g., member-only product availability, adjusted pricing in catalog, provisional discounts at cart or checkout). Businesses MUST ignore unrecognized values without error. Values MUST use reverse-domain naming (e.g., 'com.example.loyalty_gold', 'org.school.student') and MUST be non-identifying.").optional()
+	}).passthrough().describe("Buyer signals for localization (country, region, postal_code). Merchant uses for pricing, availability, currency. Falls back to geo-IP if omitted.").optional(),
+	"signals": zod.object({
+		"dev.ucp.buyer_ip": zod.string().describe("Client's IP address (IPv4 or IPv6).").optional(),
+		"dev.ucp.user_agent": zod.string().describe("Client's HTTP User-Agent header or equivalent.").optional()
+	}).passthrough().describe("Environment data provided by the platform to support authorization and abuse prevention. Values MUST NOT be buyer-asserted claims — platforms provide signals based on direct observation or independently verifiable third-party attestations. All signal keys MUST use reverse-domain naming to ensure provenance and prevent collisions when multiple extensions contribute to the shared namespace.").optional(),
+	"buyer": zod.object({
+		"first_name": zod.string().describe("First name of the buyer.").optional(),
+		"last_name": zod.string().describe("Last name of the buyer.").optional(),
+		"email": zod.string().describe("Email of the buyer.").optional(),
+		"phone_number": zod.string().describe("E.164 standard.").optional()
+	}).passthrough().describe("Optional buyer information for personalized estimates.").optional()
+}).strict();
+const CartUpdateRequestSchema = zod.object({
+	"id": zod.string().describe("Unique cart identifier."),
+	"line_items": zod.array(zod.object({
+		"id": zod.string(),
+		"item": zod.object({
+			"id": zod.string().describe("The product identifier, often the SKU, required to resolve the product details associated with this line item. Should be recognized by both the Platform, and the Business."),
+			"title": zod.string().describe("Product title."),
+			"price": zod.number().int().gte(0).describe("Unit price in ISO 4217 minor units."),
+			"image_url": zod.string().url().describe("Product image URI.").optional()
+		}),
+		"quantity": zod.number().int().gte(1).describe("Quantity of the item being purchased."),
+		"totals": zod.array(zod.object({
+			"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
+			"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
+			"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+		}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Line item totals breakdown."),
+		"parent_id": zod.string().describe("Parent line item identifier for any nested structures.").optional()
+	}).describe("Line item object. Expected to use the currency of the parent object.")).describe("Cart line items. Same structure as checkout. Full replacement on update."),
+	"context": zod.object({
+		"address_country": zod.string().describe("The country. Recommended to be in 2-letter ISO 3166-1 alpha-2 format, for example \"US\". For backward compatibility, a 3-letter ISO 3166-1 alpha-3 country code such as \"SGP\" or a full country name such as \"Singapore\" can also be used. Optional hint for market context (currency, availability, pricing)—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+		"address_region": zod.string().describe("The region in which the locality is, and which is in the country. For example, California or another appropriate first-level Administrative division. Optional hint for progressive localization—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+		"postal_code": zod.string().describe("The postal code. For example, 94043. Optional hint for regional refinement—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+		"intent": zod.string().describe("Background context describing buyer's intent (e.g., 'looking for a gift under $50', 'need something durable for outdoor use'). Informs relevance, recommendations, and personalization.").optional(),
+		"language": zod.string().describe("Preferred language for content. Use IETF BCP 47 language tags (e.g., 'en', 'fr-CA', 'zh-Hans'). For REST, equivalent to Accept-Language header—platforms SHOULD fall back to Accept-Language when this field is absent; when provided, overrides Accept-Language. Businesses MAY return content in a different language if unavailable.").optional(),
+		"currency": zod.string().describe("Preferred currency (ISO 4217, e.g., 'EUR', 'USD'). Businesses determine presentment currency from context and authoritative signals; this hint MAY inform selection in multi-currency markets. Also serves as the denomination for price filter values — platforms SHOULD include this field when sending price filters. Response prices include explicit currency confirming the resolution.").optional(),
+		"eligibility": zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Reverse-domain identifier used for collision-safe namespacing of capabilities, services, handlers, eligibility claims, and extension-contributed keys. Must contain at least two dot-separated segments (e.g., 'dev.ucp.shopping.checkout', 'com.example.loyalty_gold').")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Buyer claims about eligible benefits such as loyalty membership, payment instrument perks, and similar. Recognized claims MAY inform the Business response (e.g., member-only product availability, adjusted pricing in catalog, provisional discounts at cart or checkout). Businesses MUST ignore unrecognized values without error. Values MUST use reverse-domain naming (e.g., 'com.example.loyalty_gold', 'org.school.student') and MUST be non-identifying.").optional()
+	}).passthrough().describe("Buyer signals for localization (country, region, postal_code). Merchant uses for pricing, availability, currency. Falls back to geo-IP if omitted.").optional(),
+	"signals": zod.object({
+		"dev.ucp.buyer_ip": zod.string().describe("Client's IP address (IPv4 or IPv6).").optional(),
+		"dev.ucp.user_agent": zod.string().describe("Client's HTTP User-Agent header or equivalent.").optional()
+	}).passthrough().describe("Environment data provided by the platform to support authorization and abuse prevention. Values MUST NOT be buyer-asserted claims — platforms provide signals based on direct observation or independently verifiable third-party attestations. All signal keys MUST use reverse-domain naming to ensure provenance and prevent collisions when multiple extensions contribute to the shared namespace.").optional(),
+	"buyer": zod.object({
+		"first_name": zod.string().describe("First name of the buyer.").optional(),
+		"last_name": zod.string().describe("Last name of the buyer.").optional(),
+		"email": zod.string().describe("Email of the buyer.").optional(),
+		"phone_number": zod.string().describe("E.164 standard.").optional()
+	}).passthrough().describe("Optional buyer information for personalized estimates.").optional()
+}).strict();
+const CatalogLookupSchema = zod.record(zod.string(), zod.unknown()).describe("Product/variant lookup by identifier. Supports batch retrieval (lookup_catalog) and single-product detail (get_product).");
+const CatalogSearchSchema = zod.record(zod.string(), zod.unknown()).describe("Product catalog search capability.");
 const CheckoutSchema = zod.object({
 	"ucp": zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+		"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
 		"services": zod.record(zod.array(zod.intersection(zod.object({
 			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -215,14 +537,31 @@ const CheckoutSchema = zod.object({
 			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+			const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+			const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+			const passed = schemas.length - errors.length;
+			if (passed !== 1) ctx.addIssue(errors.length ? {
+				path: ctx.path,
+				code: "invalid_union",
+				unionErrors: errors,
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			} : {
+				path: ctx.path,
+				code: "custom",
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			});
+		}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 		"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-		}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+		}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+			"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+			"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+		}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
 	}).describe("Base UCP metadata with shared properties for all schema types."), zod.object({
 		"services": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
 			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
@@ -244,7 +583,10 @@ const CheckoutSchema = zod.object({
 			zod.object({ "transport": zod.literal("a2a").optional() }),
 			zod.object({
 				"transport": zod.literal("embedded").optional(),
-				"config": zod.object({ "delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In checkout responses, confirms accepted delegations for this session.").optional() }).describe("Per-checkout configuration for embedded transport binding. Allows businesses to vary ECP availability and delegations based on cart contents, agent authorization, or policy.").optional()
+				"config": zod.object({
+					"delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In UCP responses, confirms accepted delegations for this session.").optional(),
+					"color_scheme": zod.array(zod.enum(["light", "dark"])).describe("Color schemes the business supports. Hosts use ec_color_scheme query parameter to request a scheme from this list.").optional()
+				}).describe("Per-session configuration for embedded transport binding. Allows businesses to vary EP availability and delegations based on cart contents, agent authorization, or policy.").optional()
 			})
 		])).describe("Service binding in API responses. Includes per-resource transport configuration via typed config."))).optional(),
 		"capabilities": zod.record(zod.array(zod.intersection(zod.object({
@@ -253,38 +595,47 @@ const CheckoutSchema = zod.object({
 			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities."))).optional(),
+		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+			const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+			const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+			const passed = schemas.length - errors.length;
+			if (passed !== 1) ctx.addIssue(errors.length ? {
+				path: ctx.path,
+				code: "invalid_union",
+				unionErrors: errors,
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			} : {
+				path: ctx.path,
+				code: "custom",
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			});
+		}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities."))).optional(),
 		"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-		}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())).describe("Handler reference in responses. May include full config state for runtime usage of the handler.")))
+		}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+			"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+			"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+		}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))).describe("Handler reference in responses. May include full config state for runtime usage of the handler.")))
 	})).describe("UCP metadata for checkout responses."),
 	"id": zod.string().describe("Unique identifier of the checkout session."),
 	"line_items": zod.array(zod.object({
 		"id": zod.string(),
 		"item": zod.object({
-			"id": zod.string().describe("Should be recognized by both the Platform, and the Business. For Google it should match the id provided in the \"id\" field in the product feed."),
+			"id": zod.string().describe("The product identifier, often the SKU, required to resolve the product details associated with this line item. Should be recognized by both the Platform, and the Business."),
 			"title": zod.string().describe("Product title."),
-			"price": zod.number().int().gte(0).describe("Unit price in minor (cents) currency units."),
+			"price": zod.number().int().gte(0).describe("Unit price in ISO 4217 minor units."),
 			"image_url": zod.string().url().describe("Product image URI.").optional()
 		}),
 		"quantity": zod.number().int().gte(1).describe("Quantity of the item being purchased."),
 		"totals": zod.array(zod.object({
-			"type": zod.enum([
-				"items_discount",
-				"subtotal",
-				"discount",
-				"fulfillment",
-				"tax",
-				"fee",
-				"total"
-			]).describe("Type of total categorization."),
+			"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 			"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-			"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-		})).describe("Line item totals breakdown."),
+			"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+		}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Line item totals breakdown."),
 		"parent_id": zod.string().describe("Parent line item identifier for any nested structures.").optional()
 	}).describe("Line item object. Expected to use the currency of the parent object.")).describe("List of line items being checked out."),
 	"buyer": zod.object({
@@ -296,8 +647,16 @@ const CheckoutSchema = zod.object({
 	"context": zod.object({
 		"address_country": zod.string().describe("The country. Recommended to be in 2-letter ISO 3166-1 alpha-2 format, for example \"US\". For backward compatibility, a 3-letter ISO 3166-1 alpha-3 country code such as \"SGP\" or a full country name such as \"Singapore\" can also be used. Optional hint for market context (currency, availability, pricing)—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
 		"address_region": zod.string().describe("The region in which the locality is, and which is in the country. For example, California or another appropriate first-level Administrative division. Optional hint for progressive localization—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
-		"postal_code": zod.string().describe("The postal code. For example, 94043. Optional hint for regional refinement—higher-resolution data (e.g., shipping address) supersedes this value.").optional()
-	}).passthrough().describe("Provisional buyer signals for relevance and localization: product availability, pricing, currency, tax, shipping, payment methods, and eligibility (e.g., student or affiliation discounts). Businesses SHOULD use these values when authoritative data (e.g., address) is absent, and MAY ignore unsupported values without returning errors. Context can be disclosed progressively—coarse signals early, finer resolution as the session progresses. Higher-resolution data (shipping address, billing address) supersedes context. Platforms SHOULD progressively enhance context throughout the buyer journey.").optional(),
+		"postal_code": zod.string().describe("The postal code. For example, 94043. Optional hint for regional refinement—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+		"intent": zod.string().describe("Background context describing buyer's intent (e.g., 'looking for a gift under $50', 'need something durable for outdoor use'). Informs relevance, recommendations, and personalization.").optional(),
+		"language": zod.string().describe("Preferred language for content. Use IETF BCP 47 language tags (e.g., 'en', 'fr-CA', 'zh-Hans'). For REST, equivalent to Accept-Language header—platforms SHOULD fall back to Accept-Language when this field is absent; when provided, overrides Accept-Language. Businesses MAY return content in a different language if unavailable.").optional(),
+		"currency": zod.string().describe("Preferred currency (ISO 4217, e.g., 'EUR', 'USD'). Businesses determine presentment currency from context and authoritative signals; this hint MAY inform selection in multi-currency markets. Also serves as the denomination for price filter values — platforms SHOULD include this field when sending price filters. Response prices include explicit currency confirming the resolution.").optional(),
+		"eligibility": zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Reverse-domain identifier used for collision-safe namespacing of capabilities, services, handlers, eligibility claims, and extension-contributed keys. Must contain at least two dot-separated segments (e.g., 'dev.ucp.shopping.checkout', 'com.example.loyalty_gold').")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Buyer claims about eligible benefits such as loyalty membership, payment instrument perks, and similar. Recognized claims MAY inform the Business response (e.g., member-only product availability, adjusted pricing in catalog, provisional discounts at cart or checkout). Businesses MUST ignore unrecognized values without error. Values MUST use reverse-domain naming (e.g., 'com.example.loyalty_gold', 'org.school.student') and MUST be non-identifying.").optional()
+	}).passthrough().describe("Provisional buyer signals for relevance and localization—not authoritative data. Businesses SHOULD use these values when verified inputs (e.g., shipping address) are absent, and MAY ignore or down-rank them if inconsistent with higher-confidence signals (authenticated account, risk detection) or regulatory constraints (export controls). Eligibility and policy enforcement MUST occur at checkout time using binding transaction data. Context SHOULD be non-identifying and can be disclosed progressively—coarse signals early, finer resolution as the session progresses. Higher-resolution data (shipping address, billing address) supersedes context.").optional(),
+	"signals": zod.object({
+		"dev.ucp.buyer_ip": zod.string().describe("Client's IP address (IPv4 or IPv6).").optional(),
+		"dev.ucp.user_agent": zod.string().describe("Client's HTTP User-Agent header or equivalent.").optional()
+	}).passthrough().describe("Environment data provided by the platform to support authorization and abuse prevention. Values MUST NOT be buyer-asserted claims — platforms provide signals based on direct observation or independently verifiable third-party attestations. All signal keys MUST use reverse-domain naming to ensure provenance and prevent collisions when multiple extensions contribute to the shared namespace.").optional(),
 	"status": zod.enum([
 		"incomplete",
 		"requires_escalation",
@@ -307,39 +666,38 @@ const CheckoutSchema = zod.object({
 		"canceled"
 	]).describe("Checkout state indicating the current phase and required action. See Checkout Status lifecycle documentation for state transition details."),
 	"currency": zod.string().describe("ISO 4217 currency code reflecting the merchant's market determination. Derived from address, context, and geo IP—buyers provide signals, merchants determine currency."),
-	"totals": zod.array(zod.object({
-		"type": zod.enum([
-			"items_discount",
-			"subtotal",
-			"discount",
-			"fulfillment",
-			"tax",
-			"fee",
-			"total"
-		]).describe("Type of total categorization."),
+	"totals": zod.array(zod.intersection(zod.object({
+		"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 		"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-		"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-	})).describe("Different cart totals."),
+		"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+	}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text."), zod.intersection(zod.object({ "lines": zod.array(zod.object({
+		"display_text": zod.string().describe("Human-readable label for this sub-line."),
+		"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+	}).describe("Sub-line entry. Additional metadata MAY be included.")).describe("Optional itemized breakdown. The parent entry is always rendered; lines are supplementary. Sum of line amounts MUST equal the parent entry amount.").optional() }), zod.any()))).describe("Different cart totals."),
 	"messages": zod.array(zod.record(zod.string(), zod.unknown()).and(zod.unknown().superRefine((x, ctx) => {
 		const schemas = [
 			zod.object({
 				"type": zod.literal("error").describe("Message type discriminator."),
-				"code": zod.string().describe("Error code. Possible values include: missing, invalid, out_of_stock, payment_declined, requires_sign_in, requires_3ds, requires_identity_linking. Freeform codes also allowed."),
+				"code": zod.string().describe("Error code identifying the type of error. Standard errors are defined in specification (see examples), and have standardized semantics; freeform codes are permitted."),
 				"path": zod.string().describe("RFC 9535 JSONPath to the component the message refers to (e.g., $.items[1]).").optional(),
 				"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
 				"content": zod.string().describe("Human-readable message."),
 				"severity": zod.enum([
 					"recoverable",
 					"requires_buyer_input",
-					"requires_buyer_review"
-				]).describe("Declares who resolves this error. 'recoverable': agent can fix via API. 'requires_buyer_input': merchant requires information their API doesn't support collecting programmatically (checkout incomplete). 'requires_buyer_review': buyer must authorize before order placement due to policy, regulatory, or entitlement rules (checkout complete). Errors with 'requires_*' severity contribute to 'status: requires_escalation'.")
+					"requires_buyer_review",
+					"unrecoverable"
+				]).describe("Reflects the resource state and recommended action. 'recoverable': platform can resolve by modifying inputs and retrying via API. 'requires_buyer_input': merchant requires information their API doesn't support collecting programmatically (checkout incomplete). 'requires_buyer_review': buyer must authorize before order placement due to policy, regulatory, or entitlement rules. 'unrecoverable': no valid resource exists to act on, retry with new resource or inputs. Errors with 'requires_*' severity contribute to 'status: requires_escalation'.")
 			}),
 			zod.object({
 				"type": zod.literal("warning").describe("Message type discriminator."),
 				"path": zod.string().describe("JSONPath (RFC 9535) to related field (e.g., $.line_items[0]).").optional(),
 				"code": zod.string().describe("Warning code. Machine-readable identifier for the warning type (e.g., final_sale, prop65, fulfillment_changed, age_restricted, etc.)."),
 				"content": zod.string().describe("Human-readable warning message that MUST be displayed."),
-				"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain")
+				"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
+				"presentation": zod.string().describe("Rendering contract for this warning. 'notice' (default): platform MUST display, MAY dismiss. 'disclosure': platform MUST display in proximity to the path-referenced component, MUST NOT hide or auto-dismiss. See specification for full contract.").default("notice"),
+				"image_url": zod.string().url().describe("URL to a required visual element (e.g., warning symbol, energy class label).").optional(),
+				"url": zod.string().url().describe("Reference URL for more information (e.g., regulatory site, registry entry, policy page).").optional()
 			}),
 			zod.object({
 				"type": zod.literal("info").describe("Message type discriminator."),
@@ -389,6 +747,7 @@ const CheckoutSchema = zod.object({
 	}).passthrough().describe("The base definition for any payment instrument. It links the instrument to a specific payment handler."), zod.object({ "selected": zod.boolean().describe("Whether this instrument is selected by the user.").optional() })).describe("A payment instrument with selection state.")).describe("The payment instruments available for this payment. Each instrument is associated with a specific handler via the handler_id field. Handlers can extend the base payment_instrument schema to add handler-specific fields.").optional() }).describe("Payment configuration containing handlers.").optional(),
 	"order": zod.object({
 		"id": zod.string().describe("Unique order identifier."),
+		"label": zod.string().describe("Human-readable label for identifying the order. MUST only be provided by the business.").optional(),
 		"permalink_url": zod.string().url().describe("Permalink to access the order on merchant site.")
 	}).describe("Details about an order created for this checkout session.").optional()
 }).passthrough().describe("Base checkout schema. Extensions compose onto this using allOf.");
@@ -396,25 +755,17 @@ const CheckoutCreateRequestSchema = zod.object({
 	"line_items": zod.array(zod.object({
 		"id": zod.string(),
 		"item": zod.object({
-			"id": zod.string().describe("Should be recognized by both the Platform, and the Business. For Google it should match the id provided in the \"id\" field in the product feed."),
+			"id": zod.string().describe("The product identifier, often the SKU, required to resolve the product details associated with this line item. Should be recognized by both the Platform, and the Business."),
 			"title": zod.string().describe("Product title."),
-			"price": zod.number().int().gte(0).describe("Unit price in minor (cents) currency units."),
+			"price": zod.number().int().gte(0).describe("Unit price in ISO 4217 minor units."),
 			"image_url": zod.string().url().describe("Product image URI.").optional()
 		}),
 		"quantity": zod.number().int().gte(1).describe("Quantity of the item being purchased."),
 		"totals": zod.array(zod.object({
-			"type": zod.enum([
-				"items_discount",
-				"subtotal",
-				"discount",
-				"fulfillment",
-				"tax",
-				"fee",
-				"total"
-			]).describe("Type of total categorization."),
+			"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 			"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-			"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-		})).describe("Line item totals breakdown."),
+			"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+		}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Line item totals breakdown."),
 		"parent_id": zod.string().describe("Parent line item identifier for any nested structures.").optional()
 	}).describe("Line item object. Expected to use the currency of the parent object.")).describe("List of line items being checked out."),
 	"buyer": zod.object({
@@ -426,8 +777,16 @@ const CheckoutCreateRequestSchema = zod.object({
 	"context": zod.object({
 		"address_country": zod.string().describe("The country. Recommended to be in 2-letter ISO 3166-1 alpha-2 format, for example \"US\". For backward compatibility, a 3-letter ISO 3166-1 alpha-3 country code such as \"SGP\" or a full country name such as \"Singapore\" can also be used. Optional hint for market context (currency, availability, pricing)—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
 		"address_region": zod.string().describe("The region in which the locality is, and which is in the country. For example, California or another appropriate first-level Administrative division. Optional hint for progressive localization—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
-		"postal_code": zod.string().describe("The postal code. For example, 94043. Optional hint for regional refinement—higher-resolution data (e.g., shipping address) supersedes this value.").optional()
-	}).passthrough().describe("Provisional buyer signals for relevance and localization: product availability, pricing, currency, tax, shipping, payment methods, and eligibility (e.g., student or affiliation discounts). Businesses SHOULD use these values when authoritative data (e.g., address) is absent, and MAY ignore unsupported values without returning errors. Context can be disclosed progressively—coarse signals early, finer resolution as the session progresses. Higher-resolution data (shipping address, billing address) supersedes context. Platforms SHOULD progressively enhance context throughout the buyer journey.").optional(),
+		"postal_code": zod.string().describe("The postal code. For example, 94043. Optional hint for regional refinement—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+		"intent": zod.string().describe("Background context describing buyer's intent (e.g., 'looking for a gift under $50', 'need something durable for outdoor use'). Informs relevance, recommendations, and personalization.").optional(),
+		"language": zod.string().describe("Preferred language for content. Use IETF BCP 47 language tags (e.g., 'en', 'fr-CA', 'zh-Hans'). For REST, equivalent to Accept-Language header—platforms SHOULD fall back to Accept-Language when this field is absent; when provided, overrides Accept-Language. Businesses MAY return content in a different language if unavailable.").optional(),
+		"currency": zod.string().describe("Preferred currency (ISO 4217, e.g., 'EUR', 'USD'). Businesses determine presentment currency from context and authoritative signals; this hint MAY inform selection in multi-currency markets. Also serves as the denomination for price filter values — platforms SHOULD include this field when sending price filters. Response prices include explicit currency confirming the resolution.").optional(),
+		"eligibility": zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Reverse-domain identifier used for collision-safe namespacing of capabilities, services, handlers, eligibility claims, and extension-contributed keys. Must contain at least two dot-separated segments (e.g., 'dev.ucp.shopping.checkout', 'com.example.loyalty_gold').")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Buyer claims about eligible benefits such as loyalty membership, payment instrument perks, and similar. Recognized claims MAY inform the Business response (e.g., member-only product availability, adjusted pricing in catalog, provisional discounts at cart or checkout). Businesses MUST ignore unrecognized values without error. Values MUST use reverse-domain naming (e.g., 'com.example.loyalty_gold', 'org.school.student') and MUST be non-identifying.").optional()
+	}).passthrough().describe("Provisional buyer signals for relevance and localization—not authoritative data. Businesses SHOULD use these values when verified inputs (e.g., shipping address) are absent, and MAY ignore or down-rank them if inconsistent with higher-confidence signals (authenticated account, risk detection) or regulatory constraints (export controls). Eligibility and policy enforcement MUST occur at checkout time using binding transaction data. Context SHOULD be non-identifying and can be disclosed progressively—coarse signals early, finer resolution as the session progresses. Higher-resolution data (shipping address, billing address) supersedes context.").optional(),
+	"signals": zod.object({
+		"dev.ucp.buyer_ip": zod.string().describe("Client's IP address (IPv4 or IPv6).").optional(),
+		"dev.ucp.user_agent": zod.string().describe("Client's HTTP User-Agent header or equivalent.").optional()
+	}).passthrough().describe("Environment data provided by the platform to support authorization and abuse prevention. Values MUST NOT be buyer-asserted claims — platforms provide signals based on direct observation or independently verifiable third-party attestations. All signal keys MUST use reverse-domain naming to ensure provenance and prevent collisions when multiple extensions contribute to the shared namespace.").optional(),
 	"payment": zod.object({ "instruments": zod.array(zod.intersection(zod.object({
 		"id": zod.string().describe("A unique identifier for this instrument instance, assigned by the platform."),
 		"handler_id": zod.string().describe("The unique identifier for the handler instance that produced this instrument. This corresponds to the 'id' field in the Payment Handler definition."),
@@ -448,29 +807,20 @@ const CheckoutCreateRequestSchema = zod.object({
 	}).passthrough().describe("The base definition for any payment instrument. It links the instrument to a specific payment handler."), zod.object({ "selected": zod.boolean().describe("Whether this instrument is selected by the user.").optional() })).describe("A payment instrument with selection state.")).describe("The payment instruments available for this payment. Each instrument is associated with a specific handler via the handler_id field. Handlers can extend the base payment_instrument schema to add handler-specific fields.").optional() }).describe("Payment configuration containing handlers.").optional()
 }).strict();
 const CheckoutUpdateRequestSchema = zod.object({
-	"id": zod.string().describe("Unique identifier of the checkout session."),
 	"line_items": zod.array(zod.object({
 		"id": zod.string(),
 		"item": zod.object({
-			"id": zod.string().describe("Should be recognized by both the Platform, and the Business. For Google it should match the id provided in the \"id\" field in the product feed."),
+			"id": zod.string().describe("The product identifier, often the SKU, required to resolve the product details associated with this line item. Should be recognized by both the Platform, and the Business."),
 			"title": zod.string().describe("Product title."),
-			"price": zod.number().int().gte(0).describe("Unit price in minor (cents) currency units."),
+			"price": zod.number().int().gte(0).describe("Unit price in ISO 4217 minor units."),
 			"image_url": zod.string().url().describe("Product image URI.").optional()
 		}),
 		"quantity": zod.number().int().gte(1).describe("Quantity of the item being purchased."),
 		"totals": zod.array(zod.object({
-			"type": zod.enum([
-				"items_discount",
-				"subtotal",
-				"discount",
-				"fulfillment",
-				"tax",
-				"fee",
-				"total"
-			]).describe("Type of total categorization."),
+			"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 			"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-			"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-		})).describe("Line item totals breakdown."),
+			"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+		}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Line item totals breakdown."),
 		"parent_id": zod.string().describe("Parent line item identifier for any nested structures.").optional()
 	}).describe("Line item object. Expected to use the currency of the parent object.")).describe("List of line items being checked out."),
 	"buyer": zod.object({
@@ -482,8 +832,16 @@ const CheckoutUpdateRequestSchema = zod.object({
 	"context": zod.object({
 		"address_country": zod.string().describe("The country. Recommended to be in 2-letter ISO 3166-1 alpha-2 format, for example \"US\". For backward compatibility, a 3-letter ISO 3166-1 alpha-3 country code such as \"SGP\" or a full country name such as \"Singapore\" can also be used. Optional hint for market context (currency, availability, pricing)—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
 		"address_region": zod.string().describe("The region in which the locality is, and which is in the country. For example, California or another appropriate first-level Administrative division. Optional hint for progressive localization—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
-		"postal_code": zod.string().describe("The postal code. For example, 94043. Optional hint for regional refinement—higher-resolution data (e.g., shipping address) supersedes this value.").optional()
-	}).passthrough().describe("Provisional buyer signals for relevance and localization: product availability, pricing, currency, tax, shipping, payment methods, and eligibility (e.g., student or affiliation discounts). Businesses SHOULD use these values when authoritative data (e.g., address) is absent, and MAY ignore unsupported values without returning errors. Context can be disclosed progressively—coarse signals early, finer resolution as the session progresses. Higher-resolution data (shipping address, billing address) supersedes context. Platforms SHOULD progressively enhance context throughout the buyer journey.").optional(),
+		"postal_code": zod.string().describe("The postal code. For example, 94043. Optional hint for regional refinement—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+		"intent": zod.string().describe("Background context describing buyer's intent (e.g., 'looking for a gift under $50', 'need something durable for outdoor use'). Informs relevance, recommendations, and personalization.").optional(),
+		"language": zod.string().describe("Preferred language for content. Use IETF BCP 47 language tags (e.g., 'en', 'fr-CA', 'zh-Hans'). For REST, equivalent to Accept-Language header—platforms SHOULD fall back to Accept-Language when this field is absent; when provided, overrides Accept-Language. Businesses MAY return content in a different language if unavailable.").optional(),
+		"currency": zod.string().describe("Preferred currency (ISO 4217, e.g., 'EUR', 'USD'). Businesses determine presentment currency from context and authoritative signals; this hint MAY inform selection in multi-currency markets. Also serves as the denomination for price filter values — platforms SHOULD include this field when sending price filters. Response prices include explicit currency confirming the resolution.").optional(),
+		"eligibility": zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Reverse-domain identifier used for collision-safe namespacing of capabilities, services, handlers, eligibility claims, and extension-contributed keys. Must contain at least two dot-separated segments (e.g., 'dev.ucp.shopping.checkout', 'com.example.loyalty_gold').")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Buyer claims about eligible benefits such as loyalty membership, payment instrument perks, and similar. Recognized claims MAY inform the Business response (e.g., member-only product availability, adjusted pricing in catalog, provisional discounts at cart or checkout). Businesses MUST ignore unrecognized values without error. Values MUST use reverse-domain naming (e.g., 'com.example.loyalty_gold', 'org.school.student') and MUST be non-identifying.").optional()
+	}).passthrough().describe("Provisional buyer signals for relevance and localization—not authoritative data. Businesses SHOULD use these values when verified inputs (e.g., shipping address) are absent, and MAY ignore or down-rank them if inconsistent with higher-confidence signals (authenticated account, risk detection) or regulatory constraints (export controls). Eligibility and policy enforcement MUST occur at checkout time using binding transaction data. Context SHOULD be non-identifying and can be disclosed progressively—coarse signals early, finer resolution as the session progresses. Higher-resolution data (shipping address, billing address) supersedes context.").optional(),
+	"signals": zod.object({
+		"dev.ucp.buyer_ip": zod.string().describe("Client's IP address (IPv4 or IPv6).").optional(),
+		"dev.ucp.user_agent": zod.string().describe("Client's HTTP User-Agent header or equivalent.").optional()
+	}).passthrough().describe("Environment data provided by the platform to support authorization and abuse prevention. Values MUST NOT be buyer-asserted claims — platforms provide signals based on direct observation or independently verifiable third-party attestations. All signal keys MUST use reverse-domain naming to ensure provenance and prevent collisions when multiple extensions contribute to the shared namespace.").optional(),
 	"payment": zod.object({ "instruments": zod.array(zod.intersection(zod.object({
 		"id": zod.string().describe("A unique identifier for this instrument instance, assigned by the platform."),
 		"handler_id": zod.string().describe("The unique identifier for the handler instance that produced this instrument. This corresponds to the 'id' field in the Payment Handler definition."),
@@ -503,38 +861,46 @@ const CheckoutUpdateRequestSchema = zod.object({
 		"display": zod.record(zod.string(), zod.unknown()).describe("Display information for this payment instrument. Each payment instrument schema defines its specific display properties, as outlined by the payment handler.").optional()
 	}).passthrough().describe("The base definition for any payment instrument. It links the instrument to a specific payment handler."), zod.object({ "selected": zod.boolean().describe("Whether this instrument is selected by the user.").optional() })).describe("A payment instrument with selection state.")).describe("The payment instruments available for this payment. Each instrument is associated with a specific handler via the handler_id field. Handlers can extend the base payment_instrument schema to add handler-specific fields.").optional() }).describe("Payment configuration containing handlers.").optional()
 }).strict();
-const CheckoutCompleteRequestSchema = zod.object({ "payment": zod.object({ "instruments": zod.array(zod.intersection(zod.object({
-	"id": zod.string().describe("A unique identifier for this instrument instance, assigned by the platform."),
-	"handler_id": zod.string().describe("The unique identifier for the handler instance that produced this instrument. This corresponds to the 'id' field in the Payment Handler definition."),
-	"type": zod.string().describe("The broad category of the instrument (e.g., 'card', 'tokenized_card'). Specific schemas will constrain this to a constant value."),
-	"billing_address": zod.object({
-		"extended_address": zod.string().describe("An address extension such as an apartment number, C/O or alternative name.").optional(),
-		"street_address": zod.string().describe("The street address.").optional(),
-		"address_locality": zod.string().describe("The locality in which the street address is, and which is in the region. For example, Mountain View.").optional(),
-		"address_region": zod.string().describe("The region in which the locality is, and which is in the country. Required for applicable countries (i.e. state in US, province in CA). For example, California or another appropriate first-level Administrative division.").optional(),
-		"address_country": zod.string().describe("The country. Recommended to be in 2-letter ISO 3166-1 alpha-2 format, for example \"US\". For backward compatibility, a 3-letter ISO 3166-1 alpha-3 country code such as \"SGP\" or a full country name such as \"Singapore\" can also be used.").optional(),
-		"postal_code": zod.string().describe("The postal code. For example, 94043.").optional(),
-		"first_name": zod.string().describe("Optional. First name of the contact associated with the address.").optional(),
-		"last_name": zod.string().describe("Optional. Last name of the contact associated with the address.").optional(),
-		"phone_number": zod.string().describe("Optional. Phone number of the contact associated with the address.").optional()
-	}).describe("The billing address associated with this payment method.").optional(),
-	"credential": zod.object({ "type": zod.string().describe("The credential type discriminator. Specific schemas will constrain this to a constant value.") }).passthrough().describe("The base definition for any payment credential. Handlers define specific credential types.").optional(),
-	"display": zod.record(zod.string(), zod.unknown()).describe("Display information for this payment instrument. Each payment instrument schema defines its specific display properties, as outlined by the payment handler.").optional()
-}).passthrough().describe("The base definition for any payment instrument. It links the instrument to a specific payment handler."), zod.object({ "selected": zod.boolean().describe("Whether this instrument is selected by the user.").optional() })).describe("A payment instrument with selection state.")).describe("The payment instruments available for this payment. Each instrument is associated with a specific handler via the handler_id field. Handlers can extend the base payment_instrument schema to add handler-specific fields.").optional() }).describe("Payment configuration containing handlers.") }).strict();
+const CheckoutCompleteRequestSchema = zod.object({
+	"signals": zod.object({
+		"dev.ucp.buyer_ip": zod.string().describe("Client's IP address (IPv4 or IPv6).").optional(),
+		"dev.ucp.user_agent": zod.string().describe("Client's HTTP User-Agent header or equivalent.").optional()
+	}).passthrough().describe("Environment data provided by the platform to support authorization and abuse prevention. Values MUST NOT be buyer-asserted claims — platforms provide signals based on direct observation or independently verifiable third-party attestations. All signal keys MUST use reverse-domain naming to ensure provenance and prevent collisions when multiple extensions contribute to the shared namespace.").optional(),
+	"payment": zod.object({ "instruments": zod.array(zod.intersection(zod.object({
+		"id": zod.string().describe("A unique identifier for this instrument instance, assigned by the platform."),
+		"handler_id": zod.string().describe("The unique identifier for the handler instance that produced this instrument. This corresponds to the 'id' field in the Payment Handler definition."),
+		"type": zod.string().describe("The broad category of the instrument (e.g., 'card', 'tokenized_card'). Specific schemas will constrain this to a constant value."),
+		"billing_address": zod.object({
+			"extended_address": zod.string().describe("An address extension such as an apartment number, C/O or alternative name.").optional(),
+			"street_address": zod.string().describe("The street address.").optional(),
+			"address_locality": zod.string().describe("The locality in which the street address is, and which is in the region. For example, Mountain View.").optional(),
+			"address_region": zod.string().describe("The region in which the locality is, and which is in the country. Required for applicable countries (i.e. state in US, province in CA). For example, California or another appropriate first-level Administrative division.").optional(),
+			"address_country": zod.string().describe("The country. Recommended to be in 2-letter ISO 3166-1 alpha-2 format, for example \"US\". For backward compatibility, a 3-letter ISO 3166-1 alpha-3 country code such as \"SGP\" or a full country name such as \"Singapore\" can also be used.").optional(),
+			"postal_code": zod.string().describe("The postal code. For example, 94043.").optional(),
+			"first_name": zod.string().describe("Optional. First name of the contact associated with the address.").optional(),
+			"last_name": zod.string().describe("Optional. Last name of the contact associated with the address.").optional(),
+			"phone_number": zod.string().describe("Optional. Phone number of the contact associated with the address.").optional()
+		}).describe("The billing address associated with this payment method.").optional(),
+		"credential": zod.object({ "type": zod.string().describe("The credential type discriminator. Specific schemas will constrain this to a constant value.") }).passthrough().describe("The base definition for any payment credential. Handlers define specific credential types.").optional(),
+		"display": zod.record(zod.string(), zod.unknown()).describe("Display information for this payment instrument. Each payment instrument schema defines its specific display properties, as outlined by the payment handler.").optional()
+	}).passthrough().describe("The base definition for any payment instrument. It links the instrument to a specific payment handler."), zod.object({ "selected": zod.boolean().describe("Whether this instrument is selected by the user.").optional() })).describe("A payment instrument with selection state.")).describe("The payment instruments available for this payment. Each instrument is associated with a specific handler via the handler_id field. Handlers can extend the base payment_instrument schema to add handler-specific fields.").optional() }).describe("Payment configuration containing handlers.")
+}).strict();
 const DiscountAllocationSchema = zod.object({
 	"path": zod.string().describe("JSONPath to the allocation target (e.g., '$.line_items[0]', '$.totals.shipping')."),
-	"amount": zod.number().int().gte(0).describe("Amount allocated to this target in minor (cents) currency units.")
+	"amount": zod.number().int().gte(0).describe("Amount allocated to this target in ISO 4217 minor units.")
 }).describe("Breakdown of how a discount amount was allocated to a specific target.");
 const DiscountAppliedDiscountSchema = zod.object({
 	"code": zod.string().describe("The discount code. Omitted for automatic discounts.").optional(),
 	"title": zod.string().describe("Human-readable discount name (e.g., 'Summer Sale 20% Off')."),
-	"amount": zod.number().int().gte(0).describe("Total discount amount in minor (cents) currency units."),
+	"amount": zod.number().int().gte(0).describe("Total discount amount in ISO 4217 minor units."),
 	"automatic": zod.boolean().describe("True if applied automatically by merchant rules (no code required).").default(false),
 	"method": zod.enum(["each", "across"]).describe("Allocation method. 'each' = applied independently per item. 'across' = split proportionally by value.").optional(),
 	"priority": zod.number().int().gte(1).describe("Stacking order for discount calculation. Lower numbers applied first (1 = first).").optional(),
+	"provisional": zod.boolean().describe("True if this discount requires additional verification.").default(false),
+	"eligibility": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("The eligibility claim accepted by the Business for this discount. Corresponds to a value from context.eligibility. Omitted for code-based and non-eligibility automatic discounts.").optional(),
 	"allocations": zod.array(zod.object({
 		"path": zod.string().describe("JSONPath to the allocation target (e.g., '$.line_items[0]', '$.totals.shipping')."),
-		"amount": zod.number().int().gte(0).describe("Amount allocated to this target in minor (cents) currency units.")
+		"amount": zod.number().int().gte(0).describe("Amount allocated to this target in ISO 4217 minor units.")
 	}).describe("Breakdown of how a discount amount was allocated to a specific target.")).describe("Breakdown of where this discount was allocated. Sum of allocation amounts equals total amount.").optional()
 }).describe("A discount that was successfully applied.");
 const DiscountDiscountsObjectSchema = zod.object({
@@ -542,13 +908,15 @@ const DiscountDiscountsObjectSchema = zod.object({
 	"applied": zod.array(zod.object({
 		"code": zod.string().describe("The discount code. Omitted for automatic discounts.").optional(),
 		"title": zod.string().describe("Human-readable discount name (e.g., 'Summer Sale 20% Off')."),
-		"amount": zod.number().int().gte(0).describe("Total discount amount in minor (cents) currency units."),
+		"amount": zod.number().int().gte(0).describe("Total discount amount in ISO 4217 minor units."),
 		"automatic": zod.boolean().describe("True if applied automatically by merchant rules (no code required).").default(false),
 		"method": zod.enum(["each", "across"]).describe("Allocation method. 'each' = applied independently per item. 'across' = split proportionally by value.").optional(),
 		"priority": zod.number().int().gte(1).describe("Stacking order for discount calculation. Lower numbers applied first (1 = first).").optional(),
+		"provisional": zod.boolean().describe("True if this discount requires additional verification.").default(false),
+		"eligibility": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("The eligibility claim accepted by the Business for this discount. Corresponds to a value from context.eligibility. Omitted for code-based and non-eligibility automatic discounts.").optional(),
 		"allocations": zod.array(zod.object({
 			"path": zod.string().describe("JSONPath to the allocation target (e.g., '$.line_items[0]', '$.totals.shipping')."),
-			"amount": zod.number().int().gte(0).describe("Amount allocated to this target in minor (cents) currency units.")
+			"amount": zod.number().int().gte(0).describe("Amount allocated to this target in ISO 4217 minor units.")
 		}).describe("Breakdown of how a discount amount was allocated to a specific target.")).describe("Breakdown of where this discount was allocated. Sum of allocation amounts equals total amount.").optional()
 	}).describe("A discount that was successfully applied.")).describe("Discounts successfully applied (code-based and automatic).").readonly().optional()
 }).describe("Discount codes input and applied discounts output.");
@@ -560,18 +928,10 @@ const FulfillmentExtensionFulfillmentOptionSchema = zod.object({
 	"earliest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Earliest fulfillment date.").optional(),
 	"latest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Latest fulfillment date.").optional(),
 	"totals": zod.array(zod.object({
-		"type": zod.enum([
-			"items_discount",
-			"subtotal",
-			"discount",
-			"fulfillment",
-			"tax",
-			"fee",
-			"total"
-		]).describe("Type of total categorization."),
+		"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 		"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-		"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-	})).describe("Fulfillment option totals breakdown.")
+		"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+	}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Fulfillment option totals breakdown.")
 }).passthrough().describe("A fulfillment option within a group (e.g., Standard Shipping $5, Express $15).");
 const FulfillmentExtensionFulfillmentGroupSchema = zod.object({
 	"id": zod.string().describe("Group identifier for referencing merchant-generated groups in updates."),
@@ -584,18 +944,10 @@ const FulfillmentExtensionFulfillmentGroupSchema = zod.object({
 		"earliest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Earliest fulfillment date.").optional(),
 		"latest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Latest fulfillment date.").optional(),
 		"totals": zod.array(zod.object({
-			"type": zod.enum([
-				"items_discount",
-				"subtotal",
-				"discount",
-				"fulfillment",
-				"tax",
-				"fee",
-				"total"
-			]).describe("Type of total categorization."),
+			"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 			"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-			"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-		})).describe("Fulfillment option totals breakdown.")
+			"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+		}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Fulfillment option totals breakdown.")
 	}).passthrough().describe("A fulfillment option within a group (e.g., Standard Shipping $5, Express $15).")).describe("Available fulfillment options for this group.").optional(),
 	"selected_option_id": zod.union([zod.string().describe("ID of the selected fulfillment option for this group."), zod.null().describe("ID of the selected fulfillment option for this group.")]).describe("ID of the selected fulfillment option for this group.").optional()
 }).passthrough().describe("A merchant-generated package/group of line items with fulfillment options.");
@@ -654,18 +1006,10 @@ const FulfillmentExtensionFulfillmentMethodSchema = zod.object({
 			"earliest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Earliest fulfillment date.").optional(),
 			"latest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Latest fulfillment date.").optional(),
 			"totals": zod.array(zod.object({
-				"type": zod.enum([
-					"items_discount",
-					"subtotal",
-					"discount",
-					"fulfillment",
-					"tax",
-					"fee",
-					"total"
-				]).describe("Type of total categorization."),
+				"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 				"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-				"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-			})).describe("Fulfillment option totals breakdown.")
+				"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+			}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Fulfillment option totals breakdown.")
 		}).passthrough().describe("A fulfillment option within a group (e.g., Standard Shipping $5, Express $15).")).describe("Available fulfillment options for this group.").optional(),
 		"selected_option_id": zod.union([zod.string().describe("ID of the selected fulfillment option for this group."), zod.null().describe("ID of the selected fulfillment option for this group.")]).describe("ID of the selected fulfillment option for this group.").optional()
 	}).passthrough().describe("A merchant-generated package/group of line items with fulfillment options.")).describe("Fulfillment groups for selecting options. Agent sets selected_option_id on groups to choose shipping method.").optional()
@@ -732,18 +1076,10 @@ const FulfillmentExtensionFulfillmentSchema = zod.object({
 				"earliest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Earliest fulfillment date.").optional(),
 				"latest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Latest fulfillment date.").optional(),
 				"totals": zod.array(zod.object({
-					"type": zod.enum([
-						"items_discount",
-						"subtotal",
-						"discount",
-						"fulfillment",
-						"tax",
-						"fee",
-						"total"
-					]).describe("Type of total categorization."),
+					"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 					"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-					"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-				})).describe("Fulfillment option totals breakdown.")
+					"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+				}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Fulfillment option totals breakdown.")
 			}).passthrough().describe("A fulfillment option within a group (e.g., Standard Shipping $5, Express $15).")).describe("Available fulfillment options for this group.").optional(),
 			"selected_option_id": zod.union([zod.string().describe("ID of the selected fulfillment option for this group."), zod.null().describe("ID of the selected fulfillment option for this group.")]).describe("ID of the selected fulfillment option for this group.").optional()
 		}).passthrough().describe("A merchant-generated package/group of line items with fulfillment options.")).describe("Fulfillment groups for selecting options. Agent sets selected_option_id on groups to choose shipping method.").optional()
@@ -758,6 +1094,7 @@ const FulfillmentExtensionFulfillmentSchema = zod.object({
 const OrderSchema = zod.object({
 	"ucp": zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+		"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
 		"services": zod.record(zod.array(zod.intersection(zod.object({
 			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -779,56 +1116,82 @@ const OrderSchema = zod.object({
 			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+			const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+			const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+			const passed = schemas.length - errors.length;
+			if (passed !== 1) ctx.addIssue(errors.length ? {
+				path: ctx.path,
+				code: "invalid_union",
+				unionErrors: errors,
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			} : {
+				path: ctx.path,
+				code: "custom",
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			});
+		}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 		"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-		}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+		}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+			"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+			"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+		}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
 	}).describe("Base UCP metadata with shared properties for all schema types."), zod.object({ "capabilities": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities."))).optional() })).describe("UCP metadata for order responses. No payment handlers needed post-purchase."),
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities."))).optional() })).describe("UCP metadata for order responses. No payment handlers needed post-purchase."),
 	"id": zod.string().describe("Unique order identifier."),
+	"label": zod.string().describe("Human-readable label for identifying the order. MUST only be provided by the business.").optional(),
 	"checkout_id": zod.string().describe("Associated checkout ID for reconciliation."),
 	"permalink_url": zod.string().url().describe("Permalink to access the order on merchant site."),
 	"line_items": zod.array(zod.object({
 		"id": zod.string().describe("Line item identifier."),
 		"item": zod.object({
-			"id": zod.string().describe("Should be recognized by both the Platform, and the Business. For Google it should match the id provided in the \"id\" field in the product feed."),
+			"id": zod.string().describe("The product identifier, often the SKU, required to resolve the product details associated with this line item. Should be recognized by both the Platform, and the Business."),
 			"title": zod.string().describe("Product title."),
-			"price": zod.number().int().gte(0).describe("Unit price in minor (cents) currency units."),
+			"price": zod.number().int().gte(0).describe("Unit price in ISO 4217 minor units."),
 			"image_url": zod.string().url().describe("Product image URI.").optional()
 		}).describe("Product data (id, title, price, image_url)."),
 		"quantity": zod.object({
-			"total": zod.number().int().gte(0).describe("Current total quantity."),
-			"fulfilled": zod.number().int().gte(0).describe("Quantity fulfilled (sum from fulfillment events).")
-		}).describe("Quantity tracking. Both total and fulfilled are derived from events."),
+			"original": zod.number().int().gte(0).describe("Quantity from the original checkout.").optional(),
+			"total": zod.number().int().gte(0).describe("Current total active quantity. May differ from original due to post-order modifications (e.g., returns or cancellations)."),
+			"fulfilled": zod.number().int().gte(0).describe("Quantity fulfilled so far.")
+		}).describe("Quantity tracking for the line item."),
 		"totals": zod.array(zod.object({
-			"type": zod.enum([
-				"items_discount",
-				"subtotal",
-				"discount",
-				"fulfillment",
-				"tax",
-				"fee",
-				"total"
-			]).describe("Type of total categorization."),
+			"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 			"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-			"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-		})).describe("Line item totals breakdown."),
+			"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+		}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Line item totals breakdown."),
 		"status": zod.enum([
 			"processing",
 			"partial",
-			"fulfilled"
-		]).describe("Derived status: fulfilled if quantity.fulfilled == quantity.total, partial if quantity.fulfilled > 0, otherwise processing."),
+			"fulfilled",
+			"removed"
+		]).describe("Derived status: removed if quantity.total == 0, fulfilled if quantity.total > 0 and quantity.fulfilled == quantity.total, partial if quantity.total > 0 and quantity.fulfilled > 0, otherwise processing."),
 		"parent_id": zod.string().describe("Parent line item identifier for any nested structures.").optional()
-	})).describe("Immutable line items — source of truth for what was ordered."),
+	})).describe("Line items representing what was purchased — can change post-order via edits or exchanges."),
 	"fulfillment": zod.object({
 		"expectations": zod.array(zod.object({
 			"id": zod.string().describe("Expectation identifier."),
@@ -880,25 +1243,71 @@ const OrderSchema = zod.object({
 		]).describe("Adjustment status."),
 		"line_items": zod.array(zod.object({
 			"id": zod.string().describe("Line item ID reference."),
-			"quantity": zod.number().int().gte(1).describe("Quantity affected by this adjustment.")
+			"quantity": zod.number().int().describe("Signed quantity affected by this adjustment. Negative values represent reductions (e.g. returns); positive values represent additions (e.g. exchanges).")
 		})).describe("Which line items and quantities are affected (optional).").optional(),
-		"amount": zod.number().int().describe("Amount in minor units (cents) for refunds, credits, price adjustments (optional).").optional(),
+		"totals": zod.array(zod.object({
+			"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
+			"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
+			"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+		}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Adjustment totals breakdown. Signed values - negative for money returned to buyer (refunds, credits), positive for additional charges (exchanges).").optional(),
 		"description": zod.string().describe("Human-readable reason or description (e.g., 'Defective item', 'Customer requested').").optional()
-	}).describe("Append-only event that exists independently of fulfillment. Typically represents money movements but can be any post-order change. Polymorphic type that can optionally reference line items.")).describe("Append-only event log of money movements (refunds, returns, credits, disputes, cancellations, etc.) that exist independently of fulfillment.").optional(),
-	"totals": zod.array(zod.object({
-		"type": zod.enum([
-			"items_discount",
-			"subtotal",
-			"discount",
-			"fulfillment",
-			"tax",
-			"fee",
-			"total"
-		]).describe("Type of total categorization."),
+	}).describe("Post-order event that exists independently of fulfillment. Typically represents money movements but can be any post-order change. Polymorphic type that can optionally reference line items.")).describe("Post-order events (refunds, returns, credits, disputes, cancellations, etc.) that exist independently of fulfillment.").optional(),
+	"currency": zod.string().describe("ISO 4217 currency code. MUST match the currency from the originating checkout session."),
+	"totals": zod.array(zod.intersection(zod.object({
+		"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 		"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-		"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-	})).describe("Different totals for the order.")
-}).describe("Order schema with immutable line items, buyer-facing fulfillment expectations, and append-only event logs.");
+		"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+	}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text."), zod.intersection(zod.object({ "lines": zod.array(zod.object({
+		"display_text": zod.string().describe("Human-readable label for this sub-line."),
+		"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+	}).describe("Sub-line entry. Additional metadata MAY be included.")).describe("Optional itemized breakdown. The parent entry is always rendered; lines are supplementary. Sum of line amounts MUST equal the parent entry amount.").optional() }), zod.any()))).describe("Different totals for the order."),
+	"messages": zod.array(zod.record(zod.string(), zod.unknown()).and(zod.unknown().superRefine((x, ctx) => {
+		const schemas = [
+			zod.object({
+				"type": zod.literal("error").describe("Message type discriminator."),
+				"code": zod.string().describe("Error code identifying the type of error. Standard errors are defined in specification (see examples), and have standardized semantics; freeform codes are permitted."),
+				"path": zod.string().describe("RFC 9535 JSONPath to the component the message refers to (e.g., $.items[1]).").optional(),
+				"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
+				"content": zod.string().describe("Human-readable message."),
+				"severity": zod.enum([
+					"recoverable",
+					"requires_buyer_input",
+					"requires_buyer_review",
+					"unrecoverable"
+				]).describe("Reflects the resource state and recommended action. 'recoverable': platform can resolve by modifying inputs and retrying via API. 'requires_buyer_input': merchant requires information their API doesn't support collecting programmatically (checkout incomplete). 'requires_buyer_review': buyer must authorize before order placement due to policy, regulatory, or entitlement rules. 'unrecoverable': no valid resource exists to act on, retry with new resource or inputs. Errors with 'requires_*' severity contribute to 'status: requires_escalation'.")
+			}),
+			zod.object({
+				"type": zod.literal("warning").describe("Message type discriminator."),
+				"path": zod.string().describe("JSONPath (RFC 9535) to related field (e.g., $.line_items[0]).").optional(),
+				"code": zod.string().describe("Warning code. Machine-readable identifier for the warning type (e.g., final_sale, prop65, fulfillment_changed, age_restricted, etc.)."),
+				"content": zod.string().describe("Human-readable warning message that MUST be displayed."),
+				"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
+				"presentation": zod.string().describe("Rendering contract for this warning. 'notice' (default): platform MUST display, MAY dismiss. 'disclosure': platform MUST display in proximity to the path-referenced component, MUST NOT hide or auto-dismiss. See specification for full contract.").default("notice"),
+				"image_url": zod.string().url().describe("URL to a required visual element (e.g., warning symbol, energy class label).").optional(),
+				"url": zod.string().url().describe("Reference URL for more information (e.g., regulatory site, registry entry, policy page).").optional()
+			}),
+			zod.object({
+				"type": zod.literal("info").describe("Message type discriminator."),
+				"path": zod.string().describe("RFC 9535 JSONPath to the component the message refers to.").optional(),
+				"code": zod.string().describe("Info code for programmatic handling.").optional(),
+				"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
+				"content": zod.string().describe("Human-readable message.")
+			})
+		];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	})).describe("Container for error, warning, or info messages.")).describe("Business outcome messages (errors, warnings, informational). Present when the business needs to communicate status or issues to the platform.").optional()
+}).describe("Order schema with line items, buyer-facing fulfillment expectations, and event logs.");
 const PaymentSchema = zod.object({ "instruments": zod.array(zod.intersection(zod.object({
 	"id": zod.string().describe("A unique identifier for this instrument instance, assigned by the platform."),
 	"handler_id": zod.string().describe("The unique identifier for the handler instance that produced this instrument. This corresponds to the 'id' field in the Payment Handler definition."),
@@ -929,11 +1338,20 @@ const AdjustmentSchema = zod.object({
 	]).describe("Adjustment status."),
 	"line_items": zod.array(zod.object({
 		"id": zod.string().describe("Line item ID reference."),
-		"quantity": zod.number().int().gte(1).describe("Quantity affected by this adjustment.")
+		"quantity": zod.number().int().describe("Signed quantity affected by this adjustment. Negative values represent reductions (e.g. returns); positive values represent additions (e.g. exchanges).")
 	})).describe("Which line items and quantities are affected (optional).").optional(),
-	"amount": zod.number().int().describe("Amount in minor units (cents) for refunds, credits, price adjustments (optional).").optional(),
+	"totals": zod.array(zod.object({
+		"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
+		"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
+		"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+	}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Adjustment totals breakdown. Signed values - negative for money returned to buyer (refunds, credits), positive for additional charges (exchanges).").optional(),
 	"description": zod.string().describe("Human-readable reason or description (e.g., 'Defective item', 'Customer requested').").optional()
-}).describe("Append-only event that exists independently of fulfillment. Typically represents money movements but can be any post-order change. Polymorphic type that can optionally reference line items.");
+}).describe("Post-order event that exists independently of fulfillment. Typically represents money movements but can be any post-order change. Polymorphic type that can optionally reference line items.");
+const AmountSchema = zod.number().int().gte(0).describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD).");
+const AvailablePaymentInstrumentSchema = zod.object({
+	"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+	"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+}).describe("An instrument type available from a payment handler with optional constraints.");
 const BindingSchema = zod.object({
 	"checkout_id": zod.string().describe("The checkout session identifier this token is bound to."),
 	"identity": zod.object({ "access_token": zod.string().describe("Unique identifier for this participant, obtained during onboarding with the tokenizer.") }).describe("The participant this token is bound to. Required when acting on behalf of another participant (e.g., agent tokenizing for merchant). Omit when the authenticated caller is the binding target.").optional()
@@ -966,39 +1384,138 @@ const CardCredentialSchema = zod.intersection(zod.object({ "type": zod.string().
 	"cryptogram": zod.string().describe("Cryptogram provided with network tokens.").optional(),
 	"eci_value": zod.string().describe("Electronic Commerce Indicator / Security Level Indicator provided with network tokens.").optional()
 })).describe("A card credential containing sensitive payment card details including raw Primary Account Numbers (PANs). This credential type MUST NOT be used for checkout, only with payment handlers that tokenize or encrypt credentials. CRITICAL: Both parties handling CardCredential (sender and receiver) MUST be PCI DSS compliant. Transmission MUST use HTTPS/TLS with strong cipher suites.");
-const CardPaymentInstrumentSchema = zod.intersection(zod.object({
-	"id": zod.string().describe("A unique identifier for this instrument instance, assigned by the platform."),
-	"handler_id": zod.string().describe("The unique identifier for the handler instance that produced this instrument. This corresponds to the 'id' field in the Payment Handler definition."),
-	"type": zod.string().describe("The broad category of the instrument (e.g., 'card', 'tokenized_card'). Specific schemas will constrain this to a constant value."),
-	"billing_address": zod.object({
-		"extended_address": zod.string().describe("An address extension such as an apartment number, C/O or alternative name.").optional(),
-		"street_address": zod.string().describe("The street address.").optional(),
-		"address_locality": zod.string().describe("The locality in which the street address is, and which is in the region. For example, Mountain View.").optional(),
-		"address_region": zod.string().describe("The region in which the locality is, and which is in the country. Required for applicable countries (i.e. state in US, province in CA). For example, California or another appropriate first-level Administrative division.").optional(),
-		"address_country": zod.string().describe("The country. Recommended to be in 2-letter ISO 3166-1 alpha-2 format, for example \"US\". For backward compatibility, a 3-letter ISO 3166-1 alpha-3 country code such as \"SGP\" or a full country name such as \"Singapore\" can also be used.").optional(),
-		"postal_code": zod.string().describe("The postal code. For example, 94043.").optional(),
-		"first_name": zod.string().describe("Optional. First name of the contact associated with the address.").optional(),
-		"last_name": zod.string().describe("Optional. Last name of the contact associated with the address.").optional(),
-		"phone_number": zod.string().describe("Optional. Phone number of the contact associated with the address.").optional()
-	}).describe("The billing address associated with this payment method.").optional(),
-	"credential": zod.object({ "type": zod.string().describe("The credential type discriminator. Specific schemas will constrain this to a constant value.") }).passthrough().describe("The base definition for any payment credential. Handlers define specific credential types.").optional(),
-	"display": zod.record(zod.string(), zod.unknown()).describe("Display information for this payment instrument. Each payment instrument schema defines its specific display properties, as outlined by the payment handler.").optional()
-}).passthrough().describe("The base definition for any payment instrument. It links the instrument to a specific payment handler."), zod.object({
-	"type": zod.literal("card").describe("Indicates this is a card payment instrument."),
-	"display": zod.object({
-		"brand": zod.string().describe("The card brand/network (e.g., visa, mastercard, amex).").optional(),
-		"last_digits": zod.string().describe("Last 4 digits of the card number.").optional(),
-		"expiry_month": zod.number().int().describe("The month of the card's expiration date (1-12).").optional(),
-		"expiry_year": zod.number().int().describe("The year of the card's expiration date.").optional(),
-		"description": zod.string().describe("An optional rich text description of the card to display to the user (e.g., 'Visa ending in 1234, expires 12/2025').").optional(),
-		"card_art": zod.string().url().describe("An optional URI to a rich image representing the card (e.g., card art provided by the issuer).").optional()
-	}).describe("Display information for this card payment instrument.").optional()
-})).describe("A basic card payment instrument with visible card details. Can be inherited by a handler's instrument schema to define handler-specific display details or more complex credential structures.");
+const CardPaymentInstrumentAvailableCardPaymentInstrumentSchema = zod.intersection(zod.object({
+	"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+	"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+}).describe("An instrument type available from a payment handler with optional constraints."), zod.object({
+	"type": zod.literal("card").optional(),
+	"constraints": zod.object({ "brands": zod.array(zod.string()).min(1).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Limit to specific card brands (e.g., ['visa', 'mastercard', 'amex']).").optional() }).optional()
+})).describe("Declares card instrument availability with card-specific constraints.");
+const CategorySchema = zod.object({
+	"value": zod.string().describe("Category value or path (e.g., 'Apparel > Shirts', '1604')."),
+	"taxonomy": zod.string().describe("Source taxonomy. Well-known values: `google_product_category`, `shopify`, `merchant`.").optional()
+}).describe("A product category with optional taxonomy identifier.");
 const ContextSchema = zod.object({
 	"address_country": zod.string().describe("The country. Recommended to be in 2-letter ISO 3166-1 alpha-2 format, for example \"US\". For backward compatibility, a 3-letter ISO 3166-1 alpha-3 country code such as \"SGP\" or a full country name such as \"Singapore\" can also be used. Optional hint for market context (currency, availability, pricing)—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
 	"address_region": zod.string().describe("The region in which the locality is, and which is in the country. For example, California or another appropriate first-level Administrative division. Optional hint for progressive localization—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
-	"postal_code": zod.string().describe("The postal code. For example, 94043. Optional hint for regional refinement—higher-resolution data (e.g., shipping address) supersedes this value.").optional()
-}).passthrough().describe("Provisional buyer signals for relevance and localization: product availability, pricing, currency, tax, shipping, payment methods, and eligibility (e.g., student or affiliation discounts). Businesses SHOULD use these values when authoritative data (e.g., address) is absent, and MAY ignore unsupported values without returning errors. Context can be disclosed progressively—coarse signals early, finer resolution as the session progresses. Higher-resolution data (shipping address, billing address) supersedes context. Platforms SHOULD progressively enhance context throughout the buyer journey.");
+	"postal_code": zod.string().describe("The postal code. For example, 94043. Optional hint for regional refinement—higher-resolution data (e.g., shipping address) supersedes this value.").optional(),
+	"intent": zod.string().describe("Background context describing buyer's intent (e.g., 'looking for a gift under $50', 'need something durable for outdoor use'). Informs relevance, recommendations, and personalization.").optional(),
+	"language": zod.string().describe("Preferred language for content. Use IETF BCP 47 language tags (e.g., 'en', 'fr-CA', 'zh-Hans'). For REST, equivalent to Accept-Language header—platforms SHOULD fall back to Accept-Language when this field is absent; when provided, overrides Accept-Language. Businesses MAY return content in a different language if unavailable.").optional(),
+	"currency": zod.string().describe("Preferred currency (ISO 4217, e.g., 'EUR', 'USD'). Businesses determine presentment currency from context and authoritative signals; this hint MAY inform selection in multi-currency markets. Also serves as the denomination for price filter values — platforms SHOULD include this field when sending price filters. Response prices include explicit currency confirming the resolution.").optional(),
+	"eligibility": zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Reverse-domain identifier used for collision-safe namespacing of capabilities, services, handlers, eligibility claims, and extension-contributed keys. Must contain at least two dot-separated segments (e.g., 'dev.ucp.shopping.checkout', 'com.example.loyalty_gold').")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Buyer claims about eligible benefits such as loyalty membership, payment instrument perks, and similar. Recognized claims MAY inform the Business response (e.g., member-only product availability, adjusted pricing in catalog, provisional discounts at cart or checkout). Businesses MUST ignore unrecognized values without error. Values MUST use reverse-domain naming (e.g., 'com.example.loyalty_gold', 'org.school.student') and MUST be non-identifying.").optional()
+}).passthrough().describe("Provisional buyer signals for relevance and localization—not authoritative data. Businesses SHOULD use these values when verified inputs (e.g., shipping address) are absent, and MAY ignore or down-rank them if inconsistent with higher-confidence signals (authenticated account, risk detection) or regulatory constraints (export controls). Eligibility and policy enforcement MUST occur at checkout time using binding transaction data. Context SHOULD be non-identifying and can be disclosed progressively—coarse signals early, finer resolution as the session progresses. Higher-resolution data (shipping address, billing address) supersedes context.");
+const DescriptionSchema = zod.object({
+	"plain": zod.string().describe("Plain text content.").optional(),
+	"html": zod.string().describe("HTML-formatted content. Security: Platforms MUST sanitize before rendering—strip scripts, event handlers, and untrusted elements. Treat all rich text as untrusted input.").optional(),
+	"markdown": zod.string().describe("Markdown-formatted content.").optional()
+}).describe("Description content in one or more formats. At least one format must be provided.");
+const DetailOptionValueSchema = zod.object({
+	"available": zod.boolean().describe("Whether a variant matching this value and the current option selections is purchasable.").optional(),
+	"exists": zod.boolean().describe("Whether a variant matching this value and the current option selections exists in the catalog.").optional()
+}).and(zod.object({
+	"id": zod.string().describe("Optional server-assigned identifier for this option value. When present in a selected_option, the server SHOULD use it for matching instead of label.").optional(),
+	"label": zod.string().describe("Display text for this option value (e.g., 'Small', 'Blue').")
+}).describe("A selectable value for a product option.")).describe("An option value with availability signals relative to the current selections. Used in get_product responses where selected context exists.");
+const ErrorCodeSchema = zod.string().describe("Error code identifying the type of error. Standard errors are defined in specification (see examples), and have standardized semantics; freeform codes are permitted.");
+const ErrorResponseSchema = zod.object({
+	"ucp": zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+		"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
+		"services": zod.record(zod.array(zod.intersection(zod.object({
+			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+		}).describe("Shared foundation for all UCP entities."), zod.object({
+			"transport": zod.enum([
+				"rest",
+				"mcp",
+				"a2a",
+				"embedded"
+			]).describe("Transport protocol for this service binding."),
+			"endpoint": zod.string().url().describe("Endpoint URL for this transport binding.").optional()
+		})))).describe("Service registry keyed by reverse-domain name.").optional(),
+		"capabilities": zod.record(zod.array(zod.intersection(zod.object({
+			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+			const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+			const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+			const passed = schemas.length - errors.length;
+			if (passed !== 1) ctx.addIssue(errors.length ? {
+				path: ctx.path,
+				code: "invalid_union",
+				unionErrors: errors,
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			} : {
+				path: ctx.path,
+				code: "custom",
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			});
+		}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+		"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
+			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+		}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+			"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+			"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+		}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+	}).describe("Base UCP metadata with shared properties for all schema types."), zod.object({ "status": zod.literal("error") })).describe("UCP protocol metadata. Status MUST be 'error' for error response."),
+	"messages": zod.array(zod.record(zod.string(), zod.unknown()).and(zod.unknown().superRefine((x, ctx) => {
+		const schemas = [
+			zod.object({
+				"type": zod.literal("error").describe("Message type discriminator."),
+				"code": zod.string().describe("Error code identifying the type of error. Standard errors are defined in specification (see examples), and have standardized semantics; freeform codes are permitted."),
+				"path": zod.string().describe("RFC 9535 JSONPath to the component the message refers to (e.g., $.items[1]).").optional(),
+				"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
+				"content": zod.string().describe("Human-readable message."),
+				"severity": zod.enum([
+					"recoverable",
+					"requires_buyer_input",
+					"requires_buyer_review",
+					"unrecoverable"
+				]).describe("Reflects the resource state and recommended action. 'recoverable': platform can resolve by modifying inputs and retrying via API. 'requires_buyer_input': merchant requires information their API doesn't support collecting programmatically (checkout incomplete). 'requires_buyer_review': buyer must authorize before order placement due to policy, regulatory, or entitlement rules. 'unrecoverable': no valid resource exists to act on, retry with new resource or inputs. Errors with 'requires_*' severity contribute to 'status: requires_escalation'.")
+			}),
+			zod.object({
+				"type": zod.literal("warning").describe("Message type discriminator."),
+				"path": zod.string().describe("JSONPath (RFC 9535) to related field (e.g., $.line_items[0]).").optional(),
+				"code": zod.string().describe("Warning code. Machine-readable identifier for the warning type (e.g., final_sale, prop65, fulfillment_changed, age_restricted, etc.)."),
+				"content": zod.string().describe("Human-readable warning message that MUST be displayed."),
+				"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
+				"presentation": zod.string().describe("Rendering contract for this warning. 'notice' (default): platform MUST display, MAY dismiss. 'disclosure': platform MUST display in proximity to the path-referenced component, MUST NOT hide or auto-dismiss. See specification for full contract.").default("notice"),
+				"image_url": zod.string().url().describe("URL to a required visual element (e.g., warning symbol, energy class label).").optional(),
+				"url": zod.string().url().describe("Reference URL for more information (e.g., regulatory site, registry entry, policy page).").optional()
+			}),
+			zod.object({
+				"type": zod.literal("info").describe("Message type discriminator."),
+				"path": zod.string().describe("RFC 9535 JSONPath to the component the message refers to.").optional(),
+				"code": zod.string().describe("Info code for programmatic handling.").optional(),
+				"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
+				"content": zod.string().describe("Human-readable message.")
+			})
+		];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	})).describe("Container for error, warning, or info messages.")).min(1).describe("Array of messages describing why the operation failed."),
+	"continue_url": zod.string().url().describe("URL for buyer handoff or session recovery.").optional()
+}).strict().describe("Generic error response when business logic prevents resource creation or failed to retrieve resource. Used when no valid resource can be established.");
 const ExpectationSchema = zod.object({
 	"id": zod.string().describe("Expectation identifier."),
 	"line_items": zod.array(zod.object({
@@ -1080,18 +1597,10 @@ const FulfillmentSchema = zod.object({
 				"earliest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Earliest fulfillment date.").optional(),
 				"latest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Latest fulfillment date.").optional(),
 				"totals": zod.array(zod.object({
-					"type": zod.enum([
-						"items_discount",
-						"subtotal",
-						"discount",
-						"fulfillment",
-						"tax",
-						"fee",
-						"total"
-					]).describe("Type of total categorization."),
+					"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 					"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-					"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-				})).describe("Fulfillment option totals breakdown.")
+					"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+				}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Fulfillment option totals breakdown.")
 			}).passthrough().describe("A fulfillment option within a group (e.g., Standard Shipping $5, Express $15).")).describe("Available fulfillment options for this group.").optional(),
 			"selected_option_id": zod.union([zod.string().describe("ID of the selected fulfillment option for this group."), zod.null().describe("ID of the selected fulfillment option for this group.")]).describe("ID of the selected fulfillment option for this group.").optional()
 		}).passthrough().describe("A merchant-generated package/group of line items with fulfillment options.")).describe("Fulfillment groups for selecting options. Agent sets selected_option_id on groups to choose shipping method.").optional()
@@ -1172,18 +1681,10 @@ const FulfillmentGroupSchema = zod.object({
 		"earliest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Earliest fulfillment date.").optional(),
 		"latest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Latest fulfillment date.").optional(),
 		"totals": zod.array(zod.object({
-			"type": zod.enum([
-				"items_discount",
-				"subtotal",
-				"discount",
-				"fulfillment",
-				"tax",
-				"fee",
-				"total"
-			]).describe("Type of total categorization."),
+			"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 			"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-			"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-		})).describe("Fulfillment option totals breakdown.")
+			"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+		}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Fulfillment option totals breakdown.")
 	}).passthrough().describe("A fulfillment option within a group (e.g., Standard Shipping $5, Express $15).")).describe("Available fulfillment options for this group.").optional(),
 	"selected_option_id": zod.union([zod.string().describe("ID of the selected fulfillment option for this group."), zod.null().describe("ID of the selected fulfillment option for this group.")]).describe("ID of the selected fulfillment option for this group.").optional()
 }).passthrough().describe("A merchant-generated package/group of line items with fulfillment options.");
@@ -1243,18 +1744,10 @@ const FulfillmentMethodSchema = zod.object({
 			"earliest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Earliest fulfillment date.").optional(),
 			"latest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Latest fulfillment date.").optional(),
 			"totals": zod.array(zod.object({
-				"type": zod.enum([
-					"items_discount",
-					"subtotal",
-					"discount",
-					"fulfillment",
-					"tax",
-					"fee",
-					"total"
-				]).describe("Type of total categorization."),
+				"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 				"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-				"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-			})).describe("Fulfillment option totals breakdown.")
+				"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+			}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Fulfillment option totals breakdown.")
 		}).passthrough().describe("A fulfillment option within a group (e.g., Standard Shipping $5, Express $15).")).describe("Available fulfillment options for this group.").optional(),
 		"selected_option_id": zod.union([zod.string().describe("ID of the selected fulfillment option for this group."), zod.null().describe("ID of the selected fulfillment option for this group.")]).describe("ID of the selected fulfillment option for this group.").optional()
 	}).passthrough().describe("A merchant-generated package/group of line items with fulfillment options.")).describe("Fulfillment groups for selecting options. Agent sets selected_option_id on groups to choose shipping method.").optional()
@@ -1264,7 +1757,8 @@ const FulfillmentMethodCreateRequestSchema = zod.object({
 	"line_item_ids": zod.array(zod.string()).describe("Line item IDs fulfilled via this method.").optional()
 }).strict();
 const FulfillmentMethodUpdateRequestSchema = zod.object({
-	"id": zod.string().describe("Unique fulfillment method identifier."),
+	"id": zod.string().describe("Unique fulfillment method identifier.").optional(),
+	"type": zod.enum(["shipping", "pickup"]).describe("Fulfillment method type.").optional(),
 	"line_item_ids": zod.array(zod.string()).describe("Line item IDs fulfilled via this method.")
 }).strict();
 const FulfillmentOptionSchema = zod.object({
@@ -1275,47 +1769,35 @@ const FulfillmentOptionSchema = zod.object({
 	"earliest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Earliest fulfillment date.").optional(),
 	"latest_fulfillment_time": zod.string().datetime({ offset: true }).describe("Latest fulfillment date.").optional(),
 	"totals": zod.array(zod.object({
-		"type": zod.enum([
-			"items_discount",
-			"subtotal",
-			"discount",
-			"fulfillment",
-			"tax",
-			"fee",
-			"total"
-		]).describe("Type of total categorization."),
+		"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 		"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-		"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-	})).describe("Fulfillment option totals breakdown.")
+		"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+	}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Fulfillment option totals breakdown.")
 }).passthrough().describe("A fulfillment option within a group (e.g., Standard Shipping $5, Express $15).");
+const InputCorrelationSchema = zod.object({
+	"id": zod.string().describe("The identifier from the lookup request that resolved to this variant."),
+	"match": zod.string().describe("How the request identifier resolved to this variant. Well-known values: `exact` (input directly identifies this variant, e.g., variant ID, SKU), `featured` (server selected this variant as representative, e.g., product ID resolved to best match). Businesses MAY implement and provide additional resolution strategies.").optional()
+}).describe("Maps a request identifier to the variant it resolved to, with match semantics.");
 const ItemSchema = zod.object({
-	"id": zod.string().describe("Should be recognized by both the Platform, and the Business. For Google it should match the id provided in the \"id\" field in the product feed."),
+	"id": zod.string().describe("The product identifier, often the SKU, required to resolve the product details associated with this line item. Should be recognized by both the Platform, and the Business."),
 	"title": zod.string().describe("Product title."),
-	"price": zod.number().int().gte(0).describe("Unit price in minor (cents) currency units."),
+	"price": zod.number().int().gte(0).describe("Unit price in ISO 4217 minor units."),
 	"image_url": zod.string().url().describe("Product image URI.").optional()
 });
 const LineItemSchema = zod.object({
 	"id": zod.string(),
 	"item": zod.object({
-		"id": zod.string().describe("Should be recognized by both the Platform, and the Business. For Google it should match the id provided in the \"id\" field in the product feed."),
+		"id": zod.string().describe("The product identifier, often the SKU, required to resolve the product details associated with this line item. Should be recognized by both the Platform, and the Business."),
 		"title": zod.string().describe("Product title."),
-		"price": zod.number().int().gte(0).describe("Unit price in minor (cents) currency units."),
+		"price": zod.number().int().gte(0).describe("Unit price in ISO 4217 minor units."),
 		"image_url": zod.string().url().describe("Product image URI.").optional()
 	}),
 	"quantity": zod.number().int().gte(1).describe("Quantity of the item being purchased."),
 	"totals": zod.array(zod.object({
-		"type": zod.enum([
-			"items_discount",
-			"subtotal",
-			"discount",
-			"fulfillment",
-			"tax",
-			"fee",
-			"total"
-		]).describe("Type of total categorization."),
+		"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 		"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-		"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-	})).describe("Line item totals breakdown."),
+		"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+	}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Line item totals breakdown."),
 	"parent_id": zod.string().describe("Parent line item identifier for any nested structures.").optional()
 }).describe("Line item object. Expected to use the currency of the parent object.");
 const LineItemUpdateRequestSchema = zod.object({
@@ -1327,6 +1809,13 @@ const LinkSchema = zod.object({
 	"url": zod.string().url().describe("The actual URL pointing to the content to be displayed."),
 	"title": zod.string().describe("Optional display text for the link. When provided, use this instead of generating from type.").optional()
 });
+const MediaSchema = zod.object({
+	"type": zod.string().describe("Media type. Well-known values: `image`, `video`, `model_3d`."),
+	"url": zod.string().url().describe("URL to the media resource."),
+	"alt_text": zod.string().describe("Accessibility text describing the media.").optional(),
+	"width": zod.number().int().gte(1).describe("Width in pixels (for images/video).").optional(),
+	"height": zod.number().int().gte(1).describe("Height in pixels (for images/video).").optional()
+}).describe("Product media item (image, video, etc.).");
 const MerchantFulfillmentConfigSchema = zod.object({
 	"allows_multi_destination": zod.object({
 		"shipping": zod.boolean().describe("Multiple shipping destinations allowed.").optional(),
@@ -1338,22 +1827,26 @@ const MessageSchema = zod.record(zod.string(), zod.unknown()).and(zod.unknown().
 	const schemas = [
 		zod.object({
 			"type": zod.literal("error").describe("Message type discriminator."),
-			"code": zod.string().describe("Error code. Possible values include: missing, invalid, out_of_stock, payment_declined, requires_sign_in, requires_3ds, requires_identity_linking. Freeform codes also allowed."),
+			"code": zod.string().describe("Error code identifying the type of error. Standard errors are defined in specification (see examples), and have standardized semantics; freeform codes are permitted."),
 			"path": zod.string().describe("RFC 9535 JSONPath to the component the message refers to (e.g., $.items[1]).").optional(),
 			"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
 			"content": zod.string().describe("Human-readable message."),
 			"severity": zod.enum([
 				"recoverable",
 				"requires_buyer_input",
-				"requires_buyer_review"
-			]).describe("Declares who resolves this error. 'recoverable': agent can fix via API. 'requires_buyer_input': merchant requires information their API doesn't support collecting programmatically (checkout incomplete). 'requires_buyer_review': buyer must authorize before order placement due to policy, regulatory, or entitlement rules (checkout complete). Errors with 'requires_*' severity contribute to 'status: requires_escalation'.")
+				"requires_buyer_review",
+				"unrecoverable"
+			]).describe("Reflects the resource state and recommended action. 'recoverable': platform can resolve by modifying inputs and retrying via API. 'requires_buyer_input': merchant requires information their API doesn't support collecting programmatically (checkout incomplete). 'requires_buyer_review': buyer must authorize before order placement due to policy, regulatory, or entitlement rules. 'unrecoverable': no valid resource exists to act on, retry with new resource or inputs. Errors with 'requires_*' severity contribute to 'status: requires_escalation'.")
 		}),
 		zod.object({
 			"type": zod.literal("warning").describe("Message type discriminator."),
 			"path": zod.string().describe("JSONPath (RFC 9535) to related field (e.g., $.line_items[0]).").optional(),
 			"code": zod.string().describe("Warning code. Machine-readable identifier for the warning type (e.g., final_sale, prop65, fulfillment_changed, age_restricted, etc.)."),
 			"content": zod.string().describe("Human-readable warning message that MUST be displayed."),
-			"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain")
+			"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
+			"presentation": zod.string().describe("Rendering contract for this warning. 'notice' (default): platform MUST display, MAY dismiss. 'disclosure': platform MUST display in proximity to the path-referenced component, MUST NOT hide or auto-dismiss. See specification for full contract.").default("notice"),
+			"image_url": zod.string().url().describe("URL to a required visual element (e.g., warning symbol, energy class label).").optional(),
+			"url": zod.string().url().describe("Reference URL for more information (e.g., regulatory site, registry entry, policy page).").optional()
 		}),
 		zod.object({
 			"type": zod.literal("info").describe("Message type discriminator."),
@@ -1378,15 +1871,16 @@ const MessageSchema = zod.record(zod.string(), zod.unknown()).and(zod.unknown().
 })).describe("Container for error, warning, or info messages.");
 const MessageErrorSchema = zod.object({
 	"type": zod.literal("error").describe("Message type discriminator."),
-	"code": zod.string().describe("Error code. Possible values include: missing, invalid, out_of_stock, payment_declined, requires_sign_in, requires_3ds, requires_identity_linking. Freeform codes also allowed."),
+	"code": zod.string().describe("Error code identifying the type of error. Standard errors are defined in specification (see examples), and have standardized semantics; freeform codes are permitted."),
 	"path": zod.string().describe("RFC 9535 JSONPath to the component the message refers to (e.g., $.items[1]).").optional(),
 	"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
 	"content": zod.string().describe("Human-readable message."),
 	"severity": zod.enum([
 		"recoverable",
 		"requires_buyer_input",
-		"requires_buyer_review"
-	]).describe("Declares who resolves this error. 'recoverable': agent can fix via API. 'requires_buyer_input': merchant requires information their API doesn't support collecting programmatically (checkout incomplete). 'requires_buyer_review': buyer must authorize before order placement due to policy, regulatory, or entitlement rules (checkout complete). Errors with 'requires_*' severity contribute to 'status: requires_escalation'.")
+		"requires_buyer_review",
+		"unrecoverable"
+	]).describe("Reflects the resource state and recommended action. 'recoverable': platform can resolve by modifying inputs and retrying via API. 'requires_buyer_input': merchant requires information their API doesn't support collecting programmatically (checkout incomplete). 'requires_buyer_review': buyer must authorize before order placement due to policy, regulatory, or entitlement rules. 'unrecoverable': no valid resource exists to act on, retry with new resource or inputs. Errors with 'requires_*' severity contribute to 'status: requires_escalation'.")
 });
 const MessageInfoSchema = zod.object({
 	"type": zod.literal("info").describe("Message type discriminator."),
@@ -1400,44 +1894,47 @@ const MessageWarningSchema = zod.object({
 	"path": zod.string().describe("JSONPath (RFC 9535) to related field (e.g., $.line_items[0]).").optional(),
 	"code": zod.string().describe("Warning code. Machine-readable identifier for the warning type (e.g., final_sale, prop65, fulfillment_changed, age_restricted, etc.)."),
 	"content": zod.string().describe("Human-readable warning message that MUST be displayed."),
-	"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain")
+	"content_type": zod.enum(["plain", "markdown"]).describe("Content format, default = plain.").default("plain"),
+	"presentation": zod.string().describe("Rendering contract for this warning. 'notice' (default): platform MUST display, MAY dismiss. 'disclosure': platform MUST display in proximity to the path-referenced component, MUST NOT hide or auto-dismiss. See specification for full contract.").default("notice"),
+	"image_url": zod.string().url().describe("URL to a required visual element (e.g., warning symbol, energy class label).").optional(),
+	"url": zod.string().url().describe("Reference URL for more information (e.g., regulatory site, registry entry, policy page).").optional()
 });
+const OptionValueSchema = zod.object({
+	"id": zod.string().describe("Optional server-assigned identifier for this option value. When present in a selected_option, the server SHOULD use it for matching instead of label.").optional(),
+	"label": zod.string().describe("Display text for this option value (e.g., 'Small', 'Blue').")
+}).describe("A selectable value for a product option.");
 const OrderConfirmationSchema = zod.object({
 	"id": zod.string().describe("Unique order identifier."),
+	"label": zod.string().describe("Human-readable label for identifying the order. MUST only be provided by the business.").optional(),
 	"permalink_url": zod.string().url().describe("Permalink to access the order on merchant site.")
 }).describe("Order details available at the time of checkout completion.");
 const OrderLineItemSchema = zod.object({
 	"id": zod.string().describe("Line item identifier."),
 	"item": zod.object({
-		"id": zod.string().describe("Should be recognized by both the Platform, and the Business. For Google it should match the id provided in the \"id\" field in the product feed."),
+		"id": zod.string().describe("The product identifier, often the SKU, required to resolve the product details associated with this line item. Should be recognized by both the Platform, and the Business."),
 		"title": zod.string().describe("Product title."),
-		"price": zod.number().int().gte(0).describe("Unit price in minor (cents) currency units."),
+		"price": zod.number().int().gte(0).describe("Unit price in ISO 4217 minor units."),
 		"image_url": zod.string().url().describe("Product image URI.").optional()
 	}).describe("Product data (id, title, price, image_url)."),
 	"quantity": zod.object({
-		"total": zod.number().int().gte(0).describe("Current total quantity."),
-		"fulfilled": zod.number().int().gte(0).describe("Quantity fulfilled (sum from fulfillment events).")
-	}).describe("Quantity tracking. Both total and fulfilled are derived from events."),
+		"original": zod.number().int().gte(0).describe("Quantity from the original checkout.").optional(),
+		"total": zod.number().int().gte(0).describe("Current total active quantity. May differ from original due to post-order modifications (e.g., returns or cancellations)."),
+		"fulfilled": zod.number().int().gte(0).describe("Quantity fulfilled so far.")
+	}).describe("Quantity tracking for the line item."),
 	"totals": zod.array(zod.object({
-		"type": zod.enum([
-			"items_discount",
-			"subtotal",
-			"discount",
-			"fulfillment",
-			"tax",
-			"fee",
-			"total"
-		]).describe("Type of total categorization."),
+		"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 		"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-		"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-	})).describe("Line item totals breakdown."),
+		"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+	}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.")).describe("Line item totals breakdown."),
 	"status": zod.enum([
 		"processing",
 		"partial",
-		"fulfilled"
-	]).describe("Derived status: fulfilled if quantity.fulfilled == quantity.total, partial if quantity.fulfilled > 0, otherwise processing."),
+		"fulfilled",
+		"removed"
+	]).describe("Derived status: removed if quantity.total == 0, fulfilled if quantity.total > 0 and quantity.fulfilled == quantity.total, partial if quantity.total > 0 and quantity.fulfilled > 0, otherwise processing."),
 	"parent_id": zod.string().describe("Parent line item identifier for any nested structures.").optional()
 });
+const PaginationSchema = zod.record(zod.string(), zod.unknown()).describe("Cursor-based pagination for list operations.");
 const PaymentCredentialSchema = zod.object({ "type": zod.string().describe("The credential type discriminator. Specific schemas will constrain this to a constant value.") }).passthrough().describe("The base definition for any payment credential. Handlers define specific credential types.");
 const PaymentIdentitySchema = zod.object({ "access_token": zod.string().describe("Unique identifier for this participant, obtained during onboarding with the tokenizer.") }).describe("Identity of a participant for token binding. The access_token uniquely identifies the participant who tokens should be bound to.");
 const PaymentInstrumentSchema = zod.object({
@@ -1470,6 +1967,166 @@ const PostalAddressSchema = zod.object({
 	"last_name": zod.string().describe("Optional. Last name of the contact associated with the address.").optional(),
 	"phone_number": zod.string().describe("Optional. Phone number of the contact associated with the address.").optional()
 });
+const PriceSchema = zod.object({
+	"amount": zod.number().int().gte(0).describe("Amount in ISO 4217 minor units. Use 0 for free items."),
+	"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP').")
+}).describe("Price with explicit currency.");
+const PriceFilterSchema = zod.object({
+	"min": zod.number().int().gte(0).describe("Minimum price in ISO 4217 minor units.").optional(),
+	"max": zod.number().int().gte(0).describe("Maximum price in ISO 4217 minor units.").optional()
+}).describe("Price range filter denominated in context.currency. When context.currency matches the presentment currency, businesses apply the filter directly. When it differs, businesses SHOULD convert filter values to the presentment currency before applying; if conversion is not supported, businesses MAY ignore the filter and SHOULD indicate this via a message. When context.currency is absent, filter denomination is ambiguous and businesses MAY ignore it.");
+const PriceRangeSchema = zod.object({
+	"min": zod.object({
+		"amount": zod.number().int().gte(0).describe("Amount in ISO 4217 minor units. Use 0 for free items."),
+		"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP').")
+	}).describe("Minimum price in the range."),
+	"max": zod.object({
+		"amount": zod.number().int().gte(0).describe("Amount in ISO 4217 minor units. Use 0 for free items."),
+		"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP').")
+	}).describe("Maximum price in the range.")
+}).describe("A price range representing minimum and maximum values (e.g., across product variants).");
+const ProductSchema = zod.object({
+	"id": zod.string().describe("Global ID (GID) uniquely identifying this product."),
+	"handle": zod.string().describe("URL-safe slug for SEO-friendly URLs (e.g., 'blue-runner-pro'). Use id for stable API references.").optional(),
+	"title": zod.string().describe("Product title."),
+	"description": zod.object({
+		"plain": zod.string().describe("Plain text content.").optional(),
+		"html": zod.string().describe("HTML-formatted content. Security: Platforms MUST sanitize before rendering—strip scripts, event handlers, and untrusted elements. Treat all rich text as untrusted input.").optional(),
+		"markdown": zod.string().describe("Markdown-formatted content.").optional()
+	}).describe("Product description in one or more formats."),
+	"url": zod.string().url().describe("Canonical product page URL.").optional(),
+	"categories": zod.array(zod.object({
+		"value": zod.string().describe("Category value or path (e.g., 'Apparel > Shirts', '1604')."),
+		"taxonomy": zod.string().describe("Source taxonomy. Well-known values: `google_product_category`, `shopify`, `merchant`.").optional()
+	}).describe("A product category with optional taxonomy identifier.")).describe("Product categories with optional taxonomy identifiers.").optional(),
+	"price_range": zod.object({
+		"min": zod.object({
+			"amount": zod.number().int().gte(0).describe("Amount in ISO 4217 minor units. Use 0 for free items."),
+			"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP').")
+		}).describe("Minimum price in the range."),
+		"max": zod.object({
+			"amount": zod.number().int().gte(0).describe("Amount in ISO 4217 minor units. Use 0 for free items."),
+			"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP').")
+		}).describe("Maximum price in the range.")
+	}).describe("Price range across all variants."),
+	"list_price_range": zod.object({
+		"min": zod.object({
+			"amount": zod.number().int().gte(0).describe("Amount in ISO 4217 minor units. Use 0 for free items."),
+			"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP').")
+		}).describe("Minimum price in the range."),
+		"max": zod.object({
+			"amount": zod.number().int().gte(0).describe("Amount in ISO 4217 minor units. Use 0 for free items."),
+			"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP').")
+		}).describe("Maximum price in the range.")
+	}).describe("List price range before discounts (for strikethrough display).").optional(),
+	"media": zod.array(zod.object({
+		"type": zod.string().describe("Media type. Well-known values: `image`, `video`, `model_3d`."),
+		"url": zod.string().url().describe("URL to the media resource."),
+		"alt_text": zod.string().describe("Accessibility text describing the media.").optional(),
+		"width": zod.number().int().gte(1).describe("Width in pixels (for images/video).").optional(),
+		"height": zod.number().int().gte(1).describe("Height in pixels (for images/video).").optional()
+	}).describe("Product media item (image, video, etc.).")).describe("Product media (images, videos, 3D models). First item is the featured media for listings.").optional(),
+	"options": zod.array(zod.object({
+		"name": zod.string().describe("Option name (e.g., 'Size', 'Color')."),
+		"values": zod.array(zod.object({
+			"id": zod.string().describe("Optional server-assigned identifier for this option value. When present in a selected_option, the server SHOULD use it for matching instead of label.").optional(),
+			"label": zod.string().describe("Display text for this option value (e.g., 'Small', 'Blue').")
+		}).describe("A selectable value for a product option.")).min(1).describe("Available values for this option.")
+	}).describe("A product option such as size, color, or material.")).describe("Product options (Size, Color, etc.).").optional(),
+	"variants": zod.array(zod.object({
+		"id": zod.string().describe("Global ID (GID) uniquely identifying this variant. Used as item.id in checkout."),
+		"sku": zod.string().describe("Business-assigned identifier for inventory and fulfillment.").optional(),
+		"barcodes": zod.array(zod.object({
+			"type": zod.string().describe("Barcode standard. Well-known values: UPC, EAN, ISBN, GTIN, JAN."),
+			"value": zod.string().describe("Barcode value.")
+		})).describe("Industry-standard product identifiers for cross-reference and correlation.").optional(),
+		"handle": zod.string().describe("URL-safe variant handle/slug.").optional(),
+		"title": zod.string().describe("Variant display title (e.g., 'Blue / Large')."),
+		"description": zod.object({
+			"plain": zod.string().describe("Plain text content.").optional(),
+			"html": zod.string().describe("HTML-formatted content. Security: Platforms MUST sanitize before rendering—strip scripts, event handlers, and untrusted elements. Treat all rich text as untrusted input.").optional(),
+			"markdown": zod.string().describe("Markdown-formatted content.").optional()
+		}).describe("Variant description in one or more formats."),
+		"url": zod.string().url().describe("Canonical variant page URL.").optional(),
+		"categories": zod.array(zod.object({
+			"value": zod.string().describe("Category value or path (e.g., 'Apparel > Shirts', '1604')."),
+			"taxonomy": zod.string().describe("Source taxonomy. Well-known values: `google_product_category`, `shopify`, `merchant`.").optional()
+		}).describe("A product category with optional taxonomy identifier.")).describe("Variant categories with optional taxonomy identifiers.").optional(),
+		"price": zod.object({
+			"amount": zod.number().int().gte(0).describe("Amount in ISO 4217 minor units. Use 0 for free items."),
+			"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP').")
+		}).describe("Current selling price."),
+		"list_price": zod.object({
+			"amount": zod.number().int().gte(0).describe("Amount in ISO 4217 minor units. Use 0 for free items."),
+			"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP').")
+		}).describe("List price before discounts (for strikethrough display).").optional(),
+		"unit_price": zod.object({
+			"amount": zod.number().int().gte(0).describe("Unit price in ISO 4217 minor units. Business MUST return precomputed unit price value: (variant.price / measure.value) * reference.value."),
+			"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code."),
+			"measure": zod.object({
+				"value": zod.number().describe("Package quantity."),
+				"unit": zod.string().describe("Unit of measurement.")
+			}).describe("Product quantity in packaging (e.g., 750ml bottle)."),
+			"reference": zod.object({
+				"value": zod.number().int().describe("Reference quantity."),
+				"unit": zod.string().describe("Unit of measurement.")
+			}).describe("Denominator for unit price display (e.g., per 100ml, per 1kg).")
+		}).describe("Price per standard unit of measurement. MAY be omitted when unit pricing does not apply.").optional(),
+		"availability": zod.object({
+			"available": zod.boolean().describe("Whether this variant can be purchased. See status for fulfillment details.").optional(),
+			"status": zod.string().describe("Qualifies available with fulfillment state. Well-known values: `in_stock`, `backorder`, `preorder`, `out_of_stock`, `discontinued`.").optional()
+		}).describe("Variant availability for purchase.").optional(),
+		"selected_options": zod.array(zod.object({
+			"name": zod.string().describe("Option name (e.g., 'Size')."),
+			"id": zod.string().describe("Optional option value identifier from option_value.id. When present, the server SHOULD use it for matching; name and label remain required for display.").optional(),
+			"label": zod.string().describe("Selected option label (e.g., 'Large').")
+		}).describe("A specific option selection on a variant (e.g., Size: Large).")).describe("Option selections that define this variant.").optional(),
+		"media": zod.array(zod.object({
+			"type": zod.string().describe("Media type. Well-known values: `image`, `video`, `model_3d`."),
+			"url": zod.string().url().describe("URL to the media resource."),
+			"alt_text": zod.string().describe("Accessibility text describing the media.").optional(),
+			"width": zod.number().int().gte(1).describe("Width in pixels (for images/video).").optional(),
+			"height": zod.number().int().gte(1).describe("Height in pixels (for images/video).").optional()
+		}).describe("Product media item (image, video, etc.).")).describe("Variant media (images, videos, 3D models). First item is the featured media for listings.").optional(),
+		"rating": zod.object({
+			"value": zod.number().gte(0).describe("Average rating value."),
+			"scale_min": zod.number().gte(0).describe("Minimum value on the rating scale (e.g., 1 for 1-5 stars).").default(1),
+			"scale_max": zod.number().gte(1).describe("Maximum value on the rating scale (e.g., 5 for 5-star)."),
+			"count": zod.number().int().gte(0).describe("Number of reviews contributing to the rating.").optional()
+		}).describe("Variant rating.").optional(),
+		"tags": zod.array(zod.string()).describe("Variant tags for categorization and search.").optional(),
+		"metadata": zod.record(zod.string(), zod.unknown()).describe("Business-defined custom data extending the standard variant model.").optional(),
+		"seller": zod.object({
+			"name": zod.string().describe("Seller display name.").optional(),
+			"links": zod.array(zod.object({
+				"type": zod.string().describe("Type of link. Well-known values: `privacy_policy`, `terms_of_service`, `refund_policy`, `shipping_policy`, `faq`. Consumers SHOULD handle unknown values gracefully by displaying them using the `title` field or omitting the link."),
+				"url": zod.string().url().describe("The actual URL pointing to the content to be displayed."),
+				"title": zod.string().describe("Optional display text for the link. When provided, use this instead of generating from type.").optional()
+			})).describe("Seller policy and information links.").optional()
+		}).describe("Optional seller context for this variant.").optional()
+	}).describe("A purchasable variant of a product with specific option selections.")).min(1).describe("Purchasable variants of this product. First item is the featured variant for listings."),
+	"rating": zod.object({
+		"value": zod.number().gte(0).describe("Average rating value."),
+		"scale_min": zod.number().gte(0).describe("Minimum value on the rating scale (e.g., 1 for 1-5 stars).").default(1),
+		"scale_max": zod.number().gte(1).describe("Maximum value on the rating scale (e.g., 5 for 5-star)."),
+		"count": zod.number().int().gte(0).describe("Number of reviews contributing to the rating.").optional()
+	}).describe("Aggregate product rating.").optional(),
+	"tags": zod.array(zod.string()).describe("Product tags for categorization and search.").optional(),
+	"metadata": zod.record(zod.string(), zod.unknown()).describe("Business-defined custom data extending the standard product model.").optional()
+}).describe("A product in the catalog with variants and options.");
+const ProductOptionSchema = zod.object({
+	"name": zod.string().describe("Option name (e.g., 'Size', 'Color')."),
+	"values": zod.array(zod.object({
+		"id": zod.string().describe("Optional server-assigned identifier for this option value. When present in a selected_option, the server SHOULD use it for matching instead of label.").optional(),
+		"label": zod.string().describe("Display text for this option value (e.g., 'Small', 'Blue').")
+	}).describe("A selectable value for a product option.")).min(1).describe("Available values for this option.")
+}).describe("A product option such as size, color, or material.");
+const RatingSchema = zod.object({
+	"value": zod.number().gte(0).describe("Average rating value."),
+	"scale_min": zod.number().gte(0).describe("Minimum value on the rating scale (e.g., 1 for 1-5 stars).").default(1),
+	"scale_max": zod.number().gte(1).describe("Maximum value on the rating scale (e.g., 5 for 5-star)."),
+	"count": zod.number().int().gte(0).describe("Number of reviews contributing to the rating.").optional()
+}).describe("Product rating aggregate.");
 const RetailLocationSchema = zod.object({
 	"id": zod.string().describe("Unique location identifier."),
 	"name": zod.string().describe("Location name (e.g., store name)."),
@@ -1485,6 +2142,19 @@ const RetailLocationSchema = zod.object({
 		"phone_number": zod.string().describe("Optional. Phone number of the contact associated with the address.").optional()
 	}).describe("Physical address of the location.").optional()
 }).passthrough().describe("A pickup location (retail store, locker, etc.).");
+const ReverseDomainNameSchema = zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Reverse-domain identifier used for collision-safe namespacing of capabilities, services, handlers, eligibility claims, and extension-contributed keys. Must contain at least two dot-separated segments (e.g., 'dev.ucp.shopping.checkout', 'com.example.loyalty_gold').");
+const SearchFiltersSchema = zod.object({
+	"categories": zod.array(zod.string()).describe("Filter by product categories (OR logic — matches products in any listed categories). Values match against the value field in product category entries. Valid values can be discovered from the categories field in search results, merchant documentation, or standard taxonomies that businesses may align with.").optional(),
+	"price": zod.object({
+		"min": zod.number().int().gte(0).describe("Minimum price in ISO 4217 minor units.").optional(),
+		"max": zod.number().int().gte(0).describe("Maximum price in ISO 4217 minor units.").optional()
+	}).describe("Price range filter denominated in context.currency. When context.currency matches the presentment currency, businesses apply the filter directly. When it differs, businesses SHOULD convert filter values to the presentment currency before applying; if conversion is not supported, businesses MAY ignore the filter and SHOULD indicate this via a message. When context.currency is absent, filter denomination is ambiguous and businesses MAY ignore it.").optional()
+}).passthrough().describe("Filter criteria to narrow search results. All specified filters combine with AND logic.");
+const SelectedOptionSchema = zod.object({
+	"name": zod.string().describe("Option name (e.g., 'Size')."),
+	"id": zod.string().describe("Optional option value identifier from option_value.id. When present, the server SHOULD use it for matching; name and label remain required for display.").optional(),
+	"label": zod.string().describe("Selected option label (e.g., 'Large').")
+}).describe("A specific option selection on a variant (e.g., Size: Large).");
 const ShippingDestinationSchema = zod.record(zod.string(), zod.unknown()).and(zod.intersection(zod.object({
 	"extended_address": zod.string().describe("An address extension such as an apartment number, C/O or alternative name.").optional(),
 	"street_address": zod.string().describe("The street address.").optional(),
@@ -1496,26 +2166,119 @@ const ShippingDestinationSchema = zod.record(zod.string(), zod.unknown()).and(zo
 	"last_name": zod.string().describe("Optional. Last name of the contact associated with the address.").optional(),
 	"phone_number": zod.string().describe("Optional. Phone number of the contact associated with the address.").optional()
 }), zod.object({ "id": zod.string().describe("ID specific to this shipping destination.") }))).describe("Shipping destination.");
+const SignalsSchema = zod.object({
+	"dev.ucp.buyer_ip": zod.string().describe("Client's IP address (IPv4 or IPv6).").optional(),
+	"dev.ucp.user_agent": zod.string().describe("Client's HTTP User-Agent header or equivalent.").optional()
+}).passthrough().describe("Environment data provided by the platform to support authorization and abuse prevention. Values MUST NOT be buyer-asserted claims — platforms provide signals based on direct observation or independently verifiable third-party attestations. All signal keys MUST use reverse-domain naming to ensure provenance and prevent collisions when multiple extensions contribute to the shared namespace.");
+const SignedAmountSchema = zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).");
 const TokenCredentialSchema = zod.intersection(zod.object({ "type": zod.string().describe("The credential type discriminator. Specific schemas will constrain this to a constant value.") }).passthrough().describe("The base definition for any payment credential. Handlers define specific credential types."), zod.object({
 	"type": zod.string().describe("The specific type of token produced by the handler (e.g., 'stripe_token')."),
 	"token": zod.string().describe("The token value.")
 })).describe("Base token credential schema. Concrete payment handlers may extend this schema with additional fields and define their own constraints.");
 const TotalSchema = zod.object({
-	"type": zod.enum([
-		"items_discount",
-		"subtotal",
-		"discount",
-		"fulfillment",
-		"tax",
-		"fee",
-		"total"
-	]).describe("Type of total categorization."),
+	"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
 	"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
-	"amount": zod.number().int().gte(0).describe("If type == total, sums subtotal - discount + fulfillment + tax + fee. Should be >= 0. Amount in minor (cents) currency units.")
-});
-const EmbeddedConfigSchema = zod.object({ "delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In checkout responses, confirms accepted delegations for this session.").optional() }).describe("Per-checkout configuration for embedded transport binding. Allows businesses to vary ECP availability and delegations based on cart contents, agent authorization, or policy.");
+	"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text.");
+const TotalsSchema = zod.array(zod.intersection(zod.object({
+	"type": zod.string().describe("Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses MAY use additional values."),
+	"display_text": zod.string().describe("Text to display against the amount. Should reflect appropriate method (e.g., 'Shipping', 'Delivery').").optional(),
+	"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+}).and(zod.intersection(zod.any(), zod.any())).describe("A cost breakdown entry with a category, amount, and optional display text."), zod.intersection(zod.object({ "lines": zod.array(zod.object({
+	"display_text": zod.string().describe("Human-readable label for this sub-line."),
+	"amount": zod.number().int().describe("Monetary amount in the currency's minor unit as defined by ISO 4217. Refer to the currency's exponent to determine minor-to-major ratio (e.g., 2 for USD, 0 for JPY, 3 for KWD). May be negative — the sign is intrinsic to the value (e.g., discounts are negative, charges are positive).")
+}).describe("Sub-line entry. Additional metadata MAY be included.")).describe("Optional itemized breakdown. The parent entry is always rendered; lines are supplementary. Sum of line amounts MUST equal the parent entry amount.").optional() }), zod.any()))).describe("Pricing breakdown provided by the business. MUST contain exactly one subtotal and one total entry. Detail types (tax, fee, discount, fulfillment) may appear multiple times for itemization. Platforms MUST render all entries in order using display_text and amount.");
+const VariantSchema = zod.object({
+	"id": zod.string().describe("Global ID (GID) uniquely identifying this variant. Used as item.id in checkout."),
+	"sku": zod.string().describe("Business-assigned identifier for inventory and fulfillment.").optional(),
+	"barcodes": zod.array(zod.object({
+		"type": zod.string().describe("Barcode standard. Well-known values: UPC, EAN, ISBN, GTIN, JAN."),
+		"value": zod.string().describe("Barcode value.")
+	})).describe("Industry-standard product identifiers for cross-reference and correlation.").optional(),
+	"handle": zod.string().describe("URL-safe variant handle/slug.").optional(),
+	"title": zod.string().describe("Variant display title (e.g., 'Blue / Large')."),
+	"description": zod.object({
+		"plain": zod.string().describe("Plain text content.").optional(),
+		"html": zod.string().describe("HTML-formatted content. Security: Platforms MUST sanitize before rendering—strip scripts, event handlers, and untrusted elements. Treat all rich text as untrusted input.").optional(),
+		"markdown": zod.string().describe("Markdown-formatted content.").optional()
+	}).describe("Variant description in one or more formats."),
+	"url": zod.string().url().describe("Canonical variant page URL.").optional(),
+	"categories": zod.array(zod.object({
+		"value": zod.string().describe("Category value or path (e.g., 'Apparel > Shirts', '1604')."),
+		"taxonomy": zod.string().describe("Source taxonomy. Well-known values: `google_product_category`, `shopify`, `merchant`.").optional()
+	}).describe("A product category with optional taxonomy identifier.")).describe("Variant categories with optional taxonomy identifiers.").optional(),
+	"price": zod.object({
+		"amount": zod.number().int().gte(0).describe("Amount in ISO 4217 minor units. Use 0 for free items."),
+		"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP').")
+	}).describe("Current selling price."),
+	"list_price": zod.object({
+		"amount": zod.number().int().gte(0).describe("Amount in ISO 4217 minor units. Use 0 for free items."),
+		"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP').")
+	}).describe("List price before discounts (for strikethrough display).").optional(),
+	"unit_price": zod.object({
+		"amount": zod.number().int().gte(0).describe("Unit price in ISO 4217 minor units. Business MUST return precomputed unit price value: (variant.price / measure.value) * reference.value."),
+		"currency": zod.string().regex(/* @__PURE__ */ new RegExp("^[A-Z]{3}$")).describe("ISO 4217 currency code."),
+		"measure": zod.object({
+			"value": zod.number().describe("Package quantity."),
+			"unit": zod.string().describe("Unit of measurement.")
+		}).describe("Product quantity in packaging (e.g., 750ml bottle)."),
+		"reference": zod.object({
+			"value": zod.number().int().describe("Reference quantity."),
+			"unit": zod.string().describe("Unit of measurement.")
+		}).describe("Denominator for unit price display (e.g., per 100ml, per 1kg).")
+	}).describe("Price per standard unit of measurement. MAY be omitted when unit pricing does not apply.").optional(),
+	"availability": zod.object({
+		"available": zod.boolean().describe("Whether this variant can be purchased. See status for fulfillment details.").optional(),
+		"status": zod.string().describe("Qualifies available with fulfillment state. Well-known values: `in_stock`, `backorder`, `preorder`, `out_of_stock`, `discontinued`.").optional()
+	}).describe("Variant availability for purchase.").optional(),
+	"selected_options": zod.array(zod.object({
+		"name": zod.string().describe("Option name (e.g., 'Size')."),
+		"id": zod.string().describe("Optional option value identifier from option_value.id. When present, the server SHOULD use it for matching; name and label remain required for display.").optional(),
+		"label": zod.string().describe("Selected option label (e.g., 'Large').")
+	}).describe("A specific option selection on a variant (e.g., Size: Large).")).describe("Option selections that define this variant.").optional(),
+	"media": zod.array(zod.object({
+		"type": zod.string().describe("Media type. Well-known values: `image`, `video`, `model_3d`."),
+		"url": zod.string().url().describe("URL to the media resource."),
+		"alt_text": zod.string().describe("Accessibility text describing the media.").optional(),
+		"width": zod.number().int().gte(1).describe("Width in pixels (for images/video).").optional(),
+		"height": zod.number().int().gte(1).describe("Height in pixels (for images/video).").optional()
+	}).describe("Product media item (image, video, etc.).")).describe("Variant media (images, videos, 3D models). First item is the featured media for listings.").optional(),
+	"rating": zod.object({
+		"value": zod.number().gte(0).describe("Average rating value."),
+		"scale_min": zod.number().gte(0).describe("Minimum value on the rating scale (e.g., 1 for 1-5 stars).").default(1),
+		"scale_max": zod.number().gte(1).describe("Maximum value on the rating scale (e.g., 5 for 5-star)."),
+		"count": zod.number().int().gte(0).describe("Number of reviews contributing to the rating.").optional()
+	}).describe("Variant rating.").optional(),
+	"tags": zod.array(zod.string()).describe("Variant tags for categorization and search.").optional(),
+	"metadata": zod.record(zod.string(), zod.unknown()).describe("Business-defined custom data extending the standard variant model.").optional(),
+	"seller": zod.object({
+		"name": zod.string().describe("Seller display name.").optional(),
+		"links": zod.array(zod.object({
+			"type": zod.string().describe("Type of link. Well-known values: `privacy_policy`, `terms_of_service`, `refund_policy`, `shipping_policy`, `faq`. Consumers SHOULD handle unknown values gracefully by displaying them using the `title` field or omitting the link."),
+			"url": zod.string().url().describe("The actual URL pointing to the content to be displayed."),
+			"title": zod.string().describe("Optional display text for the link. When provided, use this instead of generating from type.").optional()
+		})).describe("Seller policy and information links.").optional()
+	}).describe("Optional seller context for this variant.").optional()
+}).describe("A purchasable variant of a product with specific option selections.");
+const EmbeddedConfigSchema = zod.object({
+	"delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In UCP responses, confirms accepted delegations for this session.").optional(),
+	"color_scheme": zod.array(zod.enum(["light", "dark"])).describe("Color schemes the business supports. Hosts use ec_color_scheme query parameter to request a scheme from this list.").optional()
+}).describe("Per-session configuration for embedded transport binding. Allows businesses to vary EP availability and delegations based on cart contents, agent authorization, or policy.");
 const UcpVersionSchema = zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format.");
-const UcpReverseDomainNameSchema = zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Reverse-domain identifier (e.g., com.google.pay, dev.ucp.shopping.checkout)");
+const UcpVersionConstraintSchema = zod.object({
+	"min": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Minimum required version (inclusive)."),
+	"max": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Maximum compatible version (inclusive). When absent, no upper bound.").optional()
+}).passthrough().describe("Version range requirement with minimum and optional maximum.");
+const UcpRequiresSchema = zod.object({
+	"protocol": zod.object({
+		"min": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Minimum required version (inclusive)."),
+		"max": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Maximum compatible version (inclusive). When absent, no upper bound.").optional()
+	}).passthrough().describe("Required protocol version.").optional(),
+	"capabilities": zod.record(zod.object({
+		"min": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Minimum required version (inclusive)."),
+		"max": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Maximum compatible version (inclusive). When absent, no upper bound.").optional()
+	}).passthrough().describe("Version range requirement with minimum and optional maximum.")).describe("Required capability versions, keyed by capability name. Keys must be a subset of the extension's $defs keys.").optional()
+}).passthrough().describe("Version requirements for extension schemas. Declares minimum (and optionally maximum) protocol and capability versions needed for correct operation.");
 const UcpEntitySchema = zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -1525,6 +2288,157 @@ const UcpEntitySchema = zod.object({
 }).describe("Shared foundation for all UCP entities.");
 const UcpBaseSchema = zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+	"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
+	"services": zod.record(zod.array(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.object({
+		"transport": zod.enum([
+			"rest",
+			"mcp",
+			"a2a",
+			"embedded"
+		]).describe("Transport protocol for this service binding."),
+		"endpoint": zod.string().url().describe("Endpoint URL for this transport binding.").optional()
+	})))).describe("Service registry keyed by reverse-domain name.").optional(),
+	"capabilities": zod.record(zod.array(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+}).describe("Base UCP metadata with shared properties for all schema types.");
+const UcpSuccessSchema = zod.intersection(zod.object({
+	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+	"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
+	"services": zod.record(zod.array(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.object({
+		"transport": zod.enum([
+			"rest",
+			"mcp",
+			"a2a",
+			"embedded"
+		]).describe("Transport protocol for this service binding."),
+		"endpoint": zod.string().url().describe("Endpoint URL for this transport binding.").optional()
+	})))).describe("Service registry keyed by reverse-domain name.").optional(),
+	"capabilities": zod.record(zod.array(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+}).describe("Base UCP metadata with shared properties for all schema types."), zod.object({ "status": zod.literal("success") })).describe("UCP metadata with status 'success'. Use for response branches that carry the expected payload.");
+const UcpErrorSchema = zod.intersection(zod.object({
+	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+	"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
+	"services": zod.record(zod.array(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.object({
+		"transport": zod.enum([
+			"rest",
+			"mcp",
+			"a2a",
+			"embedded"
+		]).describe("Transport protocol for this service binding."),
+		"endpoint": zod.string().url().describe("Endpoint URL for this transport binding.").optional()
+	})))).describe("Service registry keyed by reverse-domain name.").optional(),
+	"capabilities": zod.record(zod.array(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+}).describe("Base UCP metadata with shared properties for all schema types."), zod.object({ "status": zod.literal("error") })).describe("UCP metadata with status 'error'. Use for response branches that carry error information.");
+const UcpPlatformSchema = zod.intersection(zod.object({
+	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+	"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
 	"services": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -1546,17 +2460,87 @@ const UcpBaseSchema = zod.object({
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())))).describe("Payment handler registry keyed by reverse-domain name.").optional()
-}).describe("Base UCP metadata with shared properties for all schema types.");
-const UcpPlatformSchema = zod.intersection(zod.object({
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+}).describe("Base UCP metadata with shared properties for all schema types."), zod.object({
+	"services": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.object({
+		"transport": zod.enum([
+			"rest",
+			"mcp",
+			"a2a",
+			"embedded"
+		]).describe("Transport protocol for this service binding."),
+		"endpoint": zod.string().url().describe("Endpoint URL for this transport binding.").optional()
+	})), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.union([
+		zod.object({ "transport": zod.literal("rest").optional() }),
+		zod.object({ "transport": zod.literal("mcp").optional() }),
+		zod.object({ "transport": zod.literal("a2a").optional() }),
+		zod.object({ "transport": zod.literal("embedded").optional() })
+	]))).describe("Full service declaration for platform-level discovery. All transports require `version`, `spec`, and `transport`. REST and MCP additionally require `schema` and `endpoint`; A2A requires `endpoint`; embedded requires `schema`."))),
+	"capabilities": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })), zod.record(zod.string(), zod.unknown())).describe("Full capability declaration for platform-level discovery. Includes spec/schema URLs for agent fetching."))).optional(),
+	"payment_handlers": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
+		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))), zod.record(zod.string(), zod.unknown())).describe("Platform declaration for discovery profiles. May include partial config state required for discovery.")))
+})).describe("Full UCP metadata for platform-level configuration. Hosted at a URI advertised by the platform in request headers.");
+const UcpBusinessSchema = zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+	"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
 	"services": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -1578,15 +2562,33 @@ const UcpPlatformSchema = zod.intersection(zod.object({
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
 }).describe("Base UCP metadata with shared properties for all schema types."), zod.object({
+	"supported_versions": zod.record(zod.string().url()).describe("Previous protocol versions this business supports, mapped to profile URIs. Businesses that support older protocol versions SHOULD advertise each version and link to its profile. Each URI points to a complete, self-contained profile for that version. When omitted, only `version` is supported.").optional(),
 	"services": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -1601,29 +2603,53 @@ const UcpPlatformSchema = zod.intersection(zod.object({
 			"embedded"
 		]).describe("Transport protocol for this service binding."),
 		"endpoint": zod.string().url().describe("Endpoint URL for this transport binding.").optional()
-	})), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.union([
+	})), zod.union([
 		zod.object({ "transport": zod.literal("rest").optional() }),
 		zod.object({ "transport": zod.literal("mcp").optional() }),
 		zod.object({ "transport": zod.literal("a2a").optional() }),
-		zod.object({ "transport": zod.literal("embedded").optional() })
-	]))).describe("Full service declaration for platform-level discovery. Different transports require different fields."))),
-	"capabilities": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
+		zod.object({
+			"transport": zod.literal("embedded").optional(),
+			"config": zod.object({
+				"delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In UCP responses, confirms accepted delegations for this session.").optional(),
+				"color_scheme": zod.array(zod.enum(["light", "dark"])).describe("Color schemes the business supports. Hosts use ec_color_scheme query parameter to request a scheme from this list.").optional()
+			}).describe("Per-session configuration for embedded transport binding. Allows businesses to vary EP availability and delegations based on cart contents, agent authorization, or policy.").optional()
+		})
+	])).describe("Service binding for business/merchant configuration. May override platform endpoints."))),
+	"capabilities": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })), zod.record(zod.string(), zod.unknown())).describe("Full capability declaration for platform-level discovery. Includes spec/schema URLs for agent fetching."))).optional(),
-	"payment_handlers": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })).describe("Capability configuration for business/merchant level. May include business-specific config overrides."))).optional(),
+	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())), zod.record(zod.string(), zod.unknown())).describe("Platform declaration for discovery profiles. May include partial config state required for discovery.")))
-})).describe("Full UCP metadata for platform-level configuration. Hosted at a URI advertised by the platform in request headers.");
-const UcpBusinessSchema = zod.intersection(zod.object({
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))).describe("Business declaration for discovery profiles. May include partial config state required for discovery.")))
+})).describe("UCP metadata for business/merchant-level configuration. Subset of platform schema with business-specific settings.");
+const UcpResponseCheckoutSchema = zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+	"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
 	"services": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -1645,14 +2671,31 @@ const UcpBusinessSchema = zod.intersection(zod.object({
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
 }).describe("Base UCP metadata with shared properties for all schema types."), zod.object({
 	"services": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
@@ -1674,26 +2717,47 @@ const UcpBusinessSchema = zod.intersection(zod.object({
 		zod.object({ "transport": zod.literal("a2a").optional() }),
 		zod.object({
 			"transport": zod.literal("embedded").optional(),
-			"config": zod.object({ "delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In checkout responses, confirms accepted delegations for this session.").optional() }).describe("Per-checkout configuration for embedded transport binding. Allows businesses to vary ECP availability and delegations based on cart contents, agent authorization, or policy.").optional()
+			"config": zod.object({
+				"delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In UCP responses, confirms accepted delegations for this session.").optional(),
+				"color_scheme": zod.array(zod.enum(["light", "dark"])).describe("Color schemes the business supports. Hosts use ec_color_scheme query parameter to request a scheme from this list.").optional()
+			}).describe("Per-session configuration for embedded transport binding. Allows businesses to vary EP availability and delegations based on cart contents, agent authorization, or policy.").optional()
 		})
-	])).describe("Service binding for business/merchant configuration. May override platform endpoints."))),
+	])).describe("Service binding in API responses. Includes per-resource transport configuration via typed config."))).optional(),
 	"capabilities": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })).describe("Capability configuration for business/merchant level. May include business-specific config overrides."))).optional(),
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities."))).optional(),
 	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())).describe("Business declaration for discovery profiles. May include partial config state required for discovery.")))
-})).describe("UCP metadata for business/merchant-level configuration. Subset of platform schema with business-specific settings.");
-const UcpResponseCheckoutSchema = zod.intersection(zod.object({
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))).describe("Handler reference in responses. May include full config state for runtime usage of the handler.")))
+})).describe("UCP metadata for checkout responses.");
+const UcpResponseOrderSchema = zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+	"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
 	"services": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -1715,16 +2779,56 @@ const UcpResponseCheckoutSchema = zod.intersection(zod.object({
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())))).describe("Payment handler registry keyed by reverse-domain name.").optional()
-}).describe("Base UCP metadata with shared properties for all schema types."), zod.object({
-	"services": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+}).describe("Base UCP metadata with shared properties for all schema types."), zod.object({ "capabilities": zod.record(zod.array(zod.intersection(zod.object({
+	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+	"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+	"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+	"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+	const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+	const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+	const passed = schemas.length - errors.length;
+	if (passed !== 1) ctx.addIssue(errors.length ? {
+		path: ctx.path,
+		code: "invalid_union",
+		unionErrors: errors,
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	} : {
+		path: ctx.path,
+		code: "custom",
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	});
+}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities."))).optional() })).describe("UCP metadata for order responses. No payment handlers needed post-purchase.");
+const UcpResponseCartSchema = zod.intersection(zod.object({
+	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+	"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
+	"services": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
@@ -1738,32 +2842,62 @@ const UcpResponseCheckoutSchema = zod.intersection(zod.object({
 			"embedded"
 		]).describe("Transport protocol for this service binding."),
 		"endpoint": zod.string().url().describe("Endpoint URL for this transport binding.").optional()
-	})), zod.union([
-		zod.object({ "transport": zod.literal("rest").optional() }),
-		zod.object({ "transport": zod.literal("mcp").optional() }),
-		zod.object({ "transport": zod.literal("a2a").optional() }),
-		zod.object({
-			"transport": zod.literal("embedded").optional(),
-			"config": zod.object({ "delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In checkout responses, confirms accepted delegations for this session.").optional() }).describe("Per-checkout configuration for embedded transport binding. Allows businesses to vary ECP availability and delegations based on cart contents, agent authorization, or policy.").optional()
-		})
-	])).describe("Service binding in API responses. Includes per-resource transport configuration via typed config."))).optional(),
+	})))).describe("Service registry keyed by reverse-domain name.").optional(),
 	"capabilities": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities."))).optional(),
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())).describe("Handler reference in responses. May include full config state for runtime usage of the handler.")))
-})).describe("UCP metadata for checkout responses.");
-const UcpResponseOrderSchema = zod.intersection(zod.object({
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+}).describe("Base UCP metadata with shared properties for all schema types."), zod.object({ "capabilities": zod.record(zod.array(zod.intersection(zod.object({
+	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
+	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
+	"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
+	"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
+	"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
+}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+	const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+	const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+	const passed = schemas.length - errors.length;
+	if (passed !== 1) ctx.addIssue(errors.length ? {
+		path: ctx.path,
+		code: "invalid_union",
+		unionErrors: errors,
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	} : {
+		path: ctx.path,
+		code: "custom",
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	});
+}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities."))).optional() })).describe("UCP metadata for cart responses. No payment handlers needed pre-checkout.");
+const UcpResponseCatalogSchema = zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+	"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
 	"services": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -1785,21 +2919,52 @@ const UcpResponseOrderSchema = zod.intersection(zod.object({
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
 }).describe("Base UCP metadata with shared properties for all schema types."), zod.object({ "capabilities": zod.record(zod.array(zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("Entity version in YYYY-MM-DD format."),
 	"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 	"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 	"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 	"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities."))).optional() })).describe("UCP metadata for order responses. No payment handlers needed post-purchase.");
+}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+	const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+	const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+	const passed = schemas.length - errors.length;
+	if (passed !== 1) ctx.addIssue(errors.length ? {
+		path: ctx.path,
+		code: "invalid_union",
+		unionErrors: errors,
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	} : {
+		path: ctx.path,
+		code: "custom",
+		message: "Invalid input: Should pass single schema. Passed " + passed
+	});
+}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })).describe("Capability reference in responses. Only name/version required to confirm active capabilities."))).optional() })).describe("UCP metadata for catalog responses.");
 const ProfileSchemaSigningKeySchema = zod.object({
 	"kid": zod.string().describe("Key ID. Referenced in signature headers to identify which key to use for verification."),
 	"kty": zod.string().describe("Key type (e.g., 'EC', 'RSA')."),
@@ -1814,6 +2979,7 @@ const ProfileSchemaSigningKeySchema = zod.object({
 const ProfileSchemaBaseSchema = zod.object({
 	"ucp": zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+		"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
 		"services": zod.record(zod.array(zod.intersection(zod.object({
 			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -1835,14 +3001,31 @@ const ProfileSchemaBaseSchema = zod.object({
 			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+			const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+			const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+			const passed = schemas.length - errors.length;
+			if (passed !== 1) ctx.addIssue(errors.length ? {
+				path: ctx.path,
+				code: "invalid_union",
+				unionErrors: errors,
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			} : {
+				path: ctx.path,
+				code: "custom",
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			});
+		}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 		"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-		}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+		}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+			"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+			"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+		}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
 	}).describe("Base UCP metadata with shared properties for all schema types."),
 	"signing_keys": zod.array(zod.object({
 		"kid": zod.string().describe("Key ID. Referenced in signature headers to identify which key to use for verification."),
@@ -1859,6 +3042,7 @@ const ProfileSchemaBaseSchema = zod.object({
 const ProfileSchemaPlatformProfileSchema = zod.intersection(zod.object({
 	"ucp": zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+		"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
 		"services": zod.record(zod.array(zod.intersection(zod.object({
 			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -1880,14 +3064,31 @@ const ProfileSchemaPlatformProfileSchema = zod.intersection(zod.object({
 			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+			const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+			const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+			const passed = schemas.length - errors.length;
+			if (passed !== 1) ctx.addIssue(errors.length ? {
+				path: ctx.path,
+				code: "invalid_union",
+				unionErrors: errors,
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			} : {
+				path: ctx.path,
+				code: "custom",
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			});
+		}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 		"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-		}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+		}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+			"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+			"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+		}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
 	}).describe("Base UCP metadata with shared properties for all schema types."),
 	"signing_keys": zod.array(zod.object({
 		"kid": zod.string().describe("Key ID. Referenced in signature headers to identify which key to use for verification."),
@@ -1902,6 +3103,7 @@ const ProfileSchemaPlatformProfileSchema = zod.intersection(zod.object({
 	}).describe("Public key for signature verification in JWK format.")).describe("Public keys for signature verification (JWK format). Used to verify signed responses, webhooks, and other authenticated messages from this party.").optional()
 }).passthrough().describe("Base discovery profile with shared properties for all profile types."), zod.object({ "ucp": zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+	"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
 	"services": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -1923,14 +3125,31 @@ const ProfileSchemaPlatformProfileSchema = zod.intersection(zod.object({
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
 }).describe("Base UCP metadata with shared properties for all schema types."), zod.object({
 	"services": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
@@ -1951,25 +3170,43 @@ const ProfileSchemaPlatformProfileSchema = zod.intersection(zod.object({
 		zod.object({ "transport": zod.literal("mcp").optional() }),
 		zod.object({ "transport": zod.literal("a2a").optional() }),
 		zod.object({ "transport": zod.literal("embedded").optional() })
-	]))).describe("Full service declaration for platform-level discovery. Different transports require different fields."))),
+	]))).describe("Full service declaration for platform-level discovery. All transports require `version`, `spec`, and `transport`. REST and MCP additionally require `schema` and `endpoint`; A2A requires `endpoint`; embedded requires `schema`."))),
 	"capabilities": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })), zod.record(zod.string(), zod.unknown())).describe("Full capability declaration for platform-level discovery. Includes spec/schema URLs for agent fetching."))).optional(),
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })), zod.record(zod.string(), zod.unknown())).describe("Full capability declaration for platform-level discovery. Includes spec/schema URLs for agent fetching."))).optional(),
 	"payment_handlers": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())), zod.record(zod.string(), zod.unknown())).describe("Platform declaration for discovery profiles. May include partial config state required for discovery.")))
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))), zod.record(zod.string(), zod.unknown())).describe("Platform declaration for discovery profiles. May include partial config state required for discovery.")))
 })).describe("Full UCP metadata for platform-level configuration. Hosted at a URI advertised by the platform in request headers.").optional() })).describe("Full discovery profile for platforms. Exposes complete service, capability, and payment handler registries.");
 const ProfileSchemaBusinessProfileSchema = zod.intersection(zod.object({
 	"ucp": zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+		"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
 		"services": zod.record(zod.array(zod.intersection(zod.object({
 			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -1991,14 +3228,31 @@ const ProfileSchemaBusinessProfileSchema = zod.intersection(zod.object({
 			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+		}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+			const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+			const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+			const passed = schemas.length - errors.length;
+			if (passed !== 1) ctx.addIssue(errors.length ? {
+				path: ctx.path,
+				code: "invalid_union",
+				unionErrors: errors,
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			} : {
+				path: ctx.path,
+				code: "custom",
+				message: "Invalid input: Should pass single schema. Passed " + passed
+			});
+		}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 		"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 			"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 			"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 			"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 			"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 			"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-		}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+		}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+			"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+			"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+		}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
 	}).describe("Base UCP metadata with shared properties for all schema types."),
 	"signing_keys": zod.array(zod.object({
 		"kid": zod.string().describe("Key ID. Referenced in signature headers to identify which key to use for verification."),
@@ -2013,6 +3267,7 @@ const ProfileSchemaBusinessProfileSchema = zod.intersection(zod.object({
 	}).describe("Public key for signature verification in JWK format.")).describe("Public keys for signature verification (JWK format). Used to verify signed responses, webhooks, and other authenticated messages from this party.").optional()
 }).passthrough().describe("Base discovery profile with shared properties for all profile types."), zod.object({ "ucp": zod.intersection(zod.object({
 	"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
+	"status": zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.").default("success"),
 	"services": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -2034,15 +3289,33 @@ const ProfileSchemaBusinessProfileSchema = zod.intersection(zod.object({
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })))).describe("Capability registry keyed by reverse-domain name.").optional(),
 	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())))).describe("Payment handler registry keyed by reverse-domain name.").optional()
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))))).describe("Payment handler registry keyed by reverse-domain name.").optional()
 }).describe("Base UCP metadata with shared properties for all schema types."), zod.object({
+	"supported_versions": zod.record(zod.string().url()).describe("Previous protocol versions this business supports, mapped to profile URIs. Businesses that support older protocol versions SHOULD advertise each version and link to its profile. Each URI points to a complete, self-contained profile for that version. When omitted, only `version` is supported.").optional(),
 	"services": zod.record(zod.array(zod.intersection(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
@@ -2063,7 +3336,10 @@ const ProfileSchemaBusinessProfileSchema = zod.intersection(zod.object({
 		zod.object({ "transport": zod.literal("a2a").optional() }),
 		zod.object({
 			"transport": zod.literal("embedded").optional(),
-			"config": zod.object({ "delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In checkout responses, confirms accepted delegations for this session.").optional() }).describe("Per-checkout configuration for embedded transport binding. Allows businesses to vary ECP availability and delegations based on cart contents, agent authorization, or policy.").optional()
+			"config": zod.object({
+				"delegate": zod.array(zod.string()).describe("Delegations the business allows. At service-level, declares available delegations. In UCP responses, confirms accepted delegations for this session.").optional(),
+				"color_scheme": zod.array(zod.enum(["light", "dark"])).describe("Color schemes the business supports. Hosts use ec_color_scheme query parameter to request a scheme from this list.").optional()
+			}).describe("Per-session configuration for embedded transport binding. Allows businesses to vary EP availability and delegations based on cart contents, agent authorization, or policy.").optional()
 		})
 	])).describe("Service binding for business/merchant configuration. May override platform endpoints."))),
 	"capabilities": zod.record(zod.array(zod.intersection(zod.object({
@@ -2072,14 +3348,31 @@ const ProfileSchemaBusinessProfileSchema = zod.intersection(zod.object({
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")).describe("Parent capability this extends. Present for extensions, absent for root capabilities.").optional() })).describe("Capability configuration for business/merchant level. May include business-specific config overrides."))).optional(),
+	}).describe("Shared foundation for all UCP entities."), zod.object({ "extends": zod.unknown().superRefine((x, ctx) => {
+		const schemas = [zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$")), zod.array(zod.string().regex(/* @__PURE__ */ new RegExp("^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9_]*)+$"))).min(1)];
+		const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
+		const passed = schemas.length - errors.length;
+		if (passed !== 1) ctx.addIssue(errors.length ? {
+			path: ctx.path,
+			code: "invalid_union",
+			unionErrors: errors,
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		} : {
+			path: ctx.path,
+			code: "custom",
+			message: "Invalid input: Should pass single schema. Passed " + passed
+		});
+	}).describe("Parent capability(s) this extends. Present for extensions, absent for root capabilities. Use array for multi-parent extensions.").optional() })).describe("Capability configuration for business/merchant level. May include business-specific config overrides."))).optional(),
 	"payment_handlers": zod.record(zod.array(zod.intersection(zod.object({
 		"version": zod.string().regex(/* @__PURE__ */ new RegExp("^\\d{4}-\\d{2}-\\d{2}$")).describe("UCP version in YYYY-MM-DD format."),
 		"spec": zod.string().url().describe("URL to human-readable specification document.").optional(),
 		"schema": zod.string().url().describe("URL to JSON Schema defining this entity's structure and payloads.").optional(),
 		"id": zod.string().describe("Unique identifier for this entity instance. Used to disambiguate when multiple instances exist.").optional(),
 		"config": zod.record(zod.string(), zod.unknown()).describe("Entity-specific configuration. Structure defined by each entity's schema.").optional()
-	}).describe("Shared foundation for all UCP entities."), zod.record(zod.string(), zod.unknown())).describe("Business declaration for discovery profiles. May include partial config state required for discovery.")))
+	}).describe("Shared foundation for all UCP entities."), zod.intersection(zod.record(zod.string(), zod.unknown()), zod.object({ "available_instruments": zod.array(zod.object({
+		"type": zod.string().describe("The instrument type identifier (e.g., 'card', 'gift_card'). References an instrument schema's type constant."),
+		"constraints": zod.record(zod.string(), zod.unknown()).describe("Constraints on this instrument type. Structure depends on instrument type and active capabilities.").optional()
+	}).describe("An instrument type available from a payment handler with optional constraints.")).min(1).describe("Instrument types this handler supports, with optional constraints. When absent, every instrument should be considered available.").optional() }))).describe("Business declaration for discovery profiles. May include partial config state required for discovery.")))
 })).describe("UCP metadata for business/merchant-level configuration. Subset of platform schema with business-specific settings.").optional() })).describe("Discovery profile for businesses/merchants. Subset of platform profile with business-specific configuration.");
 const ServiceBaseTransportEnumSchema = zod.enum([
 	"rest",
@@ -2117,24 +3410,18 @@ const MessageErrorContentTypeEnumSchema = zod.enum(["plain", "markdown"]).descri
 const MessageErrorSeverityEnumSchema = zod.enum([
 	"recoverable",
 	"requires_buyer_input",
-	"requires_buyer_review"
-]).describe("Declares who resolves this error. 'recoverable': agent can fix via API. 'requires_buyer_input': merchant requires information their API doesn't support collecting programmatically (checkout incomplete). 'requires_buyer_review': buyer must authorize before order placement due to policy, regulatory, or entitlement rules (checkout complete). Errors with 'requires_*' severity contribute to 'status: requires_escalation'.");
+	"requires_buyer_review",
+	"unrecoverable"
+]).describe("Reflects the resource state and recommended action. 'recoverable': platform can resolve by modifying inputs and retrying via API. 'requires_buyer_input': merchant requires information their API doesn't support collecting programmatically (checkout incomplete). 'requires_buyer_review': buyer must authorize before order placement due to policy, regulatory, or entitlement rules. 'unrecoverable': no valid resource exists to act on, retry with new resource or inputs. Errors with 'requires_*' severity contribute to 'status: requires_escalation'.");
 const MessageInfoContentTypeEnumSchema = zod.enum(["plain", "markdown"]).describe("Content format, default = plain.");
 const MessageWarningContentTypeEnumSchema = zod.enum(["plain", "markdown"]).describe("Content format, default = plain.");
 const OrderLineItemStatusEnumSchema = zod.enum([
 	"processing",
 	"partial",
-	"fulfilled"
-]).describe("Derived status: fulfilled if quantity.fulfilled == quantity.total, partial if quantity.fulfilled > 0, otherwise processing.");
-const TotalTypeEnumSchema = zod.enum([
-	"items_discount",
-	"subtotal",
-	"discount",
-	"fulfillment",
-	"tax",
-	"fee",
-	"total"
-]).describe("Type of total categorization.");
+	"fulfilled",
+	"removed"
+]).describe("Derived status: removed if quantity.total == 0, fulfilled if quantity.total > 0 and quantity.fulfilled == quantity.total, partial if quantity.total > 0 and quantity.fulfilled > 0, otherwise processing.");
+const UcpBaseStatusEnumSchema = zod.enum(["success", "error"]).describe("Application-level status of the UCP operation.");
 const ProfileSchemaSigningKeyUseEnumSchema = zod.enum(["sig", "enc"]).describe("Key usage. Should be 'sig' for signing keys.");
 //#endregion
 //#region src/extensions.ts
@@ -2156,11 +3443,13 @@ const OrderUpdateSchema = OrderSchema;
 exports.AccountInfoSchema = AccountInfoSchema;
 exports.AdjustmentSchema = AdjustmentSchema;
 exports.AdjustmentStatusEnumSchema = AdjustmentStatusEnumSchema;
+exports.AmountSchema = AmountSchema;
 exports.Ap2MandateAp2WithCheckoutMandateSchema = Ap2MandateAp2WithCheckoutMandateSchema;
 exports.Ap2MandateAp2WithMerchantAuthorizationSchema = Ap2MandateAp2WithMerchantAuthorizationSchema;
 exports.Ap2MandateCheckoutMandateSchema = Ap2MandateCheckoutMandateSchema;
 exports.Ap2MandateErrorCodeSchema = Ap2MandateErrorCodeSchema;
 exports.Ap2MandateMerchantAuthorizationSchema = Ap2MandateMerchantAuthorizationSchema;
+exports.AvailablePaymentInstrumentSchema = AvailablePaymentInstrumentSchema;
 exports.BindingSchema = BindingSchema;
 exports.BusinessFulfillmentConfigSchema = BusinessFulfillmentConfigSchema;
 exports.BuyerConsentBuyerSchema = BuyerConsentBuyerSchema;
@@ -2172,7 +3461,13 @@ exports.CapabilityPlatformSchema = CapabilityPlatformSchema;
 exports.CapabilityResponseSchema = CapabilityResponseSchema;
 exports.CardCredentialCardNumberTypeEnumSchema = CardCredentialCardNumberTypeEnumSchema;
 exports.CardCredentialSchema = CardCredentialSchema;
-exports.CardPaymentInstrumentSchema = CardPaymentInstrumentSchema;
+exports.CardPaymentInstrumentAvailableCardPaymentInstrumentSchema = CardPaymentInstrumentAvailableCardPaymentInstrumentSchema;
+exports.CartCreateRequestSchema = CartCreateRequestSchema;
+exports.CartSchema = CartSchema;
+exports.CartUpdateRequestSchema = CartUpdateRequestSchema;
+exports.CatalogLookupSchema = CatalogLookupSchema;
+exports.CatalogSearchSchema = CatalogSearchSchema;
+exports.CategorySchema = CategorySchema;
 exports.CheckoutCompleteRequestSchema = CheckoutCompleteRequestSchema;
 exports.CheckoutCreateRequestSchema = CheckoutCreateRequestSchema;
 exports.CheckoutResponseSchema = CheckoutResponseSchema;
@@ -2181,11 +3476,15 @@ exports.CheckoutSchema = CheckoutSchema;
 exports.CheckoutStatusEnumSchema = CheckoutStatusEnumSchema;
 exports.CheckoutUpdateRequestSchema = CheckoutUpdateRequestSchema;
 exports.ContextSchema = ContextSchema;
+exports.DescriptionSchema = DescriptionSchema;
+exports.DetailOptionValueSchema = DetailOptionValueSchema;
 exports.DiscountAllocationSchema = DiscountAllocationSchema;
 exports.DiscountAppliedDiscountMethodEnumSchema = DiscountAppliedDiscountMethodEnumSchema;
 exports.DiscountAppliedDiscountSchema = DiscountAppliedDiscountSchema;
 exports.DiscountDiscountsObjectSchema = DiscountDiscountsObjectSchema;
 exports.EmbeddedConfigSchema = EmbeddedConfigSchema;
+exports.ErrorCodeSchema = ErrorCodeSchema;
+exports.ErrorResponseSchema = ErrorResponseSchema;
 exports.ExpectationMethodTypeEnumSchema = ExpectationMethodTypeEnumSchema;
 exports.ExpectationSchema = ExpectationSchema;
 exports.FulfillmentAvailableMethodSchema = FulfillmentAvailableMethodSchema;
@@ -2207,12 +3506,14 @@ exports.FulfillmentMethodUpdateRequestSchema = FulfillmentMethodUpdateRequestSch
 exports.FulfillmentOptionSchema = FulfillmentOptionSchema;
 exports.FulfillmentResponseSchema = FulfillmentResponseSchema;
 exports.FulfillmentSchema = FulfillmentSchema;
+exports.InputCorrelationSchema = InputCorrelationSchema;
 exports.ItemResponseSchema = ItemResponseSchema;
 exports.ItemSchema = ItemSchema;
 exports.LineItemResponseSchema = LineItemResponseSchema;
 exports.LineItemSchema = LineItemSchema;
 exports.LineItemUpdateRequestSchema = LineItemUpdateRequestSchema;
 exports.LinkSchema = LinkSchema;
+exports.MediaSchema = MediaSchema;
 exports.MerchantFulfillmentConfigSchema = MerchantFulfillmentConfigSchema;
 exports.MessageErrorContentTypeEnumSchema = MessageErrorContentTypeEnumSchema;
 exports.MessageErrorSchema = MessageErrorSchema;
@@ -2222,11 +3523,13 @@ exports.MessageInfoSchema = MessageInfoSchema;
 exports.MessageSchema = MessageSchema;
 exports.MessageWarningContentTypeEnumSchema = MessageWarningContentTypeEnumSchema;
 exports.MessageWarningSchema = MessageWarningSchema;
+exports.OptionValueSchema = OptionValueSchema;
 exports.OrderConfirmationSchema = OrderConfirmationSchema;
 exports.OrderLineItemSchema = OrderLineItemSchema;
 exports.OrderLineItemStatusEnumSchema = OrderLineItemStatusEnumSchema;
 exports.OrderSchema = OrderSchema;
 exports.OrderUpdateSchema = OrderUpdateSchema;
+exports.PaginationSchema = PaginationSchema;
 exports.PaymentCredentialSchema = PaymentCredentialSchema;
 exports.PaymentHandlerBaseSchema = PaymentHandlerBaseSchema;
 exports.PaymentHandlerBusinessSchema = PaymentHandlerBusinessSchema;
@@ -2239,31 +3542,49 @@ exports.PaymentResponseSchema = PaymentResponseSchema;
 exports.PaymentSchema = PaymentSchema;
 exports.PlatformFulfillmentConfigSchema = PlatformFulfillmentConfigSchema;
 exports.PostalAddressSchema = PostalAddressSchema;
+exports.PriceFilterSchema = PriceFilterSchema;
+exports.PriceRangeSchema = PriceRangeSchema;
+exports.PriceSchema = PriceSchema;
+exports.ProductOptionSchema = ProductOptionSchema;
+exports.ProductSchema = ProductSchema;
 exports.ProfileSchemaBaseSchema = ProfileSchemaBaseSchema;
 exports.ProfileSchemaBusinessProfileSchema = ProfileSchemaBusinessProfileSchema;
 exports.ProfileSchemaPlatformProfileSchema = ProfileSchemaPlatformProfileSchema;
 exports.ProfileSchemaSigningKeySchema = ProfileSchemaSigningKeySchema;
 exports.ProfileSchemaSigningKeyUseEnumSchema = ProfileSchemaSigningKeyUseEnumSchema;
+exports.RatingSchema = RatingSchema;
 exports.RetailLocationSchema = RetailLocationSchema;
+exports.ReverseDomainNameSchema = ReverseDomainNameSchema;
+exports.SearchFiltersSchema = SearchFiltersSchema;
+exports.SelectedOptionSchema = SelectedOptionSchema;
 exports.ServiceBaseSchema = ServiceBaseSchema;
 exports.ServiceBaseTransportEnumSchema = ServiceBaseTransportEnumSchema;
 exports.ServiceBusinessSchema = ServiceBusinessSchema;
 exports.ServicePlatformSchema = ServicePlatformSchema;
 exports.ServiceResponseSchema = ServiceResponseSchema;
 exports.ShippingDestinationSchema = ShippingDestinationSchema;
+exports.SignalsSchema = SignalsSchema;
+exports.SignedAmountSchema = SignedAmountSchema;
 exports.TokenCredentialSchema = TokenCredentialSchema;
 exports.TotalResponseSchema = TotalResponseSchema;
 exports.TotalSchema = TotalSchema;
-exports.TotalTypeEnumSchema = TotalTypeEnumSchema;
+exports.TotalsSchema = TotalsSchema;
 exports.UcpBaseSchema = UcpBaseSchema;
+exports.UcpBaseStatusEnumSchema = UcpBaseStatusEnumSchema;
 exports.UcpBusinessSchema = UcpBusinessSchema;
 exports.UcpDiscoveryBusinessProfileSchema = UcpDiscoveryBusinessProfileSchema;
 exports.UcpDiscoveryPlatformProfileSchema = UcpDiscoveryPlatformProfileSchema;
 exports.UcpDiscoveryProfileSchema = UcpDiscoveryProfileSchema;
 exports.UcpEntitySchema = UcpEntitySchema;
+exports.UcpErrorSchema = UcpErrorSchema;
 exports.UcpPlatformSchema = UcpPlatformSchema;
+exports.UcpRequiresSchema = UcpRequiresSchema;
+exports.UcpResponseCartSchema = UcpResponseCartSchema;
+exports.UcpResponseCatalogSchema = UcpResponseCatalogSchema;
 exports.UcpResponseCheckoutSchema = UcpResponseCheckoutSchema;
 exports.UcpResponseOrderSchema = UcpResponseOrderSchema;
-exports.UcpReverseDomainNameSchema = UcpReverseDomainNameSchema;
 exports.UcpSigningKeySchema = UcpSigningKeySchema;
+exports.UcpSuccessSchema = UcpSuccessSchema;
+exports.UcpVersionConstraintSchema = UcpVersionConstraintSchema;
 exports.UcpVersionSchema = UcpVersionSchema;
+exports.VariantSchema = VariantSchema;