cloudbase-agent-server 0.1.1__tar.gz

cloudbase_agent_server-0.1.1/.gitignore

@@ -0,0 +1,194 @@
+
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Production builds
+dist/
+build/
+out/
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# TypeScript
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+
+# Nuxt.js build / generate output
+.nuxt
+
+# Gatsby files
+.cache/
+
+# vuepress build output
+.vuepress/dist
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Temporary files
+*.tmp
+*.temp
+
+# WeChat Mini Program
+miniprogram_npm/
+project.config.json
+project.private.config.json
+
+# Testing
+coverage/
+.nyc_output/
+
+# Storybook build outputs
+storybook-static/
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.so
+*.egg
+*.egg-info
+dist/
+build/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Python virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# Python testing and coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+
+# Python type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+
+# Python linting
+.flake8_cache/
+
+# Python profiling
+.prof
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Python package manager
+pip-log.txt
+pip-delete-this-directory.txt
+
+# UV lock files (if not tracking)
+# uv.lock
+/docs/dist/

cloudbase_agent_server-0.1.1/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: cloudbase-agent-server
+Version: 0.1.1
+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.1/README.md

@@ -0,0 +1,19 @@
+# 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.1/pyproject.toml

@@ -0,0 +1,45 @@
+[project]
+name = "cloudbase-agent-server"
+version = "0.1.1"
+description = "Cloudbase Agent Python SDK - FastAPI server implementation"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "Apache-2.0" }
+authors = [
+    { name = "Cloudbase Agent Team", email = "ag-kit@example.com" }
+]
+keywords = ["ai", "agent", "llm", "Cloudbase Agent"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+dependencies = [
+    "cloudbase-agent-core",
+    "fastapi>=0.100.0",
+    "uvicorn>=0.20.0",
+    "sse-starlette>=1.6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "ruff>=0.12.0",
+    "mypy>=1.0.0",
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/cloudbase_agent"]
+
+[tool.uv.sources]
+cloudbase-agent-core = { workspace = true }

cloudbase_agent_server-0.1.1/src/cloudbase_agent/__init__.py

@@ -0,0 +1,5 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Cloudbase Agent package."""
+
+__all__ = []

cloudbase_agent_server-0.1.1/src/cloudbase_agent/server/__init__.py

@@ -0,0 +1,91 @@
+"""Cloudbase Agent Server Package.
+
+This package provides server components for the Cloudbase Agent Python SDK,
+including FastAPI integration, request handling, streaming responses,
+and resource cleanup support.
+
+Core Capabilities (Primary Exports):
+    - create_send_message_adapter: Create adapter for Cloudbase Agent native send_message endpoint
+    - create_openai_adapter: Create adapter for OpenAI-compatible chat/completions endpoint
+
+Convenience Tools (Secondary Exports):
+    - AGKitAPIApp: FastAPI application wrapper for quick server setup
+
+Data Models:
+    - SendMessageInput: Request model for send_message endpoint
+    - OpenAIChatCompletionRequest: Request model for OpenAI-compatible endpoint
+    - AgentCreatorResult: TypedDict for agent creator return type
+    - AgentCreator: Type alias for agent creator functions
+
+Example:
+    Using core capabilities (advanced users)::
+
+        from fastapi import FastAPI
+        from cloudbase_agent.server import create_send_message_adapter, create_openai_adapter
+        from cloudbase_agent.server import SendMessageInput, OpenAIChatCompletionRequest
+
+        def create_agent():
+            return {"agent": MyAgent()}
+
+        app = FastAPI()
+
+        @app.post("/custom/send-message")
+        async def send_message(request: SendMessageInput):
+            return await create_send_message_adapter(create_agent, request)
+
+        @app.post("/custom/chat/completions")
+        async def chat_completions(request: OpenAIChatCompletionRequest):
+            return await create_openai_adapter(create_agent, request)
+
+    Using convenience tool (quick start)::
+
+        from cloudbase_agent.server import AGKitAPIApp
+
+        def create_agent():
+            return {"agent": MyAgent()}
+
+        AGKitAPIApp().run(create_agent, port=8000)
+
+    With resource cleanup::
+
+        from cloudbase_agent.server import AGKitAPIApp, AgentCreatorResult
+
+        def create_agent() -> AgentCreatorResult:
+            db = connect_database()
+            agent = MyAgent(db)
+
+            def cleanup():
+                db.close()
+                print("Resources cleaned up")
+
+            return {"agent": agent, "cleanup": cleanup}
+
+        AGKitAPIApp().run(create_agent, port=8000)
+"""
+
+# Core capabilities (primary exports)
+# Convenience tool (secondary export)
+from .app import AGKitAPIApp
+from .healthz.models import HealthzConfig, HealthzResponse
+from .openai.models import OpenAIChatCompletionRequest
+from .openai.server import create_adapter as create_openai_adapter
+
+# Data models
+from .send_message.models import SendMessageInput
+from .send_message.server import create_adapter as create_send_message_adapter
+from .utils.types import AgentCreator, AgentCreatorResult
+
+__all__ = [
+    # Core capabilities (primary)
+    "create_send_message_adapter",
+    "create_openai_adapter",
+    # Convenience tool (secondary)
+    "AGKitAPIApp",
+    # Data models
+    "SendMessageInput",
+    "OpenAIChatCompletionRequest",
+    "HealthzConfig",
+    "HealthzResponse",
+    "AgentCreatorResult",
+    "AgentCreator",
+]