WebSocket SDK

1
import { AtomsAgent } from "@smallest-ai/agent-sdk";
2
3
const agent = new AtomsAgent({
4
  apiKey:  "sk_...",   // Smallest API key
5
  agentId: "...",      // Agent ID
6
});
7
8
agent.on("session_started", (e) => {
9
  console.log("Session started:", e.session_id, e.call_id);
10
});
11
agent.on("agent_start_talking", () => console.log("Agent speaking"));
12
agent.on("agent_stop_talking",  () => console.log("Agent stopped"));
13
agent.on("error",               (e) => console.error(`[${e.code}] ${e.message}`));
14
15
await agent.connect();
16
// Microphone capture starts automatically. Speak, and the agent replies
17
// through the default audio output. Call agent.disconnect() when done.

1
interface AtomsAgentConfig {
2
  apiKey:          string;    // Required. Smallest API key.
3
  agentId:         string;    // Required. Agent to connect to.
4
  baseUrl?:        string;    // Default: wss://api.smallest.ai. Override for local dev.
5
  sampleRate?:     number;    // Default: 24000. Audio sample rate in Hz.
6
  autoCaptureMic?: boolean;   // Default: true. If false, no microphone is captured and mute()/unmute() are no-ops. See the Push-to-talk pattern below for the correct way to start muted.
7
}

1
const agent = new AtomsAgent({
2
  apiKey:  "sk_...",
3
  agentId: "...",
4
});
5
6
await agent.connect();
7
agent.mute();  // silence the mic right after connect
8
9
talkButton.addEventListener("pointerdown", () => agent.unmute());
10
talkButton.addEventListener("pointerup",   () => agent.mute());

1
agent.on("agent_start_talking", () => setSpeaking(true));
2
agent.on("agent_stop_talking",  () => setSpeaking(false));

1
window.addEventListener("beforeunload", () => {
2
  if (agent.isConnected) agent.disconnect();
3
});

1
await agent.connect();
2
sendButton.addEventListener("click", () => {
3
  agent.sendText(inputEl.value);
4
});

1
try {
2
  await agent.connect();
3
} catch (err) {
4
  console.error("connect failed:", err.message);
5
  // Likely causes: invalid API key, unknown agent ID, microphone denied, network blocked.
6
}

1
agent.on("error", (e) => {
2
  console.error(`[${e.code}] ${e.message}`);
3
});

1
agent.on("session_ended", (e) => {
2
  // e.reason is a server string (e.g. "client_requested") or a numeric
3
  // WebSocket close code as a string (e.g. "1006" for abnormal closure).
4
  console.log("session ended:", e.reason);
5
});