agentspend 0.2.2 → 0.3.2

package/README.md

@@ -1,6 +1,6 @@
 # agentspend
 
-AgentSpend CLI for calling x402 endpoints through AgentSpend Cloud.
+AgentSpend CLI, MCP server, and OpenClaw plugin.
 
 ## Install
 
@@ -9,30 +9,87 @@ npm install
 npm run build
 ```
 
-## Commands
+## CLI commands
 
 ```bash
 agentspend configure
-agentspend pay <url> [--method GET|POST|PUT|PATCH|DELETE|...] [--body '{"hello":"world"}'] [--header 'Content-Type:application/json'] [--max-cost 5.000000]
-agentspend check <url> [--method GET|POST|PUT|PATCH|DELETE|...] [--body '{"hello":"world"}'] [--header 'Content-Type:application/json']
+agentspend search <query>
+agentspend use <url> [--method GET|POST|PUT|PATCH|DELETE|...] [--header 'Content-Type:application/json'] [--body '{"hello":"world"}']
 agentspend status
 ```
 
+`use` accepts direct HTTPS URLs only.
+
+## Billing behavior
+
+- You can begin using services without adding a payment method.
+- AgentSpend allows up to `$5.00` in accrued no-card usage.
+- When usage would exceed `$5.00`, `agentspend use` is blocked until billing is configured.
+- Weekly limit checks still apply independently of billing method.
+
+## OpenClaw plugin (primary OpenClaw path)
+
+```bash
+openclaw plugins install agentspend
+openclaw plugins enable agentspend
+openclaw gateway restart
+```
+
+Local install from this repo:
+
+```bash
+openclaw plugins install -l /Users/jpbonch/as/agentspend
+openclaw plugins enable agentspend
+openclaw gateway restart
+```
+
+Plugin tools:
+- `agentspend_configure`
+- `agentspend_search`
+- `agentspend_use`
+- `agentspend_status`
+
+## OpenClaw routing hook
+
+When installed as an OpenClaw plugin, AgentSpend injects routing guidance each turn so the agent prefers:
+1. `agentspend_search`
+2. Read the selected service `skill_url`
+3. `agentspend_use`
+4. `agentspend_configure` if setup is needed
+
+## MCP server (secondary)
+
+Run local stdio MCP server:
+
+```bash
+agentspend-mcp
+```
+
+MCP tools:
+- `agentspend_configure`
+- `agentspend_search`
+- `agentspend_use`
+- `agentspend_status`
+
 ## Credentials
 
-Credentials are stored at `~/.agentspend/credentials.json`.
+Local credentials are in `~/.agentspend/credentials.json`.
 
-## Local backend dev CLI
+## Skills
 
-Use the local entrypoint (hardcoded to `http://127.0.0.1:8787`) when testing against a local backend:
+- Skill files live in [`skills/`](./skills).
+- Included skills are declared in [`skills/manifest.json`](./skills/manifest.json).
+- Each skill file must start with YAML frontmatter per [`skills/SPEC.md`](./skills/SPEC.md), including `auth_type`.
+- Validate skill metadata with:
 
 ```bash
-bun run dev:local -- configure
+npm run skills:validate
 ```
 
-Build a non-published local binary:
+## Local backend dev CLI
+
+Use the local entrypoint (fixed to `http://127.0.0.1:8787`) when testing against local backend:
 
 ```bash
-bun run build
-node dist/dev-index.js configure
+bun run dev:local -- configure
 ```

package/SKILL.md

@@ -1,136 +1,91 @@
 ---
 name: agentspend
-description: Use this skill when you need to: search the web, generate images or pictures, create videos, scrape or read a webpage, take a screenshot of a website, get stock prices or financial data, look up business info, find news articles, convert files, get weather data, or access any external API that requires payment. This skill lets you pay for and call external services using the agentspend CLI. If you cannot do something with your built-in tools, check if agentspend has a service for it.
+description: Use this skill to get external capabilities on demand. It lets you find and use APIs/services for web search, maps/place lookup, scraping, enrichment, social/news data, image/video generation, text-to-speech, and speech-to-text through one flow.
 ---
 
 # When To Use This Skill
