docs: add tool runtime safety guide

[Isjuanplayer]

Summary

Adds a new documentation guide for production tool runtime safety and validation in Swarms. The guide covers narrow tool contracts, validation before side effects, secret handling, structured outputs, dry-run behavior for destructive actions, audit-friendly logs, and a reviewer checklist.

Why this helps

Tool safety is a recurring concern for agent systems because tools often bridge model output with files, APIs, tickets, payments, or databases. This guide gives contributors and users a practical checklist plus copyable Python examples that fit the existing Tools Reference section.

Bounty eligibility

This PR is intended as a bounty-eligible documentation contribution under the Swarms Documentation Bounty Initiative.

Expected tier: Gold documentation contribution ($20-$50), because it adds a new major guide over 500 words with examples and a review checklist.

Validation

• Added the guide to docs/swarms/tools/tool_runtime_safety.md
• Added the page to docs/mkdocs.yml under Tools Reference
• Confirmed the new guide is 1,100+ words
• Ran git diff --check
• Attempted mkdocs build --strict, but this local machine does not have mkdocs installed

---

📚 Documentation preview 📚: https://swarms--1595.org.readthedocs.build/en/1595/

[github-actions]

Hello there, thank you for opening an PR ! 🙏🏻 The team was notified and they will get back to you asap.

[Isjuanplayer]

I do not have permission to apply repository labels from this fork, but this PR is submitted for the documentation bounty program. Could a maintainer please add the bounty-eligible label if this contribution qualifies?

[kyegomez]

Closing — both files this touches no longer exist.

docs/mkdocs.yml and the new docs/swarms/tools/tool_runtime_safety.md are both under docs/, which was removed from the repository in 8bd8d227 (2026-07-27). Nothing left to rebase onto.

Tool runtime safety is a real topic — see #1930, which is hardening the actual run_bash tool against argv-level bypasses. If you want to document that behavior once it lands, that would be useful.