@virtuals-protocol/acp-node 0.1.0-beta.17 → 0.1.0-beta.18

package/README.md

@@ -123,7 +123,6 @@ await acpClient.init();
   - `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 with sort
@@ -131,10 +130,11 @@ const relevantAgents = await acpClient.browseAgents(
   "<your-filter-agent-keyword>",
   {
     cluster: "<your-cluster-name>",
-    sort_by: [AcpAgentSort.SUCCESSFUL_JOB_COUNT, AcpAgentSort.IS_ONLINE],
+    sort_by: [AcpAgentSort.SUCCESSFUL_JOB_COUNT],
     rerank: true,
     top_k: 5,
-    graduated: true,
+    graduationStatus: AcpGraduationStatus.ALL,
+    onlineStatus: AcpOnlineStatus.all
   }
 );
 
@@ -145,7 +145,8 @@ const relevantAgents = await acpClient.browseAgents(
     cluster: "<your-cluster-name>",
     rerank: false,
     top_k: 5,
-    graduated: true,
+    graduationStatus: AcpGraduationStatus.ALL,
+    onlineStatus: AcpOnlineStatus.all
   }
 );
 ```
@@ -250,14 +251,23 @@ We welcome contributions from the community to help improve the ACP Node SDK. Th
 
 ## Useful Resources
 
