fabricatio 0.2.0.dev0__py3-none-any.whl → 0.2.0.dev2__py3-none-any.whl

fabricatio/__init__.py

@@ -1,24 +1,32 @@
 """Fabricatio is a Python library for building llm app using event-based agent structure."""
 
 from fabricatio.core import env
+from fabricatio.fs import magika
 from fabricatio.journal import logger
 from fabricatio.models.action import Action, WorkFlow
 from fabricatio.models.events import Event
 from fabricatio.models.role import Role
 from fabricatio.models.task import Task
 from fabricatio.models.tool import ToolBox
-from fabricatio.models.utils import Messages
-from fabricatio.parser import Capture
+from fabricatio.models.utils import Message, Messages
+from fabricatio.parser import Capture, CodeBlockCapture, JsonCapture, PythonCapture
+from fabricatio.templates import templates_manager
 
 __all__ = [
     "Action",
     "Capture",
+    "CodeBlockCapture",
     "Event",
+    "JsonCapture",
+    "Message",
     "Messages",
+    "PythonCapture",
     "Role",
     "Task",
     "ToolBox",
     "WorkFlow",
     "env",
     "logger",
+    "magika",
+    "templates_manager",
 ]

fabricatio/actions/__init__.py

@@ -1,5 +1,5 @@
 """module for actions."""
 
-from fabricatio.actions.transmission import SendTask
+from fabricatio.actions.transmission import PublishTask
 
-__all__ = ["SendTask"]
+__all__ = ["PublishTask"]

fabricatio/actions/communication.py

@@ -0,0 +1,13 @@
+from fabricatio.models.action import Action
+from fabricatio.models.task import Task
+
+
+class Talk(Action):
+    """Action that says hello to the world."""
+
+    name: str = "talk"
+    output_key: str = "talk_response"
+
+    async def _execute(self, task_input: Task[str], **_) -> str:
+        """Execute the action."""
+        return await self.aask(task_input.briefing, system_message=task_input.generate_prompt())

fabricatio/actions/transmission.py

@@ -2,15 +2,31 @@ from typing import List
 
 from fabricatio.journal import logger
 from fabricatio.models.action import Action
+from fabricatio.models.events import EventLike
 from fabricatio.models.task import Task
 
 
-class SendTask(Action):
-    """Action that sends a task to a user."""
+class PublishTask(Action):
+    """An action that publishes a task to a list of targets."""
 
-    name: str = "send_task"
+    name: str = "publish_task"
+    """The name of the action."""
+    description: str = "Publish a task to a list of targets."
+    """The description of the action."""
 
-    async def _execute(self, send_targets: List[str], send_task: Task, **_) -> None:
+    async def _execute(self, send_targets: List[EventLike], send_task: Task, **_) -> None:
+        """Execute the action by sending the task to the specified targets."""
         logger.info(f"Sending task {send_task.name} to {send_targets}")
         for target in send_targets:
-            await send_task.publish(target)
+            await send_task.move_to(target).publish()
+
+
+class CycleTask(Action):
+    """An action that cycles a task through a list of targets."""
+
+    name: str = "cycle_task"
+    """The name of the action."""
+    description: str = "Cycle a task through a list of targets"
+
+    async def _execute(self, task_input: Task, **_) -> None:
+        """Execute the action by cycling the task through the specified targets."""

fabricatio/bin/template_download.py

