pycityagent 2.0.0a65__cp310-cp310-macosx_11_0_arm64.whl → 2.0.0a67__cp310-cp310-macosx_11_0_arm64.whl

pycityagent/workflow/trigger.py

@@ -1,25 +1,49 @@
 import asyncio
-from typing import Optional
 import socket
-from ..memory import Memory
+from typing import Optional
+
 from ..environment import Simulator
+from ..memory import Memory
 
 KEY_TRIGGER_COMPONENTS = [Memory, Simulator]
 
+__all__ = [
+    "EventTrigger",
+    "MemoryChangeTrigger",
+    "TimeTrigger",
+]
+
 
 class EventTrigger:
-    """Base class for event triggers that wait for specific conditions to be met."""
+    """Base class for event triggers that wait for specific conditions to be met.
+
+    - **Attributes**:
+        - `required_components` (List[Type]): A list of component types required by this trigger.
+    """
 
     # 定义该trigger需要的组件类型
     required_components: list[type] = []
 
     def __init__(self, block=None):
+        """
+        - **Description**:
+            - Initializes the EventTrigger with an optional block which contains dependencies.
+
+        - **Args**:
+            - `block`: An object containing necessary dependencies for the trigger. Defaults to None.
+        """
         self.block = block
         if block is not None:
             self.initialize()
 
     def initialize(self) -> None:
-        """Initialize the trigger with necessary dependencies."""
+        """
+        - **Description**:
+            - Initialize the trigger with necessary dependencies and checks for missing components.
+
+        - **Raises**:
+            - `RuntimeError`: If the block is not set or required components are missing.
+        """
         if not self.block:
             raise RuntimeError("Block not set for trigger")
 
@@ -37,24 +61,32 @@ class EventTrigger:
             )
 
     async def wait_for_trigger(self) -> None:
-        """Wait for the event trigger to be activated.
+        """
+        - **Description**:
+            - Wait for the event trigger to be activated.
 
-        Raises:
-            NotImplementedError: Subclasses must implement this method.
+        - **Raises**:
+            - `NotImplementedError`: Subclasses must implement this method.
         """
         raise NotImplementedError
 
 
 class MemoryChangeTrigger(EventTrigger):
-    """Event trigger that activates when a specific key in memory changes."""
+    """Event trigger that activates when a specific key in memory changes.
+
+    - **Attributes**:
+        - `required_components` (List[Type]): Specifies that the Memory component is required.
+    """
 
     required_components = [Memory]
 
     def __init__(self, key: str) -> None:
-        """Initialize the memory change trigger.
+        """
+        - **Description**:
+            - Initialize the memory change trigger.
 
-        Args:
-            key (str): The key in memory to monitor for changes.
+        - **Args**:
+            - `key` (str): The key in memory to monitor for changes.
         """
         self.key = key
         self.trigger_event = asyncio.Event()
@@ -62,14 +94,27 @@ class MemoryChangeTrigger(EventTrigger):
         super().__init__()
 
     def initialize(self) -> None:
-        """Initialize the trigger with memory from block."""
+        """
+        - **Description**:
+            - Initialize the trigger with memory from block and add watcher for the specified key.
+
+        - **Raises**:
+            - `RuntimeError`: If the block is not properly set.
+        """
         super().initialize()  # 首先检查必需组件
+        assert self.block is not None
         self.memory = self.block.memory
         asyncio.create_task(self.memory.add_watcher(self.key, self.trigger_event.set))
         self._initialized = True
 
     async def wait_for_trigger(self) -> None:
-        """Wait for the memory change trigger to be activated."""
+        """
+        - **Description**:
+            - Wait for the memory change trigger to be activated.
+
+        - **Raises**:
+            - `RuntimeError`: If the trigger is not properly initialized.
+        """
         if not self._initialized:
             raise RuntimeError("Trigger not properly initialized")
         await self.trigger_event.wait()
@@ -77,7 +122,11 @@ class MemoryChangeTrigger(EventTrigger):
 
 
 class TimeTrigger(EventTrigger):
-    """Event trigger that activates periodically based on time intervals."""
+    """Event trigger that activates periodically based on time intervals.
+
+    - **Attributes**:
+        - `required_components` (List[Type]): Specifies that the Simulator component is required.
+    """
 
     required_components = [Simulator]
 
