lionagi 0.14.7__py3-none-any.whl → 0.14.8__py3-none-any.whl

lionagi/fields/instruct.py

@@ -11,7 +11,6 @@ from lionagi.libs.validate.common_field_validators import (
     validate_nullable_jsonvalue_field,
 )
 from lionagi.models import FieldModel, HashableModel
-from lionagi.utils import to_num
 
 __all__ = (
     "Instruct",

lionagi/service/connections/providers/_claude_code/models.py

@@ -61,6 +61,7 @@ class ClaudeCodeRequest(BaseModel):
     max_thinking_tokens: int | None = None
     mcp_tools: list[str] = Field(default_factory=list)
     mcp_servers: dict[str, Any] = Field(default_factory=dict)
+    mcp_config: str | Path | None = Field(None, exclude=True)
     permission_mode: ClaudePermission | None = None
     permission_prompt_tool_name: str | None = None
     disallowed_tools: list[str] = Field(default_factory=list)
@@ -71,7 +72,7 @@ class ClaudeCodeRequest(BaseModel):
         description="Automatically finish the conversation after the first response",
     )
     verbose_output: bool = Field(default=False)
-    cli_display_theme: Literal["light", "dark"] = "light"
+    cli_display_theme: Literal["light", "dark"] = "dark"
 
     # ------------------------ validators & helpers --------------------------
     @field_validator("permission_mode", mode="before")
@@ -163,6 +164,15 @@ class ClaudeCodeRequest(BaseModel):
         if self.add_dir:
             args += ["--add-dir", self.add_dir]
 
+        if self.permission_prompt_tool_name:
+            args += [
+                "--permission-prompt-tool",
+                self.permission_prompt_tool_name,
+            ]
+
+        if self.mcp_config:
+            args += ["--mcp-config", str(self.mcp_config)]
+
         args += ["--model", self.model or "sonnet", "--verbose"]
         return args
 

lionagi/version.py

@@ -1 +1 @@
-__version__ = "0.14.7"
+__version__ = "0.14.8"

