computer-agents 0.6.6 → 0.6.7

package/README.md

@@ -168,6 +168,97 @@ for await (const event of runStreamed(agent, 'Create a web scraper')) {
 }
 ```
 
+## Task Control
+
+Control running agents with pause, resume, abort, and messaging capabilities:
+
+### Local Control
+
+Control agents running in the same process:
+
+```typescript
+import { Agent, run } from 'computer-agents';
+
+const agent = new Agent({
+  agentType: 'computer',
+  workspace: './my-project'
+});
+
+// Start a long-running task
+const taskPromise = run(agent, 'Analyze all TypeScript files');
+
+// Pause after 5 seconds
+setTimeout(async () => {
+  await agent.pause();
+  console.log('Agent paused');
+
+  // Resume later
+  await agent.resume();
+  await run(agent, 'Continue analysis');
+}, 5000);
+
+// Check status
+const status = agent.getStatus();
+console.log(status);
+// { status: 'running', threadId: 'thread-123', queuedMessages: 0 }
+
+// Send messages
+await agent.sendMessage('Focus on performance issues');
+
+// Abort permanently
+await agent.abort();
+```
+
+### Cloud Control API
+
+Control cloud agents remotely via HTTP endpoints:
+
+```bash
+# Get execution status
+curl -X GET https://api.testbase.ai/control/status/thread-abc-123 \
+  -H "X-API-Key: your-api-key"
+
+# Pause execution
+curl -X POST https://api.testbase.ai/control/pause/thread-abc-123 \
+  -H "X-API-Key: your-api-key"
+
+# Resume execution
+curl -X POST https://api.testbase.ai/control/resume/thread-abc-123 \
+  -H "X-API-Key: your-api-key"
+
+# Abort execution
+curl -X POST https://api.testbase.ai/control/abort/thread-abc-123 \
+  -H "X-API-Key: your-api-key"
+
+# Send message
+curl -X POST https://api.testbase.ai/control/message/thread-abc-123 \
+  -H "X-API-Key: your-api-key" \
+  -H "Content-Type: application/json" \
+  -d '{"message": "Focus on critical files only"}'
+
+# List all running executions
+curl -X GET https://api.testbase.ai/control/executions \
+  -H "X-API-Key: your-api-key"
+```
+
+### Control Methods
+
+| Method | Description | Returns |
+|--------|-------------|---------|
+| `agent.pause()` | Pause execution (can be resumed) | `Promise<void>` |
+| `agent.resume()` | Resume paused execution | `Promise<void>` |
+| `agent.abort()` | Stop permanently (cannot resume) | `Promise<void>` |
+| `agent.sendMessage(msg)` | Queue message for agent | `Promise<void>` |
+| `agent.getStatus()` | Get current status | `{ status, threadId, queuedMessages }` |
+
+### Use Cases
+
+- **Long-running tasks**: Pause agents that exceed time limits
+- **User intervention**: Send messages to guide agent behavior
+- **Error recovery**: Abort stuck or misbehaving agents
+- **Resource management**: Control multiple cloud executions
+- **Interactive workflows**: Pause for user review, then resume
+
 ## Session Continuity
 
 Agents automatically maintain context across multiple runs:
@@ -291,6 +382,13 @@ class Agent {
   resetSession(): void;
   workspace: string;
   agentType: 'llm' | 'computer';
+
+  // Task control
+  async pause(): Promise<void>;
+  async resume(): Promise<void>;
+  async abort(): Promise<void>;
+  async sendMessage(message: string): Promise<void>;
+  getStatus(): { status: 'idle' | 'running' | 'paused' | 'aborted', threadId?: string, queuedMessages: number };
 }
 ```
 

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.6",
+    "version": "0.6.7",
     "versions": {
-        "computer-agents": "0.6.6"
+        "computer-agents": "0.6.7"
     }
 };
 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.6",
+  "version": "0.6.7",
   "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",