zrb 1.4.0__py3-none-any.whl → 1.4.2__py3-none-any.whl

zrb/__main__.py

@@ -1,3 +1,4 @@
+import os
 import sys
 
 from zrb.config import INIT_MODULES, INIT_SCRIPTS
@@ -9,10 +10,19 @@ from zrb.util.load import load_file, load_module
 
 def serve_cli():
     try:
+        # load init modules
         for init_module in INIT_MODULES:
             load_module(init_module)
+        zrb_init_path_list = _get_zrb_init_path_list()
+        # load init scripts
         for init_script in INIT_SCRIPTS:
-            load_file(init_script, -1)
+            abs_init_script = os.path.abspath(init_script)
+            if abs_init_script not in zrb_init_path_list:
+                load_file(abs_init_script, -1)
+        # load zrb init
+        for zrb_init_path in zrb_init_path_list:
+            load_file(zrb_init_path)
+        # run the CLI
         cli.run(sys.argv[1:])
     except KeyboardInterrupt:
         print(stylize_warning("\nStopped"), file=sys.stderr)
@@ -24,3 +34,17 @@ def serve_cli():
     except NodeNotFoundError as e:
         print(stylize_error(f"{e}"), file=sys.stderr)
         sys.exit(1)
+
+
+def _get_zrb_init_path_list() -> list[str]:
+    current_path = os.path.abspath(os.getcwd())
+    dir_path_list = [current_path]
+    while current_path != os.path.dirname(current_path):  # Stop at root
+        current_path = os.path.dirname(current_path)
+        dir_path_list.append(current_path)
+    zrb_init_path_list = []
+    for current_path in dir_path_list[::-1]:
+        zrb_init_path = os.path.join(current_path, "zrb_init.py")
+        if os.path.isfile(zrb_init_path):
+            zrb_init_path_list.append(zrb_init_path)
+    return zrb_init_path_list

zrb/builtin/llm/llm_chat.py

@@ -22,7 +22,6 @@ from zrb.config import (
     LLM_ALLOW_ACCESS_LOCAL_FILE,
     LLM_ALLOW_ACCESS_SHELL,
     LLM_HISTORY_DIR,
-    LLM_SYSTEM_PROMPT,
     SERP_API_KEY,
 )
 from zrb.context.any_shared_context import AnySharedContext
@@ -119,7 +118,7 @@ llm_chat: LLMTask = llm_group.add_task(
                 "system-prompt",
                 description="System prompt",
                 prompt="System prompt",
-                default=LLM_SYSTEM_PROMPT,
+                default="",
                 allow_positional_parsing=False,
                 always_prompt=False,
             ),
@@ -141,17 +140,19 @@ llm_chat: LLMTask = llm_group.add_task(
                 always_prompt=False,
             ),
         ],
-        model=lambda ctx: None if ctx.input.model == "" else ctx.input.model,
+        model=lambda ctx: None if ctx.input.model.strip() == "" else ctx.input.model,
         model_base_url=lambda ctx: (
-            None if ctx.input.base_url == "" else ctx.input.base_url
+            None if ctx.input.base_url.strip() == "" else ctx.input.base_url
         ),
         model_api_key=lambda ctx: (
-            None if ctx.input.api_key == "" else ctx.input.api_key
+            None if ctx.input.api_key.strip() == "" else ctx.input.api_key
         ),
         conversation_history_reader=_read_chat_conversation,
         conversation_history_writer=_write_chat_conversation,
         description="Chat with LLM",
-        system_prompt="{ctx.input.system_prompt}",
+        system_prompt=lambda ctx: (
+            None if ctx.input.system_prompt.strip() == "" else ctx.input.system_prompt
+        ),
         message="{ctx.input.message}",
         retries=0,
     ),

zrb/builtin/llm/tool/file.py

@@ -3,25 +3,92 @@ import os
 
 from zrb.util.file import read_file, write_file
 
