{"endpoint":"/energy/decision","method":"POST","content_type":"application/json","inputSchema":{"type":"object","properties":{"goal":{"type":"string","enum":["minimize_cost","minimize_carbon","balanced","maximize_self_consumption","trading_signal"],"default":"balanced"},"device":{"type":"string","enum":["ev","battery","heat_pump","flexible_load","generic"],"default":"generic"},"location":{"type":"string","default":"Germany"},"duration_hours":{"type":"integer","minimum":1,"maximum":24,"default":4},"deadline":{"type":"string","format":"date-time"},"policy_profile":{"type":"string","enum":["balanced","utility","precision","recall"],"description":"Optional override. Trading defaults to precision; flexible devices default to utility."},"constraints":{"type":"object","properties":{"min_soc":{"type":"number"},"target_soc":{"type":"number"},"max_power_kw":{"type":"number"},"must_finish_by":{"type":"string","format":"date-time"}},"additionalProperties":false}},"additionalProperties":false},"requestExample":{"goal":"minimize_cost","device":"ev","location":"Germany","duration_hours":2,"constraints":{"target_soc":80,"max_power_kw":11}}}