API Resources

import { ComputerAgentsClient } from 'computer-agents';
 
const client = new ComputerAgentsClient({
  apiKey: process.env.COMPUTER_AGENTS_API_KEY
});
 
// Access resources
client.threads       // Thread management
client.environments  // Environment management
client.agents        // Agent configuration
client.files         // File operations
client.schedules     // Scheduled tasks
client.budget        // Budget status
client.billing       // Usage records
client.git           // Git operations

const thread = await client.threads.create({
  environmentId: 'env_xxx'
});
 
console.log(thread.id);  // 'thread_abc123'

const result = await client.threads.sendMessage(thread.id, {
  content: 'Create a Python calculator',
  onEvent: (event) => {
    console.log(event.type);
  }
});
 
console.log(result.content);  // Agent response
console.log(result.run);      // Run details (tokens, status)

const { data: threads } = await client.threads.list();
 
threads.forEach(t => {
  console.log(`${t.id}: ${t.messageCount} messages`);
});

const thread = await client.threads.get('thread_xxx');
console.log(thread.status);  // 'active' | 'completed' | 'cancelled'

const { data: messages } = await client.threads.getMessages('thread_xxx');
 
messages.forEach(m => {
  console.log(`[${m.role}]: ${m.content}`);
});

await client.threads.delete('thread_xxx');

const environments = await client.environments.list();
 
environments.forEach(env => {
  console.log(`${env.name} (${env.id}) - ${env.isDefault ? 'default' : ''}`);
});

const env = await client.environments.create({
  name: 'my-project',
  description: 'Project workspace',
  internetAccess: true,
  isDefault: false,
  environmentVariables: [
    { key: 'NODE_ENV', value: 'development' }
  ],
  secrets: [
    { key: 'API_KEY', value: 'secret-value' }
  ]
});

const env = await client.environments.get('env_xxx');
console.log(env.name, env.internetAccess);

const updated = await client.environments.update('env_xxx', {
  name: 'renamed-project',
  internetAccess: false
});

await client.environments.delete('env_xxx');

const files = await client.files.listFiles('env_xxx');
 
files.forEach(f => {
  const icon = f.type === 'directory' ? '📁' : '📄';
  console.log(`${icon} ${f.path} ${f.size ? `(${f.size} bytes)` : ''}`);
});

const result = await client.files.uploadFile({
  environmentId: 'env_xxx',
  filename: 'app.py',
  path: 'src',  // Optional subdirectory
  content: 'print("Hello, World!")'
});
 
console.log(`Uploaded: ${result.path}`);

// As string
const content = await client.files.getFile('env_xxx', 'src/app.py');
console.log(content);
 
// As Buffer (for binary files)
const buffer = await client.files.downloadFile('env_xxx', 'image.png');

await client.files.moveFile({
  environmentId: 'env_xxx',
  sourcePath: 'old-name.py',
  destPath: 'new-name.py'
});

await client.files.deleteFile('env_xxx', 'src/app.py');

const agents = await client.agents.list();
 
agents.forEach(agent => {
  console.log(`${agent.name} (${agent.model})`);
});

const agent = await client.agents.create({
  name: 'Code Assistant',
  model: 'gpt-4o',
  instructions: 'You are a helpful coding assistant. Write clean, tested code.',
  reasoningEffort: 'medium'
});

const agent = await client.agents.get('agent_xxx');
console.log(agent.instructions);

const updated = await client.agents.update('agent_xxx', {
  instructions: 'Updated instructions for the agent.',
  model: 'gpt-4o-mini'
});

await client.agents.delete('agent_xxx');

const schedules = await client.schedules.list();
 
schedules.forEach(s => {
  console.log(`${s.name}: ${s.cronExpression} (${s.enabled ? 'enabled' : 'disabled'})`);
});

const schedule = await client.schedules.create({
  name: 'Daily Report',
  agentId: 'agent_xxx',
  agentName: 'Reporter',
  task: 'Generate a daily status report and save to reports/',
  scheduleType: 'recurring',
  cronExpression: '0 9 * * *',  // Daily at 9 AM
  timezone: 'America/New_York',
  enabled: true
});

await client.schedules.update('schedule_xxx', {
  enabled: false  // Pause the schedule
});

await client.schedules.delete('schedule_xxx');

const status = await client.budget.getStatus();
 
console.log(`Balance: $${(status.balance / 100).toFixed(2)}`);
console.log(`Spent: $${(status.spent / 100).toFixed(2)}`);
console.log(`Remaining: $${(status.remaining / 100).toFixed(2)}`);

const { canExecute, reason } = await client.budget.canExecute();
 
if (!canExecute) {
  console.error('Cannot execute:', reason);
}

const { records } = await client.budget.getRecords({ limit: 10 });
 
records.forEach(r => {
  console.log(`${r.type}: $${(r.amount / 100).toFixed(2)} - ${r.description}`);
});

const stats = await client.billing.getStats({ period: 'month' });
 
console.log(`Total cost: $${(stats.totalCost / 100).toFixed(2)}`);
console.log(`Total tokens: ${stats.totalTokens}`);
console.log(`Total runs: ${stats.totalRuns}`);

const diff = await client.git.diff('env_xxx');
 
diff.diffs.forEach(d => {
  console.log(`${d.path}: +${d.additions} -${d.deletions}`);
});

const result = await client.git.commit('env_xxx', {
  message: 'Add user authentication feature',
  author: {
    name: 'AI Agent',
    email: 'agent@computer-agents.com'
  }
});
 
console.log(`Committed: ${result.commit.sha}`);

const result = await client.git.push('env_xxx', {
  remote: 'origin',
  branch: 'main'
});
 
console.log(`Pushed ${result.push.commits} commits`);

const health = await client.health();
 
console.log(`Status: ${health.status}`);
console.log(`Uptime: ${health.uptime}s`);

const metrics = await client.metrics();
 
console.log(`Total executions: ${metrics.totalExecutions}`);
console.log(`Success rate: ${(metrics.successfulExecutions / metrics.totalExecutions * 100).toFixed(1)}%`);