lionagi 0.5.2__py3-none-any.whl → 0.5.4__py3-none-any.whl

lionagi/protocols/operatives/prompts.py

@@ -2,235 +2,82 @@
 #
 # SPDX-License-Identifier: Apache-2.0
 
-from pydantic import JsonValue
-
 function_field_description = (
-    "Specify the name of the function to execute. **Choose "
-    "from the provided `tool_schemas`; do not invent function names.**"
-    "Only provide function names if tool_schemas are provided. Otherwise, "
-    "must leave blank or set to None."
+    "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 = (
-    "Provide the arguments to pass to the function as a "
-    "dictionary. **Use argument names and types as specified in the "
-    "`tool_schemas`; do not invent argument names.**"
+    "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 = (
-    "Specify whether the step requires actions to be "
-    "performed. If **True**, the actions in `action_requests` "
-    "must be performed. If **False**, the actions in "
-    "`action_requests` are optional. If no tool_schemas"
-    " are provided, this field is ignored."
+    "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 performed if `action_required` "
-    "is **True**. Leave empty if no action is required. "
-    "**When providing actions, you must choose from the "
-    "provided `tool_schemas`. Do not invent function or "
-    "argument names.**"
+    "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 = (
-    "Provide an objective numeric confidence score between 0 and 1 (with 3 "
-    "decimal places) indicating how likely you successfully achieved the task"
-    " according to user expectation. Interpret the score as:\n"
-    "- **1**: Very confident in a good job.\n"
-    "- **0**: Not confident at all.\n"
-    "- **[0.8, 1]**: You can continue the path of reasoning if needed.\n"
-    "- **[0.5, 0.8)**: Recheck your reasoning and consider reverting to a "
-    "previous, more confident reasoning path.\n"
-    "- **[0, 0.5)**: Stop because the reasoning is starting to be off track."
+    "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 = (
-    "Define the core task or instruction to be executed. Your instruction should:\n\n"
-    "1. Be specific and actionable\n"
-    "2. Clearly state the expected outcome\n"
-    "3. Include any critical constraints or requirements\n\n"
-    "**Guidelines for writing effective instructions:**\n"
-    "- Start with a clear action verb (e.g., analyze, create, evaluate)\n"
-    "- Specify the scope and boundaries of the task\n"
-    "- Include success criteria when applicable\n"
-    "- Break complex tasks into distinct steps\n\n"
-    "**Examples:**\n"
-    "- 'Analyze the provided sales data and identify top 3 performing products'\n"
-    "- 'Generate a Python function that validates email addresses'\n"
-    "- 'Create a data visualization showing monthly revenue trends'"
+    "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 = (
-    "Provide strategic direction and constraints for task execution.\n\n"
-    "**Key components to include:**\n"
-    "1. Methodological preferences\n"
-    "2. Quality standards and requirements\n"
-    "3. Specific limitations or boundaries\n"
-    "4. Performance expectations\n\n"
-    "**Best practices:**\n"
-    "- Be explicit about any assumptions that should be made\n"
-    "- Specify preferred approaches or techniques\n"
-    "- Detail any constraints on resources or methods\n"
-    "- Include relevant standards or compliance requirements\n\n"
-    "Leave as None if no specific guidance is needed beyond the instruction."
+    "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 = (
-    "Supply essential background information and current state data required for "
-    "task execution.\n\n"
-    "**Include relevant details about:**\n"
-    "1. Environmental conditions\n"
-    "2. Historical context\n"
-    "3. Related systems or processes\n"
-    "4. Previous outcomes or decisions\n\n"
-    "**Context should:**\n"
-    "- Be directly relevant to the task\n"
-    "- Provide necessary background without excess detail\n"
-    "- Include any dependencies or prerequisites\n"
-    "- Specify the current state of the system\n\n"
-    "Set to None if no additional context is required."
+    "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 = (
-    "Control whether detailed reasoning should be included in the response.\n\n"
-    "**When set to True:**\n"
-    "- Must include a ReasonModel explaining decision rationale\n"
-    "- Should detail key decision points\n"
-    "- Must provide confidence scores for decisions\n"
-    "- Should explain trade-offs considered\n\n"
-    "**When set to False:**\n"
-    "- Skip detailed reasoning\n"
-    "- Focus on direct results\n"
-    "- Omit confidence scoring\n\n"
-    "Set to None to make reasoning optional based on context."
+    "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 = (
-    "Specify whether concrete actions should be taken as part of task execution.\n\n"
-    "**When set to True:**\n"
-    "- Must include appropriate ActionRequestModels\n"
-    "- Actions should directly relate to task goals\n"
-    "- Each action must be properly structured and validated\n"
-    "- Actions must use available tool schemas\n\n"
-    "**When set to False:**\n"
-    "- No actions should be included\n"
-    "- Focus on analysis and recommendations\n\n"
-    "Set to None to make actions optional based on requirements."
-)
-
-# Example structures for each field to demonstrate proper formatting
-instruction_examples: list[JsonValue] = [
-    "Analyze the dataset 'sales_2023.csv' and identify revenue trends",
-    "Create a Python function to process customer feedback data",
-    {
-        "task": "data_analysis",
-        "target": "sales_performance",
-        "scope": ["revenue", "growth", "seasonality"],
-    },
-]
-
-guidance_examples: list[JsonValue] = [
-    "Use statistical methods for trend analysis",
-    "Optimize for readability and maintainability",
-    {
-        "methods": ["regression", "time_series"],
-        "constraints": {"memory": "2GB", "time": "5min"},
-    },
-]
-
-context_examples: list[JsonValue] = [
-    "Previous analysis showed seasonal patterns",
-    {
-        "prior_results": {"accuracy": 0.95},
-        "system_state": "production",
-        "dependencies": ["numpy", "pandas"],
-    },
-]
-
-"""Field description for InstructModel."""
-
-instruct_model_description = (
-    "Generate structured instructions for task execution.\n\n"
-    "**Key Components:**\n"
-    "1. Task Definition: Clear description of what needs to be accomplished\n"
-    "2. Execution Parameters: How the task should be performed\n"
-    "3. Success Criteria: What constitutes successful completion\n"
-    "4. Scope and Boundaries: Limits and constraints of the task\n\n"
-    "**Structure Guidelines:**\n"
-    "- `instruction`: Core task or objective to accomplish\n"
-    "- `guidance`: Parameters, preferences, and constraints\n"
-    "- `context`: Relevant background and environmental information\n"
-    "- `reason`: Whether to include reasoning in output\n"
-    "- `actions`: Whether specific actions are required\n\n"
-    "**Best Practices:**\n"
-    "- Keep instructions clear and specific\n"
-    "- Provide necessary but not excessive detail\n"
-    "- Define measurable outcomes\n"
-    "- Include relevant dependencies\n"
-    "- Specify critical constraints\n\n"
-    "**Common Issues to Avoid:**\n"
-    "- Vague or ambiguous directives\n"
-    "- Missing essential context\n"
-    "- Undefined success criteria\n"
-    "- Incomplete requirements\n"
-    "- Conflicting parameters\n\n"
-    "Structure instructions to enable successful task execution while maintaining "
-    "appropriate flexibility for implementation details."
+    "Controls execution mode. "
+    "True: Execute specified actions. "
+    "False: Analysis/recommendations only. "
+    "None: Contextual execution."
 )
