Running a Scan
Reading the tool graph
What Talos shows you before it attacks.
Every scan starts with a tool graph. It's the artifact that makes Talos's attacks specific instead of generic — attack templates only run when the graph has a node they can target.
Discover-only mode
Run talos-scan discover to print the graph without launching any attacks. Useful for auditing what your agent actually exposes.
talos — discover
❯ talos-scan discover --target http://localhost:8000/agent --adapter langchain→ 4 tools mapped: lookup_order, issue_refund, search_kb, send_email→ issue_refund: HIGH RISK (no bounds check, no confirmation)→ send_email: HIGH RISK (no recipient allowlist)→ search_kb: MEDIUM (user-influenced retrieval)→ lookup_order: LOW✓ Graph saved: ./reports/tool_graph.svg
Anatomy of the graph
- Nodes are individual tools with a parameter schema and declared side effects.
- Edges are observed data-flow (output of A becomes input of B) or shared permission scopes.
- Risk labels combine side-effect category, argument openness, and confirmation requirements.
Risk heuristics
| Signal | Contribution |
|---|---|
| Unbounded numeric argument (e.g. amount) | +2 severity |
| Free-form string reaching external systems | +2 severity |
| Missing user-confirmation step | +1 severity |
| Reads user-supplied documents into context | +1 severity |
| Idempotent, read-only, no PII | -2 severity |