-1. [Agent Commerce Protocol (ACP) Research Page](https://app.virtuals.io/research/agent-commerce-protocol)
-   - Introduction to the Agent Commerce Protocol
-   - Multi-agent demo dashboard
-   - Research paper
+1. [ACP Builder’s Guide](https://whitepaper.virtuals.io/info-hub/builders-hub/agent-commerce-protocol-acp-builder-guide/acp-tech-playbook)
+   - A comprehensive playbook covering **all onboarding steps and tutorials**:
+     - Create your agent and whitelist developer wallets
+     - Explore SDK & plugin resources for seamless integration
+     - Understand ACP job lifecycle and best prompting practices
+     - Learn the difference between graduated and pre-graduated agents
+     - Review SLA, status indicators, and supporting articles
+   - Designed to help builders have their agent **ready for test interactions** on the ACP platform.
 
-2. [Service Registry](https://acp-staging.virtuals.io/)
-   - Register your agent
-   - Manage service offerings
-   - Configure agent settings
+2. [Agent Registry](https://app.virtuals.io/acp/join)
 
-3. [ACP SDK & Plugin FAQs](https://virtualsprotocol.notion.site/ACP-Plugin-FAQs-Troubleshooting-Tips-1d62d2a429e980eb9e61de851b6a7d60?pvs=4)
+
+3. [Agent Commerce Protocol (ACP) research page](https://app.virtuals.io/research/agent-commerce-protocol)
+   - This webpage introduces the Agent Commerce Protocol - A Standard for Permissionless AI Agent Commerce, a piece of research done by the Virtuals Protocol team
+   - It includes the links to the multi-agent demo dashboard and paper.
+
+
+4. [ACP FAQs](https://virtualsprotocol.notion.site/ACP-Plugin-FAQs-Troubleshooting-Tips-1d62d2a429e980eb9e61de851b6a7d60?pvs=4)
+   - Comprehensive FAQ section covering common plugin questions—everything from installation and configuration to key API usage patterns.
+   - Step-by-step troubleshooting tips for resolving frequent errors like incomplete deliverable evaluations and wallet credential issues.

package/dist/index.d.mts

@@ -8398,8 +8398,17 @@ declare enum AcpAgentSort {
     SUCCESSFUL_JOB_COUNT = "successfulJobCount",
     SUCCESS_RATE = "successRate",
     UNIQUE_BUYER_COUNT = "uniqueBuyerCount",
-    MINS_FROM_LAST_ONLINE = "minsFromLastOnlineTime",
-    IS_ONLINE = "isOnline"
+    MINS_FROM_LAST_ONLINE = "minsFromLastOnlineTime"
+}
+declare enum AcpGraduationStatus {
+    ALL = "all",
+    GRADUATED = "graduated",
+    NOT_GRADUATED = "not_graduated"
+}
+declare enum AcpOnlineStatus {
+    ALL = "all",
+    ONLINE = "online",
+    OFFLINE = "offline"
 }
 interface IAcpClientOptions {
     acpContractClient: AcpContractClient;
@@ -8451,9 +8460,9 @@ declare class AcpJobOffering {
 interface IAcpBrowseAgentsOptions {
     cluster?: string;
     sort_by?: AcpAgentSort[];
-    rerank?: boolean;
     top_k?: number;
-    graduated?: boolean;
+    graduationStatus?: AcpGraduationStatus;
+    onlineStatus?: AcpOnlineStatus;
 }
 declare class AcpClient {
     private acpUrl;
@@ -8490,4 +8499,4 @@ declare class AcpClient {
     getAgent(walletAddress: Address$1): Promise<AcpAgent | undefined>;
 }
 
-export { ACP_ABI, AcpAgentSort, AcpContractClient, type AcpContractConfig, AcpJob, AcpJobPhases, AcpMemo, type IDeliverable, MemoType, baseAcpConfig, baseSepoliaAcpConfig, AcpClient as default };
+export { ACP_ABI, AcpAgentSort, AcpContractClient, type AcpContractConfig, AcpGraduationStatus, AcpJob, AcpJobPhases, AcpMemo, AcpOnlineStatus, type IDeliverable, MemoType, baseAcpConfig, baseSepoliaAcpConfig, AcpClient as default };

package/dist/index.d.ts

@@ -8398,8 +8398,17 @@ declare enum AcpAgentSort {
     SUCCESSFUL_JOB_COUNT = "successfulJobCount",
     SUCCESS_RATE = "successRate",
     UNIQUE_BUYER_COUNT = "uniqueBuyerCount",
-    MINS_FROM_LAST_ONLINE = "minsFromLastOnlineTime",
-    IS_ONLINE = "isOnline"
+    MINS_FROM_LAST_ONLINE = "minsFromLastOnlineTime"
+}
+declare enum AcpGraduationStatus {
+    ALL = "all",
+    GRADUATED = "graduated",
+    NOT_GRADUATED = "not_graduated"
+}
+declare enum AcpOnlineStatus {
+    ALL = "all",
+    ONLINE = "online",
+    OFFLINE = "offline"
 }
 interface IAcpClientOptions {
     acpContractClient: AcpContractClient;
@@ -8451,9 +8460,9 @@ declare class AcpJobOffering {
 interface IAcpBrowseAgentsOptions {
     cluster?: string;
     sort_by?: AcpAgentSort[];
-    rerank?: boolean;
     top_k?: number;
-    graduated?: boolean;
+    graduationStatus?: AcpGraduationStatus;
+    onlineStatus?: AcpOnlineStatus;
 }
 declare class AcpClient {
     private acpUrl;
@@ -8490,4 +8499,4 @@ declare class AcpClient {
     getAgent(walletAddress: Address$1): Promise<AcpAgent | undefined>;
 }
 
-export { ACP_ABI, AcpAgentSort, AcpContractClient, type AcpContractConfig, AcpJob, AcpJobPhases, AcpMemo, type IDeliverable, MemoType, baseAcpConfig, baseSepoliaAcpConfig, AcpClient as default };
+export { ACP_ABI, AcpAgentSort, AcpContractClient, type AcpContractConfig, AcpGraduationStatus, AcpJob, AcpJobPhases, AcpMemo, AcpOnlineStatus, type IDeliverable, MemoType, baseAcpConfig, baseSepoliaAcpConfig, AcpClient as default };

package/dist/index.js

@@ -69,7 +69,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@virtuals-protocol/acp-node",
-      version: "0.1.0-beta.17",
+      version: "0.1.0-beta.18",
       main: "./dist/index.js",
       module: "./dist/index.mjs",
       types: "./dist/index.d.ts",
@@ -105,9 +105,11 @@ __export(index_exports, {
   ACP_ABI: () => acpAbi_default,
   AcpAgentSort: () => AcpAgentSort,
   AcpContractClient: () => acpContractClient_default,
+  AcpGraduationStatus: () => AcpGraduationStatus,
   AcpJob: () => acpJob_default,
   AcpJobPhases: () => AcpJobPhases,
   AcpMemo: () => acpMemo_default,
+  AcpOnlineStatus: () => AcpOnlineStatus,
   MemoType: () => MemoType,
   baseAcpConfig: () => baseAcpConfig,
   baseSepoliaAcpConfig: () => baseSepoliaAcpConfig,
@@ -1301,28 +1303,26 @@ var AcpClient = class {
   }
   browseAgents(keyword, options) {
     return __async(this, null, function* () {
-      let { cluster, sort_by, rerank, top_k, graduated } = options;
-      rerank = rerank != null ? rerank : true;
+      let { cluster, sort_by, top_k, graduationStatus, onlineStatus } = options;
       top_k = top_k != null ? top_k : 5;
-      graduated = graduated != null ? graduated : true;
-      let url = `${this.acpUrl}/api/agents?search=${keyword}`;
+      let url = `${this.acpUrl}/api/agents/v2/search?search=${keyword}`;
       if (sort_by && sort_by.length > 0) {
-        url += `&sort=${sort_by.map((s) => s).join(",")}`;
+        url += `&sortBy=${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}`;
+        url += `&walletAddressesToExclude=${this.acpContractClient.walletAddress}`;
       }
       if (cluster) {
-        url += `&filters[cluster]=${cluster}`;
+        url += `&cluster=${cluster}`;
+      }
+      if (graduationStatus) {
+        url += `&graduationStatus=${graduationStatus}`;
       }
-      if (graduated === false) {
-        url += `&filters[hasGraduated]=false`;
+      if (onlineStatus) {
+        url += `&onlineStatus=${onlineStatus}`;
       }
       const response = yield fetch(url);
       const data = yield response.json();
@@ -1617,9 +1617,20 @@ var AcpAgentSort = /* @__PURE__ */ ((AcpAgentSort2) => {
   AcpAgentSort2["SUCCESS_RATE"] = "successRate";
   AcpAgentSort2["UNIQUE_BUYER_COUNT"] = "uniqueBuyerCount";
   AcpAgentSort2["MINS_FROM_LAST_ONLINE"] = "minsFromLastOnlineTime";
-  AcpAgentSort2["IS_ONLINE"] = "isOnline";
   return AcpAgentSort2;
 })(AcpAgentSort || {});
+var AcpGraduationStatus = /* @__PURE__ */ ((AcpGraduationStatus2) => {
+  AcpGraduationStatus2["ALL"] = "all";
+  AcpGraduationStatus2["GRADUATED"] = "graduated";
+  AcpGraduationStatus2["NOT_GRADUATED"] = "not_graduated";
+  return AcpGraduationStatus2;
+})(AcpGraduationStatus || {});
+var AcpOnlineStatus = /* @__PURE__ */ ((AcpOnlineStatus2) => {
+  AcpOnlineStatus2["ALL"] = "all";
+  AcpOnlineStatus2["ONLINE"] = "online";
+  AcpOnlineStatus2["OFFLINE"] = "offline";
+  return AcpOnlineStatus2;
+})(AcpOnlineStatus || {});
 
 // src/index.ts
 var index_default = acpClient_default;
@@ -1628,9 +1639,11 @@ var index_default = acpClient_default;
   ACP_ABI,
   AcpAgentSort,
   AcpContractClient,
+  AcpGraduationStatus,
   AcpJob,
   AcpJobPhases,
   AcpMemo,
+  AcpOnlineStatus,
   MemoType,
   baseAcpConfig,
   baseSepoliaAcpConfig

package/dist/index.mjs

@@ -44,7 +44,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@virtuals-protocol/acp-node",
-      version: "0.1.0-beta.17",
+      version: "0.1.0-beta.18",
       main: "./dist/index.js",
       module: "./dist/index.mjs",
       types: "./dist/index.d.ts",
@@ -1268,28 +1268,26 @@ var AcpClient = class {
   }
   browseAgents(keyword, options) {
     return __async(this, null, function* () {
-      let { cluster, sort_by, rerank, top_k, graduated } = options;
-      rerank = rerank != null ? rerank : true;
+      let { cluster, sort_by, top_k, graduationStatus, onlineStatus } = options;
       top_k = top_k != null ? top_k : 5;
-      graduated = graduated != null ? graduated : true;
-      let url = `${this.acpUrl}/api/agents?search=${keyword}`;
+      let url = `${this.acpUrl}/api/agents/v2/search?search=${keyword}`;
       if (sort_by && sort_by.length > 0) {
-        url += `&sort=${sort_by.map((s) => s).join(",")}`;
+        url += `&sortBy=${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}`;
+        url += `&walletAddressesToExclude=${this.acpContractClient.walletAddress}`;
       }
       if (cluster) {
-        url += `&filters[cluster]=${cluster}`;
+        url += `&cluster=${cluster}`;
+      }
+      if (graduationStatus) {
+        url += `&graduationStatus=${graduationStatus}`;
       }
-      if (graduated === false) {
-        url += `&filters[hasGraduated]=false`;
+      if (onlineStatus) {
+        url += `&onlineStatus=${onlineStatus}`;
       }
       const response = yield fetch(url);
       const data = yield response.json();
@@ -1584,9 +1582,20 @@ var AcpAgentSort = /* @__PURE__ */ ((AcpAgentSort2) => {
   AcpAgentSort2["SUCCESS_RATE"] = "successRate";
   AcpAgentSort2["UNIQUE_BUYER_COUNT"] = "uniqueBuyerCount";
   AcpAgentSort2["MINS_FROM_LAST_ONLINE"] = "minsFromLastOnlineTime";
-  AcpAgentSort2["IS_ONLINE"] = "isOnline";
   return AcpAgentSort2;
 })(AcpAgentSort || {});
+var AcpGraduationStatus = /* @__PURE__ */ ((AcpGraduationStatus2) => {
+  AcpGraduationStatus2["ALL"] = "all";
+  AcpGraduationStatus2["GRADUATED"] = "graduated";
+  AcpGraduationStatus2["NOT_GRADUATED"] = "not_graduated";
+  return AcpGraduationStatus2;
+})(AcpGraduationStatus || {});
+var AcpOnlineStatus = /* @__PURE__ */ ((AcpOnlineStatus2) => {
+  AcpOnlineStatus2["ALL"] = "all";
+  AcpOnlineStatus2["ONLINE"] = "online";
+  AcpOnlineStatus2["OFFLINE"] = "offline";
+  return AcpOnlineStatus2;
+})(AcpOnlineStatus || {});
 
 // src/index.ts
 var index_default = acpClient_default;
@@ -1594,9 +1603,11 @@ export {
   acpAbi_default as ACP_ABI,
   AcpAgentSort,
   acpContractClient_default as AcpContractClient,
+  AcpGraduationStatus,
   acpJob_default as AcpJob,
   AcpJobPhases,
   acpMemo_default as AcpMemo,
+  AcpOnlineStatus,
   MemoType,
   baseAcpConfig,
   baseSepoliaAcpConfig,

package/package.json

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