agentux.events

Event subscription, unsubscription, and server-push notifications

`agentux.events.subscribe`

Subscribe to server-push event notifications on the current WebSocket connection.

Parameters:

Name	Type	Required	Description
`event_types`	string[]	Yes	Array of event type names to subscribe to

Valid Event Types:

Event Type	Notification Method	Description
`selectionChanged`	agentux.event.selectionChanged	Actor selection in the editor changed
`assetSaved`	agentux.event.assetSaved	A package/asset was saved
`compilationComplete`	agentux.event.compilationComplete	A Blueprint compilation completed
`levelChanged`	agentux.event.levelChanged	The current level/map changed (load, save, new)

Returns:

Name	Type	Description
`subscribed`	string[]	Event types successfully subscribed to
`count`	number	Number of event types subscribed

Example Request:

{
  "jsonrpc": "2.0",
  "method": "agentux.events.subscribe",
  "params": {
    "event_types": ["selectionChanged", "assetSaved"]
  },
  "id": 1
}

Example Response:

{
  "jsonrpc": "2.0",
  "result": {
    "subscribed": ["selectionChanged", "assetSaved"],
    "count": 2
  },
  "id": 1
}

`agentux.events.unsubscribe`

Unsubscribe from one or more event types.

Parameters:

Name	Type	Required	Description
`event_types`	string[]	Yes	Array of event type names to unsubscribe from

Returns:

Name	Type	Description
`unsubscribed`	string[]	Event types unsubscribed from
`count`	number	Number of event types unsubscribed

Example Request:

{
  "jsonrpc": "2.0",
  "method": "agentux.events.unsubscribe",
  "params": {
    "event_types": ["selectionChanged"]
  },
  "id": 2
}

Example Response:

{
  "jsonrpc": "2.0",
  "result": {
    "unsubscribed": ["selectionChanged"],
    "count": 1
  },
  "id": 2
}

`agentux.events.list`

List all available event types and current subscriptions.

No parameters.

Returns:

Name	Type	Description
`available`	string[]	All event types available for subscription
`subscribed`	string[]	Event types currently subscribed to (across all connections)
`subscriber_count`	number	Number of active WebSocket connections

Example Request:

{
  "jsonrpc": "2.0",
  "method": "agentux.events.list",
  "id": 3
}

Example Response:

{
  "jsonrpc": "2.0",
  "result": {
    "available": ["selectionChanged", "assetSaved", "compilationComplete", "levelChanged"],
    "subscribed": ["selectionChanged"],
    "subscriber_count": 1
  },
  "id": 3
}