skill_provenance.py 1.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344
  1. """Skill write-origin provenance: a ContextVar separating background-review skill writes from foreground
  2. user-directed writes (the curator only curates skills the self-improvement review fork created; skills a user
  3. asked for belong to the user). run_agent.py binds the origin before each tool loop, mirroring
  4. AIAgent._memory_write_origin: ``token = set_current_write_origin(...)`` / ``reset_current_write_origin(token)``."""
  5. import contextvars
  6. _write_origin: contextvars.ContextVar[str] = contextvars.ContextVar("skill_write_origin", default="foreground")
  7. BACKGROUND_REVIEW = "background_review" # sentinel used by run_agent._spawn_background_review
  8. def set_current_write_origin(origin: str) -> contextvars.Token[str]:
  9. return _write_origin.set(origin or "foreground")
  10. def reset_current_write_origin(token: contextvars.Token[str]) -> None:
  11. _write_origin.reset(token)
  12. def get_current_write_origin() -> str:
  13. """"foreground" for any regular agent (CLI, gateway, cron, subagent); "background_review" for the review fork."""
  14. return _write_origin.get()
  15. def is_background_review() -> bool:
  16. return get_current_write_origin() == BACKGROUND_REVIEW
  17. # Attendedness is orthogonal to origin: an explicit ``/refine`` fork IS a background review (every
  18. # curator / skill-ledger / approval guard keyed on ``is_background_review()`` must still apply), but a
  19. # user asked for it, so the unattended-only memory delete gate (#105921) does not.
  20. _review_attended: contextvars.ContextVar[bool] = contextvars.ContextVar("review_attended", default=False)
  21. def set_review_attended(attended: bool) -> contextvars.Token[bool]:
  22. return _review_attended.set(bool(attended))
  23. def reset_review_attended(token: contextvars.Token[bool]) -> None:
  24. _review_attended.reset(token)
  25. def is_unattended_review() -> bool:
  26. return is_background_review() and not _review_attended.get()