computer-agents 0.4.9 → 0.4.11

package/README.md

@@ -101,6 +101,67 @@ const result = await run(agent, "Build a REST API with Express");
 // Executes in fresh cloud workspace, results stay in cloud
 ```
 
+### Streaming Progress (Real-Time Visibility)
+
+Track agent execution in real-time with `runStreamed()`:
+
+```typescript
+import { Agent, runStreamed, LocalRuntime } from 'computer-agents';
+
+const agent = new Agent({
+  agentType: "computer",
+  runtime: new LocalRuntime(),
+  workspace: "./my-project",
+});
+
+// Stream events in real-time
+for await (const event of runStreamed(agent, 'Create a Python web scraper')) {
+  switch (event.type) {
+    case 'thread.started':
+      console.log(`🔗 Thread: ${event.thread_id}`);
+      break;
+    case 'turn.started':
+      console.log('🎬 Turn started');
+      break;
+    case 'item.completed':
+      if (event.item.type === 'file_change') {
+        const files = event.item.changes.map(c => `${c.kind} ${c.path}`).join(', ');
+        console.log(`✅ Files: ${files}`);
+      }
+      break;
+    case 'turn.completed':
+      console.log(`🎉 Completed (${event.usage.input_tokens + event.usage.output_tokens} tokens)`);
+      break;
+  }
+}
+```
+
+**Event Types:**
+- `thread.started` - Session initialized with thread ID
+- `turn.started` - Agent begins processing
+- `item.started` - Tool call or action begins
+- `item.completed` - Tool call or action completes (includes file changes)
+- `turn.completed` - Processing finished (includes token usage)
+- `turn.failed` - Error occurred
+
+**Use Cases:**
+- Progress bars for long-running tasks
+- Real-time logging and debugging
+- Live UI updates in applications
+- Better UX for multi-step operations
+
+**API Consistency:** `runStreamed()` mirrors `run()` - same signature, just with streaming!
+
+```typescript
+// Standard execution
+const result = await run(agent, task);
+
+// Streaming execution
+for await (const event of runStreamed(agent, task)) {
+  // Real-time progress
+}
+```
+
 ### Parallel Execution (The Game Changer)
 
 Run multiple agents simultaneously:
@@ -236,6 +297,9 @@ cd computer-agents
 npm install
 npm run build
 
+# Streaming progress (real-time event visibility)
+node examples/testbase/streaming-progress.cjs
+
 # Workspace sync modes (default vs cloud-only)
 node examples/testbase/workspace-sync-modes.mjs
 
@@ -415,6 +479,30 @@ function run(
 ): Promise<RunResult>;
 ```
 
+### runStreamed()
+
+```typescript
+function runStreamed(
+  agent: Agent,
+  task: string,
+  options?: RunOptions
+): AsyncGenerator<Event>;
+```
+
+Stream real-time events during agent execution. Returns an async generator that yields:
+- `thread.started` - Session initialized
+- `turn.started` - Agent begins processing
+- `item.started` / `item.completed` - Tool calls and file changes
+- `turn.completed` - Processing finished with usage stats
+- `turn.failed` - Error occurred
+
+**Example:**
+```typescript
+for await (const event of runStreamed(agent, 'Create app.py')) {
+  console.log(event.type, event);
+}
+```
+
 ### LocalRuntime
 
 ```typescript
@@ -578,6 +666,12 @@ new CloudRuntime({ skipWorkspaceSync: true })
 
 ## What's New
 
+### v0.4.9
+- **Streaming Progress**: New `runStreamed()` function for real-time visibility
+- Stream events: thread.started, turn.started, item.completed, turn.completed
+- API consistency - mirrors `run()` signature for easy adoption
+- Perfect for progress bars, real-time logging, and better UX
+
 ### v0.4.6
 - **Cloud-Only Mode**: `skipWorkspaceSync` option for CloudRuntime
 - Perfect for CI/CD and parallel experiments

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.9",
+    "version": "0.4.11",
     "versions": {
-        "computer-agents": "0.4.9"
+        "computer-agents": "0.4.11"
     }
 };
 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,OAAO;IAClB,UAAU,EAAE;QACV,iBAAiB,EAAE,OAAO;KAC3B;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,QAAQ;IACnB,UAAU,EAAE;QACV,iBAAiB,EAAE,QAAQ;KAC5B;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.9",
+  "version": "0.4.11",
   "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": "workspace:*",
-    "computer-agents-openai": "workspace:*"
+    "computer-agents-core": "0.4.11",
+    "computer-agents-openai": "0.4.11"
   },
   "keywords": [
     "computer-agents",