Skip to content

Commit ae45a41

Browse files
author
Lasim
committed
feat: Enhance documentation for idle process management, including new event types and Linux host requirements
1 parent 9058f48 commit ae45a41

6 files changed

Lines changed: 646 additions & 21 deletions

File tree

development/satellite/event-system.mdx

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ Satellite Components EventBus Backend
6666
**Naming Convention**: All event data fields use **snake_case** (e.g., `server_id`, `team_id`, `spawn_duration_ms`) to match the backend API convention.
6767
</Note>
6868

69-
The satellite emits 10 event types across 4 categories:
69+
The satellite emits 12 event types across 4 categories:
7070

7171
### MCP Server Lifecycle
7272

@@ -148,6 +148,46 @@ Emitted when server exhausts all 3 restart attempts.
148148
}
149149
```
150150

151+
#### `mcp.server.dormant`
152+
Emitted when idle stdio process is terminated to save resources.
153+
154+
**Data Structure:**
155+
```typescript
156+
{
157+
server_id: string;
158+
server_slug: string;
159+
team_id: string;
160+
process_id: number;
161+
idle_duration_seconds: number;
162+
last_activity_at: string; // ISO 8601 timestamp
163+
}
164+
```
165+
166+
**Purpose:**
167+
- Track resource optimization (memory/CPU savings)
168+
- Monitor process sleep patterns
169+
- Alert on unexpected idle behavior
170+
171+
#### `mcp.server.respawned`
172+
Emitted when dormant process is automatically respawned on API call.
173+
174+
**Data Structure:**
175+
```typescript
176+
{
177+
server_id: string;
178+
server_slug: string;
179+
team_id: string;
180+
process_id: number;
181+
dormant_duration_seconds: number;
182+
respawn_duration_ms: number;
183+
}
184+
```
185+
186+
**Purpose:**
187+
- Track transparent process respawning
188+
- Measure respawn latency (1-3s typical)
189+
- Monitor usage patterns after idle periods
190+
151191
### Client Connections
152192

153193
#### `mcp.client.connected`

0 commit comments

Comments
 (0)