lionagi 0.5.2__tar.gz → 0.5.3__tar.gz

{lionagi-0.5.2 → lionagi-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lionagi
-Version: 0.5.2
+Version: 0.5.3
 Summary: An AGentic Intelligence Operating System.
 Author-email: HaiyangLi <quantocean.li@gmail.com>
 License:            Apache License
@@ -336,7 +336,7 @@ pplx_small = iModel(
 b = await hunter.communicate(
     instruction="What makes a well-behaved dragon?",
     clear_messages=True,            # refresh the conversation
-    imodel=pplx_small,                  # use sonnet model
+    imodel=pplx_small,              # use perplexity model
 )
 
 print(b)

{lionagi-0.5.2 → lionagi-0.5.3}/README.md

@@ -107,7 +107,7 @@ pplx_small = iModel(
 b = await hunter.communicate(
     instruction="What makes a well-behaved dragon?",
     clear_messages=True,            # refresh the conversation
-    imodel=pplx_small,                  # use sonnet model
+    imodel=pplx_small,              # use perplexity model
 )
 
 print(b)

{lionagi-0.5.2 → lionagi-0.5.3}/lionagi/__init__.py

@@ -4,7 +4,8 @@ import logging
 
 from dotenv import load_dotenv
 
-from .core.session.types import Branch
+from .core.session.types import Branch, Session
+from .integrations.litellm_.imodel import LiteiModel
 from .protocols.operatives.step import Step
 from .service import iModel
 from .settings import Settings
@@ -20,6 +21,8 @@ __all__ = [
     "LiteiModel",
     "Branch",
     "Step",
+    "Session",
+    "LiteiModel",
 ]
 
 logger = logging.getLogger(__name__)

{lionagi-0.5.2 → lionagi-0.5.3}/lionagi/core/session/branch.py

@@ -9,6 +9,7 @@ from pydantic import model_validator
 
 from lionagi.core.generic.types import Component, LogManager, Pile, Progression
 from lionagi.core.typing import ID
+from lionagi.integrations.litellm_.imodel import LiteiModel
 from lionagi.protocols.operatives.instruct import Instruct, OperationInstruct
 from lionagi.service import iModel
 from lionagi.settings import Settings
@@ -24,8 +25,8 @@ class Branch(Component, BranchActionMixin, BranchOperationMixin):
     name: str | None = None
     msgs: MessageManager = None
     acts: ActionManager = None
-    imodel: iModel | None = None
-    parse_imodel: iModel | None = None
+    imodel: iModel | LiteiModel | None = None
+    parse_imodel: iModel | LiteiModel | None = None
 
     @model_validator(mode="before")
     def _validate_data(cls, data: dict) -> dict:

{lionagi-0.5.2 → lionagi-0.5.3}/lionagi/operations/brainstorm/brainstorm.py

@@ -6,7 +6,7 @@
 from lionagi.core.session.branch import Branch
 from lionagi.core.session.session import Session
 from lionagi.core.typing import ID, Any, BaseModel
-from lionagi.libs.func import alcall
+from lionagi.libs.func.types import alcall
 from lionagi.libs.parse import to_flat_list
 from lionagi.protocols.operatives.instruct import (
     INSTRUCT_FIELD_MODEL,

lionagi-0.5.3/lionagi/operations/brainstorm/prompt.py

@@ -0,0 +1,8 @@
+PROMPT = """Perform a brainstorm session. Generate {num_instruct} concise and distinct instructions (Instruct), each representing a potential next step. We will run them in parallel under the same context. Ensure each idea:
+
+1. Adheres to project guidelines and standards.
+2. Maintains a unique perspective or approach.
+3. Remains succinct yet sufficiently detailed.
+4. Flags any step that needs deeper expansion.
+
+Aim for clarity, practicality, and adherence to the project's core principles."""

lionagi-0.5.3/lionagi/operations/plan/prompt.py

@@ -0,0 +1,22 @@
+PLAN_PROMPT = """
+Develop a high-level plan containing {num_steps} distinct steps. Each step must:
+1. Represent a clear milestone or phase.
+2. Follow a logical sequence, respecting inter-step dependencies.
+3. Differ clearly from other steps.
+4. Have measurable completion criteria.
+5. Be open to further breakdown if needed.
+
+Keep each step concise yet actionable, ensuring the overall plan remains coherent.
+"""
+
+EXPANSION_PROMPT = """
+Transform each high-level plan step into detailed, executable actions. For every step:
+
+1. Keep actions atomic, verifiable, and clearly scoped.
+2. Include essential context and preconditions.
+3. Define expected outcomes, success criteria, and validations.
+4. Respect sequential dependencies and error handling.
+5. Provide all necessary parameters and specify outputs.
+
+Ensure each action is self-contained yet fits within the larger plan.
+"""

{lionagi-0.5.2 → lionagi-0.5.3}/lionagi/protocols/operatives/instruct.py

@@ -14,11 +14,8 @@ from lionagi.libs.parse import validate_boolean
 
 from .prompts import (
     actions_field_description,
-    context_examples,
     context_field_description,
-    guidance_examples,
     guidance_field_description,
-    instruction_examples,
     instruction_field_description,
     reason_field_description,
 )
@@ -62,7 +59,6 @@ INSTRUCTION_FIELD = FieldModel(
     default=None,
     title="Primary Instruction",
     description=instruction_field_description,
-    examples=instruction_examples,
     validator=validate_instruction,
     validator_kwargs={"mode": "before"},
 )
@@ -73,7 +69,6 @@ GUIDANCE_FIELD = FieldModel(
     default=None,
     title="Execution Guidance",
     description=guidance_field_description,
-    examples=guidance_examples,
 )
 
 CONTEXT_FIELD = FieldModel(
@@ -82,7 +77,6 @@ CONTEXT_FIELD = FieldModel(
     default=None,
     title="Task Context",
     description=context_field_description,
-    examples=context_examples,
 )
 
 REASON_FIELD = FieldModel(

lionagi-0.5.3/lionagi/protocols/operatives/prompts.py

@@ -0,0 +1,83 @@
+# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+#
+# SPDX-License-Identifier: Apache-2.0
+
+function_field_description = (
+    "Name of the function to call from the provided `tool_schemas`. "
+    "If no `tool_schemas` exist, set to None or leave blank. "
+    "Never invent new function names outside what's given."
+)
+
+arguments_field_description = (
+    "Dictionary of arguments for the chosen function. "
+    "Use only argument names/types defined in `tool_schemas`. "
+    "Never introduce extra argument names."
+)
+
+action_required_field_description = (
+    "Whether this step strictly requires performing actions. "
+    "If true, the requests in `action_requests` must be fulfilled, "
+    "assuming `tool_schemas` are available. "
+    "If false or no `tool_schemas` exist, actions are optional."
+)
+
+action_requests_field_description = (
+    "List of actions to be executed when `action_required` is true. "
+    "Each action must align with the available `tool_schemas`. "
+    "Leave empty if no actions are needed."
+)
+
+confidence_description = (
+    "Numeric confidence score (0.0 to 1.0, up to three decimals) indicating "
+    "how well you've met user expectations. Use this guide:\n"
+    "  • 1.0: Highly confident\n"
+    "  • 0.8-1.0: Reasonably sure\n"
+    "  • 0.5-0.8: Re-check or refine\n"
+    "  • 0.0-0.5: Off track"
+)
+
+instruction_field_description = (
+    "A clear, actionable task definition. Specify:\n"
+    "1) The primary goal or objective\n"
+    "2) Key success criteria or constraints\n"
+    "\n"
+    "Guidelines:\n"
+    "- Start with a direct action verb (e.g., 'Analyze', 'Generate', 'Create')\n"
+    "- Include scope, boundaries, or constraints\n"
+    "- Provide success criteria if relevant\n"
+    "- For complex tasks, break them into logical steps"
+)
+
+guidance_field_description = (
+    "Strategic direction and constraints for executing the task. "
+    "Include:\n"
+    "1) Preferred methods or frameworks\n"
+    "2) Quality benchmarks (e.g., speed, clarity)\n"
+    "3) Resource or environmental constraints\n"
+    "4) Relevant compliance or standards\n"
+    "Use None if no special guidance."
+)
+
+context_field_description = (
+    "Background information and current-state data needed for the task. "
+    "Should be:\n"
+    "1) Directly relevant\n"
+    "2) Sufficient to perform the task\n"
+    "3) Free of extraneous detail\n"
+    "Include environment, prior outcomes, system states, or dependencies. "
+    "Use None if no additional context is needed."
+)
+
+reason_field_description = (
+    "Include a thoughtful explanation of decisions, trade-offs, "
+    "and insights. Encourage deeper introspection on why certain "
+    "choices were made, potential alternatives, and how confidence "
+    "was shaped. If not needed, set to None."
+)
+
+actions_field_description = (
+    "Controls execution mode. "
+    "True: Execute specified actions. "
+    "False: Analysis/recommendations only. "
+    "None: Contextual execution."
+)

lionagi-0.5.3/lionagi/version.py

@@ -0,0 +1 @@
+__version__ = "0.5.3"

{lionagi-0.5.2 → lionagi-0.5.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lionagi"
-version = "0.5.2"
+version = "0.5.3"
 description = "An AGentic Intelligence Operating System."
 authors = [
     { name = "HaiyangLi", email = "quantocean.li@gmail.com" },