fabricatio 0.2.9.dev0__cp312-cp312-manylinux_2_34_x86_64.whl → 0.2.9.dev2__cp312-cp312-manylinux_2_34_x86_64.whl

fabricatio/actions/output.py

@@ -1,7 +1,7 @@
 """Dump the finalized output to a file."""
 
 from pathlib import Path
-from typing import Iterable, List, Optional, Type
+from typing import Any, Iterable, List, Optional, Type
 
 from fabricatio.journal import logger
 from fabricatio.models.action import Action
@@ -33,6 +33,7 @@ class DumpFinalizedOutput(Action):
                 "Could not find the path of file to dump the data.",
             )
         )
+        logger.info(f"Saving output to {dump_path.as_posix()}")
         ok(to_dump, "Could not dump the data since the path is not specified.").finalized_dump_to(dump_path)
         return dump_path.as_posix()
 
@@ -41,7 +42,11 @@ class PersistentAll(Action):
     """Persist all the data to a file."""
 
     output_key: str = "persistent_count"
+    """The number of objects persisted."""
     persist_dir: Optional[str] = None
+    """The directory to persist the data."""
+    override: bool = False
+    """Whether to remove the existing dir before dumping."""
 
     async def _execute(
         self,
@@ -64,16 +69,22 @@ class PersistentAll(Action):
         if persist_dir.is_file():
             logger.warning("Dump should be a directory, but it is a file. Skip dumping.")
             return count
-
+        if self.override and persist_dir.is_dir():
+            logger.info(f"Override the existing directory {persist_dir.as_posix()}.")
+            persist_dir.rmdir()
+        logger.info(f"Starting persistence in directory {persist_dir}")
         for k, v in cxt.items():
             final_dir = persist_dir.joinpath(k)
+            logger.debug(f"Checking key {k} for persistence")
             if isinstance(v, PersistentAble):
+                logger.info(f"Persisting object {k} to {final_dir}")
                 final_dir.mkdir(parents=True, exist_ok=True)
                 v.persist(final_dir)
                 count += 1
             if isinstance(v, Iterable) and any(
                 persistent_ables := (pers for pers in v if isinstance(pers, PersistentAble))
             ):
+                logger.info(f"Persisting collection {k} to {final_dir}")
                 final_dir.mkdir(parents=True, exist_ok=True)
                 for per in persistent_ables:
                     per.persist(final_dir)
@@ -93,10 +104,39 @@ class RetrieveFromPersistent[T: PersistentAble](Action):
     """The class of the object to retrieve."""
 
     async def _execute(self, /, **__) -> Optional[T | List[T]]:
-        logger.info(f"Retrieve `{self.retrieve_cls.__name__}` from persistent file: {self.load_path}")
+        logger.info(f"Retrieve `{self.retrieve_cls.__name__}` from {self.load_path}")
         if not (p := Path(self.load_path)).exists():
+            logger.warning(f"Path {self.load_path} does not exist")
             return None
 
         if p.is_dir():
+            logger.info(f"Found directory with {len(list(p.glob('*')))} items")
             return [self.retrieve_cls.from_persistent(per) for per in p.glob("*")]
         return self.retrieve_cls.from_persistent(self.load_path)
+
+
+class GatherAsList(Action):
+    """Gather the objects from the context as a list.
+
+    Notes:
+        If both `gather_suffix` and `gather_prefix` are specified, only the objects with the suffix will be gathered.
+    """
+    output_key: str = "gathered"
+    """Gather the objects from the context as a list."""
+    gather_suffix: Optional[str] = None
+    """Gather the objects from the context as a list."""
+    gather_prefix: Optional[str] = None
+    """Gather the objects from the context as a list."""
+
+    async def _execute(self, **cxt) -> List[Any]:
+
+        if self.gather_suffix is not None:
+            result = [cxt[k] for k in cxt if k.endswith(self.gather_suffix)]
+            logger.debug(f"Gathered {len(result)} items with suffix {self.gather_suffix}")
+            return result
+        if  self.gather_prefix is None:
+            logger.error(err:="Either `gather_suffix` or `gather_prefix` must be specified.")
+            raise ValueError(err)
+        result = [cxt[k] for k in cxt if k.startswith(self.gather_prefix)]
+        logger.debug(f"Gathered {len(result)} items with prefix {self.gather_prefix}")
+        return result

fabricatio/capabilities/censor.py

@@ -20,8 +20,6 @@ class Censor(Correct, Check):
     Inherits from both Correct and Check classes.
     Provides methods to censor objects and strings by first checking them against a ruleset and then correcting them if necessary.
 
-    Attributes:
-        ruleset (RuleSet): The ruleset to be used for censoring.
     """
 
     async def censor_obj[M: SketchedAble](
@@ -42,7 +40,7 @@ class Censor(Correct, Check):
         """
         imp = await self.check_obj(obj, ruleset, **override_kwargs(kwargs, default=None))
         if imp is None:
-            return imp
+            return None
         return await self.correct_obj(obj, imp, **kwargs)
 
     async def censor_string(

fabricatio/capabilities/check.py

@@ -11,6 +11,7 @@ from fabricatio.models.extra.problem import Improvement
 from fabricatio.models.extra.rule import Rule, RuleSet
 from fabricatio.models.generic import Display, WithBriefing
 from fabricatio.models.kwargs_types import ValidateKwargs
+from fabricatio.rust import detect_language
 from fabricatio.utils import override_kwargs
 
 
@@ -56,9 +57,7 @@ class Check(AdvancedJudge, Propose):
 
         ruleset_patch = await self.propose(
             RuleSetBriefingPatch,
-            f"# Rules Requirements\n{rule_reqs}\n# Generated Rules\n{Display.seq_display(rules)}\n\n"
-            f"You need to write a concise and detailed patch for this ruleset that can be applied to the ruleset nicely.\n"
-            f"Note that all fields in this patch will be directly copied to the ruleset obj, including `name` and `description`, so write when knowing the subject.\n",
+            f"{ruleset_requirement}\n\nYou should use `{detect_language(ruleset_requirement)}`!",
             **override_kwargs(kwargs, default=None),
         )
 
@@ -98,7 +97,7 @@ class Check(AdvancedJudge, Propose):
                 Improvement,
                 TEMPLATE_MANAGER.render_template(
                     configs.templates.check_string_template,
-                    {"to_check": input_text, "rule": rule, "judge": judge.display(), "reference": reference},
+                    {"to_check": input_text, "rule": rule.display(), "judge": judge.display(), "reference": reference},
                 ),
                 **kwargs,
             )

fabricatio/capabilities/correct.py

@@ -78,11 +78,11 @@ class Correct(Rating, Propose):
             TEMPLATE_MANAGER.render_template(
                 configs.templates.fix_troubled_obj_template,
                 {
-                    "problem": problem_solutions.problem,
+                    "problem": problem_solutions.problem.display(),
                     "solution": ok(
                         problem_solutions.final_solution(),
                         f"No solution found for problem: {problem_solutions.problem}",
-                    ),
+                    ).display(),
                     "reference": reference,
                 },
             ),
