Chat

{
  "agent": "my-agent",
  "message": "Find oil change shops near me and check traffic to the closest highly rated option",
  "end_user_id": "user-123",
  "session_id": "550e8400-e29b-41d4-a716-446655440000",
  "timezone": "America/New_York",
  "system_prompt_append": "The user is viewing their 2020 Toyota Camry. Prefer shops within 5 miles.",
  "overrides": {
    "model": "anthropic/claude-sonnet-4-5",
    "tools": {
      "include": ["google-maps-search", "traffic"]
    },
    "streaming": true,
    "thinking": true,
    "auto_prompts": true
  }
}

{"type": "session", "session_id": "550e8400-e29b-41d4-a716-446655440000", "is_new": true}

{"type": "tool_call", "id": "tc_1", "actions": [
  {"tool": "google-maps-search", "args": {"query": "oil change shops near Phoenix, AZ"}},
  {"tool": "traffic", "args": {"action": "route_traffic", "origin": "Phoenix, AZ", "destination": "Best rated oil change shop near Phoenix, AZ"}}
]}

{"type": "tool_result", "id": "tc_1", "results": [
  {"tool": "google-maps-search", "status": "success", "data": {"results": [...]}},
  {"tool": "traffic", "status": "success", "data": {"route": {...}, "incidents": [...]}}
]}

{"type": "data_saved", "mutations": [
  {
    "action": "create",
    "table": "vehicles",
    "record": {
      "id": "a1b2c3d4-...",
      "year": 2020,
      "make": "Toyota",
      "model": "Camry",
      "trim": "SE",
      "vin": "4T1BF1FK5LU123456",
      "odometer_km": 72420
    }
  }
]}

{"type": "usage", "prompt_tokens": 1250, "completion_tokens": 340, "thinking_tokens": 0, "cost_cents": 42}

async function chat(agent, message, endUserId, sessionId) {
  const response = await fetch("https://api.galadri.com/v1/chat", {
    method: "POST",
    headers: {
      "Authorization": "Bearer gld_your_api_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      agent,
      message,
      end_user_id: endUserId,
      ...(sessionId && { session_id: sessionId }),
    }),
  });

  if (!response.ok) {
    const err = await response.json();
    throw new Error(err.error);
  }

  const reader = response.body.getReader();
  const decoder = new TextDecoder();
  let buffer = "";
  let currentSessionId = sessionId;

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;

    buffer += decoder.decode(value, { stream: true });
    const lines = buffer.split("\n");
    buffer = lines.pop() || "";

    for (const line of lines) {
      if (!line.startsWith("data: ")) continue;
      const payload = line.slice(6);
      if (payload === "[DONE]") return currentSessionId;

      const event = JSON.parse(payload);

      switch (event.type) {
        case "session":
          currentSessionId = event.session_id;
          break;
        case "content":
          process.stdout.write(event.content);
          break;
        case "tool_call":
          console.log("\nUsing tools:", event.actions.map(a => a.tool));
          break;
        case "data_saved":
          console.log("\nData saved:", event.mutations);
          break;
        case "usage":
          console.log("\nCost:", event.cost_cents, "cents");
          break;
        case "error":
          console.error("\nError:", event.error);
          break;
      }
    }
  }

  return currentSessionId;
}

{
  "session_id": "550e8400-e29b-41d4-a716-446655440000",
  "is_new_session": true,
  "message": "I found several oil change shops near Phoenix, AZ:\n\n1. **Valvoline** — ...",
  "thinking": "The user wants oil change shops. I should search Google Maps...",
  "tool_calls": [
    {
      "actions": [
        {"tool": "google-maps-search", "args": {"query": "oil change shops near Phoenix, AZ"}}
      ],
      "results": [
        {"tool": "google-maps-search", "status": "success", "data": {"places": [...]}}
      ]
    }
  ],
  "data_saved": [],
  "usage": {
    "prompt_tokens": 1250,
    "completion_tokens": 340,
    "thinking_tokens": 128,
    "cost_cents": 42
  },
  "auto_prompts": ["Show EV chargers nearby", "Save this shop to my notes"]
}

{
  "agent": "my-agent",
  "message": "Check the user's upcoming service schedule and send a reminder email",
  "end_user_id": "user-123",
  "callback_url": "https://your-app.com/webhooks/galadri"
}

{
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing",
  "session_id": "550e8400-e29b-41d4-a716-446655440000",
  "is_new_session": true
}

{
  "event": "chat.completed",
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "session_id": "550e8400-e29b-41d4-a716-446655440000",
  "is_new_session": true,
  "message": "I've sent a service reminder email to the user.",
  "tool_calls": [...],
  "usage": { "prompt_tokens": 980, "completion_tokens": 120, "thinking_tokens": 0, "cost_cents": 18 },
  "completed_at": "2026-04-01T14:30:00.000Z"
}

import { createHmac } from "crypto";

function verifySignature(body: string, signature: string, secret: string): boolean {
  const expected = createHmac("sha256", secret).update(body).digest("hex");
  return signature === expected;
}

{
  "agent": "my-agent",
  "message": "Book the first one for Saturday at 10am",
  "end_user_id": "user-123",
  "session_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": "Agent not found or inactive"
}

data: {"type": "error", "error": "Model provider returned an error. Please try again."}
data: [DONE]