Events

2 actions. Each is callable by the agent as a tool, over HTTP via /api/invoke, and (usually) from a UI page.

events.emit

POST · mutating

Publish an event to the workflow event bus. Workflows subscribed to this event kind (triggerKind=event, triggerConfig.eventKind=X) auto-fire. Use for cross-workflow coordination — emitting funding.threshold.crossed from one workflow can trigger several others without hard-wiring.

  • AI tool: events_emit
  • API: POST /api/invoke/events.emit

Input

Field Type Required Description
kind string yes
payload object
missionId string
subjectId string
projectId string
actorId string
JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "minLength": 1
    },
    "payload": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "missionId": {
      "type": "string",
      "minLength": 1
    },
    "subjectId": {
      "type": "string",
      "minLength": 1
    },
    "projectId": {
      "type": "string",
      "minLength": 1
    },
    "actorId": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "kind"
  ]
}

events.list

GET

List recent workflow events, optionally filtered by kind / scope. Useful for debugging event-driven workflows.

  • AI tool: events_list
  • API: GET /api/invoke/events.list

Input

Field Type Required Description
kind string
missionId string
subjectId string
projectId string
limit integer
JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "kind": {
      "type": "string"
    },
    "missionId": {
      "type": "string",
      "minLength": 1
    },
    "subjectId": {
      "type": "string",
      "minLength": 1
    },
    "projectId": {
      "type": "string",
      "minLength": 1
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  }
}