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
	}
);

async () => {
	const res = await platform.request({
		method: 'GET',
		path: '/v1/repository_change_requests',
		query: { state: 'READY' },
		headers: { 'Akua-Context': 'ws_123' }
	});

	return res.body.data.map((change) => ({
		id: change.id,
		parent_repository_id: change.parent_repository_id,
		state: change.state
	}));
}

{
  "method": "session/prompt",
  "params": {
    "message": "Investigate the failed install and ask before accepting any change."
  }
}