@justhandledlabs/agent-client 0.1.0 → 0.1.1

package/README.md

@@ -1,66 +1,68 @@
-# 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 ten deterministic preflights. Each paid call costs exactly $0.05 USDC on Base mainnet and returns a versioned evidence receipt.
-
-The client fails closed before signing. It accepts only the pinned JustHandled gateway, Base mainnet, the canonical Base USDC contract, a 50,000-base-unit price, and the published merchant receiver. Customer inputs are not persisted by the gateway.
-
-## Inspect without a wallet
-
-```bash
-npx --package @justhandledlabs/agent-client justhandled-agent catalog
-npx --package @justhandledlabs/agent-client justhandled-agent preview filename-portability-preflight --json '{"paths":["CON.txt"]}'
-```
-
-Preview performs an unpaid request and validates the returned x402 terms. It does not sign or spend.
-
-## Execute one paid utility
-
-Use a dedicated low-balance Base wallet. Never provide a primary wallet key.
-
-```bash
-export JH_EVM_PRIVATE_KEY=0x...
-npx --package @justhandledlabs/agent-client justhandled-agent call filename-portability-preflight --json '{"paths":["CON.txt"]}'
-```
-
-PowerShell:
-
-```powershell
-$env:JH_EVM_PRIVATE_KEY = "0x..."
-npx.cmd --package @justhandledlabs/agent-client justhandled-agent call filename-portability-preflight --json '{"paths":["CON.txt"]}'
-```
-
-## MCP configuration
-
-```json
-{
-  "mcpServers": {
-    "justhandled": {
-      "command": "npx",
-      "args": ["-y", "@justhandledlabs/agent-client"],
-      "env": {
-        "JH_EVM_PRIVATE_KEY": "0xDEDICATED_LOW_BALANCE_WALLET_KEY"
-      }
-    }
-  }
-}
-```
-
-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.
-
-## Security model
-
-- Price, chain, asset, receiver, and gateway origin are pinned in code.
-- Every execution starts with an unpaid 402 preview.
-- A mismatched term aborts before signing.
-- The package never prints the private key.
-- The gateway does not persist raw inputs or results.
-- Treat all crypto transfers as irreversible and fund only a dedicated wallet.
-
-## Development
-
-```bash
-npm install
-npm run check
-```
-
-The gateway implementation is intentionally not included in this client repository.
+# 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 sixteen deterministic preflights, including six agent evidence and evaluation checks. Each paid call costs exactly $0.05 USDC on Base mainnet and returns a versioned evidence receipt.
+
+The client fails closed before signing. It accepts only the pinned JustHandled gateway, Base mainnet, the canonical Base USDC contract, a 50,000-base-unit price, and the published merchant receiver. Customer inputs are not persisted by the gateway.
+
+## Inspect without a wallet
+
+```bash
+npx --package @justhandledlabs/agent-client justhandled-agent catalog
+npx --package @justhandledlabs/agent-client justhandled-agent preview filename-portability-preflight --json '{"paths":["CON.txt"]}'
+```
+
+Preview performs an unpaid request and validates the returned x402 terms. It does not sign or spend.
+
+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
+
+Use a dedicated low-balance Base wallet. Never provide a primary wallet key.
+
+```bash
+export JH_EVM_PRIVATE_KEY=0x...
+npx --package @justhandledlabs/agent-client justhandled-agent call filename-portability-preflight --json '{"paths":["CON.txt"]}'
+```
+
+PowerShell:
+
+```powershell
+$env:JH_EVM_PRIVATE_KEY = "0x..."
+npx.cmd --package @justhandledlabs/agent-client justhandled-agent call filename-portability-preflight --json '{"paths":["CON.txt"]}'
+```
+
+## MCP configuration
+
+```json
+{
+  "mcpServers": {
+    "justhandled": {
+      "command": "npx",
+      "args": ["-y", "@justhandledlabs/agent-client"],
+      "env": {
+        "JH_EVM_PRIVATE_KEY": "0xDEDICATED_LOW_BALANCE_WALLET_KEY"
+      }
+    }
+  }
+}
+```
+
+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.
+
+## Security model
+
+- Price, chain, asset, receiver, and gateway origin are pinned in code.
+- Every execution starts with an unpaid 402 preview.
+- A mismatched term aborts before signing.
+- The package never prints the private key.
+- The gateway does not persist raw inputs or results.
+- Treat all crypto transfers as irreversible and fund only a dedicated wallet.
+
+## Development
+
+```bash
+npm install
+npm run check
+```
+
+The gateway implementation is intentionally not included in this client repository.

package/package.json

