Playbooks

propose_action & record_outcome

The agent loop is two tools. One drafts with citations, the other closes the loop so confidence reflects usefulness.

propose_action

Returns a source-cited draft built from your facts and approved playbooks — a reply, a message, a summary. Flipper never sends it. Your agent executes under its own credentials, or you send it yourself.

record_outcome

Tell Flipper whether the draft worked. Facts cited in the draft move by one bounded step — up when it worked, down when it did not — so a fact that keeps being useful earns its band instead of asserting it.

text

agent → propose_action({ intent: "refund reply", context: ticket })
      ← draft + citations [f412, f88, playbook:refunds]
you   → send it
agent → record_outcome({ ok: true, cited: [f412, f88] })