computer-agents 2.2.0__tar.gz

computer_agents-2.2.0/.gitignore

@@ -0,0 +1,181 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# 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
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+.cache
+
+# vitepress build output
+**/.vitepress/dist
+
+# vitepress cache directory
+**/.vitepress/cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# 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.*
+
+packages/*/dist
+
+docs/src/content/docs/@openai/*
+docs/src/content/docs/openai/*
+
+# Python reference implementation (never published with the JS repo)
+openai-agents-python
+
+.DS_Store
+
+bundled/
+
+.wrangler/
+.dev.vars
+
+# Test artifacts
+**/tests/tmp/
+*.db
+*.sqlite
+*.sqlite3
+
+# Build artifacts that shouldn't be committed
+FIX_SUMMARY.md
+test-package-exports.mjs
+test-codex-loading.mjs
+
+# Internal documentation (not for public repo)
+API_DOCUMENTATION.md
+API_KEY_SYSTEM_COMPLETE.md
+API_KEY_TESTING_RESULTS.md
+API_KEY_MANAGEMENT.md
+BILLING.md
+*INTERNAL*.md
+AUTHENTICATION-UPDATE.md
+PHASE-2-COMPLETE.md
+PRE_PUBLISH_CHECKLIST.md
+REFACTORING_SUMMARY.md
+RENAME_COMPLETE.md
+REPUBLISH_GUIDE.md
+SESSION-SUMMARY.md
+TESTING-SUMMARY.md
+packages/cloud-infrastructure/API_KEY_MANAGEMENT.md
+packages/cloud-infrastructure/BILLING.md
+packages/cloud-infrastructure/BILLING_SYSTEM_COMPLETE.md

