@omnixhq/ucp-client 2.3.0 → 2.5.0

package/dist/index.js

@@ -1,35 +1,19 @@
 import { UCPError, UCPEscalationError, UCPIdempotencyConflictError, UCPOAuthError } from "./errors-DX7yw6Gl.js";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
-import { AccountInfoSchema, AdjustmentSchema, Ap2MandateAp2WithCheckoutMandateSchema, Ap2MandateAp2WithMerchantAuthorizationSchema, Ap2MandateCheckoutMandateSchema, Ap2MandateErrorCodeSchema, Ap2MandateMerchantAuthorizationSchema, BindingSchema, BusinessFulfillmentConfigSchema, BuyerConsentBuyerSchema, BuyerConsentConsentSchema, BuyerSchema, CapabilityBaseSchema, CapabilityBusinessSchema, CapabilityPlatformSchema, CapabilityResponseSchema, CardCredentialSchema, CardPaymentInstrumentSchema, CheckoutCompleteRequestSchema, CheckoutCreateRequestSchema, CheckoutResponseSchema, CheckoutResponseStatusSchema, CheckoutSchema, CheckoutUpdateRequestSchema, ContextSchema, DiscountAllocationSchema, DiscountAppliedDiscountSchema, DiscountDiscountsObjectSchema, EmbeddedConfigSchema, ExpectationSchema, FulfillmentAvailableMethodSchema, FulfillmentDestinationSchema, FulfillmentEventSchema, FulfillmentExtensionFulfillmentAvailableMethodSchema, FulfillmentExtensionFulfillmentGroupSchema, FulfillmentExtensionFulfillmentMethodSchema, FulfillmentExtensionFulfillmentOptionSchema, FulfillmentExtensionFulfillmentSchema, FulfillmentGroupSchema, FulfillmentGroupUpdateRequestSchema, FulfillmentMethodCreateRequestSchema, FulfillmentMethodResponseSchema, FulfillmentMethodSchema, FulfillmentMethodUpdateRequestSchema, FulfillmentOptionSchema, FulfillmentResponseSchema, FulfillmentSchema, ItemResponseSchema, ItemSchema, LineItemResponseSchema, LineItemSchema, LineItemUpdateRequestSchema, LinkSchema, MerchantFulfillmentConfigSchema, MessageErrorSchema, MessageInfoSchema, MessageSchema, MessageWarningSchema, OrderConfirmationSchema, OrderLineItemSchema, OrderSchema, OrderUpdateSchema, PaymentCredentialSchema, PaymentHandlerBaseSchema, PaymentHandlerBusinessSchema, PaymentHandlerPlatformSchema, PaymentHandlerResponseSchema, PaymentIdentitySchema, PaymentInstrumentResponseSchema, PaymentInstrumentSchema, PaymentResponseSchema, PaymentSchema, PlatformFulfillmentConfigSchema, PostalAddressSchema, RetailLocationSchema, ServiceBaseSchema, ServiceBusinessSchema, ServicePlatformSchema, ServiceResponseSchema, ShippingDestinationSchema, TokenCredentialSchema, TotalResponseSchema, TotalSchema, UcpBaseSchema, UcpBusinessSchema, UcpDiscoveryProfileSchema, UcpEntitySchema, UcpPlatformSchema, UcpResponseCheckoutSchema, UcpResponseOrderSchema, UcpReverseDomainNameSchema, UcpVersionSchema } from "@omnixhq/ucp-js-sdk";
+import { AccountInfoSchema, AdjustmentSchema, AdjustmentStatusEnumSchema, Ap2MandateAp2WithCheckoutMandateSchema, Ap2MandateAp2WithMerchantAuthorizationSchema, Ap2MandateCheckoutMandateSchema, Ap2MandateErrorCodeSchema, Ap2MandateMerchantAuthorizationSchema, BindingSchema, BusinessFulfillmentConfigSchema, BuyerConsentBuyerSchema, BuyerConsentConsentSchema, BuyerSchema, CapabilityBaseSchema, CapabilityBusinessSchema, CapabilityPlatformSchema, CapabilityResponseSchema, CardCredentialCardNumberTypeEnumSchema, CardCredentialSchema, CardPaymentInstrumentSchema, CheckoutCompleteRequestSchema, CheckoutCreateRequestSchema, CheckoutResponseSchema, CheckoutResponseStatusSchema, CheckoutSchema, CheckoutStatusEnumSchema, CheckoutUpdateRequestSchema, ContextSchema, DiscountAllocationSchema, DiscountAppliedDiscountMethodEnumSchema, DiscountAppliedDiscountSchema, DiscountDiscountsObjectSchema, EmbeddedConfigSchema, ExpectationMethodTypeEnumSchema, ExpectationSchema, FulfillmentAvailableMethodSchema, FulfillmentAvailableMethodTypeEnumSchema, FulfillmentDestinationSchema, FulfillmentEventSchema, FulfillmentExtensionFulfillmentAvailableMethodSchema, FulfillmentExtensionFulfillmentGroupSchema, FulfillmentExtensionFulfillmentMethodSchema, FulfillmentExtensionFulfillmentOptionSchema, FulfillmentExtensionFulfillmentSchema, FulfillmentGroupSchema, FulfillmentGroupUpdateRequestSchema, FulfillmentMethodCreateRequestSchema, FulfillmentMethodResponseSchema, FulfillmentMethodSchema, FulfillmentMethodTypeEnumSchema, FulfillmentMethodUpdateRequestSchema, FulfillmentOptionSchema, FulfillmentResponseSchema, FulfillmentSchema, ItemResponseSchema, ItemSchema, LineItemResponseSchema, LineItemSchema, LineItemUpdateRequestSchema, LinkSchema, MerchantFulfillmentConfigSchema, MessageErrorContentTypeEnumSchema, MessageErrorSchema, MessageErrorSeverityEnumSchema, MessageInfoContentTypeEnumSchema, MessageInfoSchema, MessageSchema, MessageWarningContentTypeEnumSchema, MessageWarningSchema, OrderConfirmationSchema, OrderLineItemSchema, OrderLineItemStatusEnumSchema, OrderSchema, OrderUpdateSchema, PaymentCredentialSchema, PaymentHandlerBaseSchema, PaymentHandlerBusinessSchema, PaymentHandlerPlatformSchema, PaymentHandlerResponseSchema, PaymentIdentitySchema, PaymentInstrumentResponseSchema, PaymentInstrumentSchema, PaymentResponseSchema, PaymentSchema, PlatformFulfillmentConfigSchema, PostalAddressSchema, ProfileSchemaBaseSchema, ProfileSchemaBusinessProfileSchema, ProfileSchemaPlatformProfileSchema, ProfileSchemaSigningKeySchema, ProfileSchemaSigningKeyUseEnumSchema, RetailLocationSchema, ServiceBaseSchema, ServiceBaseTransportEnumSchema, ServiceBusinessSchema, ServicePlatformSchema, ServiceResponseSchema, ShippingDestinationSchema, TokenCredentialSchema, TotalResponseSchema, TotalSchema, TotalTypeEnumSchema, UcpBaseSchema, UcpBusinessSchema, UcpDiscoveryBusinessProfileSchema, UcpDiscoveryPlatformProfileSchema, UcpDiscoveryProfileSchema, UcpEntitySchema, UcpPlatformSchema, UcpResponseCheckoutSchema, UcpResponseOrderSchema, UcpReverseDomainNameSchema, UcpSigningKeySchema, UcpVersionSchema } from "@omnixhq/ucp-js-sdk";
 
 //#region src/schemas.ts
