cloudbase-agent-core 0.1.4__tar.gz

cloudbase_agent_core-0.1.4/.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_core-0.1.4/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: cloudbase-agent-core
+Version: 0.1.4
+Summary: Cloudbase Agent Python SDK - Core functionality
+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: ag-ui-protocol>=0.1.9
+Requires-Dist: lazy-loader>=0.4
+Requires-Dist: pydantic>=2.0.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 Python SDK - Core
+
+Core functionality for Cloudbase Agent Python SDK, including base agent classes and protocols.

cloudbase_agent_core-0.1.4/README.md

@@ -0,0 +1,3 @@
+# Cloudbase Agent Python SDK - Core
+
+Core functionality for Cloudbase Agent Python SDK, including base agent classes and protocols.

cloudbase_agent_core-0.1.4/pyproject.toml

@@ -0,0 +1,41 @@
+[project]
+name = "cloudbase-agent-core"
+version = "0.1.4"
+description = "Cloudbase Agent Python SDK - Core functionality"
+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 = [
+    "pydantic>=2.0.0",
+    "lazy_loader>=0.4",
+    "ag-ui-protocol>=0.1.9",
+]
+
+[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"]

cloudbase_agent_core-0.1.4/src/cloudbase_agent/__init__.py

@@ -0,0 +1,69 @@
+"""Agents Package.
+
+This package provides agent creation utilities for the Cloudbase Agent Python SDK.
+It includes base agent classes and framework-specific implementations with
+lazy loading support for optional dependencies.
+
+Framework Support:
+    - LangGraph: Install with `pip install cloudbase_agent_py[langgraph]`
+    - CrewAI: Install with `pip install cloudbase_agent_py[crewai]`
+    - All frameworks: Install with `pip install cloudbase_agent_py[all]`
+
+Available Classes:
+    - BaseAgent: Abstract base class for all Cloudbase Agent agents
+    - AgentCallback: Protocol for event callbacks
+    - ToolProxy: Protocol for tool call interception
+    - ToolCallResult: Result of tool proxy interception
+    - LangGraphAgent: LangGraph-based agent implementation (lazy-loaded)
+    - CrewAIAgent: CrewAI-based agent implementation (lazy-loaded)
+
+Example:
+    Using LangGraph::
+
+        # Install: pip install cloudbase_agent_py[langgraph]
+        from cloudbase_agent.agents import LangGraphAgent
+        from langgraph.graph import StateGraph
+
+        workflow = StateGraph(State)
+        compiled_graph = workflow.compile()
+        agent = LangGraphAgent("MyAgent", "Description", compiled_graph)
+
+    Using CrewAI::
+
+        # Install: pip install cloudbase_agent_py[crewai]
+        from cloudbase_agent.agents import CrewAIAgent
+        from crewai.flow.flow import Flow
+
+        class MyFlow(Flow):
+            pass
+
+        flow = MyFlow()
+        agent = CrewAIAgent("MyAgent", "Description", flow)
+
+Note:
+    Framework-specific agents are lazy-loaded. If you try to import an agent
+    without installing its dependencies, you'll get a helpful error message
+    indicating which package to install.
+"""
+
+import lazy_loader as lazy
+
+# Eager imports (always available, no optional dependencies)
+from .base_agent import AgentCallback, BaseAgent, ToolCallResult, ToolProxy
+
+# Lazy imports setup (framework-specific agents loaded on demand)
+__getattr__, __dir__, __all__ = lazy.attach_stub(__name__, __file__)
+
+# Ensure base classes and lazy-loaded agents are in __all__
+__all__ = [
+    "BaseAgent",
+    "AgentCallback",
+    "ToolProxy",
+    "ToolCallResult",
+    "LangGraphAgent",  # Lazy-loaded when accessed
+    "CrewAIAgent",     # Lazy-loaded when accessed
+]
+
+# Enable namespace package support to allow other cloudbase_agent subpackages
+# (like cloudbase_agent.server, cloudbase_agent.storage) to be imported
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)

cloudbase_agent_core-0.1.4/src/cloudbase_agent/__init__.pyi

@@ -0,0 +1,12 @@
+"""Type stubs for cloudbase_agent core package.
+
+This stub file provides type hints for IDE and static analysis tools.
+"""
+
+# Eager imports (always available)
+from .base_agent import AgentCallback as AgentCallback
+from .base_agent import BaseAgent as BaseAgent
+from .base_agent import ToolCallResult as ToolCallResult
+from .base_agent import ToolProxy as ToolProxy
+
+__all__: list[str]