@openagentmarket/nodejs 1.1.2 → 1.2.0

package/dist/client.d.ts

@@ -0,0 +1,77 @@
+export interface OpenAgentClientConfig {
+    mnemonic?: string;
+    privateKey?: string;
+    env?: "production" | "dev" | "local";
+}
+export interface TaskResult {
+    /** True if the agent returned a result */
+    success: boolean;
+    /** The result data from the agent (JSON-RPC response) */
+    result?: any;
+    /** If the agent demanded payment */
+    paymentRequired?: {
+        amount: number;
+        currency: string;
+        recipient: string;
+        chainId: number;
+    };
+    /** Raw response text */
+    raw?: string;
+    /** Error message if something went wrong */
+    error?: string;
+}
+export interface SendTaskOptions {
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Payment proof transaction hash (if prepaying) */
+    txHash?: string;
+}
+/**
+ * OpenAgentClient — buyer-side SDK for hiring agents via XMTP.
+ *
+ * No registration or agent card needed. Just create a client and start
+ * sending tasks to agents by their wallet address.
+ *
+ * ```typescript
+ * const client = await OpenAgentClient.create({ mnemonic: process.env.MNEMONIC, env: "production" });
+ * const result = await client.sendTask("0xAgentAddress", "buy_key", { name: "My Key" });
+ * ```
+ */
+export declare class OpenAgentClient {
+    private client;
+    private wallet;
+    private constructor();
+    /**
+     * Create a new OpenAgentClient.
+     * Handles wallet creation and XMTP connection.
+     */
+    static create(config: OpenAgentClientConfig): Promise<OpenAgentClient>;
+    /**
+     * Get the client's wallet address.
+     */
+    getAddress(): string;
+    /**
+     * Send a named task to an agent and wait for the response.
+     *
+     * @param agentAddress - The target agent's wallet address
+     * @param method - The task name (e.g. "buy_key", "say_hello")
+     * @param params - Task input parameters
+     * @param opts - Optional: timeout, payment txHash
+     * @returns TaskResult with the response or payment demand
+     */
+    sendTask(agentAddress: string, method: string, params?: Record<string, any>, opts?: SendTaskOptions): Promise<TaskResult>;
+    /**
+     * Send a plain text message to an agent and wait for the reply.
+     *
+     * @param agentAddress - The target agent's wallet address
+     * @param text - The message text
+     * @param timeout - Timeout in ms (default: 30000)
+     * @returns TaskResult with the reply
+     */
+    chat(agentAddress: string, text: string, timeout?: number): Promise<TaskResult>;
+    /**
+     * Wait for a response message from the agent on a conversation.
+     */
+    private waitForResponse;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACvB,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,oCAAoC;IACpC,eAAe,CAAC,EAAE;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC5B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAwB;IAEtC,OAAO;IAKP;;;OAGG;WACiB,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAiCnF;;OAEG;IACI,UAAU,IAAI,MAAM;IAI3B;;;;;;;;OAQG;IACU,QAAQ,CACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAChC,IAAI,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,UAAU,CAAC;IA4BtB;;;;;;;OAOG;IACU,IAAI,CACb,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAc,GACxB,OAAO,CAAC,UAAU,CAAC;IAWtB;;OAEG;YACW,eAAe;CA+EhC"}

package/dist/client.js

@@ -0,0 +1,181 @@
+import { Client } from '@xmtp/node-sdk';
+import { Wallet, getBytes } from 'ethers';
+/**
+ * OpenAgentClient — buyer-side SDK for hiring agents via XMTP.
+ *
+ * No registration or agent card needed. Just create a client and start
+ * sending tasks to agents by their wallet address.
+ *
+ * ```typescript
+ * const client = await OpenAgentClient.create({ mnemonic: process.env.MNEMONIC, env: "production" });
+ * const result = await client.sendTask("0xAgentAddress", "buy_key", { name: "My Key" });
+ * ```
+ */
+export class OpenAgentClient {
+    client;
+    wallet;
+    constructor(client, wallet) {
+        this.client = client;
+        this.wallet = wallet;
+    }
+    /**
+     * Create a new OpenAgentClient.
+     * Handles wallet creation and XMTP connection.
+     */
+    static async create(config) {
+        let wallet;
+        if (config.mnemonic) {
+            wallet = Wallet.fromPhrase(config.mnemonic);
+        }
+        else if (config.privateKey) {
+            wallet = new Wallet(config.privateKey);
+        }
+        else {
+            wallet = Wallet.createRandom();
+        }
+        // Build XMTP signer adapter
+        const signer = {
+            getAddress: async () => wallet.address,
+            getIdentifier: () => ({
+                identifier: wallet.address,
+                identifierKind: 0
+            }),
+            signMessage: async (message) => {
+                const sig = await wallet.signMessage(message);
+                return getBytes(sig);
+            },
+            type: "EOA"
+        };
+        const client = await Client.create(signer, {
+            env: config.env || "production"
+        });
+        console.log(`[OpenAgentClient] Connected as ${wallet.address}`);
+        return new OpenAgentClient(client, wallet);
+    }
+    /**
+     * Get the client's wallet address.
+     */
+    getAddress() {
+        return this.wallet.address;
+    }
+    /**
+     * Send a named task to an agent and wait for the response.
+     *
+     * @param agentAddress - The target agent's wallet address
+     * @param method - The task name (e.g. "buy_key", "say_hello")
+     * @param params - Task input parameters
+     * @param opts - Optional: timeout, payment txHash
+     * @returns TaskResult with the response or payment demand
+     */
+    async sendTask(agentAddress, method, params = {}, opts) {
+        const timeout = opts?.timeout ?? 30000;
+        // Open DM with the agent
+        const conversation = await this.client.conversations.newDmWithIdentifier({
+            identifier: agentAddress,
+            identifierKind: 0
+        });
+        // Build JSON-RPC request
+        const request = {
+            method,
+            params,
+            id: Date.now()
+        };
+        // Attach payment proof if provided
+        if (opts?.txHash) {
+            request.payment = { txHash: opts.txHash };
+        }
+        // Send as string
+        await conversation.send(JSON.stringify(request));
+        // Wait for response
+        return await this.waitForResponse(conversation, timeout);
+    }
+    /**
+     * Send a plain text message to an agent and wait for the reply.
+     *
+     * @param agentAddress - The target agent's wallet address
+     * @param text - The message text
+     * @param timeout - Timeout in ms (default: 30000)
+     * @returns TaskResult with the reply
+     */
+    async chat(agentAddress, text, timeout = 30000) {
+        const conversation = await this.client.conversations.newDmWithIdentifier({
+            identifier: agentAddress,
+            identifierKind: 0
+        });
+        await conversation.send(text);
+        return await this.waitForResponse(conversation, timeout);
+    }
+    /**
+     * Wait for a response message from the agent on a conversation.
+     */
+    async waitForResponse(conversation, timeout) {
+        return new Promise(async (resolve) => {
+            const timer = setTimeout(() => {
+                resolve({
+                    success: false,
+                    error: `Timeout: No response after ${timeout}ms`
+                });
+            }, timeout);
+            try {
+                const stream = await conversation.stream();
+                for await (const message of stream) {
+                    // Skip our own messages
+                    if (message.senderInboxId === this.client.inboxId)
+                        continue;
+                    clearTimeout(timer);
+                    const content = message.content;
+                    if (typeof content !== 'string') {
+                        resolve({ success: true, raw: String(content) });
+                        return;
+                    }
+                    // Try to parse as JSON
+                    try {
+                        const json = JSON.parse(content);
+                        // 402 Payment Required
+                        if (json.type === "PAYMENT_REQUIRED") {
+                            resolve({
+                                success: false,
+                                paymentRequired: json.payment,
+                                raw: content
+                            });
+                            return;
+                        }
+                        // JSON-RPC error
+                        if (json.error) {
+                            resolve({
+                                success: false,
+                                error: json.error.message || JSON.stringify(json.error),
+                                raw: content
+                            });
+                            return;
+                        }
+                        // JSON-RPC success
+                        if (json.result !== undefined) {
+                            resolve({
+                                success: true,
+                                result: json.result,
+                                raw: content
+                            });
+                            return;
+                        }
+                        // Generic JSON response
+                        resolve({ success: true, result: json, raw: content });
+                        return;
+                    }
+                    catch {
+                        // Plain text response
+                        resolve({ success: true, result: content, raw: content });
+                        return;
+                    }
+                }
+            }
+            catch (err) {
+                clearTimeout(timer);
+                resolve({
+                    success: false,
+                    error: err.message || "Stream error"
+                });
+            }
+        });
+    }
+}

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from './skills/payment.js';
 export * from './skills/discovery.js';
 export * from './skills/job.js';
 export * from './registry.js';
+export * from './client.js';
 export interface OpenAgentConfig {
     signer?: Signer;
     mnemonic?: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAAY,KAAK,WAAW,IAAI,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAEvG,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAE9B,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,GAAG,CAAC,EAAE,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;CACxC;AAED,qBAAa,SAAS;IAClB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO;WAMa,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAoCvE,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACI,GAAG,CAAC,UAAU,EAAE,eAAe;IAItC;;;;OAIG;IACI,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC;IAIrE;;OAEG;IACU,KAAK;IAKlB;;;;OAIG;IACU,QAAQ,CACjB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACpE,OAAO,CAAC,cAAc,CAAC;CAS7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAAY,KAAK,WAAW,IAAI,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAEvG,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,GAAG,CAAC,EAAE,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;CACxC;AAED,qBAAa,SAAS;IAClB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO;WAMa,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAoCvE,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACI,GAAG,CAAC,UAAU,EAAE,eAAe;IAItC;;;;OAIG;IACI,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC;IAIrE;;OAEG;IACU,KAAK;IAKlB;;;;OAIG;IACU,QAAQ,CACjB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACpE,OAAO,CAAC,cAAc,CAAC;CAS7B"}

package/dist/index.js

@@ -8,6 +8,7 @@ export * from './skills/payment.js';
 export * from './skills/discovery.js';
 export * from './skills/job.js';
 export * from './registry.js';
+export * from './client.js';
 export class OpenAgent {
     agent;
     config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openagentmarket/nodejs",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "OpenAgent Market Node.js SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -24,6 +24,7 @@
   "license": "MIT",
   "dependencies": {
     "@xmtp/agent-sdk": "^1.0.0",
+    "@xmtp/node-sdk": "^4.6.0",
     "agent0-sdk": "^1.5.3",
     "dotenv": "^16.4.0",
     "ethers": "^6.10.0"

package/src/client.ts

@@ -0,0 +1,246 @@
+import { Client } from '@xmtp/node-sdk';
+import { type Signer, Wallet, HDNodeWallet, getBytes } from 'ethers';
+
+export interface OpenAgentClientConfig {
+    mnemonic?: string;
+    privateKey?: string;
+    env?: "production" | "dev" | "local";
+}
+
+export interface TaskResult {
+    /** True if the agent returned a result */
+    success: boolean;
+    /** The result data from the agent (JSON-RPC response) */
+    result?: any;
+    /** If the agent demanded payment */
+    paymentRequired?: {
+        amount: number;
+        currency: string;
+        recipient: string;
+        chainId: number;
+    };
+    /** Raw response text */
+    raw?: string;
+    /** Error message if something went wrong */
+    error?: string;
+}
+
+export interface SendTaskOptions {
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Payment proof transaction hash (if prepaying) */
+    txHash?: string;
+}
+
+/**
+ * OpenAgentClient — buyer-side SDK for hiring agents via XMTP.
+ *
+ * No registration or agent card needed. Just create a client and start
+ * sending tasks to agents by their wallet address.
+ *
+ * ```typescript
+ * const client = await OpenAgentClient.create({ mnemonic: process.env.MNEMONIC, env: "production" });
+ * const result = await client.sendTask("0xAgentAddress", "buy_key", { name: "My Key" });
+ * ```
+ */
+export class OpenAgentClient {
+    private client: Client;
+    private wallet: Wallet | HDNodeWallet;
+
+    private constructor(client: Client, wallet: Wallet | HDNodeWallet) {
+        this.client = client;
+        this.wallet = wallet;
+    }
+
+    /**
+     * Create a new OpenAgentClient.
+     * Handles wallet creation and XMTP connection.
+     */
+    public static async create(config: OpenAgentClientConfig): Promise<OpenAgentClient> {
+        let wallet: Wallet | HDNodeWallet;
+
+        if (config.mnemonic) {
+            wallet = Wallet.fromPhrase(config.mnemonic);
+        } else if (config.privateKey) {
+            wallet = new Wallet(config.privateKey);
+        } else {
+            wallet = Wallet.createRandom();
+        }
+
+        // Build XMTP signer adapter
+        const signer = {
+            getAddress: async () => wallet.address,
+            getIdentifier: () => ({
+                identifier: wallet.address,
+                identifierKind: 0
+            }),
+            signMessage: async (message: string | Uint8Array) => {
+                const sig = await wallet.signMessage(message);
+                return getBytes(sig);
+            },
+            type: "EOA"
+        };
+
+        const client = await Client.create(signer as any, {
+            env: config.env || "production"
+        });
+
+        console.log(`[OpenAgentClient] Connected as ${wallet.address}`);
+        return new OpenAgentClient(client, wallet);
+    }
+
+    /**
+     * Get the client's wallet address.
+     */
+    public getAddress(): string {
+        return this.wallet.address;
+    }
+
+    /**
+     * Send a named task to an agent and wait for the response.
+     *
+     * @param agentAddress - The target agent's wallet address
+     * @param method - The task name (e.g. "buy_key", "say_hello")
+     * @param params - Task input parameters
+     * @param opts - Optional: timeout, payment txHash
+     * @returns TaskResult with the response or payment demand
+     */
+    public async sendTask(
+        agentAddress: string,
+        method: string,
+        params: Record<string, any> = {},
+        opts?: SendTaskOptions
+    ): Promise<TaskResult> {
+        const timeout = opts?.timeout ?? 30000;
+
+        // Open DM with the agent
+        const conversation = await this.client.conversations.newDmWithIdentifier({
+            identifier: agentAddress,
+            identifierKind: 0
+        });
+
+        // Build JSON-RPC request
+        const request: Record<string, any> = {
+            method,
+            params,
+            id: Date.now()
+        };
+
+        // Attach payment proof if provided
+        if (opts?.txHash) {
+            request.payment = { txHash: opts.txHash };
+        }
+
+        // Send as string
+        await conversation.send(JSON.stringify(request));
+
+        // Wait for response
+        return await this.waitForResponse(conversation, timeout);
+    }
+
+    /**
+     * Send a plain text message to an agent and wait for the reply.
+     *
+     * @param agentAddress - The target agent's wallet address
+     * @param text - The message text
+     * @param timeout - Timeout in ms (default: 30000)
+     * @returns TaskResult with the reply
+     */
+    public async chat(
+        agentAddress: string,
+        text: string,
+        timeout: number = 30000
+    ): Promise<TaskResult> {
+        const conversation = await this.client.conversations.newDmWithIdentifier({
+            identifier: agentAddress,
+            identifierKind: 0
+        });
+
+        await conversation.send(text);
+
+        return await this.waitForResponse(conversation, timeout);
+    }
+
+    /**
+     * Wait for a response message from the agent on a conversation.
+     */
+    private async waitForResponse(
+        conversation: any,
+        timeout: number
+    ): Promise<TaskResult> {
+        return new Promise<TaskResult>(async (resolve) => {
+            const timer = setTimeout(() => {
+                resolve({
+                    success: false,
+                    error: `Timeout: No response after ${timeout}ms`
+                });
+            }, timeout);
+
+            try {
+                const stream = await conversation.stream();
+
+                for await (const message of stream) {
+                    // Skip our own messages
+                    if ((message as any).senderInboxId === this.client.inboxId) continue;
+
+                    clearTimeout(timer);
+
+                    const content = (message as any).content;
+                    if (typeof content !== 'string') {
+                        resolve({ success: true, raw: String(content) });
+                        return;
+                    }
+
+                    // Try to parse as JSON
+                    try {
+                        const json = JSON.parse(content);
+
+                        // 402 Payment Required
+                        if (json.type === "PAYMENT_REQUIRED") {
+                            resolve({
+                                success: false,
+                                paymentRequired: json.payment,
+                                raw: content
+                            });
+                            return;
+                        }
+
+                        // JSON-RPC error
+                        if (json.error) {
+                            resolve({
+                                success: false,
+                                error: json.error.message || JSON.stringify(json.error),
+                                raw: content
+                            });
+                            return;
+                        }
+
+                        // JSON-RPC success
+                        if (json.result !== undefined) {
+                            resolve({
+                                success: true,
+                                result: json.result,
+                                raw: content
+                            });
+                            return;
+                        }
+
+                        // Generic JSON response
+                        resolve({ success: true, result: json, raw: content });
+                        return;
+                    } catch {
+                        // Plain text response
+                        resolve({ success: true, result: content, raw: content });
+                        return;
+                    }
+                }
+            } catch (err: any) {
+                clearTimeout(timer);
+                resolve({
+                    success: false,
+                    error: err.message || "Stream error"
+                });
+            }
+        });
+    }
+}

package/src/index.ts

@@ -9,6 +9,7 @@ export * from './skills/payment.js';
 export * from './skills/discovery.js';
 export * from './skills/job.js';
 export * from './registry.js';
+export * from './client.js';
 
 export interface OpenAgentConfig {
     signer?: Signer;