@@ -0,0 +1,92 @@
+import shutil
+import subprocess
+import tarfile
+from pathlib import Path
+
+import requests
+import typer
+
+app = typer.Typer()
+
+
+def download_file(url: str, destination: Path) -> None:
+    """Download a file from a given URL to a specified destination.
+
+    Args:
+        url (str): The URL of the file to download.
+        destination (Path): The path where the file should be saved.
+
+    Raises:
+        requests.exceptions.HTTPError: If the request to the URL fails.
+    """
+    response = requests.get(url, stream=True, timeout=120)
+    response.raise_for_status()
+    with destination.open("wb") as f:
+        for chunk in response.iter_content(chunk_size=8192):
+            f.write(chunk)
+
+
+def extract_tar_gz(file_path: Path, extract_to: Path) -> None:
+    """Extract a tar.gz file to a specified directory.
+
+    Args:
+        file_path (Path): The path to the tar.gz file.
+        extract_to (Path): The directory where the contents should be extracted.
+    """
+    with tarfile.open(file_path, "r:gz") as tar:
+        tar.extractall(path=extract_to, filter="data")
+
+
+def extract_with_7z(file_path: Path, extract_to: Path) -> None:
+    """Extract a file using the 7z command-line tool.
+
+    Args:
+        file_path (Path): The path to the file to extract.
+        extract_to (Path): The directory where the contents should be extracted.
+
+    Raises:
+        subprocess.CalledProcessError: If the 7z command fails.
+    """
+    subprocess.run(["7z", "x", file_path, f"-o{extract_to}"], check=True)
+
+
+@app.command()
+def download_and_extract(output_dir: str = typer.Argument(..., help="Directory to extract the templates to")) -> None:
+    """Download and extract the templates.tar.gz file from the latest release of the fabricatio GitHub repository.
+
+    Args:
+        output_dir (str): The directory where the templates should be extracted.
+
+    Raises:
+        typer.Exit: If the templates.tar.gz file is not found or extraction fails.
+    """
+    repo_url = "https://api.github.com/repos/Whth/fabricatio/releases/latest"
+    response = requests.get(repo_url, timeout=30)
+    response.raise_for_status()
+    latest_release = response.json()
+    assets = latest_release.get("assets", [])
+    tar_gz_asset = next((asset for asset in assets if asset["name"] == "templates.tar.gz"), None)
+
+    if not tar_gz_asset:
+        typer.echo("templates.tar.gz not found in the latest release.")
+        raise typer.Exit(code=1)
+
+    download_url = tar_gz_asset["browser_download_url"]
+    output_path = Path(output_dir)  # Convert output_dir to Path object
+    tar_gz_path = output_path.joinpath("templates.tar.gz")  # Use joinpath instead of os.path.join
+
+    download_file(download_url, tar_gz_path)  # Directly use Path object
+    typer.echo(f"Downloaded {download_url} to {tar_gz_path}")
+
+    try:
+        if shutil.which("7z"):
+            extract_with_7z(tar_gz_path, output_path)  # Directly use Path objects
+        elif shutil.which("tar"):
+            extract_tar_gz(tar_gz_path, output_path)  # Directly use Path objects
+        else:
+            typer.echo("Neither 7z nor tar is available for extraction.")
+            raise typer.Exit(code=1)
+        typer.echo(f"Extracted templates to {output_dir}")
+    except RuntimeError as e:
+        typer.echo(f"Extraction failed: {e}")
+        raise typer.Exit(code=1) from e

fabricatio/config.py

@@ -1,3 +1,4 @@
+from pathlib import Path
 from typing import List, Literal, Optional
 
 from appdirs import user_config_dir
@@ -119,10 +120,13 @@ class Code2PromptConfig(BaseModel):
 
     model_config = ConfigDict(use_attribute_docstrings=True)
     template_dir: List[DirectoryPath] = Field(
-        default_factory=lambda: [r".\c2p_templates", rf"{ROAMING_DIR}\c2p_templates"]
+        default_factory=lambda: [Path(r".\templates"), Path(rf"{ROAMING_DIR}\templates")]
     )
     """The directory containing the templates for code2prompt."""
 
+    template_suffix: str = Field(default=".hbs", frozen=True)
+    """The suffix of the template files for code2prompt."""
+
 
 class MagikaConfig(BaseModel):
     """Magika configuration class."""

fabricatio/fs/__init__.py

@@ -0,0 +1,5 @@
+"""FileSystem manipulation module for Fabricatio."""
+
+from fabricatio.fs.readers import magika
+
+__all__ = ["magika"]

fabricatio/models/action.py

@@ -1,20 +1,22 @@
 import traceback
 from abc import abstractmethod
 from asyncio import Queue
-from typing import Any, Dict, Tuple, Type, Unpack
+from typing import Any, Dict, Self, Tuple, Type, Unpack
 
 from pydantic import Field, PrivateAttr
 
 from fabricatio.journal import logger
 from fabricatio.models.generic import LLMUsage, WithBriefing
-from fabricatio.models.task import Task
+from fabricatio.models.task import ProposeTask, Task
 
 
-class Action(WithBriefing, LLMUsage):
+class Action(ProposeTask):
     """Class that represents an action to be executed in a workflow."""
 
