← Tool reference

render_buyer_action_review

Review an action

Render exact recipients, message, attachments, terms or facts from an existing prepared action ID. The buyer can explicitly confirm through the original authorized operation; never supply model-authored display facts. A text-only client (a terminal) draws no card: put the exact recipients, subject, message, attachments or terms from the result in your reply and take the buyer's confirmation in the conversation. Show only one focused card per assistant turn; do not call another render tool in parallel. Use structured reads to summarize the other information.

Effect
Read
Required scopes
workspace:read
Workflow stages
closing, transaction
Data classes
transaction, ui telemetry
Operation cost
1 weighted units; additional domain limits may apply.
Configurations
Buyer UI v2
Muse proposal
Read. Retrieves or computes authorized information; consult the tool contract for its scopes and result. Meta makes the final classification during review.

Buyer approval and signing controls apply in addition to the scopes above. Read error and retry guidance before implementing recovery.

Buyer UI v2 contracts

Returns structured content and a JSON text content block. Live discovery may compact a large output schema; execution validates the full contract below.

Input fields

Required applies within the containing object. Optional fields can be omitted; null is accepted only where listed. Field descriptions and constraints come from the source schema. The raw schema remains the complete contract.

FieldRequiredMeaning and constraints
workspaceIdstringYes

Pattern validation applies; see the raw schema.

preparedActionIdstringYes

Pattern validation applies; see the raw schema.

kindstringYes

Allowed: "terms", "email", "transaction".

Output fields

Required applies within the containing object. Optional fields can be omitted; null is accepted only where listed. Field descriptions and constraints come from the source schema. The raw schema remains the complete contract.

FieldRequiredMeaning and constraints
uistringYes

Must be "action".

presentationobjectYes

Extra fields are not allowed.

presentation: nested contract
FieldRequiredMeaning and constraints
addressstring | nullYes

Must match at least one alternative.

address: nested contract
Alternative 1: string

Alternative 2: null

citystring | nullYes

Must match at least one alternative.

city: nested contract
Alternative 1: string

Alternative 2: null

canEditbooleanYesNo additional description in the contract.
canUploadbooleanNoNo additional description in the contract.
buyerDefaultsobjectNo

Extra fields are not allowed.

buyerDefaults: nested contract
FieldRequiredMeaning and constraints
namestringYesNo additional description in the contract.
emailstringYesNo additional description in the contract.
phonestringYesNo additional description in the contract.
checksarray<object>YesNo additional description in the contract.
checks: nested contract
Array item contract

Extra fields are not allowed.

FieldRequiredMeaning and constraints
idstringYesNo additional description in the contract.
labelstringYesNo additional description in the contract.
hintstringYesNo additional description in the contract.
sourcestringYes

Allowed: "buyer", "system", "custom".

completeboolean | nullYes

Must match at least one alternative.

complete: nested contract
Alternative 1: boolean

Alternative 2: null

actionobjectYes

Extra fields are not allowed.

action: nested contract
FieldRequiredMeaning and constraints
workspaceIdstringYesNo additional description in the contract.
preparedActionIdstringYesNo additional description in the contract.
titlestringYesNo additional description in the contract.
confirmationLabelstringYesNo additional description in the contract.
statusstringYes

Allowed: "prepared", "applying", "completed", "expired", "declined".

expiresAtstringYes

Format: date-time.

Pattern validation applies; see the raw schema.

summaryobjectYesNo additional description in the contract.
displayDatesobjectNoNo additional description in the contract.
receiptobject | nullYes

Must match at least one alternative.

receipt: nested contract
Alternative 1: object

Alternative 2: null

canExecutebooleanYesNo additional description in the contract.
executionobjectYes

Extra fields are not allowed.

execution: nested contract
FieldRequiredMeaning and constraints
namestringYes

Allowed: "confirm_offer_draft_terms", "send_transaction_email_draft", "confirm_closing", "confirm_possession", "confirm_purchase_step", "confirm_counter_candidate", "confirm_ratification", "confirm_transaction_fact", "confirm_repair_seller_response_review", "confirm_contract_amendment", "confirm_contingency_extension_agreement", "resend_co_buyer_invite", "confirm_contact_verification", "confirm_transaction_step".

argumentsobjectYesNo additional description in the contract.
needsConfirmationKeybooleanYesNo additional description in the contract.
actionKindstringYes

