aient 1.1.97__py3-none-any.whl → 1.1.99__py3-none-any.whl

aient/architext/architext/core.py

@@ -35,13 +35,30 @@ class ContentBlock:
 # 2. 上下文提供者 (带缓存)
 class ContextProvider(ABC):
     def __init__(self, name: str):
-        self.name = name; self._cached_content: Optional[str] = None; self._is_stale: bool = True
+        self.name = name
+        self._cached_content: Optional[str] = None
+        self._is_stale: bool = True
+        self._visible: bool = True
 
     def __str__(self):
         # This allows the object to be captured when used inside an f-string.
         return _register_provider(self)
 
     def mark_stale(self): self._is_stale = True
+
+    @property
+    def visible(self) -> bool:
+        """Gets the visibility of the provider."""
+        return self._visible
+
+    @visible.setter
+    def visible(self, value: bool):
+        """Sets the visibility of the provider."""
+        if self._visible != value:
+            self._visible = value
+            # Content needs to be re-evaluated, but the source data hasn't changed,
+            # so just marking it stale is enough for the renderer to reconsider it.
+            self.mark_stale()
     async def refresh(self):
         if self._is_stale:
             self._cached_content = await self.render()
@@ -51,7 +68,8 @@ class ContextProvider(ABC):
     @abstractmethod
     def update(self, *args, **kwargs): raise NotImplementedError
     def get_content_block(self) -> Optional[ContentBlock]:
-        if self._cached_content is not None: return ContentBlock(self.name, self._cached_content)
+        if self.visible and self._cached_content is not None:
+            return ContentBlock(self.name, self._cached_content)
         return None
 
 class Texts(ContextProvider):
@@ -84,7 +102,12 @@ class Texts(ContextProvider):
         self._is_dynamic = callable(self._text)
         self.mark_stale()
 
-    async def render(self) -> Optional[str]:
+    @property
+    def content(self) -> Optional[str]:
+        """
+        Synchronously retrieves the raw text content as a property.
+        If the content is dynamic (a callable), it executes the callable.
+        """
         if self._is_dynamic:
             # Ensure dynamic content returns a string, even if empty
             result = self._text()
@@ -92,6 +115,9 @@ class Texts(ContextProvider):
         # Ensure static content returns a string, even if empty
         return self._text if self._text is not None else ""
 
+    async def render(self) -> Optional[str]:
+        return self.content
+
 class Tools(ContextProvider):
     def __init__(self, tools_json: Optional[List[Dict]] = None, name: str = "tools"):
         super().__init__(name)

aient/architext/test/test.py

@@ -998,6 +998,61 @@ Current time: {Texts(lambda: datetime.now().strftime("%Y-%m-%d %H:%M:%S"))}
         # 验证两次渲染的时间戳不同
         self.assertNotEqual(time1_str_part, time2_str_part, "f-string 中的动态 lambda 内容在两次渲染之间应该更新")
 
+    def test_z6_direct_content_access(self):
+        """测试通过 .content 属性直接访问 Texts 内容"""
+        # 1. 测试静态内容
+        static_text = Texts("Hello, Architext!")
+        self.assertEqual(static_text.content, "Hello, Architext!")
+
+        # 2. 测试动态内容
+        from datetime import datetime
+        current_time_str = datetime.now().isoformat()
+        dynamic_text = Texts(lambda: current_time_str)
+        self.assertEqual(dynamic_text.content, current_time_str)
+
+        # 3. 测试更新后的内容访问
+        static_text.update("Updated content.")
+        self.assertEqual(static_text.content, "Updated content.")
+
+        # 4. 测试 None 和空字符串
+        none_text = Texts(name="none_text") # Provide a name when text is None
+        self.assertEqual(none_text.content, "")
+
+        empty_text = Texts("")
+        self.assertEqual(empty_text.content, "")
+
+    async def test_z7_provider_visibility(self):
+        """测试 provider 的可见性标志是否能正常工作"""
+        # 1. 初始化 provider，visible 默认为 True
+        text_provider = Texts("Hello, World!", name="greeting")
+        self.assertTrue(text_provider.visible)
+
+        messages = Messages(SystemMessage(text_provider))
+
+        # 2. 初始渲染，内容应该可见
+        rendered_visible = await messages.render_latest()
+        self.assertEqual(len(rendered_visible), 1)
+        self.assertEqual(rendered_visible[0]['content'], "Hello, World!")
+
+        # 3. 设置为不可见
+        provider = messages.provider("greeting")
+        provider.visible = False
+        self.assertFalse(provider.visible)
+
+        # 4. 再次渲染，内容应该消失
+        # 因为 visibility 变化会 mark_stale，所以需要 render_latest
+        rendered_invisible = await messages.render_latest()
+        self.assertEqual(len(rendered_invisible), 0, "设置为不可见后，消息应该不被渲染")
+
+        # 5. 再次设置为可见
+        provider.visible = True
+        self.assertTrue(provider.visible)
+
+        # 6. 渲染，内容应该再次出现
+        rendered_visible_again = await messages.render_latest()
+        self.assertEqual(len(rendered_visible_again), 1)
+        self.assertEqual(rendered_visible_again[0]['content'], "Hello, World!")
+
 
 # ==============================================================================
 # 6. 演示