+    personality: str = Field(default="")
+    """The personality of whom the action belongs to."""
     output_key: str = Field(default="")
-    """ The key of the output data."""
+    """The key of the output data."""
 
     @abstractmethod
     async def _execute(self, **cxt: Unpack) -> Any:
@@ -40,21 +42,30 @@ class Action(WithBriefing, LLMUsage):
             cxt[self.output_key] = ret
         return cxt
 
+    def briefing(self) -> str:
+        """Return a brief description of the action."""
+        if self.personality:
+            return f"## Your personality: \n{self.personality}\n# The action you are going to perform: \n{super().briefing}"
+        return f"# The action you are going to perform: \n{super().briefing}"
 
-class WorkFlow(WithBriefing, LLMUsage):
+
+class WorkFlow[A: Type[Action] | Action](WithBriefing, LLMUsage):
     """Class that represents a workflow to be executed in a task."""
 
     _context: Queue[Dict[str, Any]] = PrivateAttr(default_factory=lambda: Queue(maxsize=1))
     """ The context dictionary to be used for workflow execution."""
 
     _instances: Tuple[Action, ...] = PrivateAttr(...)
+    """ The instances of the workflow steps."""
 
-    steps: Tuple[Type[Action], ...] = Field(...)
-    """ The steps to be executed in the workflow."""
+    steps: Tuple[A, ...] = Field(...)
+    """ The steps to be executed in the workflow, actions or action classes."""
     task_input_key: str = Field(default="task_input")
     """ The key of the task input data."""
     task_output_key: str = Field(default="task_output")
     """ The key of the task output data."""
+    extra_init_context: Dict[str, Any] = Field(default_factory=dict, frozen=True)
+    """ The extra context dictionary to be used for workflow initialization."""
 
     def model_post_init(self, __context: Any) -> None:
         """Initialize the workflow by setting fallbacks for each step.
@@ -62,9 +73,24 @@ class WorkFlow(WithBriefing, LLMUsage):
         Args:
             __context: The context to be used for initialization.
         """
-        self._instances = tuple(step() for step in self.steps)
-        for step in self._instances:
-            step.fallback_to(self)
+        temp = []
+        for step in self.steps:
+            temp.append(step if isinstance(step, Action) else step())
+        self._instances = tuple(temp)
+
+    def inject_personality(self, personality: str) -> Self:
+        """Inject the personality of the workflow.
+
+        Args:
+            personality: The personality to be injected.
+
+        Returns:
+            Self: The instance of the workflow with the injected personality.
+        """
+        for a in self._instances:
+            if not a.personality:
+                a.personality = personality
+        return self
 
     async def serve(self, task: Task) -> None:
         """Serve the task by executing the workflow steps.
@@ -73,13 +99,13 @@ class WorkFlow(WithBriefing, LLMUsage):
             task: The task to be served.
         """
         await task.start()
-        await self._context.put({self.task_input_key: task})
+        await self._init_context()
         current_action = None
         try:
             for step in self._instances:
                 logger.debug(f"Executing step: {step.name}")
-                ctx = await self._context.get()
-                modified_ctx = await step.act(ctx)
+                cxt = await self._context.get()
+                modified_ctx = await step.act(cxt)
                 await self._context.put(modified_ctx)
                 current_action = step.name
             logger.info(f"Finished executing workflow: {self.name}")
@@ -88,3 +114,14 @@ class WorkFlow(WithBriefing, LLMUsage):
             logger.error(f"Error during task: {current_action} execution: {e}")  # Log the exception
             logger.error(traceback.format_exc())  # Add this line to log the traceback
             await task.fail()  # Mark the task as failed
+
+    async def _init_context(self) -> None:
+        """Initialize the context dictionary for workflow execution."""
+        logger.debug(f"Initializing context for workflow: {self.name}")
+        await self._context.put({self.task_input_key: None, **dict(self.extra_init_context)})
+
+    def fallback_to_self(self) -> Self:
+        """Set the fallback for each step to the workflow itself."""
+        for step in self._instances:
+            step.fallback_to(self)
+        return self

fabricatio/models/role.py

@@ -1,17 +1,15 @@
 from typing import Any
 
