API reference

const chatbot = tai.getInstance("YOUR_ASSISTANT_ID");

const chatbot = await tai.getReadyInstance("YOUR_ASSISTANT_ID");

window.addEventListener("teamAIChatbotReady", (event) => {
  const chatbot = event.detail.chatbots.get("YOUR_ASSISTANT_ID");
});

type ChatbotSendResult =
  | { success: true }
  | { success: false; code: "busy" | "not_ready" | "timeout" | "destroyed" | "invalid_message"; message: string };

interface ConversationData {
  assistantId: string;
  messages: Array<{
    id: string;
    role: "user" | "assistant";
    content: string;
    parts: unknown[];
    timestamp: number;
  }>;
}

interface ClientTool {
  name: string;
  displayName?: string;
  description: string;
  parameters: Record<string, any>; // JSON Schema for the tool input
  execute: (params: Record<string, any>) => Promise<any> | any;
}

interface UploadResponse {
  url: string;        // https://storage.googleapis.com/<bucket>/<objectName>
  objectName?: string;
  fileId?: string;    // same as objectName
  type?: string;      // "file"
  fileName?: string;
}

interface IdentityConfig {
  user_id: string;
  user_hash: string; // HMAC-SHA256 hex of user_id, computed on your server
  user_metadata?: Record<string, any>; // up to 1000 characters serialized
}