agent-framework-lib 0.8.2.post2__tar.gz → 0.8.4__tar.gz

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/MANIFEST.in

@@ -11,6 +11,9 @@ include docs/*.md
 # Include type information
 include agent_framework/py.typed
 
+# Include PowerPoint templates embedded with the powerpoint skill
+recursive-include agent_framework/skills/builtin/skills/powerpoint/templates *.pptx
+
 # Include HTML templates and static files from the main package
 include agent_framework/test_app.html
 include agent_framework/*.html

{agent_framework_lib-0.8.2.post2/agent_framework_lib.egg-info → agent_framework_lib-0.8.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-framework-lib
-Version: 0.8.2.post2
+Version: 0.8.4
 Summary: A comprehensive Python framework for building and serving conversational AI agents with FastAPI
 Author-email: Sebastian Pavel <sebastian@cinco.ai>, Elliott Girard <elliott.girard@icloud.com>
 Maintainer-email: Sebastian Pavel <sebastian@cinco.ai>

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/__init__.py

@@ -32,7 +32,7 @@ Example Usage:
     create_basic_agent_server(MyAgent, port=8000)
     ```
 
-Version: 0.8.2
+Version: 0.8.4
 Author: Cinco AI Team
 License: MIT
 """
@@ -41,6 +41,7 @@ import logging
 import os
 from typing import TYPE_CHECKING
 
+
 # Create logger for this module
 logger = logging.getLogger(__name__)
 
@@ -64,7 +65,7 @@ def _auto_setup_dependencies() -> None:
     _AUTO_SETUP_DONE = True
 
     try:
-        from .utils.post_install import ensure_playwright_browsers, ensure_deno
+        from .utils.post_install import ensure_deno, ensure_playwright_browsers
 
         # Check/install Playwright (silent if already installed)
         success, error = ensure_playwright_browsers()
@@ -88,99 +89,100 @@ def _auto_setup_dependencies() -> None:
 # Track if auto-setup has been done
 _AUTO_SETUP_DONE = False
 
-__version__ = "0.8.2"
+__version__ = "0.8.4"
 __author__ = "Cinco AI Team"
 __license__ = "MIT"
 __email__ = "sebastian@cinco.ai"
 
 # Core interfaces and base classes
 from .core.agent_interface import (
+    AgentConfig,
+    AgentInputPartUnion,
     AgentInterface,
+    AgentOutputPartUnion,
+    ChartJsOutputPart,
+    FileContentOutputPart,
+    FileDataInputPart,
+    FileDownloadLinkOutputPart,
+    FileReferenceInputPart,
+    FileReferenceOutputPart,
+    FormDefinitionOutputPart,
+    ImageOutputPart,
+    ImageUrlInputPart,
+    JsonOutputPart,
+    MermaidOutputPart,
+    OptionsBlockOutputPart,
     StructuredAgentInput,
     StructuredAgentOutput,
-    AgentConfig,
+    TableDataOutputPart,
     # Input part types
     TextInputPart,
-    ImageUrlInputPart,
-    FileDataInputPart,
-    AgentInputPartUnion,
     # Output part types
     TextOutputPart,
     TextOutputStreamPart,
-    JsonOutputPart,
     YamlOutputPart,
-    FileContentOutputPart,
-    FileReferenceInputPart,
-    FileReferenceOutputPart,
-    MermaidOutputPart,
-    ChartJsOutputPart,
-    TableDataOutputPart,
-    FormDefinitionOutputPart,
-    OptionsBlockOutputPart,
-    FileDownloadLinkOutputPart,
-    ImageOutputPart,
-    AgentOutputPartUnion,
     # Utility functions
     consolidate_text_parts,
     strip_technical_details,
 )
 
-# Framework-agnostic base agent and implementations
-from .core.base_agent import BaseAgent
-from .implementations.llamaindex_agent import LlamaIndexAgent
-from .implementations.microsoft_agent import MicrosoftAgent
-
-# State management
-from .core.state_manager import StateManager, AgentIdentity
-
 # Agent provider
 from .core.agent_provider import AgentManager
 
+# Framework-agnostic base agent and implementations
+from .core.base_agent import BaseAgent
+from .core.model_clients import ModelClientFactory, client_factory
+
 # Model configuration and clients
 from .core.model_config import ModelConfigManager, ModelProvider, model_config
-from .core.model_clients import ModelClientFactory, client_factory
+
+# State management
+from .core.state_manager import AgentIdentity, StateManager
+from .implementations.llamaindex_agent import LlamaIndexAgent
+from .implementations.microsoft_agent import MicrosoftAgent
 
 # Session storage
 from .session.session_storage import (
-    SessionStorageInterface,
-    SessionStorageFactory,
-    SessionData,
+    AgentLifecycleData,
+    MemorySessionStorage,
     MessageData,
     MessageInsight,
     MessageMetadata,
-    AgentLifecycleData,
-    MemorySessionStorage,
     MongoDBSessionStorage,
+    SessionData,
+    SessionStorageFactory,
+    SessionStorageInterface,
     history_message_to_message_data,
     message_data_to_history_message,
 )
+from .storage.file_storages import (
+    FileMetadata,
+    FileStorageInterface,
+    LocalFileStorage,
+    MetadataStorageInterface,
+)
 
 # File system management (consolidated)
 from .storage.file_system_management import (
-    FileStorageManager,
+    FileInputMixin,
     FileStorageFactory,
-    process_file_inputs,
-    process_response_file_links,
+    FileStorageManager,
     get_download_url,
     get_file_processing_summary,
-    FileInputMixin,
-)
-from .storage.file_storages import (
-    FileStorageInterface,
-    MetadataStorageInterface,
-    FileMetadata,
-    LocalFileStorage,
+    process_file_inputs,
+    process_response_file_links,
 )
 
+
 # Optional file storage backends (only available if dependencies are installed)
 try:
-    from .storage.file_storages import S3FileStorage, S3_AVAILABLE
+    from .storage.file_storages import S3_AVAILABLE, S3FileStorage
 except ImportError:
     S3FileStorage = None
     S3_AVAILABLE = False
 
 try:
-    from .storage.file_storages import MinIOFileStorage, MINIO_AVAILABLE
+    from .storage.file_storages import MINIO_AVAILABLE, MinIOFileStorage
 except ImportError:
     MinIOFileStorage = None
     MINIO_AVAILABLE = False
@@ -191,6 +193,7 @@ from .utils import get_deno_command
 # Server application
 from .web.server import app, start_server
 
+
 # Convenience imports for common use cases
 __all__ = [
     # Version info

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/a2a/__init__.py

@@ -9,15 +9,16 @@ The Task Store is a lightweight mapping layer: it links A2A task IDs
 to existing framework sessions, without duplicating conversational content.
 """
 
-from .models import A2ATask, TaskStatus
 from .base import A2ATaskProvider
+from .models import A2ATask, TaskStatus
 from .providers import (
-    ElasticsearchTaskProvider,
-    PostgresTaskProvider,
     ELASTICSEARCH_PROVIDER_AVAILABLE,
     POSTGRES_PROVIDER_AVAILABLE,
+    ElasticsearchTaskProvider,
+    PostgresTaskProvider,
 )
 
+
 __all__ = [
     "A2ATask",
     "TaskStatus",
@@ -31,4 +32,5 @@ __all__ = [
 
 from . import endpoints
 
+
 __version__ = "0.1.0"

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/a2a/endpoints/a2a_router.py

@@ -4,17 +4,22 @@ from __future__ import annotations
 
 import logging
 import os
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
 from fastapi import APIRouter, Depends, HTTPException, Request
-from fastapi.responses import JSONResponse
 
 from .agent_card_builder import AgentCardBuilder
 from .jsonrpc_dispatcher import JSONRPCDispatcher
-from .models_jsonrpc import A2AConfigRequest
 from .sse_wrapper import SSEWrapperA2A
 from .translation_layer import A2ATranslationLayer
 
+
+if TYPE_CHECKING:
+    from fastapi.responses import JSONResponse
+
+    from .models_jsonrpc import A2AConfigRequest
+
+
 logger = logging.getLogger(__name__)
 
 

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/a2a/endpoints/jsonrpc_dispatcher.py

@@ -21,6 +21,7 @@ from .models_jsonrpc import (
     TaskGetParams,
 )
 
+
 logger = logging.getLogger(__name__)
 
 

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/a2a/endpoints/models_jsonrpc.py

@@ -6,6 +6,7 @@ from typing import Any, Literal
 
 from pydantic import BaseModel
 
+
 # JSON-RPC 2.0 standard error codes
 PARSE_ERROR = -32700
 INVALID_REQUEST = -32600

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/a2a/endpoints/sse_wrapper.py

@@ -16,6 +16,7 @@ from .models_jsonrpc import (
     TaskStatusUpdateEvent,
 )
 
+
 logger = logging.getLogger(__name__)
 
 

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/a2a/endpoints/translation_layer.py

@@ -4,16 +4,12 @@ from __future__ import annotations
 
 import logging
 import uuid
-from collections.abc import AsyncGenerator
 from datetime import datetime, timezone
 from typing import TYPE_CHECKING, Any
 
-from ..base import TaskNotCancelableError, TaskNotFoundError
+from ..base import TaskNotFoundError
 from ..models import A2ATask, TaskStatus
 from .models_jsonrpc import (
-    INTERNAL_ERROR,
-    TASK_NOT_CANCELABLE,
-    TASK_NOT_FOUND,
     A2AArtifact,
     A2AMessage,
     A2APart,
@@ -24,7 +20,10 @@ from .models_jsonrpc import (
     TaskGetParams,
 )
 
+
 if TYPE_CHECKING:
+    from collections.abc import AsyncGenerator
+
     from ..base import A2ATaskProvider
     from .sse_wrapper import SSEWrapperA2A
 

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/a2a/providers/elasticsearch_provider.py

@@ -1,7 +1,7 @@
 """Elasticsearch implementation of A2ATaskProvider."""
 
 import logging
-from datetime import datetime, timezone, timedelta
+from datetime import datetime, timedelta, timezone
 
 from ..base import (
     A2ATaskProvider,

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/a2a/providers/postgres_provider.py

@@ -2,7 +2,8 @@
 
 import json
 import logging
-from datetime import datetime, timezone, timedelta
+from datetime import datetime, timedelta, timezone
+
 
 try:
     import asyncpg  # noqa: F401 — availability check

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/capabilities/__init__.py

@@ -1,6 +1,6 @@
 """Capability resolution for token-based access control."""
 
-from .resolver import CapabilityResolverError, CapabilityResolver, CapabilitySet
+from .resolver import CapabilityResolver, CapabilityResolverError, CapabilitySet
 
 
 __all__ = [

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/capabilities/resolver.py

@@ -8,10 +8,13 @@ import contextlib
 import json
 import logging
 import os
-from collections.abc import Iterator
 from dataclasses import dataclass, field
 from pathlib import Path
-from typing import Any
+from typing import TYPE_CHECKING, Any
+
+
+if TYPE_CHECKING:
+    from collections.abc import Iterator
 
 
 logger = logging.getLogger(__name__)
@@ -27,7 +30,7 @@ class CapabilitySet:
     env_overrides: dict[str, str] = field(default_factory=dict)
 
     @classmethod
-    def empty(cls) -> "CapabilitySet":
+    def empty(cls) -> CapabilitySet:
         """Return an empty CapabilitySet (no capabilities authorized)."""
         return cls()
 

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/core/__init__.py

@@ -3,4 +3,5 @@
 from agent_framework.core.elasticsearch_config_provider import ElasticsearchConfigProvider
 from agent_framework.core.models import Tag
 
+
 __all__ = ["ElasticsearchConfigProvider", "Tag"]

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/core/agent_interface.py

@@ -95,9 +95,8 @@ class FileDataInputPart(BaseModel):
     @classmethod
     def validate_at_least_one_source(cls, data: Any) -> Any:
         """Ensure content_base64 is present."""
-        if isinstance(data, dict):
-            if "content_base64" not in data:
-                raise ValueError("content_base64 must be present")
+        if isinstance(data, dict) and "content_base64" not in data:
+            raise ValueError("content_base64 must be present")
         return data
 
     def set_binary_content(self, binary_data: bytes):
@@ -201,9 +200,8 @@ class MediaPartType(BaseModel):
     @classmethod
     def validate_at_least_one_source(cls, data: Any) -> Any:
         """Ensure either content or url is present."""
-        if isinstance(data, dict):
-            if not ("content" in data or "url" in data):
-                raise ValueError("Either content or url must be present")
+        if isinstance(data, dict) and not ("content" in data or "url" in data):
+            raise ValueError("Either content or url must be present")
         return data
 
     def set_binary_content(self, binary_data: bytes):

{agent_framework_lib-0.8.2.post2 → agent_framework_lib-0.8.4}/agent_framework/core/agent_provider.py

@@ -12,22 +12,23 @@ Observability Integration:
 - Uses StreamingLatencyTracer for granular preprocessing instrumentation
 """
 
-import logging
 import asyncio
+import logging
 import uuid
+from collections.abc import AsyncGenerator
 from datetime import datetime, timezone
-from typing import TYPE_CHECKING, Any, AsyncGenerator, Dict, Optional, Type
+from typing import TYPE_CHECKING, Any
 
-from .agent_interface import AgentInterface, StructuredAgentInput, StructuredAgentOutput
 from agent_framework.core.model_config import model_config
-from .state_manager import AgentIdentity, StateManager
-from ..session.session_storage import AgentLifecycleData, SessionStorageInterface
+
 from ..monitoring.streaming_latency_tracer import get_streaming_latency_tracer
+from ..session.session_storage import AgentLifecycleData, SessionStorageInterface
+from .agent_interface import AgentInterface, StructuredAgentInput, StructuredAgentOutput
+from .state_manager import AgentIdentity, StateManager
 
 
 if TYPE_CHECKING:
     from ..monitoring.observability_manager import ObservabilityManager
-    from ..monitoring.tracing_context import APISpanContext
 
 logger = logging.getLogger(__name__)
 
@@ -60,15 +61,15 @@ class _ManagedAgentProxy(AgentInterface):
         """
         return getattr(self._real_agent, name)
 
-    async def get_metadata(self) -> Dict[str, Any]:
+    async def get_metadata(self) -> dict[str, Any]:
         """Passes the call to the real agent."""
         return await self._real_agent.get_metadata()
 
-    async def get_system_prompt(self) -> Optional[str]:
+    async def get_system_prompt(self) -> str | None:
         """Passes the call to the real agent."""
         return await self._real_agent.get_system_prompt()
 
-    async def get_current_model(self, session_id: str) -> Optional[str]:
+    async def get_current_model(self, session_id: str) -> str | None:
         """Passes the call to the real agent."""
         return await self._real_agent.get_current_model(session_id)
 
@@ -82,17 +83,17 @@ class _ManagedAgentProxy(AgentInterface):
         if hasattr(self._real_agent, "set_display_config_manager"):
             self._real_agent.set_display_config_manager(manager)
 
-    def get_custom_tool_display_info(self) -> Dict[str, Any]:
+    def get_custom_tool_display_info(self) -> dict[str, Any]:
         """Passes the call to the real agent to get custom tool display info."""
         if hasattr(self._real_agent, "get_custom_tool_display_info"):
             return self._real_agent.get_custom_tool_display_info()
         return {}
 
-    async def get_state(self) -> Dict[str, Any]:
+    async def get_state(self) -> dict[str, Any]:
         """Passes the call to the real agent."""
         return await self._real_agent.get_state()
 
-    async def load_state(self, state: Dict[str, Any]):
+    async def load_state(self, state: dict[str, Any]):
         """Passes the call to the real agent."""
         await self._real_agent.load_state(state)
 
@@ -182,8 +183,8 @@ class AgentManager:
 
     def __init__(self, storage: SessionStorageInterface):
         self._storage = storage
-        self._active_agents: Dict[str, AgentInterface] = {}  # A cache for active agent instances
-        self._observability_manager: Optional["ObservabilityManager"] = None
+        self._active_agents: dict[str, AgentInterface] = {}  # A cache for active agent instances
+        self._observability_manager: ObservabilityManager | None = None
 
     def _get_observability_manager(self) -> "ObservabilityManager":
         """Get or create the ObservabilityManager instance.
@@ -198,7 +199,7 @@ class AgentManager:
         return self._observability_manager
 
     async def get_agent(
-        self, session_id: str, agent_class: Type[AgentInterface], user_id: str = ""
+        self, session_id: str, agent_class: type[AgentInterface], user_id: str = ""
     ) -> AgentInterface:
         """
         Gets a fully initialized agent instance for a given session, wrapped in a
@@ -225,9 +226,7 @@ class AgentManager:
         async with tracer.agent_span("inject_storage"):
             if hasattr(real_agent, "set_session_storage"):
                 real_agent.set_session_storage(self._storage)
-                logger.debug(
-                    f"AgentManager: Injected session storage into agent for memory support"
-                )
+                logger.debug("AgentManager: Injected session storage into agent for memory support")
 
         # 2. Create agent identity before any other operations
         agent_identity = StateManager.create_agent_identity(real_agent)
@@ -236,7 +235,6 @@ class AgentManager:
         )
 
         # Import model_config before using it
-        from agent_framework.core.model_config import model_config
 
         # Check if agent uses remote config
         use_remote_config = agent_class.get_use_remote_config()
@@ -329,7 +327,7 @@ class AgentManager:
             else:
                 # Session has stored config but not from ES, merge it
                 logger.debug(
-                    f"AgentManager: Found existing session configuration, merging with dynamic config"
+                    "AgentManager: Found existing session configuration, merging with dynamic config"
                 )
                 effective_config = dynamic_config.copy()
                 effective_config = self._merge_session_configs(effective_config, stored_config)
@@ -454,7 +452,7 @@ class AgentManager:
                     # Fallback: store full config if we can't get version info
                     session_data.session_configuration = effective_config
                     logger.warning(
-                        f"AgentManager: Could not get ES config version, storing full config"
+                        "AgentManager: Could not get ES config version, storing full config"
                     )
             except Exception as e:
                 logger.warning(
@@ -514,8 +512,8 @@ class AgentManager:
         return proxy
 
     def _merge_session_configs(
-        self, base_config: Dict[str, Any], session_config: Dict[str, Any]
-    ) -> Dict[str, Any]:
+        self, base_config: dict[str, Any], session_config: dict[str, Any]
+    ) -> dict[str, Any]:
         """
         Merge session configuration with base configuration.
 
@@ -594,7 +592,7 @@ class AgentManager:
             logger.error(f"AgentManager: Error updating session with agent identity: {e}")
 
     async def _validate_agent_state_compatibility(
-        self, agent_identity: AgentIdentity, agent_state: Dict[str, Any]
+        self, agent_identity: AgentIdentity, agent_state: dict[str, Any]
     ) -> bool:
         """
         Validate that agent state is compatible with current agent identity.
@@ -608,9 +606,9 @@ class AgentManager:
         self,
         agent_identity: AgentIdentity,
         event_type: str,
-        session_id: Optional[str] = None,
-        user_id: Optional[str] = None,
-        metadata: Optional[Dict[str, Any]] = None,
+        session_id: str | None = None,
+        user_id: str | None = None,
+        metadata: dict[str, Any] | None = None,
     ) -> None:
         """Record an agent lifecycle event"""
         try: