events.iterate.com

Event type

events.iterate.com/feed/item-published

A complete renderable feed item revision, with a stable display position.

Payload schema

itemobject
variant 1object
kind"user" | "assistant"
idstring
textstring
timestampMsnumber
filesobject[]optional
contentTypestring
filenamestring
pathstring
sizenumber
urlstring
mentionsobject[]optional
idstring
type"repo-file"
repoPath"/repos/config"
pathstring
mentionResolutionsRecord<string, object>optional
[key: string]objectoptional
status"resolved" | "missing" | "binary" | "read-failed"
truncatedbooleanoptional
viaobjectoptional
service"slack" | "telegram" | "agent" | "email" | "github"
senderstringoptional
kind: "activity"object
kind"activity"
idstring
status"running" | "done"
stepsobject[]
kind: "llm"object
kind"llm"
idstring
llmRequestOffsetinteger
status"running" | "done"
modelstringoptional
thinkingTextstring | object
responseTextstring | object
previewTruncatedbooleanoptional
assistantEventOffsetintegeroptional
interpretedbooleanoptional
inputTokensintegeroptional
outputTokensintegeroptional
durationMsnumberoptional
outcome"completed" | "failed" | "cancelled"optional
cancelReason"interrupted-by-user-input" | "expired"optional
errorMessagestringoptional
startedAtMsnumber
kind: "code"object
kind"code"
idstring
executionIdstring
status"running" | "done"
codestring
resultanyoptional
errorMessagestringoptional
durationMsnumberoptional
successbooleanoptional
outcomeSource"durable" | "inferred"optional
startedAtMsnumber
expiresAtMsnumber
activitySummarystringoptional
startedAtMsnumber
endedAtMsnumberoptional
kind: "stream-woken"object
kind"stream-woken"
idstring
textstring
timestampMsnumber
countintegeroptional
kind: "child-stream-created"object
kind"child-stream-created"
idstring
childPathstring
timestampMsnumber
variant 5object
kind"stream-paused" | "stream-resumed"
idstring
textstring
reasonstringoptional
timestampMsnumber
kind: "processor-revived"object
kind"processor-revived"
idstring
processorSlugstringoptional
revivalsintegeroptional
timestampMsnumber
firstOffsetinteger
ordinalinteger
revisionOffsetinteger
Raw JSON schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "item": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "user",
                "assistant"
              ]
            },
            "id": {
              "type": "string"
            },
            "text": {
              "type": "string"
            },
            "timestampMs": {
              "type": "number"
            },
            "files": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "contentType": {
                    "type": "string"
                  },
                  "filename": {
                    "type": "string"
                  },
                  "path": {
                    "type": "string"
                  },
                  "size": {
                    "type": "number",
                    "minimum": 0
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "contentType",
                  "filename",
                  "path",
                  "size",
                  "url"
                ],
                "additionalProperties": false
              }
            },
            "mentions": {
              "maxItems": 100,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "maxLength": 8192,
                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._~%:/-]*$"
                  },
                  "type": {
                    "type": "string",
                    "const": "repo-file"
                  },
                  "repoPath": {
                    "type": "string",
                    "const": "/repos/config"
                  },
                  "path": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4096
                  }
                },
                "required": [
                  "id",
                  "type",
                  "repoPath",
                  "path"
                ],
                "additionalProperties": false
              }
            },
            "mentionResolutions": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "resolved",
                      "missing",
                      "binary",
                      "read-failed"
                    ]
                  },
                  "truncated": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "status"
                ],
                "additionalProperties": false
              }
            },
            "via": {
              "type": "object",
              "properties": {
                "service": {
                  "type": "string",
                  "enum": [
                    "slack",
                    "telegram",
                    "agent",
                    "email",
                    "github"
                  ]
                },
                "sender": {
                  "type": "string"
                }
              },
              "required": [
                "service"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "kind",
            "id",
            "text",
            "timestampMs"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "activity"
            },
            "id": {
              "type": "string"
            },
            "status": {
              "type": "string",
              "enum": [
                "running",
                "done"
              ]
            },
            "steps": {
              "type": "array",
              "items": {
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "const": "llm"
                      },
                      "id": {
                        "type": "string"
                      },
                      "llmRequestOffset": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "running",
                          "done"
                        ]
                      },
                      "model": {
                        "type": "string"
                      },
                      "thinkingText": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "length": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "blockCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "tailOffset": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "groups": {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string",
                                  "pattern": "^(0|[1-9]\\d*)$"
                                },
                                "additionalProperties": {
                                  "type": "object",
                                  "propertyNames": {
                                    "type": "string",
                                    "pattern": "^(0|[1-9]\\d*)$"
                                  },
                                  "additionalProperties": {
                                    "type": "string",
                                    "maxLength": 1025
                                  }
                                }
                              }
                            },
                            "required": [
                              "length",
                              "blockCount",
                              "tailOffset",
                              "groups"
                            ],
                            "additionalProperties": false
                          }
                        ]
                      },
                      "responseText": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "length": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "blockCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "tailOffset": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "groups": {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string",
                                  "pattern": "^(0|[1-9]\\d*)$"
                                },
                                "additionalProperties": {
                                  "type": "object",
                                  "propertyNames": {
                                    "type": "string",
                                    "pattern": "^(0|[1-9]\\d*)$"
                                  },
                                  "additionalProperties": {
                                    "type": "string",
                                    "maxLength": 1025
                                  }
                                }
                              }
                            },
                            "required": [
                              "length",
                              "blockCount",
                              "tailOffset",
                              "groups"
                            ],
                            "additionalProperties": false
                          }
                        ]
                      },
                      "previewTruncated": {
                        "type": "boolean"
                      },
                      "assistantEventOffset": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      },
                      "interpreted": {
                        "type": "boolean"
                      },
                      "inputTokens": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "outputTokens": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "durationMs": {
                        "type": "number",
                        "minimum": 0
                      },
                      "outcome": {
                        "type": "string",
                        "enum": [
                          "completed",
                          "failed",
                          "cancelled"
                        ]
                      },
                      "cancelReason": {
                        "type": "string",
                        "enum": [
                          "interrupted-by-user-input",
                          "expired"
                        ]
                      },
                      "errorMessage": {
                        "type": "string"
                      },
                      "startedAtMs": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "kind",
                      "id",
                      "llmRequestOffset",
                      "status",
                      "thinkingText",
                      "responseText",
                      "startedAtMs"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "const": "code"
                      },
                      "id": {
                        "type": "string"
                      },
                      "executionId": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "running",
                          "done"
                        ]
                      },
                      "code": {
                        "type": "string"
                      },
                      "result": {},
                      "errorMessage": {
                        "type": "string"
                      },
                      "durationMs": {
                        "type": "number",
                        "minimum": 0
                      },
                      "success": {
                        "type": "boolean"
                      },
                      "outcomeSource": {
                        "type": "string",
                        "enum": [
                          "durable",
                          "inferred"
                        ]
                      },
                      "startedAtMs": {
                        "type": "number"
                      },
                      "expiresAtMs": {
                        "type": "number"
                      },
                      "activitySummary": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "kind",
                      "id",
                      "executionId",
                      "status",
                      "code",
                      "startedAtMs",
                      "expiresAtMs"
                    ],
                    "additionalProperties": false
                  }
                ]
              }
            },
            "startedAtMs": {
              "type": "number"
            },
            "endedAtMs": {
              "type": "number"
            }
          },
          "required": [
            "kind",
            "id",
            "status",
            "steps",
            "startedAtMs"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "stream-woken"
            },
            "id": {
              "type": "string"
            },
            "text": {
              "type": "string"
            },
            "timestampMs": {
              "type": "number"
            },
            "count": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "kind",
            "id",
            "text",
            "timestampMs"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "child-stream-created"
            },
            "id": {
              "type": "string"
            },
            "childPath": {
              "type": "string"
            },
            "timestampMs": {
              "type": "number"
            }
          },
          "required": [
            "kind",
            "id",
            "childPath",
            "timestampMs"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "stream-paused",
                "stream-resumed"
              ]
            },
            "id": {
              "type": "string"
            },
            "text": {
              "type": "string"
            },
            "reason": {
              "type": "string"
            },
            "timestampMs": {
              "type": "number"
            }
          },
          "required": [
            "kind",
            "id",
            "text",
            "timestampMs"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "processor-revived"
            },
            "id": {
              "type": "string"
            },
            "processorSlug": {
              "type": "string"
            },
            "revivals": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "timestampMs": {
              "type": "number"
            }
          },
          "required": [
            "kind",
            "id",
            "timestampMs"
          ],
          "additionalProperties": false
        }
      ]
    },
    "firstOffset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "ordinal": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "revisionOffset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "item",
    "firstOffset",
    "ordinal",
    "revisionOffset"
  ],
  "additionalProperties": false
}