+_INCLUDED_PATTERNS: list[str] = [
+    "*.py",  # Python
+    "*.go",  # Go
+    "*.rs",  # Rust
+    "*.js",  # JavaScript
+    "*.ts",  # TypeScript
+    "*.java",  # Java
+    "*.c",  # C
+    "*.cpp",  # C++
+    "*.cc",  # Alternative C++ extension
+    "*.cxx",  # Alternative C++ extension
+    "*.rb",  # Ruby
+    "*.swift",  # Swift
+    "*.kt",  # Kotlin
+    "*.php",  # PHP
+    "*.pl",  # Perl / Prolog
+    "*.pm",  # Perl module
+    "*.sh",  # Shell
+    "*.bat",  # Batch
+    "*.ps1",  # PowerShell
+    "*.R",  # R (capital)
+    "*.r",  # R (lowercase)
+    "*.scala",  # Scala
+    "*.hs",  # Haskell
+    "*.cs",  # C#
+    "*.fs",  # F#
+    "*.ex",  # Elixir
+    "*.exs",  # Elixir script
+    "*.erl",  # Erlang
+    "*.hrl",  # Erlang header
+    "*.dart",  # Dart
+    "*.m",  # Objective-C / Matlab (note: conflicts may arise)
+    "*.mm",  # Objective-C++
+    "*.lua",  # Lua
+    "*.jl",  # Julia
+    "*.groovy",  # Groovy
+    "*.clj",  # Clojure
+    "*.cljs",  # ClojureScript
+    "*.cljc",  # Clojure common
+    "*.vb",  # Visual Basic
+    "*.f90",  # Fortran
+    "*.f95",  # Fortran
+    "*.adb",  # Ada
+    "*.ads",  # Ada specification
+    "*.pas",  # Pascal
+    "*.pp",  # Pascal
+    "*.ml",  # OCaml
+    "*.mli",  # OCaml interface
+    "*.nim",  # Nim
+    "*.rkt",  # Racket
+    "*.d",  # D
+    "*.lisp",  # Common Lisp
+    "*.lsp",  # Lisp variant
+    "*.cl",  # Common Lisp
+    "*.scm",  # Scheme
+    "*.st",  # Smalltalk
+    "*.vhd",  # VHDL
+    "*.vhdl",  # VHDL
+    "*.v",  # Verilog
+    "*.asm",  # Assembly
+    "*.s",  # Assembly (alternative)
+    "*.sql",  # SQL (if desired)
+]
+
+# Extended list of directories and patterns to exclude.
+_EXCLUDED_PATTERNS: list[str] = [
+    "venv",  # Python virtual environments
+    ".venv",
+    "node_modules",  # Node.js dependencies
+    ".git",  # Git repositories
+    "__pycache__",  # Python cache directories
+    "build",  # Build directories
+    "dist",  # Distribution directories
+    "target",  # Build output directories (Java, Rust, etc.)
+    "bin",  # Binary directories
+    "obj",  # Object files directories
+    ".idea",  # JetBrains IDEs
+    ".vscode",  # VS Code settings
+    ".eggs",  # Python eggs
+]
+
 
 def list_files(
     directory: str = ".",
-    included_patterns: list[str] = [
-        "*.py",
-        "*.go",
-        "*.js",
-        "*.ts",
-        "*.java",
-        "*.c",
-        "*.cpp",
-    ],
-    excluded_patterns: list[str] = [
-        "venv",
-        ".venv",
-        "node_modules",
-        ".git",
-        "__pycache__",
-    ],
+    included_patterns: list[str] = _INCLUDED_PATTERNS,
+    excluded_patterns: list[str] = _EXCLUDED_PATTERNS,
 ) -> list[str]:
     """List all files in a directory that match any of the included glob patterns
     and do not reside in any directory matching an excluded pattern.
@@ -32,38 +99,47 @@ def list_files(
         for filename in files:
             if any(fnmatch.fnmatch(filename, pat) for pat in included_patterns):
                 full_path = os.path.join(root, filename)
-                # Check each component of the full path for excluded patterns.
-                if any(
-                    any(fnmatch.fnmatch(part, pat) for pat in excluded_patterns)
-                    for part in os.path.normpath(full_path).split(os.sep)
-                ):
+                if _should_exclude(full_path, excluded_patterns):
                     continue
                 all_files.append(full_path)
     return all_files
 
 
+def _should_exclude(full_path: str, excluded_patterns: list[str]) -> bool:
+    """
+    Return True if the file at full_path should be excluded based on
+    the list of excluded_patterns. Patterns that include a path separator
+    are applied to the full normalized path; otherwise they are matched
+    against each individual component of the path.
+    """
+    norm_path = os.path.normpath(full_path)
+    path_parts = norm_path.split(os.sep)
+    for pat in excluded_patterns:
+        # If the pattern seems intended for full path matching (contains a separator)
+        if os.sep in pat or "/" in pat:
+            if fnmatch.fnmatch(norm_path, pat):
+                return True
+        else:
+            # Otherwise check each part of the path
+            if any(fnmatch.fnmatch(part, pat) for part in path_parts):
+                return True
+    return False
+
+
 def read_text_file(file: str) -> str:
-    """Read a text file"""
+    """Read a text file and return a string containing the file content."""
     return read_file(os.path.abspath(file))
 
 
 def write_text_file(file: str, content: str):
-    """Write a text file"""
+    """Write content to a text file"""
     return write_file(os.path.abspath(file), content)
 
 
 def read_all_files(
     directory: str = ".",
-    included_patterns: list[str] = [
-        "*.py",
-        "*.go",
-        "*.js",
-        "*.ts",
-        "*.java",
-        "*.c",
-        "*.cpp",
-    ],
-    excluded_patterns: list[str] = [],
+    included_patterns: list[str] = _INCLUDED_PATTERNS,
+    excluded_patterns: list[str] = _EXCLUDED_PATTERNS,
 ) -> list[str]:
     """Read all files in a directory that match any of the included glob patterns
     and do not match any of the excluded glob patterns.

