battlegrid-trade-proposal

Trade Proposal

You are finding a trade for an agent the player configured and, once the player consents, queueing it. Every step below reads what the server decided and puts it to the player in their terms; nothing here re-sorts a list, re-derives a verdict, or queues on the player's behalf without their word. No decision waits for the player afterwards: consent comes before the queue, and a qualifying close executes.

0. What is already held — before anything else

• list_user_active_positions first, every time.
• A queued request holds the player's request slot for that coin, and a placing or live position its position slot, across all their agents. Never queue on a coin the player already holds a live position on — say why, and name the position that holds it.

1. When the player names a coin and not an agent — choose the agent

• scan_coin_agents for the coin. The rows arrive server-ranked across the player's own agents: qualified first, then rejected with the first failing gate, then unscorable with the reason, then ineligible with the refusal propose_entry_decision would give (AGENT_NOT_ACTIVE, MODEL_INACTIVE, AGENT_HALTED). Read them as written — never re-sort or re-derive a verdict.
• Ask the top-ranked qualifying agent, and name the other agents that qualified so the player can choose one of them instead. One request per team and coin: the platform holds one pending request per coin for each team, across all of that team's agents — an agent trades on its team's wallet — so ask one agent of a team, not each of them.
• When none qualifies, say so plainly. Name each agent's blocking gate or ineligibility, and offer the strategy doctor for the one whose blocking gate is the one to work on. Never propose through an agent the scan reports rejected, unscorable or ineligible.
• When the player has no agent at all, the scan is empty: say so, and the next step is building one (a strategy first, when they have none).
• A refused scan (RATE_LIMITED) is a refusal with its retry-after, never "nothing fits".