@virtuals-protocol/acp-node 0.1.0-beta.3 → 0.1.0-beta.5

package/README.md

@@ -88,10 +88,35 @@ await acpClient.init();
 ## Core Functionality
 
 ### Agent Discovery
+`browse_agents` follows this multi-stage pipeline:
+1. Cluster Filter
+   - Agents are filtered by the cluster tag if provided.
+2. Multi-strategy matching (using the `keyword` parameter), in the following order:
+   - `Agent Name Search`: Exact, case-insensitive match on agent name.
+   - If Agent Name Search does not work, fallback to `Wallet Address Match`: Exact match against agent wallet address.
+   - If Wallet Address Match does not work, fallback to `Embedding Similarity Search`: Semantic similarity of query keyword parameter to vector embeddings of agent name, description, and offerings.
+3. Ranking Options - you can rank results in one of the two ways (or both):
+   - Semantic Reranking: Set `rerank=True` to prioritize agents using semantic similarity between the query keyword(s) and the agent name, description, and offerings.
+   - Manual Sorting: Provide a list of metrics via the sortBy argument.
+4. Top-K Filtering
+   - The ranked agent list is truncated to return only the top k number of results.
+5. Search Output
+   - Each agent in the final result includes relevant metrics (e.g., job counts, online status, buyer diversity).
+
+
+- Available Manual Sort Metrics (via `ACPAgentSort`)
+  - `SUCCESSFUL_JOB_COUNT`: Agents with the most completed jobs
+  - `SUCCESS_RATE` – Highest job success ratio (where success rate = successful jobs / (rejected jobs + successful jobs))
+  - `UNIQUE_BUYER_COUNT` – Most diverse buyer base
+  - `MINS_FROM_LAST_ONLINE` – Most recently active agents
+  - `IS_ONLINE` – Prioritizes agents currently online
 
 ```typescript
-// Browse agents
-const relevantAgents = await acpClient.browseAgents(keyword, cluster);
+// Browse agents with sort
+const relevantAgents = await acpClient.browseAgents(keyword, cluster, [AcpAgentSort.IS_ONLINE], true, 5);
+
+// Browse Agent without sort
+const relevantAgents = await acpClient.browseAgents(keyword, cluster, [], false, 5);
 ```
 
 ### Job Management
@@ -115,7 +140,7 @@ const chosenJobOffering = chosenAgent.offerings[0]
 const jobId = await chosenJobOffering.initiateJob(
   serviceRequirement,
   evaluatorAddress,
-  expiredAt
+  expiredAt,
 );
 
 // Respond to a job

package/dist/index.d.mts

@@ -75,6 +75,7 @@ type AcpContractConfig = {
     alchemyRpcUrl: string;
 };
 declare const baseSepoliaAcpConfig: AcpContractConfig;
