continuum-agent-sdk 1.0.0__tar.gz

continuum_agent_sdk-1.0.0/.gitignore

@@ -0,0 +1,55 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Rust build artifacts
+target/
+*.pdb
+
+# Project specific
+.egg/
+*.log
+.env
+.env.local
+.env.test
+test,env
+*.bak
+
+# Secrets - never commit
+*_key*
+*_secret*
+*_token*

continuum_agent_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: continuum-agent-sdk
+Version: 1.0.0
+Summary: Production-Grade Agent Framework with Crash Safety Guarantees
+Project-URL: Homepage, https://github.com/continuum-ai/continuum
+Project-URL: Documentation, https://continuum-agent-sdk.readthedocs.io
+Project-URL: Repository, https://github.com/continuum-ai/continuum
+Project-URL: Issues, https://github.com/continuum-ai/continuum/issues
+Author: Continuum Team
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: toml>=0.10.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Continuum Python SDK
+
+A production-grade agent framework with crash safety guarantees.
+
+## Quick Start (3 steps)
+
+```python
+from continuum import Agent
+
+agent = Agent()  # Auto-loads config from environment
+result = agent.run("your task")
+```
+
+## Installation
+
+```bash
+pip install continuum
+```
+
+## Configuration
+
+### Environment Variables
+
+Priority: `CONTINUUM_*` > `CONTINUUM_*` > `ANTHROPIC_*`
+
+```bash
+export CONTINUUM_API_KEY=your_api_key
+export CONTINUUM_PROVIDER=anthropic  # or openai, google
+export CONTINUUM_MODEL=claude-sonnet-4-6
+```
+
+### Config File
+
+Create `~/.continuum/config.toml`:
+
+```toml
+[providers.anthropic]
+api_key = "${ANTHROPIC_API_KEY}"
+base_url = "https://api.anthropic.com/v1"
+model = "claude-sonnet-4-6"
+
+[providers.openai]
+api_key = "${OPENAI_API_KEY}"
+base_url = "https://api.openai.com/v1"
+model = "gpt-4"
+
+[settings]
+session_auto_save = true
+checkpoint_enabled = true
+audit_enabled = true
+```
+
+## Features
+
+- **Agent**: One-line agent creation with automatic configuration
+- **Session**: Conversation history management with checkpoint support
+- **Tools**: Built-in and custom tool registration
+- **Memory**: Multi-layer memory system (episodic, semantic, procedural)
+- **Config**: Multi-provider configuration with environment variable support
+
+## API Reference
+
+```python
+from continuum import Agent, Session, Config
+
+# Agent
+agent = Agent(name="my-agent", model="claude-sonnet-4-6")
+agent.run("task description")  # One-shot task execution
+agent.chat("message")  # Interactive chat
+agent.start()  # Start agent runtime
+
+# Session
+session = agent.create_session()
+session.add_message("user", "Hello")
+session.save()  # Persist to storage
+session.load(session_id)  # Resume session
+
+# Config
+config = Config.from_env()  # Load from environment
+config = Config.from_file("~/.continuum/config.toml")  # Load from file
+config.use("openai")  # Switch provider
+```
+
+## License
+
+MIT License

continuum_agent_sdk-1.0.0/README.md

@@ -0,0 +1,86 @@
+# Continuum Python SDK
+
+A production-grade agent framework with crash safety guarantees.
+
+## Quick Start (3 steps)
+
+```python
+from continuum import Agent
+
+agent = Agent()  # Auto-loads config from environment
+result = agent.run("your task")
+```
+
+## Installation
+
+```bash
+pip install continuum
+```
+
+## Configuration
+
+### Environment Variables
+
+Priority: `CONTINUUM_*` > `CONTINUUM_*` > `ANTHROPIC_*`
+
+```bash
+export CONTINUUM_API_KEY=your_api_key
+export CONTINUUM_PROVIDER=anthropic  # or openai, google
+export CONTINUUM_MODEL=claude-sonnet-4-6
+```
+
+### Config File
+
+Create `~/.continuum/config.toml`:
+
+```toml
+[providers.anthropic]
+api_key = "${ANTHROPIC_API_KEY}"
+base_url = "https://api.anthropic.com/v1"
+model = "claude-sonnet-4-6"
+
+[providers.openai]
+api_key = "${OPENAI_API_KEY}"
+base_url = "https://api.openai.com/v1"
+model = "gpt-4"
+
+[settings]
+session_auto_save = true
+checkpoint_enabled = true
+audit_enabled = true
+```
+
+## Features
+
+- **Agent**: One-line agent creation with automatic configuration
+- **Session**: Conversation history management with checkpoint support
+- **Tools**: Built-in and custom tool registration
+- **Memory**: Multi-layer memory system (episodic, semantic, procedural)
+- **Config**: Multi-provider configuration with environment variable support
+
+## API Reference
+
+```python
+from continuum import Agent, Session, Config
+
+# Agent
+agent = Agent(name="my-agent", model="claude-sonnet-4-6")
+agent.run("task description")  # One-shot task execution
+agent.chat("message")  # Interactive chat
+agent.start()  # Start agent runtime
+
+# Session
+session = agent.create_session()
+session.add_message("user", "Hello")
+session.save()  # Persist to storage
+session.load(session_id)  # Resume session
+
+# Config
+config = Config.from_env()  # Load from environment
+config = Config.from_file("~/.continuum/config.toml")  # Load from file
+config.use("openai")  # Switch provider
+```
+
+## License
+
+MIT License

