Agents API

const { executionId, sessionId } = await client.agents.execute('agent-uuid', {
  task: 'Analyze these metrics',
  context: { quarter: 'Q4' },         // optional context
  attachmentIds: ['uuid-1', 'uuid-2'], // optional files
  teamUuid: 'team-uuid',              // optional team mode
});

const result = await client.agents.executeSync('agent-uuid', {
  task: 'Summarize this data',
});

console.log(result.output);
console.log(result.status);      // 'completed' | 'failed'
console.log(result.toolResults); // tool call results

const stream = await client.agents.stream('agent-uuid', {
  task: 'Generate a report',
});

stream.on('textDelta', ({ delta }) => process.stdout.write(delta));
stream.on('toolCall', ({ name, input }) => console.log(`Tool: ${name}`));
stream.on('complete', ({ execution }) => console.log('Done:', execution.output));
stream.on('error', (err) => console.error(err));

await stream.connect();

const execution = await client.agents.getExecution(executionId);
// { id, status, output, toolResults, sessionId, startedAt, completedAt }

await client.agents.cancelExecution(executionId);

const { data: agents } = await client.agents.list();

agents.forEach(agent => {
  console.log(`${agent.name} (${agent.type}): ${agent.description}`);
});