@@ -87,15 +136,17 @@ class TimeTrigger(EventTrigger):
         hours: Optional[int] = None,
         minutes: Optional[int] = None,
     ) -> None:
-        """Initialize the time trigger with interval settings.
+        """
+        - **Description**:
+            - Initialize the time trigger with interval settings.
 
-        Args:
-            days (Optional[int]): Execute every N days
-            hours (Optional[int]): Execute every N hours
-            minutes (Optional[int]): Execute every N minutes
+        - **Args**:
+            - `days` (Optional[int]): Execute every N days. Defaults to None.
+            - `hours` (Optional[int]): Execute every N hours. Defaults to None.
+            - `minutes` (Optional[int]): Execute every N minutes. Defaults to None.
 
-        Raises:
-            ValueError: If all interval parameters are None or negative
+        - **Raises**:
+            - `ValueError`: If all interval parameters are None or any of them are negative.
         """
         if all(param is None for param in (days, hours, minutes)):
             raise ValueError("At least one time interval must be specified")
@@ -125,8 +176,15 @@ class TimeTrigger(EventTrigger):
         super().__init__()
 
     def initialize(self) -> None:
-        """Initialize the trigger with necessary dependencies."""
+        """
+        - **Description**:
+            - Initialize the trigger with necessary dependencies and start monitoring task.
+
+        - **Raises**:
+            - `RuntimeError`: If the block is not properly set.
+        """
         super().initialize()  # 首先检查必需组件
+        assert self.block is not None
         self.memory = self.block.memory
         self.simulator = self.block.simulator
         # 启动时间监控任务
@@ -134,7 +192,10 @@ class TimeTrigger(EventTrigger):
         self._initialized = True
 
     async def _monitor_time(self):
-        """持续监控时间并在达到间隔时触发事件"""
+        """
+        - **Description**:
+            - Continuously monitor the time and trigger the event when the interval has passed.
+        """
         # 第一次调用时直接触发
         self.trigger_event.set()
 
@@ -156,7 +217,13 @@ class TimeTrigger(EventTrigger):
                 await asyncio.sleep(10)  # 发生错误时等待较长时间
 
     async def wait_for_trigger(self) -> None:
-        """Wait for the time trigger to be activated."""
+        """
+        - **Description**:
+            - Wait for the time trigger to be activated.
+
+        - **Raises**:
+            - `RuntimeError`: If the trigger is not properly initialized.
+        """
         if not self._initialized:
             raise RuntimeError("Trigger not properly initialized")
         await self.trigger_event.wait()

{pycityagent-2.0.0a65.dist-info → pycityagent-2.0.0a67.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: pycityagent
-Version: 2.0.0a65
+Version: 2.0.0a67
 Summary: LLM-based city environment agent building library
 Author-email: Yuwei Yan <pinkgranite86@gmail.com>, Junbo Yan <yanjb20thu@gmali.com>, Jun Zhang <zhangjun990222@gmali.com>
 License: MIT License
@@ -45,7 +45,7 @@ Requires-Dist: openai>=1.58.1
 Requires-Dist: Pillow<12.0.0,>=11.0.0
 Requires-Dist: protobuf<5.0.0,<=4.24.0
 Requires-Dist: pycitydata>=1.0.3
-Requires-Dist: pycityproto>=2.2.0
+Requires-Dist: pycityproto>=2.2.2
 Requires-Dist: requests>=2.32.3
 Requires-Dist: Shapely>=2.0.6
 Requires-Dist: PyYAML>=6.0.2

pycityagent-2.0.0a67.dist-info/RECORD

@@ -0,0 +1,97 @@
+pycityagent-2.0.0a67.dist-info/RECORD,,
+pycityagent-2.0.0a67.dist-info/LICENSE,sha256=n2HPXiupinpyHMnIkbCf3OTYd3KMqbmldu1e7av0CAU,1084
+pycityagent-2.0.0a67.dist-info/WHEEL,sha256=ezfKMaDztqf77C8lvQ0NCnZxkTaOaKLprqJ8q932MhU,109
+pycityagent-2.0.0a67.dist-info/entry_points.txt,sha256=BZcne49AAIFv-hawxGnPbblea7X3MtAtoPyDX8L4OC4,132
+pycityagent-2.0.0a67.dist-info/top_level.txt,sha256=yOmeu6cSXmiUtScu53a3s0p7BGtLMaV0aff83EHCTic,43
+pycityagent-2.0.0a67.dist-info/METADATA,sha256=c4r6nC0hBaQ9ux_-fHHvugj-ReCAlqoKDbWew9PE1f8,9110
+pycityagent/pycityagent-sim,sha256=7AF-sHfnUfVBbiBMOWc11C_5xc9rfEip9lg_7vUieUU,35884466
+pycityagent/__init__.py,sha256=PUKWTXc-xdMG7px8oTNclodsILUgypANj2Z647sY63k,808
+pycityagent/pycityagent-ui,sha256=Ur95yZygIaZ5l_CDqP9394M5GQ66iV5PkcNPYFWqzvk,41225346
+pycityagent/metrics/mlflow_client.py,sha256=-iyh4BPVnBkluhmfucUzibCUnBX2iftkz4tVJJVxwHw,6958
+pycityagent/metrics/__init__.py,sha256=X08PaBbGVAd7_PRGLREXWxaqm7nS82WBQpD1zvQzcqc,128
+pycityagent/economy/__init__.py,sha256=aonY4WHnx-6EGJ4WKrx4S-2jAkYNLtqUA04jp6q8B7w,75
+pycityagent/economy/econ_client.py,sha256=9kzGMhzoTsOXzyv6vBPscc7LbU3gvN5yiuofMUBOgvE,24797
+pycityagent/tools/__init__.py,sha256=y7sMVMHf0AbivlczM2h-kr7mkgXK-WAx3S9BXLXkWvw,235
+pycityagent/tools/tool.py,sha256=-HZvKeq4gFMo2wJPk6vcr8EdXubM7kA0qC82zv_yS-s,9011
+pycityagent/llm/llmconfig.py,sha256=6AqCMV4B_JqBD2mb98bLGzpUdlOCnziQKae-Hhxxp-E,469
+pycityagent/llm/__init__.py,sha256=iWs6FLgrbRVIiqOf4ILS89gkVCTvS7HFC3vG-MWuyko,205
+pycityagent/llm/llm.py,sha256=DvrgrnrmR2JAQRVOvvRo3w4aD8M-qLAqVSD5pXZHr4M,19019
+pycityagent/llm/embeddings.py,sha256=3610I-_scAy8HwRNpT8hVJpH9_8_pTLCPptqnzSq10o,11322
+pycityagent/llm/utils.py,sha256=rSx_fp-_Gh0vZ-x2rqAUqnpS56BVTZ4ChfAMarB8S1A,195
+pycityagent/memory/memory.py,sha256=Shf-8ZAPCzxcIgZM-L64OzwjkCmIlN_26ByeI-meqnE,44760
+pycityagent/memory/profile.py,sha256=Z1shwFc6MqakorbiY6rGqVAgCJP4YTpDrqnMQZcYQno,5227
+pycityagent/memory/__init__.py,sha256=NClJAXC4G6I8kFWkPEcU2lbVDfyrRb5HrrBHgCXrzOU,125
+pycityagent/memory/memory_base.py,sha256=av_sbD62PZbJyM8E9wmVuqYqgsutghcO7nJdAxGpHi0,9784
+pycityagent/memory/self_define.py,sha256=rndjWvQfi4x_90jtQWuCtWwLFBKqe7sExsDqs4I-KEw,5224
+pycityagent/memory/utils.py,sha256=oJWLdPeJy_jcdKcDTo9JAH9kDZhqjoQhhv_zT9qWC0w,877
+pycityagent/memory/const.py,sha256=nFmjvt-8FEB0hc0glOH3lliqJhkhf3D_NKxWI0pf6TY,936
+pycityagent/memory/faiss_query.py,sha256=KPeyzIjD0dzkxr-TlOeCiIlkdh1WAyyipCAXUEt97Lk,17350
+pycityagent/memory/state.py,sha256=JFCBuK1AS-HqscvdGS9ATF9AUU8t29_2leDY_6iO2_4,5158
+pycityagent/simulation/simulation.py,sha256=WlCs76fvLdZNzmAJvAsKdXiTH7eyvVmqOG9xK-OhQWk,47719
+pycityagent/simulation/__init__.py,sha256=u1WpgwVxPboXWMxrUQKMXJNmTKQYAeCaqZv9HmSxESY,118
+pycityagent/simulation/agentgroup.py,sha256=TlZekAZBjJsch2ZlvDWgRNyFmyc6kwzd_S550s2Lflw,36796
+pycityagent/simulation/storage/pg.py,sha256=xRshSOGttW-p0re0fNBOjOpb-nQ5msIE2LsdT79_E_Y,8425
+pycityagent/message/message_interceptor.py,sha256=QWuTUqi1Cu214fhFs0f78tD2zflMnb6zEAGB4RutXxs,17736
+pycityagent/message/__init__.py,sha256=f5QH7DKPqEAMyfSlBMnl3uouOKlsoel909STlIe7nUk,276
+pycityagent/message/messager.py,sha256=UdOyEMLmaF3ZUvXHmratZxKNEb3BpmN7VyRdvGJWTL4,9060
+pycityagent/utils/avro_schema.py,sha256=dzytGiDy5tDFTi5QJ8pHySl9xrbXZ0Qwrc1ONUhfzwk,4150
+pycityagent/utils/__init__.py,sha256=GQEa4x_uJBK19Z57vfm9Omvqg1c4ysi3QJ9wx8xiDhI,524
+pycityagent/utils/survey_util.py,sha256=o-gvmmfus3vMIN-EMWPzfLbHkDH4DfZb8B-yBd_mGYk,2076
+pycityagent/utils/pg_query.py,sha256=KAcnBDLyzUu2il18SGXxk8dySdBen_8ejfpxiWuKUMA,2225
+pycityagent/utils/decorators.py,sha256=Gk3r41hfk6awui40tbwpq3C7wC7jHaRmLRlcJFlLQCE,3160
+pycityagent/utils/parsers/__init__.py,sha256=AN2xgiPxszWK4rpX7zrqRsqNwfGF3WnCA5-PFTvbaKk,281
+pycityagent/utils/parsers/code_block_parser.py,sha256=jy6wHx9zypvJTWneCKuUaLQL19d4yLK6C_awc7y8A-k,1179
+pycityagent/utils/parsers/parser_base.py,sha256=ZbqRcqOBL9hfHVZSltQSQmJnWrtuJS9aYeOJU-FlJ0E,1725
+pycityagent/utils/parsers/json_parser.py,sha256=sakKohUuMcUH2toR85CAG_37D02ZoAn6LlzLgftUjmo,2923
+pycityagent/agent/agent_base.py,sha256=s2jFdGadn9gL9WPXf-WpdaPgY-yjzsxfcZp6VVr1K8M,37996
+pycityagent/agent/__init__.py,sha256=U20yKu9QwSqAx_PHk5JwipfODkDfxONtumVfnsKjWFg,180
+pycityagent/agent/agent.py,sha256=CmgjlH4oBJ0elApYXbmEI33sJ_GKh2KS0bFBY0kUgVE,18874
+pycityagent/cli/wrapper.py,sha256=bAwmfWTXbGld-uiMnIMhKp22IVRQjhLUToknyUDk9rQ,1147
+pycityagent/workflow/__init__.py,sha256=H08Ko3eliZvuuCMajbEri-IP4-SeswYU6UjHBNA4Ze0,490
+pycityagent/workflow/prompt.py,sha256=rzenP4EFGxbWE1aq-x2036b6umKvi5cQx2xtWULwgIk,3392
+pycityagent/workflow/block.py,sha256=WJfCeL8e117GzkVPJCRNsQZZinccMnVyEubkwrf-17U,12295
+pycityagent/workflow/trigger.py,sha256=4nzAwywGQsFabgo6gzp-vD2EV4wII7Z0LHGEAsflSEY,7608
+pycityagent/environment/__init__.py,sha256=fFIth2jxxgZ92cXm-aoM2igHgaSqsYGwtBhyb7opjzk,166
+pycityagent/environment/simulator.py,sha256=bZr167qLth2tK8HtQm_L82OdnG2pM5SeP-iA26A7aRo,21259
+pycityagent/environment/utils/port.py,sha256=3OM6kSUt3PxvDUOlgyiendBtETaWU8Mzk_8H0TzTmYg,295
+pycityagent/environment/utils/grpc.py,sha256=_lB4-k4dTKuNvApaDiYgFxiLTPtYG42DVQtG9yOj9pQ,2022
+pycityagent/environment/utils/base64.py,sha256=hoREzQo3FXMN79pqQLO2jgsDEvudciomyKii7MWljAM,374
+pycityagent/environment/utils/__init__.py,sha256=9FoaNGpNmhWehA-iRQ4m9t85AOtPsCg4TTMDzZJ81Qc,239
+pycityagent/environment/utils/map_utils.py,sha256=iNdsvyrknJT_fWo64TMFW3SB7lbLe2H9hF_l-a4eHE4,5761
+pycityagent/environment/utils/protobuf.py,sha256=0BsM_G7x2B_6DMIBHe9bjVuQDOXUytNRQ03g9e05F3c,1170
+pycityagent/environment/utils/geojson.py,sha256=R5GVMvU1Gn6eteG3L10-f1mQ9tvrnGJJAQ2Uh8djTXk,673
+pycityagent/environment/utils/const.py,sha256=1LqxnYJ8FSmq37fN5kIFlWLwycEDzFa8SFS-8plrFlU,5396
+pycityagent/environment/sim/pause_service.py,sha256=UUTa4pTBOX_MGKki9QDgKId7scch0waAWF9xRVmNlAs,1701
+pycityagent/environment/sim/person_service.py,sha256=T1pRi5jDcivSInX7iGZoHKYZmgO7_t5MYtLhU12_LC4,10793
+pycityagent/environment/sim/aoi_service.py,sha256=bYVJDrOfDn8hgOORDU7PxMaT-fpqXA5Z0A080l2EPBc,1242
+pycityagent/environment/sim/sim_env.py,sha256=szkrZtVrm3NXBxLJ2n_ghOhYtTaDUpVak9krjBXgC8Y,4580
+pycityagent/environment/sim/lane_service.py,sha256=bmf0zOWkxDzMEDlhTdHNRJRiTFGgzjbeqmex387gHZs,3964
+pycityagent/environment/sim/client.py,sha256=x4REWPRFG_C2s0-CWz8MnYalD_esfu2pPHf_vpsCG78,2852
+pycityagent/environment/sim/__init__.py,sha256=CyJc5Tey9MgzomZv0ynAcV0yaUlSE3bPbegYXar8wJc,601
+pycityagent/environment/sim/social_service.py,sha256=Y4A56aKXsjSv18UFumGPjQoJVMcM8Z6uTPI_C9D2PZw,2038
+pycityagent/environment/sim/light_service.py,sha256=q4pKcGrm7WU0h29I1dFIDOz2OV0BM-2s37uC6zokkoA,4290
+pycityagent/environment/sim/clock_service.py,sha256=4Hly8CToghj0x_XbDgGrIZy1YYAlDH0EUGCiCDYpk_I,1375
+pycityagent/environment/sim/road_service.py,sha256=Bb1sreO0Knt9tcqH_WJF-I3P3G92bRAlzDBEa--25GE,1297
+pycityagent/cityagent/metrics.py,sha256=yXZ4uRXARjDAvPKyquut7YWs363nDcIV0J1KQgYacZE,2169
+pycityagent/cityagent/memory_config.py,sha256=52QkS_4wtM-PPTM5xR10IPvG00VOlWogFTOP6BqBrYo,11899
+pycityagent/cityagent/bankagent.py,sha256=uL9ATilEddhJR25qW0p8jX6I9QKGm3gDi1wmJNr6Hbg,4036
+pycityagent/cityagent/__init__.py,sha256=gcBQ-a50XegFtjigQ7xDXRBZrywBKqifiQFSRnEF8gM,572
+pycityagent/cityagent/firmagent.py,sha256=x9Yvrd9j0dSILUm__e9dBT7FBgJ0q7VFzbNUC10Vg5A,3677
+pycityagent/cityagent/nbsagent.py,sha256=2021QjPm2JFhDJ0KKNpEZwtTT8GaGyj2zf6KCKHdL3Y,4059
+pycityagent/cityagent/initial.py,sha256=a8ed-vvagYw8tJY-uzYm_sAja2545QRAEa58Tp4DHck,6130
+pycityagent/cityagent/societyagent.py,sha256=2WSXh-eElgigXfDHOh9KoDU2KCmIatwD2D57cZlh0Fs,20253
+pycityagent/cityagent/message_intercept.py,sha256=dyT1G-nMxKb2prhgtyFFHFz593qBrkk5DnHsHvG1OIc,4418
+pycityagent/cityagent/governmentagent.py,sha256=YoydTQ-LMOF5ZbisxG4vQFaFT9ZS0DzDjb3hQg87YzM,2830
+pycityagent/cityagent/blocks/dispatcher.py,sha256=U5BPeUrjrTyDaznYfT6YUJIW8vfKVRDF4EO0oOn6Td4,2886
+pycityagent/cityagent/blocks/needs_block.py,sha256=LwoH-4WcAF5L8IOW2ytf51QeIghq9D9KspQ92s5k4Nk,15897
+pycityagent/cityagent/blocks/cognition_block.py,sha256=5QWhX2vg1VqYYzm-qBITBhVntaaetePQoa7OqvmXJug,15170
+pycityagent/cityagent/blocks/social_block.py,sha256=QwmfVYa0Q0anMTYsJe8IxMRecJCNEpCuTsm9bo27eEM,15439
+pycityagent/cityagent/blocks/__init__.py,sha256=h6si6WBcVVuglIskKQKA8Cxtf_VKen1sNPqOFKI311Q,420
+pycityagent/cityagent/blocks/economy_block.py,sha256=CCF2xPxwAiMy0PhFis11_tjH0NMYwSnbUx9VUNfIbGg,19061
+pycityagent/cityagent/blocks/utils.py,sha256=uu4iQOYKwIT87AqbT5KT4W8p_UI_dZfuXkyxWto_EQ0,2097
+pycityagent/cityagent/blocks/other_block.py,sha256=LdtL6248xvMvvRQx6NvdlJrWWZFu8Xusjxb9yEh1M0k,4365
+pycityagent/cityagent/blocks/plan_block.py,sha256=LcmG7d9oMezq9TiEerFJyUZytZRg5Zf03B7m6aV7HCI,11465
+pycityagent/cityagent/blocks/mobility_block.py,sha256=YmKhJW_srC6b6n_LvJujSO-eB-13G10BhDnURaVVdj8,15290
+pycityagent/survey/models.py,sha256=g3xni4GcA1Py3vlGt6z4ltutjgQ4G0uINYAM8vKRJAw,5225
+pycityagent/survey/__init__.py,sha256=rxwou8U9KeFSP7rMzXtmtp2fVFZxK4Trzi-psx9LPIs,153
+pycityagent/survey/manager.py,sha256=tHkdeq4lTfAHwvgf4-udsXri0z2l6E00rEbvwl7SqRs,3439

pycityagent/environment/interact/interact.py

@@ -1,198 +0,0 @@
-"""环境相关的Interaction定义"""
-
-from enum import Enum
-from typing import Callable, Optional, Any
-from abc import ABC, abstractmethod
-from typing import Callable, Any
-
-
-class ActionType(Enum):
-    """
-    行动类型枚举 所有行动本质上为数据推送
-    Action Type enumeration, all actions are essentially data push
-
-    Types:
-    - Sim = 1, 用于表示与模拟器对接的行动
-    - Hub = 2, 用于表示与AppHub(前端)对接的行动
-    - Comp = 3, 表示综合类型 (可能同时包含与Sim以及Hub的交互)
-    """
-
-    Sim = 1
-    Hub = 2
-    Comp = 3
-
-
-class Action:
-    """
-    - Action
-    """
-
-    def __init__(
-        self,
-        agent,
-        type: ActionType,
-        source: Optional[str] = None,
-        before: Optional[Callable[[list], Any]] = None,
-    ) -> None:
-        """
-        默认初始化
-
-        Args:
-        - agent (Agent): the related agent
-        - type (ActionType)
-        - source (str): 数据来源, 默认为None, 如果为None则会从接收用户传入的数据作为Forward函数参数, 否则从WM.Reason数据缓存中取对应数据作为参数
-        - before (function): 数据处理方法, 用于当Reason缓存中的参数与标准格式不符时使用
-        """
-        self._agent = agent
-        self._type = type
-        self._source = source
-        self._before = before
-
-    def get_source(self):
-        """
-        获取source数据
-        """
-        if self._source != None:
-            source = self._agent.Brain.Memory.Working.Reason[self._source]
-            if self._before != None:
-                source = self._before(source)
-            return source
-        else:
-            return None
-
-    @abstractmethod
-    async def Forward(self):
-        """接口函数"""
-
-
-class SimAction(Action):
-    """SimAction: 模拟器关联Action"""
-
-    def __init__(
-        self,
-        agent,
-        source: Optional[str] = None,
-        before: Optional[Callable[[list], Any]] = None,
-    ) -> None:
-        super().__init__(agent, ActionType.Sim, source, before)
-
-
-class HubAction(Action):
-    """HubAction: Apphub关联Action"""
-
-    def __init__(
-        self,
-        agent,
-        source: Optional[str] = None,
-        before: Optional[Callable[[list], Any]] = None,
-    ) -> None:
-        super().__init__(agent, ActionType.Hub, source, before)
-
-
-class SetSchedule(SimAction):
-    """
-    用于将agent的行程信息同步至模拟器 —— 仅对citizen类型agent适用
-    Synchronize agent's schedule to simulator —— only avalable for citizen type of agent
-    """
-
-    def __init__(
-        self,
-        agent,
-        source: Optional[str] = None,
-        before: Optional[Callable[[list], Any]] = None,
-    ) -> None:
-        super().__init__(agent, source, before)
-
-    async def Forward(self, schedule=None):
-        """
-        如果当前行程已经同步至模拟器: 跳过同步, 否则同步至模拟器
-        If current schedule has been synchronized to simulator: skip, else sync
-        """
-        if not schedule == None:
-            if not schedule.is_set:
-                """同步schedule至模拟器"""
-                self._agent.Scheduler.now.is_set = True
-                departure_time = schedule.time
-                mode = schedule.mode
-                aoi_id = schedule.target_id_aoi
-                poi_id = schedule.target_id_poi
-                end = {"aoi_position": {"aoi_id": aoi_id, "poi_id": poi_id}}
-                activity = schedule.description
-                trips = [
-                    {
-                        "mode": mode,
-                        "end": end,
-                        "departure_time": departure_time,
-                        "activity": activity,
-                    }
-                ]
-                set_schedule = [
-                    {"trips": trips, "loop_count": 1, "departure_time": departure_time}
-                ]
-
-                # * 与模拟器对接
-                req = {"person_id": self._agent._id, "schedules": set_schedule}
-                await self._agent._client.person_service.SetSchedule(req)
-        elif self._source != None:
-            schedule = self.get_source()
-            if schedule != None and not schedule.is_set:
-                """同步schedule至模拟器"""
-                self._agent.Scheduler.now.is_set = True
-                departure_time = schedule.time
-                mode = schedule.mode
-                aoi_id = schedule.target_id_aoi
-                poi_id = schedule.target_id_poi
-                end = {"aoi_position": {"aoi_id": aoi_id, "poi_id": poi_id}}
-                activity = schedule.description
-                trips = [
-                    {
-                        "mode": mode,
-                        "end": end,
-                        "departure_time": departure_time,
-                        "activity": activity,
-                    }
-                ]
-                set_schedule = [
-                    {"trips": trips, "loop_count": 1, "departure_time": departure_time}
-                ]
-
-                # * 与模拟器对接
-                req = {"person_id": self._agent._id, "schedules": set_schedule}
-                await self._agent._client.person_service.SetSchedule(req)
-
-
-class SendAgentMessage(SimAction):
-    """
-    发送信息给其他agent
-    Send messages to other agents
-    """
-
-    def __init__(
-        self,
-        agent,
-        source: Optional[str] = None,
-        before: Optional[Callable[[list], Any]] = None,
-    ) -> None:
-        super().__init__(agent, source, before)
-
-    async def Forward(self, messages: Optional[dict] = None):
-        if not messages == None and len(messages) > 0:
-            req = {"messages": []}
-            for message in messages:
-                from_id = self._agent._id
-                to_id = message["id"]
-                mes = message["message"]
-                req["messages"].append({"from": from_id, "to": to_id, "message": mes})
-            await self._agent._client.social_service.Send(req)
-        elif self._source != None:
-            messages = self.get_source()
-            if not messages == None and len(messages) > 0:
-                req = {"messages": []}
-                for message in messages:
-                    from_id = self._agent._id
-                    to_id = message["id"]
-                    mes = message["message"]
-                    req["messages"].append(
-                        {"from": from_id, "to": to_id, "message": mes}
-                    )
-                await self._agent._client.social_service.Send(req)