diff --git a/.gitignore b/.gitignore
index e10ddfd..f215918 100644
--- a/.gitignore
+++ b/.gitignore
@@ -3,3 +3,6 @@
 .ruff_cache
 uv.lock
 .venv
+node_modules
+rest/nodejs/dist
+.env
\ No newline at end of file
diff --git a/README.md b/README.md
index 61eaa64..e447fb4 100644
--- a/README.md
+++ b/README.md
@@ -49,6 +49,33 @@ Zod.
     *   Demonstrates implementation of UCP specifications for shopping,
         checkout, and order management using a Node.js stack.
 
+### Agentic Commerce (A2A)
+
+Demonstrates how to build AI-powered shopping assistants using UCP as an
+extension to the [A2A (Agent-to-Agent) protocol](https://google.github.io/A2A/).
+
+*   **[Full A2A Sample](a2a/README.md)**: Overview of the agentic commerce
+    architecture.
+*   **Business Agent**: AI shopping assistant built with Python, Google ADK, and
+    Gemini.
+*   **Chat Client**: React-based UI that renders UCP data types for
+    conversational commerce.
+
+## Which Sample to Use?
+
+This repository contains two different ways to implement UCP based on your
+use-case:
+
+| Use Case | Recommended Sample | Protocol |
+| :--- | :--- | :--- |
+| **Traditional E-commerce** | [REST Samples](rest/) | Standard RESTful HTTP |
+| **AI / Conversational Commerce** | [A2A Samples](a2a/) | JSON-RPC over A2A |
+
+*   Use the **REST Samples** if you are building a standard web store backend and
+    want to follow the official UCP REST specification.
+*   Use the **A2A Samples** if you are building an AI agent that needs to help
+    users shop through natural language.
+
 ## Getting Started
 
 Please refer to the specific README files linked above for detailed instructions
diff --git a/rest/nodejs/package-lock.json b/rest/nodejs/package-lock.json
index 76459c3..582a8da 100644
--- a/rest/nodejs/package-lock.json
+++ b/rest/nodejs/package-lock.json
@@ -1383,9 +1383,9 @@
       "license": "MIT"
     },
     "node_modules/hono": {
-      "version": "4.11.1",
-      "resolved": "https://registry.npmjs.org/hono/-/hono-4.11.1.tgz",
-      "integrity": "sha512-KsFcH0xxHes0J4zaQgWbYwmz3UPOOskdqZmItstUG93+Wk1ePBLkLGwbP9zlmh1BFUiL8Qp+Xfu9P7feJWpGNg==",
+      "version": "4.11.4",
+      "resolved": "https://registry.npmjs.org/hono/-/hono-4.11.4.tgz",
+      "integrity": "sha512-U7tt8JsyrxSRKspfhtLET79pU8K+tInj5QZXs1jSugO1Vq5dFj3kmZsRldo29mTBfcjDRVRXrEZ6LS63Cog9ZA==",
       "license": "MIT",
       "engines": {
         "node": ">=16.9.0"