Agent tools
Built-in tools used by Ship Spec’s workflows and available to agents.
Retriever (retrieve_code)
Hybrid vector + keyword code search.
// Input
{ query: string, k?: number }
// Output
[{ filepath, content, type, symbolName, lines }]
Web search (web_search)
Compliance and best-practice lookup (Tavily primary; DuckDuckGo fallback).
{ query: string, maxResults?: number } -> [{ title, url, content }]
SAST scanner (run_sast_scans)
Optional security scanners.
{ tools?: ["semgrep" | "gitleaks" | "trivy"] }
Findings are routed into productionalize reports and remediation task prompts.