Skip to content

Building AI agents, atomically

#116 init commit for modularization, flattening tool imports, still testing, working through examples

jon fox185a4b452fc4
diff --git a/atomic-agents/atomic_agents/__init__.py b/atomic-agents/atomic_agents/__init__.py
new file mode 100644
index 0000000..0bf1c96
--- /dev/null
+++ b/atomic-agents/atomic_agents/__init__.py
@@ -0,0 +1,41 @@
+"""
+Atomic Agents - A modular framework for building AI agents.
+"""
+
+# Core exports for simplified imports
+from .agents.base_agent import (
+ BaseAgent,
+ BaseAgentConfig,
+ BaseAgentInputSchema,
+ BaseAgentOutputSchema,
+)
+
+from .lib.base.base_io_schema import BaseIOSchema
+from .lib.base.base_tool import BaseTool, BaseToolConfig
+
+from .lib.components.chat_history import ChatHistory
+from .lib.components.system_prompt_generator import (
+ SystemPromptGenerator,
+ SystemPromptContextProviderBase,
+)
+
+# Version info
+__version__ = "2.0.0"
+
+# Public API
+__all__ = [
+ # Agents
+ "BaseAgent",
+ "BaseAgentConfig",
+ "BaseAgentInputSchema",
+ "BaseAgentOutputSchema",
+ # Schemas
+ "BaseIOSchema",
+ # Tools
+ "BaseTool",
+ "BaseToolConfig",
+ # Components
+ "ChatHistory",
+ "SystemPromptGenerator",
+ "SystemPromptContextProviderBase",
+]
diff --git a/atomic-agents/atomic_agents/agents/__init__.py b/atomic-agents/atomic_agents/agents/__init__.py
index e69de29..ef70134 100644
--- a/atomic-agents/atomic_agents/agents/__init__.py
+++ b/atomic-agents/atomic_agents/agents/__init__.py
@@ -0,0 +1,15 @@
+"""Agent implementations and configurations."""
+
+from .base_agent import (
+ BaseAgent,
+ BaseAgentConfig,
+ BaseAgentInputSchema,
+ BaseAgentOutputSchema,
+)
+
+__all__ = [
+ "BaseAgent",
+ "BaseAgentConfig",
+ "BaseAgentInputSchema",
+ "BaseAgentOutputSchema",
+]
\ No newline at end of file
diff --git a/atomic-agents/atomic_agents/lib/__init__.py b/atomic-agents/atomic_agents/lib/__init__.py
index e69de29..08c3005 100644
--- a/atomic-agents/atomic_agents/lib/__init__.py
+++ b/atomic-agents/atomic_agents/lib/__init__.py
@@ -0,0 +1,25 @@
+"""Library components for Atomic Agents."""
+
+# Base classes
+from .base.base_io_schema import BaseIOSchema
+from .base.base_tool import BaseTool, BaseToolConfig
+
+# Components
+from .components.chat_history import ChatHistory
+from .components.system_prompt_generator import (
+ SystemPromptGenerator,
+ SystemPromptContextProviderBase,
+)
+
+# Utilities
+from .utils.format_tool_message import format_tool_message
+
+__all__ = [
+ "BaseIOSchema",
+ "BaseTool",
+ "BaseToolConfig",
+ "ChatHistory",
+ "SystemPromptGenerator",
+ "SystemPromptContextProviderBase",
+ "format_tool_message",
+]
\ No newline at end of file
diff --git a/atomic-agents/atomic_agents/lib/base/__init__.py b/atomic-agents/atomic_agents/lib/base/__init__.py
new file mode 100644
index 0000000..b551c96
--- /dev/null
+++ b/atomic-agents/atomic_agents/lib/base/__init__.py
@@ -0,0 +1,10 @@
+"""Base classes for Atomic Agents."""
+
+from .base_io_schema import BaseIOSchema
+from .base_tool import BaseTool, BaseToolConfig
+
+__all__ = [
+ "BaseIOSchema",
+ "BaseTool",
+ "BaseToolConfig",
+]
diff --git a/atomic-agents/atomic_agents/lib/components/__init__.py b/atomic-agents/atomic_agents/lib/components/__init__.py
index e69de29..442346d 100644
--- a/atomic-agents/atomic_agents/lib/components/__init__.py
+++ b/atomic-agents/atomic_agents/lib/components/__init__.py
@@ -0,0 +1,13 @@
+"""Framework components."""
+
+from .chat_history import ChatHistory
+from .system_prompt_generator import (
+ SystemPromptGenerator,
+ SystemPromptContextProviderBase,
+)
+
+__all__ = [
+ "ChatHistory",
+ "SystemPromptGenerator",
+ "SystemPromptContextProviderBase",
+]
\ No newline at end of file
diff --git a/atomic-agents/atomic_agents/lib/factories/__init__.py b/atomic-agents/atomic_agents/lib/factories/__init__.py
new file mode 100644
index 0000000..509fd48
--- /dev/null
+++ b/atomic-agents/atomic_agents/lib/factories/__init__.py
@@ -0,0 +1,20 @@
+"""Factory classes for Atomic Agents."""
+
+from .mcp_tool_factory import MCPToolFactory, MCPToolOutputSchema, fetch_mcp_tools, fetch_mcp_tools_async
+from .schema_transformer import SchemaTransformer
+from .tool_definition_service import (
+ ToolDefinitionService,
+ MCPToolDefinition,
+ MCPTransportType
+)
+
+__all__ = [
+ "MCPToolFactory",
+ "MCPToolOutputSchema",
+ "fetch_mcp_tools",
+ "fetch_mcp_tools_async",
+ "SchemaTransformer",
+ "ToolDefinitionService",
+ "MCPToolDefinition",
+ "MCPTransportType",
+]
diff --git a/atomic-agents/atomic_agents/lib/utils/__init__.py b/atomic-agents/atomic_agents/lib/utils/__init__.py
index e69de29..6d883c4 100644
--- a/atomic-agents/atomic_agents/lib/utils/__init__.py
+++ b/atomic-agents/atomic_agents/lib/utils/__init__.py
@@ -0,0 +1,7 @@
+"""Utility functions."""
+
+from .format_tool_message import format_tool_message
+
+__all__ = [
+ "format_tool_message",
+]
\ No newline at end of file
diff --git a/atomic-examples/mcp-agent/example-client/example_client/main_stdio.py b/atomic-examples/mcp-agent/example-client/example_client/main_stdio.py
index 9b18761..e46f686 100644
--- a/atomic-examples/mcp-agent/example-client/example_client/main_stdio.py
+++ b/atomic-examples/mcp-agent/example-client/example_client/main_stdio.py
@@ -1,6 +1,4 @@
# pyright: reportInvalidTypeForm=false
-from atomic_agents.lib.factories.mcp_tool_factory import fetch_mcp_tools
-from atomic_agents.lib.factories.tool_definition_service import MCPTransportType
from rich.console import Console
from rich.table import Table
import openai
@@ -10,9 +8,8 @@ import asyncio
import shlex
from contextlib import AsyncExitStack
from pydantic import Field
-from atomic_agents.agents.base_agent import BaseIOSchema, BaseAgent, BaseAgentConfig
-from atomic_agents.lib.components.system_prompt_generator import SystemPromptGenerator
-from atomic_agents.lib.components.chat_history import ChatHistory
+from atomic_agents.lib.factories import fetch_mcp_tools, MCPTransportType
+from atomic_agents import BaseIOSchema, BaseAgent, BaseAgentConfig, ChatHistory, SystemPromptGenerator
from typing import Union, Type, Dict, Optional
from dataclasses import dataclass
from mcp import ClientSession, StdioServerParameters