import type { AgentTool } from '@earendil-works/pi-agent-core';
export interface ShellDetails {
    exitCode: number | null;
    timedOut: boolean;
    truncated: boolean;
    truncatedBy?: 'lines' | 'bytes';
    outputBytes?: number;
}
export interface CreateShellToolOptions {
    /** Env var names allowed through {@link prepareSafeToolEnv} even if they match secret heuristics (skill passthrough). */
    getSkillPassthroughEnvVarNames?: () => string[];
}
export declare function createShellTool(cwd: string, options?: CreateShellToolOptions): AgentTool;
