import type { AgentTool } from '@earendil-works/pi-agent-core';
export type ToolMutationScope = 'none' | 'workspace' | 'external' | 'unknown';
export type ToolVerificationKind = 'none' | 'diff-review' | 'test' | 'build' | 'lint' | 'typecheck';
export interface XopcToolMetadata {
    mutatesWorkspace?: boolean;
    mutationScope?: ToolMutationScope;
    supportsParallel?: boolean;
    idempotent?: boolean;
    verificationKind?: ToolVerificationKind;
    requiresExclusiveWorkspaceLock?: boolean;
    finalGuardRelevant?: boolean;
}
export type AgentToolWithMetadata<TParams = any, TDetails = any> = AgentTool<TParams, TDetails> & XopcToolMetadata;
export declare const DEFAULT_TOOL_METADATA: Required<XopcToolMetadata>;
export declare function getToolMetadata(tool: AgentTool<any, any>): Required<XopcToolMetadata>;