@@ -1,69 +1,69 @@
-{
-  "name": "@justhandledlabs/agent-client",
-  "version": "0.1.0",
-  "description": "Guarded CLI and MCP client for JustHandled's x402 utility gateway",
-  "type": "module",
-  "license": "MIT",
-  "mcpName": "com.justhandledlabs/agent-gateway",
-  "repository": {
-    "type": "git",
+{
+  "name": "@justhandledlabs/agent-client",
+  "version": "0.1.1",
+  "description": "Guarded CLI and MCP client for JustHandled's x402 utility gateway",
+  "type": "module",
+  "license": "MIT",
+  "mcpName": "com.justhandledlabs/agent-gateway",
+  "repository": {
+    "type": "git",
     "url": "git+https://github.com/justhandledlabs/justhandled-agent-client.git"
-  },
-  "homepage": "https://justhandled-agent-gateway.netlify.app",
-  "bugs": {
-    "url": "https://github.com/justhandledlabs/justhandled-agent-client/issues"
-  },
-  "keywords": [
-    "ai-agents",
-    "mcp",
-    "x402",
-    "base",
-    "usdc",
-    "preflight"
-  ],
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "server.json"
-  ],
-  "bin": {
-    "agent-client": "dist/mcp.js",
-    "justhandled-agent-client": "dist/mcp.js",
-    "justhandled-agent": "dist/cli.js",
-    "justhandled-agent-mcp": "dist/mcp.js"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "scripts": {
-    "build": "node scripts/clean.mjs && tsc -p tsconfig.json",
-    "test": "node --import tsx --test tests/*.test.ts",
-    "smoke:mcp": "npm run build && node scripts/smoke-mcp.mjs",
-    "check": "npm run build && npm test",
-    "prepack": "npm run check",
-    "prepublishOnly": "node scripts/assert-publish-ready.mjs"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "latest",
-    "@x402/core": "latest",
-    "@x402/evm": "latest",
-    "@x402/fetch": "^2.20.0",
-    "viem": "^2.55.10"
-  },
-  "devDependencies": {
-    "@types/node": "latest",
-    "tsx": "latest",
-    "typescript": "latest"
-  },
-  "engines": {
-    "node": ">=22"
-  },
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
-  }
-}
+  },
+  "homepage": "https://justhandled-agent-gateway.netlify.app",
+  "bugs": {
+    "url": "https://github.com/justhandledlabs/justhandled-agent-client/issues"
+  },
+  "keywords": [
+    "ai-agents",
+    "mcp",
+    "x402",
+    "base",
+    "usdc",
+    "preflight"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "server.json"
+  ],
+  "bin": {
+    "agent-client": "dist/mcp.js",
+    "justhandled-agent-client": "dist/mcp.js",
+    "justhandled-agent": "dist/cli.js",
+    "justhandled-agent-mcp": "dist/mcp.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "node scripts/clean.mjs && tsc -p tsconfig.json",
+    "test": "node --import tsx --test tests/*.test.ts",
+    "smoke:mcp": "npm run build && node scripts/smoke-mcp.mjs",
+    "check": "npm run build && npm test",
+    "prepack": "npm run check",
+    "prepublishOnly": "node scripts/assert-publish-ready.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "latest",
+    "@x402/core": "latest",
+    "@x402/evm": "latest",
+    "@x402/fetch": "^2.20.0",
+    "viem": "^2.55.10"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "tsx": "latest",
+    "typescript": "latest"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}

package/server.json

@@ -1,30 +1,30 @@
-{
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "com.justhandledlabs/agent-gateway",
-  "title": "JustHandled Agent Utility Gateway",
-  "description": "Ten deterministic preflights with guarded $0.05 USDC x402 execution.",
-  "version": "0.1.0",
-  "repository": {
-    "url": "https://github.com/justhandledlabs/justhandled-agent-client",
-    "source": "github"
-  },
-  "packages": [
-    {
-      "registryType": "npm",
-      "identifier": "@justhandledlabs/agent-client",
-      "version": "0.1.0",
-      "transport": {
-        "type": "stdio"
-      },
-      "environmentVariables": [
-        {
-          "name": "JH_EVM_PRIVATE_KEY",
-          "description": "Private key for a dedicated Base wallet funded with USDC. Never use a primary wallet.",
-          "isRequired": true,
-          "isSecret": true,
-          "format": "string"
-        }
-      ]
-    }
-  ]
-}
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "com.justhandledlabs/agent-gateway",
+  "title": "JustHandled Agent Utility Gateway",
+  "description": "Sixteen deterministic preflights with guarded $0.05 USDC x402 execution.",
+  "version": "0.1.1",
+  "repository": {
+    "url": "https://github.com/justhandledlabs/justhandled-agent-client",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@justhandledlabs/agent-client",
+      "version": "0.1.1",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "JH_EVM_PRIVATE_KEY",
+          "description": "Private key for a dedicated Base wallet funded with USDC. Never use a primary wallet.",
+          "isRequired": true,
+          "isSecret": true,
+          "format": "string"
+        }
+      ]
+    }
+  ]
+}