Quickstart

import { ScenaroProvider } from '@scenaro/sdk/react';

export function AppProviders({ children }: { children: React.ReactNode }) {
  return (
    <ScenaroProvider apiUrl="https://api.scenaro.io">
      {children}
    </ScenaroProvider>
  );
}

import { useScenaroSession } from '@scenaro/sdk/react';

const SCENARIO_UUID = 'your-publication-uuid';

export function VoiceButton() {
  const { status, start, end } = useScenaroSession({ scenario: SCENARIO_UUID });

  return status === 'connected'
    ? <button onClick={end}>End session</button>
    : <button onClick={() => start()}>Talk to the assistant</button>;
}

const {
  status,        // 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'ended'
  agentState,    // 'idle' | 'listening' | 'thinking' | 'speaking'
  messages,      // ConversationMessage[]
  error,         // ScenaroError | null
  sendText,
  setMicrophoneEnabled,
} = useScenaroSession({
  scenario: SCENARIO_UUID,
  onMessage: (message) => console.log(message),
  onError: (error) => console.error(error.code, error.message),
});

useScenaroSession({
  scenario: SCENARIO_UUID,
  tools: {
    search_products: async ({ query }) => searchCatalog(query),
    open_page: async ({ url }) => {
      router.push(url);
      return { ok: true };
    },
  },
});