events.iterate.com

Event type

events.iterate.com/agent/summary-updated

Updates the agent's human-readable summary. Omitted fields remain unchanged, null clears an optional field, and pinned false unpins. The same event is used whether an agent or a human initiated the edit; the processor's own conditional waiting clear ({ waitingFor: null, clearWaitingForThroughOffset }) only clears a wait established at or before the waking input's offset.

Payload schema

One of 2 shapes:

variant 1

titlestring | nulloptional
descriptionstring | nulloptional
activitystring | nulloptional
waitingFor"user_input" | "external_event" | "timer" | nulloptional
pinnedbooleanoptional

variant 2

waitingFornull
clearWaitingForThroughOffsetinteger
Raw JSON schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "title": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 120
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 600
            },
            {
              "type": "null"
            }
          ]
        },
        "activity": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 240
            },
            {
              "type": "null"
            }
          ]
        },
        "waitingFor": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "user_input",
                "external_event",
                "timer"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "pinned": {
          "type": "boolean"
        }
      },
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "waitingFor": {
          "type": "null"
        },
        "clearWaitingForThroughOffset": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "waitingFor",
        "clearWaitingForThroughOffset"
      ],
      "additionalProperties": false
    }
  ]
}