zrb 1.9.7__tar.gz → 1.9.8__tar.gz

{zrb-1.9.7 → zrb-1.9.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: zrb
-Version: 1.9.7
+Version: 1.9.8
 Summary: Your Automation Powerhouse
 Home-page: https://github.com/state-alchemists/zrb
 License: AGPL-3.0-or-later

{zrb-1.9.7 → zrb-1.9.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "zrb"
-version = "1.9.7"
+version = "1.9.8"
 description = "Your Automation Powerhouse"
 authors = ["Go Frendi Gunawan <gofrendiasgard@gmail.com>"]
 license = "AGPL-3.0-or-later"

{zrb-1.9.7 → zrb-1.9.8}/src/zrb/config/config.py

@@ -277,7 +277,7 @@ class Config:
 
     @property
     def LLM_HISTORY_SUMMARIZATION_TOKEN_THRESHOLD(self) -> int:
-        return int(os.getenv("ZRB_LLM_HISTORY_SUMMARIZATION_TOKEN_THRESHOLD", "3000"))
+        return int(os.getenv("ZRB_LLM_HISTORY_SUMMARIZATION_TOKEN_THRESHOLD", "20000"))
 
     @property
     def LLM_ENRICH_CONTEXT(self) -> bool:
@@ -285,7 +285,7 @@ class Config:
 
     @property
     def LLM_CONTEXT_ENRICHMENT_TOKEN_THRESHOLD(self) -> int:
-        return int(os.getenv("ZRB_LLM_CONTEXT_ENRICHMENT_TOKEN_THRESHOLD", "3000"))
+        return int(os.getenv("ZRB_LLM_CONTEXT_ENRICHMENT_TOKEN_THRESHOLD", "20000"))
 
     @property
     def LLM_HISTORY_DIR(self) -> str:

{zrb-1.9.7 → zrb-1.9.8}/src/zrb/config/llm_config.py

@@ -15,47 +15,69 @@ DEFAULT_PERSONA = (
 DEFAULT_INTERACTIVE_SYSTEM_PROMPT = (
     "This is an interactive CLI session. Your standard response format is\n"
     "GitHub-flavored Markdown. You MUST follow this thinking process:\n\n"
-    "1.  **Analyze Request:** Use the `Scratchpad` and `Narrative Summary` to\n"
-    "    fully understand the user's request in the context of the\n"
-    "    conversation.\n\n"
-    "2.  **Plan & Verify Pre-conditions:** Create a step-by-step plan. Before\n"
+    "1.  **Analyze Request, Scope & Identify Gaps:** Use the `Scratchpad`\n"
+    "    and `Narrative Summary` to fully understand the user's request.\n"
+    "    - **Determine Scope:** Critically assess if the request is a\n"
+    "      one-time command or a standing order that should affect future\n"
+    "      interactions (e.g., 'From now on...'). Resolve contextual\n"
+    "      references like 'it' or 'that' to the immediate topic.\n"
+    "    - **Identify Gaps:** Assess if you have enough information to\n"
+    "      proceed. If not, identify the missing information as an\n"
+    "      'information gap'.\n\n"
+    "2.  **Fill Information Gaps:** Before planning, you MUST proactively use\n"
+    "    your tools to fill any identified information gaps. Be persistent.\n"
+    "    If one tool or approach fails, try another until you have the\n"
+    "    necessary information or determine it's impossible to obtain.\n\n"
+    "3.  **Plan & Verify Pre-conditions:** Create a step-by-step plan. Before\n"
     "    executing, use read-only tools to check the current state. For\n"
     "    example, if the plan is to create a file, check if it already\n"
     "    exists. If pre-conditions are not as expected, inform the user.\n\n"
-    "3.  **Assess Consent & Execute:**\n"
+    "4.  **Assess Consent & Execute:**\n"
+    "    - **You have standing consent to use any read-only tools** for\n"
+    "      information gathering, planning, and verification. You do not\n"
+    "      need to ask for permission for these actions.\n"
     "    - If the user's last instruction was an explicit command (e.g.,\n"
     '      "create file X", "delete Y"), you have consent. Proceed with the\n'
     "      action.\n"
     '    - If the request was general (e.g., "fix the bug") and your plan\n'
     "      involves a potentially altering action, you MUST explain the\n"
     "      action and ask for user approval before proceeding.\n\n"
-    "4.  **Verify Outcome:** After executing the action, use read-only tools to\n"
+    "5.  **Verify Outcome:** After executing the action, use read-only tools to\n"
     "    confirm it was successful. Report the outcome to the user.\n\n"
-    "For software engineering tasks, you MUST follow the guidelines in the\n"
-    "`DEFAULT_SPECIAL_INSTRUCTION_PROMPT`."
 ).strip()
 
 DEFAULT_SYSTEM_PROMPT = (
     "This is a one-shot CLI session. Your final answer MUST be in\n"
     "GitHub-flavored Markdown. You MUST follow this thinking process:\n\n"
-    "1.  **Analyze Request:** Use the `Scratchpad` and `Narrative Summary` to\n"
-    "    fully understand the user's request in the context of the\n"
-    "    conversation.\n\n"
-    "2.  **Plan & Verify Pre-conditions:** Create a step-by-step plan. Before\n"
+    "1.  **Analyze Request, Scope & Identify Gaps:** Use the `Scratchpad`\n"
+    "    and `Narrative Summary` to fully understand the user's request.\n"
+    "    - **Determine Scope:** Critically assess if the request is a\n"
+    "      one-time command or a standing order that should affect future\n"
+    "      interactions (e.g., 'From now on...'). Resolve contextual\n"
+    "      references like 'it' or 'that' to the immediate topic.\n"
+    "    - **Identify Gaps:** Assess if you have enough information to\n"
+    "      proceed. If not, identify the missing information as an\n"
+    "      'information gap'.\n\n"
+    "2.  **Fill Information Gaps:** Before planning, you MUST proactively use\n"
+    "    your tools to fill any identified information gaps. Be persistent.\n"
+    "    If one tool or approach fails, try another until you have the\n"
+    "    necessary information or determine it's impossible to obtain.\n\n"
+    "3.  **Plan & Verify Pre-conditions:** Create a step-by-step plan. Before\n"
     "    executing, use read-only tools to check the current state. For\n"
     "    example, if the plan is to create a file, check if it already\n"
     "    exists. If pre-conditions are not as expected, state that and stop.\n\n"
-    "3.  **Assess Consent & Execute:**\n"
+    "4.  **Assess Consent & Execute:**\n"
+    "    - **You have standing consent to use any read-only tools** for\n"
+    "      information gathering, planning, and verification. You do not\n"
+    "      need to ask for permission for these actions.\n"
     "    - If the user's last instruction was an explicit command (e.g.,\n"
     '      "create file X", "delete Y"), you have consent. Proceed with the\n'
     "      action.\n"
     '    - If the request was general (e.g., "fix the bug") and your plan\n'
     "      involves a potentially altering action, you MUST explain the\n"
     "      action and ask for user approval before proceeding.\n\n"
-    "4.  **Verify Outcome:** After executing the action, use read-only tools to\n"
+    "5.  **Verify Outcome:** After executing the action, use read-only tools to\n"
     "    confirm it was successful. Report the outcome to the user.\n\n"
-    "For software engineering tasks, you MUST follow the guidelines in the\n"
-    "`DEFAULT_SPECIAL_INSTRUCTION_PROMPT`."
 ).strip()
 
 DEFAULT_SPECIAL_INSTRUCTION_PROMPT = (
@@ -157,22 +179,32 @@ DEFAULT_CONTEXT_ENRICHMENT_PROMPT = (
     "3.  **Re-write:** Create the new 'Long-Term Context' by applying these\n"
     "    changes.\n\n"
     "**CRITICAL CURATION RULES:**\n"
+    "- **Do Not Assume Permanence:** A one-time request (e.g., 'Write it in\n"
+    "  JSON') is NOT a permanent preference. Only save preferences that are\n"
+    "  explicitly stated as long-term (e.g., 'From now on, always...').\n"
     "- **The context MUST NOT grow indefinitely.** Your primary goal is to\n"
     "  keep it concise and relevant to the *current* state of the\n"
     "  conversation.\n"
-    "- **ADD** new, stable facts (e.g., long-term user preferences).\n"
-    "- **UPDATE** existing facts if the user provides new information.\n"
+    "- **ADD** new, explicitly stable facts (e.g., long-term user\n"
+    "  preferences).\n"
+    "- **UPDATE** existing facts if the user provides new information or if\n"
+    "  new information overrides the previous one.\n"
     "- **REMOVE** goals, tasks, or files that are completed or no longer\n"
     "  relevant. Be aggressive in pruning irrelevant information.\n"
     "- **CONDENSE** older entries that are still relevant but not the\n"
     "  immediate focus. For example, a completed high-level goal might be\n"
-    "  condensed into a single 'Past Accomplishments' line item.\n\n"
+    "  condensed into a single 'Past Accomplishments' line item.\n"
+    "- **Prioritize Information Above All:** The extraction and retention of\n"
+    "  information vital to the conversation's continuity and success\n"
+    "  outweighs all other considerations. No detail, fact, or nuance should\n"
+    "  be discarded if it could be useful.\n\n"
     "**A Note on Dynamic Information:**\n"
-    "Be mindful that some information is temporary. Details like the current\n"
-    "working directory, project context, or file contents can change\n"
-    "frequently. The main assistant MUST NOT assume this information is\n"
-    "current and should always use its tools to verify the latest state when\n"
-    "needed."
+    "Be mindful that some information is temporary and highly dynamic (e.g.,\n"
+    "current weather, location, current working directory, project context,\n"
+    "or file contents). You MUST add a note to this kind of information,\n"
+    "for example: `(short-term, must be re-verified)`.\n"
+    "The main assistant MUST NOT assume this information is current and\n"
+    "should always use its tools to verify the latest state when needed."
 ).strip()
 
 

{zrb-1.9.7 → zrb-1.9.8}/src/zrb/task/llm_task.py

@@ -262,7 +262,7 @@ class LLMTask(BaseTask):
             should_enrich_context_attr=self._should_enrich_context,
             render_enrich_context=self._render_enrich_context,
             context_enrichment_token_threshold_attr=self._context_enrichment_token_threshold,
-            render_context_enrichment_token_threshold=self._render_context_enrichment_token_threshold,
+            render_context_enrichment_token_threshold=self._render_context_enrichment_token_threshold,  # noqa
             model=model,
             model_settings=model_settings,
             context_enrichment_prompt=context_enrichment_prompt,
@@ -274,7 +274,7 @@ class LLMTask(BaseTask):
             conversation_summary=conversation_summary,
             should_summarize_history_attr=self._should_summarize_history,
             render_summarize_history=self._render_summarize_history,
-            history_summarization_token_threshold_attr=self._history_summarization_token_threshold,
+            history_summarization_token_threshold_attr=self._history_summarization_token_threshold,  # noqa
             render_history_summarization_token_threshold=(
                 self._render_history_summarization_token_threshold
             ),
@@ -364,134 +364,3 @@ class LLMTask(BaseTask):
         except Exception as e:
             ctx.log_error(f"Error during agent execution or history saving: {str(e)}")
             raise  # Re-raise the exception after logging
-
-
-def llm_task(
-    name: str,
-    color: int | None = None,
-    icon: str | None = None,
-    description: str | None = None,
-    cli_only: bool = False,
-    input: list[AnyInput | None] | AnyInput | None = None,
-    env: list[AnyEnv | None] | AnyEnv | None = None,
-    model: "Callable[[AnySharedContext], Model | str | fstring] | Model | None" = None,
-    render_model: bool = True,
-    model_base_url: StrAttr | None = None,
-    render_model_base_url: bool = True,
-    model_api_key: StrAttr | None = None,
-    render_model_api_key: bool = True,
-    model_settings: "ModelSettings | Callable[[AnySharedContext], ModelSettings] | None" = None,
-    agent: "Agent | Callable[[AnySharedContext], Agent] | None" = None,
-    persona: StrAttr | None = None,
-    system_prompt: StrAttr | None = None,
-    special_instruction_prompt: StrAttr | None = None,
-    message: StrAttr | None = None,
-    render_message: bool = True,
-    enrich_context: BoolAttr | None = None,
-    render_enrich_context: bool = True,
-    context_enrichment_prompt: StrAttr | None = None,
-    render_context_enrichment_prompt: bool = True,
-    context_enrichment_token_threshold: IntAttr | None = None,
-    render_context_enrichment_token_threshold: bool = True,
-    tools: (
-        list["ToolOrCallable"] | Callable[[AnySharedContext], list["ToolOrCallable"]]
-    ) = [],
-    mcp_servers: (
-        list["MCPServer"] | Callable[[AnySharedContext], list["MCPServer"]]
-    ) = [],
-    conversation_history: (
-        ConversationHistoryData
-        | Callable[[AnySharedContext], ConversationHistoryData | dict | list]
-        | dict
-        | list
-    ) = ConversationHistoryData(),
-    conversation_history_reader: (
-        Callable[[AnySharedContext], ConversationHistoryData | dict | list | None]
-        | None
-    ) = None,
-    conversation_history_writer: (
-        Callable[[AnySharedContext, ConversationHistoryData], None] | None
-    ) = None,
-    conversation_history_file: StrAttr | None = None,
-    render_history_file: bool = True,
-    summarize_history: BoolAttr | None = None,
-    render_summarize_history: bool = True,
-    summarization_prompt: StrAttr | None = None,
-    history_summarization_token_threshold: IntAttr | None = None,
-    render_history_summarization_token_threshold: bool = True,
-    rate_limitter: LLMRateLimiter | None = None,
-    execute_condition: bool | str | Callable[[AnySharedContext], bool] = True,
-    retries: int = 2,
-    retry_period: float = 0,
-    readiness_check: list[AnyTask] | AnyTask | None = None,
-    readiness_check_delay: float = 0.5,
-    readiness_check_period: float = 5,
-    readiness_failure_threshold: int = 1,
-    readiness_timeout: int = 60,
-    monitor_readiness: bool = False,
-    max_call_iteration: int = 20,
-    upstream: list[AnyTask] | AnyTask | None = None,
-    fallback: list[AnyTask] | AnyTask | None = None,
-    successor: list[AnyTask] | AnyTask | None = None,
-    conversation_context: (
-        dict[str, Any] | Callable[[AnySharedContext], dict[str, Any]] | None
-    ) = None,
-) -> LLMTask:
-    """
-    Create a new LLM task.
-    """
-    return LLMTask(
-        name=name,
-        color=color,
-        icon=icon,
-        description=description,
-        cli_only=cli_only,
-        input=input,
-        env=env,
-        model=model,
-        render_model=render_model,
-        model_base_url=model_base_url,
-        render_model_base_url=render_model_base_url,
-        model_api_key=model_api_key,
-        render_model_api_key=render_model_api_key,
-        model_settings=model_settings,
-        agent=agent,
-        persona=persona,
-        system_prompt=system_prompt,
-        special_instruction_prompt=special_instruction_prompt,
-        message=message,
-        render_message=render_message,
-        enrich_context=enrich_context,
-        render_enrich_context=render_enrich_context,
-        context_enrichment_prompt=context_enrichment_prompt,
-        render_context_enrichment_prompt=render_context_enrichment_prompt,
-        context_enrichment_token_threshold=context_enrichment_token_threshold,
-        render_context_enrichment_token_threshold=render_context_enrichment_token_threshold,
-        tools=tools,
-        mcp_servers=mcp_servers,
-        conversation_history=conversation_history,
-        conversation_history_reader=conversation_history_reader,
-        conversation_history_writer=conversation_history_writer,
-        conversation_history_file=conversation_history_file,
-        render_history_file=render_history_file,
-        summarize_history=summarize_history,
-        render_summarize_history=render_summarize_history,
-        summarization_prompt=summarization_prompt,
-        history_summarization_token_threshold=history_summarization_token_threshold,
-        render_history_summarization_token_threshold=render_history_summarization_token_threshold,
-        rate_limitter=rate_limitter,
-        execute_condition=execute_condition,
-        retries=retries,
-        retry_period=retry_period,
-        readiness_check=readiness_check,
-        readiness_check_delay=readiness_check_delay,
-        readiness_check_period=readiness_check_period,
-        readiness_failure_threshold=readiness_failure_threshold,
-        readiness_timeout=readiness_timeout,
-        monitor_readiness=monitor_readiness,
-        max_call_iteration=max_call_iteration,
-        upstream=upstream,
-        fallback=fallback,
-        successor=successor,
-        conversation_context=conversation_context,
-    )