Agents API

const agent = await client.agents.create({
	name: 'Production deploy triage',
	capabilities: ['CHAT', 'CODING', 'AMBIENT']
});

const templates = await client.agentTemplates.list();
const failedInstallTriage = templates.data.find(
	(template) => template.id === 'agtpl_failedinstalltriage01'
);

const session = await client.agentSessions.create({
	agent_id: agent.id
});

const turn = await client.agentTurns.create(
	{
		session_id: session.id,
		message:
			'Investigate the failed production install and draft a repository change request if needed.'
	},
	{ idempotencyKey: 'turn-2026-05-13-prod-failure' }
);

for await (const event of client.agentEvents.stream({ turn: turn.id })) {
	if (event.type === 'widget.created') {
		renderAgentWidget(event.data.widget_type, event.data);
		continue;
	}

	console.log(event.type, event.data);
}

const approvals = await client.approvalRequests.list({
	state: 'PENDING',
	agent: agent.id
});

await client.approvalRequests.resolve(
	approvals.data[0].id,
	{ decision: 'APPROVE' },
	{
		idempotencyKey: 'approve-prod-fix-001',
		ifMatch: approvals.data[0].etag
	}
);