dex-agents-pydantic-ai-cli 0.6.1__tar.gz

dex_agents_pydantic_ai_cli-0.6.1/LICENSE

@@ -0,0 +1,105 @@
+# License
+
+Copyright (c) 2026 Super Durable, Inc.
+
+Portions of this software are licensed as follows:
+
+- Legacy Materials remain under their original licenses as described in
+  `LEGACY_NOTICES.md`.
+- Third-Party Materials remain under the licenses provided by their owners.
+- The `docs/` and `examples/` directories are not licensed under the
+  Sustainable Use License and retain their existing licensing status.
+- All other material owned or licensable by Super Durable, Inc. is available
+  under the Sustainable Use License below.
+
+See `LEGACY_NOTICES.md` for the applicable legacy and third-party notices.
+
+## Sustainable Use License
+
+Version 1.0
+
+### Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+### Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations below.
+
+### Limitations
+
+You may use or modify the software only for your own internal business purposes
+or for non-commercial or personal use. You may distribute the software or
+provide it to others only if you do so free of charge for non-commercial
+purposes. You may not alter, remove, or obscure any licensing, copyright, or
+other notices of the licensor in the software. Any use of the licensor's
+trademarks is subject to applicable law.
+
+### Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software.
+
+If you or your company make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license for the software
+granted under these terms ends immediately. If your company makes such a claim,
+your patent license ends immediately for work on behalf of your company.
+
+### Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms. If you modify the software, you must
+include in any modified copies of the software a prominent notice stating that
+you have modified the software.
+
+### No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+### Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your license will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your license will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your license
+to terminate automatically and permanently.
+
+### No Liability
+
+As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.
+
+### Definitions
+
+The "licensor" is the entity offering these terms.
+
+The "software" is the software the licensor makes available under these terms,
+including any portion of it.
+
+"You" refers to the individual or entity agreeing to these terms.
+
+"Your company" is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+Control means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+"Your license" is the license granted to you for the software under these
+terms.
+
+"Use" means anything you do with the software requiring your license.
+
+"Trademark" means trademarks, service marks, and similar rights.

