computer-agents 0.6.4 → 0.6.5

package/README.md

@@ -3,7 +3,31 @@
 [![npm version](https://img.shields.io/npm/v/computer-agents.svg)](https://www.npmjs.com/package/computer-agents)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Build agents that write code, run tests, and modify files. Supports both local and cloud execution with automatic session management.
+Build agents that write code, run tests, and modify files. Orchestrate unlimited agents in parallel with seamless local and cloud execution.
+
+## Why Computer Agents?
+
+Traditional agent frameworks limit you to single-agent workflows or rigid orchestration patterns. Computer Agents is designed for programmatic multi-agent orchestration at scale.
+
+**Unlimited Parallel Orchestration**
+Compose and run unlimited agents concurrently. Build custom multi-agent workflows programmatically—you control execution flow and agent communication. No framework constraints, just code.
+
+**Seamless Local ↔ Cloud Execution**
+Develop locally, scale to cloud by changing workspace configuration. Runtime abstraction handles the complexity while your code remains identical. Switch execution environments without rewriting workflows.
+
+**Two Powerful Agent Types**
+- **LLM agents** (OpenAI API) for planning, reasoning, and code review
+- **Computer agents** (Codex SDK) for code generation and file operations
+
+Mix agent types to build sophisticated workflows. Computer agents bypass LLM for tool selection, providing faster execution and lower costs.
+
+**Production-Ready Infrastructure**
+- Automatic session continuity across runs
+- Efficient workspace synchronization
+- Built on OpenAI Codex SDK
+- Type-safe TypeScript with comprehensive documentation
+
+**Use cases:** Parallel test generation, distributed code review, large-scale refactoring, automated debugging workflows, multi-repository updates.
 
 ## Installation
 
@@ -80,62 +104,41 @@ const agent = new Agent({
 await run(agent, "Review the authentication implementation");
 ```
 
-## Cloud Execution
-
-### Cloud Agents
+## Multi-Agent Workflows
 
-Execute agents in cloud environments using the CloudClient:
+Compose multiple agents for complex tasks:
 
 ```typescript
-import { Agent, run, CloudClient } from 'computer-agents';
+import { Agent, run } from 'computer-agents';
 
-const client = new CloudClient({
-  apiKey: process.env.TESTBASE_API_KEY
+// LLM creates plan
+const planner = new Agent({
+  agentType: 'llm',
+  model: 'gpt-4o',
+  instructions: 'Create implementation plans.'
 });
 
-// Create a cloud project
-const project = await client.createProject({ name: 'my-app' });
-
-// Cloud agent
-const agent = new Agent({
-  agentType: "computer",
-  workspace: project,
-  instructions: "You are an expert developer."
+// Computer agent executes
+const executor = new Agent({
+  agentType: 'computer',
+  workspace: './my-project',
+  instructions: 'Execute implementation plans.'
 });
 
-const result = await run(agent, "Add error handling to the API");
-console.log(result.finalOutput);
-```
-
-### Project Management
-
-Manage cloud workspaces with the Project API:
-
-```typescript
-import { CloudClient } from 'computer-agents';
-
-const client = new CloudClient({ apiKey: process.env.TESTBASE_API_KEY });
-
-// Create project with local sync
-const project = await client.createProject({
-  name: 'my-app',
-  localPath: './src'  // Enables bidirectional sync
+// LLM reviews result
+const reviewer = new Agent({
+  agentType: 'llm',
+  model: 'gpt-4o',
+  instructions: 'Review code quality.'
 });
 
-// Sync files
-await project.sync({ direction: 'both' });
-
-// File operations
-const files = await project.listFiles();
-const content = await project.readFile('config.json');
-await project.writeFile('settings.json', '{"debug": true}');
-
-// Sync statistics
-const stats = await project.getSyncStats();
-console.log(stats);  // { lastSyncAt, fileCount, version }
+const task = "Add user authentication";
+const plan = await run(planner, `Plan: ${task}`);
+const code = await run(executor, plan.finalOutput);
+const review = await run(reviewer, `Review: ${code.finalOutput}`);
 ```
 
-### Streaming Events
+## Streaming Events
 
 Monitor agent execution in real-time:
 
@@ -165,40 +168,6 @@ for await (const event of runStreamed(agent, 'Create a web scraper')) {
 }
 ```
 
-## Multi-Agent Workflows
-
-Compose multiple agents for complex tasks:
-
-```typescript
-import { Agent, run } from 'computer-agents';
-
-// LLM creates plan
-const planner = new Agent({
-  agentType: 'llm',
-  model: 'gpt-4o',
-  instructions: 'Create implementation plans.'
-});
-
-// Computer agent executes
-const executor = new Agent({
-  agentType: 'computer',
-  workspace: './my-project',
-  instructions: 'Execute implementation plans.'
-});
-
-// LLM reviews result
-const reviewer = new Agent({
-  agentType: 'llm',
-  model: 'gpt-4o',
-  instructions: 'Review code quality.'
-});
-
-const task = "Add user authentication";
-const plan = await run(planner, `Plan: ${task}`);
-const code = await run(executor, plan.finalOutput);
-const review = await run(reviewer, `Review: ${code.finalOutput}`);
-```
-
 ## Session Continuity
 
 Agents automatically maintain context across multiple runs:
@@ -219,6 +188,41 @@ agent.resetSession();  // Start fresh
 await run(agent, 'New project');  // New session
 ```
 
+## Cloud Execution (Coming Soon)
+
+> **Note**: Cloud execution with `CloudClient` and `Project` management is currently in private beta. Public access coming soon.
+>
+> Interested in early access? [Join the waitlist →](https://testbase.ai)
+
+Cloud execution will enable:
+- Run agents in isolated cloud environments
+- Project-based workspace management with bidirectional sync
+- Seamless transition from local to cloud with workspace configuration
+- Parallel execution at scale without local resource constraints
+
+Example (available in private beta):
+
+```typescript
+import { Agent, run, CloudClient } from 'computer-agents';
+
+const client = new CloudClient({
+  apiKey: process.env.TESTBASE_API_KEY
+});
+
+// Create a cloud project
+const project = await client.createProject({ name: 'my-app' });
+
+// Cloud agent
+const agent = new Agent({
+  agentType: "computer",
+  workspace: project,  // Use cloud project as workspace
+  instructions: "You are an expert developer."
+});
+
+const result = await run(agent, "Add error handling to the API");
+console.log(result.finalOutput);
+```
+
 ## Configuration
 
 ### Agent Configuration
@@ -236,23 +240,13 @@ const agent = new Agent({
 });
 ```
 
-### CloudClient Configuration
-
-```typescript
-const client = new CloudClient({
-  apiKey: process.env.TESTBASE_API_KEY,  // Required
-  debug: false,                           // Show detailed logs
-  timeout: 600000,                        // 10 minutes (default)
-});
-```
-
 ### Environment Variables
 
 ```bash
 # Required for all agents
 OPENAI_API_KEY=your-openai-key
 
-# Required for CloudClient
+# Required for CloudClient (private beta)
 TESTBASE_API_KEY=your-testbase-key
 ```
 
@@ -320,7 +314,7 @@ function runStreamed(
 ): AsyncGenerator<Event>;
 ```
 
-### CloudClient
+### CloudClient (Coming Soon)
 
 ```typescript
 class CloudClient {
@@ -333,7 +327,7 @@ class CloudClient {
 }
 ```
 
-### Project
+### Project (Coming Soon)
 
 ```typescript
 class Project {
@@ -381,14 +375,6 @@ node examples/testbase/streaming-progress.cjs
 export OPENAI_API_KEY=sk-...
 ```
 
-### "TESTBASE_API_KEY required"
-
-```bash
-export TESTBASE_API_KEY=your-key
-# Or provide in constructor:
-new CloudClient({ apiKey: 'your-key' })
-```
-
 ### "Computer agents require a workspace"
 
 Computer agents need a workspace parameter:

package/dist/metadata.js

@@ -4,9 +4,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.METADATA = void 0;
 exports.METADATA = {
     "name": "computer-agents",
-    "version": "0.6.4",
+    "version": "0.6.5",
     "versions": {
-        "computer-agents": "0.6.4"
+        "computer-agents": "0.6.5"
     }
 };
 exports.default = exports.METADATA;

package/package.json

@@ -2,7 +2,7 @@
   "name": "computer-agents",
   "repository": "https://github.com/TestBase-ai/computer-agents",
   "homepage": "https://testbase.ai/computer-agents",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "Build computer-use agents that write code, run tests, and deploy apps. Seamless local and cloud execution with automatic session continuity.",
   "author": "Testbase",
   "main": "dist/index.js",