session_local_editor.py 3.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
  1. """Editor policy lives with execution; an ACP connection is only a viewer."""
  2. from contextlib import contextmanager
  3. from dataclasses import asdict
  4. import uuid
  5. from hermes_state_runtime import RuntimeStoreError
  6. def validate_editor(source, editor):
  7. """The launch's editor policy, or a refusal that names the key it read (create path totality).
  8. An ACP connection is a viewer; the policy itself lives with execution. Every branch below refuses
  9. with its own field, so a rejected editor launch says which key was wrong instead of a bare code.
  10. """
  11. if editor is None:
  12. return
  13. if source != 'acp':
  14. raise RuntimeStoreError('invalid_params', field='editor',
  15. detail=f'an editor policy is only accepted from an ACP launch, not {source}')
  16. if not isinstance(editor, dict):
  17. raise RuntimeStoreError('invalid_params', field='editor',
  18. detail=f'must be a mapping, got {type(editor).__name__}')
  19. unknown = sorted(set(editor) - {'mcp_servers', 'edit_approval_policy'})
  20. if unknown:
  21. raise RuntimeStoreError('invalid_params', field=f'editor.{unknown[0]}',
  22. detail='unknown editor key')
  23. if editor.get('edit_approval_policy', 'ask') != 'ask':
  24. raise RuntimeStoreError('invalid_params', field='editor.edit_approval_policy',
  25. detail="must be 'ask': every edit is approved one at a time")
  26. if not isinstance(editor.get('mcp_servers', []), list):
  27. raise RuntimeStoreError('invalid_params', field='editor.mcp_servers',
  28. detail=f'must be a list, got {type(editor.get("mcp_servers")).__name__}')
  29. from gateway.session_local_mcp import validate_servers
  30. validate_servers(editor.get('mcp_servers', []))
  31. def request_editor_edit(proposal):
  32. from tools import approval
  33. from tools.approval_context import get_current_session_key
  34. from tools.approval_gateway_wait import _await_gateway_decision
  35. route = get_current_session_key()
  36. with approval._lock:
  37. notify = approval._gateway_notify_cbs.get(route)
  38. if notify is None:
  39. return False
  40. # Each diff is a one-use consent, never a command-pattern or session grant.
  41. data = {'command': f'Edit {proposal.path}', 'description': 'Approve proposed file change',
  42. 'pattern_key': 'editor-' + uuid.uuid4().hex,
  43. 'allow_session': False, 'allow_permanent': False, 'edit': asdict(proposal)}
  44. data['pattern_keys'] = [data['pattern_key']]
  45. decision = _await_gateway_decision(route, notify, data, surface='acp')
  46. return decision.get('resolved') and decision.get('choice') == 'once'
  47. def _policy_requester(policy):
  48. """The session's edit approval policy in front of the editor's consent (main's ACP modes): Accept
  49. Edits / Don't Ask let an edit run unasked; sensitive paths and everything else still ask."""
  50. from acp_adapter.edit_approval import should_auto_approve_edit
  51. if policy.edit_approval_policy == 'ask':
  52. return request_editor_edit
  53. def request(proposal):
  54. if should_auto_approve_edit(proposal, policy.edit_approval_policy, policy.cwd):
  55. return True
  56. return request_editor_edit(proposal)
  57. return request
  58. @contextmanager
  59. def editor_scope(policy):
  60. from acp_adapter.edit_approval import set_edit_approval_requester, reset_edit_approval_requester
  61. token = set_edit_approval_requester(_policy_requester(policy) if policy.source == 'acp' else None)
  62. try:
  63. yield
  64. finally:
  65. reset_edit_approval_requester(token)