Skip to content

Commit 1807466

Browse files
docs(api): document recoveryDisabled field on SessionInfo (#4805)
Documents the new optional `recoveryDisabled?: boolean` field on the `GET /v1/sessions/:id` response, introduced in PR #4803 (Issue #4802 F-4 per-session stall auto-recovery kill-switch). Cross-references: - Issue #4802 (F-4 spec) - PR #4803 (server-side implementation, merged) - PR #4804 (dashboard stall pill follow-up)
1 parent 2359d42 commit 1807466

1 file changed

Lines changed: 2 additions & 1 deletion

File tree

docs/api-reference.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -864,12 +864,13 @@ curl http://localhost:9100/v1/sessions/abc123 \
864864
-H "Authorization: Bearer $TOKEN"
865865
```
866866

867-
**Response:** Session object with `actionHints` for current interactive state, `latestActivityText` for live agent activity, `ccSessionId` when correlated with a Claude Code session, and `telegramTopicId` when a Telegram topic is linked.
867+
**Response:** Session object with `actionHints` for current interactive state, `latestActivityText` for live agent activity, `ccSessionId` when correlated with a Claude Code session, `telegramTopicId` when a Telegram topic is linked, and `recoveryDisabled` when stall auto-recovery is paused on this session.
868868

869869
| Field | Type | Description |
870870
|-------|------|-------------|
871871
| `latestActivityText` | string | Human-readable description of current agent activity (e.g. `"Running: npm test"`, `"Editing: server.ts"`, `"Idle"`, `"Waiting for input"`, `"Compacting context"`). Updated in real-time from CC hook events. |
872872
| `ccSessionId` | string | Claude Code session ID correlated with this Aegis session via the `CLAUDE_CODE_SESSION_ID` environment variable. Only present when the CC→Aegis mapping has been established through MCP tool usage. |
873+
| `recoveryDisabled` | boolean | Per-session kill-switch for stall auto-recovery. When `true`, Aegis will not auto-restart a stalled session — the operator has paused recovery. Persists across Aegis restarts. Only present when explicitly set (defaults to `false`). Currently toggled via the dashboard stall pill; no REST endpoint to set it directly. |
873874

874875
**Errors:**
875876

0 commit comments

Comments
 (0)