Skip to main content
API reference sections

Schema

AgentNotice

A short status line a local agent said during a reply that is not part of the reply (koru-ai D69, AI schema 12): Devin's Hook failed: … about a hook on the person's machine. Kept with the reply it came with, in the order it came, and where in the reply it came.

Type object

Shape

FieldTypeDescription
idrequiredAgentNoticeId

AgentNoticeId - a client-minted UUID v4, never derived from content or location.

attempt_idrequiredInferenceAttemptId

InferenceAttemptId - a client-minted UUID v4, never derived from content or location.

chat_idrequiredChatId

ChatId - a client-minted UUID v4, never derived from content or location.

assistant_message_idrequiredMessageId

MessageId - a client-minted UUID v4, never derived from content or location.

textrequiredstring

The agent's words, bounded to 500 characters by the session host before they reach the chat.

text_offsetinteger (uint32, >= 0) or null

How much of the reply's Markdown, in bytes, had arrived when the notice came; None until the store has written it.

created_atrequiredTimestamp

Epoch milliseconds, UTC. Signed, so instants before 1970 are representable.

Example
{
  "id": "00000000-0000-4000-8000-000000000000",
  "attempt_id": "00000000-0000-4000-8000-000000000000",
  "chat_id": "00000000-0000-4000-8000-000000000000",
  "assistant_message_id": "00000000-0000-4000-8000-000000000000",
  "text": "string",
  "text_offset": 0,
  "created_at": 0
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Generated from contract version 1. Last updated .

Privacy choices

Choose which optional tools Koru may use on this site. Your choice is saved in a cookie in this browser for 12 months. Privacy policy

Privacy choices

Keep you signed in, protect forms and remember your language and this choice.

Always on

PostHog and Google Analytics 4 measure page views and actions such as downloads, using cookies or local storage.

PostHog records how pages are used, with form inputs masked and private pages excluded. Needs Analytics.

Ahrefs Web Analytics measures visits and where they come from, and Google Ads measures whether our ads led to a visit or download.