@justhandledlabs/agent-client 0.4.1 → 0.5.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://justhandledlabs.com/agent-gateway/). The package exposes twenty-five deterministic preflights, maintained-data lookups, and evidence products. Twenty-two products cost $0.05 USDC; the Chicago permit change packet, site-discovery change packet, and consolidated six-check Agent Run Evidence Pack cost $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://justhandledlabs.com/agent-gateway/). The package exposes twenty-six deterministic preflights, maintained-data lookups, and evidence products. Twenty-two products cost $0.05 USDC; four evidence-heavy products cost $0.25, including the Agent Distribution Readiness Pack. 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.
 
@@ -10,6 +10,7 @@ The client fails closed before signing. It accepts only the pinned JustHandled g
 npx --package @justhandledlabs/agent-client justhandled-agent catalog
 npx --package @justhandledlabs/agent-client justhandled-agent preview filename-portability-preflight --json '{"paths":["CON.txt"]}'
 npx --package @justhandledlabs/agent-client justhandled-agent preview agent-run-evidence-pack --file agent-run-evidence-pack.sample.json
+npx --package @justhandledlabs/agent-client justhandled-agent preview agent-distribution-readiness-pack --file agent-distribution-readiness-pack.sample.json
 ```
 
 Preview performs an unpaid request and validates the returned x402 terms. It does not sign or spend.
@@ -57,7 +58,7 @@ The package declares the official MCP Registry identity `io.github.justhandledla
 ## Security model
 
 - Price, chain, asset, receiver, and gateway origin are pinned in code.
-- The three $0.25 products' 250,000-base-unit price is pinned separately from 50,000-base-unit checks.
+- The four $0.25 products' 250,000-base-unit price is pinned separately from 50,000-base-unit checks.
 - Every execution starts with an unpaid 402 preview.
 - A mismatched term aborts before signing.
 - The package never prints the private key.

package/dist/config.js

@@ -11,6 +11,7 @@ export const QUARTER_DOLLAR_UTILITIES = new Set([
     AGENT_RUN_EVIDENCE_PACK,
     "chicago-demolition-permit-change-packet",
     "site-discovery-change-packet",
+    "agent-distribution-readiness-pack",
 ]);
 export function expectedPriceForUtility(utility) {
     return QUARTER_DOLLAR_UTILITIES.has(utility) ? AGENT_RUN_EVIDENCE_PACK_PRICE_USDC : PRICE_USDC;

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.4.1" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "justhandled-agent-gateway", version: "0.5.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     const catalog = await getCatalog();
     return {

package/examples/agent-distribution-readiness-pack.sample.json

@@ -0,0 +1,23 @@
+{
+  "observed_at": "2026-08-01T21:00:00Z",
+  "product": {
+    "name": "Example Agent",
+    "version": "1.2.0",
+    "kind": "mcp-server",
+    "canonical_url": "https://example.com/agent/",
+    "price_usd": 0.25
+  },
+  "surfaces": [
+    { "id": "home", "type": "homepage", "url": "https://example.com/agent/", "captured_at": "2026-08-01T20:55:00Z", "http_status": 200, "name": "Example Agent", "version": "1.2.0", "canonical_url": "https://example.com/agent/", "price_usd": 0.25, "evidence_ref": "sha256:homepage" },
+    { "id": "docs", "type": "documentation", "url": "https://example.com/agent/docs", "captured_at": "2026-08-01T20:55:00Z", "http_status": 200, "evidence_ref": "sha256:docs" },
+    { "id": "pricing", "type": "pricing", "url": "https://example.com/agent/pricing", "captured_at": "2026-08-01T20:55:00Z", "http_status": 200, "price_usd": 0.25, "evidence_ref": "sha256:pricing" },
+    { "id": "support", "type": "support", "url": "https://example.com/agent/support", "captured_at": "2026-08-01T20:55:00Z", "http_status": 200, "evidence_ref": "sha256:support" },
+    { "id": "security", "type": "security", "url": "https://example.com/agent/security", "captured_at": "2026-08-01T20:55:00Z", "http_status": 200, "evidence_ref": "sha256:security" },
+    { "id": "registry", "type": "agent-registry", "url": "https://registry.modelcontextprotocol.io/example", "captured_at": "2026-08-01T20:55:00Z", "http_status": 200, "name": "Example Agent", "version": "1.2.0", "evidence_ref": "registry:example@1.2.0" },
+    { "id": "transport", "type": "transport", "url": "https://api.example.com/mcp", "captured_at": "2026-08-01T20:55:00Z", "http_status": 200, "capabilities": ["tools/list", "resources/list"], "evidence_ref": "sha256:mcp-probe" }
+  ],
+  "claims": [
+    { "id": "live", "text": "The hosted MCP transport is live.", "evidence_surface_ids": ["transport"] }
+  ],
+  "target_channels": ["mcp-registry", "smithery"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justhandledlabs/agent-client",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Guarded CLI and MCP client for JustHandled's x402 utility gateway",
   "type": "module",
   "license": "MIT",

package/server.json

@@ -2,8 +2,8 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.justhandledlabs/agent-gateway",
   "title": "JustHandled Agent Utility Gateway",
-  "description": "Twenty-five guarded pay-per-call preflights and evidence products over USDC x402.",
-  "version": "0.4.1",
+  "description": "Twenty-six guarded pay-per-call preflights and evidence products over USDC x402.",
+  "version": "0.5.0",
   "repository": {
     "url": "https://github.com/justhandledlabs/justhandled-agent-client",
     "source": "github"
@@ -12,7 +12,7 @@
     {
       "registryType": "npm",
       "identifier": "@justhandledlabs/agent-client",
-      "version": "0.4.1",
+      "version": "0.5.0",
       "transport": {
         "type": "stdio"
       },