zrb/config.py

@@ -76,15 +76,6 @@ WEB_AUTH_REFRESH_TOKEN_EXPIRE_MINUTES = int(
     os.getenv("ZRB_WEB_REFRESH_TOKEN_EXPIRE_MINUTES", "60")
 )
 
-_DEFAULT_PROMPT = (
-    "You are a helpful AI assistant capable of using various tools to answer user queries. When solving a problem:\n"
-    "1. Carefully analyze the user's request and identify what information is needed to provide a complete answer.\n"
-    "2. Determine which available tools can help you gather the necessary information.\n"
-    "3. Call tools strategically and in a logical sequence to collect required data.\n"
-    "4. If a tool provides incomplete information, intelligently decide which additional tool or approach to use.\n"
-    "5. Always aim to provide the most accurate and helpful response possible."
-)
-LLM_SYSTEM_PROMPT = os.getenv("ZRB_LLM_SYSTEM_PROMPT", _DEFAULT_PROMPT)
 LLM_HISTORY_DIR = os.getenv(
     "ZRB_LLM_HISTORY_DIR", os.path.expanduser(os.path.join("~", ".zrb-llm-history"))
 )

zrb/llm_config.py

@@ -4,23 +4,49 @@ from pydantic_ai.models import Model
 from pydantic_ai.models.openai import OpenAIModel
 from pydantic_ai.providers.openai import OpenAIProvider
 
+DEFAULT_SYSTEM_PROMPT = """
+You have access to tools.
+Your goal to to answer user queries accurately.
+Follow these instructions precisely:
+1. ALWAYS use available tools to gather information BEFORE asking the user questions
+2. For tools that require arguments: provide arguments in valid JSON format
+3. For tools that require NO arguments: call with empty JSON object ({}) NOT empty string ('')
+4. NEVER pass arguments to tools that don't accept parameters
+5. NEVER ask users for information obtainable through tools
+6. Use tools in logical sequence until you have sufficient information
+7. If a tool call fails, check if you're passing arguments in the correct format
+8. Only after exhausting relevant tools should you request clarification
+""".strip()
+
 
 class LLMConfig:
 
     def __init__(
         self,
-        model_name: str | None = None,
-        base_url: str | None = None,
-        api_key: str | None = None,
+        default_model_name: str | None = None,
+        default_base_url: str | None = None,
+        default_api_key: str | None = None,
+        default_system_prompt: str | None = None,
     ):
         self._model_name = (
-            model_name if model_name is not None else os.getenv("ZRB_LLM_MODEL", None)
+            default_model_name
+            if default_model_name is not None
+            else os.getenv("ZRB_LLM_MODEL", None)
+        )
+        self._model_base_url = (
+            default_base_url
+            if default_base_url is not None
+            else os.getenv("ZRB_LLM_BASE_URL", None)
         )
