agnets done

src/components/ai-assistant/blocks.js

@@ -90,6 +90,25 @@ export const skillSection = (section, data) =>
 /** A caveat. Always the last word on a claim, never the headline. */
 export const note = (value) => value && { type: 'note', text: value };
 
+/**
+ * A write the agent has proposed and NOT performed.
+ *
+ * The only block in this file that carries a decision rather than information,
+ * and the only one whose renderer has a button. Everything else here describes
+ * something that already happened; this describes something that will happen if
+ * a person says so.
+ *
+ * The payload comes from the server verbatim — title, summary, details,
+ * warnings, token — and is rendered rather than reformatted. The wording was
+ * composed beside the code that will do the writing, so a browser paraphrasing
+ * it would be describing a different act than the one the token authorises.
+ *
+ * `token` is what the approval sends back. It authorises exactly one call, with
+ * exactly those arguments, and it expires.
+ */
+export const confirmation = (payload) =>
+  payload?.token && { type: 'confirmation', ...payload };
+
 /** A single sentence answer — used by short free-text replies. */
 export const answer = (value) => doc(text(value));