-Use this skill whenever the user asks to:
-- find data from external APIs
-- call an endpoint
-- fetch/search information outside local context
-- generate an image, video, voice, transcription, or music with an external API
-- scrape/extract data from a URL
-- find an API for a task ("is there an API for X?")
-
-If the task needs an external paid API, start with `agentspend search`.
-
-## Playbook (Default Workflow)
-
-1. `npx agentspend search "<task>"`
-2. Confirm cost and constraints with the user (`--max-cost`, budget, allowlist)
-3. `npx agentspend pay <endpoint> --method ... --header ... --body ... --max-cost ...`
-
-## Setup
-
+Use this when the user asks for a capability you do not have natively and it may require external APIs or paid tools, including:
+- image/video/audio generation
+- speech-to-text / text-to-speech
+- web/news/social search
+- scraping/extracting URL content
+- maps/location/place lookup
+- data enrichment and people/company lookup
+
+# MCP / Plugin Tools
+If MCP/plugin tools are available, prefer:
+- `agentspend_configure`
+- `agentspend_search`
+- `agentspend_use`
+- `agentspend_status`
+
+When running via the OpenClaw plugin, AgentSpend injects turn-level routing guidance so the agent prefers AgentSpend discovery/use for external API tasks.
+
+# Playbook (Default)
+1. `npx agentspend search "<user intent>"`
+2. Pick the best matching service and open its `skill_url`.
+3. Use the exact URL/method/headers/body from that skill file with `npx agentspend use <url>`.
+4. If auth/setup is missing, run `npx agentspend configure` and continue after completion.
+
+# Setup
 ```bash
 npx agentspend configure
 ```
 
-Opens a URL to add a credit card and set a weekly spending limit. Saves credentials to `~/.agentspend/credentials.json`.
-
-If already configured, re-running opens the dashboard to update settings.
+This opens a URL for gateway configuration (billing + connections) and stores credentials in `~/.agentspend/credentials.json`.
+It does not require adding a card to start using services.
 
-## Commands
-
-### Pay
+# Commands
 
+## Use
 ```bash
-npx agentspend pay <url>
+npx agentspend use <url>
 ```
 
-Make a paid request. AgentSpend handles the payment automatically.
-
-**Options:**
-- `--method <method>` — HTTP method (default: `GET`)
-- `--body <body>` — Request body (JSON or text)
-- `--header <header>` — Header in `key:value` format (repeatable)
-- `--max-cost <usd>` — Maximum acceptable charge in USD (up to 6 decimal places)
+`<url>` must be a direct HTTPS URL.
 
-**Returns:**
-- Response body from the endpoint
-- Charge amount and remaining weekly budget
-
-**Example:**
+Options:
+- `--method <method>` HTTP method
+- `--header <key:value>` repeatable header
+- `--body <json-or-text>` request body
 
+Examples:
 ```bash
-npx agentspend pay <url> \
-  --method POST \
-  --header "key:value" \
-  --body '{"key": "value"}' \
-  --max-cost 0.05
-```
-
-### Check
-
-```bash
-npx agentspend check <url>
-```
-
-Discover an endpoint's price without paying.
-
-Important:
-- `check` must use the same request shape you plan to `pay` with.
-- Always pass `--method` for non-GET endpoints.
-- If the endpoint needs headers/body, include the same `--header` and `--body` on `check`.
-- If request shape is wrong, endpoint may return `404`/`400` instead of `402`, and no price can be extracted.
-
-**Example:**
-
-```bash
-npx agentspend check <url> \
+npx agentspend use https://stableenrich.dev/api/exa/search \
   --method POST \
   --header "content-type:application/json" \
-  --body '{"key":"value"}'
+  --body '{"query":"latest robotics news","numResults":5}'
 ```
 
-**Returns:**
-- Price in USD
-- Description (if available)
-
-### Search
-
+## Search
 ```bash
 npx agentspend search <keywords>
 ```
 
-Keyword search over service names and descriptions in the catalog. Returns up to 5 matching services.
-
-**Example:**
-
-```bash
-npx agentspend search "video generation"
-```
-
-### Status
+Returns up to 5 matching services with domain and skill link.
 
+## Status
 ```bash
 npx agentspend status
 ```
 
-Show account spending overview.
-
-**Returns:**
-- Weekly budget
-- Amount spent this week
-- Remaining budget
-- Recent charges with amounts, domains, and timestamps
-
-### Configure
+Shows weekly budget, spend, remaining budget, and recent charges.
 
