@justhandledlabs/agent-client 0.8.0 → 0.10.0

package/README.md

@@ -1,8 +1,8 @@
 # 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-nine deterministic preflights, maintained-data lookups, and evidence products. Twenty-two products cost $0.05 USDC; seven evidence-heavy products cost $0.25, including Agent Distribution Readiness, Community Rule & Credibility Preflight, Qualified Demand Ledger, and Channel-Fit Evidence Matrix. 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 thirty-two preflights, maintained-data lookups, and evidence products. Twenty-two products cost $0.05 USDC; ten evidence-heavy or maintained-data products cost $0.25, including the live Chicago Contract Change Packet. 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.
+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 and complete customer results are not persisted by the gateway; maintained public-source snapshots are labeled in the receipt.
 
 ## Inspect without a wallet
 
@@ -14,6 +14,9 @@ npx --package @justhandledlabs/agent-client justhandled-agent preview agent-dist
 npx --package @justhandledlabs/agent-client justhandled-agent preview community-rule-credibility-preflight --file community-rule-credibility-preflight.sample.json
 npx --package @justhandledlabs/agent-client justhandled-agent preview qualified-demand-ledger --file qualified-demand-ledger.sample.json
 npx --package @justhandledlabs/agent-client justhandled-agent preview channel-fit-evidence-matrix --file channel-fit-evidence-matrix.sample.json