-
-instruct_model_examples = [
-    {
-        "instruction": "Process the input data according to specified requirements",
-        "guidance": {
-            "requirements": ["validation", "transformation", "aggregation"],
-            "output_format": "structured_report",
-            "quality_metrics": ["accuracy", "completeness"],
-        },
-        "context": {
-            "input_source": "data_stream",
-            "domain": "general",
-            "priority": "standard",
-        },
-        "reason": True,
-        "actions": True,
-    },
-    {
-        "instruction": "Evaluate system performance against baseline metrics",
-        "guidance": {
-            "evaluation_criteria": [
-                "response_time",
-                "resource_usage",
-                "error_rate",
-            ],
-            "methodology": "standard",
-            "reporting": "detailed",
-        },
-        "context": {
-            "environment": "test",
-            "criticality": "medium",
-            "constraints": {"time": "bounded"},
-        },
-        "reason": True,
-        "actions": False,
-    },
-]
-
-
-__all__ = [
-    "function_field_description",
-    "arguments_field_description",
-    "action_required_field_description",
-    "action_requests_field_description",
-    "confidence_description",
-    "instruction_field_description",
-    "guidance_field_description",
-    "context_field_description",
-    "reason_field_description",
-    "actions_field_description",
-    "instruction_examples",
-    "guidance_examples",
-    "context_examples",
-    "instruct_model_description",
-    "instruct_model_examples",
-]

