Draft payment proposals from a conversation (ALPHA)
Alpha — early access.
Pure cognition, no side effects: turn a customer’s natural-language request into reviewable PROPOSALS — the same action-series shape POST /instructions accepts. Stateless: send the conversation so far in messages (and/or a prompt appended as the latest user turn) on each call, and the response carries either a clarifying/confirming reply, or — only at high confidence — validated proposals (sometimes both). The agent may consult the customer’s existing payees and this agent’s payment history; it never guesses amounts, assets, networks, or addresses, and proposals still only take effect via the instructions + mandate-signature flow. Requires the freeform LLM layer to be configured server-side.
Authorizations
Path Parameters
Body
A freeform proposals conversation. The server is stateless — send the whole history in messages on each call. prompt is a convenience for a single-shot turn (or the latest user message); it is appended after messages. At least one of prompt or messages must be non-empty. Supplying both is valid only when messages does not already end with a user turn; otherwise the request is rejected with 400 (two consecutive user turns are not allowed).
Response
The agent's next step — a reply, proposals, or both
The agent's next step. At least one of proposals or reply is always present in a successful response — proposals at high confidence (optionally with a short reply note), or reply alone when the agent needs more from the user.
Validated action-series proposals, ready to accept via POST /instructions. Present only at high confidence.
The agent's conversational reply — a clarifying question or confirmation. Present without proposals when the agent needs more from the user; may accompany proposals as a short note.
How the boundary screen treated this turn. ok is a normal payments turn; warned means the request was off-topic and the customer was warned but may continue; blocked means the conversation has been terminated (repeated off-topic turns or a manipulation attempt) — the client should stop serving it and offer a fresh chat.
ok, warned, blocked 
