<tool name="read_prompt_tools">
  <description>Read the function/tool definitions attached to one playground prompt instance, including a `revision` token required to safely call `write_prompt_tools`.</description>
  <when_to_use>
    - Before calling `write_prompt_tools` — you need the latest `revision` to pass as `expectedRevision` and the existing tool `id`s to do an update.
    - Whenever the user asks what tools the prompt currently exposes, or wants to add to / refine the existing tool list.
  </when_to_use>
  <guidelines>
    - The returned `revision` is opaque. Pass it back unchanged as `expectedRevision` when calling `write_prompt_tools`. If the tool list changes between read and write, the write will be rejected; re-read and retry.
    - Each tool entry includes a `kind`: `function` tools are editable via `write_prompt_tools`; `raw` tools are vendor passthrough blobs and cannot be edited from PXI (the user manages them directly in the playground tool editor).
    - If there is exactly one playground instance, you may omit `instanceId`. Otherwise pass the specific numeric `instanceId` — use the alphabetic `label` from `read_prompt_instance` (A, B, C, D) only when talking to the user.
  </guidelines>
</tool>
