fix: circular imports

Author: arthurbrenno

agentle/agents/__init__.py

@@ -1,3 +0,0 @@
-from .agent import Agent
-
-__all__: list[str] = ["Agent"]

agentle/parsing/factories/audio_description_agent_factory.py

@@ -1,10 +1,13 @@
-from agentle.agents.agent import Agent
-from agentle.generations.models.structured_outputs_store.audio_description import (
-    AudioDescription,
-)
-from agentle.generations.providers.google.google_genai_generation_provider import (
-    GoogleGenaiGenerationProvider,
-)
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+
+if TYPE_CHECKING:
+    from agentle.agents.agent import Agent
+    from agentle.generations.models.structured_outputs_store.audio_description import (
+        AudioDescription,
+    )
 
 
 def audio_description_agent_factory() -> Agent[AudioDescription]:
@@ -44,6 +47,14 @@ def audio_description_agent_factory() -> Agent[AudioDescription]:
         print(result.parsed.overall_description)
         ```
     """
+    from agentle.agents.agent import Agent
+    from agentle.generations.models.structured_outputs_store.audio_description import (
+        AudioDescription,
+    )
+    from agentle.generations.providers.google.google_genai_generation_provider import (
+        GoogleGenaiGenerationProvider,
+    )
+
     return Agent(
         model="gemini-2.0-flash",
         instructions="You are a helpful assistant that deeply understands audio files.",

agentle/parsing/factories/file_parser_factory.py

@@ -1,13 +1,20 @@
-from agentle.parsing.parsers.file_parser import FileParser
-from agentle.parsing.factories.visual_description_agent_factory import (
-    visual_description_agent_factory,
-)
-from agentle.parsing.factories.audio_description_agent_factory import (
-    audio_description_agent_factory,
-)
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+
+if TYPE_CHECKING:
+    from agentle.parsing.parsers.file_parser import FileParser
 
 
 def file_parser_factory() -> FileParser:
+    from agentle.parsing.parsers.file_parser import FileParser
+    from agentle.parsing.factories.visual_description_agent_factory import (
+        visual_description_agent_factory,
+    )
+    from agentle.parsing.factories.audio_description_agent_factory import (
+        audio_description_agent_factory,
+    )
+
     return FileParser(
         visual_description_agent=visual_description_agent_factory(),
         audio_description_agent=audio_description_agent_factory(),

agentle/parsing/factories/visual_description_agent_factory.py

@@ -1,10 +1,12 @@
-from agentle.agents.agent import Agent
-from agentle.generations.models.structured_outputs_store.visual_media_description import (
-    VisualMediaDescription,
-)
-from agentle.generations.providers.google.google_genai_generation_provider import (
-    GoogleGenaiGenerationProvider,
-)
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from agentle.agents.agent import Agent
+    from agentle.generations.models.structured_outputs_store.visual_media_description import (
+        VisualMediaDescription,
+    )
 
 
 def visual_description_agent_factory() -> Agent[VisualMediaDescription]:
@@ -46,6 +48,14 @@ def visual_description_agent_factory() -> Agent[VisualMediaDescription]:
         print(result.parsed.ocr_text)
         ```
     """
+    from agentle.agents.agent import Agent
+    from agentle.generations.models.structured_outputs_store.visual_media_description import (
+        VisualMediaDescription,
+    )
+    from agentle.generations.providers.google.google_genai_generation_provider import (
+        GoogleGenaiGenerationProvider,
+    )
+
     return Agent(
         model="gemini-2.0-pro-vision",
         instructions="You are a helpful assistant that deeply understands visual media.",

docs/source/examples.rst

@@ -8,7 +8,7 @@ Example 1: Creating Agents
 
 .. code-block:: python
 
-   from agentle.agents import Agent
+   from agentle.agents.agent import Agent
    
    # Example code for creating and configuring agents