Agent Lifecycle

┌─────────┐    ┌───────────┐    ┌─────────┐    ┌────────┐
│  init   │───►│ connecting│───►│  ready  │◄──►│  busy  │
└─────────┘    └───────────┘    └────┬────┘    └───┬────┘
                                     │             │
                                ┌────┴────┐   ┌────┴────┐
                                │  error  │◄──┤suspended│
                                └────┬────┘   └─────────┘
                                     │
                                ┌────┴────┐
                                │ disposed│
                                └─────────┘

import { AllternitClient } from '@allternit/sdk';

const client = new AllternitClient({
  apiKey: process.env.ALLTERNIT_API_KEY,
});

const agent = await client.agents.create({
  name: 'code-reviewer',
  runtime: 'gizzi-pro',
  skills: ['code', 'web_search'],
});

const run = await client.agents.run(agent.id, {
  input: 'Review this pull request for security issues',
  context: { repo: 'my-org/my-repo', pr: 42 },
});

// Stream events
for await (const event of run.events()) {
  if (event.type === 'message') console.log(event.data);
  if (event.type === 'tool_use') console.log('Tool:', event.tool);
}

await client.agents.approve(run.id, { approved: true });
// or
await client.agents.approve(run.id, { approved: false, reason: 'Too risky' });

await client.agents.stop(agent.id);

run.events().on('error', (event) => {
  console.error('Agent error:', event.code, event.message);
  // Codes: RATE_LIMITED, MODEL_ERROR, TOOL_ERROR, TIMEOUT, INTERNAL
});