+## Configure
 ```bash
 npx agentspend configure
 ```
 
-Run onboarding or open the dashboard to update settings (weekly budget, domain allowlist, payment method).
-
-## Spending Controls
-
-- **Weekly budget** — Set during configure. Requests that would exceed the budget are rejected.
-- **Per-request max cost** — Use `--max-cost` on `pay` to reject requests above a price threshold.
-- **Domain allowlist** — Configurable via the dashboard. Requests to non-allowlisted domains are rejected.
+Opens configuration for billing, budget, and connected auth providers.
+Billing can be added later; usage accrues until the no-card allowance threshold is reached.
 
-## Common Errors
+# Spending Controls
+- Weekly budget enforced server-side.
+- Up to `$5.00` of no-card accrued usage is allowed before billing setup is required.
+- Target domain must match an active service domain in AgentSpend.
 
-- **`WEEKLY_BUDGET_EXCEEDED`** — Weekly spending limit reached. Run `npx agentspend configure` to increase the budget.
-- **`DOMAIN_NOT_ALLOWLISTED`** — The target domain is not in the allowlist. Run `npx agentspend configure` to update allowed domains.
-- **`PRICE_EXCEEDS_MAX`** — Endpoint price is higher than `--max-cost`. Increase the value or remove the flag.
+# Common Errors
+- `WEEKLY_BUDGET_EXCEEDED` — weekly limit reached.
+- `PAYMENT_METHOD_REQUIRED` — no-card usage threshold or billing hold reached; run configure and add/update payment method.
+- `SERVICE_DOMAIN_NOT_REGISTERED` — target domain is not registered as an active service domain.
+- `SERVICE_AUTH_REQUIRED` — required OAuth connection missing; run configure and connect provider.

package/dist/cli.js

@@ -1,50 +1,29 @@
 import { Command } from "commander";
-import { runCheck } from "./commands/check.js";
+import { createRequire } from "node:module";
 import { runConfigure } from "./commands/configure.js";
-import { runPay } from "./commands/pay.js";
+import { runUse } from "./commands/use.js";
 import { runSearch } from "./commands/search.js";
 import { runStatus } from "./commands/status.js";
 import { AgentspendApiClient } from "./lib/api.js";