lionagi/version.py

@@ -1 +1 @@
-__version__ = "0.5.2"
+__version__ = "0.5.4"

{lionagi-0.5.2.dist-info → lionagi-0.5.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lionagi
-Version: 0.5.2
+Version: 0.5.4
 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.dist-info → lionagi-0.5.4.dist-info}/RECORD

@@ -1,6 +1,6 @@
-lionagi/__init__.py,sha256=TGvl3bsM1uF2XANOQxClkDGdDt_u5MxXFMEvwEvaYDw,442
+lionagi/__init__.py,sha256=oybfu2VsZc4ElN7ZeaW3KQrz8T8EcSDHPA8lUE-8G2I,537
 lionagi/settings.py,sha256=BOjxRV4N9zQJervvajPhbaHmgZ-nhbCy7AaQJi3Avug,2726
-lionagi/version.py,sha256=isJrmDBLRag7Zc2UK9ZovWGOv7ji1Oh-zJtJMNJFkXw,22
+lionagi/version.py,sha256=DITpct-LrdIsTgwx2NgH5Ghx5y8Xgz1YMimy1ZV5RTY,22
 lionagi/core/__init__.py,sha256=v8vNyJVIVj8_Oz9RJdVe6ZKUQMYTgDh1VQpnr1KdLaw,112
 lionagi/core/_class_registry.py,sha256=srSWefqCS9EZrMvyA8zCrZ9KFvzAhTIj8g6mJG5KlIc,1982
 lionagi/core/action/__init__.py,sha256=v8vNyJVIVj8_Oz9RJdVe6ZKUQMYTgDh1VQpnr1KdLaw,112
@@ -54,9 +54,9 @@ lionagi/core/models/operable_model.py,sha256=zuXDjoNI2-jLFxp3XWITtzIv0-CQ6FO6DQy
 lionagi/core/models/schema_model.py,sha256=H2tSX3r0U6MDNi929rWmAZy3nUKMP47RG-Ma0O-QYNY,667
 lionagi/core/models/types.py,sha256=elcUuz_9dx4AhZddnICF-Cs62VJWIBqMET7MiRe4c1I,447
 lionagi/core/session/__init__.py,sha256=v8vNyJVIVj8_Oz9RJdVe6ZKUQMYTgDh1VQpnr1KdLaw,112
-lionagi/core/session/branch.py,sha256=KxdfUnwxLUZlDN5axEmyel86UZDQ6mK_-NB1EQvy6jY,4320
+lionagi/core/session/branch.py,sha256=r6yNXwTm0oYA-9YOereuvLJtDnhj9IJWJ5fjTyKN88U,4406
 lionagi/core/session/branch_mixins.py,sha256=C9lGHmD1AmXAePw0kGIeuZjZ7SzOrFcIwV6rVaGhoGg,19623
-lionagi/core/session/session.py,sha256=Uup50oMqs00ZH6zgEiqtk0pG_ANByHW_Ael07dfbT1M,5122
+lionagi/core/session/session.py,sha256=cutece_iTs5K_m5soRfU9oTfHmw1icDEvx77E1RelIM,5129
 lionagi/core/session/types.py,sha256=MUGTSa2HWK79p7z-CG22RFP07N5AKnPVNXZwZt_wIvU,202
 lionagi/core/typing/__init__.py,sha256=Y9BK1OUXzjQgIo3epCVwWqUYhFwQQ_ayhRwI1UOmINg,228
 lionagi/core/typing/_concepts.py,sha256=uIzqfwtPBsIREhvT7NDAowc4i-u-69n_DRzLHzvHZO4,3730