continuum_agent_sdk-1.0.0/benchmarks/bench_agent.py

@@ -0,0 +1,157 @@
+"""Agent 性能基准测试"""
+
+import sys
+import os
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+import time
+import statistics
+from typing import List, Callable
+
+# 简单基准测试框架（避免pytest-benchmark依赖）
+class BenchResult:
+    def __init__(self, name: str):
+        self.name = name
+        self.times: List[float] = []
+        self.result = None
+    
+    def add(self, elapsed: float):
+        self.times.append(elapsed)
+    
+    @property
+    def mean(self) -> float:
+        return statistics.mean(self.times) if self.times else 0
+    
+    @property
+    def median(self) -> float:
+        return statistics.median(self.times) if self.times else 0
+    
+    @property
+    def stdev(self) -> float:
+        return statistics.stdev(self.times) if len(self.times) > 1 else 0
+    
+    @property
+    def min(self) -> float:
+        return min(self.times) if self.times else 0
+    
+    @property
+    def max(self) -> float:
+        return max(self.times) if self.times else 0
+
+
+def bench(func: Callable, iterations: int = 100) -> BenchResult:
+    """运行基准测试"""
+    result = BenchResult(func.__name__)
+    
+    # 预热
+    func()
+    
+    # 正式测试
+    for _ in range(iterations):
+        start = time.perf_counter()
+        func()
+        elapsed = time.perf_counter() - start
+        result.add(elapsed)
+    
+    return result
+
+
+def format_result(result: BenchResult) -> str:
+    """格式化结果"""
+    return f"""
+{result.name}:
+  Iterations: {len(result.times)}
+  Mean:   {result.mean*1000:.4f} ms
+  Median: {result.median*1000:.4f} ms
+  StdDev: {result.stdev*1000:.4f} ms
+  Min:    {result.min*1000:.4f} ms
+  Max:    {result.max*1000:.4f} ms
+"""
+
+
+# ========================================
+# Agent 基准测试
+# ========================================
+
+def bench_agent_creation():
+    """测试 Agent 创建时间"""
+    from continuum_sdk import Agent
+    return Agent()
+
+
+def bench_agent_start():
+    """测试 Agent 启动时间"""
+    from continuum_sdk import Agent
+    agent = Agent()
+    agent.start()
+    return agent
+
+
+def bench_agent_run():
+    """测试 Agent run 方法时间"""
+    from continuum_sdk import Agent
+    agent = Agent()
+    agent.start()
+    return agent.run("test task", auto_start=False)
+
+
+def bench_agent_chat():
+    """测试 Agent chat 方法时间"""
+    from continuum_sdk import Agent
+    agent = Agent()
+    agent.start()
+    return agent.chat("hello")
+
+
+def bench_agent_with_config():
+    """测试带配置的 Agent 创建时间"""
+    from continuum_sdk import Agent, Config
+    config = Config(provider="anthropic", model="claude-sonnet-4-6")
+    return Agent(config=config)
+
+
+def bench_agent_create_session():
+    """测试会话创建时间"""
+    from continuum_sdk import Agent
+    agent = Agent()
+    return agent.create_session()
+
+
+def bench_agent_register_tool():
+    """测试工具注册时间"""
+    from continuum_sdk import Agent
+    agent = Agent()
+    for i in range(10):
+        agent.register_tool(f"tool_{i}", lambda x: x)
+    return agent
+
+
+def run_agent_benchmarks():
+    """运行所有 Agent 基准测试"""
+    print("=" * 50)
+    print("Agent Performance Benchmarks")
+    print("=" * 50)
+    
+    tests = [
+        ("Agent Creation", bench_agent_creation, 1000),
+        ("Agent with Config", bench_agent_with_config, 1000),
+        ("Agent Start", bench_agent_start, 100),
+        ("Agent Run", bench_agent_run, 100),
+        ("Agent Chat", bench_agent_chat, 100),
+        ("Create Session", bench_agent_create_session, 1000),
+        ("Register 10 Tools", bench_agent_register_tool, 100),
+    ]
+    
+    results = []
+    for name, func, iterations in tests:
+        print(f"\nRunning: {name}...")
+        func.__name__ = name
+        result = bench(func, iterations)
+        results.append(result)
+        print(format_result(result))
+    
+    return results
+
+
+if __name__ == "__main__":
+    run_agent_benchmarks()

