@zeroxyz/cli 1.9.0 → 1.10.0

package/dist/index.js

@@ -76582,7 +76582,7 @@ init_esm_shims();
 
 // package.json
 var package_default = {
-  version: "1.9.0"};
+  version: "1.10.0"};
 
 // src/app.ts
 init_esm_shims();
@@ -77590,7 +77590,7 @@ init_esm_shims();
 // ../sdk/dist/index.js
 init_esm_shims();
 
-// ../sdk/dist/chunk-26IHUYNK.js
+// ../sdk/dist/chunk-NUBD543C.js
 init_esm_shims();
 
 // ../../node_modules/.pnpm/viem@2.52.2_bufferutil@4.1.0_typescript@5.9.3_utf-8-validate@6.0.6_zod@4.3.6/node_modules/viem/_esm/index.js
@@ -142972,7 +142972,7 @@ config(en_default2());
 // ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/index.js
 var zod_default = external_exports3;
 
-// ../sdk/dist/chunk-26IHUYNK.js
+// ../sdk/dist/chunk-NUBD543C.js
 var createManagedAccount = (client, address2) => toAccount({
   address: address2,
   async signMessage({ message: message2 }) {
@@ -144784,7 +144784,7 @@ var clientFetch = async (client, url4, opts = {}) => {
   return result;
 };
 var package_default2 = {
-  version: "0.7.0"
+  version: "0.8.0"
 };
 var SDK_VERSION2 = package_default2.version;
 var userWalletDtoSchema = external_exports3.object({
@@ -145391,6 +145391,14 @@ var capabilityResponseSchema = external_exports3.object({
   example: external_exports3.object({ request: external_exports3.unknown(), response: external_exports3.unknown() }).nullable(),
   tags: external_exports3.array(external_exports3.string()).nullable(),
   exampleAgentPrompt: external_exports3.string().nullable().optional(),
+  whatItDoes: external_exports3.string().nullable().optional(),
+  resultDescription: external_exports3.string().nullable().optional(),
+  failureModes: external_exports3.array(external_exports3.string()).nullable().optional(),
+  whenToPreferThis: external_exports3.string().nullable().optional(),
+  // Agent-facing execution guide (markdown). Covers usage patterns, input
+  // field guidance, cross-cap composition, and known failure modes.
+  // Named after MCP tool convention: description = what it is, instructions = how to use it.
+  instructions: external_exports3.string().nullable().optional(),
   displayCostAmount: external_exports3.string(),
   displayCostAsset: external_exports3.string(),
   reviewCount: external_exports3.number(),
@@ -147073,28 +147081,35 @@ var fetchCommand = (appContext) => new Command("fetch").description(
           })
         );
       } else if (runId && outcomeInfo.reviewable) {
+        const isTTY = process.stderr.isTTY;
         console.error(`
   Run ID: ${runId}`);
-        console.error(
-          `  Leave a review to help other agents discover great capabilities:`
-        );
-        console.error(
-          `  zero review ${runId} --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"`
-        );
-        console.error(
-          [
-            ``,
-            `  Tips for a great review:`,
-            `    --success / --no-success   Did the API return the result you expected?`,
-            `    --accuracy  1-5            How correct was the response? (1 = wrong, 5 = perfect)`,
-            `    --value     1-5            Was it worth the price? (1 = overpriced, 5 = great deal)`,
-            `    --reliability 1-5          Did it respond quickly and without errors? (1 = flaky, 5 = rock solid)`,
-            `    --content                  Free-text is optional but helps other agents pick the best capability.`,
-            `                               Published publicly \u2014 do not include personal or identifying`,
-            `                               information (names, emails, phone numbers, addresses, keys, SSNs).`,
-            ``
-          ].join("\n")
-        );
+        if (isTTY) {
+          console.error(
+            `  Leave a review to help other agents discover great capabilities:`
+          );
+          console.error(
+            `  zero review ${runId} --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"`
+          );
+          console.error(
+            [
+              ``,
+              `  Tips for a great review:`,
+              `    --success / --no-success   Did the API return the result you expected?`,
+              `    --accuracy  1-5            How correct was the response? (1 = wrong, 5 = perfect)`,
+              `    --value     1-5            Was it worth the price? (1 = overpriced, 5 = great deal)`,
+              `    --reliability 1-5          Did it respond quickly and without errors? (1 = flaky, 5 = rock solid)`,
+              `    --content                  Free-text is optional but helps other agents pick the best capability.`,
+              `                               Published publicly \u2014 do not include personal or identifying`,
+              `                               information (names, emails, phone numbers, addresses, keys, SSNs).`,
+              ``
+            ].join("\n")
+          );
+        } else {
+          console.error(
+            `  zero review ${runId} --success --accuracy 5 --value 4 --reliability 5`
+          );
+        }
       } else if (!runId && cliSkipReasons.length > 0) {
         console.error(
           `
@@ -147405,7 +147420,11 @@ var buildTryItExample = (capability) => {
   if (method === "GET" || queryParams && !body) {
     const qpProps = queryParams ? asNode(queryParams.properties) : null;
     const qs = qpProps ? Object.entries(qpProps).map(
-      ([k3, schema]) => `${encodeURIComponent(k3)}=${encodeURIComponent(placeholderFor(k3, schema))}`
+      // Key is always an identifier — safe to encode. Value is
+      // left unencoded so `<FIELD>` placeholders stay readable
+      // (encodeURIComponent would produce %3CFIELD%3E, which
+      // agents copy verbatim and get a charged 400).
+      ([k3, schema]) => `${encodeURIComponent(k3)}=${placeholderFor(k3, schema)}`
     ).join("&") : "";
     const url4 = qs ? `${capability.url}?${qs}` : capability.url;
     const urlLine = `  zero fetch --capability ${capability.slug} "${url4}"`;
@@ -147453,6 +147472,12 @@ var formatCapability = (capability) => {
   lines.push(
     `  Last successful run: ${formatRelativeTimestamp(capability.lastSuccessfullyRanAt)}`
   );
+  if (capability.instructions?.trim()) {
+    lines.push("", "Instructions:");
+    for (const line of capability.instructions.trim().split("\n")) {
+      lines.push(`  ${line}`);
+    }
+  }
   if (capability.exampleAgentPrompt?.trim()) {
     lines.push("  Example prompt:");
     for (const promptLine of capability.exampleAgentPrompt.split("\n")) {
@@ -148679,7 +148704,8 @@ var formatSearchResults = (results) => {
     const ratingBadge = formatRatingBadge(r2.rating);
     const statusBadge = formatStatusBadge(r2.availabilityStatus);
     const costLabel = r2.cost.amount === "0" ? "Free" : r2.cost.amount === "unknown" ? "variable pricing" : `$${r2.cost.amount}/call`;
-    return `  ${r2.position}. ${displayName} \u2014 ${costLabel} \u2014 ${ratingBadge}${statusBadge}
+    const tokenHint = r2.token ? ` [${r2.token}]` : "";
+    return `  ${r2.position}.${tokenHint} ${displayName} \u2014 ${costLabel} \u2014 ${ratingBadge}${statusBadge}
      "${displayDescription}"`;
   }).join("\n");
 };

package/package.json

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