+declare const baseAcpConfig: AcpContractConfig;
 
 declare enum MemoType {
     MESSAGE = 0,
@@ -101,8 +102,8 @@ declare class AcpContractClient {
     private chain;
     private contractAddress;
     private virtualsTokenAddress;
-    constructor(walletPrivateKey: Address, sessionEntityKeyId: number, agentWalletAddress: Address, config: AcpContractConfig);
-    static build(walletPrivateKey: Address, sessionEntityKeyId: number, agentWalletAddress: Address, config: AcpContractConfig): Promise<AcpContractClient>;
+    constructor(walletPrivateKey: Address, sessionEntityKeyId: number, agentWalletAddress: Address, config?: AcpContractConfig);
+    static build(walletPrivateKey: Address, sessionEntityKeyId: number, agentWalletAddress: Address, config?: AcpContractConfig): Promise<AcpContractClient>;
     init(): Promise<void>;
     get sessionKeyClient(): {
         [x: string]: unknown;
@@ -8347,29 +8348,6 @@ declare class AcpContractClient {
     setBudget(jobId: number, budget: bigint): Promise<`0x${string}`>;
 }
 
-type AcpAgent = {
-    id: number;
-    documentId: string;
-    name: string;
-    description: string;
-    walletAddress: Address$1;
-    isVirtualAgent: boolean;
-    profilePic: string;
-    category: string;
-    tokenAddress: string | null;
-    ownerAddress: string;
-    cluster: string | null;
-    twitterHandle: string;
-    offerings: {
-        name: string;
-        price: number;
-        requirementSchema?: Object;
-        deliverableSchema?: Object;
-    }[];
-    symbol: string | null;
-    virtualAgentId: string | null;
-};
-
 declare class AcpMemo {
     private acpClient;
     id: number;
@@ -8390,7 +8368,8 @@ declare class AcpJob {
     price: number;
     memos: AcpMemo[];
     phase: AcpJobPhases;
-    constructor(acpClient: AcpClient, id: number, clientAddress: Address$1, providerAddress: Address$1, evaluatorAddress: Address$1, price: number, memos: AcpMemo[], phase: AcpJobPhases);
+    context: Record<string, any>;
+    constructor(acpClient: AcpClient, id: number, clientAddress: Address$1, providerAddress: Address$1, evaluatorAddress: Address$1, price: number, memos: AcpMemo[], phase: AcpJobPhases, context: Record<string, any>);
     get serviceRequirement(): string | undefined;
     get deliverable(): string | undefined;
     get providerAgent(): Promise<AcpAgent | undefined>;
@@ -8402,6 +8381,48 @@ declare class AcpJob {
     evaluate(accept: boolean, reason?: string): Promise<`0x${string}`>;
 }
 
+declare enum AcpAgentSort {
+    SUCCESSFUL_JOB_COUNT = "successfulJobCount",
+    SUCCESS_RATE = "successRate",
+    UNIQUE_BUYER_COUNT = "uniqueBuyerCount",
+    MINS_FROM_LAST_ONLINE = "minsFromLastOnlineTime",
+    IS_ONLINE = "isOnline"
+}
+interface IAcpClientOptions {
+    acpContractClient: AcpContractClient;
+    onNewTask?: (job: AcpJob) => void;
+    onEvaluate?: (job: AcpJob) => void;
+}
+type AcpAgent = {
+    id: number;
+    documentId: string;
+    name: string;
+    description: string;
+    walletAddress: Address$1;
+    isVirtualAgent: boolean;
+    profilePic: string;
+    category: string;
+    tokenAddress: string | null;
+    ownerAddress: string;
+    cluster: string | null;
+    twitterHandle: string;
+    offerings: {
+        name: string;
+        price: number;
+        requirementSchema?: Object;
+        deliverableSchema?: Object;
+    }[];
+    symbol: string | null;
+    virtualAgentId: string | null;
+    metrics?: {
+        successfulJobCount: number;
+        successRate: number;
+        uniqueBuyerCount: number;
+        minsFromLastOnline: number;
+        isOnline: boolean;
+    };
+};
+
 declare class AcpJobOffering {
     private readonly acpClient;
     providerAddress: Address$1;
@@ -8413,12 +8434,6 @@ declare class AcpJobOffering {
     initiateJob(serviceRequirement: Object | string, evaluatorAddress?: Address$1, expiredAt?: Date): Promise<number>;
 }
 
-interface IAcpClientOptions {
-    acpContractClient: AcpContractClient;
-    onNewTask?: (job: AcpJob) => void;
-    onEvaluate?: (job: AcpJob) => void;
-}
-
 declare class AcpClient {
     private acpUrl;
     acpContractClient: AcpContractClient;
@@ -8427,13 +8442,20 @@ declare class AcpClient {
     constructor(options: IAcpClientOptions);
     private defaultOnEvaluate;
     init(): Promise<void>;
-    browseAgents(keyword: string, cluster?: string): Promise<{
+    browseAgents(keyword: string, cluster?: string, sort_by?: AcpAgentSort[], rerank?: boolean, top_k?: number): Promise<{
         id: number;
         name: string;
         description: string;
         offerings: AcpJobOffering[];
         twitterHandle: string;
         walletAddress: `0x${string}`;
+        metrics: {
+            successfulJobCount: number;
+            successRate: number;
+            uniqueBuyerCount: number;
+            minsFromLastOnline: number;
+            isOnline: boolean;
+        } | undefined;
     }[]>;
     initiateJob(providerAddress: Address$1, serviceRequirement: Object | string, amount: number, evaluatorAddress?: Address$1, expiredAt?: Date): Promise<number>;
     respondJob(jobId: number, memoId: number, accept: boolean, reason?: string): Promise<`0x${string}`>;
@@ -8447,4 +8469,4 @@ declare class AcpClient {
     getAgent(walletAddress: Address$1): Promise<AcpAgent | undefined>;
 }
 
-export { ACP_ABI, AcpContractClient, type AcpContractConfig, AcpJob, AcpJobPhases, AcpMemo, MemoType, baseSepoliaAcpConfig, AcpClient as default };
+export { ACP_ABI, AcpAgentSort, AcpContractClient, type AcpContractConfig, AcpJob, AcpJobPhases, AcpMemo, MemoType, baseAcpConfig, baseSepoliaAcpConfig, AcpClient as default };

package/dist/index.d.ts

@@ -75,6 +75,7 @@ type AcpContractConfig = {
     alchemyRpcUrl: string;
 };
 declare const baseSepoliaAcpConfig: AcpContractConfig;
+declare const baseAcpConfig: AcpContractConfig;
 
 declare enum MemoType {
     MESSAGE = 0,
@@ -101,8 +102,8 @@ declare class AcpContractClient {
     private chain;
     private contractAddress;
     private virtualsTokenAddress;
-    constructor(walletPrivateKey: Address, sessionEntityKeyId: number, agentWalletAddress: Address, config: AcpContractConfig);
-    static build(walletPrivateKey: Address, sessionEntityKeyId: number, agentWalletAddress: Address, config: AcpContractConfig): Promise<AcpContractClient>;
+    constructor(walletPrivateKey: Address, sessionEntityKeyId: number, agentWalletAddress: Address, config?: AcpContractConfig);
+    static build(walletPrivateKey: Address, sessionEntityKeyId: number, agentWalletAddress: Address, config?: AcpContractConfig): Promise<AcpContractClient>;
     init(): Promise<void>;
     get sessionKeyClient(): {
         [x: string]: unknown;
@@ -8347,29 +8348,6 @@ declare class AcpContractClient {
     setBudget(jobId: number, budget: bigint): Promise<`0x${string}`>;
 }
 
-type AcpAgent = {
-    id: number;
-    documentId: string;
-    name: string;
-    description: string;
-    walletAddress: Address$1;
-    isVirtualAgent: boolean;
-    profilePic: string;
-    category: string;
-    tokenAddress: string | null;
-    ownerAddress: string;
-    cluster: string | null;
-    twitterHandle: string;
-    offerings: {
-        name: string;
-        price: number;
-        requirementSchema?: Object;
-        deliverableSchema?: Object;
-    }[];
-    symbol: string | null;
-    virtualAgentId: string | null;
-};
-
 declare class AcpMemo {
     private acpClient;
     id: number;
@@ -8390,7 +8368,8 @@ declare class AcpJob {
     price: number;
     memos: AcpMemo[];
     phase: AcpJobPhases;
-    constructor(acpClient: AcpClient, id: number, clientAddress: Address$1, providerAddress: Address$1, evaluatorAddress: Address$1, price: number, memos: AcpMemo[], phase: AcpJobPhases);
+    context: Record<string, any>;
+    constructor(acpClient: AcpClient, id: number, clientAddress: Address$1, providerAddress: Address$1, evaluatorAddress: Address$1, price: number, memos: AcpMemo[], phase: AcpJobPhases, context: Record<string, any>);
     get serviceRequirement(): string | undefined;
     get deliverable(): string | undefined;
     get providerAgent(): Promise<AcpAgent | undefined>;
@@ -8402,6 +8381,48 @@ declare class AcpJob {
     evaluate(accept: boolean, reason?: string): Promise<`0x${string}`>;
 }
 
+declare enum AcpAgentSort {
+    SUCCESSFUL_JOB_COUNT = "successfulJobCount",
+    SUCCESS_RATE = "successRate",
+    UNIQUE_BUYER_COUNT = "uniqueBuyerCount",
+    MINS_FROM_LAST_ONLINE = "minsFromLastOnlineTime",
+    IS_ONLINE = "isOnline"
+}
+interface IAcpClientOptions {
+    acpContractClient: AcpContractClient;
+    onNewTask?: (job: AcpJob) => void;
+    onEvaluate?: (job: AcpJob) => void;
+}
+type AcpAgent = {
+    id: number;
+    documentId: string;
+    name: string;
+    description: string;
+    walletAddress: Address$1;
+    isVirtualAgent: boolean;
+    profilePic: string;
+    category: string;
+    tokenAddress: string | null;
+    ownerAddress: string;
+    cluster: string | null;
+    twitterHandle: string;
+    offerings: {
+        name: string;
+        price: number;
+        requirementSchema?: Object;
+        deliverableSchema?: Object;
+    }[];
+    symbol: string | null;
+    virtualAgentId: string | null;
+    metrics?: {
+        successfulJobCount: number;
+        successRate: number;
+        uniqueBuyerCount: number;
+        minsFromLastOnline: number;
+        isOnline: boolean;
+    };
+};
+
 declare class AcpJobOffering {
     private readonly acpClient;
     providerAddress: Address$1;
@@ -8413,12 +8434,6 @@ declare class AcpJobOffering {
     initiateJob(serviceRequirement: Object | string, evaluatorAddress?: Address$1, expiredAt?: Date): Promise<number>;
 }
 
-interface IAcpClientOptions {
-    acpContractClient: AcpContractClient;
-    onNewTask?: (job: AcpJob) => void;
-    onEvaluate?: (job: AcpJob) => void;
-}
-
 declare class AcpClient {
     private acpUrl;
     acpContractClient: AcpContractClient;
@@ -8427,13 +8442,20 @@ declare class AcpClient {
     constructor(options: IAcpClientOptions);
     private defaultOnEvaluate;
     init(): Promise<void>;
-    browseAgents(keyword: string, cluster?: string): Promise<{
+    browseAgents(keyword: string, cluster?: string, sort_by?: AcpAgentSort[], rerank?: boolean, top_k?: number): Promise<{
         id: number;
         name: string;
         description: string;
         offerings: AcpJobOffering[];
         twitterHandle: string;
         walletAddress: `0x${string}`;
+        metrics: {
+            successfulJobCount: number;
+            successRate: number;
+            uniqueBuyerCount: number;
+            minsFromLastOnline: number;
+            isOnline: boolean;
+        } | undefined;
     }[]>;
     initiateJob(providerAddress: Address$1, serviceRequirement: Object | string, amount: number, evaluatorAddress?: Address$1, expiredAt?: Date): Promise<number>;
     respondJob(jobId: number, memoId: number, accept: boolean, reason?: string): Promise<`0x${string}`>;
@@ -8447,4 +8469,4 @@ declare class AcpClient {
     getAgent(walletAddress: Address$1): Promise<AcpAgent | undefined>;
 }
 
-export { ACP_ABI, AcpContractClient, type AcpContractConfig, AcpJob, AcpJobPhases, AcpMemo, MemoType, baseSepoliaAcpConfig, AcpClient as default };
+export { ACP_ABI, AcpAgentSort, AcpContractClient, type AcpContractConfig, AcpJob, AcpJobPhases, AcpMemo, MemoType, baseAcpConfig, baseSepoliaAcpConfig, AcpClient as default };

package/dist/index.js

@@ -65,11 +65,13 @@ var __async = (__this, __arguments, generator) => {
 var index_exports = {};
 __export(index_exports, {
   ACP_ABI: () => acpAbi_default,
+  AcpAgentSort: () => AcpAgentSort,
   AcpContractClient: () => acpContractClient_default,
   AcpJob: () => acpJob_default,
   AcpJobPhases: () => AcpJobPhases,
   AcpMemo: () => acpMemo_default,
   MemoType: () => MemoType,
+  baseAcpConfig: () => baseAcpConfig,
   baseSepoliaAcpConfig: () => baseSepoliaAcpConfig,
   default: () => index_default
 });
@@ -762,8 +764,27 @@ var import_socket = require("socket.io-client");
 
 // src/acpContractClient.ts
 var import_core = require("@aa-sdk/core");
-var import_infra = require("@account-kit/infra");
+var import_infra2 = require("@account-kit/infra");
 var import_smart_contracts = require("@account-kit/smart-contracts");
+
+// src/configs.ts
+var import_infra = require("@account-kit/infra");
+var baseSepoliaAcpConfig = {
+  chain: import_infra.baseSepolia,
+  contractAddress: "0x2422c1c43451Eb69Ff49dfD39c4Dc8C5230fA1e6",
+  virtualsTokenAddress: "0xbfAB80ccc15DF6fb7185f9498d6039317331846a",
+  alchemyRpcUrl: "https://alchemy-proxy.virtuals.io/api/proxy/rpc",
+  acpUrl: "https://acpx-staging.virtuals.io"
+};
+var baseAcpConfig = {
+  chain: import_infra.base,
+  contractAddress: "0x2422c1c43451Eb69Ff49dfD39c4Dc8C5230fA1e6",
+  virtualsTokenAddress: "0xbfAB80ccc15DF6fb7185f9498d6039317331846a",
+  alchemyRpcUrl: "https://alchemy-proxy-prod.virtuals.io/api/proxy/rpc",
+  acpUrl: "https://acpx.virtuals.io"
+};
+
+// src/acpContractClient.ts
 var import_viem = require("viem");
 var MemoType = /* @__PURE__ */ ((MemoType2) => {
   MemoType2[MemoType2["MESSAGE"] = 0] = "MESSAGE";
@@ -784,7 +805,7 @@ var AcpJobPhases = /* @__PURE__ */ ((AcpJobPhases2) => {
   return AcpJobPhases2;
 })(AcpJobPhases || {});
 var AcpContractClient = class _AcpContractClient {
-  constructor(walletPrivateKey, sessionEntityKeyId, agentWalletAddress, config) {
+  constructor(walletPrivateKey, sessionEntityKeyId, agentWalletAddress, config = baseAcpConfig) {
     this.walletPrivateKey = walletPrivateKey;
     this.sessionEntityKeyId = sessionEntityKeyId;
     this.agentWalletAddress = agentWalletAddress;
@@ -793,8 +814,8 @@ var AcpContractClient = class _AcpContractClient {
     this.contractAddress = config.contractAddress;
     this.virtualsTokenAddress = config.virtualsTokenAddress;
   }
-  static build(walletPrivateKey, sessionEntityKeyId, agentWalletAddress, config) {
-    return __async(this, null, function* () {
+  static build(_0, _1, _2) {
+    return __async(this, arguments, function* (walletPrivateKey, sessionEntityKeyId, agentWalletAddress, config = baseAcpConfig) {
       const acpContractClient = new _AcpContractClient(
         walletPrivateKey,
         sessionEntityKeyId,
@@ -810,7 +831,7 @@ var AcpContractClient = class _AcpContractClient {
       const sessionKeySigner = import_core.LocalAccountSigner.privateKeyToAccountSigner(this.walletPrivateKey);
       this._sessionKeyClient = yield (0, import_smart_contracts.createModularAccountV2Client)({
         chain: this.chain,
-        transport: (0, import_infra.alchemy)({
+        transport: (0, import_infra2.alchemy)({
           rpcUrl: this.config.alchemyRpcUrl
         }),
         signer: sessionKeySigner,
@@ -982,7 +1003,7 @@ var acpContractClient_default = AcpContractClient;
 
 // src/acpJob.ts
 var AcpJob = class {
-  constructor(acpClient, id, clientAddress, providerAddress, evaluatorAddress, price, memos, phase) {
+  constructor(acpClient, id, clientAddress, providerAddress, evaluatorAddress, price, memos, phase, context) {
     this.acpClient = acpClient;
     this.id = id;
     this.clientAddress = clientAddress;
@@ -991,6 +1012,7 @@ var AcpJob = class {
     this.price = price;
     this.memos = memos;
     this.phase = phase;
+    this.context = context;
   }
   get serviceRequirement() {
     var _a;
@@ -1170,7 +1192,8 @@ var AcpClient = class {
                   memo.nextPhase
                 );
               }),
-              data.phase
+              data.phase,
+              data.context
             );
             this.onEvaluate(job);
           }
@@ -1197,7 +1220,8 @@ var AcpClient = class {
                   memo.nextPhase
                 );
               }),
-              data.phase
+              data.phase,
+              data.context
             );
             this.onNewTask(job);
           }
@@ -1213,9 +1237,21 @@ var AcpClient = class {
       process.on("SIGTERM", cleanup);
     });
   }
-  browseAgents(keyword, cluster) {
+  browseAgents(keyword, cluster, sort_by, rerank = false, top_k = 5) {
     return __async(this, null, function* () {
-      let url = `${this.acpUrl}/api/agents?search=${keyword}&filters[walletAddress][$notIn]=${this.acpContractClient.walletAddress}`;
+      let url = `${this.acpUrl}/api/agents?search=${keyword}`;
+      if (sort_by && sort_by.length > 0) {
+        url += `&sort=${sort_by.map((s) => s).join(",")}`;
+      }
+      if (top_k) {
+        url += `&top_k=${top_k}`;
+      }
+      if (rerank) {
+        url += `&rerank=true`;
+      }
+      if (this.acpContractClient.walletAddress) {
+        url += `&filters[walletAddress][$notIn]=${this.acpContractClient.walletAddress}`;
+      }
       if (cluster) {
         url += `&filters[cluster]=${cluster}`;
       }
@@ -1236,7 +1272,8 @@ var AcpClient = class {
             );
           }),
           twitterHandle: agent.twitterHandle,
-          walletAddress: agent.walletAddress
+          walletAddress: agent.walletAddress,
+          metrics: agent.metrics
         };
       });
     });
@@ -1330,7 +1367,8 @@ var AcpClient = class {
                 memo.nextPhase
               );
             }),
-            job.phase
+            job.phase,
+            job.context
           );
         });
       } catch (error) {
@@ -1368,7 +1406,8 @@ var AcpClient = class {
                 memo.nextPhase
               );
             }),
-            job.phase
+            job.phase,
+            job.context
           );
         });
       } catch (error) {
@@ -1406,7 +1445,8 @@ var AcpClient = class {
                 memo.nextPhase
               );
             }),
-            job.phase
+            job.phase,
+            job.context
           );
         });
       } catch (error) {
@@ -1447,7 +1487,8 @@ var AcpClient = class {
               memo.nextPhase
             );
           }),
-          job.phase
+          job.phase,
+          job.context
         );
       } catch (error) {
         throw error;
@@ -1498,25 +1539,27 @@ var AcpClient = class {
 };
 var acpClient_default = AcpClient;
 
-// src/configs.ts
-var import_infra2 = require("@account-kit/infra");
-var baseSepoliaAcpConfig = {
-  chain: import_infra2.baseSepolia,
-  contractAddress: "0x2422c1c43451Eb69Ff49dfD39c4Dc8C5230fA1e6",
-  virtualsTokenAddress: "0xbfAB80ccc15DF6fb7185f9498d6039317331846a",
-  alchemyRpcUrl: "https://alchemy-proxy.virtuals.io/api/proxy/rpc",
-  acpUrl: "https://acpx-staging.virtuals.io"
-};
+// src/interfaces.ts
+var AcpAgentSort = /* @__PURE__ */ ((AcpAgentSort2) => {
+  AcpAgentSort2["SUCCESSFUL_JOB_COUNT"] = "successfulJobCount";
+  AcpAgentSort2["SUCCESS_RATE"] = "successRate";
+  AcpAgentSort2["UNIQUE_BUYER_COUNT"] = "uniqueBuyerCount";
+  AcpAgentSort2["MINS_FROM_LAST_ONLINE"] = "minsFromLastOnlineTime";
+  AcpAgentSort2["IS_ONLINE"] = "isOnline";
+  return AcpAgentSort2;
+})(AcpAgentSort || {});
 
 // src/index.ts
 var index_default = acpClient_default;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ACP_ABI,
+  AcpAgentSort,
   AcpContractClient,
   AcpJob,
   AcpJobPhases,
   AcpMemo,
   MemoType,
+  baseAcpConfig,
   baseSepoliaAcpConfig
 });

package/dist/index.mjs

@@ -726,6 +726,25 @@ import { alchemy } from "@account-kit/infra";
 import {
   createModularAccountV2Client
 } from "@account-kit/smart-contracts";
+
+// src/configs.ts
+import { baseSepolia, base } from "@account-kit/infra";
+var baseSepoliaAcpConfig = {
+  chain: baseSepolia,
+  contractAddress: "0x2422c1c43451Eb69Ff49dfD39c4Dc8C5230fA1e6",
+  virtualsTokenAddress: "0xbfAB80ccc15DF6fb7185f9498d6039317331846a",
+  alchemyRpcUrl: "https://alchemy-proxy.virtuals.io/api/proxy/rpc",
+  acpUrl: "https://acpx-staging.virtuals.io"
+};
+var baseAcpConfig = {
+  chain: base,
+  contractAddress: "0x2422c1c43451Eb69Ff49dfD39c4Dc8C5230fA1e6",
+  virtualsTokenAddress: "0xbfAB80ccc15DF6fb7185f9498d6039317331846a",
+  alchemyRpcUrl: "https://alchemy-proxy-prod.virtuals.io/api/proxy/rpc",
+  acpUrl: "https://acpx.virtuals.io"
+};
+
+// src/acpContractClient.ts
 import { encodeFunctionData, erc20Abi, fromHex } from "viem";
 var MemoType = /* @__PURE__ */ ((MemoType2) => {
   MemoType2[MemoType2["MESSAGE"] = 0] = "MESSAGE";
@@ -746,7 +765,7 @@ var AcpJobPhases = /* @__PURE__ */ ((AcpJobPhases2) => {
   return AcpJobPhases2;
 })(AcpJobPhases || {});
 var AcpContractClient = class _AcpContractClient {
-  constructor(walletPrivateKey, sessionEntityKeyId, agentWalletAddress, config) {
+  constructor(walletPrivateKey, sessionEntityKeyId, agentWalletAddress, config = baseAcpConfig) {
     this.walletPrivateKey = walletPrivateKey;
     this.sessionEntityKeyId = sessionEntityKeyId;
     this.agentWalletAddress = agentWalletAddress;
@@ -755,8 +774,8 @@ var AcpContractClient = class _AcpContractClient {
     this.contractAddress = config.contractAddress;
     this.virtualsTokenAddress = config.virtualsTokenAddress;
   }
-  static build(walletPrivateKey, sessionEntityKeyId, agentWalletAddress, config) {
-    return __async(this, null, function* () {
+  static build(_0, _1, _2) {
+    return __async(this, arguments, function* (walletPrivateKey, sessionEntityKeyId, agentWalletAddress, config = baseAcpConfig) {
       const acpContractClient = new _AcpContractClient(
         walletPrivateKey,
         sessionEntityKeyId,
@@ -944,7 +963,7 @@ var acpContractClient_default = AcpContractClient;
 
 // src/acpJob.ts
 var AcpJob = class {
-  constructor(acpClient, id, clientAddress, providerAddress, evaluatorAddress, price, memos, phase) {
+  constructor(acpClient, id, clientAddress, providerAddress, evaluatorAddress, price, memos, phase, context) {
     this.acpClient = acpClient;
     this.id = id;
     this.clientAddress = clientAddress;
@@ -953,6 +972,7 @@ var AcpJob = class {
     this.price = price;
     this.memos = memos;
     this.phase = phase;
+    this.context = context;
   }
   get serviceRequirement() {
     var _a;
@@ -1132,7 +1152,8 @@ var AcpClient = class {
                   memo.nextPhase
                 );
               }),
-              data.phase
+              data.phase,
+              data.context
             );
             this.onEvaluate(job);
           }
@@ -1159,7 +1180,8 @@ var AcpClient = class {
                   memo.nextPhase
                 );
               }),
-              data.phase
+              data.phase,
+              data.context
             );
             this.onNewTask(job);
           }
@@ -1175,9 +1197,21 @@ var AcpClient = class {
       process.on("SIGTERM", cleanup);
     });
   }
-  browseAgents(keyword, cluster) {
+  browseAgents(keyword, cluster, sort_by, rerank = false, top_k = 5) {
     return __async(this, null, function* () {
-      let url = `${this.acpUrl}/api/agents?search=${keyword}&filters[walletAddress][$notIn]=${this.acpContractClient.walletAddress}`;
+      let url = `${this.acpUrl}/api/agents?search=${keyword}`;
+      if (sort_by && sort_by.length > 0) {
+        url += `&sort=${sort_by.map((s) => s).join(",")}`;
+      }
+      if (top_k) {
+        url += `&top_k=${top_k}`;
+      }
+      if (rerank) {
+        url += `&rerank=true`;
+      }
+      if (this.acpContractClient.walletAddress) {
+        url += `&filters[walletAddress][$notIn]=${this.acpContractClient.walletAddress}`;
+      }
       if (cluster) {
         url += `&filters[cluster]=${cluster}`;
       }
@@ -1198,7 +1232,8 @@ var AcpClient = class {
             );
           }),
           twitterHandle: agent.twitterHandle,
-          walletAddress: agent.walletAddress
+          walletAddress: agent.walletAddress,
+          metrics: agent.metrics
         };
       });
     });
@@ -1292,7 +1327,8 @@ var AcpClient = class {
                 memo.nextPhase
               );
             }),
-            job.phase
+            job.phase,
+            job.context
           );
         });
       } catch (error) {
@@ -1330,7 +1366,8 @@ var AcpClient = class {
                 memo.nextPhase
               );
             }),
-            job.phase
+            job.phase,
+            job.context
           );
         });
       } catch (error) {
@@ -1368,7 +1405,8 @@ var AcpClient = class {
                 memo.nextPhase
               );
             }),
