acp-plugin-gamesdk 0.1.4__py3-none-any.whl → 0.1.6__py3-none-any.whl

acp_plugin_gamesdk/acp_client.py

@@ -5,6 +5,7 @@ import requests
 from acp_plugin_gamesdk.interface import AcpAgent, AcpJobPhases, AcpOffering, AcpState
 from acp_plugin_gamesdk.acp_token import AcpToken, MemoType
 import time
+import traceback
 
 
 class AcpClient:
@@ -40,7 +41,12 @@ class AcpClient:
         response = requests.get(url)
         
         if response.status_code != 200:
-            raise Exception(f"Failed to browse agents: {response.text}")
+            raise Exception(
+                    f"Error occured in browse_agents function. Failed to browse agents.\n" 
+                    f"Response status code: {response.status_code}\n"
+                    f"Response description: {response.text}\n"
+                )
+        
 
         response_json = response.json()
         
@@ -98,7 +104,8 @@ class AcpClient:
                     break  
                 
             except Exception as e:
-                print(f"Error creating job: {e}")
+                print(f"Error in create_job function: {e}")
+                print(traceback.format_exc())
                 if attempt < retry_count - 1:
                     time.sleep(retry_delay) 
                 else:
@@ -166,7 +173,15 @@ class AcpClient:
         time.sleep(5)
         self.acp_token.approve_allowance(amount_wei)
         time.sleep(5)
-        return self.acp_token.sign_memo(memo_id, True, reason)
+        self.acp_token.sign_memo(memo_id, True, reason)
+        time.sleep(5)
+        return self.acp_token.create_memo(
+            job_id=job_id,
+            content=f"Payment of {amount} made {reason}",
+            memo_type=MemoType.MESSAGE,
+            is_secured=False,
+            next_phase=AcpJobPhases.EVALUATION
+        )
 
     def deliver_job(self, job_id: int, deliverable: str):
         return self.acp_token.create_memo(
@@ -194,7 +209,11 @@ class AcpClient:
         )
         
         if response.status_code != 200 and response.status_code != 201:
-            raise Exception(f"Failed to add tweet: {response.status_code} {response.text}")
+            raise Exception(
+                f"Error occured in add_tweet function. Failed to add tweet.\n" 
+                f"Response status code: {response.status_code}\n"
+                f"Response description: {response.text}\n"
+            )
         
         
         return response.json()
@@ -206,4 +225,22 @@ class AcpClient:
         )
         
         if response.status_code not in [200, 204]:
+            raise Exception(
+                f"Error occured in reset_state function. Failed to reset state\n" 
+                f"Response status code: {response.status_code}\n"
+                f"Response description: {response.text}\n"
+            )
             raise Exception(f"Failed to reset state: {response.status_code} {response.text}")
+        
+    def delete_completed_job(self, job_id: int) -> None:
+        response = requests.delete(
+            f"{self.base_url}/{job_id}/wallet/{self.agent_wallet_address}",
+            headers={"x-api-key": self.api_key}
+        )
+        
+        if response.status_code not in [200, 204]:
+            raise Exception(
+                f"Error occurred in delete_completed_job function. Failed to delete job.\n"
+                f"Response status code: {response.status_code}\n"
+                f"Response description: {response.text}\n"
+            )

acp_plugin_gamesdk/acp_plugin.py

@@ -15,7 +15,7 @@ from twitter_plugin_gamesdk.twitter_plugin import TwitterPlugin
 from twitter_plugin_gamesdk.game_twitter_plugin import GameTwitterPlugin
 from acp_plugin_gamesdk.acp_client import AcpClient
 from acp_plugin_gamesdk.acp_token import AcpToken
-from acp_plugin_gamesdk.interface import AcpJobPhasesDesc, IDeliverable, IInventory
+from acp_plugin_gamesdk.interface import AcpJobPhasesDesc, IDeliverable, IInventory, AcpJob
 
 @dataclass
 class AcpPluginOptions:
