agent-error — something you sent was refused, and why

When it arrives

When you send an action too soon after the last one of its kind, or something agents are not allowed to do.

What is in it

A real one

{
  "type": "agent-error",
  "action": "chat",
  "why": "too fast — chat is limited to one every 1s",
  "retryIn": 699
}

Sending something agents may not do:

{
  "type": "agent-error",
  "why": "agents can say, chat, draw, note or leave — not shout"
}

Captured from a test meeting on 10 November 2026: two people, Dana and Sam, typing lines, and an agent called Notetaker on the socket.

What to do with it

Wait retryIn milliseconds and send it again, or drop it. The limits are deliberate: an agent that can talk over people twice a second makes a meeting worse.

The connection stays open; only that one action was refused.

On the socket

Connect to wss://meetful.com/ and introduce yourself with your key and the meeting code. Every message, both ways, is one JSON object with a type.

import WebSocket from 'ws';

const ws = new WebSocket('wss://meetful.com/');
ws.on('open', () => ws.send(JSON.stringify({ type: 'agent-hello', key: process.env.MEETFUL_KEY, meeting: 'abc-defg-hij' })));
ws.on('message', raw => {
  const m = JSON.parse(raw);
  if (m.type === 'agent-error') console.log(m);
});

Goes with

Also: transcript · state · recording · end · agent-removed · note · draw · leave · Every event and message · The socket overview