continuum_agent_sdk-1.0.0/benchmarks/bench_config.py

@@ -0,0 +1,181 @@
+"""Config 性能基准测试"""
+
+import sys
+import os
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+import time
+import statistics
+
+
+class BenchResult:
+    def __init__(self, name: str):
+        self.name = name
+        self.times = []
+    
+    def add(self, elapsed: float):
+        self.times.append(elapsed)
+    
+    @property
+    def mean(self) -> float:
+        return statistics.mean(self.times) if self.times else 0
+    
+    @property
+    def median(self) -> float:
+        return statistics.median(self.times) if self.times else 0
+    
+    @property
+    def stdev(self) -> float:
+        return statistics.stdev(self.times) if len(self.times) > 1 else 0
+    
+    @property
+    def min(self) -> float:
+        return min(self.times) if self.times else 0
+    
+    @property
+    def max(self) -> float:
+        return max(self.times) if self.times else 0
+
+
+def bench(func, iterations=100):
+    """运行基准测试"""
+    result = BenchResult(func.__name__)
+    
+    # 预热
+    func()
+    
+    # 正式测试
+    for _ in range(iterations):
+        start = time.perf_counter()
+        func()
+        elapsed = time.perf_counter() - start
+        result.add(elapsed)
+    
+    return result
+
+
+def format_result(result):
+    return f"""
+{result.name}:
+  Iterations: {len(result.times)}
+  Mean:   {result.mean*1000:.4f} ms
+  Median: {result.median*1000:.4f} ms
+  StdDev: {result.stdev*1000:.4f} ms
+  Min:    {result.min*1000:.4f} ms
+  Max:    {result.max*1000:.4f} ms
+"""
+
+
+# ========================================
+# Config 基准测试
+# ========================================
+
+def bench_config_creation():
+    """测试 Config 创建时间"""
+    from continuum_sdk import Config
+    return Config()
+
+
+def bench_config_from_env():
+    """测试从环境变量加载"""
+    from continuum_sdk import Config
+    return Config.from_env()
+
+
+def bench_config_from_default():
+    """测试默认加载"""
+    from continuum_sdk import Config
+    return Config.from_default()
+
+
+def bench_config_with_params():
+    """测试带参数创建"""
+    from continuum_sdk import Config
+    return Config(
+        provider="anthropic",
+        api_key="test-key",
+        model="claude-sonnet-4-6",
+        max_tokens=8192,
+        temperature=0.7
+    )
+
+
+def bench_config_use_provider():
+    """测试提供商切换"""
+    from continuum_sdk import Config
+    config = Config()
+    config.add_provider("test", api_key="test-key")
+    config.use("test")
+    return config
+
+
+def bench_config_to_dict():
+    """测试序列化"""
+    from continuum_sdk import Config
+    config = Config(provider="anthropic", model="claude-sonnet-4-6")
+    return config.to_dict()
+
+
+def bench_config_from_dict():
+    """测试反序列化"""
+    from continuum_sdk import Config
+    data = {"provider": "anthropic", "model": "claude-sonnet-4-6"}
+    return Config.from_dict(data)
+
+
+def bench_config_load_toml():
+    """测试TOML文件加载"""
+    from continuum_sdk import Config
+    from pathlib import Path
+    template_path = Path(__file__).parent.parent.parent / "templates" / "config.toml"
+    if template_path.exists():
+        return Config.from_file(str(template_path))
+    return Config()
+
+
+def bench_config_add_provider():
+    """测试添加提供商"""
+    from continuum_sdk import Config
+    config = Config()
+    config.add_provider("custom", api_key="key", model="model")
+    return config
+
+
+def bench_config_list_providers():
+    """测试列出提供商"""
+    from continuum_sdk.config import list_providers
+    return list_providers()
+
+
+def run_config_benchmarks():
+    """运行所有 Config 基准测试"""
+    print("=" * 50)
+    print("Config Performance Benchmarks")
+    print("=" * 50)
+    
+    tests = [
+        ("Config Creation", bench_config_creation, 1000),
+        ("Config from env", bench_config_from_env, 500),
+        ("Config from default", bench_config_from_default, 500),
+        ("Config with params", bench_config_with_params, 1000),
+        ("Config use provider", bench_config_use_provider, 1000),
+        ("Config to_dict", bench_config_to_dict, 5000),
+        ("Config from_dict", bench_config_from_dict, 5000),
+        ("Config load TOML", bench_config_load_toml, 100),
+        ("Config add provider", bench_config_add_provider, 1000),
+        ("List providers", bench_config_list_providers, 1000),
+    ]
+    
+    results = []
+    for name, func, iterations in tests:
+        print(f"\nRunning: {name}...")
+        func.__name__ = name
+        result = bench(func, iterations)
+        results.append(result)
+        print(format_result(result))
+    
+    return results
+
+
+if __name__ == "__main__":
+    run_config_benchmarks()