Coverage for src/copytrading_engine/host/pipe/handlers/control.py: 100%

41 statements  

« prev     ^ index     » next       coverage.py v7.16.2, created at 2026-11-16 16:55 +0000

1"""Agent control through the app: commands, proposals, and the audit trail.""" 

2 

3from copytrading_engine.control.proposals import ProposalRefused 

4from copytrading_engine.control.service import ControlService 

5from copytrading_engine.host.pipe.requests import ( 

6 AgentAuditRequest, 

7 ApproveProposalRequest, 

8 AuthorizeSetupRequest, 

9 CompleteProposalRequest, 

10 ControlRequest, 

11 DiscardProposalsRequest, 

12 ListProposalsRequest, 

13 PipeRequest, 

14 RejectProposalRequest, 

15 RequestHandler, 

16) 

17from copytrading_engine.host.pipe.responses import ErrorCode, reply 

18from copytrading_engine.host.pipe.session import PipeSession 

19 

20 

21class ControlHandlers: 

22 """Route agent control lines to the control service, stamped with the engine state.""" 

23 

24 def __init__( 

25 self, 

26 *, 

27 control: ControlService | None, 

28 session: PipeSession, 

29 ) -> None: 

30 self._control = control 

31 self._session = session 

32 

33 def handlers(self) -> dict[type[PipeRequest], RequestHandler]: 

34 return { 

35 ControlRequest: self._handle_control, 

36 AuthorizeSetupRequest: self._handle_control, 

37 ListProposalsRequest: self._handle_control, 

38 ApproveProposalRequest: self._handle_control, 

39 CompleteProposalRequest: self._handle_control, 

40 RejectProposalRequest: self._handle_control, 

41 DiscardProposalsRequest: self._handle_control, 

42 AgentAuditRequest: self._handle_control, 

43 } 

44 

45 async def _handle_control( 

46 self, 

47 request: ControlRequest 

48 | AuthorizeSetupRequest 

49 | ListProposalsRequest 

50 | ApproveProposalRequest 

51 | CompleteProposalRequest 

52 | RejectProposalRequest 

53 | DiscardProposalsRequest 

54 | AgentAuditRequest, 

55 ) -> bytes: 

56 """Serve agent control; only the app, after owner authentication, approves.""" 

57 control = self._control 

58 if control is None: 

59 return reply(request.version, request.request_id, error="unavailable") 

60 if isinstance(request, ControlRequest): 

61 response = await control.handle( 

62 request.line, request.context, engine_state=self._session.state 

63 ) 

64 return reply( 

65 request.version, 

66 request.request_id, 

67 # The exact contract line, so the app relays bytes it never reinterprets. 

68 ok={"type": "control", "line": response.model_dump_json()}, 

69 ) 

70 if isinstance(request, AuthorizeSetupRequest): 

71 answer = await control.authorize_setup(request.setup, request.context) 

72 if answer is None: 

73 return reply(request.version, request.request_id, ok={"type": "setup_allowed"}) 

74 return reply( 

75 request.version, 

76 request.request_id, 

77 ok={"type": "control", "line": answer.model_dump_json()}, 

78 ) 

79 if isinstance(request, ListProposalsRequest): 

80 return reply( 

81 request.version, 

82 request.request_id, 

83 ok={ 

84 "type": "proposals", 

85 "proposals": [item.model_dump(mode="json") for item in control.proposals()], 

86 }, 

87 ) 

88 if isinstance(request, AgentAuditRequest): 

89 entries = await control.audit_entries(request.limit) 

90 return reply( 

91 request.version, 

92 request.request_id, 

93 ok={ 

94 "type": "agent_audit", 

95 "entries": [ 

96 { 

97 "at": entry.at.isoformat(), 

98 "actor": entry.actor, 

99 "caller_pid": entry.caller_pid, 

100 "caller_path": entry.caller_path, 

101 "operation": entry.operation, 

102 "tier": entry.tier, 

103 "outcome": entry.outcome, 

104 "proposal_id": entry.proposal_id, 

105 } 

106 for entry in entries 

107 ], 

108 }, 

109 ) 

110 if isinstance(request, DiscardProposalsRequest): 

111 count = await control.discard_pending() 

112 return reply( 

113 request.version, 

114 request.request_id, 

115 ok={"type": "proposals_discarded", "count": count}, 

116 ) 

117 try: 

118 if isinstance(request, ApproveProposalRequest): 

119 proposal = await control.approve(request.proposal_id, request.digest) 

120 elif isinstance(request, CompleteProposalRequest): 

121 proposal = await control.complete( 

122 request.proposal_id, request.outcome, request.code 

123 ) 

124 else: 

125 proposal = await control.reject(request.proposal_id) 

126 except ProposalRefused as refused: 

127 code: ErrorCode = "not_found" if refused.code == "not_found" else "invalid_request" 

128 return reply(request.version, request.request_id, error=code) 

129 return reply( 

130 request.version, 

131 request.request_id, 

132 ok={"type": "proposal", "proposal": proposal.model_dump(mode="json")}, 

133 )