/**
 * Shared helpers for lexicon plugin implementations.
 *
 * Eliminates boilerplate across the 8 lexicon plugins by providing
 * factory functions for common plugin methods: skills loading,
 * MCP diff tool, and MCP catalog resource.
 */
import type { SkillDefinition } from "./lexicon.js";
import type { McpToolContribution, McpResourceContribution } from "./mcp/types.js";
import type { Serializer } from "./serializer.js";
/**
 * Metadata for a skill file on disk. Spread into the resulting SkillDefinition
 * after the file content is read.
 */
export type SkillFileSpec = Omit<SkillDefinition, "content"> & {
    /** Filename relative to the skills directory (e.g. "chant-aws.md") */
    file: string;
};
/**
 * Create a skills loader that reads .md files from a lexicon's skills directory.
 *
 * Usage in a plugin:
 * ```ts
 * import { createSkillsLoader } from "@intentius/chant/lexicon-plugin-helpers";
 *
 * const loadSkills = createSkillsLoader(import.meta.url, [
 *   { file: "chant-aws.md", name: "chant-aws", description: "..." },
 * ]);
 *
 * // In plugin:
 * skills() { return loadSkills(); }
 * ```
 */
export declare function createSkillsLoader(importMetaUrl: string, specs: SkillFileSpec[]): () => SkillDefinition[];
/**
 * Create an MCP diff tool contribution for a lexicon.
 *
 * All lexicons (except Azure) expose an identical-shape "diff" tool that
 * compares current build output against previous output using the lexicon's
 * serializer. The tool name is namespaced by `lexiconName` (e.g. `gcp:diff`)
 * so multiple lexicons loaded together don't collide on the same tool key.
 */
export declare function createDiffTool(serializer: Serializer, description: string, lexiconName: string): McpToolContribution;
/**
 * Create an MCP resource that serves the lexicon's meta.json as a catalog.
 *
 * Most lexicons expose a "resource-catalog" resource with identical
 * structure. The URI is namespaced by `lexiconName` (e.g.
 * `gcp:resource-catalog`) so multiple lexicons loaded together don't
 * collide on the same resource key.
 *
 * @param importMetaUrl — The plugin's import.meta.url (used to locate generated JSON)
 * @param name — Display name (e.g. "AWS Resource Catalog")
 * @param description — Resource description
 * @param lexiconJsonFile — Filename of the generated lexicon JSON (e.g. "lexicon-aws.json")
 * @param lexiconName — Short lexicon name (e.g. "aws", "gcp"). Becomes the URI prefix.
 */
export declare function createCatalogResource(importMetaUrl: string, name: string, description: string, lexiconJsonFile: string, lexiconName: string): McpResourceContribution;
//# sourceMappingURL=lexicon-plugin-helpers.d.ts.map