agentspend 0.2.1 → 0.3.2

package/dist/openclaw-plugin/tools/pay.js

@@ -0,0 +1,60 @@
+import { normalizeMethod } from "../../lib/request-options.js";
+import { optionalStringRecord, requiredString, resolveApiKeyForTool, toJsonValue, toolSuccess, withToolErrorHandling, } from "../shared.js";
+const MAX_BODY_CHARS = 6000;
+const BODY_PREVIEW_CHARS = 1200;
+function compactResponseBody(body) {
+    const jsonBody = toJsonValue(body);
+    const serialized = JSON.stringify(jsonBody);
+    if (!serialized || serialized.length <= MAX_BODY_CHARS) {
+        return { body: jsonBody, body_omitted: false };
+    }
+    return {
+        body: {
+            note: "Response body omitted because it is large (common for base64 media payloads).",
+            size_chars: serialized.length,
+            preview: serialized.slice(0, BODY_PREVIEW_CHARS),
+        },
+        body_omitted: true,
+    };
+}
+export function createPayTool(apiClient) {
+    return {
+        name: "agentspend_pay",
+        description: "Execute a paid API request through AgentSpend.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                url: { type: "string", format: "uri" },
+                method: { type: "string", minLength: 1 },
+                headers: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                },
+                body: {},
+            },
+            required: ["url", "method"],
+        },
+        execute: async (_toolCallId, args) => withToolErrorHandling(async () => {
+            const url = requiredString(args.url, "url");
+            const method = normalizeMethod(requiredString(args.method, "method"));
+            const headers = optionalStringRecord(args.headers, "headers");
+            const body = args.body;
+            const apiKey = await resolveApiKeyForTool(apiClient);
+            const response = await apiClient.pay(apiKey, {
+                url,
+                method,
+                headers,
+                body,
+            });
+            const compactBody = compactResponseBody(response.body);
+            return toolSuccess({
+                status: response.status,
+                body: compactBody.body,
+                body_omitted: compactBody.body_omitted,
+                charged_usd: response.payment?.charged_usd ?? null,
+                remaining_budget_usd: response.payment?.remaining_budget_usd ?? null,
+            });
+        }),
+    };
+}

package/dist/openclaw-plugin/tools/search.js

@@ -0,0 +1,24 @@
+import { requiredString, resolveApiKeyForTool, toolSuccess, withToolErrorHandling, } from "../shared.js";
+export function createSearchTool(apiClient) {
+    return {
+        name: "agentspend_search",
+        description: "Search AgentSpend services catalog by keyword.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                query: { type: "string", minLength: 1 },
+            },
+            required: ["query"],
+        },
+        execute: async (_toolCallId, args) => withToolErrorHandling(async () => {
+            const query = requiredString(args.query, "query");
+            const apiKey = await resolveApiKeyForTool(apiClient);
+            const response = await apiClient.search(apiKey, query);
+            return toolSuccess({
+                query: response.query,
+                services: response.services,
+            });
+        }),
+    };
+}

package/dist/openclaw-plugin/tools/status.js

@@ -0,0 +1,22 @@
+import { resolveApiKeyForTool, toJsonValue, toolSuccess, withToolErrorHandling, } from "../shared.js";
+export function createStatusTool(apiClient) {
+    return {
+        name: "agentspend_status",
+        description: "Get weekly budget, current spend, remaining budget, and recent charges.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {},
+        },
+        execute: async () => withToolErrorHandling(async () => {
+            const apiKey = await resolveApiKeyForTool(apiClient);
+            const response = await apiClient.status(apiKey);
+            return toolSuccess({
+                weekly_budget_usd: response.weekly_budget_usd,
+                spent_this_week_usd: response.spent_this_week_usd,
+                remaining_budget_usd: response.remaining_budget_usd,
+                recent_charges: toJsonValue(response.recent_charges),
+            });
+        }),
+    };
+}

package/dist/openclaw-plugin/tools/use.js

@@ -0,0 +1,80 @@
+import { ApiError } from "../../lib/api.js";
+import { formatUseCloudResult } from "../../lib/use-cloud-result.js";
+import { normalizeMethod } from "../../lib/request-options.js";
+import { optionalStringRecord, requiredString, resolveApiKeyForTool, toolSuccess, withToolErrorHandling, } from "../shared.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function asPaymentMethodRequiredResult(error) {
+    if (error.status !== 403 || !isRecord(error.body)) {
+        return null;
+    }
+    if (error.body.code !== "PAYMENT_METHOD_REQUIRED") {
+        return null;
+    }
+    return {
+        mode: "action_required",
+        code: "PAYMENT_METHOD_REQUIRED",
+        message: typeof error.body.message === "string"
+            ? error.body.message
+            : "Payment method required. Run agentspend_configure and complete billing setup.",
+        configure_url: typeof error.body.configure_url === "string" ? error.body.configure_url : null,
+        details: isRecord(error.body.details) ? error.body.details : null,
+    };
+}
+export function createUseTool(apiClient) {
+    return {
+        name: "agentspend_use",
+        description: "Call a URL through AgentSpend.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                url: { type: "string", minLength: 1 },
+                method: { type: "string", minLength: 1 },
+                headers: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                },
+                body: {},
+            },
+            required: ["url"],
+        },
+        execute: async (_toolCallId, args) => withToolErrorHandling(async () => {
+            const url = requiredString(args.url, "url");
+            const methodRaw = args.method;
+            const method = methodRaw === undefined ? undefined : normalizeMethod(requiredString(methodRaw, "method"));
+            const headers = optionalStringRecord(args.headers, "headers");
+            const body = args.body;
+            const apiKey = await resolveApiKeyForTool(apiClient);
+            let response;
+            try {
+                response = await apiClient.use(apiKey, {
+                    url,
+                    method,
+                    headers,
+                    body,
+                });
+            }
+            catch (error) {
+                if (error instanceof ApiError) {
+                    const paymentRequiredResult = asPaymentMethodRequiredResult(error);
+                    if (paymentRequiredResult) {
+                        return toolSuccess(paymentRequiredResult);
+                    }
+                }
+                throw error;
+            }
+            if (response.mode === "cloud_http_result") {
+                return toolSuccess(formatUseCloudResult(response));
+            }
+            return toolSuccess({
+                mode: response.mode,
+                code: response.code,
+                message: response.message,
+                configure_url: response.configure_url ?? null,
+                details: response.details ?? null,
+            });
+        }),
+    };
+}