-        self._base_url = (
-            base_url if base_url is not None else os.getenv("ZRB_LLM_BASE_URL", None)
+        self._model_api_key = (
+            default_api_key
+            if default_api_key is not None
+            else os.getenv("ZRB_LLM_API_KEY", None)
         )
-        self._api_key = (
-            api_key if api_key is not None else os.getenv("ZRB_LLM_API_KEY", None)
+        self._system_prompt = (
+            default_system_prompt
+            if default_system_prompt is not None
+            else os.getenv("ZRB_LLM_SYSTEM_PROMPT", None)
         )
         self._default_model = None
 
@@ -28,9 +54,16 @@ class LLMConfig:
         return self._model_name if self._model_name is not None else None
 
     def _get_model_provider(self) -> OpenAIProvider:
-        if self._base_url is None and self._api_key is None:
+        if self._model_base_url is None and self._model_api_key is None:
             return "openai"
-        return OpenAIProvider(base_url=self._base_url, api_key=self._api_key)
+        return OpenAIProvider(
+            base_url=self._model_base_url, api_key=self._model_api_key
+        )
+
+    def get_default_system_prompt(self) -> str:
+        if self._system_prompt is not None:
+            return self._system_prompt
+        return DEFAULT_SYSTEM_PROMPT
 
     def get_default_model(self) -> Model | str | None:
         if self._default_model is not None:
@@ -43,6 +76,18 @@ class LLMConfig:
             provider=self._get_model_provider(),
         )
 
+    def set_default_system_prompt(self, system_prompt: str):
+        self._system_prompt = system_prompt
+
+    def set_default_model_name(self, model_name: str):
+        self._model_name = model_name
+
+    def set_default_model_api_key(self, model_api_key: str):
+        self._model_api_key = model_api_key
+
+    def set_default_model_base_url(self, model_base_url: str):
+        self._model_base_url = model_base_url
+
     def set_default_model(self, model: Model | str | None):
         self._default_model = model
 

zrb/runner/cli.py

@@ -18,13 +18,11 @@ from zrb.util.cli.style import (
     stylize_section_header,
 )
 from zrb.util.group import extract_node_from_args, get_non_empty_subgroups, get_subtasks
-from zrb.util.load import load_zrb_init
 from zrb.util.string.conversion import double_quote
 
 
 class Cli(Group):
     def run(self, args: list[str] = []):
-        load_zrb_init()
         kwargs, args = self._extract_kwargs_from_args(args)
         node, node_path, args = extract_node_from_args(self, args)
         if isinstance(node, Group):

zrb/task/llm_task.py

@@ -18,7 +18,6 @@ from pydantic_ai.models import Model
 from pydantic_ai.settings import ModelSettings
 
 from zrb.attr.type import StrAttr, fstring
-from zrb.config import LLM_SYSTEM_PROMPT
 from zrb.context.any_context import AnyContext
 from zrb.context.any_shared_context import AnySharedContext
 from zrb.env.any_env import AnyEnv
@@ -58,7 +57,7 @@ class LLMTask(BaseTask):
             ModelSettings | Callable[[AnySharedContext], ModelSettings] | None
         ) = None,
         agent: Agent | Callable[[AnySharedContext], Agent] | None = None,