-const CheckoutSessionSchema = CheckoutResponseSchema.passthrough();
-const UCPProfileSchema = UcpDiscoveryProfileSchema.passthrough();
-const CreateCheckoutRequestSchema = CheckoutCreateRequestSchema.passthrough();
-const UpdateCheckoutRequestSchema = CheckoutUpdateRequestSchema.passthrough();
-const CompleteCheckoutRequestSchema = CheckoutCompleteRequestSchema.passthrough();
-/** @deprecated Removed from ucp-js-sdk 1.0.2. Use PaymentCredentialSchema instead. */
-const ExtendedPaymentCredentialSchema = z.object({
-	type: z.string(),
-	token: z.string().optional()
-}).passthrough();
-/** @deprecated Removed from ucp-js-sdk 1.0.2. Will be removed in a future major version. */
-const PlatformConfigSchema = z.object({ webhook_url: z.string().optional() }).passthrough();
+const CheckoutSessionSchema = CheckoutResponseSchema;
+const UCPProfileSchema = UcpDiscoveryProfileSchema;
+const CreateCheckoutRequestSchema = CheckoutCreateRequestSchema;
+const UpdateCheckoutRequestSchema = CheckoutUpdateRequestSchema;
+const CompleteCheckoutRequestSchema = CheckoutCompleteRequestSchema;
 const WebhookEventSchema = z.object({
 	event_id: z.string(),
 	created_time: z.string(),
-	order: OrderSchema.passthrough()
-}).passthrough();
-const JWKSchema = z.object({
-	kty: z.string(),
-	kid: z.string().optional(),
-	use: z.string().optional(),
-	alg: z.string().optional(),
-	crv: z.string().optional(),
-	x: z.string().optional(),
-	y: z.string().optional()
-}).passthrough();
+	order: OrderSchema
+});
 
 //#endregion
 //#region src/http.ts
