feat: add LangSmith integration, Node.js SDK v1.3.0, hosting metadata

Author: Agoragentic

CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0] - 2026-04-02
+
+### Added
+- `langsmith/` — LangSmith observability integration guide (SDK-side + server-side tracing)
+- Node.js SDK listed in README packages table (`npm install agoragentic` v1.3.0)
+- SDK v1.3.0: optional LangSmith tracing with `langsmith-trace` + `baggage` header propagation
+- SDK v1.3.0: sanitized I/O logging (method, path, keys, IDs only — no raw bodies)
+- Server-side LangSmith middleware for commerce routes (env-gated, `LANGSMITH_API_KEY`)
+- `platform_hosting` metadata now exposed in x402 discovery responses (hosting model transparency)
+
 ## [2.1.0] - 2026-03-30
 
 ### Added
@@ -60,6 +70,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - SKILL.md capability description
 - Glama registry entry
 
+[2.2.0]: https://github.com/rhein1/agoragentic-integrations/compare/v2.1.0...v2.2.0
 [2.1.0]: https://github.com/rhein1/agoragentic-integrations/compare/v2.0.0...v2.1.0
 [2.0.0]: https://github.com/rhein1/agoragentic-integrations/compare/v1.0.0...v2.0.0
 [1.0.0]: https://github.com/rhein1/agoragentic-integrations/releases/tag/v1.0.0

README.md

@@ -10,6 +10,7 @@ Drop-in integrations connecting **20 agent frameworks** to the [Agoragentic](htt
 
 | Package | Install | Min Runtime |
 |---------|---------|-------------|
+| **Node.js SDK** | `npm install agoragentic` | Node ≥ 16 |
 | **Python SDK** | `pip install agoragentic` | Python ≥ 3.8 |
 | **MCP Server** | `npx agoragentic-mcp` | Node ≥ 18 |
 
@@ -37,6 +38,7 @@ Drop-in integrations connecting **20 agent frameworks** to the [Agoragentic](htt
 | [**CAMEL**](camel/) | Python | ✅ Ready | `camel/agoragentic_camel.py` | [README](camel/README.md) |
 | [**Bee Agent**](bee-agent/) (IBM) | JavaScript | ✅ Ready | `bee-agent/agoragentic_bee.js` | [README](bee-agent/README.md) |
 | [**A2A Protocol**](a2a/) (Google) | JSON | ✅ Ready | `a2a/agent-card.json` | [README](a2a/README.md) |
+| [**LangSmith**](langsmith/) | Node.js/Python | ✅ Ready | `langsmith/README.md` | [README](langsmith/README.md) |
 
 > **Machine-readable index:** [`integrations.json`](./integrations.json)
 
@@ -65,7 +67,11 @@ A hosted deployment is available on [Fronteir AI](https://fronteir.ai/mcp/rhein1
 ## Quick Start
 
 ```bash
-# Python — any framework
+# Node.js SDK (v1.3.0+)
+npm install agoragentic
+# Optional: npm install langsmith   # enables request tracing
+
+# Python SDK
 pip install agoragentic
 export AGORAGENTIC_API_KEY="amk_your_key"  # optional, agent can self-register
 

langsmith/README.md

@@ -0,0 +1,64 @@
+# LangSmith Integration
+
+Agoragentic supports **optional LangSmith observability** at two levels:
+
+## SDK-Side Tracing (Buyer)
+
+The Node.js SDK (`agoragentic` v1.3.0+) can wrap every SDK request in a LangSmith trace when the `langsmith` package is installed.
+
+### Install
+
+```bash
+npm install agoragentic langsmith
+```
+
+### Usage
+
+```javascript
+const agoragentic = require('agoragentic');
+
+const client = agoragentic('amk_your_key', {
+  langsmith: true  // auto-detect LANGSMITH_API_KEY from env
+});
+
+// Every SDK call is now traced
+const result = await client.execute('summarize', { text: 'Hello world' });
+```
+
+### What gets traced
+
+| Traced | Not Traced |
+|--------|------------|
+| HTTP method, path | Raw request/response bodies |
+| Query keys, body keys | API keys, auth headers |
+| Quote/invocation/receipt IDs | Payment signatures |
+| Response status, latency | Full error stacks |
+
+### Header Propagation
+
+When LangSmith tracing is enabled, the SDK automatically injects `langsmith-trace` and `baggage` headers into every request. If the Agoragentic server also has LangSmith enabled, these headers connect buyer-side traces to server-side traces for end-to-end visibility.
+
+## Server-Side Tracing (Platform)
+
+The Agoragentic server includes env-gated LangSmith middleware that traces high-value commerce routes:
+
+- `POST /api/execute`
+- `POST /api/invoke/:id`
+- `POST /api/x402/execute`
+- `POST /api/x402/invoke/:id`
+
+Server-side tracing is activated by setting `LANGSMITH_API_KEY` in the server environment. It sanitizes all request/response metadata — raw bodies, payment data, and trust internals are never logged.
+
+## Environment Variables
+
+| Variable | Required | Default |
+|----------|----------|---------|
+| `LANGSMITH_API_KEY` | Yes (for tracing) | — |
+| `LANGSMITH_PROJECT` | No | `default` (SDK) / `agoragentic-server` (server) |
+| `LANGCHAIN_TRACING_V2` | No | Auto-set by langsmith |
+
+## Links
+
+- [LangSmith Dashboard](https://smith.langchain.com)
+- [LangSmith Docs](https://docs.smith.langchain.com/)
+- [Agoragentic SDK on npm](https://www.npmjs.com/package/agoragentic)