-        system_prompt: StrAttr | None = LLM_SYSTEM_PROMPT,
+        system_prompt: StrAttr | None = None,
         render_system_prompt: bool = True,
         message: StrAttr | None = None,
         tools: (
@@ -258,14 +257,14 @@ class LLMTask(BaseTask):
             return default_llm_config.get_default_model()
         if isinstance(model, str):
             llm_config = LLMConfig(
-                model_name=model,
-                base_url=get_attr(
+                default_model_name=model,
+                default_base_url=get_attr(
                     ctx,
                     self._get_model_base_url(ctx),
                     None,
                     auto_render=self._render_model_base_url,
                 ),
-                api_key=get_attr(
+                default_api_key=get_attr(
                     ctx,
                     self._get_model_api_key(ctx),
                     None,
@@ -292,12 +291,15 @@ class LLMTask(BaseTask):
         raise ValueError(f"Invalid model base URL: {api_key}")
 
     def _get_system_prompt(self, ctx: AnyContext) -> str:
-        return get_str_attr(
+        system_prompt = get_attr(
             ctx,
             self._system_prompt,
-            "You are a helpful assistant",
+            None,
             auto_render=self._render_system_prompt,
         )
+        if system_prompt is not None:
+            return system_prompt
+        return default_llm_config.get_default_system_prompt()
 
     def _get_message(self, ctx: AnyContext) -> str:
         return get_str_attr(ctx, self._message, "How are you?", auto_render=True)

zrb/util/load.py

@@ -9,22 +9,6 @@ from typing import Any
 pattern = re.compile("[^a-zA-Z0-9]")
 
 
-def load_zrb_init(dir_path: str | None = None) -> Any | None:
-    if dir_path is None:
-        dir_path = os.getcwd()
-    # get path list from current path to the absolute root
-    current_path = os.path.abspath(dir_path)
-    path_list = [current_path]
-    while current_path != os.path.dirname(current_path):  # Stop at root
-        current_path = os.path.dirname(current_path)
-        path_list.append(current_path)
-    # loop from root to current path to load zrb_init
-    for current_path in path_list[::-1]:
-        script_path = os.path.join(current_path, "zrb_init.py")
-        if os.path.isfile(script_path):
-            load_file(script_path)
-
-
 @lru_cache
 def load_file(script_path: str, sys_path_index: int = 0) -> Any | None:
     if not os.path.isfile(script_path):

{zrb-1.4.0.dist-info → zrb-1.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: zrb
-Version: 1.4.0
+Version: 1.4.2
 Summary: Your Automation Powerhouse
 Home-page: https://github.com/state-alchemists/zrb
 License: AGPL-3.0-or-later
@@ -39,29 +39,58 @@ Description-Content-Type: text/markdown
 
 # 🤖 Zrb: Your Automation Powerhouse
 
-Zrb allows you to write your automation tasks in Python. For example, you can define the following script in your home directory (`/home/<your-user-name>/zrb_init.py`).
+
+**Unlock the full potential of automation in your projects!**
+
+Zrb streamlines repetitive tasks, integrates with powerful LLMs, and lets you create custom automation workflows effortlessly. Whether you’re building CI/CD pipelines, code generators, or unique automation scripts, Zrb is designed to simplify and supercharge your workflow.
+
+
+## 🚀 Why Zrb?
+
+- **Easy Automation with Python:** Write your tasks in Python and let Zrb handle the rest.
+- **Seamless Integration:** Utilize built-in support for LLM tasks, command execution, and more.
+- **Custom Workflows:** Chain tasks, set dependencies, and build robust automation pipelines.
+- **Developer-Friendly:** Quick to install and get started, with clear documentation and examples.
+- **Web Interface:** Run Zrb as a server to make tasks accessible even to non-technical team members.
+
+
+## 🔥 Key Features
+
+- **LLM Integration:** Leverage state-of-the-art language models to generate code, diagrams, and documentation.
+- **Task Chaining:** Easily define dependencies between tasks to create complex workflows.
+- **CLI & Server Mode:** Run tasks directly from the command line or through a user-friendly web UI.
+- **Flexible Input Handling:** Defaults, prompts, and command-line parameters to suit any workflow.
+- **Extensible & Open Source:** Contribute, customize, or extend Zrb to fit your unique needs.
+
+
+# 🛠️ Installation
+
+Install Zrb via pip:
+
+```bash
+pip install zrb
+
+```
+
+Or run our installation script to set up Zrb along with all prerequisites:
+
+```bash
+bash -c "$(curl -fsSL https://raw.githubusercontent.com/state-alchemists/zrb/main/install.sh)"
+
+```
+
+# 🍲 Quick Start
+
+Create a file at `/home/<your-user-name>/zrb_init.py` with the following content:
 
 
 ```python
 import os
 from zrb import cli, llm_config, LLMTask, CmdTask, StrInput, Group
 from zrb.builtin.llm.tool.file import read_all_files, write_text_file
-from pydantic_ai.models.openai import OpenAIModel
-from pydantic_ai.providers.openai import OpenAIProvider
 
 CURRENT_DIR = os.getcwd()
 
-# Setup default LLM Config
-llm_config.set_default_model(
-    OpenAIModel(
-        model_name="gpt-4o",
-        provider=OpenAIProvider(
-            base_url="https://openrouter.ai/api/v1",
-            api_key=os.getenv("OPENROUTER_API_KEY", "")
-        )
-    )
-)
-
 # Make UML group
 uml_group = cli.add_group(Group(name="uml", description="UML related tasks"))
 
@@ -98,27 +127,39 @@ make_uml_image = uml_group.add_task(
 make_uml_script >> make_uml_image
 ```
 
-Once defined, your automation tasks are immediately accessible from the CLI. You can then invoke the tasks by invoking.
+You have just define two automation tasks.
+
+The first one use LLM to read files in your current directory and create a `PlantUML script` on that directory.
+
+The second task turn the PlantUML script into a `*.png` file. The second task depends on the first task and both of them are located under the same group.
+
+You can run the tasks by invoking `zrb uml make-script` or `zrb uml make-image` respectively.
+
+When you run zrb, it automatically searches for a file named `zrb_init.py` starting from your current directory and moving upward through its parent directories. This design lets you set up common automation tasks in a central location—like placing a `zrb_init.py` in your home directory (`/home/<your-user>/zrb_init.py`)—so that your tasks are available across all your projects.
+
+Now, go to your project and create a state diagram:
 
 ```bash
+git clone git@github.com:jjinux/gotetris.git
+cd gotetris
 zrb uml make-image --diagram "state diagram"
 ```
 
-Or you can invoke the tasks without parameter.
+You can also invoke the task without specifying parameter.
 
 ```bash
 zrb uml make-image
 ```
 
-At this point, Zrb will politely ask you to provide the diagram type.
+Once you do so, Zrb will ask you to provide the diagram type.
 
 ```
 diagram [state diagram]:
 ```
 
-You can just press enter if you want to use the default value.
+You can just press enter if you want to use the default value (i.e., in this case `state diagram`).
 
-Finally, you can run Zrb as a server and make your tasks available for non technical users by invoking the following command.
+Finally, you can also serve the tasks via a Web UI interface by invoking the following command:
 
 ```bash
 zrb server start
@@ -128,49 +169,39 @@ You will have a nice web interface running on `http://localhost:12123`
 
 ![Zrb Web UI](https://raw.githubusercontent.com/state-alchemists/zrb/main/_images/zrb-web-ui.png)
 
-Now, let's see how Zrb generate the state diagram. Based on the source code in your current directory, Zrb will generate a `state diagram.uml` and transform it into `state diagram.png`.
+Now, let's see how things work in detail. First, Zrb generates a `state diagram.uml` in your current directory, it then transform the UML script into a PNG image `state diagram.png`.
 
 ![State Diagram](https://raw.githubusercontent.com/state-alchemists/zrb/main/_images/state-diagram.png)
 
-See the [getting started guide](https://github.com/state-alchemists/zrb/blob/main/docs/recipes/getting-started/README.md) for more information. Or just watch the demo:
-
-[![Video Title](https://img.youtube.com/vi/W7dgk96l__o/0.jpg)](https://www.youtube.com/watch?v=W7dgk96l__o)
-
 
-# 🫰 Installing Zrb
+# 🎥 Demo & Documentation
 
-You can install Zrb as a pip package by invoking the following command:
+- **Step by step guide:** [Getting started with Zrb](https://github.com/state-alchemists/zrb/blob/main/docs/recipes/getting-started/README.md).
+- **Full documentation:** [Zrb Documentation](https://github.com/state-alchemists/zrb/blob/main/docs/README.md)
+- **Video demo:**
+  [![Video Title](https://img.youtube.com/vi/W7dgk96l__o/0.jpg)](https://www.youtube.com/watch?v=W7dgk96l__o)
 
-```bash
-pip install --pre zrb
-```
-
-Alternatively, you can also use our installation script to install Zrb along with some prerequisites:
 
-```bash
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/state-alchemists/zrb/main/install.sh)"
-```
+# 🤝 Join the Community
 
-# 🐞 Bug Report + Feature Request
+- **Bug Reports & Feature Requests:** Create an [issue](https://github.com/state-alchemists/zrb/issues) on Zrb's GitHub Repositories and include:
+    - Your Zrb version (i.e., `zrb version`).
+    - Steps you’ve taken and what you expected versus what happened
+- **Contributions:** We welcome pull requests! Check out our [contribution guidelines](https://github.com/state-alchemists/zrb/pulls).
 
-You can submit bug reports and feature requests by creating a new [issue](https://github.com/state-alchemists/zrb/issues) on Zrb's GitHub Repositories. When reporting a bug or requesting a feature, please be sure to:
 
-- Include the version of Zrb you are using (i.e., `zrb version`)
-- Tell us what you have tried
-- Tell us what you expect
-- Tell us what you get
+# ☕ Support The Project
 
-We will also welcome your [pull requests and contributions](https://github.com/state-alchemists/zrb/pulls).
-
-
-# ☕ Donation
-
-Help Red Skull to click the donation button:
+If you find Zrb valuable, please consider donating:
 
 [![](https://raw.githubusercontent.com/state-alchemists/zrb/main/_images/donator.png)](https://stalchmst.com/donation)
 
 # 🎉 Fun Fact
 
+Did you know?
+
+Zrb is named after `Zaruba`, a powerful support tool from the Garo universe!
+
 > Madou Ring Zaruba (魔導輪ザルバ, Madōrin Zaruba) is a Madougu which supports bearers of the Garo Armor. [(Garo Wiki | Fandom)](https://garo.fandom.com/wiki/Zaruba)
 
 ![Madou Ring Zaruba on Kouga's Hand](https://raw.githubusercontent.com/state-alchemists/zrb/main/_images/madou-ring-zaruba.jpg)

{zrb-1.4.0.dist-info → zrb-1.4.2.dist-info}/RECORD

@@ -1,5 +1,5 @@
 zrb/__init__.py,sha256=1waPjZcA3IHUEvIuVQso0YfNfW9i7SCJgEfzhiNTaCk,3020
-zrb/__main__.py,sha256=QcMnHfAFbDUFw9p9tgfFS4U0Ra9nE-TLU5YoMBiAriE,808
+zrb/__main__.py,sha256=MvAGzoM3ElJZOPMKNqaTdnrT9PXi9Saq8CPa11RiLQk,1748
 zrb/attr/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/attr/type.py,sha256=4TV5gPYMMrKh5V-yB6iRYKCbsXAH_AvGXMsjxKLHcUs,568
 zrb/builtin/__init__.py,sha256=oXG4Zm_rIp3G81Y7hiSe38jeS2sGZAnADoP_yxxhYEc,1926
@@ -7,11 +7,11 @@ zrb/builtin/base64.py,sha256=1YnSwASp7OEAvQcsnHZGpJEvYoI1Z2zTIJ1bCDHfcPQ,921
 zrb/builtin/git.py,sha256=8_qVE_2lVQEVXQ9vhiw8Tn4Prj1VZB78ZjEJJS5Ab3M,5461
 zrb/builtin/git_subtree.py,sha256=7BKwOkVTWDrR0DXXQ4iJyHqeR6sV5VYRt8y_rEB0EHg,3505
 zrb/builtin/group.py,sha256=-phJfVpTX3_gUwS1u8-RbZUHe-X41kxDBSmrVh4rq8E,1682
-zrb/builtin/llm/llm_chat.py,sha256=QCfxocM7UQPtpIWLMzr9wKbl9DCPcDZszAnPxszaww0,6071
+zrb/builtin/llm/llm_chat.py,sha256=OwbeXNaskyufYIhbhLmj9JRYB9bw5D8JfntAzOhmrP8,6140
 zrb/builtin/llm/previous-session.js,sha256=xMKZvJoAbrwiyHS0OoPrWuaKxWYLoyR5sguePIoCjTY,816
 zrb/builtin/llm/tool/api.py,sha256=bXFE7jihdhUscxJH8lu5imwlYH735AalbCyUTl28BaQ,826
 zrb/builtin/llm/tool/cli.py,sha256=to_IjkfrMGs6eLfG0cpVN9oyADWYsJQCtyluUhUdBww,253
-zrb/builtin/llm/tool/file.py,sha256=CVmAwzHrO6gk6OcnHedKiZDQhmi-0f6Tx0vJWQe1KOQ,2191
+zrb/builtin/llm/tool/file.py,sha256=YkJ5RGwsqlv3ZxAcQDKqjlcOdmHYRJlZ6M9P49uMJEY,4792
 zrb/builtin/llm/tool/rag.py,sha256=vEIThEy0JGwXEiNRLOEJAHAE0l1Qie2qvU3ryioeYMk,6066
 zrb/builtin/llm/tool/web.py,sha256=SDnCtYHZ0Q4DtLbIhc11a0UyyKbTTeW60UfeIKzK35k,3204
 zrb/builtin/md5.py,sha256=0pNlrfZA0wlZlHvFHLgyqN0JZJWGKQIF5oXxO44_OJk,949
@@ -208,7 +208,7 @@ zrb/callback/callback.py,sha256=hKefB_Jd1XGjPSLQdMKDsGLHPzEGO2dqrIArLl_EmD0,848
 zrb/cmd/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/cmd/cmd_result.py,sha256=L8bQJzWCpcYexIxHBNsXj2pT3BtLmWex0iJSMkvimOA,597
 zrb/cmd/cmd_val.py,sha256=7Doowyg6BK3ISSGBLt-PmlhzaEkBjWWm51cED6fAUOQ,1014
-zrb/config.py,sha256=X0mlhmpUrYp_l4qI3CnsqOAfvxfLkteCOV9ABGF--Qc,4690
+zrb/config.py,sha256=YBbpjH4Wnb8yQz0-982RCnbrdefdQy8SNZnJZJsfDvk,3985
 zrb/content_transformer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/content_transformer/any_content_transformer.py,sha256=v8ZUbcix1GGeDQwB6OKX_1TjpY__ksxWVeqibwa_iZA,850
 zrb/content_transformer/content_transformer.py,sha256=STl77wW-I69QaGzCXjvkppngYFLufow8ybPLSyAvlHs,2404
@@ -237,9 +237,9 @@ zrb/input/option_input.py,sha256=TQB82ko5odgzkULEizBZi0e9TIHEbIgvdP0AR3RhA74,213
 zrb/input/password_input.py,sha256=szBojWxSP9QJecgsgA87OIYwQrY2AQ3USIKdDZY6snU,1465
 zrb/input/str_input.py,sha256=NevZHX9rf1g8eMatPyy-kUX3DglrVAQpzvVpKAzf7bA,81
 zrb/input/text_input.py,sha256=shvVbc2U8Is36h23M5lcW8IEwKc9FR-4uEPZZroj3rU,3377
-zrb/llm_config.py,sha256=SXSkDpmXxGLJaoUrT09oNdOGwHXc82TwIGssVeo6S7U,1553
+zrb/llm_config.py,sha256=zNr46IOm8lGQKSp9yzWLfa4KOx5Yn_7xFoReyk2Cp9Y,3328
 zrb/runner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-zrb/runner/cli.py,sha256=HtfJQecFg2keIMK-7bVATBlTeZC_RvT8DsbUC58TMKU,6736
+zrb/runner/cli.py,sha256=0mT0oO_yEhc8N4nYCJNujhgLjVykZ0B-kAOFXyAvAqM,6672
 zrb/runner/common_util.py,sha256=0zhZn1Jdmr194_nsL5_L-Kn9-_NDpMTI2z6_LXUQJ-U,1369
 zrb/runner/web_app.py,sha256=Ji2AWeFpJu5guXmur7mAAbjMToyjgmPDdfYu8047FFI,2616
 zrb/runner/web_config/config.py,sha256=0wR58KreAmawGGfamm0GLZY344HaXs7qfDgHLavBDwo,3125
@@ -300,7 +300,7 @@ zrb/task/base_task.py,sha256=SQRf37bylS586KwyW0eYDe9JZ5Hl18FP8kScHae6y3A,21251
 zrb/task/base_trigger.py,sha256=jC722rDvodaBLeNaFghkTyv1u0QXrK6BLZUUqcmBJ7Q,4581
 zrb/task/cmd_task.py,sha256=pUKRSR4DZKjbmluB6vi7cxqyhxOLfJ2czSpYeQbiDvo,10705
 zrb/task/http_check.py,sha256=Gf5rOB2Se2EdizuN9rp65HpGmfZkGc-clIAlHmPVehs,2565
-zrb/task/llm_task.py,sha256=Gf_Y8e3-U46wjnH5K36I1XJnFwwU-eTQlG5JL87UobM,13495
+zrb/task/llm_task.py,sha256=m8B0dXsRZOo5h0FPEm3KJTEj378iAVpwxMMUfbZwTW0,13578
 zrb/task/make_task.py,sha256=PD3b_aYazthS8LHeJsLAhwKDEgdurQZpymJDKeN60u0,2265
 zrb/task/rsync_task.py,sha256=GSL9144bmp6F0EckT6m-2a1xG25AzrrWYzH4k3SVUKM,6370
 zrb/task/scaffolder.py,sha256=rME18w1HJUHXgi9eTYXx_T2G4JdqDYzBoNOkdOOo5-o,6806
@@ -332,7 +332,7 @@ zrb/util/file.py,sha256=mgNobIKCr0eIQUlg6W2Yg1fvg943VyuOUF8WMFpJA5A,859
 zrb/util/git.py,sha256=TShnMxPAk20Tglp25d_XPVZX-q0mvKeqdprVMeXQ5f0,4787
 zrb/util/git_subtree.py,sha256=zyWl0aUEZJyUJKjfw1uglozB4R1kF9pWtfKjhu8DN44,2658
 zrb/util/group.py,sha256=Bg7HrSycoK110U5s_Tca6-uUQuZ5CMgb8wxZSrvDQ98,2790
-zrb/util/load.py,sha256=m0e5DVLV7_RON6AZdjkquPym6BBrvYBbDMrllV44Y_k,1993
+zrb/util/load.py,sha256=Aeyh1EWtp-oJGVAhcjZn-VSB9innoOe8ZkUawha_ddk,1339
 zrb/util/run.py,sha256=DGHUP9x1Q8V8UF3FbpmjLGuhVVCCLfjTH2teT8qXlNI,207
 zrb/util/string/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/util/string/conversion.py,sha256=636sfF1a3_bpzXNw5bdSzbJzwakyAoo70KT3_ItgZEo,4333
@@ -341,7 +341,7 @@ zrb/util/string/name.py,sha256=8picJfUBXNpdh64GNaHv3om23QHhUZux7DguFLrXHp8,1163
 zrb/util/todo.py,sha256=1nDdwPc22oFoK_1ZTXyf3638Bg6sqE2yp_U4_-frHoc,16015
 zrb/xcom/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/xcom/xcom.py,sha256=o79rxR9wphnShrcIushA0Qt71d_p3ZTxjNf7x9hJB78,1571
-zrb-1.4.0.dist-info/METADATA,sha256=9IBDp38-en6FVpqq2RUd4qMo7c138HImysJXzd6-kwg,6291
-zrb-1.4.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-zrb-1.4.0.dist-info/entry_points.txt,sha256=-Pg3ElWPfnaSM-XvXqCxEAa-wfVI6BEgcs386s8C8v8,46
-zrb-1.4.0.dist-info/RECORD,,
+zrb-1.4.2.dist-info/METADATA,sha256=P5W8EKRiKGR4QNCpW0dtC-NJEXxoMfuTz9uHCwgY2WU,8096
+zrb-1.4.2.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+zrb-1.4.2.dist-info/entry_points.txt,sha256=-Pg3ElWPfnaSM-XvXqCxEAa-wfVI6BEgcs386s8C8v8,46
+zrb-1.4.2.dist-info/RECORD,,