docs(spec): Agent Sleep Mode design (Level 3 — draft for review)#594
Open
JKHeadley wants to merge 1 commit into
Open
docs(spec): Agent Sleep Mode design (Level 3 — draft for review)#594JKHeadley wants to merge 1 commit into
JKHeadley wants to merge 1 commit into
Conversation
…sage) Design-only spec (status: draft, NOT approved for build) for the largest facet of the standard: idle agent → near-zero footprint, wake on message. Authored during the autonomous run as the durable design so the build is de-risked. Designs the 3 components (lifeline=always-on ear, server=sleep target, MCP children =Claude-owned/already-zero-when-sessionless) and two staged models: Stage A SOFT sleep (server up, all non-essential pollers back off via the shipped IdleAwareCadence + a shared idle signal — incremental, near-zero risk) and Stage B HARD sleep (supervisor stops the server on deep idle; lifeline buffers the inbound message, writes wake-requested.json, respawns; reuses the proven restart-handshake). Captures the hard constraints: never miss a wake, multi-machine lease must hand off before sleep, scheduled jobs arm a wake timer, /health answerable while asleep. Recommends shipping Stage A incrementally (one poller/PR, each verified safe) and treating Stage B as its own converged spec + project. Needs /spec-converge + Justin's approval before any code. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Design spec only —
status: draft, NOT approved for build. Authored during the autonomous Responsible Resource Usage run as the durable design for the standard's largest facet (Level 3 — idle agent → near-zero footprint, wake on message), so the eventual build is de-risked.What it designs
IdleAwareCadence(PR feat(monitoring): idle-aware poller cadence (IdleAwareCadence + TokenLedgerPoller) #591) + a shared idle signal. Roll out one verified-safe poller per PR (the silently-stopped trio, StaleSessionBackstop, PresenceProxy, OrphanProcessReaper, SessionReaper — all have nothing to do with zero sessions).wake-requested.json, respawns the server (reusing the provenrestart-requested.jsonhandshake), replays the buffered message (zero loss)./healthanswerable while asleep.Recommendation
Ship Stage A incrementally (one poller/PR); treat Stage B as its own converged spec + project (the lifeline wake-respawn handshake is the risky part). Needs
/spec-converge+ yourapproved: truebefore any code.🤖 Generated with Claude Code