@@ -111,11 +111,11 @@ class Correct(Rating, Propose):
             TEMPLATE_MANAGER.render_template(
                 configs.templates.fix_troubled_string_template,
                 {
-                    "problem": problem_solutions.problem,
+                    "problem": problem_solutions.problem.display(),
                     "solution": ok(
                         problem_solutions.final_solution(),
                         f"No solution found for problem: {problem_solutions.problem}",
-                    ),
+                    ).display(),
                     "reference": reference,
                     "string_to_fix": input_text,
                 },

fabricatio/config.py

@@ -303,7 +303,7 @@ class CacheConfig(BaseModel):
 
     model_config = ConfigDict(use_attribute_docstrings=True)
 
-    type: Optional[LiteLLMCacheType] = None
+    type: LiteLLMCacheType = LiteLLMCacheType.LOCAL
     """The type of cache to use. If None, the default cache type will be used."""
     params: CacheKwargs = Field(default_factory=CacheKwargs)
     """The parameters for the cache. If type is None, the default parameters will be used."""

fabricatio/models/action.py

@@ -1,7 +1,12 @@
-"""Module that contains the classes for actions and workflows.
+"""Module that contains the classes for defining and executing task workflows.
 
-This module defines the Action and WorkFlow classes, which are used for
-creating and executing sequences of actions in a task-based context.
+This module provides the Action and WorkFlow classes for creating structured
+task execution pipelines. Actions represent atomic operations, while WorkFlows
+orchestrate sequences of actions with shared context and error handling.
+
+Classes:
+    Action: Base class for defining executable actions with context management.
+    WorkFlow: Manages action sequences, context propagation, and task lifecycle.
 """
 
 import traceback
@@ -50,28 +55,26 @@ class Action(WithBriefing, LLMUsage):
         self.description = self.description or self.__class__.__doc__ or ""
 
     @abstractmethod
-    async def _execute(self, *_, **cxt) -> Any:  # noqa: ANN002
-        """Execute the action logic with the provided context arguments.
-
-        This method must be implemented by subclasses to define the actual behavior.
+    async def _execute(self, *_:Any, **cxt) -> Any:
+        """Implement the core logic of the action.
 
         Args:
-            **cxt: The context dictionary containing input and output data.
+            **cxt: Context dictionary containing input/output data.
 
         Returns:
-            Any: The result of the action execution.
+            Result of the action execution to be stored in context.
         """
         pass
 
     @final
     async def act(self, cxt: Dict[str, Any]) -> Dict[str, Any]:
-        """Perform the action and update the context with results.
+        """Execute action and update context.
 
         Args:
-            cxt: The context dictionary containing input and output data.
+            cxt (Dict[str, Any]): Shared context dictionary.
 
         Returns:
-            Dict[str, Any]: The updated context dictionary.
+            Updated context dictionary with new/modified entries.
         """
         ret = await self._execute(**cxt)
 
@@ -83,10 +86,10 @@ class Action(WithBriefing, LLMUsage):
 
     @property
     def briefing(self) -> str:
-        """Return a formatted description of the action including personality context if available.
+        """Generate formatted action description with personality context.
 
         Returns:
-            str: Formatted briefing text with personality and action description.
+            Briefing text combining personality and action description.
         """
         if self.personality:
             return f"## Your personality: \n{self.personality}\n# The action you are going to perform: \n{super().briefing}"
