Give voice to your
agents and apps.

import { VocalBridgeProvider } from "@vocalbridgeai/react";

export default function Layout({ children }) {
  return (
    <VocalBridgeProvider
      options={{ auth: { tokenUrl: "/api/token" } }}
    >
      {children}
    </VocalBridgeProvider>
  );
}

import { useAgentActions } from "@vocalbridgeai/react";

export function TicTacToe() {
  const { onAction, sendAction } = useAgentActions();

  // agent → app : the agent picks a square, we draw it
  useEffect(() =>
    onAction("place_mark", ({ row, col }) => {
      setBoard((b) => place(b, row, col, "O"));
    }),
  [onAction]);

  // app → agent : user clicked a square, tell the agent
  const handleClick = (row, col) => {
    const next = place(board, row, col, "X");
    setBoard(next);
    sendAction("user_placed_mark", { row, col, board: next });
  };

  return <Board cells={board} onCell={handleClick} />;
}

export const makePhoneCall = {
  name: "make_phone_call",
  description:
    "Place an outbound phone call via Vocal Bridge.",
  input_schema: {
    type: "object",
    properties: {
      phone_number: { type: "string" },   // E.164
      name:         { type: "string" },
      purpose:      { type: "string" },
    },
    required: ["phone_number"],
  },
};

import { execFile } from "node:child_process";
import { promisify } from "node:util";

const run = promisify(execFile);

export async function placeCall(input) {
  const { phone_number, name } = input;

  const { stdout } = await run("vb", [
    "call", phone_number,
    "--name", name ?? "",
    "--json",
  ]);

  return JSON.parse(stdout);   // { call_id, status }
}