export type PdfVisionPositionPermission = "filesystem:read" | "office:pdf:read" | "office:pdf:render";
export type PdfVisionPositionBoundary = "input" | "scope" | "permission" | "contract";
export type PdfVisionPositionContext = {
    runtimeId?: string;
    invocationId?: string;
    dryRun?: boolean;
    allowedDocumentRoots?: readonly string[];
    grantedPermissions?: readonly PdfVisionPositionPermission[];
    auditMetadata?: Readonly<Record<string, unknown>>;
};
export type PdfVisionPositionTarget = {
    pdfPath: string;
    visualCue: string;
    pageNumber: number;
    coordinateSystem?: "pdf-points" | "rendered-pixels";
    renderDpi?: number;
    maxCandidates?: number;
};
export type PdfVisionPositionRequest = {
    target?: Partial<PdfVisionPositionTarget>;
    context?: PdfVisionPositionContext;
};
export type PdfVisionPositionErrorCode = "MISSING_PDF_PATH" | "INVALID_PDF_PATH" | "MISSING_VISUAL_CUE" | "INVALID_PAGE_NUMBER" | "INVALID_COORDINATE_SYSTEM" | "INVALID_RENDER_DPI" | "INVALID_MAX_CANDIDATES" | "SCOPE_REJECTED" | "PERMISSION_DENIED" | "REAL_EXECUTION_BLOCKED";
export type PdfVisionPositionError = {
    code: PdfVisionPositionErrorCode;
    message: string;
    boundary: PdfVisionPositionBoundary;
    publicSafe: true;
};
export type PdfVisionPositionAuditEvent = {
    type: string;
    toolId: "office.pdfVisionPosition";
    invocationId: string;
    dryRun: boolean;
    pdfPath?: string;
    metadata: Readonly<Record<string, unknown>>;
};
export type PdfVisionRegionEnvelope = {
    pageNumber: number;
    x: number;
    y: number;
    width: number;
    height: number;
    confidence?: number;
    label?: string;
};
export type PdfVisionPositionOutput = {
    kind: "agentCore.basicTool.office.pdfVisionPosition";
    target: PdfVisionPositionTarget;
    renderPlan: {
        pageNumber: number;
        dpi: number;
        coordinateSystem: "pdf-points" | "rendered-pixels";
    };
    dryRun: true;
    executionBlocked: true;
    permissionsRequired: readonly PdfVisionPositionPermission[];
    providerCallRequired: false;
    unsafeSideEffects: false;
    resultEnvelope: {
        candidateRegions: readonly PdfVisionRegionEnvelope[];
    };
};
export type PdfVisionPositionResult = {
    ok: true;
    toolId: "office.pdfVisionPosition";
    output: PdfVisionPositionOutput;
    audit: readonly PdfVisionPositionAuditEvent[];
    events: readonly string[];
} | {
    ok: false;
    toolId: "office.pdfVisionPosition";
    error: PdfVisionPositionError;
    audit: readonly PdfVisionPositionAuditEvent[];
    events: readonly string[];
};
export declare const pdfVisionPositionDescriptor: {
    readonly toolId: "office.pdfVisionPosition";
    readonly capability: "position-pdf-visual-region";
    readonly route: "toolabilityPool.officeBase.Portable_Document_Format";
    readonly defaultDryRun: true;
    readonly tapOwnsApproval: true;
    readonly permissionsRequired: readonly ["filesystem:read", "office:pdf:read", "office:pdf:render"];
};
export declare function planPdfVisionPosition(request?: PdfVisionPositionRequest): PdfVisionPositionResult;
