Agorio – TypeScript SDK for Building AI Shopping Agents (UCP/ACP)

I built an open-source TypeScript SDK for building AI agents that can discover merchants, browse products, and complete purchases using the new UCP (Google/Shopify) and ACP (OpenAI/Stripe) commerce protocols.

Try it in 2 minutes:

npm install @agorio/sdk

import { ShoppingAgent, GeminiAdapter, MockMerchant } from '@agorio/sdk'; const merchant = new MockMerchant(); await merchant.start(); const agent = new ShoppingAgent({ llm: new GeminiAdapter({ apiKey: process.env.GEMINI_API_KEY }) }); const result = await agent.run( `Go to ${merchant.domain} and buy me wireless headphones` );

What it does:

- UcpClient: discovers merchants via /.well-known/ucp, parses capabilities, normalizes both array and object formats, calls REST APIs - ShoppingAgent: plan-act-observe loop with 12 built-in tools (discover, search, browse, cart, checkout, order tracking) - MockMerchant: full UCP-compliant Express server with product catalog, checkout flow, and configurable chaos testing (latency, error rates) - LlmAdapter interface: swap LLMs without changing agent code. Gemini ships today, Claude and OpenAI coming in v0.2

The agent handles the entire purchase flow autonomously - UCP discovery, product search, cart management, shipping, payment, order confirmation. 37 tests passing.

Context: UCP was announced Jan 11 by Google, Shopify, and 25+ partners (Walmart, Target, Visa, Mastercard). ACP is by OpenAI and Stripe, powers ChatGPT Instant Checkout. Both are open standards. But there was no developer SDK for building on top of them - just the raw specs.

GitHub: https://github.com/Nolpak14/agorio npm: https://www.npmjs.com/package/@agorio/sdk