fabricatio 0.2.4.dev0__tar.gz → 0.2.4.dev2__tar.gz

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fabricatio
-Version: 0.2.4.dev0
+Version: 0.2.4.dev2
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: 3.12

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/examples/extract_article/extract.py

@@ -1,8 +1,9 @@
 """Example of proposing a task to a role."""
 
 import asyncio
+from typing import List
 
-from fabricatio import Event, ExtractArticleEssence, Role, WorkFlow, logger
+from fabricatio import ArticleEssence, Event, ExtractArticleEssence, Role, Task, WorkFlow, logger
 
 
 async def main() -> None:
@@ -17,9 +18,11 @@ async def main() -> None:
             )
         },
     )
-    task = await role.propose_task("Extract the essence of the article from the file at './7.md'")
-    ess = await task.delegate("article")
-    logger.success(f"Essence:\n{ess}")
+    task: Task[List[ArticleEssence]] = await role.propose_task(
+        "Extract the essence of the article from the file at './7.md'"
+    )
+    ess = (await task.delegate("article")).pop()
+    logger.success(f"Essence:\n{ess.display()}")
 
 
 if __name__ == "__main__":

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/examples/llm_usages/llm_usage.py

@@ -11,7 +11,6 @@ from fabricatio.parser import PythonCapture
 class WriteCode(Action):
     """Action that says hello to the world."""
 
-    name: str = "write code"
     output_key: str = "task_output"
 
     async def _execute(self, task_input: Task[str], **_) -> str:
@@ -22,10 +21,8 @@ class WriteCode(Action):
 
 
 class WriteDocumentation(Action):
-    """Action that says hello to the world."""
+    """write documentation for the code in markdown format."""
 
-    name: str = "write documentation"
-    description: str = "write documentation for the code in markdown format"
     output_key: str = "task_output"
 
     async def _execute(self, task_input: Task[str], **_) -> str:
@@ -38,12 +35,8 @@ async def main() -> None:
         name="Coder",
         description="A python coder who can write code and documentation",
         registry={
-            Event.instantiate_from("coding").push_wildcard().push("pending"): WorkFlow(
-                name="write code", steps=(WriteCode,)
-            ),
-            Event.instantiate_from("doc").push_wildcard().push("pending"): WorkFlow(
-                name="write documentation", steps=(WriteDocumentation,)
-            ),
+            Event.quick_instantiate("coding"): WorkFlow(name="write code", steps=(WriteCode,)),
+            Event.quick_instantiate("doc"): WorkFlow(name="write documentation", steps=(WriteDocumentation,)),
         },
     )
 

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/examples/make_a_rating/rating.py

@@ -12,7 +12,6 @@ from fabricatio.models.task import Task
 class Rate(Action):
     """Rate the task."""
 
-    name: str = "rate"
     output_key: str = "task_output"
 
     async def _execute(self, to_rate: List[str], rate_topic: str, criteria: Set[str], **_) -> List[Dict[str, float]]:
@@ -28,8 +27,6 @@ class Rate(Action):
 class WhatToRate(Action):
     """Figure out what to rate."""
 
-    name: str = "figure out what to rate"
-
     output_key: str = "to_rate"
 
     async def _execute(self, task_input: Task, rate_topic: str, **cxt: Unpack) -> List[str]:
@@ -55,7 +52,6 @@ class WhatToRate(Action):
 class MakeCriteria(Action):
     """Make criteria for rating."""
 
-    name: str = "make criteria"
     output_key: str = "criteria"
 
     async def _execute(self, rate_topic: str, to_rate: List[str], **cxt: Unpack) -> Set[str]:
@@ -67,8 +63,6 @@ class MakeCriteria(Action):
 class MakeCompositeScore(Action):
     """Make a composite score."""
 
-    name: str = "make composite score"
-
     output_key: str = "task_output"
 
     async def _execute(self, rate_topic: str, to_rate: List[str], **cxt: Unpack) -> List[float]:
