import type { AgentTool } from '@earendil-works/pi-agent-core'; export type ClarifyRequestPayload = { question: string; choices?: string[]; default?: string; }; export type GatewayClarifyRequestFn = (sessionKey: string, request: ClarifyRequestPayload) => Promise; export interface ClarifyToolDeps { /** Resolve a per-turn callback; returns null when clarification is unavailable. */ resolveAskUser: () => ((request: ClarifyRequestPayload) => Promise) | null; } export declare function createClarifyTool(deps: ClarifyToolDeps): AgentTool;