-from pydantic import Field, ValidationError
+from pydantic import Field
 
 from fabricatio.core import env
 from fabricatio.journal import logger
 from fabricatio.models.action import WorkFlow
 from fabricatio.models.events import Event
-from fabricatio.models.generic import LLMUsage, Memorable, WithBriefing, WithToDo
-from fabricatio.models.task import Task
-from fabricatio.parser import JsonCapture
+from fabricatio.models.task import ProposeTask
 
 
-class Role(Memorable, WithBriefing, WithToDo, LLMUsage):
+class Role(ProposeTask):
     """Class that represents a role with a registry of events and workflows."""
 
     registry: dict[Event | str, WorkFlow] = Field(...)
@@ -20,31 +18,8 @@ class Role(Memorable, WithBriefing, WithToDo, LLMUsage):
     def model_post_init(self, __context: Any) -> None:
         """Register the workflows in the role to the event bus."""
         for event, workflow in self.registry.items():
-            workflow.fallback_to(self)
+            workflow.fallback_to(self).fallback_to_self().inject_personality(self.briefing)
             logger.debug(
                 f"Registering workflow: {workflow.name} for event: {event.collapse() if isinstance(event, Event) else event}"
             )
             env.on(event, workflow.serve)
-
-    async def propose(self, prompt: str) -> Task:
-        """Propose a task based on the provided prompt."""
-        assert prompt, "Prompt must be provided."
-
-        def _validate_json(response: str) -> None | Task:
-            try:
-                cap = JsonCapture.capture(response)
-                logger.debug(f"Response: \n{response}")
-                logger.info(f"Captured JSON: \n{cap[0]}")
-                return Task.model_validate_json(cap[0] if cap else response)
-            except ValidationError as e:
-                logger.error(f"Failed to parse task from JSON: {e}")
-                return None
-
-        return await self.aask_validate(
-            f"{prompt} \n\nBased on requirement above, "
-            f"you need to construct a task to satisfy that requirement in JSON format "
-            f"written like this: \n\n```json\n{Task.json_example()}\n```\n\n"
-            f"No extra explanation needed. ",
-            _validate_json,
-            system_message=f"# your personal briefing: \n{self.briefing}",
-        )

fabricatio/models/task.py

@@ -7,12 +7,13 @@ from asyncio import Queue
 from enum import Enum
 from typing import Any, List, Optional, Self
 
-from pydantic import Field, PrivateAttr
+from pydantic import Field, PrivateAttr, ValidationError
 
 from fabricatio.core import env
 from fabricatio.journal import logger
-from fabricatio.models.events import Event
-from fabricatio.models.generic import WithBriefing, WithDependency, WithJsonExample
+from fabricatio.models.events import Event, EventLike
+from fabricatio.models.generic import LLMUsage, WithBriefing, WithDependency, WithJsonExample
+from fabricatio.parser import JsonCapture
 
 
 class TaskStatus(Enum):
@@ -69,7 +70,7 @@ class Task[T](WithBriefing, WithJsonExample, WithDependency):
         """Initialize the task with a namespace event."""
         self._namespace.segments.extend(self.namespace)
 
-    def move_to(self, new_namespace: List[str]) -> Self:
+    def move_to(self, new_namespace: EventLike) -> Self:
         """Move the task to a new namespace.
 
         Args:
@@ -254,3 +255,30 @@ class Task[T](WithBriefing, WithJsonExample, WithDependency):
             str: The briefing of the task.
         """
         return f"{super().briefing}\n{self.goal}"
+
+
+class ProposeTask(LLMUsage, WithBriefing):
+    """A class that proposes a task based on a prompt."""
+
+    async def propose(self, prompt: str) -> Task:
+        """Propose a task based on the provided prompt."""
+        assert prompt, "Prompt must be provided."
+
+        def _validate_json(response: str) -> None | Task:
+            try:
+                cap = JsonCapture.capture(response)
+                logger.debug(f"Response: \n{response}")
+                logger.info(f"Captured JSON: \n{cap[0]}")
+                return Task.model_validate_json(cap[0] if cap else response)
+            except ValidationError as e:
+                logger.error(f"Failed to parse task from JSON: {e}")
+                return None
+
+        return await self.aask_validate(
+            f"{prompt} \n\nBased on requirement above, "
+            f"you need to construct a task to satisfy that requirement in JSON format "
+            f"written like this: \n\n```json\n{Task.json_example()}\n```\n\n"
+            f"No extra explanation needed. ",
+            _validate_json,
+            system_message=f"# your personal briefing: \n{self.briefing}",
+        )

