name: convert-documents-to-markdown description: Convert an attached Word document, presentation, spreadsheet, OpenDocument file, RTF, EPUB, CSV, or text-based PDF into local Markdown. Use when a message supplies a local attachment path that must be read without uploading it to an external parser. allowed-tools: Bash(anydoc:*)
Convert documents to Markdown
Use the installed Firecrawl AnyDoc CLI (MIT). Conversion is local to the agent container.
Use the exact local attachment path supplied in the message. Current Chat SDK attachments normally use /workspace/inbox/<message-id>/<file>. Encode the path as a single-quoted shell literal, replacing each apostrophe with '"'"'. Never paste an untrusted path inside double quotes because command substitutions still execute there. Quote generated paths, put options before --, and put the input after it:
input_path='/workspace/inbox/<message-id>/<document>'
mkdir -p "/workspace/agent/converted"
output_dir="$(mktemp -d "/workspace/agent/converted/anydoc.XXXXXX")"
output_path="$output_dir/document.md"
timeout 60s anydoc -o "$output_path" -- "$input_path"
printf 'Converted document: %s\n' "$output_path"
For example, this assigns a filename containing both shell syntax and an apostrophe without executing it:
input_path='/workspace/inbox/msg/report $(echo unsafe) '"'"'Q3'"'"'.docx'
The -- prevents a filename beginning with - from becoming an option. If timeout is unavailable, run the same command without the wrapper.