{lionagi-0.14.7.dist-info → lionagi-0.14.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lionagi
-Version: 0.14.7
+Version: 0.14.8
 Summary: An Intelligence Operating System.
 Author-email: HaiyangLi <quantocean.li@gmail.com>, Liangbingyan Luo <llby_luo@outlook.com>
 License:            Apache License
@@ -295,7 +295,9 @@ integrations, and custom validations in a single coherent pipeline.
 ## Installation
 
 ```
-pip install lionagi
+uv add lionagi  # recommended to use pyproject and uv for dependency management
+
+pip install lionagi # or install directly
 ```
 
 ## Quick Start
@@ -304,12 +306,12 @@ pip install lionagi
 from lionagi import Branch, iModel
 
 # Pick a model
-gpt4o = iModel(provider="openai", model="gpt-4o")
+gpt41 = iModel(provider="openai", model="gpt-4.1-mini")
 
 # Create a Branch (conversation context)
 hunter = Branch(
   system="you are a hilarious dragon hunter who responds in 10 words rhymes.",
-  chat_model=gpt4o,
+  chat_model=gpt41,
 )
 
 # Communicate asynchronously
@@ -390,41 +392,75 @@ print(df.tail())
 ```python
 from lionagi import Branch, iModel
 
-gpt4o = iModel(provider="openai", model="gpt-4o")
 sonnet = iModel(
   provider="anthropic",
   model="claude-3-5-sonnet-20241022",
   max_tokens=1000,                    # max_tokens is required for anthropic models
 )
 
-branch = Branch(chat_model=gpt4o)
-# Switch mid-flow
-analysis = await branch.communicate("Analyze these stats", imodel=sonnet)
+branch = Branch(chat_model=gpt41)
+analysis = await branch.communicate("Analyze these stats", chat_model=sonnet) # Switch mid-flow
 ```
 
 Seamlessly route to different models in the same workflow.
 
 ### Claude Code Integration
 
-LionAGI now supports Anthropic's [Claude Code Python SDK](https://github.com/anthropics/claude-code-sdk-python), enabling autonomous coding capabilities with persistent session management:
+LionAGI now supports Anthropic's Claude Code [Python SDK](https://github.com/anthropics/claude-code-sdk-python), and [CLI SDK](https://docs.anthropic.com/en/docs/claude-code/sdk) enabling autonomous coding capabilities with persistent session management. The CLI endpoint
+directly connects to claude code, and is recommended, you can either use it via a [proxy server](https://github.com/khive-ai/lionagi/tree/main/cookbooks/claude_proxy) or directly with `query_cli` endpoint, provided you have already logged onto claude code cli in your terminal.
 
 ```python
 from lionagi import iModel, Branch
 
-# Create a Claude Code model
-model = iModel(
-    provider="claude_code",
-    endpoint="query_cli",
-    model="sonnet",
-    allowed_tools=["Write", "Read", "Edit"],  # Control which tools Claude can use
-    permission_mode = "bypassPermissions", # Bypass tool permission checks (use with caution!),
-    verbose_output=True,  # Enable detailed output for debugging
-)
+def create_cc_model():
+  return iModel(
+      provider="claude_code",
+      endpoint="query_cli",
+      model="sonnet",
+      verbose_output=True,  # Enable detailed output for debugging
+  )
 
 # Start a coding session
-branch = Branch(chat_model=model)
-response = await branch.communicate("Explain the architecture of protocols, operations, and branch")
-response2 = await branch.communicate("how do these parts form lionagi system")
+orchestrator = Branch(chat_model=create_cc_model())
+response = await orchestrator.communicate("Explain the architecture of protocols, operations, and branch")
+
+# continue the session with more queries
+response2 = await orchestrator.communicate("how do these parts form lionagi system")
+```
+
+### Fan out fan in pattern orchestration with claude code
+
+```python
+# use structured outputs with claude code
+from lionagi.fields import LIST_INSTRUCT_FIELD_MODEL, Instruct
+
+response3 = await orchestrator.operate(
+  instruct=Instruct(
+    instruction="create 4 research questions for parallel discovery",
+    guidance="put into `instruct_models` field as part of your structured result message",
+    context="I'd like to create an orchestration system for AI agents using lionagi"
+  ),
+  field_models=[LIST_INSTRUCT_FIELD_MODEL],
+)
+
+len(response3.instruct_models)  # should be 4
+
+async def handle_instruct(instruct):
+  sub_branch = Branch(
+    system="You are an diligent research expert.",
+    chat_model=create_cc_model(),
+  )
+  return await sub_branch.operate(instruct=instruct)
+
+# run in parallel across all instruct models
+from lionagi.utils import alcall
+responses = await alcall(response3.instruct_models, handle_instruct)
+
+# now hand these reports back to the orchestrator
+final_response = await orchestrator.communicate(
+  "please synthesize these research findings into a final report",
+  context=responses,
+)
 ```
 
 Key features:
@@ -436,9 +472,14 @@ Key features:
 ### optional dependencies
 
 ```
-pip install "lionagi[reader]"
-pip install "lionagi[ollama]"
-pip install "lionagi[claude-code]"
+"lionagi[reader]" - Reader tool for any unstructured data and web pages
+"lionagi[ollama]" - Ollama model support for local inference
+"lionagi[claude-code]" - Claude code python SDK integration (cli endpoint does not require this)
+"lionagi[rich]" - Rich output formatting for better console display
+"lionagi[schema]" - Convert pydantic schema to make the Model class persistent
+"lionagi[postgres]" - Postgres database support for storing and retrieving structured data
+"lionagi[graph]" - Graph display for visualizing complex workflows
+"lionagi[sqlite]" - SQLite database support for lightweight data storage (also need `postgres` option)
 ```
 
 ## Community & Contributing

{lionagi-0.14.7.dist-info → lionagi-0.14.8.dist-info}/RECORD

@@ -6,7 +6,7 @@ lionagi/config.py,sha256=Dxs5FA9UCv1YX5H54qOJcPsDrIF9wFokWEPZ212eH-k,3715
 lionagi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/settings.py,sha256=HDuKCEJCpc4HudKodBnhoQUGuTGhRHdlIFhbtf3VBtY,1633
 lionagi/utils.py,sha256=n2aUMSnLLgy7HWFlfzDV1OqMDbatLNX0QYc7jIjXwQA,75023
-lionagi/version.py,sha256=yNRy8QmCVyuml0ju8L9u6swkKYhN3lS8nPbf2IWPDOU,23
+lionagi/version.py,sha256=FrbFRQ_ImRf8C9xWDXvZmcPev0r6romK0PIGZ4NmgIg,23
 lionagi/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/adapters/async_postgres_adapter.py,sha256=Kf2YCzwRqKpEHY3GQCXEiMl201CCIkDvXcvddwZNkkE,12723
 lionagi/adapters/postgres_model_adapter.py,sha256=e_wfJNyihbpLCXuAs_W9tbLoMXAXbAXtkQDaHfqWz3o,4555
@@ -15,7 +15,7 @@ lionagi/fields/action.py,sha256=OziEpbaUeEVo34KdtbzDxXJBgkf3QLxlcKIQAfHe4O0,5791
 lionagi/fields/base.py,sha256=mvgqxLonCROszMjnG8QWt00l-MvIr_mnGvCtaH-SQ_k,3814
 lionagi/fields/code.py,sha256=TFym51obzaSfCmeRoHZJyBtjfDI4tvl9F-1sjFc9rMw,7713
 lionagi/fields/file.py,sha256=DhQ_HE0RvTNzkvBGQHRgbMYSokDkzE8GEu814i6jw5Q,7297
-lionagi/fields/instruct.py,sha256=cpAfKAhQek3Tu6nja5l04zpoBlTZSn10SxEPD7YFahA,4367
+lionagi/fields/instruct.py,sha256=2koYdY7XyJh5lrd7tD_BA9bqCbmpsdTDaASEv_dX4i8,4334
 lionagi/fields/reason.py,sha256=eTGI9jDaaZJInUjCR9lEpYvw2_1UUF-xzCVCFP3-JRI,1437
 lionagi/fields/research.py,sha256=eEPKocx8eQy2E9FExRWVIo6MK_xvmwBAoRZciBY3RG0,1421
 lionagi/libs/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
@@ -200,7 +200,7 @@ lionagi/service/connections/providers/oai_.py,sha256=FmQMEmOY7H7dZd4og-_cdd1Unzy
 lionagi/service/connections/providers/ollama_.py,sha256=jdx6dGeChwVk5TFfFRbpnrpKzj8YQZw6D5iWJ6zYmfk,4096
 lionagi/service/connections/providers/perplexity_.py,sha256=9MH9YmMy9Jg7JDMJHQxxMYHyjJ4NP0OlN7sCuhla85I,917
 lionagi/service/connections/providers/_claude_code/__init__.py,sha256=3lzOakDoBWmMaNnT2g-YwktPKa_Wme4lnPRSmOQfayY,105
-lionagi/service/connections/providers/_claude_code/models.py,sha256=vMY2QoGpW2_hv_49IZiFzqiite8gCPKkkYzN6QqWPFQ,7995
+lionagi/service/connections/providers/_claude_code/models.py,sha256=Iyx8YPv56n_GZN8e3mcZ6e7sYllhlVxX2Mp4zWd0BzM,8320
 lionagi/service/connections/providers/_claude_code/stream_cli.py,sha256=0brD9mWRXPIiRSmha5n77JudW5tmhLNZmsjGgUWM060,12388
 lionagi/service/third_party/README.md,sha256=qFjWnI8rmLivIyr6Tc-hRZh-rQwntROp76af4MBNJJc,2214
 lionagi/service/third_party/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -218,7 +218,7 @@ lionagi/tools/types.py,sha256=XtJLY0m-Yi_ZLWhm0KycayvqMCZd--HxfQ0x9vFUYDE,230
 lionagi/tools/file/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/tools/file/reader.py,sha256=0TdnfVGVCKuM58MmGM-NyVjhU9BFoitkNYEepdc0z_Y,9529
 lionagi/tools/memory/tools.py,sha256=zTGBenVsF8Wuh303kWntmQSGlAFKonHNdh5ePuQ26KE,15948
-lionagi-0.14.7.dist-info/METADATA,sha256=LIGnpV3vzJiX-2RNPyjWuuNBm1u7ww0kZtjMsWN2Mgs,20803
-lionagi-0.14.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-lionagi-0.14.7.dist-info/licenses/LICENSE,sha256=VXFWsdoN5AAknBCgFqQNgPWYx7OPp-PFEP961zGdOjc,11288
-lionagi-0.14.7.dist-info/RECORD,,
+lionagi-0.14.8.dist-info/METADATA,sha256=_XF7GKTpMRcN_jpow1LJhSTdESVCqcN4el14Sc5-Lxc,22794
+lionagi-0.14.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+lionagi-0.14.8.dist-info/licenses/LICENSE,sha256=VXFWsdoN5AAknBCgFqQNgPWYx7OPp-PFEP961zGdOjc,11288
+lionagi-0.14.8.dist-info/RECORD,,