Agents

const result = await client.agents.list();

for (const agent of result) {
  console.log(agent.name);
}
result.meta;  // { total: 3 }

const agent = await client.agents.create({
  name: 'Hotel Concierge',
  system_prompt: 'You are a hotel operations agent...',
  business_account_id: 'acc_01hx...',
});

agent.id;     // "agt_01hx..."
agent.name;   // "Hotel Concierge"
agent.active; // true

const agent = await client.agents.create({
  name: 'Hotel Concierge',
  system_prompt: 'Extract structured tasks from hotel guest messages.',
  payload_schema: [
    { name: 'room_number', field_type: 'text', required: true },
    { name: 'description', field_type: 'text', required: true },
    { name: 'due_at', field_type: 'datetime', required: false },
    { name: 'priority', field_type: 'text', required: false },
  ],
});

agent.payloadSchema;  // PayloadSchemaField[]

const agent = await client.agents.create({
  name: 'Support Agent',
  system_prompt: 'Handle customer support requests.',
  allowed_actions: [
    'support.refund.process',
    'support.ticket.create',
    'support.escalation.request',
  ],
});

agent.allowedActions;  // ["support.refund.process", "support.ticket.create", ...]

const run = await agent.run({ input: { last_message: 'I want a refund for order #1234' } });

for (const action of run.actions) {
  switch (action.type) {
    case 'support.refund.process':
      await processRefund(action.payload);
      break;
    case 'support.ticket.create':
      await createTicket(action.payload);
      break;
    case 'support.escalation.request':
      await notifyEscalation(action.payload);
      break;
  }
}

const agent = await client.agents.retrieve('agt_01hx...');
agent.isActive;  // true
agent.isAutoRun; // false

const agent = await client.agents.update('agt_01hx...', { name: 'Updated Concierge' });

await client.agents.delete('agt_01hx...');  // true

// String input
const run = await agent.run({ input: 'Clean room 204 tomorrow at 8' });

// Object input (full control)
const run = await agent.run({
  input: {
    last_message: 'Clean room 204 tomorrow at 8',
    recent_messages: ['Hi, I have a request'],
  },
  timeout: 30_000,  // ms, default
  interval: 1_000,  // ms, default
});

run.status;         // "completed"
run.intent;         // "task_extraction"
run.confidence;     // 0.95
run.actions;        // [{ type: "hospitality.room_service.request", payload: { ... } }]
run.suggestedReply; // "I'll arrange cleaning for room 204 tomorrow at 8am."
run.contextSummary; // "Guest requested room 204 cleaning for tomorrow 8am."

const run = await agent.runAsync({ input: 'Clean room 204 tomorrow at 8' });
run.status;  // "pending"

// Wait for completion later
await run.wait({ timeout: 30_000 });
run.status;  // "completed"

// From an agent object
const runs = await agent.runs().list();

// From the client
const runs = await client.agentRuns('agt_01hx...').list();

const run = await client.agentRuns('agt_01hx...').retrieve('run_01hx...');

import { ActionRegistry } from '@whatsrb/cloud';

const registry = new ActionRegistry();

registry
  .register('create_task', (payload) => createTask(payload))
  .register('create_ticket', (payload) => createTicket(payload));

// Dispatch all actions from a completed run
const run = await agent.run({ input: { last_message: 'Fix the AC in room 107' } });
run.dispatch(registry);

// Enable confirmation mode
const agent = await client.agents.update("agt_xxx", {
  confirmationMode: "confirm",
  confirmationTimeoutMinutes: 30,
});

// Run the agent
const run = await agent.run({ input: "I want a refund for order #1234" });

// Review actionStatuses
run.actionStatuses;  // [{ status: "pending", ... }, ...]

// Confirm specific actions (by index)
await run.confirmActions([0, 2]);

// Reject specific actions (by index)
await run.rejectActions([1]);

// Dispatch only executes confirmed actions
run.dispatch(registry);