cloudbase-agent-server 0.1.9__py3-none-any.whl

cloudbase_agent/server/utils/sse.py

@@ -0,0 +1,32 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Server-Sent Events (SSE) Utilities.
+
+This module provides utility functions for working with Server-Sent Events
+in streaming HTTP responses.
+"""
+
+from typing import AsyncGenerator
+
+
+async def async_generator_from_string(content: str) -> AsyncGenerator[str, None]:
+    r"""Create an async generator from a string.
+
+    This utility function converts a string into an async generator,
+    which is useful for creating error responses in streaming format
+    that are compatible with StreamingResponse.
+
+    :param content: The string content to yield
+    :type content: str
+
+    :yields: The input content as a single item
+    :ytype: str
+
+    Example:
+        Creating an error stream::
+
+            error_content = "data: {'error': 'Something went wrong'}\\n\\n"
+            error_stream = async_generator_from_string(error_content)
+            return StreamingResponse(error_stream, media_type="text/event-stream")
+    """
+    yield content

cloudbase_agent/server/utils/types.py

@@ -0,0 +1,73 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Type Definitions for Cloudbase Agent Server.
+
+This module defines common types used throughout the Cloudbase Agent server,
+including agent creator function signatures and result types.
+"""
+
+from typing import Any, Awaitable, Callable, Optional, TypedDict, Union
+
+
+class AgentCreatorResult(TypedDict, total=False):
+    """Result type for agent creator functions.
+
+    This type defines the structure returned by agent creator functions,
+    which includes the agent instance and an optional cleanup callback.
+
+    :param agent: The agent instance to handle requests
+    :type agent: Any
+    :param cleanup: Optional cleanup function called after stream completes.
+                   Can be sync or async function.
+    :type cleanup: Optional[Callable[[], Union[None, Awaitable[None]]]]
+
+    Example:
+        Synchronous cleanup::
+
+            def create_agent() -> AgentCreatorResult:
+                db = connect_database()
+                agent = MyAgent(db)
+
+                def cleanup():
+                    db.close()
+                    print("Database closed")
+
+                return {"agent": agent, "cleanup": cleanup}
+
+        Asynchronous cleanup::
+
+            async def create_agent() -> AgentCreatorResult:
+                db = await async_connect_database()
+                agent = MyAgent(db)
+
+                async def cleanup():
+                    await db.close()
+                    print("Database closed")
+
+                return {"agent": agent, "cleanup": cleanup}
+    """
+
+    agent: Any
+    cleanup: Optional[Callable[[], Union[None, Awaitable[None]]]]
+
+
+# Type alias for agent creator functions
+AgentCreator = Callable[[], Union[AgentCreatorResult, Awaitable[AgentCreatorResult]]]
+"""Type alias for agent creator functions.
+
+Agent creator functions are responsible for creating agent instances
+and optionally providing cleanup callbacks. They can be either
+synchronous or asynchronous.
+
+Example:
+    Synchronous creator::
+    
+        def create_agent() -> AgentCreatorResult:
+            return {"agent": MyAgent()}
+    
+    Asynchronous creator::
+    
+        async def create_agent() -> AgentCreatorResult:
+            agent = await initialize_agent()
+            return {"agent": agent}
+"""

cloudbase_agent_server-0.1.9.dist-info/METADATA

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: cloudbase-agent-server
+Version: 0.1.9
+Summary: Cloudbase Agent Python SDK - FastAPI server implementation
+Author-email: Cloudbase Agent Team <ag-kit@example.com>
+License: Apache-2.0
+Keywords: Cloudbase Agent,agent,ai,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: cloudbase-agent-core
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: sse-starlette>=1.6.0
+Requires-Dist: uvicorn>=0.20.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.12.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# cloudbase-agent-server
+
+Cloudbase Agent Python SDK - FastAPI server implementation
+
+## Installation
+
+```bash
+pip install cloudbase-agent-server
+```
+
+## Usage
+
+```python
+from cloudbase_agent import ...
+```
+
+## License
+
+Apache-2.0

cloudbase_agent_server-0.1.9.dist-info/RECORD

@@ -0,0 +1,21 @@
+cloudbase_agent/__init__.py,sha256=Y6_UXMNNLTKwMpyPOXccmFjNhoBJgbN6F6ftmWVuPJo,182
+cloudbase_agent/server/__init__.py,sha256=fRvNDgpb3Yp8yZAFKh8d1d963QvnIfkSevmchS-waLQ,3069
+cloudbase_agent/server/app.py,sha256=s5UYJRX9IRsVA8pRtlqtOaRsVSLAWnuj3VBKxasTphE,13808
+cloudbase_agent/server/healthz/__init__.py,sha256=oSFAw2bZt3HD8n8OTSqTtNJVgGLivFxiepzmtayCm-8,338
+cloudbase_agent/server/healthz/handler.py,sha256=ZWDdU3AOvs217PhS-CjISPwRZGoat2Pgvyh-Hu6GSTY,6599
+cloudbase_agent/server/healthz/models.py,sha256=XHf4GiVG4L7kDbjstbxMdadecy96klQIZpo1hIx4xHQ,4425
+cloudbase_agent/server/openai/__init__.py,sha256=QSZOmo7M0qAhk11BIkyxwuwlzhEJDLAf2MAkUljje6E,376
+cloudbase_agent/server/openai/converter.py,sha256=kcSWmMv8fDruHSHimQqcWAjk8nysnpEV4LOHZXL7uB0,2153
+cloudbase_agent/server/openai/models.py,sha256=Q5VHZiBADc7VzAIC1lS1JR-rqXWvDoXuWwljMkXaiTs,1750
+cloudbase_agent/server/openai/server.py,sha256=BZA-r0RoejUa4eDh-SFt6FkGShBBmomPMQjeX6dp4sI,1833
+cloudbase_agent/server/send_message/__init__.py,sha256=ScHAG5JcE1gXLKTONSd8AkqZ5gnZU42NuKCFx92K_Z4,551
+cloudbase_agent/server/send_message/handler.py,sha256=JtW-QsiVPblIKaqY-37Lgq50LlwtxyyRij0D6rJOQsg,5606
+cloudbase_agent/server/send_message/models.py,sha256=WoKgrffIZ3hTzvI1_zoH3STKHiRuQJsLCA0y3n25vaE,1330
+cloudbase_agent/server/send_message/server.py,sha256=nucOzHkCbhPSIJquyOjEyH3ZQK6oikSg4ZAwIT0nu6A,3288
+cloudbase_agent/server/utils/__init__.py,sha256=B8svvS8Dz0ajhMyyqB_ZP3OHBHAXZ1L_uuuKLjF6nyk,577
+cloudbase_agent/server/utils/converters.py,sha256=7G-njOCWZHKHlETlL61whrCPtQZTQlzKdJ7LNYCL2TI,575
+cloudbase_agent/server/utils/sse.py,sha256=-H0SLEDb8q-mnNNKSK6aGqvbDS2oZxGGQfxwdX_OAu8,992
+cloudbase_agent/server/utils/types.py,sha256=3ceCpEUkW2W-CNjP4wFwC0tB7CsAJUaQCW_8AiaaFlg,2274
+cloudbase_agent_server-0.1.9.dist-info/METADATA,sha256=YcD33l-pG6RalNjMeW9p-jGFY0ytau7CEVT-dN5Mc2M,1238
+cloudbase_agent_server-0.1.9.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+cloudbase_agent_server-0.1.9.dist-info/RECORD,,

cloudbase_agent_server-0.1.9.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any