+npx --package @justhandledlabs/agent-client justhandled-agent preview proof-to-channel-evidence-packet --file proof-to-channel-evidence-packet.sample.json
+npx --package @justhandledlabs/agent-client justhandled-agent preview channel-experiment-postmortem --file channel-experiment-postmortem.sample.json
+npx --package @justhandledlabs/agent-client justhandled-agent preview chicago-contract-change-packet --file chicago-contract-change-packet.sample.json
 ```
 
 Preview performs an unpaid request and validates the returned x402 terms. It does not sign or spend.
@@ -61,11 +64,11 @@ 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 seven $0.25 products' 250,000-base-unit price is pinned separately from 50,000-base-unit checks.
+- The ten $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.
-- The gateway does not persist raw inputs or results.
+- The gateway does not persist customer inputs or complete customer results. Maintained-data products may retain normalized public-source snapshots and disclose that state in the receipt.
 - Treat all crypto transfers as irreversible and fund only a dedicated wallet.
 
 ## Development

package/dist/config.js

@@ -10,11 +10,14 @@ export const AGENT_RUN_EVIDENCE_PACK_PRICE_USDC = "$0.25";
 export const QUARTER_DOLLAR_UTILITIES = new Set([
     AGENT_RUN_EVIDENCE_PACK,
     "chicago-demolition-permit-change-packet",
+    "chicago-contract-change-packet",
     "site-discovery-change-packet",
     "agent-distribution-readiness-pack",
     "community-rule-credibility-preflight",
     "qualified-demand-ledger",
     "channel-fit-evidence-matrix",
+    "proof-to-channel-evidence-packet",
+    "channel-experiment-postmortem",
 ]);
 export function expectedPriceForUtility(utility) {
     return QUARTER_DOLLAR_UTILITIES.has(utility) ? AGENT_RUN_EVIDENCE_PACK_PRICE_USDC : PRICE_USDC;

package/dist/mcp.js

@@ -3,14 +3,14 @@ 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.8.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "justhandled-agent-gateway", version: "0.10.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     const catalog = await getCatalog();
     return {
         tools: [
             {
                 name: "justhandled_list_utilities",
-                description: "List JustHandled deterministic preflights, prices, and limitations.",
+                description: "List JustHandled preflights, maintained-data lookups, evidence products, prices, and limitations.",
                 inputSchema: { type: "object", properties: {}, additionalProperties: false },
             },
             ...catalog.utilities.map((utility) => ({

package/examples/channel-experiment-postmortem.sample.json

@@ -0,0 +1,9 @@
+{
+  "observed_at": "2026-08-16T00:00:00Z",
+  "experiment": {"id":"directory-proof-v1","channel":"agent-directory","hypothesis":"A concrete evidence packet will produce at least two attributable checkout openings in 14 days.","objective":"qualified-demand","started_at":"2026-08-01T00:00:00Z","ended_at":"2026-08-15T00:00:00Z","declared_before_start":true,"gate":{"metric":"checkout-open","threshold":2,"window_days":14},"variables":{"channel":"agent-directory","offer":"$19 evidence skill","artifact":"proof-led listing","audience":"AI agent builders","timing":"14-day launch window"},"changed_variables":["artifact"],"max_cost_usd":0,"max_effort_hours":5,"cooldown_days":7},
+  "events": [{"id":"open-1","type":"checkout-open","occurred_at":"2026-08-05T12:00:00Z","evidence_ref":"checkout:open:1","external_actor":true,"owner_controlled":false,"attribution":"verified"},{"id":"open-2","type":"checkout-open","occurred_at":"2026-08-09T12:00:00Z","evidence_ref":"checkout:open:2","external_actor":true,"owner_controlled":false,"attribution":"direct"}],
+  "cost_usd": 0,
+  "effort_hours": 3,
+  "attribution_complete": true,
+  "owner_activity_excluded": true
+}

package/examples/chicago-contract-change-packet.sample.json

@@ -0,0 +1,7 @@
+{
+  "query": {
+    "field": "vendor",
+    "value": "THUONG TRAN"
+  },
+  "max_results": 10
+}

package/examples/proof-to-channel-evidence-packet.sample.json

@@ -0,0 +1,10 @@
+{
+  "observed_at": "2026-08-01T23:30:00Z",
+  "max_evidence_age_days": 30,
+  "product": {"id":"example-agent","name":"Example Agent","version":"1.0.0","canonical_url":"https://example.com/agent","offer_url":"https://example.com/agent/try","price_usd":19},
+  "channel": {"name":"Example Agent Directory","kind":"agent-directory","rules_captured_at":"2026-08-01T22:00:00Z","rules_source_url":"https://example.com/directory/rules","rule_status":"verified","link_policy":"allowed","pricing_disclosure_required":true,"demo_required":true,"screenshots_required":1,"identity_fields":[]},
+  "claims": [{"id":"deterministic","text":"Produces a deterministic evidence report from normalized input.","evidence_ids":["docs","demo"],"required_for_submission":true,"personal_experience":false}],
+  "evidence": [{"id":"docs","type":"documentation","source_url":"https://example.com/agent/docs","captured_at":"2026-08-01T22:30:00Z","observed":true,"supports_claim_ids":["deterministic"]},{"id":"demo","type":"demo","source_url":"https://example.com/agent/demo","captured_at":"2026-08-01T22:35:00Z","observed":true,"supports_claim_ids":["deterministic"]},{"id":"shot","type":"screenshot","source_url":"https://example.com/agent/screenshot","captured_at":"2026-08-01T22:40:00Z","observed":true,"supports_claim_ids":[]}],
+  "artifacts": {"demo_url":"https://example.com/agent/demo","install_path":"Run npx example-agent with the supplied JSON file.","screenshots":[{"id":"hero","evidence_id":"shot"}],"pricing_disclosure":"$19 one-time download.","link_target":"https://example.com/agent/try?source=directory","attribution_mechanism":"Preserve the source token through checkout-open and settlement receipts."},
+  "human_authored_fields": {}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justhandledlabs/agent-client",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Guarded CLI and MCP client for JustHandled's x402 utility gateway",
   "type": "module",
   "license": "MIT",
@@ -23,7 +23,9 @@
     "preflight",
     "agent-evaluation",
     "agent-observability",
-    "evidence"
+    "evidence",
+    "public-data",
+    "procurement"
   ],
   "files": [
     "dist",

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-nine guarded pay-per-call preflights and evidence products over USDC x402.",
-  "version": "0.8.0",
+  "description": "Thirty-two guarded pay-per-call preflights, maintained-data lookups, and evidence products over USDC x402.",
+  "version": "0.10.0",
   "repository": {
     "url": "https://github.com/justhandledlabs/justhandled-agent-client",
     "source": "github"
@@ -12,7 +12,7 @@
     {
       "registryType": "npm",
       "identifier": "@justhandledlabs/agent-client",
-      "version": "0.8.0",
+      "version": "0.10.0",
       "transport": {
         "type": "stdio"
       },