@@ -46,7 +30,7 @@ var HttpClient = class HttpClient {
 		this.ucpVersion = config.ucpVersion;
 		this.requestSignature = config.requestSignature;
 		this.accessToken = config.accessToken;
-		this.onValidationWarning = config.onValidationWarning ?? ((msg, detail) => console.warn(msg, detail));
+		this.onValidationWarning = config.onValidationWarning ?? (() => void 0);
 	}
 	withAccessToken(token) {
 		return new HttpClient({
@@ -87,21 +71,18 @@ var HttpClient = class HttpClient {
 		return result.data;
 	}
 	throwFromResponse(data, statusCode) {
-		if (typeof data !== "object" || data === null) {
-			if (statusCode === 409) throw new UCPIdempotencyConflictError();
-			throw new UCPError("HTTP_ERROR", `Gateway returned ${statusCode}`, "error", statusCode);
-		}
-		const body = data;
-		const rawMessages = body["messages"];
-		if (Array.isArray(rawMessages) && rawMessages.length > 0) {
-			const allMessages = parseMessages(rawMessages);
-			const first = allMessages[0];
-			const code = first.code ?? "UNKNOWN";
-			throw new UCPError(code, first.content, first.type, statusCode, {
-				...first.path !== void 0 ? { path: first.path } : {},
-				...first.content_type !== void 0 ? { contentType: first.content_type } : {},
-				messages: allMessages
-			});
+		if (typeof data === "object" && data !== null && Array.isArray(data["messages"])) {
+			const rawMessages = data["messages"];
+			if (rawMessages.length > 0) {
+				const allMessages = parseMessages(rawMessages);
+				const first = allMessages[0];
+				const code = first.code ?? "UNKNOWN";
+				throw new UCPError(code, first.content, first.type, statusCode, {
+					...first.path !== void 0 ? { path: first.path } : {},
+					...first.content_type !== void 0 ? { contentType: first.content_type } : {},
+					messages: allMessages
+				});
+			}
 		}
 		if (statusCode === 409) throw new UCPIdempotencyConflictError();
 		throw new UCPError("HTTP_ERROR", `Gateway returned ${statusCode}`, "error", statusCode);
@@ -151,10 +132,7 @@ function parseMessages(rawMessages) {
 		return {
 			type,
 			content: String(record["content"] ?? "Unknown error"),
-			...record["code"] !== void 0 ? { code: String(record["code"]) } : {},
-			...record["severity"] !== void 0 ? { severity: String(record["severity"]) } : {},
-			...record["path"] !== void 0 ? { path: String(record["path"]) } : {},
-			...record["content_type"] !== void 0 ? { content_type: String(record["content_type"]) } : {}
+			...record["code"] !== void 0 ? { code: String(record["code"]) } : {}
 		};
 	});
 }
@@ -194,44 +172,48 @@ var CheckoutCapability = class {
 		const data = await this.http.request("POST", `/checkout-sessions/${encodeURIComponent(id)}/cancel`);
 		return this.validateSession(data);
 	}
-	async setFulfillment(id, type, patch) {
-		return this.update(id, {
-			...patch,
-			fulfillment: { methods: [{
-				id: DEFAULT_METHOD_ID,
-				type
-			}] }
-		});
+	async setFulfillment(id, type) {
+		return this.patchFulfillmentDiscount(id, { fulfillment: { methods: [{
+			id: DEFAULT_METHOD_ID,
+			type
+		}] } });
 	}
-	async selectDestination(id, destinationId, fulfillmentType = "shipping", patch) {
-		return this.update(id, {
-			...patch,
-			fulfillment: { methods: [{
-				id: DEFAULT_METHOD_ID,
-				type: fulfillmentType,
-				selected_destination_id: destinationId
-			}] }
-		});
+	async selectDestination(id, destinationId, fulfillmentType = "shipping") {
+		return this.patchFulfillmentDiscount(id, { fulfillment: { methods: [{
+			id: DEFAULT_METHOD_ID,
+			type: fulfillmentType,
+			selected_destination_id: destinationId
+		}] } });
 	}
-	async selectFulfillmentOption(id, optionId, destinationId, fulfillmentType = "shipping", patch) {
-		return this.update(id, {
-			...patch,
-			fulfillment: { methods: [{
-				id: DEFAULT_METHOD_ID,
-				type: fulfillmentType,
-				...destinationId !== void 0 ? { selected_destination_id: destinationId } : {},
-				groups: [{
-					id: DEFAULT_GROUP_ID,
-					selected_option_id: optionId
-				}]
-			}] }
-		});
+	async selectFulfillmentOption(id, optionId, destinationId, fulfillmentType = "shipping") {
+		return this.patchFulfillmentDiscount(id, { fulfillment: { methods: [{
+			id: DEFAULT_METHOD_ID,
+			type: fulfillmentType,
+			...destinationId !== void 0 ? { selected_destination_id: destinationId } : {},
+			groups: [{
+				id: DEFAULT_GROUP_ID,
+				selected_option_id: optionId
+			}]
+		}] } });
 	}
-	async applyDiscountCodes(id, codes, patch) {
-		return this.update(id, {
-			...patch,
-			discounts: { codes: [...codes] }
-		});
+	async applyDiscountCodes(id, codes) {
+		return this.patchFulfillmentDiscount(id, { discounts: { codes: [...codes] } });
+	}
+	async createFulfillmentMethod(id, payload) {
+		const data = await this.http.request("POST", `/checkout-sessions/${encodeURIComponent(id)}/fulfillment/methods`, payload);
+		return this.validateSession(data);
+	}
+	async updateFulfillmentMethod(id, methodId, payload) {
+		const data = await this.http.request("PUT", `/checkout-sessions/${encodeURIComponent(id)}/fulfillment/methods/${encodeURIComponent(methodId)}`, payload);
+		return this.validateSession(data);
+	}
+	async updateFulfillmentGroup(id, methodId, groupId, payload) {
+		const data = await this.http.request("PUT", `/checkout-sessions/${encodeURIComponent(id)}/fulfillment/methods/${encodeURIComponent(methodId)}/groups/${encodeURIComponent(groupId)}`, payload);
+		return this.validateSession(data);
+	}
+	async patchFulfillmentDiscount(id, patch) {
+		const data = await this.http.request("PUT", `/checkout-sessions/${encodeURIComponent(id)}`, patch);
+		return this.validateSession(data);
 	}
 	validateSession(data) {
 		const session = this.http.validate(data, CheckoutSessionSchema);
@@ -255,7 +237,12 @@ var OrderCapability = class {
 	/** Update an order with fulfillment events, adjustments, or status changes. */
 	async update(id, payload) {
 		const data = await this.http.request("PUT", `/orders/${encodeURIComponent(id)}`, payload);
-		return this.http.validate(data, OrderSchema);
+		return this.http.validate(data, OrderUpdateSchema);
+	}
+	/** Update a single line item within an order (e.g. set parent for grouping). */
+	async updateLineItem(id, lineItemId, payload) {
+		const data = await this.http.request("PUT", `/orders/${encodeURIComponent(id)}/line-items/${encodeURIComponent(lineItemId)}`, payload);
+		return this.http.validate(data, OrderUpdateSchema);
 	}
 };
 
@@ -642,6 +629,97 @@ function fulfillmentTools(client) {
 				required: ["id", "option_id"]
 			},
 			execute: async (params) => client.checkout.selectFulfillmentOption(params["id"], params["option_id"], params["destination_id"], params["fulfillment_type"] ?? "shipping")
+		},
+		{
+			name: "create_fulfillment_method",
+			description: "Add a new fulfillment method (shipping or pickup) to a checkout session.",
+			parameters: {
+				type: "object",
+				properties: {
+					id: {
+						type: "string",
+						description: "Checkout session ID"
+					},
+					type: {
+						type: "string",
+						enum: ["shipping", "pickup"],
+						description: "Fulfillment method type"
+					},
+					line_item_ids: {
+						type: "array",
+						items: { type: "string" },
+						description: "Line item IDs to associate with this method (optional)"
+					}
+				},
+				required: ["id", "type"]
+			},
+			execute: async (params) => {
+				const { id,...payload } = params;
+				return client.checkout.createFulfillmentMethod(id, payload);
+			}
+		},
+		{
+			name: "update_fulfillment_method",
+			description: "Update an existing fulfillment method on a checkout session.",
+			parameters: {
+				type: "object",
+				properties: {
+					id: {
+						type: "string",
+						description: "Checkout session ID"
+					},
+					method_id: {
+						type: "string",
+						description: "Fulfillment method ID to update"
+					},
+					type: {
+						type: "string",
+						enum: ["shipping", "pickup"],
+						description: "Updated fulfillment method type (optional)"
+					},
+					line_item_ids: {
+						type: "array",
+						items: { type: "string" },
+						description: "Updated line item IDs to associate with this method"
+					}
+				},
+				required: [
+					"id",
+					"method_id",
+					"line_item_ids"
+				]
+			},
+			execute: async (params) => {
+				const { id, method_id,...payload } = params;
+				return client.checkout.updateFulfillmentMethod(id, method_id, payload);
+			}
+		},
+		{
+			name: "update_fulfillment_group",
+			description: "Update a fulfillment group within a fulfillment method on a checkout session.",
+			parameters: {
+				type: "object",
+				properties: {
+					id: {
+						type: "string",
+						description: "Checkout session ID"
+					},
+					method_id: {
+						type: "string",
+						description: "Fulfillment method ID"
+					},
+					group_id: {
+						type: "string",
+						description: "Fulfillment group ID to update"
+					}
+				},
+				required: [
+					"id",
+					"method_id",
+					"group_id"
+				]
+			},
+			execute: async (params) => client.checkout.updateFulfillmentGroup(params["id"], params["method_id"], params["group_id"], { id: params["group_id"] })
 		}
 	];
 }
@@ -668,45 +746,74 @@ function discountTools(client) {
 	}];
 }
 function orderTools(client) {
-	return [{
-		name: "get_order",
-		description: "Get order details by ID, including line items, fulfillment status, and tracking information.",
-		parameters: {
-			type: "object",
-			properties: { id: {
-				type: "string",
-				description: "Order ID"
-			} },
-			required: ["id"]
-		},
-		execute: async (params) => client.order.get(params["id"])
-	}, {
-		name: "update_order",
-		description: "Update an order with fulfillment events, adjustments, or status changes.",
-		parameters: {
-			type: "object",
-			properties: {
-				id: {
+	return [
+		{
+			name: "get_order",
+			description: "Get order details by ID, including line items, fulfillment status, and tracking information.",
+			parameters: {
+				type: "object",
+				properties: { id: {
 					type: "string",
 					description: "Order ID"
+				} },
+				required: ["id"]
+			},
+			execute: async (params) => client.order.get(params["id"])
+		},
+		{
+			name: "update_order",
+			description: "Update an order with fulfillment events, adjustments, or status changes.",
+			parameters: {
+				type: "object",
+				properties: {
+					id: {
+						type: "string",
+						description: "Order ID"
+					},
+					fulfillment: {
+						type: "object",
+						description: "Fulfillment update data (events, tracking)"
+					},
+					adjustments: {
+						type: "array",
+						description: "Order adjustments (refunds, returns)",
+						items: { type: "object" }
+					}
 				},
-				fulfillment: {
-					type: "object",
-					description: "Fulfillment update data (events, tracking)"
-				},
-				adjustments: {
-					type: "array",
-					description: "Order adjustments (refunds, returns)",
-					items: { type: "object" }
-				}
+				required: ["id"]
 			},
-			required: ["id"]
+			execute: async (params) => {
+				const { id,...payload } = params;
+				return client.order.update(id, payload);
+			}
 		},
-		execute: async (params) => {
-			const { id,...payload } = params;
-			return client.order.update(id, payload);
+		{
+			name: "update_order_line_item",
+			description: "Update a line item within an order, such as setting a parent line item for grouping.",
+			parameters: {
+				type: "object",
+				properties: {
+					id: {
+						type: "string",
+						description: "Order ID"
+					},
+					line_item_id: {
+						type: "string",
+						description: "Line item ID to update"
+					},
+					parent_id: {
+						type: "string",
+						description: "Parent line item ID for grouping (optional)"
+					}
+				},
+				required: ["id", "line_item_id"]
+			},
+			execute: async (params) => {
+				const { id, line_item_id,...payload } = params;
+				return client.order.updateLineItem(id, line_item_id, payload);
+			}
 		}
-	}];
+	];
 }
 function identityLinkingTools(client) {
 	return [
@@ -833,21 +940,6 @@ function identityLinkingTools(client) {
 
 //#endregion
 //#region src/UCPClient.ts
-/**
-* Connect to a UCP server, discover its capabilities, and return a {@link ConnectedClient}.
-*
-* @example
-* ```typescript
-* const client = await connect({
-*   gatewayUrl: 'https://store.example.com/ucp',
-*   agentProfileUrl: 'https://platform.example.com/.well-known/ucp',
-* });
-*
-* if (client.checkout) {
-*   const session = await client.checkout.create({ line_items: [...] });
-* }
-* ```
-*/
 async function connect(config, options) {
 	validateConfig(config);
 	const http = new HttpClient({
@@ -877,40 +969,29 @@ async function connect(config, options) {
 	};
 	return Object.freeze(client);
 }
-/**
-* UCP client entry point. Use `UCPClient.connect()` to discover server capabilities
-* and get a {@link ConnectedClient}.
-*
-* @example
-* ```typescript
-* const client = await UCPClient.connect({
-*   gatewayUrl: 'https://store.example.com/ucp',
-*   agentProfileUrl: 'https://platform.example.com/.well-known/ucp',
-* });
-* ```
-*/
 var UCPClient = class {
 	constructor() {}
 	static connect = connect;
 };
 function validateConfig(config) {
-	new URL(config.gatewayUrl);
+	try {
+		new URL(config.gatewayUrl);
+	} catch {
+		throw new Error(`UCPClient: gatewayUrl is not a valid URL: "${config.gatewayUrl}"`);
+	}
 	if (config.agentProfileUrl.includes("\"") || config.agentProfileUrl.includes("\n")) throw new Error("agentProfileUrl must not contain double quotes or newlines");
-	new URL(config.agentProfileUrl);
+	try {
+		new URL(config.agentProfileUrl);
+	} catch {
+		throw new Error(`UCPClient: agentProfileUrl is not a valid URL: "${config.agentProfileUrl}"`);
+	}
 }
 function extractCapabilityNames(profile) {
 	const capabilities = profile.ucp?.capabilities;
 	if (typeof capabilities !== "object" || capabilities === null) return new Set();
 	return new Set(Object.keys(capabilities));
 }
-const PaymentHandlerInstanceSchema = z.object({
-	id: z.string(),
-	version: z.string(),
-	spec: z.string(),
-	schema: z.string(),
-	config: z.record(z.unknown()).optional()
-}).passthrough();
-const PaymentHandlerMapSchema = z.record(z.array(PaymentHandlerInstanceSchema));
+const PaymentHandlerMapSchema = z.record(z.array(PaymentHandlerBaseSchema));
 function extractPaymentHandlers(profile) {
 	const raw = profile["payment_handlers"];
 	if (typeof raw !== "object" || raw === null) return {};
@@ -923,7 +1004,7 @@ function extractSigningKeys(profile) {
 	if (!Array.isArray(raw)) return [];
 	const keys = [];
 	for (const item of raw) {
-		const result = JWKSchema.safeParse(item);
+		const result = UcpSigningKeySchema.safeParse(item);
 		if (result.success) keys.push(result.data);
 	}
 	return keys;
@@ -996,6 +1077,18 @@ function buildToolDescriptors(checkout, order, identityLinking) {
 			name: "select_fulfillment_option",
 			capability: "checkout.fulfillment",
 			description: "Select fulfillment option (e.g., express shipping)"
+		}, {
+			name: "create_fulfillment_method",
+			capability: "checkout.fulfillment",
+			description: "Add a new fulfillment method to a checkout session"
+		}, {
+			name: "update_fulfillment_method",
+			capability: "checkout.fulfillment",
+			description: "Update an existing fulfillment method on a checkout session"
+		}, {
+			name: "update_fulfillment_group",
+			capability: "checkout.fulfillment",
+			description: "Update a fulfillment group within a fulfillment method"
 		});
 		if (checkout.extensions.discount) tools.push({
 			name: "apply_discount_codes",
@@ -1011,6 +1104,10 @@ function buildToolDescriptors(checkout, order, identityLinking) {
 		name: "update_order",
 		capability: "order",
 		description: "Update an order"
+	}, {
+		name: "update_order_line_item",
+		capability: "order",
+		description: "Update a line item within an order"
 	});
 	if (identityLinking) tools.push({
 		name: "get_authorization_url",
@@ -1103,24 +1200,43 @@ function createWebhookVerifier(gatewayUrl) {
 	const baseUrl = gatewayUrl.replace(/\/+$/, "");
 	const keyCache = new Map();
 	let fetched = false;
+	let loadingPromise = null;
 	async function loadKeys() {
 		const res = await fetch(`${baseUrl}/.well-known/ucp`);
-		if (!res.ok) return;
-		const profile = await res.json();
+		if (!res.ok) {
+			fetched = true;
+			return;
+		}
+		let profile;
+		try {
+			profile = await res.json();
+		} catch {
+			fetched = true;
+			return;
+		}
 		const rawKeys = profile["signing_keys"];
-		if (!Array.isArray(rawKeys)) return;
+		if (!Array.isArray(rawKeys)) {
+			fetched = true;
+			return;
+		}
 		keyCache.clear();
 		for (const item of rawKeys) {
-			const parsed = JWKSchema.safeParse(item);
+			const parsed = UcpSigningKeySchema.safeParse(item);
 			if (parsed.success && typeof parsed.data.kid === "string") keyCache.set(parsed.data.kid, parsed.data);
 		}
 		fetched = true;
 	}
+	function ensureKeys() {
+		loadingPromise ??= loadKeys().finally(() => {
+			loadingPromise = null;
+		});
+		return loadingPromise;
+	}
 	return { async verify(body, signature) {
 		const kid = extractKid(signature);
 		if (kid === null) return false;
-		if (!fetched) await loadKeys();
-		if (!keyCache.has(kid)) await loadKeys();
+		if (!fetched) await ensureKeys();
+		if (!keyCache.has(kid)) await ensureKeys();
 		const key = keyCache.get(kid);
 		if (!key) return false;
 		return verifyRequestSignature(body, signature, [key]);
@@ -1184,5 +1300,5 @@ function parseWebhookEvent(body) {
 }
 
 //#endregion
-export { AccountInfoSchema, AdjustmentSchema, Ap2MandateAp2WithCheckoutMandateSchema, Ap2MandateAp2WithMerchantAuthorizationSchema, Ap2MandateCheckoutMandateSchema, Ap2MandateErrorCodeSchema, Ap2MandateMerchantAuthorizationSchema, BindingSchema, BusinessFulfillmentConfigSchema, BuyerConsentBuyerSchema, BuyerConsentConsentSchema, BuyerSchema, CapabilityBaseSchema, CapabilityBusinessSchema, CapabilityPlatformSchema, CapabilityResponseSchema, CardCredentialSchema, CardPaymentInstrumentSchema, CheckoutCapability, CheckoutCompleteRequestSchema, CheckoutCreateRequestSchema, CheckoutResponseSchema, CheckoutResponseStatusSchema, CheckoutSchema, CheckoutSessionSchema, CheckoutUpdateRequestSchema, CompleteCheckoutRequestSchema, ContextSchema, CreateCheckoutRequestSchema, DEFAULT_UCP_VERSION, DiscountAllocationSchema, DiscountAppliedDiscountSchema, DiscountDiscountsObjectSchema, EmbeddedConfigSchema, ExpectationSchema, ExtendedPaymentCredentialSchema, FulfillmentAvailableMethodSchema, FulfillmentDestinationSchema, FulfillmentEventSchema, FulfillmentExtensionFulfillmentAvailableMethodSchema, FulfillmentExtensionFulfillmentGroupSchema, FulfillmentExtensionFulfillmentMethodSchema, FulfillmentExtensionFulfillmentOptionSchema, FulfillmentExtensionFulfillmentSchema, FulfillmentGroupSchema, FulfillmentGroupUpdateRequestSchema, FulfillmentMethodCreateRequestSchema, FulfillmentMethodResponseSchema, FulfillmentMethodSchema, FulfillmentMethodUpdateRequestSchema, FulfillmentOptionSchema, FulfillmentResponseSchema, FulfillmentSchema, IdentityLinkingCapability, ItemResponseSchema, ItemSchema, JWKSchema, LineItemResponseSchema, LineItemSchema, LineItemUpdateRequestSchema, LinkSchema, MerchantFulfillmentConfigSchema, MessageErrorSchema, MessageInfoSchema, MessageSchema, MessageWarningSchema, OrderCapability, OrderConfirmationSchema, OrderLineItemSchema, OrderUpdateSchema, PaymentCredentialSchema, PaymentHandlerBaseSchema, PaymentHandlerBusinessSchema, PaymentHandlerPlatformSchema, PaymentHandlerResponseSchema, PaymentIdentitySchema, PaymentInstrumentResponseSchema, PaymentInstrumentSchema, PaymentResponseSchema, PaymentSchema, PlatformConfigSchema, PlatformFulfillmentConfigSchema, PostalAddressSchema, RetailLocationSchema, ServiceBaseSchema, ServiceBusinessSchema, ServicePlatformSchema, ServiceResponseSchema, ShippingDestinationSchema, TokenCredentialSchema, TotalResponseSchema, TotalSchema, UCPClient, UCPError, UCPEscalationError, UCPIdempotencyConflictError, UCPOAuthError, UCPProfileSchema, OrderSchema as UCPSpecOrderSchema, UCP_CAPABILITIES, UcpBaseSchema, UcpBusinessSchema, UcpEntitySchema, UcpPlatformSchema, UcpResponseCheckoutSchema, UcpResponseOrderSchema, UcpReverseDomainNameSchema, UcpVersionSchema, UpdateCheckoutRequestSchema, WebhookEventSchema, connect, createWebhookVerifier, getAgentTools, parseWebhookEvent, verifyRequestSignature };
+export { AccountInfoSchema, AdjustmentSchema, AdjustmentStatusEnumSchema, Ap2MandateAp2WithCheckoutMandateSchema, Ap2MandateAp2WithMerchantAuthorizationSchema, Ap2MandateCheckoutMandateSchema, Ap2MandateErrorCodeSchema, Ap2MandateMerchantAuthorizationSchema, BindingSchema, BusinessFulfillmentConfigSchema, BuyerConsentBuyerSchema, BuyerConsentConsentSchema, BuyerSchema, CapabilityBaseSchema, CapabilityBusinessSchema, CapabilityPlatformSchema, CapabilityResponseSchema, CardCredentialCardNumberTypeEnumSchema, CardCredentialSchema, CardPaymentInstrumentSchema, CheckoutCapability, CheckoutCompleteRequestSchema, CheckoutCreateRequestSchema, CheckoutResponseSchema, CheckoutResponseStatusSchema, CheckoutSchema, CheckoutSessionSchema, CheckoutStatusEnumSchema, CheckoutUpdateRequestSchema, CompleteCheckoutRequestSchema, ContextSchema, CreateCheckoutRequestSchema, DEFAULT_UCP_VERSION, DiscountAllocationSchema, DiscountAppliedDiscountMethodEnumSchema, DiscountAppliedDiscountSchema, DiscountDiscountsObjectSchema, EmbeddedConfigSchema, ExpectationMethodTypeEnumSchema, ExpectationSchema, FulfillmentAvailableMethodSchema, FulfillmentAvailableMethodTypeEnumSchema, FulfillmentDestinationSchema, FulfillmentEventSchema, FulfillmentExtensionFulfillmentAvailableMethodSchema, FulfillmentExtensionFulfillmentGroupSchema, FulfillmentExtensionFulfillmentMethodSchema, FulfillmentExtensionFulfillmentOptionSchema, FulfillmentExtensionFulfillmentSchema, FulfillmentGroupSchema, FulfillmentGroupUpdateRequestSchema, FulfillmentMethodCreateRequestSchema, FulfillmentMethodResponseSchema, FulfillmentMethodSchema, FulfillmentMethodTypeEnumSchema, FulfillmentMethodUpdateRequestSchema, FulfillmentOptionSchema, FulfillmentResponseSchema, FulfillmentSchema, IdentityLinkingCapability, ItemResponseSchema, ItemSchema, UcpSigningKeySchema as JWKSchema, LineItemResponseSchema, LineItemSchema, LineItemUpdateRequestSchema, LinkSchema, MerchantFulfillmentConfigSchema, MessageErrorContentTypeEnumSchema, MessageErrorSchema, MessageErrorSeverityEnumSchema, MessageInfoContentTypeEnumSchema, MessageInfoSchema, MessageSchema, MessageWarningContentTypeEnumSchema, MessageWarningSchema, OrderCapability, OrderConfirmationSchema, OrderLineItemSchema, OrderLineItemStatusEnumSchema, OrderUpdateSchema, PaymentCredentialSchema, PaymentHandlerBaseSchema, PaymentHandlerBusinessSchema, PaymentHandlerPlatformSchema, PaymentHandlerResponseSchema, PaymentIdentitySchema, PaymentInstrumentResponseSchema, PaymentInstrumentSchema, PaymentResponseSchema, PaymentSchema, PlatformFulfillmentConfigSchema, PostalAddressSchema, ProfileSchemaBaseSchema, ProfileSchemaBusinessProfileSchema, ProfileSchemaPlatformProfileSchema, ProfileSchemaSigningKeySchema, ProfileSchemaSigningKeyUseEnumSchema, RetailLocationSchema, ServiceBaseSchema, ServiceBaseTransportEnumSchema, ServiceBusinessSchema, ServicePlatformSchema, ServiceResponseSchema, ShippingDestinationSchema, TokenCredentialSchema, TotalResponseSchema, TotalSchema, TotalTypeEnumSchema, UCPClient, UCPError, UCPEscalationError, UCPIdempotencyConflictError, UCPOAuthError, UCPProfileSchema, OrderSchema as UCPSpecOrderSchema, UCP_CAPABILITIES, UcpBaseSchema, UcpBusinessSchema, UcpDiscoveryBusinessProfileSchema, UcpDiscoveryPlatformProfileSchema, UcpEntitySchema, UcpPlatformSchema, UcpResponseCheckoutSchema, UcpResponseOrderSchema, UcpReverseDomainNameSchema, UcpVersionSchema, UpdateCheckoutRequestSchema, WebhookEventSchema, connect, createWebhookVerifier, getAgentTools, parseWebhookEvent, verifyRequestSignature };
 //# sourceMappingURL=index.js.map