npm - @zeroxyz/cli - Versions diffs - 0.0.21 → 0.0.23 - Mend

@zeroxyz/cli 0.0.21 → 0.0.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/dist/index.js CHANGED Viewed

@@ -6,7 +6,7 @@ import { Command as Command9 } from "commander";
 // package.json
 var package_default = {
   name: "@zeroxyz/cli",
-  version: "0.0.21",
+  version: "0.0.23",
   type: "module",
   bin: {
     zero: "dist/index.js",
@@ -111,6 +111,44 @@ var configCommand = (_appContext) => new Command("config").description("View or
 // src/commands/fetch-command.ts
 import { Command as Command2 } from "commander";
+// src/util/infer-schema.ts
+var inferSchema = (value, depth = 0) => {
+  if (depth > 6) return { type: typeOf(value) };
+  if (value === null) return { type: "null" };
+  if (Array.isArray(value)) {
+    const itemSchemas = value.slice(0, 3).map((v) => inferSchema(v, depth + 1));
+    return {
+      type: "array",
+      items: itemSchemas[0] ?? { type: "unknown" }
+    };
+  }
+  if (typeof value === "object") {
+    const obj = value;
+    const properties = {};
+    const required = [];
+    for (const [k, v] of Object.entries(obj)) {
+      properties[k] = inferSchema(v, depth + 1);
+      required.push(k);
+    }
+    return { type: "object", properties, required };
+  }
+  return { type: typeOf(value) };
+};
+var typeOf = (v) => {
+  if (v === null) return "null";
+  if (Array.isArray(v)) return "array";
+  return typeof v;
+};
+var tryParseJson = (text) => {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+};
+// src/commands/fetch-command.ts
 var detectPaymentRequirement = (headers, status) => {
   if (status !== 402) return null;
   const x402Header = headers.get("payment-required") ?? headers.get("x-payment-required");
@@ -130,7 +168,10 @@ var detectPaymentRequirement = (headers, status) => {
   }
   return { protocol: "unknown", raw: {} };
 };
-var fetchCommand = (appContext) => new Command2("fetch").description("Fetch a capability URL with automatic payment handling").argument("<url>", "URL to fetch").option("-d, --data <body>", "Request body (JSON string)").option("-H, --header <header...>", "Headers in Key:Value format").option("--max-pay <amount>", "Maximum amount willing to pay (USDC)").option(
+var fetchCommand = (appContext) => new Command2("fetch").description("Fetch a capability URL with automatic payment handling").argument("<url>", "URL to fetch").option(
+  "-X, --method <method>",
+  "HTTP method (GET, POST, PUT, PATCH, DELETE). Defaults to POST when -d is set, otherwise GET"
+).option("-d, --data <body>", "Request body (JSON string)").option("-H, --header <header...>", "Headers in Key:Value format").option("--max-pay <amount>", "Maximum amount willing to pay (USDC)").option(
   "--capability <id>",
   "Bind this fetch to a capability (uid or slug) so a reviewable run is recorded even without a prior `zero search`"
 ).option(
@@ -163,55 +204,80 @@ var fetchCommand = (appContext) => new Command2("fetch").description("Fetch a ca
         headers["content-type"] = "application/json";
       }
       const log = (msg) => console.error(`  ${msg}`);
+      const method = options.method ? options.method.toUpperCase() : options.data ? "POST" : "GET";
       const requestInit = {
-        method: options.data ? "POST" : "GET",
+        method,
         headers,
         body: options.data
       };
-      log(`Calling ${url}...`);
-      const response = await fetch(url, requestInit);
-      const paymentReq = detectPaymentRequirement(
-        response.headers,
-        response.status
+      const lastSearch = stateService.loadLastSearch();
+      const matchedCapability = lastSearch?.capabilities.find(
+        (c) => url.startsWith(c.url)
       );
-      let finalResponse;
-      let paymentMeta;
-      if (paymentReq) {
-        log(
-          `Payment required (${paymentReq.protocol}) \u2014 preparing payment...`
+      const capabilityId = options.capability ?? matchedCapability?.id ?? null;
+      const searchId = matchedCapability ? lastSearch?.searchId : void 0;
+      const skipReasons = [];
+      if (!apiService.walletAddress) {
+        skipReasons.push(
+          "no wallet configured (run `zero wallet import` / set ZERO_PRIVATE_KEY)"
         );
-        const result = await paymentService.handlePayment(
-          url,
-          requestInit,
-          paymentReq,
-          options.maxPay,
-          log
+      }
+      if (!capabilityId) {
+        skipReasons.push(
+          "no capability resolved \u2014 pass --capability <uid|slug> or run `zero search` first so the URL can be matched"
         );
-        finalResponse = result.response;
-        paymentMeta = {
-          protocol: result.protocol,
-          chain: result.chain,
-          txHash: result.txHash,
-          amount: result.amount,
-          asset: result.asset
-        };
-        log(
-          `Paid ${result.amount} ${result.asset} via ${result.protocol} on ${result.chain}`
+      }
+      let finalResponse;
+      let body = "";
+      let paymentMeta;
+      let fetchError;
+      try {
+        log(`Calling ${url}...`);
+        const response = await fetch(url, requestInit);
+        const paymentReq = detectPaymentRequirement(
+          response.headers,
+          response.status
         );
-      } else {
-        finalResponse = response;
+        if (paymentReq) {
+          log(
+            `Payment required (${paymentReq.protocol}) \u2014 preparing payment...`
+          );
+          const result = await paymentService.handlePayment(
+            url,
+            requestInit,
+            paymentReq,
+            options.maxPay,
+            log
+          );
+          finalResponse = result.response;
+          paymentMeta = {
+            protocol: result.protocol,
+            chain: result.chain,
+            txHash: result.txHash,
+            amount: result.amount,
+            asset: result.asset
+          };
+          log(
+            `Paid ${result.amount} ${result.asset} via ${result.protocol} on ${result.chain}`
+          );
+        } else {
+          finalResponse = response;
+        }
+        body = await finalResponse.text();
+      } catch (err) {
+        fetchError = err instanceof Error ? err : new Error(String(err));
       }
       const latencyMs = Date.now() - startTime;
-      const body = await finalResponse.text();
-      if (!options.json) {
+      if (finalResponse && !options.json) {
         console.log(body);
       }
       analyticsService.capture("fetch_executed", {
         url,
-        status: finalResponse.status,
+        status: finalResponse?.status,
         hasPayment: !!paymentMeta,
         paymentProtocol: paymentMeta?.protocol,
-        paymentAmount: paymentMeta?.amount
+        paymentAmount: paymentMeta?.amount,
+        ...fetchError && { error: fetchError.message }
       });
       if (paymentMeta) {
         try {
@@ -230,31 +296,30 @@ var fetchCommand = (appContext) => new Command2("fetch").description("Fetch a ca
         } catch {
         }
       }
-      const lastSearch = stateService.loadLastSearch();
-      const matchedCapability = lastSearch?.capabilities.find(
-        (c) => url.startsWith(c.url)
-      );
-      const capabilityId = options.capability ?? matchedCapability?.id ?? null;
-      const searchId = matchedCapability ? lastSearch?.searchId : void 0;
       let runId = null;
-      const skipReasons = [];
-      if (!apiService.walletAddress) {
-        skipReasons.push(
-          "no wallet configured (run `zero wallet import` / set ZERO_PRIVATE_KEY)"
-        );
-      }
-      if (!capabilityId) {
-        skipReasons.push(
-          "no capability resolved \u2014 pass --capability <uid|slug> or run `zero search` first so the URL can be matched"
-        );
-      }
       if (capabilityId && apiService.walletAddress) {
+        let requestSchema;
+        let responseSchema;
+        if (options.data) {
+          const parsedReq = tryParseJson(options.data);
+          if (parsedReq !== null && typeof parsedReq === "object") {
+            requestSchema = inferSchema(parsedReq);
+          }
+        }
+        if (body) {
+          const parsedResp = tryParseJson(body);
+          if (parsedResp !== null && typeof parsedResp === "object") {
+            responseSchema = inferSchema(parsedResp);
+          }
+        }
         try {
           const runResult = await apiService.createRun({
             capabilityId,
             searchId,
-            status: finalResponse.status,
+            status: finalResponse?.status,
             latencyMs,
+            requestSchema,
+            responseSchema,
             ...paymentMeta && {
               costAmount: paymentMeta.amount,
               costAsset: paymentMeta.asset,
@@ -271,14 +336,18 @@ var fetchCommand = (appContext) => new Command2("fetch").description("Fetch a ca
           );
         }
       }
+      if (fetchError && !options.json) {
+        console.error(`  Fetch failed: ${fetchError.message}`);
+      }
       if (options.json) {
         console.log(
           JSON.stringify({
             runId,
-            status: finalResponse.status,
+            status: finalResponse?.status ?? null,
             latencyMs,
             payment: paymentMeta ?? null,
-            body,
+            body: finalResponse ? body : null,
+            ...fetchError && { error: fetchError.message },
             ...skipReasons.length > 0 && {
               runTrackingSkipped: skipReasons
             }
@@ -311,6 +380,9 @@ var fetchCommand = (appContext) => new Command2("fetch").description("Fetch a ca
   Note: this run was NOT recorded for review \u2014 ${skipReasons.join("; ")}.`
         );
       }
+      if (fetchError) {
+        process.exitCode = 1;
+      }
     } catch (err) {
       console.error(err instanceof Error ? err.message : "Fetch failed");
       process.exitCode = 1;
@@ -810,7 +882,13 @@ Bulk review complete: ${ok} ok, ${failed} failed`);
           process.exitCode = 1;
           return;
         }
-        runId = list.runs[0].uid;
+        const [only] = list.runs;
+        if (!only) {
+          console.error("No run found for capability");
+          process.exitCode = 1;
+          return;
+        }
+        runId = only.uid;
         console.log(`Resolved to run ${runId}`);
       }
       const accuracy = requireRating("accuracy", options.accuracy);
@@ -934,7 +1012,13 @@ var formatSearchResults = (results) => {
 var searchCommand = (appContext) => new Command7("search").description("Search for capabilities").argument("<query>", "Search query").option("--json", "Output raw JSON to stdout").option("--offset <n>", "Pagination offset", Number).option("--limit <n>", "Results per page", Number).option("--free", "Only show free capabilities").option("--max-cost <amount>", "Maximum cost per call").option("--min-rating <stars>", "Minimum star rating (1-5)", Number).option("--protocol <protocol>", "Payment protocol (x402 or mpp)").option("--min-trust <n>", "Minimum trust score (0-100)", Number).option(
   "--status <status>",
   "Filter by availability (healthy, degraded, down)"
-).option("--all", "Show all results (no trust or health filtering)").action(
+).option("--all", "Show all results (no trust or health filtering)").option(
+  "--source <source>",
+  "Only show results from this crawl source (e.g. mpp, bazaar)"
+).option(
+  "--exclude-source <source>",
+  "Exclude results from this crawl source"
+).action(
   async (query, options) => {
     try {
       const { analyticsService, apiService, stateService } = appContext.services;
@@ -963,7 +1047,9 @@ var searchCommand = (appContext) => new Command7("search").description("Search f
         protocol: options.protocol,
         minTrust: options.minTrust,
         availabilityStatus: options.status,
-        includeAll: options.all
+        includeAll: options.all,
+        source: options.source,
+        excludeSource: options.excludeSource
       });
       analyticsService.capture("search_executed", {
         query,
@@ -1311,6 +1397,12 @@ var capabilityResponseSchema = z3.object({
     stars: z3.string().nullable().optional(),
     state: z3.enum(["unrated", "rated"]).optional()
   }),
+  priceObserved: z3.object({
+    medianCents: z3.string(),
+    p95Cents: z3.string(),
+    sampleCount: z3.number(),
+    varies: z3.boolean()
+  }).nullable().optional(),
   paymentMethods: z3.array(
     z3.object({
       uid: z3.string(),

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
 	"name": "@zeroxyz/cli",
-	"version": "0.0.21",
+	"version": "0.0.23",
 	"type": "module",
 	"bin": {
 		"zero": "dist/index.js",

package/skills/zero/SKILL.md CHANGED Viewed

@@ -33,7 +33,13 @@ Run these commands in order. Do not skip steps.
 **Step 1 — Install:** `npm i -g @zeroxyz/cli`
-**Step 2 — Initialize wallet:** `zero init` — generates a new wallet. Save the printed address. Or, to use an existing wallet: `zero wallet set <privateKey>` (0x-prefixed hex private key).
+**Step 2 — Provide a wallet.** Pick one path:
+- **New wallet (persistent):** `zero init` — generates a wallet and writes it to `~/.zero/config.json`. Save the printed address.
+- **Existing wallet (persistent):** `zero wallet set <privateKey>` — 0x-prefixed hex. Writes to `~/.zero/config.json`. Refuses to overwrite an existing wallet without `--force`.
+- **Existing wallet (ephemeral, e.g. CI):** set `ZERO_PRIVATE_KEY=0x...` in the environment. The CLI reads it at runtime and writes nothing to disk.
+**Prefer `zero init` or `zero wallet set` for local/interactive use** so the wallet persists across shells. Use `ZERO_PRIVATE_KEY` only when persisting to disk is undesirable — CI jobs, containers, one-off scripts, or secrets-manager-injected environments.
 **Step 3 — Fund wallet:** `zero wallet fund` — opens browser to add USDC (Base). For manual transfer: `zero wallet fund --manual`.
@@ -41,7 +47,7 @@ Run these commands in order. Do not skip steps.
 ### Setup Rules
-- If `ZERO_PRIVATE_KEY` is set in the environment, the CLI uses that key instead of the one from `zero init`.
+- Precedence: `ZERO_PRIVATE_KEY` (env) > `~/.zero/config.json`. If the env var is set, it wins even when a config file exists — useful for overriding on a single invocation (`ZERO_PRIVATE_KEY=0x... zero wallet balance`).
 - Wallet must be funded with USDC on Base before calling paid capabilities.
 ## After Setup
@@ -105,7 +111,9 @@ zero fetch https://api.example.com/expensive --max-pay 0.50
 ### Rules
-- Always discover capabilities with `zero search` + `zero get` before calling; never guess endpoint URLs or schemas.
+- **Always `zero search` fresh, every time.** Never reuse a capability URL, slug, schema, or price from an earlier turn, prior conversation, training data, or memory. Capabilities churn constantly — endpoints go offline, prices change, schemas evolve, and rankings shift as reviews accumulate. A capability that worked yesterday may be dead, repriced, or outranked today. Searching again costs nothing and is the only way to get current trust scores and availability.
+- **Always `zero get` before `zero fetch`.** Even if you "know" the URL, re-fetch the full details to confirm the URL, method, required headers, body schema, and current price. Do not reconstruct a fetch call from memory.
+- Never guess endpoint URLs or schemas.
 - Use `--max-pay` before potentially expensive requests.
 - Review capabilities after every paid call. The review signal feeds search ranking — skipping reviews means your next search is less informed.
 - Before ending a multi-call task, run `zero runs --unreviewed` and review anything you missed.