{aient-1.1.97.dist-info → aient-1.1.99.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aient
-Version: 1.1.97
+Version: 1.1.99
 Summary: Aient: The Awakening of Agent.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{aient-1.1.97.dist-info → aient-1.1.99.dist-info}/RECORD

@@ -1,8 +1,8 @@
 aient/__init__.py,sha256=SRfF7oDVlOOAi6nGKiJIUK6B_arqYLO9iSMp-2IZZps,21
 aient/architext/architext/__init__.py,sha256=79Ih1151rfcqZdr7F8HSZSTs_iT2SKd1xCkehMsXeXs,19
-aient/architext/architext/core.py,sha256=-uu6CelQyKJQ7e6xTZWRxnC-yvxeLiIl8siQdXcL8RI,20727
+aient/architext/architext/core.py,sha256=RGUKPrTm0mXrC7FweIkPXRAXCDE1xxU08pZo1n-2tsA,21555
 aient/architext/test/openai_client.py,sha256=Dqtbmubv6vwF8uBqcayG0kbsiO65of7sgU2-DRBi-UM,4590
-aient/architext/test/test.py,sha256=URVDaUfxxPU4yobojJC7SO1cBsM0Hzz96ZW3lYYMWGo,48176
+aient/architext/test/test.py,sha256=CSjXZbY-cgJP1xXY-vA56iM5XXMfwsW2sZQLwAwWS7k,50477
 aient/architext/test/test_save_load.py,sha256=o8DqH6gDYZkFkQy-a7blqLtJTRj5e4a-Lil48pJ0V3g,3260
 aient/core/__init__.py,sha256=NxjebTlku35S4Dzr16rdSqSTWUvvwEeACe8KvHJnjPg,34
 aient/core/log_config.py,sha256=kz2_yJv1p-o3lUQOwA3qh-LSc3wMHv13iCQclw44W9c,274
@@ -35,8 +35,8 @@ aient/plugins/write_file.py,sha256=Jt8fOEwqhYiSWpCbwfAr1xoi_BmFnx3076GMhuL06uI,3
 aient/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 aient/utils/prompt.py,sha256=UcSzKkFE4-h_1b6NofI6xgk3GoleqALRKY8VBaXLjmI,11311
 aient/utils/scripts.py,sha256=VqtK4RFEx7KxkmcqG3lFDS1DxoNlFFGErEjopVcc8IE,40974
-aient-1.1.97.dist-info/licenses/LICENSE,sha256=XNdbcWldt0yaNXXWB_Bakoqnxb3OVhUft4MgMA_71ds,1051
-aient-1.1.97.dist-info/METADATA,sha256=iNrH1fwUGshVwM3UmFmun1CV7qPH61FPl1XpUmMemyo,4842
-aient-1.1.97.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aient-1.1.97.dist-info/top_level.txt,sha256=3oXzrP5sAVvyyqabpeq8A2_vfMtY554r4bVE-OHBrZk,6
-aient-1.1.97.dist-info/RECORD,,
+aient-1.1.99.dist-info/licenses/LICENSE,sha256=XNdbcWldt0yaNXXWB_Bakoqnxb3OVhUft4MgMA_71ds,1051
+aient-1.1.99.dist-info/METADATA,sha256=lUsprSWgvrH42NHm6pTNppqBmiSn7FG1BH2IDEZa4cE,4842
+aient-1.1.99.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aient-1.1.99.dist-info/top_level.txt,sha256=3oXzrP5sAVvyyqabpeq8A2_vfMtY554r4bVE-OHBrZk,6
+aient-1.1.99.dist-info/RECORD,,