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
« 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."""
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
21class ControlHandlers:
22 """Route agent control lines to the control service, stamped with the engine state."""
24 def __init__(
25 self,
26 *,
27 control: ControlService | None,
28 session: PipeSession,
29 ) -> None:
30 self._control = control
31 self._session = session
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 }
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 )