@@ -257,7 +257,7 @@ lionagi/libs/func/throttle.py,sha256=iOOmS6i81NGRCClf4WaIhMMXwPt_rZ6WXYBqMJ_weEE
 lionagi/libs/func/types.py,sha256=wdjGNmY82pVACQBuDMUt3XJO0G9_wKHR7VesOeMxo_A,831
 lionagi/libs/func/utils.py,sha256=-LMdUEjksXP6JjjcUBh0XEQiXF30Zmv3xpKbmXjfya8,2674
 lionagi/libs/func/async_calls/__init__.py,sha256=qDHIkH7B-Ka5NJqeeyu_YL3TY36xL8kBwTjtCR4H8AU,495
-lionagi/libs/func/async_calls/alcall.py,sha256=U8-lWwqNwhe50Q07kzyW4YVcbx_LkUN5X1K1zvFg7i0,7283
+lionagi/libs/func/async_calls/alcall.py,sha256=GhPXId0YLvfxpDSYOABwr_3D-nRu8aLWshaYboJQzmQ,7436
 lionagi/libs/func/async_calls/bcall.py,sha256=gwfKpRZkExjVn-1YGZfaboFES8RqUgyaBrdpNtz1IdY,4436
 lionagi/libs/func/async_calls/mcall.py,sha256=9O5gWbBT4iIqXfcdZjgAdqsOSLWrNS4_tt6ou231ozA,4607
 lionagi/libs/func/async_calls/pcall.py,sha256=6u3RJPV-3yOkWxC9iSoVFl1veFfZFJpR0QRyGtfBODI,5831
@@ -317,11 +317,11 @@ lionagi/libs/string_similarity/utils.py,sha256=NdD0qF5tuytWBsm0WMrH0gRBBSxw2p4-m
 lionagi/operations/__init__.py,sha256=Dt7o6DFP7zVR-uxZ4xsGHQcse3XVlF6S8Y9NhaUTn_4,68
 lionagi/operations/utils.py,sha256=kn5SkZRczl1aQ-vJBeVPlMdeyUUD0s5iyuAW4P6KOvQ,1164
 lionagi/operations/brainstorm/__init__.py,sha256=amsoH65wepsx58DfgH-TRTN1wDH5TC24qYI_f02zkVg,61
-lionagi/operations/brainstorm/brainstorm.py,sha256=fLTO5RFXHzGf7TDJXMV2tuPSYblPYtI52BCJnhHUoao,6273
-lionagi/operations/brainstorm/prompt.py,sha256=95t8SEEzaaEj0x0l5H5HsWaHSiPn-YqH9GaxaQYX0Dw,459
+lionagi/operations/brainstorm/brainstorm.py,sha256=1Uuc11OH34jEYfDdombX5ui9b-bJTn4bVSLt0jjQUIc,16747
+lionagi/operations/brainstorm/prompt.py,sha256=3a7LsmtiqGAK5mtWoX-2qhsjETBzBx8FxM3cFCBEoOo,497
 lionagi/operations/plan/__init__.py,sha256=SVqoVmlSGz9lsLztm487H2qOLwgyFxSi2yZ8ubn-bgE,43
-lionagi/operations/plan/plan.py,sha256=Ui8fFdRNLiD3RJmnKCwfY48yj0Fxxw2LBye0egYttWE,5611
-lionagi/operations/plan/prompt.py,sha256=ze79yFvZ_mBz4m-nS5ly9IK2PC43xl87_hfbwfj5jkw,763
+lionagi/operations/plan/plan.py,sha256=AX4h_TeyhcXag572ywN9rmvo3fEiuGER7skAKf25_LY,15329
+lionagi/operations/plan/prompt.py,sha256=sKHa_jDahzCJ60oILj1XNYCIlbS-H8ybKRXpf9zd5x0,880
 lionagi/operations/select/__init__.py,sha256=dUd-KS1l404_ueYlIQsVNhS9jAqjn5pJbtUEbbh6KlI,49
 lionagi/operations/select/prompt.py,sha256=wbmuDC96fcQ4LFKjqmeErOQwVRpGWRqcwUeLTWnbeNs,186
 lionagi/operations/select/select.py,sha256=2lQ8el8bQV1kaUF-r5IBfgaGhD2bvrLd9zwfqvcWYgk,3164