@@ -98,10 +101,15 @@ class Action(WithBriefing, LLMUsage):
         return self
 
 class WorkFlow(WithBriefing, ToolBoxUsage):
-    """Class that represents a sequence of actions to be executed for a task.
+    """Manages sequences of actions to fulfill tasks.
 
-    A workflow manages the execution of multiple actions in sequence, passing
-    a shared context between them and handling task lifecycle events.
+    Handles context propagation between actions, error handling, and task lifecycle
+    events like cancellation and completion.
+
+    Attributes:
+        steps (Tuple): Sequence of Action instances or classes to execute.
+        task_input_key (str): Key for storing task instance in context.
+        task_output_key (str): Key to retrieve final result from context.
     """
 
     description: str = ""
@@ -137,26 +145,29 @@ class WorkFlow(WithBriefing, ToolBoxUsage):
         self._instances = tuple(step if isinstance(step, Action) else step() for step in self.steps)
 
     def inject_personality(self, personality: str) -> Self:
-        """Set the personality for all actions that don't have one defined.
+        """Set personality for actions without existing personality.
 
         Args:
-            personality: The personality text to inject.
+            personality (str): Shared personality context
 
         Returns:
-            Self: The workflow instance for method chaining.
+            Workflow instance with updated actions
         """
         for action in filter(lambda a: not a.personality, self._instances):
             action.personality = personality
         return self
 
     async def serve(self, task: Task) -> None:
-        """Execute the workflow to fulfill the given task.
-
-        This method manages the complete lifecycle of processing a task through
-        the workflow's sequence of actions.
+        """Execute workflow to complete given task.
 
         Args:
-            task: The task to be processed.
+            task (Task): Task instance to be processed.
+
+        Steps:
+            1. Initialize context with task instance and extra data
+            2. Execute each action sequentially
+            3. Handle task cancellation and exceptions
+            4. Extract final result from context
         """
         logger.info(f"Start execute workflow: {self.name}")
 
@@ -206,10 +217,14 @@ class WorkFlow(WithBriefing, ToolBoxUsage):
             await task.fail()
 
     async def _init_context[T](self, task: Task[T]) -> None:
-        """Initialize the context dictionary for workflow execution.
+        """Initialize workflow execution context.
 
         Args:
-            task: The task being served by this workflow.
+            task (Task[T]): Task being processed
+
+        Context includes:
+            - Task instance stored under task_input_key
+            - Any extra_init_context values
         """
         logger.debug(f"Initializing context for workflow: {self.name}")
         initial_context = {self.task_input_key: task, **dict(self.extra_init_context)}
@@ -230,7 +245,7 @@ class WorkFlow(WithBriefing, ToolBoxUsage):
         Returns:
             Self: The workflow instance for method chaining.
         """
-        self.provide_tools_to(self._instances)
+        self.provide_tools_to(i for i in self._instances if isinstance(i,ToolBoxUsage))
         return self
 
     def update_init_context(self, /, **kwargs) -> Self:

fabricatio/models/extra/article_base.py

@@ -7,8 +7,6 @@ from typing import Generator, List, Optional, Self, Tuple, overload
 
 from fabricatio.models.generic import (
     AsPrompt,
-    CensoredAble,
-    Display,
     FinalizedDumpAble,
     Introspect,
     ModelHash,
@@ -16,6 +14,7 @@ from fabricatio.models.generic import (
     ProposedUpdateAble,
     ResolveUpdateConflict,
     SequencePatch,
+    SketchedAble,
 )
 
 
@@ -30,7 +29,7 @@ class ReferringType(StrEnum):
 type RefKey = Tuple[str, Optional[str], Optional[str]]
 
 
-class ArticleRef(CensoredAble, ProposedUpdateAble):
+class ArticleRef(ProposedUpdateAble):
     """Reference to a specific chapter, section or subsection within the article. You SHALL not refer to an article component that is external and not present within our own article.
 
     Examples:
@@ -104,7 +103,7 @@ class ArticleRef(CensoredAble, ProposedUpdateAble):
         return ReferringType.CHAPTER
 
 
-class ArticleMetaData(CensoredAble, Display):
+class ArticleMetaData(SketchedAble):
     """Metadata for an article component."""
 
     description: str
@@ -120,6 +119,9 @@ class ArticleMetaData(CensoredAble, Display):
     title: str
     """Do not add any prefix or suffix to the title. should not contain special characters."""
 
+    expected_word_count: int
+    """Expected word count of this research component."""
+
 
 class ArticleRefSequencePatch(SequencePatch[ArticleRef]):
     """Patch for article refs."""

fabricatio/models/extra/article_main.py