dex_agents_pydantic_ai_cli-0.6.1/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: dex-agents-pydantic-ai-cli
+Version: 0.6.1
+Summary: The dex-agents-pydantic-ai command: a durable Pydantic AI agent in your terminal
+Author: Super Durable
+License-Expression: LicenseRef-Sustainable-Use-1.0
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Dist: dex-agents==0.6.1
+Requires-Dist: dex-agents-cli-core==0.6.1
+Requires-Dist: dex-agents-pydantic-ai==0.6.1
+Requires-Dist: dex-python-sdk==1.45.0
+Requires-Dist: pydantic-ai-slim[anthropic,google,openai]>=2.64,<3
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/superdurable/dex/tree/main/agents/cli/python/pydantic-ai
+Project-URL: Repository, https://github.com/superdurable/dex
+Project-URL: Changelog, https://github.com/superdurable/dex/blob/main/agents/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# dex-agents-pydantic-ai-cli
+
+`dex-agents-pydantic-ai-cli` provides the `dex-agents-pydantic-ai` command. It
+runs a [Pydantic AI](https://ai.pydantic.dev/) agent as a durable Dex agent
+session and chats with it in your terminal. The shared CLI core,
+[`dex-agents-cli-core`](../core/README.md), starts or reuses `dexcli dev`,
+connects the connectors MCP server, and runs the Worker. This package only
+builds the agent with the
+[Pydantic AI adapter](../../../python/pydantic-ai/README.md).
+
+## Running it
+
+The command needs Python 3.11 or later and a key for the model's provider:
+
+```bash
+export OPENAI_API_KEY=sk-...
+uvx --from dex-agents-pydantic-ai-cli dex-agents-pydantic-ai
+```
+
+The first run asks the `init` questions and writes
+`~/.dex/agents/pydantic-ai.yaml`. Then type a message at the `>` prompt.
+Approve or reject tool calls with `y` or `n`, and press Ctrl-D to exit. The
+session stays in Dex, and the command prints the `--resume` line that
+continues it. See the [CLI core README](../core/README.md#running-a-command)
+for every subcommand and option, and [`agents/cli`](../../README.md) for the
+configuration file.
+
+The provider reads its key from its standard environment variable. The
+package includes the OpenAI, Anthropic, and Google providers:
+
+| Model prefix | Environment variables |
+| --- | --- |
+| `openai:` | `OPENAI_API_KEY`; `OPENAI_BASE_URL` for another endpoint |
+| `anthropic:` | `ANTHROPIC_API_KEY`; `ANTHROPIC_BASE_URL` for another endpoint |
+| `google-gla:` | `GOOGLE_API_KEY` |
+
+The command never prints or stores a key.
+
+## Configuration
+
+The model defaults to `openai:gpt-5.2`; set `model` in the file or pass
+`--model` to change it. It is a Pydantic AI model name, `<provider>:<model>`,
+such as `anthropic:claude-opus-5-5`. A session's settings may change the model
+and the instructions; each model call uses the values of its turn.
+`system_prompt` replaces the default instructions. The `pydantic_ai` section
+has no options yet, and any key in it is a configuration error.
+
+## Tools
+
+The agent's tools are the CLI core's: its local tool source and the connector
+tools of the connectors MCP server. Every call runs in its own Dex tool Step,
+with the CLI core's policy. Reads run at once, file writes and shell commands
+wait for approval unless the shell allow list has the command, and the file
+tools stay in the workspace. See the
+[CLI core README](../core/README.md) for the local tools.
+
+## Images
+
+`/image <path>` attaches an image file to the next message. The command gives
+the Pydantic AI adapter the media store of `media.store`, so the model sees the
+image, and images that tools return go to the same store. See
+[Images](../../README.md#images).
+
+## Development
+
+Develop with uv 0.12.2. The package resolves `dex-agents`, the adapter, the
+CLI core, and the shared test support from this repository by path. `uv.lock`
+pins `pydantic-ai-slim` to the version the adapter's lock pins, and `ci.sh`
+checks that. `ci.sh` installs the locked dependencies, checks lint and types,
+and runs the tests against a private `dexcli dev`:
+
+```bash
+cd agents/cli/python/pydantic-ai
+DEXCLI=/path/to/dexcli ./ci.sh
+```
+
+The tests run the command in a pseudo-terminal with a private home and an
+allow-listed environment. Pydantic AI's OpenAI provider calls the scripted
+Responses API of [`../testing`](../testing); a refused proxy stops any other
+request. A fake connectors MCP server serves a connector read and write. The
+tests cover a chat turn and `--resume`, `read_file` without approval and
+`write_file` after approval, a connector read and an approved connector write
+that runs once, session settings that change the model, and a key in the
+`pydantic_ai` section.
+They also cover a `system_prompt` set in the session settings, which reaches
+the next model request, and a rejected file write and connector write, which
+never run.

dex_agents_pydantic_ai_cli-0.6.1/README.md

@@ -0,0 +1,87 @@
+# dex-agents-pydantic-ai-cli
+
+`dex-agents-pydantic-ai-cli` provides the `dex-agents-pydantic-ai` command. It
+runs a [Pydantic AI](https://ai.pydantic.dev/) agent as a durable Dex agent
+session and chats with it in your terminal. The shared CLI core,
+[`dex-agents-cli-core`](../core/README.md), starts or reuses `dexcli dev`,
+connects the connectors MCP server, and runs the Worker. This package only
+builds the agent with the
+[Pydantic AI adapter](../../../python/pydantic-ai/README.md).
+
+## Running it
+
+The command needs Python 3.11 or later and a key for the model's provider:
+
+```bash
+export OPENAI_API_KEY=sk-...
+uvx --from dex-agents-pydantic-ai-cli dex-agents-pydantic-ai
+```
+
+The first run asks the `init` questions and writes
+`~/.dex/agents/pydantic-ai.yaml`. Then type a message at the `>` prompt.
+Approve or reject tool calls with `y` or `n`, and press Ctrl-D to exit. The
+session stays in Dex, and the command prints the `--resume` line that
+continues it. See the [CLI core README](../core/README.md#running-a-command)
+for every subcommand and option, and [`agents/cli`](../../README.md) for the
+configuration file.
+
+The provider reads its key from its standard environment variable. The
+package includes the OpenAI, Anthropic, and Google providers:
+
+| Model prefix | Environment variables |
+| --- | --- |
+| `openai:` | `OPENAI_API_KEY`; `OPENAI_BASE_URL` for another endpoint |
+| `anthropic:` | `ANTHROPIC_API_KEY`; `ANTHROPIC_BASE_URL` for another endpoint |
+| `google-gla:` | `GOOGLE_API_KEY` |
+
+The command never prints or stores a key.
+
+## Configuration
+
+The model defaults to `openai:gpt-5.2`; set `model` in the file or pass
+`--model` to change it. It is a Pydantic AI model name, `<provider>:<model>`,
+such as `anthropic:claude-opus-5-5`. A session's settings may change the model
+and the instructions; each model call uses the values of its turn.
+`system_prompt` replaces the default instructions. The `pydantic_ai` section
+has no options yet, and any key in it is a configuration error.
+
+## Tools
+
+The agent's tools are the CLI core's: its local tool source and the connector
+tools of the connectors MCP server. Every call runs in its own Dex tool Step,
+with the CLI core's policy. Reads run at once, file writes and shell commands
+wait for approval unless the shell allow list has the command, and the file
+tools stay in the workspace. See the
+[CLI core README](../core/README.md) for the local tools.
+
+## Images
+
+`/image <path>` attaches an image file to the next message. The command gives
+the Pydantic AI adapter the media store of `media.store`, so the model sees the
+image, and images that tools return go to the same store. See
+[Images](../../README.md#images).
+
+## Development
+
+Develop with uv 0.12.2. The package resolves `dex-agents`, the adapter, the
+CLI core, and the shared test support from this repository by path. `uv.lock`
+pins `pydantic-ai-slim` to the version the adapter's lock pins, and `ci.sh`
+checks that. `ci.sh` installs the locked dependencies, checks lint and types,
+and runs the tests against a private `dexcli dev`:
+
+```bash
+cd agents/cli/python/pydantic-ai
+DEXCLI=/path/to/dexcli ./ci.sh
+```
+
+The tests run the command in a pseudo-terminal with a private home and an
+allow-listed environment. Pydantic AI's OpenAI provider calls the scripted
+Responses API of [`../testing`](../testing); a refused proxy stops any other
+request. A fake connectors MCP server serves a connector read and write. The
+tests cover a chat turn and `--resume`, `read_file` without approval and
+`write_file` after approval, a connector read and an approved connector write
+that runs once, session settings that change the model, and a key in the
+`pydantic_ai` section.
+They also cover a `system_prompt` set in the session settings, which reaches
+the next model request, and a rejected file write and connector write, which
+never run.

dex_agents_pydantic_ai_cli-0.6.1/pyproject.toml

@@ -0,0 +1,119 @@
+[project]
+name = "dex-agents-pydantic-ai-cli"
+version = "0.6.1"
+description = "The dex-agents-pydantic-ai command: a durable Pydantic AI agent in your terminal"
+readme = "README.md"
+license = "LicenseRef-Sustainable-Use-1.0"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Typing :: Typed",
+]
+dependencies = [
+    "dex-agents==0.6.1",
+    "dex-agents-cli-core==0.6.1",
+    "dex-agents-pydantic-ai==0.6.1",
+    "dex-python-sdk==1.45.0",
+    "pydantic-ai-slim[anthropic,google,openai]>=2.64,<3",
+]
+
+[[project.authors]]
+name = "Super Durable"
+
+[project.scripts]
+dex-agents-pydantic-ai = "dex_agents_pydantic_ai_cli:run"
+
+[project.urls]
+Homepage = "https://github.com/superdurable/dex/tree/main/agents/cli/python/pydantic-ai"
+Repository = "https://github.com/superdurable/dex"
+Changelog = "https://github.com/superdurable/dex/blob/main/agents/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+    "dex-agents-cli-testing",
+    "mypy>=1.15,<2",
+    "pexpect>=4.9,<5",
+    "pytest>=8.3,<9",
+    "pytest-asyncio>=0.26,<2",
+    "ruff>=0.8,<0.9",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.2,<0.13"]
+build-backend = "uv_build"
+
+[tool.uv]
+required-version = "==0.12.2"
+
+[tool.uv.sources.dex-agents]
+path = "../../../python/core"
+editable = true
+
+[tool.uv.sources.dex-agents-cli-core]
+path = "../core"
+editable = true
+
+[tool.uv.sources.dex-agents-cli-testing]
+path = "../testing"
+editable = true
+
+[tool.uv.sources.dex-agents-pydantic-ai]
+path = "../../../python/pydantic-ai"
+editable = true
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "W",
+    "I",
+    "B",
+    "UP",
+    "ASYNC",
+    "RUF",
+]
+ignore = [
+    "ASYNC109",
+    "ASYNC110",
+    "ASYNC220",
+    "ASYNC221",
+]
+
+[tool.ruff.lint.isort]
+known-first-party = [
+    "dex_agents",
+    "dex_agents_cli_core",
+    "dex_agents_pydantic_ai",
+    "dex_agents_pydantic_ai_cli",
+    "dex_agents_cli_testing",
+    "tests",
+]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+files = [
+    "src",
+    "tests",
+]
+
+[[tool.mypy.overrides]]
+module = [
+    "pexpect",
+    "pexpect.*",
+]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"
+asyncio_default_test_loop_scope = "session"

dex_agents_pydantic_ai_cli-0.6.1/pyproject.toml.orig

@@ -0,0 +1,89 @@
+[project]
+name = "dex-agents-pydantic-ai-cli"
+# Every agents package shares one version; agents/script/stamp_agents_release_version.py sets it.
+version = "0.6.1"
+description = "The dex-agents-pydantic-ai command: a durable Pydantic AI agent in your terminal"
+authors = [{name = "Super Durable"}]
+readme = "README.md"
+license = "LicenseRef-Sustainable-Use-1.0"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Typing :: Typed",
+]
+dependencies = [
+    "dex-agents==0.6.1",
+    "dex-agents-cli-core==0.6.1",
+    "dex-agents-pydantic-ai==0.6.1",
+    "dex-python-sdk==1.45.0",
+    "pydantic-ai-slim[anthropic,google,openai]>=2.64,<3",
+]
+
+[project.scripts]
+dex-agents-pydantic-ai = "dex_agents_pydantic_ai_cli:run"
+
+[project.urls]
+Homepage = "https://github.com/superdurable/dex/tree/main/agents/cli/python/pydantic-ai"
+Repository = "https://github.com/superdurable/dex"
+Changelog = "https://github.com/superdurable/dex/blob/main/agents/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+    "dex-agents-cli-testing",
+    "mypy>=1.15,<2",
+    "pexpect>=4.9,<5",
+    "pytest>=8.3,<9",
+    "pytest-asyncio>=0.26,<2",
+    "ruff>=0.8,<0.9",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.2,<0.13"]
+build-backend = "uv_build"
+
+[tool.uv]
+required-version = "==0.12.2"
+
+[tool.uv.sources]
+dex-agents = { path = "../../../python/core", editable = true }
+dex-agents-cli-core = { path = "../core", editable = true }
+dex-agents-cli-testing = { path = "../testing", editable = true }
+dex-agents-pydantic-ai = { path = "../../../python/pydantic-ai", editable = true }
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP", "ASYNC", "RUF"]
+# Test helpers poll files and spawn children on purpose.
+ignore = ["ASYNC109", "ASYNC110", "ASYNC220", "ASYNC221"]
+
+[tool.ruff.lint.isort]
+known-first-party = [
+    "dex_agents",
+    "dex_agents_cli_core",
+    "dex_agents_pydantic_ai",
+    "dex_agents_pydantic_ai_cli",
+    "dex_agents_cli_testing",
+    "tests",
+]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+files = ["src", "tests"]
+
+[[tool.mypy.overrides]]
+module = ["pexpect", "pexpect.*"]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"
+asyncio_default_test_loop_scope = "session"

dex_agents_pydantic_ai_cli-0.6.1/src/dex_agents_pydantic_ai_cli/__init__.py

@@ -0,0 +1,61 @@
+# Copyright (c) 2026 Super Durable, Inc.
+#
+# Licensed under the Sustainable Use License 1.0.
+# You may not use this file except in compliance with the License.
+# See the LICENSE file in the repository root.
+#
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+
+"""The ``dex-agents-pydantic-ai`` command: a Pydantic AI agent in the terminal.
+
+It builds the agent session Flow with the Dex Pydantic AI adapter and
+runs it with the shared Dex Agents CLI core. See the package README.
+"""
+
+import dex_agents_cli_core  # noqa: F401  # first: it configures gRPC before anything imports it
+
+# isort: split
+
+import sys
+
+from dex_agents_cli_core import ConfigError, command_name, run_agent_cli
+from dex_agents_pydantic_ai_cli.harness import (
+    DEFAULT_INSTRUCTIONS,
+    DEFAULT_PYDANTIC_AI_MODEL,
+    PYDANTIC_AI_CLI_FLOW_TYPE,
+    PydanticAiHarness,
+    validate_pydantic_ai_section,
+)
+
+__all__ = [
+    "DEFAULT_INSTRUCTIONS",
+    "DEFAULT_PYDANTIC_AI_MODEL",
+    "PYDANTIC_AI_CLI_FLOW_TYPE",
+    "PydanticAiHarness",
+    "main",
+    "run",
+    "validate_pydantic_ai_section",
+]
+
+
+def main(argv: list[str] | None = None) -> int:
+    """Run the command and return its exit code.
+
+    Args:
+        argv: The arguments without the program name; ``None`` reads ``sys.argv``.
+
+    Returns:
+        0 on success, 1 for a failure at run time, and 2 for a usage or
+        configuration error, such as a key in the ``pydantic_ai`` section.
+    """
+    harness = PydanticAiHarness()
+    try:
+        return run_agent_cli(harness, argv)
+    except ConfigError as error:
+        print(f"{command_name(harness)}: {error}", file=sys.stderr)
+        return 2
+
+
+def run() -> None:
+    """Run the command from its console script and exit with its code."""
+    raise SystemExit(main())

dex_agents_pydantic_ai_cli-0.6.1/src/dex_agents_pydantic_ai_cli/__main__.py

@@ -0,0 +1,14 @@
+# Copyright (c) 2026 Super Durable, Inc.
+#
+# Licensed under the Sustainable Use License 1.0.
+# You may not use this file except in compliance with the License.
+# See the LICENSE file in the repository root.
+#
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+
+"""``python -m dex_agents_pydantic_ai_cli`` runs the ``dex-agents-pydantic-ai`` command."""
+
+from dex_agents_pydantic_ai_cli import run
+
+if __name__ == "__main__":
+    run()

dex_agents_pydantic_ai_cli-0.6.1/src/dex_agents_pydantic_ai_cli/harness.py

@@ -0,0 +1,124 @@
+# Copyright (c) 2026 Super Durable, Inc.
+#
+# Licensed under the Sustainable Use License 1.0.
+# You may not use this file except in compliance with the License.
+# See the LICENSE file in the repository root.
+#
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+
+"""The Pydantic AI harness: a Pydantic AI agent with the CLI core's tools."""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any
+
+import dex_agents_cli_core  # noqa: F401  # first: it configures gRPC before anything imports it
+
+# isort: split
+
+from pydantic_ai import Agent
+from pydantic_ai.models import Model, infer_model
+from pydantic_ai.models.wrapper import WrapperModel
+
+from dex_agents import AgentSessionFlow
+from dex_agents_cli_core import ConfigError, HarnessContext, LocalToolGroup, current_turn_config
+from dex_agents_pydantic_ai import pydantic_ai_session_flow
+
+#: The Flow type of the command's sessions, before the CLI core namespaces it.
+PYDANTIC_AI_CLI_FLOW_TYPE = "DexAgentsPydanticAiCliSession"
+
+#: The Pydantic AI model the command uses when the configuration file sets none.
+DEFAULT_PYDANTIC_AI_MODEL = "openai:gpt-5.2"
+
+#: The instructions the agent gets when the configuration sets none.
+DEFAULT_INSTRUCTIONS = (
+    "You are a helpful assistant. Use your tools to work with the files and commands "
+    "in your workspace and with the connected services."
+)
+
+
+class PydanticAiHarness:
+    """The ``dex-agents-pydantic-ai`` command: a Pydantic AI agent in the terminal.
+
+    Every model call uses the turn's model, a Pydantic AI model name such as
+    ``openai:gpt-5.2`` or ``anthropic:claude-opus-5-5``, and the turn's
+    instructions. The provider reads its standard environment variables. The
+    CLI core's connector and local tools are the agent's only tools.
+    """
+
+    name = "pydantic-ai"
+    config_section = "pydantic_ai"
+    flow_type = PYDANTIC_AI_CLI_FLOW_TYPE
+    default_model: str | None = DEFAULT_PYDANTIC_AI_MODEL
+    replaced_local_tools: frozenset[LocalToolGroup] = frozenset()
+
+    def create_session_flow(self, context: HarnessContext) -> AgentSessionFlow:
+        """Build the Pydantic AI agent session Flow from the effective configuration.
+
+        Args:
+            context: The configuration, workspace, and tool sources.
+
+        Returns:
+            The Flow, with ``context.flow_type`` as its type.
+
+        Raises:
+            ConfigError: If the ``pydantic_ai`` section has a key; it has no options yet.
+        """
+        validate_pydantic_ai_section(context.harness_options)
+
+        def instructions() -> str:
+            return context.current_turn().instructions or DEFAULT_INSTRUCTIONS
+
+        agent: Agent[None, str] = Agent(
+            TurnModel(context.config.model), instructions=instructions, name="pydantic-ai"
+        )
+        return pydantic_ai_session_flow(
+            agent,
+            flow_type=context.flow_type,
+            tool_sources=context.tool_sources,
+            media_store=context.media_store,
+            summary_attributes_indexed=context.is_session_summary_indexed,
+        )
+
+
+class TurnModel(WrapperModel):
+    """Call the running turn's model, so session settings can change it between turns.
+
+    Outside a turn, such as in a compaction summary call, it calls the file's model.
+    """
+
+    def __init__(self, file_model: str) -> None:
+        """Create the model without resolving any provider yet.
+
+        Args:
+            file_model: The configuration file's model name.
+        """
+        Model.__init__(self)
+        self._file_model = file_model
+        self._models: dict[str, Model] = {}
+
+    @property
+    def wrapped(self) -> Model:  # type: ignore[override]
+        """Return the running turn's model, resolved once per name."""
+        turn = current_turn_config()
+        model_name = self._file_model if turn is None else turn.model
+        model = self._models.get(model_name)
+        if model is None:
+            model = infer_model(model_name)
+            self._models[model_name] = model
+        return model
+
+
+def validate_pydantic_ai_section(options: Mapping[str, Any]) -> None:
+    """Reject every key of the ``pydantic_ai`` section, which has no options yet.
+
+    Args:
+        options: The section, ``{}`` when the file omits it.
+
+    Raises:
+        ConfigError: ``schema`` with the first key's JSON Pointer.
+    """
+    for key in sorted(options):
+        escaped = key.replace("~", "~0").replace("/", "~1")
+        raise ConfigError("schema", f"/pydantic_ai/{escaped}", keyword="additionalProperties")