Merge branch 'main' into update-versins

Author: medaminezghal

clai/README.md

@@ -68,7 +68,7 @@ positional arguments:
 options:
   -h, --help            show this help message and exit
   -m [MODEL], --model [MODEL]
-                        Model to use, in format "<provider>:<model>" e.g. "openai:gpt-4o" or "anthropic:claude-3-7-sonnet-latest". Defaults to "openai:gpt-4o".
+                        Model to use, in format "<provider>:<model>" e.g. "openai:gpt-4.1" or "anthropic:claude-sonnet-4-0". Defaults to "openai:gpt-4.1".
   -a AGENT, --agent AGENT
                         Custom Agent to use, in format "module:variable", e.g. "mymodule.submodule:my_agent"
   -l, --list-models     List all available models and exit

clai/pyproject.toml

@@ -15,10 +15,11 @@ name = "clai"
 dynamic = ["version", "dependencies"]
 description = "PydanticAI CLI: command line interface to chat to LLMs"
 authors = [
-  { name = "Samuel Colvin", email = "[email protected]" },
-  { name = "Marcelo Trylesinski", email = "[email protected]" },
-  { name = "David Montague", email = "[email protected]" },
-  { name = "Alex Hall", email = "[email protected]" },
+    { name = "Samuel Colvin", email = "[email protected]" },
+    { name = "Marcelo Trylesinski", email = "[email protected]" },
+    { name = "David Montague", email = "[email protected]" },
+    { name = "Alex Hall", email = "[email protected]" },
+    { name = "Douwe Maan", email = "[email protected]" },
 ]
 license = "MIT"
 readme = "README.md"

docs/agents.md

@@ -826,7 +826,7 @@ with capture_run_messages() as messages:  # (2)!
         result = agent.run_sync('Please get me the volume of a box with size 6.')
     except UnexpectedModelBehavior as e:
         print('An error occurred:', e)
-        #> An error occurred: Tool exceeded max retries count of 1
+        #> An error occurred: Tool 'calc_volume' exceeded max retries count of 1
         print('cause:', repr(e.__cause__))
         #> cause: ModelRetry('Please try again.')
         print('messages:', messages)

docs/api/ext.md

@@ -0,0 +1,5 @@
+# `pydantic_ai.ext`
+
+::: pydantic_ai.ext.langchain
+
+::: pydantic_ai.ext.aci

docs/api/models/huggingface.md

@@ -0,0 +1,7 @@
+# `pydantic_ai.models.huggingface`
+
+## Setup
+
+For details on how to set up authentication with this model, see [model configuration for Hugging Face](../../models/huggingface.md).
+
+::: pydantic_ai.models.huggingface

docs/api/output.md

@@ -10,3 +10,4 @@
             - PromptedOutput
             - TextOutput
             - StructuredDict
+            - DeferredToolCalls

docs/api/providers.md

@@ -31,3 +31,5 @@
 ::: pydantic_ai.providers.github.GitHubProvider
 
 ::: pydantic_ai.providers.openrouter.OpenRouterProvider
+
+::: pydantic_ai.providers.huggingface.HuggingFaceProvider

docs/api/toolsets.md

@@ -0,0 +1,14 @@
+# `pydantic_ai.toolsets`
+
+::: pydantic_ai.toolsets
+    options:
+        members:
+        - AbstractToolset
+        - CombinedToolset
+        - DeferredToolset
+        - FilteredToolset
+        - FunctionToolset
+        - PrefixedToolset
+        - RenamedToolset
+        - PreparedToolset
+        - WrapperToolset

docs/cli.md

@@ -60,7 +60,7 @@ uvx clai --help
 You can specify which model to use with the `--model` flag:
 
 ```bash
-uvx clai --model anthropic:claude-3-7-sonnet-latest
+uvx clai --model anthropic:claude-sonnet-4-0
 ```
 
 (a full list of models available can be printed with `uvx clai --list-models`)
@@ -72,7 +72,7 @@ You can specify a custom agent using the `--agent` flag with a module path and v
 ```python {title="custom_agent.py" test="skip"}
 from pydantic_ai import Agent
 
-agent = Agent('openai:gpt-4o', instructions='You always respond in Italian.')
+agent = Agent('openai:gpt-4.1', instructions='You always respond in Italian.')
 ```
 
 Then run:
@@ -92,7 +92,7 @@ Additionally, you can directly launch CLI mode from an `Agent` instance using `A
 ```python {title="agent_to_cli_sync.py" test="skip" hl_lines=4}
 from pydantic_ai import Agent
 
-agent = Agent('openai:gpt-4o', instructions='You always respond in Italian.')
+agent = Agent('openai:gpt-4.1', instructions='You always respond in Italian.')
 agent.to_cli_sync()
 ```
 
@@ -101,7 +101,7 @@ You can also use the async interface with `Agent.to_cli()`:
 ```python {title="agent_to_cli.py" test="skip" hl_lines=6}
 from pydantic_ai import Agent
 
-agent = Agent('openai:gpt-4o', instructions='You always respond in Italian.')
+agent = Agent('openai:gpt-4.1', instructions='You always respond in Italian.')
 
 async def main():
     await agent.to_cli()

docs/common-tools.md

@@ -5,7 +5,7 @@ PydanticAI ships with native tools that can be used to enhance your agent's capa
 ## DuckDuckGo Search Tool
 
 The DuckDuckGo search tool allows you to search the web for information. It is built on top of the
-[DuckDuckGo API](https://github.com/deedy5/duckduckgo_search).
+[DuckDuckGo API](https://github.com/deedy5/ddgs).
 
 ### Installation