@@ -340,9 +340,9 @@ lionagi/protocols/configs/retry_config.py,sha256=pZwV-iV7YoyPpJgSJTbIXYjOKQjzudn
 lionagi/protocols/configs/types.py,sha256=8CFN8Lv6F0aJ4Xy7pslnpNTe18dBFaddvzOrAsZuOp0,383
 lionagi/protocols/operatives/__init__.py,sha256=v8vNyJVIVj8_Oz9RJdVe6ZKUQMYTgDh1VQpnr1KdLaw,112
 lionagi/protocols/operatives/action.py,sha256=cWIyehhB750Sp1w9jPTV-DXcQRLhCFNp2TXHysQvGLU,4854
-lionagi/protocols/operatives/instruct.py,sha256=WRtFi-bxgmymVNBU-nw6wpM2qcWcU7btCf2MFEC3Pq8,5311
+lionagi/protocols/operatives/instruct.py,sha256=XCIkNkuP0Dd7ZOnCpuC2iYuufW9_H8ue5imyqduqQgs,5142
 lionagi/protocols/operatives/operative.py,sha256=jGsnPSn7LeJE9H-fGjHYIY2N_QgclZpmch8tlshUMcg,6620
-lionagi/protocols/operatives/prompts.py,sha256=-ZGLS1Cbv1ll9-I-GIyAuqT01PRMwOhxcn4z3Ek3ibA,8984
+lionagi/protocols/operatives/prompts.py,sha256=JRJBPiAAccB50sGY2FDIDvSehfc-sCbYLgWmH4BUwBs,2978
 lionagi/protocols/operatives/reason.py,sha256=i5iIr0xdMISbrJ_u6fQO4MZy0aceX8nYcETVfHILh-8,1441
 lionagi/protocols/operatives/step.py,sha256=ePFmRyuJ0v_X9BVgzkFAv8afqnic6Zmjt4MGzlCeLpk,8155
 lionagi/protocols/operatives/types.py,sha256=SPFX2EHHoJF2ZMgxoJrNlf02QlcAk7ijup6kY5GhrK0,463
@@ -368,7 +368,7 @@ lionagi/strategies/sequential_chunk.py,sha256=jG_WZXG-Ra3yd30CmX4b3XeCNAUrZGA2-i
 lionagi/strategies/sequential_concurrent_chunk.py,sha256=H7GShaqYlD5XxNJMG2GdOR4Vl8JHDhZb5jxNq8zY0hI,3365
 lionagi/strategies/types.py,sha256=fEvE4d1H4SeCcXcd2dz3q4k8jFIBtxYzjxDN7eJRLtI,769
 lionagi/strategies/utils.py,sha256=DX1dvxia8cNRqEJJbssJ3mgRzo7kgWCTA4y5DYLCCZE,1281
-lionagi-0.5.2.dist-info/METADATA,sha256=V8Q9Mtjss6_gk1rH4myIQa-HMUw66XV4S3GRa54p9WY,22736
-lionagi-0.5.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-lionagi-0.5.2.dist-info/licenses/LICENSE,sha256=VXFWsdoN5AAknBCgFqQNgPWYx7OPp-PFEP961zGdOjc,11288
-lionagi-0.5.2.dist-info/RECORD,,
+lionagi-0.5.4.dist-info/METADATA,sha256=or-K2I6vye-JTu559FMXpy14cZlI5_3xLAgLCURMu1w,22736
+lionagi-0.5.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+lionagi-0.5.4.dist-info/licenses/LICENSE,sha256=VXFWsdoN5AAknBCgFqQNgPWYx7OPp-PFEP961zGdOjc,11288
+lionagi-0.5.4.dist-info/RECORD,,