fix: setup docs, error integration, response shapes, bump to 0.2.2

Author: fieldviolence

package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-markets-cli",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "type": "module",
   "description": "CLI for trading on Context prediction markets",
   "author": "Context",

skills/api-reference.md

@@ -754,7 +754,8 @@ Response:
 {
   "status": "new_wallet",
   "address": "0xAddress",
-  "privateKey": "(saved to ~/.config/context/config.env)",
+  "saved": true,
+  "configPath": "~/.config/context/config.env",
   "nextSteps": ["string"]
 }
 ```

skills/onboarding.md

@@ -22,7 +22,7 @@ If you don't have a private key yet:
 **JSON mode** (`context setup --output json`): The key is always saved to the config file automatically, since agents can't manually back up keys. The key is never included in JSON output.
 
 ```bash
-context setup --output json
+context setup --output json --api-key <key>
 ```
 
 ```json
@@ -85,12 +85,9 @@ context deposit 500
 
 ```json
 {
-  "success": true,
-  "txHash": "0x...",
-  "user": "0xYourAddress",
-  "token": "0x...",
-  "amount": "500000000",
-  "relayer": "0x..."
+  "status": "deposited",
+  "amount_usdc": 500,
+  "tx_hash": "0x..."
 }
 ```
 

src/cli.ts

@@ -136,9 +136,10 @@ Options:
   --chain <chain>       Target chain (default: mainnet)
   --yes                 Skip confirmations
   --save                Save wallet to config file (for --output json)
+                       (always on in --output json mode)
 
 Agent workflow (non-interactive):
-  context setup --output json --save           Generate wallet, save to config
+  context setup --output json                  Generate wallet, save to config
   context approve --output json                Approve contracts
   context deposit <amount> --output json       Deposit USDC`);
           break;

src/commands/setup.ts

@@ -4,21 +4,18 @@
 
 import * as p from "@clack/prompts";
 import chalk from "chalk";
-import { ContextApiError, type AccountStatus } from "context-markets";
+import type { AccountStatus } from "context-markets";
 import { formatEther } from "viem";
 import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
 import { tradingClient, type ClientFlags } from "../client.js";
 import { out, fail, getOutputMode, requirePositional, type ParsedArgs } from "../format.js";
 import { loadConfig, saveConfig, configPath } from "../config.js";
+import { cleanErrorMessage } from "../error.js";
 import { confirmAction } from "../ui/prompt.js";
 
 const MIN_ETH_FOR_GAS = 1_000_000_000_000n; // 0.000001 ETH — just enough for a few txs
 const PRIVATE_KEY_PATTERN = /^0x[0-9a-fA-F]{64}$/;
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null;
-}
-
 export default async function handleSetup(parsed: ParsedArgs): Promise<void> {
   const { subcommand, positional, flags } = parsed;
 
@@ -44,30 +41,6 @@ export default async function handleSetup(parsed: ParsedArgs): Promise<void> {
 // Shared approve → mint → deposit flow
 // ---------------------------------------------------------------------------
 
-/** Dig through error cause chain to find the most useful message */
-function formatError(err: unknown): string {
-  if (!(err instanceof Error)) return String(err);
-
-  // Walk the cause chain to find the deepest message
-  let deepest = err;
-  let current: unknown = err;
-  while (current instanceof Error && current.cause) {
-    current = current.cause;
-    if (current instanceof Error) deepest = current;
-  }
-
-  if (err instanceof ContextApiError) {
-    const body = err.body;
-    if (isRecord(body) && typeof body.message === "string") return body.message;
-    if (typeof body === "string") return body;
-  }
-
-  // Use the deepest cause message if it's more specific
-  const deepMsg = deepest.message.split("\n")[0];
-  const topMsg = err.message.split("\n")[0];
-  return deepMsg !== topMsg && deepMsg.length > 5 ? `${topMsg}: ${deepMsg}` : topMsg;
-}
-
 /**
  * Check ETH balance and wait for funding if needed.
  * Takes pre-fetched status to avoid redundant API calls.
@@ -126,7 +99,8 @@ async function approveWithRetry(ctx: ReturnType<typeof tradingClient>): Promise<
       return true;
     } catch (err) {
       s.stop("Approval failed");
-      p.log.warning(formatError(err));
+      const msg = cleanErrorMessage(err instanceof Error ? err.message : String(err));
+      p.log.warning(msg);
 
       const action = await p.select({
         message: "What would you like to do?",
@@ -254,7 +228,8 @@ async function onboardingFlow(ctx: ReturnType<typeof tradingClient>): Promise<bo
         deposited = true;
       } catch (err) {
         sp.stop("Deposit failed");
-        p.log.warning(formatError(err));
+        const msg = cleanErrorMessage(err instanceof Error ? err.message : String(err));
+        p.log.warning(msg);
 
         const action = await p.select({
           message: "What would you like to do?",