package/openclaw.plugin.json

@@ -0,0 +1,10 @@
+{
+  "id": "agentspend",
+  "name": "AgentSpend",
+  "description": "AgentSpend paid API tools for OpenClaw agents.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -1,19 +1,26 @@
 {
   "name": "agentspend",
-  "version": "0.2.1",
-  "description": "AgentSpend CLI for managed x402 spending",
-  "files": ["dist", "SKILL.md"],
+  "version": "0.3.2",
+  "description": "AgentSpend CLI for agent access to APIs",
+  "files": ["dist", "SKILL.md", "openclaw.plugin.json"],
   "type": "module",
   "bin": {
-    "agentspend": "dist/index.js"
+    "agentspend": "dist/index.js",
+    "agentspend-mcp": "dist/mcp-server.js"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "dev": "tsx src/index.ts",
     "dev:local": "tsx src/dev-index.ts",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "dev:mcp": "tsx src/mcp-server.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "skills:validate": "node scripts/validate-skills-manifest.mjs"
+  },
+  "openclaw": {
+    "extensions": ["./dist/openclaw-plugin/index.js"]
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "bcryptjs": "^2.4.3",
     "commander": "^12.1.0"
   },

package/dist/commands/check.js

@@ -1,40 +0,0 @@
-import { ApiError } from "../lib/api.js";
-import { resolveApiKeyWithAutoClaim } from "../lib/auth-flow.js";
-import { formatUsd, usd6ToUsd } from "../lib/output.js";
-import { normalizeMethod, parseBody, parseHeaders } from "../lib/request-options.js";
-export async function runCheck(apiClient, url, options) {
-    const apiKey = await resolveApiKeyWithAutoClaim(apiClient);
-    try {
-        const response = await apiClient.check(apiKey, {
-            url,
-            method: normalizeMethod(options.method),
-            headers: parseHeaders(options.header),
-            body: parseBody(options.body),
-        });
-        if (response.free) {
-            if ((response.status ?? 200) >= 400) {
-                console.log(`No payment required, but endpoint returned status ${response.status}.`);
-                return;
-            }
-            console.log("This endpoint is free.");
-            return;
-        }
-        const policyUsd = response.price_usd ?? (typeof response.price_usd6 === "number" ? usd6ToUsd(response.price_usd6) : null);
-        const price = policyUsd !== null ? formatUsd(policyUsd) : "unavailable";
-        const description = response.description ?? "unavailable";
-        console.log(`Price: ${price}`);
-        console.log(`Description: ${description}`);
-        return;
-    }
-    catch (error) {
-        if (error instanceof ApiError) {
-            const body = error.body;
-            if (error.status === 502 && body?.code === "UNSUPPORTED_PAYMENT_REQUIRED_FORMAT") {
-                const headers = (body.details?.header_names ?? []).join(", ");
-                console.error(`Endpoint returned 402 with an unsupported payment format. Headers seen: ${headers || "none"}.`);
-                return;
-            }
-        }
-        throw error;
-    }
-}

package/dist/commands/setup.js

@@ -1,36 +0,0 @@
-import bcrypt from "bcryptjs";
-import crypto from "node:crypto";
-import { saveCredentials } from "../lib/credentials.js";
-const POLL_INTERVAL_MS = 2_000;
-const SETUP_TIMEOUT_MS = 10 * 60 * 1000;
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function generateApiKey() {
-    return `sk_agent_${crypto.randomBytes(32).toString("hex")}`;
-}
-export async function runSetup(apiClient) {
-    const setup = await apiClient.createSetup();
-    console.log(`Open this URL to complete setup:\n${setup.setup_url}\n`);
-    console.log("Waiting for setup to complete...");
-    const started = Date.now();
-    while (Date.now() - started < SETUP_TIMEOUT_MS) {
-        const status = await apiClient.getSetupStatus(setup.setup_id);
-        if (status.status === "ready") {
-            const apiKey = generateApiKey();
-            const apiKeyHash = await bcrypt.hash(apiKey, 12);
-            await apiClient.claimSetup(setup.setup_id, apiKeyHash);
-            await saveCredentials(apiKey);
-            console.log("Ready! Your agent can now spend.");
-            return;
-        }
-        if (status.status === "claimed") {
-            throw new Error("This setup session was already claimed. Run agentspend setup again.");
-        }
-        if (status.status === "expired") {
-            throw new Error("Setup timed out. Run agentspend setup again.");
-        }
-        await sleep(POLL_INTERVAL_MS);
-    }
-    throw new Error("Setup timed out. Run agentspend setup again.");
-}