Events
Session Events
(Archived) Legacy Lens runtime: session events for querying, validating, and controlling active lens sessions.
Was this page helpful?
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
(Archived) Legacy Lens runtime: session events for querying, validating, and controlling active lens sessions.
| Event Type | Pattern | Description |
|---|---|---|
session.status | Query | Retrieve current session status and metadata |
session.validate | Request-Response | Validate session health and configuration |
session.get | Request-Response | Retrieve specific session information |
session.modify | Request-Response | Modify session configuration |
session.update | Request-Response | Update session state |
session.read | Direct | Read pending events from session queue |
session.destroy | Request-Response | Terminate session and free resources |
type: session.status
{
"session_id": "lsn-...",
"lens_id": "lens_...",
"org_id": "org_...",
"session_status": "SESSION_STATUS_RUNNING",
"session_endpoint": "https://...",
"reverse_proxy_endpoint": "https://...",
"session_runner": "node_...",
"node_tag": "default",
"registration_timestamp": 1234567890.0,
"last_event_timestamp": 1234567890.0,
"last_update_timestamp": 1234567890.0,
"num_active_connections": 2,
"num_updates": 15,
"num_inputs": 42,
"num_outputs": 38,
"num_events": 120,
"session_ttl_sec": 600
}
type: session.validate
event_data: {}
{
"type": "session.validate.response",
// Response content is lens-specific
}
type: session.get
event_data:
# Parameters are lens-specific
{
"type": "session.get.response",
// Response content is lens-specific
}
type: session.modify
event_data:
# Parameters are lens-specific
{
"type": "session.modify.response",
// Response content is lens-specific
}
type: session.update
event_data:
# Parameters are lens-specific
{
"type": "session.update.response",
// Response content is lens-specific
}
type: session.read
event_data:
# Parameters are lens-specific
{
// Returns immediately with available events
}
SESSION_STATUS_STARTING or SESSION_STATUS_RUNNING status.type: session.destroy
event_data: {}
{
"type": "session.destroy.response",
// Response confirms destruction
}
| Error Type | Message | Cause |
|---|---|---|
error | "Unknown session id: {session_id}" | Session not found |
error | "Failed to fetch session_runner!" | No node assigned to session |
{
"type": "error",
"message": "Unknown session id: lsn-abc123"
}
{
"type": "error",
"message": "Failed to fetch session_runner!"
}
Was this page helpful?