@justhandledlabs/agent-client 0.2.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # JustHandled Agent Client
 
-A guarded CLI, JavaScript client, and local MCP server for the [JustHandled Agent Utility Gateway](https://justhandled-agent-gateway.netlify.app). The package exposes seventeen deterministic preflights and evidence packs. Sixteen individual checks cost $0.05 USDC; the consolidated six-check Agent Run Evidence Pack costs $0.25. Every paid call returns a versioned evidence receipt.
+A guarded CLI, JavaScript client, and local MCP server for the [JustHandled Agent Utility Gateway](https://justhandled-agent-gateway.netlify.app). The package exposes twenty deterministic preflights and evidence products. Nineteen individual checks cost $0.05 USDC; the consolidated six-check Agent Run Evidence Pack costs $0.25. Every paid call returns a versioned evidence receipt.
 
 The client fails closed before signing. It accepts only the pinned JustHandled gateway, Base mainnet, canonical Base USDC, the exact per-product price, and the published merchant receiver. Customer inputs are not persisted by the gateway.
 
@@ -14,6 +14,8 @@ npx --package @justhandledlabs/agent-client justhandled-agent preview agent-run-
 
 Preview performs an unpaid request and validates the returned x402 terms. It does not sign or spend.
 
+The catalog includes API-response contract drift, webhook contract and replay, and policy-change evidence products. Packaged example inputs are available in `examples/`.
+
 Machine-readable products, exact payment terms, and free deterministic fixtures are available from the gateway's [product catalog](https://justhandled-agent-gateway.netlify.app/api/product-catalog), [OpenAPI document](https://justhandled-agent-gateway.netlify.app/openapi.json), and [sandbox index](https://justhandled-agent-gateway.netlify.app/sandbox/index.json).
 
 ## Execute one paid utility
@@ -50,6 +52,8 @@ npx.cmd --package @justhandledlabs/agent-client justhandled-agent call filename-
 
 The MCP server exposes a free catalog tool plus one paid tool per gateway utility. Missing wallet configuration produces an error instead of a payment attempt.
 
+The package declares the official MCP Registry identity `io.github.justhandledlabs/agent-gateway`. Registry identity is discovery metadata only: installing or listing the server does not spend funds, and paid execution still requires a dedicated wallet plus the client's exact-term checks.
+
 ## Security model
 
 - Price, chain, asset, receiver, and gateway origin are pinned in code.

package/dist/mcp.js

@@ -3,7 +3,7 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { getCatalog, runPaidUtility } from "./client.js";
-const server = new Server({ name: "justhandled-agent-gateway", version: "0.2.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "justhandled-agent-gateway", version: "0.3.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     const catalog = await getCatalog();
     return {

package/examples/api-response-contract-drift.json

@@ -0,0 +1,18 @@
+{
+  "contracts": [{
+    "id": "get-account",
+    "expected_status": 200,
+    "expected_content_type": "application/json",
+    "required_fields": ["data.id", "data.status"],
+    "forbidden_fields": ["data.secret"],
+    "field_types": { "data.id": "string", "data.status": "string" },
+    "stable_values": { "data.status": "active" }
+  }],
+  "responses": [{
+    "id": "run-1",
+    "contract_id": "get-account",
+    "status": 200,
+    "content_type": "application/json",
+    "body": { "data": { "id": "acct-1", "status": "active" } }
+  }]
+}

package/examples/policy-change-evidence.json

@@ -0,0 +1,15 @@
+{
+  "policies": [{
+    "id": "refund-policy",
+    "baseline": {
+      "version": "1.0",
+      "effective_date": "2026-01-01",
+      "clauses": [{ "id": "window", "text": "Refunds are available within 30 days.", "applies_to": ["all customers"], "requirements": ["receipt"] }]
+    },
+    "current": {
+      "version": "1.0",
+      "effective_date": "2026-01-01",
+      "clauses": [{ "id": "window", "text": "Refunds are available within 30 days.", "applies_to": ["all customers"], "requirements": ["receipt"] }]
+    }
+  }]
+}

package/examples/webhook-contract-replay.json

@@ -0,0 +1,20 @@
+{
+  "observed_at": "2026-08-01T15:00:00.000Z",
+  "contracts": [{
+    "event": "invoice.paid",
+    "allowed_versions": ["2026-01"],
+    "required_fields": ["invoice.id", "invoice.amount"],
+    "signature_required": true,
+    "idempotency_required": true,
+    "max_age_seconds": 300
+  }],
+  "deliveries": [{
+    "id": "delivery-1",
+    "event": "invoice.paid",
+    "version": "2026-01",
+    "payload": { "invoice": { "id": "inv-1", "amount": 2500 } },
+    "signature_present": true,
+    "idempotency_key": "evt-1",
+    "event_created_at": "2026-08-01T14:58:00.000Z"
+  }]
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@justhandledlabs/agent-client",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Guarded CLI and MCP client for JustHandled's x402 utility gateway",
   "type": "module",
   "license": "MIT",
-  "mcpName": "com.justhandledlabs/agent-gateway",
+  "mcpName": "io.github.justhandledlabs/agent-gateway",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/justhandledlabs/justhandled-agent-client.git"
@@ -16,10 +16,14 @@
   "keywords": [
     "ai-agents",
     "mcp",
+    "mcp-server",
     "x402",
     "base",
     "usdc",
-    "preflight"
+    "preflight",
+    "agent-evaluation",
+    "agent-observability",
+    "evidence"
   ],
   "files": [
     "dist",

package/server.json

@@ -1,9 +1,9 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "com.justhandledlabs/agent-gateway",
+  "name": "io.github.justhandledlabs/agent-gateway",
   "title": "JustHandled Agent Utility Gateway",
-  "description": "Seventeen deterministic preflights and evidence packs with guarded per-product USDC x402 execution.",
-  "version": "0.2.0",
+  "description": "Twenty deterministic preflights and evidence products with guarded per-product USDC x402 execution.",
+  "version": "0.3.0",
   "repository": {
     "url": "https://github.com/justhandledlabs/justhandled-agent-client",
     "source": "github"
@@ -12,7 +12,7 @@
     {
       "registryType": "npm",
       "identifier": "@justhandledlabs/agent-client",
-      "version": "0.2.0",
+      "version": "0.3.0",
       "transport": {
         "type": "stdio"
       },