@@ -25,12 +25,15 @@ class AcpPluginOptions:
     cluster: Optional[str] = None
     evaluator_cluster: Optional[str] = None
     on_evaluate: Optional[Callable[[IDeliverable], Tuple[bool, str]]] = None
+    on_phase_change: Optional[Callable[[AcpJob], None]] = None
+    
 
 SocketEvents = {
     "JOIN_EVALUATOR_ROOM": "joinEvaluatorRoom",
     "LEAVE_EVALUATOR_ROOM": "leaveEvaluatorRoom", 
     "ON_EVALUATE": "onEvaluate",
-    "ROOM_JOINED" : "roomJoined"
+    "ROOM_JOINED" : "roomJoined",
+    "ON_PHASE_CHANGE": "onPhaseChange"
 }
 
 class AcpPlugin:
@@ -57,22 +60,29 @@ class AcpPlugin:
         """
         self.cluster = options.cluster
         self.evaluator_cluster = options.evaluator_cluster
-        self.twitter_plugin = options.twitter_plugin
+        self.twitter_plugin = None
+        if (options.twitter_plugin is not None):
+            self.twitter_plugin = options.twitter_plugin
+            
         self.produced_inventory: List[IInventory] = []
         self.acp_base_url = self.acp_token_client.acp_base_url if self.acp_token_client.acp_base_url is None else "https://acpx-staging.virtuals.io/api"
-        if (options.on_evaluate is not None):
+        if options.on_evaluate is not None or options.on_phase_change is not None:
             print("Initializing socket")
-            self.on_evaluate = options.on_evaluate
             self.socket = None
+            if options.on_evaluate is not None:
+                self.on_evaluate = options.on_evaluate
+            if options.on_phase_change is not None:
+                self.on_phase_change = options.on_phase_change
             self.initializeSocket()
         
+        
+        
     def initializeSocket(self) -> Tuple[bool, str]:
         """
         Initialize socket connection for real-time communication.
         Returns a tuple of (success, message).
         """
         try:
-            print("Initializing socket after")
             self.socket = socketio.Client()
                 
             # Set up authentication before connecting
@@ -97,15 +107,23 @@ class AcpPlugin:
                     is_approved, reasoning = self.on_evaluate(deliverable)
                     
                     self.acp_token_client.sign_memo(memo_id, is_approved, reasoning)
+                    
+                        # Set up event handler for phase changes
+            @self.socket.on(SocketEvents["ON_PHASE_CHANGE"])
+            def on_phase_change(data):
+                if hasattr(self, 'on_phase_change') and self.on_phase_change:
+                    print(f"on_phase_change: {data}")
+                    self.on_phase_change(data)
             
             # Set up cleanup function for graceful shutdown
             def cleanup():
                 if self.socket:
                     print("Disconnecting socket")
-                    
                     import time
                     time.sleep(1)
                     self.socket.disconnect()
+                    
+                    
             
             def signal_handler(sig, frame):
                 cleanup()
@@ -120,6 +138,8 @@ class AcpPlugin:
             return False, f"Failed to initialize socket: {str(e)}"
     
     
+    def set_on_phase_change(self, on_phase_change: Callable[[AcpJob], None]) -> None:
+        self.on_phase_change = on_phase_change
 
     def add_produce_item(self, item: IInventory) -> None:
         self.produced_inventory.append(item)
@@ -127,6 +147,9 @@ class AcpPlugin:
     def reset_state(self) -> None:
         self.acp_client.reset_state()
         
+    def delete_completed_job(self, job_id: int) -> None:
+        self.acp_client.delete_completed_job(job_id)
+        
     def get_acp_state(self) -> Dict:
         server_state = self.acp_client.get_state()
         server_state["inventory"]["produced"] = self.produced_inventory
@@ -252,7 +275,7 @@ class AcpPlugin:
 
         args = [seller_wallet_address_arg, price_arg, reasoning_arg, service_requirements_arg, require_evaluation_arg, evaluator_keyword_arg]
         
-        if self.twitter_plugin is not None:
+        if hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None:
             tweet_content_arg = Argument(
                 name="tweetContent",
                 type="string",
@@ -304,7 +327,7 @@ class AcpPlugin:
                 evaluatorAddress
             )
             
-            if (self.twitter_plugin is not None and tweetContent is not None):
+            if (hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None and tweetContent is not None):
                 post_tweet_fn = self.twitter_plugin.get_function('post_tweet')
                 tweet_id = post_tweet_fn(tweetContent, None).get('data', {}).get('id')
                 if (tweet_id is not None):
@@ -343,7 +366,7 @@ class AcpPlugin:
         
         args = [job_id_arg, decision_arg, reasoning_arg]
         
-        if self.twitter_plugin is not None:
+        if hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None:
             tweet_content_arg = Argument(
                 name="tweetContent",
                 type="string",
@@ -389,7 +412,7 @@ class AcpPlugin:
                 reasoning
             )
             
-            if (self.twitter_plugin is not None and tweetContent is not None):
+            if (hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None and tweetContent is not None):
                 tweet_history = job.get("tweetHistory", [])
                 tweet_id = tweet_history[-1].get("tweetId") if tweet_history else None
                 if (tweet_id is not None):
@@ -429,7 +452,7 @@ class AcpPlugin:
 
         args = [job_id_arg, amount_arg, reasoning_arg]
         
-        if self.twitter_plugin is not None:
+        if hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None:
             tweet_content_arg = Argument(
                 name="tweetContent",
                 type="string",
@@ -476,7 +499,7 @@ class AcpPlugin:
                 reasoning
             )
             
-            if (self.twitter_plugin is not None and tweetContent is not None):
+            if (hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None and tweetContent is not None):
                 tweet_history = job.get("tweetHistory", [])
                 tweet_id = tweet_history[-1].get("tweetId") if tweet_history else None
                 if (tweet_id is not None):
@@ -522,7 +545,7 @@ class AcpPlugin:
 
         args = [job_id_arg, deliverable_type_arg, deliverable_arg, reasoning_arg]
         
-        if self.twitter_plugin is not None:
+        if hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None:
             tweet_content_arg = Argument(
                 name="tweetContent",
                 type="string",
@@ -579,7 +602,8 @@ class AcpPlugin:
                 json.dumps(deliverable),
             )
             
-            if (self.twitter_plugin is not None and tweetContent is not None):
+            if (hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None and tweetContent is not None):
+
                 tweet_history = job.get("tweetHistory", [])
                 tweet_id = tweet_history[-1].get("tweetId") if tweet_history else None
                 if (tweet_id is not None):

acp_plugin_gamesdk/acp_token.py

@@ -107,6 +107,7 @@ class AcpToken:
     ) -> dict:
         try:
             provider_address = Web3.to_checksum_address(provider_address)
+            evaluator_address = Web3.to_checksum_address(evaluator_address)
             expire_timestamp = int(expire_at.timestamp())
         
             # Sign the transaction

acp_plugin_gamesdk/interface.py

@@ -34,7 +34,13 @@ class AcpJobPhasesDesc(str, Enum):
 class AcpRequestMemo:
     id: int
     created_at: int
-
+    
+@dataclass
+class ITweet:
+    type: Literal["buyer", "seller"]
+    tweet_id: str
+    content: str
+    created_at: int
 @dataclass
 class AcpJob:
     job_id: int
@@ -42,6 +48,7 @@ class AcpJob:
     price: str
     phase: AcpJobPhasesDesc
     memo: List[AcpRequestMemo]
+    tweet_history : ITweet
     last_updated: int
 
 @dataclass

{acp_plugin_gamesdk-0.1.4.dist-info → acp_plugin_gamesdk-0.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: acp-plugin-gamesdk
-Version: 0.1.4
+Version: 0.1.6
 Summary: ACP Plugin for Python SDK for GAME by Virtuals
 Author: Steven Lee Soon Fatt
 Author-email: steven@virtuals.io
@@ -134,7 +134,7 @@ acp_plugin = AcpPlugin(
 > - This is where you can get your session entity key ID:
 >   ![Session Entity ID](../../docs/imgs/session-entity-id-location.png)
 
-4. (optional) If you want to use GAME's twitter client with the ACP plugin, you can initialize it by running:
+4. (Optional) If you want to use GAME's twitter client with the ACP plugin, you can initialize it by running:
 
 ```python
 twitter_client_options = {
@@ -200,7 +200,7 @@ agent = Agent(
 )
 ```
 
-1. Buyer-specific configurations
+7. Buyer-specific configurations
 
    - <i>[Setting buyer agent goal]</i> Define what item needs to be "bought" and which worker to go to look for the item, e.g.
 
@@ -208,7 +208,7 @@ agent = Agent(
    agent_goal = "You are an agent that gains market traction by posting memes. Your interest are in cats and AI. You can head to acp to look for agents to help you generate memes."
    ```
 
-2. Seller-specific configurations
+8. Seller-specific configurations
 
    - <i>[Setting seller agent goal]</i> Define what item needs to be "sold" and which worker to go to respond to jobs, e.g.
 
@@ -288,4 +288,5 @@ To register your agent, please head over to the [agent registry](https://acp-sta
 1. [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.
+2. [ACP Plugin FAQs](https://virtualsprotocol.notion.site/ACP-Plugin-FAQs-Troubleshooting-Tips-1d62d2a429e980eb9e61de851b6a7d60?pvs=4)
 

acp_plugin_gamesdk-0.1.6.dist-info/RECORD

@@ -0,0 +1,8 @@
+acp_plugin_gamesdk/acp_client.py,sha256=JRrlfaRDgP2uZpbX8Vea-uHO6yicn488bmi_IXGVvt8,8896
+acp_plugin_gamesdk/acp_plugin.py,sha256=M4pZ6UyTk60CEA_R2tvKVRezd4CZQOFna94jzrM6_ss,26778
+acp_plugin_gamesdk/acp_token.py,sha256=Wx87e2Wd-5QUKoMWX_wf3IBEP-cl1pSyA9IZr1yYIDE,11796
+acp_plugin_gamesdk/acp_token_abi.py,sha256=nllh9xOuDXxFFdhLklTTdtZxWZd2LcUTBoOP2d9xDTA,22319
+acp_plugin_gamesdk/interface.py,sha256=mWZ41SycGrNQbnC_IfBq8K6TgpguCvvbVTqFg8Uxy58,1549
+acp_plugin_gamesdk-0.1.6.dist-info/METADATA,sha256=w_mr3J8GkBN5AY6IU-CVfKpZG-lv4pu4cMSLOHxN7zw,11545
+acp_plugin_gamesdk-0.1.6.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+acp_plugin_gamesdk-0.1.6.dist-info/RECORD,,

acp_plugin_gamesdk-0.1.4.dist-info/RECORD

@@ -1,8 +0,0 @@
-acp_plugin_gamesdk/acp_client.py,sha256=8wHyGL6VIWVTOkmXcYwDd1v_Tp4SqbWHpxXHc4fSl4c,7382
-acp_plugin_gamesdk/acp_plugin.py,sha256=UZlC5SqVZw1F7Cg-oez9d7xwYfWJmcnMLDp6SA-QbMs,25459
-acp_plugin_gamesdk/acp_token.py,sha256=CL-0Ww1i0tzDNj0sAuY3DvlWIKrEGoMcb0Z69e5X9og,11720
-acp_plugin_gamesdk/acp_token_abi.py,sha256=nllh9xOuDXxFFdhLklTTdtZxWZd2LcUTBoOP2d9xDTA,22319
-acp_plugin_gamesdk/interface.py,sha256=5jStptqzT_dTlO-d51Xp4PaOVYeFV6uss70GvpLfCEM,1401
-acp_plugin_gamesdk-0.1.4.dist-info/METADATA,sha256=iICvWAXJEdNAlbVW06cLm4En1zqUYKq5t0LGQ-K2SAc,11410
-acp_plugin_gamesdk-0.1.4.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-acp_plugin_gamesdk-0.1.4.dist-info/RECORD,,