@justhandledlabs/agent-client 0.7.0 → 0.9.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-eight deterministic preflights, maintained-data lookups, and evidence products. Twenty-two products cost $0.05 USDC; six evidence-heavy products cost $0.25, including Agent Distribution Readiness, Community Rule & Credibility Preflight, and Qualified Demand Ledger. 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-one deterministic preflights, maintained-data lookups, and evidence products. Twenty-two products cost $0.05 USDC; nine evidence-heavy products cost $0.25, including Channel-Fit Evidence Matrix, Proof-to-Channel Evidence Packet, and Channel Experiment Postmortem. 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.
 
@@ -13,6 +13,9 @@ npx --package @justhandledlabs/agent-client justhandled-agent preview agent-run-
 npx --package @justhandledlabs/agent-client justhandled-agent preview agent-distribution-readiness-pack --file agent-distribution-readiness-pack.sample.json
 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
 ```
 
 Preview performs an unpaid request and validates the returned x402 terms. It does not sign or spend.
@@ -60,7 +63,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 six $0.25 products' 250,000-base-unit price is pinned separately from 50,000-base-unit checks.
+- The seven $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

@@ -14,6 +14,9 @@ export const QUARTER_DOLLAR_UTILITIES = new Set([
     "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,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.7.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "justhandled-agent-gateway", version: "0.9.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     const catalog = await getCatalog();
     return {

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/channel-fit-evidence-matrix.sample.json

@@ -0,0 +1,94 @@
+{
+  "observed_at": "2026-08-01T22:30:00Z",
+  "objective": "qualified-demand",
+  "constraints": {
+    "budget_usd": 50,
+    "effort_hours": 12,
+    "max_parallel_tests": 2,
+    "rules_max_age_days": 30
+  },
+  "evidence": [
+    {
+      "id": "rule-agent-directory",
+      "type": "platform-rule",
+      "captured_at": "2026-08-01T20:00:00Z",
+      "source_url": "https://example.com/directory-rules",
+      "observed": true
+    },
+    {
+      "id": "rule-marketplace",
+      "type": "platform-rule",
+      "captured_at": "2026-08-01T20:10:00Z",
+      "source_url": "https://example.com/marketplace-rules",
+      "observed": true
+    },
+    {
+      "id": "proof-live",
+      "type": "product-proof",
+      "captured_at": "2026-08-01T21:00:00Z",
+      "source_url": "https://example.com/product",
+      "observed": true
+    },
+    {
+      "id": "proof-readiness",
+      "type": "distribution-readiness",
+      "captured_at": "2026-08-01T21:10:00Z",
+      "source_url": "https://example.com/readiness-receipt",
+      "observed": true
+    }
+  ],
+  "channels": [
+    {
+      "id": "agent-directory",
+      "kind": "agent-directory",
+      "audience_match": 5,
+      "buyer_intent": 4,
+      "format_match": 5,
+      "saturation": 3,
+      "rule_status": "verified",
+      "rule_evidence_id": "rule-agent-directory",
+      "product_evidence_ids": ["proof-live", "proof-readiness"],
+      "attribution": "verified",
+      "attribution_mechanism": "Unique source token preserved through the unpaid challenge and settlement receipt.",
+      "existing_access": "account",
+      "offer_path_ready": true,
+      "estimated_cost_usd": 0,
+      "estimated_effort_hours": 2,
+      "owner_presence_required": false,
+      "owner_available": true,
+      "outcome_gate": {
+        "metric": "payment-initiation",
+        "threshold": 2,
+        "window_days": 14,
+        "max_cost_usd": 0,
+        "max_effort_hours": 4
+      }
+    },
+    {
+      "id": "marketplace",
+      "kind": "marketplace",
+      "audience_match": 4,
+      "buyer_intent": 5,
+      "format_match": 4,
+      "saturation": 4,
+      "rule_status": "verified",
+      "rule_evidence_id": "rule-marketplace",
+      "product_evidence_ids": ["proof-live"],
+      "attribution": "direct",
+      "attribution_mechanism": "Marketplace listing identifier linked to checkout-opening evidence.",
+      "existing_access": "account",
+      "offer_path_ready": true,
+      "estimated_cost_usd": 0,
+      "estimated_effort_hours": 3,
+      "owner_presence_required": false,
+      "owner_available": true,
+      "outcome_gate": {
+        "metric": "checkout-open",
+        "threshold": 2,
+        "window_days": 14,
+        "max_cost_usd": 0,
+        "max_effort_hours": 5
+      }
+    }
+  ]
+}

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.7.0",
+  "version": "0.9.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-eight guarded pay-per-call preflights and evidence products over USDC x402.",
-  "version": "0.7.0",
+  "description": "Thirty-one guarded pay-per-call preflights and evidence products over USDC x402.",
+  "version": "0.9.0",
   "repository": {
     "url": "https://github.com/justhandledlabs/justhandled-agent-client",
     "source": "github"
@@ -12,7 +12,7 @@
     {
       "registryType": "npm",
       "identifier": "@justhandledlabs/agent-client",
-      "version": "0.7.0",
+      "version": "0.9.0",
       "transport": {
         "type": "stdio"
       },