## Context\n\nThe gentle-agent-state inventory showed the missing layer in Cortex: a stable anti-corruption contract between agent-native events and UI surfaces like Herdr, statusline and notifications.\n\n## Goal\n\nDefine `cortex.agent_state.v1` before implementing runtime code.\n\n## Proposed Contract\n\nCanonical states:\n\n- `working`\n- `blocked`\n- `idle`\n- `unknown`\n\nRules to specify:\n\n- event shape\n- source identity\n- pane/session identity\n- timestamps and TTL\n- stale-state cleanup\n- rollup order: `blocked > working > idle > unknown`\n- transition-only notifications\n- visibility-aware suppression\n\n## Deliverable\n\nA small spec/doc first. Runtime adapters come later.
Context\n\nThe gentle-agent-state inventory showed the missing layer in Cortex: a stable anti-corruption contract between agent-native events and UI surfaces like Herdr, statusline and notifications.\n\n## Goal\n\nDefine
cortex.agent_state.v1before implementing runtime code.\n\n## Proposed Contract\n\nCanonical states:\n\n-working\n-blocked\n-idle\n-unknown\n\nRules to specify:\n\n- event shape\n- source identity\n- pane/session identity\n- timestamps and TTL\n- stale-state cleanup\n- rollup order:blocked > working > idle > unknown\n- transition-only notifications\n- visibility-aware suppression\n\n## Deliverable\n\nA small spec/doc first. Runtime adapters come later.