computer_agents-2.2.0/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: computer-agents
+Version: 2.2.0
+Summary: Official Python SDK for the Computer Agents Cloud API. Execute Claude-powered AI agents in isolated cloud containers.
+Project-URL: Homepage, https://computer-agents.com
+Project-URL: Documentation, https://computer-agents.com/documentation
+Project-URL: Repository, https://github.com/computer-agents/computer-agents-python
+Author: Computer Agents
+License-Expression: MIT
+Keywords: agents,ai,anthropic,api,automation,claude,cloud,code-generation,computer-agents,mcp,sdk
+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.9
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.25.0
+Description-Content-Type: text/markdown
+
+# Computer Agents Python SDK
+
+The official Python SDK for the [Computer Agents](https://computer-agents.com) Cloud API. Execute Claude-powered AI agents in isolated cloud containers.
+
+## Installation
+
+```bash
+pip install computer-agents
+```
+
+## Quick Start
+
+```python
+from computer_agents import ComputerAgentsClient
+
+client = ComputerAgentsClient(api_key="ca_your_api_key")
+
+# Execute a task
+result = client.run(
+    "Create a REST API with Flask",
+    environment_id="env_xxx",
+    on_event=lambda e: print(e["type"]),
+)
+
+print(result.content)
+print(f"Thread ID: {result.thread_id}")
+```
+
+## Multi-Turn Conversations
+
+```python
+# Create a thread for persistent conversation
+thread = client.threads.create(environment_id="env_xxx")
+
+# First message
+result = client.threads.send_message(
+    thread["id"],
+    content="Create a Python web server",
+    on_event=lambda e: print(e),
+)
+
+# Follow-up (continues same session)
+result2 = client.threads.send_message(
+    thread["id"],
+    content="Add authentication to the server",
+)
+```
+
+## Environments
+
+```python
+# Create a custom environment
+env = client.environments.create(
+    name="data-science",
+    internet_access=True,
+    runtimes={"python": "3.12"},
+)
+
+# Install packages
+client.environments.install_packages(env["id"], "python", ["pandas", "numpy"])
+
+# Add MCP servers
+client.environments.update(
+    env["id"],
+    mcp_servers=[{
+        "type": "stdio",
+        "name": "filesystem",
+        "command": "npx",
+        "args": ["@modelcontextprotocol/server-filesystem", "/workspace"],
+    }],
+)
+```
+
+## Agents
+
+```python
+# Create a custom agent
+agent = client.agents.create(
+    name="Code Reviewer",
+    model="claude-sonnet-4-5",
+    instructions="You are a thorough code reviewer.",
+    enabled_skills=["web_search"],
+)
+
+# Use the agent
+thread = client.threads.create(
+    environment_id="env_xxx",
+    agent_id=agent["id"],
+)
+```
+
+## Files
+
+```python
+# Upload a file
+client.files.upload_file(
+    "env_xxx",
+    filename="app.py",
+    content='print("hello")',
+    path="src",
+)
+
+# Download a file
+content = client.files.get_file("env_xxx", "src/app.py")
+
+# List files
+files = client.files.list_files("env_xxx")
+```
+
+## Git Operations
+
+```python
+diff = client.git.diff("env_xxx")
+client.git.commit("env_xxx", message="Update feature")
+client.git.push("env_xxx")
+```
+
+## Schedules
+
+```python
+schedule = client.schedules.create(
+    name="Daily Report",
+    agent_id="agent_xxx",
+    agent_name="Reporter",
+    task="Generate daily report",
+    schedule_type="recurring",
+    cron_expression="0 9 * * *",
+)
+```
+
+## Configuration
+
+The API key can be provided via:
+
+1. Constructor argument: `ComputerAgentsClient(api_key="ca_...")`
+2. Environment variable: `COMPUTER_AGENTS_API_KEY`
+
+```python
+# Custom base URL and timeout
+client = ComputerAgentsClient(
+    api_key="ca_...",
+    base_url="https://custom-api.example.com",
+    timeout=120.0,
+    debug=True,
+)
+```
+
+## Context Manager
+
+```python
+with ComputerAgentsClient(api_key="ca_...") as client:
+    result = client.run("Hello world", environment_id="env_xxx")
+    print(result.content)
+# Client is automatically closed
+```
+
+## API Resources
+
+| Resource | Description |
+|----------|-------------|
+| `client.threads` | Conversation management with SSE streaming |
+| `client.environments` | Environment configuration and container lifecycle |
+| `client.agents` | Agent configuration (model, instructions, skills) |
+| `client.files` | File management in environment workspaces |
+| `client.schedules` | Scheduled task management |
+| `client.triggers` | Event-driven triggers |
+| `client.orchestrations` | Agent-to-agent orchestration |
+| `client.budget` | Budget and usage tracking |
+| `client.billing` | Billing records and statistics |
+| `client.git` | Git operations on workspaces |
+
+## Requirements
+
+- Python >= 3.9
+- httpx >= 0.25.0
+
+## License
+
+MIT

computer_agents-2.2.0/README.md

@@ -0,0 +1,179 @@
+# Computer Agents Python SDK
+
+The official Python SDK for the [Computer Agents](https://computer-agents.com) Cloud API. Execute Claude-powered AI agents in isolated cloud containers.
+
+## Installation
+
+```bash
+pip install computer-agents
+```
+
+## Quick Start
+
+```python
+from computer_agents import ComputerAgentsClient
+
+client = ComputerAgentsClient(api_key="ca_your_api_key")
+
+# Execute a task
+result = client.run(
+    "Create a REST API with Flask",
+    environment_id="env_xxx",
+    on_event=lambda e: print(e["type"]),
+)
+
+print(result.content)
+print(f"Thread ID: {result.thread_id}")
+```
+
+## Multi-Turn Conversations
+
+```python
+# Create a thread for persistent conversation
+thread = client.threads.create(environment_id="env_xxx")
+
+# First message
+result = client.threads.send_message(
+    thread["id"],
+    content="Create a Python web server",
+    on_event=lambda e: print(e),
+)
+
+# Follow-up (continues same session)
+result2 = client.threads.send_message(
+    thread["id"],
+    content="Add authentication to the server",
+)
+```
+
+## Environments
+
+```python
+# Create a custom environment
+env = client.environments.create(
+    name="data-science",
+    internet_access=True,
+    runtimes={"python": "3.12"},
+)
+
+# Install packages
+client.environments.install_packages(env["id"], "python", ["pandas", "numpy"])
+
+# Add MCP servers
+client.environments.update(
+    env["id"],
+    mcp_servers=[{
+        "type": "stdio",
+        "name": "filesystem",
+        "command": "npx",
+        "args": ["@modelcontextprotocol/server-filesystem", "/workspace"],
+    }],
+)
+```
+
+## Agents
+
+```python
+# Create a custom agent
+agent = client.agents.create(
+    name="Code Reviewer",
+    model="claude-sonnet-4-5",
+    instructions="You are a thorough code reviewer.",
+    enabled_skills=["web_search"],
+)
+
+# Use the agent
+thread = client.threads.create(
+    environment_id="env_xxx",
+    agent_id=agent["id"],
+)
+```
+
+## Files
+
+```python
+# Upload a file
+client.files.upload_file(
+    "env_xxx",
+    filename="app.py",
+    content='print("hello")',
+    path="src",
+)
+
+# Download a file
+content = client.files.get_file("env_xxx", "src/app.py")
+
+# List files
+files = client.files.list_files("env_xxx")
+```
+
+## Git Operations
+
+```python
+diff = client.git.diff("env_xxx")
+client.git.commit("env_xxx", message="Update feature")
+client.git.push("env_xxx")
+```
+
+## Schedules
+
+```python
+schedule = client.schedules.create(
+    name="Daily Report",
+    agent_id="agent_xxx",
+    agent_name="Reporter",
+    task="Generate daily report",
+    schedule_type="recurring",
+    cron_expression="0 9 * * *",
+)
+```
+
+## Configuration
+
+The API key can be provided via:
+
+1. Constructor argument: `ComputerAgentsClient(api_key="ca_...")`
+2. Environment variable: `COMPUTER_AGENTS_API_KEY`
+
+```python
+# Custom base URL and timeout
+client = ComputerAgentsClient(
+    api_key="ca_...",
+    base_url="https://custom-api.example.com",
+    timeout=120.0,
+    debug=True,
+)
+```
+
+## Context Manager
+
+```python
+with ComputerAgentsClient(api_key="ca_...") as client:
+    result = client.run("Hello world", environment_id="env_xxx")
+    print(result.content)
+# Client is automatically closed
+```
+
+## API Resources
+
+| Resource | Description |
+|----------|-------------|
+| `client.threads` | Conversation management with SSE streaming |
+| `client.environments` | Environment configuration and container lifecycle |
+| `client.agents` | Agent configuration (model, instructions, skills) |
+| `client.files` | File management in environment workspaces |
+| `client.schedules` | Scheduled task management |
+| `client.triggers` | Event-driven triggers |
+| `client.orchestrations` | Agent-to-agent orchestration |
+| `client.budget` | Budget and usage tracking |
+| `client.billing` | Billing records and statistics |
+| `client.git` | Git operations on workspaces |
+
+## Requirements
+
+- Python >= 3.9
+- httpx >= 0.25.0
+
+## License
+
+MIT