computer-agents 0.4.11 → 0.5.1

package/README.md

@@ -64,11 +64,14 @@ const result = await run(agent, "Create a Python script that calculates fibonacc
 console.log(result.finalOutput);
 ```
 
-### Cloud Computer Agent (with workspace sync)
+### Cloud Computer Agent (Coming Soon)
+
+> **Note**: CloudRuntime for remote execution is under development and will be available in an upcoming release. The infrastructure is production-ready, and we're finalizing API access for public use.
 
 ```typescript
 import { Agent, run, CloudRuntime } from 'computer-agents';
 
+// CloudRuntime will be available soon
 const agent = new Agent({
   agentType: "computer",
   runtime: new CloudRuntime({ apiKey: process.env.TESTBASE_API_KEY }),
@@ -81,25 +84,7 @@ console.log(result.finalOutput);
 // Files automatically synced from cloud to local workspace
 ```
 
-### Cloud-Only Mode (no local sync)
-
-Perfect for CI/CD, experiments, and parallel tasks:
-
-```typescript
-const runtime = new CloudRuntime({
-  apiKey: process.env.TESTBASE_API_KEY,
-  skipWorkspaceSync: true,  // No upload/download, faster execution
-});
-
-const agent = new Agent({
-  agentType: "computer",
-  runtime,
-  workspace: "./cloud-workspace",  // Placeholder, not synced
-});
-
-const result = await run(agent, "Build a REST API with Express");
-// Executes in fresh cloud workspace, results stay in cloud
-```
+For now, use `LocalRuntime` for all computer agent tasks.
 
 ### Streaming Progress (Real-Time Visibility)
 
@@ -162,26 +147,92 @@ for await (const event of runStreamed(agent, task)) {
 }
 ```
 
-### Parallel Execution (The Game Changer)
+### Project Management (Efficient Workspace Sync)
+
+Manage workspaces with the new Project API - perfect for organizing code and syncing with cloud storage:
+
+```typescript
+import { Project, CloudRuntime, Agent, run } from 'computer-agents';
+
+const runtime = new CloudRuntime({ apiKey: process.env.TESTBASE_API_KEY });
+
+// Create a synced project (local ↔ cloud)
+const project = await Project.create({
+  name: 'my-app',
+  type: 'synced',           // 'local', 'cloud', or 'synced'
+  localPath: './src',
+  runtime
+});
+
+// Incremental sync - only uploads changed files (10x faster!)
+await project.sync({ direction: 'up' });  // Upload changes
+await project.sync({ direction: 'down' }); // Download changes
+await project.sync({ direction: 'both' }); // Bi-directional sync
+
+// Agents automatically use project workspaces
+const agent = new Agent({
+  agentType: 'computer',
+  runtime,
+  workspace: project.getWorkspacePath()
+});
+
+await run(agent, 'Add user authentication');
+// Changes are tracked, next sync will be incremental!
+```
+
+**Project Types:**
+- **`local`** - Local-only workspace (no cloud sync)
+- **`cloud`** - Cloud-only workspace (no local files)
+- **`synced`** - Bidirectional sync with incremental updates
+
+**Key Benefits:**
+- **10x faster sync** - Only transfers changed files (SHA-256 hashing)
+- **Organized workspaces** - Manage multiple projects easily
+- **Automatic tracking** - Sync state persisted in `.testbase/sync-state.json`
+- **Flexible sync** - Choose `up`, `down`, or `both` directions
+
+**Example: Incremental Sync Performance**
+- Full workspace (500MB): ~35 seconds
+- Incremental (5MB changes): ~3 seconds
+
+```typescript
+// List all projects
+const projects = await Project.list({ runtime });
+
+// Get existing project
+const project = await Project.get('project-id', { runtime });
+
+// Get sync statistics
+const stats = await project.getSyncStats();
+console.log(stats); // { lastSyncAt, fileCount, version }
+
+// Manual file operations
+await project.upload(['file1.txt', 'file2.txt']);
+await project.download(['file1.txt']);
+await project.readFile('config.json');
+await project.writeFile('config.json', '{ "new": "data" }');
+```
+
+> **Note**: Project Management with CloudRuntime is coming soon. Currently works with LocalRuntime for local workspace organization.
+
+### Parallel Execution (Coming Soon with CloudRuntime)
 
-Run multiple agents simultaneously:
+> **Note**: Large-scale parallel execution requires CloudRuntime, which is coming soon. For now, you can run multiple LocalRuntime agents in parallel for local development.
+
+When CloudRuntime is available, run 10, 50, or 100+ agents simultaneously:
 
 ```typescript
 import { Agent, run, CloudRuntime } from 'computer-agents';
 
+// CloudRuntime will enable massive parallelization
 const runtime = new CloudRuntime({
   apiKey: process.env.TESTBASE_API_KEY,
   skipWorkspaceSync: true,
 });
 
 // Create 5 agents to test different approaches
-const agents = [
-  'Express',
-  'Fastify',
-  'Koa',
-  'Hapi',
-  'Restify'
-].map(framework => new Agent({
+const frameworks = ['Express', 'Fastify', 'Koa', 'Hapi', 'Restify'];
+const agents = frameworks.map(framework => new Agent({
   name: `${framework} Agent`,
   agentType: 'computer',
   runtime,
@@ -198,6 +249,22 @@ const results = await Promise.all(
 console.log('All 5 frameworks tested in parallel!');
 ```
 
+**For now with LocalRuntime:**
+```typescript
+// You can still run multiple LocalRuntime agents in parallel
+// (limited by your local machine resources)
+const localAgents = frameworks.map(framework => new Agent({
+  agentType: 'computer',
+  runtime: new LocalRuntime(),
+  workspace: `./local-test-${framework.toLowerCase()}`,
+}));
+
+// Parallel local execution
+const results = await Promise.all(
+  localAgents.map((agent, i) => run(agent, tasks[i]))
+);
+```
+
 ### LLM Agent (for planning and reasoning)
 
 ```typescript
@@ -519,6 +586,8 @@ class LocalRuntime implements Runtime {
 
 ### CloudRuntime
 
+> **Note**: CloudRuntime is under development and will be available in an upcoming release.
+
 ```typescript
 class CloudRuntime implements Runtime {
   constructor(config?: {
@@ -534,6 +603,60 @@ class CloudRuntime implements Runtime {
 }
 ```
 
+### Project
+
+```typescript
+class Project {
+  // Factory methods
+  static async create(config: CreateProjectConfig): Promise<Project>;
+  static async get(id: string, config: GetProjectConfig): Promise<Project>;
+  static async list(config: GetProjectConfig): Promise<Project[]>;
+
+  // Properties
+  readonly id: string;
+  readonly name: string;
+  readonly type: 'local' | 'cloud' | 'synced';
+  readonly localPath: string | undefined;
+  readonly cloudPath: string;
+
+  // Sync operations
+  async sync(options?: SyncOptions): Promise<SyncResult>;
+  async upload(files: string[]): Promise<void>;
+  async download(files: string[]): Promise<void>;
+
+  // File operations
+  async listFiles(pattern?: string): Promise<ProjectFile[]>;
+  async readFile(path: string): Promise<string>;
+  async writeFile(path: string, content: string): Promise<void>;
+
+  // Management
+  async delete(hard?: boolean): Promise<void>;
+  async getStats(): Promise<ProjectStats>;
+  async getSyncStats(): Promise<SyncStats>;
+  async resetSyncState(): Promise<void>;
+
+  // Workspace path for agents
+  getWorkspacePath(): string;
+}
+
+// Create project
+const project = await Project.create({
+  name: 'my-app',
+  type: 'synced',           // 'local' | 'cloud' | 'synced'
+  localPath: './src',       // Required for 'local' and 'synced'
+  runtime,                  // Required for 'cloud' and 'synced'
+  description: 'My app',    // Optional
+  metadata: { ... },        // Optional
+});
+
+// Sync options
+await project.sync({
+  direction: 'both',        // 'up' | 'down' | 'both'
+  force: false,             // Force full sync (skip incremental)
+  pattern: '*.ts'          // Optional glob pattern
+});
+```
+
 ## Architecture
 
 ```
@@ -625,15 +748,20 @@ for (let i = 0; i < agents.length; i++) {
 
 ## Cloud Infrastructure
 
-computer-agents includes production-ready cloud infrastructure:
+> **Coming Soon**: Public access to cloud execution infrastructure is under development.
+
+computer-agents includes production-ready cloud infrastructure that will soon be available:
 
 - **GCS Bucket** - Workspace storage (`gs://testbase-workspaces`)
 - **GCE VM** - Codex SDK execution server
 - **Pay-per-token** - Credit-based billing system
 - **API Keys** - Database-backed authentication
 - **Budget Protection** - Daily/monthly spending limits
+- **Project Management** - Incremental sync with SHA-256 hashing
+
+The infrastructure is fully built and tested. We're finalizing API access for public use. Stay tuned for updates!
 
-See [Cloud Infrastructure docs](./packages/cloud-infrastructure/README.md) for deployment details.
+For now, `LocalRuntime` provides full computer-use agent capabilities for local development.
 
 ## Documentation
 
@@ -666,6 +794,15 @@ new CloudRuntime({ skipWorkspaceSync: true })
 
 ## What's New
 
+### v0.5.0
+- **Project Management System**: Organize and sync workspaces efficiently
+- Three project types: `local`, `cloud`, and `synced`
+- Incremental sync with SHA-256 hashing - 10x faster than full sync
+- Track sync state automatically in `.testbase/sync-state.json`
+- Native Web API FormData for reliable file uploads
+- Seamless agent integration with project workspaces
+- Complete API: `Project.create()`, `project.sync()`, `project.upload()`, `project.download()`
+
 ### v0.4.9
 - **Streaming Progress**: New `runStreamed()` function for real-time visibility
 - Stream events: thread.started, turn.started, item.completed, turn.completed

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.4.11",
+    "version": "0.5.1",
     "versions": {
-        "computer-agents": "0.4.11"
+        "computer-agents": "0.5.1"
     }
 };
 exports.default = exports.METADATA;

package/dist/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":";AACA,uCAAuC;;;AAE1B,QAAA,QAAQ,GAAG;IACtB,MAAM,EAAE,iBAAiB;IACzB,SAAS,EAAE,QAAQ;IACnB,UAAU,EAAE;QACV,iBAAiB,EAAE,QAAQ;KAC5B;CACF,CAAC;AAEF,kBAAe,gBAAQ,CAAC"}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":";AACA,uCAAuC;;;AAE1B,QAAA,QAAQ,GAAG;IACtB,MAAM,EAAE,iBAAiB;IACzB,SAAS,EAAE,OAAO;IAClB,UAAU,EAAE;QACV,iBAAiB,EAAE,OAAO;KAC3B;CACF,CAAC;AAEF,kBAAe,gBAAQ,CAAC"}

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.4.11",
+  "version": "0.5.1",
   "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",
@@ -20,8 +20,8 @@
     "build-check": "tsc --noEmit -p ./tsconfig.test.json"
   },
   "dependencies": {
-    "computer-agents-core": "0.4.11",
-    "computer-agents-openai": "0.4.11"
+    "computer-agents-core": "0.5.0",
+    "computer-agents-openai": "0.5.0"
   },
   "keywords": [
     "computer-agents",