/**
 * @fileoverview Thin domain-typed wrapper around the generic marker
 * walker for `kind: "tool"`.
 *
 * A Tool plugin is any npm package (scoped or unscoped, first- or third-
 * party) whose `package.json` declares:
 *
 *   { "opensipTools": { "kind": "tool" } }
 *
 * The walker itself lives in `marker-discovery.ts` — this file preserves
 * the public surface (`discoverToolPackages`, `DiscoveredToolPackage`)
 * existing CLI consumers depend on, and delegates the actual node_modules
 * traversal to the shared primitive.
 *
 * Direct dependencies of opensip-tools are always loaded by the
 * CLI's own import statements; this discovery exists so a user can
 * install a third-party tool via `npm install` and have it picked up
 * with no further wiring.
 */
export interface ToolPackageDiscoveryOptions {
    /** Absolute path to the project root. */
    readonly projectDir: string;
}
export interface DiscoveredToolPackage {
    /** npm package name, e.g. '@opensip-tools/fitness' or '@my-co/audit'. */
    readonly name: string;
    /** Absolute path to the package's directory inside node_modules. */
    readonly packageDir: string;
}
/**
 * Walk up from `projectDir` looking for `node_modules/` directories
 * containing packages with `opensipTools.kind === 'tool'`. Returns the
 * deduplicated list (first-occurrence-wins by package name).
 */
export declare function discoverToolPackages(options: ToolPackageDiscoveryOptions): DiscoveredToolPackage[];
/**
 * One discovery source for {@link discoverToolPackagesFromAnchors}.
 *
 *  - `walkUp`: walk ancestor `node_modules` from `dir` (project trees, the
 *    CLI install dir — covers a plain `npm install @tool` and global CLI
 *    siblings).
 *  - `scanDir`: scan exactly `<dir>/node_modules`, no walk (the fixed
 *    plugin host dirs — `~/.opensip-tools/plugins/tool`,
 *    `<project>/.runtime/plugins/tool`).
 */
export interface ToolDiscoverySource {
    readonly dir: string;
    readonly mode: 'walkUp' | 'scanDir';
}
/**
 * Discover tool packages across an ORDERED list of sources, deduplicated
 * by package name with first-occurrence-wins. Order encodes precedence:
 * an earlier source's package shadows a later same-named one (e.g. a
 * project-local pin shadows a user-global install). Mirrors the
 * ToolRegistry's own first-writer-wins on duplicate ids.
 */
export declare function discoverToolPackagesFromAnchors(sources: readonly ToolDiscoverySource[]): DiscoveredToolPackage[];
/**
 * Read `name` and the resolved main entry of a discovered tool package.
 * Mirrors readCheckPackageMetadata in shape but is exposed at the kernel
 * level so any consumer (CLI, tests, future tooling) can resolve a tool
 * package without depending on fitness.
 */
export interface ToolPackageMetadata {
    readonly name: string;
    readonly mainEntry: string;
}
export declare function readToolPackageMetadata(packageDir: string): ToolPackageMetadata | undefined;
//# sourceMappingURL=tool-package-discovery.d.ts.map