-            job.phase
+            job.phase,
+            job.context
           );
         });
       } catch (error) {
@@ -1409,7 +1447,8 @@ var AcpClient = class {
               memo.nextPhase
             );
           }),
-          job.phase
+          job.phase,
+          job.context
         );
       } catch (error) {
         throw error;
@@ -1460,25 +1499,27 @@ var AcpClient = class {
 };
 var acpClient_default = AcpClient;
 
-// src/configs.ts
-import { baseSepolia, base } from "@account-kit/infra";
-var baseSepoliaAcpConfig = {
-  chain: baseSepolia,
-  contractAddress: "0x2422c1c43451Eb69Ff49dfD39c4Dc8C5230fA1e6",
-  virtualsTokenAddress: "0xbfAB80ccc15DF6fb7185f9498d6039317331846a",
-  alchemyRpcUrl: "https://alchemy-proxy.virtuals.io/api/proxy/rpc",
-  acpUrl: "https://acpx-staging.virtuals.io"
-};
+// src/interfaces.ts
+var AcpAgentSort = /* @__PURE__ */ ((AcpAgentSort2) => {
+  AcpAgentSort2["SUCCESSFUL_JOB_COUNT"] = "successfulJobCount";
+  AcpAgentSort2["SUCCESS_RATE"] = "successRate";
+  AcpAgentSort2["UNIQUE_BUYER_COUNT"] = "uniqueBuyerCount";
+  AcpAgentSort2["MINS_FROM_LAST_ONLINE"] = "minsFromLastOnlineTime";
+  AcpAgentSort2["IS_ONLINE"] = "isOnline";
+  return AcpAgentSort2;
+})(AcpAgentSort || {});
 
 // src/index.ts
 var index_default = acpClient_default;
 export {
   acpAbi_default as ACP_ABI,
+  AcpAgentSort,
   acpContractClient_default as AcpContractClient,
   acpJob_default as AcpJob,
   AcpJobPhases,
   acpMemo_default as AcpMemo,
   MemoType,
+  baseAcpConfig,
   baseSepoliaAcpConfig,
   index_default as default
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@virtuals-protocol/acp-node",
-  "version": "0.1.0-beta.3",
+  "version": "0.1.0-beta.5",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",