@@ -84,7 +78,7 @@ async def main() -> None:
         name="TaskRater",
         description="A role that can rate tasks.",
         registry={
-            Event.instantiate_from("rate_food").push_wildcard().push("pending"): WorkFlow(
+            Event.quick_instantiate("rate_food"): WorkFlow(
                 name="Rate food",
                 steps=(WhatToRate, Rate),
                 extra_init_context={
@@ -92,14 +86,14 @@ async def main() -> None:
                     "criteria": {"taste", "price", "quality", "safety", "healthiness"},
                 },
             ),
-            Event.instantiate_from("make_criteria_for_food").push_wildcard().push("pending"): WorkFlow(
+            Event.quick_instantiate("make_criteria_for_food"): WorkFlow(
                 name="Make criteria for food",
                 steps=(WhatToRate, MakeCriteria, Rate),
                 extra_init_context={
                     "rate_topic": "if the food is 'good'",
                 },
             ),
-            Event.instantiate_from("make_composite_score").push_wildcard().push("pending"): WorkFlow(
+            Event.quick_instantiate("make_composite_score"): WorkFlow(
                 name="Make composite score",
                 steps=(WhatToRate, MakeCompositeScore),
                 extra_init_context={

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/examples/make_diary/diary.py

@@ -13,8 +13,6 @@ from pydantic import Field
 class WriteDiary(Action):
     """Write a diary according to the given commit messages in json format."""
 
-    name: str = "write diary"
-    description: str = "write a diary according to the given commit messages in json format"
     output_key: str = "dump_text"
 
     async def _execute(self, task_input: Task[str], **_) -> str:
@@ -50,8 +48,6 @@ class WriteDiary(Action):
 class DumpText(Action):
     """Dump the text to a file."""
 
-    name: str = "dump text"
-    description: str = "dump text to a file"
     toolboxes: Set[ToolBox] = Field(default_factory=lambda: {fs_toolbox})
     output_key: str = "task_output"
 
@@ -77,9 +73,7 @@ async def main() -> None:
         name="Coder",
         description="A python coder who can ",
         registry={
-            Event.instantiate_from("doc").push_wildcard().push("pending"): WorkFlow(
-                name="write documentation", steps=(WriteDiary, DumpText)
-            ),
+            Event.quick_instantiate("doc"): WorkFlow(name="write documentation", steps=(WriteDiary, DumpText)),
         },
     )
 

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/examples/minor/hello_fabricatio.py

@@ -11,7 +11,6 @@ task = Task(name="say hello", goals=["say hello"], description="say hello to the
 class Hello(Action):
     """Action that says hello."""
 
-    name: str = "hello"
     output_key: str = "task_output"
 
     async def _execute(self, task_input: Task[str], **_) -> Any:

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/examples/propose_task/propose.py

@@ -9,7 +9,6 @@ from fabricatio import Action, Event, Role, Task, WorkFlow, logger
 class Talk(Action):
     """Action that says hello to the world."""
 
-    name: str = "talk"
     output_key: str = "task_output"
 
     async def _execute(self, **_) -> Any:

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/examples/simple_chat/chat.py

@@ -10,7 +10,6 @@ from questionary import text
 class Talk(Action):
     """Action that says hello to the world."""
 
-    name: str = "talk"
     output_key: str = "task_output"
 
     async def _execute(self, task_input: Task[str], **_) -> int:

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/examples/simple_rag/simple_rag.py

@@ -10,7 +10,6 @@ from questionary import text
 class Talk(Action, RAG):
     """Action that says hello to the world."""
 
-    name: str = "talk"
     output_key: str = "task_output"
 
     async def _execute(self, task_input: Task[str], **_) -> int:

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/examples/task_handle/handle_task.py

@@ -10,7 +10,6 @@ from pydantic import Field
 class WriteCode(Action):
     """Action that says hello to the world."""
 
-    name: str = "write code"
     output_key: str = "dump_text"
 
     async def _execute(self, task_input: Task[str], **_) -> str:
@@ -24,8 +23,6 @@ class WriteCode(Action):
 class DumpText(Action):
     """Dump the text to a file."""
 
-    name: str = "dump text"
-    description: str = "dump text to a file"
     toolboxes: Set[ToolBox] = Field(default_factory=lambda: {fs_toolbox})
     output_key: str = "task_output"
 
@@ -48,8 +45,6 @@ class DumpText(Action):
 class WriteDocumentation(Action):
     """Action that says hello to the world."""
 
-    name: str = "write documentation"
-    description: str = "write documentation for the code in markdown format"
     output_key: str = "dump_text"
 
     async def _execute(self, task_input: Task[str], **_) -> str:
@@ -59,8 +54,6 @@ class WriteDocumentation(Action):
 class TestCancel(Action):
     """Action that says hello to the world."""
 
-    name: str = "cancel"
-    description: str = "cancel the task"
     output_key: str = "counter"
 
     async def _execute(self, counter: int, **_) -> int:
@@ -73,7 +66,6 @@ class TestCancel(Action):
 class WriteToOutput(Action):
     """Action that says hello to the world."""
 
-    name: str = "write to output"
     output_key: str = "task_output"
 
     async def _execute(self, **_) -> str:
@@ -86,13 +78,9 @@ async def main() -> None:
         name="Coder",
         description="A python coder who can ",
         registry={
-            Event.instantiate_from("coding").push_wildcard().push("pending"): WorkFlow(
-                name="write code", steps=(WriteCode, DumpText)
-            ),
-            Event.instantiate_from("doc").push_wildcard().push("pending"): WorkFlow(
-                name="write documentation", steps=(WriteDocumentation, DumpText)
-            ),
-            Event.instantiate_from("cancel_test").push_wildcard().push("pending"): WorkFlow(
+            Event.quick_instantiate("coding"): WorkFlow(name="write code", steps=(WriteCode, DumpText)),
+            Event.quick_instantiate("doc"): WorkFlow(name="write documentation", steps=(WriteDocumentation, DumpText)),
+            Event.quick_instantiate("cancel_test"): WorkFlow(
                 name="cancel_test",
                 steps=(TestCancel, TestCancel, TestCancel, TestCancel, TestCancel, TestCancel, WriteToOutput),
                 extra_init_context={"counter": 0},

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fabricatio"
-version = "0.2.4-dev0"
+version = "0.2.4-dev2"
 description = "A LLM multi-agent framework."
 readme = "README.md"
 license = { file = "LICENSE" }

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/python/fabricatio/__init__.py

@@ -3,12 +3,13 @@
 from importlib.util import find_spec
 
 from fabricatio._rust_instances import template_manager
-from fabricatio.actions import ExtractArticleEssence
+from fabricatio.actions.article import ExtractArticleEssence
 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.extra import ArticleEssence
 from fabricatio.models.role import Role
 from fabricatio.models.task import Task
 from fabricatio.models.tool import ToolBox
@@ -18,6 +19,7 @@ from fabricatio.toolboxes import arithmetic_toolbox, basic_toolboxes, fs_toolbox
 
 __all__ = [
     "Action",
+    "ArticleEssence",
     "Capture",
     "CodeBlockCapture",
     "Event",
@@ -42,6 +44,8 @@ __all__ = [
 
 
 if find_spec("pymilvus"):
+    from fabricatio.actions.rag import InjectToDB
     from fabricatio.capabilities.rag import RAG
+    from fabricatio.workflows.articles import StoreArticle
 
-    __all__ += ["RAG"]
+    __all__ += ["RAG", "InjectToDB", "StoreArticle"]

fabricatio-0.2.4.dev2/python/fabricatio/actions/article.py

@@ -0,0 +1,49 @@
+"""Actions for transmitting tasks to targets."""
+
+from os import PathLike
+from pathlib import Path
+from typing import Callable, List
+
+from fabricatio.journal import logger
+from fabricatio.models.action import Action
+from fabricatio.models.extra import ArticleEssence
+from fabricatio.models.task import Task
+
+
+class ExtractArticleEssence(Action):
+    """Extract the essence of article(s) in text format from the paths specified in the task dependencies.
+
+    Notes:
+        This action is designed to extract vital information from articles with Markdown format, which is pure text, and
+        which is converted from pdf files using `magic-pdf` from the `MinerU` project, see https://github.com/opendatalab/MinerU
+    """
+
+    name: str = "extract article essence"
+    """The name of the action."""
+    description: str = "Extract the essence of article(s) from the paths specified in the task dependencies."
+    """The description of the action."""
+
+    output_key: str = "article_essence"
+    """The key of the output data."""
+
+    async def _execute[P: PathLike | str](
+        self,
+        task_input: Task,
+        reader: Callable[[P], str] = lambda p: Path(p).read_text(encoding="utf-8"),
+        **_,
+    ) -> List[ArticleEssence]:
+        if not await self.ajudge(
+            f"= Task\n{task_input.briefing}\n\n\n= Role\n{self.briefing}",
+            affirm_case="The task does not violate the role, and could be approved since the file dependencies are specified.",
+            deny_case="The task does violate the role, and could not be approved.",
+        ):
+            logger.info(err := "Task not approved.")
+            raise RuntimeError(err)
+
+        # trim the references
+        contents = ["References".join(c.split("References")[:-1]) for c in map(reader, task_input.dependencies)]
+        return await self.propose(
+            ArticleEssence,
+            contents,
+            system_message=f"# your personal briefing: \n{self.briefing}",
+        )

fabricatio-0.2.4.dev2/python/fabricatio/actions/rag.py

@@ -0,0 +1,25 @@
+"""Inject data into the database."""
+
+from typing import List, Optional, Unpack
+
+from fabricatio.capabilities.rag import RAG
+from fabricatio.models.action import Action
+from fabricatio.models.generic import PrepareVectorization
+
+
+class InjectToDB(Action, RAG):
+    """Inject data into the database."""
+
+    output_key: str = "collection_name"
+
+    async def _execute[T: PrepareVectorization](
+        self, to_inject: T | List[T], collection_name: Optional[str] = "my_collection", **cxt: Unpack
+    ) -> str:
+        if not isinstance(to_inject, list):
+            to_inject = [to_inject]
+
+        await self.view(collection_name, create=True).consume_string(
+            [t.prepare_vectorization(self.embedding_max_sequence_length) for t in to_inject],
+        )
+
+        return collection_name

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/python/fabricatio/capabilities/rating.py

@@ -131,8 +131,7 @@ class GiveRating(WithBriefing, LLMUsage):
 
         def _validator(response: str) -> Dict[str, str] | None:
             if (
-                (json_data := JsonCapture.convert_with(response, orjson.loads)) is not None
-                and isinstance(json_data, dict)
+                (json_data := JsonCapture.validate_with(response, target_type=dict, elements_type=str)) is not None
                 and json_data.keys() == criteria
                 and all(isinstance(v, str) for v in json_data.values())
             ):
@@ -173,11 +172,10 @@ class GiveRating(WithBriefing, LLMUsage):
 
         def _validator(response: str) -> Set[str] | None:
             if (
-                (json_data := JsonCapture.convert_with(response, orjson.loads)) is not None
-                and isinstance(json_data, list)
-                and all(isinstance(v, str) for v in json_data)
-                and (criteria_count == 0 or len(json_data) == criteria_count)
-            ):
+                json_data := JsonCapture.validate_with(
+                    response, target_type=list, elements_type=str, length=criteria_count
+                )
+            ) is not None:
                 return set(json_data)
             return None
 
@@ -219,27 +217,6 @@ class GiveRating(WithBriefing, LLMUsage):
         Returns:
             Set[str]: A set of drafted rating criteria.
         """
-
-        def _reasons_validator(response: str) -> List[str] | None:
-            if (
-                (json_data := JsonCapture.convert_with(response, orjson.loads)) is not None
-                and isinstance(json_data, list)
-                and all(isinstance(v, str) for v in json_data)
-                and len(json_data) == reasons_count
-            ):
-                return json_data
-            return None
-
-        def _criteria_validator(response: str) -> Set[str] | None:
-            if (
-                (json_data := JsonCapture.convert_with(response, orjson.loads)) is not None
-                and isinstance(json_data, list)
-                and all(isinstance(v, str) for v in json_data)
-                and len(json_data) == criteria_count
-            ):
-                return set(json_data)
-            return None
-
         kwargs = GenerateKwargs(system_message=f"# your personal briefing: \n{self.briefing}", **kwargs)
         # extract reasons from the comparison of ordered pairs of extracted from examples
         reasons = flatten(
@@ -256,7 +233,9 @@ class GiveRating(WithBriefing, LLMUsage):
                     )
                     for pair in (permutations(examples, 2))
                 ],
-                validator=_reasons_validator,
+                validator=lambda resp: JsonCapture.validate_with(
+                    resp, target_type=list, elements_type=str, length=reasons_count
+                ),
                 **kwargs,
             )
         )
@@ -272,7 +251,9 @@ class GiveRating(WithBriefing, LLMUsage):
                     },
                 )
             ),
-            validator=_criteria_validator,
+            validator=lambda resp: set(out)
+            if (out := JsonCapture.validate_with(resp, target_type=list, elements_type=str, length=criteria_count))
+            else None,
             **kwargs,
         )
 
@@ -295,11 +276,6 @@ class GiveRating(WithBriefing, LLMUsage):
         if len(criteria) < 2:  # noqa: PLR2004
             raise ValueError("At least two criteria are required to draft rating weights")
 
-        def _validator(resp: str) -> float | None:
-            if (cap := JsonCapture.convert_with(resp, orjson.loads)) is not None and isinstance(cap, float):
-                return cap
-            return None
-
         criteria = list(criteria)  # freeze the order
         windows = windowed(criteria, 2)
 
@@ -316,7 +292,7 @@ class GiveRating(WithBriefing, LLMUsage):
                 )
                 for pair in windows
             ],
-            validator=_validator,
+            validator=lambda resp: JsonCapture.validate_with(resp, target_type=float),
             **GenerateKwargs(system_message=f"# your personal briefing: \n{self.briefing}", **kwargs),
         )
         weights = [1]

fabricatio-0.2.4.dev2/python/fabricatio/fs/__init__.py

@@ -0,0 +1,17 @@
+"""FileSystem manipulation module for Fabricatio."""
+
+from fabricatio.fs.curd import copy_file, create_directory, delete_directory, delete_file, dump_text, move_file, tree
+from fabricatio.fs.readers import magika, safe_json_read, safe_text_read
+
+__all__ = [
+    "copy_file",
+    "create_directory",
+    "delete_directory",
+    "delete_file",
+    "dump_text",
+    "magika",
+    "move_file",
+    "safe_json_read",
+    "safe_text_read",
+    "tree",
+]

{fabricatio-0.2.4.dev0 → fabricatio-0.2.4.dev2}/python/fabricatio/models/action.py

@@ -3,7 +3,7 @@
 import traceback
 from abc import abstractmethod
 from asyncio import Queue, create_task
-from typing import Any, Dict, Self, Tuple, Type, Union, Unpack
+from typing import Any, Dict, Self, Tuple, Type, Union, Unpack, final
 
 from fabricatio.capabilities.rating import GiveRating
 from fabricatio.capabilities.task import HandleTask, ProposeTask
@@ -17,11 +17,26 @@ from pydantic import Field, PrivateAttr
 class Action(HandleTask, ProposeTask, GiveRating):
     """Class that represents an action to be executed in a workflow."""
 
+    name: str = Field(default="")
+    """The name of the action."""
+    description: str = Field(default="")
+    """The description of the action."""
     personality: str = Field(default="")
     """The personality of whom the action belongs to."""
     output_key: str = Field(default="")
     """The key of the output data."""
 
+    @final
+    def model_post_init(self, __context: Any) -> None:
+        """Initialize the action by setting the name if not provided.
+
+        Args:
+            __context: The context to be used for initialization.
+        """
+        self.name = self.name or self.__class__.__name__
+
+        self.description = self.description or self.__class__.__doc__ or ""
+
     @abstractmethod
     async def _execute(self, **cxt: Unpack) -> Any:
         """Execute the action with the provided arguments.
@@ -34,6 +49,7 @@ class Action(HandleTask, ProposeTask, GiveRating):
         """
         pass
 
+    @final
     async def act(self, cxt: Dict[str, Any]) -> Dict[str, Any]:
         """Perform the action by executing it and setting the output data.
 
@@ -92,9 +108,8 @@ class WorkFlow(WithBriefing, ToolBoxUsage):
         Returns:
             Self: The instance of the workflow with the injected personality.
         """
-        for a in self._instances:
-            if not a.personality:
-                a.personality = personality
+        for a in filter(lambda action: not action.personality, self._instances):
+            a.personality = personality
         return self
 
     async def serve(self, task: Task) -> None:

fabricatio-0.2.4.dev0/python/fabricatio/actions/article.py → fabricatio-0.2.4.dev2/python/fabricatio/models/extra.py

@@ -1,16 +1,9 @@
-"""Actions for transmitting tasks to targets."""
+"""Extra models for built-in actions."""
 
-from os import PathLike
-from pathlib import Path
-from typing import Callable, List
+from typing import List
 
-from pydantic import BaseModel, Field
-from pydantic.config import ConfigDict
-
-from fabricatio.journal import logger
-from fabricatio.models.action import Action
-from fabricatio.models.generic import ProposedAble
-from fabricatio.models.task import Task
+from fabricatio.models.generic import Display, PrepareVectorization, ProposedAble
+from pydantic import BaseModel, ConfigDict, Field
 
 
 class Equation(BaseModel):
@@ -36,8 +29,28 @@ class Figure(BaseModel):
     figure_caption: str = Field(...)
     """The caption accompanying the figure, summarizing its main points and academic value."""
 
+    figure_path: str = Field(...)
+    """The file path to the figure"""
+
+
+class Highlightings(BaseModel):
+    """Structured representation of highlighted elements in an academic paper (including equations, algorithms, figures, and tables)."""
+
+    # Academic Achievements Showcase
+    highlighted_equations: List[Equation] = Field(default_factory=list)
+    """Core mathematical equations that represent breakthroughs in the field, accompanied by explanations of their physical or conceptual significance."""
+
+    highlighted_algorithms: List[str] = Field(default_factory=list)
+    """Pseudocode for key algorithms, annotated to highlight innovative components."""
+
+    highlighted_figures: List[Figure] = Field(default_factory=list)
+    """Critical diagrams or illustrations, each accompanied by a caption explaining their academic importance."""
+
+    highlighted_tables: List[str] = Field(default_factory=list)
+    """Important data tables, annotated to indicate statistical significance or other notable findings."""
 
-class ArticleEssence(ProposedAble):
+
+class ArticleEssence(ProposedAble, Display, PrepareVectorization):
     """Structured representation of the core elements of an academic paper(providing a comprehensive digital profile of the paper's essential information)."""
 
     # Basic Metadata
@@ -66,19 +79,6 @@ class ArticleEssence(ProposedAble):
     technical_novelty: List[str] = Field(default_factory=list)
     """Specific technical innovations introduced by the research, listed as individual points."""
 
-    # Academic Achievements Showcase
-    highlighted_equations: List[Equation] = Field(default_factory=list)
-    """Core mathematical equations that represent breakthroughs in the field, accompanied by explanations of their physical or conceptual significance."""
-
-    highlighted_algorithms: List[str] = Field(default_factory=list)
-    """Pseudocode for key algorithms, annotated to highlight innovative components."""
-
-    highlighted_figures: List[Figure] = Field(default_factory=list)
-    """Critical diagrams or illustrations, each accompanied by a caption explaining their academic importance."""
-
-    highlighted_tables: List[str] = Field(default_factory=list)
-    """Important data tables, annotated to indicate statistical significance or other notable findings."""
-
     # Academic Discussion Dimensions
     research_problem: str = Field("")
     """A clearly defined research question or problem addressed by the study."""
@@ -92,36 +92,5 @@ class ArticleEssence(ProposedAble):
     impact_analysis: str = Field("")
     """An assessment of the paper's potential influence on the development of the field."""
 
-
-class ExtractArticleEssence(Action):
-    """Extract the essence of article(s)."""
-
-    name: str = "extract article essence"
-    """The name of the action."""
-    description: str = "Extract the essence of an article. output as json"
-    """The description of the action."""
-
-    output_key: str = "article_essence"
-    """The key of the output data."""
-
-    async def _execute[P: PathLike | str](
-        self,
-        task_input: Task,
-        reader: Callable[[P], str] = lambda p: Path(p).read_text(encoding="utf-8"),
-        **_,
-    ) -> List[ArticleEssence]:
-        if not await self.ajudge(
-            f"= Task\n{task_input.briefing}\n\n\n= Role\n{self.briefing}",
-            affirm_case="The task does not violate the role, and could be approved since the file dependencies are specified.",
-            deny_case="The task does violate the role, and could not be approved.",
-        ):
-            logger.info(err := "Task not approved.")
-            raise RuntimeError(err)
-
-        # trim the references
-        contents = ["References".join(c.split("References")[:-1]) for c in map(reader, task_input.dependencies)]
-        return await self.propose(
-            ArticleEssence,
-            contents,
-            system_message=f"# your personal briefing: \n{self.briefing}",
-        )
+    def _prepare_vectorization_inner(self) -> str:
+        return self.model_dump_json()