Allowed: "terms", "email", "transaction".

confirmableInSecondsintegerNo

Minimum: 0.

Maximum: 3600.

schemaVersionstringYes

Must be "1".

Raw input schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,200}$"
    },
    "preparedActionId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,200}$"
    },
    "kind": {
      "type": "string",
      "enum": [
        "terms",
        "email",
        "transaction"
      ]
    }
  },
  "required": [
    "workspaceId",
    "preparedActionId",
    "kind"
  ],
  "additionalProperties": false
}
Full output schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ui": {
      "type": "string",
      "const": "action"
    },
    "presentation": {
      "type": "object",
      "properties": {
        "address": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "city": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "canEdit": {
          "type": "boolean"
        },
        "canUpload": {
          "type": "boolean"
        },
        "buyerDefaults": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "email": {
              "type": "string"
            },
            "phone": {
              "type": "string"
            }
          },
          "required": [
            "name",
            "email",
            "phone"
          ],
          "additionalProperties": false
        },
        "checks": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "hint": {
                "type": "string"
              },
              "source": {
                "type": "string",
                "enum": [
                  "buyer",
                  "system",
                  "custom"
                ]
              },
              "complete": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "label",
              "hint",
              "source",
              "complete"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "address",
        "city",
        "canEdit",
        "checks"
      ],
      "additionalProperties": false
    },
    "action": {
      "type": "object",
      "properties": {
        "workspaceId": {
          "type": "string"
        },
        "preparedActionId": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "confirmationLabel": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "prepared",
            "applying",
            "completed",
            "expired",
            "declined"
          ]
        },
        "expiresAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
        },
        "summary": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        },
        "displayDates": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 80
              },
              "local": {
                "type": "string",
                "minLength": 16,
                "maxLength": 40
              },
              "time": {
                "type": "string",
                "minLength": 1,
                "maxLength": 20
              },
              "timezone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              },
              "utc": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
              },
              "weekday": {
                "type": "string",
                "enum": [
                  "Monday",
                  "Tuesday",
                  "Wednesday",
                  "Thursday",
                  "Friday",
                  "Saturday",
                  "Sunday"
                ]
              }
            },
            "required": [
              "date",
              "label",
              "local",
              "time",
              "timezone",
              "utc",
              "weekday"
            ],
            "additionalProperties": false
          }
        },
        "receipt": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "$ref": "#/$defs/__schema1"
              }
            },
            {
              "type": "null"
            }
          ]
        },
        "canExecute": {
          "type": "boolean"
        },
        "execution": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "enum": [
                "confirm_offer_draft_terms",
                "send_transaction_email_draft",
                "confirm_closing",
                "confirm_possession",
                "confirm_purchase_step",
                "confirm_counter_candidate",
                "confirm_ratification",
                "confirm_transaction_fact",
                "confirm_repair_seller_response_review",
                "confirm_contract_amendment",
                "confirm_contingency_extension_agreement",
                "resend_co_buyer_invite",
                "confirm_contact_verification",
                "confirm_transaction_step"
              ]
            },
            "arguments": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "string"
              }
            },
            "needsConfirmationKey": {
              "type": "boolean"
            }
          },
          "required": [
            "name",
            "arguments",
            "needsConfirmationKey"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "workspaceId",
        "preparedActionId",
        "title",
        "confirmationLabel",
        "status",
        "expiresAt",
        "summary",
        "receipt",
        "canExecute",
        "execution"
      ],
      "additionalProperties": false
    },
    "actionKind": {
      "type": "string",
      "enum": [
        "terms",
        "email",
        "transaction"
      ]
    },
    "confirmableInSeconds": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3600
    },
    "schemaVersion": {
      "type": "string",
      "const": "1"
    }
  },
  "required": [
    "ui",
    "presentation",
    "action",
    "actionKind",
    "schemaVersion"
  ],
  "additionalProperties": false,
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    },
    "__schema1": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema1"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema1"
          }
        }
      ]
    }
  }
}
Tool annotations
{
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false,
  "readOnlyHint": true
}

UI resource: ui://ohvii/buyer-v2-fdbde13acd06e0a4.html. Visibility: host default.

Reference 00e5441a095c7e20. Download the full catalog.