@agenttool/sdk 0.2.2 → 0.2.3

package/dist/economy.d.ts

@@ -1,27 +1,108 @@
 /**
- * Economy client for the wallet/economy API.
+ * Economy client for the wallet/escrow API.
  */
-import type { CreateWalletOptions, Wallet } from "./types.js";
+import type { CreateEscrowOptions, CreateWalletOptions, Escrow, Wallet, WalletPolicy } from "./types.js";
 import type { HttpConfig } from "./memory.js";
 /**
- * Client for the economy/wallet API.
+ * Client for the agent-economy API — wallets and escrows.
  *
  * @example
  * ```ts
  * const at = new AgentTool();
- * const wallet = await at.economy.createWallet({ name: "my-wallet" });
- * console.log(wallet.id, wallet.balance);
+ *
+ * // Create and fund a wallet
+ * const wallet = await at.economy.createWallet({ name: "agent-wallet", agentId: "agent-1" });
+ * await at.economy.fundWallet(wallet.id, { amount: 500, description: "Weekly budget" });
+ *
+ * // Create an escrow for agent-to-agent payment
+ * const escrow = await at.economy.createEscrow({
+ *   creatorWalletId: wallet.id,
+ *   amount: 100,
+ *   description: "Summarise 50 research papers",
+ * });
+ * await at.economy.releaseEscrow(escrow.id);
  * ```
  */
 export declare class EconomyClient {
     private readonly http;
     /** @internal */
     constructor(http: HttpConfig);
+    private url;
+    private req;
     /**
      * Create a new wallet.
-     *
-     * @param options - Wallet creation options (name required).
-     * @returns The created Wallet object.
      */
     createWallet(options: CreateWalletOptions): Promise<Wallet>;
+    /**
+     * List all wallets for this project.
+     */
+    listWallets(): Promise<Wallet[]>;
+    /**
+     * Get a wallet by ID.
+     */
+    getWallet(walletId: string): Promise<Wallet>;
+    /**
+     * Fund a wallet with credits.
+     */
+    fundWallet(walletId: string, options: {
+        amount: number;
+        description?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Spend credits from a wallet (subject to spending policy).
+     */
+    spend(walletId: string, options: {
+        amount: number;
+        counterparty: string;
+        description: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Set or update a wallet's spending policy.
+     */
+    setPolicy(walletId: string, policy: WalletPolicy): Promise<Record<string, unknown>>;
+    /**
+     * Freeze a wallet — halts all spending immediately.
+     */
+    freezeWallet(walletId: string): Promise<Wallet>;
+    /**
+     * Unfreeze a wallet to resume normal operation.
+     */
+    unfreezeWallet(walletId: string): Promise<Wallet>;
+    /**
+     * Get paginated transaction history for a wallet.
+     */
+    getTransactions(walletId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    /**
+     * Create an escrow — locks credits until work is released or refunded.
+     */
+    createEscrow(options: CreateEscrowOptions): Promise<Escrow>;
+    /**
+     * List escrows, optionally filtered by status.
+     */
+    listEscrows(status?: Escrow["status"]): Promise<Escrow[]>;
+    /**
+     * Get an escrow by ID.
+     */
+    getEscrow(escrowId: string): Promise<Escrow>;
+    /**
+     * Accept an escrow as the worker.
+     */
+    acceptEscrow(escrowId: string, workerWalletId: string): Promise<Escrow>;
+    /**
+     * Release escrow funds to the worker.
+     */
+    releaseEscrow(escrowId: string): Promise<Escrow>;
+    /**
+     * Refund escrow credits back to the creator.
+     */
+    refundEscrow(escrowId: string): Promise<Escrow>;
+    /**
+     * Flag an escrow as disputed — credits stay locked pending resolution.
+     */
+    disputeEscrow(escrowId: string): Promise<Escrow>;
 }

package/dist/economy.js

@@ -1,15 +1,25 @@
 /**
- * Economy client for the wallet/economy API.
+ * Economy client for the wallet/escrow API.
  */
 import { AgentToolError } from "./errors.js";
 /**
- * Client for the economy/wallet API.
+ * Client for the agent-economy API — wallets and escrows.
  *
  * @example
  * ```ts
  * const at = new AgentTool();
- * const wallet = await at.economy.createWallet({ name: "my-wallet" });
- * console.log(wallet.id, wallet.balance);
+ *
+ * // Create and fund a wallet
+ * const wallet = await at.economy.createWallet({ name: "agent-wallet", agentId: "agent-1" });
+ * await at.economy.fundWallet(wallet.id, { amount: 500, description: "Weekly budget" });
+ *
+ * // Create an escrow for agent-to-agent payment
+ * const escrow = await at.economy.createEscrow({
+ *   creatorWalletId: wallet.id,
+ *   amount: 100,
+ *   description: "Summarise 50 research papers",
+ * });
+ * await at.economy.releaseEscrow(escrow.id);
  * ```
  */
 export class EconomyClient {
@@ -18,34 +28,179 @@ export class EconomyClient {
     constructor(http) {
         this.http = http;
     }
-    /**
-     * Create a new wallet.
-     *
-     * @param options - Wallet creation options (name required).
-     * @returns The created Wallet object.
-     */
-    async createWallet(options) {
-        const body = { name: options.name };
-        const url = `${this.http.baseUrl}/v1/wallets`;
+    // ── helpers ──────────────────────────────────────────────────────────────
+    url(path) {
+        return `${this.http.baseUrl}${path}`;
+    }
+    async req(method, path, body, params) {
+        let url = this.url(path);
+        if (params) {
+            const qs = new URLSearchParams(params).toString();
+            url = `${url}?${qs}`;
+        }
         const resp = await globalThis.fetch(url, {
-            method: "POST",
+            method,
             headers: this.http.headers,
-            body: JSON.stringify(body),
+            body: body !== undefined ? JSON.stringify(body) : undefined,
             signal: AbortSignal.timeout(this.http.timeout),
         });
         if (resp.status >= 400) {
             let detail;
             try {
                 const json = (await resp.json());
-                detail = json.detail ?? resp.statusText;
+                detail = json.detail ?? json.error ?? resp.statusText;
             }
             catch {
                 detail = resp.statusText;
             }
             throw new AgentToolError(`Economy API error (${resp.status}): ${detail}`, {
-                hint: "Check your API key and request parameters.",
+                hint: "Check wallet ID, balance, and spending policy.",
             });
         }
-        return (await resp.json());
+        return resp.json();
+    }
+    // ── Wallets ───────────────────────────────────────────────────────────────
+    /**
+     * Create a new wallet.
+     */
+    async createWallet(options) {
+        const body = { name: options.name };
+        if (options.agentId)
+            body.agentId = options.agentId;
+        if (options.currency)
+            body.currency = options.currency;
+        const r = await this.req("POST", "/v1/wallets", body);
+        return r.data ?? r;
+    }
+    /**
+     * List all wallets for this project.
+     */
+    async listWallets() {
+        const r = await this.req("GET", "/v1/wallets");
+        return r.data ?? r;
+    }
+    /**
+     * Get a wallet by ID.
+     */
+    async getWallet(walletId) {
+        const r = await this.req("GET", `/v1/wallets/${walletId}`);
+        return r.data ?? r;
+    }
+    /**
+     * Fund a wallet with credits.
+     */
+    async fundWallet(walletId, options) {
+        const body = {
+            amount: options.amount,
+            description: options.description ?? "Manual fund",
+        };
+        if (options.metadata)
+            body.metadata = options.metadata;
+        return this.req("POST", `/v1/wallets/${walletId}/fund`, body);
+    }
+    /**
+     * Spend credits from a wallet (subject to spending policy).
+     */
+    async spend(walletId, options) {
+        const body = {
+            amount: options.amount,
+            counterparty: options.counterparty,
+            description: options.description,
+        };
+        if (options.metadata)
+            body.metadata = options.metadata;
+        return this.req("POST", `/v1/wallets/${walletId}/spend`, body);
+    }
+    /**
+     * Set or update a wallet's spending policy.
+     */
+    async setPolicy(walletId, policy) {
+        return this.req("PUT", `/v1/wallets/${walletId}/policy`, policy);
+    }
+    /**
+     * Freeze a wallet — halts all spending immediately.
+     */
+    async freezeWallet(walletId) {
+        const r = await this.req("POST", `/v1/wallets/${walletId}/freeze`);
+        return r.data ?? r;
+    }
+    /**
+     * Unfreeze a wallet to resume normal operation.
+     */
+    async unfreezeWallet(walletId) {
+        const r = await this.req("POST", `/v1/wallets/${walletId}/unfreeze`);
+        return r.data ?? r;
+    }
+    /**
+     * Get paginated transaction history for a wallet.
+     */
+    async getTransactions(walletId, options) {
+        const params = {};
+        if (options?.limit)
+            params.limit = String(options.limit);
+        if (options?.offset)
+            params.offset = String(options.offset);
+        const r = await this.req("GET", `/v1/wallets/${walletId}/transactions`, undefined, Object.keys(params).length ? params : undefined);
+        return r.data ?? r;
+    }
+    // ── Escrows ───────────────────────────────────────────────────────────────
+    /**
+     * Create an escrow — locks credits until work is released or refunded.
+     */
+    async createEscrow(options) {
+        const body = {
+            creatorWalletId: options.creatorWalletId,
+            amount: options.amount,
+            description: options.description,
+        };
+        if (options.workerWalletId)
+            body.workerWalletId = options.workerWalletId;
+        if (options.deadline)
+            body.deadline = options.deadline;
+        const r = await this.req("POST", "/v1/escrows", body);
+        return r.data ?? r;
+    }
+    /**
+     * List escrows, optionally filtered by status.
+     */
+    async listEscrows(status) {
+        const params = status ? { status } : undefined;
+        const r = await this.req("GET", "/v1/escrows", undefined, params);
+        return r.data ?? r;
+    }
+    /**
+     * Get an escrow by ID.
+     */
+    async getEscrow(escrowId) {
+        const r = await this.req("GET", `/v1/escrows/${escrowId}`);
+        return r.data ?? r;
+    }
+    /**
+     * Accept an escrow as the worker.
+     */
+    async acceptEscrow(escrowId, workerWalletId) {
+        const r = await this.req("POST", `/v1/escrows/${escrowId}/accept`, { workerWalletId });
+        return r.data ?? r;
+    }
+    /**
+     * Release escrow funds to the worker.
+     */
+    async releaseEscrow(escrowId) {
+        const r = await this.req("POST", `/v1/escrows/${escrowId}/release`);
+        return r.data ?? r;
+    }
+    /**
+     * Refund escrow credits back to the creator.
+     */
+    async refundEscrow(escrowId) {
+        const r = await this.req("POST", `/v1/escrows/${escrowId}/refund`);
+        return r.data ?? r;
+    }
+    /**
+     * Flag an escrow as disputed — credits stay locked pending resolution.
+     */
+    async disputeEscrow(escrowId) {
+        const r = await this.req("POST", `/v1/escrows/${escrowId}/dispute`);
+        return r.data ?? r;
     }
 }

package/dist/index.d.ts

@@ -12,4 +12,4 @@
 export { AgentTool } from "./client.js";
 export { AgentToolError } from "./errors.js";
 export type { Trace, StoreTraceOptions, SearchTracesOptions, TraceSearchResult, TraceChain } from "./traces.js";
-export type { CreateWalletOptions, ExecuteResult, Memory, ScrapeResult, SearchMemoryOptions, SearchResponse, SearchResult, StoreOptions, UsageStats, VerifyResult, Wallet, } from "./types.js";
+export type { CreateEscrowOptions, CreateWalletOptions, Escrow, ExecuteResult, Memory, ScrapeResult, SearchMemoryOptions, SearchResponse, SearchResult, StoreOptions, UsageStats, VerifyResult, Wallet, WalletPolicy, } from "./types.js";

package/dist/types.d.ts

@@ -76,9 +76,41 @@ export interface Wallet {
     id: string;
     name: string;
     balance: number;
-    api_key: string;
+    currency: string;
+    frozen: boolean;
+    agentId?: string;
+    createdAt?: string;
 }
 /** Options for creating a wallet. */
 export interface CreateWalletOptions {
     name: string;
+    agentId?: string;
+    currency?: string;
+}
+/** A wallet spending policy. */
+export interface WalletPolicy {
+    maxPerTransaction?: number | null;
+    maxPerHour?: number | null;
+    maxPerDay?: number | null;
+    allowedRecipients?: string[] | null;
+    requiresApprovalAbove?: number | null;
+}
+/** An escrow object. */
+export interface Escrow {
+    id: string;
+    status: "pending" | "active" | "released" | "refunded" | "disputed";
+    amount: number;
+    description: string;
+    creatorWalletId: string;
+    workerWalletId?: string | null;
+    deadline?: string | null;
+    createdAt?: string;
+}
+/** Options for creating an escrow. */
+export interface CreateEscrowOptions {
+    creatorWalletId: string;
+    amount: number;
+    description: string;
+    workerWalletId?: string;
+    deadline?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenttool/sdk",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "TypeScript SDK for agenttool.dev — memory and tools for AI agents",
   "type": "module",
   "main": "dist/index.js",