Add PydanticAI runtime via PydanticAIBaseAgent

README.md

@@ -2,6 +2,10 @@
 
 Misc extension to [akd-core](https://github.com/NASA-IMPACT/accelerated-discovery/).
 
+## Documentation
+
+- [Creating Agents](docs/development/creating_agents.md) — guide for building new agents on `OpenAIBaseAgent` or `PydanticAIBaseAgent`, including config, schemas, tools, capabilities, tests, and reference examples.
+
 ## Installation
 
 ### Using uv (recommended)

akd_ext/agents/_base/__init__.py

@@ -0,0 +1,17 @@
+"""Base agent classes for akd_ext.
+
+Two families live here:
+
+- :class:`OpenAIBaseAgent` — built on the OpenAI Agents SDK (``openai``).
+- :class:`PydanticAIBaseAgent` — built on :class:`pydantic_ai.Agent`.
+"""
+
+from akd_ext.agents._base.openai import OpenAIBaseAgent, OpenAIBaseAgentConfig
+from akd_ext.agents._base.pydantic_ai import PydanticAIBaseAgent, PydanticAIBaseAgentConfig
+
+__all__ = [
+    "OpenAIBaseAgent",
+    "OpenAIBaseAgentConfig",
+    "PydanticAIBaseAgent",
+    "PydanticAIBaseAgentConfig",
+]

akd_ext/agents/_base/pydantic_ai/__init__.py

@@ -0,0 +1,20 @@
+"""Pydantic AI-backed agent base class for akd_ext.
+
+Public API:
+
+- :class:`PydanticAIBaseAgent` — subclass this to build new agents.
+- :class:`PydanticAIBaseAgentConfig` — extend for subclass-specific config.
+
+The subpackage also exposes internal helpers (``_tool_adapter``,
+``_context_adapter``, ``_event_translator``, ``_capabilities``) that consumers
+typically don't need to import directly. Structural protocols
+(``AKDExecutable``, ``AKDTool``, ``RunContextProtocol``, ``TokenCounts``) are
+sourced from ``akd._base.protocols``.
+"""
+
+from ._base import PydanticAIBaseAgent, PydanticAIBaseAgentConfig
+
+__all__ = [
+    "PydanticAIBaseAgent",
+    "PydanticAIBaseAgentConfig",
+]