import { type RegisteredTool } from '../../server.ts';
/**
 * Serves the provider-authoring guide on demand, ONE TOPIC AT A TIME. The
 * server's always-on `instructions` are a terse tool-flow reference; this tool
 * is the deep version, so any MCP client — not just Claude Code, which alone
 * auto-loads skills — can pull it.
 *
 * Topic-scoped rather than all-at-once because the full guide is ~7k tokens:
 * paying that to answer "how do I mark a header secret?" crowds out the actual
 * task, which is exactly what makes an agent slow and prone to inventing
 * details. Every response carries the topic index, so a caller that guessed
 * wrong (or called with no topic at all) always learns what else is available
 * without a second round-trip.
 *
 * `oldMode` selects the backend-specific guide, so the agent is never told to
 * call auth/publish tools that aren't registered in its mode. Stateless:
 * callable before `attach_browser`.
 */
export declare function howItWorksTool(oldMode: boolean): RegisteredTool;