agentkernel 0.3.3__tar.gz → 0.5.0__tar.gz

{agentkernel-0.3.3 → agentkernel-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: agentkernel
-Version: 0.3.3
+Version: 0.5.0
 Summary: Agent Kernel - Unified AI Agents Runtime
 Author: Yaala Labs
 Author-email: Yaala Labs <agentkernel@yaalalabs.com>
@@ -22,23 +22,25 @@ Requires-Dist: boto3>=1.41.4 ; extra == 'aws'
 Requires-Dist: azure-functions>=1.24.0 ; extra == 'azure'
 Requires-Dist: azure-data-tables>=12.4.0 ; extra == 'azure'
 Requires-Dist: azure-core>=1.26.0 ; extra == 'azure'
+Requires-Dist: chromadb>=0.4.0 ; extra == 'chromadb'
 Requires-Dist: crewai>=0.150.0 ; extra == 'crewai'
 Requires-Dist: openinference-instrumentation-crewai>=0.1.16 ; extra == 'crewai'
 Requires-Dist: openinference-instrumentation-litellm>=0.1.28 ; extra == 'crewai'
+Requires-Dist: google-cloud-firestore>=2.19.0 ; extra == 'gcp'
 Requires-Dist: google-auth>=2.0.0 ; extra == 'gmail'
 Requires-Dist: google-auth-oauthlib>=1.0.0 ; extra == 'gmail'
 Requires-Dist: google-auth-httplib2>=0.2.0 ; extra == 'gmail'
 Requires-Dist: google-api-python-client>=2.0.0 ; extra == 'gmail'
 Requires-Dist: httpx>=0.27.0 ; extra == 'instagram'
-Requires-Dist: langfuse>=3.9.2 ; extra == 'langfuse'
+Requires-Dist: langfuse>=4.2.0 ; extra == 'langfuse'
 Requires-Dist: nest-asyncio>=1.6.0 ; extra == 'langfuse'
 Requires-Dist: langgraph~=1.0.5 ; extra == 'langgraph'
 Requires-Dist: langchain~=1.2.3 ; extra == 'langgraph'
 Requires-Dist: langchain-community~=0.4.1 ; extra == 'langgraph'
 Requires-Dist: litellm~=1.74.9 ; extra == 'langgraph'
-Requires-Dist: fastmcp>=2.12.4 ; extra == 'mcp'
+Requires-Dist: fastmcp>=2.14.2,<3.0.0 ; extra == 'mcp'
 Requires-Dist: httpx>=0.27.0 ; extra == 'messenger'
-Requires-Dist: litellm>=1.74.9 ; extra == 'multimodal'
+Requires-Dist: neo4j>=5.0.0 ; extra == 'neo4j'
 Requires-Dist: openai-agents>=0.6.5 ; extra == 'openai'
 Requires-Dist: openinference-instrumentation-openai-agents>=1.4.0 ; extra == 'openai'
 Requires-Dist: openai-guardrails>=0.2.1 ; extra == 'openai'
@@ -46,6 +48,11 @@ Requires-Dist: traceloop-sdk>=0.48.0 ; extra == 'openllmetry'
 Requires-Dist: redis>=7.1.0 ; extra == 'redis'
 Requires-Dist: slack-bolt==1.22.0 ; extra == 'slack'
 Requires-Dist: httpx>=0.27.0 ; extra == 'slack'
+Requires-Dist: smolagents>=1.0.0 ; extra == 'smolagents'
+Requires-Dist: botbuilder-core>=4.17.0 ; extra == 'teams'
+Requires-Dist: botbuilder-schema>=4.17.0 ; extra == 'teams'
+Requires-Dist: msal>=1.31.1 ; extra == 'teams'
+Requires-Dist: httpx>=0.27.0 ; extra == 'teams'
 Requires-Dist: httpx>=0.27.0 ; extra == 'telegram'
 Requires-Dist: pytest>=8.4.1 ; extra == 'test'
 Requires-Dist: pytest-asyncio>=1.2.0 ; extra == 'test'
@@ -57,6 +64,7 @@ Requires-Dist: ragas>=0.4.1 ; extra == 'test'
 Requires-Dist: datasets>=2.14.0 ; extra == 'test'
 Requires-Dist: pandas>=2.0.0 ; extra == 'test'
 Requires-Dist: litellm>=1.74.9 ; extra == 'test'
+Requires-Dist: trino>=0.337.0 ; extra == 'trino'
 Requires-Dist: walledai>=4.9.3 ; extra == 'walledai'
 Requires-Dist: httpx>=0.27.0 ; extra == 'whatsapp'
 Requires-Python: >=3.12, <3.14
@@ -66,21 +74,26 @@ Provides-Extra: api
 Provides-Extra: auth
 Provides-Extra: aws
 Provides-Extra: azure
+Provides-Extra: chromadb
 Provides-Extra: cli
 Provides-Extra: crewai
+Provides-Extra: gcp
 Provides-Extra: gmail
 Provides-Extra: instagram
 Provides-Extra: langfuse
 Provides-Extra: langgraph
 Provides-Extra: mcp
 Provides-Extra: messenger
-Provides-Extra: multimodal
+Provides-Extra: neo4j
 Provides-Extra: openai
 Provides-Extra: openllmetry
 Provides-Extra: redis
 Provides-Extra: slack
+Provides-Extra: smolagents
+Provides-Extra: teams
 Provides-Extra: telegram
 Provides-Extra: test
+Provides-Extra: trino
 Provides-Extra: walledai
 Provides-Extra: whatsapp
 Description-Content-Type: text/markdown
@@ -90,17 +103,18 @@ Description-Content-Type: text/markdown
 [![PyPI version](https://badge.fury.io/py/agentkernel.svg)](https://badge.fury.io/py/agentkernel)
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
 
-Agent Kernel is a lightweight **multi-cloud AI agent runtime** and adapter layer for building and running AI agents across multiple frameworks and cloud providers. Deploy the same agent code to **AWS or Azure** without modification. Migrate your existing agents to Agent Kernel and instantly utilize pre-built execution and testing capabilities.
+Agent Kernel is a lightweight **multi-cloud AI agent runtime** and adapter layer for building and running AI agents across multiple frameworks and cloud providers. Deploy the same agent code to **AWS, Azure, or GCP** without modification. Migrate your existing agents to Agent Kernel and instantly utilize pre-built execution and testing capabilities.
 
-**Supported Cloud Platforms:** AWS, Azure
+**Supported Cloud Platforms:** AWS, Azure, GCP
 
 ## Features
 
 - **Unified API**: Common abstractions (Agent, Runner, Session, Module, Runtime) across frameworks
-- **Multi-Framework Support**: OpenAI Agents SDK, CrewAI, LangGraph, Google ADK
-- **Multi-Cloud Deployment**: Deploy to AWS (Lambda, ECS/Fargate) or Azure (Functions, Container Apps) with the same code
-- **Session Management**: Built-in session abstraction with multi-cloud storage (Redis, DynamoDB, Cosmos DB)
-- **Flexible Deployment**: Interactive CLI, REST API, serverless (AWS Lambda, Azure Functions), containerized (AWS ECS, Azure Container Apps)
+- **Multi-Framework Support**: OpenAI Agents SDK, CrewAI, LangGraph, Google ADK, and Smolagents
+- **Multi-Cloud Deployment**: Deploy to AWS (Lambda, ECS/Fargate), Azure (Functions, Container Apps), or GCP (Cloud Run serverless/containerized) with the same code
+- **Session Management**: Built-in session abstraction with multi-cloud storage (Redis, DynamoDB, Cosmos DB, Firestore)
+- **Knowledge Bases**: Unified `KnowledgeBase` interface with ChromaDB, Neo4j, and Starburst/Trino backends via `KnowledgeBuilder`
+- **Flexible Deployment**: Interactive CLI, REST API, serverless (AWS Lambda, Azure Functions, GCP Cloud Run), containerized (AWS ECS, Azure Container Apps, GCP Cloud Run)
 - **Pluggable Architecture**: Easy to extend with custom framework adapters and cloud providers
 - **MCP Server**: Built-in Model Context Protocol server for exposing agents as MCP tools and exposing any custom tool
 - **A2A Server**: Built-in Agent-to-Agent communication server for exposing agents with a simple configuration change
@@ -113,6 +127,14 @@ Agent Kernel is a lightweight **multi-cloud AI agent runtime** and adapter layer
 pip install agentkernel
 ```
 
+Install optional knowledge base extras as needed:
+
+```bash
+pip install "agentkernel[chromadb]"
+pip install "agentkernel[neo4j]"
+pip install "agentkernel[trino]"
+```
+
 **Requirements:**
 - Python 3.12+
 
@@ -337,6 +359,31 @@ Azure Functions also accepts the normalized envelope, and flat run payloads are
 - `400` — No agent available
 - `500` — Unexpected error
 
+### GCP Cloud Run Deployment
+
+Deploy your agents to GCP Cloud Run using the built-in `CloudRun` handler.
+
+```python
+from agentkernel.gcp import CloudRun
+from agentkernel.openai import OpenAIModule
+
+OpenAIModule([...])
+
+@CloudRun.register("/app", method="GET")
+def app_handler() -> dict:
+    return {"status": "ok"}
+
+def main() -> None:
+    CloudRun.run()
+
+if __name__ == "__main__":
+    main()
+```
+
+`CloudRun` is the GCP equivalent of `Lambda` (AWS) and `AzureFunctions` (Azure). It wraps `RESTAPI` and starts a FastAPI/uvicorn server. Custom routes are registered with `@CloudRun.register(path, method)`. Use `CloudRun.run()` instead of `RESTAPI.run()` when deploying to GCP.
+
+For full Terraform deployment configuration, see [`ak-deployment/ak-gcp/`](https://github.com/yaalalabs/agent-kernel/tree/develop/ak-deployment/ak-gcp) or the [GCP deployment docs](https://github.com/yaalalabs/agent-kernel/tree/develop/docs/docs/deployment/gcp-serverless.md).
+
 ## Configuration
 
 Agent Kernel can be configured via environment variables, `.env` files, or YAML/JSON configuration files.
@@ -364,13 +411,19 @@ Supported formats: `.yaml`, `.yml`, `.json`
 
 ### Configuration Options
 
-#### Debug Mode
+#### Logging Configuration
+
+- **Field**: `logging.ak.level`
+- **Type**: string
+- **Default**: `WARNING`
+- **Description**: Agent Kernel logger level (INFO, DEBUG, ERROR, WARNING, CRITICAL)
+- **Environment Variable**: `AK_LOGGING__AK__LEVEL`
 
-- **Field**: `debug`
-- **Type**: boolean
-- **Default**: `false`
-- **Description**: Enable debug mode across the library
-- **Environment Variable**: `AK_DEBUG`
+- **Field**: `logging.system.level`
+- **Type**: string
+- **Default**: `WARNING`
+- **Description**: System/root logger level (INFO, DEBUG, ERROR, WARNING, CRITICAL)
+- **Environment Variable**: `AK_LOGGING__SYSTEM__LEVEL`
 
 #### Session Store
 
@@ -378,7 +431,7 @@ Configure where agent sessions are stored (supports multi-cloud storage backends
 
 - **Field**: `session.type`
 - **Type**: string
-- **Options**: `in_memory`, `redis`, `dynamodb` (AWS), `cosmosdb` (Azure)
+- **Options**: `in_memory`, `redis`, `dynamodb` (AWS), `cosmosdb` (Azure), `firestore` (GCP)
 - **Default**: `in_memory`
 - **Environment Variable**: `AK_SESSION__TYPE`
 
@@ -538,10 +591,15 @@ Configure the REST API server (if using the API module).
   - **Description**: List of agent names to expose as MCP tools
   - **Environment Variable**: `AK_MCP__AGENTS` (comma-separated)
 
-- **URL**
-  - **Field**: `mcp.url`
-  - **Default**: `http://localhost:8000/mcp`
-  - **Environment Variable**: `AK_MCP__URL`
+- **Stateless HTTP**
+  - **Field**: `mcp.stateless_http`
+  - **Default**: `false`
+  - **Description**: Run MCP in stateless HTTP mode (no `Mcp-Session-Id`)
+  - **Environment Variable**: `AK_MCP__STATELESS_HTTP`
+
+- **Endpoint** (not configurable)
+  - The MCP server is always mounted at `/mcp` on the main API server.
+  - Full URL: `http://{api.host}:{api.port}/mcp` — use `api.port` / `AK_API__PORT` to change the port.
 
 #### Trace (Observability) Configuration
 
@@ -956,7 +1014,6 @@ AK_TRACE__TYPE=langfuse  # or openllmetry
 #### config.yaml
 
 ```yaml
-debug: false
 session:
   type: redis
   redis:
@@ -998,7 +1055,6 @@ mcp:
   enabled: false
   expose_agents: false
   agents: ["*"]
-  url: http://localhost:8000/mcp
 trace:
   enabled: true
   type: langfuse
@@ -1070,8 +1126,7 @@ gmail:
   "mcp": {
     "enabled": false,
     "expose_agents": false,
-    "agents": ["*"],
-    "url": "http://localhost:8000/mcp"
+    "agents": ["*"]
   },
   "trace": {
     "enabled": true,

{agentkernel-0.3.3 → agentkernel-0.5.0}/README.md

@@ -3,17 +3,18 @@
 [![PyPI version](https://badge.fury.io/py/agentkernel.svg)](https://badge.fury.io/py/agentkernel)
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
 
-Agent Kernel is a lightweight **multi-cloud AI agent runtime** and adapter layer for building and running AI agents across multiple frameworks and cloud providers. Deploy the same agent code to **AWS or Azure** without modification. Migrate your existing agents to Agent Kernel and instantly utilize pre-built execution and testing capabilities.
+Agent Kernel is a lightweight **multi-cloud AI agent runtime** and adapter layer for building and running AI agents across multiple frameworks and cloud providers. Deploy the same agent code to **AWS, Azure, or GCP** without modification. Migrate your existing agents to Agent Kernel and instantly utilize pre-built execution and testing capabilities.
 
-**Supported Cloud Platforms:** AWS, Azure
+**Supported Cloud Platforms:** AWS, Azure, GCP
 
 ## Features
 
 - **Unified API**: Common abstractions (Agent, Runner, Session, Module, Runtime) across frameworks
-- **Multi-Framework Support**: OpenAI Agents SDK, CrewAI, LangGraph, Google ADK
-- **Multi-Cloud Deployment**: Deploy to AWS (Lambda, ECS/Fargate) or Azure (Functions, Container Apps) with the same code
-- **Session Management**: Built-in session abstraction with multi-cloud storage (Redis, DynamoDB, Cosmos DB)
-- **Flexible Deployment**: Interactive CLI, REST API, serverless (AWS Lambda, Azure Functions), containerized (AWS ECS, Azure Container Apps)
+- **Multi-Framework Support**: OpenAI Agents SDK, CrewAI, LangGraph, Google ADK, and Smolagents
+- **Multi-Cloud Deployment**: Deploy to AWS (Lambda, ECS/Fargate), Azure (Functions, Container Apps), or GCP (Cloud Run serverless/containerized) with the same code
+- **Session Management**: Built-in session abstraction with multi-cloud storage (Redis, DynamoDB, Cosmos DB, Firestore)
+- **Knowledge Bases**: Unified `KnowledgeBase` interface with ChromaDB, Neo4j, and Starburst/Trino backends via `KnowledgeBuilder`
+- **Flexible Deployment**: Interactive CLI, REST API, serverless (AWS Lambda, Azure Functions, GCP Cloud Run), containerized (AWS ECS, Azure Container Apps, GCP Cloud Run)
 - **Pluggable Architecture**: Easy to extend with custom framework adapters and cloud providers
 - **MCP Server**: Built-in Model Context Protocol server for exposing agents as MCP tools and exposing any custom tool
 - **A2A Server**: Built-in Agent-to-Agent communication server for exposing agents with a simple configuration change
@@ -26,6 +27,14 @@ Agent Kernel is a lightweight **multi-cloud AI agent runtime** and adapter layer
 pip install agentkernel
 ```
 
+Install optional knowledge base extras as needed:
+
+```bash
+pip install "agentkernel[chromadb]"
+pip install "agentkernel[neo4j]"
+pip install "agentkernel[trino]"
+```
+
 **Requirements:**
 - Python 3.12+
 
@@ -250,6 +259,31 @@ Azure Functions also accepts the normalized envelope, and flat run payloads are
 - `400` — No agent available
 - `500` — Unexpected error
 
+### GCP Cloud Run Deployment
+
+Deploy your agents to GCP Cloud Run using the built-in `CloudRun` handler.
+
+```python
+from agentkernel.gcp import CloudRun
+from agentkernel.openai import OpenAIModule
+
+OpenAIModule([...])
+
+@CloudRun.register("/app", method="GET")
+def app_handler() -> dict:
+    return {"status": "ok"}
+
+def main() -> None:
+    CloudRun.run()
+
+if __name__ == "__main__":
+    main()
+```
+
+`CloudRun` is the GCP equivalent of `Lambda` (AWS) and `AzureFunctions` (Azure). It wraps `RESTAPI` and starts a FastAPI/uvicorn server. Custom routes are registered with `@CloudRun.register(path, method)`. Use `CloudRun.run()` instead of `RESTAPI.run()` when deploying to GCP.
+
+For full Terraform deployment configuration, see [`ak-deployment/ak-gcp/`](https://github.com/yaalalabs/agent-kernel/tree/develop/ak-deployment/ak-gcp) or the [GCP deployment docs](https://github.com/yaalalabs/agent-kernel/tree/develop/docs/docs/deployment/gcp-serverless.md).
+
 ## Configuration
 
 Agent Kernel can be configured via environment variables, `.env` files, or YAML/JSON configuration files.
@@ -277,13 +311,19 @@ Supported formats: `.yaml`, `.yml`, `.json`
 
 ### Configuration Options
 
-#### Debug Mode
+#### Logging Configuration
+
+- **Field**: `logging.ak.level`
+- **Type**: string
+- **Default**: `WARNING`
+- **Description**: Agent Kernel logger level (INFO, DEBUG, ERROR, WARNING, CRITICAL)
+- **Environment Variable**: `AK_LOGGING__AK__LEVEL`
 
-- **Field**: `debug`
-- **Type**: boolean
-- **Default**: `false`
-- **Description**: Enable debug mode across the library
-- **Environment Variable**: `AK_DEBUG`
+- **Field**: `logging.system.level`
+- **Type**: string
+- **Default**: `WARNING`
+- **Description**: System/root logger level (INFO, DEBUG, ERROR, WARNING, CRITICAL)
+- **Environment Variable**: `AK_LOGGING__SYSTEM__LEVEL`
 
 #### Session Store
 
@@ -291,7 +331,7 @@ Configure where agent sessions are stored (supports multi-cloud storage backends
 
 - **Field**: `session.type`
 - **Type**: string
-- **Options**: `in_memory`, `redis`, `dynamodb` (AWS), `cosmosdb` (Azure)
+- **Options**: `in_memory`, `redis`, `dynamodb` (AWS), `cosmosdb` (Azure), `firestore` (GCP)
 - **Default**: `in_memory`
 - **Environment Variable**: `AK_SESSION__TYPE`
 
@@ -451,10 +491,15 @@ Configure the REST API server (if using the API module).
   - **Description**: List of agent names to expose as MCP tools
   - **Environment Variable**: `AK_MCP__AGENTS` (comma-separated)
 
-- **URL**
-  - **Field**: `mcp.url`
-  - **Default**: `http://localhost:8000/mcp`
-  - **Environment Variable**: `AK_MCP__URL`
+- **Stateless HTTP**
+  - **Field**: `mcp.stateless_http`
+  - **Default**: `false`
+  - **Description**: Run MCP in stateless HTTP mode (no `Mcp-Session-Id`)
+  - **Environment Variable**: `AK_MCP__STATELESS_HTTP`
+
+- **Endpoint** (not configurable)
+  - The MCP server is always mounted at `/mcp` on the main API server.
+  - Full URL: `http://{api.host}:{api.port}/mcp` — use `api.port` / `AK_API__PORT` to change the port.
 
 #### Trace (Observability) Configuration
 
@@ -869,7 +914,6 @@ AK_TRACE__TYPE=langfuse  # or openllmetry
 #### config.yaml
 
 ```yaml
-debug: false
 session:
   type: redis
   redis:
@@ -911,7 +955,6 @@ mcp:
   enabled: false
   expose_agents: false
   agents: ["*"]
-  url: http://localhost:8000/mcp
 trace:
   enabled: true
   type: langfuse
@@ -983,8 +1026,7 @@ gmail:
   "mcp": {
     "enabled": false,
     "expose_agents": false,
-    "agents": ["*"],
-    "url": "http://localhost:8000/mcp"
+    "agents": ["*"]
   },
   "trace": {
     "enabled": true,

{agentkernel-0.3.3 → agentkernel-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "agentkernel"
-version = "0.3.3"
+version = "0.5.0"
 description = "Agent Kernel - Unified AI Agents Runtime"
 readme = "README.md"
 requires-python = ">=3.12,<3.14"
@@ -25,7 +25,7 @@ auth = [
     "PyJWT>=2.0.0",
 ]
 langfuse = [
-    "langfuse>=3.9.2",
+    "langfuse>=4.2.0",
     "nest-asyncio>=1.6.0",
 ]
 openllmetry = [
@@ -42,6 +42,9 @@ langgraph = [
     "langchain_community~=0.4.1",
     "litellm~=1.74.9"
 ]
+smolagents = [
+    "smolagents>=1.0.0",
+]
 cli = [
 
 ]
@@ -57,6 +60,17 @@ azure = [
 redis = [
     "redis>=7.1.0",
 ]
+
+neo4j = [
+    "neo4j>=5.0.0",
+]
+chromadb = [
+    "chromadb>=0.4.0",
+]
+trino = [
+    "trino>=0.337.0",
+]
+
 openai = [
     "openai-agents>=0.6.5",
     "openinference-instrumentation-openai-agents>=1.4.0",
@@ -91,12 +105,21 @@ instagram = [
 telegram = [
     "httpx>=0.27.0"
 ]
+teams = [
+    "botbuilder-core>=4.17.0",
+    "botbuilder-schema>=4.17.0",
+    "msal>=1.31.1",
+    "httpx>=0.27.0",
+]
 gmail = [
     "google-auth>=2.0.0",
     "google-auth-oauthlib>=1.0.0",
     "google-auth-httplib2>=0.2.0",
     "google-api-python-client>=2.0.0",
 ]
+gcp = [
+    "google-cloud-firestore>=2.19.0",
+]
 test = [
     "pytest>=8.4.1",
     "pytest-asyncio>=1.2.0",
@@ -113,10 +136,7 @@ a2a = [
     "a2a-sdk[http-server]>=0.3.6",
 ]
 mcp = [
-    "fastmcp>=2.12.4",
-]
-multimodal = [
-    "litellm>=1.74.9",
+    "fastmcp>=2.14.2,<3.0.0"
 ]
 
 [project.scripts]
@@ -150,4 +170,3 @@ target-version = ["py312"]
 
 [tool.pytest.ini_options]
 addopts = "--cov=src --cov-report=term --cov-report=html --html=report.html"
-

{agentkernel-0.3.3 → agentkernel-0.5.0}/src/agentkernel/__init__.py

@@ -5,7 +5,7 @@ This package provides a unified framework for working with different agent imple
 It includes core functionality for agent execution, modular integration, and runtime management.
 
 Features:
-- Support for multiple agent frameworks (OpenAI, CrewAI, LangGraph)
+- Support for multiple agent frameworks (OpenAI, CrewAI, LangGraph, Smolagents)
 - Modular architecture for easy extension
 - Unified runtime environment
 - CLI interface for agent interaction
@@ -19,3 +19,8 @@ except importlib.metadata.PackageNotFoundError:
     __version__ = "0.1.0"
 
 from .core import *
+
+# Auto-configure logging on import if not already configured (handled inside the "configure_from_config()" function)
+from .core.logger import AKLogger
+
+AKLogger.configure_from_config()

{agentkernel-0.3.3 → agentkernel-0.5.0}/src/agentkernel/api/a2a/a2a.py

@@ -31,7 +31,7 @@ class A2A:
     """
     Card built flag
     """
-    _log = logging.getLogger(__name__)
+    _log = logging.getLogger("ak.a2a")
 
     class Executor(AgentExecutor):
 

agentkernel-0.5.0/src/agentkernel/api/handler.py

@@ -0,0 +1,87 @@
+import logging
+from abc import ABC, abstractmethod
+from typing import List, Optional
+
+from fastapi import APIRouter, File, Form, UploadFile
+from pydantic import ConfigDict
+
+from ..core import Config
+from ..core.chat_service import ChatService
+from ..core.model import BaseChatRequest, BaseRunRequest
+from ..core.runtime import Runtime
+
+
+class RESTRequestHandler(ABC):
+    @abstractmethod
+    def get_router(self) -> APIRouter:
+        """
+        Returns the APIRouter instance which has configured routes
+        E.g.:
+        - GET /api/v1/agents: List available agents
+
+        router = APIRouter()
+
+        @router.get("/api/v1/agents")
+        def list_agents():
+            from ..core.runtime import Runtime
+            return {"agents": list(Runtime.current().agents().keys())}
+
+        """
+        pass
+
+
+class AgentRESTRequestHandler(RESTRequestHandler):
+    """
+    API routers that expose endpoints to interact with Agent Kernel.
+    Endpoints:
+    - GET /api/v1/agents: List available agents
+    - POST /api/v1/chat: Run an agent with a prompt
+      Payload JSON: { "prompt": str, "agent": str | null, "session_id": str | null }
+    """
+
+    class BaseMultimodalRunRequest(BaseChatRequest):
+        """Chat request with multipart file and image uploads (UploadFile format)."""
+
+        files: Optional[List[UploadFile]] = None
+        images: Optional[List[UploadFile]] = None
+        model_config = ConfigDict(extra="allow")
+
+    def __init__(self):
+        self._log = logging.getLogger("ak.api.agent")
+        self._max_file_size = Config.get().api.max_file_size
+        self.chat_service = ChatService(rest_api_mode=True)
+
+    def get_router(self) -> APIRouter:
+        """
+        Returns the APIRouter instance.
+        """
+
+        router = APIRouter()
+
+        @router.get("/api/v1/agents")
+        def list_agents():
+            return {"agents": list(Runtime.current().agents().keys())}
+
+        @router.post("/api/v1/chat")
+        async def run(body: BaseRunRequest):
+            return await self.chat_service.process_async_chat_request(req=body)
+
+        @router.post("/api/v1/chat-multipart")
+        async def run_multipart(
+            prompt: str = Form(...),
+            agent: Optional[str] = Form(None),
+            session_id: Optional[str] = Form(None),
+            files: Optional[List[UploadFile]] = File(None),
+            images: Optional[List[UploadFile]] = File(None),
+        ):
+            # Construct BaseMultimodalRunRequest from form parameters
+            req = AgentRESTRequestHandler.BaseMultimodalRunRequest(
+                prompt=prompt,
+                agent=agent,
+                session_id=session_id,
+                files=files,
+                images=images,
+            )
+            return await self.chat_service.process_async_chat_request(req=req)
+
+        return router

{agentkernel-0.3.3 → agentkernel-0.5.0}/src/agentkernel/api/http.py

@@ -9,12 +9,6 @@ from ..auth import AuthValidator, ValidationContext
 from ..core.config import AKConfig
 from .handler import AgentRESTRequestHandler, RESTRequestHandler
 
-logging.basicConfig(
-    level=logging.DEBUG,
-    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
-    force=True,
-)
-
 
 class RESTAPI:
     """

{agentkernel-0.3.3 → agentkernel-0.5.0}/src/agentkernel/api/mcp/akmcp.py

@@ -59,7 +59,10 @@ class MCP:
         if cls._built or not AKConfig.get().mcp.enabled:
             return
         if cls._fastmcp is None:
-            cls._fastmcp = FastMCP("Agent Kernel FastMCP Instance")
+            cls._fastmcp = FastMCP(
+                "Agent Kernel FastMCP Instance",
+                stateless_http=AKConfig.get().mcp.stateless_http,
+            )
         if AKConfig.get().mcp.expose_agents:
             agents: dict[str, Agent] = Runtime.current().agents()
             for name, agent in agents.items():

{agentkernel-0.3.3 → agentkernel-0.5.0}/src/agentkernel/auth/handler.py

@@ -7,7 +7,7 @@ from pydantic import BaseModel
 class ValidationContext(BaseModel):
     path: Optional[str] = None
     http_method: Optional[str] = None
-    headers: Dict[str, str]
+    headers: Optional[Dict[str, Any]] = None
 
 
 class ValidationResult(BaseModel):

{agentkernel-0.3.3 → agentkernel-0.5.0}/src/agentkernel/cli/cli.py

@@ -3,17 +3,14 @@ import logging
 import readline  # Enables line editing and history features for input() in the CLI
 
 from ..core import AgentService
+from ..core.config import AKConfig
 
-# Configure logger only to print agent kernel logs
-ak_logger = logging.getLogger("ak")
-ak_logger.setLevel(logging.INFO)
-ak_logger.propagate = False
+ak_cli_logger = logging.getLogger("ak.cli")
 
-if not ak_logger.handlers:
+if not ak_cli_logger.handlers:
     handler = logging.StreamHandler()
-    handler.setLevel(logging.INFO)
     handler.setFormatter(logging.Formatter("\033[36m(kernel) >> %(message)s\033[0m"))
-    ak_logger.addHandler(handler)
+    ak_cli_logger.addHandler(handler)
 
 
 class CLI:
@@ -101,7 +98,7 @@ class CLI:
                 raise
             except Exception as e:
                 self._print(f"Error: {e}")
-                ak_logger.error("Exception in CLI run loop", exc_info=True)
+                ak_cli_logger.error("Exception in CLI run loop", exc_info=True)
 
     @classmethod
     def main(cls):

{agentkernel-0.3.3 → agentkernel-0.5.0}/src/agentkernel/core/__init__.py

@@ -29,3 +29,4 @@ from .service import AgentService
 from .hooks import PreHook, PostHook
 from .tool import ToolContext, ToolBuilder
 from .util.key_value_cache import KeyValueCache
+from .chat_service import ChatService