@@ -14,11 +14,11 @@ from fabricatio.models.extra.article_base import (
 from fabricatio.models.extra.article_outline import (
     ArticleOutline,
 )
-from fabricatio.models.generic import CensoredAble, Display, PersistentAble, SequencePatch, WithRef
+from fabricatio.models.generic import PersistentAble, SequencePatch, SketchedAble, WithRef
 from fabricatio.utils import ok
 
 
-class Paragraph(CensoredAble):
+class Paragraph(SketchedAble):
     """Structured academic paragraph blueprint for controlled content generation."""
 
     description: str
@@ -73,8 +73,7 @@ class ArticleChapter(ChapterBase[ArticleSection]):
 
 
 class Article(
-    Display,
-    CensoredAble,
+    SketchedAble,
     WithRef[ArticleOutline],
     PersistentAble,
     ArticleBase[ArticleChapter],

fabricatio/models/extra/article_outline.py

@@ -9,7 +9,7 @@ from fabricatio.models.extra.article_base import (
     SubSectionBase,
 )
 from fabricatio.models.extra.article_proposal import ArticleProposal
-from fabricatio.models.generic import CensoredAble, Display, PersistentAble, WithRef
+from fabricatio.models.generic import PersistentAble, SketchedAble, WithRef
 
 
 class ArticleSubsectionOutline(SubSectionBase):
@@ -25,8 +25,7 @@ class ArticleChapterOutline(ChapterBase[ArticleSectionOutline]):
 
 
 class ArticleOutline(
-    Display,
-    CensoredAble,
+    SketchedAble,
     WithRef[ArticleProposal],
     PersistentAble,
     ArticleBase[ArticleChapterOutline],

fabricatio/models/extra/article_proposal.py

@@ -2,10 +2,10 @@
 
 from typing import Dict, List
 
-from fabricatio.models.generic import AsPrompt, CensoredAble, Display, PersistentAble, WithRef
+from fabricatio.models.generic import AsPrompt, SketchedAble, PersistentAble, WithRef
 
 
-class ArticleProposal(CensoredAble, Display, WithRef[str], AsPrompt, PersistentAble):
+class ArticleProposal(SketchedAble, WithRef[str], AsPrompt, PersistentAble):
     """Structured proposal for academic paper development with core research elements.
 
     Guides LLM in generating comprehensive research proposals with clearly defined components.
@@ -41,8 +41,8 @@ class ArticleProposal(CensoredAble, Display, WithRef[str], AsPrompt, PersistentA
     abstract: str
     """A concise summary of the research proposal, outlining the main points and objectives."""
 
-    min_word_count: int
-    """The minimum number of words required for the research proposal."""
+    expected_word_count: int
+    """The estimated word count of the final academic paper."""
 
     def _as_prompt_inner(self) -> Dict[str, str]:
         return {

fabricatio/models/generic.py

@@ -33,45 +33,50 @@ class Base(BaseModel):
     """Base class for all models with Pydantic configuration.
 
     This class sets up the basic Pydantic configuration for all models in the Fabricatio library.
+    The `model_config` uses `use_attribute_docstrings=True` to ensure field descriptions are
+    pulled from the attribute's docstring instead of the default Pydantic behavior.
     """
-
     model_config = ConfigDict(use_attribute_docstrings=True)
 
 
 class Display(Base):
-    """Class that provides a method to display the model in a formatted JSON string.
+    """Class that provides formatted JSON representation utilities.
 
-    This class includes methods to display the model in both formatted and compact JSON strings.
+    Provides methods to generate both pretty-printed and compact JSON representations of the model.
+    Used for debugging and logging purposes.
     """
-
     def display(self) -> str:
-        """Display the model in a formatted JSON string.
+        """Generate pretty-printed JSON representation.
 
         Returns:
-            str: The formatted JSON string of the model.
+            str: JSON string with 1-level indentation for readability
         """
         return self.model_dump_json(indent=1)
 
     def compact(self) -> str:
-        """Display the model in a compact JSON string.
+        """Generate compact JSON representation.
 
         Returns:
-            str: The compact JSON string of the model.
+            str: Minified JSON string without whitespace
         """
         return self.model_dump_json()
 
     @staticmethod
     def seq_display(seq: Iterable["Display"], compact: bool = False) -> str:
-        """Display a sequence of Display objects in a formatted JSON string.
+        """Generate formatted display for sequence of Display objects.
 
         Args:
-            seq (Iterable[Display]): The sequence of Display objects to display.
-            compact (bool): Whether to display the sequence in a compact format. Defaults to False.
+            seq (Iterable[Display]): Sequence of objects to display
+            compact (bool): Use compact format instead of pretty print
 
         Returns:
-            str: The formatted JSON string of the sequence.
+            str: Combined display output with boundary markers
         """
-        return "\n".join(d.compact() if compact else d.display() for d in seq)
+        return (
+            "--- Start of Extra Info Sequence ---"
+            + "\n".join(d.compact() if compact else d.display() for d in seq)
+            + "--- End of Extra Info Sequence ---"
+        )
 
 
 class Named(Base):
@@ -184,25 +189,29 @@ class WithRef[T](Base):
 
 
 class PersistentAble(Base):
-    """Class that provides a method to persist the object.
+    """Class providing file persistence capabilities.
 
-    This class includes methods to persist the object to a file or directory.
+    Enables saving model instances to disk with timestamped filenames and loading from persisted files.
+    Implements basic versioning through filename hashing and timestamping.
     """
-
     def persist(self, path: str | Path) -> Self:
-        """Persist the object to a file or directory.
+        """Save model instance to disk with versioned filename.
 
         Args:
-            path (str | Path): The path to save the object.
+            path (str | Path): Target directory or file path. If directory, filename is auto-generated.
 
         Returns:
-            Self: The current instance of the object.
+            Self: Current instance for method chaining
+
+        Notes:
+            - Filename format: <ClassName>_<YYYYMMDD_HHMMSS>_<6-char_hash>.json
+            - Hash generated from JSON content ensures uniqueness
         """
         p = Path(path)
         out = self.model_dump_json()
 
         # Generate a timestamp in the format YYYYMMDD_HHMMSS
-        timestamp = datetime.now().strftime("%Y%m%d")
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
 
         # Generate the hash
         file_hash = blake3_hash(out.encode())[:6]
@@ -219,15 +228,52 @@ class PersistentAble(Base):
         logger.info(f"Persisted `{self.__class__.__name__}` to {p.as_posix()}")
         return self
 
+    @classmethod
+    def from_latest_persistent(cls, dir_path: str | Path) -> Self:
+        """Load most recent persisted instance from directory.
+
+        Args:
+            dir_path (str | Path): Directory containing persisted files
+
+        Returns:
+            Self: Most recently modified instance
+
+        Raises:
+            NotADirectoryError: If path is not a valid directory
+            FileNotFoundError: If no matching files found
+        """
+        dir_path = Path(dir_path)
+        if not dir_path.is_dir():
+            raise NotADirectoryError(f"{dir_path} is not a valid directory")
+
+        pattern = f"{cls.__name__}_*.json"
+        files = list(dir_path.glob(pattern))
+
+        if not files:
+            raise FileNotFoundError(f"No persistent files found for {cls.__name__} in {dir_path}")
+
+        def _get_timestamp(file_path: Path) -> datetime:
+            stem = file_path.stem
+            parts = stem.split("_")
+            return datetime.strptime(f"{parts[1]}_{parts[2]}", "%Y%m%d_%H%M%S")
+
+        files.sort(key=lambda f: _get_timestamp(f), reverse=True)
+
+        return cls.from_persistent(files.pop(0))
+
     @classmethod
     def from_persistent(cls, path: str | Path) -> Self:
-        """Load the object from a file.
+        """Load an instance from a specific persisted file.
 
         Args:
-            path (str | Path): The path to load the object from.
+            path (str | Path): Path to the JSON file.
 
         Returns:
-            Self: The current instance of the object.
+            Self: The loaded instance from the file.
+
+        Raises:
+            FileNotFoundError: If the specified file does not exist.
+            ValueError: If the file content is invalid for the model.
         """
         return cls.model_validate_json(safe_text_read(path))
 
@@ -236,7 +282,7 @@ class Language(Base):
     """Class that provides a language attribute."""
 
     language: str
-    """The written language of this object, which should be aligned to the original requirement 
+    """The written language of this object, which should be aligned to the original requirement
     For example if the requirement is in Chinese, the language should be set to `zh`, if the requirement is in English, the language should be set to `en` and etc."""
 
 
@@ -619,11 +665,11 @@ class Vectorizable(Base):
 
 
 class ScopedConfig(Base):
-    """Class that manages a scoped configuration.
+    """Configuration holder with hierarchical fallback mechanism.
 
-    This class includes attributes and methods to manage configuration settings scoped to the instance.
+    Manages LLM, embedding, and vector database configurations with fallback logic.
+    Allows configuration values to be overridden in a hierarchical manner.
     """
-
     llm_api_endpoint: Optional[HttpUrl] = None
     """The OpenAI API endpoint."""
 
@@ -698,13 +744,15 @@ class ScopedConfig(Base):
 
     @final
     def fallback_to(self, other: "ScopedConfig") -> Self:
-        """Fallback to another instance's attribute values if the current instance's attributes are None.
+        """Merge configuration values with fallback priority.
+
+        Copies non-null values from 'other' to self where current values are None.
 
         Args:
-            other (ScopedConfig): Another instance from which to copy attribute values.
+            other (ScopedConfig): Configuration to fallback to
 
         Returns:
-            Self: The current instance, allowing for method chaining.
+            Self: Current instance with merged values
         """
         # Iterate over the attribute names and copy values from 'other' to 'self' where applicable
         # noinspection PydanticTypeChecker,PyTypeChecker
@@ -718,13 +766,15 @@ class ScopedConfig(Base):
 
     @final
     def hold_to(self, others: Union["ScopedConfig", Iterable["ScopedConfig"]]) -> Self:
-        """Hold to another instance's attribute values if the current instance's attributes are None.
+        """Propagate non-null values to other configurations.
+
+        Copies current non-null values to target configurations where they are None.
 
         Args:
-            others (Union[ScopedConfig, Iterable[ScopedConfig]]): Another instance or iterable of instances from which to copy attribute values.
+            others (ScopedConfig|Iterable): Target configurations to update
 
         Returns:
-            Self: The current instance, allowing for method chaining.
+            Self: Current instance unchanged
         """
         if not isinstance(others, Iterable):
             others = [others]
@@ -777,14 +827,15 @@ class Patch[T](ProposedAble):
             str: The JSON schema of the model in a formatted string.
         """
         my_schema = cls.model_json_schema(schema_generator=UnsortGenerate)
-        if (ref_cls := cls.ref_cls()) is not None:
+
+        ref_cls = cls.ref_cls()
+        if ref_cls is not None:
             # copy the desc info of each corresponding fields from `ref_cls`
-            for field_name, field_info in cls.model_fields.items():
-                if (ref_field := getattr(ref_cls, field_name, None)) is not None:
-                    if (desc := ref_field.field_info.description) is not None:
-                        my_schema["properties"][field_name]["description"] = desc
-                    if (example := ref_field.field_info.examples) is not None:
-                        my_schema["properties"][field_name]["examples"] = example
+            for field_name in [f for f in cls.model_fields if f in ref_cls.model_fields]:
+                my_schema["properties"][field_name]["description"] = (
+                    ref_cls.model_fields[field_name].description or my_schema["properties"][field_name]["description"]
+                )
+            my_schema["description"] = ref_cls.__doc__
 
         return orjson.dumps(
             my_schema,

fabricatio/rust.pyi

@@ -1,5 +1,7 @@
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import List, Optional
+
+from pydantic import JsonValue
 
 class TemplateManager:
     """Template rendering engine using Handlebars templates.
@@ -41,7 +43,7 @@ class TemplateManager:
         This refreshes the template cache, finding any new or modified templates.
         """
 
-    def render_template(self, name: str, data: Dict[str, Any]) -> str:
+    def render_template(self, name: str, data: JsonValue) -> str:
         """Render a template with context data.
 
         Args:
@@ -55,7 +57,7 @@ class TemplateManager:
             RuntimeError: If template rendering fails
         """
 
-    def render_template_raw(self, template: str, data: Dict[str, Any]) -> str:
+    def render_template_raw(self, template: str, data: JsonValue) -> str:
         """Render a template with context data.
 
         Args:
@@ -76,6 +78,9 @@ def blake3_hash(content: bytes) -> str:
         Hex-encoded BLAKE3 hash string
     """
 
+def detect_language(string: str) -> str:
+    """Detect the language of a given string."""
+
 class BibManager:
     """BibTeX bibliography manager for parsing and querying citation data."""
 
@@ -162,7 +167,7 @@ class BibManager:
             Title if found, None otherwise
         """
 
-    def get_field_by_key(self, key: str, field: str)-> Optional[str]:
+    def get_field_by_key(self, key: str, field: str) -> Optional[str]:
         """Retrieve a specific field by citation key.
 
         Args:

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

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

{fabricatio-0.2.9.dev0.dist-info → fabricatio-0.2.9.dev2.dist-info}/RECORD

@@ -1,28 +1,28 @@
-fabricatio-0.2.9.dev0.dist-info/METADATA,sha256=XLilH1rtKOSDzExN0RDKFUXBBmrcOY0I0i_dHhNJIfo,5151
-fabricatio-0.2.9.dev0.dist-info/WHEEL,sha256=7FgAcpQES0h1xhfN9Ugve9FTUilU6sRAr1WJ5ph2cuw,108
-fabricatio-0.2.9.dev0.dist-info/licenses/LICENSE,sha256=yDZaTLnOi03bi3Dk6f5IjhLUc5old2yOsihHWU0z-i0,1067
+fabricatio-0.2.9.dev2.dist-info/METADATA,sha256=3qxanLDFv9Y-sTj944gRiPAzjQsZkIZ3OwIVUFNDzQk,5151
+fabricatio-0.2.9.dev2.dist-info/WHEEL,sha256=7FgAcpQES0h1xhfN9Ugve9FTUilU6sRAr1WJ5ph2cuw,108
+fabricatio-0.2.9.dev2.dist-info/licenses/LICENSE,sha256=yDZaTLnOi03bi3Dk6f5IjhLUc5old2yOsihHWU0z-i0,1067
 fabricatio/decorators.py,sha256=GrkclNTGT2bk7cjTyuca7mqSVlKwTcujcj3uBuZpT8s,7343
 fabricatio/core.py,sha256=MaEKZ6DDmbdScAY-7F1gwGA6fr7ADX6Mz5rNVi2msFA,6277
-fabricatio/models/generic.py,sha256=LAmr3FtknPVRugQ4FHH3uccZAblssUz-FSGOR6o8dXM,27450
+fabricatio/models/generic.py,sha256=pe5raaUtzXVOyZfeXVXBsxz1nPEg3_nVdSa7Z7XGBFc,29281
 fabricatio/models/tool.py,sha256=VM3rMeDpUbeeFAKpsPfweJ2JGHf-w5f1voDnuhK99ew,12178
 fabricatio/models/role.py,sha256=iao4teYzY5QjfN1B2tEY5wbQq5afFz7jdhi6IziIong,2878
 fabricatio/models/kwargs_types.py,sha256=N-CqIDGzkcDSveY8NKUntkTJykst5dAhqjzDw5Zi54I,5479
 fabricatio/models/utils.py,sha256=x4ZSk5YfHjRuEz_zzcU-rI9nBV_idq9N9RFF6UT8FXg,4269
-fabricatio/models/extra/article_proposal.py,sha256=hPkc2bfalTwdDiCpwpQ0KVbBWINBFOrsY0-WaufohCU,1992
+fabricatio/models/extra/article_proposal.py,sha256=DjgynelsFHIrlYeGJjZKHh5sDMAdsqucWepjhsnazEg,1969
 fabricatio/models/extra/advanced_judge.py,sha256=iiiERQ12uOyloZAsSQpKoFX7LKVM5ci1zmtEgMoi6lw,967
-fabricatio/models/extra/article_main.py,sha256=2iudJLMHtUHi1dIraVlVkNurgKdE1HXH5xJnEKRyqLo,8011
+fabricatio/models/extra/article_main.py,sha256=lNMWkjQTlF_KFYGjn7OHGmfzcd-PPkmpe6dU1oMLkSI,7989
 fabricatio/models/extra/problem.py,sha256=fTmp0o7fHoC4wf0gSIg5nyy7DyA8gwM-S7eUZPtKaWw,5675
 fabricatio/models/extra/article_essence.py,sha256=Fc1h05RFgKowHpHkdh-PNx3IxaUKLYdHVora-QM63WI,2726
-fabricatio/models/extra/article_outline.py,sha256=EMKo4CBxU3ns6UhM1eDtoo-14MjEKT7cFs_CqrXbEhU,1409
+fabricatio/models/extra/article_outline.py,sha256=2vqMDhXwfRooHEe_cblkOj-4V96VsIAy68x22KBEQPQ,1387
 fabricatio/models/extra/__init__.py,sha256=0R9eZsCNu6OV-Xtf15H7FrqhfHTFBFf3fBrcd7ChsJ0,53
 fabricatio/models/extra/rule.py,sha256=sz2TPWOKKcttINaSHt0vYRGohlk4AoJpuTDiuqQzv7U,2051
-fabricatio/models/extra/article_base.py,sha256=qcBgHjQAXktC_jKNM2DNyNFZGC5TagI6sGIBwQM7AVw,16631
+fabricatio/models/extra/article_base.py,sha256=a3sSfw24oHEMzlRFLjz6tlqALMVKWRu2Gj0jvN5GwOQ,16683
 fabricatio/models/extra/patches.py,sha256=5Pw_xNiFsbcV-Cnh6hE3PLvwdrDptTxGY_j_AWTfnjo,969
 fabricatio/models/adv_kwargs_types.py,sha256=NzTrhNvLGFns2qZJCCs4Xht5DKmPgX9nztOJFJjZWQ4,835
 fabricatio/models/usages.py,sha256=DwaaWJnir5vC3OTriCllYLfEMQXvvx9SZ0mpXMliDaA,31576
 fabricatio/models/events.py,sha256=UvOc6V3vfjKuvh7irDezJ8EGpsNo5yzLdq4xQexVonw,4063
 fabricatio/models/task.py,sha256=MygHTr3wC5MT3tdIU-seBhaRGq94aBAJFb464m5tm-g,10192
-fabricatio/models/action.py,sha256=EH1gt3Jav00aITGoOB7IqbUWl8qUrDYdYiPFQ0YV5OQ,8983
+fabricatio/models/action.py,sha256=97Rd0kLTDhVuObggtgTEomZyKMd4I4HoVmNhmgxLw1I,9517
 fabricatio/toolboxes/fs.py,sha256=OQMdeokYxSNVrCZJAweJ0cYiK4k2QuEiNdIbS5IHIV8,705
 fabricatio/toolboxes/__init__.py,sha256=dYm_Gd8XolSU_h4wnkA09dlaLDK146eeFz0CUgPZ8_c,380
 fabricatio/toolboxes/arithmetic.py,sha256=sSTPkKI6-mb278DwQKFO9jKyzc9kCx45xNH7V6bGBpE,1307
@@ -31,12 +31,12 @@ fabricatio/fs/readers.py,sha256=5bLlpqcdhIwWfysh7gvfVv0PPPVAeDlTPGwNTio6j9M,1156
 fabricatio/fs/curd.py,sha256=QqwnyLdVALNnerYGXf6a0irqoPSNE9_GJV9bJ33kbl0,4610
 fabricatio/fs/__init__.py,sha256=hTuYtzmvIGtbg7PTdoqLEQJ0E63hOzZltCIrLlDKaSE,559
 fabricatio/rust_instances.py,sha256=i5fIt6XkE8UwUU4JarmPt50AZs8aJW6efaypSLGLl0I,303
-fabricatio/config.py,sha256=a-kL9uFwedizrCAkGYhTeFtPvPKuV7caw6egA_jdlrk,17261
+fabricatio/config.py,sha256=NleUcBs5R1x63qZY0gQah9OVfCg9o2BXI4rC836p9LQ,17269
 fabricatio/utils.py,sha256=n74jVUh8x6SqcgwAAEM8AIQTxAztAIp9ze7w_y8qogc,1627
 fabricatio/journal.py,sha256=Op0wC-JlZumnAc_aDmYM4ljnSNLoKEEMfcIRbCF69ow,455
-fabricatio/rust.pyi,sha256=J5T5o3EALYdQhuSDd2mKaLmWZ_S7b9z1av61MBS6CPw,4930
+fabricatio/rust.pyi,sha256=nUra-xJnTumf8f4Hpj_tZOcWZzuVQrgEj9z31mcTC3M,5033
 fabricatio/__init__.py,sha256=OXoMMHJKHEB_vN97_34U4I5QpAKL9xnVQEVcBCvwBCg,986
-fabricatio/actions/output.py,sha256=cZw3A6QUFdqfruqp2AMhYMzdJjGorNbWnCI3u4o06Xk,3652
+fabricatio/actions/output.py,sha256=NvVL4YdGHnQaYLzP9g3dsh1XBZYOFpbM8qDxT-NXAKg,5619
 fabricatio/actions/article_rag.py,sha256=DViaxJQtGphcjVswN81ilyIYe_u0zakzAKFxF3KQQd8,4252
 fabricatio/actions/rag.py,sha256=0jkk-weJN6HyXK18hMP-U24kL-HsurVTEFx4LST9qZE,2663
 fabricatio/actions/__init__.py,sha256=ZMa1LeM5BNeqp-J-D32W-f5bD53-kdXGyt0zuueJofM,47
@@ -46,16 +46,16 @@ fabricatio/workflows/articles.py,sha256=oHNV5kNKEcOKP55FA7I1SlxQRlk6N26cpem_QYu0
 fabricatio/workflows/rag.py,sha256=uOZXprD479fUhLA6sYvEM8RWcVcUZXXtP0xRbTMPdHE,509
 fabricatio/workflows/__init__.py,sha256=Lq9pFo2cudwFCrQUUNgSTr1CoU0J1Nw-HNEQN7cHLp8,50
 fabricatio/parser.py,sha256=AD9vgy-MljB8o3kH89RfwUyD5V296nrGnAe5u1nE00M,6165
-fabricatio/capabilities/censor.py,sha256=TaonBIMaaHiqPU8JFcek3waG6E4sbXDyR_DMYRGeTc8,3779
+fabricatio/capabilities/censor.py,sha256=8PdA5RDbUtXbhWOogkpxJ6tf0nRY7hRjVRzcANVygWI,3699
 fabricatio/capabilities/advanced_judge.py,sha256=bvb8fYoiKoGlBwMZVMflVE9R2MoS1VtmZAo65jMJFew,683
-fabricatio/capabilities/check.py,sha256=gspjI5N_hyE8kLBTqbwu5v7Ce4DoMlB3l238OxOD9Qg,8092
-fabricatio/capabilities/correct.py,sha256=DX4pPL5NUB1QVEvDJ5yc7jxPut3Pa9QmmZ6B4NieofA,8968
+fabricatio/capabilities/check.py,sha256=bYq54jcLhIj_Jv-LhSKGN0hV0bnyh1EF4j-NCFxB1dw,7850
+fabricatio/capabilities/correct.py,sha256=LVN5rQ4NdxDwdJZo_KLNnrEaPIC7m7Ts0lE5bUYpI4g,9008
 fabricatio/capabilities/rag.py,sha256=It5uWwqbrX64MfQ3FbSvmgcpECAo8XWkLhtRSdTb0ME,17300
 fabricatio/capabilities/__init__.py,sha256=skaJ43CqAQaZMH-mCRzF4Fps3x99P2SwJ8vSM9pInX8,56
 fabricatio/capabilities/rating.py,sha256=Sb9Tbd8qQCqt7eLv5C87f73g4nuaA9Cdv-zaurtfqtA,16618
 fabricatio/capabilities/review.py,sha256=EPL8IlxSKO0XStBkXdW7FJMbPztDQMv9w7tHgu6r3PM,4948
 fabricatio/capabilities/propose.py,sha256=vOJvmmnMBHUQB6N1AmZNFw42jf7Bl2mBRNlBK15TpNI,1942
 fabricatio/capabilities/task.py,sha256=gg1xcNlvHy7voR1GXiVDpKW16IvFofLInMlXgkhzBiQ,4304
-fabricatio/rust.cpython-312-x86_64-linux-gnu.so,sha256=XGQclTvq5O9nTzK9I7DsGqfT5NS-jbHaULQExDIHkiI,1960928
-fabricatio-0.2.9.dev0.data/scripts/tdown,sha256=GdTCN1GtfFujyfb0JeiHdrfKN9du10s-mjVd4GUqkas,4598184
-fabricatio-0.2.9.dev0.dist-info/RECORD,,
+fabricatio/rust.cpython-312-x86_64-linux-gnu.so,sha256=fFxA6svoT7gfEt43u4sMaJdRirvKNvgUeiTCgeF1nf8,2237648
+fabricatio-0.2.9.dev2.data/scripts/tdown,sha256=GdTCN1GtfFujyfb0JeiHdrfKN9du10s-mjVd4GUqkas,4598184
+fabricatio-0.2.9.dev2.dist-info/RECORD,,