Quickstart

import { CallServer, type CallSession } from "@komaa/standin-sdk";

class MyHandler {
  #call: CallSession | undefined;

  async onStart(session: CallSession) {
    this.#call = session;
    // Join a room, open a realtime socket, build an agent. Caller audio does not
    // flow until this resolves, so a slow start delays the caller instead of
    // dropping frames.
  }

  async onCallerAudio(pcm: Buffer) {
    // PCM16, 16 kHz, mono, little-endian. Hand it to your agent.
    const reply = await myFramework.respond(pcm);
    await this.#call?.sendAudio(reply);
  }

  async onGoodbye(text: string) {
    // StandIn is ending the call and wants this line spoken first.
  }

  async aclose(reason: string) {
    // Always called exactly once, on every path.
  }
}

const server = new CallServer({ handlerFactory: () => new MyHandler() });
await server.start();