user@gryczka.dev: ~/garden/agentic-commerce-registry
$ cat ~/garden/agentic-commerce-registry/README.md
Agentic Commerce Registry screenshot

Agentic Commerce Registry

December 14, 2025 | Patrick Gryczka

## Overview

A hands-on walkthrough of the Cloudflare Developer Platform, structured as a realistic agentic commerce scenario. Walk through a 7-step demo flow — from registering shoppers and merchants, to creating AI agent delegations, initiating purchases, and auditing the full transaction trail. Every API call returns real-time request traces showing KV operation durations and the Cloudflare POP that handled the request. Each "View Code" button opens annotated snippets of the actual Worker source with color-coded platform tags.

## Highlights

  • -> 7-step interactive demo flow with real KV persistence
  • -> Per-request span timeline showing Worker execution and KV operation durations
  • -> Edge location detection via request.cf.colo
  • -> Cold vs. warm latency comparison on KV reads
  • -> Annotated source code with color-coded platform tags

## Architecture

Agentic Commerce architecture diagram
Browser (public/index.html)
    │   Fetch API calls to /api/*
    ▼
Cloudflare Workers Runtime (src/index.ts)
    │   Hono router handles routing + CORS
    │   TracedKV wraps every KV call with timing
    ▼
Workers KV (REGISTRY namespace)
    │   Keys: shopper:{id}, merchant:{id}, agent:{id},
    │         delegation:{agentId}:{shopperId}, transaction:{id}
    ▼
Response (JSON + _trace + _colo fields)

## Tech Stack

WorkersKVHonoTypeScript
$ _