/**
 * What each wrapped engine tool does to the editor it is addressed to.
 *
 * This file is the reviewed half of the Epic action surface. The catalog in
 * `tests/golden/epic-catalog.json` says what tools exist and what arguments
 * they take; Epic ships no annotation saying whether one reads or writes, so
 * that judgement is made here, by a person, once, and lives in a diff.
 *
 * It is hand-edited. `npm run epic:seed` only ADDS entries for tools that have
 * none, so re-recording a newer engine appends its new tools and never
 * overwrites a decision already made. `npm run epic:generate` refuses to run
 * while any tool in the catalog is missing from here.
 *
 * An entry marked `// SEEDED` was written by the seeder from the tool's own
 * description and has not been read by a person yet. `npm run epic:unreviewed`
 * lists them. Removing that comment is what "I have read this one" means.
 *
 *   read     observes. Landing it in the wrong editor returns the wrong answer
 *            and changes nothing.
 *   mutate   may change the editor, its project on disk, or its process.
 *   unknown  decided by an argument rather than by the tool. Gated as mutate.
 */
import type { ActionEffect } from "../../types.js";
/** Keyed by the tool's fully qualified registry name. */
export declare const EPIC_TOOL_EFFECTS: Record<string, ActionEffect>;