From c72329a1bbe016057bd2cbe14ed6be24f70e83fa Mon Sep 17 00:00:00 2001
From: Vincent Koc <vincentkoc@ieee.org>
Date: Thu, 23 Apr 2026 15:49:13 -0700
Subject: [PATCH] docs(pdf): convert Input reference to ParamField

---
 docs/tools/pdf.md | 29 +++++++++++++++++++++++------
 1 file changed, 23 insertions(+), 6 deletions(-)

diff --git a/docs/tools/pdf.md b/docs/tools/pdf.md
index 1dab903d3a8..6b7c23c7807 100644
--- a/docs/tools/pdf.md
+++ b/docs/tools/pdf.md
@@ -37,12 +37,29 @@ Availability notes:
 
 ## Input reference
 
-- `pdf` (`string`): one PDF path or URL
-- `pdfs` (`string[]`): multiple PDF paths or URLs, up to 10 total
-- `prompt` (`string`): analysis prompt, default `Analyze this PDF document.`
-- `pages` (`string`): page filter like `1-5` or `1,3,7-9`
-- `model` (`string`): optional model override (`provider/model`)
-- `maxBytesMb` (`number`): per-PDF size cap in MB
+<ParamField path="pdf" type="string">
+One PDF path or URL.
+</ParamField>
+
+<ParamField path="pdfs" type="string[]">
+Multiple PDF paths or URLs, up to 10 total.
+</ParamField>
+
+<ParamField path="prompt" type="string" default="Analyze this PDF document.">
+Analysis prompt.
+</ParamField>
+
+<ParamField path="pages" type="string">
+Page filter like `1-5` or `1,3,7-9`.
+</ParamField>
+
+<ParamField path="model" type="string">
+Optional model override in `provider/model` form.
+</ParamField>
+
+<ParamField path="maxBytesMb" type="number">
+Per-PDF size cap in MB. Defaults to `agents.defaults.pdfMaxBytesMb` or `10`.
+</ParamField>
 
 Input notes: