import type { IdeId } from './ide-types.js';
/**
 * hook-translator —— peaks 自有 hook 协议的核心。
 *
 * 单一职责:把 IDE 私有 stdin 形态归一化到 peaks canonical schema;把 peaks 决策
 * 格式化回 IDE 期望的 stdout/exit-code 形态。
 *
 * auto-detection 算法(优先级从高到低):
 *   1. env 变量:CLAUDE_PROJECT_DIR / TRAE_PROJECT_DIR / CODEX_PROJECT_DIR / ...
 *   2. stdin shape:`{ tool_name, tool_input }` 是 Claude / Trae;
 *                `{ toolName, toolInput }` 是 Cursor;
 *                `{ eventName, parameters }` 是 Trae 另形态
 *   3. cwd 启发式:存在 .claude / .trae / .codex / .cursor 目录
 *   4. fallback:`claude-code`(backward compat,见 PRD preserved behavior #10)
 */
export interface DetectFromStdinInput {
    readonly env: NodeJS.ProcessEnv;
    readonly cwd: string;
    /** 已解析的 stdin 形态;null = 空 stdin 或非 JSON */
    readonly parsedStdin: unknown;
}
/**
 * Detect the originating IDE from env / stdin shape / cwd heuristics.
 * Falls back to 'claude-code' (PRD preserved behavior: backward compat).
 */
export declare function detectIdeFromContext(input: DetectFromStdinInput): IdeId;
/**
 * Pluck a string value at a nested path. Returns undefined if any segment is
 * missing or non-object. Used by adapter-driven stdin parsers.
 */
export declare function pluckString(obj: unknown, path: readonly string[]): string | undefined;
export declare function pluckObject(obj: unknown, path: readonly string[]): Record<string, unknown> | undefined;
/**
 * Default stdin parser for adapters that follow the Claude Code shape
 * (most LLM-style IDEs do: tool_name at top, tool_input.{command} inside).
 */
export declare function parseClaudeShapeStdin(parsed: unknown): {
    toolName?: string;
    command?: string;
};
/**
 * Trae stdin parser. UNVERIFIED — Trae 1.x's actual stdin envelope shape is
 * assumed to be Cursor-style (eventName at top, parameters nested), based on
 * slice #2's read of Trae as a "Cursor sibling". When a real Trae 1.x hook
 * payload is dogfooded, this parser is the seam to update.
 *
 * Shape (assumed):
 *   { eventName: 'beforeToolCall', parameters: { command: 'rm -rf /' } }
 *
 * Returns the same `{ toolName, command }` shape as parseClaudeShapeStdin so
 * downstream code (buildCanonicalHook, enforceBashCommand) does not need to
 * branch on IDE. The `toolName` here is the IDE-specific name (e.g.
 * 'terminal'); callers may normalize it to the canonical 'Bash' if needed.
 */
export declare function parseTraeShapeStdin(parsed: unknown): {
    toolName?: string;
    command?: string;
};
/**
 * Per-adapter stdin parser dispatch. Returns the `{ toolName, command }` pair
 * for the given IDE, regardless of which stdin shape the IDE actually emits.
 *
 * The dispatch table is keyed on `IdeId` (not stdin shape) so an adapter can
 * change its wire format without breaking the hook-handle flow. Unknown IDEs
 * fall back to the Claude parser — that preserves the slice #1 "fail-open to
 * Claude" behavior so a future adapter that has not yet been added does not
 * crash the hook runtime.
 */
export declare function parseAdapterStdin(ide: IdeId, parsed: unknown): {
    toolName?: string;
    command?: string;
};