SDK Reference

@aeontel/sdk — official TypeScript client for the Aeontel API.

@aeontel/sdk is the official TypeScript client for the Aeontel API. Every HTTP endpoint is reachable through a resource accessor on the client (client.agents, client.workflows, client.files, …), and every method returns typed results.

Quick start

import Aeontel from "@aeontel/sdk";

const client = new Aeontel("sec_...");

// List agents in a workspace
const page = await client.agents.list({ workspace_id: "wsp_..." });
for (const agent of page.data) {
  console.log(agent.id, agent.name);
}

// Create an agent
const agent = await client.agents.create({
  workspaceId: "wsp_...",
  name: "Support triage",
  model: "anthropic/claude-sonnet-4-5",
});

// Start a run
const run = await client.runs.create({
  workspaceId: "wsp_...",
  agentId: agent.id,
  input: { messages: [{ role: "user", content: "Hello" }] },
});

What's inside

• Installation — install the package and construct a client.
• Authentication — secret keys, publishable keys, session tokens, cookie auth, and service bindings.
• Pagination — the Page class, manual paging, and for await auto-pagination.
• File uploads — the multipart upload lifecycle and runUpload orchestrator.
• Streaming & events — chat streaming and the workspace event stream via SSE/WebSocket.
• Errors — the typed error hierarchy you can catch and inspect.
• Resources — one page per SDK resource, generated from source.