fabricatio/models/tool.py

@@ -24,7 +24,7 @@ class Tool[**P, R](WithBriefing):
         assert self.name, "The tool must have a name."
         self.description = self.description or self.source.__doc__ or ""
 
-    def __call__(self, *args: P.args, **kwargs: P.kwargs) -> R:
+    def invoke(self, *args: P.args, **kwargs: P.kwargs) -> R:
         """Invoke the tool's source function with the provided arguments."""
         return self.source(*args, **kwargs)
 
@@ -82,20 +82,18 @@ class ToolBox(WithBriefing):
         toc = f"## {self.name}: {self.description}\n## {len(self.tools)} tools available:"
         return f"{toc}\n\n{list_out}"
 
-    def invoke_tool[**P, R](self, name: str, *args: P.args, **kwargs: P.kwargs) -> R:
+    def get[**P, R](self, name: str) -> Tool[P, R]:
         """Invoke a tool by name with the provided arguments.
 
         Args:
             name (str): The name of the tool to invoke.
-            *args (P.args): Positional arguments to pass to the tool.
-            **kwargs (P.kwargs): Keyword arguments to pass to the tool.
 
         Returns:
-            R: The result of the tool's execution.
+            Tool: The tool instance with the specified name.
 
         Raises:
             AssertionError: If no tool with the specified name is found.
         """
         tool = next((tool for tool in self.tools if tool.name == name), None)
         assert tool, f"No tool named {name} found."
-        return tool(*args, **kwargs)
+        return tool

fabricatio/templates.py

@@ -0,0 +1,39 @@
+from typing import Any, Dict, List, Self
+
+from pydantic import BaseModel, ConfigDict, DirectoryPath, Field, FilePath, PrivateAttr
+
+from fabricatio.config import configs
+from fabricatio.journal import logger
+
+
+class TemplateManager(BaseModel):
+    """A class that manages templates for code generation."""
+
+    model_config = ConfigDict(use_attribute_docstrings=True)
+    templates_dir: List[DirectoryPath] = Field(default_factory=lambda: list(configs.code2prompt.template_dir))
+    """The directories containing the templates. first element has the highest override priority."""
+    _discovered_templates: Dict[str, FilePath] = PrivateAttr(default_factory=dict)
+
+    def model_post_init(self, __context: Any) -> None:
+        """Post-initialization method for the model."""
+        self.discover_templates()
+
+    def discover_templates(self) -> Self:
+        """Discover the templates in the template directories."""
+        discovered = [
+            f
+            for d in self.templates_dir[::-1]
+            for f in d.rglob(f"*{configs.code2prompt.template_suffix}", case_sensitive=False)
+            if f.is_file()
+        ]
+
+        self._discovered_templates = {f.stem: f for f in discovered}
+        logger.info(f"Discovered {len(self._discovered_templates)} templates.")
+        return self
+
+    def get_template(self, name: str) -> FilePath | None:
+        """Get the template with the specified name."""
+        return self._discovered_templates.get(name, None)
+
+
+templates_manager = TemplateManager()

