@justhandledlabs/agent-client - npm Package Compare versions

Comparing version 0.7.0 to 0.8.0

examples/channel-fit-evidence-matrix.sample.json

+{
+  "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
+      }
+    }
+  ]
+}

dist/config.js

@@ -17,2 +17,3 @@ export const GATEWAY_ORIGIN = "https://justhandled-agent-gateway.netlify.app";
     "qualified-demand-ledger",
+    "channel-fit-evidence-matrix",
 ]);
@@ -19,0 +20,0 @@ export function expectedPriceForUtility(utility) {

dist/mcp.js

@@ -6,3 +6,3 @@ #!/usr/bin/env node
 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.8.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => {
@@ -9,0 +9,0 @@ const catalog = await getCatalog();

package.json

 {
   "name": "@justhandledlabs/agent-client",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Guarded CLI and MCP client for JustHandled's x402 utility gateway",
@@ -5,0 +5,0 @@ "type": "module",

README.md

 # 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 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.
 
@@ -16,2 +16,3 @@ 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.
 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
 ```
@@ -64,3 +65,3 @@
 - 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.
@@ -67,0 +68,0 @@ - A mismatched term aborts before signing.

server.json

@@ -5,4 +5,4 @@ {
   "title": "JustHandled Agent Utility Gateway",
-  "description": "Twenty-eight guarded pay-per-call preflights and evidence products over USDC x402.",
-  "version": "0.7.0",
+  "description": "Twenty-nine guarded pay-per-call preflights and evidence products over USDC x402.",
+  "version": "0.8.0",
   "repository": {
@@ -16,3 +16,3 @@ "url": "https://github.com/justhandledlabs/justhandled-agent-client",
       "identifier": "@justhandledlabs/agent-client",
-      "version": "0.7.0",
+      "version": "0.8.0",
       "transport": {
@@ -19,0 +19,0 @@ "type": "stdio"

No alert changes

Improved metrics

Total package byte prevSize

31301

10.36%

Number of package files

23

4.55%

Lines of code

581

19.55%

Number of lines in readme file

79

1.28%

No dependency changes