docs: add ScopeBlind integration guide (signed decision receipts for tools)

[tomjwxf]

Summary

Adds an integration guide at docs/integrations/scopeblind.md for scopeblind-swarms — a Python package that wraps any Swarms tool with Ed25519-signed, tamper-evident, offline-verifiable decision receipts in the Veritas Acta format.

The same receipt format is used by:

• Microsoft Agent Governance Toolkit (see docs: Tutorial 33 — Offline-Verifiable Decision Receipts microsoft/agent-governance-toolkit#1197 (comment); docs: add Signet to Tutorial 33 cross-implementation table microsoft/agent-governance-toolkit#1201 (comment); docs: sb-runtime integration guide (a Veritas Acta receipt format implementation) microsoft/agent-governance-toolkit#1202 (comment); feat: sb-runtime governance skill (signed decision receipts, nono-composable) microsoft/agent-governance-toolkit#1203 (comment); feat: GitHub Pages docs site with MkDocs Material (closes #347) microsoft/agent-governance-toolkit#1186 (comment);
  feat(examples): physical-attestation-governed — cold chain sensor receipts microsoft/agent-governance-toolkit#1168 (comment);
  feat(examples): protect-mcp governed example — Cedar policies + signed receipts microsoft/agent-governance-toolkit#1159 (comment);
  feat: ScopeBlind protect-mcp integration — Cedar policy enforcement + verifiable receipts microsoft/agent-governance-toolkit#667 (comment))

• protect-mcp / protect-mcp-adk (MCP + Google ADK)

• sb-runtime (Rust runtime backend)

• hermes-decision-receipts (aeoess / Agent Passport System bridge)

• Signet (Prismer-AI, maintainer-self-certified)

• bindu-scopeblind (Bindu / GetBindu)

15 implementations in total on the draft-02 IETF Implementation Status appendix. This PR brings Swarms into that cross-verifying ecosystem.

What's in the PR

Doc-only. One new file: docs/integrations/scopeblind.md. No changes to Swarms core or to any existing file.

The guide covers:

• One-liner install (pip install scopeblind-swarms swarms)
• Quick start (3 code blocks: create chain, wrap tool, use in Agent)
• Receipt payload shape (tool_name, action_ref, result_hash, policy_id, previousReceiptHash, Ed25519 signature)
• Offline verification (npx @veritasacta/verify receipt.json --key operator.pem)
• Composition with other ecosystem components (sandbox backends, policy engines, transparency logs)
• Thread-safety note for async Swarms agents

Design note on the extension point

Swarms does not expose pre/post tool hooks. The canonical interception point per upstream guidance (BaseTool's _execute_single_function_call discussion in existing tool docs) is wrapping the tool callable before passing it to Agent(tools=[...]). scopeblind-swarms uses that extension point exactly; it does not patch Swarms internals, subclass Agent, or modify any Swarms code path.

Related

• scopeblind-swarms PyPI page: https://pypi.org/project/scopeblind-swarms/
• Source: ScopeBlind/scopeblind-gateway (MIT)
• Reference verifier: @veritasacta/verify (Apache-2.0, offline, zero dependencies on ScopeBlind or Swarms)
• IETF draft: draft-farley-acta-signed-receipts-02
• Microsoft AGT integration docs (parallel shape): docs/integrations/sb-runtime.md

Test plan

• Markdown renders correctly (local preview)
• All cross-links resolve
• Python examples are copy-pasteable and match the installed scopeblind-swarms@0.1.0 API
• Companion package has 17/17 tests passing (receipt signing, chain linkage, tamper detection, thread-safety under concurrent signing, decorator form, bulk wrapping, embedded-key rejection)

Cc @kyegomez — the receipt-layer primitive composes cleanly with existing Swarms tool machinery. Happy to iterate on scope, style, or framing if there's anything you'd like adjusted. The only ask is a doc link; the adapter itself lives on PyPI and the ScopeBlind monorepo, not in swarms-core.

---

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

[github-actions]

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