Operations guide

A production tool layer needs visibility, safety controls, and repeatable debugging.

Security checklist

• Give tools narrow names, clear docstrings, and explicit typed arguments.
• Tag tools by domain and capability so retrieval and policy decisions are explainable.
• Use security policies for sensitive operations, rate limits for load control, and circuit breakers for unstable dependencies.
• Log tool-call events and attach tracing through console, OpenTelemetry, or Prometheus adapters.

Debug retrieval

result = await gantry.retrieve(query)
for candidate in result.tools:
    print(candidate.tool.name, candidate.score, candidate.reason)

Release checklist

• Run unit tests and framework adapter tests relevant to your extras.
• Build the Astro docs site with npm run build.
• Preview docs styling with npm run preview when changing user-facing pages.