computer-agents 2.1.0 → 2.3.0

package/README.md

@@ -1,15 +1,14 @@
 # Computer Agents SDK
 
-Official TypeScript/JavaScript SDK for the [Computer Agents Cloud API](https://api.computer-agents.com).
+[![npm version](https://img.shields.io/npm/v/computer-agents.svg?color=success)](https://www.npmjs.com/package/computer-agents)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+Official TypeScript/JavaScript SDK for the [Computer Agents Cloud API](https://computer-agents.com). Execute Claude-powered AI agents in isolated cloud containers.
 
 ## Installation
 
 ```bash
 npm install computer-agents
-# or
-pnpm add computer-agents
-# or
-yarn add computer-agents
 ```
 
 ## Quick Start
@@ -23,7 +22,6 @@ const client = new ComputerAgentsClient({
 
 // Execute a task
 const result = await client.run('Create a REST API with Flask', {
-  environmentId: 'env_xxx',
   onEvent: (event) => console.log(event.type)
 });
 
@@ -32,54 +30,57 @@ console.log(result.content);
 
 ## Features
 
-- Full TypeScript support with complete type definitions
-- SSE streaming for real-time execution progress
-- Simple, intuitive API that mirrors the REST API structure
-- Zero dependencies - uses native `fetch`
+- **Claude-powered** — agents run on Claude Opus 4.6, Sonnet 4.5, or Haiku 4.5
+- **Cloud execution** — isolated containers with persistent workspaces
+- **SSE streaming** — real-time execution progress and tool calls
+- **Session continuity** — multi-turn conversations via threads
+- **MCP integration** — extend capabilities with Model Context Protocol servers
+- **Skills** — web search, image generation, deep research
+- **Zero dependencies** — uses native `fetch`
+- **Full TypeScript support** — complete type definitions
+
+## Supported Models
+
+| Model | ID | Use Case |
+|-------|-----|----------|
+| Claude 4.6 Opus | `claude-opus-4-6` | Most capable, complex tasks |
+| Claude 4.5 Sonnet | `claude-sonnet-4-5` | Balanced (default) |
+| Claude 4.5 Haiku | `claude-haiku-4-5` | Fast, efficient |
 
 ## API Reference
 
-### Creating a Client
+### Client
 
 ```typescript
 const client = new ComputerAgentsClient({
-  apiKey: 'tb_xxx',                              // Required
-  baseUrl: 'https://api.computer-agents.com',   // Optional (default)
-  timeout: 60000,                                // Optional (default: 60s)
-  debug: false                                   // Optional
+  apiKey: 'your-api-key',                         // Required
+  baseUrl: 'https://api.computer-agents.com',     // Optional (default)
+  timeout: 60000,                                  // Optional (default: 60s)
+  debug: false                                     // Optional
 });
 ```
 
 ### Running Tasks
 
-The simplest way to execute a task:
-
 ```typescript
 // One-shot execution
 const result = await client.run('Fix the TypeScript errors', {
   environmentId: 'env_xxx'
 });
 
-// With streaming progress
+// With streaming
 const result = await client.run('Build a REST API', {
-  environmentId: 'env_xxx',
   onEvent: (event) => {
     if (event.type === 'response.item.completed') {
-      console.log(event.item);
+      console.log(event);
     }
   }
 });
-
-// Continue a conversation
-const followUp = await client.run('Add authentication', {
-  environmentId: 'env_xxx',
-  threadId: result.threadId
-});
 ```
 
 ### Threads
 
-For multi-turn conversations:
+Multi-turn conversations with persistent context:
 
 ```typescript
 // Create a thread
@@ -87,154 +88,103 @@ const thread = await client.threads.create({
   environmentId: 'env_xxx'
 });
 
-// Send a message
-const result = await client.threads.sendMessage(thread.id, {
-  content: 'Create a REST API',
+// Send messages — the agent remembers the full context
+await client.threads.sendMessage(thread.id, {
+  content: 'Create a Python web server',
   onEvent: (event) => console.log(event)
 });
 
-// List threads
-const threads = await client.threads.list();
-
-// Get a specific thread
-const thread = await client.threads.get('thread_xxx');
-
-// Delete a thread
-await client.threads.delete('thread_xxx');
-```
-
-### Environments
-
-Manage isolated execution environments:
-
-```typescript
-// Create an environment with custom configuration
-const env = await client.environments.create({
-  name: 'data-science',
-  description: 'Environment for data processing',
-  runtimes: { python: '3.12', nodejs: '20' },
-  packages: {
-    system: ['ffmpeg'],
-    python: ['pandas', 'numpy'],
-    node: ['typescript']
-  },
-  internetAccess: true
+await client.threads.sendMessage(thread.id, {
+  content: 'Add authentication to it',
+  onEvent: (event) => console.log(event)
 });
 
-// List environments
-const environments = await client.environments.list();
-
-// Get an environment
-const env = await client.environments.get('env_xxx');
-
-// Get default environment (creates one if doesn't exist)
-const defaultEnv = await client.environments.getDefault();
-
-// Update an environment
-await client.environments.update('env_xxx', {
-  description: 'Updated description'
+// Copy a thread to fork the conversation
+const copy = await client.threads.copy(thread.id, {
+  title: 'Experiment v2'
 });
 
-// Delete an environment
-await client.environments.delete('env_xxx');
-```
-
-#### Runtime Management
-
-```typescript
-// List all available runtimes and versions
-const available = await client.environments.listAvailableRuntimes();
-// { python: ['3.9', '3.10', '3.11', '3.12', '3.13'], nodejs: ['18', '20', '22'], ... }
-
-// Get current runtimes for an environment
-const runtimes = await client.environments.getRuntimes('env_xxx');
-// { python: '3.12', nodejs: '20' }
-
-// Set runtime versions (triggers rebuild)
-await client.environments.setRuntimes('env_xxx', {
-  python: '3.12',
-  nodejs: '20',
-  go: '1.22'
+// Search across threads
+const results = await client.threads.search({
+  query: 'REST API',
+  limit: 10
 });
-```
-
-#### Package Management
-
-```typescript
-// List installed packages
-const packages = await client.environments.listPackages('env_xxx');
-// { system: ['ffmpeg'], python: ['pandas'], node: ['typescript'] }
 
-// Install packages (triggers rebuild)
-await client.environments.installPackages('env_xxx', 'python', ['requests', 'beautifulsoup4']);
-await client.environments.installPackages('env_xxx', 'system', ['imagemagick']);
-await client.environments.installPackages('env_xxx', 'node', ['tsx']);
+// Get execution logs
+const logs = await client.threads.getLogs(thread.id);
 
-// Uninstall a package (triggers rebuild)
-await client.environments.uninstallPackage('env_xxx', 'python', 'requests');
+// List, get, update, delete
+const threads = await client.threads.list();
+const t = await client.threads.get('thread_xxx');
+await client.threads.update('thread_xxx', { title: 'New title' });
+await client.threads.delete('thread_xxx');
 ```
 
-#### Dockerfile Customization
-
-```typescript
-// Get Dockerfile configuration
-const dockerfile = await client.environments.getDockerfile('env_xxx');
-// { baseImage: '...', dockerfileExtensions: '...', effectiveDockerfile: '...' }
-
-// Set Dockerfile extensions (triggers rebuild)
-await client.environments.setDockerfileExtensions('env_xxx',
-  'RUN pip install custom-package\nRUN apt-get install -y custom-tool'
-);
-
-// Validate Dockerfile syntax without building
-const validation = await client.environments.validateDockerfile('env_xxx',
-  'RUN pip install something'
-);
-// { valid: true, warnings: [], effectiveDockerfile: '...' }
-```
+### Agents
 
-#### Build Management
+Configure agent behavior with specific models and instructions:
 
 ```typescript
-// Trigger a build
-const build = await client.environments.triggerBuild('env_xxx');
-// { buildId: 'build_xxx', status: 'building', message: 'Build started' }
-
-// Force rebuild even if up to date
-await client.environments.triggerBuild('env_xxx', true);
-
-// Get build status
-const status = await client.environments.getBuildStatus('env_xxx');
-// { buildStatus: 'ready', buildHash: '...', imageTag: '...', lastBuildAt: '...' }
-
-// Get build logs
-const logs = await client.environments.getBuildLogs('env_xxx');
-// { logs: '...', buildStatus: 'ready' }
+const agent = await client.agents.create({
+  name: 'Senior Developer',
+  model: 'claude-sonnet-4-5',
+  instructions: 'You are a senior developer. Write clean, tested code.',
+  reasoningEffort: 'high'
+});
 
-// Test build (validates without caching)
-const test = await client.environments.testBuild('env_xxx');
-// { success: true, logs: '...', duration: 45000 }
+// Use the agent in a thread
+const thread = await client.threads.create({
+  environmentId: 'env_xxx',
+  agentId: agent.id
+});
 ```
 
-### Agents
+### Environments
 
-Configure agent behavior:
+Isolated containers with custom runtimes, packages, and configuration:
 
 ```typescript
-// Create an agent
-const agent = await client.agents.create({
-  name: 'Code Assistant',
-  model: 'gpt-4o',
-  instructions: 'You are a helpful coding assistant.'
+// Create an environment
+const env = await client.environments.create({
+  name: 'python-dev',
+  internetAccess: true
 });
 
-// List agents
-const agents = await client.agents.list();
+// Configure runtimes
+await client.environments.setRuntimes(env.id, {
+  python: '3.12',
+  nodejs: '20'
+});
+
+// Install packages
+await client.environments.installPackages(env.id, {
+  packages: [
+    { type: 'python', name: 'flask' },
+    { type: 'python', name: 'pytest' },
+    { type: 'system', name: 'curl' }
+  ]
+});
 
-// Update an agent
-await client.agents.update('agent_xxx', {
-  instructions: 'Updated instructions'
+// Add MCP servers
+await client.environments.update(env.id, {
+  mcpServers: [
+    {
+      type: 'stdio',
+      name: 'filesystem',
+      command: 'npx',
+      args: ['-y', '@modelcontextprotocol/server-filesystem', '/workspace']
+    },
+    {
+      type: 'http',
+      name: 'notion',
+      url: 'https://mcp.notion.com/mcp',
+      bearerToken: process.env.NOTION_TOKEN
+    }
+  ]
 });
+
+// Trigger a build
+await client.environments.build(env.id);
 ```
 
 ### Files
@@ -242,89 +192,92 @@ await client.agents.update('agent_xxx', {
 Manage files in environment workspaces:
 
 ```typescript
-// List files in an environment
-const files = await client.files.listFiles('env_xxx');
-
 // Upload a file
 await client.files.uploadFile({
   environmentId: 'env_xxx',
-  filename: 'app.py',
-  path: 'src',  // optional subdirectory
+  path: 'src/app.py',
   content: 'print("hello")'
 });
 
 // Download file content
 const content = await client.files.getFile('env_xxx', 'src/app.py');
 
-// Download as Buffer
-const buffer = await client.files.downloadFile('env_xxx', 'src/app.py');
-
-// Move/rename a file
-await client.files.moveFile({
-  environmentId: 'env_xxx',
-  sourcePath: 'old-name.py',
-  destPath: 'new-name.py'
-});
+// List files
+const files = await client.files.listFiles('env_xxx');
 
 // Delete a file
 await client.files.deleteFile('env_xxx', 'src/app.py');
 ```
 
+### Git
+
+Version control on workspaces:
+
+```typescript
+// View uncommitted changes
+const diff = await client.git.diff('env_xxx');
+
+// Commit and push
+await client.git.commit('env_xxx', { message: 'Add new feature' });
+await client.git.push('env_xxx');
+```
+
 ### Schedules
 
-Automate task execution:
+Automate recurring tasks:
 
 ```typescript
-// Create a schedule
 const schedule = await client.schedules.create({
-  name: 'Daily Report',
-  agentId: 'agent_xxx',
-  agentName: 'Reporter',
-  task: 'Generate daily report',
-  scheduleType: 'recurring',
-  cronExpression: '0 9 * * *'
+  name: 'Daily Code Review',
+  type: 'cron',
+  cronExpression: '0 9 * * *',
+  task: 'Review all uncommitted changes',
+  environmentId: 'env_xxx'
 });
 
-// List schedules
-const schedules = await client.schedules.list();
-
-// Trigger a schedule manually
-await client.schedules.trigger('schedule_xxx');
+// Trigger manually
+await client.schedules.trigger(schedule.id);
 ```
 
-### Billing
+### Budget
 
-Track usage and manage budgets:
+Monitor spending and control execution:
 
 ```typescript
-// Get budget status
 const status = await client.budget.getStatus();
+console.log(`Balance: $${(status.balance / 100).toFixed(2)}`);
 
-// Check if can execute
 const canRun = await client.budget.canExecute();
-
-// Get billing records
-const records = await client.billing.listRecords({ limit: 10 });
-
-// Get usage stats
-const stats = await client.billing.getStats({ period: 'month' });
+if (!canRun.canExecute) {
+  console.log('Budget exceeded:', canRun.reason);
+}
 ```
 
-### Git Operations
-
-Manage version control:
+## Streaming Events
 
 ```typescript
-// Get diff
-const diff = await client.git.diff('env_xxx');
-
-// Commit changes
-await client.git.commit('env_xxx', {
-  message: 'Add new feature'
+await client.threads.sendMessage(threadId, {
+  content: 'Build a REST API',
+  onEvent: (event) => {
+    switch (event.type) {
+      case 'response.started':
+        console.log('Execution started');
+        break;
+      case 'response.item.completed':
+        console.log('Item:', event);
+        break;
+      case 'response.completed':
+        console.log('Response finished');
+        break;
+      case 'stream.completed':
+        console.log('Done');
+        break;
+      case 'stream.error':
+        console.error('Error:', event);
+        break;
+    }
+  }
 });
-
-// Push to remote
-await client.git.push('env_xxx');
 ```
 
 ## Error Handling
@@ -333,7 +286,7 @@ await client.git.push('env_xxx');
 import { ComputerAgentsClient, ApiClientError } from 'computer-agents';
 
 try {
-  await client.run('Task', { environmentId: 'env_xxx' });
+  await client.run('Task');
 } catch (error) {
   if (error instanceof ApiClientError) {
     console.error(`API Error: ${error.message}`);
@@ -343,11 +296,31 @@ try {
 }
 ```
 
-## Environment Variables
+## Examples
+
+See the [`examples/`](./examples) directory for complete, runnable examples:
 
-| Variable | Description |
-|----------|-------------|
-| `COMPUTER_AGENTS_API_KEY` | API key for authentication |
+| Example | Description |
+|---------|-------------|
+| [Hello World](./examples/01-hello-world.ts) | Simplest possible usage |
+| [Multi-turn Conversation](./examples/02-multi-turn-conversation.ts) | Thread-based conversations |
+| [Streaming](./examples/03-streaming.ts) | Real-time SSE event handling |
+| [Custom Agent](./examples/04-custom-agent.ts) | Agent configuration with models and instructions |
+| [Environments](./examples/05-environments.ts) | Environment management |
+| [File Operations](./examples/06-file-operations.ts) | Upload, download, and manage files |
+| [Copy Thread](./examples/07-copy-thread.ts) | Fork conversations |
+| [Search Threads](./examples/08-search-threads.ts) | Full-text search across threads |
+| [MCP Servers](./examples/09-mcp-servers.ts) | Model Context Protocol integration |
+| [Git Operations](./examples/10-git-operations.ts) | Diffs, commits, and pushes |
+| [Budget Management](./examples/11-budget-management.ts) | Monitor spending |
+| [Schedules](./examples/12-schedules.ts) | Automate recurring tasks |
+| [Execution Logs](./examples/13-execution-logs.ts) | Logs and deep research sessions |
+
+Run any example:
+
+```bash
+COMPUTER_AGENTS_API_KEY=your-key npx tsx examples/01-hello-world.ts
+```
 
 ## TypeScript
 
@@ -355,25 +328,29 @@ Full type definitions are included:
 
 ```typescript
 import type {
-  // Core types
   Thread,
   Environment,
   CloudAgent,
   Schedule,
-  BudgetStatus,
+  Run,
+  AgentModel,
+  ReasoningEffort,
   MessageStreamEvent,
-
-  // Environment configuration
-  RuntimeConfig,
-  PackagesConfig,
-  AvailableRuntimes,
-  PackageType,
-  BuildStatus,
-  BuildStatusResult,
-  DockerfileResult,
+  McpServer,
+  BudgetStatus,
+  CopyThreadParams,
+  SearchThreadsResponse,
+  ThreadLogEntry,
+  ResearchSession,
 } from 'computer-agents';
 ```
 
 ## License
 
 MIT
+
+## Links
+
+- [Website](https://computer-agents.com)
+- [npm](https://www.npmjs.com/package/computer-agents)
+- [GitHub](https://github.com/computer-agents/computer-agents-sdk)

package/dist/ComputerAgentsClient.d.ts

@@ -31,7 +31,7 @@
  */
 import { ApiClientError } from './cloud/ApiClient';
 import type { ApiClientConfig } from './cloud/ApiClient';
-import { EnvironmentsResource, ThreadsResource, AgentsResource, BudgetResource, BillingResource, SchedulesResource, GitResource, FilesResource } from './cloud/resources';
+import { EnvironmentsResource, ThreadsResource, AgentsResource, BudgetResource, BillingResource, SchedulesResource, TriggersResource, OrchestrationsResource, GitResource, FilesResource } from './cloud/resources';
 import type { HealthCheck, Metrics, Project, Environment, MessageStreamEvent } from './cloud/types';
 export { ApiClientError };
 export type { ApiClientConfig };
@@ -234,6 +234,46 @@ export declare class ComputerAgentsClient {
      * ```
      */
     readonly schedules: SchedulesResource;
+    /**
+     * Event-driven triggers
+     *
+     * Create triggers that fire agents in response to events from
+     * GitHub, Slack, email, webhooks, and more.
+     *
+     * @example
+     * ```typescript
+     * const trigger = await client.triggers.create({
+     *   name: 'On Push to Main',
+     *   environmentId: 'env_xxx',
+     *   source: 'github',
+     *   event: 'push',
+     *   filters: { branch: 'main' },
+     *   action: { type: 'send_message', message: 'Run tests and report results' }
+     * });
+     * ```
+     */
+    readonly triggers: TriggersResource;
+    /**
+     * Agent-to-agent orchestration
+     *
+     * Create multi-agent workflows where agents collaborate in parallel,
+     * sequential, conditional, or map-reduce patterns.
+     *
+     * @example
+     * ```typescript
+     * const orch = await client.orchestrations.create({
+     *   name: 'Code Review Pipeline',
+     *   environmentId: 'env_xxx',
+     *   strategy: 'sequential',
+     *   steps: [
+     *     { agentId: 'agent_lint', name: 'Lint' },
+     *     { agentId: 'agent_test', name: 'Test' },
+     *     { agentId: 'agent_review', name: 'Review' }
+     *   ]
+     * });
+     * ```
+     */
+    readonly orchestrations: OrchestrationsResource;
     /**
      * Budget management
      *

package/dist/ComputerAgentsClient.js

@@ -160,6 +160,46 @@ class ComputerAgentsClient {
      * ```
      */
     schedules;
+    /**
+     * Event-driven triggers
+     *
+     * Create triggers that fire agents in response to events from
+     * GitHub, Slack, email, webhooks, and more.
+     *
+     * @example
+     * ```typescript
+     * const trigger = await client.triggers.create({
+     *   name: 'On Push to Main',
+     *   environmentId: 'env_xxx',
+     *   source: 'github',
+     *   event: 'push',
+     *   filters: { branch: 'main' },
+     *   action: { type: 'send_message', message: 'Run tests and report results' }
+     * });
+     * ```
+     */
+    triggers;
+    /**
+     * Agent-to-agent orchestration
+     *
+     * Create multi-agent workflows where agents collaborate in parallel,
+     * sequential, conditional, or map-reduce patterns.
+     *
+     * @example
+     * ```typescript
+     * const orch = await client.orchestrations.create({
+     *   name: 'Code Review Pipeline',
+     *   environmentId: 'env_xxx',
+     *   strategy: 'sequential',
+     *   steps: [
+     *     { agentId: 'agent_lint', name: 'Lint' },
+     *     { agentId: 'agent_test', name: 'Test' },
+     *     { agentId: 'agent_review', name: 'Review' }
+     *   ]
+     * });
+     * ```
+     */
+    orchestrations;
     /**
      * Budget management
      *
@@ -230,6 +270,8 @@ class ComputerAgentsClient {
         this.agents = new resources_1.AgentsResource(this.api);
         this.files = new resources_1.FilesResource(this.api);
         this.schedules = new resources_1.SchedulesResource(this.api);
+        this.triggers = new resources_1.TriggersResource(this.api);
+        this.orchestrations = new resources_1.OrchestrationsResource(this.api);
         this.budget = new resources_1.BudgetResource(this.api);
         this.billing = new resources_1.BillingResource(this.api);
         this.git = new resources_1.GitResource(this.api);

package/dist/ComputerAgentsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"ComputerAgentsClient.js","sourceRoot":"","sources":["../src/ComputerAgentsClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ComputerAgentsClient.js","sourceRoot":"","sources":["../src/ComputerAgentsClient.ts"],"names":[],"mappings":"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"}

package/dist/cloud/resources/EnvironmentsResource.d.ts

@@ -157,11 +157,11 @@ export declare class EnvironmentsResource {
      */
     getStatus(environmentId: string): Promise<ContainerStatus>;
     /**
-     * Get the Codex configuration for an environment
+     * Get the agent configuration for an environment
      */
     getConfig(environmentId: string): Promise<string>;
     /**
-     * Update the Codex configuration for an environment
+     * Update the agent configuration for an environment
      */
     updateConfig(environmentId: string, config: string): Promise<void>;
 }

package/dist/cloud/resources/EnvironmentsResource.js

@@ -239,14 +239,14 @@ class EnvironmentsResource {
     // Configuration Management
     // =========================================================================
     /**
-     * Get the Codex configuration for an environment
+     * Get the agent configuration for an environment
      */
     async getConfig(environmentId) {
         const response = await this.client.get(`/environments/${environmentId}/config`);
         return response.config;
     }
     /**
-     * Update the Codex configuration for an environment
+     * Update the agent configuration for an environment
      */
     async updateConfig(environmentId, config) {
         await this.client.put(`/environments/${environmentId}/config`, { config });

package/dist/cloud/resources/OrchestrationsResource.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Orchestrations Resource Manager
+ *
+ * Handles agent-to-agent orchestration including CRUD operations,
+ * running orchestrations, and tracking run status.
+ *
+ * Note: projectId is now embedded in the API key, so routes use
+ * simplified paths without /projects/:projectId prefix.
+ */
+import type { ApiClient } from '../ApiClient';
+import type { Orchestration, CreateOrchestrationParams, UpdateOrchestrationParams, OrchestrationRun } from '../types';
+export declare class OrchestrationsResource {
+    private readonly client;
+    constructor(client: ApiClient);
+    /**
+     * Create a new orchestration
+     */
+    create(params: CreateOrchestrationParams): Promise<Orchestration>;
+    /**
+     * List all orchestrations
+     */
+    list(params?: {
+        environmentId?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Orchestration[]>;
+    /**
+     * Get an orchestration by ID
+     */
+    get(orchestrationId: string): Promise<Orchestration>;
+    /**
+     * Update an orchestration
+     */
+    update(orchestrationId: string, params: UpdateOrchestrationParams): Promise<Orchestration>;
+    /**
+     * Delete an orchestration
+     */
+    delete(orchestrationId: string): Promise<void>;
+    /**
+     * Execute an orchestration
+     */
+    run(orchestrationId: string, options?: {
+        inputs?: Record<string, unknown>;
+    }): Promise<OrchestrationRun>;
+    /**
+     * Get a specific run
+     */
+    getRun(orchestrationId: string, runId: string): Promise<OrchestrationRun>;
+    /**
+     * List all runs for an orchestration
+     */
+    listRuns(orchestrationId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<OrchestrationRun[]>;
+}

package/dist/cloud/resources/OrchestrationsResource.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Orchestrations Resource Manager
+ *
+ * Handles agent-to-agent orchestration including CRUD operations,
+ * running orchestrations, and tracking run status.
+ *
+ * Note: projectId is now embedded in the API key, so routes use
+ * simplified paths without /projects/:projectId prefix.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrchestrationsResource = void 0;
+class OrchestrationsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new orchestration
+     */
+    async create(params) {
+        const response = await this.client.post(`/orchestrations`, params);
+        return response.orchestration;
+    }
+    /**
+     * List all orchestrations
+     */
+    async list(params) {
+        const response = await this.client.get(`/orchestrations`, params);
+        return response.data;
+    }
+    /**
+     * Get an orchestration by ID
+     */
+    async get(orchestrationId) {
+        const response = await this.client.get(`/orchestrations/${orchestrationId}`);
+        return response.orchestration;
+    }
+    /**
+     * Update an orchestration
+     */
+    async update(orchestrationId, params) {
+        const response = await this.client.patch(`/orchestrations/${orchestrationId}`, params);
+        return response.orchestration;
+    }
+    /**
+     * Delete an orchestration
+     */
+    async delete(orchestrationId) {
+        await this.client.delete(`/orchestrations/${orchestrationId}`);
+    }
+    // =========================================================================
+    // Orchestration Runs
+    // =========================================================================
+    /**
+     * Execute an orchestration
+     */
+    async run(orchestrationId, options) {
+        const response = await this.client.post(`/orchestrations/${orchestrationId}/runs`, options);
+        return response.run;
+    }
+    /**
+     * Get a specific run
+     */
+    async getRun(orchestrationId, runId) {
+        const response = await this.client.get(`/orchestrations/${orchestrationId}/runs/${runId}`);
+        return response.run;
+    }
+    /**
+     * List all runs for an orchestration
+     */
+    async listRuns(orchestrationId, params) {
+        const response = await this.client.get(`/orchestrations/${orchestrationId}/runs`, params);
+        return response.data;
+    }
+}
+exports.OrchestrationsResource = OrchestrationsResource;
+//# sourceMappingURL=OrchestrationsResource.js.map

package/dist/cloud/resources/OrchestrationsResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrchestrationsResource.js","sourceRoot":"","sources":["../../../src/cloud/resources/OrchestrationsResource.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAUH,MAAa,sBAAsB;IACJ;IAA7B,YAA6B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAElD;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAAiC;QAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACrC,iBAAiB,EACjB,MAAM,CACP,CAAC;QACF,OAAO,QAAQ,CAAC,aAAa,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CACR,MAAoE;QAEpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAKnC,iBAAiB,EAAE,MAAM,CAAC,CAAC;QAC9B,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,eAAuB;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,mBAAmB,eAAe,EAAE,CACrC,CAAC;QACF,OAAO,QAAQ,CAAC,aAAa,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,eAAuB,EACvB,MAAiC;QAEjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CACtC,mBAAmB,eAAe,EAAE,EACpC,MAAM,CACP,CAAC;QACF,OAAO,QAAQ,CAAC,aAAa,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,eAAuB;QAClC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,eAAe,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,4EAA4E;IAC5E,qBAAqB;IACrB,4EAA4E;IAE5E;;OAEG;IACH,KAAK,CAAC,GAAG,CACP,eAAuB,EACvB,OAA8C;QAE9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACrC,mBAAmB,eAAe,OAAO,EACzC,OAAO,CACR,CAAC;QACF,OAAO,QAAQ,CAAC,GAAG,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,eAAuB,EACvB,KAAa;QAEb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,mBAAmB,eAAe,SAAS,KAAK,EAAE,CACnD,CAAC;QACF,OAAO,QAAQ,CAAC,GAAG,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,eAAuB,EACvB,MAA4C;QAE5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAKnC,mBAAmB,eAAe,OAAO,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF;AA1GD,wDA0GC"}

package/dist/cloud/resources/TriggersResource.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Triggers Resource Manager
+ *
+ * Handles event-driven trigger management including CRUD operations,
+ * enable/disable control, testing, and execution history.
+ *
+ * Note: projectId is now embedded in the API key, so routes use
+ * simplified paths without /projects/:projectId prefix.
+ */
+import type { ApiClient } from '../ApiClient';
+import type { Trigger, CreateTriggerParams, UpdateTriggerParams, TriggerExecution } from '../types';
+export declare class TriggersResource {
+    private readonly client;
+    constructor(client: ApiClient);
+    /**
+     * Create a new trigger
+     */
+    create(params: CreateTriggerParams): Promise<Trigger>;
+    /**
+     * List all triggers
+     */
+    list(params?: {
+        environmentId?: string;
+        enabled?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<Trigger[]>;
+    /**
+     * Get a trigger by ID
+     */
+    get(triggerId: string): Promise<Trigger>;
+    /**
+     * Update a trigger
+     */
+    update(triggerId: string, params: UpdateTriggerParams): Promise<Trigger>;
+    /**
+     * Delete a trigger
+     */
+    delete(triggerId: string): Promise<void>;
+    /**
+     * Enable a trigger
+     */
+    enable(triggerId: string): Promise<Trigger>;
+    /**
+     * Disable a trigger
+     */
+    disable(triggerId: string): Promise<Trigger>;
+    /**
+     * Test-fire a trigger with an optional payload
+     */
+    test(triggerId: string, payload?: Record<string, unknown>): Promise<TriggerExecution>;
+    /**
+     * List past executions for a trigger
+     */
+    listExecutions(triggerId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<TriggerExecution[]>;
+}

package/dist/cloud/resources/TriggersResource.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Triggers Resource Manager
+ *
+ * Handles event-driven trigger management including CRUD operations,
+ * enable/disable control, testing, and execution history.
+ *
+ * Note: projectId is now embedded in the API key, so routes use
+ * simplified paths without /projects/:projectId prefix.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TriggersResource = void 0;
+class TriggersResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new trigger
+     */
+    async create(params) {
+        const response = await this.client.post(`/triggers`, params);
+        return response.trigger;
+    }
+    /**
+     * List all triggers
+     */
+    async list(params) {
+        const response = await this.client.get(`/triggers`, params);
+        return response.data;
+    }
+    /**
+     * Get a trigger by ID
+     */
+    async get(triggerId) {
+        const response = await this.client.get(`/triggers/${triggerId}`);
+        return response.trigger;
+    }
+    /**
+     * Update a trigger
+     */
+    async update(triggerId, params) {
+        const response = await this.client.patch(`/triggers/${triggerId}`, params);
+        return response.trigger;
+    }
+    /**
+     * Delete a trigger
+     */
+    async delete(triggerId) {
+        await this.client.delete(`/triggers/${triggerId}`);
+    }
+    // =========================================================================
+    // Trigger Control
+    // =========================================================================
+    /**
+     * Enable a trigger
+     */
+    async enable(triggerId) {
+        const response = await this.client.patch(`/triggers/${triggerId}/enable`);
+        return response.trigger;
+    }
+    /**
+     * Disable a trigger
+     */
+    async disable(triggerId) {
+        const response = await this.client.patch(`/triggers/${triggerId}/disable`);
+        return response.trigger;
+    }
+    /**
+     * Test-fire a trigger with an optional payload
+     */
+    async test(triggerId, payload) {
+        const response = await this.client.post(`/triggers/${triggerId}/test`, payload ? { payload } : undefined);
+        return response.execution;
+    }
+    // =========================================================================
+    // Execution History
+    // =========================================================================
+    /**
+     * List past executions for a trigger
+     */
+    async listExecutions(triggerId, params) {
+        const response = await this.client.get(`/triggers/${triggerId}/executions`, params);
+        return response.data;
+    }
+}
+exports.TriggersResource = TriggersResource;
+//# sourceMappingURL=TriggersResource.js.map

package/dist/cloud/resources/TriggersResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriggersResource.js","sourceRoot":"","sources":["../../../src/cloud/resources/TriggersResource.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAUH,MAAa,gBAAgB;IACE;IAA7B,YAA6B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAElD;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAA2B;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACrC,WAAW,EACX,MAAM,CACP,CAAC;QACF,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CACR,MAAuF;QAEvF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAKnC,WAAW,EAAE,MAAM,CAAC,CAAC;QACxB,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,aAAa,SAAS,EAAE,CACzB,CAAC;QACF,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,MAA2B;QAE3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CACtC,aAAa,SAAS,EAAE,EACxB,MAAM,CACP,CAAC;QACF,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CACtC,aAAa,SAAS,SAAS,CAChC,CAAC;QACF,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CACtC,aAAa,SAAS,UAAU,CACjC,CAAC;QACF,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,OAAiC;QAC7D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACrC,aAAa,SAAS,OAAO,EAC7B,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAClC,CAAC;QACF,OAAO,QAAQ,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED,4EAA4E;IAC5E,oBAAoB;IACpB,4EAA4E;IAE5E;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,SAAiB,EACjB,MAA4C;QAE5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAKnC,aAAa,SAAS,aAAa,EAAE,MAAM,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF;AAlHD,4CAkHC"}

package/dist/cloud/resources/index.d.ts

@@ -12,6 +12,8 @@ export { RunsResource } from './RunsResource';
 export { AgentsResource } from './AgentsResource';
 export { BudgetResource, BillingResource } from './BudgetResource';
 export { SchedulesResource } from './SchedulesResource';
+export { TriggersResource } from './TriggersResource';
+export { OrchestrationsResource } from './OrchestrationsResource';
 export { GitResource } from './GitResource';
 export { FilesResource } from './FilesResource';
 export type { EnvironmentFile, ListFilesResult, UploadFileParams, UploadFileResult, MoveFileParams, MoveFileResult, DeleteFileResult, CreateDirectoryResult, } from './FilesResource';

package/dist/cloud/resources/index.js

@@ -5,7 +5,7 @@
  * Export all resource managers for use in CloudClient.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FilesResource = exports.GitResource = exports.SchedulesResource = exports.BillingResource = exports.BudgetResource = exports.AgentsResource = exports.RunsResource = exports.ThreadsResource = exports.EnvironmentsResource = exports.ProjectsResource = void 0;
+exports.FilesResource = exports.GitResource = exports.OrchestrationsResource = exports.TriggersResource = exports.SchedulesResource = exports.BillingResource = exports.BudgetResource = exports.AgentsResource = exports.RunsResource = exports.ThreadsResource = exports.EnvironmentsResource = exports.ProjectsResource = void 0;
 var ProjectsResource_1 = require("./ProjectsResource");
 Object.defineProperty(exports, "ProjectsResource", { enumerable: true, get: function () { return ProjectsResource_1.ProjectsResource; } });
 var EnvironmentsResource_1 = require("./EnvironmentsResource");
@@ -21,6 +21,10 @@ Object.defineProperty(exports, "BudgetResource", { enumerable: true, get: functi
 Object.defineProperty(exports, "BillingResource", { enumerable: true, get: function () { return BudgetResource_1.BillingResource; } });
 var SchedulesResource_1 = require("./SchedulesResource");
 Object.defineProperty(exports, "SchedulesResource", { enumerable: true, get: function () { return SchedulesResource_1.SchedulesResource; } });
+var TriggersResource_1 = require("./TriggersResource");
+Object.defineProperty(exports, "TriggersResource", { enumerable: true, get: function () { return TriggersResource_1.TriggersResource; } });
+var OrchestrationsResource_1 = require("./OrchestrationsResource");
+Object.defineProperty(exports, "OrchestrationsResource", { enumerable: true, get: function () { return OrchestrationsResource_1.OrchestrationsResource; } });
 var GitResource_1 = require("./GitResource");
 Object.defineProperty(exports, "GitResource", { enumerable: true, get: function () { return GitResource_1.GitResource; } });
 var FilesResource_1 = require("./FilesResource");

package/dist/cloud/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cloud/resources/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAE7B,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AAExB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,mDAAmE;AAA1D,gHAAA,cAAc,OAAA;AAAE,iHAAA,eAAe,OAAA;AACxC,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cloud/resources/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAE7B,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AAExB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,mDAAmE;AAA1D,gHAAA,cAAc,OAAA;AAAE,iHAAA,eAAe,OAAA;AACxC,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA"}

package/dist/cloud/types.d.ts

@@ -698,6 +698,103 @@ export interface UpdateScheduleParams {
     enabled?: boolean;
     metadata?: Record<string, unknown>;
 }
+export type TriggerSource = 'github' | 'slack' | 'email' | 'webhook' | 'cron' | 'custom';
+export interface TriggerAction {
+    type: 'send_message';
+    message?: string;
+    template?: string;
+}
+export interface Trigger {
+    id: string;
+    name: string;
+    environmentId: string;
+    agentId?: string;
+    source: TriggerSource;
+    event: string;
+    filters?: Record<string, unknown>;
+    action: TriggerAction;
+    enabled: boolean;
+    lastTriggeredAt?: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface CreateTriggerParams {
+    name: string;
+    environmentId: string;
+    agentId?: string;
+    source: TriggerSource;
+    event: string;
+    filters?: Record<string, unknown>;
+    action: TriggerAction;
+    enabled?: boolean;
+}
+export interface UpdateTriggerParams {
+    name?: string;
+    agentId?: string;
+    event?: string;
+    filters?: Record<string, unknown>;
+    action?: TriggerAction;
+    enabled?: boolean;
+}
+export interface TriggerExecution {
+    id: string;
+    triggerId: string;
+    threadId: string;
+    event: Record<string, unknown>;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    createdAt: number;
+}
+export type OrchestrationStrategy = 'parallel' | 'sequential' | 'conditional' | 'map_reduce';
+export interface OrchestrationStep {
+    id: string;
+    agentId: string;
+    name: string;
+    instructions?: string;
+    inputs?: Record<string, unknown>;
+    dependsOn?: string[];
+    condition?: string;
+}
+export interface Orchestration {
+    id: string;
+    name: string;
+    environmentId: string;
+    strategy: OrchestrationStrategy;
+    coordinatorAgentId?: string;
+    steps: OrchestrationStep[];
+    status: 'draft' | 'active' | 'archived';
+    createdAt: number;
+    updatedAt: number;
+}
+export interface CreateOrchestrationParams {
+    name: string;
+    environmentId: string;
+    strategy: OrchestrationStrategy;
+    coordinatorAgentId?: string;
+    steps: Omit<OrchestrationStep, 'id'>[];
+}
+export interface UpdateOrchestrationParams {
+    name?: string;
+    strategy?: OrchestrationStrategy;
+    coordinatorAgentId?: string;
+    steps?: Omit<OrchestrationStep, 'id'>[];
+}
+export interface OrchestrationStepResult {
+    stepId: string;
+    agentId: string;
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+    output?: string;
+    error?: string;
+    durationMs?: number;
+}
+export interface OrchestrationRun {
+    id: string;
+    orchestrationId: string;
+    threadId: string;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    stepResults: OrchestrationStepResult[];
+    createdAt: number;
+    completedAt?: number;
+}
 export interface HealthCheck {
     status: 'healthy' | 'unhealthy';
     timestamp: string;

package/dist/index.d.ts

@@ -22,7 +22,7 @@
  */
 export { ComputerAgentsClient, CloudClient, TestbaseClient, ApiClientError, } from './ComputerAgentsClient';
 export type { ComputerAgentsClientConfig, RunOptions, RunResult, ApiClientConfig, } from './ComputerAgentsClient';
-export { ProjectsResource, EnvironmentsResource, ThreadsResource, RunsResource, AgentsResource, BudgetResource, BillingResource, SchedulesResource, GitResource, } from './cloud/resources';
+export { ProjectsResource, EnvironmentsResource, ThreadsResource, RunsResource, AgentsResource, BudgetResource, BillingResource, SchedulesResource, TriggersResource, OrchestrationsResource, GitResource, } from './cloud/resources';
 export type { StreamEventCallback, SendMessageOptions, SendMessageResult, ListEnvironmentsParams, } from './cloud/resources';
-export type { PaginationParams, PaginatedResponse, ApiError, Project, CreateProjectParams, UpdateProjectParams, ProjectStats, ProjectType, ProjectSource, Environment, CreateEnvironmentParams, UpdateEnvironmentParams, EnvironmentStatus, EnvironmentVariable, McpServer, ContainerStatus, BuildResult, BuildStatus, BuildStatusResult, BuildLogsResult, TestBuildResult, DockerfileResult, ValidateDockerfileResult, RuntimeConfig, PackagesConfig, AvailableRuntimes, PackageType, InstallPackagesResult, StartContainerParams, StartContainerResult, Thread, CreateThreadParams, UpdateThreadParams, ListThreadsParams, SendMessageParams, ThreadMessage, ThreadStatus, AgentConfig, CopyThreadParams, SearchThreadsParams, SearchThreadResult, SearchThreadsResponse, ThreadLogEntry, ResearchSession, StreamEvent, MessageStreamEvent, ResponseStartedEvent, ResponseItemCompletedEvent, ResponseCompletedEvent, StreamCompletedEvent, StreamErrorEvent, Run, CreateRunParams, UpdateRunParams, ListRunsParams, RunStatus, RunLogEntry, RunDiff, TokenUsage, CloudAgent, CreateAgentParams, UpdateAgentParams, AgentModel, ReasoningEffort, DeepResearchModel, AgentBinary, BudgetStatus, CanExecuteResult, IncreaseBudgetParams, IncreaseBudgetResult, BillingRecord, ListBillingRecordsParams, BillingAccount, UsageStats, UsageStatsParams, FileEntry, ListFilesParams, UploadFileParams, CreateDirectoryParams, GitDiffFile, GitDiffResult, GitCommitParams, GitCommitResult, GitPushParams, GitPushResult, Schedule, CreateScheduleParams, UpdateScheduleParams, ScheduleType, HealthCheck, Metrics, } from './cloud/types';
+export type { PaginationParams, PaginatedResponse, ApiError, Project, CreateProjectParams, UpdateProjectParams, ProjectStats, ProjectType, ProjectSource, Environment, CreateEnvironmentParams, UpdateEnvironmentParams, EnvironmentStatus, EnvironmentVariable, McpServer, ContainerStatus, BuildResult, BuildStatus, BuildStatusResult, BuildLogsResult, TestBuildResult, DockerfileResult, ValidateDockerfileResult, RuntimeConfig, PackagesConfig, AvailableRuntimes, PackageType, InstallPackagesResult, StartContainerParams, StartContainerResult, Thread, CreateThreadParams, UpdateThreadParams, ListThreadsParams, SendMessageParams, ThreadMessage, ThreadStatus, AgentConfig, CopyThreadParams, SearchThreadsParams, SearchThreadResult, SearchThreadsResponse, ThreadLogEntry, ResearchSession, StreamEvent, MessageStreamEvent, ResponseStartedEvent, ResponseItemCompletedEvent, ResponseCompletedEvent, StreamCompletedEvent, StreamErrorEvent, Run, CreateRunParams, UpdateRunParams, ListRunsParams, RunStatus, RunLogEntry, RunDiff, TokenUsage, CloudAgent, CreateAgentParams, UpdateAgentParams, AgentModel, ReasoningEffort, DeepResearchModel, AgentBinary, BudgetStatus, CanExecuteResult, IncreaseBudgetParams, IncreaseBudgetResult, BillingRecord, ListBillingRecordsParams, BillingAccount, UsageStats, UsageStatsParams, FileEntry, ListFilesParams, UploadFileParams, CreateDirectoryParams, GitDiffFile, GitDiffResult, GitCommitParams, GitCommitResult, GitPushParams, GitPushResult, Schedule, CreateScheduleParams, UpdateScheduleParams, ScheduleType, TriggerSource, Trigger, TriggerAction, CreateTriggerParams, UpdateTriggerParams, TriggerExecution, OrchestrationStrategy, OrchestrationStep, Orchestration, CreateOrchestrationParams, UpdateOrchestrationParams, OrchestrationRun, OrchestrationStepResult, HealthCheck, Metrics, } from './cloud/types';
 export { ApiClient } from './cloud/ApiClient';

package/dist/index.js

@@ -22,7 +22,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApiClient = exports.GitResource = exports.SchedulesResource = exports.BillingResource = exports.BudgetResource = exports.AgentsResource = exports.RunsResource = exports.ThreadsResource = exports.EnvironmentsResource = exports.ProjectsResource = exports.ApiClientError = exports.TestbaseClient = exports.CloudClient = exports.ComputerAgentsClient = void 0;
+exports.ApiClient = exports.GitResource = exports.OrchestrationsResource = exports.TriggersResource = exports.SchedulesResource = exports.BillingResource = exports.BudgetResource = exports.AgentsResource = exports.RunsResource = exports.ThreadsResource = exports.EnvironmentsResource = exports.ProjectsResource = exports.ApiClientError = exports.TestbaseClient = exports.CloudClient = exports.ComputerAgentsClient = void 0;
 // ============================================================================
 // Main Client
 // ============================================================================
@@ -45,6 +45,8 @@ Object.defineProperty(exports, "AgentsResource", { enumerable: true, get: functi
 Object.defineProperty(exports, "BudgetResource", { enumerable: true, get: function () { return resources_1.BudgetResource; } });
 Object.defineProperty(exports, "BillingResource", { enumerable: true, get: function () { return resources_1.BillingResource; } });
 Object.defineProperty(exports, "SchedulesResource", { enumerable: true, get: function () { return resources_1.SchedulesResource; } });
+Object.defineProperty(exports, "TriggersResource", { enumerable: true, get: function () { return resources_1.TriggersResource; } });
+Object.defineProperty(exports, "OrchestrationsResource", { enumerable: true, get: function () { return resources_1.OrchestrationsResource; } });
 Object.defineProperty(exports, "GitResource", { enumerable: true, get: function () { return resources_1.GitResource; } });
 // ============================================================================
 // Low-level API Client (for advanced usage)

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,+DAOgC;AAN9B,4HAAA,oBAAoB,OAAA;AACpB,kCAAkC;AAClC,mHAAA,WAAW,OAAA;AACX,sHAAA,cAAc,OAAA;AACd,cAAc;AACd,sHAAA,cAAc,OAAA;AAUhB,+EAA+E;AAC/E,yCAAyC;AACzC,+EAA+E;AAE/E,+CAU2B;AATzB,6GAAA,gBAAgB,OAAA;AAChB,iHAAA,oBAAoB,OAAA;AACpB,4GAAA,eAAe,OAAA;AACf,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,4GAAA,eAAe,OAAA;AACf,8GAAA,iBAAiB,OAAA;AACjB,wGAAA,WAAW,OAAA;AAmIb,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E,+CAA8C;AAArC,sGAAA,SAAS,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,+DAOgC;AAN9B,4HAAA,oBAAoB,OAAA;AACpB,kCAAkC;AAClC,mHAAA,WAAW,OAAA;AACX,sHAAA,cAAc,OAAA;AACd,cAAc;AACd,sHAAA,cAAc,OAAA;AAUhB,+EAA+E;AAC/E,yCAAyC;AACzC,+EAA+E;AAE/E,+CAY2B;AAXzB,6GAAA,gBAAgB,OAAA;AAChB,iHAAA,oBAAoB,OAAA;AACpB,4GAAA,eAAe,OAAA;AACf,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,4GAAA,eAAe,OAAA;AACf,8GAAA,iBAAiB,OAAA;AACjB,6GAAA,gBAAgB,OAAA;AAChB,mHAAA,sBAAsB,OAAA;AACtB,wGAAA,WAAW,OAAA;AAoJb,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E,+CAA8C;AAArC,sGAAA,SAAS,OAAA"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "computer-agents",
-  "repository": "https://github.com/TestBase-ai/computer-agents",
+  "repository": "https://github.com/computer-agents/computer-agents-sdk",
   "homepage": "https://computer-agents.com",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "Official SDK for the Computer Agents Cloud API. Execute Claude-powered AI agents in isolated cloud containers.",
   "author": "Computer Agents",
   "main": "dist/index.js",