{fabricatio-0.2.0.dev0.dist-info → fabricatio-0.2.0.dev2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fabricatio
-Version: 0.2.0.dev0
+Version: 0.2.0.dev2
 Summary: A LLM multi-agent framework.
 Author-email: Whth <zettainspector@foxmail.com>
 License: MIT License
@@ -43,18 +43,61 @@ Requires-Dist: litellm>=1.60.0
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: magika>=0.5.1
 Requires-Dist: orjson>=3.10.15
+Requires-Dist: pybars3>=0.9.7
 Requires-Dist: pydantic-settings>=2.7.1
 Requires-Dist: pydantic>=2.10.6
 Requires-Dist: pymitter>=1.0.0
 Requires-Dist: questionary>=2.1.0
 Requires-Dist: regex>=2024.11.6
 Requires-Dist: rich>=13.9.4
+Requires-Dist: typer>=0.15.1
 Description-Content-Type: text/markdown
 
+# Fabricatio
+
+---
+
+Fabricatio is a powerful framework designed to facilitate the creation and management of tasks, actions, and workflows. It leverages modern Python features and libraries to provide a robust and flexible environment for building applications that require task automation and orchestration.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+    - [Defining a Task](#defining-a-task)
+    - [Creating an Action](#creating-an-action)
+    - [Assigning a Role](#assigning-a-role)
+    - [Logging](#logging)
+- [Configuration](#configuration)
+    - [LLM Configuration](#llm-configuration)
+    - [Debug Configuration](#debug-configuration)
+- [Examples](#examples)
+    - [Simple Task Example](#simple-task-example)
+    - [Complex Workflow Example](#complex-workflow-example)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Installation
+To install Fabricatio, you can use pip:
+
+```bash
+pip install fabricatio
+```
+
+Alternatively, you can clone the repository and install it manually:
+
+```bash
+git clone https://github.com/your-repo/fabricatio.git
+cd fabricatio
+pip install .
+```
+
+
 ## Usage
 
 ### Defining a Task
 
+A task in Fabricatio is defined using the `Task` class. You can specify the name, goal, and description of the task.
+
 ```python
 from fabricatio.models.task import Task
 
@@ -64,12 +107,14 @@ task = Task(name="say hello", goal="say hello", description="say hello to the wo
 
 ### Creating an Action
 
+Actions are the building blocks of workflows. They perform specific tasks and can be asynchronous.
+
 ```python
 from fabricatio import Action, logger
 from fabricatio.models.task import Task
 
 class Talk(Action):
-    async def _execute(self, task_input: Task[str], **_) -> Any:
+    async def _execute(self, task_input: Task[str], **_) -> str:
         ret = "Hello fabricatio!"
         logger.info("executing talk action")
         return ret
@@ -78,6 +123,8 @@ class Talk(Action):
 
 ### Assigning a Role
 
+Roles in Fabricatio are responsible for executing workflows. You can define a role with a set of actions.
+
 ```python
 from fabricatio.models.role import Role
 from fabricatio.models.action import WorkFlow
@@ -104,19 +151,91 @@ debug_config = DebugConfig(log_level="DEBUG", log_file="fabricatio.log")
 
 Fabricatio uses Pydantic for configuration management. You can define your settings in the `config.py` file.
 
+### LLM Configuration
+
+The Large Language Model (LLM) configuration is managed by the `LLMConfig` class.
+
 ```python
-from fabricatio.config import Settings
+from fabricatio.config import LLMConfig
 
-settings = Settings(llm=LLMConfig(api_endpoint="https://api.example.com"))
+llm_config = LLMConfig(api_endpoint="https://api.example.com")
 ```
 
 
-## Testing
+### Debug Configuration
 
-Fabricatio includes a set of tests to ensure the framework works as expected. You can run the tests using `pytest`.
+The debug configuration is managed by the `DebugConfig` class.
 
-```bash
-pytest
+```python
+from fabricatio.config import DebugConfig
+
+debug_config = DebugConfig(log_level="DEBUG", log_file="fabricatio.log")
+```
+
+
+## Examples
+
+### Simple Task Example
+
+Here is a simple example of a task that prints "Hello fabricatio!".
+
+```python
+import asyncio
+from fabricatio import Action, Role, Task, WorkFlow, logger
+
+task = Task(name="say hello", goal="say hello", description="say hello to the world")
+
+class Talk(Action):
+    async def _execute(self, task_input: Task[str], **_) -> Any:
+        ret = "Hello fabricatio!"
+        logger.info("executing talk action")
+        return ret
+
+class TestWorkflow(WorkFlow):
+    pass
+
+role = Role(name="Test Role", actions=[TestWorkflow()])
+
+async def main() -> None:
+    await role.act(task)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+
+### Complex Workflow Example
+
+Here is a more complex example that demonstrates how to create a workflow with multiple actions.
+
+```python
+import asyncio
+from fabricatio import Action, Role, Task, WorkFlow, logger
+
+task = Task(name="complex task", goal="perform complex operations", description="a task with multiple actions")
+
+class ActionOne(Action):
+    async def _execute(self, task_input: Task[str], **_) -> Any:
+        ret = "Action One executed"
+        logger.info(ret)
+        return ret
+
+class ActionTwo(Action):
+    async def _execute(self, task_input: Task[str], **_) -> Any:
+        ret = "Action Two executed"
+        logger.info(ret)
+        return ret
+
+class ComplexWorkflow(WorkFlow):
+    actions = [ActionOne(), ActionTwo()]
+
+role = Role(name="Complex Role", actions=[ComplexWorkflow()])
+
+async def main() -> None:
+    await role.act(task)
+
+if __name__ == "__main__":
+    asyncio.run(main())
 ```
 
 

fabricatio-0.2.0.dev2.dist-info/RECORD

@@ -0,0 +1,28 @@
+fabricatio/__init__.py,sha256=eznZiLDVe3pw0NwX36Rari-DK0zxDTpa_wwAmWGnto8,909
+fabricatio/config.py,sha256=61wo7pingdp8vaxzI78QLSLWtuTdMbsa0FgOTJbnnZM,7979
+fabricatio/core.py,sha256=B6KBIfBRF023HF0UUaUprEkQd6sT7G_pexGXQ9btJnE,5788
+fabricatio/decorators.py,sha256=Qsyb-_cDwtXY5yhyLrYZEAlrHh5ZuEooQ8vEOUAxj8k,1855
+fabricatio/journal.py,sha256=CW9HePtgTiboOyPTExq9GjG5BseZcbc-S6lxDXrpmv0,667
+fabricatio/parser.py,sha256=6PNFNNyHNkNG7vTS1ejFc4vCzl1OCy4bqB0e4Ty_-Qs,2365
+fabricatio/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fabricatio/templates.py,sha256=7HnWGp2a_Z4ILBHb0Hxh0sOBs8fVD8V6wsnb_OIkYww,1553
+fabricatio/actions/__init__.py,sha256=eFmFVPQvtNgFynIXBVr3eP-vWQDWCPng60YY5LXvZgg,115
+fabricatio/actions/communication.py,sha256=tmsr3H_w-V-b2WxLEyWByGuwSCLgHIHTdHYAgHrdUxc,425
+fabricatio/actions/transmission.py,sha256=PedZ6XsflKdT5ikzaqWr_6h8jci0kekAHfwygzKBUns,1188
+fabricatio/bin/template_download.py,sha256=JcertOKBIHHorXrQURdqH2wgy2LLzqps5ADp7QbYNgc,3415
+fabricatio/fs/__init__.py,sha256=lWcKYg0v3mv2LnnSegOQaTtlVDODU0vtw_s6iKU5IqQ,122
+fabricatio/fs/readers.py,sha256=mw0VUH3P7Wk0SMlcQm2yOfjEz5C3mQ_kjduAjecaxgY,123
+fabricatio/models/action.py,sha256=M5EfKRJr6puUeKPMm8SGxtKIQWcDcR6dZYs1VTN0ihw,4977
+fabricatio/models/events.py,sha256=pW3sfxEFWTafbP4bn4hVFSe8qloYrrzOgi9oMCqAEgw,2604
+fabricatio/models/generic.py,sha256=noHow8dUjMnNiasl2ZHaZeCMpxzDme9QvxTetoyB45w,19539
+fabricatio/models/role.py,sha256=PM4yBMkHIjYVGsUKlWFbKSOUnhJ8pMXSBySG3Ub4e60,972
+fabricatio/models/task.py,sha256=VPK7ey5AFTeH_Ufr-qwDXEhdwA6GRfBElLIiVH6azDA,9431
+fabricatio/models/tool.py,sha256=1hxDvE92uiWCaxrb0c81EGCkNrt8Ce_V9JDBz7b3qVo,3349
+fabricatio/models/utils.py,sha256=2mgXla9_K3dnRrz6hIKzmltTYPmvDk0MBjjEBkCXTdg,2474
+fabricatio/toolboxes/__init__.py,sha256=bjefmPd7wBaWhbZzdMPXvrjMTeRzlUh_Dev2PUAc124,158
+fabricatio/toolboxes/task.py,sha256=xgyPetm2R_HlQwpzE8YPnBN7QOYLd0-T8E6QPZG1PPQ,204
+fabricatio-0.2.0.dev2.dist-info/METADATA,sha256=7sQ65HU4g26s-Vd1dXOUTQ0bygyZPU9eLTsfgOs1jZc,7113
+fabricatio-0.2.0.dev2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fabricatio-0.2.0.dev2.dist-info/entry_points.txt,sha256=qfO9AWRzHvppZwBQ9LKc88-Y9jf2o_0rqEEnM7daM-8,84
+fabricatio-0.2.0.dev2.dist-info/licenses/LICENSE,sha256=do7J7EiCGbq0QPbMAL_FqLYufXpHnCnXBOuqVPwSV8Y,1088
+fabricatio-0.2.0.dev2.dist-info/RECORD,,

fabricatio-0.2.0.dev2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+templates = fabricatio.bin.template_download:download_and_extract

fabricatio-0.2.0.dev0.dist-info/RECORD

@@ -1,24 +0,0 @@
-fabricatio/__init__.py,sha256=nFPtohqceECRYzU-WlVT6o4oSaKN0vGok-w9JIaiJfs,644
-fabricatio/config.py,sha256=emkIpaXRQykAX_C2ND8tKR2DQUJJEN0mvdMDTklwOXw,7823
-fabricatio/core.py,sha256=B6KBIfBRF023HF0UUaUprEkQd6sT7G_pexGXQ9btJnE,5788
-fabricatio/decorators.py,sha256=Qsyb-_cDwtXY5yhyLrYZEAlrHh5ZuEooQ8vEOUAxj8k,1855
-fabricatio/journal.py,sha256=CW9HePtgTiboOyPTExq9GjG5BseZcbc-S6lxDXrpmv0,667
-fabricatio/parser.py,sha256=6PNFNNyHNkNG7vTS1ejFc4vCzl1OCy4bqB0e4Ty_-Qs,2365
-fabricatio/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-fabricatio/actions/__init__.py,sha256=n3lwq9FPNtvfLu2L1pX4UkwiPITU7luk-b4aMJyjIC8,109
-fabricatio/actions/transmission.py,sha256=Azog4ItVk7aASdYzTwzyckzYG2hDFSXctnA7qp-Qlq0,502
-fabricatio/fs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-fabricatio/fs/readers.py,sha256=mw0VUH3P7Wk0SMlcQm2yOfjEz5C3mQ_kjduAjecaxgY,123
-fabricatio/models/action.py,sha256=M-12dc-nQiNJU6Y9j-dr4Ef3642vRvzHlzxekBepzaU,3358
-fabricatio/models/events.py,sha256=pW3sfxEFWTafbP4bn4hVFSe8qloYrrzOgi9oMCqAEgw,2604
-fabricatio/models/generic.py,sha256=noHow8dUjMnNiasl2ZHaZeCMpxzDme9QvxTetoyB45w,19539
-fabricatio/models/role.py,sha256=jdabuYRXwgvpYoNwvazygDiZHGGQApUIIKltniu78O8,2151
-fabricatio/models/task.py,sha256=Qc16UeeTMaFjG2-sXafyOrjOS7H_0RluE9sFNwArDlI,8179
-fabricatio/models/tool.py,sha256=UkEp1Nzbl5wZX21q_Z2VkpiJmVDSdoGDzINQniO8hSY,3536
-fabricatio/models/utils.py,sha256=2mgXla9_K3dnRrz6hIKzmltTYPmvDk0MBjjEBkCXTdg,2474
-fabricatio/toolboxes/__init__.py,sha256=bjefmPd7wBaWhbZzdMPXvrjMTeRzlUh_Dev2PUAc124,158
-fabricatio/toolboxes/task.py,sha256=xgyPetm2R_HlQwpzE8YPnBN7QOYLd0-T8E6QPZG1PPQ,204
-fabricatio-0.2.0.dev0.dist-info/METADATA,sha256=keLz2I0t_VqaU0Xx5rgSIW66aZqSeJLKIsi9Vjw89vc,3858
-fabricatio-0.2.0.dev0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fabricatio-0.2.0.dev0.dist-info/licenses/LICENSE,sha256=do7J7EiCGbq0QPbMAL_FqLYufXpHnCnXBOuqVPwSV8Y,1088
-fabricatio-0.2.0.dev0.dist-info/RECORD,,