-function parsePositiveUsd(value) {
-    const parsed = Number(value);
-    if (!Number.isFinite(parsed) || parsed <= 0) {
-        throw new Error(`Expected a positive USD value, received: ${value}`);
-    }
-    const rounded = Math.round(parsed * 1_000_000) / 1_000_000;
-    if (Math.abs(parsed - rounded) > 1e-9) {
-        throw new Error(`Expected at most 6 decimal places, received: ${value}`);
-    }
-    return parsed;
-}
+const require = createRequire(import.meta.url);
+const packageJson = require("../package.json");
+const CLI_VERSION = typeof packageJson.version === "string" ? packageJson.version : "0.0.0";
 export async function runCli(options) {
     const program = new Command();
     const apiClient = new AgentspendApiClient(options?.baseUrl);
     const programName = options?.programName ?? "agentspend";
-    program.name(programName).description("AgentSpend CLI").version("0.2.0");
-    program
-        .command("pay")
-        .argument("<url>", "URL to call")
-        .description("Make a paid request")
-        .option("-X, --method <method>", "HTTP method for target request", "GET")
-        .option("--body <body>", "Request body (JSON or text)")
-        .option("--header <header>", "Header in key:value form", (value, previous) => {
-        return [...previous, value];
-    }, [])
-        .option("--max-cost <usd>", "Maximum acceptable charge in USD (up to 6 decimals)", parsePositiveUsd)
-        .action(async (url, commandOptions) => {
-        await runPay(apiClient, url, commandOptions);
-    });
+    program.name(programName).description("AgentSpend CLI").version(CLI_VERSION);
     program
-        .command("check")
-        .argument("<url>", "URL to check")
-        .description("Discover endpoint price without paying")
-        .option("-X, --method <method>", "HTTP method for target request", "GET")
+        .command("use")
+        .argument("<url>", "Direct HTTPS URL")
+        .description("Call a URL through AgentSpend")
+        .option("-X, --method <method>", "HTTP method")
         .option("--body <body>", "Request body (JSON or text)")
         .option("--header <header>", "Header in key:value form", (value, previous) => {
         return [...previous, value];
     }, [])
         .action(async (url, commandOptions) => {
-        await runCheck(apiClient, url, commandOptions);
+        await runUse(apiClient, url, commandOptions);
     });
     program
         .command("search")

package/dist/commands/configure.js

@@ -1,44 +1,5 @@
-import { ApiError } from "../lib/api.js";
-import { clearPendingConfigureToken, readCredentials, savePendingConfigureToken, } from "../lib/credentials.js";
-import { claimConfigureToken, getPendingConfigureStatus } from "../lib/auth-flow.js";
-async function tryAuthenticatedConfigure(apiClient, apiKey) {
-    try {
-        return await apiClient.configure(undefined, apiKey);
-    }
-    catch (error) {
-        if (error instanceof ApiError && error.status === 401) {
-            return null;
-        }
-        throw error;
-    }
-}
+import { resolveConfigureStatus } from "../lib/configure-flow.js";
 export async function runConfigure(apiClient) {
-    const credentials = await readCredentials();
-    if (credentials) {
-        const authenticatedResponse = await tryAuthenticatedConfigure(apiClient, credentials.api_key);
-        if (authenticatedResponse) {
-            console.log(`Open this URL to configure settings:\n${authenticatedResponse.configure_url}`);
-            return;
-        }
-    }
-    const pending = await getPendingConfigureStatus(apiClient);
-    if (pending) {
-        if (pending.status.claim_status === "awaiting_card") {
-            console.log(`Open this URL to configure settings:\n${pending.status.configure_url}`);
-            return;
-        }
-        if (pending.status.claim_status === "ready_to_claim") {
-            const apiKey = await claimConfigureToken(apiClient, pending.token);
-            const claimedResponse = await tryAuthenticatedConfigure(apiClient, apiKey);
-            if (claimedResponse) {
-                console.log(`Open this URL to configure settings:\n${claimedResponse.configure_url}`);
-                return;
-            }
-            throw new Error("API key was claimed, but configure session could not be created. Run agentspend configure again.");
-        }
-        await clearPendingConfigureToken();
-    }
-    const created = await apiClient.configure();
-    await savePendingConfigureToken(created.token);
-    console.log(`Open this URL to configure settings:\n${created.configure_url}`);
+    const result = await resolveConfigureStatus(apiClient);
+    console.log(`Open this URL to configure settings:\n${result.status.configure_url}`);
 }

package/dist/commands/pay.js

@@ -1,6 +1,6 @@
 import { ApiError } from "../lib/api.js";
 import { resolveApiKeyWithAutoClaim } from "../lib/auth-flow.js";
-import { formatJson, formatUsd, formatUsdEstimate, usd6ToUsd } from "../lib/output.js";
+import { formatJson, formatUsd, usd6ToUsd } from "../lib/output.js";
 import { normalizeMethod, parseBody, parseHeaders } from "../lib/request-options.js";
 function isRecord(value) {
     return typeof value === "object" && value !== null;
@@ -17,8 +17,7 @@ function parsePayErrorCode(value) {
     if (typeof value !== "string") {
         return undefined;
     }
-    if (value === "PRICE_EXCEEDS_MAX" ||
-        value === "PRICE_NOT_CONVERTIBLE" ||
+    if (value === "PRICE_NOT_CONVERTIBLE" ||
         value === "WEEKLY_BUDGET_EXCEEDED" ||
         value === "DOMAIN_NOT_ALLOWLISTED") {
         return value;
@@ -37,10 +36,6 @@ function parsePayErrorBody(body) {
     }
     const detailsRecord = body.details;
     parsed.details = {
-        offered_price_usd6: readNumber(detailsRecord, "offered_price_usd6"),
-        offered_price_usd: readNumber(detailsRecord, "offered_price_usd"),
-        max_cost_usd6: readNumber(detailsRecord, "max_cost_usd6"),
-        max_cost_usd: readNumber(detailsRecord, "max_cost_usd"),
         weekly_limit_usd6: readNumber(detailsRecord, "weekly_limit_usd6"),
         weekly_limit_usd: readNumber(detailsRecord, "weekly_limit_usd"),
         spent_this_week_usd6: readNumber(detailsRecord, "spent_this_week_usd6"),
@@ -62,7 +57,6 @@ export async function runPay(apiClient, url, options) {
             method,
             headers: parseHeaders(options.header),
             body: parseBody(options.body),
-            max_cost_usd: options.maxCost,
         });
         console.log(formatJson(response.body));
         if (response.payment) {
@@ -72,20 +66,6 @@ export async function runPay(apiClient, url, options) {
     catch (error) {
         if (error instanceof ApiError) {
             const body = parsePayErrorBody(error.body);
-            if (error.status === 400 && body.code === "PRICE_EXCEEDS_MAX") {
-                const offered = body.details?.offered_price_usd ??
-                    (typeof body.details?.offered_price_usd6 === "number" ? usd6ToUsd(body.details.offered_price_usd6) : 0);
-                const max = body.details?.max_cost_usd ??
-                    (typeof body.details?.max_cost_usd6 === "number" ? usd6ToUsd(body.details.max_cost_usd6) : 0);
-                const estimatedUsd = body.details?.estimated_usd;
-                const amountDisplay = body.details?.amount_display;
-                const currency = body.details?.currency ?? "USDC";
-                console.error(`Price ${formatUsd(offered)} exceeds --max-cost ${formatUsd(max)}. Run without --max-cost or increase it.`);
-                if (amountDisplay) {
-                    console.error(`Offered token amount: ${amountDisplay} ${currency} (~${formatUsdEstimate(estimatedUsd, offered)})`);
-                }
-                return;
-            }
             if (error.status === 400 && body.code === "PRICE_NOT_CONVERTIBLE") {
                 console.error("Price could not be converted to 6-decimal USD units for policy checks.");
                 return;

package/dist/commands/search.js

@@ -7,7 +7,7 @@ export async function runSearch(apiClient, query) {
         return;
     }
     for (const service of response.services) {
-        console.log(service.name);
+        console.log(`${service.name} (${service.slug})`);
         console.log(`Description: ${service.description}`);
         console.log(`Domain: ${service.domain}`);
         console.log(`Skill URL: ${service.skill_url ?? "n/a"}`);

package/dist/commands/use.js

@@ -0,0 +1,117 @@
+import { ApiError } from "../lib/api.js";
+import { resolveApiKeyWithAutoClaim } from "../lib/auth-flow.js";
+import { formatJson, formatUsd, usd6ToUsd } from "../lib/output.js";
+import { normalizeMethod, parseBody, parseHeaders } from "../lib/request-options.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function readNumber(record, key) {
+    const value = record[key];
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function readString(record, key) {
+    const value = record[key];
+    return typeof value === "string" ? value : undefined;
+}
+function parseUseErrorCode(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    if (value === "PRICE_NOT_CONVERTIBLE" ||
+        value === "WEEKLY_BUDGET_EXCEEDED" ||
+        value === "SERVICE_DOMAIN_NOT_REGISTERED" ||
+        value === "SERVICE_AUTH_REQUIRED" ||
+        value === "PAYMENT_METHOD_REQUIRED") {
+        return value;
+    }
+    return undefined;
+}
+function parseUseErrorBody(body) {
+    if (!isRecord(body)) {
+        return {};
+    }
+    const parsed = {
+        code: parseUseErrorCode(body.code),
+        message: readString(body, "message"),
+        configure_url: readString(body, "configure_url"),
+    };
+    if (!isRecord(body.details)) {
+        return parsed;
+    }
+    const detailsRecord = body.details;
+    parsed.details = {
+        weekly_limit_usd6: readNumber(detailsRecord, "weekly_limit_usd6"),
+        weekly_limit_usd: readNumber(detailsRecord, "weekly_limit_usd"),
+        spent_this_week_usd6: readNumber(detailsRecord, "spent_this_week_usd6"),
+        spent_this_week_usd: readNumber(detailsRecord, "spent_this_week_usd"),
+        attempted_charge_usd6: readNumber(detailsRecord, "attempted_charge_usd6"),
+        attempted_charge_usd: readNumber(detailsRecord, "attempted_charge_usd"),
+        estimated_usd: readNumber(detailsRecord, "estimated_usd"),
+        amount_display: readString(detailsRecord, "amount_display"),
+        currency: readString(detailsRecord, "currency"),
+        configure_url: readString(detailsRecord, "configure_url"),
+    };
+    return parsed;
+}
+function printCloudHttpResult(result) {
+    console.log(formatJson(result.body));
+    if (result.payment) {
+        console.log(`\nCharged: ${formatUsd(result.payment.charged_usd)} | Remaining: ${formatUsd(result.payment.remaining_budget_usd)}`);
+    }
+}
+export async function runUse(apiClient, url, options) {
+    const apiKey = await resolveApiKeyWithAutoClaim(apiClient);
+    try {
+        const response = await apiClient.use(apiKey, {
+            url,
+            method: options.method ? normalizeMethod(options.method) : undefined,
+            headers: parseHeaders(options.header),
+            body: parseBody(options.body),
+        });
+        if (response.mode === "cloud_http_result") {
+            printCloudHttpResult(response);
+            return;
+        }
+        if (response.mode === "action_required") {
+            const configureUrl = response.configure_url ? `\n${response.configure_url}` : "";
+            throw new Error(`${response.message}${configureUrl}`);
+        }
+        console.log(formatJson(response));
+    }
+    catch (error) {
+        if (error instanceof ApiError) {
+            const body = parseUseErrorBody(error.body);
+            if (error.status === 400 && body.code === "PRICE_NOT_CONVERTIBLE") {
+                console.error("Price could not be converted to 6-decimal USD units for policy checks.");
+                return;
+            }
+            if (error.status === 402 && body.code === "WEEKLY_BUDGET_EXCEEDED") {
+                const weeklyLimit = body.details?.weekly_limit_usd ??
+                    (typeof body.details?.weekly_limit_usd6 === "number" ? usd6ToUsd(body.details.weekly_limit_usd6) : 0);
+                const spent = body.details?.spent_this_week_usd ??
+                    (typeof body.details?.spent_this_week_usd6 === "number" ? usd6ToUsd(body.details.spent_this_week_usd6) : 0);
+                const attempted = body.details?.attempted_charge_usd ??
+                    (typeof body.details?.attempted_charge_usd6 === "number" ? usd6ToUsd(body.details.attempted_charge_usd6) : 0);
+                console.error(`Weekly budget exceeded. Limit ${formatUsd(weeklyLimit)}, spent ${formatUsd(spent)}, attempted ${formatUsd(attempted)}.`);
+                return;
+            }
+            if (error.status === 403 && body.code === "SERVICE_DOMAIN_NOT_REGISTERED") {
+                console.error("This domain is not registered as an active AgentSpend service domain.");
+                return;
+            }
+            if (error.status === 403 && body.code === "SERVICE_AUTH_REQUIRED") {
+                const configureUrl = body.configure_url ?? body.details?.configure_url;
+                console.error(body.message ??
+                    `Service authentication required. Complete connection setup in configure.${configureUrl ? `\n${configureUrl}` : ""}`);
+                return;
+            }
+            if (error.status === 403 && body.code === "PAYMENT_METHOD_REQUIRED") {
+                const configureUrl = body.configure_url ?? body.details?.configure_url;
+                console.error(body.message
+                    ?? `Payment method required. Add or update billing details in configure.${configureUrl ? `\n${configureUrl}` : ""}`);
+                return;
+            }
+        }
+        throw error;
+    }
+}

package/dist/lib/api.js

@@ -55,14 +55,8 @@ export class AgentspendApiClient {
         }
         return body;
     }
-    pay(apiKey, payload) {
-        return this.request("/pay", {
-            method: "POST",
-            body: JSON.stringify(payload),
-        }, apiKey);
-    }
-    check(apiKey, payload) {
-        return this.request("/check", {
+    use(apiKey, payload) {
+        return this.request("/use", {
             method: "POST",
             body: JSON.stringify(payload),
         }, apiKey);

package/dist/lib/auth-flow.js

@@ -48,9 +48,6 @@ export async function resolveApiKeyWithAutoClaim(apiClient) {
     if (pending.status.claim_status === "ready_to_claim") {
         return claimConfigureToken(apiClient, pending.token);
     }
-    if (pending.status.claim_status === "awaiting_card") {
-        throw new Error(`Card setup required. Open this URL:\n${pending.status.configure_url}`);
-    }
     await clearPendingConfigureToken();
-    throw new Error("Configure session already claimed. Run `agentspend configure` again.");
+    throw new Error("Configure session is no longer claimable. Run `agentspend configure` again.");
 }